Albert Netymk <albertnet...@gmail.com> writes:
> The man page of git-diff-index:
> states that
> `git-diff-index - Compares content and mode of blobs between the index
> and repository`.
> However, in fact this command compares between files on disk and
> repository by default. It's explained clearly in here:
> Maybe the man page could be updated to reflect this in NAME section:
> `git-diff-index - Compares content and mode of blobs between files on
> disk and repository or between the index and repository`
Surely; we need to keep it fit on a single line, though.
> In DESCRIPTION section:
> `Compares the content and mode of the blobs found via a tree object
> with the content of the files on disk by default, and could be
> compared with index only using cached option. ...`
Yes, mentioning both mode is a good change. The above exact text
may give a false impression (with that "by default") that it is
somehow more preferrable to compare tree with working tree through
the index, and only weirdos would use "--cached" to compare tree and
the index, though.
Patches welcome. Thanks.
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majord...@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html