git-diff.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(1)</title>\r
 260 </head>\r
 261 <body>\r
 262 <div id="header">\r
 263 <h1>\r
 264 git-diff(1) Manual Page\r
 265 </h1>\r
 266 <h2>NAME</h2>\r
 267 <div class="sectionbody">\r
 268 <p>git-diff -\r
 269    Show changes between commits, commit and working tree, etc.\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</em> [ --diff-options ] &lt;ent&gt;{0,2} [&lt;path&gt;&#8230;]</p>\r
 276 </div>\r
 277 <h2>DESCRIPTION</h2>\r
 278 <div class="sectionbody">\r
 279 <p>Show changes between two ents, an ent and the working tree, an\r
 280 ent and the index file, or the index file and the working tree.\r
 281 The combination of what is compared with what is determined by\r
 282 the number of ents given to the command.</p>\r
 283 <ul>\r
 284 <li>\r
 285 <p>\r
 286 When no &lt;ent&gt; is given, the working tree and the index\r
 287   file is compared, using <tt>git-diff-files</tt>.\r
 288 </p>\r
 289 </li>\r
 290 <li>\r
 291 <p>\r
 292 When one &lt;ent&gt; is given, the working tree and the named\r
 293   tree is compared, using <tt>git-diff-index</tt>.  The option\r
 294   <tt>--cached</tt> can be given to compare the index file and\r
 295   the named tree.\r
 296 </p>\r
 297 </li>\r
 298 <li>\r
 299 <p>\r
 300 When two &lt;ent&gt;s are given, these two trees are compared\r
 301   using <tt>git-diff-tree</tt>.\r
 302 </p>\r
 303 </li>\r
 304 </ul>\r
 305 </div>\r
 306 <h2>OPTIONS</h2>\r
 307 <div class="sectionbody">\r
 308 <dl>\r
 309 <dt>\r
 310 --diff-options\r
 311 </dt>\r
 312 <dd>\r
 313 <p>\r
 314         <em>--diff-options</em> are passed to the <tt>git-diff-files</tt>,\r
 315         <tt>git-diff-index</tt>, and <tt>git-diff-tree</tt> commands.  See the\r
 316         documentation for these commands for description.\r
 317 </p>\r
 318 </dd>\r
 319 <dt>\r
 320 &lt;path&gt;&#8230;\r
 321 </dt>\r
 322 <dd>\r
 323 <p>\r
 324         The &lt;path&gt; arguments are also passed to <tt>git-diff-*</tt>\r
 325         commands.\r
 326 </p>\r
 327 </dd>\r
 328 </dl>\r
 329 </div>\r
 330 <h2>EXAMPLES</h2>\r
 331 <div class="sectionbody">\r
 332 <dl>\r
 333 <dt>\r
 334 Various ways to check your working tree\r
 335 </dt>\r
 336 <dd>\r
 337 <div class="listingblock">\r
 338 <div class="content">\r
 339 <pre><tt>$ git diff <b>(1)</b>\r
 340 $ git diff --cached <b>(2)</b>\r
 341 $ git diff HEAD <b>(3)</b>\r
 342 \r
 343 <b>(1)</b> changes in the working tree since your last git-update-index.\r
 344 <b>(2)</b> changes between the index and your last commit; what you\r
 345 would be committing if you run "git commit" without "-a" option.\r
 346 <b>(3)</b> changes in the working tree since your last commit; what you\r
 347 would be committing if you run "git commit -a"</tt></pre>\r
 348 </div></div>\r
 349 </dd>\r
 350 <dt>\r
 351 Comparing with arbitrary commits\r
 352 </dt>\r
 353 <dd>\r
 354 <div class="listingblock">\r
 355 <div class="content">\r
 356 <pre><tt>$ git diff test <b>(1)</b>\r
 357 $ git diff HEAD -- ./test <b>(2)</b>\r
 358 $ git diff HEAD^ HEAD <b>(3)</b>\r
 359 \r
 360 <b>(1)</b> instead of using the tip of the current branch, compare with the\r
 361 tip of "test" branch.\r
 362 <b>(2)</b> instead of comparing with the tip of "test" branch, compare with\r
 363 the tip of the current branch, but limit the comparison to the\r
 364 file "test".\r
 365 <b>(3)</b> compare the version before the last commit and the last commit.</tt></pre>\r
 366 </div></div>\r
 367 </dd>\r
 368 <dt>\r
 369 Limiting the diff output\r
 370 </dt>\r
 371 <dd>\r
 372 <div class="listingblock">\r
 373 <div class="content">\r
 374 <pre><tt>$ git diff --diff-filter=MRC <b>(1)</b>\r
 375 $ git diff --name-status -r <b>(2)</b>\r
 376 $ git diff arch/i386 include/asm-i386 <b>(3)</b>\r
 377 \r
 378 <b>(1)</b> show only modification, rename and copy, but not addition\r
 379 nor deletion.\r
 380 <b>(2)</b> show only names and the nature of change, but not actual\r
 381 diff output.  --name-status disables usual patch generation\r
 382 which in turn also disables recursive behaviour, so without -r\r
 383 you would only see the directory name if there is a change in a\r
 384 file in a subdirectory.\r
 385 <b>(3)</b> limit diff output to named subtrees.</tt></pre>\r
 386 </div></div>\r
 387 </dd>\r
 388 <dt>\r
 389 Munging the diff output\r
 390 </dt>\r
 391 <dd>\r
 392 <div class="listingblock">\r
 393 <div class="content">\r
 394 <pre><tt>$ git diff --find-copies-harder -B -C <b>(1)</b>\r
 395 $ git diff -R <b>(2)</b>\r
 396 \r
 397 <b>(1)</b> spend extra cycles to find renames, copies and complete\r
 398 rewrites (very expensive).\r
 399 <b>(2)</b> output diff in reverse.</tt></pre>\r
 400 </div></div>\r
 401 </dd>\r
 402 </dl>\r
 403 </div>\r
 404 <h2>Author</h2>\r
 405 <div class="sectionbody">\r
 406 <p>Written by Linus Torvalds &lt;torvalds@osdl.org&gt;</p>\r
 407 </div>\r
 408 <h2>Documentation</h2>\r
 409 <div class="sectionbody">\r
 410 <p>Documentation by Junio C Hamano and the git-list &lt;git@vger.kernel.org&gt;.</p>\r
 411 </div>\r
 412 <h2>GIT</h2>\r
 413 <div class="sectionbody">\r
 414 <p>Part of the <a href="git.html">git(7)</a> suite</p>\r
 415 </div>\r
 416 <div id="footer">\r
 417 <div id="footer-text">\r
 418 Last updated 06-Jan-2006 17:12:28 PDT\r
 419 </div>\r
 420 </div>\r
 421 </body>\r
 422 </html>\r