doc: journal: describe postings & their cleared flag

hledger-lib/doc/hledger_journal.5

@@ -72,13 +72,21 @@ a transaction code (eg a check number),
 .IP \[bu] 2
 and/or a description
 .PP
-then some number of postings, of some amount to some account, each on
+then some number of postings, of some amount to some account.
-its own line.
+Each posting is on its own line, consisting of:
-Usually there are at least two postings, though one or even none is
+.IP \[bu] 2
-possible.
+indentation of one or more spaces (or tabs)
+.IP \[bu] 2
+optionally, a \f[C]!\f[] or \f[C]*\f[] status flag followed by a space
+.IP \[bu] 2
+an account name, optionally containing single spaces
+.IP \[bu] 2
+optionally, two or more spaces or tabs followed by an amount
 .PP
-The (real) posting amounts within a transaction must always balance, ie
+Usually there are two or more postings, though one or none is also
-add up to 0.
+possible.
+The posting amounts within a transaction must always balance, ie add up
+to 0.
 Optionally one amount can be left blank, in which case it will be
 inferred.
 .SS Dates

hledger-lib/doc/hledger_journal.5.info

@@ -92,11 +92,19 @@ between them:
 
    * and/or a description
 
-   then some number of postings, of some amount to some account, each on
+   then some number of postings, of some amount to some account. Each
-its own line. Usually there are at least two postings, though one or
+posting is on its own line, consisting of:
-even none is possible.
 
-   The (real) posting amounts within a transaction must always balance,
+   * indentation of one or more spaces (or tabs)
+
+   * optionally, a `!' or `*' status flag followed by a space
+
+   * an account name, optionally containing single spaces
+
+   * optionally, two or more spaces or tabs followed by an amount
+
+   Usually there are two or more postings, though one or none is also
+possible. The posting amounts within a transaction must always balance,
 ie add up to 0. Optionally one amount can be left blank, in which case
 it will be inferred.
 
@@ -912,67 +920,67 @@ Node: FILE FORMAT2286
 Ref: #file-format2412
 Node: Transactions2571
 Ref: #transactions2691
-Node: Dates3377
+Node: Dates3634
-Ref: #dates3505
+Ref: #dates3762
-Node: Simple dates3570
+Node: Simple dates3827
-Ref: #simple-dates3698
+Ref: #simple-dates3955
-Node: Secondary dates4062
+Node: Secondary dates4319
-Ref: #secondary-dates4218
+Ref: #secondary-dates4475
-Node: Posting dates5779
+Node: Posting dates6036
-Ref: #posting-dates5910
+Ref: #posting-dates6167
-Node: Account names7281
+Node: Account names7538
-Ref: #account-names7420
+Ref: #account-names7677
-Node: Amounts7905
+Node: Amounts8162
-Ref: #amounts8043
+Ref: #amounts8300
-Node: Virtual Postings10041
+Node: Virtual Postings10298
-Ref: #virtual-postings10202
+Ref: #virtual-postings10459
-Node: Balance Assertions11422
+Node: Balance Assertions11679
-Ref: #balance-assertions11586
+Ref: #balance-assertions11843
-Node: Assertions and ordering12408
+Node: Assertions and ordering12665
-Ref: #assertions-and-ordering12593
+Ref: #assertions-and-ordering12850
-Node: Assertions and commodities13624
+Node: Assertions and commodities13881
-Ref: #assertions-and-commodities13850
+Ref: #assertions-and-commodities14107
-Node: Assertions and subaccounts14542
+Node: Assertions and subaccounts14799
-Ref: #assertions-and-subaccounts14776
+Ref: #assertions-and-subaccounts15033
-Node: Assertions and virtual postings15298
+Node: Assertions and virtual postings15555
-Ref: #assertions-and-virtual-postings15507
+Ref: #assertions-and-virtual-postings15764
-Node: Prices15648
+Node: Prices15905
-Ref: #prices15780
+Ref: #prices16037
-Node: Transaction prices15831
+Node: Transaction prices16088
-Ref: #transaction-prices15976
+Ref: #transaction-prices16233
-Node: Market prices17583
+Node: Market prices17840
-Ref: #market-prices17718
+Ref: #market-prices17975
-Node: Comments18606
+Node: Comments18863
-Ref: #comments18728
+Ref: #comments18985
-Node: Tags19840
+Node: Tags20097
-Ref: #tags19958
+Ref: #tags20215
-Node: Directives20881
+Node: Directives21138
-Ref: #directives20996
+Ref: #directives21253
-Node: Account aliases21189
+Node: Account aliases21446
-Ref: #account-aliases21335
+Ref: #account-aliases21592
-Node: Basic aliases21937
+Node: Basic aliases22194
-Ref: #basic-aliases22082
+Ref: #basic-aliases22339
-Node: Regex aliases22770
+Node: Regex aliases23027
-Ref: #regex-aliases22940
+Ref: #regex-aliases23197
-Node: Multiple aliases23710
+Node: Multiple aliases23967
-Ref: #multiple-aliases23884
+Ref: #multiple-aliases24141
-Node: end aliases24380
+Node: end aliases24637
-Ref: #end-aliases24522
+Ref: #end-aliases24779
-Node: account directive24624
+Node: account directive24881
-Ref: #account-directive24806
+Ref: #account-directive25063
-Node: apply account directive25102
+Node: apply account directive25359
-Ref: #apply-account-directive25300
+Ref: #apply-account-directive25557
-Node: Multi-line comments25961
+Node: Multi-line comments26218
-Ref: #multi-line-comments26153
+Ref: #multi-line-comments26410
-Node: commodity directive26280
+Node: commodity directive26537
-Ref: #commodity-directive26466
+Ref: #commodity-directive26723
-Node: Default commodity27339
+Node: Default commodity27596
-Ref: #default-commodity27514
+Ref: #default-commodity27771
-Node: Default year27835
+Node: Default year28092
-Ref: #default-year28002
+Ref: #default-year28259
-Node: Including other files28425
+Node: Including other files28682
-Ref: #including-other-files28584
+Ref: #including-other-files28841
-Node: EDITOR SUPPORT28980
+Node: EDITOR SUPPORT29237
-Ref: #editor-support29100
+Ref: #editor-support29357
 
 End Tag Table

