;doc: regen manuals

[ci skip]
This commit is contained in:
Simon Michael 2020-06-21 10:36:21 -07:00
parent 24996caaeb
commit ce4de7aeb9
21 changed files with 1066 additions and 1064 deletions

View File

@ -1,6 +1,6 @@
.\"t
.TH "hledger_csv" "5" "June 2020" "hledger 1.18" "hledger User Manuals"
.TH "hledger_csv" "5" "June 2020" "hledger 1.18.99" "hledger User Manuals"

View File

@ -3,8 +3,8 @@ This is hledger_csv.info, produced by makeinfo version 6.7 from stdin.

File: hledger_csv.info, Node: Top, Next: EXAMPLES, Up: (dir)
hledger_csv(5) hledger 1.18
***************************
hledger_csv(5) hledger 1.18.99
******************************
CSV - how hledger reads CSV data, and the CSV rules file format
@ -1036,74 +1036,74 @@ command the user specified.

Tag Table:
Node: Top72
Node: EXAMPLES2174
Ref: #examples2280
Node: Basic2488
Ref: #basic2588
Node: Bank of Ireland3130
Ref: #bank-of-ireland3265
Node: Amazon4727
Ref: #amazon4845
Node: Paypal6564
Ref: #paypal6658
Node: CSV RULES14302
Ref: #csv-rules14411
Node: skip14687
Ref: #skip14780
Node: fields15155
Ref: #fields15277
Node: Transaction field names16442
Ref: #transaction-field-names16602
Node: Posting field names16713
Ref: #posting-field-names16865
Node: account16935
Ref: #account17051
Node: amount17588
Ref: #amount17719
Node: currency18826
Ref: #currency18961
Node: balance19167
Ref: #balance19301
Node: comment19618
Ref: #comment19735
Node: field assignment19898
Ref: #field-assignment20041
Node: separator20859
Ref: #separator20988
Node: if21399
Ref: #if21501
Node: end23657
Ref: #end23763
Node: date-format23987
Ref: #date-format24119
Node: newest-first24868
Ref: #newest-first25006
Node: include25689
Ref: #include25818
Node: balance-type26262
Ref: #balance-type26382
Node: TIPS27082
Ref: #tips27164
Node: Rapid feedback27420
Ref: #rapid-feedback27537
Node: Valid CSV27997
Ref: #valid-csv28127
Node: File Extension28319
Ref: #file-extension28471
Node: Reading multiple CSV files28881
Ref: #reading-multiple-csv-files29066
Node: Valid transactions29307
Ref: #valid-transactions29485
Node: Deduplicating importing30113
Ref: #deduplicating-importing30292
Node: Setting amounts31325
Ref: #setting-amounts31494
Node: Setting currency/commodity32481
Ref: #setting-currencycommodity32673
Node: Referencing other fields33476
Ref: #referencing-other-fields33676
Node: How CSV rules are evaluated34573
Ref: #how-csv-rules-are-evaluated34746
Node: EXAMPLES2180
Ref: #examples2286
Node: Basic2494
Ref: #basic2594
Node: Bank of Ireland3136
Ref: #bank-of-ireland3271
Node: Amazon4733
Ref: #amazon4851
Node: Paypal6570
Ref: #paypal6664
Node: CSV RULES14308
Ref: #csv-rules14417
Node: skip14693
Ref: #skip14786
Node: fields15161
Ref: #fields15283
Node: Transaction field names16448
Ref: #transaction-field-names16608
Node: Posting field names16719
Ref: #posting-field-names16871
Node: account16941
Ref: #account17057
Node: amount17594
Ref: #amount17725
Node: currency18832
Ref: #currency18967
Node: balance19173
Ref: #balance19307
Node: comment19624
Ref: #comment19741
Node: field assignment19904
Ref: #field-assignment20047
Node: separator20865
Ref: #separator20994
Node: if21405
Ref: #if21507
Node: end23663
Ref: #end23769
Node: date-format23993
Ref: #date-format24125
Node: newest-first24874
Ref: #newest-first25012
Node: include25695
Ref: #include25824
Node: balance-type26268
Ref: #balance-type26388
Node: TIPS27088
Ref: #tips27170
Node: Rapid feedback27426
Ref: #rapid-feedback27543
Node: Valid CSV28003
Ref: #valid-csv28133
Node: File Extension28325
Ref: #file-extension28477
Node: Reading multiple CSV files28887
Ref: #reading-multiple-csv-files29072
Node: Valid transactions29313
Ref: #valid-transactions29491
Node: Deduplicating importing30119
Ref: #deduplicating-importing30298
Node: Setting amounts31331
Ref: #setting-amounts31500
Node: Setting currency/commodity32487
Ref: #setting-currencycommodity32679
Node: Referencing other fields33482
Ref: #referencing-other-fields33682
Node: How CSV rules are evaluated34579
Ref: #how-csv-rules-are-evaluated34752

End Tag Table

View File

@ -852,4 +852,4 @@ SEE ALSO
hledger 1.18 June 2020 hledger_csv(5)
hledger 1.18.99 June 2020 hledger_csv(5)

View File

