;update manuals

hledger-ui/hledger-ui.1

@@ -192,7 +192,7 @@ show general or COMMAND user manual with man
 show general or COMMAND user manual with info
 .TP
 \f[B]\f[CB]--version\f[B]\f[R]
-show general or ADDONCOMMAND version
+show general or ADDONCMD version
 .TP
 \f[B]\f[CB]--debug[=N]\f[B]\f[R]
 show debug output (levels 1-9, default: 1)

hledger-ui/hledger-ui.info

@@ -206,7 +206,7 @@ the last one takes precedence.
      show general or COMMAND user manual with info
 '--version'
 
-     show general or ADDONCOMMAND version
+     show general or ADDONCMD version
 '--debug[=N]'
 
      show debug output (levels 1-9, default: 1)
@@ -528,23 +528,23 @@ Tag Table:
 Node: Top71
 Node: OPTIONS1488
 Ref: #options1585
-Node: KEYS5772
-Ref: #keys5867
-Node: SCREENS10186
-Ref: #screens10291
-Node: Accounts screen10381
-Ref: #accounts-screen10509
-Node: Register screen12724
-Ref: #register-screen12879
-Node: Transaction screen14876
-Ref: #transaction-screen15034
-Node: Error screen15904
-Ref: #error-screen16026
-Node: ENVIRONMENT16270
-Ref: #environment16384
-Node: FILES17191
-Ref: #files17290
-Node: BUGS17503
-Ref: #bugs17580
+Node: KEYS5768
+Ref: #keys5863
+Node: SCREENS10182
+Ref: #screens10287
+Node: Accounts screen10377
+Ref: #accounts-screen10505
+Node: Register screen12720
+Ref: #register-screen12875
+Node: Transaction screen14872
+Ref: #transaction-screen15030
+Node: Error screen15900
+Ref: #error-screen16022
+Node: ENVIRONMENT16266
+Ref: #environment16380
+Node: FILES17187
+Ref: #files17286
+Node: BUGS17499
+Ref: #bugs17576
 
 End Tag Table

hledger-ui/hledger-ui.txt

@@ -185,7 +185,7 @@ OPTIONS
        --info show general or COMMAND user manual with info
 
        --version
-              show general or ADDONCOMMAND version
+              show general or ADDONCMD version
 
        --debug[=N]
               show debug output (levels 1-9, default: 1)

hledger-web/hledger-web.1

@@ -221,7 +221,7 @@ show general or COMMAND user manual with man
 show general or COMMAND user manual with info
 .TP
 \f[B]\f[CB]--version\f[B]\f[R]
-show general or ADDONCOMMAND version
+show general or ADDONCMD version
 .TP
 \f[B]\f[CB]--debug[=N]\f[B]\f[R]
 show debug output (levels 1-9, default: 1)

hledger-web/hledger-web.info

@@ -234,7 +234,7 @@ the last one takes precedence.
      show general or COMMAND user manual with info
 '--version'
 
-     show general or ADDONCOMMAND version
+     show general or ADDONCMD version
 '--debug[=N]'
 
      show debug output (levels 1-9, default: 1)
@@ -598,19 +598,19 @@ Tag Table:
 Node: Top72
 Node: OPTIONS1762
 Ref: #options1867
-Node: PERMISSIONS9086
-Ref: #permissions9225
-Node: EDITING UPLOADING DOWNLOADING10437
-Ref: #editing-uploading-downloading10618
-Node: RELOADING11452
-Ref: #reloading11586
-Node: JSON API12019
-Ref: #json-api12133
-Node: ENVIRONMENT17623
-Ref: #environment17739
-Node: FILES18472
-Ref: #files18572
-Node: BUGS18785
-Ref: #bugs18863
+Node: PERMISSIONS9082
+Ref: #permissions9221
+Node: EDITING UPLOADING DOWNLOADING10433
+Ref: #editing-uploading-downloading10614
+Node: RELOADING11448
+Ref: #reloading11582
+Node: JSON API12015
+Ref: #json-api12129
+Node: ENVIRONMENT17619
+Ref: #environment17735
+Node: FILES18468
+Ref: #files18568
+Node: BUGS18781
+Ref: #bugs18859
 
 End Tag Table

hledger-web/hledger-web.txt

@@ -209,7 +209,7 @@ OPTIONS
        --info show general or COMMAND user manual with info
 
        --version
-              show general or ADDONCOMMAND version
+              show general or ADDONCMD version
 
        --debug[=N]
               show debug output (levels 1-9, default: 1)

hledger/hledger.1

@@ -84,7 +84,7 @@ show general or COMMAND user manual with man
 show general or COMMAND user manual with info
 .TP
 \f[B]\f[CB]--version\f[B]\f[R]
-show general or ADDONCOMMAND version
+show general or ADDONCMD version
 .TP
 \f[B]\f[CB]--debug[=N]\f[B]\f[R]
 show debug output (levels 1-9, default: 1)
@@ -3788,15 +3788,12 @@ print
 Show transaction journal entries, sorted by date.
 .PP
 The print command displays full journal entries (transactions) from the
