X-Git-Url: https://git.verplant.org/?a=blobdiff_plain;f=Documentation%2Fgit-diff-cache.txt;h=a353d1262876d27841d4335fc99bd5a22f54837f;hb=d59a6043a8a7aed97c684fb4f14fe5221df1fcaf;hp=35253b11b34b8b302ac264eaf90eadcdc2bf1555;hpb=b1c006dd651fce55e25a7b06d00382cfdc1a3f91;p=git.git diff --git a/Documentation/git-diff-cache.txt b/Documentation/git-diff-cache.txt index 35253b11..a353d126 100644 --- a/Documentation/git-diff-cache.txt +++ b/Documentation/git-diff-cache.txt @@ -9,7 +9,7 @@ git-diff-cache - Compares content and mode of blobs between the cache and reposi SYNOPSIS -------- -'git-diff-cache' [-p] [-r] [-z] [-m] [-M] [-R] [-C] [-S] [--cached] [...] +'git-diff-cache' [-m] [--cached] [] [...] DESCRIPTION ----------- @@ -21,33 +21,11 @@ entries in the cache are compared. OPTIONS ------- +include::diff-options.txt[] + :: The id of a tree object to diff against. --p:: - Generate patch (see section on generating patches) - --r:: - This flag does not mean anything. It is there only to match - "git-diff-tree". Unlike "git-diff-tree", "git-diff-cache" - always looks at all the subdirectories. - --z:: - \0 line termination on output - --M:: - Detect renames. - --C:: - Detect copies as well as renames. - --S:: - Look for differences that contains the change in . - - --R:: - Output diff in reverse. - --cached:: do not consider the on-disk file at all @@ -72,13 +50,13 @@ Cached Mode ----------- If '--cached' is specified, it allows you to ask: - show me the differences between HEAD and the current index + show me the differences between HEAD and the current cache contents (the ones I'd write with a "git-write-tree") -For example, let's say that you have worked on your index file, and are -ready to commit. You want to see eactly *what* you are going to commit is -without having to write a new tree object and compare it that way, and to -do that, you just do +For example, let's say that you have worked on your working directory, updated +some files in the cache and are ready to commit. You want to see eactly +*what* you are going to commit is without having to write a new tree +object and compare it that way, and to do that, you just do git-diff-cache --cached $(cat .git/HEAD)