Skip to content

Commit

Permalink
;doc: add version annotations for features in 1.32
Browse files Browse the repository at this point in the history
- match groups and match negations
- beancount output format
- tsv output format
- consistently add annotation
- `--round` for print
  • Loading branch information
hamzashezad authored and simonmichael committed Jan 17, 2024
1 parent 6461839 commit 6afff58
Show file tree
Hide file tree
Showing 8 changed files with 12 additions and 10 deletions.
2 changes: 1 addition & 1 deletion hledger/Hledger/Cli/Commands/Aregister.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,7 @@ at the cost of more time and memory, use the `--align-all` flag.
This command also supports the
[output destination](hledger.html#output-destination) and
[output format](hledger.html#output-format) options.
The output formats supported are `txt`, `csv`, `tsv`, and `json`.
The output formats supported are `txt`, `csv`, `tsv` (*Added in 1.32*), and `json`.

### aregister and posting dates

Expand Down
2 changes: 1 addition & 1 deletion hledger/Hledger/Cli/Commands/Balance.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,7 @@ Many of these work with the higher-level commands as well.
This command supports the
[output destination](#output-destination) and
[output format](#output-format) options,
with output formats `txt`, `csv`, `tsv`, `json`, and (multi-period reports only:) `html`.
with output formats `txt`, `csv`, `tsv` (*Added in 1.32*), `json`, and (multi-period reports only:) `html`.
In `txt` output in a colour-supporting terminal, negative amounts are shown in red.

The `--related`/`-r` flag shows the balance of the *other* postings in the
Expand Down
2 changes: 1 addition & 1 deletion hledger/Hledger/Cli/Commands/Balancesheet.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,4 +48,4 @@ This command also supports the
[output destination](hledger.html#output-destination) and
[output format](hledger.html#output-format) options
The output formats supported are
`txt`, `csv`, `tsv`, `html`, and `json`.
`txt`, `csv`, `tsv` (*Added in 1.32*), `html`, and `json`.
2 changes: 1 addition & 1 deletion hledger/Hledger/Cli/Commands/Cashflow.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,4 +48,4 @@ This command also supports the
[output destination](hledger.html#output-destination) and
[output format](hledger.html#output-format) options
The output formats supported are
`txt`, `csv`, `tsv`, `html`, and `json`.
`txt`, `csv`, `tsv` (*Added in 1.32*), `html`, and `json`.
2 changes: 1 addition & 1 deletion hledger/Hledger/Cli/Commands/Incomestatement.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,4 +49,4 @@ This command also supports the
[output destination](hledger.html#output-destination) and
[output format](hledger.html#output-format) options
The output formats supported are
`txt`, `csv`, `tsv`, `html`, and `json`.
`txt`, `csv`, `tsv` (*Added in 1.32*), `html`, and `json`.
4 changes: 2 additions & 2 deletions hledger/Hledger/Cli/Commands/Print.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ Amounts will be (mostly) normalised to their [commodity display style](#commodit
their symbol placement, decimal mark, and digit group marks will be made consistent.
By default, decimal digits are shown as they are written in the journal.

With the `--round` option, `print` will try increasingly hard to
With the `--round` (*Added in 1.32*) option, `print` will try increasingly hard to
display decimal digits according to the [commodity display styles](#commodity-display-style):

- `--round=none` show amounts with original precisions (default)
Expand Down Expand Up @@ -115,7 +115,7 @@ This command also supports the
[output destination](hledger.html#output-destination) and
[output format](hledger.html#output-format) options
The output formats supported are
`txt`, `beancount`, `csv`, `tsv`, `json` and `sql`.
`txt`, `beancount` (*Added in 1.32*), `csv`, `tsv` (*Added in 1.32*), `json` and `sql`.

The `beancount` format tries to produce Beancount-compatible output, as follows:

Expand Down
2 changes: 1 addition & 1 deletion hledger/Hledger/Cli/Commands/Register.md
Original file line number Diff line number Diff line change
Expand Up @@ -142,4 +142,4 @@ This command also supports the
[output destination](hledger.html#output-destination) and
[output format](hledger.html#output-format) options
The output formats supported are
`txt`, `csv`, `tsv`, and `json`.
`txt`, `csv`, `tsv` (*Added in 1.32*), and `json`.
6 changes: 4 additions & 2 deletions hledger/hledger.m4.md
Original file line number Diff line number Diff line change
Expand Up @@ -3338,13 +3338,15 @@ When an if block has multiple matchers, they are combined as follows:

- By default they are OR'd (any one of them can match)
- When a matcher is preceded by ampersand (`&`) it will be AND'ed with the previous matcher (both of them must match)
- When a matcher is preceded by an exclamation mark (`!`), the matcher is negated (it may not match).
- *Added in 1.32* When a matcher is preceded by an exclamation mark (`!`), the matcher is negated (it may not match).

[Currently](https://github.com/simonmichael/hledger/pull/2088#issuecomment-1844200398) there is a limitation:
you can't use both `&` and `!` on the same line (you can't AND a negated matcher).

### Match groups

*Added in 1.32*

Matchers can define match groups: parenthesised portions of the regular expression
which are available for reference in field assignments. Groups are enclosed
in regular parentheses (`(` and `)`) and can be nested. Each group is available
Expand Down Expand Up @@ -4240,7 +4242,7 @@ After the date line are zero or more time postings, consisting of:
These are the dots in "timedot".
Spaces are ignored and can be used for grouping/alignment.
- one or more letters. These are like dots but they also generate
- *Added in 1.32* one or more letters. These are like dots but they also generate
a tag `t:` (short for "type") with the letter as its value,
and a separate posting for each of the values.
This provides a second dimension of categorisation,
Expand Down

0 comments on commit 6afff58

Please sign in to comment.