-journal file in date order, tidily formatted.
-With --date2, transactions are sorted by secondary date instead.
-.PP
-print\[aq]s output is always a valid hledger journal.
-.PD 0
-.P
-.PD
-It preserves all transaction information, but it does not preserve
-directives or inter-transaction comments
+journal file, sorted by date (or with \f[C]--date2\f[R], by secondary
+date).
+Amounts are shown right-aligned within each transaction (but not across
+all transactions).
+Directives and inter-transaction comments are not shown.
+Eg:
 .IP
 .nf
 \f[C]
@@ -3824,6 +3821,29 @@ $ hledger print
 \f[R]
 .fi
 .PP
+print\[aq]s output is usually a valid hledger journal, and you can
+process it again with a second hledger command.
+This can be useful for certain kinds of search, eg:
+.IP
+.nf
+\f[C]
+# Show running total of food expenses paid from cash.
+# -f- reads from stdin. -I/--ignore-assertions is sometimes needed.
+$ hledger print assets:cash | hledger -f- -I reg expenses:food
+\f[R]
+.fi
+.PP
+There are some situations where print\[aq]s output can become
+unparseable:
+.IP \[bu] 2
+Rounding amounts according to commodity display styles can cause
+transactions to appear unbalanced.
+.IP \[bu] 2
+Valuation affects posting amounts but not balance assertion or balance
+assignment amounts, potentially causing those to fail.
+.IP \[bu] 2
+Auto postings can generate postings with too many missing amounts.
+.PP
 Normally, the journal entry\[aq]s explicit or implicit amount style is
 preserved.
 For example, when an amount is omitted in the journal, it will not

hledger/hledger.info

@@ -112,7 +112,7 @@ by most hledger commands, run 'hledger -h'.
      show general or COMMAND user manual with info
 '--version'
 
-     show general or ADDONCOMMAND version
+     show general or ADDONCMD version
 '--debug[=N]'
 
      show debug output (levels 1-9, default: 1)
@@ -3218,12 +3218,10 @@ print
 Show transaction journal entries, sorted by date.
 
    The print command displays full journal entries (transactions) from
-the journal file in date order, tidily formatted.  With -date2,
-transactions are sorted by secondary date instead.
-
-   print's output is always a valid hledger journal.
-It preserves all transaction information, but it does not preserve
-directives or inter-transaction comments
+the journal file, sorted by date (or with '--date2', by secondary date).
+Amounts are shown right-aligned within each transaction (but not across
+all transactions).  Directives and inter-transaction comments are not
+shown.  Eg:
 
 $ hledger print
 2008/01/01 income
@@ -3247,6 +3245,23 @@ $ hledger print
     liabilities:debts               $1
     assets:bank:checking           $-1
 
+   print's output is usually a valid hledger journal, and you can
+process it again with a second hledger command.  This can be useful for
+certain kinds of search, eg:
+
+# Show running total of food expenses paid from cash.
+# -f- reads from stdin. -I/--ignore-assertions is sometimes needed.
+$ hledger print assets:cash | hledger -f- -I reg expenses:food
+
+   There are some situations where print's output can become
+unparseable:
+
+   * Rounding amounts according to commodity display styles can cause
+     transactions to appear unbalanced.
+   * Valuation affects posting amounts but not balance assertion or
+     balance assignment amounts, potentially causing those to fail.
+   * Auto postings can generate postings with too many missing amounts.
+
    Normally, the journal entry's explicit or implicit amount style is
 preserved.  For example, when an amount is omitted in the journal, it
 will not appear in the output.  Similarly, when a transaction price is
@@ -7836,421 +7851,421 @@ Node: OPTIONS2509
 Ref: #options2610
 Node: General options2752
 Ref: #general-options2877