@ -1,6 +1,6 @@
.\"t
.TH "hledger_journal" "5" "June 2020" "hledger 1.18" "hledger User Manuals"
.TH "hledger_journal" "5" "June 2020" "hledger 1.18.99" "hledger User Manuals"
@ -1143,15 +1143,20 @@ files can be included (not CSV files, currently).
If the file path does not begin with a slash, it is relative to the
current file\[aq]s folder.
.PP
It may contain glob patterns to match multiple files, eg:
A tilde means home directory, eg: \f[C]include \[ti]/main.journal\f[R].
.PP
The path may contain glob patterns to match multiple files, eg:
\f[C]include *.journal\f[R].
.PP
Or a tilde, meaning home directory:
\f[C]include \[ti]/main.journal\f[R].
There is limited support for recursive wildcards: \f[C]**/\f[R] (the
slash is required) matches 0 or more subdirectories.
It\[aq]s not super convenient since you have to avoid include cycles and
including directories, but this can be done, eg:
\f[C]include */**/*.journal\f[R].
.PP
It may also be prefixed to force a specific file format, overriding the
file extension (as described in hledger.1 -> Input files):
\f[C]include timedot:\[ti]/notes/2020*.md\f[R].
The path may also be prefixed to force a specific file format,
overriding the file extension (as described in hledger.1 -> Input
files): \f[C]include timedot:\[ti]/notes/2020*.md\f[R].
.SS Default year
.PP
You can set a default year to be used for subsequent dates which

View File

@ -4,8 +4,8 @@ stdin.

File: hledger_journal.info, Node: Top, Up: (dir)
hledger_journal(5) hledger 1.18
*******************************
hledger_journal(5) hledger 1.18.99
**********************************
Journal - hledger's default file format, representing a General Journal
@ -1023,14 +1023,19 @@ timedot files can be included (not CSV files, currently).
If the file path does not begin with a slash, it is relative to the
current file's folder.
It may contain glob patterns to match multiple files, eg: 'include
*.journal'.
A tilde means home directory, eg: 'include ~/main.journal'.
Or a tilde, meaning home directory: 'include ~/main.journal'.
The path may contain glob patterns to match multiple files, eg:
'include *.journal'.
It may also be prefixed to force a specific file format, overriding
the file extension (as described in hledger.1 -> Input files): 'include
timedot:~/notes/2020*.md'.
There is limited support for recursive wildcards: '**/' (the slash is
required) matches 0 or more subdirectories. It's not super convenient
since you have to avoid include cycles and including directories, but
this can be done, eg: 'include */**/*.journal'.
The path may also be prefixed to force a specific file format,
overriding the file extension (as described in hledger.1 -> Input
files): 'include timedot:~/notes/2020*.md'.

File: hledger_journal.info, Node: Default year, Next: Declaring commodities, Prev: Including other files, Up: Directives
@ -1823,124 +1828,124 @@ will have these tags added:

