slaesvuo/hledger
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

doc: journal: clarify market prices (#403)

Browse Source
This commit is contained in:
Simon Michael 2016-12-29 12:39:39 -08:00
parent fa431f9544
commit 547e6d5438
1 changed files with 9 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
hledger-lib/doc/hledger_journal.5.m4.md
View File

@ -424,18 +424,17 @@ rate of purchases made in a foreign currency.
### Market prices ### Market prices
Market prices are not tied to a particular transaction; they represent Market prices are not tied to a particular transaction; they represent
historical exchange rates between two commodities, usually from some historical exchange rates between two commodities. For example, the prices
public market which publishes such rates. published by a [stock exchange](https://en.wikipedia.org/wiki/Stock_exchange)
or the [foreign exchange market](https://en.wikipedia.org/wiki/Foreign_exchange_market).
When market prices are known, the `-V/--value` option will use them to When market prices are known and in effect at the
convert reported amounts to their market value as of the report end [report end date](hledger.html#report-start-end-date) (see hledger -> Report start & end date),
date. This option is currently available only with the the balance command's `-V/--value` option will show balances as their market value on that date.
[balance](#balance) command. (This option is currently available only with the [balance](#balance) command.)
You record market prices (Ledger calls them historical prices) with a To record market prices (Ledger calls them historical prices), use P directives,
P directive, in the journal or perhaps in a separate in the journal or an [included](#including-other-files) file. Their format is:
[included](#including-other-files) file. Market price directives have
the format:
```journal ```journal
P DATE COMMODITYSYMBOL UNITPRICE P DATE COMMODITYSYMBOL UNITPRICE
``` ```
@ -447,8 +446,6 @@ P 2009/1/1 € $1.35
P 2010/1/1 € $1.40 P 2010/1/1 € $1.40
``` ```
Example use for market prices: tracking the value of stocks.
<!-- <!--
This is different from Ledger, where transaction prices fluctuate by This is different from Ledger, where transaction prices fluctuate by
default. Ledger has a different syntax for specifying default. Ledger has a different syntax for specifying