From e34a20f3dbbd2c98f7048161eab17782dc76d712 Mon Sep 17 00:00:00 2001
From: Simon Michael <simon@joyful.com>
Date: Wed, 15 Feb 2023 20:09:20 -1000
Subject: [PATCH] ;doc: import: note a pitfall with multifile import

---
 hledger/Hledger/Cli/Commands/Import.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/hledger/Hledger/Cli/Commands/Import.md b/hledger/Hledger/Cli/Commands/Import.md
index 438e164f3..b3c3a6feb 100644
--- a/hledger/Hledger/Cli/Commands/Import.md
+++ b/hledger/Hledger/Cli/Commands/Import.md
@@ -76,6 +76,12 @@ or (live updating):
 $ ls bank.csv* | entr bash -c 'echo ====; hledger import --dry bank.csv | hledger -f- -I print unknown'
 ```
 
+Note: when importing from multiple files at once, it's currently possible for
+some .latest files to be updated successfully, while the actual import fails
+because of a problem in one of the files, leaving them out of sync (and causing
+some transactions to be missed, requiring the .latest files to be manually reset).
+To prevent this, do a --dry-run first and fix any problems before the real import.
+
 ### Importing balance assignments
 
 Entries added by import will have their posting amounts made explicit (like `hledger print -x`).