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

;doc: tags: discuss multi-values/overriding (#1950)

Browse Source
This commit is contained in:
Simon Michael 2022-12-06 08:15:06 -10:00
parent 5e4e69f390
commit e72350ae75
1 changed files with 11 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
hledger/hledger.m4.md
View File

@ -2360,7 +2360,7 @@ So in the example above,
Tags can have a value, which is the text after the colon, Tags can have a value, which is the text after the colon,
until the next comma or end of line, with surrounding whitespace stripped. until the next comma or end of line, with surrounding whitespace stripped.
Note this means that hledger tag values may not contain commas. Note this means that hledger tag values can not contain commas.
For example, in this posting: For example, in this posting:
```journal ```journal
expenses:food $10 ; foo, tag1: value 1 , tag2:value 2, bar tag3: , baz expenses:food $10 ; foo, tag1: value 1 , tag2:value 2, bar tag3: , baz
@ -2370,6 +2370,16 @@ For example, in this posting:
- `tag2`'s value is "value 2" - `tag2`'s value is "value 2"
- `tag3`'s value is "" (the empty string) - `tag3`'s value is "" (the empty string)
Note that tags are multi-valued. When a tag name is seen again with a new value,
the new value is added, rather than overriding the previous value.
Currently this is true for all same-tag situations, ie:
- Same tag on multiple transactions
- Posting inheriting the same tag from its transaction or account
- Transaction acquiring the same tag from one or more of its postings
To list all of a tag's values: `hledger tags --values TAGNAME`
## Postings ## Postings
A posting is an addition of some amount to, or removal of some amount from, an account. A posting is an addition of some amount to, or removal of some amount from, an account.