[PATCH 0/4] Re: Undocumented git-diff syntax
From: Jonathan Nieder <hidden>
Date: 2016-06-15 22:49:45
Yann Dirson wrote:
OTOH, that appears not to be 100% accurate (my tests would have shown me): although --no-index does give me the expected results when one or two of the files are untracked, I have to explicitely add it, which seem to contradict this part of the doc.
Yep, the doc is out of date. Luckily I had a series updating it rotting in my local tree. Patch 5 gives --no-index its own prominent mention in the DESCRIPTION section. I suspect that is a bad idea --- too much to learn for new users --- and that the description should go under OPTIONS, but I ran out of time. Maybe patches 1-4 can help? Jonathan Nieder (5): Documentation: gitrevisions is in section 7 Documentation: diff can compare blobs Documentation: expand 'git diff' SEE ALSO section Documentation: update "git diff --no-index" description Documentation: expand diff --no-index description Documentation/git-cat-file.txt | 2 +- Documentation/git-check-ref-format.txt | 2 +- Documentation/git-cherry-pick.txt | 2 +- Documentation/git-diff.txt | 36 ++++++++++++++++++++++++-------- Documentation/git-fast-import.txt | 2 +- Documentation/git-format-patch.txt | 2 +- Documentation/git-log.txt | 2 +- Documentation/git-push.txt | 2 +- Documentation/git-reflog.txt | 2 +- Documentation/git-revert.txt | 2 +- Documentation/git-show-branch.txt | 2 +- Documentation/git-show.txt | 2 +- Documentation/git.txt | 2 +- Documentation/gitcore-tutorial.txt | 2 +- Documentation/gitk.txt | 2 +- Documentation/user-manual.txt | 8 +++--- 16 files changed, 45 insertions(+), 27 deletions(-) -- 1.7.2.3