path: root/Documentation/git-diff-files.txt
diff options
authorJunio C Hamano <>2005-11-30 10:16:36 (GMT)
committerJunio C Hamano <>2005-11-30 10:17:51 (GMT)
commit15bf57a18aaf10c038e2026dfe54281edbb6080a (patch)
treed6f3fd0ab63ff060db738273b0e4997fafd42e40 /Documentation/git-diff-files.txt
parent354b9b59b0a02ce7e32a7b0c10caaa1e3532f22b (diff)
diff-files: show diffs with stage0 and unmerged stage at the same time.
After thinking about it more, I realized that much of the change I did on top of Linus' version does not make much sense. This commit reverts it so that it by default shows diffs with stage0 paths or stage2 paths with working tree; the unmerged stage to use can be overridden with -1/-2/-3 option (-2 is the default so essentially is a no-op). When the index file is unmerged, we are by definition in the middle of a conflicting merge, and we should show the diff with stage 2 by default. More importantly, paths without conflicts are updated in the working tree and collapsed to stage0 in the index, so showing diff with stage0 at the same time does not hurt. In normal cases, stage0 entries should be in sync with the working tree files and does not clutter the output. It even helps the user to realize that the working tree has local changes unrelated to the merge and remember to be careful not to do a "git-commit -a" after resolving the conflicts. When there is no unmerged entries, giving diff_unmerged_stage a default value of 2 does not cause any harm, because it would not be used anyway. So in all, always showing diff between stage0 paths and unmerged entries from a stage (defaulting to 2) is the right thing to do, as Linus originally did. Signed-off-by: Junio C Hamano <>
Diffstat (limited to 'Documentation/git-diff-files.txt')
1 files changed, 3 insertions, 4 deletions
diff --git a/Documentation/git-diff-files.txt b/Documentation/git-diff-files.txt
index b45d1e6..67f5126 100644
--- a/Documentation/git-diff-files.txt
+++ b/Documentation/git-diff-files.txt
@@ -26,10 +26,9 @@ include::diff-options.txt[]
branch" respectively. With these options, diffs for
merged entries are not shown.
-The default is to diff against our branch (-2) if there
-is an unmerged path, and show diff for unmerged entries
-otherwise. The option -0 can be given to force diff for
-unmerged entries even when the index is unmerged.
+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".
Remain silent even on nonexisting files