;doc: update manuals

hledger-ui/hledger-ui.1

@@ -146,7 +146,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)
+     \-\-debug=[1\-9]          show this much debug output (default: 1)
 .EE
 .PP
 With hledger\-ui, the \f[CR]\-\-debug\f[R] option sends debug output to

hledger-ui/hledger-ui.info

@@ -157,7 +157,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)
+     --debug=[1-9]          show this much debug output (default: 1)
 
    With hledger-ui, the '--debug' option sends debug output to a
 'hledger-ui.log' file in the current directory.
@@ -533,34 +533,34 @@ Tag Table:
 Node: Top221
 Node: OPTIONS1872
 Ref: #options1970
-Node: MOUSE8240
-Ref: #mouse8335
-Node: KEYS8572
-Ref: #keys8665
-Node: SCREENS13320
-Ref: #screens13424
-Node: Menu screen14060
-Ref: #menu-screen14181
-Node: Cash accounts screen14376
-Ref: #cash-accounts-screen14553
-Node: Balance sheet accounts screen14737
-Ref: #balance-sheet-accounts-screen14953
-Node: Income statement accounts screen15073
-Ref: #income-statement-accounts-screen15294
-Node: All accounts screen15458
-Ref: #all-accounts-screen15639
-Node: Register screen15821
-Ref: #register-screen15980
-Node: Transaction screen18264
-Ref: #transaction-screen18422
-Node: Error screen19839
-Ref: #error-screen19961
-Node: WATCH MODE20205
-Ref: #watch-mode20322
-Node: ENVIRONMENT21781
-Ref: #environment21897
-Node: BUGS22088
-Ref: #bugs22171
+Node: MOUSE8236
+Ref: #mouse8331
+Node: KEYS8568
+Ref: #keys8661
+Node: SCREENS13316
+Ref: #screens13420
+Node: Menu screen14056
+Ref: #menu-screen14177
+Node: Cash accounts screen14372
+Ref: #cash-accounts-screen14549
+Node: Balance sheet accounts screen14733
+Ref: #balance-sheet-accounts-screen14949
+Node: Income statement accounts screen15069
+Ref: #income-statement-accounts-screen15290
+Node: All accounts screen15454
+Ref: #all-accounts-screen15635
+Node: Register screen15817
+Ref: #register-screen15976
+Node: Transaction screen18260
+Ref: #transaction-screen18418
+Node: Error screen19835
+Ref: #error-screen19957
+Node: WATCH MODE20201
+Ref: #watch-mode20318
+Node: ENVIRONMENT21777
+Ref: #environment21893
+Node: BUGS22084
+Ref: #bugs22167
 
 End Tag Table
 

hledger-ui/hledger-ui.txt

@@ -135,7 +135,7 @@ OPTIONS
                    --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)
+                   --debug=[1-9]          show this much debug output (default: 1)
 
        With  hledger-ui,  the  --debug  option  sends  debug   output   to   a
        hledger-ui.log file in the current directory.

hledger-web/hledger-web.1

@@ -197,7 +197,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)
+     \-\-debug=[1\-9]          show this much debug output (default: 1)
 .EE
 .PP
 hledger\-web shows accounts with zero balances by default (like

hledger-web/hledger-web.info

@@ -202,7 +202,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)
+     --debug=[1-9]          show this much debug output (default: 1)
 
    hledger-web shows accounts with zero balances by default (like
 'hledger-ui', and unlike 'hledger').  Using the '-E/--empty' flag will
@@ -525,22 +525,22 @@ Tag Table:
 Node: Top223
 Node: OPTIONS2569
 Ref: #options2674
