;doc: update manuals

2024-09-19 10:17:35 +03:00 · 2021-12-06 14:50:49 -10:00 · 2021-12-06 14:50:49 -10:00 · ca44e092fd
commit ca44e092fd
parent 5c597750fb
3 changed files with 395 additions and 388 deletions
--- a/hledger/hledger.1
+++ b/hledger/hledger.1
@ -3236,9 +3236,9 @@ balance report, even when you don\[aq]t have transactions in all of your
 declared accounts yet.
 .SS Data layout
 .PP
-With \f[C]--layout\f[R], you can influence how amounts with more than
-one commodity are displayed (and a bit more), which in turn affects the
-layout of the report data:
+The \f[C]--layout\f[R] option affects how multi-commodity amounts are
+displayed, and some other things, influencing the overall layout of the
+report data:
 .IP \[bu] 2
 \f[C]--layout=wide[,WIDTH]\f[R]: commodities are shown on a single line,
 possibly elided to the specified width
@ -3249,7 +3249,11 @@ possibly elided to the specified width
 commodity symbols in a separate column
 .IP \[bu] 2
 \f[C]--layout=tidy\f[R]: data is normalised to tidy form, with one row
-per data value (supported with CSV output only)
+per data value.
+This is supported with CSV output format only.
+Totals and row averages are disabled in this mode
+(\f[C]-N/--no-total\f[R] is implied and \f[C]-T/--row-total\f[R] and
+\f[C]-A/--average\f[R] will be ignored).
 .PP
 These \f[C]--layout\f[R] values affect some but not all of the output
 formats, as shown:
--- a/hledger/hledger.info
+++ b/hledger/hledger.info
@ -2619,9 +2619,9 @@ File: hledger.info,  Node: Data layout,  Next: Sorting by amount,  Prev: Showing
 11.5.9 Data layout
 ------------------

-With '--layout', you can influence how amounts with more than one
-commodity are displayed (and a bit more), which in turn affects the
-layout of the report data:
+The '--layout' option affects how multi-commodity amounts are displayed,
+and some other things, influencing the overall layout of the report
+data:

   * '--layout=wide[,WIDTH]': commodities are shown on a single line,
     possibly elided to the specified width
@ -2629,7 +2629,9 @@ layout of the report data:
   * '--layout=bare': amounts are shown as bare numbers, with commodity
     symbols in a separate column
   * '--layout=tidy': data is normalised to tidy form, with one row per
-     data value (supported with CSV output only)
+     data value.  This is supported with CSV output format only.  Totals
+     and row averages are disabled in this mode ('-N/--no-total' is
+     implied and '-T/--row-total' and '-A/--average' will be ignored).

   These '--layout' values affect some but not all of the output
 formats, as shown:
@ -9242,378 +9244,378 @@ Node: Showing declared accounts90665
 Ref: #showing-declared-accounts90858
 Node: Data layout91389
 Ref: #data-layout91544
