doc: regen manuals

hledger-lib/hledger_journal.5

@@ -602,8 +602,21 @@ One workaround is to isolate each commodity into its own subaccount:
 .fi
 .SS Assertions and prices
 .PP
-Balance assertion (or assignment) amounts should not have a price, as
+Balance assertions ignore transaction prices, and should normally be
-the meaning of that would be unclear.
+written without one:
+.IP
+.nf
+\f[C]
+2019/1/1
+\ \ (a)\ \ \ \ \ $1\ \@\ €1\ =\ $1
+\f[]
+.fi
+.PP
+We do allow prices to be written there, however, and print shows them,
+even though they don\[aq]t affect whether the assertion passes or fails.
+This is for backward compatibility (hledger\[aq]s close command used to
+generate balance assertions with prices), and because balance
+\f[I]assignments\f[] do use them (see below).
 .SS Assertions and subaccounts
 .PP
 Balance assertions do not count the balance from subaccounts; they check
@@ -682,6 +695,25 @@ assignment).
 Note that using balance assignments makes your journal a little less
 explicit; to know the exact amount posted, you have to run hledger or do
 the calculations yourself, instead of just reading it.
+.SS Balance assignments and prices
+.PP
+A transaction price in a balance assignment will cause the calculated
+amount to have that price attached:
+.IP
+.nf
+\f[C]
+2019/1/1
+\ \ (a)\ \ \ \ \ \ \ \ \ \ \ \ \ =\ $1\ \@\ €2
+\f[]
+.fi
+.IP
+.nf
+\f[C]
+$\ hledger\ print\ \-\-explicit
+2019/01/01
+\ \ \ \ (a)\ \ \ \ \ \ \ \ \ $1\ \@\ €2\ =\ $1\ \@\ €2
+\f[]
+.fi
 .SS Transaction prices
 .PP
 Within a transaction, you can note an amount\[aq]s price in another

hledger-lib/hledger_journal.info

@@ -573,8 +573,17 @@ File: hledger_journal.info,  Node: Assertions and prices,  Next: Assertions and
 1.9.5 Assertions and prices
 ---------------------------
 
-Balance assertion (or assignment) amounts should not have a price, as
+Balance assertions ignore transaction prices, and should normally be
-the meaning of that would be unclear.
+written without one:
+
+2019/1/1
+  (a)     $1 @ €1 = $1
+
+   We do allow prices to be written there, however, and print shows
+them, even though they don't affect whether the assertion passes or
+fails.  This is for backward compatibility (hledger's close command used
+to generate balance assertions with prices), and because balance
+_assignments_ do use them (see below).
 
 
 File: hledger_journal.info,  Node: Assertions and subaccounts,  Next: Assertions and virtual postings,  Prev: Assertions and prices,  Up: Balance Assertions
@@ -652,6 +661,25 @@ of the commodity to that account since the last balance assertion or
 assignment).  Note that using balance assignments makes your journal a
 little less explicit; to know the exact amount posted, you have to run
 hledger or do the calculations yourself, instead of just reading it.
+* Menu:
+
+* Balance assignments and prices::
+
+
+File: hledger_journal.info,  Node: Balance assignments and prices,  Up: Balance Assignments
+
+1.10.1 Balance assignments and prices
+-------------------------------------
+
+A transaction price in a balance assignment will cause the calculated
+amount to have that price attached:
+
+2019/1/1
+  (a)             = $1 @ €2
+
+$ hledger print --explicit
+2019/01/01
+    (a)         $1 @ €2 = $1 @ €2
 
 
 File: hledger_journal.info,  Node: Transaction prices,  Next: Comments,  Prev: Balance Assignments,  Up: FILE FORMAT
@@ -1597,67 +1625,69 @@ Node: Assertions and commodities19383
 Ref: #assertions-and-commodities19613
 Node: Assertions and prices20801
 Ref: #assertions-and-prices21013
