;update manuals

2021-05-18 10:48:42 -10:00 · 2021-05-18 10:48:42 -10:00 · 6a3019c5a8
commit 6a3019c5a8
parent 031219e792
9 changed files with 594 additions and 571 deletions
--- a/hledger-ui/hledger-ui.1
+++ b/hledger-ui/hledger-ui.1
@ -97,10 +97,12 @@ do extra error checking (check that all posted accounts are declared)
 hledger reporting options:
 .TP
 \f[B]\f[CB]-b --begin=DATE\f[B]\f[R]
-include postings/txns on or after this date
+include postings/txns on or after this date (will be adjusted to
+preceding subperiod start when using a report interval)
 .TP
 \f[B]\f[CB]-e --end=DATE\f[B]\f[R]
-include postings/txns before this date
+include postings/txns before this date (will be adjusted to following
+subperiod end when using a report interval)
 .TP
 \f[B]\f[CB]-D --daily\f[B]\f[R]
 multiperiod/multicolumn report by day
--- a/hledger-ui/hledger-ui.info
+++ b/hledger-ui/hledger-ui.info
@ -107,10 +107,12 @@ the data.
   hledger reporting options:

 `-b --begin=DATE'
-     include postings/txns on or after this date
+     include postings/txns on or after this date (will be adjusted to
+     preceding subperiod start when using a report interval)

 `-e --end=DATE'
-     include postings/txns before this date
+     include postings/txns before this date (will be adjusted to
+     following subperiod end when using a report interval)

 `-D --daily'
     multiperiod/multicolumn report by day
@ -529,23 +531,23 @@ Tag Table:
 Node: Top82
 Node: OPTIONS1478
 Ref: #options1575
-Node: KEYS5808
-Ref: #keys5903
-Node: SCREENS10199
-Ref: #screens10304
-Node: Accounts screen10394
-Ref: #accounts-screen10522
-Node: Register screen12726
-Ref: #register-screen12881
-Node: Transaction screen14876
-Ref: #transaction-screen15034
-Node: Error screen15901
-Ref: #error-screen16023
-Node: ENVIRONMENT16265
-Ref: #environment16379
-Node: FILES17184
-Ref: #files17283
-Node: BUGS17496
-Ref: #bugs17573
+Node: KEYS5970
+Ref: #keys6065
+Node: SCREENS10361
+Ref: #screens10466
+Node: Accounts screen10556
+Ref: #accounts-screen10684
+Node: Register screen12888
+Ref: #register-screen13043
+Node: Transaction screen15038
+Ref: #transaction-screen15196
+Node: Error screen16063
+Ref: #error-screen16185
+Node: ENVIRONMENT16427
+Ref: #environment16541
+Node: FILES17346
+Ref: #files17445
+Node: BUGS17658
+Ref: #bugs17735

 End Tag Table
--- a/hledger-ui/hledger-ui.txt
+++ b/hledger-ui/hledger-ui.txt
@ -92,10 +92,12 @@ OPTIONS
       hledger reporting options:

       -b --begin=DATE
-              include postings/txns on or after this date
+              include postings/txns on or after this date (will be adjusted to
+              preceding subperiod start when using a report interval)

       -e --end=DATE
-              include postings/txns before this date
+              include postings/txns before this date (will be adjusted to fol-
+              lowing subperiod end when using a report interval)

       -D --daily
              multiperiod/multicolumn report by day
--- a/hledger-web/hledger-web.1
+++ b/hledger-web/hledger-web.1
@ -126,10 +126,12 @@ do extra error checking (check that all posted accounts are declared)
 hledger reporting options:
 .TP
 \f[B]\f[CB]-b --begin=DATE\f[B]\f[R]
-include postings/txns on or after this date
+include postings/txns on or after this date (will be adjusted to
+preceding subperiod start when using a report interval)
 .TP
 \f[B]\f[CB]-e --end=DATE\f[B]\f[R]
-include postings/txns before this date
+include postings/txns before this date (will be adjusted to following
+subperiod end when using a report interval)
 .TP
 \f[B]\f[CB]-D --daily\f[B]\f[R]
 multiperiod/multicolumn report by day
--- a/hledger-web/hledger-web.info
+++ b/hledger-web/hledger-web.info
@ -133,10 +133,12 @@ before options, as shown in the synopsis above.
   hledger reporting options:

 `-b --begin=DATE'
-     include postings/txns on or after this date
+     include postings/txns on or after this date (will be adjusted to
+     preceding subperiod start when using a report interval)

 `-e --end=DATE'
-     include postings/txns before this date
+     include postings/txns before this date (will be adjusted to
+     following subperiod end when using a report interval)

 `-D --daily'
     multiperiod/multicolumn report by day
@ -608,19 +610,19 @@ Tag Table:
 Node: Top84
 Node: OPTIONS1727
 Ref: #options1832
-Node: PERMISSIONS9083
-Ref: #permissions9222
-Node: EDITING UPLOADING DOWNLOADING10434
-Ref: #editing-uploading-downloading10615
-Node: RELOADING11446
-Ref: #reloading11580
-Node: JSON API12012
-Ref: #json-api12126
-Node: ENVIRONMENT17615
-Ref: #environment17731
-Node: FILES18463
-Ref: #files18563
-Node: BUGS18776
-Ref: #bugs18854
+Node: PERMISSIONS9245
+Ref: #permissions9384
+Node: EDITING UPLOADING DOWNLOADING10596
+Ref: #editing-uploading-downloading10777
+Node: RELOADING11608
+Ref: #reloading11742
+Node: JSON API12174
+Ref: #json-api12288
+Node: ENVIRONMENT17777
+Ref: #environment17893
+Node: FILES18625
+Ref: #files18725
+Node: BUGS18938
+Ref: #bugs19016

 End Tag Table
