;doc: regen manuals

[ci skip]

hledger/hledger.1

@@ -280,12 +280,57 @@ Most hledger commands accept arguments after the command name, which are
 often a query, filtering the data in some way.
 .SS Argument files
 .PP
-You can save a set of command line options/arguments in a file, one per
-line, and then reuse them by writing \f[C]\[at]FILENAME\f[R] in a
-command line.
-To prevent this expansion of \f[C]\[at]\f[R]-arguments, precede them
-with a \f[C]--\f[R] argument.
-For more, see Save frequently used options.
+You can save a set of command line options/arguments in a file, and then
+reuse them by writing \f[C]\[at]FILENAME\f[R] as a command line
+argument.
+Eg: \f[C]hledger bal \[at]foo.args\f[R].
+(To prevent this, eg if you have an argument that begins with a literal
+\f[C]\[at]\f[R], precede it with \f[C]--\f[R], eg:
+\f[C]hledger bal -- \[at]ARG\f[R]).
+.PP
+Inside the argument file, each line should contain just one option or
+argument.
+Avoid the use of spaces, except inside quotes (or you\[aq]ll see a
+confusing error).
+Between a flag and its argument, use = (or nothing).
+Bad:
+.IP
+.nf
+\f[C]
+assets depth:2
+-X USD
+\f[R]
+.fi
+.PP
+Good:
+.IP
+.nf
+\f[C]
+assets
+depth:2
+-X=USD
+\f[R]
+.fi
+.PP
+For special characters (see below), use one less level of quoting than
+you would at the command prompt.
+Bad:
+.IP
+.nf
+\f[C]
+-X\[dq]$\[dq]
+\f[R]
+.fi
+.PP
+Good:
+.IP
+.nf
+\f[C]
+-X$
+\f[R]
+.fi
+.PP
+See also: Save frequently used options.
 .SS Special characters in arguments and queries
 .PP
 In shell command lines, option and argument values which contain

hledger/hledger.info

@@ -284,10 +284,36 @@ File: hledger.info,  Node: Argument files,  Next: Special characters in argument
 2.4 Argument files
 ==================
 
