Albert Netymk <albertnetymk@xxxxxxxxx> writes: > Hello, > > The man page of git-diff-index: > http://git-scm.com/docs/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: > http://git-scm.com/docs/gitdiffcore > > 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 majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html