docs: clarify git diff modes of operation
commit49bd56a5f7b09f89b59a6a77d331e8f85f6d7fde
authorJeff King <peff@peff.net>
Thu, 4 Nov 2010 21:17:29 +0000 (4 17:17 -0400)
committerJunio C Hamano <gitster@pobox.com>
Fri, 5 Nov 2010 17:05:46 +0000 (5 10:05 -0700)
tree4efeb0656991bf133ec28baf6b14b4e2fb919989
parent9edb8a0f7b3e2ca06b360abce2e2aaa2b5760a68
docs: clarify git diff modes of operation

It is an oversimplification to say that we can take
"[<commit> [<commit>]]", as it really depends on what
options have been given. Instead, let's list the major modes
of operation separately, as we do in other manpages.

This patch also adjusts the text immediately after the
synopsis to match the lines given in the synopsis.

For git-difftool, which has the same issue, let's refer the
user to the git-diff manpage rather than spelling it all out
again.

Signed-off-by: Jeff King <peff@peff.net>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-diff.txt
Documentation/git-difftool.txt