Tag Table:
Node: Top76
Node: Transactions1869
Ref: #transactions1961
Node: Dates3245
Ref: #dates3344
Node: Simple dates3409
Ref: #simple-dates3535
Node: Secondary dates4044
Ref: #secondary-dates4198
Node: Posting dates5534
Ref: #posting-dates5663
Node: Status7035
Ref: #status7156
Node: Description8864
Ref: #description8998
Node: Payee and note9318
Ref: #payee-and-note9432
Node: Comments9767
Ref: #comments9893
Node: Tags11087
Ref: #tags11202
Node: Postings12595
Ref: #postings12723
Node: Virtual postings13749
Ref: #virtual-postings13866
Node: Account names15171
Ref: #account-names15312
Node: Amounts15799
Ref: #amounts15938
Node: Digit group marks17046
Ref: #digit-group-marks17194
Node: Amount display style18132
Ref: #amount-display-style18286
Node: Transaction prices19723
Ref: #transaction-prices19895
Node: Lot prices and lot dates22227
Ref: #lot-prices-and-lot-dates22424
Node: Balance assertions22912
Ref: #balance-assertions23098
Node: Assertions and ordering24131
Ref: #assertions-and-ordering24319
Node: Assertions and included files25019
Ref: #assertions-and-included-files25262
Node: Assertions and multiple -f options25595
Ref: #assertions-and-multiple--f-options25851
Node: Assertions and commodities25983
Ref: #assertions-and-commodities26215
Node: Assertions and prices27372
Ref: #assertions-and-prices27586
Node: Assertions and subaccounts28026
Ref: #assertions-and-subaccounts28255
Node: Assertions and virtual postings28579
Ref: #assertions-and-virtual-postings28821
Node: Assertions and precision28963
Ref: #assertions-and-precision29156
Node: Balance assignments29423
Ref: #balance-assignments29597
Node: Balance assignments and prices30761
Ref: #balance-assignments-and-prices30933
Node: Directives31157
Ref: #directives31316
Node: Directives and multiple files37007
Ref: #directives-and-multiple-files37190
Node: Comment blocks37854
Ref: #comment-blocks38037
Node: Including other files38213
Ref: #including-other-files38393
Node: Default year39044
Ref: #default-year39213
Node: Declaring commodities39620
Ref: #declaring-commodities39803
Node: Default commodity41609
Ref: #default-commodity41795
Node: Declaring market prices42684
Ref: #declaring-market-prices42879
Node: Declaring accounts43736
Ref: #declaring-accounts43922
Node: Account comments44847
Ref: #account-comments45010
Node: Account subdirectives45434
Ref: #account-subdirectives45629
Node: Account types45942
Ref: #account-types46126
Node: Account display order47765
Ref: #account-display-order47935
Node: Rewriting accounts49086
Ref: #rewriting-accounts49271
Node: Basic aliases50028
Ref: #basic-aliases50174
Node: Regex aliases50878
Ref: #regex-aliases51050
Node: Combining aliases51768
Ref: #combining-aliases51961
Node: Aliases and multiple files53237
Ref: #aliases-and-multiple-files53446
Node: end aliases54025
Ref: #end-aliases54182
Node: Default parent account54283
Ref: #default-parent-account54451
Node: Periodic transactions55335
Ref: #periodic-transactions55510
Node: Periodic rule syntax57382
Ref: #periodic-rule-syntax57588
Node: Two spaces between period expression and description!58292
Ref: #two-spaces-between-period-expression-and-description58611
Node: Forecasting with periodic transactions59295
Ref: #forecasting-with-periodic-transactions59600
Node: Budgeting with periodic transactions61655
Ref: #budgeting-with-periodic-transactions61894
Node: Auto postings62343
Ref: #auto-postings62483
Node: Auto postings and multiple files64662
Ref: #auto-postings-and-multiple-files64866
Node: Auto postings and dates65075
Ref: #auto-postings-and-dates65349
Node: Auto postings and transaction balancing / inferred amounts / balance assertions65524
Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions65875
Node: Auto posting tags66217
Ref: #auto-posting-tags66432
Node: Transactions1875
Ref: #transactions1967
Node: Dates3251
Ref: #dates3350
Node: Simple dates3415
Ref: #simple-dates3541
Node: Secondary dates4050
Ref: #secondary-dates4204
Node: Posting dates5540
Ref: #posting-dates5669
Node: Status7041
Ref: #status7162
Node: Description8870
Ref: #description9004
Node: Payee and note9324
Ref: #payee-and-note9438
Node: Comments9773
Ref: #comments9899
Node: Tags11093
Ref: #tags11208
Node: Postings12601
Ref: #postings12729
Node: Virtual postings13755
Ref: #virtual-postings13872
Node: Account names15177
Ref: #account-names15318
Node: Amounts15805
Ref: #amounts15944
Node: Digit group marks17052
Ref: #digit-group-marks17200
Node: Amount display style18138
Ref: #amount-display-style18292
Node: Transaction prices19729
Ref: #transaction-prices19901
Node: Lot prices and lot dates22233
Ref: #lot-prices-and-lot-dates22430
Node: Balance assertions22918
Ref: #balance-assertions23104
Node: Assertions and ordering24137
Ref: #assertions-and-ordering24325
Node: Assertions and included files25025
Ref: #assertions-and-included-files25268
Node: Assertions and multiple -f options25601
Ref: #assertions-and-multiple--f-options25857
Node: Assertions and commodities25989
Ref: #assertions-and-commodities26221
Node: Assertions and prices27378
Ref: #assertions-and-prices27592
Node: Assertions and subaccounts28032
Ref: #assertions-and-subaccounts28261
Node: Assertions and virtual postings28585
Ref: #assertions-and-virtual-postings28827
Node: Assertions and precision28969
Ref: #assertions-and-precision29162
Node: Balance assignments29429
Ref: #balance-assignments29603
Node: Balance assignments and prices30767
Ref: #balance-assignments-and-prices30939
Node: Directives31163
Ref: #directives31322
Node: Directives and multiple files37013
Ref: #directives-and-multiple-files37196
Node: Comment blocks37860
Ref: #comment-blocks38043
Node: Including other files38219
Ref: #including-other-files38399
Node: Default year39323
Ref: #default-year39492
Node: Declaring commodities39899
Ref: #declaring-commodities40082
Node: Default commodity41888
Ref: #default-commodity42074
Node: Declaring market prices42963
Ref: #declaring-market-prices43158
Node: Declaring accounts44015
Ref: #declaring-accounts44201
Node: Account comments45126
Ref: #account-comments45289
Node: Account subdirectives45713
Ref: #account-subdirectives45908
Node: Account types46221
Ref: #account-types46405
Node: Account display order48044
Ref: #account-display-order48214
Node: Rewriting accounts49365
Ref: #rewriting-accounts49550
Node: Basic aliases50307
Ref: #basic-aliases50453
Node: Regex aliases51157
Ref: #regex-aliases51329
Node: Combining aliases52047
Ref: #combining-aliases52240
Node: Aliases and multiple files53516
Ref: #aliases-and-multiple-files53725
Node: end aliases54304
Ref: #end-aliases54461
Node: Default parent account54562
Ref: #default-parent-account54730
Node: Periodic transactions55614
Ref: #periodic-transactions55789
Node: Periodic rule syntax57661
Ref: #periodic-rule-syntax57867
Node: Two spaces between period expression and description!58571
Ref: #two-spaces-between-period-expression-and-description58890
Node: Forecasting with periodic transactions59574
Ref: #forecasting-with-periodic-transactions59879
Node: Budgeting with periodic transactions61934
Ref: #budgeting-with-periodic-transactions62173
Node: Auto postings62622
Ref: #auto-postings62762
Node: Auto postings and multiple files64941
Ref: #auto-postings-and-multiple-files65145
Node: Auto postings and dates65354
Ref: #auto-postings-and-dates65628
Node: Auto postings and transaction balancing / inferred amounts / balance assertions65803
Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions66154
Node: Auto posting tags66496
Ref: #auto-posting-tags66711

End Tag Table

View File

@ -792,14 +792,19 @@ FILE FORMAT
If the file path does not begin with a slash, it is relative to the
current file's folder.
It may contain glob patterns to match multiple files, eg: include
A tilde means home directory, eg: include ~/main.journal.
The path may contain glob patterns to match multiple files, eg: include
*.journal.
Or a tilde, meaning home directory: include ~/main.journal.
There is limited support for recursive wildcards: **/ (the slash is re-
quired) matches 0 or more subdirectories. It's not super convenient
since you have to avoid include cycles and including directories, but
this can be done, eg: include */**/*.journal.
It may also be prefixed to force a specific file format, overriding the
file extension (as described in hledger.1 -> Input files): include
timedot:~/notes/2020*.md.
The path may also be prefixed to force a specific file format, overrid-
ing the file extension (as described in hledger.1 -> Input files): in-
clude timedot:~/notes/2020*.md.
Default year
You can set a default year to be used for subsequent dates which don't
@ -1480,4 +1485,4 @@ SEE ALSO
hledger 1.18 June 2020 hledger_journal(5)
hledger 1.18.99 June 2020 hledger_journal(5)

