diff options
author | Junio C Hamano <gitster@pobox.com> | 2018-02-28 15:40:27 -0800 |
---|---|---|
committer | Junio C Hamano <gitster@pobox.com> | 2018-02-28 15:40:27 -0800 |
commit | 615c3b305d84007474d17c62d54fc18c71fdc587 (patch) | |
tree | 3c342628ed177b313bffbdb3250ed18d71046cca /git-update-index.txt | |
parent | 90fd88e4a2ddbb1298553bb804788405aa3e984c (diff) | |
download | git-htmldocs-615c3b305d84007474d17c62d54fc18c71fdc587.tar.gz |
Autogenerated HTML docs for v2.16.2-345-g7e3123
Diffstat (limited to 'git-update-index.txt')
-rw-r--r-- | git-update-index.txt | 30 |
1 files changed, 28 insertions, 2 deletions
diff --git a/git-update-index.txt b/git-update-index.txt index bdb034259..3897a59ee 100644 --- a/git-update-index.txt +++ b/git-update-index.txt @@ -464,6 +464,32 @@ command reads the index; while when `--[no-|force-]untracked-cache` are used, the untracked cache is immediately added to or removed from the index. +Before 2.17, the untracked cache had a bug where replacing a directory +with a symlink to another directory could cause it to incorrectly show +files tracked by git as untracked. See the "status: add a failing test +showing a core.untrackedCache bug" commit to git.git. A workaround for +that is (and this might work for other undiscovered bugs in the +future): + +---------------- +$ git -c core.untrackedCache=false status +---------------- + +This bug has also been shown to affect non-symlink cases of replacing +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 ------------------- @@ -484,8 +510,8 @@ the `core.fsmonitor` configuration variable (see linkgit:git-config[1]) than using the `--fsmonitor` option to `git update-index` in each repository, especially if you want to do so across all repositories you use, because you can set the configuration -variable to `true` (or `false`) in your `$HOME/.gitconfig` just once -and have it affect all repositories you touch. +variable in your `$HOME/.gitconfig` just once and have it affect all +repositories you touch. When the `core.fsmonitor` configuration variable is changed, the file system monitor is added to or removed from the index the next time |