;update manuals

hledger-lib/hledger_journal.5

@@ -585,9 +585,9 @@ commodity       1 000 000.9455
 .PP
 .SS Commodity display style
 .PP
-For each commodity, hledger chooses a consistent style to use when
+For the amounts in each commodity, hledger chooses a consistent display
-displaying amounts.
+style.
-(Except price amounts, which are always displayed as written).
+(Excluding price amounts, which are always displayed as written).
 The display style is chosen as follows:
 .IP \[bu] 2
 If there is a commodity directive (or default commodity directive) for
@@ -623,9 +623,19 @@ or, the style of the first posting amount in the journal, with the
 first-seen digit group style and the maximum-seen number of decimal
 places.
 .PP
-If reports are showing amounts in a way you don\[aq]t like (eg, with too
+So if your reports are showing amounts in a way you don\[aq]t like, eg
-many decimal places), use a commodity directive to set your preferred
+with too many decimal places, use a commodity directive to set the
-style.
+commodity\[aq]s display style.
+For example:
+.IP
+.nf
+\f[C]
+# declare euro, dollar and bitcoin commodities and set their display styles:
+commodity EUR 1.000,
+commodity $1000.00
+commodity 1000.00000000 BTC
+\f[R]
+.fi
 .SS Rounding
 .PP
 Amounts are stored internally as decimal numbers with up to 255 decimal

hledger-lib/hledger_journal.info

@@ -526,9 +526,9 @@ File: hledger_journal.info,  Node: Commodity display style,  Next: Rounding,  Pr
 9.2 Commodity display style
 ===========================
 
-For each commodity, hledger chooses a consistent style to use when
+For the amounts in each commodity, hledger chooses a consistent display
-displaying amounts.  (Except price amounts, which are always displayed
+style.  (Excluding price amounts, which are always displayed as
-as written).  The display style is chosen as follows:
+written).  The display style is chosen as follows:
 
    * If there is a commodity directive (or default commodity directive)
      for the commodity, its style is used (see examples above).
@@ -561,9 +561,14 @@ style.
      first-seen digit group style and the maximum-seen number of decimal
      places.
 
-   If reports are showing amounts in a way you don't like (eg, with too
+   So if your reports are showing amounts in a way you don't like, eg
-many decimal places), use a commodity directive to set your preferred
+with too many decimal places, use a commodity directive to set the
-style.
+commodity's display style.  For example:
+
+# declare euro, dollar and bitcoin commodities and set their display styles:
+commodity EUR 1.000,
+commodity $1000.00
+commodity 1000.00000000 BTC
 
 
 File: hledger_journal.info,  Node: Rounding,  Prev: Commodity display style,  Up: AMOUNTS
@@ -1996,105 +2001,105 @@ Node: Digit group marks16957
 Ref: #digit-group-marks17104
 Node: Commodity display style18042
 Ref: #commodity-display-style18218