-Node: Assertions and subaccounts21122
+Node: Assertions and subaccounts21453
-Ref: #assertions-and-subaccounts21349
+Ref: #assertions-and-subaccounts21680
-Node: Assertions and virtual postings21870
+Node: Assertions and virtual postings22201
-Ref: #assertions-and-virtual-postings22110
+Ref: #assertions-and-virtual-postings22441
-Node: Assertions and precision22252
+Node: Assertions and precision22583
-Ref: #assertions-and-precision22443
+Ref: #assertions-and-precision22774
-Node: Balance Assignments22710
+Node: Balance Assignments23041
-Ref: #balance-assignments22891
+Ref: #balance-assignments23222
-Node: Transaction prices24011
+Node: Balance assignments and prices24386
-Ref: #transaction-prices24180
+Ref: #balance-assignments-and-prices24558
-Node: Comments26448
+Node: Transaction prices24782
-Ref: #comments26582
+Ref: #transaction-prices24951
-Node: Tags27752
+Node: Comments27219
-Ref: #tags27870
+Ref: #comments27353
-Node: Directives29272
+Node: Tags28523
-Ref: #directives29415
+Ref: #tags28641
-Node: Comment blocks35022
+Node: Directives30043
-Ref: #comment-blocks35167
+Ref: #directives30186
-Node: Including other files35343
+Node: Comment blocks35793
-Ref: #including-other-files35523
+Ref: #comment-blocks35938
-Node: Default year35931
+Node: Including other files36114
-Ref: #default-year36100
+Ref: #including-other-files36294
-Node: Declaring commodities36523
+Node: Default year36702
-Ref: #declaring-commodities36706
+Ref: #default-year36871
-Node: Default commodity37933
+Node: Declaring commodities37294
-Ref: #default-commodity38109
+Ref: #declaring-commodities37477
-Node: Market prices38745
+Node: Default commodity38704
-Ref: #market-prices38910
+Ref: #default-commodity38880
-Node: Declaring accounts39751
+Node: Market prices39516
-Ref: #declaring-accounts39927
+Ref: #market-prices39681
-Node: Account comments40852
+Node: Declaring accounts40522
-Ref: #account-comments41015
+Ref: #declaring-accounts40698
-Node: Account subdirectives41410
+Node: Account comments41623
-Ref: #account-subdirectives41605
+Ref: #account-comments41786
-Node: Account types41918
+Node: Account subdirectives42181
-Ref: #account-types42102
+Ref: #account-subdirectives42376
-Node: Account display order43746
+Node: Account types42689
-Ref: #account-display-order43916
+Ref: #account-types42873
-Node: Rewriting accounts45045
+Node: Account display order44517
-Ref: #rewriting-accounts45230
+Ref: #account-display-order44687
-Node: Basic aliases45964
+Node: Rewriting accounts45816
-Ref: #basic-aliases46110
+Ref: #rewriting-accounts46001
-Node: Regex aliases46814
+Node: Basic aliases46735
-Ref: #regex-aliases46985
+Ref: #basic-aliases46881
-Node: Multiple aliases47703
+Node: Regex aliases47585
-Ref: #multiple-aliases47878
+Ref: #regex-aliases47756
-Node: end aliases48376
+Node: Multiple aliases48474
-Ref: #end-aliases48523
+Ref: #multiple-aliases48649
-Node: Default parent account48624
+Node: end aliases49147
-Ref: #default-parent-account48790
+Ref: #end-aliases49294
-Node: Periodic transactions49674
+Node: Default parent account49395
-Ref: #periodic-transactions49856
+Ref: #default-parent-account49561
-Node: Two spaces after the period expression50981
+Node: Periodic transactions50445
-Ref: #two-spaces-after-the-period-expression51226
+Ref: #periodic-transactions50627
-Node: Forecasting with periodic transactions51711
+Node: Two spaces after the period expression51752
-Ref: #forecasting-with-periodic-transactions52001
+Ref: #two-spaces-after-the-period-expression51997
-Node: Budgeting with periodic transactions53688
+Node: Forecasting with periodic transactions52482
-Ref: #budgeting-with-periodic-transactions53927
+Ref: #forecasting-with-periodic-transactions52772
-Node: Transaction Modifiers54386
+Node: Budgeting with periodic transactions54459
-Ref: #transaction-modifiers54549
+Ref: #budgeting-with-periodic-transactions54698
-Node: EDITOR SUPPORT56530
+Node: Transaction Modifiers55157
-Ref: #editor-support56648
+Ref: #transaction-modifiers55320
+Node: EDITOR SUPPORT57301
+Ref: #editor-support57419
 
 End Tag Table

