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

;doc: update manuals

Browse Source
This commit is contained in:
Simon Michael 2024-09-29 12:13:50 -10:00
parent d88e30ff43
commit a494e15d55
9 changed files with 1094 additions and 864 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
hledger-ui/hledger-ui.1
View File

@ -151,6 +151,10 @@ General help flags:
.PP .PP
With hledger\-ui, the \f[CR]\-\-debug\f[R] option sends debug output to With hledger\-ui, the \f[CR]\-\-debug\f[R] option sends debug output to
a \f[CR]hledger\-ui.log\f[R] file in the current directory. a \f[CR]hledger\-ui.log\f[R] file in the current directory.
.PP
If you use the bash shell, you can auto\-complete flags by pressing TAB
in the command line.
If this is not working see Install > Shell completions.
.SH MOUSE .SH MOUSE
In most modern terminals, you can navigate through the screens with a In most modern terminals, you can navigate through the screens with a
mouse or touchpad: mouse or touchpad:

60
hledger-ui/hledger-ui.info
View File

@ -162,6 +162,10 @@ General help flags:
With hledger-ui, the '--debug' option sends debug output to a With hledger-ui, the '--debug' option sends debug output to a
'hledger-ui.log' file in the current directory. 'hledger-ui.log' file in the current directory.
If you use the bash shell, you can auto-complete flags by pressing
TAB in the command line. If this is not working see Install > Shell
completions.
 
File: hledger-ui.info, Node: MOUSE, Next: KEYS, Prev: OPTIONS, Up: Top File: hledger-ui.info, Node: MOUSE, Next: KEYS, Prev: OPTIONS, Up: Top
@ -537,34 +541,34 @@ Tag Table:
Node: Top221 Node: Top221
Node: OPTIONS1872 Node: OPTIONS1872
Ref: #options1970 Ref: #options1970
Node: MOUSE8236 Node: MOUSE8389
Ref: #mouse8331 Ref: #mouse8484
Node: KEYS8568 Node: KEYS8721
Ref: #keys8661 Ref: #keys8814
Node: SCREENS13396 Node: SCREENS13549
Ref: #screens13500 Ref: #screens13653
Node: Menu screen14136 Node: Menu screen14289
Ref: #menu-screen14257 Ref: #menu-screen14410
Node: Cash accounts screen14452 Node: Cash accounts screen14605
Ref: #cash-accounts-screen14629 Ref: #cash-accounts-screen14782
Node: Balance sheet accounts screen14813 Node: Balance sheet accounts screen14966
Ref: #balance-sheet-accounts-screen15029 Ref: #balance-sheet-accounts-screen15182
Node: Income statement accounts screen15149 Node: Income statement accounts screen15302
Ref: #income-statement-accounts-screen15370 Ref: #income-statement-accounts-screen15523
Node: All accounts screen15534 Node: All accounts screen15687
Ref: #all-accounts-screen15715 Ref: #all-accounts-screen15868
Node: Register screen15897 Node: Register screen16050
Ref: #register-screen16056 Ref: #register-screen16209
Node: Transaction screen18340 Node: Transaction screen18493
Ref: #transaction-screen18498 Ref: #transaction-screen18651
Node: Error screen19915 Node: Error screen20068
Ref: #error-screen20037 Ref: #error-screen20190
Node: WATCH MODE20281 Node: WATCH MODE20434
Ref: #watch-mode20398 Ref: #watch-mode20551
Node: ENVIRONMENT21857 Node: ENVIRONMENT22010
Ref: #environment21973 Ref: #environment22126
Node: BUGS22164 Node: BUGS22317
Ref: #bugs22247 Ref: #bugs22400
 
End Tag Table End Tag Table

4
hledger-ui/hledger-ui.txt
View File

@ -140,6 +140,10 @@ OPTIONS
With hledger-ui, the --debug option sends debug output to a With hledger-ui, the --debug option sends debug output to a
hledger-ui.log file in the current directory. hledger-ui.log file in the current directory.
If you use the bash shell, you can auto-complete flags by pressing TAB
in the command line. If this is not working see Install > Shell com-
pletions.
MOUSE MOUSE
In most modern terminals, you can navigate through the screens with a In most modern terminals, you can navigate through the screens with a
mouse or touchpad: mouse or touchpad:

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

@ -211,6 +211,10 @@ balance, which looks like zero when costs are hidden.
Reporting options and/or query arguments can be used to set an initial Reporting options and/or query arguments can be used to set an initial
query, which although not shown in the UI, will restrict the data shown query, which although not shown in the UI, will restrict the data shown
(in addition to any search query entered in the UI). (in addition to any search query entered in the UI).
.PP
If you use the bash shell, you can auto\-complete flags by pressing TAB
in the command line.
If this is not working see Install > Shell completions.
.SH PERMISSIONS .SH PERMISSIONS
By default, hledger\-web allows anyone who can reach it to view the By default, hledger\-web allows anyone who can reach it to view the
journal and to add new transactions, but not to change existing data. journal and to add new transactions, but not to change existing data.

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

@ -215,6 +215,10 @@ mixed-cost balance, which looks like zero when costs are hidden.
initial query, which although not shown in the UI, will restrict the initial query, which although not shown in the UI, will restrict the
data shown (in addition to any search query entered in the UI). data shown (in addition to any search query entered in the UI).
If you use the bash shell, you can auto-complete flags by pressing
TAB in the command line. If this is not working see Install > Shell
completions.
 
File: hledger-web.info, Node: PERMISSIONS, Next: EDITING UPLOADING DOWNLOADING, Prev: OPTIONS, Up: Top File: hledger-web.info, Node: PERMISSIONS, Next: EDITING UPLOADING DOWNLOADING, Prev: OPTIONS, Up: Top
@ -525,22 +529,22 @@ Tag Table:
Node: Top223 Node: Top223
Node: OPTIONS2569 Node: OPTIONS2569
Ref: #options2674 Ref: #options2674
Node: PERMISSIONS10948 Node: PERMISSIONS11101
Ref: #permissions11087 Ref: #permissions11240
Node: EDITING UPLOADING DOWNLOADING12299 Node: EDITING UPLOADING DOWNLOADING12452
Ref: #editing-uploading-downloading12480 Ref: #editing-uploading-downloading12633
Node: RELOADING13314 Node: RELOADING13467
Ref: #reloading13448 Ref: #reloading13601
Node: JSON API13881 Node: JSON API14034
Ref: #json-api13996 Ref: #json-api14149
Node: DEBUG OUTPUT19530 Node: DEBUG OUTPUT19683
Ref: #debug-output19655 Ref: #debug-output19808
Node: Debug output19682 Node: Debug output19835
Ref: #debug-output-119783 Ref: #debug-output-119936
Node: ENVIRONMENT20200 Node: ENVIRONMENT20353
Ref: #environment20319 Ref: #environment20472
Node: BUGS20436 Node: BUGS20589
Ref: #bugs20520 Ref: #bugs20673
 
