diff --git a/hledger/Hledger/Cli/Commands/Balance.txt b/hledger/Hledger/Cli/Commands/Balance.txt index d2218401a..76917d4af 100644 --- a/hledger/Hledger/Cli/Commands/Balance.txt +++ b/hledger/Hledger/Cli/Commands/Balance.txt @@ -94,7 +94,9 @@ data fields interpolated like so: %[MIN][.MAX](FIELDNAME) - MIN pads with spaces to at least this width (optional) + - MAX truncates at this width (optional) + - FIELDNAME must be enclosed in parentheses, and can be one of: - depth_spacer - a number of spaces equal to the account's depth, diff --git a/hledger/Hledger/Cli/Commands/Close.txt b/hledger/Hledger/Cli/Commands/Close.txt index ef63cf4d3..bd7d77faa 100644 --- a/hledger/Hledger/Cli/Commands/Close.txt +++ b/hledger/Hledger/Cli/Commands/Close.txt @@ -9,7 +9,7 @@ _FLAGS_ The closing transaction transfers balances to "equity:closing balances". The opening transaction transfers balances from "equity:opening -balances". You can chose to print just one of the transactions by using +balances". You can choose to print just one of the transactions by using the --opening or --closing flag. If you split your journal files by time (eg yearly), you will typically diff --git a/hledger/Hledger/Cli/Commands/Import.txt b/hledger/Hledger/Cli/Commands/Import.txt index bb7f8a930..d958fb8d7 100644 --- a/hledger/Hledger/Cli/Commands/Import.txt +++ b/hledger/Hledger/Cli/Commands/Import.txt @@ -17,3 +17,18 @@ The --dry-run output is in journal format, so you can filter it, eg to see only uncategorised transactions: $ hledger import --dry ... | hledger -f- print unknown --ignore-assertions + +Importing balance assignments: + +Entries added by import will have their posting amounts made explicit +(like hledger print -x). This means that any balance assignments in +imported files must be evaluated; but, imported files don't get to see +the main file's account balances. As a result, importing entries with +balance assignments (eg from an institution that provides only balances +and not posting amounts) will probably generate incorrect posting +amounts. To avoid this problem, use print instead of import: + +$ hledger print IMPORTFILE [--new] >> $LEDGER_FILE + +(If you think import should leave amounts implicit like print does, +please test it and send a pull request.)