--- a/hledger-web/hledger-web.txt
+++ b/hledger-web/hledger-web.txt
@ -115,10 +115,12 @@ OPTIONS
       hledger reporting options:

       -b --begin=DATE
-              include postings/txns on or after this date
+              include postings/txns on or after this date (will be adjusted to
+              preceding subperiod start when using a report interval)

       -e --end=DATE
-              include postings/txns before this date
+              include postings/txns before this date (will be adjusted to fol-
+              lowing subperiod end when using a report interval)

       -D --daily
              multiperiod/multicolumn report by day
--- a/hledger/hledger.1
+++ b/hledger/hledger.1
@ -119,10 +119,12 @@ do extra error checking (check that all posted accounts are declared)
 General reporting options:
 .TP
 \f[B]\f[CB]-b --begin=DATE\f[B]\f[R]
-include postings/txns on or after this date
+include postings/txns on or after this date (will be adjusted to
+preceding subperiod start when using a report interval)
 .TP
 \f[B]\f[CB]-e --end=DATE\f[B]\f[R]
-include postings/txns before this date
+include postings/txns before this date (will be adjusted to following
+subperiod end when using a report interval)
 .TP
 \f[B]\f[CB]-D --daily\f[B]\f[R]
 multiperiod/multicolumn report by day
@ -780,6 +782,9 @@ The effective report start and end dates are the intersection of the
 start/end dates from options and that from \f[C]date:\f[R] queries.
 That is, \f[C]date:2019-01 date:2019 -p\[aq]2000 to 2030\[aq]\f[R]
 yields January 2019, the smallest common time span.
+.IP \[bu] 2
+A report interval (see below) will adjust start/end dates, when needed,
+so that they fall on subperiod boundaries.
 .PP
 Examples:
 .PP
@ -1207,6 +1212,8 @@ Examples: \f[C]date:2016\f[R], \f[C]date:thismonth\f[R],
 \f[C]date:2000/2/1-2/15\f[R], \f[C]date:lastweek-\f[R].
 If the \f[C]--date2\f[R] command line flag is present, this matches
 secondary dates instead.
+(Report intervals will adjust start/end dates to preceding/following
+subperiod boundaries.)
 .TP
 \f[B]\f[R]\f[C]date2:PERIODEXPR\f[R]\f[B]\f[R]
 match secondary dates within the specified period.
--- a/hledger/hledger.info
+++ b/hledger/hledger.info
@ -149,10 +149,12 @@ by most hledger commands, run `hledger -h'.
   General reporting options:

 `-b --begin=DATE'
-     include postings/txns on or after this date
+     include postings/txns on or after this date (will be adjusted to
+     preceding subperiod start when using a report interval)

 `-e --end=DATE'
-     include postings/txns before this date
+     include postings/txns before this date (will be adjusted to
+     following subperiod end when using a report interval)

 `-D --daily'
     multiperiod/multicolumn report by day
@ -726,6 +728,9 @@ these accept the smart date syntax.
     That is, `date:2019-01 date:2019 -p'2000 to 2030'' yields January
     2019, the smallest common time span.

+   * A report interval (see below) will adjust start/end dates, when
+     needed, so that they fall on subperiod boundaries.
+
   Examples:

 `-b           begin on St. Patrick's day 2016
@ -982,7 +987,8 @@ also be prefixed with *`not:'*, eg to exclude a particular subaccount.
     expression (with no report interval). Examples: `date:2016',
     `date:thismonth', `date:2000/2/1-2/15', `date:lastweek-'.  If the
     `--date2' command line flag is present, this matches secondary
-     dates instead.
+     dates instead. (Report intervals will adjust start/end dates to
+     preceding/following subperiod boundaries.)

 *`date2:PERIODEXPR'*
     match secondary dates within the specified period.
@ -8691,447 +8697,447 @@ Node: OPTIONS2449
 Ref: #options2550
 Node: General options2692
 Ref: #general-options2817
