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

;doc: tags: clarify additive, not overriding (#1950)

Browse Source
This commit is contained in:
Simon Michael 2023-01-04 22:59:23 -10:00
parent 550c248088
commit 069b57561f
1 changed files with 3 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
hledger/hledger.m4.md
View File

@ -1644,13 +1644,9 @@ Eg in the following posting, the three tags' values are "value 1", "value 2", an
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
``` ```
Note that tags are multi-valued. When a tag name is seen again with a new value, Note that tags can be repeated, and are additive rather than overriding:
the new value is added, rather than overriding the previous value. when the same tag name is seen again with a new value, the new name:value pair is added to the tags.
Currently this is true for all same-tag situations, ie: (It is not possible to override a tag's value or remove a tag.)
- 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
You can list a tag's values with `hledger tags TAGNAME --values`, You can list a tag's values with `hledger tags TAGNAME --values`,
or match by tag value with a `tag:NAMEREGEX=VALUEREGEX` query. or match by tag value with a `tag:NAMEREGEX=VALUEREGEX` query.