View File

@ -1,5 +1,5 @@
.TH "hledger_timeclock" "5" "June 2020" "hledger 1.18" "hledger User Manuals"
.TH "hledger_timeclock" "5" "June 2020" "hledger 1.18.99" "hledger User Manuals"

View File

@ -4,8 +4,8 @@ stdin.

File: hledger_timeclock.info, Node: Top, Up: (dir)
hledger_timeclock(5) hledger 1.18
*********************************
hledger_timeclock(5) hledger 1.18.99
************************************
Timeclock - the time logging format of timeclock.el, as read by hledger

View File

@ -78,4 +78,4 @@ SEE ALSO
hledger 1.18 June 2020 hledger_timeclock(5)
hledger 1.18.99 June 2020 hledger_timeclock(5)

View File

@ -1,5 +1,5 @@
.TH "hledger_timedot" "5" "June 2020" "hledger 1.18" "hledger User Manuals"
.TH "hledger_timedot" "5" "June 2020" "hledger 1.18.99" "hledger User Manuals"

View File

@ -4,8 +4,8 @@ stdin.

File: hledger_timedot.info, Node: Top, Up: (dir)
hledger_timedot(5) hledger 1.18
*******************************
hledger_timedot(5) hledger 1.18.99
**********************************
Timedot - hledger's human-friendly time logging format

View File

@ -161,4 +161,4 @@ SEE ALSO
hledger 1.18 June 2020 hledger_timedot(5)
hledger 1.18.99 June 2020 hledger_timedot(5)

View File

@ -1,5 +1,5 @@
.TH "hledger-ui" "1" "June 2020" "hledger-ui 1.18" "hledger User Manuals"
.TH "hledger-ui" "1" "June 2020" "hledger-ui 1.18.99" "hledger User Manuals"

View File

@ -3,8 +3,8 @@ This is hledger-ui.info, produced by makeinfo version 6.7 from stdin.

File: hledger-ui.info, Node: Top, Next: OPTIONS, Up: (dir)
hledger-ui(1) hledger-ui 1.18
*****************************
hledger-ui(1) hledger-ui 1.18.99
********************************
hledger-ui - terminal interface for the hledger accounting tool
@ -508,26 +508,26 @@ program is restarted.

Tag Table:
Node: Top71
Node: OPTIONS1470
Ref: #options1567
Node: KEYS5182
Ref: #keys5277
Node: SCREENS9553
Ref: #screens9658
Node: Accounts screen9748
Ref: #accounts-screen9876
Node: Register screen12092
Ref: #register-screen12247
Node: Transaction screen14244
Ref: #transaction-screen14402
Node: Error screen15272
Ref: #error-screen15394
Node: ENVIRONMENT15638
Ref: #environment15752
Node: FILES16559
Ref: #files16658
Node: BUGS16871
Ref: #bugs16948
Node: OPTIONS1476
Ref: #options1573
Node: KEYS5188
Ref: #keys5283
Node: SCREENS9559
Ref: #screens9664
Node: Accounts screen9754
Ref: #accounts-screen9882
Node: Register screen12098
Ref: #register-screen12253
Node: Transaction screen14250
Ref: #transaction-screen14408
Node: Error screen15278
Ref: #error-screen15400
Node: ENVIRONMENT15644
Ref: #environment15758
Node: FILES16565
Ref: #files16664
Node: BUGS16877
Ref: #bugs16954

End Tag Table

View File

@ -450,4 +450,4 @@ SEE ALSO
hledger-ui 1.18 June 2020 hledger-ui(1)
hledger-ui 1.18.99 June 2020 hledger-ui(1)

View File

@ -1,5 +1,5 @@
.TH "hledger-web" "1" "June 2020" "hledger-web 1.18" "hledger User Manuals"
.TH "hledger-web" "1" "June 2020" "hledger-web 1.18.99" "hledger User Manuals"

View File

@ -3,8 +3,8 @@ This is hledger-web.info, produced by makeinfo version 6.7 from stdin.

File: hledger-web.info, Node: Top, Next: OPTIONS, Up: (dir)
hledger-web(1) hledger-web 1.18
*******************************
hledger-web(1) hledger-web 1.18.99
**********************************
hledger-web - web interface for the hledger accounting tool
@ -573,22 +573,22 @@ awkward.

Tag Table:
Node: Top72
Node: OPTIONS1746
Ref: #options1851
Node: PERMISSIONS8379
Ref: #permissions8518
Node: EDITING UPLOADING DOWNLOADING9730
Ref: #editing-uploading-downloading9911
Node: RELOADING10745
Ref: #reloading10879
Node: JSON API11312
Ref: #json-api11426
Node: ENVIRONMENT16907
Ref: #environment17023
Node: FILES17756
Ref: #files17856
Node: BUGS18069
Ref: #bugs18147
Node: OPTIONS1752
Ref: #options1857
Node: PERMISSIONS8385
Ref: #permissions8524
Node: EDITING UPLOADING DOWNLOADING9736
Ref: #editing-uploading-downloading9917
Node: RELOADING10751
Ref: #reloading10885
Node: JSON API11318
Ref: #json-api11432
Node: ENVIRONMENT16913
Ref: #environment17029
Node: FILES17762
Ref: #files17862
Node: BUGS18075
Ref: #bugs18153

End Tag Table

View File

@ -538,4 +538,4 @@ SEE ALSO
hledger-web 1.18 June 2020 hledger-web(1)
hledger-web 1.18.99 June 2020 hledger-web(1)

View File

