doc: assertions: edit

This commit is contained in:
Simon Michael 2022-04-04 13:03:48 -10:00
parent 0231ee1124
commit c185bfef58

View File

@ -2511,19 +2511,22 @@ Multiple files included with the [`include` directive](#including-other-files)
are processed as if concatenated into one file, preserving are processed as if concatenated into one file, preserving
their order and the posting order within each file. their order and the posting order within each file.
It means that balance assertions in later files will see balance from earlier files. It means that balance assertions in later files will see balance from earlier files.
And if you have multiple postings to an account on the same day, split And if you have multiple postings to an account on the same day, split
across multiple files, and you want to assert the account's balance on across multiple files, and you want to assert the account's balance on
that day, you'll need to put the assertion in the right file (the last that day, you'll need to put the assertion in the right file - the
one in the sequence, probably). last one in the sequence, probably.
### Assertions and multiple -f files ### Assertions and multiple -f files
Multiple files specified on the command line with multiple `-f/--file` options Unlike `include`, when multiple files are specified on the command
are processed in sequence, but separately, and balance assertions will not line with multiple `-f/--file` options, balance assertions will not
see balance from earlier files. This can actually be useful, when you do not see balance from earlier files. This can be useful when you do not
want older files to potentially break valid balance assertions in newer files. want problems in earlier files to disrupt valid assertions in later
If you want assertions to see balance from earlier files, use `include` as above, files.
or [concatenate the files](#input-files) temporarily.
If you do want assertions to see balance from earlier files, use
`include`, or concatenate the files temporarily.
### Assertions and commodities ### Assertions and commodities