;doc: update embedded manuals

hledger/hledger.1

@@ -8460,10 +8460,11 @@ run more quickly than if you ran them individually at the command line.
 .PP
 Also like \f[CR]run\f[R], the input file(s) specified for the
 \f[CR]repl\f[R] command will be the default input for all interactive
-commands, you can override this temporarily by specifying an
-\f[CR]\-f\f[R] option in particular commands, and commands will not see
-any changes made to input files (eg by \f[CR]add\f[R]) until you exit
-and restart the REPL.
+commands.
+You can override this temporarily by specifying an \f[CR]\-f\f[R] option
+in particular commands.
+But note that commands will not see any changes made to input files (eg
+by \f[CR]add\f[R]) until you exit and restart the REPL.
 .PP
 The command syntax is the same as with \f[CR]run\f[R]:
 .IP \[bu] 2
@@ -8496,10 +8497,11 @@ and can be useful.
 You can type control\-C to cancel a long\-running command (but only
 once; typing it a second time will exit the REPL).
 .PP
-And in most shells you can type control\-Z to exit temporarily to the
-shell (and \f[CR]fg\f[R] to return to the REPL).
+And in most shells you can type control\-Z to temporarily exit to the
+shell (and \f[CR]fg\f[R] to bring it back to foreground and return to
+the REPL).
 .PP
-You may find some differences in behaviour between \f[CR]run\f[R]
+You may find some differences in behaviour between \f[CR]repl\f[R]
 command lines and normal hledger command lines.
 For example, in the REPL,
 .IP \[bu] 2

hledger/hledger.info

@@ -8190,10 +8190,10 @@ so commands will run more quickly than if you ran them individually at
 the command line.
 
    Also like 'run', the input file(s) specified for the 'repl' command
-will be the default input for all interactive commands, you can override
-this temporarily by specifying an '-f' option in particular commands,
-and commands will not see any changes made to input files (eg by 'add')
-until you exit and restart the REPL.
+will be the default input for all interactive commands.  You can
+override this temporarily by specifying an '-f' option in particular
+commands.  But note that commands will not see any changes made to input
+files (eg by 'add') until you exit and restart the REPL.
 
    The command syntax is the same as with 'run':
 
@@ -8218,10 +8218,10 @@ way, and can be useful.
    You can type control-C to cancel a long-running command (but only
 once; typing it a second time will exit the REPL).
 
-   And in most shells you can type control-Z to exit temporarily to the
-shell (and 'fg' to return to the REPL).
+   And in most shells you can type control-Z to temporarily exit to the
+shell (and 'fg' to bring it back to foreground and return to the REPL).
 
-   You may find some differences in behaviour between 'run' command
+   You may find some differences in behaviour between 'repl' command
 lines and normal hledger command lines.  For example, in the REPL,
 
    * the command name must be written first, options afterward
@@ -12863,121 +12863,121 @@ Node: demo295039
 Node: help296273
 Node: User interface commands297978
 Node: repl298189
