cli: clearer command-line help for --date2 (fixes #604)

doc/lib.m4

@@ -127,7 +127,7 @@ m4_define({{_reportingoptions_}}, {{
 : set start date, end date, and/or reporting interval all at once (overrides the flags above)
 
 `--date2`
-: show, and match with -b/-e/-p/date:, secondary dates instead
+: match the secondary date instead (see command help for other effects)
 
 `-U --unmarked`
 : include only unmarked postings/txns (can combine with -P or -C)

hledger-ui/doc/hledger-ui.1

@@ -142,7 +142,7 @@ set start date, end date, and/or reporting interval all at once
 .RE
 .TP
 .B \f[C]\-\-date2\f[]
-show, and match with \-b/\-e/\-p/date:, secondary dates instead
+match the secondary date instead (see command help for other effects)
 .RS
 .RE
 .TP

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

@@ -103,7 +103,8 @@ the data.
      (overrides the flags above)
 '--date2'
 
-     show, and match with -b/-e/-p/date:, secondary dates instead
+     match the secondary date instead (see command help for other
+     effects)
 '-U --unmarked'
 
      include only unmarked postings/txns (can combine with -P or -C)
@@ -357,17 +358,17 @@ Tag Table:
 Node: Top73
 Node: OPTIONS831
 Ref: #options930
-Node: KEYS3465
-Ref: #keys3562
-Node: SCREENS6358
-Ref: #screens6445
-Node: Accounts screen6535
-Ref: #accounts-screen6665
-Node: Register screen8895
-Ref: #register-screen9052
-Node: Transaction screen11126
-Ref: #transaction-screen11286
-Node: Error screen12156
-Ref: #error-screen12280
+Node: KEYS3479
+Ref: #keys3576
+Node: SCREENS6372
+Ref: #screens6459
+Node: Accounts screen6549
+Ref: #accounts-screen6679
+Node: Register screen8909
+Ref: #register-screen9066
+Node: Transaction screen11140
+Ref: #transaction-screen11300
+Node: Error screen12170
+Ref: #error-screen12294
 
 End Tag Table

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

@@ -99,7 +99,8 @@ OPTIONS
               (overrides the flags above)
 
        --date2
-              show, and match with -b/-e/-p/date:, secondary dates instead
+              match the secondary date instead (see  command  help  for  other
+              effects)
 
        -U --unmarked
               include only unmarked postings/txns (can combine with -P or -C)

hledger-web/doc/hledger-web.1

@@ -198,7 +198,7 @@ set start date, end date, and/or reporting interval all at once
 .RE
 .TP
 .B \f[C]\-\-date2\f[]
-show, and match with \-b/\-e/\-p/date:, secondary dates instead
+match the secondary date instead (see command help for other effects)
 .RS
 .RE
 .TP

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

@@ -148,7 +148,8 @@ options as shown above.
      (overrides the flags above)
 '--date2'
 
-     show, and match with -b/-e/-p/date:, secondary dates instead
+     match the secondary date instead (see command help for other
+     effects)
 '-U --unmarked'
 
      include only unmarked postings/txns (can combine with -P or -C)

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

@@ -144,7 +144,8 @@ OPTIONS
               (overrides the flags above)
 
        --date2
-              show, and match with -b/-e/-p/date:, secondary dates instead
+              match  the  secondary  date  instead (see command help for other
+              effects)
 
        -U --unmarked
               include only unmarked postings/txns (can combine with -P or -C)

hledger/Hledger/Cli/CliOptions.hs

@@ -138,7 +138,7 @@ reportflags = [
  ,flagNone ["quarterly","Q"] (setboolopt "quarterly") "multiperiod/multicolumn report by quarter"
  ,flagNone ["yearly","Y"]    (setboolopt "yearly") "multiperiod/multicolumn report by year"
  ,flagReq  ["period","p"]    (\s opts -> Right $ setopt "period" s opts) "PERIODEXP" "set start date, end date, and/or report interval all at once (overrides the flags above)"
- ,flagNone ["date2"]         (setboolopt "date2") "show, and make -b/-e/-p/date: match, secondary dates instead"
+ ,flagNone ["date2"]         (setboolopt "date2") "match the secondary date instead (see command help for other effects)"
 
  ,flagNone ["unmarked","U"]  (setboolopt "unmarked") "include only unmarked postings/txns (can combine with -P or -C)"
  ,flagNone ["pending","P"]   (setboolopt "pending") "include only pending postings/txns"

hledger/Hledger/Cli/Print.hs

@@ -28,7 +28,7 @@ import Hledger.Cli.Add ( transactionsSimilarTo )
 
 
 printmode = (defCommandMode $ ["print"] ++ aliases) {
-  modeHelp = "show transaction journal entries" `withAliases` aliases
+  modeHelp = "show transaction journal entries, sorted by date. With --date2, sort by secondary date instead." `withAliases` aliases
  ,modeGroupFlags = Group {
      groupUnnamed = [
         let matcharg = "STR"

hledger/Hledger/Cli/Register.hs

@@ -29,7 +29,7 @@ import Hledger.Cli.Utils
 
 
 registermode = (defCommandMode $ ["register"] ++ aliases) {
-  modeHelp = "show postings and running total" `withAliases` aliases
+  modeHelp = "show postings and running total. With --date2, show and sort by secondary date instead." `withAliases` aliases
  ,modeGroupFlags = Group {
      groupUnnamed = [
       flagNone ["cumulative"]         (\opts -> setboolopt "change" opts)

hledger/doc/hledger.1

@@ -253,7 +253,7 @@ set start date, end date, and/or reporting interval all at once
 .RE
 .TP
 .B \f[C]\-\-date2\f[]
-show, and match with \-b/\-e/\-p/date:, secondary dates instead
+match the secondary date instead (see command help for other effects)
 .RS
 .RE
 .TP

hledger/doc/hledger.1.info

@@ -203,7 +203,8 @@ different, like git.)
      (overrides the flags above)
 '--date2'
 
-     show, and match with -b/-e/-p/date:, secondary dates instead
+     match the secondary date instead (see command help for other
+     effects)
 '-U --unmarked'
 
      include only unmarked postings/txns (can combine with -P or -C)
@@ -2087,121 +2088,121 @@ Node: OPTIONS3640
 Ref: #options3744
 Node: General options4025
 Ref: #general-options4152
-Node: Command options6484
-Ref: #command-options6637
-Node: Command arguments7035
-Ref: #command-arguments7195
-Node: Special characters7316
-Ref: #special-characters7474
-Node: Input files8642
-Ref: #input-files8780
-Node: Smart dates10743
-Ref: #smart-dates10886
-Node: Report start & end date11865
-Ref: #report-start-end-date12037
-Node: Report intervals13103
-Ref: #report-intervals13268
-Node: Period expressions13669
-Ref: #period-expressions13829
-Node: Depth limiting16169
-Ref: #depth-limiting16315
-Node: Pivoting16516
-Ref: #pivoting16636
-Node: Cost18407
-Ref: #cost18517
-Node: Market value18635
-Ref: #market-value18772
-Node: Regular expressions20072
-Ref: #regular-expressions20210
-Node: QUERIES21571
-Ref: #queries21675
-Node: COMMANDS25340
-Ref: #commands25454
-Node: accounts26110
-Ref: #accounts26210
-Node: activity27192
-Ref: #activity27304
-Node: add27663
-Ref: #add27764
-Node: balance30422
-Ref: #balance30535
-Node: Flat mode33550
-Ref: #flat-mode33677
-Node: Depth limited balance reports34097
-Ref: #depth-limited-balance-reports34300
-Node: Multicolumn balance reports34720
-Ref: #multicolumn-balance-reports34931
-Node: Custom balance output39579
-Ref: #custom-balance-output39763
-Node: Colour support41856
-Ref: #colour-support42017
-Node: Output destination42190
-Ref: #output-destination42348
-Node: CSV output42618
-Ref: #csv-output42737
-Node: balancesheet43134
-Ref: #balancesheet43262
-Node: cashflow45169
-Ref: #cashflow45286
-Node: help47154
-Ref: #help47266
-Node: incomestatement48340
-Ref: #incomestatement48471
-Node: print50363
-Ref: #print50478
-Node: register54234
-Ref: #register54347
-Node: Custom register output58843
-Ref: #custom-register-output58974
-Node: stats60271
-Ref: #stats60377
-Node: test61258
-Ref: #test61345
-Node: ADD-ON COMMANDS61713
-Ref: #add-on-commands61825
-Node: Official add-ons63112
-Ref: #official-add-ons63254
-Node: api63341
-Ref: #api63432
-Node: ui63484
-Ref: #ui63585
-Node: web63643
-Ref: #web63734
-Node: Third party add-ons63780
-Ref: #third-party-add-ons63957
-Node: diff64092
-Ref: #diff64191
-Node: iadd64290
-Ref: #iadd64406
-Node: interest64489
-Ref: #interest64612
-Node: irr64707
-Ref: #irr64807
-Node: Experimental add-ons64885
-Ref: #experimental-add-ons65039
-Node: autosync65441
-Ref: #autosync65555
-Node: budget65794
-Ref: #budget65918
-Node: chart65984
-Ref: #chart66103
-Node: check66174
-Ref: #check66298
-Node: check-dates66365
-Ref: #check-dates66507
-Node: check-dupes66580
-Ref: #check-dupes66723
-Node: equity66800
-Ref: #equity66928
-Node: prices67047
-Ref: #prices67176
-Node: print-unique67231
-Ref: #print-unique67380
-Node: register-match67473
-Ref: #register-match67629
-Node: rewrite67727
-Ref: #rewrite67861
-Node: tags67939
-Ref: #tags68044
+Node: Command options6498
+Ref: #command-options6651
+Node: Command arguments7049
+Ref: #command-arguments7209
+Node: Special characters7330
+Ref: #special-characters7488
+Node: Input files8656
+Ref: #input-files8794
+Node: Smart dates10757
+Ref: #smart-dates10900
+Node: Report start & end date11879
+Ref: #report-start-end-date12051
+Node: Report intervals13117
+Ref: #report-intervals13282
+Node: Period expressions13683
+Ref: #period-expressions13843
+Node: Depth limiting16183
+Ref: #depth-limiting16329
+Node: Pivoting16530
+Ref: #pivoting16650
+Node: Cost18421
+Ref: #cost18531
+Node: Market value18649
+Ref: #market-value18786
+Node: Regular expressions20086
+Ref: #regular-expressions20224
+Node: QUERIES21585
+Ref: #queries21689
+Node: COMMANDS25354
+Ref: #commands25468
+Node: accounts26124
+Ref: #accounts26224
+Node: activity27206
+Ref: #activity27318
+Node: add27677
+Ref: #add27778
+Node: balance30436
+Ref: #balance30549
+Node: Flat mode33564
+Ref: #flat-mode33691
+Node: Depth limited balance reports34111
+Ref: #depth-limited-balance-reports34314
+Node: Multicolumn balance reports34734
+Ref: #multicolumn-balance-reports34945
+Node: Custom balance output39593
+Ref: #custom-balance-output39777
+Node: Colour support41870
+Ref: #colour-support42031
+Node: Output destination42204
+Ref: #output-destination42362
+Node: CSV output42632
+Ref: #csv-output42751
+Node: balancesheet43148
+Ref: #balancesheet43276
+Node: cashflow45183
+Ref: #cashflow45300
+Node: help47168
+Ref: #help47280
+Node: incomestatement48354
+Ref: #incomestatement48485
+Node: print50377
+Ref: #print50492
+Node: register54248
+Ref: #register54361
+Node: Custom register output58857
+Ref: #custom-register-output58988
+Node: stats60285
+Ref: #stats60391
+Node: test61272
+Ref: #test61359
+Node: ADD-ON COMMANDS61727
+Ref: #add-on-commands61839
+Node: Official add-ons63126
+Ref: #official-add-ons63268
+Node: api63355
+Ref: #api63446
+Node: ui63498
+Ref: #ui63599
+Node: web63657
+Ref: #web63748
+Node: Third party add-ons63794
+Ref: #third-party-add-ons63971
+Node: diff64106
+Ref: #diff64205
+Node: iadd64304
+Ref: #iadd64420
+Node: interest64503
+Ref: #interest64626
+Node: irr64721
+Ref: #irr64821
+Node: Experimental add-ons64899
+Ref: #experimental-add-ons65053
+Node: autosync65455
+Ref: #autosync65569
+Node: budget65808
+Ref: #budget65932
+Node: chart65998
+Ref: #chart66117
+Node: check66188
+Ref: #check66312
+Node: check-dates66379
+Ref: #check-dates66521
+Node: check-dupes66594
+Ref: #check-dupes66737
+Node: equity66814
+Ref: #equity66942
+Node: prices67061
+Ref: #prices67190
+Node: print-unique67245
+Ref: #print-unique67394
+Node: register-match67487
+Ref: #register-match67643
+Node: rewrite67741
+Ref: #rewrite67875
+Node: tags67953
+Ref: #tags68058
 
 End Tag Table

hledger/doc/hledger.1.txt

@@ -174,7 +174,8 @@ OPTIONS
               (overrides the flags above)
 
        --date2
-              show, and match with -b/-e/-p/date:, secondary dates instead
+              match  the  secondary  date  instead (see command help for other
+              effects)
 
        -U --unmarked
               include only unmarked postings/txns (can combine with -P or -C)