;update CLI usage texts

This commit is contained in:
Simon Michael 2020-11-05 11:00:12 -10:00
parent 10facfdb50
commit f615c07d0f

View File

@ -45,9 +45,8 @@ $ hledger balance
0 0
By default, accounts are displayed hierarchically, with subaccounts By default, accounts are displayed hierarchically, with subaccounts
indented below their parent. At each level of the tree, accounts are indented below their parent, with accounts at each level of the tree
sorted by account code if any, then by account name. Or with sorted by declaration order if declared, then by account name.
-S/--sort-amount, by their balance amount, largest first.
"Boring" accounts, which contain a single interesting subaccount and no "Boring" accounts, which contain a single interesting subaccount and no
balance of their own, are elided into the following line for more balance of their own, are elided into the following line for more
@ -186,6 +185,18 @@ This flag does not work if the report contains any mixed commodity
accounts. If there are mixed commodity accounts in the report be sure to accounts. If there are mixed commodity accounts in the report be sure to
use -V or -B to coerce the report into using a single commodity. use -V or -B to coerce the report into using a single commodity.
Sorting by amount
With -S/--sort-amount, accounts with the largest (most positive)
balances are shown first. For example, hledger bal expenses -MAS shows
your biggest averaged monthly expenses first.
Revenues and liability balances are typically negative, however, so -S
shows these in reverse order (largest last). To work around this, you
can add --invert to flip the signs. Or, use one of the sign-flipping
report like balancesheet or incomestatement, which also support -S. Eg:
hledger is -MAS.
Multicolumn balance report Multicolumn balance report
Multicolumn or tabular balance reports are a very useful hledger Multicolumn or tabular balance reports are a very useful hledger