-Node: PERMISSIONS10952
-Ref: #permissions11091
-Node: EDITING UPLOADING DOWNLOADING12303
-Ref: #editing-uploading-downloading12484
-Node: RELOADING13318
-Ref: #reloading13452
-Node: JSON API13885
-Ref: #json-api14000
-Node: DEBUG OUTPUT19534
-Ref: #debug-output19659
-Node: Debug output19686
-Ref: #debug-output-119787
-Node: ENVIRONMENT20204
-Ref: #environment20323
-Node: BUGS20440
-Ref: #bugs20524
+Node: PERMISSIONS10948
+Ref: #permissions11087
+Node: EDITING UPLOADING DOWNLOADING12299
+Ref: #editing-uploading-downloading12480
+Node: RELOADING13314
+Ref: #reloading13448
+Node: JSON API13881
+Ref: #json-api13996
+Node: DEBUG OUTPUT19530
+Ref: #debug-output19655
+Node: Debug output19682
+Ref: #debug-output-119783
+Node: ENVIRONMENT20200
+Ref: #environment20319
+Node: BUGS20436
+Ref: #bugs20520
 
 End Tag Table
 

hledger-web/hledger-web.txt

@@ -179,7 +179,7 @@ OPTIONS
                    --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)
+                   --debug=[1-9]          show this much debug output (default: 1)
 
        hledger-web  shows  accounts  with  zero  balances  by  default   (like
        hledger-ui,  and  unlike  hledger).  Using the -E/--empty flag will re-

hledger/hledger.1

@@ -431,7 +431,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)
+     \-\-debug=[1\-9]          show this much debug output (default: 1)
 .EE
 .PP
 Usually hledger accepts any unambiguous flag prefix, eg you can write
@@ -731,29 +731,30 @@ quoting than you would at the command prompt.)
 .PP
 Argument files are now superseded by..
 .SS Config files
-hledger looks for a \f[CR]hledger.conf\f[R] file (or
-\f[CR].hledger.conf\f[R] in your home directory) in the current
-directory, then parent directories, then your XDG config directory
-(\f[CR]\[ti]/.config/hledger/\f[R]).
-Any command line options (or arguments) in this file will be added to
-your \f[CR]hledger\f[R] commands, near the start of the command line (so
-you can override them when needed).
-.PP
-Or you can specify a config file with the \f[CR]\-\-conf\f[R] option.
-Or you can add a \f[CR]hledger \-\-conf\f[R] shebang line to a config
-file and make it executable.
-.PP
-A hledger config file contains command line options, to be used with all
-commands that support them, and optionally command\-specific options in
-named sections.
-hledger.conf.sample is a sample demonstrating the syntax; you can
-install it as \f[CR]./hledger.conf\f[R] or
-\f[CR]$HOME/.hledger.conf\f[R] and customise it.
-.PP
-You can disable config files entirely by running with the
-\f[CR]\-n/\-\-no\-conf\f[R] flag.
-This will ensure hledger runs with standard defaults, useful when
-troubleshooting or when sharing examples with others.
+hledger will read extra command line options from a
+\f[CR]hledger.conf\f[R] config file.
+These will be inserted early in the command line, so your later options
+can override them if needed.
+The config file can contain general options (which will be used with all
+commands that support them), and command\-specific options (or
+arguments).
+hledger.conf.sample is an example, which you can install as
+\f[CR]./hledger.conf\f[R] or \f[CR]$HOME/.hledger.conf\f[R].
+.PP
+To be precise, hledger looks for \f[CR]hledger.conf\f[R] in the current
+directory or above, or in your home directory (with a dotted name,
+\f[CR]\[ti]/.hledger.conf\f[R]), or finally in your XDG config directory
+(\f[CR]\[ti]/.config/hledger/hledger.conf\f[R]).
+Or you can select a particular config file by using the
+\f[CR]\-\-conf\f[R] option, or by adding a \f[CR]hledger \-\-conf\f[R]
+shebang line to a config file and executing it like a script (see the
+example file).
+You can inspect the finding and processing of config files with
+\f[CR]\-\-debug\f[R] or \f[CR]\-\-debug=8\f[R].
+.PP
+If you want to run hledger without a config file, to ensure standard
+defaults and behaviour, use the \f[CR]\-n/\-\-no\-conf\f[R] flag.
+This is useful when troubleshooting problems or sharing examples.
 .PP
 \f[I](Added in 1.40; experimental)\f[R]
 .SH Output