hledger-lib/hledger_journal.txt

@@ -447,8 +447,17 @@ FILE FORMAT
                 a:euro   0 ==  1
 
    Assertions and prices
-       Balance assertion (or assignment) amounts should not have a  price,  as
+       Balance assertions ignore transaction prices, and  should  normally  be
-       the meaning of that would be unclear.
+       written without one:
+
+              2019/1/1
+                (a)     $1 @ 1 = $1
+
+       We  do allow prices to be written there, however, and print shows them,
+       even though they don't affect whether the assertion  passes  or  fails.
+       This  is  for  backward  compatibility (hledger's close command used to
+       generate balance assertions with prices), and because  balance  assign-
+       ments do use them (see below).
 
    Assertions and subaccounts
        Balance  assertions  do  not  count  the balance from subaccounts; they
@@ -506,6 +515,17 @@ FILE FORMAT
        less explicit; to know the exact amount posted, you have to run hledger
        or do the calculations yourself, instead of just reading it.
 
+   Balance assignments and prices
+       A transaction price in a balance assignment will cause  the  calculated
+       amount to have that price attached:
+
+              2019/1/1
+                (a)             = $1 @ 2
+
+              $ hledger print --explicit
+              2019/01/01
+                  (a)         $1 @ 2 = $1 @ 2
+
    Transaction prices
        Within a transaction, you can note an amount's price in another commod-
        ity.  This can be used to document the cost (in a purchase) or  selling
@@ -650,6 +670,9 @@ FILE FORMAT
        links to more detailed docs.
 
 
+
+
+
        direc-          end                 subdi-    purpose                        can  affect  (as of
        tive            directive           rec-                                     2018/06)
                                            tives
@@ -679,8 +702,6 @@ FILE FORMAT
                                                                                     play style: amounts
                                                                                     of  that  commodity
                                                                                     in reports
-
-
        D                                             declare  a commodity, number   commodity: all com-
                                                      notation & display style for   modityless  entries
                                                      commodityless amounts          in  all files; num-

hledger-ui/hledger-ui.1

@@ -424,7 +424,7 @@ Similarly, \f[C]P\f[] toggles pending transactions, and \f[C]C\f[]
 toggles cleared transactions.
 (By default, transactions with all statuses are shown; if you activate
 one or two status filters, only those transactions are shown; and if you
-activate all three, the filter is removed.)q
+activate all three, the filter is removed.)
 .PP
 \f[C]R\f[] toggles real mode, in which virtual postings are ignored.
 .PP

hledger-ui/hledger-ui.info

@@ -349,7 +349,7 @@ transactions.  Similarly, 'P' toggles pending transactions, and 'C'
 toggles cleared transactions.  (By default, transactions with all
 statuses are shown; if you activate one or two status filters, only
 those transactions are shown; and if you activate all three, the filter
-is removed.)q
+is removed.)
 
    'R' toggles real mode, in which virtual postings are ignored.
 
@@ -408,9 +408,9 @@ Node: Accounts screen8148
 Ref: #accounts-screen8276
 Node: Register screen10492
 Ref: #register-screen10647
-Node: Transaction screen12644
+Node: Transaction screen12643
-Ref: #transaction-screen12802
+Ref: #transaction-screen12801
-Node: Error screen13672
+Node: Error screen13671
-Ref: #error-screen13794
+Ref: #error-screen13793
 
 End Tag Table

hledger-ui/hledger-ui.txt

