update-index doc: note the caveat with "could not open..."

[thirdparty/git.git] / Documentation / git-update-index.txt

diff --git a/Documentation/git-update-index.txt b/Documentation/git-update-index.txt
index f0e08d6a4ce36c24a769d672490421eb16fbabb5..b8d3c0d72e9f270176c479bdbca2a7468e1b1ebc 100644 (file)
--- a/Documentation/git-update-index.txt
+++ b/Documentation/git-update-index.txt
@@ -480,6 +480,16 @@ a directory with a file when it comes to the internal structures of
 the untracked cache, but no case has been reported where this resulted in
 wrong "git status" output.
 
 the untracked cache, but no case has been reported where this resulted in
 wrong "git status" output.
 

+There are also cases where existing indexes written by git versions
+before 2.17 will reference directories that don't exist anymore,
+potentially causing many "could not open directory" warnings to be
+printed on "git status". These are new warnings for existing issues
+that were previously silently discarded.
+
+As with the bug described above the solution is to one-off do a "git
+status" run with `core.untrackedCache=false` to flush out the leftover
+bad data.
+

 File System Monitor
 -------------------
 
 File System Monitor
 -------------------