-Node: Rounding19761
+Node: Rounding19931
-Ref: #rounding19881
+Ref: #rounding20051
-Node: TRANSACTION PRICES20293
+Node: TRANSACTION PRICES20463
-Ref: #transaction-prices20450
+Ref: #transaction-prices20620
-Node: LOT PRICES LOT DATES22881
+Node: LOT PRICES LOT DATES23051
-Ref: #lot-prices-lot-dates23055
+Ref: #lot-prices-lot-dates23225
-Node: BALANCE ASSERTIONS23543
+Node: BALANCE ASSERTIONS23713
-Ref: #balance-assertions23712
+Ref: #balance-assertions23882
-Node: Assertions and ordering24745
+Node: Assertions and ordering24915
-Ref: #assertions-and-ordering24929
+Ref: #assertions-and-ordering25099
-Node: Assertions and included files25629
+Node: Assertions and included files25799
-Ref: #assertions-and-included-files25868
+Ref: #assertions-and-included-files26038
-Node: Assertions and multiple -f options26201
+Node: Assertions and multiple -f options26371
-Ref: #assertions-and-multiple--f-options26453
+Ref: #assertions-and-multiple--f-options26623
-Node: Assertions and commodities26585
+Node: Assertions and commodities26755
-Ref: #assertions-and-commodities26813
+Ref: #assertions-and-commodities26983
-Node: Assertions and prices27970
+Node: Assertions and prices28140
-Ref: #assertions-and-prices28180
+Ref: #assertions-and-prices28350
-Node: Assertions and subaccounts28620
+Node: Assertions and subaccounts28790
-Ref: #assertions-and-subaccounts28845
+Ref: #assertions-and-subaccounts29015
-Node: Assertions and virtual postings29169
+Node: Assertions and virtual postings29339
-Ref: #assertions-and-virtual-postings29407
+Ref: #assertions-and-virtual-postings29577
-Node: Assertions and precision29549
+Node: Assertions and precision29719
-Ref: #assertions-and-precision29738
+Ref: #assertions-and-precision29908
-Node: BALANCE ASSIGNMENTS30005
+Node: BALANCE ASSIGNMENTS30175
-Ref: #balance-assignments30166
+Ref: #balance-assignments30336
-Node: Balance assignments and prices31330
+Node: Balance assignments and prices31500
-Ref: #balance-assignments-and-prices31498
+Ref: #balance-assignments-and-prices31668
-Node: DIRECTIVES31722
+Node: DIRECTIVES31892
-Ref: #directives31868
+Ref: #directives32038
-Node: Directives and multiple files37366
+Node: Directives and multiple files37536
-Ref: #directives-and-multiple-files37545
+Ref: #directives-and-multiple-files37715
-Node: Comment blocks38209
+Node: Comment blocks38379
-Ref: #comment-blocks38388
+Ref: #comment-blocks38558
-Node: Including other files38564
+Node: Including other files38734
-Ref: #including-other-files38740
+Ref: #including-other-files38910
-Node: Default year39664
+Node: Default year39834
-Ref: #default-year39829
+Ref: #default-year39999
-Node: Declaring commodities40236
+Node: Declaring commodities40406
-Ref: #declaring-commodities40415
+Ref: #declaring-commodities40585
-Node: Commodity error checking42259
+Node: Commodity error checking42429
-Ref: #commodity-error-checking42415
+Ref: #commodity-error-checking42585
-Node: Default commodity42672
+Node: Default commodity42842
-Ref: #default-commodity42854
+Ref: #default-commodity43024
-Node: Declaring market prices43743
+Node: Declaring market prices43913
-Ref: #declaring-market-prices43934
+Ref: #declaring-market-prices44104
-Node: Declaring accounts44791
+Node: Declaring accounts44961
-Ref: #declaring-accounts44973
+Ref: #declaring-accounts45143
-Node: Account error checking46175
+Node: Account error checking46345
-Ref: #account-error-checking46347
+Ref: #account-error-checking46517
-Node: Account comments47526
+Node: Account comments47696
-Ref: #account-comments47716
+Ref: #account-comments47886
-Node: Account subdirectives48140
+Node: Account subdirectives48310
-Ref: #account-subdirectives48331
+Ref: #account-subdirectives48501
-Node: Account types48644
+Node: Account types48814
-Ref: #account-types48824
+Ref: #account-types48994
-Node: Declaring account types49560
+Node: Declaring account types49730
-Ref: #declaring-account-types49745
+Ref: #declaring-account-types49915
-Node: Auto-detected account types50395
+Node: Auto-detected account types50565
-Ref: #auto-detected-account-types50642
+Ref: #auto-detected-account-types50812
-Node: Interference from auto-detected account types51539
+Node: Interference from auto-detected account types51709
-Ref: #interference-from-auto-detected-account-types51822
+Ref: #interference-from-auto-detected-account-types51992
-Node: Old account type syntax52305
+Node: Old account type syntax52475
-Ref: #old-account-type-syntax52508
+Ref: #old-account-type-syntax52678
-Node: Account display order52808
+Node: Account display order52978
-Ref: #account-display-order52974
+Ref: #account-display-order53144
-Node: Rewriting accounts54125
+Node: Rewriting accounts54295
-Ref: #rewriting-accounts54306
+Ref: #rewriting-accounts54476
-Node: Basic aliases55063
+Node: Basic aliases55233
-Ref: #basic-aliases55205
+Ref: #basic-aliases55375
-Node: Regex aliases55909
+Node: Regex aliases56079
-Ref: #regex-aliases56077
+Ref: #regex-aliases56247
-Node: Combining aliases56796
+Node: Combining aliases56966
-Ref: #combining-aliases56985
+Ref: #combining-aliases57155
-Node: Aliases and multiple files58261
+Node: Aliases and multiple files58431
-Ref: #aliases-and-multiple-files58466
+Ref: #aliases-and-multiple-files58636
-Node: end aliases59045
+Node: end aliases59215
-Ref: #end-aliases59198
+Ref: #end-aliases59368
-Node: Default parent account59299
+Node: Default parent account59469
-Ref: #default-parent-account59463
+Ref: #default-parent-account59633
-Node: PERIODIC TRANSACTIONS60347
+Node: PERIODIC TRANSACTIONS60517
-Ref: #periodic-transactions60509
+Ref: #periodic-transactions60679
-Node: Periodic rule syntax62426
+Node: Periodic rule syntax62596
-Ref: #periodic-rule-syntax62628
+Ref: #periodic-rule-syntax62798
-Node: Two spaces between period expression and description!63332
+Node: Two spaces between period expression and description!63502
-Ref: #two-spaces-between-period-expression-and-description63647
+Ref: #two-spaces-between-period-expression-and-description63817
-Node: Forecasting with periodic transactions64331
+Node: Forecasting with periodic transactions64501
-Ref: #forecasting-with-periodic-transactions64632
+Ref: #forecasting-with-periodic-transactions64802
-Node: Budgeting with periodic transactions66687
+Node: Budgeting with periodic transactions66857
-Ref: #budgeting-with-periodic-transactions66922
+Ref: #budgeting-with-periodic-transactions67092
-Node: AUTO POSTINGS67331
+Node: AUTO POSTINGS67501
-Ref: #auto-postings67458
+Ref: #auto-postings67628
-Node: Auto postings and multiple files69637
+Node: Auto postings and multiple files69807
-Ref: #auto-postings-and-multiple-files69837
+Ref: #auto-postings-and-multiple-files70007
-Node: Auto postings and dates70046
+Node: Auto postings and dates70216
-Ref: #auto-postings-and-dates70316
+Ref: #auto-postings-and-dates70486
-Node: Auto postings and transaction balancing / inferred amounts / balance assertions70491
+Node: Auto postings and transaction balancing / inferred amounts / balance assertions70661
-Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions70838
+Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions71008
-Node: Auto posting tags71180
+Node: Auto posting tags71350
-Ref: #auto-posting-tags71391
+Ref: #auto-posting-tags71561
 
 End Tag Table