-Node: Command options6398
-Ref: #command-options6549
-Node: Command arguments6949
-Ref: #command-arguments7107
-Node: Special characters7987
-Ref: #special-characters8150
-Node: Single escaping shell metacharacters8313
-Ref: #single-escaping-shell-metacharacters8554
-Node: Double escaping regular expression metacharacters8955
-Ref: #double-escaping-regular-expression-metacharacters9266
-Node: Triple escaping for add-on commands9792
-Ref: #triple-escaping-for-add-on-commands10052
-Node: Less escaping10696
-Ref: #less-escaping10850
-Node: Unicode characters11174
-Ref: #unicode-characters11339
-Node: Regular expressions12751
-Ref: #regular-expressions12891
-Node: ENVIRONMENT14627
-Ref: #environment14743
-Node: DATA FILES15728
-Ref: #data-files15847
-Node: Data formats16386
-Ref: #data-formats16504
-Node: Multiple files17841
-Ref: #multiple-files17983
-Node: Strict mode18452
-Ref: #strict-mode18567
-Node: TIME PERIODS19215
-Ref: #time-periods19332
-Node: Smart dates19430
-Ref: #smart-dates19556
-Node: Report start & end date20882
-Ref: #report-start-end-date21057
-Node: Report intervals22590
-Ref: #report-intervals22758
-Node: Period expressions23148
-Ref: #period-expressions23288
-Node: DEPTH27731
-Ref: #depth27831
-Node: QUERIES28163
-Ref: #queries28264
-Node: VALUATION32226
-Ref: #valuation32334
-Node: -B Cost33023
-Ref: #b-cost33121
-Node: -V Value33254
-Ref: #v-value33394
-Node: -X Value in specified commodity33589
-Ref: #x-value-in-specified-commodity33782
-Node: Valuation date33931
-Ref: #valuation-date34093
-Node: Market prices34530
-Ref: #market-prices34704
-Node: --infer-value market prices from transactions35625
-Ref: #infer-value-market-prices-from-transactions35868
-Node: Valuation commodity37129
-Ref: #valuation-commodity37332
-Node: Simple valuation examples38537
-Ref: #simple-valuation-examples38733
-Node: --value Flexible valuation39392
-Ref: #value-flexible-valuation39594
-Node: More valuation examples41541
-Ref: #more-valuation-examples41744
-Node: Effect of valuation on reports43749
-Ref: #effect-of-valuation-on-reports43931
-Node: PIVOTING50950
-Ref: #pivoting51055
-Node: OUTPUT52731
-Ref: #output52831
-Node: Output destination52882
-Ref: #output-destination53013
-Node: Output format53438
-Ref: #output-format53559
-Node: COMMANDS55726
-Ref: #commands55838
-Node: accounts59203
-Ref: #accounts59303
-Node: activity59999
-Ref: #activity60111
-Node: add60494
-Ref: #add60597
-Node: aregister63390
-Ref: #aregister63504
-Node: aregister and custom posting dates64998
-Ref: #aregister-and-custom-posting-dates65164
-Node: balance65985
-Ref: #balance66104
-Node: Classic balance report67727
-Ref: #classic-balance-report67902
-Node: Customising the classic balance report69226
-Ref: #customising-the-classic-balance-report69456
-Node: Colour support71532
-Ref: #colour-support71701
-Node: Flat mode71797
-Ref: #flat-mode71947
-Node: Depth limited balance reports72360
-Ref: #depth-limited-balance-reports72547
-Node: Percentages73003
-Ref: #percentages73162
-Node: Sorting by amount74299
-Ref: #sorting-by-amount74467
-Node: Multicolumn balance report74961
-Ref: #multicolumn-balance-report75149
-Node: Budget report80746
-Ref: #budget-report80882
-Node: Budget report start date86171
-Ref: #budget-report-start-date86338
-Node: Nested budgets87670
-Ref: #nested-budgets87817
-Node: balancesheet91257
-Ref: #balancesheet91395
-Node: balancesheetequity93032
-Ref: #balancesheetequity93183
-Node: cashflow94402
-Ref: #cashflow94526
-Node: check95860
-Ref: #check95965
-Node: Basic checks96570
-Ref: #basic-checks96688
-Node: Strict checks97181
-Ref: #strict-checks97322
-Node: Other checks97565
-Ref: #other-checks97705
-Node: Add-on checks98003
-Ref: #add-on-checks98123
-Node: close98576
-Ref: #close98680
-Node: close usage100202
-Ref: #close-usage100297
-Node: codes103110
-Ref: #codes103220
-Node: commodities103932
-Ref: #commodities104061
-Node: descriptions104143
-Ref: #descriptions104273
-Node: diff104577
-Ref: #diff104685
-Node: files105732
-Ref: #files105834
-Node: help105981
-Ref: #help106083
-Node: import106810
-Ref: #import106926
-Node: Importing balance assignments107848
-Ref: #importing-balance-assignments108031
-Node: Commodity display styles108680
-Ref: #commodity-display-styles108853
-Node: incomestatement108982
-Ref: #incomestatement109117
-Node: notes110579
-Ref: #notes110694
-Node: payees111062
-Ref: #payees111170
-Node: prices111590
-Ref: #prices111698
-Node: print112039
-Ref: #print112151
-Node: print-unique116938
-Ref: #print-unique117066
-Node: register117351
-Ref: #register117480
-Node: Custom register output121926
-Ref: #custom-register-output122057
-Node: register-match123394
-Ref: #register-match123530
-Node: rewrite123881
-Ref: #rewrite123998
-Node: Re-write rules in a file125904
-Ref: #re-write-rules-in-a-file126067
-Node: Diff output format127216
-Ref: #diff-output-format127399
-Node: rewrite vs print --auto128491
-Ref: #rewrite-vs.-print---auto128651
-Node: roi129207
-Ref: #roi129307
-Node: stats141517
-Ref: #stats141618
-Node: tags142406
-Ref: #tags142506
-Node: test143025
-Ref: #test143141
-Node: About add-on commands143888
-Ref: #about-add-on-commands144025
-Node: JOURNAL FORMAT145156
-Ref: #journal-format145284
-Node: Transactions147450
-Ref: #transactions147565
-Node: Dates148579
-Ref: #dates148695
-Node: Simple dates148760
-Ref: #simple-dates148880
-Node: Secondary dates149389
-Ref: #secondary-dates149537
-Node: Posting dates150873
-Ref: #posting-dates150996
-Node: Status152368
-Ref: #status152485
-Node: Description154193
-Ref: #description154323
-Node: Payee and note154643
-Ref: #payee-and-note154751
-Node: Comments155086
-Ref: #comments155208
-Node: Tags156402
-Ref: #tags-1156513
-Node: Postings157906
-Ref: #postings158030
-Node: Virtual postings159056
-Ref: #virtual-postings159167
-Node: Account names160472
-Ref: #account-names160609
-Node: Amounts161096
-Ref: #amounts161231
-Node: Digit group marks162355
-Ref: #digit-group-marks162500
-Node: Commodity display style163438
-Ref: #commodity-display-style163612
-Node: Rounding165325
-Ref: #rounding165443
-Node: Transaction prices165855
-Ref: #transaction-prices166021
-Node: Lot prices lot dates168452
-Ref: #lot-prices-lot-dates168635
-Node: Balance assertions169123
-Ref: #balance-assertions169301
-Node: Assertions and ordering170334
-Ref: #assertions-and-ordering170516
-Node: Assertions and included files171216
-Ref: #assertions-and-included-files171453
-Node: Assertions and multiple -f options171786
-Ref: #assertions-and-multiple--f-options172036
-Node: Assertions and commodities172168
-Ref: #assertions-and-commodities172394
-Node: Assertions and prices173551
-Ref: #assertions-and-prices173759
-Node: Assertions and subaccounts174199
-Ref: #assertions-and-subaccounts174422
-Node: Assertions and virtual postings174746
-Ref: #assertions-and-virtual-postings174982
-Node: Assertions and precision175124
-Ref: #assertions-and-precision175311
-Node: Balance assignments175578
-Ref: #balance-assignments175748
-Node: Balance assignments and prices176912
-Ref: #balance-assignments-and-prices177078
-Node: Directives177302
-Ref: #directives177465
-Node: Directives and multiple files182708
-Ref: #directives-and-multiple-files182904
-Node: Comment blocks183568
-Ref: #comment-blocks183745
-Node: Including other files183921
-Ref: #including-other-files184095
-Node: Default year185019
-Ref: #default-year185182
-Node: Declaring commodities185589
-Ref: #declaring-commodities185766
-Node: Commodity error checking187610
-Ref: #commodity-error-checking187760
-Node: Default commodity188017
-Ref: #default-commodity188197
-Node: Declaring market prices189086
-Ref: #declaring-market-prices189275
-Node: Declaring accounts190132
-Ref: #declaring-accounts190312
-Node: Account error checking191514
-Ref: #account-error-checking191680
-Node: Account comments192859
-Ref: #account-comments193043
-Node: Account subdirectives193467
-Ref: #account-subdirectives193652
-Node: Account types193965
-Ref: #account-types194139
-Node: Declaring account types194875
-Ref: #declaring-account-types195054
-Node: Auto-detected account types195704
-Ref: #auto-detected-account-types195945
-Node: Interference from auto-detected account types196842
-Ref: #interference-from-auto-detected-account-types197119
-Node: Old account type syntax197602
-Ref: #old-account-type-syntax197799
-Node: Account display order198099
-Ref: #account-display-order198259
-Node: Rewriting accounts199410
-Ref: #rewriting-accounts199589
-Node: Basic aliases200346
-Ref: #basic-aliases200482
-Node: Regex aliases201186
-Ref: #regex-aliases201348
-Node: Combining aliases202067
-Ref: #combining-aliases202250
-Node: Aliases and multiple files203526
-Ref: #aliases-and-multiple-files203725
-Node: end aliases204304
-Ref: #end-aliases204451
-Node: Default parent account204552
-Ref: #default-parent-account204742
-Node: Periodic transactions205626
-Ref: #periodic-transactions205809
-Node: Periodic rule syntax207726
-Ref: #periodic-rule-syntax207926
-Node: Two spaces between period expression and description!208630
-Ref: #two-spaces-between-period-expression-and-description208943
-Node: Forecasting with periodic transactions209627
-Ref: #forecasting-with-periodic-transactions209926
-Node: Budgeting with periodic transactions211981
-Ref: #budgeting-with-periodic-transactions212214
-Node: Auto postings212623
-Ref: #auto-postings212759
-Node: Auto postings and multiple files214938
-Ref: #auto-postings-and-multiple-files215136
-Node: Auto postings and dates215345
-Ref: #auto-postings-and-dates215613
-Node: Auto postings and transaction balancing / inferred amounts / balance assertions215788
-Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions216133
-Node: Auto posting tags216475
-Ref: #auto-posting-tags216684
-Node: CSV FORMAT217320
-Ref: #csv-format217448
-Node: Examples220034
-Ref: #examples220137
-Node: Basic220345
-Ref: #basic220447
-Node: Bank of Ireland220989
-Ref: #bank-of-ireland221126
-Node: Amazon222588
-Ref: #amazon222708
-Node: Paypal224427
-Ref: #paypal224523
-Node: CSV rules232167
-Ref: #csv-rules232285
-Node: skip232597
-Ref: #skip232692
-Node: fields233067
-Ref: #fields233191
-Node: Transaction field names234356
-Ref: #transaction-field-names234518
-Node: Posting field names234629
-Ref: #posting-field-names234783
-Node: field assignment237153
-Ref: #field-assignment237298
-Node: separator238116
-Ref: #separator238253
-Node: if block238793
-Ref: #if-block238920
-Node: Matching the whole record239321
-Ref: #matching-the-whole-record239498
-Node: Matching individual fields240302
-Ref: #matching-individual-fields240508
-Node: Combining matchers240732
-Ref: #combining-matchers240930
-Node: Rules applied on successful match241243
-Ref: #rules-applied-on-successful-match241436
-Node: if table242090
-Ref: #if-table242211
-Node: end243949
-Ref: #end244063
-Node: date-format244287
-Ref: #date-format244421
-Node: decimal-mark245170
-Ref: #decimal-mark245315
-Node: newest-first245654
-Ref: #newest-first245797
-Node: include246480
-Ref: #include246613
-Node: balance-type247057
-Ref: #balance-type247179
-Node: Tips247879
-Ref: #tips247970
-Node: Rapid feedback248226
-Ref: #rapid-feedback248345
-Node: Valid CSV248805
-Ref: #valid-csv248937
-Node: File Extension249129
-Ref: #file-extension249283
-Node: Reading multiple CSV files249712
-Ref: #reading-multiple-csv-files249899
-Node: Valid transactions250140
-Ref: #valid-transactions250320
-Node: Deduplicating importing250948
-Ref: #deduplicating-importing251129
-Node: Setting amounts252162
-Ref: #setting-amounts252333
-Node: Setting currency/commodity253320
-Ref: #setting-currencycommodity253514
-Node: Referencing other fields254688
-Ref: #referencing-other-fields254890
-Node: How CSV rules are evaluated255787
-Ref: #how-csv-rules-are-evaluated255962
-Node: TIMECLOCK FORMAT257413
-Ref: #timeclock-format257553
-Node: TIMEDOT FORMAT259614
-Ref: #timedot-format259752
-Node: COMMON TASKS264028
-Ref: #common-tasks264157
-Node: Getting help264564
-Ref: #getting-help264698
-Node: Constructing command lines265251
-Ref: #constructing-command-lines265445
-Node: Starting a journal file266142
-Ref: #starting-a-journal-file266342
-Node: Setting opening balances267530
-Ref: #setting-opening-balances267728
-Node: Recording transactions270869
-Ref: #recording-transactions271051
-Node: Reconciling271607
-Ref: #reconciling271752
-Node: Reporting274009
-Ref: #reporting274151
-Node: Migrating to a new file278150
-Ref: #migrating-to-a-new-file278300
-Node: LIMITATIONS278599
-Ref: #limitations278727
-Node: TROUBLESHOOTING279470
-Ref: #troubleshooting279585
+Node: Command options6394
+Ref: #command-options6545
+Node: Command arguments6945
+Ref: #command-arguments7103
+Node: Special characters7983
+Ref: #special-characters8146
+Node: Single escaping shell metacharacters8309
+Ref: #single-escaping-shell-metacharacters8550
+Node: Double escaping regular expression metacharacters8951
+Ref: #double-escaping-regular-expression-metacharacters9262
+Node: Triple escaping for add-on commands9788
+Ref: #triple-escaping-for-add-on-commands10048
+Node: Less escaping10692
+Ref: #less-escaping10846
+Node: Unicode characters11170
+Ref: #unicode-characters11335
+Node: Regular expressions12747
+Ref: #regular-expressions12887
+Node: ENVIRONMENT14623
+Ref: #environment14739
+Node: DATA FILES15724
+Ref: #data-files15843
+Node: Data formats16382
+Ref: #data-formats16500
+Node: Multiple files17837
+Ref: #multiple-files17979
+Node: Strict mode18448
+Ref: #strict-mode18563
+Node: TIME PERIODS19211
+Ref: #time-periods19328
+Node: Smart dates19426
+Ref: #smart-dates19552
+Node: Report start & end date20878
+Ref: #report-start-end-date21053
+Node: Report intervals22586
+Ref: #report-intervals22754
+Node: Period expressions23144
+Ref: #period-expressions23284
+Node: DEPTH27727
+Ref: #depth27827
+Node: QUERIES28159
+Ref: #queries28260
+Node: VALUATION32222
+Ref: #valuation32330
+Node: -B Cost33019
+Ref: #b-cost33117
+Node: -V Value33250
+Ref: #v-value33390
+Node: -X Value in specified commodity33585
+Ref: #x-value-in-specified-commodity33778
+Node: Valuation date33927
+Ref: #valuation-date34089
+Node: Market prices34526
+Ref: #market-prices34700
+Node: --infer-value market prices from transactions35621
+Ref: #infer-value-market-prices-from-transactions35864
+Node: Valuation commodity37125
+Ref: #valuation-commodity37328
+Node: Simple valuation examples38533
+Ref: #simple-valuation-examples38729
+Node: --value Flexible valuation39388
+Ref: #value-flexible-valuation39590
+Node: More valuation examples41537
+Ref: #more-valuation-examples41740
+Node: Effect of valuation on reports43745
+Ref: #effect-of-valuation-on-reports43927
+Node: PIVOTING50946
+Ref: #pivoting51051
+Node: OUTPUT52727
+Ref: #output52827
+Node: Output destination52878
+Ref: #output-destination53009
+Node: Output format53434
+Ref: #output-format53555
+Node: COMMANDS55722
+Ref: #commands55834
+Node: accounts59199
+Ref: #accounts59299
+Node: activity59995
+Ref: #activity60107
+Node: add60490
+Ref: #add60593
+Node: aregister63386
+Ref: #aregister63500
+Node: aregister and custom posting dates64994
+Ref: #aregister-and-custom-posting-dates65160
+Node: balance65981
+Ref: #balance66100
+Node: Classic balance report67723
+Ref: #classic-balance-report67898
+Node: Customising the classic balance report69222
+Ref: #customising-the-classic-balance-report69452
+Node: Colour support71528
+Ref: #colour-support71697
+Node: Flat mode71793
+Ref: #flat-mode71943
+Node: Depth limited balance reports72356
+Ref: #depth-limited-balance-reports72543
+Node: Percentages72999
+Ref: #percentages73158
+Node: Sorting by amount74295
+Ref: #sorting-by-amount74463
+Node: Multicolumn balance report74957
+Ref: #multicolumn-balance-report75145
+Node: Budget report80742
+Ref: #budget-report80878
+Node: Budget report start date86167
+Ref: #budget-report-start-date86334
+Node: Nested budgets87666
+Ref: #nested-budgets87813
+Node: balancesheet91253
+Ref: #balancesheet91391
+Node: balancesheetequity93028
+Ref: #balancesheetequity93179
+Node: cashflow94398
+Ref: #cashflow94522
+Node: check95856
+Ref: #check95961
+Node: Basic checks96566
+Ref: #basic-checks96684
+Node: Strict checks97177
+Ref: #strict-checks97318
+Node: Other checks97561
+Ref: #other-checks97701
+Node: Add-on checks97999
+Ref: #add-on-checks98119
+Node: close98572
+Ref: #close98676
+Node: close usage100198
+Ref: #close-usage100293
+Node: codes103106
+Ref: #codes103216
+Node: commodities103928
+Ref: #commodities104057
+Node: descriptions104139
+Ref: #descriptions104269
+Node: diff104573
+Ref: #diff104681
+Node: files105728
+Ref: #files105830
+Node: help105977
+Ref: #help106079
+Node: import106806
+Ref: #import106922
+Node: Importing balance assignments107844
+Ref: #importing-balance-assignments108027
+Node: Commodity display styles108676
+Ref: #commodity-display-styles108849
+Node: incomestatement108978
+Ref: #incomestatement109113
+Node: notes110575
+Ref: #notes110690
+Node: payees111058
+Ref: #payees111166
+Node: prices111586
+Ref: #prices111694
+Node: print112035
+Ref: #print112147
+Node: print-unique117632
+Ref: #print-unique117760
+Node: register118045
+Ref: #register118174
+Node: Custom register output122620
+Ref: #custom-register-output122751
+Node: register-match124088
+Ref: #register-match124224
+Node: rewrite124575
+Ref: #rewrite124692
+Node: Re-write rules in a file126598
+Ref: #re-write-rules-in-a-file126761
+Node: Diff output format127910
+Ref: #diff-output-format128093
+Node: rewrite vs print --auto129185
+Ref: #rewrite-vs.-print---auto129345
+Node: roi129901
+Ref: #roi130001
+Node: stats142211
+Ref: #stats142312
+Node: tags143100
+Ref: #tags143200
+Node: test143719
+Ref: #test143835
+Node: About add-on commands144582
+Ref: #about-add-on-commands144719
+Node: JOURNAL FORMAT145850
+Ref: #journal-format145978
+Node: Transactions148144
+Ref: #transactions148259
+Node: Dates149273
+Ref: #dates149389
+Node: Simple dates149454
+Ref: #simple-dates149574
+Node: Secondary dates150083
+Ref: #secondary-dates150231
+Node: Posting dates151567
+Ref: #posting-dates151690
+Node: Status153062
+Ref: #status153179
+Node: Description154887
+Ref: #description155017
+Node: Payee and note155337
+Ref: #payee-and-note155445
+Node: Comments155780
+Ref: #comments155902
+Node: Tags157096
+Ref: #tags-1157207
+Node: Postings158600
+Ref: #postings158724
+Node: Virtual postings159750
+Ref: #virtual-postings159861
+Node: Account names161166
+Ref: #account-names161303
+Node: Amounts161790
+Ref: #amounts161925
+Node: Digit group marks163049
+Ref: #digit-group-marks163194
+Node: Commodity display style164132
+Ref: #commodity-display-style164306
+Node: Rounding166019
+Ref: #rounding166137
+Node: Transaction prices166549
+Ref: #transaction-prices166715
+Node: Lot prices lot dates169146
+Ref: #lot-prices-lot-dates169329
+Node: Balance assertions169817
+Ref: #balance-assertions169995
+Node: Assertions and ordering171028
+Ref: #assertions-and-ordering171210
+Node: Assertions and included files171910
+Ref: #assertions-and-included-files172147
+Node: Assertions and multiple -f options172480
+Ref: #assertions-and-multiple--f-options172730
+Node: Assertions and commodities172862
+Ref: #assertions-and-commodities173088
+Node: Assertions and prices174245
+Ref: #assertions-and-prices174453
+Node: Assertions and subaccounts174893
+Ref: #assertions-and-subaccounts175116
+Node: Assertions and virtual postings175440
+Ref: #assertions-and-virtual-postings175676
+Node: Assertions and precision175818
+Ref: #assertions-and-precision176005
+Node: Balance assignments176272
+Ref: #balance-assignments176442
+Node: Balance assignments and prices177606
+Ref: #balance-assignments-and-prices177772
+Node: Directives177996
+Ref: #directives178159
+Node: Directives and multiple files183402
+Ref: #directives-and-multiple-files183598
+Node: Comment blocks184262
+Ref: #comment-blocks184439
+Node: Including other files184615
+Ref: #including-other-files184789
+Node: Default year185713
+Ref: #default-year185876
+Node: Declaring commodities186283
+Ref: #declaring-commodities186460
+Node: Commodity error checking188304
+Ref: #commodity-error-checking188454
+Node: Default commodity188711
+Ref: #default-commodity188891
+Node: Declaring market prices189780
+Ref: #declaring-market-prices189969
+Node: Declaring accounts190826
+Ref: #declaring-accounts191006
+Node: Account error checking192208
+Ref: #account-error-checking192374
+Node: Account comments193553
+Ref: #account-comments193737
+Node: Account subdirectives194161
+Ref: #account-subdirectives194346
+Node: Account types194659
+Ref: #account-types194833
+Node: Declaring account types195569
+Ref: #declaring-account-types195748
+Node: Auto-detected account types196398
+Ref: #auto-detected-account-types196639
+Node: Interference from auto-detected account types197536
+Ref: #interference-from-auto-detected-account-types197813
+Node: Old account type syntax198296
+Ref: #old-account-type-syntax198493
+Node: Account display order198793
+Ref: #account-display-order198953
+Node: Rewriting accounts200104
+Ref: #rewriting-accounts200283
+Node: Basic aliases201040
+Ref: #basic-aliases201176
+Node: Regex aliases201880
+Ref: #regex-aliases202042
+Node: Combining aliases202761
+Ref: #combining-aliases202944
+Node: Aliases and multiple files204220
+Ref: #aliases-and-multiple-files204419
+Node: end aliases204998
+Ref: #end-aliases205145
+Node: Default parent account205246
+Ref: #default-parent-account205436
+Node: Periodic transactions206320
+Ref: #periodic-transactions206503
+Node: Periodic rule syntax208420
+Ref: #periodic-rule-syntax208620
+Node: Two spaces between period expression and description!209324
+Ref: #two-spaces-between-period-expression-and-description209637
+Node: Forecasting with periodic transactions210321
+Ref: #forecasting-with-periodic-transactions210620
+Node: Budgeting with periodic transactions212675
+Ref: #budgeting-with-periodic-transactions212908
+Node: Auto postings213317
+Ref: #auto-postings213453
+Node: Auto postings and multiple files215632
+Ref: #auto-postings-and-multiple-files215830
+Node: Auto postings and dates216039
+Ref: #auto-postings-and-dates216307
+Node: Auto postings and transaction balancing / inferred amounts / balance assertions216482
+Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions216827
+Node: Auto posting tags217169
+Ref: #auto-posting-tags217378
+Node: CSV FORMAT218014
+Ref: #csv-format218142
+Node: Examples220728
+Ref: #examples220831
+Node: Basic221039
+Ref: #basic221141
+Node: Bank of Ireland221683
+Ref: #bank-of-ireland221820
+Node: Amazon223282
+Ref: #amazon223402
+Node: Paypal225121
+Ref: #paypal225217
+Node: CSV rules232861
+Ref: #csv-rules232979
+Node: skip233291
+Ref: #skip233386
+Node: fields233761
+Ref: #fields233885
+Node: Transaction field names235050
+Ref: #transaction-field-names235212
+Node: Posting field names235323
+Ref: #posting-field-names235477
+Node: field assignment237847
+Ref: #field-assignment237992
+Node: separator238810
+Ref: #separator238947
+Node: if block239487
+Ref: #if-block239614
+Node: Matching the whole record240015
+Ref: #matching-the-whole-record240192
+Node: Matching individual fields240996
+Ref: #matching-individual-fields241202
+Node: Combining matchers241426
+Ref: #combining-matchers241624
+Node: Rules applied on successful match241937
+Ref: #rules-applied-on-successful-match242130
+Node: if table242784
+Ref: #if-table242905
+Node: end244643
+Ref: #end244757
+Node: date-format244981
+Ref: #date-format245115
+Node: decimal-mark245864
+Ref: #decimal-mark246009
+Node: newest-first246348
+Ref: #newest-first246491
+Node: include247174
+Ref: #include247307
+Node: balance-type247751
+Ref: #balance-type247873
+Node: Tips248573
+Ref: #tips248664
+Node: Rapid feedback248920
+Ref: #rapid-feedback249039
+Node: Valid CSV249499
+Ref: #valid-csv249631
+Node: File Extension249823
+Ref: #file-extension249977
+Node: Reading multiple CSV files250406
+Ref: #reading-multiple-csv-files250593
+Node: Valid transactions250834
+Ref: #valid-transactions251014
+Node: Deduplicating importing251642
+Ref: #deduplicating-importing251823
+Node: Setting amounts252856
+Ref: #setting-amounts253027
+Node: Setting currency/commodity254014
+Ref: #setting-currencycommodity254208
+Node: Referencing other fields255382
+Ref: #referencing-other-fields255584
+Node: How CSV rules are evaluated256481
+Ref: #how-csv-rules-are-evaluated256656
+Node: TIMECLOCK FORMAT258107
+Ref: #timeclock-format258247
+Node: TIMEDOT FORMAT260308
+Ref: #timedot-format260446
+Node: COMMON TASKS264722
+Ref: #common-tasks264851
+Node: Getting help265258
+Ref: #getting-help265392
+Node: Constructing command lines265945
+Ref: #constructing-command-lines266139
+Node: Starting a journal file266836
+Ref: #starting-a-journal-file267036
+Node: Setting opening balances268224
+Ref: #setting-opening-balances268422
+Node: Recording transactions271563
+Ref: #recording-transactions271745
+Node: Reconciling272301
+Ref: #reconciling272446
+Node: Reporting274703
+Ref: #reporting274845
+Node: Migrating to a new file278844
+Ref: #migrating-to-a-new-file278994
+Node: LIMITATIONS279293
+Ref: #limitations279421
+Node: TROUBLESHOOTING280164
+Ref: #troubleshooting280279
 
 End Tag Table

