X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=Documentation%2Fgit-diff.txt;h=a2f192fb7519117f8e47f3ec4608e3301c200dc3;hb=5fdb70983585ccde1540563a8c7458621f7a7407;hp=7acd428964a9e6ffc4b876ce01731c1daf3a72bc;hpb=5f54de5bd07481f6d88e8dbd5551f3356ecbf513;p=git.git diff --git a/Documentation/git-diff.txt b/Documentation/git-diff.txt index 7acd42896..a2f192fb7 100644 --- a/Documentation/git-diff.txt +++ b/Documentation/git-diff.txt @@ -8,14 +8,14 @@ git-diff - Show changes between commits, commit and working tree, etc SYNOPSIS -------- -'git-diff' [] {0,2} [--] [...] +'git diff' [] {0,2} [--] [...] DESCRIPTION ----------- Show changes between two trees, a tree and the working tree, a tree and the index file, or the index file and the working tree. -'git-diff' [--options] [--] [...]:: +'git diff' [--options] [--] [...]:: This form is to view the changes you made relative to the index (staging area for the next commit). In other @@ -27,14 +27,15 @@ If exactly two paths are given, and at least one is untracked, compare the two files / directories. This behavior can be forced by --no-index. -'git-diff' [--options] --cached [] [--] [...]:: +'git diff' [--options] --cached [] [--] [...]:: This form is to view the changes you staged for the next commit relative to the named . Typically you would want comparison with the latest commit, so if you do not give , it defaults to HEAD. + --staged is a synonym of --cached. -'git-diff' [--options] [--] [...]:: +'git diff' [--options] [--] [...]:: This form is to view the changes you have in your working tree relative to the named . You can @@ -42,23 +43,23 @@ forced by --no-index. branch name to compare with the tip of a different branch. -'git-diff' [--options] [--] [...]:: +'git diff' [--options] [--] [...]:: This is to view the changes between two arbitrary . -'git-diff' [--options] .. [--] [...]:: +'git diff' [--options] .. [--] [...]:: This is synonymous to the previous form. If on one side is omitted, it will have the same effect as using HEAD instead. -'git-diff' [--options] \... [--] [...]:: +'git diff' [--options] \... [--] [...]:: This form is to view the changes on the branch containing and up to the second , starting at a common ancestor - of both . "git-diff A\...B" is equivalent to - "git-diff $(git-merge-base A B) B". You can omit any one + of both . "git diff A\...B" is equivalent to + "git diff $(git-merge-base A B) B". You can omit any one of , which has the same effect as using HEAD instead. Just in case if you are doing something exotic, it should be