-Node: Command options6386
-Ref: #command-options6537
-Node: Command arguments6936
-Ref: #command-arguments7094
-Node: Special characters7972
-Ref: #special-characters8135
-Node: Single escaping shell metacharacters8298
-Ref: #single-escaping-shell-metacharacters8539
-Node: Double escaping regular expression metacharacters8941
-Ref: #double-escaping-regular-expression-metacharacters9252
-Node: Triple escaping for add-on commands9778
-Ref: #triple-escaping-for-add-on-commands10038
-Node: Less escaping10684
-Ref: #less-escaping10838
-Node: Unicode characters11164
-Ref: #unicode-characters11329
-Node: Regular expressions12738
-Ref: #regular-expressions12878
-Node: ENVIRONMENT14619
-Ref: #environment14735
-Node: DATA FILES15717
-Ref: #data-files15836
-Node: Data formats16377
-Ref: #data-formats16495
-Node: Multiple files17977
-Ref: #multiple-files18119
-Node: Strict mode18589
-Ref: #strict-mode18704
-Node: TIME PERIODS19355
-Ref: #time-periods19472
-Node: Smart dates19570
-Ref: #smart-dates19696
-Node: Report start & end date21000
-Ref: #report-start-end-date21175
-Node: Report intervals22719
-Ref: #report-intervals22887
-Node: Period expressions24161
-Ref: #period-expressions24301
-Node: DEPTH28680
-Ref: #depth28780
-Node: QUERIES29111
-Ref: #queries29210
-Node: COSTING33162
-Ref: #costing33265
-Node: VALUATION33538
-Ref: #valuation33646
-Node: -V Value34369
-Ref: #v-value34493
-Node: -X Value in specified commodity34687
-Ref: #x-value-in-specified-commodity34880
-Node: Valuation date35029
-Ref: #valuation-date35191
-Node: Market prices35628
-Ref: #market-prices35809
-Node: --infer-market-price market prices from transactions36991
-Ref: #infer-market-price-market-prices-from-transactions37255
-Node: Valuation commodity38604
-Ref: #valuation-commodity38814
-Node: Simple valuation examples40039
-Ref: #simple-valuation-examples40235
-Node: --value Flexible valuation40897
-Ref: #value-flexible-valuation41099
-Node: More valuation examples42741
-Ref: #more-valuation-examples42942
-Node: Effect of valuation on reports44948
-Ref: #effect-of-valuation-on-reports45130
-Node: PIVOTING53027
-Ref: #pivoting53132
-Node: OUTPUT54811
-Ref: #output54913
-Node: Output destination54964
-Ref: #output-destination55097
-Node: Output format55753
-Ref: #output-format55876
-Node: COMMANDS58039
-Ref: #commands58151
-Node: accounts61541
-Ref: #accounts61641
-Node: activity62333
-Ref: #activity62445
-Node: add62827
-Ref: #add62930
-Node: aregister65725
-Ref: #aregister65839
-Node: aregister and custom posting dates68034
-Ref: #aregister-and-custom-posting-dates68200
-Node: balance69021
-Ref: #balance69140
-Node: balance features70053
-Ref: #balance-features70193
-Node: Simple balance report71863
-Ref: #simple-balance-report72045
-Node: Filtered balance report73493
-Ref: #filtered-balance-report73680
-Node: List or tree mode73977
-Ref: #list-or-tree-mode74145
-Node: Depth limiting75462
-Ref: #depth-limiting75628
-Node: Multi-period balance report76386
-Ref: #multi-period-balance-report76578
-Node: Sorting by amount78834
-Ref: #sorting-by-amount79003
-Node: Percentages79465
-Ref: #percentages79621
-Node: Balance change end balance80553
-Ref: #balance-change-end-balance80744
-Node: Balance report types82168
-Ref: #balance-report-types82358
-Node: Useful balance reports86522
-Ref: #useful-balance-reports86703
-Node: Budget report87787
-Ref: #budget-report87971
-Node: Budget report start date93140
-Ref: #budget-report-start-date93309
-Node: Nested budgets94636
-Ref: #nested-budgets94785
-Node: Customising single-period balance reports98172
-Ref: #customising-single-period-balance-reports98381
-Node: balancesheet100538
-Ref: #balancesheet100676
-Node: balancesheetequity101974
-Ref: #balancesheetequity102125
-Node: cashflow103505
-Ref: #cashflow103629
-Node: check104775
-Ref: #check104880
-Node: Basic checks105513
-Ref: #basic-checks105631
-Node: Strict checks106164
-Ref: #strict-checks106305
-Node: Other checks106609
-Ref: #other-checks106749
-Node: Custom checks107106
-Ref: #custom-checks107226
-Node: close107644
-Ref: #close107748
-Node: close usage109265
-Ref: #close-usage109360
-Node: codes112168
-Ref: #codes112278
-Node: commodities112991
-Ref: #commodities113120
-Node: descriptions113202
-Ref: #descriptions113332
-Node: diff113636
-Ref: #diff113744
-Node: files114789
-Ref: #files114891
-Node: help115037
-Ref: #help115139
-Node: import115862
-Ref: #import115978
-Node: Deduplication116840
-Ref: #deduplication116965
-Node: Import testing118853
-Ref: #import-testing119018
-Node: Importing balance assignments119508
-Ref: #importing-balance-assignments119714
-Node: Commodity display styles120361
-Ref: #commodity-display-styles120534
-Node: incomestatement120663
-Ref: #incomestatement120798
-Node: notes122099
-Ref: #notes122214
-Node: payees122581
-Ref: #payees122689
-Node: prices123215
-Ref: #prices123323
-Node: print123662
-Ref: #print123774
-Node: print-unique129084
-Ref: #print-unique129212
-Node: register129498
-Ref: #register129627
-Node: Custom register output134071
-Ref: #custom-register-output134202
-Node: register-match135539
-Ref: #register-match135675
-Node: rewrite136023
-Ref: #rewrite136140
-Node: Re-write rules in a file138046
-Ref: #re-write-rules-in-a-file138209
-Node: Diff output format139359
-Ref: #diff-output-format139542
-Node: rewrite vs print --auto140634
-Ref: #rewrite-vs.-print---auto140794
-Node: roi141344
-Ref: #roi141444
-Node: Semantics of --inv and --pnl143079
-Ref: #semantics-of---inv-and---pnl143261
-Node: IRR and TWR explained145107
-Ref: #irr-and-twr-explained145267
-Node: stats148329
-Ref: #stats148430
-Node: tags149217
-Ref: #tags149317
-Node: test149834
-Ref: #test149950
-Node: About add-on commands150695
-Ref: #about-add-on-commands150832
-Node: JOURNAL FORMAT151965
-Ref: #journal-format152093
-Node: Transactions154273
-Ref: #transactions154388
-Node: Dates155405
-Ref: #dates155521
-Node: Simple dates155586
-Ref: #simple-dates155706
-Node: Secondary dates156213
-Ref: #secondary-dates156361
-Node: Posting dates157695
-Ref: #posting-dates157818
-Node: Status159187
-Ref: #status159304
-Node: Description161009
-Ref: #description161139
-Node: Payee and note161457
-Ref: #payee-and-note161565
-Node: Comments161899
-Ref: #comments162021
-Node: Tags163214
-Ref: #tags-1163325
-Node: Postings164723
-Ref: #postings164847
-Node: Virtual postings165871
-Ref: #virtual-postings165982
-Node: Account names167284
-Ref: #account-names167421
-Node: Amounts167907
-Ref: #amounts168042
-Node: Decimal marks digit group marks169000
-Ref: #decimal-marks-digit-group-marks169175
-Node: Commodity170047
-Ref: #commodity170205
-Node: Commodity directives171155
-Ref: #commodity-directives171327
-Node: Commodity display style171813
-Ref: #commodity-display-style171990
-Node: Rounding174098
-Ref: #rounding174216
-Node: Transaction prices174626
-Ref: #transaction-prices174792
-Node: Lot prices lot dates177222
-Ref: #lot-prices-lot-dates177405
-Node: Balance assertions177892
-Ref: #balance-assertions178070
-Node: Assertions and ordering179100
-Ref: #assertions-and-ordering179282
-Node: Assertions and included files179979
-Ref: #assertions-and-included-files180216
-Node: Assertions and multiple -f options180547
-Ref: #assertions-and-multiple--f-options180797
-Node: Assertions and commodities180928
-Ref: #assertions-and-commodities181154
-Node: Assertions and prices182309
-Ref: #assertions-and-prices182517
-Node: Assertions and subaccounts182958
-Ref: #assertions-and-subaccounts183181
-Node: Assertions and virtual postings183505
-Ref: #assertions-and-virtual-postings183741
-Node: Assertions and precision183882
-Ref: #assertions-and-precision184069
-Node: Balance assignments184334
-Ref: #balance-assignments184504
-Node: Balance assignments and prices185667
-Ref: #balance-assignments-and-prices185833
-Node: Directives186059
-Ref: #directives186222
-Node: Directives and multiple files191627
-Ref: #directives-and-multiple-files191823
-Node: Comment blocks192485
-Ref: #comment-blocks192662
-Node: Including other files192837
-Ref: #including-other-files193011
-Node: Default year193935
-Ref: #default-year194093
-Node: Declaring payees194500
-Ref: #declaring-payees194666
-Node: Declaring commodities194911
-Ref: #declaring-commodities195092
-Node: Commodity error checking197468
-Ref: #commodity-error-checking197618
-Node: Default commodity197874
-Ref: #default-commodity198054
-Node: Declaring market prices198928
-Ref: #declaring-market-prices199117
-Node: Declaring accounts199975
-Ref: #declaring-accounts200155
-Node: Account error checking201362
-Ref: #account-error-checking201528
-Node: Account comments202705
-Ref: #account-comments202889
-Node: Account subdirectives203315
-Ref: #account-subdirectives203500
-Node: Account types203815
-Ref: #account-types203989
-Node: Declaring account types204724
-Ref: #declaring-account-types204903
-Node: Auto-detected account types205554
-Ref: #auto-detected-account-types205795
-Node: Interference from auto-detected account types206761
-Ref: #interference-from-auto-detected-account-types207038
-Node: Old account type syntax207521
-Ref: #old-account-type-syntax207718
-Node: Account display order208019
-Ref: #account-display-order208179
-Node: Rewriting accounts209330
-Ref: #rewriting-accounts209509
-Node: Basic aliases210268
-Ref: #basic-aliases210404
-Node: Regex aliases211106
-Ref: #regex-aliases211268
-Node: Combining aliases211988
-Ref: #combining-aliases212171
-Node: Aliases and multiple files213448
-Ref: #aliases-and-multiple-files213647
-Node: end aliases214228
-Ref: #end-aliases214375
-Node: Default parent account214477
-Ref: #default-parent-account214667
-Node: Periodic transactions215551
-Ref: #periodic-transactions215734
-Node: Periodic rule syntax217651
-Ref: #periodic-rule-syntax217851
-Node: Two spaces between period expression and description!218554
-Ref: #two-spaces-between-period-expression-and-description218867
-Node: Forecasting with periodic transactions219552
-Ref: #forecasting-with-periodic-transactions219851
-Node: Budgeting with periodic transactions221897
-Ref: #budgeting-with-periodic-transactions222130
-Node: Auto postings222537
-Ref: #auto-postings222673
-Node: Auto postings and multiple files224856
-Ref: #auto-postings-and-multiple-files225054
-Node: Auto postings and dates225262
-Ref: #auto-postings-and-dates225530
-Node: Auto postings and transaction balancing / inferred amounts / balance assertions225705
-Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions226051
-Node: Auto posting tags226396
-Ref: #auto-posting-tags226605
-Node: CSV FORMAT227242
-Ref: #csv-format227370
-Node: Examples229951
-Ref: #examples230054
-Node: Basic230261
-Ref: #basic230363
-Node: Bank of Ireland230907
-Ref: #bank-of-ireland231044
-Node: Amazon232509
-Ref: #amazon232629
-Node: Paypal234350
-Ref: #paypal234446
-Node: CSV rules242094
-Ref: #csv-rules242212
-Node: skip242524
-Ref: #skip242619
-Node: fields242991
-Ref: #fields243115
-Node: Transaction field names244276
-Ref: #transaction-field-names244438
-Node: Posting field names244549
-Ref: #posting-field-names244703
-Node: field assignment247064
-Ref: #field-assignment247209
-Node: separator248023
-Ref: #separator248160
-Node: if block248702
-Ref: #if-block248829
-Node: Matching the whole record249227
-Ref: #matching-the-whole-record249404
-Node: Matching individual fields250207
-Ref: #matching-individual-fields250413
-Node: Combining matchers250637
-Ref: #combining-matchers250835
-Node: Rules applied on successful match251149
-Ref: #rules-applied-on-successful-match251342
-Node: if table251999
-Ref: #if-table252120
-Node: end253856
-Ref: #end253970
-Node: date-format254194
-Ref: #date-format254328
-Node: decimal-mark255078
-Ref: #decimal-mark255223
-Node: newest-first255560
-Ref: #newest-first255703
-Node: include256386
-Ref: #include256519
-Node: balance-type256961
-Ref: #balance-type257083
-Node: Tips257783
-Ref: #tips257874
-Node: Rapid feedback258173
-Ref: #rapid-feedback258292
-Node: Valid CSV258751
-Ref: #valid-csv258883
-Node: File Extension259075
-Ref: #file-extension259229
-Node: Reading multiple CSV files259658
-Ref: #reading-multiple-csv-files259845
-Node: Valid transactions260085
-Ref: #valid-transactions260265
-Node: Deduplicating importing260893
-Ref: #deduplicating-importing261074
-Node: Setting amounts262106
-Ref: #setting-amounts262263
-Node: Amount signs264482
-Ref: #amount-signs264636
-Node: Setting currency/commodity265323
-Ref: #setting-currencycommodity265511
-Node: Amount decimal places266691
-Ref: #amount-decimal-places266883
-Node: Referencing other fields267195
-Ref: #referencing-other-fields267394
-Node: How CSV rules are evaluated268292
-Ref: #how-csv-rules-are-evaluated268467
-Node: TIMECLOCK FORMAT269916
-Ref: #timeclock-format270056
-Node: TIMEDOT FORMAT272124
-Ref: #timedot-format272262
-Node: COMMON TASKS276525
-Ref: #common-tasks276654
-Node: Getting help277061
-Ref: #getting-help277195
-Node: Constructing command lines277746
-Ref: #constructing-command-lines277940
-Node: Starting a journal file278639
-Ref: #starting-a-journal-file278839
-Node: Setting opening balances280026
-Ref: #setting-opening-balances280224
-Node: Recording transactions283357
-Ref: #recording-transactions283539
-Node: Reconciling284096
-Ref: #reconciling284241
-Node: Reporting286486
-Ref: #reporting286628
-Node: Migrating to a new file290548
-Ref: #migrating-to-a-new-file290698
-Node: LIMITATIONS290996
-Ref: #limitations291124
-Node: TROUBLESHOOTING291865
-Ref: #troubleshooting291980
+Node: Command options6548
+Ref: #command-options6699
+Node: Command arguments7098
+Ref: #command-arguments7256
+Node: Special characters8134
+Ref: #special-characters8297
+Node: Single escaping shell metacharacters8460
+Ref: #single-escaping-shell-metacharacters8701
+Node: Double escaping regular expression metacharacters9103
+Ref: #double-escaping-regular-expression-metacharacters9414
+Node: Triple escaping for add-on commands9940
+Ref: #triple-escaping-for-add-on-commands10200
+Node: Less escaping10846
+Ref: #less-escaping11000
+Node: Unicode characters11326
+Ref: #unicode-characters11491
+Node: Regular expressions12900
+Ref: #regular-expressions13040
+Node: ENVIRONMENT14781
+Ref: #environment14897
+Node: DATA FILES15879
+Ref: #data-files15998
+Node: Data formats16539
+Ref: #data-formats16657
+Node: Multiple files18139
+Ref: #multiple-files18281
+Node: Strict mode18751
+Ref: #strict-mode18866
+Node: TIME PERIODS19517
+Ref: #time-periods19634
+Node: Smart dates19732
+Ref: #smart-dates19858
+Node: Report start & end date21162
+Ref: #report-start-end-date21337
+Node: Report intervals23007
+Ref: #report-intervals23175
+Node: Period expressions24449
+Ref: #period-expressions24589
+Node: DEPTH28968
+Ref: #depth29068
+Node: QUERIES29399
+Ref: #queries29498
+Node: COSTING33547
+Ref: #costing33650
+Node: VALUATION33923
+Ref: #valuation34031
+Node: -V Value34754
+Ref: #v-value34878
+Node: -X Value in specified commodity35072
+Ref: #x-value-in-specified-commodity35265
+Node: Valuation date35414
+Ref: #valuation-date35576
+Node: Market prices36013
+Ref: #market-prices36194
+Node: --infer-market-price market prices from transactions37376
+Ref: #infer-market-price-market-prices-from-transactions37640
+Node: Valuation commodity38989
+Ref: #valuation-commodity39199
+Node: Simple valuation examples40424
+Ref: #simple-valuation-examples40620
+Node: --value Flexible valuation41282
+Ref: #value-flexible-valuation41484
+Node: More valuation examples43126
+Ref: #more-valuation-examples43327
+Node: Effect of valuation on reports45333
+Ref: #effect-of-valuation-on-reports45515
+Node: PIVOTING53412
+Ref: #pivoting53517
+Node: OUTPUT55196
+Ref: #output55298
+Node: Output destination55349
+Ref: #output-destination55482
+Node: Output format56138
+Ref: #output-format56261
+Node: COMMANDS58424
+Ref: #commands58536
+Node: accounts61926
+Ref: #accounts62026
+Node: activity62718
+Ref: #activity62830
+Node: add63212
+Ref: #add63315
+Node: aregister66110
+Ref: #aregister66224
+Node: aregister and custom posting dates68419
+Ref: #aregister-and-custom-posting-dates68585
+Node: balance69406
+Ref: #balance69525
+Node: balance features70438
+Ref: #balance-features70578
+Node: Simple balance report72248
+Ref: #simple-balance-report72430
+Node: Filtered balance report73878
+Ref: #filtered-balance-report74065
+Node: List or tree mode74362
+Ref: #list-or-tree-mode74530
+Node: Depth limiting75847
+Ref: #depth-limiting76013
+Node: Multi-period balance report76771
+Ref: #multi-period-balance-report76963
+Node: Sorting by amount79219
+Ref: #sorting-by-amount79388
+Node: Percentages79850
+Ref: #percentages80006
+Node: Balance change end balance80938
+Ref: #balance-change-end-balance81129
+Node: Balance report types82553
+Ref: #balance-report-types82743
+Node: Useful balance reports86907
+Ref: #useful-balance-reports87088
+Node: Budget report88172
+Ref: #budget-report88356
+Node: Budget report start date93525
+Ref: #budget-report-start-date93694
+Node: Nested budgets95021
+Ref: #nested-budgets95170
+Node: Customising single-period balance reports98557
+Ref: #customising-single-period-balance-reports98766
+Node: balancesheet100923
+Ref: #balancesheet101061
+Node: balancesheetequity102359
+Ref: #balancesheetequity102510
+Node: cashflow103890
+Ref: #cashflow104014
+Node: check105160
+Ref: #check105265
+Node: Basic checks105898
+Ref: #basic-checks106016
+Node: Strict checks106549
+Ref: #strict-checks106690
+Node: Other checks106994
+Ref: #other-checks107134
+Node: Custom checks107491
+Ref: #custom-checks107611
+Node: close108029
+Ref: #close108133
+Node: close usage109650
+Ref: #close-usage109745
+Node: codes112553
+Ref: #codes112663
+Node: commodities113376
+Ref: #commodities113505
+Node: descriptions113587
+Ref: #descriptions113717
+Node: diff114021
+Ref: #diff114129
+Node: files115174
+Ref: #files115276
+Node: help115422
+Ref: #help115524
+Node: import116247
+Ref: #import116363
+Node: Deduplication117225
+Ref: #deduplication117350
+Node: Import testing119238
+Ref: #import-testing119403
+Node: Importing balance assignments119893
+Ref: #importing-balance-assignments120099
+Node: Commodity display styles120746
+Ref: #commodity-display-styles120919
+Node: incomestatement121048
+Ref: #incomestatement121183
+Node: notes122484
+Ref: #notes122599
+Node: payees122966
+Ref: #payees123074
+Node: prices123600
+Ref: #prices123708
+Node: print124047
+Ref: #print124159
+Node: print-unique129469
+Ref: #print-unique129597
+Node: register129883
+Ref: #register130012
+Node: Custom register output134456
+Ref: #custom-register-output134587
+Node: register-match135924
+Ref: #register-match136060
+Node: rewrite136408
+Ref: #rewrite136525
+Node: Re-write rules in a file138431
+Ref: #re-write-rules-in-a-file138594
+Node: Diff output format139744
+Ref: #diff-output-format139927
+Node: rewrite vs print --auto141019
+Ref: #rewrite-vs.-print---auto141179
+Node: roi141729
+Ref: #roi141829
+Node: Semantics of --inv and --pnl143464
+Ref: #semantics-of---inv-and---pnl143646
+Node: IRR and TWR explained145492
+Ref: #irr-and-twr-explained145652
+Node: stats148714
+Ref: #stats148815
+Node: tags149602
+Ref: #tags149702
+Node: test150219
+Ref: #test150335
+Node: About add-on commands151080
+Ref: #about-add-on-commands151217
+Node: JOURNAL FORMAT152350
+Ref: #journal-format152478
+Node: Transactions154658
+Ref: #transactions154773
+Node: Dates155790
+Ref: #dates155906
+Node: Simple dates155971
+Ref: #simple-dates156091
+Node: Secondary dates156598
+Ref: #secondary-dates156746
+Node: Posting dates158080
+Ref: #posting-dates158203
+Node: Status159572
+Ref: #status159689
+Node: Description161394
+Ref: #description161524
+Node: Payee and note161842
+Ref: #payee-and-note161950
+Node: Comments162284
+Ref: #comments162406
+Node: Tags163599
+Ref: #tags-1163710
+Node: Postings165108
+Ref: #postings165232
+Node: Virtual postings166256
+Ref: #virtual-postings166367
+Node: Account names167669
+Ref: #account-names167806
+Node: Amounts168292
+Ref: #amounts168427
+Node: Decimal marks digit group marks169385
+Ref: #decimal-marks-digit-group-marks169560
+Node: Commodity170432
+Ref: #commodity170590
+Node: Commodity directives171540
+Ref: #commodity-directives171712
+Node: Commodity display style172198
+Ref: #commodity-display-style172375
+Node: Rounding174483
+Ref: #rounding174601
+Node: Transaction prices175011
+Ref: #transaction-prices175177
+Node: Lot prices lot dates177607
+Ref: #lot-prices-lot-dates177790
+Node: Balance assertions178277
+Ref: #balance-assertions178455
+Node: Assertions and ordering179485
+Ref: #assertions-and-ordering179667
+Node: Assertions and included files180364
+Ref: #assertions-and-included-files180601
+Node: Assertions and multiple -f options180932
+Ref: #assertions-and-multiple--f-options181182
+Node: Assertions and commodities181313
+Ref: #assertions-and-commodities181539
+Node: Assertions and prices182694
+Ref: #assertions-and-prices182902
+Node: Assertions and subaccounts183343
+Ref: #assertions-and-subaccounts183566
+Node: Assertions and virtual postings183890
+Ref: #assertions-and-virtual-postings184126
+Node: Assertions and precision184267
+Ref: #assertions-and-precision184454
+Node: Balance assignments184719
+Ref: #balance-assignments184889
+Node: Balance assignments and prices186052
+Ref: #balance-assignments-and-prices186218
+Node: Directives186444
+Ref: #directives186607
+Node: Directives and multiple files192012
+Ref: #directives-and-multiple-files192208
+Node: Comment blocks192870
+Ref: #comment-blocks193047
+Node: Including other files193222
+Ref: #including-other-files193396
+Node: Default year194320
+Ref: #default-year194478
+Node: Declaring payees194885
+Ref: #declaring-payees195051
+Node: Declaring commodities195296
+Ref: #declaring-commodities195477
+Node: Commodity error checking197853
+Ref: #commodity-error-checking198003
+Node: Default commodity198259
+Ref: #default-commodity198439
+Node: Declaring market prices199313
+Ref: #declaring-market-prices199502
+Node: Declaring accounts200360
+Ref: #declaring-accounts200540
+Node: Account error checking201747
+Ref: #account-error-checking201913
+Node: Account comments203090
+Ref: #account-comments203274
+Node: Account subdirectives203700
+Ref: #account-subdirectives203885
+Node: Account types204200
+Ref: #account-types204374
+Node: Declaring account types205109
+Ref: #declaring-account-types205288
+Node: Auto-detected account types205939
+Ref: #auto-detected-account-types206180
+Node: Interference from auto-detected account types207146
+Ref: #interference-from-auto-detected-account-types207423
+Node: Old account type syntax207906
+Ref: #old-account-type-syntax208103
+Node: Account display order208404
+Ref: #account-display-order208564
+Node: Rewriting accounts209715
+Ref: #rewriting-accounts209894
+Node: Basic aliases210653
+Ref: #basic-aliases210789
+Node: Regex aliases211491
+Ref: #regex-aliases211653
+Node: Combining aliases212373
+Ref: #combining-aliases212556
+Node: Aliases and multiple files213833
+Ref: #aliases-and-multiple-files214032
+Node: end aliases214613
+Ref: #end-aliases214760
+Node: Default parent account214862
+Ref: #default-parent-account215052
+Node: Periodic transactions215936
+Ref: #periodic-transactions216119
+Node: Periodic rule syntax218036
+Ref: #periodic-rule-syntax218236
+Node: Two spaces between period expression and description!218939
+Ref: #two-spaces-between-period-expression-and-description219252
+Node: Forecasting with periodic transactions219937
+Ref: #forecasting-with-periodic-transactions220236
+Node: Budgeting with periodic transactions222282
+Ref: #budgeting-with-periodic-transactions222515
+Node: Auto postings222922
+Ref: #auto-postings223058
+Node: Auto postings and multiple files225241
+Ref: #auto-postings-and-multiple-files225439
+Node: Auto postings and dates225647
+Ref: #auto-postings-and-dates225915
+Node: Auto postings and transaction balancing / inferred amounts / balance assertions226090
+Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions226436
+Node: Auto posting tags226781
+Ref: #auto-posting-tags226990
+Node: CSV FORMAT227627
+Ref: #csv-format227755
+Node: Examples230336
+Ref: #examples230439
+Node: Basic230646
+Ref: #basic230748
+Node: Bank of Ireland231292
+Ref: #bank-of-ireland231429
+Node: Amazon232894
+Ref: #amazon233014
+Node: Paypal234735
+Ref: #paypal234831
+Node: CSV rules242479
+Ref: #csv-rules242597
+Node: skip242909
+Ref: #skip243004
+Node: fields243376
+Ref: #fields243500
+Node: Transaction field names244661
+Ref: #transaction-field-names244823
+Node: Posting field names244934
+Ref: #posting-field-names245088
+Node: field assignment247449
+Ref: #field-assignment247594
+Node: separator248408
+Ref: #separator248545
+Node: if block249087
+Ref: #if-block249214
+Node: Matching the whole record249612
+Ref: #matching-the-whole-record249789
+Node: Matching individual fields250592
+Ref: #matching-individual-fields250798
+Node: Combining matchers251022
+Ref: #combining-matchers251220
+Node: Rules applied on successful match251534
+Ref: #rules-applied-on-successful-match251727
+Node: if table252384
+Ref: #if-table252505
+Node: end254241
+Ref: #end254355
+Node: date-format254579
+Ref: #date-format254713
+Node: decimal-mark255463
+Ref: #decimal-mark255608
+Node: newest-first255945
+Ref: #newest-first256088
+Node: include256771
+Ref: #include256904
+Node: balance-type257346
+Ref: #balance-type257468
+Node: Tips258168
+Ref: #tips258259
+Node: Rapid feedback258558
+Ref: #rapid-feedback258677
+Node: Valid CSV259136
+Ref: #valid-csv259268
+Node: File Extension259460
+Ref: #file-extension259614
+Node: Reading multiple CSV files260043
+Ref: #reading-multiple-csv-files260230
+Node: Valid transactions260470
+Ref: #valid-transactions260650
+Node: Deduplicating importing261278
+Ref: #deduplicating-importing261459
+Node: Setting amounts262491
+Ref: #setting-amounts262648
+Node: Amount signs264867
+Ref: #amount-signs265021
+Node: Setting currency/commodity265708
+Ref: #setting-currencycommodity265896
+Node: Amount decimal places267076
+Ref: #amount-decimal-places267268
+Node: Referencing other fields267580
+Ref: #referencing-other-fields267779
+Node: How CSV rules are evaluated268677
+Ref: #how-csv-rules-are-evaluated268852
+Node: TIMECLOCK FORMAT270301
+Ref: #timeclock-format270441
+Node: TIMEDOT FORMAT272509
+Ref: #timedot-format272647
+Node: COMMON TASKS276910
+Ref: #common-tasks277039
+Node: Getting help277446
+Ref: #getting-help277580
+Node: Constructing command lines278131
+Ref: #constructing-command-lines278325
+Node: Starting a journal file279024
+Ref: #starting-a-journal-file279224
+Node: Setting opening balances280411
+Ref: #setting-opening-balances280609
+Node: Recording transactions283742
+Ref: #recording-transactions283924
+Node: Reconciling284481
+Ref: #reconciling284626
+Node: Reporting286871
+Ref: #reporting287013
+Node: Migrating to a new file290933
+Ref: #migrating-to-a-new-file291083
+Node: LIMITATIONS291381
+Ref: #limitations291509
+Node: TROUBLESHOOTING292250
+Ref: #troubleshooting292365

 End Tag Table
