diff-files: -1/-2/-3 to diff against unmerged stage.
[git.git] / Documentation / git-diff-files.txt
1 git-diff-files(1)
2 =================
3
4 NAME
5 ----
6 git-diff-files - Compares files in the working tree and the index
7
8
9 SYNOPSIS
10 --------
11 'git-diff-files' [-q] [<common diff options>] [<path>...]
12
13 DESCRIPTION
14 -----------
15 Compares the files in the working tree and the index.  When paths
16 are specified, compares only those named paths.  Otherwise all
17 entries in the index are compared.  The output format is the
18 same as "git-diff-index" and "git-diff-tree".
19
20 OPTIONS
21 -------
22 include::diff-options.txt[]
23
24 -1 -2 -3 or --base --ours --theirs, and -0::
25         Diff against the "base" version, "our branch" or "their
26         branch" respectively.  With these options, diffs for
27         merged entries are not shown.
28 +
29 The default is to diff against our branch (-2) if there
30 is an unmerged path, and show diff for unmerged entries
31 otherwise.  The option -0 can be given to force diff for
32 unmerged entries even when the index is unmerged.
33
34 -q::
35         Remain silent even on nonexisting files
36
37 Output format
38 -------------
39 include::diff-format.txt[]
40
41
42 Author
43 ------
44 Written by Linus Torvalds <torvalds@osdl.org>
45
46 Documentation
47 --------------
48 Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
49
50 GIT
51 ---
52 Part of the gitlink:git[7] suite
53