-You can save a set of command line options/arguments in a file, one per
-line, and then reuse them by writing '@FILENAME' in a command line.  To
-prevent this expansion of '@'-arguments, precede them with a '--'
-argument.  For more, see Save frequently used options.
+You can save a set of command line options/arguments in a file, and then
+reuse them by writing '@FILENAME' as a command line argument.  Eg:
+'hledger bal @foo.args'.  (To prevent this, eg if you have an argument
+that begins with a literal '@', precede it with '--', eg: 'hledger bal
+-- @ARG').
+
+   Inside the argument file, each line should contain just one option or
+argument.  Avoid the use of spaces, except inside quotes (or you'll see
+a confusing error).  Between a flag and its argument, use = (or
+nothing).  Bad:
+
+assets depth:2
+-X USD
+
+   Good:
+
+assets
+depth:2
+-X=USD
+
+   For special characters (see below), use one less level of quoting
+than you would at the command prompt.  Bad:
+
+-X"$"
+
+   Good:
+
+-X$
+
+   See also: Save frequently used options.
 
 
 File: hledger.info,  Node: Special characters in arguments and queries,  Next: Command line tips,  Prev: Argument files,  Up: OPTIONS
@@ -3177,163 +3203,163 @@ Node: Command arguments7513
 Ref: #command-arguments7667
 Node: Argument files7788
 Ref: #argument-files7964
-Node: Special characters in arguments and queries8230
-Ref: #special-characters-in-arguments-and-queries8464
-Node: More escaping8915
-Ref: #more-escaping9077
-Node: Even more escaping9373
-Ref: #even-more-escaping9567
-Node: Less escaping10238
-Ref: #less-escaping10400
-Node: Command line tips10645
-Ref: #command-line-tips10831
-Node: Unicode characters11208
-Ref: #unicode-characters11364
-Node: Input files12776
-Ref: #input-files12912
-Node: Smart dates14841
-Ref: #smart-dates14982
-Node: Report start & end date16388
-Ref: #report-start-end-date16560
-Node: Report intervals17984
-Ref: #report-intervals18149
-Node: Period expressions18539
-Ref: #period-expressions18699
-Node: Depth limiting22654
-Ref: #depth-limiting22798
-Node: Pivoting23140
-Ref: #pivoting23263
-Node: Valuation24939
-Ref: #valuation25068
-Node: -B Cost25248
-Ref: #b-cost25359
-Node: -V Market value25557
-Ref: #v-market-value25731
-Node: -X Market value in specified commodity27163
-Ref: #x-market-value-in-specified-commodity27402
-Node: --value Flexible valuation27578
-Ref: #value-flexible-valuation27804
-Node: Effect of --value on reports31994
-Ref: #effect-of---value-on-reports32210
-Node: Combining -B -V -X --value37141
-Ref: #combining--b--v--x---value37324
-Node: Output destination37360
-Ref: #output-destination37512
-Node: Output format37795
-Ref: #output-format37947
-Node: Regular expressions38332
-Ref: #regular-expressions38469
-Node: QUERIES39830
-Ref: #queries39932
-Node: COMMANDS43894
-Ref: #commands44006
-Node: accounts45070
-Ref: #accounts45168
-Node: activity45867
-Ref: #activity45977
-Node: add46360
-Ref: #add46459
-Node: balance49198
-Ref: #balance49309
-Node: Classic balance report50767
-Ref: #classic-balance-report50940
-Node: Customising the classic balance report52309
-Ref: #customising-the-classic-balance-report52537
-Node: Colour support54613
-Ref: #colour-support54780
-Node: Flat mode54953
-Ref: #flat-mode55101
-Node: Depth limited balance reports55514
-Ref: #depth-limited-balance-reports55699
-Node: Percentages56155
-Ref: #percentages56321
-Node: Multicolumn balance report57458
-Ref: #multicolumn-balance-report57638
-Node: Budget report62952
-Ref: #budget-report63095
-Node: Nested budgets68297
-Ref: #nested-budgets68409
-Ref: #output-format-171890
-Node: balancesheet71968
-Ref: #balancesheet72104
-Node: balancesheetequity73487
-Ref: #balancesheetequity73636
-Node: cashflow74197
-Ref: #cashflow74325
-Node: check-dates75421
-Ref: #check-dates75548
-Node: check-dupes75827
-Ref: #check-dupes75951
-Node: close76244
-Ref: #close76358
-Node: commodities80024
-Ref: #commodities80151
-Node: descriptions80233
-Ref: #descriptions80361
-Node: diff80542
-Ref: #diff80648
-Node: files81695
-Ref: #files81795
-Node: help81942
-Ref: #help82042
-Node: import83123
-Ref: #import83237
-Node: Importing balance assignments84130
-Ref: #importing-balance-assignments84278
-Node: incomestatement84927
-Ref: #incomestatement85060
-Node: notes86464
-Ref: #notes86577
-Node: payees86703
-Ref: #payees86809
-Node: prices86967
-Ref: #prices87073
-Node: print87414
-Ref: #print87524
-Node: print-unique92017
-Ref: #print-unique92143
-Node: register92428
-Ref: #register92555
-Node: Custom register output96727
-Ref: #custom-register-output96856
-Node: register-match98118
-Ref: #register-match98252
-Node: rewrite98603
-Ref: #rewrite98718
-Node: Re-write rules in a file100573
-Ref: #re-write-rules-in-a-file100707
-Node: Diff output format101917
-Ref: #diff-output-format102086
-Node: rewrite vs print --auto103178
-Ref: #rewrite-vs.-print---auto103357
-Node: roi103913
-Ref: #roi104011
-Node: stats105023
-Ref: #stats105122
-Node: tags105910
-Ref: #tags106008
-Node: test106302
-Ref: #test106386
-Node: ADD-ON COMMANDS107133
-Ref: #add-on-commands107243
-Node: Official add-ons108531
-Ref: #official-add-ons108671
-Node: ui108751
-Ref: #ui108838
-Node: web108892
-Ref: #web108981
-Node: Third party add-ons109027
-Ref: #third-party-add-ons109202
-Node: iadd109321
-Ref: #iadd109422
-Node: interest109504
-Ref: #interest109613
-Node: Experimental add-ons109708
-Ref: #experimental-add-ons109860
-Node: autosync110098
-Ref: #autosync110209
-Node: chart110448
-Ref: #chart110553
+Node: Special characters in arguments and queries8720
+Ref: #special-characters-in-arguments-and-queries8954
+Node: More escaping9405
+Ref: #more-escaping9567
+Node: Even more escaping9863
+Ref: #even-more-escaping10057
+Node: Less escaping10728
+Ref: #less-escaping10890
+Node: Command line tips11135
+Ref: #command-line-tips11321
+Node: Unicode characters11698
+Ref: #unicode-characters11854
+Node: Input files13266
+Ref: #input-files13402
+Node: Smart dates15331
+Ref: #smart-dates15472
+Node: Report start & end date16878
+Ref: #report-start-end-date17050
+Node: Report intervals18474
+Ref: #report-intervals18639
+Node: Period expressions19029
+Ref: #period-expressions19189
+Node: Depth limiting23144
+Ref: #depth-limiting23288
+Node: Pivoting23630
+Ref: #pivoting23753
+Node: Valuation25429
+Ref: #valuation25558
+Node: -B Cost25738
+Ref: #b-cost25849
+Node: -V Market value26047
+Ref: #v-market-value26221
+Node: -X Market value in specified commodity27653
+Ref: #x-market-value-in-specified-commodity27892
+Node: --value Flexible valuation28068
+Ref: #value-flexible-valuation28294
+Node: Effect of --value on reports32484
+Ref: #effect-of---value-on-reports32700
+Node: Combining -B -V -X --value37631
+Ref: #combining--b--v--x---value37814
+Node: Output destination37850
+Ref: #output-destination38002
+Node: Output format38285
+Ref: #output-format38437
+Node: Regular expressions38822
+Ref: #regular-expressions38959
+Node: QUERIES40320
+Ref: #queries40422
+Node: COMMANDS44384
+Ref: #commands44496
+Node: accounts45560
+Ref: #accounts45658
+Node: activity46357
+Ref: #activity46467
+Node: add46850
+Ref: #add46949
+Node: balance49688
+Ref: #balance49799
+Node: Classic balance report51257
+Ref: #classic-balance-report51430
+Node: Customising the classic balance report52799
+Ref: #customising-the-classic-balance-report53027
+Node: Colour support55103
+Ref: #colour-support55270
+Node: Flat mode55443
+Ref: #flat-mode55591
+Node: Depth limited balance reports56004
+Ref: #depth-limited-balance-reports56189
+Node: Percentages56645
+Ref: #percentages56811
+Node: Multicolumn balance report57948
+Ref: #multicolumn-balance-report58128
+Node: Budget report63442
+Ref: #budget-report63585
+Node: Nested budgets68787
+Ref: #nested-budgets68899
+Ref: #output-format-172380
+Node: balancesheet72458
+Ref: #balancesheet72594
+Node: balancesheetequity73977
+Ref: #balancesheetequity74126
+Node: cashflow74687
+Ref: #cashflow74815
+Node: check-dates75911
+Ref: #check-dates76038
+Node: check-dupes76317
+Ref: #check-dupes76441
+Node: close76734
+Ref: #close76848
+Node: commodities80514
+Ref: #commodities80641
+Node: descriptions80723
+Ref: #descriptions80851
+Node: diff81032
+Ref: #diff81138
+Node: files82185
+Ref: #files82285
+Node: help82432
+Ref: #help82532
+Node: import83613
+Ref: #import83727
+Node: Importing balance assignments84620
+Ref: #importing-balance-assignments84768
+Node: incomestatement85417
+Ref: #incomestatement85550
+Node: notes86954
+Ref: #notes87067
+Node: payees87193
+Ref: #payees87299
+Node: prices87457
+Ref: #prices87563
+Node: print87904
+Ref: #print88014
+Node: print-unique92507
+Ref: #print-unique92633
+Node: register92918
+Ref: #register93045
+Node: Custom register output97217
+Ref: #custom-register-output97346
+Node: register-match98608
+Ref: #register-match98742
+Node: rewrite99093
+Ref: #rewrite99208
+Node: Re-write rules in a file101063
+Ref: #re-write-rules-in-a-file101197
+Node: Diff output format102407
+Ref: #diff-output-format102576
+Node: rewrite vs print --auto103668
+Ref: #rewrite-vs.-print---auto103847
+Node: roi104403
+Ref: #roi104501
+Node: stats105513
+Ref: #stats105612
+Node: tags106400
+Ref: #tags106498
+Node: test106792
+Ref: #test106876
+Node: ADD-ON COMMANDS107623
+Ref: #add-on-commands107733
+Node: Official add-ons109021
+Ref: #official-add-ons109161
+Node: ui109241
+Ref: #ui109328
+Node: web109382
+Ref: #web109471
+Node: Third party add-ons109517
+Ref: #third-party-add-ons109692
+Node: iadd109811
+Ref: #iadd109912
+Node: interest109994
+Ref: #interest110103
+Node: Experimental add-ons110198
+Ref: #experimental-add-ons110350
+Node: autosync110588
+Ref: #autosync110699
+Node: chart110938
+Ref: #chart111043
 
 End Tag Table