@@ -314,8 +314,7 @@ SCREENS
        transactions.  Similarly, P toggles pending transactions, and C toggles
        cleared transactions.  (By default, transactions with all statuses  are
        shown;  if  you activate one or two status filters, only those transac-
-       tions are  shown;  and  if  you  activate  all  three,  the  filter  is
+       tions are shown; and if you activate all three, the filter is removed.)
-       removed.)q
 
        R toggles real mode, in which virtual postings are ignored.
 

hledger/hledger.1

@@ -1639,11 +1639,6 @@ show performance compared to budget goals defined by periodic
 transactions
 .RS
 .RE
-.TP
-.B \f[C]\-\-show\-unbudgeted\f[]
-with \-\-budget, show unbudgeted accounts also
-.RS
-.RE
 .PP
 The balance command is hledger\[aq]s most versatile command.
 Note, despite the name, it is not always used for showing real\-world
@@ -1934,6 +1929,8 @@ Second, all accounts which existed at the report start date will be
 considered, not just the ones with activity during the report period
 (use \-E to include low\-activity accounts which would otherwise would
 be omitted).
+With \f[C]\-\-budget\f[], \f[C]\-\-empty\f[] also shows unbudgeted
+accounts.
 .PP
 The \f[C]\-T/\-\-row\-total\f[] flag adds an additional column showing
 the total for each row.
@@ -2040,12 +2037,11 @@ In the example above, transactions in \f[C]expenses:gifts\f[] and
 but accounts \f[C]expenses:gifts\f[] and \f[C]expenses:supplies\f[] are
 not shown, as they don\[aq]t have any budgets.
 .PP
-You can use \f[C]\-\-show\-unbudgeted\f[] shows unbudgeted accounts as
+You can use \f[C]\-\-empty\f[] shows unbudgeted accounts as well:
-well:
 .IP
 .nf
 \f[C]
-$\ hledger\ balance\ \-M\ \-\-budget\ \-\-show\-unbudgeted
+$\ hledger\ balance\ \-M\ \-\-budget\ \-\-empty
 Budget\ performance\ in\ 2017/11/01\-2017/12/31:
 
 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ ||\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ Nov\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ Dec\ 
@@ -2174,12 +2170,12 @@ Budget\ performance\ in\ 2019/01:
 \f[]
 .fi
 .PP
-And with \f[C]\-\-show\-unbudgeted\f[], we can get a better picture of
+And with \f[C]\-\-empty\f[], we can get a better picture of budget
-budget allocation and consumption:
+allocation and consumption:
 .IP
 .nf
 \f[C]
-$\ hledger\ balance\ \-\-budget\ \-M\ \-\-show\-unbudgeted
+$\ hledger\ balance\ \-\-budget\ \-M\ \-\-empty
 Budget\ performance\ in\ 2019/01:
 
 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ ||\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ Jan\ 

hledger/hledger.info

@@ -1243,9 +1243,6 @@ Show accounts and their balances.  Aliases: b, bal.
 
      show performance compared to budget goals defined by periodic
      transactions
-'--show-unbudgeted'
-
-     with -budget, show unbudgeted accounts also
 
    The balance command is hledger's most versatile command.  Note,
 despite the name, it is not always used for showing real-world account
@@ -1510,7 +1507,8 @@ period (without -E, leading and trailing columns with all zeroes are not
 shown).  Second, all accounts which existed at the report start date
 will be considered, not just the ones with activity during the report
 period (use -E to include low-activity accounts which would otherwise
-would be omitted).
+would be omitted).  With '--budget', '--empty' also shows unbudgeted
+accounts.
 
    The '-T/--row-total' flag adds an additional column showing the total
 for each row.
@@ -1608,9 +1606,9 @@ are shown.  In the example above, transactions in 'expenses:gifts' and
 'expenses:gifts' and 'expenses:supplies' are not shown, as they don't
 have any budgets.
 
-   You can use '--show-unbudgeted' shows unbudgeted accounts as well:
+   You can use '--empty' shows unbudgeted accounts as well:
 
