;doc:cost, value reporting: edits

This commit is contained in:
Simon Michael 2025-02-05 10:26:05 -10:00
parent 57efcfb79a
commit 27e51edbf4

View File

@ -5727,9 +5727,12 @@ format amounts a little bit differently to suit different consumers:
# Cost reporting # Cost reporting
In some transactions - for example a currency conversion, or a purchase or sale of stock - one commodity is exchanged for another. In some transactions - for example a currency conversion, or a purchase
In these transactions there is a conversion rate, also called the cost (when buying) or selling price (when selling). or sale of stock - one commodity is exchanged for another. In these
In hledger docs we just say "cost", for convenience; feel free to mentally translate to "conversion rate" or "selling price" if helpful. transactions there is a conversion rate, also called the cost (when
buying) or selling price (when selling). (In hledger docs we just say
"cost" generically for convenience.)
With the `-B/--cost` flag, hledger can show amounts "at cost", converted to the cost's commodity.
## Recording costs ## Recording costs
@ -5945,12 +5948,11 @@ and let us know what problems you find.
# Value reporting # Value reporting
Instead of reporting amounts in their original commodity, hledger can convert them to hledger can also show amounts "at market value",
cost/sale amount (using the conversion rate recorded in the transaction), converted to some other commodity using the conversion rate, AKA market price, on a certain date.
and/or to market value (using some market price on a certain date). This is controlled by the `--value=TYPE[,COMMODITY]` option, which will be described below. We also provide the simpler `-V`
This is controlled by the `--value=TYPE[,COMMODITY]` option, which will be described below. and `-X COMMODITY` options, and often one of these is all you need.
We also provide the simpler `-V` and `-X COMMODITY` options, and often The market prices are declared with a special `P` directive, and/or they can be inferred from the costs recorded in transactions using the `--infer-market-prices` flag.
one of these is all you need:
## -V: Value ## -V: Value