===================================================================
RCS file: /cvs/pta/pta_import.1,v
retrieving revision 1.9
retrieving revision 1.12
diff -u -p -r1.9 -r1.12
--- pta/pta_import.1	2020/11/28 15:10:36	1.9
+++ pta/pta_import.1	2020/12/03 14:17:39	1.12
@@ -1,4 +1,4 @@
-.\" $Id: pta_import.1,v 1.9 2020/11/28 15:10:36 freda Exp $
+.\" $Id: pta_import.1,v 1.12 2020/12/03 14:17:39 freda Exp $
 .\"
 .\" Copyright (c) 2020 Freda Bundchen
 .\"
@@ -14,7 +14,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: November 28 2020 $
+.Dd $Mdocdate: December 3 2020 $
 .Dt PTA_IMPORT 1
 .Os
 .Sh NAME
@@ -81,6 +81,35 @@ The number in
 .Xr pta-accounts 5
 of the bank or credit card account this CSV file contains entries for.
 This rule is required in every configuration file.
+.It Ic AMOUNT Oo Ar debit_column Oc Ar credit_column
+The column numbers in the CSV file containing amounts to be
+booked on the debit or credits side of the contra account
+.Ar account_number ,
+respectively.
+If
+.Ar debit_column
+is omitted, amounts preceded by a minus sign or enclosed
+in parentheses are booked to the debit side.
+.It Ic COSTCENTER Ar costcenter_column
+The column number in the CSV file containing the cost center.
+Numbering starts from 1.
+If this rule is not specified, no cost centers are assigned.
+.It Ic DATE Ar date_column date_format
+The column number in the CSV file containing the date.
+Numbering starts from 1.
+The
+.Ar date_format
+is one of
+.Ic MM/DD/YY ,
+.Ic MM/DD/YYYY ,
+.Ic YYYY-MM-DD ,
+or
+.Ic DD.MM.YY .
+This rule is required in every configuration file.
+.It Ic DESCRIPTION Ar descr_column ...
+The column numbers in the CSV file to be concatenated to form the
+text string for the journal entry.
+Numbering starts from 1.
 .It Ic DELIM Ar delimiter
 The character used to separate fields.
 This rule is required in every configuration file.
@@ -92,6 +121,11 @@ line verbatim, or cause parsing to fail if it does not
 .It Ic IGNORE Ar regular_expression
 Skip all lines in the CSV file matching the
 .Ar regular_expression .
+.It Ic QUANTITY Ar quantity_column
+The column number in the CSV file containing the number of stock shares.
+Numbering starts from 1.
+If this rule is not specified, no information about the number of traded
+securities is appended to the text string.
 .It Ic QUOTE Ar quote
 Expects that every field starts and ends with the
 .Ar quote
@@ -109,7 +143,8 @@ by delimiters defined in the
 rule.
 .El
 .Sh FILES
-.Bl -tag -width Ds -compact
+Example configuration files:
+.Bl -tag -offset indent -width Ds -compact
 .It Pa ./import/bbva_usa.txt
 .It Pa ./import/capital_one_360.txt
 .It Pa ./import/capital_one_credit.txt
@@ -120,11 +155,16 @@ rule.
 .It Pa ./import/wellsfargo.txt
 .El
 .Pp
-These files contain the header that the financial institution uses, the
-account number from
-.Pa ./accounts.txt
-used by this account, as well as patterns used to map transactions to
-the correct account and booking identifier.
+Example CSV files:
+.Bl -tag -offset indent -width Ds -compact
+.It Pa ./csv/bbva_usa.csv
+.It Pa ./csv/capital_one_360.csv
+.It Pa ./csv/capital_one_credit.csv
+.It Pa ./csv/chase_credit.csv
+.It Pa ./csv/etrade_ira.csv
+.It Pa ./csv/optum_hsa.csv
+.It Pa ./csv/wellsfargo.csv
+.El
 .Sh EXIT STATUS
 .Ex -std
 .Sh EXAMPLES