hledger-lib/hledger_journal.txt

@@ -411,9 +411,9 @@ AMOUNTS
               commodity       1 000 000.9455
 
    Commodity display style
-       For each commodity, hledger chooses a consistent style to use when dis-
+       For the amounts in each commodity, hledger chooses a consistent display
-       playing amounts.  (Except price amounts, which are always displayed  as
+       style.  (Excluding price amounts, which are always displayed  as  writ-
-       written).  The display style is chosen as follows:
+       ten).  The display style is chosen as follows:
 
        o If  there  is  a commodity directive (or default commodity directive)
          for the commodity, its style is used (see examples above).
@@ -447,9 +447,14 @@ AMOUNTS
          first-seen digit group style and the maximum-seen number  of  decimal
          places.
 
-       If  reports  are  showing amounts in a way you don't like (eg, with too
+       So if your reports are showing amounts in a way you don't like, eg with
-       many decimal places), use a commodity directive to set  your  preferred
+       too many decimal places, use a commodity directive to set  the  commod-
-       style.
+       ity's display style.  For example:
+
+              # declare euro, dollar and bitcoin commodities and set their display styles:
+              commodity EUR 1.000,
+              commodity $1000.00
+              commodity 1000.00000000 BTC
 
    Rounding
        Amounts are stored internally as decimal numbers with up to 255 decimal
@@ -721,6 +726,12 @@ DIRECTIVES
                   ment                                                 until  end  of cur-
                                                                        rent  file  or  end
                                                                        directive
+
+
+
+
+
+
        commod-                format    declare a commodity and  its   number    notation:
        ity                              number  notation  &  display   following   entries
                                         style                          in  that  commodity
@@ -740,8 +751,6 @@ DIRECTIVES
                                                                        play style: amounts
                                                                        of  that  commodity
                                                                        in reports
-
-
        include                          include   entries/directives   what  the  included
                                         from another file              directives affect
        P                                declare a market price for a   amounts   of   that