End Tag Table End Tag Table

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

@ -192,6 +192,10 @@ OPTIONS
query, which although not shown in the UI, will restrict the data shown query, which although not shown in the UI, will restrict the data shown
(in addition to any search query entered in the UI). (in addition to any search query entered in the UI).
If you use the bash shell, you can auto-complete flags by pressing TAB
in the command line. If this is not working see Install > Shell com-
pletions.
PERMISSIONS PERMISSIONS
By default, hledger-web allows anyone who can reach it to view the By default, hledger-web allows anyone who can reach it to view the
journal and to add new transactions, but not to change existing data. journal and to add new transactions, but not to change existing data.

95
hledger/hledger.1
View File

@ -290,8 +290,9 @@ Most of these commands do not change the journal file; they just read it
and output a report. and output a report.
A few commands assist with adding data and file management. A few commands assist with adding data and file management.
.PP .PP
To show the commands list, run \f[CR]hledger\f[R] with no arguments. To show a summary of commands, run \f[CR]hledger\f[R] with no arguments.
The commands are described in detail in PART 4: COMMANDS, below. You can see the same commands summary at the start of PART 4: COMMANDS
below.
.PP .PP
To use a particular command, run To use a particular command, run
\f[CR]hledger CMD [CMDOPTS] [CMDARGS]\f[R], \f[CR]hledger CMD [CMDOPTS] [CMDARGS]\f[R],
@ -748,8 +749,6 @@ Here\[aq]s a small example:
To use a config file, specify it with the \f[CR]\-\-conf\f[R] option. To use a config file, specify it with the \f[CR]\-\-conf\f[R] option.
Its options will be inserted near the start of your command line (so you Its options will be inserted near the start of your command line (so you
can override them if needed). can override them if needed).
Or, you can add a \f[CR]hledger \-\-conf\f[R] shebang line to a config
file and execute it like a script.
.PP .PP
Or, you can set up an automatic config file that is used whenever you Or, you can set up an automatic config file that is used whenever you
run hledger. run hledger.
@ -769,12 +768,14 @@ To inspect the processing of config files, use \f[CR]\-\-debug\f[R] or
Here is another example config file you could start with: Here is another example config file you could start with:
https://github.com/simonmichael/hledger/blob/master/hledger.conf.sample https://github.com/simonmichael/hledger/blob/master/hledger.conf.sample
.PP .PP
Tips:
.PP
Automatic config files are convenient, but have a cost: it\[aq]s easy to Automatic config files are convenient, but have a cost: it\[aq]s easy to
change a report\[aq]s behaviour, or break scripts/applications which use change a report\[aq]s behaviour, or break scripts/applications which use
hledger, in unintended ways that will surprise you later. hledger, in unintended ways that will surprise you later.
They change the nature of hledger somewhat, making it less transparent They change the nature of hledger somewhat, making it less transparent
and predictable. and predictable.
If you decide to use one, here are some tips: If you decide to use one:
.IP \[bu] 2 .IP \[bu] 2
Be conservative about what you put in it. Be conservative about what you put in it.
Try to consider the effect on all your reports. Try to consider the effect on all your reports.
@ -785,8 +786,38 @@ Whenever a hledger command does not work as expected, try it again with
If that helps, you can run it with \f[CR]\-\-debug\f[R] to see how a If that helps, you can run it with \f[CR]\-\-debug\f[R] to see how a
config file affected it. config file affected it.
.PP .PP
This feature has been added in hledger 1.40 and is considered On unix machines, you can add a shebang line at the top of a config
file, set executable permission on the file, and use it like a script.
Eg (some operating systems need the \f[CR]\-S\f[R], some don\[aq]t):
.IP
.EX
#!/usr/bin/env \-S hledger \-\-conf
.EE
.PP
You can put not only options, but also arguments in a config file.
This is probably more useful in special\-purpose config files, not an
automatic one.
.PP
There\[aq]s an exception to this: a config file can\[aq]t provide the
command argument, currently (#2231).
If you need that, you can do it in the shebang line instead.
Eg:
.IP
.EX
#!/usr/bin/env \-S hledger balance \-\-conf
.EE
.PP
The config file feature has been added in hledger 1.40 and is considered
\f[I]experimental\f[R]. \f[I]experimental\f[R].
.SS Shell completions
If you use the bash shell, you can optionally set up context\-sensitive
autocompletions when you press TAB in a hledger command line.
At a bash shell prompt, try pressing \f[CR]hledger<SPACE><TAB><TAB>\f[R]
(should list all hledger commands) or
\f[CR]hledger reg acct:<TAB><TAB>\f[R] (should list your top\-level
account names).
If completions aren\[aq]t working, or for more details, see Install >
Shell completions.
.SH Output .SH Output
.SS Output destination .SS Output destination
hledger commands send their output to the terminal by default. hledger commands send their output to the terminal by default.
@ -4205,6 +4236,9 @@ in the code.
A comment starting with \f[CR]\[rs]n\f[R] will begin on a new line. A comment starting with \f[CR]\[rs]n\f[R] will begin on a new line.
.PP .PP
Comments can contain tags, as usual. Comments can contain tags, as usual.
.PP
Posting comments can also contain a posting date.
A secondary date, or a year\-less date, will be ignored.
.SS account field .SS account field
Assigning to \f[CR]accountN\f[R], where N is 1 to 99, sets the account Assigning to \f[CR]accountN\f[R], where N is 1 to 99, sets the account
name of the Nth posting, and causes that posting to be generated. name of the Nth posting, and causes that posting to be generated.
@ -5467,6 +5501,11 @@ And from the first date line onward, Emacs org mode heading prefixes at
the start of lines (one or more \f[CR]*\f[R]\[aq]s followed by a space) the start of lines (one or more \f[CR]*\f[R]\[aq]s followed by a space)
will be ignored. will be ignored.
This means the time log can also be a org outline. This means the time log can also be a org outline.
.PP
Timedot files don\[aq]t support directives like journal files.
So a common pattern is to have a main journal file (eg
\f[CR]time.journal\f[R]) that contains any needed directives, and then
includes the timedot file (\f[CR]include time.timedot\f[R]).
.SS Timedot examples .SS Timedot examples
Numbers: Numbers:
.IP .IP
@ -9089,6 +9128,7 @@ Flags:
balance value minus cost basis) balance value minus cost basis)
\-\-budget show sum of posting amounts compared to budget \-\-budget show sum of posting amounts compared to budget
goals defined by periodic transactions goals defined by periodic transactions
\-\-count show the count of postings
\-\-change accumulate amounts from column start to column \-\-change accumulate amounts from column start to column
end (in multicolumn reports) end (in multicolumn reports)
\-\-cumulative accumulate amounts from report start (specified \-\-cumulative accumulate amounts from report start (specified
@ -9120,6 +9160,9 @@ Flags:
\[aq]wide[,WIDTH]\[aq]: all commodities on one line \[aq]wide[,WIDTH]\[aq]: all commodities on one line
\[aq]tall\[aq] : each commodity on a new line \[aq]tall\[aq] : each commodity on a new line
\[aq]bare\[aq] : bare numbers, symbols in a column \[aq]bare\[aq] : bare numbers, symbols in a column
\-\-base\-url=URLPREFIX in html output, generate hyperlinks to
hledger\-web, with this prefix. (Usually the base
url shown by hledger\-web; can also be relative.)
\-O \-\-output\-format=FMT select the output format. Supported formats: \-O \-\-output\-format=FMT select the output format. Supported formats:
txt, html, csv, tsv, json. txt, html, csv, tsv, json.
\-o \-\-output\-file=FILE write output to FILE. A file extension matching \-o \-\-output\-file=FILE write output to FILE. A file extension matching
@ -9189,6 +9232,7 @@ Flags:
balance value minus cost basis) balance value minus cost basis)
\-\-budget show sum of posting amounts compared to budget \-\-budget show sum of posting amounts compared to budget
goals defined by periodic transactions goals defined by periodic transactions
\-\-count show the count of postings
\-\-change accumulate amounts from column start to column \-\-change accumulate amounts from column start to column
end (in multicolumn reports) end (in multicolumn reports)
\-\-cumulative accumulate amounts from report start (specified \-\-cumulative accumulate amounts from report start (specified
@ -9220,6 +9264,9 @@ Flags:
\[aq]wide[,WIDTH]\[aq]: all commodities on one line \[aq]wide[,WIDTH]\[aq]: all commodities on one line
\[aq]tall\[aq] : each commodity on a new line \[aq]tall\[aq] : each commodity on a new line
\[aq]bare\[aq] : bare numbers, symbols in a column \[aq]bare\[aq] : bare numbers, symbols in a column
\-\-base\-url=URLPREFIX in html output, generate hyperlinks to
hledger\-web, with this prefix. (Usually the base
url shown by hledger\-web; can also be relative.)
\-O \-\-output\-format=FMT select the output format. Supported formats: \-O \-\-output\-format=FMT select the output format. Supported formats:
txt, html, csv, tsv, json. txt, html, csv, tsv, json.
\-o \-\-output\-file=FILE write output to FILE. A file extension matching \-o \-\-output\-file=FILE write output to FILE. A file extension matching
@ -9297,6 +9344,7 @@ Flags:
balance value minus cost basis) balance value minus cost basis)
\-\-budget show sum of posting amounts compared to budget \-\-budget show sum of posting amounts compared to budget
goals defined by periodic transactions goals defined by periodic transactions
\-\-count show the count of postings
\-\-change accumulate amounts from column start to column \-\-change accumulate amounts from column start to column
end (in multicolumn reports) (default) end (in multicolumn reports) (default)
\-\-cumulative accumulate amounts from report start (specified \-\-cumulative accumulate amounts from report start (specified
@ -9327,6 +9375,9 @@ Flags:
\[aq]wide[,WIDTH]\[aq]: all commodities on one line \[aq]wide[,WIDTH]\[aq]: all commodities on one line
\[aq]tall\[aq] : each commodity on a new line \[aq]tall\[aq] : each commodity on a new line
\[aq]bare\[aq] : bare numbers, symbols in a column \[aq]bare\[aq] : bare numbers, symbols in a column
\-\-base\-url=URLPREFIX in html output, generate hyperlinks to
hledger\-web, with this prefix. (Usually the base
url shown by hledger\-web; can also be relative.)
\-O \-\-output\-format=FMT select the output format. Supported formats: \-O \-\-output\-format=FMT select the output format. Supported formats:
txt, html, csv, tsv, json. txt, html, csv, tsv, json.
\-o \-\-output\-file=FILE write output to FILE. A file extension matching \-o \-\-output\-file=FILE write output to FILE. A file extension matching
@ -9394,6 +9445,7 @@ Flags:
balance value minus cost basis) balance value minus cost basis)
\-\-budget show sum of posting amounts compared to budget \-\-budget show sum of posting amounts compared to budget
goals defined by periodic transactions goals defined by periodic transactions
\-\-count show the count of postings
\-\-change accumulate amounts from column start to column \-\-change accumulate amounts from column start to column
end (in multicolumn reports) (default) end (in multicolumn reports) (default)
\-\-cumulative accumulate amounts from report start (specified \-\-cumulative accumulate amounts from report start (specified
@ -9424,6 +9476,9 @@ Flags:
\[aq]wide[,WIDTH]\[aq]: all commodities on one line \[aq]wide[,WIDTH]\[aq]: all commodities on one line
\[aq]tall\[aq] : each commodity on a new line \[aq]tall\[aq] : each commodity on a new line
\[aq]bare\[aq] : bare numbers, symbols in a column \[aq]bare\[aq] : bare numbers, symbols in a column
\-\-base\-url=URLPREFIX in html output, generate hyperlinks to
hledger\-web, with this prefix. (Usually the base
url shown by hledger\-web; can also be relative.)
\-O \-\-output\-format=FMT select the output format. Supported formats: \-O \-\-output\-format=FMT select the output format. Supported formats:
txt, html, csv, tsv, json. txt, html, csv, tsv, json.
\-o \-\-output\-file=FILE write output to FILE. A file extension matching \-o \-\-output\-file=FILE write output to FILE. A file extension matching
@ -9488,6 +9543,11 @@ performance, unrealised capital gains, etc.
.EX .EX
Flags: Flags:
\-\-sum show sum of posting amounts (default) \-\-sum show sum of posting amounts (default)
\-\-valuechange show total change of value of period\-end
historical balances (caused by deposits,
withdrawals, market price fluctuations)
\-\-gain show unrealised capital gain/loss (historical
balance value minus cost basis)
\-\-budget[=DESCPAT] show sum of posting amounts together with budget \-\-budget[=DESCPAT] show sum of posting amounts together with budget
goals defined by periodic goals defined by periodic
transactions. With a DESCPAT argument (must be transactions. With a DESCPAT argument (must be
@ -9495,11 +9555,6 @@ Flags:
use only periodic transactions with matching use only periodic transactions with matching
description description
(case insensitive substring match). (case insensitive substring match).
\-\-valuechange show total change of value of period\-end
historical balances (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 \-\-count show the count of postings
\-\-change accumulate amounts from column start to column \-\-change accumulate amounts from column start to column
end (in multicolumn reports, default) end (in multicolumn reports, default)
@ -9517,7 +9572,6 @@ Flags:
with \-E) with \-E)
\-A \-\-average show a row average column (in multicolumn \-A \-\-average show a row average column (in multicolumn
reports) reports)
\-r \-\-related show postings\[aq] siblings instead
\-T \-\-row\-total show a row total column (in multicolumn reports) \-T \-\-row\-total show a row total column (in multicolumn reports)
\-\-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)
@ -9530,14 +9584,18 @@ Flags:
total, or by row average if that is displayed. total, or by row average if that is displayed.
\-% \-\-percent express values in percentage of each column\[aq]s \-% \-\-percent express values in percentage of each column\[aq]s
total total
\-r \-\-related show the other accounts transacted with, instead
\-\-invert display all amounts with reversed sign \-\-invert display all amounts with reversed sign
\-\-transpose transpose rows and columns \-\-transpose switch rows and columns (use vertical time axis)
\-\-layout=ARG how to lay out multi\-commodity amounts and the \-\-layout=ARG how to lay out multi\-commodity amounts and the
overall table: overall table:
\[aq]wide[,WIDTH]\[aq]: commodities on one line \[aq]wide[,WIDTH]\[aq]: commodities on one line
\[aq]tall\[aq] : commodities on separate lines \[aq]tall\[aq] : commodities on separate lines
\[aq]bare\[aq] : commodity symbols in one column \[aq]bare\[aq] : commodity symbols in one column
\[aq]tidy\[aq] : every attribute in its own column \[aq]tidy\[aq] : every attribute in its own column
\-\-base\-url=URLPREFIX in html output, generate links to hledger\-web,
with this prefix. (Usually the base url shown by
hledger\-web; can also be relative.)
\-O \-\-output\-format=FMT select the output format. Supported formats: \-O \-\-output\-format=FMT select the output format. Supported formats:
txt, html, csv, tsv, json, fods. txt, html, csv, tsv, json, fods.
\-o \-\-output\-file=FILE write output to FILE. A file extension matching \-o \-\-output\-file=FILE write output to FILE. A file extension matching
@ -9890,6 +9948,17 @@ each commodity:
$ hledger bal \-% cur:\[rs]\[rs]$ $ hledger bal \-% cur:\[rs]\[rs]$
$ hledger bal \-% cur:€ $ hledger bal \-% cur:€
.EE .EE
.SS Hyperlinks
The HTML and FODS output formats can generate hyperlinks to a
\f[CR]hledger\-web\f[R] register view for each account and period.
E.g.
if your \f[CR]hledger\-web\f[R] server is reachable at
\f[CR]http://localhost:5000\f[R] then you might run the
\f[CR]balance\f[R] command with the extra option
\f[CR]\-\-base\-url=http://localhost:5000\f[R].
You can also produce relative links, like
\f[CR]\-\-base\-url=\[dq]some/path\[dq]\f[R] or
\f[CR]\-\-base\-url=\[dq]\[dq]\f[R].)
.SS Multi\-period balance report .SS Multi\-period balance report
With a report interval (set by the \f[CR]\-D/\-\-daily\f[R], With a report interval (set by the \f[CR]\-D/\-\-daily\f[R],
\f[CR]\-W/\-\-weekly\f[R], \f[CR]\-M/\-\-monthly\f[R], \f[CR]\-W/\-\-weekly\f[R], \f[CR]\-M/\-\-monthly\f[R],

1483
hledger/hledger.info
View File

File diff suppressed because it is too large Load Diff

268
hledger/hledger.txt
View File

@ -203,48 +203,48 @@ Commands
output a report. A few commands assist with adding data and file man- output a report. A few commands assist with adding data and file man-
agement. agement.
To show the commands list, run hledger with no arguments. The commands To show a summary of commands, run hledger with no arguments. You can
are described in detail in PART 4: COMMANDS, below. see the same commands summary at the start of PART 4: COMMANDS below.
To use a particular command, run hledger CMD [CMDOPTS] [CMDARGS], To use a particular command, run hledger CMD [CMDOPTS] [CMDARGS],
o CMD is the full command name, or its standard abbreviation shown in o CMD is the full command name, or its standard abbreviation shown in
the commands list, or any unambiguous prefix of the name. the commands list, or any unambiguous prefix of the name.
o CMDOPTS are command-specific options, if any. Command-specific op- o CMDOPTS are command-specific options, if any. Command-specific op-
tions must be written after the command name. Eg: hledger print -x. tions must be written after the command name. Eg: hledger print -x.
o CMDARGS are additional arguments to the command, if any. Most o CMDARGS are additional arguments to the command, if any. Most
hledger commands accept arguments representing a query, to limit the hledger commands accept arguments representing a query, to limit the
data in some way. Eg: hledger reg assets:checking. data in some way. Eg: hledger reg assets:checking.
To list a command's options, arguments, and documentation in the termi- To list a command's options, arguments, and documentation in the termi-
nal, run hledger CMD -h. Eg: hledger bal -h. nal, run hledger CMD -h. Eg: hledger bal -h.
Add-on commands Add-on commands
In addition to the built-in commands, you can install add-on commands: In addition to the built-in commands, you can install add-on commands:
programs or scripts named "hledger-SOMETHING", which will also appear programs or scripts named "hledger-SOMETHING", which will also appear
in hledger's commands list. If you used the hledger-install script, in hledger's commands list. If you used the hledger-install script,
you will have several add-ons installed already. Some more can be you will have several add-ons installed already. Some more can be
found in hledger's bin/ directory, documented at found in hledger's bin/ directory, documented at
https://hledger.org/scripts.html. https://hledger.org/scripts.html.
More precisely, add-on commands are programs or scripts in your shell's More precisely, add-on commands are programs or scripts in your shell's
PATH, whose name starts with "hledger-" and ends with no extension or a PATH, whose name starts with "hledger-" and ends with no extension or a
recognised extension (".bat", ".com", ".exe", ".hs", ".js", ".lhs", recognised extension (".bat", ".com", ".exe", ".hs", ".js", ".lhs",
".lua", ".php", ".pl", ".py", ".rb", ".rkt", or ".sh"), and (on unix ".lua", ".php", ".pl", ".py", ".rb", ".rkt", or ".sh"), and (on unix
and mac) which has executable permission for the current user. and mac) which has executable permission for the current user.
You can run add-on commands using hledger, much like built-in commands: You can run add-on commands using hledger, much like built-in commands:
hledger ADDONCMD [-- ADDONCMDOPTS] [ADDONCMDARGS]. But note the double hledger ADDONCMD [-- ADDONCMDOPTS] [ADDONCMDARGS]. But note the double
hyphen argument, required before add-on-specific options. Eg: hledger hyphen argument, required before add-on-specific options. Eg: hledger
ui -- --watch or hledger web -- --serve. If this causes difficulty, ui -- --watch or hledger web -- --serve. If this causes difficulty,
you can always run the add-on directly, without using hledger: you can always run the add-on directly, without using hledger:
hledger-ui --watch or hledger-web --serve. hledger-ui --watch or hledger-web --serve.
Options Options
Run hledger -h to see general command line help. Options can be writ- Run hledger -h to see general command line help. Options can be writ-
ten either before or after the command name. These options are spe- ten either before or after the command name. These options are spe-
cific to the hledger CLI: cific to the hledger CLI:
Flags: Flags:
@ -334,14 +334,14 @@ Options
--version show version information --version show version information
--debug=[1-9] show this much debug output (default: 1) --debug=[1-9] show this much debug output (default: 1)
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, usually the
last (right-most) wins. last (right-most) wins.
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
with arguments. with arguments.
Below are more tips for using the command line interface - feel free to Below are more tips for using the command line interface - feel free to
@ -349,10 +349,10 @@ Options
Special characters Special characters
Single escaping (shell metacharacters) Single escaping (shell metacharacters)
In shell command lines, characters significant to your shell - such as In shell command lines, characters significant to your shell - such as
spaces, <, >, (, ), |, $ and \ - should be "shell-escaped" if you want spaces, <, >, (, ), |, $ and \ - should be "shell-escaped" if you want
hledger to see them. This is done by enclosing them in single or dou- hledger to see them. This is done by enclosing them in single or dou-
ble quotes, or by writing a backslash before them. Eg to match an ac- ble quotes, or by writing a backslash before them. Eg to match an ac-
count name containing a space: count name containing a space:
$ hledger register 'credit card' $ hledger register 'credit card'
@ -361,17 +361,17 @@ Options
$ hledger register credit\ card $ hledger register credit\ card
Windows users should keep in mind that cmd treats single quote as a Windows users should keep in mind that cmd treats single quote as a
regular character, so you should be using double quotes exclusively. regular character, so you should be using double quotes exclusively.
PowerShell treats both single and double quotes as quotes. PowerShell treats both single and double quotes as quotes.
Double escaping (regular expression metacharacters) Double escaping (regular expression metacharacters)
Characters significant in regular expressions (described below) - such Characters significant in regular expressions (described below) - such
as ., ^, $, [, ], (, ), |, and \ - may need to be "regex-escaped" if as ., ^, $, [, ], (, ), |, and \ - may need to be "regex-escaped" if
you don't want them to be interpreted by hledger's regular expression you don't want them to be interpreted by hledger's regular expression
engine. This is done by writing backslashes before them, but since engine. This is done by writing backslashes before them, but since
backslash is typically also a shell metacharacter, both shell-escaping backslash is typically also a shell metacharacter, both shell-escaping
and regex-escaping will be needed. Eg to match a literal $ sign while and regex-escaping will be needed. Eg to match a literal $ sign while
using the bash shell: using the bash shell:
$ hledger balance cur:'\$' $ hledger balance cur:'\$'
@ -381,10 +381,10 @@ Options
$ hledger balance cur:\\$ $ hledger balance cur:\\$
Triple escaping (for add-on commands) Triple escaping (for add-on commands)
When you use hledger to run an external add-on command (described be- When you use hledger to run an external add-on command (described be-
low), one level of shell-escaping is lost from any options or arguments low), one level of shell-escaping is lost from any options or arguments
intended for by the add-on command, so those need an extra level of intended for by the add-on command, so those need an extra level of
shell-escaping. Eg to match a literal $ sign while using the bash shell-escaping. Eg to match a literal $ sign while using the bash
shell and running an add-on command (ui): shell and running an add-on command (ui):
$ hledger ui cur:'\\$' $ hledger ui cur:'\\$'
@ -400,14 +400,14 @@ Options
double-escaped: \\$ double-escaped: \\$
triple-escaped: \\\\$ triple-escaped: \\\\$
Or, you can avoid the extra escaping by running the add-on executable Or, you can avoid the extra escaping by running the add-on executable
directly: directly:
$ hledger-ui cur:\\$ $ hledger-ui cur:\\$
Less escaping Less escaping
Options and arguments are sometimes used in places other than the shell Options and arguments are sometimes used in places other than the shell
command line, where shell-escaping is not needed, so there you should command line, where shell-escaping is not needed, so there you should
use one less level of escaping. Those places include: use one less level of escaping. Those places include:
o an @argumentfile o an @argumentfile
@ -421,8 +421,8 @@ Options
Unicode characters Unicode characters
hledger is expected to handle non-ascii characters correctly: hledger is expected to handle non-ascii characters correctly:
o they should be parsed correctly in input files and on the command o they should be parsed correctly in input files and on the command
line, by all hledger tools (add, iadd, hledger-web's search/add/edit line, by all hledger tools (add, iadd, hledger-web's search/add/edit
forms, etc.) forms, etc.)
o they should be displayed correctly by all hledger tools, and o they should be displayed correctly by all hledger tools, and
@ -430,40 +430,40 @@ Options
This requires a well-configured environment. Here are some tips: This requires a well-configured environment. Here are some tips:
o A system locale must be configured, and it must be one that can de- o A system locale must be configured, and it must be one that can de-
code the characters being used. In bash, you can set a locale like code the characters being used. In bash, you can set a locale like
this: export LANG=en_US.UTF-8. There are some more details in Trou- this: export LANG=en_US.UTF-8. There are some more details in Trou-
bleshooting. This step is essential - without it, hledger will quit bleshooting. This step is essential - without it, hledger will quit
on encountering a non-ascii character (as with all GHC-compiled pro- on encountering a non-ascii character (as with all GHC-compiled pro-
grams). grams).
o Your terminal software (eg Terminal.app, iTerm, CMD.exe, xterm..) o Your terminal software (eg Terminal.app, iTerm, CMD.exe, xterm..)
must support unicode. On Windows, you may need to use Windows Termi- must support unicode. On Windows, you may need to use Windows Termi-
nal and/or enable UTF-8 support. nal and/or enable UTF-8 support.
o The terminal must be using a font which includes the required unicode o The terminal must be using a font which includes the required unicode
glyphs. glyphs.
o The terminal should be configured to display wide characters as dou- o The terminal should be configured to display wide characters as dou-
ble width (for report alignment). ble width (for report alignment).
o On Windows, for best results you should run hledger in the same kind o On Windows, for best results you should run hledger in the same kind
of environment in which it was built. Eg hledger built in the stan- of environment in which it was built. Eg hledger built in the stan-
dard CMD.EXE environment (like the binaries on our download page) dard CMD.EXE environment (like the binaries on our download page)
might show display problems when run in a cygwin or msys terminal, might show display problems when run in a cygwin or msys terminal,
and vice versa. (See eg #961). and vice versa. (See eg #961).
Regular expressions Regular expressions
A regular expression (regexp) is a small piece of text where certain A regular expression (regexp) is a small piece of text where certain
characters (like ., ^, $, +, *, (), |, [], \) have special meanings, characters (like ., ^, $, +, *, (), |, [], \) have special meanings,
forming a tiny language for matching text precisely - very useful in forming a tiny language for matching text precisely - very useful in
hledger and elsewhere. To learn all about them, visit regular-expres- hledger and elsewhere. To learn all about them, visit regular-expres-
sions.info. sions.info.
hledger supports regexps whenever you are entering a pattern to match hledger supports regexps whenever you are entering a pattern to match
something, eg in query arguments, account aliases, CSV if rules, something, eg in query arguments, account aliases, CSV if rules,
hledger-web's search form, hledger-ui's / search, etc. You may need to hledger-web's search form, hledger-ui's / search, etc. You may need to
wrap them in quotes, especially at the command line (see Special char- wrap them in quotes, especially at the command line (see Special char-
acters above). Here are some examples: acters above). Here are some examples:
Account name queries (quoted for command line use): Account name queries (quoted for command line use):
@ -519,57 +519,57 @@ Options
& %date (29|30|31|01|02|03)$ & %date (29|30|31|01|02|03)$
hledger's regular expressions hledger's regular expressions
hledger's regular expressions come from the regex-tdfa library. If hledger's regular expressions come from the regex-tdfa library. If
they're not doing what you expect, it's important to know exactly what they're not doing what you expect, it's important to know exactly what
they support: they support:
1. they are case insensitive 1. they are case insensitive
2. they are infix matching (they do not need to match the entire thing 2. they are infix matching (they do not need to match the entire thing
being matched) being matched)
3. they are POSIX ERE (extended regular expressions) 3. they are POSIX ERE (extended regular expressions)
4. they also support GNU word boundaries (\b, \B, \<, \>) 4. they also support GNU word boundaries (\b, \B, \<, \>)
5. backreferences are supported when doing text replacement in account 5. backreferences are supported when doing text replacement in account
aliases or CSV rules, where backreferences can be used in the re- aliases or CSV rules, where backreferences can be used in the re-
placement string to reference capturing groups in the search regexp. placement string to reference capturing groups in the search regexp.
Otherwise, if you write \1, it will match the digit 1. Otherwise, if you write \1, it will match the digit 1.
6. they do not support mode modifiers ((?s)), character classes (\w, 6. they do not support mode modifiers ((?s)), character classes (\w,
\d), or anything else not mentioned above. \d), or anything else not mentioned above.
Some things to note: Some things to note:
o In the alias directive and --alias option, regular expressions must o In the alias directive and --alias option, regular expressions must
be enclosed in forward slashes (/REGEX/). Elsewhere in hledger, be enclosed in forward slashes (/REGEX/). Elsewhere in hledger,
these are not required. these are not required.
o In queries, to match a regular expression metacharacter like $ as a o In queries, to match a regular expression metacharacter like $ as a
literal character, prepend a backslash. Eg to search for amounts literal character, prepend a backslash. Eg to search for amounts
with the dollar sign in hledger-web, write cur:\$. with the dollar sign in hledger-web, write cur:\$.
o On the command line, some metacharacters like $ have a special mean- o On the command line, some metacharacters like $ have a special mean-
ing to the shell and so must be escaped at least once more. See Spe- ing to the shell and so must be escaped at least once more. See Spe-
cial characters. cial characters.
Argument files Argument files
You can save a set of command line options and arguments in a file, and You can save a set of command line options and arguments in a file, and
then reuse them by writing @FILENAME as a command line argument. Eg: then reuse them by writing @FILENAME as a command line argument. Eg:
hledger bal @foo.args. hledger bal @foo.args.
(Inside the argument file, each line should contain just one option or (Inside the argument file, each line should contain just one option or
argument. Don't use spaces except inside quotes; write = or nothing argument. Don't use spaces except inside quotes; write = or nothing
between a flag and its argument. For the special characters mentioned between a flag and its argument. For the special characters mentioned
above, use one less level of quoting than you would at the command above, use one less level of quoting than you would at the command
prompt.) prompt.)
Argument files are now superseded by.. Argument files are now superseded by..
Config files Config files
As of hledger 1.40, you can optionally save command line options (or As of hledger 1.40, you can optionally save command line options (or
arguments) to be used when running hledger commands, in a config file. arguments) to be used when running hledger commands, in a config file.
Here's a small example: Here's a small example:
# General options are listed first, one or more per line. # General options are listed first, one or more per line.
@ -580,42 +580,67 @@ Options
[print] [print]
--explicit --show-costs --explicit --show-costs
To use a config file, specify it with the --conf option. Its options To use a config file, specify it with the --conf option. Its options
will be inserted near the start of your command line (so you can over- will be inserted near the start of your command line (so you can over-
ride them if needed). Or, you can add a hledger --conf shebang line to ride them if needed).
a config file and execute it like a script.
Or, you can set up an automatic config file that is used whenever you Or, you can set up an automatic config file that is used whenever you
run hledger. This can be hledger.conf in the current directory or run hledger. This can be hledger.conf in the current directory or
above, or .hledger.conf in your home directory (~/.hledger.conf), or above, or .hledger.conf in your home directory (~/.hledger.conf), or
hledger.conf in your XDG config directory (~/.con- hledger.conf in your XDG config directory (~/.con-
fig/hledger/hledger.conf). fig/hledger/hledger.conf).
You can ignore config files by adding the -n/--no-conf flag. This is You can ignore config files by adding the -n/--no-conf flag. This is
useful when using hledger in scripts, or when troubleshooting. (When useful when using hledger in scripts, or when troubleshooting. (When
both --conf and --no-conf options are used, the right-most wins.) To both --conf and --no-conf options are used, the right-most wins.) To
inspect the processing of config files, use --debug or --debug=8. inspect the processing of config files, use --debug or --debug=8.
Here is another example config file you could start with: Here is another example config file you could start with:
https://github.com/simonmichael/hledger/blob/master/hledger.conf.sample https://github.com/simonmichael/hledger/blob/master/hledger.conf.sample
Automatic config files are convenient, but have a cost: it's easy to Tips:
change a report's behaviour, or break scripts/applications which use
hledger, in unintended ways that will surprise you later. They change Automatic config files are convenient, but have a cost: it's easy to
the nature of hledger somewhat, making it less transparent and pre- change a report's behaviour, or break scripts/applications which use
dictable. If you decide to use one, here are some tips: hledger, in unintended ways that will surprise you later. They change
the nature of hledger somewhat, making it less transparent and pre-
dictable. If you decide to use one:
o Be conservative about what you put in it. Try to consider the effect o Be conservative about what you put in it. Try to consider the effect
on all your reports. on all your reports.
o Whenever a hledger command does not work as expected, try it again o Whenever a hledger command does not work as expected, try it again
with -n. with -n.
o If that helps, you can run it with --debug to see how a config file o If that helps, you can run it with --debug to see how a config file
affected it. affected it.
This feature has been added in hledger 1.40 and is considered experi- On unix machines, you can add a shebang line at the top of a config
mental. file, set executable permission on the file, and use it like a script.
Eg (some operating systems need the -S, some don't):
#!/usr/bin/env -S hledger --conf
You can put not only options, but also arguments in a config file.
This is probably more useful in special-purpose config files, not an
automatic one.
There's an exception to this: a config file can't provide the command
argument, currently (#2231). If you need that, you can do it in the
shebang line instead. Eg:
#!/usr/bin/env -S hledger balance --conf
The config file feature has been added in hledger 1.40 and is consid-
ered experimental.
Shell completions
If you use the bash shell, you can optionally set up context-sensitive
autocompletions when you press TAB in a hledger command line. At a
bash shell prompt, try pressing hledger<SPACE><TAB><TAB> (should list
all hledger commands) or hledger reg acct:<TAB><TAB> (should list your
top-level account names). If completions aren't working, or for more
details, see Install > Shell completions.
Output Output
Output destination Output destination
@ -3276,6 +3301,9 @@ CSV
Comments can contain tags, as usual. Comments can contain tags, as usual.
Posting comments can also contain a posting date. A secondary date, or
a year-less date, will be ignored.
account field account field
Assigning to accountN, where N is 1 to 99, sets the account name of the Assigning to accountN, where N is 1 to 99, sets the account name of the
Nth posting, and causes that posting to be generated. Nth posting, and causes that posting to be generated.
@ -4329,6 +4357,11 @@ Timedot
space) will be ignored. This means the time log can also be a org space) will be ignored. This means the time log can also be a org
outline. outline.
Timedot files don't support directives like journal files. So a common
pattern is to have a main journal file (eg time.journal) that contains
any needed directives, and then includes the timedot file (include
time.timedot).
Timedot examples Timedot examples
Numbers: Numbers:
@ -7147,6 +7180,7 @@ Standard report commands
balance value minus cost basis) balance value minus cost basis)
--budget show sum of posting amounts compared to budget --budget show sum of posting amounts compared to budget
goals defined by periodic transactions goals defined by periodic transactions
--count show the count of postings
--change accumulate amounts from column start to column --change accumulate amounts from column start to column
end (in multicolumn reports) end (in multicolumn reports)
--cumulative accumulate amounts from report start (specified --cumulative accumulate amounts from report start (specified
@ -7178,6 +7212,9 @@ Standard report commands
'wide[,WIDTH]': all commodities on one line 'wide[,WIDTH]': all commodities on one line
'tall' : each commodity on a new line 'tall' : each commodity on a new line
'bare' : bare numbers, symbols in a column 'bare' : bare numbers, symbols in a column
--base-url=URLPREFIX in html output, generate hyperlinks to
hledger-web, with this prefix. (Usually the base
url shown by hledger-web; can also be relative.)
-O --output-format=FMT select the output format. Supported formats: -O --output-format=FMT select the output format. Supported formats:
txt, html, csv, tsv, json. txt, html, csv, tsv, json.
-o --output-file=FILE write output to FILE. A file extension matching -o --output-file=FILE write output to FILE. A file extension matching
@ -7240,6 +7277,7 @@ Standard report commands
balance value minus cost basis) balance value minus cost basis)
--budget show sum of posting amounts compared to budget --budget show sum of posting amounts compared to budget
goals defined by periodic transactions goals defined by periodic transactions
--count show the count of postings
--change accumulate amounts from column start to column --change accumulate amounts from column start to column
end (in multicolumn reports) end (in multicolumn reports)
--cumulative accumulate amounts from report start (specified --cumulative accumulate amounts from report start (specified
@ -7271,6 +7309,9 @@ Standard report commands
'wide[,WIDTH]': all commodities on one line 'wide[,WIDTH]': all commodities on one line
'tall' : each commodity on a new line 'tall' : each commodity on a new line
'bare' : bare numbers, symbols in a column 'bare' : bare numbers, symbols in a column
--base-url=URLPREFIX in html output, generate hyperlinks to
hledger-web, with this prefix. (Usually the base
url shown by hledger-web; can also be relative.)
-O --output-format=FMT select the output format. Supported formats: -O --output-format=FMT select the output format. Supported formats:
txt, html, csv, tsv, json. txt, html, csv, tsv, json.
-o --output-file=FILE write output to FILE. A file extension matching -o --output-file=FILE write output to FILE. A file extension matching
@ -7339,6 +7380,7 @@ Standard report commands
balance value minus cost basis) balance value minus cost basis)
--budget show sum of posting amounts compared to budget --budget show sum of posting amounts compared to budget
goals defined by periodic transactions goals defined by periodic transactions
--count show the count of postings
--change accumulate amounts from column start to column --change accumulate amounts from column start to column
end (in multicolumn reports) (default) end (in multicolumn reports) (default)
--cumulative accumulate amounts from report start (specified --cumulative accumulate amounts from report start (specified
@ -7369,6 +7411,9 @@ Standard report commands
'wide[,WIDTH]': all commodities on one line 'wide[,WIDTH]': all commodities on one line
'tall' : each commodity on a new line 'tall' : each commodity on a new line
'bare' : bare numbers, symbols in a column 'bare' : bare numbers, symbols in a column
--base-url=URLPREFIX in html output, generate hyperlinks to
hledger-web, with this prefix. (Usually the base
url shown by hledger-web; can also be relative.)
-O --output-format=FMT select the output format. Supported formats: -O --output-format=FMT select the output format. Supported formats:
txt, html, csv, tsv, json. txt, html, csv, tsv, json.
-o --output-file=FILE write output to FILE. A file extension matching -o --output-file=FILE write output to FILE. A file extension matching
@ -7428,6 +7473,7 @@ Standard report commands
balance value minus cost basis) balance value minus cost basis)
--budget show sum of posting amounts compared to budget --budget show sum of posting amounts compared to budget
goals defined by periodic transactions goals defined by periodic transactions
--count show the count of postings
--change accumulate amounts from column start to column --change accumulate amounts from column start to column
end (in multicolumn reports) (default) end (in multicolumn reports) (default)
--cumulative accumulate amounts from report start (specified --cumulative accumulate amounts from report start (specified
@ -7458,6 +7504,9 @@ Standard report commands
'wide[,WIDTH]': all commodities on one line 'wide[,WIDTH]': all commodities on one line
'tall' : each commodity on a new line 'tall' : each commodity on a new line
'bare' : bare numbers, symbols in a column 'bare' : bare numbers, symbols in a column
--base-url=URLPREFIX in html output, generate hyperlinks to
hledger-web, with this prefix. (Usually the base
url shown by hledger-web; can also be relative.)
-O --output-format=FMT select the output format. Supported formats: -O --output-format=FMT select the output format. Supported formats:
txt, html, csv, tsv, json. txt, html, csv, tsv, json.
-o --output-file=FILE write output to FILE. A file extension matching -o --output-file=FILE write output to FILE. A file extension matching
@ -7514,6 +7563,11 @@ Advanced report commands
Flags: Flags:
--sum show sum of posting amounts (default) --sum show sum of posting amounts (default)
--valuechange show total change of value of period-end
historical balances (caused by deposits,
withdrawals, market price fluctuations)
--gain show unrealised capital gain/loss (historical
balance value minus cost basis)
--budget[=DESCPAT] show sum of posting amounts together with budget --budget[=DESCPAT] show sum of posting amounts together with budget
goals defined by periodic goals defined by periodic
transactions. With a DESCPAT argument (must be transactions. With a DESCPAT argument (must be
@ -7521,11 +7575,6 @@ Advanced report commands
use only periodic transactions with matching use only periodic transactions with matching
description description
(case insensitive substring match). (case insensitive substring match).
--valuechange show total change of value of period-end
historical balances (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 --count show the count of postings
--change accumulate amounts from column start to column --change accumulate amounts from column start to column
end (in multicolumn reports, default) end (in multicolumn reports, default)
@ -7543,7 +7592,6 @@ Advanced report commands
with -E) with -E)
-A --average show a row average column (in multicolumn -A --average show a row average column (in multicolumn
reports) reports)
-r --related show postings' siblings instead
-T --row-total show a row total column (in multicolumn reports) -T --row-total show a row total column (in multicolumn reports)
--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)
@ -7556,14 +7604,18 @@ Advanced report commands
total, or by row average if that is displayed. total, or by row average if that is displayed.
-% --percent express values in percentage of each column's -% --percent express values in percentage of each column's
total total
-r --related show the other accounts transacted with, instead
--invert display all amounts with reversed sign --invert display all amounts with reversed sign
--transpose transpose rows and columns --transpose switch rows and columns (use vertical time axis)
--layout=ARG how to lay out multi-commodity amounts and the --layout=ARG how to lay out multi-commodity amounts and the
overall table: overall table:
'wide[,WIDTH]': commodities on one line 'wide[,WIDTH]': commodities on one line
'tall' : commodities on separate lines 'tall' : commodities on separate lines
'bare' : commodity symbols in one column 'bare' : commodity symbols in one column
'tidy' : every attribute in its own column 'tidy' : every attribute in its own column
--base-url=URLPREFIX in html output, generate links to hledger-web,
with this prefix. (Usually the base url shown by
hledger-web; can also be relative.)
-O --output-format=FMT select the output format. Supported formats: -O --output-format=FMT select the output format. Supported formats:
txt, html, csv, tsv, json, fods. txt, html, csv, tsv, json, fods.
-o --output-file=FILE write output to FILE. A file extension matching -o --output-file=FILE write output to FILE. A file extension matching
@ -7879,6 +7931,14 @@ Advanced report commands
$ hledger bal -% cur:\\$ $ hledger bal -% cur:\\$
$ hledger bal -% cur: $ hledger bal -% cur:
Hyperlinks
The HTML and FODS output formats can generate hyperlinks to a
hledger-web register view for each account and period. E.g. if your
hledger-web server is reachable at http://localhost:5000 then you might
run the balance command with the extra option --base-url=http://local-
host:5000. You can also produce relative links, like
--base-url="some/path" or --base-url="".)
Multi-period balance report Multi-period balance report
With a report interval (set by the -D/--daily, -W/--weekly, With a report interval (set by the -D/--daily, -W/--weekly,
-M/--monthly, -Q/--quarterly, -Y/--yearly, or -p/--period flag), bal- -M/--monthly, -Q/--quarterly, -Y/--yearly, or -p/--period flag), bal-