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