--- a/hledger/hledger.txt
+++ b/hledger/hledger.txt
@ -105,10 +105,12 @@ OPTIONS
       General reporting options:

       -b --begin=DATE
-              include postings/txns on or after this date
+              include postings/txns on or after this date (will be adjusted to
+              preceding subperiod start when using a report interval)

       -e --end=DATE
-              include postings/txns before this date
+              include postings/txns before this date (will be adjusted to fol-
+              lowing subperiod end when using a report interval)

       -D --daily
              multiperiod/multicolumn report by day
@ -559,6 +561,9 @@ TIME PERIODS
         date:2019-01 date:2019 -p'2000 to  2030'  yields  January  2019,  the
         smallest common time span.

+       o A  report  interval  (see  below)  will  adjust start/end dates, when
+         needed, so that they fall on subperiod boundaries.
+
       Examples:


@ -625,6 +630,7 @@ TIME PERIODS
       also be written as:


+
       -p "1/1 4/1"
       -p "january-apr"
       -p "this year to 4/1"
@ -810,7 +816,8 @@ QUERIES
              expression (with  no  report  interval).   Examples:  date:2016,
              date:thismonth,   date:2000/2/1-2/15,  date:lastweek-.   If  the
              --date2 command line flag is  present,  this  matches  secondary
