2005-05-10 21:32:30 +00:00
|
|
|
git-diff-files(1)
|
|
|
|
=================
|
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
2005-11-11 01:12:27 +00:00
|
|
|
git-diff-files - Compares files in the working tree and the index
|
2005-05-10 21:32:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
--------
|
2011-07-02 02:38:26 +00:00
|
|
|
[verse]
|
2022-10-13 15:39:06 +00:00
|
|
|
'git diff-files' [-q] [-0 | -1 | -2 | -3 | -c | --cc] [<common-diff-options>] [<path>...]
|
2005-05-10 21:32:30 +00:00
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
2005-11-11 01:12:27 +00:00
|
|
|
Compares the files in the working tree and the index. When paths
|
2005-05-10 21:32:30 +00:00
|
|
|
are specified, compares only those named paths. Otherwise all
|
2005-11-11 01:12:27 +00:00
|
|
|
entries in the index are compared. The output format is the
|
2010-01-09 23:33:00 +00:00
|
|
|
same as for 'git diff-index' and 'git diff-tree'.
|
2005-05-10 21:32:30 +00:00
|
|
|
|
|
|
|
OPTIONS
|
|
|
|
-------
|
2005-07-13 19:52:35 +00:00
|
|
|
include::diff-options.txt[]
|
2005-05-10 21:32:30 +00:00
|
|
|
|
2009-01-16 21:42:33 +00:00
|
|
|
-1 --base::
|
|
|
|
-2 --ours::
|
|
|
|
-3 --theirs::
|
|
|
|
-0::
|
2023-10-08 06:45:24 +00:00
|
|
|
Diff against the "base" version, "our branch", or "their
|
2005-11-30 05:06:10 +00:00
|
|
|
branch" respectively. With these options, diffs for
|
|
|
|
merged entries are not shown.
|
|
|
|
+
|
2007-06-07 07:04:01 +00:00
|
|
|
The default is to diff against our branch (-2) and the
|
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 <junkio@cox.net>
2005-11-30 10:16:36 +00:00
|
|
|
cleanly resolved paths. The option -0 can be given to
|
|
|
|
omit diff output for unmerged entries and just show "Unmerged".
|
2005-11-30 05:06:10 +00:00
|
|
|
|
2008-06-08 01:36:09 +00:00
|
|
|
-c::
|
|
|
|
--cc::
|
2006-01-28 10:19:22 +00:00
|
|
|
This compares stage 2 (our branch), stage 3 (their
|
2023-10-08 06:45:24 +00:00
|
|
|
branch), and the working tree file and outputs a combined
|
2006-01-28 10:19:22 +00:00
|
|
|
diff, similar to the way 'diff-tree' shows a merge
|
|
|
|
commit with these flags.
|
|
|
|
|
2005-05-10 21:32:30 +00:00
|
|
|
-q::
|
2023-10-08 06:45:20 +00:00
|
|
|
Remain silent even for nonexistent files
|
2005-05-10 21:32:30 +00:00
|
|
|
|
2009-07-28 08:32:18 +00:00
|
|
|
|
2005-05-10 21:32:30 +00:00
|
|
|
include::diff-format.txt[]
|
|
|
|
|
|
|
|
GIT
|
|
|
|
---
|
2008-06-06 07:07:32 +00:00
|
|
|
Part of the linkgit:git[1] suite
|