;doc: update manuals

hledger/hledger.1

@@ -5855,9 +5855,9 @@ Either search does not converge to a solution, or converges too slowly.
 Examples:
 .IP \[bu] 2
 Using roi to compute total return of investment in stocks:
-https://github.com/simonmichael/hledger/blob/master/examples/roi-unrealised.ledger
+https://github.com/simonmichael/hledger/blob/master/examples/investing/roi-unrealised.ledger
 .IP \[bu] 2
-Cookbook -> Return on Investment
+Cookbook > Return on Investment: https://hledger.org/roi.html
 .SS Spaces and special characters in \f[C]--inv\f[R] and \f[C]--pnl\f[R]
 .PP
 Note that \f[C]--inv\f[R] and \f[C]--pnl\f[R]\[aq]s argument is a query,
@@ -6008,9 +6008,16 @@ unit\[dq].
 Change in \[dq]unit price\[dq] over the reporting period gives you rate
 of return of your investment.
 .PP
-References: * Explanation of rate of return * Explanation of IRR *
-Explanation of TWR * Examples of computing IRR and TWR and discussion of
-the limitations of both metrics
+References:
+.IP \[bu] 2
+Explanation of rate of return
+.IP \[bu] 2
+Explanation of IRR
+.IP \[bu] 2
+Explanation of TWR
+.IP \[bu] 2
+Examples of computing IRR and TWR and discussion of the limitations of
+both metrics
 .SS stats
 .PP
 stats
@@ -7602,6 +7609,12 @@ hledger will report an error if a commodity symbol is used that has not
 been declared by a \f[C]commodity\f[R] directive.
 This works similarly to account error checking, see the notes there for
 more details.
+.PP
+Note, this disallows amounts without a commodity symbol, because
+currently it\[aq]s not possible (?) to declare the \[dq]no-symbol\[dq]
+commodity with a directive.
+This is one exception for convenience: zero amounts are always allowed
+to have no commodity symbol.
 .SS Default commodity
 .PP
 The \f[C]D\f[R] directive sets a default commodity, to be used for any

hledger/hledger.info

@@ -4888,9 +4888,9 @@ display, regardless of the length of reporting interval.
    Examples:
 
    * Using roi to compute total return of investment in stocks:
-     https://github.com/simonmichael/hledger/blob/master/examples/roi-unrealised.ledger
+     https://github.com/simonmichael/hledger/blob/master/examples/investing/roi-unrealised.ledger
 
-   * Cookbook -> Return on Investment
+   * Cookbook > Return on Investment: https://hledger.org/roi.html
 
 * Menu:
 
@@ -5030,9 +5030,13 @@ and changes in its value change the value of "investment unit".  Change
 in "unit price" over the reporting period gives you rate of return of
 your investment.
 
-   References: * Explanation of rate of return * Explanation of IRR *
-Explanation of TWR * Examples of computing IRR and TWR and discussion of
-the limitations of both metrics
+   References:
+
+   * Explanation of rate of return
+   * Explanation of IRR
+   * Explanation of TWR
+   * Examples of computing IRR and TWR and discussion of the limitations
+     of both metrics
 
 
 File: hledger.info,  Node: stats,  Next: tags,  Prev: roi,  Up: COMMANDS
@@ -6436,6 +6440,11 @@ report an error if a commodity symbol is used that has not been declared
 by a 'commodity' directive.  This works similarly to account error
 checking, see the notes there for more details.
 
+   Note, this disallows amounts without a commodity symbol, because
+currently it's not possible (?)  to declare the "no-symbol" commodity
+with a directive.  This is one exception for convenience: zero amounts
+are always allowed to have no commodity symbol.
+
 
 File: hledger.info,  Node: Default commodity,  Next: Declaring market prices,  Prev: Declaring commodities,  Up: JOURNAL FORMAT
 
@@ -9629,280 +9638,280 @@ Node: rewrite vs print --auto175863
 Ref: #rewrite-vs.-print---auto176023
 Node: roi176579
 Ref: #roi176679
