;doc: update manuals

2022-08-22 08:21:39 +01:00 · 2022-08-22 08:21:39 +01:00 · 3f2fdf36b6
commit 3f2fdf36b6
parent 61d2c047e1
3 changed files with 353 additions and 363 deletions
--- a/hledger/hledger.1
+++ b/hledger/hledger.1
@ -5161,24 +5161,22 @@ help
 .PD 0
 .P
 .PD
-Show the hledger user manual in one of several formats, optionally
+Show the hledger user manual with info, man, or a pager if possible.
-positioned at a given TOPIC (if possible).
+With a TOPIC argument, open it at that topic if possible.
-.PP
+TOPIC can be any heading in the manual, or a heading prefix, case
 TOPIC is any heading in the manual, or a heading prefix, case
 insensitive.
 Eg: \f[C]commands\f[R], \f[C]print\f[R], \f[C]forecast\f[R],
-\f[C]\[dq]auto postings\[dq]\f[R], \f[C]journal\f[R], \f[C]amount\f[R].
+\f[C]journal\f[R], \f[C]amount\f[R], \f[C]\[dq]auto postings\[dq]\f[R].
 .PP
-This command shows the user manual built in to this hledger version.
+This command shows the hledger manual built in to your hledger version.
-It can be useful if the correct version of the hledger manual, or the
+It can be useful when offline, or when you prefer the terminal to a web
-usual viewing tools, are not installed on your system.
+browser, or when the appropriate hledger manual or viewing tools are not
 installed on your system.
 .PP
-By default it uses the best viewer it can find in $PATH, in this order:
+By default it chooses the best viewer found in $PATH, preferring info
-\f[C]info\f[R], \f[C]man\f[R], $PAGER (unless a topic is specified),
+since the hledger manual is large.
-\f[C]less\f[R], or stdout.
+You can select a particular viewer with the \f[C]-i\f[R], \f[C]-m\f[R],
-When run non-interactively, it always uses stdout.
+or \f[C]-p\f[R] flags.
 Or you can select a particular viewer with the \f[C]-i\f[R] (info),
 \f[C]-m\f[R] (man), or \f[C]-p\f[R] (pager) flags.
 .PP
 Examples
 .IP
--- a/hledger/hledger.info
+++ b/hledger/hledger.info
@ -4261,22 +4261,19 @@ File: hledger.info,  Node: help,  Next: import,  Prev: files,  Up: COMMANDS
 ==========
 help
-Show the hledger user manual in one of several formats, optionally
+Show the hledger user manual with info, man, or a pager if possible.
-positioned at a given TOPIC (if possible).
+With a TOPIC argument, open it at that topic if possible.  TOPIC can be
 any heading in the manual, or a heading prefix, case insensitive.  Eg:
 'commands', 'print', 'forecast', 'journal', 'amount', '"auto postings"'.
-   TOPIC is any heading in the manual, or a heading prefix, case
+   This command shows the hledger manual built in to your hledger
-insensitive.  Eg: 'commands', 'print', 'forecast', '"auto postings"',
+version.  It can be useful when offline, or when you prefer the terminal
-'journal', 'amount'.
+to a web browser, or when the appropriate hledger manual or viewing
 tools are not installed on your system.
-   This command shows the user manual built in to this hledger version.
+   By default it chooses the best viewer found in $PATH, preferring info
-It can be useful if the correct version of the hledger manual, or the
+since the hledger manual is large.  You can select a particular viewer
-usual viewing tools, are not installed on your system.
+with the '-i', '-m', or '-p' flags.
   By default it uses the best viewer it can find in $PATH, in this
 order: 'info', 'man', $PAGER (unless a topic is specified), 'less', or
 stdout.  When run non-interactively, it always uses stdout.  Or you can
 select a particular viewer with the '-i' (info), '-m' (man), or '-p'
 (pager) flags.
   Examples
@ -9885,324 +9882,324 @@ Node: files154054
 Ref: #files154156
 Node: help154303
 Ref: #help154405