-Node: Sorting by amount99491
-Ref: #sorting-by-amount99646
-Node: Percentages100316
-Ref: #percentages100474
-Node: Balance change end balance101435
-Ref: #balance-change-end-balance101628
-Node: Balance report types103056
-Ref: #balance-report-types103246
-Node: Useful balance reports107525
-Ref: #useful-balance-reports107706
-Node: Budget report108791
-Ref: #budget-report108975
-Node: Budget report start date114250
-Ref: #budget-report-start-date114428
-Node: Budgets and subaccounts115760
-Ref: #budgets-and-subaccounts115967
-Node: Selecting budget goals119407
-Ref: #selecting-budget-goals119579
-Node: Customising single-period balance reports120613
-Ref: #customising-single-period-balance-reports120822
-Node: balancesheet122997
-Ref: #balancesheet123135
-Node: balancesheetequity124434
-Ref: #balancesheetequity124585
-Node: cashflow125965
-Ref: #cashflow126089
-Node: check127235
-Ref: #check127340
-Node: Basic checks127974
-Ref: #basic-checks128092
-Node: Strict checks128643
-Ref: #strict-checks128784
-Node: Other checks129220
-Ref: #other-checks129360
-Node: Custom checks129717
-Ref: #custom-checks129837
-Node: close130254
-Ref: #close130358
-Node: close and prices132449
-Ref: #close-and-prices132578
-Node: close date132973
-Ref: #close-date133157
-Node: Example close asset/liability accounts for file transition133914
-Ref: #example-close-assetliability-accounts-for-file-transition134215
-Node: Hiding opening/closing transactions135074
-Ref: #hiding-openingclosing-transactions135345
-Node: close and balance assertions136722
-Ref: #close-and-balance-assertions136980
-Node: Example close revenue/expense accounts to retained earnings138334
-Ref: #example-close-revenueexpense-accounts-to-retained-earnings138612
-Node: codes139502
-Ref: #codes139612
-Node: commodities140324
-Ref: #commodities140453
-Node: descriptions140535
-Ref: #descriptions140665
-Node: diff140969
-Ref: #diff141077
-Node: files142124
-Ref: #files142226
-Node: help142373
-Ref: #help142475
-Node: import143293
-Ref: #import143409
-Node: Deduplication144274
-Ref: #deduplication144399
-Node: Import testing146293
-Ref: #import-testing146458
-Node: Importing balance assignments146946
-Ref: #importing-balance-assignments147152
-Node: Commodity display styles147801
-Ref: #commodity-display-styles147974
-Node: incomestatement148103
-Ref: #incomestatement148238
-Node: notes149543
-Ref: #notes149658
-Node: payees150026
-Ref: #payees150134
-Node: prices150660
-Ref: #prices150768
-Node: print151137
-Ref: #print151249
-Node: print-unique156564
-Ref: #print-unique156692
-Node: register156977
-Ref: #register157106
-Node: Custom register output161552
-Ref: #custom-register-output161683
-Node: register-match163020
-Ref: #register-match163156
-Node: rewrite163507
-Ref: #rewrite163624
-Node: Re-write rules in a file165530
-Ref: #re-write-rules-in-a-file165693
-Node: Diff output format166842
-Ref: #diff-output-format167025
-Node: rewrite vs print --auto168117
-Ref: #rewrite-vs.-print---auto168277
-Node: roi168833
-Ref: #roi168933
-Node: Spaces and special characters in --inv and --pnl170619
-Ref: #spaces-and-special-characters-in---inv-and---pnl170859
-Node: Semantics of --inv and --pnl171347
-Ref: #semantics-of---inv-and---pnl171586
-Node: IRR and TWR explained173436
-Ref: #irr-and-twr-explained173596
-Node: stats176664
-Ref: #stats176765
-Node: tags178145
-Ref: #tags178245
-Node: test178764
-Ref: #test178880
-Node: About add-on commands179627
-Ref: #about-add-on-commands179764
-Node: JOURNAL FORMAT180895
-Ref: #journal-format181023
-Node: Transactions183250
-Ref: #transactions183365
-Node: Dates184379
-Ref: #dates184495
-Node: Simple dates184560
-Ref: #simple-dates184680
-Node: Secondary dates185189
-Ref: #secondary-dates185337
-Node: Posting dates186673
-Ref: #posting-dates186796
-Node: Status188168
-Ref: #status188278
-Node: Code189986
-Ref: #code190098
-Node: Description190330
-Ref: #description190458
-Node: Payee and note190778
-Ref: #payee-and-note190886
-Node: Comments191221
-Ref: #comments191343
-Node: Tags192537
-Ref: #tags-1192648
-Node: Postings194041
-Ref: #postings194165
-Node: Virtual postings195191
-Ref: #virtual-postings195302
-Node: Account names196607
-Ref: #account-names196744
-Node: Amounts197232
-Ref: #amounts197369
-Node: Decimal marks digit group marks198354
-Ref: #decimal-marks-digit-group-marks198531
-Node: Commodity199552
-Ref: #commodity199741
-Node: Directives influencing number parsing and display200693
-Ref: #directives-influencing-number-parsing-and-display200954
-Node: Commodity display style201447
-Ref: #commodity-display-style201655
-Node: Rounding203850
-Ref: #rounding203970
-Node: Transaction prices204382
-Ref: #transaction-prices204548
-Node: Lot prices lot dates206979
-Ref: #lot-prices-lot-dates207162
-Node: Balance assertions207650
-Ref: #balance-assertions207828
-Node: Assertions and ordering208861
-Ref: #assertions-and-ordering209043
-Node: Assertions and included files209743
-Ref: #assertions-and-included-files209980
-Node: Assertions and multiple -f options210313
-Ref: #assertions-and-multiple--f-options210563
-Node: Assertions and commodities210695
-Ref: #assertions-and-commodities210921
-Node: Assertions and prices212078
-Ref: #assertions-and-prices212286
-Node: Assertions and subaccounts212726
-Ref: #assertions-and-subaccounts212949
-Node: Assertions and virtual postings213273
-Ref: #assertions-and-virtual-postings213509
-Node: Assertions and precision213651
-Ref: #assertions-and-precision213838
-Node: Balance assignments214105
-Ref: #balance-assignments214275
-Node: Balance assignments and prices215439
-Ref: #balance-assignments-and-prices215605
-Node: Directives215829
-Ref: #directives215992
-Node: Directives and multiple files220484
-Ref: #directives-and-multiple-files220680
-Node: Comment blocks221372
-Ref: #comment-blocks221549
-Node: Including other files221725
-Ref: #including-other-files221899
-Node: Default year222823
-Ref: #default-year222981
-Node: Declaring payees223388
-Ref: #declaring-payees223559
-Node: Declaring the decimal mark223805
-Ref: #declaring-the-decimal-mark224005
-Node: Declaring commodities224402
-Ref: #declaring-commodities224593
-Node: Commodity error checking227111
-Ref: #commodity-error-checking227261
-Node: Default commodity227518
-Ref: #default-commodity227698
-Node: Declaring market prices228814
-Ref: #declaring-market-prices229003
-Node: Declaring accounts229816
-Ref: #declaring-accounts229996
-Node: Account error checking231198
-Ref: #account-error-checking231364
-Node: Account comments232543
-Ref: #account-comments232727
-Node: Account subdirectives233151
-Ref: #account-subdirectives233336
-Node: Account types233649
-Ref: #account-types233823
-Node: Auto-detected account types235146
-Ref: #auto-detected-account-types235301
-Node: Account display order236536
-Ref: #account-display-order236696
-Node: Rewriting accounts237847
-Ref: #rewriting-accounts238026
-Node: Basic aliases238783
-Ref: #basic-aliases238919
-Node: Regex aliases239663
-Ref: #regex-aliases239825
-Node: Combining aliases240544
-Ref: #combining-aliases240727
-Node: Aliases and multiple files242003
-Ref: #aliases-and-multiple-files242202
-Node: end aliases242781
-Ref: #end-aliases242928
-Node: Default parent account243077
-Ref: #default-parent-account243267
-Node: Periodic transactions244151
-Ref: #periodic-transactions244334
-Node: Periodic rule syntax246251
-Ref: #periodic-rule-syntax246451
-Node: Two spaces between period expression and description!247155
-Ref: #two-spaces-between-period-expression-and-description247468
-Node: Forecasting with periodic transactions248152
-Ref: #forecasting-with-periodic-transactions248451
-Node: Budgeting with periodic transactions251222
-Ref: #budgeting-with-periodic-transactions251455
-Node: Auto postings251864
-Ref: #auto-postings252000
-Node: Auto postings and multiple files254179
-Ref: #auto-postings-and-multiple-files254377
-Node: Auto postings and dates254586
-Ref: #auto-postings-and-dates254854
-Node: Auto postings and transaction balancing / inferred amounts / balance assertions255029
-Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions255374
-Node: Auto posting tags255877
-Ref: #auto-posting-tags256086
-Node: CSV FORMAT256722
-Ref: #csv-format256850
-Node: Examples259479
-Ref: #examples259582
-Node: Basic259790
-Ref: #basic259892
-Node: Bank of Ireland260434
-Ref: #bank-of-ireland260571
-Node: Amazon262033
-Ref: #amazon262153
-Node: Paypal263872
-Ref: #paypal263968
-Node: CSV rules271612
-Ref: #csv-rules271730
-Node: skip272063
-Ref: #skip272163
-Node: fields list272538
-Ref: #fields-list272677
-Node: field assignment274180
-Ref: #field-assignment274332
-Node: Field names275367
-Ref: #field-names275507
-Node: date field275887
-Ref: #date-field276007
-Node: date2 field276055
-Ref: #date2-field276198
-Node: status field276254
-Ref: #status-field276399
-Node: code field276448
-Ref: #code-field276595
-Node: description field276640
-Ref: #description-field276802
-Node: comment field276861
-Ref: #comment-field277018
-Node: account field277318
-Ref: #account-field277470
-Node: amount field278045
-Ref: #amount-field278196
-Node: currency field279441
-Ref: #currency-field279596
-Node: balance field279853
-Ref: #balance-field279987
-Node: separator280359
-Ref: #separator280491
-Node: if block281031
-Ref: #if-block281158
-Node: Matching the whole record281559
-Ref: #matching-the-whole-record281736
-Node: Matching individual fields282539
-Ref: #matching-individual-fields282745
-Node: Combining matchers282969
-Ref: #combining-matchers283167
-Node: Rules applied on successful match283480
-Ref: #rules-applied-on-successful-match283673
-Node: if table284327
-Ref: #if-table284448
-Node: end286186
-Ref: #end286300
-Node: date-format286524
-Ref: #date-format286658
-Node: decimal-mark287654
-Ref: #decimal-mark287801
-Node: newest-first288140
-Ref: #newest-first288283
-Node: include288966
-Ref: #include289099
-Node: balance-type289543
-Ref: #balance-type289665
-Node: Tips290365
-Ref: #tips290456
-Node: Rapid feedback290755
-Ref: #rapid-feedback290874
-Node: Valid CSV291326
-Ref: #valid-csv291458
-Node: File Extension291650
-Ref: #file-extension291804
-Node: Reading multiple CSV files292233
-Ref: #reading-multiple-csv-files292420
-Node: Valid transactions292661
-Ref: #valid-transactions292841
-Node: Deduplicating importing293469
-Ref: #deduplicating-importing293650
-Node: Setting amounts294683
-Ref: #setting-amounts294840
-Node: Amount signs297281
-Ref: #amount-signs297435
-Node: Setting currency/commodity298122
-Ref: #setting-currencycommodity298310
-Node: Amount decimal places299484
-Ref: #amount-decimal-places299676
-Node: Referencing other fields299988
-Ref: #referencing-other-fields300187
-Node: How CSV rules are evaluated301084
-Ref: #how-csv-rules-are-evaluated301259
-Node: TIMECLOCK FORMAT302710
-Ref: #timeclock-format302850
-Node: TIMEDOT FORMAT304911
-Ref: #timedot-format305049
-Node: COMMON TASKS309611
-Ref: #common-tasks309740
-Node: Getting help310147
-Ref: #getting-help310281
-Node: Constructing command lines310834
-Ref: #constructing-command-lines311028
-Node: Starting a journal file311725
-Ref: #starting-a-journal-file311925
-Node: Setting opening balances313113
-Ref: #setting-opening-balances313311
-Node: Recording transactions316452
-Ref: #recording-transactions316634
-Node: Reconciling317190
-Ref: #reconciling317335
-Node: Reporting319592
-Ref: #reporting319734
-Node: Migrating to a new file323733
-Ref: #migrating-to-a-new-file323883
-Node: LIMITATIONS324182
-Ref: #limitations324310
-Node: TROUBLESHOOTING325053
-Ref: #troubleshooting325168
+Node: Sorting by amount99640
+Ref: #sorting-by-amount99795
+Node: Percentages100465
+Ref: #percentages100623
+Node: Balance change end balance101584
+Ref: #balance-change-end-balance101777
+Node: Balance report types103205
+Ref: #balance-report-types103395
+Node: Useful balance reports107674
+Ref: #useful-balance-reports107855
+Node: Budget report108940
+Ref: #budget-report109124
+Node: Budget report start date114399
+Ref: #budget-report-start-date114577
+Node: Budgets and subaccounts115909
+Ref: #budgets-and-subaccounts116116
+Node: Selecting budget goals119556
+Ref: #selecting-budget-goals119728
+Node: Customising single-period balance reports120762
+Ref: #customising-single-period-balance-reports120971
+Node: balancesheet123146
+Ref: #balancesheet123284
+Node: balancesheetequity124583
+Ref: #balancesheetequity124734
+Node: cashflow126114
+Ref: #cashflow126238
+Node: check127384
+Ref: #check127489
+Node: Basic checks128123
+Ref: #basic-checks128241
+Node: Strict checks128792
+Ref: #strict-checks128933
+Node: Other checks129369
+Ref: #other-checks129509
+Node: Custom checks129866
+Ref: #custom-checks129986
+Node: close130403
+Ref: #close130507
+Node: close and prices132598
+Ref: #close-and-prices132727
+Node: close date133122
+Ref: #close-date133306
+Node: Example close asset/liability accounts for file transition134063
+Ref: #example-close-assetliability-accounts-for-file-transition134364
+Node: Hiding opening/closing transactions135223
+Ref: #hiding-openingclosing-transactions135494
+Node: close and balance assertions136871
+Ref: #close-and-balance-assertions137129
+Node: Example close revenue/expense accounts to retained earnings138483
+Ref: #example-close-revenueexpense-accounts-to-retained-earnings138761
+Node: codes139651
+Ref: #codes139761
+Node: commodities140473
+Ref: #commodities140602
+Node: descriptions140684
+Ref: #descriptions140814
+Node: diff141118
+Ref: #diff141226
+Node: files142273
+Ref: #files142375
+Node: help142522
+Ref: #help142624
+Node: import143442
+Ref: #import143558
+Node: Deduplication144423
+Ref: #deduplication144548
+Node: Import testing146442
+Ref: #import-testing146607
+Node: Importing balance assignments147095
+Ref: #importing-balance-assignments147301
+Node: Commodity display styles147950
+Ref: #commodity-display-styles148123
+Node: incomestatement148252
+Ref: #incomestatement148387
+Node: notes149692
+Ref: #notes149807
+Node: payees150175
+Ref: #payees150283
+Node: prices150809
+Ref: #prices150917
+Node: print151286
+Ref: #print151398
+Node: print-unique156713
+Ref: #print-unique156841
+Node: register157126
+Ref: #register157255
+Node: Custom register output161701
+Ref: #custom-register-output161832
+Node: register-match163169
+Ref: #register-match163305
+Node: rewrite163656
+Ref: #rewrite163773
+Node: Re-write rules in a file165679
+Ref: #re-write-rules-in-a-file165842
+Node: Diff output format166991
+Ref: #diff-output-format167174
+Node: rewrite vs print --auto168266
+Ref: #rewrite-vs.-print---auto168426
+Node: roi168982
+Ref: #roi169082
+Node: Spaces and special characters in --inv and --pnl170768
+Ref: #spaces-and-special-characters-in---inv-and---pnl171008
+Node: Semantics of --inv and --pnl171496
+Ref: #semantics-of---inv-and---pnl171735
+Node: IRR and TWR explained173585
+Ref: #irr-and-twr-explained173745
+Node: stats176813
+Ref: #stats176914
+Node: tags178294
+Ref: #tags178394
+Node: test178913
+Ref: #test179029
+Node: About add-on commands179776
+Ref: #about-add-on-commands179913
+Node: JOURNAL FORMAT181044
+Ref: #journal-format181172
+Node: Transactions183399
+Ref: #transactions183514
+Node: Dates184528
+Ref: #dates184644
+Node: Simple dates184709
+Ref: #simple-dates184829
+Node: Secondary dates185338
+Ref: #secondary-dates185486
+Node: Posting dates186822
+Ref: #posting-dates186945
+Node: Status188317
+Ref: #status188427
+Node: Code190135
+Ref: #code190247
+Node: Description190479
+Ref: #description190607
+Node: Payee and note190927
+Ref: #payee-and-note191035
+Node: Comments191370
+Ref: #comments191492
+Node: Tags192686
+Ref: #tags-1192797
+Node: Postings194190
+Ref: #postings194314
+Node: Virtual postings195340
+Ref: #virtual-postings195451
+Node: Account names196756
+Ref: #account-names196893
+Node: Amounts197381
+Ref: #amounts197518
+Node: Decimal marks digit group marks198503
+Ref: #decimal-marks-digit-group-marks198680
+Node: Commodity199701
+Ref: #commodity199890
+Node: Directives influencing number parsing and display200842
+Ref: #directives-influencing-number-parsing-and-display201103
+Node: Commodity display style201596
+Ref: #commodity-display-style201804
+Node: Rounding203999
+Ref: #rounding204119
+Node: Transaction prices204531
+Ref: #transaction-prices204697
+Node: Lot prices lot dates207128
+Ref: #lot-prices-lot-dates207311
+Node: Balance assertions207799
+Ref: #balance-assertions207977
+Node: Assertions and ordering209010
+Ref: #assertions-and-ordering209192
+Node: Assertions and included files209892
+Ref: #assertions-and-included-files210129
+Node: Assertions and multiple -f options210462
+Ref: #assertions-and-multiple--f-options210712
+Node: Assertions and commodities210844
+Ref: #assertions-and-commodities211070
+Node: Assertions and prices212227
+Ref: #assertions-and-prices212435
+Node: Assertions and subaccounts212875
+Ref: #assertions-and-subaccounts213098
+Node: Assertions and virtual postings213422
+Ref: #assertions-and-virtual-postings213658
+Node: Assertions and precision213800
+Ref: #assertions-and-precision213987
+Node: Balance assignments214254
+Ref: #balance-assignments214424
+Node: Balance assignments and prices215588
+Ref: #balance-assignments-and-prices215754
+Node: Directives215978
+Ref: #directives216141
+Node: Directives and multiple files220633
+Ref: #directives-and-multiple-files220829
+Node: Comment blocks221521
+Ref: #comment-blocks221698
+Node: Including other files221874
+Ref: #including-other-files222048
+Node: Default year222972
+Ref: #default-year223130
+Node: Declaring payees223537
+Ref: #declaring-payees223708
+Node: Declaring the decimal mark223954
+Ref: #declaring-the-decimal-mark224154
+Node: Declaring commodities224551
+Ref: #declaring-commodities224742
+Node: Commodity error checking227260
+Ref: #commodity-error-checking227410
+Node: Default commodity227667
+Ref: #default-commodity227847
+Node: Declaring market prices228963
+Ref: #declaring-market-prices229152
+Node: Declaring accounts229965
+Ref: #declaring-accounts230145
+Node: Account error checking231347
+Ref: #account-error-checking231513
+Node: Account comments232692
+Ref: #account-comments232876
+Node: Account subdirectives233300
+Ref: #account-subdirectives233485
+Node: Account types233798
+Ref: #account-types233972
+Node: Auto-detected account types235295
+Ref: #auto-detected-account-types235450
+Node: Account display order236685
+Ref: #account-display-order236845
+Node: Rewriting accounts237996
+Ref: #rewriting-accounts238175
+Node: Basic aliases238932
+Ref: #basic-aliases239068
+Node: Regex aliases239812
+Ref: #regex-aliases239974
+Node: Combining aliases240693
+Ref: #combining-aliases240876
+Node: Aliases and multiple files242152
+Ref: #aliases-and-multiple-files242351
+Node: end aliases242930
+Ref: #end-aliases243077
+Node: Default parent account243226
+Ref: #default-parent-account243416
+Node: Periodic transactions244300
+Ref: #periodic-transactions244483
+Node: Periodic rule syntax246400
+Ref: #periodic-rule-syntax246600
+Node: Two spaces between period expression and description!247304
+Ref: #two-spaces-between-period-expression-and-description247617
+Node: Forecasting with periodic transactions248301
+Ref: #forecasting-with-periodic-transactions248600
+Node: Budgeting with periodic transactions251371
+Ref: #budgeting-with-periodic-transactions251604
+Node: Auto postings252013
+Ref: #auto-postings252149
+Node: Auto postings and multiple files254328
+Ref: #auto-postings-and-multiple-files254526
+Node: Auto postings and dates254735
+Ref: #auto-postings-and-dates255003
+Node: Auto postings and transaction balancing / inferred amounts / balance assertions255178
+Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions255523
+Node: Auto posting tags256026
+Ref: #auto-posting-tags256235
+Node: CSV FORMAT256871
+Ref: #csv-format256999
+Node: Examples259628
+Ref: #examples259731
+Node: Basic259939
+Ref: #basic260041
+Node: Bank of Ireland260583
+Ref: #bank-of-ireland260720
+Node: Amazon262182
+Ref: #amazon262302
+Node: Paypal264021
+Ref: #paypal264117
+Node: CSV rules271761
+Ref: #csv-rules271879
+Node: skip272212
+Ref: #skip272312
+Node: fields list272687
+Ref: #fields-list272826
+Node: field assignment274329
+Ref: #field-assignment274481
+Node: Field names275516
+Ref: #field-names275656
+Node: date field276036
+Ref: #date-field276156
+Node: date2 field276204
+Ref: #date2-field276347
+Node: status field276403
+Ref: #status-field276548
+Node: code field276597
+Ref: #code-field276744
+Node: description field276789
+Ref: #description-field276951
+Node: comment field277010
+Ref: #comment-field277167
+Node: account field277467
+Ref: #account-field277619
+Node: amount field278194
+Ref: #amount-field278345
+Node: currency field279590
+Ref: #currency-field279745
+Node: balance field280002
+Ref: #balance-field280136
+Node: separator280508
+Ref: #separator280640
+Node: if block281180
+Ref: #if-block281307
+Node: Matching the whole record281708
+Ref: #matching-the-whole-record281885
+Node: Matching individual fields282688
+Ref: #matching-individual-fields282894
+Node: Combining matchers283118
+Ref: #combining-matchers283316
+Node: Rules applied on successful match283629
+Ref: #rules-applied-on-successful-match283822
+Node: if table284476
+Ref: #if-table284597
+Node: end286335
+Ref: #end286449
+Node: date-format286673
+Ref: #date-format286807
+Node: decimal-mark287803
+Ref: #decimal-mark287950
+Node: newest-first288289
+Ref: #newest-first288432
+Node: include289115
+Ref: #include289248
+Node: balance-type289692
+Ref: #balance-type289814
+Node: Tips290514
+Ref: #tips290605
+Node: Rapid feedback290904
+Ref: #rapid-feedback291023
+Node: Valid CSV291475
+Ref: #valid-csv291607
+Node: File Extension291799
+Ref: #file-extension291953
+Node: Reading multiple CSV files292382
+Ref: #reading-multiple-csv-files292569
+Node: Valid transactions292810
+Ref: #valid-transactions292990
+Node: Deduplicating importing293618
+Ref: #deduplicating-importing293799
+Node: Setting amounts294832
+Ref: #setting-amounts294989
+Node: Amount signs297430
+Ref: #amount-signs297584
+Node: Setting currency/commodity298271
+Ref: #setting-currencycommodity298459
+Node: Amount decimal places299633
+Ref: #amount-decimal-places299825
+Node: Referencing other fields300137
+Ref: #referencing-other-fields300336
+Node: How CSV rules are evaluated301233
+Ref: #how-csv-rules-are-evaluated301408
+Node: TIMECLOCK FORMAT302859
+Ref: #timeclock-format302999
+Node: TIMEDOT FORMAT305060
+Ref: #timedot-format305198
+Node: COMMON TASKS309760
+Ref: #common-tasks309889
+Node: Getting help310296
+Ref: #getting-help310430
+Node: Constructing command lines310983
+Ref: #constructing-command-lines311177
+Node: Starting a journal file311874
+Ref: #starting-a-journal-file312074
+Node: Setting opening balances313262
+Ref: #setting-opening-balances313460
+Node: Recording transactions316601
+Ref: #recording-transactions316783
+Node: Reconciling317339
+Ref: #reconciling317484
+Node: Reporting319741
+Ref: #reporting319883
+Node: Migrating to a new file323882
+Ref: #migrating-to-a-new-file324032
+Node: LIMITATIONS324331
+Ref: #limitations324459
+Node: TROUBLESHOOTING325202
+Ref: #troubleshooting325317

 End Tag Table

