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

;doc: update embedded manuals

Browse Source
This commit is contained in:
Simon Michael 2025-03-08 12:46:13 -10:00
parent b31091195b
commit dcd5221489
6 changed files with 2933 additions and 2883 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
hledger-web/hledger-web.1
View File

@ -51,15 +51,14 @@ with a date field.
.PP .PP
hledger\-web can be run in three modes: hledger\-web can be run in three modes:
.IP \[bu] 2 .IP \[bu] 2
Transient mode (the default): your default web browser will be opened to \f[CR]\-\-serve\-browse\f[R] mode (the default): the app serves the web
show the app if possible, and the app exits automatically after two UI and JSON API, and opens your default web browser to show the app if
minutes of inactivity (no requests received and no open browser windows possible, and exits automatically after two minutes of inactivity (with
viewing it). no requests received and no open browser windows viewing it).
.IP \[bu] 2 .IP \[bu] 2
With \f[CR]\-\-serve\f[R]: the app runs without stopping, and without \f[CR]\-\-serve\f[R]: the app just serves the web UI and JSON API.
opening a browser.
.IP \[bu] 2 .IP \[bu] 2
With \f[CR]\-\-serve\-api\f[R]: only the JSON API is served. \f[CR]\-\-serve\-api\f[R]: the app just serves the JSON API.
.PP .PP
In all cases hledger\-web runs as a foreground process, logging requests In all cases hledger\-web runs as a foreground process, logging requests
to stdout. to stdout.

31
hledger-web/hledger-web.info
View File

@ -47,15 +47,14 @@ with a date field. (See hledger(1) -> Input for details.)
hledger-web can be run in three modes: hledger-web can be run in three modes:
* Transient mode (the default): your default web browser will be * '--serve-browse' mode (the default): the app serves the web UI and
opened to show the app if possible, and the app exits automatically JSON API, and opens your default web browser to show the app if
after two minutes of inactivity (no requests received and no open possible, and exits automatically after two minutes of inactivity
browser windows viewing it). (with no requests received and no open browser windows viewing it).
* With '--serve': the app runs without stopping, and without opening * '--serve': the app just serves the web UI and JSON API.
a browser.
* With '--serve-api': only the JSON API is served. * '--serve-api': the app just serves the JSON API.
In all cases hledger-web runs as a foreground process, logging In all cases hledger-web runs as a foreground process, logging
requests to stdout. requests to stdout.
@ -529,15 +528,15 @@ https://bugs.hledger.org), or on the hledger chat or mail list
 
Tag Table: Tag Table:
Node: Top223 Node: Top223
Node: OPTIONS2569 Node: OPTIONS2581
Node: PERMISSIONS11258 Node: PERMISSIONS11270
Node: EDITING UPLOADING DOWNLOADING12609 Node: EDITING UPLOADING DOWNLOADING12621
Node: RELOADING13624 Node: RELOADING13636
Node: JSON API14191 Node: JSON API14203
Node: DEBUG OUTPUT19840 Node: DEBUG OUTPUT19852
Node: Debug output19992 Node: Debug output20004
Node: ENVIRONMENT20510 Node: ENVIRONMENT20522
Node: BUGS20746 Node: BUGS20758
 
End Tag Table End Tag Table

13
hledger-web/hledger-web.txt
View File

@ -40,15 +40,14 @@ DESCRIPTION
hledger-web can be run in three modes: hledger-web can be run in three modes:
o Transient mode (the default): your default web browser will be opened o --serve-browse mode (the default): the app serves the web UI and JSON
to show the app if possible, and the app exits automatically after API, and opens your default web browser to show the app if possible,
two minutes of inactivity (no requests received and no open browser and exits automatically after two minutes of inactivity (with no re-
windows viewing it). quests received and no open browser windows viewing it).
o With --serve: the app runs without stopping, and without opening a o --serve: the app just serves the web UI and JSON API.
browser.
o With --serve-api: only the JSON API is served. o --serve-api: the app just serves the JSON API.
In all cases hledger-web runs as a foreground process, logging requests In all cases hledger-web runs as a foreground process, logging requests
to stdout. to stdout.

253
hledger/hledger.1
View File

