doc: update generated manuals

hledger-ui/doc/hledger-ui.1

@@ -234,11 +234,13 @@ While editing the query you can use typical command\-line edit keys
 (CTRL\-a/e/d/k, cursor keys etc.), and \f[C]ENTER\f[]to set the new
 filter or \f[C]ESCAPE\f[]to cancel.
 .PP
-\f[C]d\f[] cycles through the common report period durations: day, week,
+\f[C]t\f[] sets the report period to today, while \f[C]d\f[] and
-month, quarter, year, and unlimited (the default).
+\f[C]u\f[] cycle downward and upward through standard report periods \-
-When the report duration is limited in this way, \f[C]n\f[] and
+day, week, month, quarter, year, and unlimited.
-\f[C]p\f[] step to the next or previous day/week/month/etc.
+This is useful on the register screen, to limit the transaction history.
-(To set arbitrary start/end dates, you can use \f[C]/\f[] to set a
+When a standard report period is selected in this way, \f[C]n\f[] and
+\f[C]p\f[] step to the next or previous period.
+(For non\-standard periods, you can use \f[C]/\f[] to set a
 \f[C]date:\f[] query.)
 .PP
 \f[C]BACKSPACE\f[] or \f[C]DELETE\f[] clears any filters in effect.

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

@@ -166,11 +166,12 @@ described below). While editing the query you can use typical
 command-line edit keys (CTRL-a/e/d/k, cursor keys etc.), and `ENTER'to
 set the new filter or `ESCAPE'to cancel.
 