-$ hledger balance -M --budget --show-unbudgeted
+$ hledger balance -M --budget --empty
 Budget performance in 2017/11/01-2017/12/31:
 
                       ||                      Nov                       Dec 
@@ -1725,10 +1723,10 @@ Budget performance in 2019/01:
 -------------------------------++-------------------------------
                                ||        0 [                 0] 
 
-   And with '--show-unbudgeted', we can get a better picture of budget
+   And with '--empty', we can get a better picture of budget allocation
-allocation and consumption:
+and consumption:
 
-$ hledger balance --budget -M --show-unbudgeted
+$ hledger balance --budget -M --empty
 Budget performance in 2019/01:
 
                                         ||                           Jan 
@@ -2808,92 +2806,92 @@ Node: add35465
 Ref: #add35564
 Node: balance38225
 Ref: #balance38336
-Node: Classic balance report41526
+Node: Classic balance report41456
-Ref: #classic-balance-report41699
+Ref: #classic-balance-report41629
-Node: Customising the classic balance report43068
+Node: Customising the classic balance report42998
-Ref: #customising-the-classic-balance-report43296
+Ref: #customising-the-classic-balance-report43226
-Node: Colour support45370
+Node: Colour support45300
-Ref: #colour-support45537
+Ref: #colour-support45467
-Node: Flat mode45710
+Node: Flat mode45640
-Ref: #flat-mode45858
+Ref: #flat-mode45788
-Node: Depth limited balance reports46271
+Node: Depth limited balance reports46201
-Ref: #depth-limited-balance-reports46471
+Ref: #depth-limited-balance-reports46401
-Node: Multicolumn balance report46927
+Node: Multicolumn balance report46857
-Ref: #multicolumn-balance-report47125
+Ref: #multicolumn-balance-report47055
-Node: Budget report52305
+Node: Budget report52295
-Ref: #budget-report52448
+Ref: #budget-report52438
-Node: Nested budgets57152
+Node: Nested budgets57122
-Ref: #nested-budgets57264
+Ref: #nested-budgets57234
-Ref: #output-format-160764
+Ref: #output-format-160714
-Node: balancesheet60842
+Node: balancesheet60792
-Ref: #balancesheet60978
+Ref: #balancesheet60928
-Node: balancesheetequity63289
+Node: balancesheetequity63239
-Ref: #balancesheetequity63438
+Ref: #balancesheetequity63388
-Node: cashflow63975
+Node: cashflow63925
-Ref: #cashflow64103
+Ref: #cashflow64053
-Node: check-dates66226
+Node: check-dates66176
-Ref: #check-dates66353
+Ref: #check-dates66303
-Node: check-dupes66470
+Node: check-dupes66420
-Ref: #check-dupes66594
+Ref: #check-dupes66544
-Node: close66731
+Node: close66681
-Ref: #close66839
+Ref: #close66789
-Node: files70253
+Node: files70203
-Ref: #files70354
+Ref: #files70304
-Node: help70495
+Node: help70445
-Ref: #help70595
+Ref: #help70545
-Node: import71669
+Node: import71619
-Ref: #import71783
+Ref: #import71733
-Node: incomestatement72513
+Node: incomestatement72463
-Ref: #incomestatement72647
+Ref: #incomestatement72597
-Node: prices75051
+Node: prices75001
-Ref: #prices75166
+Ref: #prices75116
-Node: print75438
+Node: print75388
-Ref: #print75548
+Ref: #print75498
-Node: print-unique80442
+Node: print-unique80392
-Ref: #print-unique80568
+Ref: #print-unique80518
-Node: register80636
+Node: register80586
-Ref: #register80763
+Ref: #register80713
-Node: Custom register output85264
+Node: Custom register output85214
-Ref: #custom-register-output85393
+Ref: #custom-register-output85343
-Node: register-match86623
+Node: register-match86573
-Ref: #register-match86757
+Ref: #register-match86707
-Node: rewrite86940
+Node: rewrite86890
-Ref: #rewrite87055
+Ref: #rewrite87005
-Node: roi87124
+Node: roi87074
-Ref: #roi87222
+Ref: #roi87172
-Node: stats87338
+Node: stats87288
-Ref: #stats87437
+Ref: #stats87387
-Node: tags88307
+Node: tags88257
-Ref: #tags88405
+Ref: #tags88355
-Node: test88641
+Node: test88591
-Ref: #test88725
+Ref: #test88675
-Node: ADD-ON COMMANDS89433
+Node: ADD-ON COMMANDS89383
-Ref: #add-on-commands89543
+Ref: #add-on-commands89493
-Node: Official add-ons90830
+Node: Official add-ons90780
-Ref: #official-add-ons90970
+Ref: #official-add-ons90920
-Node: api91057
+Node: api91007
-Ref: #api91146
+Ref: #api91096
-Node: ui91198
+Node: ui91148
-Ref: #ui91297
+Ref: #ui91247
-Node: web91355
+Node: web91305
-Ref: #web91444
+Ref: #web91394
-Node: Third party add-ons91490
+Node: Third party add-ons91440
-Ref: #third-party-add-ons91665
+Ref: #third-party-add-ons91615
-Node: diff91800
+Node: diff91750
-Ref: #diff91897
+Ref: #diff91847
-Node: iadd91996
+Node: iadd91946
-Ref: #iadd92110
+Ref: #iadd92060
-Node: interest92193
+Node: interest92143
-Ref: #interest92314
+Ref: #interest92264
-Node: irr92409
+Node: irr92359
-Ref: #irr92507
+Ref: #irr92457
-Node: Experimental add-ons92638
+Node: Experimental add-ons92588
-Ref: #experimental-add-ons92790
+Ref: #experimental-add-ons92740
-Node: autosync93070
+Node: autosync93020
-Ref: #autosync93181
+Ref: #autosync93131
-Node: chart93420
+Node: chart93370
-Ref: #chart93539
+Ref: #chart93489
-Node: check93610
+Node: check93560
-Ref: #check93712
+Ref: #check93662
 
 End Tag Table