-Node: Spaces and special characters in --inv and --pnl178365
-Ref: #spaces-and-special-characters-in---inv-and---pnl178605
-Node: Semantics of --inv and --pnl179093
-Ref: #semantics-of---inv-and---pnl179332
-Node: IRR and TWR explained181182
-Ref: #irr-and-twr-explained181342
-Node: stats184410
-Ref: #stats184511
-Node: tags185891
-Ref: #tags185991
-Node: test186510
-Ref: #test186626
-Node: About add-on commands187373
-Ref: #about-add-on-commands187510
-Node: JOURNAL FORMAT188641
-Ref: #journal-format188769
-Node: Transactions190996
-Ref: #transactions191111
-Node: Dates192125
-Ref: #dates192241
-Node: Simple dates192306
-Ref: #simple-dates192426
-Node: Secondary dates192935
-Ref: #secondary-dates193083
-Node: Posting dates194419
-Ref: #posting-dates194542
-Node: Status195914
-Ref: #status196024
-Node: Code197732
-Ref: #code197844
-Node: Description198076
-Ref: #description198204
-Node: Payee and note198524
-Ref: #payee-and-note198632
-Node: Comments198967
-Ref: #comments199089
-Node: Tags200283
-Ref: #tags-1200394
-Node: Postings201787
-Ref: #postings201911
-Node: Virtual postings202937
-Ref: #virtual-postings203048
-Node: Account names204353
-Ref: #account-names204490
-Node: Amounts204978
-Ref: #amounts205115
-Node: Decimal marks digit group marks206100
-Ref: #decimal-marks-digit-group-marks206277
-Node: Commodity207298
-Ref: #commodity207487
-Node: Directives influencing number parsing and display208439
-Ref: #directives-influencing-number-parsing-and-display208700
-Node: Commodity display style209193
-Ref: #commodity-display-style209401
-Node: Rounding211596
-Ref: #rounding211716
-Node: Transaction prices212128
-Ref: #transaction-prices212294
-Node: Lot prices lot dates214725
-Ref: #lot-prices-lot-dates214908
-Node: Balance assertions215396
-Ref: #balance-assertions215574
-Node: Assertions and ordering216607
-Ref: #assertions-and-ordering216789
-Node: Assertions and included files217489
-Ref: #assertions-and-included-files217726
-Node: Assertions and multiple -f options218059
-Ref: #assertions-and-multiple--f-options218309
-Node: Assertions and commodities218441
-Ref: #assertions-and-commodities218667
-Node: Assertions and prices219824
-Ref: #assertions-and-prices220032
-Node: Assertions and subaccounts220472
-Ref: #assertions-and-subaccounts220695
-Node: Assertions and virtual postings221019
-Ref: #assertions-and-virtual-postings221255
-Node: Assertions and precision221397
-Ref: #assertions-and-precision221584
-Node: Balance assignments221851
-Ref: #balance-assignments222021
-Node: Balance assignments and prices223185
-Ref: #balance-assignments-and-prices223351
-Node: Directives223575
-Ref: #directives223738
-Node: Directives and multiple files228230
-Ref: #directives-and-multiple-files228426
-Node: Comment blocks229118
-Ref: #comment-blocks229295
-Node: Including other files229471
-Ref: #including-other-files229645
-Node: Default year230569
-Ref: #default-year230727
-Node: Declaring payees231134
-Ref: #declaring-payees231305
-Node: Declaring the decimal mark231551
-Ref: #declaring-the-decimal-mark231751
-Node: Declaring commodities232148
-Ref: #declaring-commodities232339
-Node: Commodity error checking234857
-Ref: #commodity-error-checking235007
-Node: Default commodity235264
-Ref: #default-commodity235444
-Node: Declaring market prices236560
-Ref: #declaring-market-prices236749
-Node: Declaring accounts237562
-Ref: #declaring-accounts237742
-Node: Account error checking238944
-Ref: #account-error-checking239110
-Node: Account comments240289
-Ref: #account-comments240473
-Node: Account subdirectives240897
-Ref: #account-subdirectives241082
-Node: Account types241395
-Ref: #account-types241569
-Node: Auto-detected account types242985
-Ref: #auto-detected-account-types243140
-Node: Account display order244375
-Ref: #account-display-order244535
-Node: Rewriting accounts245686
-Ref: #rewriting-accounts245865
-Node: Basic aliases246875
-Ref: #basic-aliases247011
-Node: Regex aliases247755
-Ref: #regex-aliases247917
-Node: Combining aliases248636
-Ref: #combining-aliases248819
-Node: Aliases and multiple files250095
-Ref: #aliases-and-multiple-files250294
-Node: end aliases250873
-Ref: #end-aliases251067
-Node: Aliases can generate bad account names251216
-Ref: #aliases-can-generate-bad-account-names251425
-Node: Default parent account252010
-Ref: #default-parent-account252200
-Node: Periodic transactions253084
-Ref: #periodic-transactions253267
-Node: Periodic rule syntax255184
-Ref: #periodic-rule-syntax255384
-Node: Two spaces between period expression and description!256088
-Ref: #two-spaces-between-period-expression-and-description256401
-Node: Forecasting with periodic transactions257085
-Ref: #forecasting-with-periodic-transactions257384
-Node: Budgeting with periodic transactions260155
-Ref: #budgeting-with-periodic-transactions260388
-Node: Auto postings260797
-Ref: #auto-postings260933
-Node: Auto postings and multiple files263112
-Ref: #auto-postings-and-multiple-files263310
-Node: Auto postings and dates263519
-Ref: #auto-postings-and-dates263787
-Node: Auto postings and transaction balancing / inferred amounts / balance assertions263962
-Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions264307
-Node: Auto posting tags264810
-Ref: #auto-posting-tags265019
-Node: CSV FORMAT265655
-Ref: #csv-format265783
-Node: Examples268412
-Ref: #examples268515
-Node: Basic268723
-Ref: #basic268825
-Node: Bank of Ireland269367
-Ref: #bank-of-ireland269504
-Node: Amazon270966
-Ref: #amazon271086
-Node: Paypal272805
-Ref: #paypal272901
-Node: CSV rules280545
-Ref: #csv-rules280663
-Node: skip280996
-Ref: #skip281096
-Node: fields list281471
-Ref: #fields-list281610
-Node: field assignment283176
-Ref: #field-assignment283328
-Node: Field names284363
-Ref: #field-names284503
-Node: date field284883
-Ref: #date-field285003
-Node: date2 field285051
-Ref: #date2-field285194
-Node: status field285250
-Ref: #status-field285395
-Node: code field285444
-Ref: #code-field285591
-Node: description field285636
-Ref: #description-field285798
-Node: comment field285857
-Ref: #comment-field286014
-Node: account field286325
-Ref: #account-field286477
-Node: amount field287052
-Ref: #amount-field287203
-Node: currency field288448
-Ref: #currency-field288603
-Node: balance field288860
-Ref: #balance-field288994
-Node: separator289366
-Ref: #separator289498
-Node: if block290038
-Ref: #if-block290165
-Node: Matching the whole record290566
-Ref: #matching-the-whole-record290743
-Node: Matching individual fields291546
-Ref: #matching-individual-fields291752
-Node: Combining matchers291976
-Ref: #combining-matchers292174
-Node: Rules applied on successful match292487
-Ref: #rules-applied-on-successful-match292680
-Node: if table293334
-Ref: #if-table293455
-Node: end295193
-Ref: #end295307
-Node: date-format295531
-Ref: #date-format295665
-Node: decimal-mark296661
-Ref: #decimal-mark296808
-Node: newest-first297147
-Ref: #newest-first297290
-Node: include297973
-Ref: #include298106
-Node: balance-type298550
-Ref: #balance-type298672
-Node: Tips299372
-Ref: #tips299463
-Node: Rapid feedback299762
-Ref: #rapid-feedback299881
-Node: Valid CSV300333
-Ref: #valid-csv300465
-Node: File Extension300657
-Ref: #file-extension300811
-Node: Reading multiple CSV files301240
-Ref: #reading-multiple-csv-files301427
-Node: Valid transactions301668
-Ref: #valid-transactions301848
-Node: Deduplicating importing302476
-Ref: #deduplicating-importing302657
-Node: Setting amounts303690
-Ref: #setting-amounts303847
-Node: Amount signs306291
-Ref: #amount-signs306445
-Node: Setting currency/commodity307132
-Ref: #setting-currencycommodity307320
-Node: Amount decimal places308494
-Ref: #amount-decimal-places308686
-Node: Referencing other fields308998
-Ref: #referencing-other-fields309197
-Node: How CSV rules are evaluated310094
-Ref: #how-csv-rules-are-evaluated310269
-Node: TIMECLOCK FORMAT311720
-Ref: #timeclock-format311860
-Node: TIMEDOT FORMAT313921
-Ref: #timedot-format314059
-Node: COMMON TASKS318621
-Ref: #common-tasks318750
-Node: Getting help319157
-Ref: #getting-help319291
-Node: Constructing command lines319852
-Ref: #constructing-command-lines320046
-Node: Starting a journal file320743
-Ref: #starting-a-journal-file320943
-Node: Setting opening balances322131
-Ref: #setting-opening-balances322329
-Node: Recording transactions325470
-Ref: #recording-transactions325652
-Node: Reconciling326208
-Ref: #reconciling326353
-Node: Reporting328610
-Ref: #reporting328752
-Node: Migrating to a new file332751
-Ref: #migrating-to-a-new-file332901
-Node: LIMITATIONS333200
-Ref: #limitations333328
-Node: TROUBLESHOOTING334071
-Ref: #troubleshooting334186
+Node: Spaces and special characters in --inv and --pnl178404
+Ref: #spaces-and-special-characters-in---inv-and---pnl178644
+Node: Semantics of --inv and --pnl179132
+Ref: #semantics-of---inv-and---pnl179371
+Node: IRR and TWR explained181221
+Ref: #irr-and-twr-explained181381
+Node: stats184467
+Ref: #stats184568
+Node: tags185948
+Ref: #tags186048
+Node: test186567
+Ref: #test186683
+Node: About add-on commands187430
+Ref: #about-add-on-commands187567
+Node: JOURNAL FORMAT188698
+Ref: #journal-format188826
+Node: Transactions191053
+Ref: #transactions191168
+Node: Dates192182
+Ref: #dates192298
+Node: Simple dates192363
+Ref: #simple-dates192483
+Node: Secondary dates192992
+Ref: #secondary-dates193140
+Node: Posting dates194476
+Ref: #posting-dates194599
+Node: Status195971
+Ref: #status196081
+Node: Code197789
+Ref: #code197901
+Node: Description198133
+Ref: #description198261
+Node: Payee and note198581
+Ref: #payee-and-note198689
+Node: Comments199024
+Ref: #comments199146
+Node: Tags200340
+Ref: #tags-1200451
+Node: Postings201844
+Ref: #postings201968
+Node: Virtual postings202994
+Ref: #virtual-postings203105
+Node: Account names204410
+Ref: #account-names204547
+Node: Amounts205035
+Ref: #amounts205172
+Node: Decimal marks digit group marks206157
+Ref: #decimal-marks-digit-group-marks206334
+Node: Commodity207355
+Ref: #commodity207544
+Node: Directives influencing number parsing and display208496
+Ref: #directives-influencing-number-parsing-and-display208757
+Node: Commodity display style209250
+Ref: #commodity-display-style209458
+Node: Rounding211653
+Ref: #rounding211773
+Node: Transaction prices212185
+Ref: #transaction-prices212351
+Node: Lot prices lot dates214782
+Ref: #lot-prices-lot-dates214965
+Node: Balance assertions215453
+Ref: #balance-assertions215631
+Node: Assertions and ordering216664
+Ref: #assertions-and-ordering216846
+Node: Assertions and included files217546
+Ref: #assertions-and-included-files217783
+Node: Assertions and multiple -f options218116
+Ref: #assertions-and-multiple--f-options218366
+Node: Assertions and commodities218498
+Ref: #assertions-and-commodities218724
+Node: Assertions and prices219881
+Ref: #assertions-and-prices220089
+Node: Assertions and subaccounts220529
+Ref: #assertions-and-subaccounts220752
+Node: Assertions and virtual postings221076
+Ref: #assertions-and-virtual-postings221312
+Node: Assertions and precision221454
+Ref: #assertions-and-precision221641
+Node: Balance assignments221908
+Ref: #balance-assignments222078
+Node: Balance assignments and prices223242
+Ref: #balance-assignments-and-prices223408
+Node: Directives223632
+Ref: #directives223795
+Node: Directives and multiple files228287
+Ref: #directives-and-multiple-files228483
+Node: Comment blocks229175
+Ref: #comment-blocks229352
+Node: Including other files229528
+Ref: #including-other-files229702
+Node: Default year230626
+Ref: #default-year230784
+Node: Declaring payees231191
+Ref: #declaring-payees231362
+Node: Declaring the decimal mark231608
+Ref: #declaring-the-decimal-mark231808
+Node: Declaring commodities232205
+Ref: #declaring-commodities232396
+Node: Commodity error checking234914
+Ref: #commodity-error-checking235064
+Node: Default commodity235579
+Ref: #default-commodity235759
+Node: Declaring market prices236875
+Ref: #declaring-market-prices237064
+Node: Declaring accounts237877
+Ref: #declaring-accounts238057
+Node: Account error checking239259
+Ref: #account-error-checking239425
+Node: Account comments240604
+Ref: #account-comments240788
+Node: Account subdirectives241212
+Ref: #account-subdirectives241397
+Node: Account types241710
+Ref: #account-types241884
+Node: Auto-detected account types243300
+Ref: #auto-detected-account-types243455
+Node: Account display order244690
+Ref: #account-display-order244850
+Node: Rewriting accounts246001
+Ref: #rewriting-accounts246180
+Node: Basic aliases247190
+Ref: #basic-aliases247326
+Node: Regex aliases248070
+Ref: #regex-aliases248232
+Node: Combining aliases248951
+Ref: #combining-aliases249134
+Node: Aliases and multiple files250410
+Ref: #aliases-and-multiple-files250609
+Node: end aliases251188
+Ref: #end-aliases251382
+Node: Aliases can generate bad account names251531
+Ref: #aliases-can-generate-bad-account-names251740
+Node: Default parent account252325
+Ref: #default-parent-account252515
+Node: Periodic transactions253399
+Ref: #periodic-transactions253582
+Node: Periodic rule syntax255499
+Ref: #periodic-rule-syntax255699
+Node: Two spaces between period expression and description!256403
+Ref: #two-spaces-between-period-expression-and-description256716
+Node: Forecasting with periodic transactions257400
+Ref: #forecasting-with-periodic-transactions257699
+Node: Budgeting with periodic transactions260470
+Ref: #budgeting-with-periodic-transactions260703
+Node: Auto postings261112
+Ref: #auto-postings261248
+Node: Auto postings and multiple files263427
+Ref: #auto-postings-and-multiple-files263625
+Node: Auto postings and dates263834
+Ref: #auto-postings-and-dates264102
+Node: Auto postings and transaction balancing / inferred amounts / balance assertions264277
+Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions264622
+Node: Auto posting tags265125
+Ref: #auto-posting-tags265334
+Node: CSV FORMAT265970
+Ref: #csv-format266098
+Node: Examples268727
+Ref: #examples268830
+Node: Basic269038
+Ref: #basic269140
+Node: Bank of Ireland269682
+Ref: #bank-of-ireland269819
+Node: Amazon271281
+Ref: #amazon271401
+Node: Paypal273120
+Ref: #paypal273216
+Node: CSV rules280860
+Ref: #csv-rules280978
+Node: skip281311
+Ref: #skip281411
+Node: fields list281786
+Ref: #fields-list281925
+Node: field assignment283491
+Ref: #field-assignment283643
+Node: Field names284678
+Ref: #field-names284818
+Node: date field285198
+Ref: #date-field285318
+Node: date2 field285366
+Ref: #date2-field285509
+Node: status field285565
+Ref: #status-field285710
+Node: code field285759
+Ref: #code-field285906
+Node: description field285951
+Ref: #description-field286113
+Node: comment field286172
+Ref: #comment-field286329
+Node: account field286640
+Ref: #account-field286792
+Node: amount field287367
+Ref: #amount-field287518
+Node: currency field288763
+Ref: #currency-field288918
+Node: balance field289175
+Ref: #balance-field289309
+Node: separator289681
+Ref: #separator289813
+Node: if block290353
+Ref: #if-block290480
+Node: Matching the whole record290881
+Ref: #matching-the-whole-record291058
+Node: Matching individual fields291861
+Ref: #matching-individual-fields292067
+Node: Combining matchers292291
+Ref: #combining-matchers292489
+Node: Rules applied on successful match292802
+Ref: #rules-applied-on-successful-match292995
+Node: if table293649
+Ref: #if-table293770
+Node: end295508
+Ref: #end295622
+Node: date-format295846
+Ref: #date-format295980
+Node: decimal-mark296976
+Ref: #decimal-mark297123
+Node: newest-first297462
+Ref: #newest-first297605
+Node: include298288
+Ref: #include298421
+Node: balance-type298865
+Ref: #balance-type298987
+Node: Tips299687
+Ref: #tips299778
+Node: Rapid feedback300077
+Ref: #rapid-feedback300196
+Node: Valid CSV300648
+Ref: #valid-csv300780
+Node: File Extension300972
+Ref: #file-extension301126
+Node: Reading multiple CSV files301555
+Ref: #reading-multiple-csv-files301742
+Node: Valid transactions301983
+Ref: #valid-transactions302163
+Node: Deduplicating importing302791
+Ref: #deduplicating-importing302972
+Node: Setting amounts304005
+Ref: #setting-amounts304162
+Node: Amount signs306606
+Ref: #amount-signs306760
+Node: Setting currency/commodity307447
+Ref: #setting-currencycommodity307635
+Node: Amount decimal places308809
+Ref: #amount-decimal-places309001
+Node: Referencing other fields309313
+Ref: #referencing-other-fields309512
+Node: How CSV rules are evaluated310409
+Ref: #how-csv-rules-are-evaluated310584
+Node: TIMECLOCK FORMAT312035
+Ref: #timeclock-format312175
+Node: TIMEDOT FORMAT314236
+Ref: #timedot-format314374
+Node: COMMON TASKS318936
+Ref: #common-tasks319065
+Node: Getting help319472
+Ref: #getting-help319606
+Node: Constructing command lines320167
+Ref: #constructing-command-lines320361
+Node: Starting a journal file321058
+Ref: #starting-a-journal-file321258
+Node: Setting opening balances322446
+Ref: #setting-opening-balances322644
+Node: Recording transactions325785
+Ref: #recording-transactions325967
+Node: Reconciling326523
+Ref: #reconciling326668
+Node: Reporting328925
+Ref: #reporting329067
+Node: Migrating to a new file333066
+Ref: #migrating-to-a-new-file333216
+Node: LIMITATIONS333515
+Ref: #limitations333643
+Node: TROUBLESHOOTING334386
+Ref: #troubleshooting334501
 
 End Tag Table