-Node: Examples300659
-Node: run301217
-Node: Examples 2303634
-Node: ui304658
-Node: web304795
-Node: Data entry commands304923
-Node: add305121
-Node: import307576
-Node: Import preview308610
-Node: Overlap detection309558
-Node: First import312444
-Node: Importing balance assignments313639
-Node: Import and commodity styles314694
-Node: Import special cases315132
-Node: Basic report commands316467
-Node: accounts316768
-Node: codes319641
-Node: commodities320663
-Node: descriptions320907
-Node: files321374
-Node: notes321671
-Node: payees322183
-Node: prices322967
-Node: stats323859
-Node: tags325600
-Node: Standard report commands326907
-Node: print327212
-Node: print explicitness329953
-Node: print amount style330873
-Node: print parseability332111
-Node: print other features333030
-Node: print output format333893
-Node: aregister337178
-Node: aregister and posting dates341637
-Node: register342538
-Node: Custom register output349713
-Node: balancesheet350898
-Node: balancesheetequity355668
-Node: cashflow360808
-Node: incomestatement365370
-Node: Advanced report commands369968
-Node: balance370176
-Node: balance features375352
-Node: Simple balance report377428
-Node: Balance report line format379238
-Node: Filtered balance report381598
-Node: List or tree mode382117
-Node: Depth limiting383630
-Node: Dropping top-level accounts384397
-Node: Showing declared accounts384907
-Node: Sorting by amount385637
-Node: Percentages386474
-Node: Multi-period balance report387181
-Node: Balance change end balance389933
-Node: Balance report types391570
-Node: Calculation type392249
-Node: Accumulation type392953
-Node: Valuation type394054
-Node: Combining balance report types395243
-Node: Budget report397275
-Node: Using the budget report399580
-Node: Budget date surprises401856
-Node: Selecting budget goals403220
-Node: Budgeting vs forecasting404168
-Node: Balance report layout405845
-Node: Wide layout407050
-Node: Tall layout409455
-Node: Bare layout410761
-Node: Tidy layout412825
-Node: Balance report output414369
-Node: Some useful balance reports415184
-Node: roi416444
-Node: Spaces and special characters in --inv and --pnl418691
-Node: Semantics of --inv and --pnl419417
-Node: IRR and TWR explained421504
-Node: Chart commands424915
-Node: activity425096
-Node: Data generation commands425593
-Node: close425799
-Node: close --clopen428362
-Node: close --close430536
-Node: close --open431060
-Node: close --assert431310
-Node: close --assign431637
-Node: close --retain432316
-Node: close customisation433173
-Node: close and balance assertions434817
-Node: close examples436339
-Node: Retain earnings436576
-Node: Migrate balances to a new file437079
-Node: More detailed close examples438441
-Node: rewrite438663
-Node: Re-write rules in a file441235
-Node: Diff output format442545
-Node: rewrite vs print --auto443818
-Node: Maintenance commands444532
-Node: check444741
-Node: Basic checks445823
-Node: Strict checks446776
-Node: Other checks447651
-Node: Custom checks449506
-Node: diff449961
-Node: test451168
-Node: PART 5 COMMON TASKS452040
-Node: Getting help452273
-Node: Constructing command lines453182
-Node: Starting a journal file454020
-Node: Setting LEDGER_FILE455404
-Node: Setting opening balances456662
-Node: Recording transactions459984
-Node: Reconciling460709
-Node: Reporting463098
-Node: Migrating to a new file467212
-Node: BUGS467661
-Node: Troubleshooting468626
+Node: Examples300704
+Node: run301262
+Node: Examples 2303679
+Node: ui304703
+Node: web304840
+Node: Data entry commands304968
+Node: add305166
+Node: import307621
+Node: Import preview308655
+Node: Overlap detection309603
+Node: First import312489
+Node: Importing balance assignments313684
+Node: Import and commodity styles314739
+Node: Import special cases315177
+Node: Basic report commands316512
+Node: accounts316813
+Node: codes319686
+Node: commodities320708
+Node: descriptions320952
+Node: files321419
+Node: notes321716
+Node: payees322228
+Node: prices323012
+Node: stats323904
+Node: tags325645
+Node: Standard report commands326952
+Node: print327257
+Node: print explicitness329998
+Node: print amount style330918
+Node: print parseability332156
+Node: print other features333075
+Node: print output format333938
+Node: aregister337223
+Node: aregister and posting dates341682
+Node: register342583
+Node: Custom register output349758
+Node: balancesheet350943
+Node: balancesheetequity355713
+Node: cashflow360853
+Node: incomestatement365415
+Node: Advanced report commands370013
+Node: balance370221
+Node: balance features375397
+Node: Simple balance report377473
+Node: Balance report line format379283
+Node: Filtered balance report381643
+Node: List or tree mode382162
+Node: Depth limiting383675
+Node: Dropping top-level accounts384442
+Node: Showing declared accounts384952
+Node: Sorting by amount385682
+Node: Percentages386519
+Node: Multi-period balance report387226
+Node: Balance change end balance389978
+Node: Balance report types391615
+Node: Calculation type392294
+Node: Accumulation type392998
+Node: Valuation type394099
+Node: Combining balance report types395288
+Node: Budget report397320
+Node: Using the budget report399625
+Node: Budget date surprises401901
+Node: Selecting budget goals403265
+Node: Budgeting vs forecasting404213
+Node: Balance report layout405890
+Node: Wide layout407095
+Node: Tall layout409500
+Node: Bare layout410806
+Node: Tidy layout412870
+Node: Balance report output414414
+Node: Some useful balance reports415229
+Node: roi416489
+Node: Spaces and special characters in --inv and --pnl418736
+Node: Semantics of --inv and --pnl419462
+Node: IRR and TWR explained421549
+Node: Chart commands424960
+Node: activity425141
+Node: Data generation commands425638
+Node: close425844
+Node: close --clopen428407
+Node: close --close430581
+Node: close --open431105
+Node: close --assert431355
+Node: close --assign431682
+Node: close --retain432361
+Node: close customisation433218
+Node: close and balance assertions434862
+Node: close examples436384
+Node: Retain earnings436621
+Node: Migrate balances to a new file437124
+Node: More detailed close examples438486
+Node: rewrite438708
+Node: Re-write rules in a file441280
+Node: Diff output format442590
+Node: rewrite vs print --auto443863
+Node: Maintenance commands444577
+Node: check444786
+Node: Basic checks445868
+Node: Strict checks446821
+Node: Other checks447696
+Node: Custom checks449551
+Node: diff450006
+Node: test451213
+Node: PART 5 COMMON TASKS452085
+Node: Getting help452318
+Node: Constructing command lines453227
+Node: Starting a journal file454065
+Node: Setting LEDGER_FILE455449
+Node: Setting opening balances456707
+Node: Recording transactions460029
+Node: Reconciling460754
+Node: Reporting463143
+Node: Migrating to a new file467257
+Node: BUGS467706
+Node: Troubleshooting468671
 
 End Tag Table