-              dates instead.
+              dates instead.  (Report intervals will adjust start/end dates to
+              preceding/following subperiod boundaries.)

       date2:PERIODEXPR
              match secondary dates within the specified period.
@ -1196,6 +1203,8 @@ VALUATION
                                      or today  of                       journal  end   sums of post-
                                      sums      of                       of  sums  of   ings
                                      postings                           postings
+
+
       budget          like balance   like balance   like      balance   like    bal-   like  balance
       amounts         changes        changes        changes             ances          changes
       (--budget)
@ -1218,12 +1227,6 @@ VALUATION
       is,        bs   postings  in                  period at respec-   each period,   sums of post-
       --change,  cf   period                        tive      posting   valued    at   ings
       --change)                                     dates               period ends
-
-
-
-
-
-
       end  balances   sums      of   same      as   sums of values of   period   end   value      at
       (bal  -H,  is   costs     of   --value=end    postings     from   balances,      DATE/today of
       --H, bs, cf)    postings                      before     period   valued    at   sums of post-
@ -4405,11 +4408,6 @@ JOURNAL FORMAT
                  ment                                                 until  end  of cur-
                                                                       rent  file  or  end
                                                                       directive
-
-
-
-
-
       commod-                format    declare a commodity and  its   number    notation:
       ity                              number  notation  &  display   following   entries
                                        style                          in  that  commodity