From f615c07d0f52a21e0d28924212f1236ef16756ca Mon Sep 17 00:00:00 2001 From: Simon Michael Date: Thu, 5 Nov 2020 11:00:12 -1000 Subject: [PATCH] ;update CLI usage texts --- hledger/Hledger/Cli/Commands/Balance.txt | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/hledger/Hledger/Cli/Commands/Balance.txt b/hledger/Hledger/Cli/Commands/Balance.txt index 16ff0d7f1..373713482 100644 --- a/hledger/Hledger/Cli/Commands/Balance.txt +++ b/hledger/Hledger/Cli/Commands/Balance.txt @@ -45,9 +45,8 @@ $ hledger balance 0 By default, accounts are displayed hierarchically, with subaccounts -indented below their parent. At each level of the tree, accounts are -sorted by account code if any, then by account name. Or with --S/--sort-amount, by their balance amount, largest first. +indented below their parent, with accounts at each level of the tree +sorted by declaration order if declared, then by account name. "Boring" accounts, which contain a single interesting subaccount and no 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 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 or tabular balance reports are a very useful hledger