-Node: import155393
+Node: import155346
-Ref: #import155509
+Ref: #import155462
-Node: Deduplication156602
+Node: Deduplication156555
-Ref: #deduplication156727
+Ref: #deduplication156680
-Node: Import testing158621
+Node: Import testing158574
-Ref: #import-testing158786
+Ref: #import-testing158739
-Node: Importing balance assignments159274
+Node: Importing balance assignments159227
-Ref: #importing-balance-assignments159480
+Ref: #importing-balance-assignments159433
-Node: Commodity display styles160129
+Node: Commodity display styles160082
-Ref: #commodity-display-styles160302
+Ref: #commodity-display-styles160255
-Node: incomestatement160431
+Node: incomestatement160384
-Ref: #incomestatement160566
+Ref: #incomestatement160519
-Node: notes161898
+Node: notes161851
-Ref: #notes162013
+Ref: #notes161966
-Node: payees162381
+Node: payees162334
-Ref: #payees162489
+Ref: #payees162442
-Node: prices163015
+Node: prices162968
-Ref: #prices163123
+Ref: #prices163076
-Node: print163492
+Node: print163445
-Ref: #print163604
+Ref: #print163557
-Node: print-unique168972
+Node: print-unique168925
-Ref: #print-unique169100
+Ref: #print-unique169053
-Node: register169385
+Node: register169338
-Ref: #register169514
+Ref: #register169467
-Node: Custom register output174264
+Node: Custom register output174217
-Ref: #custom-register-output174395
+Ref: #custom-register-output174348
-Node: register-match175732
+Node: register-match175685
-Ref: #register-match175868
+Ref: #register-match175821
-Node: rewrite176219
+Node: rewrite176172
-Ref: #rewrite176336
+Ref: #rewrite176289
-Node: Re-write rules in a file178242
+Node: Re-write rules in a file178195
-Ref: #re-write-rules-in-a-file178405
+Ref: #re-write-rules-in-a-file178358
-Node: Diff output format179554
+Node: Diff output format179507
-Ref: #diff-output-format179737
+Ref: #diff-output-format179690
-Node: rewrite vs print --auto180829
+Node: rewrite vs print --auto180782
-Ref: #rewrite-vs.-print---auto180989
+Ref: #rewrite-vs.-print---auto180942
-Node: roi181545
+Node: roi181498
-Ref: #roi181645
+Ref: #roi181598
-Node: Spaces and special characters in --inv and --pnl183370
+Node: Spaces and special characters in --inv and --pnl183323
-Ref: #spaces-and-special-characters-in---inv-and---pnl183610
+Ref: #spaces-and-special-characters-in---inv-and---pnl183563
-Node: Semantics of --inv and --pnl184098
+Node: Semantics of --inv and --pnl184051
-Ref: #semantics-of---inv-and---pnl184337
+Ref: #semantics-of---inv-and---pnl184290
-Node: IRR and TWR explained186187
+Node: IRR and TWR explained186140
-Ref: #irr-and-twr-explained186347
+Ref: #irr-and-twr-explained186300
-Node: stats189433
+Node: stats189386
-Ref: #stats189534
+Ref: #stats189487
-Node: tags190914
+Node: tags190867
-Ref: #tags191014
+Ref: #tags190967
-Node: test192028
+Node: test191981
-Ref: #test192138
+Ref: #test192091
-Node: Add-on commands192885
+Node: Add-on commands192838
-Ref: #add-on-commands193004
+Ref: #add-on-commands192957
-Node: JOURNAL FORMAT194135
+Node: JOURNAL FORMAT194088
-Ref: #journal-format194263
+Ref: #journal-format194216
-Node: Transactions196490
+Node: Transactions196443
-Ref: #transactions196605
+Ref: #transactions196558
-Node: Dates197619
+Node: Dates197572
-Ref: #dates197735
+Ref: #dates197688
-Node: Simple dates197800
+Node: Simple dates197753
-Ref: #simple-dates197920
+Ref: #simple-dates197873
-Node: Secondary dates198429
+Node: Secondary dates198382
-Ref: #secondary-dates198577
+Ref: #secondary-dates198530
-Node: Posting dates199913
+Node: Posting dates199866
-Ref: #posting-dates200036
+Ref: #posting-dates199989
-Node: Status201408
+Node: Status201361
-Ref: #status201518
+Ref: #status201471
-Node: Code203226
+Node: Code203179
-Ref: #code203338
+Ref: #code203291
-Node: Description203570
+Node: Description203523
-Ref: #description203698
+Ref: #description203651
-Node: Payee and note204018
+Node: Payee and note203971
-Ref: #payee-and-note204126
+Ref: #payee-and-note204079
-Node: Comments204461
+Node: Comments204414
-Ref: #comments204583
+Ref: #comments204536
-Node: Tags205777
+Node: Tags205730
-Ref: #tags-1205888
+Ref: #tags-1205841
-Node: Postings207343
+Node: Postings207296
-Ref: #postings207467
+Ref: #postings207420
-Node: Virtual postings208493
+Node: Virtual postings208446
-Ref: #virtual-postings208604
+Ref: #virtual-postings208557
-Node: Account names209909
+Node: Account names209862
-Ref: #account-names210046
+Ref: #account-names209999
-Node: Amounts210534
+Node: Amounts210487
-Ref: #amounts210671
+Ref: #amounts210624
-Node: Decimal marks digit group marks211656
+Node: Decimal marks digit group marks211609
-Ref: #decimal-marks-digit-group-marks211833
+Ref: #decimal-marks-digit-group-marks211786
-Node: Commodity212854
+Node: Commodity212807
-Ref: #commodity213043
+Ref: #commodity212996
-Node: Directives influencing number parsing and display213995
+Node: Directives influencing number parsing and display213948
-Ref: #directives-influencing-number-parsing-and-display214256
+Ref: #directives-influencing-number-parsing-and-display214209
-Node: Commodity display style214749
+Node: Commodity display style214702
-Ref: #commodity-display-style214957
+Ref: #commodity-display-style214910
-Node: Rounding217152
+Node: Rounding217105
-Ref: #rounding217272
+Ref: #rounding217225
-Node: Transaction prices217684
+Node: Transaction prices217637
-Ref: #transaction-prices217850
+Ref: #transaction-prices217803
-Node: Equity conversion postings220322
+Node: Equity conversion postings220275
-Ref: #equity-conversion-postings220475
+Ref: #equity-conversion-postings220428
-Node: Lot prices lot dates222993
+Node: Lot prices lot dates222946
-Ref: #lot-prices-lot-dates223176
+Ref: #lot-prices-lot-dates223129
-Node: Balance assertions223664
+Node: Balance assertions223617
-Ref: #balance-assertions223842
+Ref: #balance-assertions223795
-Node: Assertions and ordering224915
+Node: Assertions and ordering224868
-Ref: #assertions-and-ordering225106
+Ref: #assertions-and-ordering225059
-Node: Assertions and multiple included files225806
+Node: Assertions and multiple included files225759
-Ref: #assertions-and-multiple-included-files226068
+Ref: #assertions-and-multiple-included-files226021
-Node: Assertions and multiple -f files226568
+Node: Assertions and multiple -f files226521
-Ref: #assertions-and-multiple--f-files226821
+Ref: #assertions-and-multiple--f-files226774
-Node: Assertions and commodities227218
+Node: Assertions and commodities227171
-Ref: #assertions-and-commodities227442
+Ref: #assertions-and-commodities227395
-Node: Assertions and prices228622
+Node: Assertions and prices228575
-Ref: #assertions-and-prices228830
+Ref: #assertions-and-prices228783
-Node: Assertions and subaccounts229270
+Node: Assertions and subaccounts229223
-Ref: #assertions-and-subaccounts229493
+Ref: #assertions-and-subaccounts229446
-Node: Assertions and virtual postings229817
+Node: Assertions and virtual postings229770
-Ref: #assertions-and-virtual-postings230057
+Ref: #assertions-and-virtual-postings230010
-Node: Assertions and auto postings230189
+Node: Assertions and auto postings230142
-Ref: #assertions-and-auto-postings230421
+Ref: #assertions-and-auto-postings230374
-Node: Assertions and precision231066
+Node: Assertions and precision231019
-Ref: #assertions-and-precision231250
+Ref: #assertions-and-precision231203
-Node: Balance assignments231517
+Node: Balance assignments231470
-Ref: #balance-assignments231687
+Ref: #balance-assignments231640
-Node: Balance assignments and prices232851
+Node: Balance assignments and prices232804
-Ref: #balance-assignments-and-prices233017
+Ref: #balance-assignments-and-prices232970
-Node: Directives233241
+Node: Directives233194
-Ref: #directives233404
+Ref: #directives233357
-Node: Directives and multiple files237896
+Node: Directives and multiple files237849
-Ref: #directives-and-multiple-files238092
+Ref: #directives-and-multiple-files238045
-Node: Comment blocks238784
+Node: Comment blocks238737
-Ref: #comment-blocks238961
+Ref: #comment-blocks238914
-Node: Including other files239137
+Node: Including other files239090
-Ref: #including-other-files239311
+Ref: #including-other-files239264
-Node: Default year240235
+Node: Default year240188
-Ref: #default-year240393
+Ref: #default-year240346
-Node: Declaring payees240800
+Node: Declaring payees240753
-Ref: #declaring-payees240971
+Ref: #declaring-payees240924
-Node: Declaring the decimal mark241217
+Node: Declaring the decimal mark241170
-Ref: #declaring-the-decimal-mark241417
+Ref: #declaring-the-decimal-mark241370
-Node: Declaring commodities241814
+Node: Declaring commodities241767
-Ref: #declaring-commodities242005
+Ref: #declaring-commodities241958
-Node: Commodity error checking244523
+Node: Commodity error checking244476
-Ref: #commodity-error-checking244673
+Ref: #commodity-error-checking244626
-Node: Default commodity245188
+Node: Default commodity245141
-Ref: #default-commodity245368
+Ref: #default-commodity245321
-Node: Declaring market prices246484
+Node: Declaring market prices246437
-Ref: #declaring-market-prices246673
+Ref: #declaring-market-prices246626
-Node: Declaring accounts247486
+Node: Declaring accounts247439
-Ref: #declaring-accounts247666
+Ref: #declaring-accounts247619
-Node: Account comments248830
+Node: Account comments248783
-Ref: #account-comments248983
+Ref: #account-comments248936
-Node: Account subdirectives249406
+Node: Account subdirectives249359
-Ref: #account-subdirectives249600
+Ref: #account-subdirectives249553
-Node: Account error checking249742
+Node: Account error checking249695
-Ref: #account-error-checking249943
+Ref: #account-error-checking249896
-Node: Account display order251132
+Node: Account display order251085
-Ref: #account-display-order251323
+Ref: #account-display-order251276
-Node: Account types252424
+Node: Account types252377
-Ref: #account-types252568
+Ref: #account-types252521
-Node: Rewriting accounts256243
+Node: Rewriting accounts256196
-Ref: #rewriting-accounts256422
+Ref: #rewriting-accounts256375
-Node: Basic aliases257462
+Node: Basic aliases257415
-Ref: #basic-aliases257598
+Ref: #basic-aliases257551
-Node: Regex aliases258342
+Node: Regex aliases258295
-Ref: #regex-aliases258504
+Ref: #regex-aliases258457
-Node: Combining aliases259394
+Node: Combining aliases259347
-Ref: #combining-aliases259577
+Ref: #combining-aliases259530
-Node: Aliases and multiple files260853
+Node: Aliases and multiple files260806
-Ref: #aliases-and-multiple-files261052
+Ref: #aliases-and-multiple-files261005
-Node: end aliases261631
+Node: end aliases261584
-Ref: #end-aliases261825
+Ref: #end-aliases261778
-Node: Aliases can generate bad account names261974
+Node: Aliases can generate bad account names261927
-Ref: #aliases-can-generate-bad-account-names262217
+Ref: #aliases-can-generate-bad-account-names262170
-Node: Aliases and account types262802
+Node: Aliases and account types262755
-Ref: #aliases-and-account-types262999
+Ref: #aliases-and-account-types262952
-Node: Default parent account263695
+Node: Default parent account263648
-Ref: #default-parent-account263885
+Ref: #default-parent-account263838
-Node: Periodic transactions264769
+Node: Periodic transactions264722
-Ref: #periodic-transactions264952
+Ref: #periodic-transactions264905
-Node: Periodic rule syntax266907
+Node: Periodic rule syntax266860
-Ref: #periodic-rule-syntax267087
+Ref: #periodic-rule-syntax267040
-Node: Periodic rules and relative dates267546
+Node: Periodic rules and relative dates267499
-Ref: #periodic-rules-and-relative-dates267814
+Ref: #periodic-rules-and-relative-dates267767
-Node: Two spaces between period expression and description!268325
+Node: Two spaces between period expression and description!268278
-Ref: #two-spaces-between-period-expression-and-description268651
+Ref: #two-spaces-between-period-expression-and-description268604
-Node: Forecasting with periodic transactions269335
+Node: Forecasting with periodic transactions269288
-Ref: #forecasting-with-periodic-transactions269634
+Ref: #forecasting-with-periodic-transactions269587
-Node: Budgeting with periodic transactions272405
+Node: Budgeting with periodic transactions272358
-Ref: #budgeting-with-periodic-transactions272638
+Ref: #budgeting-with-periodic-transactions272591
-Node: Auto postings273047
+Node: Auto postings273000
-Ref: #auto-postings273183
+Ref: #auto-postings273136
-Node: Auto postings and multiple files275362
+Node: Auto postings and multiple files275315
-Ref: #auto-postings-and-multiple-files275560
+Ref: #auto-postings-and-multiple-files275513
-Node: Auto postings and dates275769
+Node: Auto postings and dates275722
-Ref: #auto-postings-and-dates276037
+Ref: #auto-postings-and-dates275990
-Node: Auto postings and transaction balancing / inferred amounts / balance assertions276212
+Node: Auto postings and transaction balancing / inferred amounts / balance assertions276165
-Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions276557
+Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions276510
-Node: Auto posting tags277060
+Node: Auto posting tags277013
-Ref: #auto-posting-tags277269
+Ref: #auto-posting-tags277222
-Node: CSV FORMAT277905
+Node: CSV FORMAT277858
-Ref: #csv-format278033
+Ref: #csv-format277986
-Node: Examples280663
+Node: Examples280616
-Ref: #examples280766
+Ref: #examples280719
-Node: Basic280974
+Node: Basic280927
-Ref: #basic281076
+Ref: #basic281029
-Node: Bank of Ireland281618
+Node: Bank of Ireland281571
-Ref: #bank-of-ireland281755
+Ref: #bank-of-ireland281708
-Node: Amazon283217
+Node: Amazon283170
-Ref: #amazon283337
+Ref: #amazon283290
-Node: Paypal285056
+Node: Paypal285009
-Ref: #paypal285152
+Ref: #paypal285105
-Node: CSV rules292796
+Node: CSV rules292749
-Ref: #csv-rules292914
+Ref: #csv-rules292867
-Node: skip293247
+Node: skip293200
-Ref: #skip293347
+Ref: #skip293300
-Node: fields list293722
+Node: fields list293675
-Ref: #fields-list293861
+Ref: #fields-list293814
-Node: field assignment295427
+Node: field assignment295380
-Ref: #field-assignment295579
+Ref: #field-assignment295532
-Node: Field names296614
+Node: Field names296567
-Ref: #field-names296754
+Ref: #field-names296707
-Node: date field297134
+Node: date field297087
-Ref: #date-field297254
+Ref: #date-field297207
-Node: date2 field297302
+Node: date2 field297255
-Ref: #date2-field297445
+Ref: #date2-field297398
-Node: status field297501
+Node: status field297454
-Ref: #status-field297646
+Ref: #status-field297599
-Node: code field297695
+Node: code field297648
-Ref: #code-field297842
+Ref: #code-field297795
-Node: description field297887
+Node: description field297840
-Ref: #description-field298049
+Ref: #description-field298002
-Node: comment field298108
+Node: comment field298061
-Ref: #comment-field298265
+Ref: #comment-field298218
-Node: account field298576
+Node: account field298529
-Ref: #account-field298728
+Ref: #account-field298681
-Node: amount field299303
+Node: amount field299256
-Ref: #amount-field299454
+Ref: #amount-field299407
-Node: currency field300699
+Node: currency field300652
-Ref: #currency-field300854
+Ref: #currency-field300807
-Node: balance field301111
+Node: balance field301064
-Ref: #balance-field301245
+Ref: #balance-field301198
-Node: separator301617
+Node: separator301570
-Ref: #separator301749
+Ref: #separator301702
-Node: if block302289
+Node: if block302242
-Ref: #if-block302416
+Ref: #if-block302369
-Node: Matching the whole record302817
+Node: Matching the whole record302770
-Ref: #matching-the-whole-record302994
+Ref: #matching-the-whole-record302947
-Node: Matching individual fields303797
+Node: Matching individual fields303750
-Ref: #matching-individual-fields304003
+Ref: #matching-individual-fields303956
-Node: Combining matchers304227
+Node: Combining matchers304180
-Ref: #combining-matchers304425
+Ref: #combining-matchers304378
-Node: Rules applied on successful match304738
+Node: Rules applied on successful match304691
-Ref: #rules-applied-on-successful-match304931
+Ref: #rules-applied-on-successful-match304884
-Node: if table305585
+Node: if table305538
-Ref: #if-table305706
+Ref: #if-table305659
-Node: end307444
+Node: end307397
-Ref: #end307558
+Ref: #end307511
-Node: date-format307782
+Node: date-format307735
-Ref: #date-format307916
+Ref: #date-format307869
-Node: decimal-mark308912
+Node: decimal-mark308865
-Ref: #decimal-mark309059
+Ref: #decimal-mark309012
-Node: newest-first309398
+Node: newest-first309351
-Ref: #newest-first309541
+Ref: #newest-first309494
-Node: include310224
+Node: include310177
-Ref: #include310357
+Ref: #include310310
-Node: balance-type310801
+Node: balance-type310754
-Ref: #balance-type310923
+Ref: #balance-type310876
-Node: Tips311623
+Node: Tips311576
-Ref: #tips311714
+Ref: #tips311667
-Node: Rapid feedback312013
+Node: Rapid feedback311966
-Ref: #rapid-feedback312132
+Ref: #rapid-feedback312085
-Node: Valid CSV312584
+Node: Valid CSV312537
-Ref: #valid-csv312716
+Ref: #valid-csv312669
-Node: File Extension312908
+Node: File Extension312861
-Ref: #file-extension313062
+Ref: #file-extension313015
-Node: Reading multiple CSV files313491
+Node: Reading multiple CSV files313444
-Ref: #reading-multiple-csv-files313678
+Ref: #reading-multiple-csv-files313631
-Node: Valid transactions313919
+Node: Valid transactions313872
-Ref: #valid-transactions314099
+Ref: #valid-transactions314052
-Node: Deduplicating importing314727
+Node: Deduplicating importing314680
-Ref: #deduplicating-importing314908
+Ref: #deduplicating-importing314861
-Node: Setting amounts315944
+Node: Setting amounts315897
-Ref: #setting-amounts316101
+Ref: #setting-amounts316054
-Node: Amount signs318545
+Node: Amount signs318498
-Ref: #amount-signs318699
+Ref: #amount-signs318652
-Node: Setting currency/commodity319386
+Node: Setting currency/commodity319339
-Ref: #setting-currencycommodity319574
+Ref: #setting-currencycommodity319527
-Node: Amount decimal places320748
+Node: Amount decimal places320701
-Ref: #amount-decimal-places320940
+Ref: #amount-decimal-places320893
-Node: Referencing other fields321252
+Node: Referencing other fields321205
-Ref: #referencing-other-fields321451
+Ref: #referencing-other-fields321404
-Node: How CSV rules are evaluated322348
+Node: How CSV rules are evaluated322301
-Ref: #how-csv-rules-are-evaluated322523
+Ref: #how-csv-rules-are-evaluated322476
-Node: TIMECLOCK FORMAT323974
+Node: TIMECLOCK FORMAT323927
-Ref: #timeclock-format324114
+Ref: #timeclock-format324067
-Node: TIMEDOT FORMAT326175
+Node: TIMEDOT FORMAT326128
-Ref: #timedot-format326313
+Ref: #timedot-format326266
-Node: COMMON TASKS330875
+Node: COMMON TASKS330828
-Ref: #common-tasks331004
+Ref: #common-tasks330957
-Node: Getting help331278
+Node: Getting help331231
-Ref: #getting-help331412
+Ref: #getting-help331365
-Node: Constructing command lines332164
+Node: Constructing command lines332117
-Ref: #constructing-command-lines332358
+Ref: #constructing-command-lines332311
-Node: Starting a journal file333055
+Node: Starting a journal file333008
-Ref: #starting-a-journal-file333255
+Ref: #starting-a-journal-file333208
-Node: Setting opening balances334443
+Node: Setting opening balances334396
-Ref: #setting-opening-balances334641
+Ref: #setting-opening-balances334594
-Node: Recording transactions337782
+Node: Recording transactions337735
-Ref: #recording-transactions337964
+Ref: #recording-transactions337917
-Node: Reconciling338520
+Node: Reconciling338473
-Ref: #reconciling338665
+Ref: #reconciling338618
-Node: Reporting340922
+Node: Reporting340875
-Ref: #reporting341064
+Ref: #reporting341017
-Node: Migrating to a new file345063
+Node: Migrating to a new file345016
-Ref: #migrating-to-a-new-file345213
+Ref: #migrating-to-a-new-file345166
-Node: LIMITATIONS345512
+Node: LIMITATIONS345465
-Ref: #limitations345640
+Ref: #limitations345593
-Node: TROUBLESHOOTING346409
+Node: TROUBLESHOOTING346362
-Ref: #troubleshooting346524
+Ref: #troubleshooting346477
 End Tag Table
