git-diff-stages.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"\r
   2     "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">\r
   3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">\r
   4 <head>\r
   5 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />\r
   6 <meta name="generator" content="AsciiDoc 7.0.1" />\r
   7 <style type="text/css">\r
   8 /* Debug borders */\r
   9 p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {\r
  10 /*\r
  11   border: 1px solid red;\r
  12 */\r
  13 }\r
  14 \r
  15 body {\r
  16   margin: 1em 5% 1em 5%;\r
  17 }\r
  18 \r
  19 a { color: blue; }\r
  20 a:visited { color: fuchsia; }\r
  21 \r
  22 em {\r
  23   font-style: italic;\r
  24 }\r
  25 \r
  26 strong {\r
  27   font-weight: bold;\r
  28 }\r
  29 \r
  30 tt {\r
  31   color: navy;\r
  32 }\r
  33 \r
  34 h1, h2, h3, h4, h5, h6 {\r
  35   color: #527bbd;\r
  36   font-family: sans-serif;\r
  37   margin-top: 1.2em;\r
  38   margin-bottom: 0.5em;\r
  39   line-height: 1.3;\r
  40 }\r
  41 \r
  42 h1 {\r
  43   border-bottom: 2px solid silver;\r
  44 }\r
  45 h2 {\r
  46   border-bottom: 2px solid silver;\r
  47   padding-top: 0.5em;\r
  48 }\r
  49 \r
  50 div.sectionbody {\r
  51   font-family: serif;\r
  52   margin-left: 0;\r
  53 }\r
  54 \r
  55 hr {\r
  56   border: 1px solid silver;\r
  57 }\r
  58 \r
  59 p {\r
  60   margin-top: 0.5em;\r
  61   margin-bottom: 0.5em;\r
  62 }\r
  63 \r
  64 pre {\r
  65   padding: 0;\r
  66   margin: 0;\r
  67 }\r
  68 \r
  69 span#author {\r
  70   color: #527bbd;\r
  71   font-family: sans-serif;\r
  72   font-weight: bold;\r
  73   font-size: 1.2em;\r
  74 }\r
  75 span#email {\r
  76 }\r
  77 span#revision {\r
  78   font-family: sans-serif;\r
  79 }\r
  80 \r
  81 div#footer {\r
  82   font-family: sans-serif;\r
  83   font-size: small;\r
  84   border-top: 2px solid silver;\r
  85   padding-top: 0.5em;\r
  86   margin-top: 4.0em;\r
  87 }\r
  88 div#footer-text {\r
  89   float: left;\r
  90   padding-bottom: 0.5em;\r
  91 }\r
  92 div#footer-badges {\r
  93   float: right;\r
  94   padding-bottom: 0.5em;\r
  95 }\r
  96 \r
  97 div#preamble,\r
  98 div.tableblock, div.imageblock, div.exampleblock, div.verseblock,\r
  99 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,\r
 100 div.admonitionblock {\r
 101   margin-right: 10%;\r
 102   margin-top: 1.5em;\r
 103   margin-bottom: 1.5em;\r
 104 }\r
 105 div.admonitionblock {\r
 106   margin-top: 2.5em;\r
 107   margin-bottom: 2.5em;\r
 108 }\r
 109 \r
 110 div.content { /* Block element content. */\r
 111   padding: 0;\r
 112 }\r
 113 \r
 114 /* Block element titles. */\r
 115 div.title, caption.title {\r
 116   font-family: sans-serif;\r
 117   font-weight: bold;\r
 118   text-align: left;\r
 119   margin-top: 1.0em;\r
 120   margin-bottom: 0.5em;\r
 121 }\r
 122 div.title + * {\r
 123   margin-top: 0;\r
 124 }\r
 125 \r
 126 td div.title:first-child {\r
 127   margin-top: 0.0em;\r
 128 }\r
 129 div.content div.title:first-child {\r
 130   margin-top: 0.0em;\r
 131 }\r
 132 div.content + div.title {\r
 133   margin-top: 0.0em;\r
 134 }\r
 135 \r
 136 div.sidebarblock > div.content {\r
 137   background: #ffffee;\r
 138   border: 1px solid silver;\r
 139   padding: 0.5em;\r
 140 }\r
 141 \r
 142 div.listingblock > div.content {\r
 143   border: 1px solid silver;\r
 144   background: #f4f4f4;\r
 145   padding: 0.5em;\r
 146 }\r
 147 \r
 148 div.quoteblock > div.content {\r
 149   padding-left: 2.0em;\r
 150 }\r
 151 div.quoteblock .attribution {\r
 152   text-align: right;\r
 153 }\r
 154 \r
 155 div.admonitionblock .icon {\r
 156   vertical-align: top;\r
 157   font-size: 1.1em;\r
 158   font-weight: bold;\r
 159   text-decoration: underline;\r
 160   color: #527bbd;\r
 161   padding-right: 0.5em;\r
 162 }\r
 163 div.admonitionblock td.content {\r
 164   padding-left: 0.5em;\r
 165   border-left: 2px solid silver;\r
 166 }\r
 167 \r
 168 div.exampleblock > div.content {\r
 169   border-left: 2px solid silver;\r
 170   padding: 0.5em;\r
 171 }\r
 172 \r
 173 div.verseblock div.content {\r
 174   white-space: pre;\r
 175 }\r
 176 \r
 177 div.imageblock div.content { padding-left: 0; }\r
 178 div.imageblock img { border: 1px solid silver; }\r
 179 span.image img { border-style: none; }\r
 180 \r
 181 dl {\r
 182   margin-top: 0.8em;\r
 183   margin-bottom: 0.8em;\r
 184 }\r
 185 dt {\r
 186   margin-top: 0.5em;\r
 187   margin-bottom: 0;\r
 188   font-style: italic;\r
 189 }\r
 190 dd > *:first-child {\r
 191   margin-top: 0;\r
 192 }\r
 193 \r
 194 ul, ol {\r
 195     list-style-position: outside;\r
 196 }\r
 197 ol.olist2 {\r
 198   list-style-type: lower-alpha;\r
 199 }\r
 200 \r
 201 div.tableblock > table {\r
 202   border-color: #527bbd;\r
 203   border-width: 3px;\r
 204 }\r
 205 thead {\r
 206   font-family: sans-serif;\r
 207   font-weight: bold;\r
 208 }\r
 209 tfoot {\r
 210   font-weight: bold;\r
 211 }\r
 212 \r
 213 div.hlist {\r
 214   margin-top: 0.8em;\r
 215   margin-bottom: 0.8em;\r
 216 }\r
 217 td.hlist1 {\r
 218   vertical-align: top;\r
 219   font-style: italic;\r
 220   padding-right: 0.8em;\r
 221 }\r
 222 td.hlist2 {\r
 223   vertical-align: top;\r
 224 }\r
 225 \r
 226 @media print {\r
 227   div#footer-badges { display: none; }\r
 228 }\r
 229 include::./stylesheets/xhtml11-manpage.css[]\r
 230 /* Workarounds for IE6's broken and incomplete CSS2. */\r
 231 \r
 232 div.sidebar-content {\r
 233   background: #ffffee;\r
 234   border: 1px solid silver;\r
 235   padding: 0.5em;\r
 236 }\r
 237 div.sidebar-title, div.image-title {\r
 238   font-family: sans-serif;\r
 239   font-weight: bold;\r
 240   margin-top: 0.0em;\r
 241   margin-bottom: 0.5em;\r
 242 }\r
 243 \r
 244 div.listingblock div.content {\r
 245   border: 1px solid silver;\r
 246   background: #f4f4f4;\r
 247   padding: 0.5em;\r
 248 }\r
 249 \r
 250 div.quoteblock-content {\r
 251   padding-left: 2.0em;\r
 252 }\r
 253 \r
 254 div.exampleblock-content {\r
 255   border-left: 2px solid silver;\r
 256   padding-left: 0.5em;\r
 257 }\r
 258 </style>\r
 259 <title>git-diff-stages(1)</title>\r
 260 </head>\r
 261 <body>\r
 262 <div id="header">\r
 263 <h1>\r
 264 git-diff-stages(1) Manual Page\r
 265 </h1>\r
 266 <h2>NAME</h2>\r
 267 <div class="sectionbody">\r
 268 <p>git-diff-stages -\r
 269    Compares content and mode of blobs between stages in an unmerged index file.\r
 270 </p>\r
 271 </div>\r
 272 </div>\r
 273 <h2>SYNOPSIS</h2>\r
 274 <div class="sectionbody">\r
 275 <p><em>git-diff-stages</em> [&lt;common diff options&gt;] &lt;stage1&gt; &lt;stage2&gt; [&lt;path&gt;&#8230;]</p>\r
 276 </div>\r
 277 <h2>DESCRIPTION</h2>\r
 278 <div class="sectionbody">\r
 279 <p>Compares the content and mode of the blobs in two stages in an\r
 280 unmerged index file.</p>\r
 281 </div>\r
 282 <h2>OPTIONS</h2>\r
 283 <div class="sectionbody">\r
 284 <dl>\r
 285 <dt>\r
 286 -p\r
 287 </dt>\r
 288 <dd>\r
 289 <p>\r
 290         Generate patch (see section on generating patches)\r
 291 </p>\r
 292 </dd>\r
 293 <dt>\r
 294 -u\r
 295 </dt>\r
 296 <dd>\r
 297 <p>\r
 298         Synonym for "-p".\r
 299 </p>\r
 300 </dd>\r
 301 <dt>\r
 302 -z\r
 303 </dt>\r
 304 <dd>\r
 305 <p>\r
 306         \0 line termination on output\r
 307 </p>\r
 308 </dd>\r
 309 <dt>\r
 310 --name-only\r
 311 </dt>\r
 312 <dd>\r
 313 <p>\r
 314         Show only names of changed files.\r
 315 </p>\r
 316 </dd>\r
 317 <dt>\r
 318 --name-status\r
 319 </dt>\r
 320 <dd>\r
 321 <p>\r
 322         Show only names and status of changed files.\r
 323 </p>\r
 324 </dd>\r
 325 <dt>\r
 326 --full-index\r
 327 </dt>\r
 328 <dd>\r
 329 <p>\r
 330         Instead of the first handful characters, show full\r
 331         object name of pre- and post-image blob on the "index"\r
 332         line when generating a patch format output.\r
 333 </p>\r
 334 </dd>\r
 335 <dt>\r
 336 --abbrev[=&lt;n&gt;]\r
 337 </dt>\r
 338 <dd>\r
 339 <p>\r
 340         Instead of showing the full 40-byte hexadecimal object\r
 341         name in diff-raw format output and diff-tree header\r
 342         lines, show only handful hexdigits prefix.  This is\r
 343         independent of --full-index option above, which controls\r
 344         the diff-patch output format.  Non default number of\r
 345         digits can be specified with --abbrev=&lt;n&gt;.\r
 346 </p>\r
 347 </dd>\r
 348 <dt>\r
 349 -B\r
 350 </dt>\r
 351 <dd>\r
 352 <p>\r
 353         Break complete rewrite changes into pairs of delete and create.\r
 354 </p>\r
 355 </dd>\r
 356 <dt>\r
 357 -M\r
 358 </dt>\r
 359 <dd>\r
 360 <p>\r
 361         Detect renames.\r
 362 </p>\r
 363 </dd>\r
 364 <dt>\r
 365 -C\r
 366 </dt>\r
 367 <dd>\r
 368 <p>\r
 369         Detect copies as well as renames.\r
 370 </p>\r
 371 </dd>\r
 372 <dt>\r
 373 --find-copies-harder\r
 374 </dt>\r
 375 <dd>\r
 376 <p>\r
 377         For performance reasons, by default, -C option finds copies only\r
 378         if the original file of the copy was modified in the same\r
 379         changeset.  This flag makes the command\r
 380         inspect unmodified files as candidates for the source of\r
 381         copy.  This is a very expensive operation for large\r
 382         projects, so use it with caution.\r
 383 </p>\r
 384 </dd>\r
 385 <dt>\r
 386 -l&lt;num&gt;\r
 387 </dt>\r
 388 <dd>\r
 389 <p>\r
 390         -M and -C options require O(n^2) processing time where n\r
 391         is the number of potential rename/copy targets.  This\r
 392         option prevents rename/copy detection from running if\r
 393         the number of rename/copy targets exceeds the specified\r
 394         number.\r
 395 </p>\r
 396 </dd>\r
 397 <dt>\r
 398 -S&lt;string&gt;\r
 399 </dt>\r
 400 <dd>\r
 401 <p>\r
 402         Look for differences that contain the change in &lt;string&gt;.\r
 403 </p>\r
 404 </dd>\r
 405 <dt>\r
 406 --pickaxe-all\r
 407 </dt>\r
 408 <dd>\r
 409 <p>\r
 410         When -S finds a change, show all the changes in that\r
 411         changeset, not just the files that contain the change\r
 412         in &lt;string&gt;.\r
 413 </p>\r
 414 </dd>\r
 415 <dt>\r
 416 -O&lt;orderfile&gt;\r
 417 </dt>\r
 418 <dd>\r
 419 <p>\r
 420         Output the patch in the order specified in the\r
 421         &lt;orderfile&gt;, which has one shell glob pattern per line.\r
 422 </p>\r
 423 </dd>\r
 424 <dt>\r
 425 -R\r
 426 </dt>\r
 427 <dd>\r
 428 <p>\r
 429         Swap two inputs; that is, show differences from index or\r
 430         on-disk file to tree contents.\r
 431 </p>\r
 432 </dd>\r
 433 </dl>\r
 434 <p>For more detailed explanation on these common options, see also\r
 435 <a href="diffcore.html">diffcore documentation</a>.</p>\r
 436 <dl>\r
 437 <dt>\r
 438 &lt;stage1&gt;,&lt;stage2&gt;\r
 439 </dt>\r
 440 <dd>\r
 441 <p>\r
 442         The stage number to be compared.\r
 443 </p>\r
 444 </dd>\r
 445 </dl>\r
 446 </div>\r
 447 <h2>Output format</h2>\r
 448 <div class="sectionbody">\r
 449 <p>The output format from "git-diff-index", "git-diff-tree" and\r
 450 "git-diff-files" are very similar.</p>\r
 451 <p>These commands all compare two sets of things; what is\r
 452 compared differs:</p>\r
 453 <dl>\r
 454 <dt>\r
 455 git-diff-index &lt;tree-ish&gt;\r
 456 </dt>\r
 457 <dd>\r
 458 <p>\r
 459         compares the &lt;tree-ish&gt; and the files on the filesystem.\r
 460 </p>\r
 461 </dd>\r
 462 <dt>\r
 463 git-diff-index --cached &lt;tree-ish&gt;\r
 464 </dt>\r
 465 <dd>\r
 466 <p>\r
 467         compares the &lt;tree-ish&gt; and the index.\r
 468 </p>\r
 469 </dd>\r
 470 <dt>\r
 471 git-diff-tree [-r] &lt;tree-ish-1&gt; &lt;tree-ish-2&gt; [&lt;pattern&gt;&#8230;]\r
 472 </dt>\r
 473 <dd>\r
 474 <p>\r
 475         compares the trees named by the two arguments.\r
 476 </p>\r
 477 </dd>\r
 478 <dt>\r
 479 git-diff-files [&lt;pattern&gt;&#8230;]\r
 480 </dt>\r
 481 <dd>\r
 482 <p>\r
 483         compares the index and the files on the filesystem.\r
 484 </p>\r
 485 </dd>\r
 486 </dl>\r
 487 <p>An output line is formatted this way:</p>\r
 488 <div class="listingblock">\r
 489 <div class="content">\r
 490 <pre><tt>in-place edit  :100644 100644 bcd1234... 0123456... M file0\r
 491 copy-edit      :100644 100644 abcd123... 1234567... C68 file1 file2\r
 492 rename-edit    :100644 100644 abcd123... 1234567... R86 file1 file3\r
 493 create         :000000 100644 0000000... 1234567... A file4\r
 494 delete         :100644 000000 1234567... 0000000... D file5\r
 495 unmerged       :000000 000000 0000000... 0000000... U file6</tt></pre>\r
 496 </div></div>\r
 497 <p>That is, from the left to the right:</p>\r
 498 <ol>\r
 499 <li>\r
 500 <p>\r
 501 a colon.\r
 502 </p>\r
 503 </li>\r
 504 <li>\r
 505 <p>\r
 506 mode for "src"; 000000 if creation or unmerged.\r
 507 </p>\r
 508 </li>\r
 509 <li>\r
 510 <p>\r
 511 a space.\r
 512 </p>\r
 513 </li>\r
 514 <li>\r
 515 <p>\r
 516 mode for "dst"; 000000 if deletion or unmerged.\r
 517 </p>\r
 518 </li>\r
 519 <li>\r
 520 <p>\r
 521 a space.\r
 522 </p>\r
 523 </li>\r
 524 <li>\r
 525 <p>\r
 526 sha1 for "src"; 0{40} if creation or unmerged.\r
 527 </p>\r
 528 </li>\r
 529 <li>\r
 530 <p>\r
 531 a space.\r
 532 </p>\r
 533 </li>\r
 534 <li>\r
 535 <p>\r
 536 sha1 for "dst"; 0{40} if creation, unmerged or "look at work tree".\r
 537 </p>\r
 538 </li>\r
 539 <li>\r
 540 <p>\r
 541 a space.\r
 542 </p>\r
 543 </li>\r
 544 <li>\r
 545 <p>\r
 546 status, followed by optional "score" number.\r
 547 </p>\r
 548 </li>\r
 549 <li>\r
 550 <p>\r
 551 a tab or a NUL when <em>-z</em> option is used.\r
 552 </p>\r
 553 </li>\r
 554 <li>\r
 555 <p>\r
 556 path for "src"\r
 557 </p>\r
 558 </li>\r
 559 <li>\r
 560 <p>\r
 561 a tab or a NUL when <em>-z</em> option is used; only exists for C or R.\r
 562 </p>\r
 563 </li>\r
 564 <li>\r
 565 <p>\r
 566 path for "dst"; only exists for C or R.\r
 567 </p>\r
 568 </li>\r
 569 <li>\r
 570 <p>\r
 571 an LF or a NUL when <em>-z</em> option is used, to terminate the record.\r
 572 </p>\r
 573 </li>\r
 574 </ol>\r
 575 <p>&lt;sha1&gt; is shown as all 0's if a file is new on the filesystem\r
 576 and it is out of sync with the index.</p>\r
 577 <p>Example:</p>\r
 578 <div class="listingblock">\r
 579 <div class="content">\r
 580 <pre><tt>:100644 100644 5be4a4...... 000000...... M file.c</tt></pre>\r
 581 </div></div>\r
 582 <p>When <tt>-z</tt> option is not used, TAB, LF, and backslash characters\r
 583 in pathnames are represented as <tt>\t</tt>, <tt>\n</tt>, and <tt>\\</tt>,\r
 584 respectively.</p>\r
 585 </div>\r
 586 <h2>Generating patches with -p</h2>\r
 587 <div class="sectionbody">\r
 588 <p>When "git-diff-index", "git-diff-tree", or "git-diff-files" are run\r
 589 with a <em>-p</em> option, they do not produce the output described above;\r
 590 instead they produce a patch file.</p>\r
 591 <p>The patch generation can be customized at two levels.</p>\r
 592 <ol>\r
 593 <li>\r
 594 <p>\r
 595 When the environment variable <em>GIT_EXTERNAL_DIFF</em> is not set,\r
 596    these commands internally invoke "diff" like this:\r
 597 </p>\r
 598 <div class="literalblock">\r
 599 <div class="content">\r
 600 <pre><tt>diff -L a/&lt;path&gt; -L b/&lt;path&gt; -pu &lt;old&gt; &lt;new&gt;</tt></pre>\r
 601 </div></div>\r
 602 <p>For added files, <tt>/dev/null</tt> is used for &lt;old&gt;.  For removed\r
 603 files, <tt>/dev/null</tt> is used for &lt;new&gt;</p>\r
 604 <p>The "diff" formatting options can be customized via the\r
 605 environment variable <em>GIT_DIFF_OPTS</em>.  For example, if you\r
 606 prefer context diff:</p>\r
 607 <div class="literalblock">\r
 608 <div class="content">\r
 609 <pre><tt>GIT_DIFF_OPTS=-c git-diff-index -p HEAD</tt></pre>\r
 610 </div></div>\r
 611 </li>\r
 612 <li>\r
 613 <p>\r
 614 When the environment variable <em>GIT_EXTERNAL_DIFF</em> is set, the\r
 615    program named by it is called, instead of the diff invocation\r
 616    described above.\r
 617 </p>\r
 618 <p>For a path that is added, removed, or modified,\r
 619 <em>GIT_EXTERNAL_DIFF</em> is called with 7 parameters:</p>\r
 620 <div class="literalblock">\r
 621 <div class="content">\r
 622 <pre><tt>path old-file old-hex old-mode new-file new-hex new-mode</tt></pre>\r
 623 </div></div>\r
 624 <p>where:</p>\r
 625 <div class="hlist"><table>\r
 626 <tr>\r
 627 <td class="hlist1">\r
 628 &lt;old|new&gt;-file\r
 629 </td>\r
 630 <td class="hlist2">\r
 631 are files GIT_EXTERNAL_DIFF can use to read the\r
 632                       contents of &lt;old|new&gt;,\r
 633 </td>\r
 634 </tr>\r
 635 <tr>\r
 636 <td class="hlist1">\r
 637 &lt;old|new&gt;-hex\r
 638 </td>\r
 639 <td class="hlist2">\r
 640 are the 40-hexdigit SHA1 hashes,\r
 641 </td>\r
 642 </tr>\r
 643 <tr>\r
 644 <td class="hlist1">\r
 645 &lt;old|new&gt;-mode\r
 646 </td>\r
 647 <td class="hlist2">\r
 648 are the octal representation of the file modes.\r
 649 </td>\r
 650 </tr>\r
 651 </table></div>\r
 652 <p>The file parameters can point at the user's working file\r
 653 (e.g. <tt>new-file</tt> in "git-diff-files"), <tt>/dev/null</tt> (e.g. <tt>old-file</tt>\r
 654 when a new file is added), or a temporary file (e.g. <tt>old-file</tt> in the\r
 655 index).  <em>GIT_EXTERNAL_DIFF</em> should not worry about unlinking the\r
 656 temporary file --- it is removed when <em>GIT_EXTERNAL_DIFF</em> exits.</p>\r
 657 </li>\r
 658 </ol>\r
 659 <p>For a path that is unmerged, <em>GIT_EXTERNAL_DIFF</em> is called with 1\r
 660 parameter, &lt;path&gt;.</p>\r
 661 </div>\r
 662 <h2>git specific extension to diff format</h2>\r
 663 <div class="sectionbody">\r
 664 <p>What -p option produces is slightly different from the\r
 665 traditional diff format.</p>\r
 666 <ol>\r
 667 <li>\r
 668 <p>\r
 669 It is preceded with a "git diff" header, that looks like\r
 670      this:\r
 671 </p>\r
 672 <div class="literalblock">\r
 673 <div class="content">\r
 674 <pre><tt>diff --git a/file1 b/file2</tt></pre>\r
 675 </div></div>\r
 676 <p>The <tt>a/</tt> and <tt>b/</tt> filenames are the same unless rename/copy is\r
 677 involved.  Especially, even for a creation or a deletion,\r
 678 <tt>/dev/null</tt> is _not_ used in place of <tt>a/</tt> or <tt>b/</tt> filenames.</p>\r
 679 <p>When rename/copy is involved, <tt>file1</tt> and <tt>file2</tt> show the\r
 680 name of the source file of the rename/copy and the name of\r
 681 the file that rename/copy produces, respectively.</p>\r
 682 </li>\r
 683 <li>\r
 684 <p>\r
 685 It is followed by one or more extended header lines:\r
 686 </p>\r
 687 <div class="literalblock">\r
 688 <div class="content">\r
 689 <pre><tt>old mode &lt;mode&gt;\r
 690 new mode &lt;mode&gt;\r
 691 deleted file mode &lt;mode&gt;\r
 692 new file mode &lt;mode&gt;\r
 693 copy from &lt;path&gt;\r
 694 copy to &lt;path&gt;\r
 695 rename from &lt;path&gt;\r
 696 rename to &lt;path&gt;\r
 697 similarity index &lt;number&gt;\r
 698 dissimilarity index &lt;number&gt;\r
 699 index &lt;hash&gt;..&lt;hash&gt; &lt;mode&gt;</tt></pre>\r
 700 </div></div>\r
 701 </li>\r
 702 <li>\r
 703 <p>\r
 704 TAB, LF, and backslash characters in pathnames are\r
 705     represented as <tt>\t</tt>, <tt>\n</tt>, and <tt>\\</tt>, respectively.\r
 706 </p>\r
 707 </li>\r
 708 </ol>\r
 709 </div>\r
 710 <h2>combined diff format</h2>\r
 711 <div class="sectionbody">\r
 712 <p>git-diff-tree and git-diff-files can take <em>-c</em> or <em>--cc</em> option\r
 713 to produce <em>combined diff</em>, which looks like this:</p>\r
 714 <div class="listingblock">\r
 715 <div class="content">\r
 716 <pre><tt>diff --combined describe.c\r
 717 @@@ +98,7 @@@\r
 718    return (a_date &gt; b_date) ? -1 : (a_date == b_date) ? 0 : 1;\r
 719   }\r
 720 \r
 721 - static void describe(char *arg)\r
 722  -static void describe(struct commit *cmit, int last_one)\r
 723 ++static void describe(char *arg, int last_one)\r
 724   {\r
 725  +     unsigned char sha1[20];\r
 726  +     struct commit *cmit;</tt></pre>\r
 727 </div></div>\r
 728 <p>Unlike the traditional <em>unified</em> diff format, which shows two\r
 729 files A and B with a single column that has <tt>-</tt> (minus &#8212;\r
 730 appears in A but removed in B), <tt>+</tt> (plus &#8212; missing in A but\r
 731 added to B), or <tt> </tt> (space &#8212; unchanged) prefix, this format\r
 732 compares two or more files file1, file2,&#8230; with one file X, and\r
 733 shows how X differs from each of fileN.  One column for each of\r
 734 fileN is prepended to the output line to note how X's line is\r
 735 different from it.</p>\r
 736 <p>A <tt>-</tt> character in the column N means that the line appears in\r
 737 fileN but it does not appear in the last file.  A <tt>+</tt> character\r
 738 in the column N means that the line appears in the last file,\r
 739 and fileN does not have that line.</p>\r
 740 <p>In the above example output, the function signature was changed\r
 741 from both files (hence two <tt>-</tt> removals from both file1 and\r
 742 file2, plus <tt>++</tt> to mean one line that was added does not appear\r
 743 in either file1 nor file2).  Also two other lines are the same\r
 744 from file1 but do not appear in file2 (hence prefixed with <tt> +</tt>).</p>\r
 745 <p>When shown by <tt>git diff-tree -c</tt>, it compares the parents of a\r
 746 merge commit with the merge result (i.e. file1..fileN are the\r
 747 parents).  When shown by <tt>git diff-files -c</tt>, it compares the\r
 748 two unresolved merge parents with the working tree file\r
 749 (i.e. file1 is stage 2 aka "our version", file2 is stage 3 aka\r
 750 "their version").</p>\r
 751 </div>\r
 752 <h2>Author</h2>\r
 753 <div class="sectionbody">\r
 754 <p>Written by Junio C Hamano &lt;junkio@cox.net&gt;</p>\r
 755 </div>\r
 756 <h2>Documentation</h2>\r
 757 <div class="sectionbody">\r
 758 <p>Documentation by Junio C Hamano.</p>\r
 759 </div>\r
 760 <h2>GIT</h2>\r
 761 <div class="sectionbody">\r
 762 <p>Part of the <a href="git.html">git(7)</a> suite</p>\r
 763 </div>\r
 764 <div id="footer">\r
 765 <div id="footer-text">\r
 766 Last updated 28-Jan-2006 02:37:52 PDT\r
 767 </div>\r
 768 </div>\r
 769 </body>\r
 770 </html>\r