[PATCH 4/5] git-diff.txt: document the .. and ... forms in SYNOPSIS

2013-04-24 Thread Ramkumar Ramachandra
The DESCRIPTION refers to the 'commit..commit' and
'commit...commit' forms, but the SYNOPSIS does not list them at
all.  Fix this.

Signed-off-by: Ramkumar Ramachandra artag...@gmail.com
---
 Documentation/git-diff.txt | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/Documentation/git-diff.txt b/Documentation/git-diff.txt
index a0fdfc2..291e250 100644
--- a/Documentation/git-diff.txt
+++ b/Documentation/git-diff.txt
@@ -13,6 +13,8 @@ SYNOPSIS
 'git diff' [options] --cached [commit] [[--] [path...]]
 'git diff' [options] blob blob
 'git diff' [options] commit commit [[--] [path...]]
+'git diff' [options] commit..commit [[--] [path...]]
+'git diff' [options] commit\...commit [[--] [path...]]
 'git diff' [options] [--no-index] [[--] path path]
 
 DESCRIPTION
-- 
1.8.2.1.502.g2d60b5c

--
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


Re: [PATCH 4/5] git-diff.txt: document the .. and ... forms in SYNOPSIS

2013-04-24 Thread Jonathan Nieder
Ramkumar Ramachandra wrote:

 --- a/Documentation/git-diff.txt
 +++ b/Documentation/git-diff.txt
 @@ -13,6 +13,8 @@ SYNOPSIS
  'git diff' [options] --cached [commit] [[--] [path...]]
  'git diff' [options] blob blob
  'git diff' [options] commit commit [[--] [path...]]
 +'git diff' [options] commit..commit [[--] [path...]]
 +'git diff' [options] commit\...commit [[--] [path...]]
  'git diff' [options] [--no-index] [[--] path path]

This is preparation for removing commit..commit from the
documentation, right?  It makes sense to add the ...  form since
there's no other way to spell it but I can't say I'm excited about
adding the .. form.  Especially since tree..tree doesn't work,
that form's a little embarrassing. ;-)

*checks the manpage*

Ah, this is to make the SYNOPSIS a better table of contents for the
DESCRIPTION (except that the DESCRIPTION treats git diff --no-index
path path before git diff [commit] -- pathspec while the
SYNOPSIS doesn't).  Maybe it would make sense to go all the way and
make the two follow the same order?

My 2ยข,
Jonathan
--
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