diff --git a/hledger-lib/hledger_csv.m4.md b/hledger-lib/hledger_csv.m4.md index c221ddb78..feb2950d0 100644 --- a/hledger-lib/hledger_csv.m4.md +++ b/hledger-lib/hledger_csv.m4.md @@ -233,12 +233,12 @@ It's conventional and recommended to use `account1` for the account whose CSV we ## CSV amounts -An amount must be set, in one of these ways: +A transaction [amount](/journal.html#amounts) must be set, in one of these ways: -- with an `amount` field assignment, which sets the first posting's [amount](/journal.html#amounts) +- with an `amount` field assignment, which sets the first posting's amount -- (If the CSV has debit and credit amounts in separate fields:) with - field assignments for the `amount-in` and `amount-out` pseudo fields +- (When the CSV has debit and credit amounts in separate fields:)\ + with field assignments for the `amount-in` and `amount-out` pseudo fields instead (both of them). Whichever one has a value will be used, with appropriate sign. (If both contain a value, it might not work so well.) @@ -251,7 +251,8 @@ There is some special handling for sign in amounts: If the currency/commodity symbol is provided as a separate CSV field, assign it to the `currency` pseudo field; the symbol will be prepended -to the amount (when there is an amount TODO). +to the amount +(TODO: when there is an amount). Or, you can use an `amount` [field assignment](#field-assignment) more control, eg: ``` fields date,description,currency,amount @@ -263,9 +264,10 @@ amount %amount %currency If the CSV includes a running balance, you can assign that to one of the pseudo fields `balance` (or `balance1`) or `balance2`. This will generate a [balance assertion](/journal.html#balance-assertions) -(or if the amount is left empty, a [balance assignment](/journal.html#balance-assignments)) +(or if the amount is left empty, a [balance assignment](/journal.html#balance-assignments)), on the first or second posting, whenever the running balance field is non-empty. +(TODO: [#1000](https://github.com/simonmichael/hledger/issues/1000)) ## Reading multiple CSV files