Debian Codegraph @

Hledger/Cli/Commands/Tags.txt

raw
1 tags
2
3 List the tag names used or declared in the journal, or their values.
4
5 Flags:
6 --used list tags used
7 --declared list tags declared
8 --undeclared list tags used but not declared
9 --unused list tags declared but not used
10 --find list the first tag whose name is matched by the
11 first argument (a case-insensitive infix regexp)
12 --values list tag values instead of tag names
13 --parsed show them in the order they were parsed (mostly),
14 including duplicates
15
16 This command lists tag names - all of them by default, or just the ones
17 which have been used on transactions/postings/accounts, or declared with
18 tag directives, or used but not declared, or declared but not used, or
19 just the first one matched by a pattern (with --find, returning a
20 non-zero exit code if it fails).
21
22 Note this command's non-standard first argument: it is a
23 case-insensitive infix regular expression for matching tag names, which
24 limits the tags shown. Any additional arguments are standard query
25 arguments, which limit the transactions, postings, or accounts providing
26 tags.
27
28 With --values, the tags' unique non-empty values are listed instead.
29
30 With -E/--empty, blank/empty values are also shown.
31
32 With --parsed, tags or values are shown in the order they were parsed,
33 with duplicates included. (Except, tags from account declarations are
34 always shown first.)
35
36 Remember that accounts also acquire tags from their parents; postings
37 also acquire tags from their account and transaction; and transactions
38 also acquire tags from their postings.