Google Git
Sign in
chromium / external / gitster / git-htmldocs / 7d44952cc831fe14797546fa07afc857b0844d25 / . / git-format-patch.html
blob: 1f0c8d0b018b0c37160943af2248dbe9dfba67e5 [file] [log] [blame]
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
4<head>
5<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]6<meta name="generator" content="AsciiDoc 8.2.5" />
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]7<style type="text/css">
8/* Debug borders */
9p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
10/*
11 border: 1px solid red;
12*/
13}
14
15body {
16 margin: 1em 5% 1em 5%;
17}
18
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]19a {
20 color: blue;
21 text-decoration: underline;
22}
23a:visited {
24 color: fuchsia;
25}
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]26
27em {
28 font-style: italic;
29}
30
31strong {
32 font-weight: bold;
33}
34
35tt {
36 color: navy;
37}
38
39h1, h2, h3, h4, h5, h6 {
40 color: #527bbd;
41 font-family: sans-serif;
42 margin-top: 1.2em;
43 margin-bottom: 0.5em;
44 line-height: 1.3;
45}
46
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]47h1, h2, h3 {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]48 border-bottom: 2px solid silver;
49}
50h2 {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]51 padding-top: 0.5em;
52}
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]53h3 {
54 float: left;
55}
56h3 + * {
57 clear: left;
58}
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]59
60div.sectionbody {
61 font-family: serif;
62 margin-left: 0;
63}
64
65hr {
66 border: 1px solid silver;
67}
68
69p {
70 margin-top: 0.5em;
71 margin-bottom: 0.5em;
72}
73
74pre {
75 padding: 0;
76 margin: 0;
77}
78
79span#author {
80 color: #527bbd;
81 font-family: sans-serif;
82 font-weight: bold;
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]83 font-size: 1.1em;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]84}
85span#email {
86}
87span#revision {
88 font-family: sans-serif;
89}
90
91div#footer {
92 font-family: sans-serif;
93 font-size: small;
94 border-top: 2px solid silver;
95 padding-top: 0.5em;
96 margin-top: 4.0em;
97}
98div#footer-text {
99 float: left;
100 padding-bottom: 0.5em;
101}
102div#footer-badges {
103 float: right;
104 padding-bottom: 0.5em;
105}
106
107div#preamble,
108div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
109div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
110div.admonitionblock {
111 margin-right: 10%;
112 margin-top: 1.5em;
113 margin-bottom: 1.5em;
114}
115div.admonitionblock {
116 margin-top: 2.5em;
117 margin-bottom: 2.5em;
118}
119
120div.content { /* Block element content. */
121 padding: 0;
122}
123
124/* Block element titles. */
125div.title, caption.title {
126 font-family: sans-serif;
127 font-weight: bold;
128 text-align: left;
129 margin-top: 1.0em;
130 margin-bottom: 0.5em;
131}
132div.title + * {
133 margin-top: 0;
134}
135
136td div.title:first-child {
137 margin-top: 0.0em;
138}
139div.content div.title:first-child {
140 margin-top: 0.0em;
141}
142div.content + div.title {
143 margin-top: 0.0em;
144}
145
146div.sidebarblock > div.content {
147 background: #ffffee;
148 border: 1px solid silver;
149 padding: 0.5em;
150}
151
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]152div.listingblock {
153 margin-right: 0%;
154}
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]155div.listingblock > div.content {
156 border: 1px solid silver;
157 background: #f4f4f4;
158 padding: 0.5em;
159}
160
161div.quoteblock > div.content {
162 padding-left: 2.0em;
163}
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]164
165div.attribution {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]166 text-align: right;
167}
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]168div.verseblock + div.attribution {
169 text-align: left;
170}
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]171
172div.admonitionblock .icon {
173 vertical-align: top;
174 font-size: 1.1em;
175 font-weight: bold;
176 text-decoration: underline;
177 color: #527bbd;
178 padding-right: 0.5em;
179}
180div.admonitionblock td.content {
181 padding-left: 0.5em;
182 border-left: 2px solid silver;
183}
184
185div.exampleblock > div.content {
186 border-left: 2px solid silver;
187 padding: 0.5em;
188}
189
190div.verseblock div.content {
191 white-space: pre;
192}
193
194div.imageblock div.content { padding-left: 0; }
195div.imageblock img { border: 1px solid silver; }
196span.image img { border-style: none; }
197
198dl {
199 margin-top: 0.8em;
200 margin-bottom: 0.8em;
201}
202dt {
203 margin-top: 0.5em;
204 margin-bottom: 0;
205 font-style: italic;
206}
207dd > *:first-child {
208 margin-top: 0;
209}
210
211ul, ol {
212 list-style-position: outside;
213}
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]214div.olist2 ol {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]215 list-style-type: lower-alpha;
216}
217
218div.tableblock > table {
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]219 border: 3px solid #527bbd;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]220}
221thead {
222 font-family: sans-serif;
223 font-weight: bold;
224}
225tfoot {
226 font-weight: bold;
227}
228
229div.hlist {
230 margin-top: 0.8em;
231 margin-bottom: 0.8em;
232}
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]233div.hlist td {
234 padding-bottom: 5px;
235}
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]236td.hlist1 {
237 vertical-align: top;
238 font-style: italic;
239 padding-right: 0.8em;
240}
241td.hlist2 {
242 vertical-align: top;
243}
244
245@media print {
246 div#footer-badges { display: none; }
247}
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]248
249div#toctitle {
250 color: #527bbd;
251 font-family: sans-serif;
252 font-size: 1.1em;
253 font-weight: bold;
254 margin-top: 1.0em;
255 margin-bottom: 0.1em;
256}
257
258div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
259 margin-top: 0;
260 margin-bottom: 0;
261}
262div.toclevel2 {
263 margin-left: 2em;
264 font-size: 0.9em;
265}
266div.toclevel3 {
267 margin-left: 4em;
268 font-size: 0.9em;
269}
270div.toclevel4 {
271 margin-left: 6em;
272 font-size: 0.9em;
273}
274include1::./stylesheets/xhtml11-manpage.css[]
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]275/* Workarounds for IE6's broken and incomplete CSS2. */
276
277div.sidebar-content {
278 background: #ffffee;
279 border: 1px solid silver;
280 padding: 0.5em;
281}
282div.sidebar-title, div.image-title {
283 font-family: sans-serif;
284 font-weight: bold;
285 margin-top: 0.0em;
286 margin-bottom: 0.5em;
287}
288
289div.listingblock div.content {
290 border: 1px solid silver;
291 background: #f4f4f4;
292 padding: 0.5em;
293}
294
295div.quoteblock-content {
296 padding-left: 2.0em;
297}
298
299div.exampleblock-content {
300 border-left: 2px solid silver;
301 padding-left: 0.5em;
302}
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]303
304/* IE6 sets dynamically generated links as visited. */
305div#toc a:visited { color: blue; }
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]306</style>
307<title>git-format-patch(1)</title>
308</head>
309<body>
310<div id="header">
311<h1>
312git-format-patch(1) Manual Page
313</h1>
314<h2>NAME</h2>
315<div class="sectionbody">
316<p>git-format-patch -
Junio C Hamano01078922006-03-10 00:31:47[diff] [blame]317 Prepare patches for e-mail submission
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]318</p>
319</div>
320</div>
321<h2>SYNOPSIS</h2>
322<div class="sectionbody">
Junio C Hamano235a91e2006-01-07 01:13:58[diff] [blame]323<div class="verseblock">
Junio C Hamanof4581102009-04-25 08:29:59[diff] [blame]324<div class="content"><em>git format-patch</em> [-k] [(-o|--output-directory) &lt;dir&gt; | --stdout]
Junio C Hamano1bbd0f42009-07-23 06:20:29[diff] [blame]325 [--no-thread | --thread[=&lt;style&gt;]]
Junio C Hamanof4581102009-04-25 08:29:59[diff] [blame]326 [(--attach|--inline)[=&lt;boundary&gt;] | --no-attach]
327 [-s | --signoff]
Junio C Hamano89a57342010-06-22 23:22:55[diff] [blame]328 [--signature=&lt;signature&gt; | --no-signature]
Junio C Hamano8c5802d2007-11-15 00:13:36[diff] [blame]329 [-n | --numbered | -N | --no-numbered]
Junio C Hamano94cad1a2007-06-06 10:48:25[diff] [blame]330 [--start-number &lt;n&gt;] [--numbered-files]
Junio C Hamano4f9a6052007-01-17 20:25:16[diff] [blame]331 [--in-reply-to=Message-Id] [--suffix=.&lt;sfx&gt;]
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]332 [--ignore-if-in-upstream]
Junio C Hamano6f1cca82007-04-12 05:02:47[diff] [blame]333 [--subject-prefix=Subject-Prefix]
Junio C Hamanoea90ab32010-03-15 20:32:55[diff] [blame]334 [--to=&lt;email&gt;] [--cc=&lt;email&gt;]
Junio C Hamano24bc09a2008-02-28 00:27:44[diff] [blame]335 [--cover-letter]
Junio C Hamanof4581102009-04-25 08:29:59[diff] [blame]336 [&lt;common diff options&gt;]
Junio C Hamano7d9e9bd2007-08-29 07:31:47[diff] [blame]337 [ &lt;since&gt; | &lt;revision range&gt; ]</div></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]338</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]339<h2 id="_description">DESCRIPTION</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]340<div class="sectionbody">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]341<div class="para"><p>Prepare each commit with its patch in
Junio C Hamano341071d2006-06-04 07:24:48[diff] [blame]342one file per commit, formatted to resemble UNIX mailbox format.
Junio C Hamano7d9e9bd2007-08-29 07:31:47[diff] [blame]343The output of this command is convenient for e-mail submission or
Junio C Hamano1aa40d22010-01-21 17:46:43[diff] [blame]344for use with <em>git am</em>.</p></div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]345<div class="para"><p>There are two ways to specify which commits to operate on.</p></div>
346<div class="olist"><ol>
Junio C Hamano7d9e9bd2007-08-29 07:31:47[diff] [blame]347<li>
348<p>
349A single commit, &lt;since&gt;, specifies that the commits leading
350 to the tip of the current branch that are not in the history
351 that leads to the &lt;since&gt; to be output.
352</p>
353</li>
354<li>
355<p>
356Generic &lt;revision range&gt; expression (see "SPECIFYING
357 REVISIONS" section in <a href="git-rev-parse.html">git-rev-parse(1)</a>) means the
358 commits in the specified range.
359</p>
360</li>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]361</ol></div>
Junio C Hamano9572e922009-04-02 06:52:03[diff] [blame]362<div class="para"><p>The first rule takes precedence in the case of a single &lt;commit&gt;. To
363apply the second rule, i.e., format everything since the beginning of
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]364history up until &lt;commit&gt;, use the <em>--root</em> option: <tt>git format-patch
365--root &lt;commit&gt;</tt>. If you want to format only &lt;commit&gt; itself, you
366can do this with <tt>git format-patch -1 &lt;commit&gt;</tt>.</p></div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]367<div class="para"><p>By default, each output file is numbered sequentially from 1, and uses the
Junio C Hamano341071d2006-06-04 07:24:48[diff] [blame]368first line of the commit message (massaged for pathname safety) as
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]369the filename. With the <tt>--numbered-files</tt> option, the output file names
Junio C Hamano94cad1a2007-06-06 10:48:25[diff] [blame]370will only be numbers, without the first line of the commit appended.
371The names of the output files are printed to standard
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]372output, unless the <tt>--stdout</tt> option is specified.</p></div>
373<div class="para"><p>If <tt>-o</tt> is specified, output files are created in &lt;dir&gt;. Otherwise
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]374they are created in the current working directory.</p></div>
Junio C Hamano7d06a8a2008-10-20 05:42:33[diff] [blame]375<div class="para"><p>By default, the subject of a single patch is "[PATCH] First Line" and
376the subject when multiple patches are output is "[PATCH n/m] First
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]377Line". To force 1/1 to be added for a single patch, use <tt>-n</tt>. To omit
378patch numbers from the subject, use <tt>-N</tt>.</p></div>
379<div class="para"><p>If given <tt>--thread</tt>, <tt>git-format-patch</tt> will generate <tt>In-Reply-To</tt> and
380<tt>References</tt> headers to make the second and subsequent patch mails appear
381as replies to the first mail; this also generates a <tt>Message-Id</tt> header to
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]382reference.</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]383</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]384<h2 id="_options">OPTIONS</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]385<div class="sectionbody">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]386<div class="vlist"><dl>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]387<dt>
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]388-p
389</dt>
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]390<dt>
391--no-stat
392</dt>
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]393<dd>
394<p>
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]395 Generate plain patches without any diffstats.
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]396</p>
397</dd>
398<dt>
Junio C Hamano69361562007-07-26 02:14:34[diff] [blame]399-U&lt;n&gt;
400</dt>
Junio C Hamano69361562007-07-26 02:14:34[diff] [blame]401<dt>
402--unified=&lt;n&gt;
403</dt>
404<dd>
405<p>
406 Generate diffs with &lt;n&gt; lines of context instead of
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]407 the usual three.
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]408</p>
409</dd>
Junio C Hamano20d47e32009-01-26 06:36:02[diff] [blame]410<dt>
411--patience
412</dt>
413<dd>
414<p>
415 Generate a diff using the "patience diff" algorithm.
416</p>
417</dd>
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]418<dt>
419--stat[=width[,name-width]]
420</dt>
421<dd>
422<p>
423 Generate a diffstat. You can override the default
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]424 output width for 80-column terminal by <tt>--stat=width</tt>.
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]425 The width of the filename part can be controlled by
426 giving another width to it separated by a comma.
427</p>
428</dd>
429<dt>
430--numstat
431</dt>
432<dd>
433<p>
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]434 Similar to <tt>--stat</tt>, but shows number of added and
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]435 deleted lines in decimal notation and pathname without
436 abbreviation, to make it more machine friendly. For
437 binary files, outputs two <tt>-</tt> instead of saying
438 <tt>0 0</tt>.
439</p>
440</dd>
441<dt>
442--shortstat
443</dt>
444<dd>
445<p>
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]446 Output only the last line of the <tt>--stat</tt> format containing total
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]447 number of modified files, as well as number of added and deleted
448 lines.
449</p>
450</dd>
451<dt>
Junio C Hamano6a45be92008-04-22 08:19:03[diff] [blame]452--dirstat[=limit]
453</dt>
454<dd>
455<p>
Junio C Hamanoa2f46622008-09-03 05:20:31[diff] [blame]456 Output the distribution of relative amount of changes (number of lines added or
457 removed) for each sub-directory. Directories with changes below
458 a cut-off percent (3% by default) are not shown. The cut-off percent
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]459 can be set with <tt>--dirstat=limit</tt>. Changes in a child directory is not
460 counted for the parent directory, unless <tt>--cumulative</tt> is used.
Junio C Hamano6a45be92008-04-22 08:19:03[diff] [blame]461</p>
462</dd>
463<dt>
Junio C Hamanoa476efa2008-10-10 15:31:42[diff] [blame]464--dirstat-by-file[=limit]
465</dt>
466<dd>
467<p>
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]468 Same as <tt>--dirstat</tt>, but counts changed files instead of lines.
Junio C Hamanoa476efa2008-10-10 15:31:42[diff] [blame]469</p>
470</dd>
471<dt>
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]472--summary
473</dt>
474<dd>
475<p>
476 Output a condensed summary of extended header information
477 such as creations, renames and mode changes.
478</p>
479</dd>
480<dt>
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]481--no-renames
482</dt>
483<dd>
484<p>
485 Turn off rename detection, even when the configuration
486 file gives the default to do so.
487</p>
488</dd>
489<dt>
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]490--full-index
491</dt>
492<dd>
493<p>
Junio C Hamano5cf43ca2008-08-20 09:14:14[diff] [blame]494 Instead of the first handful of characters, show the full
495 pre- and post-image blob object names on the "index"
496 line when generating patch format output.
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]497</p>
498</dd>
499<dt>
500--binary
501</dt>
502<dd>
503<p>
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]504 In addition to <tt>--full-index</tt>, output a binary diff that
505 can be applied with <tt>git-apply</tt>.
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]506</p>
507</dd>
508<dt>
509--abbrev[=&lt;n&gt;]
510</dt>
511<dd>
512<p>
513 Instead of showing the full 40-byte hexadecimal object
514 name in diff-raw format output and diff-tree header
Junio C Hamano6efe3022009-01-13 16:47:56[diff] [blame]515 lines, show only a partial prefix. This is
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]516 independent of the <tt>--full-index</tt> option above, which controls
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]517 the diff-patch output format. Non default number of
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]518 digits can be specified with <tt>--abbrev=&lt;n&gt;</tt>.
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]519</p>
520</dd>
521<dt>
522-B
523</dt>
524<dd>
525<p>
526 Break complete rewrite changes into pairs of delete and create.
527</p>
528</dd>
529<dt>
530-M
531</dt>
532<dd>
533<p>
534 Detect renames.
535</p>
536</dd>
537<dt>
538-C
539</dt>
540<dd>
541<p>
Junio C Hamano16f98872007-06-12 16:09:14[diff] [blame]542 Detect copies as well as renames. See also <tt>--find-copies-harder</tt>.
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]543</p>
544</dd>
545<dt>
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]546--find-copies-harder
547</dt>
548<dd>
549<p>
Junio C Hamano16f98872007-06-12 16:09:14[diff] [blame]550 For performance reasons, by default, <tt>-C</tt> option finds copies only
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]551 if the original file of the copy was modified in the same
552 changeset. This flag makes the command
553 inspect unmodified files as candidates for the source of
554 copy. This is a very expensive operation for large
Junio C Hamano16f98872007-06-12 16:09:14[diff] [blame]555 projects, so use it with caution. Giving more than one
556 <tt>-C</tt> option has the same effect.
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]557</p>
558</dd>
559<dt>
560-l&lt;num&gt;
561</dt>
562<dd>
563<p>
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]564 The <tt>-M</tt> and <tt>-C</tt> options require O(n^2) processing time where n
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]565 is the number of potential rename/copy targets. This
566 option prevents rename/copy detection from running if
567 the number of rename/copy targets exceeds the specified
568 number.
569</p>
570</dd>
571<dt>
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]572-O&lt;orderfile&gt;
573</dt>
574<dd>
575<p>
576 Output the patch in the order specified in the
577 &lt;orderfile&gt;, which has one shell glob pattern per line.
578</p>
579</dd>
580<dt>
Junio C Hamanobbbb8652008-12-29 10:34:22[diff] [blame]581-a
582</dt>
583<dt>
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]584--text
585</dt>
586<dd>
587<p>
588 Treat all files as text.
589</p>
590</dd>
591<dt>
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]592--ignore-space-at-eol
593</dt>
594<dd>
595<p>
Junio C Hamano3a702342007-12-12 21:34:02[diff] [blame]596 Ignore changes in whitespace at EOL.
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]597</p>
598</dd>
599<dt>
Junio C Hamanobbbb8652008-12-29 10:34:22[diff] [blame]600-b
601</dt>
602<dt>
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]603--ignore-space-change
604</dt>
605<dd>
606<p>
Junio C Hamano3a702342007-12-12 21:34:02[diff] [blame]607 Ignore changes in amount of whitespace. This ignores whitespace
608 at line end, and considers all other sequences of one or
609 more whitespace characters to be equivalent.
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]610</p>
611</dd>
612<dt>
Junio C Hamanobbbb8652008-12-29 10:34:22[diff] [blame]613-w
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]614</dt>
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]615<dt>
616--ignore-all-space
617</dt>
618<dd>
619<p>
Junio C Hamano3a702342007-12-12 21:34:02[diff] [blame]620 Ignore whitespace when comparing lines. This ignores
621 differences even if one line has whitespace where the other
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]622 line has none.
623</p>
624</dd>
625<dt>
Junio C Hamano1d40ee82009-01-07 10:14:16[diff] [blame]626--inter-hunk-context=&lt;lines&gt;
627</dt>
628<dd>
629<p>
630 Show the context between diff hunks, up to the specified number
631 of lines, thereby fusing hunks that are close to each other.
632</p>
633</dd>
634<dt>
Junio C Hamanobb0f4042007-07-04 06:41:40[diff] [blame]635--ext-diff
636</dt>
637<dd>
638<p>
639 Allow an external diff helper to be executed. If you set an
Junio C Hamano1b50ce92007-10-03 12:05:53[diff] [blame]640 external diff driver with <a href="gitattributes.html">gitattributes(5)</a>, you need
641 to use this option with <a href="git-log.html">git-log(1)</a> and friends.
Junio C Hamanobb0f4042007-07-04 06:41:40[diff] [blame]642</p>
643</dd>
644<dt>
645--no-ext-diff
646</dt>
647<dd>
648<p>
649 Disallow external diff drivers.
650</p>
651</dd>
Junio C Hamanoe27cbd22007-12-21 17:57:33[diff] [blame]652<dt>
Junio C Hamano7d449522010-07-01 00:08:51[diff] [blame^]653--ignore-submodules[=&lt;when&gt;]
Junio C Hamanodfccbb02008-05-26 01:16:14[diff] [blame]654</dt>
655<dd>
656<p>
Junio C Hamano7d449522010-07-01 00:08:51[diff] [blame^]657 Ignore changes to submodules in the diff generation. &lt;when&gt; can be
658 either "untracked", "dirty" or "all", which is the default. When
659 "untracked" is used submodules are not considered dirty when they only
660 contain untracked content (but they are still scanned for modified
661 content). Using "dirty" ignores all changes to the work tree of submodules,
662 only changes to the commits stored in the superproject are shown (this was
663 the behavior until 1.7.0). Using "all" hides all changes to submodules.
Junio C Hamanodfccbb02008-05-26 01:16:14[diff] [blame]664</p>
665</dd>
666<dt>
Junio C Hamanoe27cbd22007-12-21 17:57:33[diff] [blame]667--src-prefix=&lt;prefix&gt;
668</dt>
669<dd>
670<p>
671 Show the given source prefix instead of "a/".
672</p>
673</dd>
674<dt>
675--dst-prefix=&lt;prefix&gt;
676</dt>
677<dd>
678<p>
679 Show the given destination prefix instead of "b/".
680</p>
681</dd>
682<dt>
683--no-prefix
684</dt>
685<dd>
686<p>
687 Do not show any source or destination prefix.
688</p>
689</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]690</dl></div>
691<div class="para"><p>For more detailed explanation on these common options, see also
692<a href="gitdiffcore.html">gitdiffcore(7)</a>.</p></div>
693<div class="vlist"><dl>
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]694<dt>
Junio C Hamanobb0f4042007-07-04 06:41:40[diff] [blame]695-&lt;n&gt;
696</dt>
697<dd>
698<p>
699 Limits the number of patches to prepare.
700</p>
701</dd>
702<dt>
Junio C Hamanoeb415992008-06-08 22:49:47[diff] [blame]703-o &lt;dir&gt;
704</dt>
705<dt>
706--output-directory &lt;dir&gt;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]707</dt>
708<dd>
709<p>
710 Use &lt;dir&gt; to store the resulting files, instead of the
Junio C Hamano1bab4b02006-06-06 21:58:33[diff] [blame]711 current working directory.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]712</p>
713</dd>
714<dt>
Junio C Hamanoeb415992008-06-08 22:49:47[diff] [blame]715-n
716</dt>
717<dt>
718--numbered
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]719</dt>
720<dd>
721<p>
Junio C Hamano7d06a8a2008-10-20 05:42:33[diff] [blame]722 Name output in <em>[PATCH n/m]</em> format, even with a single patch.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]723</p>
724</dd>
725<dt>
Junio C Hamanoeb415992008-06-08 22:49:47[diff] [blame]726-N
727</dt>
728<dt>
729--no-numbered
Junio C Hamano8c5802d2007-11-15 00:13:36[diff] [blame]730</dt>
731<dd>
732<p>
733 Name output in <em>[PATCH]</em> format.
734</p>
735</dd>
736<dt>
Junio C Hamano341071d2006-06-04 07:24:48[diff] [blame]737--start-number &lt;n&gt;
738</dt>
739<dd>
740<p>
741 Start numbering the patches at &lt;n&gt; instead of 1.
742</p>
743</dd>
744<dt>
Junio C Hamano94cad1a2007-06-06 10:48:25[diff] [blame]745--numbered-files
746</dt>
747<dd>
748<p>
749 Output file names will be a simple number sequence
750 without the default first line of the commit appended.
Junio C Hamano94cad1a2007-06-06 10:48:25[diff] [blame]751</p>
752</dd>
753<dt>
Junio C Hamanoeb415992008-06-08 22:49:47[diff] [blame]754-k
755</dt>
756<dt>
757--keep-subject
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]758</dt>
759<dd>
760<p>
761 Do not strip/add <em>[PATCH]</em> from the first line of the
762 commit log message.
763</p>
764</dd>
765<dt>
Junio C Hamanoeb415992008-06-08 22:49:47[diff] [blame]766-s
767</dt>
768<dt>
769--signoff
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]770</dt>
771<dd>
772<p>
773 Add <tt>Signed-off-by:</tt> line to the commit message, using
774 the committer identity of yourself.
775</p>
776</dd>
777<dt>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]778--stdout
779</dt>
780<dd>
781<p>
Junio C Hamano341071d2006-06-04 07:24:48[diff] [blame]782 Print all commits to the standard output in mbox format,
783 instead of creating a file for each one.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]784</p>
785</dd>
Junio C Hamano2496ae42006-03-11 08:04:33[diff] [blame]786<dt>
Junio C Hamanoc51fede2007-03-12 07:29:20[diff] [blame]787--attach[=&lt;boundary&gt;]
Junio C Hamano2496ae42006-03-11 08:04:33[diff] [blame]788</dt>
789<dd>
790<p>
Junio C Hamanoc51fede2007-03-12 07:29:20[diff] [blame]791 Create multipart/mixed attachment, the first part of
792 which is the commit message and the patch itself in the
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]793 second part, with <tt>Content-Disposition: attachment</tt>.
Junio C Hamanoc51fede2007-03-12 07:29:20[diff] [blame]794</p>
795</dd>
796<dt>
Junio C Hamano0a235222009-03-06 08:21:09[diff] [blame]797--no-attach
798</dt>
799<dd>
800<p>
801 Disable the creation of an attachment, overriding the
802 configuration setting.
803</p>
804</dd>
805<dt>
Junio C Hamanoc51fede2007-03-12 07:29:20[diff] [blame]806--inline[=&lt;boundary&gt;]
807</dt>
808<dd>
809<p>
810 Create multipart/mixed attachment, the first part of
811 which is the commit message and the patch itself in the
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]812 second part, with <tt>Content-Disposition: inline</tt>.
Junio C Hamano2496ae42006-03-11 08:04:33[diff] [blame]813</p>
814</dd>
Junio C Hamanof9ca97d2006-07-25 22:23:09[diff] [blame]815<dt>
Junio C Hamanoea6a7642009-03-11 23:56:19[diff] [blame]816--thread[=&lt;style&gt;]
Junio C Hamanof9ca97d2006-07-25 22:23:09[diff] [blame]817</dt>
Junio C Hamano1bbd0f42009-07-23 06:20:29[diff] [blame]818<dt>
819--no-thread
820</dt>
Junio C Hamanof9ca97d2006-07-25 22:23:09[diff] [blame]821<dd>
822<p>
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]823 Controls addition of <tt>In-Reply-To</tt> and <tt>References</tt> headers to
Junio C Hamano1bbd0f42009-07-23 06:20:29[diff] [blame]824 make the second and subsequent mails appear as replies to the
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]825 first. Also controls generation of the <tt>Message-Id</tt> header to
Junio C Hamano1bbd0f42009-07-23 06:20:29[diff] [blame]826 reference.
Junio C Hamanof9ca97d2006-07-25 22:23:09[diff] [blame]827</p>
Junio C Hamanoea6a7642009-03-11 23:56:19[diff] [blame]828<div class="para"><p>The optional &lt;style&gt; argument can be either <tt>shallow</tt> or <tt>deep</tt>.
Junio C Hamanof4581102009-04-25 08:29:59[diff] [blame]829<em>shallow</em> threading makes every mail a reply to the head of the
Junio C Hamanoea6a7642009-03-11 23:56:19[diff] [blame]830series, where the head is chosen from the cover letter, the
Junio C Hamanof4581102009-04-25 08:29:59[diff] [blame]831<tt>--in-reply-to</tt>, and the first patch mail, in this order. <em>deep</em>
Junio C Hamano1bbd0f42009-07-23 06:20:29[diff] [blame]832threading makes every mail a reply to the previous one.</p></div>
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]833<div class="para"><p>The default is <tt>--no-thread</tt>, unless the <em>format.thread</em> configuration
834is set. If <tt>--thread</tt> is specified without a style, it defaults to the
Junio C Hamano1bbd0f42009-07-23 06:20:29[diff] [blame]835style specified by <em>format.thread</em> if any, or else <tt>shallow</tt>.</p></div>
836<div class="para"><p>Beware that the default for <em>git send-email</em> is to thread emails
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]837itself. If you want <tt>git format-patch</tt> to take care of threading, you
838will want to ensure that threading is disabled for <tt>git send-email</tt>.</p></div>
Junio C Hamanof9ca97d2006-07-25 22:23:09[diff] [blame]839</dd>
840<dt>
841--in-reply-to=Message-Id
842</dt>
843<dd>
844<p>
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]845 Make the first mail (or all the mails with <tt>--no-thread</tt>) appear as a
Junio C Hamanof9ca97d2006-07-25 22:23:09[diff] [blame]846 reply to the given Message-Id, which avoids breaking threads to
847 provide a new patch series.
848</p>
849</dd>
Junio C Hamano4f9a6052007-01-17 20:25:16[diff] [blame]850<dt>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]851--ignore-if-in-upstream
852</dt>
853<dd>
854<p>
855 Do not include a patch that matches a commit in
856 &lt;until&gt;..&lt;since&gt;. This will examine all patches reachable
857 from &lt;since&gt; but not from &lt;until&gt; and compare them with the
858 patches being generated, and any patch that matches is
859 ignored.
860</p>
861</dd>
862<dt>
Junio C Hamano6f1cca82007-04-12 05:02:47[diff] [blame]863--subject-prefix=&lt;Subject-Prefix&gt;
864</dt>
865<dd>
866<p>
867 Instead of the standard <em>[PATCH]</em> prefix in the subject
868 line, instead use <em>[&lt;Subject-Prefix&gt;]</em>. This
869 allows for useful naming of a patch series, and can be
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]870 combined with the <tt>--numbered</tt> option.
Junio C Hamano6f1cca82007-04-12 05:02:47[diff] [blame]871</p>
872</dd>
873<dt>
Junio C Hamanoea90ab32010-03-15 20:32:55[diff] [blame]874--to=&lt;email&gt;
875</dt>
876<dd>
877<p>
878 Add a <tt>To:</tt> header to the email headers. This is in addition
879 to any configured headers, and may be used multiple times.
880</p>
881</dd>
882<dt>
Junio C Hamano24bc09a2008-02-28 00:27:44[diff] [blame]883--cc=&lt;email&gt;
884</dt>
885<dd>
886<p>
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]887 Add a <tt>Cc:</tt> header to the email headers. This is in addition
Junio C Hamano24bc09a2008-02-28 00:27:44[diff] [blame]888 to any configured headers, and may be used multiple times.
889</p>
890</dd>
891<dt>
Junio C Hamano9572e922009-04-02 06:52:03[diff] [blame]892--add-header=&lt;header&gt;
893</dt>
894<dd>
895<p>
896 Add an arbitrary header to the email headers. This is in addition
897 to any configured headers, and may be used multiple times.
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]898 For example, <tt>--add-header="Organization: git-foo"</tt>
Junio C Hamano9572e922009-04-02 06:52:03[diff] [blame]899</p>
900</dd>
901<dt>
Junio C Hamano24bc09a2008-02-28 00:27:44[diff] [blame]902--cover-letter
903</dt>
904<dd>
905<p>
Junio C Hamano92a4abd2008-08-15 05:34:44[diff] [blame]906 In addition to the patches, generate a cover letter file
907 containing the shortlog and the overall diffstat. You can
908 fill in a description in the file before sending it out.
Junio C Hamano24bc09a2008-02-28 00:27:44[diff] [blame]909</p>
910</dd>
911<dt>
Junio C Hamano89a57342010-06-22 23:22:55[diff] [blame]912--[no]-signature=&lt;signature&gt;
913</dt>
914<dd>
915<p>
916 Add a signature to each message produced. Per RFC 3676 the signature
917 is separated from the body by a line with <em>-- </em> on it. If the
918 signature option is omitted the signature defaults to the git version
919 number.
920</p>
921</dd>
922<dt>
Junio C Hamano4f9a6052007-01-17 20:25:16[diff] [blame]923--suffix=.&lt;sfx&gt;
924</dt>
925<dd>
926<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]927 Instead of using <tt>.patch</tt> as the suffix for generated
Junio C Hamanoa6387422007-08-25 03:54:27[diff] [blame]928 filenames, use specified suffix. A common alternative is
Junio C Hamanof4581102009-04-25 08:29:59[diff] [blame]929 <tt>--suffix=.txt</tt>. Leaving this empty will remove the <tt>.patch</tt>
930 suffix.
Junio C Hamano4f9a6052007-01-17 20:25:16[diff] [blame]931</p>
Junio C Hamanof4581102009-04-25 08:29:59[diff] [blame]932<div class="para"><p>Note that the leading character does not have to be a dot; for example,
933you can use <tt>--suffix=-patch</tt> to get <tt>0001-description-of-my-change-patch</tt>.</p></div>
Junio C Hamano4f9a6052007-01-17 20:25:16[diff] [blame]934</dd>
Junio C Hamano869bb802008-05-12 00:29:47[diff] [blame]935<dt>
936--no-binary
937</dt>
938<dd>
939<p>
Junio C Hamanof4581102009-04-25 08:29:59[diff] [blame]940 Do not output contents of changes in binary files, instead
941 display a notice that those files changed. Patches generated
942 using this option cannot be applied properly, but they are
943 still useful for code review.
Junio C Hamano869bb802008-05-12 00:29:47[diff] [blame]944</p>
945</dd>
Junio C Hamano9572e922009-04-02 06:52:03[diff] [blame]946<dt>
947--root
948</dt>
949<dd>
950<p>
951 Treat the revision argument as a &lt;revision range&gt;, even if it
952 is just a single commit (that would normally be treated as a
953 &lt;since&gt;). Note that root commits included in the specified
954 range are always formatted as creation patches, independently
955 of this flag.
956</p>
957</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]958</dl></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]959</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]960<h2 id="_configuration">CONFIGURATION</h2>
Junio C Hamano2496ae42006-03-11 08:04:33[diff] [blame]961<div class="sectionbody">
Junio C Hamanof4581102009-04-25 08:29:59[diff] [blame]962<div class="para"><p>You can specify extra mail header lines to be added to each message,
963defaults for the subject prefix and file suffix, number patches when
Junio C Hamanoea90ab32010-03-15 20:32:55[diff] [blame]964outputting more than one patch, add "To" or "Cc:" headers, configure
965attachments, and sign off patches with configuration variables.</p></div>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]966<div class="listingblock">
Junio C Hamano2496ae42006-03-11 08:04:33[diff] [blame]967<div class="content">
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]968<pre><tt>[format]
969 headers = "Organization: git-foo\n"
Junio C Hamano1d90cb02007-07-03 07:05:31[diff] [blame]970 subjectprefix = CHANGE
Junio C Hamano8c5802d2007-11-15 00:13:36[diff] [blame]971 suffix = .txt
Junio C Hamano2fbcd212008-05-14 22:26:07[diff] [blame]972 numbered = auto
Junio C Hamanoea90ab32010-03-15 20:32:55[diff] [blame]973 to = &lt;email&gt;
Junio C Hamano0a235222009-03-06 08:21:09[diff] [blame]974 cc = &lt;email&gt;
Junio C Hamano5f9a6f02009-04-06 08:26:56[diff] [blame]975 attach [ = mime-boundary-string ]
976 signoff = true</tt></pre>
Junio C Hamano4f9a6052007-01-17 20:25:16[diff] [blame]977</div></div>
Junio C Hamano2496ae42006-03-11 08:04:33[diff] [blame]978</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]979<h2 id="_examples">EXAMPLES</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]980<div class="sectionbody">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]981<div class="ilist"><ul>
Junio C Hamano6d76d612008-05-09 05:46:08[diff] [blame]982<li>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]983<p>
Junio C Hamano6d76d612008-05-09 05:46:08[diff] [blame]984Extract commits between revisions R1 and R2, and apply them on top of
Junio C Hamano1aa40d22010-01-21 17:46:43[diff] [blame]985the current branch using <em>git am</em> to cherry-pick them:
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]986</p>
Junio C Hamano6d76d612008-05-09 05:46:08[diff] [blame]987<div class="listingblock">
988<div class="content">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]989<pre><tt>$ git format-patch -k --stdout R1..R2 | git am -3 -k</tt></pre>
Junio C Hamano6d76d612008-05-09 05:46:08[diff] [blame]990</div></div>
991</li>
992<li>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]993<p>
Junio C Hamano6d76d612008-05-09 05:46:08[diff] [blame]994Extract all commits which are in the current branch but not in the
995origin branch:
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]996</p>
Junio C Hamano6d76d612008-05-09 05:46:08[diff] [blame]997<div class="listingblock">
998<div class="content">
999<pre><tt>$ git format-patch origin</tt></pre>
1000</div></div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1001<div class="para"><p>For each commit a separate file is created in the current directory.</p></div>
Junio C Hamano6d76d612008-05-09 05:46:08[diff] [blame]1002</li>
1003<li>
Junio C Hamano7d9e9bd2007-08-29 07:31:47[diff] [blame]1004<p>
Junio C Hamano6d76d612008-05-09 05:46:08[diff] [blame]1005Extract all commits that lead to <em>origin</em> since the inception of the
1006project:
Junio C Hamano7d9e9bd2007-08-29 07:31:47[diff] [blame]1007</p>
Junio C Hamano6d76d612008-05-09 05:46:08[diff] [blame]1008<div class="listingblock">
1009<div class="content">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1010<pre><tt>$ git format-patch --root origin</tt></pre>
Junio C Hamano6d76d612008-05-09 05:46:08[diff] [blame]1011</div></div>
1012</li>
1013<li>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1014<p>
Junio C Hamano6d76d612008-05-09 05:46:08[diff] [blame]1015The same as the previous one:
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1016</p>
Junio C Hamano6d76d612008-05-09 05:46:08[diff] [blame]1017<div class="listingblock">
1018<div class="content">
1019<pre><tt>$ git format-patch -M -B origin</tt></pre>
1020</div></div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1021<div class="para"><p>Additionally, it detects and handles renames and complete rewrites
Junio C Hamano6d76d612008-05-09 05:46:08[diff] [blame]1022intelligently to produce a renaming patch. A renaming patch reduces
Junio C Hamanof4581102009-04-25 08:29:59[diff] [blame]1023the amount of text output, and generally makes it easier to review.
1024Note that non-git "patch" programs won't understand renaming patches, so
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1025use it only when you know the recipient uses git to apply your patch.</p></div>
Junio C Hamano6d76d612008-05-09 05:46:08[diff] [blame]1026</li>
1027<li>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1028<p>
Junio C Hamano6d76d612008-05-09 05:46:08[diff] [blame]1029Extract three topmost commits from the current branch and format them
1030as e-mailable patches:
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1031</p>
Junio C Hamano6d76d612008-05-09 05:46:08[diff] [blame]1032<div class="listingblock">
1033<div class="content">
1034<pre><tt>$ git format-patch -3</tt></pre>
1035</div></div>
1036</li>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1037</ul></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1038</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1039<h2 id="_see_also">SEE ALSO</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1040<div class="sectionbody">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1041<div class="para"><p><a href="git-am.html">git-am(1)</a>, <a href="git-send-email.html">git-send-email(1)</a></p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1042</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1043<h2 id="_author">Author</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1044<div class="sectionbody">
Junio C Hamano0868a302008-07-22 09:20:44[diff] [blame]1045<div class="para"><p>Written by Junio C Hamano &lt;gitster@pobox.com&gt;</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1046</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1047<h2 id="_documentation">Documentation</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1048<div class="sectionbody">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1049<div class="para"><p>Documentation by Junio C Hamano and the git-list &lt;git@vger.kernel.org&gt;.</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1050</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1051<h2 id="_git">GIT</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1052<div class="sectionbody">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1053<div class="para"><p>Part of the <a href="git.html">git(1)</a> suite</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1054</div>
1055<div id="footer">
1056<div id="footer-text">
Junio C Hamano7d449522010-07-01 00:08:51[diff] [blame^]1057Last updated 2010-07-01 00:08:20 UTC
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1058</div>
1059</div>
1060</body>
1061</html>