hledger/hledger.txt

@@ -70,7 +70,7 @@ OPTIONS
        --info show general or COMMAND user manual with info
 
        --version
-              show general or ADDONCOMMAND version
+              show general or ADDONCMD version
 
        --debug[=N]
               show debug output (levels 1-9, default: 1)
@@ -2715,12 +2715,10 @@ COMMANDS
        Show transaction journal entries, sorted by date.
 
        The print command displays full journal entries (transactions) from the
-       journal file in date order, tidily formatted.  With  --date2,  transac-
-       tions are sorted by secondary date instead.
-
-       print's output is always a valid hledger journal.
-       It  preserves all transaction information, but it does not preserve di-
-       rectives or inter-transaction comments
+       journal file, sorted by date (or  with  --date2,  by  secondary  date).
+       Amounts are shown right-aligned within each transaction (but not across
+       all transactions).  Directives and inter-transaction comments  are  not
+       shown.  Eg:
 
               $ hledger print
               2008/01/01 income
@@ -2744,6 +2742,24 @@ COMMANDS
                   liabilities:debts               $1
                   assets:bank:checking           $-1
 
+       print's  output is usually a valid hledger journal, and you can process
+       it again with a second hledger command.  This can be useful for certain
+       kinds of search, eg:
+
+              # Show running total of food expenses paid from cash.
+              # -f- reads from stdin. -I/--ignore-assertions is sometimes needed.
+              $ hledger print assets:cash | hledger -f- -I reg expenses:food
+
+       There are some situations where print's output can become unparseable:
+
+       o Rounding  amounts  according  to  commodity  display styles can cause
+         transactions to appear unbalanced.
+
+       o Valuation affects posting amounts but not balance assertion  or  bal-
+         ance assignment amounts, potentially causing those to fail.
+
+       o Auto postings can generate postings with too many missing amounts.
+
        Normally, the journal entry's explicit or implicit amount style is pre-
        served.  For example, when an amount is omitted in the journal, it will
        not  appear  in the output.  Similarly, when a transaction price is im-
@@ -4198,6 +4214,8 @@ JOURNAL FORMAT
        dis-     how to display amounts of a commodity in  reports  (symbol  side
        play     and spacing, digit groups, decimal separator, decimal places)
        style
+
+
        direc-   which  entries  and  (when there are multiple files) which files
        tive     are affected by a directive
        scope
@@ -5017,6 +5035,8 @@ CSV FORMAT
                                         by patterns, alternate syntax
        end                              skip the remaining CSV records
        date-format                      how to parse dates in CSV records
+
+
        decimal-mark                     the decimal mark used in CSV amounts, if
                                         ambiguous
        newest-first                     disambiguate record order  when  there's