From 6afff58fb845deb30bfc44f3cb07cfbf1d1cc39f Mon Sep 17 00:00:00 2001 From: hamzashezad <9590983+hamzashezad@users.noreply.github.com> Date: Fri, 12 Jan 2024 23:57:13 +0000 Subject: [PATCH] ;doc: add version annotations for features in 1.32 - match groups and match negations - beancount output format - tsv output format - consistently add annotation - `--round` for print --- hledger/Hledger/Cli/Commands/Aregister.md | 2 +- hledger/Hledger/Cli/Commands/Balance.md | 2 +- hledger/Hledger/Cli/Commands/Balancesheet.md | 2 +- hledger/Hledger/Cli/Commands/Cashflow.md | 2 +- hledger/Hledger/Cli/Commands/Incomestatement.md | 2 +- hledger/Hledger/Cli/Commands/Print.md | 4 ++-- hledger/Hledger/Cli/Commands/Register.md | 2 +- hledger/hledger.m4.md | 6 ++++-- 8 files changed, 12 insertions(+), 10 deletions(-) diff --git a/hledger/Hledger/Cli/Commands/Aregister.md b/hledger/Hledger/Cli/Commands/Aregister.md index c32046b36..4e1fd00e7 100644 --- a/hledger/Hledger/Cli/Commands/Aregister.md +++ b/hledger/Hledger/Cli/Commands/Aregister.md @@ -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 diff --git a/hledger/Hledger/Cli/Commands/Balance.md b/hledger/Hledger/Cli/Commands/Balance.md index 1c87ac46e..cd3b5f106 100644 --- a/hledger/Hledger/Cli/Commands/Balance.md +++ b/hledger/Hledger/Cli/Commands/Balance.md @@ -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 diff --git a/hledger/Hledger/Cli/Commands/Balancesheet.md b/hledger/Hledger/Cli/Commands/Balancesheet.md index 02097e71d..71d5b4a1f 100644 --- a/hledger/Hledger/Cli/Commands/Balancesheet.md +++ b/hledger/Hledger/Cli/Commands/Balancesheet.md @@ -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`. diff --git a/hledger/Hledger/Cli/Commands/Cashflow.md b/hledger/Hledger/Cli/Commands/Cashflow.md index f60aacc47..6ed2c1daa 100644 --- a/hledger/Hledger/Cli/Commands/Cashflow.md +++ b/hledger/Hledger/Cli/Commands/Cashflow.md @@ -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`. diff --git a/hledger/Hledger/Cli/Commands/Incomestatement.md b/hledger/Hledger/Cli/Commands/Incomestatement.md index c29d0fca2..df997f53f 100644 --- a/hledger/Hledger/Cli/Commands/Incomestatement.md +++ b/hledger/Hledger/Cli/Commands/Incomestatement.md @@ -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`. diff --git a/hledger/Hledger/Cli/Commands/Print.md b/hledger/Hledger/Cli/Commands/Print.md index b9f694450..bebf8e6a0 100644 --- a/hledger/Hledger/Cli/Commands/Print.md +++ b/hledger/Hledger/Cli/Commands/Print.md @@ -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) @@ -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: diff --git a/hledger/Hledger/Cli/Commands/Register.md b/hledger/Hledger/Cli/Commands/Register.md index d6371c0b5..717c09179 100644 --- a/hledger/Hledger/Cli/Commands/Register.md +++ b/hledger/Hledger/Cli/Commands/Register.md @@ -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`. diff --git a/hledger/hledger.m4.md b/hledger/hledger.m4.md index 8af43381e..0f81e0806 100644 --- a/hledger/hledger.m4.md +++ b/hledger/hledger.m4.md @@ -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 @@ -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,