;doc: update manuals
This commit is contained in:
Simon Michael
parent
6225db6b36
commit
7b59821378
@ -6694,52 +6694,66 @@ more detailed docs below:
|
||||
.PP
|
||||
.TS
|
||||
tab(@);
|
||||
lw(5.2n) lw(64.8n).
|
||||
lw(4.9n) lw(61.1n) lw(4.0n).
|
||||
T{
|
||||
directive
|
||||
T}@T{
|
||||
effects
|
||||
T}@T{
|
||||
ends at file end?
|
||||
T}
|
||||
_
|
||||
T{
|
||||
\f[B]\f[CB]account\f[B]\f[R]
|
||||
T}@T{
|
||||
Declare an account, for checking all entries in all files;and its
|
||||
display order and type, for reports.Subdirectives: any text, ignored.
|
||||
Declare an account, for checking all entries in all files; and its
|
||||
display order and type, for reports.
|
||||
Subdirectives: any text, ignored.
|
||||
T}@T{
|
||||
T}
|
||||
T{
|
||||
\f[B]\f[CB]alias\f[B]\f[R]
|
||||
T}@T{
|
||||
Rewrites account names, in following entries until end of current file
|
||||
or \f[C]end aliases\f[R].
|
||||
T}@T{
|
||||
Y
|
||||
T}
|
||||
T{
|
||||
\f[B]\f[CB]apply account\f[B]\f[R]
|
||||
T}@T{
|
||||
Prepends a common parent account to all account names, in following
|
||||
entries until end of current file or \f[C]end apply account\f[R].
|
||||
T}@T{
|
||||
Y
|
||||
T}
|
||||
T{
|
||||
\f[B]\f[CB]comment\f[B]\f[R]
|
||||
T}@T{
|
||||
Ignores part of the journal file, until end of current file or
|
||||
\f[C]end comment\f[R].
|
||||
T}@T{
|
||||
Y
|
||||
T}
|
||||
T{
|
||||
\f[B]\f[CB]commodity\f[B]\f[R]
|
||||
T}@T{
|
||||
Declares a commodity, for checking all entries in all files;the decimal
|
||||
Declares a commodity, for checking all entries in all files; the decimal
|
||||
mark for parsing amounts of this commodity, for following entries until
|
||||
end of current file;and its display style, for reports.
|
||||
Takes precedence over \f[C]D\f[R].Subdirectives: \f[C]format\f[R]
|
||||
(alternate syntax).
|
||||
end of current file; and its display style, for reports.
|
||||
Takes precedence over \f[C]D\f[R].
|
||||
Subdirectives: \f[C]format\f[R] (alternate syntax).
|
||||
T}@T{
|
||||
N, Y
|
||||
T}
|
||||
T{
|
||||
\f[B]\f[CB]D\f[B]\f[R]
|
||||
T}@T{
|
||||
Sets a default commodity to use for no-symbol amounts,and its decimal
|
||||
Sets a default commodity to use for no-symbol amounts, and its decimal
|
||||
mark for parsing amounts of this commodity in following entries until
|
||||
end of current file;and its display style, for reports.
|
||||
end of current file; and its display style, for reports.
|
||||
T}@T{
|
||||
Y
|
||||
T}
|
||||
T{
|
||||
\f[B]\f[CB]decimal-mark\f[B]\f[R]
|
||||
@ -6749,29 +6763,36 @@ following entries until next \f[C]decimal-mark\f[R] or end of current
|
||||
file.
|
||||
Included files can override.
|
||||
Takes precedence over \f[C]commodity\f[R] and \f[C]D\f[R].
|
||||
T}@T{
|
||||
Y
|
||||
T}
|
||||
T{
|
||||
\f[B]\f[CB]include\f[B]\f[R]
|
||||
T}@T{
|
||||
Includes entries and directives from another file, as if they were
|
||||
written inline.
|
||||
T}@T{
|
||||
T}
|
||||
T{
|
||||
\f[B]\f[CB]payee\f[B]\f[R]
|
||||
T}@T{
|
||||
Declares a payee name, for checking all entries in all files.
|
||||
T}@T{
|
||||
T}
|
||||
T{
|
||||
\f[B]\f[CB]P\f[B]\f[R]
|
||||
T}@T{
|
||||
Declares a market price for a commodity on some date, for valuation
|
||||
reports.
|
||||
T}@T{
|
||||
T}
|
||||
T{
|
||||
\f[B]\f[CB]Y\f[B]\f[R]
|
||||
T}@T{
|
||||
Declares a year for yearless dates, for following entries until end of
|
||||
current file.
|
||||
T}@T{
|
||||
Y
|
||||
T}
|
||||
T{
|
||||
\f[B]\f[CB]\[ti]\f[B]\f[R] (tilde)
|
||||
@ -6779,6 +6800,7 @@ T}@T{
|
||||
Declares a periodic transaction rule that generates future transactions
|
||||
with \f[C]--forecast\f[R] and budget goals with
|
||||
\f[C]balance --budget\f[R].
|
||||
T}@T{
|
||||
T}
|
||||
T{
|
||||
\f[B]\f[CB]=\f[B]\f[R] (equals)
|
||||
@ -6786,6 +6808,8 @@ T}@T{
|
||||
Declares an auto posting rule that generates extra postings on matched
|
||||
transactions with \f[C]--auto\f[R], in current, parent, and child files
|
||||
(but not sibling files, see #1212).
|
||||
T}@T{
|
||||
partly
|
||||
T}
|
||||
.TE
|
||||
.PP
|
||||
@ -6849,7 +6873,7 @@ T}@T{
|
||||
T}@T{
|
||||
T}
|
||||
T{
|
||||
Defining commodity display styles for output
|
||||
Defining commodity display styles
|
||||
T}@T{
|
||||
\f[C]commodity\f[R], \f[C]D\f[R]
|
||||
T}@T{
|
||||
|
||||
@ -5817,44 +5817,47 @@ hledger versions. Here are some more definitions:
|
||||
Here are all the directives and their precise effects, with links to
|
||||
more detailed docs below:
|
||||
|
||||
directiveeffects
|
||||
--------------------------------------------------------------------------
|
||||
*'account'*Declare an account, for checking all entries in all files;and its
|
||||
display order and type, for reports.Subdirectives: any text,
|
||||
ignored.
|
||||
*'alias'*Rewrites account names, in following entries until end of current
|
||||
file or 'end aliases'.
|
||||
*'applyPrepends a common parent account to all account names, in
|
||||
directiveeffects ends
|
||||
at
|
||||
file
|
||||
end?
|
||||
---------------------------------------------------------------------------
|
||||
*'account'*Declare an account, for checking all entries in all files;
|
||||
and its display order and type, for reports. Subdirectives:
|
||||
any text, ignored.
|
||||
*'alias'*Rewrites account names, in following entries until end of Y
|
||||
current file or 'end aliases'.
|
||||
*'applyPrepends a common parent account to all account names, in Y
|
||||
account'*following entries until end of current file or 'end apply
|
||||
account'.
|
||||
*'comment'*Ignores part of the journal file, until end of current file or
|
||||
'end comment'.
|
||||
*'commodity'*Declares a commodity, for checking all entries in all files;the
|
||||
decimal mark for parsing amounts of this commodity, for following
|
||||
entries until end of current file;and its display style, for
|
||||
reports. Takes precedence over 'D'.Subdirectives: 'format'
|
||||
(alternate syntax).
|
||||
*'D'* Sets a default commodity to use for no-symbol amounts,and its
|
||||
decimal mark for parsing amounts of this commodity in following
|
||||
entries until end of current file;and its display style, for
|
||||
reports.
|
||||
*'decimal-mark'*Declares the decimal mark, for parsing amounts of all commodities
|
||||
in following entries until next 'decimal-mark' or end of current
|
||||
file. Included files can override. Takes precedence over
|
||||
'commodity' and 'D'.
|
||||
*'comment'*Ignores part of the journal file, until end of current fileY
|
||||
or 'end comment'.
|
||||
*'commodity'*Declares a commodity, for checking all entries in all files;N,
|
||||
the decimal mark for parsing amounts of this commodity, for Y
|
||||
following entries until end of current file; and its display
|
||||
style, for reports. Takes precedence over 'D'.
|
||||
Subdirectives: 'format' (alternate syntax).
|
||||
*'D'* Sets a default commodity to use for no-symbol amounts, and Y
|
||||
its decimal mark for parsing amounts of this commodity in
|
||||
following entries until end of current file; and its display
|
||||
style, for reports.
|
||||
*'decimal-mark'*Declares the decimal mark, for parsing amounts of all Y
|
||||
commodities in following entries until next 'decimal-mark' or
|
||||
end of current file. Included files can override. Takes
|
||||
precedence over 'commodity' and 'D'.
|
||||
*'include'*Includes entries and directives from another file, as if they
|
||||
were written inline.
|
||||
*'payee'*Declares a payee name, for checking all entries in all files.
|
||||
*'P'* Declares a market price for a commodity on some date, for
|
||||
valuation reports.
|
||||
*'Y'* Declares a year for yearless dates, for following entries until
|
||||
end of current file.
|
||||
*'Y'* Declares a year for yearless dates, for following entries Y
|
||||
until end of current file.
|
||||
*'~'* Declares a periodic transaction rule that generates future
|
||||
(tilde)transactions with '--forecast' and budget goals with 'balance
|
||||
--budget'.
|
||||
*'='* Declares an auto posting rule that generates extra postings on
|
||||
(equals)matched transactions with '--auto', in current, parent, and child
|
||||
files (but not sibling files, see #1212).
|
||||
*'='* Declares an auto posting rule that generates extra postings partly
|
||||
(equals)on matched transactions with '--auto', in current, parent,
|
||||
and child files (but not sibling files, see #1212).
|
||||
|
||||
And here is an overview of which directives are useful for what:
|
||||
|
||||
@ -5880,7 +5883,6 @@ error checking 'commodity',
|
||||
Defining accounts' display order 'account'
|
||||
and accounting type
|
||||
Defining commodity display styles 'commodity', 'D' '-c/--commodity-style'
|
||||
for output
|
||||
|
||||
|
||||
File: hledger.info, Node: Directives and multiple files, Next: Comment blocks, Prev: Directives, Up: JOURNAL FORMAT
|
||||
@ -9332,196 +9334,196 @@ Node: Balance assignments and prices211022
|
||||
Ref: #balance-assignments-and-prices211188
|
||||
Node: Directives211412
|
||||
Ref: #directives211575
|
||||
Node: Directives and multiple files215697
|
||||
Ref: #directives-and-multiple-files215893
|
||||
Node: Comment blocks216585
|
||||
Ref: #comment-blocks216762
|
||||
Node: Including other files216938
|
||||
Ref: #including-other-files217112
|
||||
Node: Default year218036
|
||||
Ref: #default-year218194
|
||||
Node: Declaring payees218601
|
||||
Ref: #declaring-payees218772
|
||||
Node: Declaring the decimal mark219018
|
||||
Ref: #declaring-the-decimal-mark219218
|
||||
Node: Declaring commodities219615
|
||||
Ref: #declaring-commodities219806
|
||||
Node: Commodity error checking222324
|
||||
Ref: #commodity-error-checking222474
|
||||
Node: Default commodity222731
|
||||
Ref: #default-commodity222911
|
||||
Node: Declaring market prices224027
|
||||
Ref: #declaring-market-prices224216
|
||||
Node: Declaring accounts225029
|
||||
Ref: #declaring-accounts225209
|
||||
Node: Account error checking226411
|
||||
Ref: #account-error-checking226577
|
||||
Node: Account comments227756
|
||||
Ref: #account-comments227940
|
||||
Node: Account subdirectives228364
|
||||
Ref: #account-subdirectives228549
|
||||
Node: Account types228862
|
||||
Ref: #account-types229036
|
||||
Node: Declaring account types229694
|
||||
Ref: #declaring-account-types229873
|
||||
Node: Auto-detected account types230927
|
||||
Ref: #auto-detected-account-types231114
|
||||
Node: Account display order233132
|
||||
Ref: #account-display-order233292
|
||||
Node: Rewriting accounts234443
|
||||
Ref: #rewriting-accounts234622
|
||||
Node: Basic aliases235379
|
||||
Ref: #basic-aliases235515
|
||||
Node: Regex aliases236259
|
||||
Ref: #regex-aliases236421
|
||||
Node: Combining aliases237140
|
||||
Ref: #combining-aliases237323
|
||||
Node: Aliases and multiple files238599
|
||||
Ref: #aliases-and-multiple-files238798
|
||||
Node: end aliases239377
|
||||
Ref: #end-aliases239524
|
||||
Node: Default parent account239673
|
||||
Ref: #default-parent-account239863
|
||||
Node: Periodic transactions240747
|
||||
Ref: #periodic-transactions240930
|
||||
Node: Periodic rule syntax242847
|
||||
Ref: #periodic-rule-syntax243047
|
||||
Node: Two spaces between period expression and description!243751
|
||||
Ref: #two-spaces-between-period-expression-and-description244064
|
||||
Node: Forecasting with periodic transactions244748
|
||||
Ref: #forecasting-with-periodic-transactions245047
|
||||
Node: Budgeting with periodic transactions247818
|
||||
Ref: #budgeting-with-periodic-transactions248051
|
||||
Node: Auto postings248460
|
||||
Ref: #auto-postings248596
|
||||
Node: Auto postings and multiple files250775
|
||||
Ref: #auto-postings-and-multiple-files250973
|
||||
Node: Auto postings and dates251182
|
||||
Ref: #auto-postings-and-dates251450
|
||||
Node: Auto postings and transaction balancing / inferred amounts / balance assertions251625
|
||||
Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions251970
|
||||
Node: Auto posting tags252473
|
||||
Ref: #auto-posting-tags252682
|
||||
Node: CSV FORMAT253318
|
||||
Ref: #csv-format253446
|
||||
Node: Examples256075
|
||||
Ref: #examples256178
|
||||
Node: Basic256386
|
||||
Ref: #basic256488
|
||||
Node: Bank of Ireland257030
|
||||
Ref: #bank-of-ireland257167
|
||||
Node: Amazon258629
|
||||
Ref: #amazon258749
|
||||
Node: Paypal260468
|
||||
Ref: #paypal260564
|
||||
Node: CSV rules268208
|
||||
Ref: #csv-rules268326
|
||||
Node: skip268659
|
||||
Ref: #skip268759
|
||||
Node: fields list269134
|
||||
Ref: #fields-list269273
|
||||
Node: field assignment270776
|
||||
Ref: #field-assignment270928
|
||||
Node: Field names271963
|
||||
Ref: #field-names272103
|
||||
Node: date field272483
|
||||
Ref: #date-field272603
|
||||
Node: date2 field272651
|
||||
Ref: #date2-field272794
|
||||
Node: status field272850
|
||||
Ref: #status-field272995
|
||||
Node: code field273044
|
||||
Ref: #code-field273191
|
||||
Node: description field273236
|
||||
Ref: #description-field273398
|
||||
Node: comment field273457
|
||||
Ref: #comment-field273614
|
||||
Node: account field273914
|
||||
Ref: #account-field274066
|
||||
Node: amount field274641
|
||||
Ref: #amount-field274792
|
||||
Node: currency field276037
|
||||
Ref: #currency-field276192
|
||||
Node: balance field276449
|
||||
Ref: #balance-field276583
|
||||
Node: separator276955
|
||||
Ref: #separator277087
|
||||
Node: if block277627
|
||||
Ref: #if-block277754
|
||||
Node: Matching the whole record278155
|
||||
Ref: #matching-the-whole-record278332
|
||||
Node: Matching individual fields279135
|
||||
Ref: #matching-individual-fields279341
|
||||
Node: Combining matchers279565
|
||||
Ref: #combining-matchers279763
|
||||
Node: Rules applied on successful match280076
|
||||
Ref: #rules-applied-on-successful-match280269
|
||||
Node: if table280923
|
||||
Ref: #if-table281044
|
||||
Node: end282782
|
||||
Ref: #end282896
|
||||
Node: date-format283120
|
||||
Ref: #date-format283254
|
||||
Node: decimal-mark284250
|
||||
Ref: #decimal-mark284397
|
||||
Node: newest-first284736
|
||||
Ref: #newest-first284879
|
||||
Node: include285562
|
||||
Ref: #include285695
|
||||
Node: balance-type286139
|
||||
Ref: #balance-type286261
|
||||
Node: Tips286961
|
||||
Ref: #tips287052
|
||||
Node: Rapid feedback287351
|
||||
Ref: #rapid-feedback287470
|
||||
Node: Valid CSV287922
|
||||
Ref: #valid-csv288054
|
||||
Node: File Extension288246
|
||||
Ref: #file-extension288400
|
||||
Node: Reading multiple CSV files288829
|
||||
Ref: #reading-multiple-csv-files289016
|
||||
Node: Valid transactions289257
|
||||
Ref: #valid-transactions289437
|
||||
Node: Deduplicating importing290065
|
||||
Ref: #deduplicating-importing290246
|
||||
Node: Setting amounts291279
|
||||
Ref: #setting-amounts291436
|
||||
Node: Amount signs293877
|
||||
Ref: #amount-signs294031
|
||||
Node: Setting currency/commodity294718
|
||||
Ref: #setting-currencycommodity294906
|
||||
Node: Amount decimal places296080
|
||||
Ref: #amount-decimal-places296272
|
||||
Node: Referencing other fields296584
|
||||
Ref: #referencing-other-fields296783
|
||||
Node: How CSV rules are evaluated297680
|
||||
Ref: #how-csv-rules-are-evaluated297855
|
||||
Node: TIMECLOCK FORMAT299306
|
||||
Ref: #timeclock-format299446
|
||||
Node: TIMEDOT FORMAT301507
|
||||
Ref: #timedot-format301645
|
||||
Node: COMMON TASKS306207
|
||||
Ref: #common-tasks306336
|
||||
Node: Getting help306743
|
||||
Ref: #getting-help306877
|
||||
Node: Constructing command lines307430
|
||||
Ref: #constructing-command-lines307624
|
||||
Node: Starting a journal file308321
|
||||
Ref: #starting-a-journal-file308521
|
||||
Node: Setting opening balances309709
|
||||
Ref: #setting-opening-balances309907
|
||||
Node: Recording transactions313048
|
||||
Ref: #recording-transactions313230
|
||||
Node: Reconciling313786
|
||||
Ref: #reconciling313931
|
||||
Node: Reporting316188
|
||||
Ref: #reporting316330
|
||||
Node: Migrating to a new file320329
|
||||
Ref: #migrating-to-a-new-file320479
|
||||
Node: LIMITATIONS320778
|
||||
Ref: #limitations320906
|
||||
Node: TROUBLESHOOTING321649
|
||||
Ref: #troubleshooting321764
|
||||
Node: Directives and multiple files216025
|
||||
Ref: #directives-and-multiple-files216221
|
||||
Node: Comment blocks216913
|
||||
Ref: #comment-blocks217090
|
||||
Node: Including other files217266
|
||||
Ref: #including-other-files217440
|
||||
Node: Default year218364
|
||||
Ref: #default-year218522
|
||||
Node: Declaring payees218929
|
||||
Ref: #declaring-payees219100
|
||||
Node: Declaring the decimal mark219346
|
||||
Ref: #declaring-the-decimal-mark219546
|
||||
Node: Declaring commodities219943
|
||||
Ref: #declaring-commodities220134
|
||||
Node: Commodity error checking222652
|
||||
Ref: #commodity-error-checking222802
|
||||
Node: Default commodity223059
|
||||
Ref: #default-commodity223239
|
||||
Node: Declaring market prices224355
|
||||
Ref: #declaring-market-prices224544
|
||||
Node: Declaring accounts225357
|
||||
Ref: #declaring-accounts225537
|
||||
Node: Account error checking226739
|
||||
Ref: #account-error-checking226905
|
||||
Node: Account comments228084
|
||||
Ref: #account-comments228268
|
||||
Node: Account subdirectives228692
|
||||
Ref: #account-subdirectives228877
|
||||
Node: Account types229190
|
||||
Ref: #account-types229364
|
||||
Node: Declaring account types230022
|
||||
Ref: #declaring-account-types230201
|
||||
Node: Auto-detected account types231255
|
||||
Ref: #auto-detected-account-types231442
|
||||
Node: Account display order233460
|
||||
Ref: #account-display-order233620
|
||||
Node: Rewriting accounts234771
|
||||
Ref: #rewriting-accounts234950
|
||||
Node: Basic aliases235707
|
||||
Ref: #basic-aliases235843
|
||||
Node: Regex aliases236587
|
||||
Ref: #regex-aliases236749
|
||||
Node: Combining aliases237468
|
||||
Ref: #combining-aliases237651
|
||||
Node: Aliases and multiple files238927
|
||||
Ref: #aliases-and-multiple-files239126
|
||||
Node: end aliases239705
|
||||
Ref: #end-aliases239852
|
||||
Node: Default parent account240001
|
||||
Ref: #default-parent-account240191
|
||||
Node: Periodic transactions241075
|
||||
Ref: #periodic-transactions241258
|
||||
Node: Periodic rule syntax243175
|
||||
Ref: #periodic-rule-syntax243375
|
||||
Node: Two spaces between period expression and description!244079
|
||||
Ref: #two-spaces-between-period-expression-and-description244392
|
||||
Node: Forecasting with periodic transactions245076
|
||||
Ref: #forecasting-with-periodic-transactions245375
|
||||
Node: Budgeting with periodic transactions248146
|
||||
Ref: #budgeting-with-periodic-transactions248379
|
||||
Node: Auto postings248788
|
||||
Ref: #auto-postings248924
|
||||
Node: Auto postings and multiple files251103
|
||||
Ref: #auto-postings-and-multiple-files251301
|
||||
Node: Auto postings and dates251510
|
||||
Ref: #auto-postings-and-dates251778
|
||||
Node: Auto postings and transaction balancing / inferred amounts / balance assertions251953
|
||||
Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions252298
|
||||
Node: Auto posting tags252801
|
||||
Ref: #auto-posting-tags253010
|
||||
Node: CSV FORMAT253646
|
||||
Ref: #csv-format253774
|
||||
Node: Examples256403
|
||||
Ref: #examples256506
|
||||
Node: Basic256714
|
||||
Ref: #basic256816
|
||||
Node: Bank of Ireland257358
|
||||
Ref: #bank-of-ireland257495
|
||||
Node: Amazon258957
|
||||
Ref: #amazon259077
|
||||
Node: Paypal260796
|
||||
Ref: #paypal260892
|
||||
Node: CSV rules268536
|
||||
Ref: #csv-rules268654
|
||||
Node: skip268987
|
||||
Ref: #skip269087
|
||||
Node: fields list269462
|
||||
Ref: #fields-list269601
|
||||
Node: field assignment271104
|
||||
Ref: #field-assignment271256
|
||||
Node: Field names272291
|
||||
Ref: #field-names272431
|
||||
Node: date field272811
|
||||
Ref: #date-field272931
|
||||
Node: date2 field272979
|
||||
Ref: #date2-field273122
|
||||
Node: status field273178
|
||||
Ref: #status-field273323
|
||||
Node: code field273372
|
||||
Ref: #code-field273519
|
||||
Node: description field273564
|
||||
Ref: #description-field273726
|
||||
Node: comment field273785
|
||||
Ref: #comment-field273942
|
||||
Node: account field274242
|
||||
Ref: #account-field274394
|
||||
Node: amount field274969
|
||||
Ref: #amount-field275120
|
||||
Node: currency field276365
|
||||
Ref: #currency-field276520
|
||||
Node: balance field276777
|
||||
Ref: #balance-field276911
|
||||
Node: separator277283
|
||||
Ref: #separator277415
|
||||
Node: if block277955
|
||||
Ref: #if-block278082
|
||||
Node: Matching the whole record278483
|
||||
Ref: #matching-the-whole-record278660
|
||||
Node: Matching individual fields279463
|
||||
Ref: #matching-individual-fields279669
|
||||
Node: Combining matchers279893
|
||||
Ref: #combining-matchers280091
|
||||
Node: Rules applied on successful match280404
|
||||
Ref: #rules-applied-on-successful-match280597
|
||||
Node: if table281251
|
||||
Ref: #if-table281372
|
||||
Node: end283110
|
||||
Ref: #end283224
|
||||
Node: date-format283448
|
||||
Ref: #date-format283582
|
||||
Node: decimal-mark284578
|
||||
Ref: #decimal-mark284725
|
||||
Node: newest-first285064
|
||||
Ref: #newest-first285207
|
||||
Node: include285890
|
||||
Ref: #include286023
|
||||
Node: balance-type286467
|
||||
Ref: #balance-type286589
|
||||
Node: Tips287289
|
||||
Ref: #tips287380
|
||||
Node: Rapid feedback287679
|
||||
Ref: #rapid-feedback287798
|
||||
Node: Valid CSV288250
|
||||
Ref: #valid-csv288382
|
||||
Node: File Extension288574
|
||||
Ref: #file-extension288728
|
||||
Node: Reading multiple CSV files289157
|
||||
Ref: #reading-multiple-csv-files289344
|
||||
Node: Valid transactions289585
|
||||
Ref: #valid-transactions289765
|
||||
Node: Deduplicating importing290393
|
||||
Ref: #deduplicating-importing290574
|
||||
Node: Setting amounts291607
|
||||
Ref: #setting-amounts291764
|
||||
Node: Amount signs294205
|
||||
Ref: #amount-signs294359
|
||||
Node: Setting currency/commodity295046
|
||||
Ref: #setting-currencycommodity295234
|
||||
Node: Amount decimal places296408
|
||||
Ref: #amount-decimal-places296600
|
||||
Node: Referencing other fields296912
|
||||
Ref: #referencing-other-fields297111
|
||||
Node: How CSV rules are evaluated298008
|
||||
Ref: #how-csv-rules-are-evaluated298183
|
||||
Node: TIMECLOCK FORMAT299634
|
||||
Ref: #timeclock-format299774
|
||||
Node: TIMEDOT FORMAT301835
|
||||
Ref: #timedot-format301973
|
||||
Node: COMMON TASKS306535
|
||||
Ref: #common-tasks306664
|
||||
Node: Getting help307071
|
||||
Ref: #getting-help307205
|
||||
Node: Constructing command lines307758
|
||||
Ref: #constructing-command-lines307952
|
||||
Node: Starting a journal file308649
|
||||
Ref: #starting-a-journal-file308849
|
||||
Node: Setting opening balances310037
|
||||
Ref: #setting-opening-balances310235
|
||||
Node: Recording transactions313376
|
||||
Ref: #recording-transactions313558
|
||||
Node: Reconciling314114
|
||||
Ref: #reconciling314259
|
||||
Node: Reporting316516
|
||||
Ref: #reporting316658
|
||||
Node: Migrating to a new file320657
|
||||
Ref: #migrating-to-a-new-file320807
|
||||
Node: LIMITATIONS321106
|
||||
Ref: #limitations321234
|
||||
Node: TROUBLESHOOTING321977
|
||||
Ref: #troubleshooting322092
|
||||
|
||||
End Tag Table
|
||||
|
||||
|
||||
@ -4869,43 +4869,47 @@ JOURNAL FORMAT
|
||||
more detailed docs below:
|
||||
|
||||
|
||||
direc- effects
|
||||
tive
|
||||
-----------------------------------------------------------------------------
|
||||
account Declare an account, for checking all entries in all files;and its
|
||||
display order and type, for reports.Subdirectives: any text,
|
||||
ignored.
|
||||
alias Rewrites account names, in following entries until end of current
|
||||
file or end aliases.
|
||||
apply Prepends a common parent account to all account names, in follow-
|
||||
account ing entries until end of current file or end apply account.
|
||||
comment Ignores part of the journal file, until end of current file or
|
||||
end comment.
|
||||
commod- Declares a commodity, for checking all entries in all files;the
|
||||
ity decimal mark for parsing amounts of this commodity, for following
|
||||
entries until end of current file;and its display style, for
|
||||
reports. Takes precedence over D.Subdirectives: format (alter-
|
||||
nate syntax).
|
||||
D Sets a default commodity to use for no-symbol amounts,and its
|
||||
decimal mark for parsing amounts of this commodity in following
|
||||
entries until end of current file;and its display style, for
|
||||
reports.
|
||||
deci- Declares the decimal mark, for parsing amounts of all commodities
|
||||
mal- in following entries until next decimal-mark or end of current
|
||||
mark file. Included files can override. Takes precedence over com-
|
||||
modity and D.
|
||||
direc- effects ends
|
||||
tive at
|
||||
file
|
||||
end?
|
||||
----------------------------------------------------------------------------------
|
||||
account Declare an account, for checking all entries in all files;
|
||||
and its display order and type, for reports. Subdirectives:
|
||||
any text, ignored.
|
||||
alias Rewrites account names, in following entries until end of Y
|
||||
current file or end aliases.
|
||||
apply Prepends a common parent account to all account names, in Y
|
||||
account following entries until end of current file or end apply
|
||||
account.
|
||||
comment Ignores part of the journal file, until end of current file Y
|
||||
or end comment.
|
||||
commod- Declares a commodity, for checking all entries in all files; N, Y
|
||||
ity the decimal mark for parsing amounts of this commodity, for
|
||||
following entries until end of current file; and its display
|
||||
style, for reports. Takes precedence over D. Subdirectives:
|
||||
format (alternate syntax).
|
||||
D Sets a default commodity to use for no-symbol amounts, and Y
|
||||
its decimal mark for parsing amounts of this commodity in
|
||||
following entries until end of current file; and its display
|
||||
style, for reports.
|
||||
deci- Declares the decimal mark, for parsing amounts of all com- Y
|
||||
mal- modities in following entries until next decimal-mark or end
|
||||
mark of current file. Included files can override. Takes prece-
|
||||
dence over commodity and D.
|
||||
include Includes entries and directives from another file, as if they
|
||||
were written inline.
|
||||
payee Declares a payee name, for checking all entries in all files.
|
||||
P Declares a market price for a commodity on some date, for valua-
|
||||
tion reports.
|
||||
Y Declares a year for yearless dates, for following entries until
|
||||
end of current file.
|
||||
~ Declares a periodic transaction rule that generates future trans-
|
||||
(tilde) actions with --forecast and budget goals with balance --budget.
|
||||
= Declares an auto posting rule that generates extra postings on
|
||||
(equals) matched transactions with --auto, in current, parent, and child
|
||||
files (but not sibling files, see #1212).
|
||||
P Declares a market price for a commodity on some date, for
|
||||
valuation reports.
|
||||
Y Declares a year for yearless dates, for following entries Y
|
||||
until end of current file.
|
||||
~ Declares a periodic transaction rule that generates future
|
||||
(tilde) transactions with --forecast and budget goals with balance
|
||||
--budget.
|
||||
= Declares an auto posting rule that generates extra postings partly
|
||||
(equals) on matched transactions with --auto, in current, parent, and
|
||||
child files (but not sibling files, see #1212).
|
||||
|
||||
And here is an overview of which directives are useful for what:
|
||||
|
||||
@ -4925,13 +4929,13 @@ JOURNAL FORMAT
|
||||
Generating extra transactions or ~
|
||||
budget goals
|
||||
Generating extra postings =
|
||||
|
||||
Defining entities to help with account, commodity,
|
||||
error checking payee
|
||||
Defining accounts' display order account
|
||||
and accounting type
|
||||
|
||||
Defining commodity display styles commodity, D -c/--commodity-
|
||||
for output style
|
||||
style
|
||||
|
||||
Directives and multiple files
|
||||
If you use multiple -f/--file options, or the include directive,
|
||||
@ -5820,6 +5824,8 @@ CSV FORMAT
|
||||
records
|
||||
fields list name CSV fields, assign them to hledger
|
||||
fields
|
||||
|
||||
|
||||
field assignment assign a value to one hledger field, with
|
||||
interpolation
|
||||
Field names hledger field names, used in the fields list
|
||||
|
||||
Loading…
Reference in New Issue
Block a user