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

;doc:csv: How CSV rules are evaluated: clarify

Browse Source
This commit is contained in:
Simon Michael 2025-04-16 16:41:07 -10:00
parent 5c3197dd42
commit b54766c77a
1 changed files with 4 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
hledger/hledger.m4.md
View File

@ -4255,8 +4255,8 @@ If you get a confusing error while reading a CSV file, it may help to try to und
1. Any [included](#include) rules files are inlined, from top to bottom, depth first 1. Any [included](#include) rules files are inlined, from top to bottom, depth first
(scanning each included file for further includes, recursively, before proceeding). (scanning each included file for further includes, recursively, before proceeding).
2. Top level rules (`date-format`, `fields`, `newest-first`, `skip` at top level, etc) 2. Top level rules (`date-format`, `fields`, `newest-first`, `skip` etc) are read, top to bottom.
are read, top to bottom. "Top level rules" means non-conditional rules.
If a rule occurs more than once, the last one wins; If a rule occurs more than once, the last one wins;
except for `skip`/`end` rules, where the first one wins. except for `skip`/`end` rules, where the first one wins.
@ -4266,9 +4266,9 @@ If you get a confusing error while reading a CSV file, it may help to try to und
4. Any top-level skip or end rule is applied. 4. Any top-level skip or end rule is applied.
`skip [N]` immediately skips the current or next N CSV records; `skip [N]` immediately skips the current or next N CSV records;
`end` immediately skips all remaining CSV records. `end` immediately skips all remaining CSV records (not normally used at top level).
5. Now the remaining CSV records are processed. For CSV record, in file order: 5. Now any remaining CSV records are processed. For each CSV record, in file order:
- Is there a conditional skip/end rule that applies for this record ? - Is there a conditional skip/end rule that applies for this record ?
Search the `if` blocks, from top to bottom, for a succeeding one containing a `skip` or `end` rule. Search the `if` blocks, from top to bottom, for a succeeding one containing a `skip` or `end` rule.