@ -1,6 +1,6 @@
.\"t
.TH "hledger" "1" "June 2020" "hledger 1.18" "hledger User Manuals"
.TH "hledger" "1" "June 2020" "hledger 1.18.99" "hledger User Manuals"
@ -1679,18 +1679,12 @@ $ hledger balance --pivot member acct:.
.SS Valuation
.PP
Instead of reporting amounts in their original commodity, hledger can
convert them to:
.IP \[bu] 2
cost (or sale amount), using the conversion rate recorded as part of the
transaction (transaction price).
.IP \[bu] 2
value, using the market prices in effect on certain date(s).
.PP
We call this \[dq]valuation\[dq], and it is controlled in full by the
\f[C]--value=VALUATIONTYPE[,COMMODITY]\f[R] option.
But we also provide simpler, Ledger-compatible
\f[C]-B\f[R]/\f[C]-V\f[R]/\f[C]-X\f[R] flags, and usually one of these
is all you need:
convert them to cost/sale amount (using the conversion rate recorded in
the transaction), or to market value (using some market price on a
certain date).
This is controlled by the \f[C]--value=TYPE[,COMMODITY]\f[R] option, but
we also provide the simpler \f[C]-B\f[R]/\f[C]-V\f[R]/\f[C]-X\f[R]
flags, and usually one of those is all you need.
.SS -B: Cost
.PP
The \f[C]-B/--cost\f[R] flag converts amounts to their cost or sale
@ -1700,13 +1694,18 @@ amount at transaction time, if they have a transaction price specified.
The \f[C]-V/--market\f[R] flag converts amounts to market value in their
default \f[I]valuation commodity\f[R], using the market prices in effect
on the \f[I]valuation date(s)\f[R], if any.
More on these things in a minute.
More on these in a minute.
.SS -X: Value in specified commodity
.PP
The \f[C]-X/--exchange\f[R] option is like \f[C]-V\f[R] except the
desired valuation currency is specified explicitly.
The \f[C]-X/--exchange=COMM\f[R] option is like \f[C]-V\f[R], except you
tell it which currency you want to convert to, and it tries to convert
everything to that.
.SS Valuation date
.PP
Since market prices can change from day to day, market value reports
have a valuation date (or more than one), which determines which market
prices will be used.
.PP
For single period reports, if an explicit report end date is specified,
that will be used as the valuation date; otherwise the valuation date is
\[dq]today\[dq].
@ -1751,11 +1750,10 @@ Adding the \f[C]--infer-value\f[R] flag to \f[C]-V\f[R], \f[C]-X\f[R] or
So for example, \f[C]hledger bs -V --infer-value\f[R] will get market
prices both from P directives and from transactions.
.PP
There is a downside to this: value reports can be affected in
There is a downside: value reports can sometimes be affected in
confusing/undesired ways by your journal entries.
If this happens to you, read all of this Valuation section carefully,
and try adding \f[C]--debug\f[R] or \f[C]--debug=2\f[R] to troubleshoot
the reason.
and try adding \f[C]--debug\f[R] or \f[C]--debug=2\f[R] to troubleshoot.
.PP
\f[C]--infer-value\f[R] can infer market prices from:
.IP \[bu] 2
@ -1801,17 +1799,15 @@ If there are no P directives at all (any commodity or date) and the
\f[C]--infer-value\f[R] flag is used: the price commodity from the
latest transaction-inferred price for A on or before valuation date.
.PP
Amounts for which no valuation commodity can be found are not converted.
.PP
This means:
.IP \[bu] 2
If you have any P directives, they alone determine which commodities
\f[C]-V\f[R] will convert, and to what.
If you have P directives, they determine which commodities \f[C]-V\f[R]
will convert, and to what.
.IP \[bu] 2
If you have no P directives, and you add the \f[C]--infer-value\f[R]
flag, transaction prices determine what \f[C]-V\f[R] converts.
.IP \[bu] 2
\f[C]-X\f[R] tries harder to convert everything to just one commodity.
If you have no P directives, and use the \f[C]--infer-value\f[R] flag,
transaction prices determine it.
.PP
Amounts for which no valuation commodity can be found are not converted.
.SS Simple valuation examples
.PP
Here are some quick examples of \f[C]-V\f[R]:

View File

@ -3,8 +3,8 @@ This is hledger.info, produced by makeinfo version 6.7 from stdin.

File: hledger.info, Node: Top, Next: COMMON TASKS, Up: (dir)
hledger(1) hledger 1.18
***********************
hledger(1) hledger 1.18.99
**************************
hledger - a command-line accounting tool
@ -1373,17 +1373,11 @@ File: hledger.info, Node: Valuation, Prev: Pivoting, Up: OPTIONS
==============
Instead of reporting amounts in their original commodity, hledger can
convert them to:
* cost (or sale amount), using the conversion rate recorded as part
of the transaction (transaction price).
* value, using the market prices in effect on certain date(s).
We call this "valuation", and it is controlled in full by the
'--value=VALUATIONTYPE[,COMMODITY]' option. But we also provide
simpler, Ledger-compatible '-B'/'-V'/'-X' flags, and usually one of
these is all you need:
convert them to cost/sale amount (using the conversion rate recorded in
the transaction), or to market value (using some market price on a
certain date). This is controlled by the '--value=TYPE[,COMMODITY]'
option, but we also provide the simpler '-B'/'-V'/'-X' flags, and
usually one of those is all you need.
* Menu:
@ -1416,7 +1410,7 @@ File: hledger.info, Node: -V Value, Next: -X Value in specified commodity, Pr
The '-V/--market' flag converts amounts to market value in their default
_valuation commodity_, using the market prices in effect on the
_valuation date(s)_, if any. More on these things in a minute.
_valuation date(s)_, if any. More on these in a minute.

