X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=Documentation%2Fgit-diff-files.txt;h=b78c4c64f1b2638b8be42072a0f9a4eab1362f7f;hb=84da035f3862b72d103d21104a1f67b003d17ebb;hp=e3873888f2236acb3ac04a6cda3784d61a2ce1a2;hpb=72e5890b68e7199d92620d3bba91fa36dd259404;p=git.git diff --git a/Documentation/git-diff-files.txt b/Documentation/git-diff-files.txt index e3873888f..b78c4c64f 100644 --- a/Documentation/git-diff-files.txt +++ b/Documentation/git-diff-files.txt @@ -3,26 +3,44 @@ git-diff-files(1) NAME ---- -git-diff-files - Compares files in the working tree and the cache +git-diff-files - Compares files in the working tree and the index SYNOPSIS -------- -'git-diff-files' [-q] [] [...] +'git-diff-files' [-q] [-0|-1|-2|-3|-c|--cc|-n|--no-index] [] [...] DESCRIPTION ----------- -Compares the files in the working tree and the cache. When paths +Compares the files in the working tree and the index. When paths are specified, compares only those named paths. Otherwise all -entries in the cache are compared. The output format is the +entries in the index are compared. The output format is the same as "git-diff-index" and "git-diff-tree". OPTIONS ------- include::diff-options.txt[] +-1 -2 -3 or --base --ours --theirs, and -0:: + Diff against the "base" version, "our branch" or "their + branch" respectively. With these options, diffs for + merged entries are not shown. ++ +The default is to diff against our branch (-2) and the +cleanly resolved paths. The option -0 can be given to +omit diff output for unmerged entries and just show "Unmerged". + +-c,--cc:: + This compares stage 2 (our branch), stage 3 (their + branch) and the working tree file and outputs a combined + diff, similar to the way 'diff-tree' shows a merge + commit with these flags. + +\-n,\--no-index:: + Compare the two given files / directories. + -q:: - Remain silent even on nonexisting files + Remain silent even on nonexistent files Output format -------------