man1/git-diff-files.1

   1 .\"Generated by db2man.xsl. Don't modify this, modify the source.
   2 .de Sh \" Subsection
   3 .br
   4 .if t .Sp
   5 .ne 5
   6 .PP
   7 \fB\\$1\fR
   8 .PP
   9 ..
  10 .de Sp \" Vertical space (when we can't use .PP)
  11 .if t .sp .5v
  12 .if n .sp
  13 ..
  14 .de Ip \" List item
  15 .br
  16 .ie \\n(.$>=3 .ne \\$3
  17 .el .ne 3
  18 .IP "\\$1" \\$2
  19 ..
  20 .TH "GIT-DIFF-FILES" 1 "" "" ""
  21 .SH NAME
  22 git-diff-files \- Compares files in the working tree and the index
  23 .SH "SYNOPSIS"
  24
  25
  26 git\-diff\-files [\-q] [\-0|\-1|\-2|\-3|\-c|\-\-cc] [<common diff options>] [<path>...]
  27
  28 .SH "DESCRIPTION"
  29
  30
  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"\&.
  32
  33 .SH "OPTIONS"
  34
  35 .TP
  36 \-p
  37 Generate patch (see section on generating patches)
  38
  39 .TP
  40 \-u
  41 Synonym for "\-p"\&.
  42
  43 .TP
  44 \-z
  45 \\0 line termination on output
  46
  47 .TP
  48 \-\-name\-only
  49 Show only names of changed files\&.
  50
  51 .TP
  52 \-\-name\-status
  53 Show only names and status of changed files\&.
  54
  55 .TP
  56 \-\-full\-index
  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\&.
  58
  59 .TP
  60 \-\-abbrev[=<n>]
  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>\&.
  62
  63 .TP
  64 \-B
  65 Break complete rewrite changes into pairs of delete and create\&.
  66
  67 .TP
  68 \-M
  69 Detect renames\&.
  70
  71 .TP
  72 \-C
  73 Detect copies as well as renames\&.
  74
  75 .TP
  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\&.
  78
  79 .TP
  80 \-l<num>
  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\&.
  82
  83 .TP
  84 \-S<string>
  85 Look for differences that contain the change in <string>\&.
  86
  87 .TP
  88 \-\-pickaxe\-all
  89 When \-S finds a change, show all the changes in that changeset, not just the files that contain the change in <string>\&.
  90
  91 .TP
  92 \-O<orderfile>
  93 Output the patch in the order specified in the <orderfile>, which has one shell glob pattern per line\&.
  94
  95 .TP
  96 \-R
  97 Swap two inputs; that is, show differences from index or on\-disk file to tree contents\&.
  98
  99
 100 For more detailed explanation on these common options, see also diffcore documentation: \fIdiffcore.html\fR\&.
 101
 102 .TP
 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\&.
 105
 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"\&.
 107
 108 .TP
 109 \-c,\-\-cc
 110 This compares stage 2 (our branch), stage 3 (their branch) and the working tree file and outputs a combined diff, similar to the way diff\-tree shows a merge commit with these flags\&.
 111
 112 .TP
 113 \-q
 114 Remain silent even on nonexisting files
 115
 116 .SH "OUTPUT FORMAT"
 117
 118
 119 The output format from "git\-diff\-index", "git\-diff\-tree" and "git\-diff\-files" are very similar\&.
 120
 121
 122 These commands all compare two sets of things; what is compared differs:
 123
 124 .TP
 125 git\-diff\-index <tree\-ish>
 126 compares the <tree\-ish> and the files on the filesystem\&.
 127
 128 .TP
 129 git\-diff\-index \-\-cached <tree\-ish>
 130 compares the <tree\-ish> and the index\&.
 131
 132 .TP
 133 git\-diff\-tree [\-r] <tree\-ish\-1> <tree\-ish\-2> [<pattern>...]
 134 compares the trees named by the two arguments\&.
 135
 136 .TP
 137 git\-diff\-files [<pattern>...]
 138 compares the index and the files on the filesystem\&.
 139
 140
 141 An output line is formatted this way:
 142
 143 .IP
 144 in\-place edit  :100644 100644 bcd1234\&.\&.\&. 0123456\&.\&.\&. M file0
 145 copy\-edit      :100644 100644 abcd123\&.\&.\&. 1234567\&.\&.\&. C68 file1 file2
 146 rename\-edit    :100644 100644 abcd123\&.\&.\&. 1234567\&.\&.\&. R86 file1 file3
 147 create         :000000 100644 0000000\&.\&.\&. 1234567\&.\&.\&. A file4
 148 delete         :100644 000000 1234567\&.\&.\&. 0000000\&.\&.\&. D file5
 149 unmerged       :000000 000000 0000000\&.\&.\&. 0000000\&.\&.\&. U file6
 150
 151 That is, from the left to the right:
 152
 153 .TP 3
 154 1.
 155 a colon\&.
 156 .TP
 157 2.
 158 mode for "src"; 000000 if creation or unmerged\&.
 159 .TP
 160 3.
 161 a space\&.
 162 .TP
 163 4.
 164 mode for "dst"; 000000 if deletion or unmerged\&.
 165 .TP
 166 5.
 167 a space\&.
 168 .TP
 169 6.
 170 sha1 for "src"; 0{40} if creation or unmerged\&.
 171 .TP
 172 7.
 173 a space\&.
 174 .TP
 175 8.
 176 sha1 for "dst"; 0{40} if creation, unmerged or "look at work tree"\&.
 177 .TP
 178 9.
 179 a space\&.
 180 .TP
 181 10.
 182 status, followed by optional "score" number\&.
 183 .TP
 184 11.
 185 a tab or a NUL when \-z option is used\&.
 186 .TP
 187 12.
 188 path for "src"
 189 .TP
 190 13.
 191 a tab or a NUL when \-z option is used; only exists for C or R\&.
 192 .TP
 193 14.
 194 path for "dst"; only exists for C or R\&.
 195 .TP
 196 15.
 197 an LF or a NUL when \-z option is used, to terminate the record\&.
 198 .LP
 199
 200
 201 <sha1> is shown as all 0's if a file is new on the filesystem and it is out of sync with the index\&.
 202
 203
 204 Example:
 205
 206 .IP
 207 :100644 100644 5be4a4\&.\&.\&.\&.\&.\&. 000000\&.\&.\&.\&.\&.\&. M file\&.c
 208
 209 When \-z option is not used, TAB, LF, and backslash characters in pathnames are represented as \\t, \\n, and \\\\, respectively\&.
 210
 211 .SH "GENERATING PATCHES WITH -P"
 212
 213
 214 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\&.
 215
 216
 217 The patch generation can be customized at two levels\&.
 218
 219 .TP 3
 220 1.
 221 When the environment variable GIT_EXTERNAL_DIFF is not set, these commands internally invoke "diff" like this:
 222
 223
 224 .nf
 225 diff \-L a/<path> \-L b/<path> \-pu <old> <new>
 226 .fi
 227 For added files, /dev/null is used for <old>\&. For removed files, /dev/null is used for <new>
 228
 229 The "diff" formatting options can be customized via the environment variable GIT_DIFF_OPTS\&. For example, if you prefer context diff:
 230
 231 .nf
 232 GIT_DIFF_OPTS=\-c git\-diff\-index \-p HEAD
 233 .fi
 234 .TP
 235 2.
 236 When the environment variable GIT_EXTERNAL_DIFF is set, the program named by it is called, instead of the diff invocation described above\&.
 237
 238 For a path that is added, removed, or modified, GIT_EXTERNAL_DIFF is called with 7 parameters:
 239
 240
 241 .nf
 242 path old\-file old\-hex old\-mode new\-file new\-hex new\-mode
 243 .fi
 244 where:
 245
 246 <old|new>\-file
 247 are files GIT_EXTERNAL_DIFF can use to read the contents of <old|new>,
 248 <old|new>\-hex
 249 are the 40\-hexdigit SHA1 hashes,
 250 <old|new>\-mode
 251 are the octal representation of the file modes\&.
 252 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\&.
 253 .LP
 254
 255
 256 For a path that is unmerged, GIT_EXTERNAL_DIFF is called with 1 parameter, <path>\&.
 257
 258 .SH "GIT SPECIFIC EXTENSION TO DIFF FORMAT"
 259
 260
 261 What \-p option produces is slightly different from the traditional diff format\&.
 262
 263 .TP 3
 264 1.
 265 It is preceded with a "git diff" header, that looks like this:
 266
 267
 268 .nf
 269 diff \-\-git a/file1 b/file2
 270 .fi
 271 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\&.
 272
 273 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\&.
 274 .TP
 275 2.
 276 It is followed by one or more extended header lines:
 277
 278 .nf
 279 old mode <mode>
 280 new mode <mode>
 281 deleted file mode <mode>
 282 new file mode <mode>
 283 copy from <path>
 284 copy to <path>
 285 rename from <path>
 286 rename to <path>
 287 similarity index <number>
 288 dissimilarity index <number>
 289 index <hash>\&.\&.<hash> <mode>
 290 .fi
 291 .TP
 292 3.
 293 TAB, LF, and backslash characters in pathnames are represented as \\t, \\n, and \\\\, respectively\&.
 294 .LP
 295
 296 .SH "COMBINED DIFF FORMAT"
 297
 298
 299 git\-diff\-tree and git\-diff\-files can take \-c or \-\-cc option to produce combined diff, which looks like this:
 300
 301 .IP
 302 diff \-\-combined describe\&.c
 303 @@@ +98,7 @@@
 304    return (a_date > b_date) ? \-1 : (a_date == b_date) ? 0 : 1;
 305   }
 306
 307 \- static void describe(char *arg)
 308  \-static void describe(struct commit *cmit, int last_one)
 309 ++static void describe(char *arg, int last_one)
 310   {
 311  +     unsigned char sha1[20];
 312  +     struct commit *cmit;
 313
 314 Unlike the traditional unified diff format, which shows two files A and B with a single column that has \- (minus -- appears in A but removed in B), + (plus -- missing in A but added to B), or (space -- unchanged) prefix, this format compares two or more files file1, file2,... with one file X, and shows how X differs from each of fileN\&. One column for each of fileN is prepended to the output line to note how X's line is different from it\&.
 315
 316
 317 A \- character in the column N means that the line appears in fileN but it does not appear in the last file\&. A + character in the column N means that the line appears in the last file, and fileN does not have that line\&.
 318
 319
 320 In the above example output, the function signature was changed from both files (hence two \- removals from both file1 and file2, plus ++ to mean one line that was added does not appear in either file1 nor file2)\&. Also two other lines are the same from file1 but do not appear in file2 (hence prefixed with +)\&.
 321
 322
 323 When shown by git diff\-tree \-c, it compares the parents of a merge commit with the merge result (i\&.e\&. file1\&.\&.fileN are the parents)\&. When shown by git diff\-files \-c, it compares the two unresolved merge parents with the working tree file (i\&.e\&. file1 is stage 2 aka "our version", file2 is stage 3 aka "their version")\&.
 324
 325 .SH "AUTHOR"
 326
 327
 328 Written by Linus Torvalds <torvalds@osdl\&.org>
 329
 330 .SH "DOCUMENTATION"
 331
 332
 333 Documentation by David Greaves, Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
 334
 335 .SH "GIT"
 336
 337
 338 Part of the \fBgit\fR(7) suite
 339