-   `d' cycles through the common report period durations: day, week,
+   `t' sets the report period to today, while `d' and `u' cycle
-month, quarter, year, and unlimited (the default). When the report
+downward and upward through standard report periods - day, week, month,
-duration is limited in this way, `n' and `p' step to the next or
+quarter, year, and unlimited. This is useful on the register screen, to
-previous day/week/month/etc. (To set arbitrary start/end dates, you can
+limit the transaction history. When a standard report period is
-use `/' to set a `date:' query.)
+selected in this way, `n' and `p' step to the next or previous period.
+(For non-standard periods, you can use `/' to set a `date:' query.)
 
    `BACKSPACE' or `DELETE' clears any filters in effect.
 
@@ -346,15 +347,15 @@ Node: OPTIONS831
 Ref: #options930
 Node: KEYS3743
 Ref: #keys3840
-Node: SCREENS6052
+Node: SCREENS6157
-Ref: #screens6139
+Ref: #screens6244
-Node: Accounts screen6229
+Node: Accounts screen6334
-Ref: #accounts-screen6359
+Ref: #accounts-screen6464
-Node: Register screen7825
+Node: Register screen7930
-Ref: #register-screen7982
+Ref: #register-screen8087
-Node: Transaction screen9942
+Node: Transaction screen10047
-Ref: #transaction-screen10102
+Ref: #transaction-screen10207
-Node: Error screen10969
+Node: Error screen11074
-Ref: #error-screen11093
+Ref: #error-screen11198
 
 End Tag Table

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

@@ -155,11 +155,12 @@ KEYS
        mand-line  edit  keys (CTRL-a/e/d/k, cursor keys etc.), and ENTERto set
        the new filter or ESCAPEto cancel.
 
-       d cycles through the common report period durations: day, week,  month,
+       t sets the report period to today, while d and  u  cycle  downward  and
-       quarter,  year,  and unlimited (the default).  When the report duration
+       upward  through  standard  report  periods - day, week, month, quarter,
-       is limited in  this  way,  n  and  p  step  to  the  next  or  previous
+       year, and unlimited.  This is useful on the register screen,  to  limit
-       day/week/month/etc.   (To  set arbitrary start/end dates, you can use /
+       the  transaction history.  When a standard report period is selected in
-       to set a date: query.)
+       this way, n and p step to the next or previous period.  (For  non-stan-
+       dard periods, you can use / to set a date: query.)
 
        BACKSPACE or DELETE clears any filters in effect.
 

hledger/doc/hledger.1

@@ -1029,12 +1029,13 @@ in tree mode: don\[aq]t squash boring parent accounts
 .RE
 .TP
 .B \f[C]\-H\ \-\-historical\f[]
-in multicolumn mode: show historical ending balances
+show historical ending balances, reflecting postings before report start
 .RS
 .RE
 .TP
 .B \f[C]\-\-cumulative\f[]
-in multicolumn mode: show accumulated ending balances
+in multicolumn mode: show ending balances accumulated from 0 at report
+start
 .RS
 .RE
 .TP
@@ -1635,7 +1636,7 @@ Show postings and their running total.
 Alias: reg.
 .TP
 .B \f[C]\-H\ \-\-historical\f[]
-include prior postings in the running total
+show historical running balance, reflecting prior postings
 .RS
 .RE
 .TP

hledger/doc/hledger.1.info

@@ -817,10 +817,12 @@ Show accounts and their balances. Alias: bal.
      in tree mode: don't squash boring parent accounts
 
 `-H --historical'
-     in multicolumn mode: show historical ending balances
+     show historical ending balances, reflecting postings before report
+     start
 
 `--cumulative'
-     in multicolumn mode: show accumulated ending balances
+     in multicolumn mode: show ending balances accumulated from 0 at
+     report start
 
 `-A --average'
      in multicolumn mode: show a row average column
@@ -1396,7 +1398,7 @@ File: hledger.1.info,  Node: register,  Next: stats,  Prev: print,  Up: COMMANDS
 Show postings and their running total. Alias: reg.
 
 `-H --historical'
-     include prior postings in the running total
+     show historical running balance, reflecting prior postings
 
 `-A --average'
      show a running average instead of the running total (implies
@@ -2125,69 +2127,69 @@ Node: add21806
 Ref: #add21907
 Node: balance24566
 Ref: #balance24679
-Node: Flat mode27395
+Node: Flat mode27448
-Ref: #flat-mode27522
+Ref: #flat-mode27575
-Node: Depth limited balance reports27941
+Node: Depth limited balance reports27994
-Ref: #depth-limited-balance-reports28144
+Ref: #depth-limited-balance-reports28197
-Node: Multicolumn balance reports28565
+Node: Multicolumn balance reports28618
-Ref: #multicolumn-balance-reports28767
+Ref: #multicolumn-balance-reports28820
-Node: Market value33416
+Node: Market value33469
-Ref: #market-value33580
+Ref: #market-value33633
-Node: Custom balance output34073
+Node: Custom balance output34126
-Ref: #custom-balance-output34246
+Ref: #custom-balance-output34299
-Node: Output destination36350
+Node: Output destination36403
-Ref: #output-destination36515
+Ref: #output-destination36568
-Node: CSV output36785
+Node: CSV output36838
-Ref: #csv-output36904
+Ref: #csv-output36957
-Node: balancesheet37301
+Node: balancesheet37354
-Ref: #balancesheet37429
+Ref: #balancesheet37482
-Node: cashflow38081
+Node: cashflow38134
-Ref: #cashflow38198
+Ref: #cashflow38251
-Node: help38888
+Node: help38941
-Ref: #help39000
+Ref: #help39053
-Node: incomestatement39837
+Node: incomestatement39890
-Ref: #incomestatement39967
+Ref: #incomestatement40020
-Node: info40694
+Node: info40747
-Ref: #info40801
+Ref: #info40854
-Node: man41163
+Node: man41216
-Ref: #man41260
+Ref: #man41313
-Node: print41663
+Node: print41716
-Ref: #print41768
+Ref: #print41821
-Node: register43119
+Node: register43172
-Ref: #register43232
+Ref: #register43285
-Node: Custom register output47573
+Node: Custom register output47641
-Ref: #custom-register-output47704
+Ref: #custom-register-output47772
-Node: stats49001
+Node: stats49069
-Ref: #stats49107
+Ref: #stats49175
-Node: test49988
+Node: test50056
-Ref: #test50075
+Ref: #test50143
-Node: ADD-ON COMMANDS50442
+Node: ADD-ON COMMANDS50510
-Ref: #add-on-commands50578
+Ref: #add-on-commands50646
-Node: api51866
+Node: api51934
-Ref: #api51958
+Ref: #api52026
-Node: autosync51992
+Node: autosync52060
-Ref: #autosync52107
+Ref: #autosync52175
-Node: diff54422
+Node: diff54490
-Ref: #diff54532
+Ref: #diff54600
-Node: equity55196
+Node: equity55264
-Ref: #equity55310
+Ref: #equity55378
-Node: interest56638
+Node: interest56706
-Ref: #interest56755
+Ref: #interest56823
-Node: irr59839
+Node: irr59907
-Ref: #irr59952
+Ref: #irr60020
-Node: print-unique62327
+Node: print-unique62395
-Ref: #print-unique62457
+Ref: #print-unique62525
-Node: rewrite62715
+Node: rewrite62783
-Ref: #rewrite62834
+Ref: #rewrite62902
-Node: ui63363
+Node: ui63431
-Ref: #ui63463
+Ref: #ui63531
-Node: web63504
+Node: web63572
-Ref: #web63592
+Ref: #web63660
-Node: TROUBLESHOOTING63625
+Node: TROUBLESHOOTING63693
-Ref: #troubleshooting63744
+Ref: #troubleshooting63812
-Node: Run-time problems63798
+Node: Run-time problems63866
-Ref: #run-time-problems63941
+Ref: #run-time-problems64009
-Node: Known limitations65885
+Node: Known limitations65953
-Ref: #known-limitations66028
+Ref: #known-limitations66096
 
 End Tag Table

hledger/doc/hledger.1.txt

@@ -711,10 +711,12 @@ COMMANDS
               in tree mode: don't squash boring parent accounts
 
        -H --historical
-              in multicolumn mode: show historical ending balances
+              show historical  ending  balances,  reflecting  postings  before
+              report start
 
        --cumulative
-              in multicolumn mode: show accumulated ending balances
+              in  multicolumn mode: show ending balances accumulated from 0 at
+              report start
 
        -A --average
               in multicolumn mode: show a row average column
@@ -1178,7 +1180,7 @@ COMMANDS
        Show postings and their running total.  Alias: reg.
 
        -H --historical
-              include prior postings in the running total
+              show historical running balance, reflecting prior postings
 
        -A --average
               show  a  running  average  instead of the running total (implies