Autogenerated HTML docs for v1.7.5.1-339-gb602ed
[git/jnareb-git.git] / git-format-patch.html
blob0fc53b9f1c49591d572eb362d52192b53c196f74
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" />
6 <meta name="generator" content="AsciiDoc 8.4.5" />
7 <title>git-format-patch(1)</title>
8 <style type="text/css">
9 /* Debug borders */
10 p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
12 border: 1px solid red;
16 body {
17 margin: 1em 5% 1em 5%;
20 a {
21 color: blue;
22 text-decoration: underline;
24 a:visited {
25 color: fuchsia;
28 em {
29 font-style: italic;
30 color: navy;
33 strong {
34 font-weight: bold;
35 color: #083194;
38 tt {
39 color: navy;
42 h1, h2, h3, h4, h5, h6 {
43 color: #527bbd;
44 font-family: sans-serif;
45 margin-top: 1.2em;
46 margin-bottom: 0.5em;
47 line-height: 1.3;
50 h1, h2, h3 {
51 border-bottom: 2px solid silver;
53 h2 {
54 padding-top: 0.5em;
56 h3 {
57 float: left;
59 h3 + * {
60 clear: left;
63 div.sectionbody {
64 font-family: serif;
65 margin-left: 0;
68 hr {
69 border: 1px solid silver;
72 p {
73 margin-top: 0.5em;
74 margin-bottom: 0.5em;
77 ul, ol, li > p {
78 margin-top: 0;
81 pre {
82 padding: 0;
83 margin: 0;
86 span#author {
87 color: #527bbd;
88 font-family: sans-serif;
89 font-weight: bold;
90 font-size: 1.1em;
92 span#email {
94 span#revnumber, span#revdate, span#revremark {
95 font-family: sans-serif;
98 div#footer {
99 font-family: sans-serif;
100 font-size: small;
101 border-top: 2px solid silver;
102 padding-top: 0.5em;
103 margin-top: 4.0em;
105 div#footer-text {
106 float: left;
107 padding-bottom: 0.5em;
109 div#footer-badges {
110 float: right;
111 padding-bottom: 0.5em;
114 div#preamble {
115 margin-top: 1.5em;
116 margin-bottom: 1.5em;
118 div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
119 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
120 div.admonitionblock {
121 margin-top: 1.5em;
122 margin-bottom: 1.5em;
124 div.admonitionblock {
125 margin-top: 2.5em;
126 margin-bottom: 2.5em;
129 div.content { /* Block element content. */
130 padding: 0;
133 /* Block element titles. */
134 div.title, caption.title {
135 color: #527bbd;
136 font-family: sans-serif;
137 font-weight: bold;
138 text-align: left;
139 margin-top: 1.0em;
140 margin-bottom: 0.5em;
142 div.title + * {
143 margin-top: 0;
146 td div.title:first-child {
147 margin-top: 0.0em;
149 div.content div.title:first-child {
150 margin-top: 0.0em;
152 div.content + div.title {
153 margin-top: 0.0em;
156 div.sidebarblock > div.content {
157 background: #ffffee;
158 border: 1px solid silver;
159 padding: 0.5em;
162 div.listingblock > div.content {
163 border: 1px solid silver;
164 background: #f4f4f4;
165 padding: 0.5em;
168 div.quoteblock {
169 padding-left: 2.0em;
170 margin-right: 10%;
172 div.quoteblock > div.attribution {
173 padding-top: 0.5em;
174 text-align: right;
177 div.verseblock {
178 padding-left: 2.0em;
179 margin-right: 10%;
181 div.verseblock > div.content {
182 white-space: pre;
184 div.verseblock > div.attribution {
185 padding-top: 0.75em;
186 text-align: left;
188 /* DEPRECATED: Pre version 8.2.7 verse style literal block. */
189 div.verseblock + div.attribution {
190 text-align: left;
193 div.admonitionblock .icon {
194 vertical-align: top;
195 font-size: 1.1em;
196 font-weight: bold;
197 text-decoration: underline;
198 color: #527bbd;
199 padding-right: 0.5em;
201 div.admonitionblock td.content {
202 padding-left: 0.5em;
203 border-left: 2px solid silver;
206 div.exampleblock > div.content {
207 border-left: 2px solid silver;
208 padding: 0.5em;
211 div.imageblock div.content { padding-left: 0; }
212 span.image img { border-style: none; }
213 a.image:visited { color: white; }
215 dl {
216 margin-top: 0.8em;
217 margin-bottom: 0.8em;
219 dt {
220 margin-top: 0.5em;
221 margin-bottom: 0;
222 font-style: normal;
223 color: navy;
225 dd > *:first-child {
226 margin-top: 0.1em;
229 ul, ol {
230 list-style-position: outside;
232 ol.arabic {
233 list-style-type: decimal;
235 ol.loweralpha {
236 list-style-type: lower-alpha;
238 ol.upperalpha {
239 list-style-type: upper-alpha;
241 ol.lowerroman {
242 list-style-type: lower-roman;
244 ol.upperroman {
245 list-style-type: upper-roman;
248 div.compact ul, div.compact ol,
249 div.compact p, div.compact p,
250 div.compact div, div.compact div {
251 margin-top: 0.1em;
252 margin-bottom: 0.1em;
255 div.tableblock > table {
256 border: 3px solid #527bbd;
258 thead {
259 font-family: sans-serif;
260 font-weight: bold;
262 tfoot {
263 font-weight: bold;
265 td > div.verse {
266 white-space: pre;
268 p.table {
269 margin-top: 0;
271 /* Because the table frame attribute is overriden by CSS in most browsers. */
272 div.tableblock > table[frame="void"] {
273 border-style: none;
275 div.tableblock > table[frame="hsides"] {
276 border-left-style: none;
277 border-right-style: none;
279 div.tableblock > table[frame="vsides"] {
280 border-top-style: none;
281 border-bottom-style: none;
285 div.hdlist {
286 margin-top: 0.8em;
287 margin-bottom: 0.8em;
289 div.hdlist tr {
290 padding-bottom: 15px;
292 dt.hdlist1.strong, td.hdlist1.strong {
293 font-weight: bold;
295 td.hdlist1 {
296 vertical-align: top;
297 font-style: normal;
298 padding-right: 0.8em;
299 color: navy;
301 td.hdlist2 {
302 vertical-align: top;
304 div.hdlist.compact tr {
305 margin: 0;
306 padding-bottom: 0;
309 .comment {
310 background: yellow;
313 @media print {
314 div#footer-badges { display: none; }
317 div#toctitle {
318 color: #527bbd;
319 font-family: sans-serif;
320 font-size: 1.1em;
321 font-weight: bold;
322 margin-top: 1.0em;
323 margin-bottom: 0.1em;
326 div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
327 margin-top: 0;
328 margin-bottom: 0;
330 div.toclevel2 {
331 margin-left: 2em;
332 font-size: 0.9em;
334 div.toclevel3 {
335 margin-left: 4em;
336 font-size: 0.9em;
338 div.toclevel4 {
339 margin-left: 6em;
340 font-size: 0.9em;
342 /* Overrides for manpage documents */
343 h1 {
344 padding-top: 0.5em;
345 padding-bottom: 0.5em;
346 border-top: 2px solid silver;
347 border-bottom: 2px solid silver;
349 h2 {
350 border-style: none;
352 div.sectionbody {
353 margin-left: 5%;
356 @media print {
357 div#toc { display: none; }
360 /* Workarounds for IE6's broken and incomplete CSS2. */
362 div.sidebar-content {
363 background: #ffffee;
364 border: 1px solid silver;
365 padding: 0.5em;
367 div.sidebar-title, div.image-title {
368 color: #527bbd;
369 font-family: sans-serif;
370 font-weight: bold;
371 margin-top: 0.0em;
372 margin-bottom: 0.5em;
375 div.listingblock div.content {
376 border: 1px solid silver;
377 background: #f4f4f4;
378 padding: 0.5em;
381 div.quoteblock-attribution {
382 padding-top: 0.5em;
383 text-align: right;
386 div.verseblock-content {
387 white-space: pre;
389 div.verseblock-attribution {
390 padding-top: 0.75em;
391 text-align: left;
394 div.exampleblock-content {
395 border-left: 2px solid silver;
396 padding-left: 0.5em;
399 /* IE6 sets dynamically generated links as visited. */
400 div#toc a:visited { color: blue; }
401 </style>
402 </head>
403 <body>
404 <div id="header">
405 <h1>
406 git-format-patch(1) Manual Page
407 </h1>
408 <h2>NAME</h2>
409 <div class="sectionbody">
410 <p>git-format-patch -
411 Prepare patches for e-mail submission
412 </p>
413 </div>
414 </div>
415 <h2 id="_synopsis">SYNOPSIS</h2>
416 <div class="sectionbody">
417 <div class="verseblock">
418 <div class="verseblock-content"><em>git format-patch</em> [-k] [(-o|--output-directory) &lt;dir&gt; | --stdout]
419 [--no-thread | --thread[=&lt;style&gt;]]
420 [(--attach|--inline)[=&lt;boundary&gt;] | --no-attach]
421 [-s | --signoff]
422 [--signature=&lt;signature&gt; | --no-signature]
423 [-n | --numbered | -N | --no-numbered]
424 [--start-number &lt;n&gt;] [--numbered-files]
425 [--in-reply-to=Message-Id] [--suffix=.&lt;sfx&gt;]
426 [--ignore-if-in-upstream]
427 [--subject-prefix=Subject-Prefix]
428 [--to=&lt;email&gt;] [--cc=&lt;email&gt;]
429 [--cover-letter] [--quiet]
430 [&lt;common diff options&gt;]
431 [ &lt;since&gt; | &lt;revision range&gt; ]</div>
432 <div class="verseblock-attribution">
433 </div></div>
434 </div>
435 <h2 id="_description">DESCRIPTION</h2>
436 <div class="sectionbody">
437 <div class="paragraph"><p>Prepare each commit with its patch in
438 one file per commit, formatted to resemble UNIX mailbox format.
439 The output of this command is convenient for e-mail submission or
440 for use with <em>git am</em>.</p></div>
441 <div class="paragraph"><p>There are two ways to specify which commits to operate on.</p></div>
442 <div class="olist arabic"><ol class="arabic">
443 <li>
445 A single commit, &lt;since&gt;, specifies that the commits leading
446 to the tip of the current branch that are not in the history
447 that leads to the &lt;since&gt; to be output.
448 </p>
449 </li>
450 <li>
452 Generic &lt;revision range&gt; expression (see "SPECIFYING
453 REVISIONS" section in <a href="gitrevisions.html">gitrevisions(7)</a>) means the
454 commits in the specified range.
455 </p>
456 </li>
457 </ol></div>
458 <div class="paragraph"><p>The first rule takes precedence in the case of a single &lt;commit&gt;. To
459 apply the second rule, i.e., format everything since the beginning of
460 history up until &lt;commit&gt;, use the <em>--root</em> option: <tt>git format-patch
461 --root &lt;commit&gt;</tt>. If you want to format only &lt;commit&gt; itself, you
462 can do this with <tt>git format-patch -1 &lt;commit&gt;</tt>.</p></div>
463 <div class="paragraph"><p>By default, each output file is numbered sequentially from 1, and uses the
464 first line of the commit message (massaged for pathname safety) as
465 the filename. With the <tt>--numbered-files</tt> option, the output file names
466 will only be numbers, without the first line of the commit appended.
467 The names of the output files are printed to standard
468 output, unless the <tt>--stdout</tt> option is specified.</p></div>
469 <div class="paragraph"><p>If <tt>-o</tt> is specified, output files are created in &lt;dir&gt;. Otherwise
470 they are created in the current working directory.</p></div>
471 <div class="paragraph"><p>By default, the subject of a single patch is "[PATCH] First Line" and
472 the subject when multiple patches are output is "[PATCH n/m] First
473 Line". To force 1/1 to be added for a single patch, use <tt>-n</tt>. To omit
474 patch numbers from the subject, use <tt>-N</tt>.</p></div>
475 <div class="paragraph"><p>If given <tt>--thread</tt>, <tt>git-format-patch</tt> will generate <tt>In-Reply-To</tt> and
476 <tt>References</tt> headers to make the second and subsequent patch mails appear
477 as replies to the first mail; this also generates a <tt>Message-Id</tt> header to
478 reference.</p></div>
479 </div>
480 <h2 id="_options">OPTIONS</h2>
481 <div class="sectionbody">
482 <div class="dlist"><dl>
483 <dt class="hdlist1">
485 </dt>
486 <dt class="hdlist1">
487 --no-stat
488 </dt>
489 <dd>
491 Generate plain patches without any diffstats.
492 </p>
493 </dd>
494 <dt class="hdlist1">
495 -U&lt;n&gt;
496 </dt>
497 <dt class="hdlist1">
498 --unified=&lt;n&gt;
499 </dt>
500 <dd>
502 Generate diffs with &lt;n&gt; lines of context instead of
503 the usual three.
504 </p>
505 </dd>
506 <dt class="hdlist1">
507 --patience
508 </dt>
509 <dd>
511 Generate a diff using the "patience diff" algorithm.
512 </p>
513 </dd>
514 <dt class="hdlist1">
515 --stat[=&lt;width&gt;[,&lt;name-width&gt;]]
516 </dt>
517 <dd>
519 Generate a diffstat. You can override the default
520 output width for 80-column terminal by <tt>--stat=&lt;width&gt;</tt>.
521 The width of the filename part can be controlled by
522 giving another width to it separated by a comma.
523 </p>
524 </dd>
525 <dt class="hdlist1">
526 --numstat
527 </dt>
528 <dd>
530 Similar to <tt>--stat</tt>, but shows number of added and
531 deleted lines in decimal notation and pathname without
532 abbreviation, to make it more machine friendly. For
533 binary files, outputs two <tt>-</tt> instead of saying
534 <tt>0 0</tt>.
535 </p>
536 </dd>
537 <dt class="hdlist1">
538 --shortstat
539 </dt>
540 <dd>
542 Output only the last line of the <tt>--stat</tt> format containing total
543 number of modified files, as well as number of added and deleted
544 lines.
545 </p>
546 </dd>
547 <dt class="hdlist1">
548 --dirstat[=&lt;param1,param2,&#8230;&gt;]
549 </dt>
550 <dd>
552 Output the distribution of relative amount of changes for each
553 sub-directory. The behavior of <tt>--dirstat</tt> can be customized by
554 passing it a comma separated list of parameters.
555 The defaults are controlled by the <tt>diff.dirstat</tt> configuration
556 variable (see <a href="git-config.html">git-config(1)</a>).
557 The following parameters are available:
558 </p>
559 <div class="dlist"><dl>
560 <dt class="hdlist1">
561 <tt>changes</tt>
562 </dt>
563 <dd>
565 Compute the dirstat numbers by counting the lines that have been
566 removed from the source, or added to the destination. This ignores
567 the amount of pure code movements within a file. In other words,
568 rearranging lines in a file is not counted as much as other changes.
569 This is the default behavior when no parameter is given.
570 </p>
571 </dd>
572 <dt class="hdlist1">
573 <tt>lines</tt>
574 </dt>
575 <dd>
577 Compute the dirstat numbers by doing the regular line-based diff
578 analysis, and summing the removed/added line counts. (For binary
579 files, count 64-byte chunks instead, since binary files have no
580 natural concept of lines). This is a more expensive <tt>--dirstat</tt>
581 behavior than the <tt>changes</tt> behavior, but it does count rearranged
582 lines within a file as much as other changes. The resulting output
583 is consistent with what you get from the other <tt>--*stat</tt> options.
584 </p>
585 </dd>
586 <dt class="hdlist1">
587 <tt>files</tt>
588 </dt>
589 <dd>
591 Compute the dirstat numbers by counting the number of files changed.
592 Each changed file counts equally in the dirstat analysis. This is
593 the computationally cheapest <tt>--dirstat</tt> behavior, since it does
594 not have to look at the file contents at all.
595 </p>
596 </dd>
597 <dt class="hdlist1">
598 <tt>cumulative</tt>
599 </dt>
600 <dd>
602 Count changes in a child directory for the parent directory as well.
603 Note that when using <tt>cumulative</tt>, the sum of the percentages
604 reported may exceed 100%. The default (non-cumulative) behavior can
605 be specified with the <tt>noncumulative</tt> parameter.
606 </p>
607 </dd>
608 <dt class="hdlist1">
609 &lt;limit&gt;
610 </dt>
611 <dd>
613 An integer parameter specifies a cut-off percent (3% by default).
614 Directories contributing less than this percentage of the changes
615 are not shown in the output.
616 </p>
617 </dd>
618 </dl></div>
619 <div class="paragraph"><p>Example: The following will count changed files, while ignoring
620 directories with less than 10% of the total amount of changed files,
621 and accumulating child directory counts in the parent directories:
622 <tt>--dirstat=files,10,cumulative</tt>.</p></div>
623 </dd>
624 <dt class="hdlist1">
625 --summary
626 </dt>
627 <dd>
629 Output a condensed summary of extended header information
630 such as creations, renames and mode changes.
631 </p>
632 </dd>
633 <dt class="hdlist1">
634 --no-renames
635 </dt>
636 <dd>
638 Turn off rename detection, even when the configuration
639 file gives the default to do so.
640 </p>
641 </dd>
642 <dt class="hdlist1">
643 --full-index
644 </dt>
645 <dd>
647 Instead of the first handful of characters, show the full
648 pre- and post-image blob object names on the "index"
649 line when generating patch format output.
650 </p>
651 </dd>
652 <dt class="hdlist1">
653 --binary
654 </dt>
655 <dd>
657 In addition to <tt>--full-index</tt>, output a binary diff that
658 can be applied with <tt>git-apply</tt>.
659 </p>
660 </dd>
661 <dt class="hdlist1">
662 --abbrev[=&lt;n&gt;]
663 </dt>
664 <dd>
666 Instead of showing the full 40-byte hexadecimal object
667 name in diff-raw format output and diff-tree header
668 lines, show only a partial prefix. This is
669 independent of the <tt>--full-index</tt> option above, which controls
670 the diff-patch output format. Non default number of
671 digits can be specified with <tt>--abbrev=&lt;n&gt;</tt>.
672 </p>
673 </dd>
674 <dt class="hdlist1">
675 -B[&lt;n&gt;][/&lt;m&gt;]
676 </dt>
677 <dt class="hdlist1">
678 --break-rewrites[=[&lt;n&gt;][/&lt;m&gt;]]
679 </dt>
680 <dd>
682 Break complete rewrite changes into pairs of delete and
683 create. This serves two purposes:
684 </p>
685 <div class="paragraph"><p>It affects the way a change that amounts to a total rewrite of a file
686 not as a series of deletion and insertion mixed together with a very
687 few lines that happen to match textually as the context, but as a
688 single deletion of everything old followed by a single insertion of
689 everything new, and the number <tt>m</tt> controls this aspect of the -B
690 option (defaults to 60%). <tt>-B/70%</tt> specifies that less than 30% of the
691 original should remain in the result for git to consider it a total
692 rewrite (i.e. otherwise the resulting patch will be a series of
693 deletion and insertion mixed together with context lines).</p></div>
694 <div class="paragraph"><p>When used with -M, a totally-rewritten file is also considered as the
695 source of a rename (usually -M only considers a file that disappeared
696 as the source of a rename), and the number <tt>n</tt> controls this aspect of
697 the -B option (defaults to 50%). <tt>-B20%</tt> specifies that a change with
698 addition and deletion compared to 20% or more of the file&#8217;s size are
699 eligible for being picked up as a possible source of a rename to
700 another file.</p></div>
701 </dd>
702 <dt class="hdlist1">
703 -M[&lt;n&gt;]
704 </dt>
705 <dt class="hdlist1">
706 --find-renames[=&lt;n&gt;]
707 </dt>
708 <dd>
710 Detect renames.
711 If <tt>n</tt> is specified, it is a threshold on the similarity
712 index (i.e. amount of addition/deletions compared to the
713 file&#8217;s size). For example, <tt>-M90%</tt> means git should consider a
714 delete/add pair to be a rename if more than 90% of the file
715 hasn&#8217;t changed.
716 </p>
717 </dd>
718 <dt class="hdlist1">
719 -C[&lt;n&gt;]
720 </dt>
721 <dt class="hdlist1">
722 --find-copies[=&lt;n&gt;]
723 </dt>
724 <dd>
726 Detect copies as well as renames. See also <tt>--find-copies-harder</tt>.
727 If <tt>n</tt> is specified, it has the same meaning as for <tt>-M&lt;n&gt;</tt>.
728 </p>
729 </dd>
730 <dt class="hdlist1">
731 --find-copies-harder
732 </dt>
733 <dd>
735 For performance reasons, by default, <tt>-C</tt> option finds copies only
736 if the original file of the copy was modified in the same
737 changeset. This flag makes the command
738 inspect unmodified files as candidates for the source of
739 copy. This is a very expensive operation for large
740 projects, so use it with caution. Giving more than one
741 <tt>-C</tt> option has the same effect.
742 </p>
743 </dd>
744 <dt class="hdlist1">
746 </dt>
747 <dt class="hdlist1">
748 --irreversible-delete
749 </dt>
750 <dd>
752 Omit the preimage for deletes, i.e. print only the header but not
753 the diff between the preimage and <tt>/dev/null</tt>. The resulting patch
754 is not meant to be applied with <tt>patch</tt> nor <tt>git apply</tt>; this is
755 solely for people who want to just concentrate on reviewing the
756 text after the change. In addition, the output obviously lack
757 enough information to apply such a patch in reverse, even manually,
758 hence the name of the option.
759 </p>
760 <div class="paragraph"><p>When used together with <tt>-B</tt>, omit also the preimage in the deletion part
761 of a delete/create pair.</p></div>
762 </dd>
763 <dt class="hdlist1">
764 -l&lt;num&gt;
765 </dt>
766 <dd>
768 The <tt>-M</tt> and <tt>-C</tt> options require O(n^2) processing time where n
769 is the number of potential rename/copy targets. This
770 option prevents rename/copy detection from running if
771 the number of rename/copy targets exceeds the specified
772 number.
773 </p>
774 </dd>
775 <dt class="hdlist1">
776 -O&lt;orderfile&gt;
777 </dt>
778 <dd>
780 Output the patch in the order specified in the
781 &lt;orderfile&gt;, which has one shell glob pattern per line.
782 </p>
783 </dd>
784 <dt class="hdlist1">
786 </dt>
787 <dt class="hdlist1">
788 --text
789 </dt>
790 <dd>
792 Treat all files as text.
793 </p>
794 </dd>
795 <dt class="hdlist1">
796 --ignore-space-at-eol
797 </dt>
798 <dd>
800 Ignore changes in whitespace at EOL.
801 </p>
802 </dd>
803 <dt class="hdlist1">
805 </dt>
806 <dt class="hdlist1">
807 --ignore-space-change
808 </dt>
809 <dd>
811 Ignore changes in amount of whitespace. This ignores whitespace
812 at line end, and considers all other sequences of one or
813 more whitespace characters to be equivalent.
814 </p>
815 </dd>
816 <dt class="hdlist1">
818 </dt>
819 <dt class="hdlist1">
820 --ignore-all-space
821 </dt>
822 <dd>
824 Ignore whitespace when comparing lines. This ignores
825 differences even if one line has whitespace where the other
826 line has none.
827 </p>
828 </dd>
829 <dt class="hdlist1">
830 --inter-hunk-context=&lt;lines&gt;
831 </dt>
832 <dd>
834 Show the context between diff hunks, up to the specified number
835 of lines, thereby fusing hunks that are close to each other.
836 </p>
837 </dd>
838 <dt class="hdlist1">
839 --ext-diff
840 </dt>
841 <dd>
843 Allow an external diff helper to be executed. If you set an
844 external diff driver with <a href="gitattributes.html">gitattributes(5)</a>, you need
845 to use this option with <a href="git-log.html">git-log(1)</a> and friends.
846 </p>
847 </dd>
848 <dt class="hdlist1">
849 --no-ext-diff
850 </dt>
851 <dd>
853 Disallow external diff drivers.
854 </p>
855 </dd>
856 <dt class="hdlist1">
857 --ignore-submodules[=&lt;when&gt;]
858 </dt>
859 <dd>
861 Ignore changes to submodules in the diff generation. &lt;when&gt; can be
862 either "none", "untracked", "dirty" or "all", which is the default
863 Using "none" will consider the submodule modified when it either contains
864 untracked or modified files or its HEAD differs from the commit recorded
865 in the superproject and can be used to override any settings of the
866 <em>ignore</em> option in <a href="git-config.html">git-config(1)</a> or <a href="gitmodules.html">gitmodules(5)</a>. When
867 "untracked" is used submodules are not considered dirty when they only
868 contain untracked content (but they are still scanned for modified
869 content). Using "dirty" ignores all changes to the work tree of submodules,
870 only changes to the commits stored in the superproject are shown (this was
871 the behavior until 1.7.0). Using "all" hides all changes to submodules.
872 </p>
873 </dd>
874 <dt class="hdlist1">
875 --src-prefix=&lt;prefix&gt;
876 </dt>
877 <dd>
879 Show the given source prefix instead of "a/".
880 </p>
881 </dd>
882 <dt class="hdlist1">
883 --dst-prefix=&lt;prefix&gt;
884 </dt>
885 <dd>
887 Show the given destination prefix instead of "b/".
888 </p>
889 </dd>
890 <dt class="hdlist1">
891 --no-prefix
892 </dt>
893 <dd>
895 Do not show any source or destination prefix.
896 </p>
897 </dd>
898 </dl></div>
899 <div class="paragraph"><p>For more detailed explanation on these common options, see also
900 <a href="gitdiffcore.html">gitdiffcore(7)</a>.</p></div>
901 <div class="dlist"><dl>
902 <dt class="hdlist1">
903 -&lt;n&gt;
904 </dt>
905 <dd>
907 Prepare patches from the topmost &lt;n&gt; commits.
908 </p>
909 </dd>
910 <dt class="hdlist1">
911 -o &lt;dir&gt;
912 </dt>
913 <dt class="hdlist1">
914 --output-directory &lt;dir&gt;
915 </dt>
916 <dd>
918 Use &lt;dir&gt; to store the resulting files, instead of the
919 current working directory.
920 </p>
921 </dd>
922 <dt class="hdlist1">
924 </dt>
925 <dt class="hdlist1">
926 --numbered
927 </dt>
928 <dd>
930 Name output in <em>[PATCH n/m]</em> format, even with a single patch.
931 </p>
932 </dd>
933 <dt class="hdlist1">
935 </dt>
936 <dt class="hdlist1">
937 --no-numbered
938 </dt>
939 <dd>
941 Name output in <em>[PATCH]</em> format.
942 </p>
943 </dd>
944 <dt class="hdlist1">
945 --start-number &lt;n&gt;
946 </dt>
947 <dd>
949 Start numbering the patches at &lt;n&gt; instead of 1.
950 </p>
951 </dd>
952 <dt class="hdlist1">
953 --numbered-files
954 </dt>
955 <dd>
957 Output file names will be a simple number sequence
958 without the default first line of the commit appended.
959 </p>
960 </dd>
961 <dt class="hdlist1">
963 </dt>
964 <dt class="hdlist1">
965 --keep-subject
966 </dt>
967 <dd>
969 Do not strip/add <em>[PATCH]</em> from the first line of the
970 commit log message.
971 </p>
972 </dd>
973 <dt class="hdlist1">
975 </dt>
976 <dt class="hdlist1">
977 --signoff
978 </dt>
979 <dd>
981 Add <tt>Signed-off-by:</tt> line to the commit message, using
982 the committer identity of yourself.
983 </p>
984 </dd>
985 <dt class="hdlist1">
986 --stdout
987 </dt>
988 <dd>
990 Print all commits to the standard output in mbox format,
991 instead of creating a file for each one.
992 </p>
993 </dd>
994 <dt class="hdlist1">
995 --attach[=&lt;boundary&gt;]
996 </dt>
997 <dd>
999 Create multipart/mixed attachment, the first part of
1000 which is the commit message and the patch itself in the
1001 second part, with <tt>Content-Disposition: attachment</tt>.
1002 </p>
1003 </dd>
1004 <dt class="hdlist1">
1005 --no-attach
1006 </dt>
1007 <dd>
1009 Disable the creation of an attachment, overriding the
1010 configuration setting.
1011 </p>
1012 </dd>
1013 <dt class="hdlist1">
1014 --inline[=&lt;boundary&gt;]
1015 </dt>
1016 <dd>
1018 Create multipart/mixed attachment, the first part of
1019 which is the commit message and the patch itself in the
1020 second part, with <tt>Content-Disposition: inline</tt>.
1021 </p>
1022 </dd>
1023 <dt class="hdlist1">
1024 --thread[=&lt;style&gt;]
1025 </dt>
1026 <dt class="hdlist1">
1027 --no-thread
1028 </dt>
1029 <dd>
1031 Controls addition of <tt>In-Reply-To</tt> and <tt>References</tt> headers to
1032 make the second and subsequent mails appear as replies to the
1033 first. Also controls generation of the <tt>Message-Id</tt> header to
1034 reference.
1035 </p>
1036 <div class="paragraph"><p>The optional &lt;style&gt; argument can be either <tt>shallow</tt> or <tt>deep</tt>.
1037 <em>shallow</em> threading makes every mail a reply to the head of the
1038 series, where the head is chosen from the cover letter, the
1039 <tt>--in-reply-to</tt>, and the first patch mail, in this order. <em>deep</em>
1040 threading makes every mail a reply to the previous one.</p></div>
1041 <div class="paragraph"><p>The default is <tt>--no-thread</tt>, unless the <em>format.thread</em> configuration
1042 is set. If <tt>--thread</tt> is specified without a style, it defaults to the
1043 style specified by <em>format.thread</em> if any, or else <tt>shallow</tt>.</p></div>
1044 <div class="paragraph"><p>Beware that the default for <em>git send-email</em> is to thread emails
1045 itself. If you want <tt>git format-patch</tt> to take care of threading, you
1046 will want to ensure that threading is disabled for <tt>git send-email</tt>.</p></div>
1047 </dd>
1048 <dt class="hdlist1">
1049 --in-reply-to=Message-Id
1050 </dt>
1051 <dd>
1053 Make the first mail (or all the mails with <tt>--no-thread</tt>) appear as a
1054 reply to the given Message-Id, which avoids breaking threads to
1055 provide a new patch series.
1056 </p>
1057 </dd>
1058 <dt class="hdlist1">
1059 --ignore-if-in-upstream
1060 </dt>
1061 <dd>
1063 Do not include a patch that matches a commit in
1064 &lt;until&gt;..&lt;since&gt;. This will examine all patches reachable
1065 from &lt;since&gt; but not from &lt;until&gt; and compare them with the
1066 patches being generated, and any patch that matches is
1067 ignored.
1068 </p>
1069 </dd>
1070 <dt class="hdlist1">
1071 --subject-prefix=&lt;Subject-Prefix&gt;
1072 </dt>
1073 <dd>
1075 Instead of the standard <em>[PATCH]</em> prefix in the subject
1076 line, instead use <em>[&lt;Subject-Prefix&gt;]</em>. This
1077 allows for useful naming of a patch series, and can be
1078 combined with the <tt>--numbered</tt> option.
1079 </p>
1080 </dd>
1081 <dt class="hdlist1">
1082 --to=&lt;email&gt;
1083 </dt>
1084 <dd>
1086 Add a <tt>To:</tt> header to the email headers. This is in addition
1087 to any configured headers, and may be used multiple times.
1088 </p>
1089 </dd>
1090 <dt class="hdlist1">
1091 --cc=&lt;email&gt;
1092 </dt>
1093 <dd>
1095 Add a <tt>Cc:</tt> header to the email headers. This is in addition
1096 to any configured headers, and may be used multiple times.
1097 </p>
1098 </dd>
1099 <dt class="hdlist1">
1100 --add-header=&lt;header&gt;
1101 </dt>
1102 <dd>
1104 Add an arbitrary header to the email headers. This is in addition
1105 to any configured headers, and may be used multiple times.
1106 For example, <tt>--add-header="Organization: git-foo"</tt>
1107 </p>
1108 </dd>
1109 <dt class="hdlist1">
1110 --cover-letter
1111 </dt>
1112 <dd>
1114 In addition to the patches, generate a cover letter file
1115 containing the shortlog and the overall diffstat. You can
1116 fill in a description in the file before sending it out.
1117 </p>
1118 </dd>
1119 <dt class="hdlist1">
1120 --[no]-signature=&lt;signature&gt;
1121 </dt>
1122 <dd>
1124 Add a signature to each message produced. Per RFC 3676 the signature
1125 is separated from the body by a line with '-- ' on it. If the
1126 signature option is omitted the signature defaults to the git version
1127 number.
1128 </p>
1129 </dd>
1130 <dt class="hdlist1">
1131 --suffix=.&lt;sfx&gt;
1132 </dt>
1133 <dd>
1135 Instead of using <tt>.patch</tt> as the suffix for generated
1136 filenames, use specified suffix. A common alternative is
1137 <tt>--suffix=.txt</tt>. Leaving this empty will remove the <tt>.patch</tt>
1138 suffix.
1139 </p>
1140 <div class="paragraph"><p>Note that the leading character does not have to be a dot; for example,
1141 you can use <tt>--suffix=-patch</tt> to get <tt>0001-description-of-my-change-patch</tt>.</p></div>
1142 </dd>
1143 <dt class="hdlist1">
1144 --quiet
1145 </dt>
1146 <dd>
1148 Do not print the names of the generated files to standard output.
1149 </p>
1150 </dd>
1151 <dt class="hdlist1">
1152 --no-binary
1153 </dt>
1154 <dd>
1156 Do not output contents of changes in binary files, instead
1157 display a notice that those files changed. Patches generated
1158 using this option cannot be applied properly, but they are
1159 still useful for code review.
1160 </p>
1161 </dd>
1162 <dt class="hdlist1">
1163 --root
1164 </dt>
1165 <dd>
1167 Treat the revision argument as a &lt;revision range&gt;, even if it
1168 is just a single commit (that would normally be treated as a
1169 &lt;since&gt;). Note that root commits included in the specified
1170 range are always formatted as creation patches, independently
1171 of this flag.
1172 </p>
1173 </dd>
1174 </dl></div>
1175 </div>
1176 <h2 id="_configuration">CONFIGURATION</h2>
1177 <div class="sectionbody">
1178 <div class="paragraph"><p>You can specify extra mail header lines to be added to each message,
1179 defaults for the subject prefix and file suffix, number patches when
1180 outputting more than one patch, add "To" or "Cc:" headers, configure
1181 attachments, and sign off patches with configuration variables.</p></div>
1182 <div class="listingblock">
1183 <div class="content">
1184 <pre><tt>[format]
1185 headers = "Organization: git-foo\n"
1186 subjectprefix = CHANGE
1187 suffix = .txt
1188 numbered = auto
1189 to = &lt;email&gt;
1190 cc = &lt;email&gt;
1191 attach [ = mime-boundary-string ]
1192 signoff = true</tt></pre>
1193 </div></div>
1194 </div>
1195 <h2 id="_discussion">DISCUSSION</h2>
1196 <div class="sectionbody">
1197 <div class="paragraph"><p>The patch produced by <em>git format-patch</em> is in UNIX mailbox format,
1198 with a fixed "magic" time stamp to indicate that the file is output
1199 from format-patch rather than a real mailbox, like so:</p></div>
1200 <div class="listingblock">
1201 <div class="content">
1202 <pre><tt>From 8f72bad1baf19a53459661343e21d6491c3908d3 Mon Sep 17 00:00:00 2001
1203 From: Tony Luck &lt;tony.luck@intel.com&gt;
1204 Date: Tue, 13 Jul 2010 11:42:54 -0700
1205 Subject: [PATCH] =?UTF-8?q?[IA64]=20Put=20ia64=20config=20files=20on=20the=20?=
1206 =?UTF-8?q?Uwe=20Kleine-K=C3=B6nig=20diet?=
1207 MIME-Version: 1.0
1208 Content-Type: text/plain; charset=UTF-8
1209 Content-Transfer-Encoding: 8bit
1211 arch/arm config files were slimmed down using a python script
1212 (See commit c2330e286f68f1c408b4aa6515ba49d57f05beae comment)
1214 Do the same for ia64 so we can have sleek &amp; trim looking
1215 ...</tt></pre>
1216 </div></div>
1217 <div class="paragraph"><p>Typically it will be placed in a MUA&#8217;s drafts folder, edited to add
1218 timely commentary that should not go in the changelog after the three
1219 dashes, and then sent as a message whose body, in our example, starts
1220 with "arch/arm config files were&#8230;". On the receiving end, readers
1221 can save interesting patches in a UNIX mailbox and apply them with
1222 <a href="git-am.html">git-am(1)</a>.</p></div>
1223 <div class="paragraph"><p>When a patch is part of an ongoing discussion, the patch generated by
1224 <em>git format-patch</em> can be tweaked to take advantage of the <em>git am
1225 --scissors</em> feature. After your response to the discussion comes a
1226 line that consists solely of "<tt>-- &gt;8 --</tt>" (scissors and perforation),
1227 followed by the patch with unnecessary header fields removed:</p></div>
1228 <div class="listingblock">
1229 <div class="content">
1230 <pre><tt>...
1231 &gt; So we should do such-and-such.
1233 Makes sense to me. How about this patch?
1235 -- &gt;8 --
1236 Subject: [IA64] Put ia64 config files on the Uwe Kleine-König diet
1238 arch/arm config files were slimmed down using a python script
1239 ...</tt></pre>
1240 </div></div>
1241 <div class="paragraph"><p>When sending a patch this way, most often you are sending your own
1242 patch, so in addition to the "<tt>From $SHA1 $magic_timestamp</tt>" marker you
1243 should omit <tt>From:</tt> and <tt>Date:</tt> lines from the patch file. The patch
1244 title is likely to be different from the subject of the discussion the
1245 patch is in response to, so it is likely that you would want to keep
1246 the Subject: line, like the example above.</p></div>
1247 <h3 id="_checking_for_patch_corruption">Checking for patch corruption</h3><div style="clear:left"></div>
1248 <div class="paragraph"><p>Many mailers if not set up properly will corrupt whitespace. Here are
1249 two common types of corruption:</p></div>
1250 <div class="ulist"><ul>
1251 <li>
1253 Empty context lines that do not have <em>any</em> whitespace.
1254 </p>
1255 </li>
1256 <li>
1258 Non-empty context lines that have one extra whitespace at the
1259 beginning.
1260 </p>
1261 </li>
1262 </ul></div>
1263 <div class="paragraph"><p>One way to test if your MUA is set up correctly is:</p></div>
1264 <div class="ulist"><ul>
1265 <li>
1267 Send the patch to yourself, exactly the way you would, except
1268 with To: and Cc: lines that do not contain the list and
1269 maintainer address.
1270 </p>
1271 </li>
1272 <li>
1274 Save that patch to a file in UNIX mailbox format. Call it a.patch,
1275 say.
1276 </p>
1277 </li>
1278 <li>
1280 Apply it:
1281 </p>
1282 <div class="literalblock">
1283 <div class="content">
1284 <pre><tt>$ git fetch &lt;project&gt; master:test-apply
1285 $ git checkout test-apply
1286 $ git reset --hard
1287 $ git am a.patch</tt></pre>
1288 </div></div>
1289 </li>
1290 </ul></div>
1291 <div class="paragraph"><p>If it does not apply correctly, there can be various reasons.</p></div>
1292 <div class="ulist"><ul>
1293 <li>
1295 The patch itself does not apply cleanly. That is <em>bad</em> but
1296 does not have much to do with your MUA. You might want to rebase
1297 the patch with <a href="git-rebase.html">git-rebase(1)</a> before regenerating it in
1298 this case.
1299 </p>
1300 </li>
1301 <li>
1303 The MUA corrupted your patch; "am" would complain that
1304 the patch does not apply. Look in the .git/rebase-apply/ subdirectory and
1305 see what <em>patch</em> file contains and check for the common
1306 corruption patterns mentioned above.
1307 </p>
1308 </li>
1309 <li>
1311 While at it, check the <em>info</em> and <em>final-commit</em> files as well.
1312 If what is in <em>final-commit</em> is not exactly what you would want to
1313 see in the commit log message, it is very likely that the
1314 receiver would end up hand editing the log message when applying
1315 your patch. Things like "Hi, this is my first patch.\n" in the
1316 patch e-mail should come after the three-dash line that signals
1317 the end of the commit message.
1318 </p>
1319 </li>
1320 </ul></div>
1321 </div>
1322 <h2 id="_mua_specific_hints">MUA-SPECIFIC HINTS</h2>
1323 <div class="sectionbody">
1324 <div class="paragraph"><p>Here are some hints on how to successfully submit patches inline using
1325 various mailers.</p></div>
1326 <h3 id="_gmail">GMail</h3><div style="clear:left"></div>
1327 <div class="paragraph"><p>GMail does not have any way to turn off line wrapping in the web
1328 interface, so it will mangle any emails that you send. You can however
1329 use "git send-email" and send your patches through the GMail SMTP server, or
1330 use any IMAP email client to connect to the google IMAP server and forward
1331 the emails through that.</p></div>
1332 <div class="paragraph"><p>For hints on using <em>git send-email</em> to send your patches through the
1333 GMail SMTP server, see the EXAMPLE section of <a href="git-send-email.html">git-send-email(1)</a>.</p></div>
1334 <div class="paragraph"><p>For hints on submission using the IMAP interface, see the EXAMPLE
1335 section of <a href="git-imap-send.html">git-imap-send(1)</a>.</p></div>
1336 <h3 id="_thunderbird">Thunderbird</h3><div style="clear:left"></div>
1337 <div class="paragraph"><p>By default, Thunderbird will both wrap emails as well as flag
1338 them as being <em>format=flowed</em>, both of which will make the
1339 resulting email unusable by git.</p></div>
1340 <div class="paragraph"><p>There are three different approaches: use an add-on to turn off line wraps,
1341 configure Thunderbird to not mangle patches, or use
1342 an external editor to keep Thunderbird from mangling the patches.</p></div>
1343 <h4 id="_approach_1_add_on">Approach #1 (add-on)</h4>
1344 <div class="paragraph"><p>Install the Toggle Word Wrap add-on that is available from
1345 <a href="https://addons.mozilla.org/thunderbird/addon/toggle-word-wrap/">https://addons.mozilla.org/thunderbird/addon/toggle-word-wrap/</a>
1346 It adds a menu entry "Enable Word Wrap" in the composer&#8217;s "Options" menu
1347 that you can tick off. Now you can compose the message as you otherwise do
1348 (cut + paste, <em>git format-patch</em> | <em>git imap-send</em>, etc), but you have to
1349 insert line breaks manually in any text that you type.</p></div>
1350 <h4 id="_approach_2_configuration">Approach #2 (configuration)</h4>
1351 <div class="paragraph"><p>Three steps:</p></div>
1352 <div class="olist arabic"><ol class="arabic">
1353 <li>
1355 Configure your mail server composition as plain text:
1356 Edit&#8230;Account Settings&#8230;Composition &amp; Addressing,
1357 uncheck "Compose Messages in HTML".
1358 </p>
1359 </li>
1360 <li>
1362 Configure your general composition window to not wrap.
1363 </p>
1364 <div class="paragraph"><p>In Thunderbird 2:
1365 Edit..Preferences..Composition, wrap plain text messages at 0</p></div>
1366 <div class="paragraph"><p>In Thunderbird 3:
1367 Edit..Preferences..Advanced..Config Editor. Search for
1368 "mail.wrap_long_lines".
1369 Toggle it to make sure it is set to <tt>false</tt>.</p></div>
1370 </li>
1371 <li>
1373 Disable the use of format=flowed:
1374 Edit..Preferences..Advanced..Config Editor. Search for
1375 "mailnews.send_plaintext_flowed".
1376 Toggle it to make sure it is set to <tt>false</tt>.
1377 </p>
1378 </li>
1379 </ol></div>
1380 <div class="paragraph"><p>After that is done, you should be able to compose email as you
1381 otherwise would (cut + paste, <em>git format-patch</em> | <em>git imap-send</em>, etc),
1382 and the patches will not be mangled.</p></div>
1383 <h4 id="_approach_3_external_editor">Approach #3 (external editor)</h4>
1384 <div class="paragraph"><p>The following Thunderbird extensions are needed:
1385 AboutConfig from <a href="http://aboutconfig.mozdev.org/">http://aboutconfig.mozdev.org/</a> and
1386 External Editor from <a href="http://globs.org/articles.php?lng=en&amp;pg=8">http://globs.org/articles.php?lng=en&amp;pg=8</a></p></div>
1387 <div class="olist arabic"><ol class="arabic">
1388 <li>
1390 Prepare the patch as a text file using your method of choice.
1391 </p>
1392 </li>
1393 <li>
1395 Before opening a compose window, use Edit&#8594;Account Settings to
1396 uncheck the "Compose messages in HTML format" setting in the
1397 "Composition &amp; Addressing" panel of the account to be used to
1398 send the patch.
1399 </p>
1400 </li>
1401 <li>
1403 In the main Thunderbird window, <em>before</em> you open the compose
1404 window for the patch, use Tools&#8594;about:config to set the
1405 following to the indicated values:
1406 </p>
1407 <div class="listingblock">
1408 <div class="content">
1409 <pre><tt> mailnews.send_plaintext_flowed =&gt; false
1410 mailnews.wraplength =&gt; 0</tt></pre>
1411 </div></div>
1412 </li>
1413 <li>
1415 Open a compose window and click the external editor icon.
1416 </p>
1417 </li>
1418 <li>
1420 In the external editor window, read in the patch file and exit
1421 the editor normally.
1422 </p>
1423 </li>
1424 </ol></div>
1425 <div class="paragraph"><p>Side note: it may be possible to do step 2 with
1426 about:config and the following settings but no one&#8217;s tried yet.</p></div>
1427 <div class="listingblock">
1428 <div class="content">
1429 <pre><tt> mail.html_compose =&gt; false
1430 mail.identity.default.compose_html =&gt; false
1431 mail.identity.id?.compose_html =&gt; false</tt></pre>
1432 </div></div>
1433 <div class="paragraph"><p>There is a script in contrib/thunderbird-patch-inline which can help
1434 you include patches with Thunderbird in an easy way. To use it, do the
1435 steps above and then use the script as the external editor.</p></div>
1436 <h3 id="_kmail">KMail</h3><div style="clear:left"></div>
1437 <div class="paragraph"><p>This should help you to submit patches inline using KMail.</p></div>
1438 <div class="olist arabic"><ol class="arabic">
1439 <li>
1441 Prepare the patch as a text file.
1442 </p>
1443 </li>
1444 <li>
1446 Click on New Mail.
1447 </p>
1448 </li>
1449 <li>
1451 Go under "Options" in the Composer window and be sure that
1452 "Word wrap" is not set.
1453 </p>
1454 </li>
1455 <li>
1457 Use Message &#8594; Insert file&#8230; and insert the patch.
1458 </p>
1459 </li>
1460 <li>
1462 Back in the compose window: add whatever other text you wish to the
1463 message, complete the addressing and subject fields, and press send.
1464 </p>
1465 </li>
1466 </ol></div>
1467 </div>
1468 <h2 id="_examples">EXAMPLES</h2>
1469 <div class="sectionbody">
1470 <div class="ulist"><ul>
1471 <li>
1473 Extract commits between revisions R1 and R2, and apply them on top of
1474 the current branch using <em>git am</em> to cherry-pick them:
1475 </p>
1476 <div class="listingblock">
1477 <div class="content">
1478 <pre><tt>$ git format-patch -k --stdout R1..R2 | git am -3 -k</tt></pre>
1479 </div></div>
1480 </li>
1481 <li>
1483 Extract all commits which are in the current branch but not in the
1484 origin branch:
1485 </p>
1486 <div class="listingblock">
1487 <div class="content">
1488 <pre><tt>$ git format-patch origin</tt></pre>
1489 </div></div>
1490 <div class="paragraph"><p>For each commit a separate file is created in the current directory.</p></div>
1491 </li>
1492 <li>
1494 Extract all commits that lead to <em>origin</em> since the inception of the
1495 project:
1496 </p>
1497 <div class="listingblock">
1498 <div class="content">
1499 <pre><tt>$ git format-patch --root origin</tt></pre>
1500 </div></div>
1501 </li>
1502 <li>
1504 The same as the previous one:
1505 </p>
1506 <div class="listingblock">
1507 <div class="content">
1508 <pre><tt>$ git format-patch -M -B origin</tt></pre>
1509 </div></div>
1510 <div class="paragraph"><p>Additionally, it detects and handles renames and complete rewrites
1511 intelligently to produce a renaming patch. A renaming patch reduces
1512 the amount of text output, and generally makes it easier to review.
1513 Note that non-git "patch" programs won&#8217;t understand renaming patches, so
1514 use it only when you know the recipient uses git to apply your patch.</p></div>
1515 </li>
1516 <li>
1518 Extract three topmost commits from the current branch and format them
1519 as e-mailable patches:
1520 </p>
1521 <div class="listingblock">
1522 <div class="content">
1523 <pre><tt>$ git format-patch -3</tt></pre>
1524 </div></div>
1525 </li>
1526 </ul></div>
1527 </div>
1528 <h2 id="_see_also">SEE ALSO</h2>
1529 <div class="sectionbody">
1530 <div class="paragraph"><p><a href="git-am.html">git-am(1)</a>, <a href="git-send-email.html">git-send-email(1)</a></p></div>
1531 </div>
1532 <h2 id="_git">GIT</h2>
1533 <div class="sectionbody">
1534 <div class="paragraph"><p>Part of the <a href="git.html">git(1)</a> suite</p></div>
1535 </div>
1536 <div id="footer">
1537 <div id="footer-text">
1538 Last updated 2011-05-05 01:29:54 UTC
1539 </div>
1540 </div>
1541 </body>
1542 </html>