Clarify that "--" is meant to disambiguate paths from the other options. Signed-off-by: Ramkumar Ramachandra <artagnon@xxxxxxxxx> --- Documentation/git-diff.txt | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/Documentation/git-diff.txt b/Documentation/git-diff.txt index 47aa3fc..a0fdfc2 100644 --- a/Documentation/git-diff.txt +++ b/Documentation/git-diff.txt @@ -9,11 +9,11 @@ git-diff - Show changes between commits, commit and working tree, etc SYNOPSIS -------- [verse] -'git diff' [options] [<commit>] [--] [<path>...] -'git diff' [options] --cached [<commit>] [--] [<path>...] +'git diff' [options] [<commit>] [[--] [<path>...]] +'git diff' [options] --cached [<commit>] [[--] [<path>...]] 'git diff' [options] <blob> <blob> -'git diff' [options] <commit> <commit> [--] [<path>...] -'git diff' [options] [--no-index] [--] <path> <path> +'git diff' [options] <commit> <commit> [[--] [<path>...]] +'git diff' [options] [--no-index] [[--] <path> <path>] DESCRIPTION ----------- @@ -21,7 +21,7 @@ Show changes between the working tree and the index or a tree, changes between the index and a tree, changes between two trees, or changes between two files on disk. -'git diff' [options] [--] [<path>...]:: +'git diff' [options] [[--] [<path>...]]:: This form is to view the changes you made relative to the index (staging area for the next commit). In other @@ -33,7 +33,7 @@ If exactly two paths are given and at least one points outside the current repository, 'git diff' will compare the two files / directories. This behavior can be forced by --no-index. -'git diff' [options] --cached [<commit>] [--] [<path>...]:: +'git diff' [options] --cached [<commit>] [[--] [<path>...]]:: This form is to view the changes you staged for the next commit relative to the named <commit>. Typically you @@ -43,7 +43,7 @@ directories. This behavior can be forced by --no-index. <commit> is not given, it shows all staged changes. --staged is a synonym of --cached. -'git diff' [options] <commit> [--] [<path>...]:: +'git diff' [options] <commit> [[--] [<path>...]]:: This form is to view the changes you have in your working tree relative to the named <commit>. You can @@ -56,18 +56,18 @@ directories. This behavior can be forced by --no-index. This form is to view the differences between the raw contents of two blob objects. -'git diff' [options] <commit> <commit> [--] [<path>...]:: +'git diff' [options] <commit> <commit> [[--] [<path>...]]:: This is to view the changes between two arbitrary <commit>. -'git diff' [options] <commit>..<commit> [--] [<path>...]:: +'git diff' [options] <commit>..<commit> [[--] [<path>...]]:: This is synonymous to the previous form. If <commit> on one side is omitted, it will have the same effect as using HEAD instead. -'git diff' [options] <commit>\...<commit> [--] [<path>...]:: +'git diff' [options] <commit>\...<commit> [[--] [<path>...]]:: This form is to view the changes on the branch containing and up to the second <commit>, starting at a common ancestor -- 1.8.2.1.502.g2d60b5c -- 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