update embedded manuals

doc/lib.m4

@@ -161,6 +161,7 @@ m4_define({{_optionnotes_}}, {{
 
 A @FILE argument will be expanded to the contents of FILE,
 which should contain one command line option/argument per line.
+(To prevent this, insert a `--` argument before.)
 
 When multiple similar reporting options are provided, the last one takes precedence.
 Eg `--depth 3 --depth 1` is equivalent to `--depth 1`.

hledger-ui/doc/hledger-ui.1

@@ -204,6 +204,17 @@ show version
 show debug output (levels 1\-9, default: 1)
 .RS
 .RE
+.PP
+A \@FILE argument will be expanded to the contents of FILE, which should
+contain one command line option/argument per line.
+(To prevent this, insert a \f[C]\-\-\f[] argument before.)
+.PP
+When multiple similar reporting options are provided, the last one takes
+precedence.
+Eg \f[C]\-\-depth\ 3\ \-\-depth\ 1\f[] is equivalent to
+\f[C]\-\-depth\ 1\f[].
+.PP
+Some of the reporting options can also be written as query arguments.
 .SH KEYS
 .PP
 \f[C]?\f[] shows a help dialog listing all keys.

hledger-ui/doc/hledger-ui.1.info

@@ -144,6 +144,16 @@ the data.
 
      show debug output (levels 1-9, default: 1)
 
+   A @FILE argument will be expanded to the contents of FILE, which
+should contain one command line option/argument per line.  (To prevent
+this, insert a '--' argument before.)
+
+   When multiple similar reporting options are provided, the last one
+takes precedence.  Eg '--depth 3 --depth 1' is equivalent to '--depth
+1'.
+
+   Some of the reporting options can also be written as query arguments.
+
 
 File: hledger-ui.1.info,  Node: KEYS,  Next: SCREENS,  Prev: OPTIONS,  Up: Top
 
@@ -358,17 +368,17 @@ Tag Table:
 Node: Top73
 Node: OPTIONS831
 Ref: #options930
-Node: KEYS3519
+Node: KEYS3916
-Ref: #keys3616
+Ref: #keys4013
-Node: SCREENS6412
+Node: SCREENS6809
-Ref: #screens6499
+Ref: #screens6896
-Node: Accounts screen6589
+Node: Accounts screen6986
-Ref: #accounts-screen6719
+Ref: #accounts-screen7116
-Node: Register screen8949
+Node: Register screen9346
-Ref: #register-screen9106
+Ref: #register-screen9503
-Node: Transaction screen11180
+Node: Transaction screen11577
-Ref: #transaction-screen11340
+Ref: #transaction-screen11737
-Node: Error screen12210
+Node: Error screen12607
-Ref: #error-screen12334
+Ref: #error-screen12731
 
 End Tag Table

hledger-ui/doc/hledger-ui.1.txt

@@ -139,6 +139,15 @@ OPTIONS
        --debug[=N]
               show debug output (levels 1-9, default: 1)
 
+       A @FILE argument will be expanded to the contents of FILE, which should
+       contain one command line option/argument per line.  (To  prevent  this,
+       insert a -- argument before.)
+
+       When  multiple  similar  reporting  options  are provided, the last one
+       takes precedence.  Eg --depth 3 --depth 1 is equivalent to --depth 1.
+
+       Some of the reporting options can also be written as query arguments.
+
 KEYS
        ? shows a help dialog listing all keys.  (Some of these also appear  in
        the quick help at the bottom of each screen.) Press ? again (or ESCAPE,

hledger-web/doc/hledger-web.1

@@ -260,6 +260,17 @@ show version
 show debug output (levels 1\-9, default: 1)
 .RS
 .RE
+.PP
+A \@FILE argument will be expanded to the contents of FILE, which should
+contain one command line option/argument per line.
+(To prevent this, insert a \f[C]\-\-\f[] argument before.)
+.PP
+When multiple similar reporting options are provided, the last one takes
+precedence.
+Eg \f[C]\-\-depth\ 3\ \-\-depth\ 1\f[] is equivalent to
+\f[C]\-\-depth\ 1\f[].
+.PP
+Some of the reporting options can also be written as query arguments.
 .SH ENVIRONMENT
 .PP
 \f[B]LEDGER_FILE\f[] The journal file path when not specified with

hledger-web/doc/hledger-web.1.info

@@ -189,6 +189,16 @@ options as shown above.
 
      show debug output (levels 1-9, default: 1)
 
+   A @FILE argument will be expanded to the contents of FILE, which
+should contain one command line option/argument per line.  (To prevent
+this, insert a '--' argument before.)
+
+   When multiple similar reporting options are provided, the last one
+takes precedence.  Eg '--depth 3 --depth 1' is equivalent to '--depth
+1'.
+
+   Some of the reporting options can also be written as query arguments.
+
 
 Tag Table:
 Node: Top74

hledger-web/doc/hledger-web.1.txt

@@ -184,6 +184,15 @@ OPTIONS
        --debug[=N]
               show debug output (levels 1-9, default: 1)
 
+       A @FILE argument will be expanded to the contents of FILE, which should
+       contain  one  command line option/argument per line.  (To prevent this,
+       insert a -- argument before.)
+
+       When multiple similar reporting options  are  provided,  the  last  one
+       takes precedence.  Eg --depth 3 --depth 1 is equivalent to --depth 1.
+
+       Some of the reporting options can also be written as query arguments.
+
 ENVIRONMENT
        LEDGER_FILE The journal file path when not specified with -f.  Default:
        ~/.hledger.journal (on  windows,  perhaps  C:/Users/USER/.hledger.jour-

hledger/doc/hledger.1

@@ -301,6 +301,7 @@ most recent applicable market price, if any)
 .PP
 A \@FILE argument will be expanded to the contents of FILE, which should
 contain one command line option/argument per line.
+(To prevent this, insert a \f[C]\-\-\f[] argument before.)
 .PP
 When multiple similar reporting options are provided, the last one takes
 precedence.

hledger/doc/hledger.1.info

@@ -233,7 +233,8 @@ different, like git.)
      the most recent applicable market price, if any)
 
    A @FILE argument will be expanded to the contents of FILE, which
-should contain one command line option/argument per line.
+should contain one command line option/argument per line.  (To prevent
+this, insert a '--' argument before.)
 
    When multiple similar reporting options are provided, the last one
 takes precedence.  Eg '--depth 3 --depth 1' is equivalent to '--depth
@@ -2203,125 +2204,125 @@ Node: OPTIONS3640
 Ref: #options3744
 Node: General options4025
 Ref: #general-options4152
-Node: Command options6693
+Node: Command options6744
-Ref: #command-options6846
+Ref: #command-options6897
-Node: Command arguments7244
+Node: Command arguments7295
-Ref: #command-arguments7404
+Ref: #command-arguments7455
-Node: Special characters7525
+Node: Special characters7576
-Ref: #special-characters7683
+Ref: #special-characters7734
-Node: Input files8851
+Node: Input files8902
-Ref: #input-files8989
+Ref: #input-files9040
-Node: Smart dates10952
+Node: Smart dates11003
-Ref: #smart-dates11095
+Ref: #smart-dates11146
-Node: Report start & end date12074
+Node: Report start & end date12125
-Ref: #report-start-end-date12246
+Ref: #report-start-end-date12297
-Node: Report intervals13312
+Node: Report intervals13363
-Ref: #report-intervals13477
+Ref: #report-intervals13528
-Node: Period expressions13878
+Node: Period expressions13929
-Ref: #period-expressions14038
+Ref: #period-expressions14089
-Node: Depth limiting16378
+Node: Depth limiting16429
-Ref: #depth-limiting16524
+Ref: #depth-limiting16575
-Node: Pivoting16866
+Node: Pivoting16917
-Ref: #pivoting16986
+Ref: #pivoting17037
-Node: Cost18662
+Node: Cost18713
-Ref: #cost18772
+Ref: #cost18823
-Node: Market value18890
+Node: Market value18941
-Ref: #market-value19027
+Ref: #market-value19078
-Node: Regular expressions20327
+Node: Regular expressions20378
-Ref: #regular-expressions20465
+Ref: #regular-expressions20516
-Node: QUERIES21826
+Node: QUERIES21877
-Ref: #queries21930
+Ref: #queries21981
-Node: COMMANDS25897
+Node: COMMANDS25948
-Ref: #commands26011
+Ref: #commands26062
-Node: accounts26994
+Node: accounts27045
-Ref: #accounts27094
+Ref: #accounts27145
-Node: activity28087
+Node: activity28138
-Ref: #activity28199
+Ref: #activity28250
-Node: add28558
+Node: add28609
-Ref: #add28659
+Ref: #add28710
-Node: balance31317
+Node: balance31368
-Ref: #balance31430
+Ref: #balance31481
-Node: Flat mode34587
+Node: Flat mode34638
-Ref: #flat-mode34714
+Ref: #flat-mode34765
-Node: Depth limited balance reports35134
+Node: Depth limited balance reports35185
-Ref: #depth-limited-balance-reports35337
+Ref: #depth-limited-balance-reports35388
-Node: Multicolumn balance reports35757
+Node: Multicolumn balance reports35808
-Ref: #multicolumn-balance-reports35968
+Ref: #multicolumn-balance-reports36019
-Node: Custom balance output40616
+Node: Custom balance output40667
-Ref: #custom-balance-output40800
+Ref: #custom-balance-output40851
-Node: Colour support42893
+Node: Colour support42944
-Ref: #colour-support43054
+Ref: #colour-support43105
-Node: Output destination43227
+Node: Output destination43278
-Ref: #output-destination43385
+Ref: #output-destination43436
-Node: CSV output43655
+Node: CSV output43706
-Ref: #csv-output43774
+Ref: #csv-output43825
-Node: balancesheet44171
+Node: balancesheet44222
-Ref: #balancesheet44309
+Ref: #balancesheet44360
-Node: balancesheetequity46277
+Node: balancesheetequity46328
-Ref: #balancesheetequity46428
+Ref: #balancesheetequity46479
-Node: cashflow47217
+Node: cashflow47268
-Ref: #cashflow47347
+Ref: #cashflow47398
-Node: check-dates49259
+Node: check-dates49310
-Ref: #check-dates49388
+Ref: #check-dates49439
-Node: check-dupes49505
+Node: check-dupes49556
-Ref: #check-dupes49632
+Ref: #check-dupes49683
-Node: equity49769
+Node: equity49820
-Ref: #equity49881
+Ref: #equity49932
-Node: help50044
+Node: help50095
-Ref: #help50147
+Ref: #help50198
-Node: import51221
+Node: import51272
-Ref: #import51337
+Ref: #import51388
-Node: incomestatement51732
+Node: incomestatement51783
-Ref: #incomestatement51868
+Ref: #incomestatement51919
-Node: prices53821
+Node: prices53872
-Ref: #prices53938
+Ref: #prices53989
-Node: print53981
+Node: print54032
-Ref: #print54093
+Ref: #print54144
-Node: print-unique58939
+Node: print-unique58990
-Ref: #print-unique59067
+Ref: #print-unique59118
-Node: register59135
+Node: register59186
-Ref: #register59264
+Ref: #register59315
-Node: Custom register output63765
+Node: Custom register output63816
-Ref: #custom-register-output63896
+Ref: #custom-register-output63947
-Node: register-match65193
+Node: register-match65244
-Ref: #register-match65329
+Ref: #register-match65380
-Node: rewrite65512
+Node: rewrite65563
-Ref: #rewrite65631
+Ref: #rewrite65682
-Node: stats65700
+Node: stats65751
-Ref: #stats65805
+Ref: #stats65856
-Node: tags66686
+Node: tags66737
-Ref: #tags66786
+Ref: #tags66837
-Node: test66818
+Node: test66869
-Ref: #test66904
+Ref: #test66955
-Node: ADD-ON COMMANDS67272
+Node: ADD-ON COMMANDS67323
-Ref: #add-on-commands67384
+Ref: #add-on-commands67435
-Node: Official add-ons68671
+Node: Official add-ons68722
-Ref: #official-add-ons68813
+Ref: #official-add-ons68864
-Node: api68900
+Node: api68951
-Ref: #api68991
+Ref: #api69042
-Node: ui69043
+Node: ui69094
-Ref: #ui69144
+Ref: #ui69195
-Node: web69202
+Node: web69253
-Ref: #web69293
+Ref: #web69344
-Node: Third party add-ons69339
+Node: Third party add-ons69390
-Ref: #third-party-add-ons69516
+Ref: #third-party-add-ons69567
-Node: diff69651
+Node: diff69702
-Ref: #diff69750
+Ref: #diff69801
-Node: iadd69849
+Node: iadd69900
-Ref: #iadd69965
+Ref: #iadd70016
-Node: interest70048
+Node: interest70099
-Ref: #interest70171
+Ref: #interest70222
-Node: irr70266
+Node: irr70317
-Ref: #irr70366
+Ref: #irr70417
-Node: Experimental add-ons70444
+Node: Experimental add-ons70495
-Ref: #experimental-add-ons70598
+Ref: #experimental-add-ons70649
-Node: autosync70889
+Node: autosync70940
-Ref: #autosync71003
+Ref: #autosync71054
-Node: budget71242
+Node: budget71293
-Ref: #budget71366
+Ref: #budget71417
-Node: chart71432
+Node: chart71483
-Ref: #chart71551
+Ref: #chart71602
-Node: check71622
+Node: check71673
-Ref: #check71726
+Ref: #check71777
 
 End Tag Table

hledger/doc/hledger.1.txt

@@ -204,7 +204,8 @@ OPTIONS
               (using the most recent applicable market price, if any)
 
        A @FILE argument will be expanded to the contents of FILE, which should
-       contain one command line option/argument per line.
+       contain  one  command line option/argument per line.  (To prevent this,
+       insert a -- argument before.)
 
        When multiple similar reporting options  are  provided,  the  last  one
        takes precedence.  Eg --depth 3 --depth 1 is equivalent to --depth 1.
@@ -405,7 +406,6 @@ OPTIONS
        earliest or latest transaction in your journal:
 
 
-
        -p "from 2009/1/1"   everything  after  january
                             1, 2009
        -p "from 2009/1"     the same