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

;doc: csv: clarify skip/valid csv semantics (#1967)

Browse Source
This commit is contained in:
Simon Michael 2022-12-27 13:08:58 -10:00
parent 7df44fc199
commit 19821ee0e9
1 changed files with 7 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
hledger/hledger.m4.md
View File

@ -3149,14 +3149,15 @@ won't need this rule.
```rules ```rules
skip N skip N
``` ```
The word "skip" followed by a number (or no number, meaning 1) The word `skip` followed by a number (or no number, meaning 1)
tells hledger to ignore this many non-empty lines preceding the CSV data. tells hledger to ignore this many non-empty lines at the start of the input data.
(Empty/blank lines are skipped automatically.) (Empty/blank lines are skipped automatically, so you don't need to count those.)
You'll need this whenever your CSV data contains header lines. You'll need this whenever your CSV data contains header lines.
Header lines skipped in this way are ignored, and not parsed as CSV.
It also has a second purpose: it can be used inside [if blocks](#if) (described below) `skip` can also be used inside [if blocks](#if) (described below),
to ignore certain CSV records. to skip individual data records.
Note records skipped in this way are still required to be [valid CSV](#valid-csv), even though otherwise ignored.
## `date-format` ## `date-format`