--- a/hledger/hledger.txt
+++ b/hledger/hledger.txt
@ -2199,9 +2199,9 @@ COMMANDS
       accounts yet.

   Data layout
-       With --layout, you can influence how amounts with more than one commod-
-       ity are displayed (and a bit more), which in turn affects the layout of
-       the report data:
+       The  --layout option affects how multi-commodity amounts are displayed,
+       and some other things, influencing the overall  layout  of  the  report
+       data:

       o --layout=wide[,WIDTH]: commodities are shown on a single line, possi-
         bly elided to the specified width
@ -2212,15 +2212,17 @@ COMMANDS
         bols in a separate column

       o --layout=tidy: data is normalised to tidy form, with one row per data
-         value (supported with CSV output only)
+         value.  This is supported with CSV output format  only.   Totals  and
+         row  averages are disabled in this mode (-N/--no-total is implied and
+         -T/--row-total and -A/--average will be ignored).

       These --layout values affect some but not all of the output formats, as
       shown:


+
       -      txt   csv   html   json   sql
       -------------------------------------
-
       wide   Y     Y     Y
       tall   Y     Y     Y
       bare   Y     Y     Y
@ -3132,7 +3134,6 @@ COMMANDS
       -e 2021-01-01       end dates are exclusive
       -e 2021             equivalent,   per    smart
                           dates
-
       -p 2020             equivalent,  the  period's
                           begin date is ignored
       date:2020           equivalent query
@ -4987,8 +4988,6 @@ JOURNAL FORMAT
       budget goals
       Generate extra postings           =
       CHECKING FOR ERRORS:
-
-
       Define  valid entities to allow   account,    commodity,
       stricter error checking           payee
       DISPLAYING REPORTS:
@ -5015,6 +5014,8 @@ JOURNAL FORMAT
                  account.
       comment    Ignores part of the journal file, until end of  current  file   Y
                  or end comment.
+
+
       commod-    Declares a commodity, for checking all entries in all  files;   N, Y
       ity        the  decimal  mark for parsing amounts of this commodity, for
                  following entries until end of current file; and its  display