Mark disused commit walkers officially deprecated.
[git/mingw/4msysgit/kblees.git] / Documentation / git-diff-files.txt
blobd8a0a86022b805eabe3516fe980d6c626abfa68e
1 git-diff-files(1)
2 =================
4 NAME
5 ----
6 git-diff-files - Compares files in the working tree and the index
9 SYNOPSIS
10 --------
11 'git-diff-files' [-q] [-0|-1|-2|-3|-c|--cc|--no-index] [<common diff options>] [<path>...]
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".
20 OPTIONS
21 -------
22 include::diff-options.txt[]
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.
29 The default is to diff against our branch (-2) and the
30 cleanly resolved paths.  The option -0 can be given to
31 omit diff output for unmerged entries and just show "Unmerged".
33 -c,--cc::
34         This compares stage 2 (our branch), stage 3 (their
35         branch) and the working tree file and outputs a combined
36         diff, similar to the way 'diff-tree' shows a merge
37         commit with these flags.
39 --no-index::
40         Compare the two given files / directories.
42 -q::
43         Remain silent even on nonexistent files
45 Output format
46 -------------
47 include::diff-format.txt[]
50 Author
51 ------
52 Written by Linus Torvalds <torvalds@osdl.org>
54 Documentation
55 --------------
56 Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
58 GIT
59 ---
60 Part of the gitlink:git[7] suite