@ -447,8 +447,12 @@ Usually hledger accepts any unambiguous flag prefix, eg you can write
\f[CR]\-\-tl\f[R] instead of \f[CR]\-\-tldr\f[R] or \f[CR]\-\-dry\f[R] \f[CR]\-\-tl\f[R] instead of \f[CR]\-\-tldr\f[R] or \f[CR]\-\-dry\f[R]
instead of \f[CR]\-\-dry\-run\f[R]. instead of \f[CR]\-\-dry\-run\f[R].
.PP .PP
If the same option appears more than once in a command, usually the last If the same option appears more than once in a command line, usually the
(right\-most) wins. last (right\-most) wins.
Similarly, if mutually exclusive flags are used together, the
right\-most wins.
(When flags are mutually exclusive, they\[aq]ll usually have a group
prefix in \-\-help.)
.PP .PP
With most commands, arguments are interpreted as a hledger query which With most commands, arguments are interpreted as a hledger query which
filter the data. filter the data.
@ -8975,8 +8979,9 @@ Flags:
\-\-find find the first account matched by the first \-\-find find the first account matched by the first
argument (a case\-insensitive infix regexp or argument (a case\-insensitive infix regexp or
account name) account name)
\-l \-\-flat show accounts as a flat list (default) \-l \-\-flat list/tree mode: show accounts as a flat list
\-t \-\-tree show accounts as a tree (default)
\-t \-\-tree list/tree mode: show accounts as a tree
\-\-drop=N flat mode: omit N leading account name parts \-\-drop=N flat mode: omit N leading account name parts
.EE .EE
.PP .PP
@ -9525,9 +9530,11 @@ Flags:
date. Warning: this can show a wrong running date. Warning: this can show a wrong running
balance. balance.
\-\-no\-elide don\[aq]t show only 2 commodities per amount \-\-no\-elide don\[aq]t show only 2 commodities per amount
\-\-cumulative show running total from report start date \-\-cumulative accumulation mode: show running total from report
\-H \-\-historical show historical running total/balance (includes start date
postings before report start date) (default) \-H \-\-historical accumulation mode: show historical running
total/balance (includes postings before report
start date) (default)
\-\-invert display all amounts with reversed sign \-\-invert display all amounts with reversed sign
\-\-heading=YN show heading row above table: yes (default) or no \-\-heading=YN show heading row above table: yes (default) or no
\-w \-\-width=N set output width (default: terminal width). \-wN,M \-w \-\-width=N set output width (default: terminal width). \-wN,M
@ -9638,10 +9645,11 @@ Show postings and their running total.
.IP .IP
.EX .EX
Flags: Flags:
\-\-cumulative show running total from report start date \-\-cumulative accumulation mode: show running total from report
(default) start date (default)
\-H \-\-historical show historical running total/balance (includes \-H \-\-historical accumulation mode: show historical running
postings before report start date) total/balance (includes postings before report
start date)
\-A \-\-average show running average of posting amounts instead \-A \-\-average show running average of posting amounts instead
of total (implies \-\-empty) of total (implies \-\-empty)
\-m \-\-match=DESC fuzzy search for one recent posting with \-m \-\-match=DESC fuzzy search for one recent posting with
@ -9826,26 +9834,28 @@ financial statements.
.IP .IP
.EX .EX
Flags: Flags:
\-\-sum show sum of posting amounts (default) \-\-sum calculation mode: show sum of posting amounts
\-\-valuechange show total change of period\-end historical
balance value (caused by deposits, withdrawals,
market price fluctuations)
\-\-gain show unrealised capital gain/loss (historical
balance value minus cost basis)
\-\-count show the count of postings
\-\-change accumulate amounts from column start to column
end (in multicolumn reports)
\-\-cumulative accumulate amounts from report start (specified
by e.g. \-b/\-\-begin) to column end
\-H \-\-historical accumulate amounts from journal start to column
end (includes postings before report start date)
(default) (default)
\-l \-\-flat show accounts as a flat list (default). Amounts \-\-valuechange calculation mode: show total change of value of
exclude subaccount amounts, except where the period\-end historical balances (caused by deposits,
account is depth\-clipped. withdrawals, market price fluctuations)
\-t \-\-tree show accounts as a tree. Amounts include \-\-gain calculation mode: show unrealised capital
subaccount amounts. gain/loss (historical balance value minus cost
\-\-drop=N flat mode: omit N leading account name parts basis)
\-\-count calculation mode: show the count of postings
\-\-change accumulation mode: accumulate amounts from column
start to column end (in multicolumn reports)
\-\-cumulative accumulation mode: accumulate amounts from report
start (specified by e.g. \-b/\-\-begin) to column end
\-H \-\-historical accumulation mode: accumulate amounts from
journal start to column end (includes postings
before report start date) (default)
\-l \-\-flat list/tree mode: show accounts as a flat list
(default). Amounts exclude subaccount amounts,
except where the account is depth\-clipped.
\-t \-\-tree list/tree mode: show accounts as a tree. Amounts
include subaccount amounts.
\-\-drop=N in list mode, omit N leading account name parts
\-\-declared include non\-parent declared accounts (best used \-\-declared include non\-parent declared accounts (best used
with \-E) with \-E)
\-A \-\-average show a row average column (in multicolumn \-A \-\-average show a row average column (in multicolumn
@ -9854,8 +9864,7 @@ Flags:
\-\-summary\-only display only row summaries (e.g. row total, \-\-summary\-only display only row summaries (e.g. row total,
average) (in multicolumn reports) average) (in multicolumn reports)
\-N \-\-no\-total omit the final total row \-N \-\-no\-total omit the final total row
\-\-no\-elide don\[aq]t squash boring parent accounts (in tree \-\-no\-elide in tree mode, don\[aq]t squash boring parent accounts
mode)
\-\-format=FORMATSTR use this custom line format (in simple reports) \-\-format=FORMATSTR use this custom line format (in simple reports)
\-S \-\-sort\-amount sort by amount instead of account code/name \-S \-\-sort\-amount sort by amount instead of account code/name
\-% \-\-percent express values in percentage of each column\[aq]s \-% \-\-percent express values in percentage of each column\[aq]s
@ -9928,26 +9937,28 @@ financial statements.
.IP .IP
.EX .EX
Flags: Flags:
\-\-sum show sum of posting amounts (default) \-\-sum calculation mode: show sum of posting amounts
\-\-valuechange show total change of period\-end historical
balance value (caused by deposits, withdrawals,
market price fluctuations)
\-\-gain show unrealised capital gain/loss (historical
balance value minus cost basis)
\-\-count show the count of postings
\-\-change accumulate amounts from column start to column
end (in multicolumn reports)
\-\-cumulative accumulate amounts from report start (specified
by e.g. \-b/\-\-begin) to column end
\-H \-\-historical accumulate amounts from journal start to column
end (includes postings before report start date)
(default) (default)
\-l \-\-flat show accounts as a flat list (default). Amounts \-\-valuechange calculation mode: show total change of value of
exclude subaccount amounts, except where the period\-end historical balances (caused by deposits,
account is depth\-clipped. withdrawals, market price fluctuations)
\-t \-\-tree show accounts as a tree. Amounts include \-\-gain calculation mode: show unrealised capital
subaccount amounts. gain/loss (historical balance value minus cost
\-\-drop=N flat mode: omit N leading account name parts basis)
\-\-count calculation mode: show the count of postings
\-\-change accumulation mode: accumulate amounts from column
start to column end (in multicolumn reports)
\-\-cumulative accumulation mode: accumulate amounts from report
start (specified by e.g. \-b/\-\-begin) to column end
\-H \-\-historical accumulation mode: accumulate amounts from
journal start to column end (includes postings
before report start date) (default)
\-l \-\-flat list/tree mode: show accounts as a flat list
(default). Amounts exclude subaccount amounts,
except where the account is depth\-clipped.
\-t \-\-tree list/tree mode: show accounts as a tree. Amounts
include subaccount amounts.
\-\-drop=N in list mode, omit N leading account name parts
\-\-declared include non\-parent declared accounts (best used \-\-declared include non\-parent declared accounts (best used
with \-E) with \-E)
\-A \-\-average show a row average column (in multicolumn \-A \-\-average show a row average column (in multicolumn
@ -9956,8 +9967,7 @@ Flags:
\-\-summary\-only display only row summaries (e.g. row total, \-\-summary\-only display only row summaries (e.g. row total,
average) (in multicolumn reports) average) (in multicolumn reports)
\-N \-\-no\-total omit the final total row \-N \-\-no\-total omit the final total row
\-\-no\-elide don\[aq]t squash boring parent accounts (in tree \-\-no\-elide in tree mode, don\[aq]t squash boring parent accounts
mode)
\-\-format=FORMATSTR use this custom line format (in simple reports) \-\-format=FORMATSTR use this custom line format (in simple reports)
\-S \-\-sort\-amount sort by amount instead of account code/name \-S \-\-sort\-amount sort by amount instead of account code/name
\-% \-\-percent express values in percentage of each column\[aq]s \-% \-\-percent express values in percentage of each column\[aq]s
@ -10038,25 +10048,29 @@ financial statements.
.IP .IP
.EX .EX
Flags: Flags:
\-\-sum show sum of posting amounts (default) \-\-sum calculation mode: show sum of posting amounts
\-\-valuechange show total change of period\-end historical (default)
balance value (caused by deposits, withdrawals, \-\-valuechange calculation mode: show total change of value of
market price fluctuations) period\-end historical balances (caused by deposits,
\-\-gain show unrealised capital gain/loss (historical withdrawals, market price fluctuations)
balance value minus cost basis) \-\-gain calculation mode: show unrealised capital
\-\-count show the count of postings gain/loss (historical balance value minus cost
\-\-change accumulate amounts from column start to column basis)
end (in multicolumn reports) (default) \-\-count calculation mode: show the count of postings
\-\-cumulative accumulate amounts from report start (specified \-\-change accumulation mode: accumulate amounts from column
by e.g. \-b/\-\-begin) to column end start to column end (in multicolumn reports)
\-H \-\-historical accumulate amounts from journal start to column (default)
end (includes postings before report start date) \-\-cumulative accumulation mode: accumulate amounts from report
\-l \-\-flat show accounts as a flat list (default). Amounts start (specified by e.g. \-b/\-\-begin) to column end
exclude subaccount amounts, except where the \-H \-\-historical accumulation mode: accumulate amounts from
account is depth\-clipped. journal start to column end (includes postings
\-t \-\-tree show accounts as a tree. Amounts include before report start date)
subaccount amounts. \-l \-\-flat list/tree mode: show accounts as a flat list
\-\-drop=N flat mode: omit N leading account name parts (default). Amounts exclude subaccount amounts,
except where the account is depth\-clipped.
\-t \-\-tree list/tree mode: show accounts as a tree. Amounts
include subaccount amounts.
\-\-drop=N in list mode, omit N leading account name parts
\-\-declared include non\-parent declared accounts (best used \-\-declared include non\-parent declared accounts (best used
with \-E) with \-E)
\-A \-\-average show a row average column (in multicolumn \-A \-\-average show a row average column (in multicolumn
@ -10065,8 +10079,7 @@ Flags:
\-\-summary\-only display only row summaries (e.g. row total, \-\-summary\-only display only row summaries (e.g. row total,
average) (in multicolumn reports) average) (in multicolumn reports)
\-N \-\-no\-total omit the final total row \-N \-\-no\-total omit the final total row
\-\-no\-elide don\[aq]t squash boring parent accounts (in tree \-\-no\-elide in tree mode, don\[aq]t squash boring parent accounts
mode)
\-\-format=FORMATSTR use this custom line format (in simple reports) \-\-format=FORMATSTR use this custom line format (in simple reports)
\-S \-\-sort\-amount sort by amount instead of account code/name \-S \-\-sort\-amount sort by amount instead of account code/name
\-% \-\-percent express values in percentage of each column\[aq]s \-% \-\-percent express values in percentage of each column\[aq]s
@ -10137,25 +10150,29 @@ financial statements.
.IP .IP
.EX .EX
Flags: Flags:
\-\-sum show sum of posting amounts (default) \-\-sum calculation mode: show sum of posting amounts
\-\-valuechange show total change of period\-end historical (default)
balance value (caused by deposits, withdrawals, \-\-valuechange calculation mode: show total change of value of
market price fluctuations) period\-end historical balances (caused by deposits,
\-\-gain show unrealised capital gain/loss (historical withdrawals, market price fluctuations)
balance value minus cost basis) \-\-gain calculation mode: show unrealised capital
\-\-count show the count of postings gain/loss (historical balance value minus cost
\-\-change accumulate amounts from column start to column basis)
end (in multicolumn reports) (default) \-\-count calculation mode: show the count of postings
\-\-cumulative accumulate amounts from report start (specified \-\-change accumulation mode: accumulate amounts from column
by e.g. \-b/\-\-begin) to column end start to column end (in multicolumn reports)
\-H \-\-historical accumulate amounts from journal start to column (default)
end (includes postings before report start date) \-\-cumulative accumulation mode: accumulate amounts from report
\-l \-\-flat show accounts as a flat list (default). Amounts start (specified by e.g. \-b/\-\-begin) to column end
exclude subaccount amounts, except where the \-H \-\-historical accumulation mode: accumulate amounts from
account is depth\-clipped. journal start to column end (includes postings
\-t \-\-tree show accounts as a tree. Amounts include before report start date)
subaccount amounts. \-l \-\-flat list/tree mode: show accounts as a flat list
\-\-drop=N flat mode: omit N leading account name parts (default). Amounts exclude subaccount amounts,
except where the account is depth\-clipped.
\-t \-\-tree list/tree mode: show accounts as a tree. Amounts
include subaccount amounts.
\-\-drop=N in list mode, omit N leading account name parts
\-\-declared include non\-parent declared accounts (best used \-\-declared include non\-parent declared accounts (best used
with \-E) with \-E)
\-A \-\-average show a row average column (in multicolumn \-A \-\-average show a row average column (in multicolumn
@ -10164,8 +10181,7 @@ Flags:
\-\-summary\-only display only row summaries (e.g. row total, \-\-summary\-only display only row summaries (e.g. row total,
average) (in multicolumn reports) average) (in multicolumn reports)
\-N \-\-no\-total omit the final total row \-N \-\-no\-total omit the final total row
\-\-no\-elide don\[aq]t squash boring parent accounts (in tree \-\-no\-elide in tree mode, don\[aq]t squash boring parent accounts
mode)
\-\-format=FORMATSTR use this custom line format (in simple reports) \-\-format=FORMATSTR use this custom line format (in simple reports)
\-S \-\-sort\-amount sort by amount instead of account code/name \-S \-\-sort\-amount sort by amount instead of account code/name
\-% \-\-percent express values in percentage of each column\[aq]s \-% \-\-percent express values in percentage of each column\[aq]s
@ -10240,32 +10256,36 @@ performance, unrealised capital gains, etc.
.IP .IP
.EX .EX
Flags: Flags:
\-\-sum show sum of posting amounts (default) \-\-sum calculation mode: show sum of posting amounts
\-\-valuechange show total change of value of period\-end (default)
historical balances (caused by deposits, \-\-valuechange calculation mode: show total change of value of
period\-end historical balances (caused by deposits,
withdrawals, market price fluctuations) withdrawals, market price fluctuations)
\-\-gain show unrealised capital gain/loss (historical \-\-gain calculation mode: show unrealised capital
balance value minus cost basis) gain/loss (historical balance value minus cost
\-\-budget[=DESCPAT] show sum of posting amounts together with budget basis)
goals defined by periodic \-\-budget[=DESCPAT] calculation mode: show sum of posting amounts
together with budget goals defined by periodic
transactions. With a DESCPAT argument (must be transactions. With a DESCPAT argument (must be
separated by = not space), separated by = not space),
use only periodic transactions with matching use only periodic transactions with matching
description description
(case insensitive substring match). (case insensitive substring match).
\-\-count show the count of postings \-\-count calculation mode: show the count of postings
\-\-change accumulate amounts from column start to column \-\-change accumulation mode: accumulate amounts from column
end (in multicolumn reports, default) start to column end (in multicolumn reports,
\-\-cumulative accumulate amounts from report start (specified default)
by e.g. \-b/\-\-begin) to column end \-\-cumulative accumulation mode: accumulate amounts from report
\-H \-\-historical accumulate amounts from journal start to column start (specified by e.g. \-b/\-\-begin) to column end
end (includes postings before report start date) \-H \-\-historical accumulation mode: accumulate amounts from
\-l \-\-flat show accounts as a flat list (default). Amounts journal start to column end (includes postings
exclude subaccount amounts, except where the before report start date)
account is depth\-clipped. \-l \-\-flat list/tree mode: show accounts as a flat list
\-t \-\-tree show accounts as a tree. Amounts include (default). Amounts exclude subaccount amounts,
subaccount amounts. except where the account is depth\-clipped.
\-\-drop=N omit N leading account name parts (in flat mode) \-t \-\-tree list/tree mode: show accounts as a tree. Amounts
include subaccount amounts.
\-\-drop=N in list mode, omit N leading account name parts
\-\-declared include non\-parent declared accounts (best used \-\-declared include non\-parent declared accounts (best used
with \-E) with \-E)
\-A \-\-average show a row average column (in multicolumn \-A \-\-average show a row average column (in multicolumn
@ -10274,8 +10294,7 @@ Flags:
\-\-summary\-only display only row summaries (e.g. row total, \-\-summary\-only display only row summaries (e.g. row total,
average) (in multicolumn reports) average) (in multicolumn reports)
\-N \-\-no\-total omit the final total row \-N \-\-no\-total omit the final total row
\-\-no\-elide don\[aq]t squash boring parent accounts (in tree \-\-no\-elide in tree mode, don\[aq]t squash boring parent accounts
mode)
\-\-format=FORMATSTR use this custom line format (in simple reports) \-\-format=FORMATSTR use this custom line format (in simple reports)
\-S \-\-sort\-amount sort by amount instead of account code/name (in \-S \-\-sort\-amount sort by amount instead of account code/name (in
flat mode). With multiple columns, sorts by the row flat mode). With multiple columns, sorts by the row

993
hledger/hledger.info
View File

File diff suppressed because it is too large Load Diff

251
hledger/hledger.txt
View File

@ -344,8 +344,10 @@ Options
Usually hledger accepts any unambiguous flag prefix, eg you can write Usually hledger accepts any unambiguous flag prefix, eg you can write
--tl instead of --tldr or --dry instead of --dry-run. --tl instead of --tldr or --dry instead of --dry-run.
If the same option appears more than once in a command, usually the If the same option appears more than once in a command line, usually
last (right-most) wins. the last (right-most) wins. Similarly, if mutually exclusive flags are
used together, the right-most wins. (When flags are mutually exclu-
sive, they'll usually have a group prefix in --help.)
With most commands, arguments are interpreted as a hledger query which With most commands, arguments are interpreted as a hledger query which
filter the data. Some queries can be expressed either with options or filter the data. Some queries can be expressed either with options or
@ -7025,8 +7027,9 @@ Basic report commands
--find find the first account matched by the first --find find the first account matched by the first
argument (a case-insensitive infix regexp or argument (a case-insensitive infix regexp or
account name) account name)
-l --flat show accounts as a flat list (default) -l --flat list/tree mode: show accounts as a flat list
-t --tree show accounts as a tree (default)
-t --tree list/tree mode: show accounts as a tree
--drop=N flat mode: omit N leading account name parts --drop=N flat mode: omit N leading account name parts
This command lists account names. By default it shows all known ac- This command lists account names. By default it shows all known ac-
@ -7511,9 +7514,11 @@ Standard report commands
date. Warning: this can show a wrong running date. Warning: this can show a wrong running
balance. balance.
--no-elide don't show only 2 commodities per amount --no-elide don't show only 2 commodities per amount
--cumulative show running total from report start date --cumulative accumulation mode: show running total from report
-H --historical show historical running total/balance (includes start date
postings before report start date) (default) -H --historical accumulation mode: show historical running
total/balance (includes postings before report
start date) (default)
--invert display all amounts with reversed sign --invert display all amounts with reversed sign
--heading=YN show heading row above table: yes (default) or no --heading=YN show heading row above table: yes (default) or no
-w --width=N set output width (default: terminal width). -wN,M -w --width=N set output width (default: terminal width). -wN,M
@ -7610,10 +7615,11 @@ Standard report commands
Show postings and their running total. Show postings and their running total.
Flags: Flags:
--cumulative show running total from report start date --cumulative accumulation mode: show running total from report
(default) start date (default)
-H --historical show historical running total/balance (includes -H --historical accumulation mode: show historical running
postings before report start date) total/balance (includes postings before report
start date)
-A --average show running average of posting amounts instead -A --average show running average of posting amounts instead
of total (implies --empty) of total (implies --empty)
-m --match=DESC fuzzy search for one recent posting with -m --match=DESC fuzzy search for one recent posting with
@ -7766,26 +7772,28 @@ Standard report commands
ments. ments.
Flags: Flags:
--sum show sum of posting amounts (default) --sum calculation mode: show sum of posting amounts
--valuechange show total change of period-end historical
balance value (caused by deposits, withdrawals,
market price fluctuations)
--gain show unrealised capital gain/loss (historical
balance value minus cost basis)
--count show the count of postings
--change accumulate amounts from column start to column
end (in multicolumn reports)
--cumulative accumulate amounts from report start (specified
by e.g. -b/--begin) to column end
-H --historical accumulate amounts from journal start to column
end (includes postings before report start date)
(default) (default)
-l --flat show accounts as a flat list (default). Amounts --valuechange calculation mode: show total change of value of
exclude subaccount amounts, except where the period-end historical balances (caused by deposits,
account is depth-clipped. withdrawals, market price fluctuations)
-t --tree show accounts as a tree. Amounts include --gain calculation mode: show unrealised capital
subaccount amounts. gain/loss (historical balance value minus cost
--drop=N flat mode: omit N leading account name parts basis)
--count calculation mode: show the count of postings
--change accumulation mode: accumulate amounts from column
start to column end (in multicolumn reports)
--cumulative accumulation mode: accumulate amounts from report
start (specified by e.g. -b/--begin) to column end
-H --historical accumulation mode: accumulate amounts from
journal start to column end (includes postings
before report start date) (default)
-l --flat list/tree mode: show accounts as a flat list
(default). Amounts exclude subaccount amounts,
except where the account is depth-clipped.
-t --tree list/tree mode: show accounts as a tree. Amounts
include subaccount amounts.
--drop=N in list mode, omit N leading account name parts
--declared include non-parent declared accounts (best used --declared include non-parent declared accounts (best used
with -E) with -E)
-A --average show a row average column (in multicolumn -A --average show a row average column (in multicolumn
@ -7794,8 +7802,7 @@ Standard report commands
--summary-only display only row summaries (e.g. row total, --summary-only display only row summaries (e.g. row total,
average) (in multicolumn reports) average) (in multicolumn reports)
-N --no-total omit the final total row -N --no-total omit the final total row
--no-elide don't squash boring parent accounts (in tree --no-elide in tree mode, don't squash boring parent accounts
mode)
--format=FORMATSTR use this custom line format (in simple reports) --format=FORMATSTR use this custom line format (in simple reports)
-S --sort-amount sort by amount instead of account code/name -S --sort-amount sort by amount instead of account code/name
-% --percent express values in percentage of each column's -% --percent express values in percentage of each column's
@ -7861,26 +7868,28 @@ Standard report commands
normal positive sign, as in conventional financial statements. normal positive sign, as in conventional financial statements.
Flags: Flags:
--sum show sum of posting amounts (default) --sum calculation mode: show sum of posting amounts
--valuechange show total change of period-end historical
balance value (caused by deposits, withdrawals,
market price fluctuations)
--gain show unrealised capital gain/loss (historical
balance value minus cost basis)
--count show the count of postings
--change accumulate amounts from column start to column
end (in multicolumn reports)
--cumulative accumulate amounts from report start (specified
by e.g. -b/--begin) to column end
-H --historical accumulate amounts from journal start to column
end (includes postings before report start date)
(default) (default)
-l --flat show accounts as a flat list (default). Amounts --valuechange calculation mode: show total change of value of
exclude subaccount amounts, except where the period-end historical balances (caused by deposits,
account is depth-clipped. withdrawals, market price fluctuations)
-t --tree show accounts as a tree. Amounts include --gain calculation mode: show unrealised capital
subaccount amounts. gain/loss (historical balance value minus cost
--drop=N flat mode: omit N leading account name parts basis)
--count calculation mode: show the count of postings
--change accumulation mode: accumulate amounts from column
start to column end (in multicolumn reports)
--cumulative accumulation mode: accumulate amounts from report
start (specified by e.g. -b/--begin) to column end
-H --historical accumulation mode: accumulate amounts from
journal start to column end (includes postings
before report start date) (default)
-l --flat list/tree mode: show accounts as a flat list
(default). Amounts exclude subaccount amounts,
except where the account is depth-clipped.
-t --tree list/tree mode: show accounts as a tree. Amounts
include subaccount amounts.
--drop=N in list mode, omit N leading account name parts
--declared include non-parent declared accounts (best used --declared include non-parent declared accounts (best used
with -E) with -E)
-A --average show a row average column (in multicolumn -A --average show a row average column (in multicolumn
@ -7889,8 +7898,7 @@ Standard report commands
--summary-only display only row summaries (e.g. row total, --summary-only display only row summaries (e.g. row total,
average) (in multicolumn reports) average) (in multicolumn reports)
-N --no-total omit the final total row -N --no-total omit the final total row
--no-elide don't squash boring parent accounts (in tree --no-elide in tree mode, don't squash boring parent accounts
mode)
--format=FORMATSTR use this custom line format (in simple reports) --format=FORMATSTR use this custom line format (in simple reports)
-S --sort-amount sort by amount instead of account code/name -S --sort-amount sort by amount instead of account code/name
-% --percent express values in percentage of each column's -% --percent express values in percentage of each column's
@ -7962,25 +7970,29 @@ Standard report commands
tional financial statements. tional financial statements.
Flags: Flags:
--sum show sum of posting amounts (default) --sum calculation mode: show sum of posting amounts
--valuechange show total change of period-end historical (default)
balance value (caused by deposits, withdrawals, --valuechange calculation mode: show total change of value of
market price fluctuations) period-end historical balances (caused by deposits,
--gain show unrealised capital gain/loss (historical withdrawals, market price fluctuations)
balance value minus cost basis) --gain calculation mode: show unrealised capital
--count show the count of postings gain/loss (historical balance value minus cost
--change accumulate amounts from column start to column basis)
end (in multicolumn reports) (default) --count calculation mode: show the count of postings
--cumulative accumulate amounts from report start (specified --change accumulation mode: accumulate amounts from column
by e.g. -b/--begin) to column end start to column end (in multicolumn reports)
-H --historical accumulate amounts from journal start to column (default)
end (includes postings before report start date) --cumulative accumulation mode: accumulate amounts from report
-l --flat show accounts as a flat list (default). Amounts start (specified by e.g. -b/--begin) to column end
exclude subaccount amounts, except where the -H --historical accumulation mode: accumulate amounts from
account is depth-clipped. journal start to column end (includes postings
-t --tree show accounts as a tree. Amounts include before report start date)
subaccount amounts. -l --flat list/tree mode: show accounts as a flat list
--drop=N flat mode: omit N leading account name parts (default). Amounts exclude subaccount amounts,
except where the account is depth-clipped.
-t --tree list/tree mode: show accounts as a tree. Amounts
include subaccount amounts.
--drop=N in list mode, omit N leading account name parts
--declared include non-parent declared accounts (best used --declared include non-parent declared accounts (best used
with -E) with -E)
-A --average show a row average column (in multicolumn -A --average show a row average column (in multicolumn
@ -7989,8 +8001,7 @@ Standard report commands
--summary-only display only row summaries (e.g. row total, --summary-only display only row summaries (e.g. row total,
average) (in multicolumn reports) average) (in multicolumn reports)
-N --no-total omit the final total row -N --no-total omit the final total row
--no-elide don't squash boring parent accounts (in tree --no-elide in tree mode, don't squash boring parent accounts
mode)
--format=FORMATSTR use this custom line format (in simple reports) --format=FORMATSTR use this custom line format (in simple reports)
-S --sort-amount sort by amount instead of account code/name -S --sort-amount sort by amount instead of account code/name
-% --percent express values in percentage of each column's -% --percent express values in percentage of each column's
@ -8053,25 +8064,29 @@ Standard report commands
cial statements. cial statements.
Flags: Flags:
--sum show sum of posting amounts (default) --sum calculation mode: show sum of posting amounts
--valuechange show total change of period-end historical (default)
balance value (caused by deposits, withdrawals, --valuechange calculation mode: show total change of value of
market price fluctuations) period-end historical balances (caused by deposits,
--gain show unrealised capital gain/loss (historical withdrawals, market price fluctuations)
balance value minus cost basis) --gain calculation mode: show unrealised capital
--count show the count of postings gain/loss (historical balance value minus cost
--change accumulate amounts from column start to column basis)
end (in multicolumn reports) (default) --count calculation mode: show the count of postings
--cumulative accumulate amounts from report start (specified --change accumulation mode: accumulate amounts from column
by e.g. -b/--begin) to column end start to column end (in multicolumn reports)
-H --historical accumulate amounts from journal start to column (default)
end (includes postings before report start date) --cumulative accumulation mode: accumulate amounts from report
-l --flat show accounts as a flat list (default). Amounts start (specified by e.g. -b/--begin) to column end
exclude subaccount amounts, except where the -H --historical accumulation mode: accumulate amounts from
account is depth-clipped. journal start to column end (includes postings
-t --tree show accounts as a tree. Amounts include before report start date)
subaccount amounts. -l --flat list/tree mode: show accounts as a flat list
--drop=N flat mode: omit N leading account name parts (default). Amounts exclude subaccount amounts,
except where the account is depth-clipped.
-t --tree list/tree mode: show accounts as a tree. Amounts
include subaccount amounts.
--drop=N in list mode, omit N leading account name parts
--declared include non-parent declared accounts (best used --declared include non-parent declared accounts (best used
with -E) with -E)
-A --average show a row average column (in multicolumn -A --average show a row average column (in multicolumn
@ -8080,8 +8095,7 @@ Standard report commands
--summary-only display only row summaries (e.g. row total, --summary-only display only row summaries (e.g. row total,
average) (in multicolumn reports) average) (in multicolumn reports)
-N --no-total omit the final total row -N --no-total omit the final total row
--no-elide don't squash boring parent accounts (in tree --no-elide in tree mode, don't squash boring parent accounts
mode)
--format=FORMATSTR use this custom line format (in simple reports) --format=FORMATSTR use this custom line format (in simple reports)
-S --sort-amount sort by amount instead of account code/name -S --sort-amount sort by amount instead of account code/name
-% --percent express values in percentage of each column's -% --percent express values in percentage of each column's
@ -8148,32 +8162,36 @@ Advanced report commands
balances, budget performance, unrealised capital gains, etc. balances, budget performance, unrealised capital gains, etc.
Flags: Flags:
--sum show sum of posting amounts (default) --sum calculation mode: show sum of posting amounts
--valuechange show total change of value of period-end (default)
historical balances (caused by deposits, --valuechange calculation mode: show total change of value of
period-end historical balances (caused by deposits,
withdrawals, market price fluctuations) withdrawals, market price fluctuations)
--gain show unrealised capital gain/loss (historical --gain calculation mode: show unrealised capital
balance value minus cost basis) gain/loss (historical balance value minus cost
--budget[=DESCPAT] show sum of posting amounts together with budget basis)
goals defined by periodic --budget[=DESCPAT] calculation mode: show sum of posting amounts
together with budget goals defined by periodic
transactions. With a DESCPAT argument (must be transactions. With a DESCPAT argument (must be
separated by = not space), separated by = not space),
use only periodic transactions with matching use only periodic transactions with matching
description description
(case insensitive substring match). (case insensitive substring match).
--count show the count of postings --count calculation mode: show the count of postings
--change accumulate amounts from column start to column --change accumulation mode: accumulate amounts from column
end (in multicolumn reports, default) start to column end (in multicolumn reports,
--cumulative accumulate amounts from report start (specified default)
by e.g. -b/--begin) to column end --cumulative accumulation mode: accumulate amounts from report
-H --historical accumulate amounts from journal start to column start (specified by e.g. -b/--begin) to column end
end (includes postings before report start date) -H --historical accumulation mode: accumulate amounts from
-l --flat show accounts as a flat list (default). Amounts journal start to column end (includes postings
exclude subaccount amounts, except where the before report start date)
account is depth-clipped. -l --flat list/tree mode: show accounts as a flat list
-t --tree show accounts as a tree. Amounts include (default). Amounts exclude subaccount amounts,
subaccount amounts. except where the account is depth-clipped.
--drop=N omit N leading account name parts (in flat mode) -t --tree list/tree mode: show accounts as a tree. Amounts
include subaccount amounts.
--drop=N in list mode, omit N leading account name parts
--declared include non-parent declared accounts (best used --declared include non-parent declared accounts (best used
with -E) with -E)
-A --average show a row average column (in multicolumn -A --average show a row average column (in multicolumn
@ -8182,8 +8200,7 @@ Advanced report commands
--summary-only display only row summaries (e.g. row total, --summary-only display only row summaries (e.g. row total,
average) (in multicolumn reports) average) (in multicolumn reports)
-N --no-total omit the final total row -N --no-total omit the final total row
--no-elide don't squash boring parent accounts (in tree --no-elide in tree mode, don't squash boring parent accounts
mode)
--format=FORMATSTR use this custom line format (in simple reports) --format=FORMATSTR use this custom line format (in simple reports)
-S --sort-amount sort by amount instead of account code/name (in -S --sort-amount sort by amount instead of account code/name (in
flat mode). With multiple columns, sorts by the row flat mode). With multiple columns, sorts by the row