doc: core.ignoreStat update, and clarify the --assume-unchanged effect
The assume-unchanged bit, and consequently core.ignoreStat, can be misunderstood. Be assertive about the expectation that file changes should notified to Git. Overhaul the general wording thus: 1. direct description of what is ignored given first. 2. example instruction of the user manual action required. 3. use sideways indirection for assume-unchanged and update-index references. 4. add a 'normally' to give leeway for the change detection. Signed-off-by: Philip Oakley <philipoakley@iee.org> Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:
parent
1be976eeb4
commit
92be938e96
@ -364,14 +364,18 @@ This is useful for excluding servers inside a firewall from
|
|||||||
proxy use, while defaulting to a common proxy for external domains.
|
proxy use, while defaulting to a common proxy for external domains.
|
||||||
|
|
||||||
core.ignoreStat::
|
core.ignoreStat::
|
||||||
If true, commands which modify both the working tree and the index
|
If true, Git will avoid using lstat() calls to detect if files have
|
||||||
will mark the updated paths with the "assume unchanged" bit in the
|
changed by setting the "assume-unchanged" bit for those tracked files
|
||||||
index. These marked files are then expected to stay unchanged in the
|
which it has updated identically in both the index and working tree.
|
||||||
working tree. If you change them you should mark their update manually.
|
+
|
||||||
Git will normally not detect the file changes by lstat() calls.
|
When files are modified outside of Git, the user will need to stage
|
||||||
This is useful on systems where those calls are very slow, such as
|
the modified files explicitly (e.g. see 'Examples' section in
|
||||||
cifs/Microsoft Windows.
|
linkgit:git-update-index[1]).
|
||||||
See linkgit:git-update-index[1].
|
Git will not normally detect changes to those files.
|
||||||
|
+
|
||||||
|
This is useful on systems where lstat() calls are very slow, such as
|
||||||
|
CIFS/Microsoft Windows.
|
||||||
|
+
|
||||||
False by default.
|
False by default.
|
||||||
|
|
||||||
core.preferSymlinkRefs::
|
core.preferSymlinkRefs::
|
||||||
|
Loading…
Reference in New Issue
Block a user