hledger-lib/doc/hledger_journal.5.m4.md

@@ -69,17 +69,23 @@ Transactions are represented by journal entries. Each begins with a
 [simple date](#simple-dates) in column 0, followed by three optional
 fields with spaces between them:
 
-- a status flag, which can be empty or `!` or `*` (meaning "uncleared", "pending" and "cleared", or whatever you want)
+- a status flag, which can be empty or `!` or `*` (meaning "uncleared",
+  "pending" and "cleared", or whatever you want)
 - a transaction code (eg a check number),
 - and/or a description
 
-then some number of postings, of some amount to some account, each on
+then some number of postings, of some amount to some account. Each
-its own line. Usually there are at least two postings, though one or
+posting is on its own line, consisting of:
-even none is possible.
 
-The ([real](#virtual-postings)) posting amounts within a transaction
+- indentation of one or more spaces (or tabs)
-must always balance, ie add up to 0.  Optionally one amount can be
+- optionally, a `!` or `*` status flag followed by a space
-left blank, in which case it will be inferred.
+- an account name, optionally containing single spaces
+- optionally, two or more spaces or tabs followed by an amount
+
+Usually there are two or more postings, though one or none is also
+possible. The posting amounts within a transaction must always balance,
+ie add up to 0. Optionally one amount can be left blank, in which case
+it will be inferred.
 
 ## Dates
 

hledger-lib/doc/hledger_journal.5.txt

@@ -64,13 +64,21 @@ FFIILLEE FFOORRMMAATT
 
        +o and/or a description
 
-       then some number of postings, of some amount to some account,  each  on
+       then some number of postings, of some amount  to  some  account.   Each
-       its  own  line.  Usually there are at least two postings, though one or
+       posting is on its own line, consisting of:
-       even none is possible.
 
-       The (real) posting amounts within a transaction must always balance, ie
+       +o indentation of one or more spaces (or tabs)
-       add up to 0.  Optionally one amount can be left blank, in which case it
+
-       will be inferred.
+       +o optionally, a ! or * status flag followed by a space
+
+       +o an account name, optionally containing single spaces
+
+       +o optionally, two or more spaces or tabs followed by an amount
+
+       Usually there are two or more postings, though one or none is also pos-
+       sible.  The posting amounts within a transaction must  always  balance,
+       ie add up to 0.  Optionally one amount can be left blank, in which case
+       it will be inferred.
 
    DDaatteess
    SSiimmppllee ddaatteess