File: hledger.info, Node: -X Value in specified commodity, Next: Valuation date, Prev: -V Value, Up: Valuation
@ -1424,8 +1418,9 @@ File: hledger.info, Node: -X Value in specified commodity, Next: Valuation dat
2.17.3 -X: Value in specified commodity
---------------------------------------
The '-X/--exchange' option is like '-V' except the desired valuation
currency is specified explicitly.
The '-X/--exchange=COMM' option is like '-V', except you tell it which
currency you want to convert to, and it tries to convert everything to
that.

File: hledger.info, Node: Valuation date, Next: Market prices, Prev: -X Value in specified commodity, Up: Valuation
@ -1433,9 +1428,13 @@ File: hledger.info, Node: Valuation date, Next: Market prices, Prev: -X Value
2.17.4 Valuation date
---------------------
For single period reports, if an explicit report end date is specified,
that will be used as the valuation date; otherwise the valuation date is
"today".
Since market prices can change from day to day, market value reports
have a valuation date (or more than one), which determines which market
prices will be used.
For single period reports, if an explicit report end date is
specified, that will be used as the valuation date; otherwise the
valuation date is "today".
For multiperiod reports, each column/period is valued on the last day
of the period.
@ -1486,10 +1485,10 @@ needing P directives at all.
this. So for example, 'hledger bs -V --infer-value' will get market
prices both from P directives and from transactions.
There is a downside to this: value reports can be affected in
There is a downside: value reports can sometimes be affected in
confusing/undesired ways by your journal entries. If this happens to
you, read all of this Valuation section carefully, and try adding
'--debug' or '--debug=2' to troubleshoot the reason.
'--debug' or '--debug=2' to troubleshoot.
'--infer-value' can infer market prices from:
@ -1531,18 +1530,16 @@ follows, in this order of preference:
'--infer-value' flag is used: the price commodity from the latest
transaction-inferred price for A on or before valuation date.
Amounts for which no valuation commodity can be found are not
converted.
This means:
* If you have any P directives, they alone determine which
commodities '-V' will convert, and to what.
* If you have P directives, they determine which commodities '-V'
will convert, and to what.
* If you have no P directives, and you add the '--infer-value' flag,
transaction prices determine what '-V' converts.
* If you have no P directives, and use the '--infer-value' flag,
transaction prices determine it.
* '-X' tries harder to convert everything to just one commodity.
Amounts for which no valuation commodity can be found are not
converted.

File: hledger.info, Node: Simple valuation examples, Next: --value Flexible valuation, Prev: Valuation commodity, Up: Valuation
@ -3861,197 +3858,197 @@ $ LANG=en_US.UTF-8 hledger -f my.journal print