--- a/hledger/hledger.txt
+++ b/hledger/hledger.txt
@ -3633,20 +3633,19 @@ COMMANDS
   help
       help
-       Show  the  hledger  user  manual  in one of several formats, optionally
+       Show  the  hledger  user manual with info, man, or a pager if possible.
-       positioned at a given TOPIC (if possible).
+       With a TOPIC argument, open it at that topic if possible.  TOPIC can be
       any  heading in the manual, or a heading prefix, case insensitive.  Eg:
       commands, print, forecast, journal, amount, "auto postings".
-       TOPIC is any heading in the manual, or a heading prefix, case  insensi-
+       This command shows the hledger manual built in to your hledger version.
-       tive.  Eg: commands, print, forecast, "auto postings", journal, amount.
+       It can be useful when offline, or when you prefer the terminal to a web
       browser, or when the appropriate hledger manual or  viewing  tools  are
       not installed on your system.
-       This command shows the user manual built in to  this  hledger  version.
+       By  default  it chooses the best viewer found in $PATH, preferring info
-       It  can  be useful if the correct version of the hledger manual, or the
+       since the hledger manual is large.  You can select a particular  viewer
-       usual viewing tools, are not installed on your system.
+       with the -i, -m, or -p flags.
       By default it uses the best viewer it can find in $PATH, in this order:
       info, man, $PAGER (unless a topic is specified), less, or stdout.  When
       run non-interactively, it always uses stdout.  Or you can select a par-
       ticular viewer with the -i (info), -m (man), or -p (pager) flags.
       Examples
@ -5380,6 +5379,7 @@ JOURNAL FORMAT
       Generate  extra transactions or   ~
       budget goals
       Generate extra postings           =
       CHECKING FOR ERRORS:
       Define valid entities to  allow   account,    commodity,
       stricter error checking           payee
@ -5402,9 +5402,6 @@ JOURNAL FORMAT
                  any text, ignored.
       alias      Rewrites  account  names,  in  following entries until end of   Y
                  current file or end aliases.
       apply      Prepends a common parent account to  all  account  names,  in   Y
       account    following  entries  until  end  of  current file or end apply
                  account.
@ -6388,8 +6385,6 @@ CSV FORMAT
       below, after the examples:
       skip                         skip one or more header lines or matched CSV
                                    records
       fields list                  name  CSV  fields,  assign  them  to hledger