;doc: update help

doc/common.m4

@@ -58,12 +58,13 @@ m4_dnl
 m4_define({{_generaloptions_}}, {{
 ```
 General input/data transformation flags:
-  -f --file=FILE            Read data from FILE, or from stdin if -. Can be
-                            specified more than once. If not specified, reads
-                            from $LEDGER_FILE or $HOME/.hledger.journal.
-     --rules-file=RULEFILE  Use conversion rules from this file for
+  -f --file=[FMT:]FILE      Read data from FILE, or from stdin if FILE is -,
+                            inferring format from extension or a FMT: prefix.
+                            Can be specified more than once. If not specified,
+                            reads from $LEDGER_FILE or $HOME/.hledger.journal.
+     --rules=RULESFILE      Use rules defined in this rules file for
                             converting subsequent CSV/SSV/TSV files. If not
-                            specified, uses FILE.rules for each such FILE.
+                            specified, uses FILE.csv.rules for each FILE.csv.
      --alias=A=B|/RGX/=RPL  transform account names from A to B, or by
                             replacing regular expression matches
      --auto                 generate extra postings by applying auto posting
@@ -126,7 +127,6 @@ General output/reporting flags (supported by some commands):
      --pretty[=YN]          Use box-drawing characters in text output? Can be
                             'y'/'yes' or 'n'/'no'.
                             If YN is specified, the equals is required.
-     --debug=[1-9]          show this level of debug output (default: 1)
 
 General help flags:
   -h --help                 show command line help
@@ -134,6 +134,7 @@ General help flags:
      --info                 show the manual with info
      --man                  show the manual with man
      --version              show version information
+     --debug=[1-9]          show this level of debug output (default: 1)
 ```
 }} )m4_dnl
 m4_dnl

hledger/Hledger/Cli/Commands/Balance.txt

@@ -854,11 +854,11 @@ $ hledger -f examples/bcexample.hledger bal assets:us:etrade -3 -O csv --layout=
 "Assets:US:ETrade","USD","5120.50"
 "Assets:US:ETrade","VEA","36.00"
 "Assets:US:ETrade","VHT","294.00"
-"total","GLD","70.00"
-"total","ITOT","17.00"
-"total","USD","5120.50"
-"total","VEA","36.00"
-"total","VHT","294.00"
+"Total:","GLD","70.00"
+"Total:","ITOT","17.00"
+"Total:","USD","5120.50"
+"Total:","VEA","36.00"
+"Total:","VHT","294.00"
 
 Bare layout will sometimes display an extra row for the no-symbol
 commodity, because of zero amounts (hledger treats zeroes as

hledger/Hledger/Cli/Commands/Help.md

@@ -5,10 +5,10 @@ With a (case insensitive) TOPIC argument, try to open it at that section heading
 
 ```flags
 Flags:
-  -i            show the manual with info
-  -m            show the manual with man
-  -p            show the manual with $PAGER or less
-                (less is always used if TOPIC is specified)
+  -i                show the manual with info
+  -m                show the manual with man
+  -p                show the manual with $PAGER or less
+                    (less is always used if TOPIC is specified)
 ```
 
 This command shows the hledger manual built in to your hledger executable.

hledger/Hledger/Cli/Commands/Help.txt

@@ -4,10 +4,10 @@ Show the hledger user manual with info, man, or a pager. With a (case
 insensitive) TOPIC argument, try to open it at that section heading.
 
 Flags:
-  -i            show the manual with info
-  -m            show the manual with man
-  -p            show the manual with $PAGER or less
-                (less is always used if TOPIC is specified)
+  -i                show the manual with info
+  -m                show the manual with man
+  -p                show the manual with $PAGER or less
+                    (less is always used if TOPIC is specified)
 
 This command shows the hledger manual built in to your hledger
 executable. It can be useful when offline, or when you prefer the

hledger/hledger.m4.md

@@ -246,7 +246,17 @@ If this causes difficulty, you can always run the add-on directly, without using
 
 Run `hledger -h` to see general command line help.
 Options can be written either before or after the command name.
-The following general options are common to most hledger commands.
+These options are specific to the `hledger` CLI:
+
+```
+Flags:
+     --conf=CONFFILE        Use extra options defined in this config file. If
+                            not specified, searches upward and in XDG config
+                            dir for hledger.conf (or .hledger.conf in $HOME).
+  -n --no-conf              ignore any config file
+```
+
+And the following general options are common to most hledger commands:
 
 _generaloptions_