update-index doc: note the caveat with "could not open..."
Note the caveat where 2.17 is stricter about index validation potentially causing "could not open directory" warnings when git is upgraded. See the preceding "dir.c: stop ignoring opendir() error in open_cached_dir()" change. This caused some mayhem when I upgraded git to a version with this series at Booking.com, and other users have doubtless enabled the UC extension and are in for a surprise when they upgrade. Let's give them a headsup in the docs. Signed-off-by: Ævar Arnfjörð Bjarmason <avarab@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Ævar Arnfjörð Bjarmason committed
Feb 9, 2018 at 21:04 UTC
7bf0be75016058e43181ecc22c65b363beb6d24b
1 file changed
+10
Documentation/git-update-index.txt
+10
@@ -480,6 +480,16 @@ a directory with a file when it comes to the internal structures of
480
the untracked cache, but no case has been reported where this resulted in
481
wrong "git status" output.
482
483
+There are also cases where existing indexes written by git versions
484
+before 2.17 will reference directories that don't exist anymore,
485
+potentially causing many "could not open directory" warnings to be
486
+printed on "git status". These are new warnings for existing issues
487
+that were previously silently discarded.
488
+
489
+As with the bug described above the solution is to one-off do a "git
490
+status" run with `core.untrackedCache=false` to flush out the leftover
491
+bad data.
492
+
493
File System Monitor
494
-------------------
495