diff options
author | Philip Oakley <philipoakley@iee.org> | 2014-12-06 15:04:30 +0000 |
---|---|---|
committer | Junio C Hamano <gitster@pobox.com> | 2014-12-09 14:23:29 -0800 |
commit | ccadb25f730de775660c82695c5fcf9169f0aae7 (patch) | |
tree | af704299ad5ee6f5cbe654cbbd2bfa8231ad656a /Documentation/git-am.txt | |
parent | Merge branch 'maint-1.8.5' into maint-1.9 (diff) | |
download | tgif-ccadb25f730de775660c82695c5fcf9169f0aae7.tar.xz |
doc: make clear --assume-unchanged's user contract
Many users misunderstand the --assume-unchanged contract, believing
it means Git won't look at the flagged file.
Be explicit that the --assume-unchanged contract is by the user that
they will NOT change the file so that Git does not need to look (and
expend, for example, lstat(2) cycles)
Mentioning "Git stops checking" does not help the reader, as it is
only one possible consequence of what that assumption allows Git to
do, but
(1) there are things other than "stop checking" that Git can do
based on that assumption; and
(2) Git is not obliged to stop checking; it merely is allowed to.
Also, this is a single flag bit, correct the plural to singular, and
the verb, accordingly.
Drop the stale and incorrect information about "poor-man's ignore",
which is not what this flag bit is about at all.
Signed-off-by: Philip Oakley <philipoakley@iee.org>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation/git-am.txt')
0 files changed, 0 insertions, 0 deletions