X-Git-Url: http://git.ipfire.org/?a=blobdiff_plain;f=Documentation%2Fgit-update-index.txt;h=b8d3c0d72e9f270176c479bdbca2a7468e1b1ebc;hb=7bf0be75016058e43181ecc22c65b363beb6d24b;hp=f0e08d6a4ce36c24a769d672490421eb16fbabb5;hpb=9b978691b1940024beeccaf8944f7125c746a628;p=thirdparty%2Fgit.git

diff --git a/Documentation/git-update-index.txt b/Documentation/git-update-index.txt
index f0e08d6a4c..b8d3c0d72e 100644
--- 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.
 
+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
 -------------------