Tag Table:
Node: Top68
Node: COMMON TASKS2315
Ref: #common-tasks2427
Node: Getting help2834
Ref: #getting-help2966
Node: Constructing command lines3519
Ref: #constructing-command-lines3711
Node: Starting a journal file4408
Ref: #starting-a-journal-file4606
Node: Setting opening balances5794
Ref: #setting-opening-balances5990
Node: Recording transactions9131
Ref: #recording-transactions9311
Node: Reconciling9867
Ref: #reconciling10010
Node: Reporting12267
Ref: #reporting12407
Node: Migrating to a new file16406
Ref: #migrating-to-a-new-file16554
Node: OPTIONS16853
Ref: #options16960
Node: General options17330
Ref: #general-options17455
Node: Command options20409
Ref: #command-options20560
Node: Command arguments20958
Ref: #command-arguments21105
Node: Queries21985
Ref: #queries22140
Node: Special characters in arguments and queries26102
Ref: #special-characters-in-arguments-and-queries26330
Node: More escaping26781
Ref: #more-escaping26943
Node: Even more escaping27239
Ref: #even-more-escaping27433
Node: Less escaping28104
Ref: #less-escaping28266
Node: Unicode characters28511
Ref: #unicode-characters28693
Node: Input files30105
Ref: #input-files30248
Node: Output destination32177
Ref: #output-destination32329
Node: Output format32754
Ref: #output-format32904
Node: Regular expressions34486
Ref: #regular-expressions34643
Node: Smart dates36379
Ref: #smart-dates36530
Node: Report start & end date37891
Ref: #report-start-end-date38063
Node: Report intervals39560
Ref: #report-intervals39725
Node: Period expressions40115
Ref: #period-expressions40275
Node: Depth limiting44411
Ref: #depth-limiting44555
Node: Pivoting44887
Ref: #pivoting45010
Node: Valuation46686
Ref: #valuation46788
Node: -B Cost47588
Ref: #b-cost47692
Node: -V Value47825
Ref: #v-value47971
Node: -X Value in specified commodity48173
Ref: #x-value-in-specified-commodity48372
Node: Valuation date48476
Ref: #valuation-date48644
Node: Market prices48888
Ref: #market-prices49068
Node: --infer-value market prices from transactions49845
Ref: #infer-value-market-prices-from-transactions50094
Node: Valuation commodity51385
Ref: #valuation-commodity51594
Node: Simple valuation examples52919
Ref: #simple-valuation-examples53121
Node: --value Flexible valuation53780
Ref: #value-flexible-valuation53988
Node: More valuation examples55935
Ref: #more-valuation-examples56144
Node: Effect of valuation on reports58149
Ref: #effect-of-valuation-on-reports58337
Node: COMMANDS63858
Ref: #commands63966
Node: accounts65050
Ref: #accounts65148
Node: activity65847
Ref: #activity65957
Node: add66340
Ref: #add66439
Node: balance69178
Ref: #balance69289
Node: Classic balance report70747
Ref: #classic-balance-report70920
Node: Customising the classic balance report72289
Ref: #customising-the-classic-balance-report72517
Node: Colour support74593
Ref: #colour-support74760
Node: Flat mode74933
Ref: #flat-mode75081
Node: Depth limited balance reports75494
Ref: #depth-limited-balance-reports75679
Node: Percentages76135
Ref: #percentages76301
Node: Multicolumn balance report77438
Ref: #multicolumn-balance-report77618
Node: Budget report82880
Ref: #budget-report83023
Node: Nested budgets88289
Ref: #nested-budgets88401
Ref: #output-format-191882
Node: balancesheet92079
Ref: #balancesheet92215
Node: balancesheetequity93681
Ref: #balancesheetequity93830
Node: cashflow94553
Ref: #cashflow94681
Node: check-dates95860
Ref: #check-dates95987
Node: check-dupes96266
Ref: #check-dupes96390
Node: close96683
Ref: #close96797
Node: close usage98319
Ref: #close-usage98412
Node: commodities101225
Ref: #commodities101352
Node: descriptions101434
Ref: #descriptions101562
Node: diff101743
Ref: #diff101849
Node: files102896
Ref: #files102996
Node: help103143
Ref: #help103243
Node: import104324
Ref: #import104438
Node: Importing balance assignments105331
Ref: #importing-balance-assignments105479
Node: incomestatement106128
Ref: #incomestatement106261
Node: notes107748
Ref: #notes107861
Node: payees107987
Ref: #payees108093
Node: prices108251
Ref: #prices108357
Node: print108698
Ref: #print108808
Node: print-unique113594
Ref: #print-unique113720
Node: register114005
Ref: #register114132
Node: Custom register output118304
Ref: #custom-register-output118433
Node: register-match119770
Ref: #register-match119904
Node: rewrite120255
Ref: #rewrite120370
Node: Re-write rules in a file122225
Ref: #re-write-rules-in-a-file122359
Node: Diff output format123569
Ref: #diff-output-format123738
Node: rewrite vs print --auto124830
Ref: #rewrite-vs.-print---auto125009
Node: roi125565
Ref: #roi125663
Node: stats126675
Ref: #stats126774
Node: tags127562
Ref: #tags127660
Node: test127954
Ref: #test128062
Node: Add-on commands128809
Ref: #add-on-commands128926
Node: ui130269
Ref: #ui130357
Node: web130411
Ref: #web130514
Node: iadd130630
Ref: #iadd130741
Node: interest130823
Ref: #interest130930
Node: ENVIRONMENT131170
Ref: #environment131282
Node: FILES132111
Ref: #files-1132214
Node: LIMITATIONS132427
Ref: #limitations132546
Node: TROUBLESHOOTING133288
Ref: #troubleshooting133401
Node: COMMON TASKS2321
Ref: #common-tasks2433
Node: Getting help2840
Ref: #getting-help2972
Node: Constructing command lines3525
Ref: #constructing-command-lines3717
Node: Starting a journal file4414
Ref: #starting-a-journal-file4612
Node: Setting opening balances5800
Ref: #setting-opening-balances5996
Node: Recording transactions9137
Ref: #recording-transactions9317
Node: Reconciling9873
Ref: #reconciling10016
Node: Reporting12273
Ref: #reporting12413
Node: Migrating to a new file16412
Ref: #migrating-to-a-new-file16560
Node: OPTIONS16859
Ref: #options16966
Node: General options17336
Ref: #general-options17461
Node: Command options20415
Ref: #command-options20566
Node: Command arguments20964
Ref: #command-arguments21111
Node: Queries21991
Ref: #queries22146
Node: Special characters in arguments and queries26108
Ref: #special-characters-in-arguments-and-queries26336
Node: More escaping26787
Ref: #more-escaping26949
Node: Even more escaping27245
Ref: #even-more-escaping27439
Node: Less escaping28110
Ref: #less-escaping28272
Node: Unicode characters28517
Ref: #unicode-characters28699
Node: Input files30111
Ref: #input-files30254
Node: Output destination32183
Ref: #output-destination32335
Node: Output format32760
Ref: #output-format32910
Node: Regular expressions34492
Ref: #regular-expressions34649
Node: Smart dates36385
Ref: #smart-dates36536
Node: Report start & end date37897
Ref: #report-start-end-date38069
Node: Report intervals39566
Ref: #report-intervals39731
Node: Period expressions40121
Ref: #period-expressions40281
Node: Depth limiting44417
Ref: #depth-limiting44561
Node: Pivoting44893
Ref: #pivoting45016
Node: Valuation46692
Ref: #valuation46794
Node: -B Cost47483
Ref: #b-cost47587
Node: -V Value47720
Ref: #v-value47866
Node: -X Value in specified commodity48061
Ref: #x-value-in-specified-commodity48260
Node: Valuation date48409
Ref: #valuation-date48577
Node: Market prices48987
Ref: #market-prices49167
Node: --infer-value market prices from transactions49944
Ref: #infer-value-market-prices-from-transactions50193
Node: Valuation commodity51475
Ref: #valuation-commodity51684
Node: Simple valuation examples52910
Ref: #simple-valuation-examples53112
Node: --value Flexible valuation53771
Ref: #value-flexible-valuation53979
Node: More valuation examples55926
Ref: #more-valuation-examples56135
Node: Effect of valuation on reports58140
Ref: #effect-of-valuation-on-reports58328
Node: COMMANDS63849
Ref: #commands63957
Node: accounts65041
Ref: #accounts65139
Node: activity65838
Ref: #activity65948
Node: add66331
Ref: #add66430
Node: balance69169
Ref: #balance69280
Node: Classic balance report70738
Ref: #classic-balance-report70911
Node: Customising the classic balance report72280
Ref: #customising-the-classic-balance-report72508
Node: Colour support74584
Ref: #colour-support74751
Node: Flat mode74924
Ref: #flat-mode75072
Node: Depth limited balance reports75485
Ref: #depth-limited-balance-reports75670
Node: Percentages76126
Ref: #percentages76292
Node: Multicolumn balance report77429
Ref: #multicolumn-balance-report77609
Node: Budget report82871
Ref: #budget-report83014
Node: Nested budgets88280
Ref: #nested-budgets88392
Ref: #output-format-191873
Node: balancesheet92070
Ref: #balancesheet92206
Node: balancesheetequity93672
Ref: #balancesheetequity93821
Node: cashflow94544
Ref: #cashflow94672
Node: check-dates95851
Ref: #check-dates95978
Node: check-dupes96257
Ref: #check-dupes96381
Node: close96674
Ref: #close96788
Node: close usage98310
Ref: #close-usage98403
Node: commodities101216
Ref: #commodities101343
Node: descriptions101425
Ref: #descriptions101553
Node: diff101734
Ref: #diff101840
Node: files102887
Ref: #files102987
Node: help103134
Ref: #help103234
Node: import104315
Ref: #import104429
Node: Importing balance assignments105322
Ref: #importing-balance-assignments105470
Node: incomestatement106119
Ref: #incomestatement106252
Node: notes107739
Ref: #notes107852
Node: payees107978
Ref: #payees108084
Node: prices108242
Ref: #prices108348
Node: print108689
Ref: #print108799
Node: print-unique113585
Ref: #print-unique113711
Node: register113996
Ref: #register114123
Node: Custom register output118295
Ref: #custom-register-output118424
Node: register-match119761
Ref: #register-match119895
Node: rewrite120246
Ref: #rewrite120361
Node: Re-write rules in a file122216
Ref: #re-write-rules-in-a-file122350
Node: Diff output format123560
Ref: #diff-output-format123729
Node: rewrite vs print --auto124821
Ref: #rewrite-vs.-print---auto125000
Node: roi125556
Ref: #roi125654
Node: stats126666
Ref: #stats126765
Node: tags127553
Ref: #tags127651
Node: test127945
Ref: #test128053
Node: Add-on commands128800
Ref: #add-on-commands128917
Node: ui130260
Ref: #ui130348
Node: web130402
Ref: #web130505
Node: iadd130621
Ref: #iadd130732
Node: interest130814
Ref: #interest130921
Node: ENVIRONMENT131161
Ref: #environment131273
Node: FILES132102
Ref: #files-1132205
Node: LIMITATIONS132418
Ref: #limitations132537
Node: TROUBLESHOOTING133279
Ref: #troubleshooting133392

