From 3b1bd92cf2d456a5a9cda62c4cab095944a2c731 Mon Sep 17 00:00:00 2001 From: Simon Michael Date: Fri, 13 Jun 2025 10:27:56 -1000 Subject: [PATCH] ;doc: add: balance assignments: mention -I [#2406] --- hledger/Hledger/Cli/Commands/Add.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/hledger/Hledger/Cli/Commands/Add.md b/hledger/Hledger/Cli/Commands/Add.md index cc3cf1162..717fb7a59 100644 --- a/hledger/Hledger/Cli/Commands/Add.md +++ b/hledger/Hledger/Cli/Commands/Add.md @@ -72,7 +72,7 @@ You can use `-I`/`--ignore-assertions` to disable this assertion checking. ## add and balance assignments -You can't add new postings which are dated earlier than a balance assignment, currently. -It's because balance assignments are performed once, before `add`; -by the time `add` runs, all amounts in the journal are explicit, and assignments have become assertions. +If you try to add a new posting which is dated earlier than a balance assignment in that account and commodity, it will be rejected. +It's because by the time `add` runs, all balance assignments have been processed and have become assertions. +So if you need to do this, add the `-I` flag to disable assertions temporarily. ([#2406](https://github.com/simonmichael/hledger/issues/2406)).