1 .\"Generated by db2man.xsl. Don't modify this, modify the source.
10 .de Sp \" Vertical space (when we can't use .PP)
16 .ie \\n(.$>=3 .ne \\$3
20 .TH "GIT-DIFF-FILES" 1 "" "" ""
22 git-diff-files \- Compares files in the working tree and the index
26 git\-diff\-files [\-q] [<common diff options>] [<path>...]
31 Compares the files in the working tree and the index\&. When paths are specified, compares only those named paths\&. Otherwise all entries in the index are compared\&. The output format is the same as "git\-diff\-index" and "git\-diff\-tree"\&.
37 Generate patch (see section on generating patches)
45 \\0 line termination on output
49 Show only names of changed files\&.
53 Show only names and status of changed files\&.
57 Instead of the first handful characters, show full object name of pre\- and post\-image blob on the "index" line when generating a patch format output\&.
61 Instead of showing the full 40\-byte hexadecimal object name in diff\-raw format output and diff\-tree header lines, show only handful hexdigits prefix\&. This is independent of \-\-full\-index option above, which controls the diff\-patch output format\&. Non default number of digits can be specified with \-\-abbrev=<n>\&.
65 Break complete rewrite changes into pairs of delete and create\&.
73 Detect copies as well as renames\&.
76 \-\-find\-copies\-harder
77 For performance reasons, by default, \-C option finds copies only if the original file of the copy was modified in the same changeset\&. This flag makes the command inspect unmodified files as candidates for the source of copy\&. This is a very expensive operation for large projects, so use it with caution\&.
81 \-M and \-C options require O(n^2) processing time where n is the number of potential rename/copy targets\&. This option prevents rename/copy detection from running if the number of rename/copy targets exceeds the specified number\&.
85 Look for differences that contain the change in <string>\&.
89 When \-S finds a change, show all the changes in that changeset, not just the files that contain the change in <string>\&.
93 Output the patch in the order specified in the <orderfile>, which has one shell glob pattern per line\&.
97 Swap two inputs; that is, show differences from index or on\-disk file to tree contents\&.
100 For more detailed explanation on these common options, see also diffcore documentation: \fIdiffcore.html\fR\&.
103 \-1 \-2 \-3 or \-\-base \-\-ours \-\-theirs, and \-0
104 Diff against the "base" version, "our branch" or "their branch" respectively\&. With these options, diffs for merged entries are not shown\&.
106 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"\&.
110 Remain silent even on nonexisting files
115 The output format from "git\-diff\-index", "git\-diff\-tree" and "git\-diff\-files" are very similar\&.
118 These commands all compare two sets of things; what is compared differs:
121 git\-diff\-index <tree\-ish>
122 compares the <tree\-ish> and the files on the filesystem\&.
125 git\-diff\-index \-\-cached <tree\-ish>
126 compares the <tree\-ish> and the index\&.
129 git\-diff\-tree [\-r] <tree\-ish\-1> <tree\-ish\-2> [<pattern>...]
130 compares the trees named by the two arguments\&.
133 git\-diff\-files [<pattern>...]
134 compares the index and the files on the filesystem\&.
137 An output line is formatted this way:
140 in\-place edit :100644 100644 bcd1234\&.\&.\&. 0123456\&.\&.\&. M file0
141 copy\-edit :100644 100644 abcd123\&.\&.\&. 1234567\&.\&.\&. C68 file1 file2
142 rename\-edit :100644 100644 abcd123\&.\&.\&. 1234567\&.\&.\&. R86 file1 file3
143 create :000000 100644 0000000\&.\&.\&. 1234567\&.\&.\&. A file4
144 delete :100644 000000 1234567\&.\&.\&. 0000000\&.\&.\&. D file5
145 unmerged :000000 000000 0000000\&.\&.\&. 0000000\&.\&.\&. U file6
147 That is, from the left to the right:
154 mode for "src"; 000000 if creation or unmerged\&.
160 mode for "dst"; 000000 if deletion or unmerged\&.
166 sha1 for "src"; 0{40} if creation or unmerged\&.
172 sha1 for "dst"; 0{40} if creation, unmerged or "look at work tree"\&.
178 status, followed by optional "score" number\&.
181 a tab or a NUL when \-z option is used\&.
187 a tab or a NUL when \-z option is used; only exists for C or R\&.
190 path for "dst"; only exists for C or R\&.
193 an LF or a NUL when \-z option is used, to terminate the record\&.
197 <sha1> is shown as all 0's if a file is new on the filesystem and it is out of sync with the index\&.
203 :100644 100644 5be4a4\&.\&.\&.\&.\&.\&. 000000\&.\&.\&.\&.\&.\&. M file\&.c
205 When \-z option is not used, TAB, LF, and backslash characters in pathnames are represented as \\t, \\n, and \\\\, respectively\&.
207 .SH "GENERATING PATCHES WITH -P"
210 When "git\-diff\-index", "git\-diff\-tree", or "git\-diff\-files" are run with a \-p option, they do not produce the output described above; instead they produce a patch file\&.
213 The patch generation can be customized at two levels\&.
217 When the environment variable GIT_EXTERNAL_DIFF is not set, these commands internally invoke "diff" like this:
221 diff \-L a/<path> \-L b/<path> \-pu <old> <new>
223 For added files, /dev/null is used for <old>\&. For removed files, /dev/null is used for <new>
225 The "diff" formatting options can be customized via the environment variable GIT_DIFF_OPTS\&. For example, if you prefer context diff:
228 GIT_DIFF_OPTS=\-c git\-diff\-index \-p HEAD
232 When the environment variable GIT_EXTERNAL_DIFF is set, the program named by it is called, instead of the diff invocation described above\&.
234 For a path that is added, removed, or modified, GIT_EXTERNAL_DIFF is called with 7 parameters:
238 path old\-file old\-hex old\-mode new\-file new\-hex new\-mode
243 are files GIT_EXTERNAL_DIFF can use to read the contents of <old|new>,
245 are the 40\-hexdigit SHA1 hashes,
247 are the octal representation of the file modes\&.
248 The file parameters can point at the user's working file (e\&.g\&. new\-file in "git\-diff\-files"), /dev/null (e\&.g\&. old\-file when a new file is added), or a temporary file (e\&.g\&. old\-file in the index)\&. GIT_EXTERNAL_DIFF should not worry about unlinking the temporary file \-\-\- it is removed when GIT_EXTERNAL_DIFF exits\&.
252 For a path that is unmerged, GIT_EXTERNAL_DIFF is called with 1 parameter, <path>\&.
254 .SH "GIT SPECIFIC EXTENSION TO DIFF FORMAT"
257 What \-p option produces is slightly different from the traditional diff format\&.
261 It is preceded with a "git diff" header, that looks like this:
265 diff \-\-git a/file1 b/file2
267 The a/ and b/ filenames are the same unless rename/copy is involved\&. Especially, even for a creation or a deletion, /dev/null is _not_ used in place of a/ or b/ filenames\&.
269 When rename/copy is involved, file1 and file2 show the name of the source file of the rename/copy and the name of the file that rename/copy produces, respectively\&.
272 It is followed by one or more extended header lines:
277 deleted file mode <mode>
283 similarity index <number>
284 dissimilarity index <number>
285 index <hash>\&.\&.<hash> <mode>
289 TAB, LF, and backslash characters in pathnames are represented as \\t, \\n, and \\\\, respectively\&.
295 Written by Linus Torvalds <torvalds@osdl\&.org>
300 Documentation by David Greaves, Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
305 Part of the \fBgit\fR(7) suite