End Tag Table

View File

@ -1190,17 +1190,11 @@ OPTIONS
Valuation
Instead of reporting amounts in their original commodity, hledger can
convert them to:
o cost (or sale amount), using the conversion rate recorded as part of
the transaction (transaction price).
o value, using the market prices in effect on certain date(s).
We call this "valuation", and it is controlled in full by the
--value=VALUATIONTYPE[,COMMODITY] option. But we also provide simpler,
Ledger-compatible -B/-V/-X flags, and usually one of these is all you
need:
convert them to cost/sale amount (using the conversion rate recorded in
the transaction), or to market value (using some market price on a cer-
tain date). This is controlled by the --value=TYPE[,COMMODITY] option,
but we also provide the simpler -B/-V/-X flags, and usually one of
those is all you need.
-B: Cost
The -B/--cost flag converts amounts to their cost or sale amount at
@ -1209,13 +1203,18 @@ OPTIONS
-V: Value
The -V/--market flag converts amounts to market value in their default
valuation commodity, using the market prices in effect on the valuation
date(s), if any. More on these things in a minute.
date(s), if any. More on these in a minute.
-X: Value in specified commodity
The -X/--exchange option is like -V except the desired valuation cur-
rency is specified explicitly.
The -X/--exchange=COMM option is like -V, except you tell it which cur-
rency you want to convert to, and it tries to convert everything to
that.
Valuation date
Since market prices can change from day to day, market value reports
have a valuation date (or more than one), which determines which market
prices will be used.
For single period reports, if an explicit report end date is specified,
that will be used as the valuation date; otherwise the valuation date
is "today".
@ -1259,10 +1258,10 @@ OPTIONS
for example, hledger bs -V --infer-value will get market prices both
from P directives and from transactions.
There is a downside to this: value reports can be affected in confus-
There is a downside: value reports can sometimes be affected in confus-
ing/undesired ways by your journal entries. If this happens to you,
read all of this Valuation section carefully, and try adding --debug or
--debug=2 to troubleshoot the reason.
--debug=2 to troubleshoot.
--infer-value can infer market prices from:
@ -1298,18 +1297,16 @@ OPTIONS
--infer-value flag is used: the price commodity from the latest
transaction-inferred price for A on or before valuation date.
Amounts for which no valuation commodity can be found are not con-
verted.
This means:
o If you have any P directives, they alone determine which commodities
-V will convert, and to what.
o If you have P directives, they determine which commodities -V will
convert, and to what.
o If you have no P directives, and you add the --infer-value flag,
transaction prices determine what -V converts.
o If you have no P directives, and use the --infer-value flag, transac-
tion prices determine it.
o -X tries harder to convert everything to just one commodity.
Amounts for which no valuation commodity can be found are not con-
verted.
Simple valuation examples
Here are some quick examples of -V:
@ -1557,9 +1554,6 @@ OPTIONS
ages (with played val- played val- played val- values
report in- ues ues ues
terval)
column to- sums of dis- sums of dis- not supported sums of dis- sums of dis-
tals played val- played val- played val- played values
ues ues ues
@ -3285,4 +3279,4 @@ SEE ALSO
hledger 1.18 June 2020 hledger(1)
hledger 1.18.99 June 2020 hledger(1)