slaesvuo/hledger
1
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity

doc: describe changes to csv parser

Browse Source
This commit is contained in:
Dmitry Astapov 2019-10-12 23:48:51 +01:00
parent f108b52171
commit 5d207ddd05
1 changed files with 5 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
hledger-lib/hledger_csv.m4.md
View File

@ -92,7 +92,7 @@ You'll need this whenever your CSV data contains header lines. Eg:
<!-- XXX --> <!-- XXX -->
<!-- hledger tries to skip initial CSV header lines automatically. --> <!-- hledger tries to skip initial CSV header lines automatically. -->
<!-- If it guesses wrong, use this directive to skip exactly N lines. --> <!-- If it guesses wrong, use this directive to skip exactly N lines. -->
<!-- This can also be used in a conditional block to ignore certain CSV records. --> This can also be used in a conditional block (without numeric argument) to ignore certain CSV records.
```rules ```rules
# ignore the first CSV line # ignore the first CSV line
skip 1 skip 1
@ -145,6 +145,10 @@ Eg:
fields date, description, , amount, , , somefield, anotherfield fields date, description, , amount, , , somefield, anotherfield
``` ```
If you want one line of CSV file to produce more that two postings, you can use the following fields, substituting X with a number from 1 to 9: `accountX`, `amountX`, `amountX-in`, `amount-X-out`, `currencyX`, `balanceX`, `commentX`.
Fields `amount`, `amount-in`, `amount-out`, `currency` and `balance` are treated as aliases for `amount1`, and so on. If your rules file leads to both aliased fields having different values, `hledger` will raise an error.
## field assignment ## field assignment
*`ENTRYFIELDNAME`* *`FIELDVALUE`* *`ENTRYFIELDNAME`* *`FIELDVALUE`*