hledger/hledger.txt

@@ -1111,9 +1111,6 @@ COMMANDS
               show performance compared to budget goals  defined  by  periodic
               transactions
 
-       --show-unbudgeted
-              with --budget, show unbudgeted accounts also
-
        The balance command is hledger's most versatile command.  Note, despite
        the name, it is not always used for  showing  real-world  account  bal-
        ances;  the  more accounting-aware balancesheet and incomestatement may
@@ -1348,7 +1345,8 @@ COMMANDS
        not shown).  Second, all accounts which existed  at  the  report  start
        date  will  be  considered,  not just the ones with activity during the
        report period (use -E to include low-activity accounts which would oth-
-       erwise would be omitted).
+       erwise would be omitted).  With --budget, --empty also shows unbudgeted
+       accounts.
 
        The -T/--row-total flag adds an additional column showing the total for
        each row.
@@ -1441,9 +1439,9 @@ COMMANDS
        expenses:gifts  and expenses:supplies are not shown, as they don't have
        any budgets.
 
-       You can use --show-unbudgeted shows unbudgeted accounts as well:
+       You can use --empty shows unbudgeted accounts as well:
 
-              $ hledger balance -M --budget --show-unbudgeted
+              $ hledger balance -M --budget --empty
               Budget performance in 2017/11/01-2017/12/31:
 
                                     ||                      Nov                       Dec
@@ -1550,10 +1548,10 @@ COMMANDS
               -------------------------------++-------------------------------
                                              ||        0 [                 0]
 
-       And with --show-unbudgeted, we can get a better picture of budget allo-
+       And with --empty, we can get a better picture of budget allocation  and
-       cation and consumption:
+       consumption:
 
-              $ hledger balance --budget -M --show-unbudgeted
+              $ hledger balance --budget -M --empty
               Budget performance in 2019/01:
 
                                                       ||                           Jan