summaryrefslogtreecommitdiffstats
path: root/git-format-patch.html
diff options
context:
space:
mode:
authorJunio C Hamano <junio@kernel.org>2010-11-06 01:01:59 +0000
committerJunio C Hamano <junio@kernel.org>2010-11-06 01:01:59 +0000
commit68cf15a825368c926443c26a6516947fca3c1d39 (patch)
treea587c9a51372746ddc3cdb08108bb14fb94a0488 /git-format-patch.html
parent39c7a69d994a13cbd5594bf2f5e65a0f21cc9bb9 (diff)
downloadgit-htmldocs-68cf15a825368c926443c26a6516947fca3c1d39.tar.gz
Autogenerated HTML docs for v1.7.3.2-161-g3089c
Diffstat (limited to 'git-format-patch.html')
-rw-r--r--git-format-patch.html356
1 files changed, 226 insertions, 130 deletions
diff --git a/git-format-patch.html b/git-format-patch.html
index 30e7f59df..db6b3f057 100644
--- a/git-format-patch.html
+++ b/git-format-patch.html
@@ -3,7 +3,8 @@
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
-<meta name="generator" content="AsciiDoc 8.2.5" />
+<meta name="generator" content="AsciiDoc 8.4.5" />
+<title>git-format-patch(1)</title>
<style type="text/css">
/* Debug borders */
p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
@@ -26,10 +27,12 @@ a:visited {
em {
font-style: italic;
+ color: navy;
}
strong {
font-weight: bold;
+ color: #083194;
}
tt {
@@ -71,6 +74,10 @@ p {
margin-bottom: 0.5em;
}
+ul, ol, li > p {
+ margin-top: 0;
+}
+
pre {
padding: 0;
margin: 0;
@@ -84,7 +91,7 @@ span#author {
}
span#email {
}
-span#revision {
+span#revnumber, span#revdate, span#revremark {
font-family: sans-serif;
}
@@ -104,11 +111,13 @@ div#footer-badges {
padding-bottom: 0.5em;
}
-div#preamble,
+div#preamble {
+ margin-top: 1.5em;
+ margin-bottom: 1.5em;
+}
div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
div.admonitionblock {
- margin-right: 10%;
margin-top: 1.5em;
margin-bottom: 1.5em;
}
@@ -123,6 +132,7 @@ div.content { /* Block element content. */
/* Block element titles. */
div.title, caption.title {
+ color: #527bbd;
font-family: sans-serif;
font-weight: bold;
text-align: left;
@@ -149,22 +159,33 @@ div.sidebarblock > div.content {
padding: 0.5em;
}
-div.listingblock {
- margin-right: 0%;
-}
div.listingblock > div.content {
border: 1px solid silver;
background: #f4f4f4;
padding: 0.5em;
}
-div.quoteblock > div.content {
+div.quoteblock {
padding-left: 2.0em;
+ margin-right: 10%;
}
-
-div.attribution {
+div.quoteblock > div.attribution {
+ padding-top: 0.5em;
text-align: right;
}
+
+div.verseblock {
+ padding-left: 2.0em;
+ margin-right: 10%;
+}
+div.verseblock > div.content {
+ white-space: pre;
+}
+div.verseblock > div.attribution {
+ padding-top: 0.75em;
+ text-align: left;
+}
+/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
div.verseblock + div.attribution {
text-align: left;
}
@@ -187,13 +208,9 @@ div.exampleblock > div.content {
padding: 0.5em;
}
-div.verseblock div.content {
- white-space: pre;
-}
-
div.imageblock div.content { padding-left: 0; }
-div.imageblock img { border: 1px solid silver; }
span.image img { border-style: none; }
+a.image:visited { color: white; }
dl {
margin-top: 0.8em;
@@ -202,18 +219,38 @@ dl {
dt {
margin-top: 0.5em;
margin-bottom: 0;
- font-style: italic;
+ font-style: normal;
+ color: navy;
}
dd > *:first-child {
- margin-top: 0;
+ margin-top: 0.1em;
}
ul, ol {
list-style-position: outside;
}
-div.olist2 ol {
+ol.arabic {
+ list-style-type: decimal;
+}
+ol.loweralpha {
list-style-type: lower-alpha;
}
+ol.upperalpha {
+ list-style-type: upper-alpha;
+}
+ol.lowerroman {
+ list-style-type: lower-roman;
+}
+ol.upperroman {
+ list-style-type: upper-roman;
+}
+
+div.compact ul, div.compact ol,
+div.compact p, div.compact p,
+div.compact div, div.compact div {
+ margin-top: 0.1em;
+ margin-bottom: 0.1em;
+}
div.tableblock > table {
border: 3px solid #527bbd;
@@ -225,22 +262,53 @@ thead {
tfoot {
font-weight: bold;
}
+td > div.verse {
+ white-space: pre;
+}
+p.table {
+ margin-top: 0;
+}
+/* Because the table frame attribute is overriden by CSS in most browsers. */
+div.tableblock > table[frame="void"] {
+ border-style: none;
+}
+div.tableblock > table[frame="hsides"] {
+ border-left-style: none;
+ border-right-style: none;
+}
+div.tableblock > table[frame="vsides"] {
+ border-top-style: none;
+ border-bottom-style: none;
+}
+
-div.hlist {
+div.hdlist {
margin-top: 0.8em;
margin-bottom: 0.8em;
}
-div.hlist td {
- padding-bottom: 5px;
+div.hdlist tr {
+ padding-bottom: 15px;
}
-td.hlist1 {
+dt.hdlist1.strong, td.hdlist1.strong {
+ font-weight: bold;
+}
+td.hdlist1 {
vertical-align: top;
- font-style: italic;
+ font-style: normal;
padding-right: 0.8em;
+ color: navy;
}
-td.hlist2 {
+td.hdlist2 {
vertical-align: top;
}
+div.hdlist.compact tr {
+ margin: 0;
+ padding-bottom: 0;
+}
+
+.comment {
+ background: yellow;
+}
@media print {
div#footer-badges { display: none; }
@@ -271,7 +339,24 @@ div.toclevel4 {
margin-left: 6em;
font-size: 0.9em;
}
-include1::./stylesheets/xhtml11-manpage.css[]
+/* Overrides for manpage documents */
+h1 {
+ padding-top: 0.5em;
+ padding-bottom: 0.5em;
+ border-top: 2px solid silver;
+ border-bottom: 2px solid silver;
+}
+h2 {
+ border-style: none;
+}
+div.sectionbody {
+ margin-left: 5%;
+}
+
+@media print {
+ div#toc { display: none; }
+}
+
/* Workarounds for IE6's broken and incomplete CSS2. */
div.sidebar-content {
@@ -280,6 +365,7 @@ div.sidebar-content {
padding: 0.5em;
}
div.sidebar-title, div.image-title {
+ color: #527bbd;
font-family: sans-serif;
font-weight: bold;
margin-top: 0.0em;
@@ -292,8 +378,17 @@ div.listingblock div.content {
padding: 0.5em;
}
-div.quoteblock-content {
- padding-left: 2.0em;
+div.quoteblock-attribution {
+ padding-top: 0.5em;
+ text-align: right;
+}
+
+div.verseblock-content {
+ white-space: pre;
+}
+div.verseblock-attribution {
+ padding-top: 0.75em;
+ text-align: left;
}
div.exampleblock-content {
@@ -304,7 +399,6 @@ div.exampleblock-content {
/* IE6 sets dynamically generated links as visited. */
div#toc a:visited { color: blue; }
</style>
-<title>git-format-patch(1)</title>
</head>
<body>
<div id="header">
@@ -318,10 +412,10 @@ git-format-patch(1) Manual Page
</p>
</div>
</div>
-<h2>SYNOPSIS</h2>
+<h2 id="_synopsis">SYNOPSIS</h2>
<div class="sectionbody">
<div class="verseblock">
-<div class="content"><em>git format-patch</em> [-k] [(-o|--output-directory) &lt;dir&gt; | --stdout]
+<div class="verseblock-content"><em>git format-patch</em> [-k] [(-o|--output-directory) &lt;dir&gt; | --stdout]
[--no-thread | --thread[=&lt;style&gt;]]
[(--attach|--inline)[=&lt;boundary&gt;] | --no-attach]
[-s | --signoff]
@@ -334,16 +428,18 @@ git-format-patch(1) Manual Page
[--to=&lt;email&gt;] [--cc=&lt;email&gt;]
[--cover-letter]
[&lt;common diff options&gt;]
- [ &lt;since&gt; | &lt;revision range&gt; ]</div></div>
+ [ &lt;since&gt; | &lt;revision range&gt; ]</div>
+<div class="verseblock-attribution">
+</div></div>
</div>
<h2 id="_description">DESCRIPTION</h2>
<div class="sectionbody">
-<div class="para"><p>Prepare each commit with its patch in
+<div class="paragraph"><p>Prepare each commit with its patch in
one file per commit, formatted to resemble UNIX mailbox format.
The output of this command is convenient for e-mail submission or
for use with <em>git am</em>.</p></div>
-<div class="para"><p>There are two ways to specify which commits to operate on.</p></div>
-<div class="olist"><ol>
+<div class="paragraph"><p>There are two ways to specify which commits to operate on.</p></div>
+<div class="olist arabic"><ol class="arabic">
<li>
<p>
A single commit, &lt;since&gt;, specifies that the commits leading
@@ -359,35 +455,35 @@ Generic &lt;revision range&gt; expression (see "SPECIFYING
</p>
</li>
</ol></div>
-<div class="para"><p>The first rule takes precedence in the case of a single &lt;commit&gt;. To
+<div class="paragraph"><p>The first rule takes precedence in the case of a single &lt;commit&gt;. To
apply the second rule, i.e., format everything since the beginning of
history up until &lt;commit&gt;, use the <em>--root</em> option: <tt>git format-patch
--root &lt;commit&gt;</tt>. If you want to format only &lt;commit&gt; itself, you
can do this with <tt>git format-patch -1 &lt;commit&gt;</tt>.</p></div>
-<div class="para"><p>By default, each output file is numbered sequentially from 1, and uses the
+<div class="paragraph"><p>By default, each output file is numbered sequentially from 1, and uses the
first line of the commit message (massaged for pathname safety) as
the filename. With the <tt>--numbered-files</tt> option, the output file names
will only be numbers, without the first line of the commit appended.
The names of the output files are printed to standard
output, unless the <tt>--stdout</tt> option is specified.</p></div>
-<div class="para"><p>If <tt>-o</tt> is specified, output files are created in &lt;dir&gt;. Otherwise
+<div class="paragraph"><p>If <tt>-o</tt> is specified, output files are created in &lt;dir&gt;. Otherwise
they are created in the current working directory.</p></div>
-<div class="para"><p>By default, the subject of a single patch is "[PATCH] First Line" and
+<div class="paragraph"><p>By default, the subject of a single patch is "[PATCH] First Line" and
the subject when multiple patches are output is "[PATCH n/m] First
Line". To force 1/1 to be added for a single patch, use <tt>-n</tt>. To omit
patch numbers from the subject, use <tt>-N</tt>.</p></div>
-<div class="para"><p>If given <tt>--thread</tt>, <tt>git-format-patch</tt> will generate <tt>In-Reply-To</tt> and
+<div class="paragraph"><p>If given <tt>--thread</tt>, <tt>git-format-patch</tt> will generate <tt>In-Reply-To</tt> and
<tt>References</tt> headers to make the second and subsequent patch mails appear
as replies to the first mail; this also generates a <tt>Message-Id</tt> header to
reference.</p></div>
</div>
<h2 id="_options">OPTIONS</h2>
<div class="sectionbody">
-<div class="vlist"><dl>
-<dt>
+<div class="dlist"><dl>
+<dt class="hdlist1">
-p
</dt>
-<dt>
+<dt class="hdlist1">
--no-stat
</dt>
<dd>
@@ -395,10 +491,10 @@ reference.</p></div>
Generate plain patches without any diffstats.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
-U&lt;n&gt;
</dt>
-<dt>
+<dt class="hdlist1">
--unified=&lt;n&gt;
</dt>
<dd>
@@ -407,7 +503,7 @@ reference.</p></div>
the usual three.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--patience
</dt>
<dd>
@@ -415,7 +511,7 @@ reference.</p></div>
Generate a diff using the "patience diff" algorithm.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--stat[=&lt;width&gt;[,&lt;name-width&gt;]]
</dt>
<dd>
@@ -426,7 +522,7 @@ reference.</p></div>
giving another width to it separated by a comma.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--numstat
</dt>
<dd>
@@ -438,7 +534,7 @@ reference.</p></div>
<tt>0 0</tt>.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--shortstat
</dt>
<dd>
@@ -448,7 +544,7 @@ reference.</p></div>
lines.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--dirstat[=&lt;limit&gt;]
</dt>
<dd>
@@ -460,7 +556,7 @@ reference.</p></div>
counted for the parent directory, unless <tt>--cumulative</tt> is used.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--dirstat-by-file[=&lt;limit&gt;]
</dt>
<dd>
@@ -468,7 +564,7 @@ reference.</p></div>
Same as <tt>--dirstat</tt>, but counts changed files instead of lines.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--summary
</dt>
<dd>
@@ -477,7 +573,7 @@ reference.</p></div>
such as creations, renames and mode changes.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--no-renames
</dt>
<dd>
@@ -486,7 +582,7 @@ reference.</p></div>
file gives the default to do so.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--full-index
</dt>
<dd>
@@ -496,7 +592,7 @@ reference.</p></div>
line when generating patch format output.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--binary
</dt>
<dd>
@@ -505,7 +601,7 @@ reference.</p></div>
can be applied with <tt>git-apply</tt>.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--abbrev[=&lt;n&gt;]
</dt>
<dd>
@@ -518,10 +614,10 @@ reference.</p></div>
digits can be specified with <tt>--abbrev=&lt;n&gt;</tt>.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
-B[&lt;n&gt;][/&lt;m&gt;]
</dt>
-<dt>
+<dt class="hdlist1">
--break-rewrites[=[&lt;n&gt;][/&lt;m&gt;]]
</dt>
<dd>
@@ -529,7 +625,7 @@ reference.</p></div>
Break complete rewrite changes into pairs of delete and
create. This serves two purposes:
</p>
-<div class="para"><p>It affects the way a change that amounts to a total rewrite of a file
+<div class="paragraph"><p>It affects the way a change that amounts to a total rewrite of a file
not as a series of deletion and insertion mixed together with a very
few lines that happen to match textually as the context, but as a
single deletion of everything old followed by a single insertion of
@@ -538,18 +634,18 @@ option (defaults to 60%). <tt>-B/70%</tt> specifies that less than 30% of the
original should remain in the result for git to consider it a total
rewrite (i.e. otherwise the resulting patch will be a series of
deletion and insertion mixed together with context lines).</p></div>
-<div class="para"><p>When used with -M, a totally-rewritten file is also considered as the
+<div class="paragraph"><p>When used with -M, a totally-rewritten file is also considered as the
source of a rename (usually -M only considers a file that disappeared
as the source of a rename), and the number <tt>n</tt> controls this aspect of
the -B option (defaults to 50%). <tt>-B20%</tt> specifies that a change with
-addition and deletion compared to 20% or more of the file's size are
+addition and deletion compared to 20% or more of the file&#8217;s size are
eligible for being picked up as a possible source of a rename to
another file.</p></div>
</dd>
-<dt>
+<dt class="hdlist1">
-M[&lt;n&gt;]
</dt>
-<dt>
+<dt class="hdlist1">
--detect-renames[=&lt;n&gt;]
</dt>
<dd>
@@ -557,15 +653,15 @@ another file.</p></div>
Detect renames.
If <tt>n</tt> is specified, it is a is a threshold on the similarity
index (i.e. amount of addition/deletions compared to the
- file's size). For example, <tt>-M90%</tt> means git should consider a
+ file&#8217;s size). For example, <tt>-M90%</tt> means git should consider a
delete/add pair to be a rename if more than 90% of the file
- hasn't changed.
+ hasn&#8217;t changed.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
-C[&lt;n&gt;]
</dt>
-<dt>
+<dt class="hdlist1">
--detect-copies[=&lt;n&gt;]
</dt>
<dd>
@@ -574,7 +670,7 @@ another file.</p></div>
If <tt>n</tt> is specified, it has the same meaning as for <tt>-M&lt;n&gt;</tt>.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--find-copies-harder
</dt>
<dd>
@@ -588,7 +684,7 @@ another file.</p></div>
<tt>-C</tt> option has the same effect.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
-l&lt;num&gt;
</dt>
<dd>
@@ -600,7 +696,7 @@ another file.</p></div>
number.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
-O&lt;orderfile&gt;
</dt>
<dd>
@@ -609,10 +705,10 @@ another file.</p></div>
&lt;orderfile&gt;, which has one shell glob pattern per line.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
-a
</dt>
-<dt>
+<dt class="hdlist1">
--text
</dt>
<dd>
@@ -620,7 +716,7 @@ another file.</p></div>
Treat all files as text.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--ignore-space-at-eol
</dt>
<dd>
@@ -628,10 +724,10 @@ another file.</p></div>
Ignore changes in whitespace at EOL.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
-b
</dt>
-<dt>
+<dt class="hdlist1">
--ignore-space-change
</dt>
<dd>
@@ -641,10 +737,10 @@ another file.</p></div>
more whitespace characters to be equivalent.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
-w
</dt>
-<dt>
+<dt class="hdlist1">
--ignore-all-space
</dt>
<dd>
@@ -654,7 +750,7 @@ another file.</p></div>
line has none.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--inter-hunk-context=&lt;lines&gt;
</dt>
<dd>
@@ -663,7 +759,7 @@ another file.</p></div>
of lines, thereby fusing hunks that are close to each other.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--ext-diff
</dt>
<dd>
@@ -673,7 +769,7 @@ another file.</p></div>
to use this option with <a href="git-log.html">git-log(1)</a> and friends.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--no-ext-diff
</dt>
<dd>
@@ -681,7 +777,7 @@ another file.</p></div>
Disallow external diff drivers.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--ignore-submodules[=&lt;when&gt;]
</dt>
<dd>
@@ -699,7 +795,7 @@ another file.</p></div>
the behavior until 1.7.0). Using "all" hides all changes to submodules.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--src-prefix=&lt;prefix&gt;
</dt>
<dd>
@@ -707,7 +803,7 @@ another file.</p></div>
Show the given source prefix instead of "a/".
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--dst-prefix=&lt;prefix&gt;
</dt>
<dd>
@@ -715,7 +811,7 @@ another file.</p></div>
Show the given destination prefix instead of "b/".
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--no-prefix
</dt>
<dd>
@@ -724,10 +820,10 @@ another file.</p></div>
</p>
</dd>
</dl></div>
-<div class="para"><p>For more detailed explanation on these common options, see also
+<div class="paragraph"><p>For more detailed explanation on these common options, see also
<a href="gitdiffcore.html">gitdiffcore(7)</a>.</p></div>
-<div class="vlist"><dl>
-<dt>
+<div class="dlist"><dl>
+<dt class="hdlist1">
-&lt;n&gt;
</dt>
<dd>
@@ -735,10 +831,10 @@ another file.</p></div>
Prepare patches from the topmost &lt;n&gt; commits.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
-o &lt;dir&gt;
</dt>
-<dt>
+<dt class="hdlist1">
--output-directory &lt;dir&gt;
</dt>
<dd>
@@ -747,10 +843,10 @@ another file.</p></div>
current working directory.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
-n
</dt>
-<dt>
+<dt class="hdlist1">
--numbered
</dt>
<dd>
@@ -758,10 +854,10 @@ another file.</p></div>
Name output in <em>[PATCH n/m]</em> format, even with a single patch.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
-N
</dt>
-<dt>
+<dt class="hdlist1">
--no-numbered
</dt>
<dd>
@@ -769,7 +865,7 @@ another file.</p></div>
Name output in <em>[PATCH]</em> format.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--start-number &lt;n&gt;
</dt>
<dd>
@@ -777,7 +873,7 @@ another file.</p></div>
Start numbering the patches at &lt;n&gt; instead of 1.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--numbered-files
</dt>
<dd>
@@ -786,10 +882,10 @@ another file.</p></div>
without the default first line of the commit appended.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
-k
</dt>
-<dt>
+<dt class="hdlist1">
--keep-subject
</dt>
<dd>
@@ -798,10 +894,10 @@ another file.</p></div>
commit log message.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
-s
</dt>
-<dt>
+<dt class="hdlist1">
--signoff
</dt>
<dd>
@@ -810,7 +906,7 @@ another file.</p></div>
the committer identity of yourself.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--stdout
</dt>
<dd>
@@ -819,7 +915,7 @@ another file.</p></div>
instead of creating a file for each one.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--attach[=&lt;boundary&gt;]
</dt>
<dd>
@@ -829,7 +925,7 @@ another file.</p></div>
second part, with <tt>Content-Disposition: attachment</tt>.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--no-attach
</dt>
<dd>
@@ -838,7 +934,7 @@ another file.</p></div>
configuration setting.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--inline[=&lt;boundary&gt;]
</dt>
<dd>
@@ -848,10 +944,10 @@ another file.</p></div>
second part, with <tt>Content-Disposition: inline</tt>.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--thread[=&lt;style&gt;]
</dt>
-<dt>
+<dt class="hdlist1">
--no-thread
</dt>
<dd>
@@ -861,19 +957,19 @@ another file.</p></div>
first. Also controls generation of the <tt>Message-Id</tt> header to
reference.
</p>
-<div class="para"><p>The optional &lt;style&gt; argument can be either <tt>shallow</tt> or <tt>deep</tt>.
+<div class="paragraph"><p>The optional &lt;style&gt; argument can be either <tt>shallow</tt> or <tt>deep</tt>.
<em>shallow</em> threading makes every mail a reply to the head of the
series, where the head is chosen from the cover letter, the
<tt>--in-reply-to</tt>, and the first patch mail, in this order. <em>deep</em>
threading makes every mail a reply to the previous one.</p></div>
-<div class="para"><p>The default is <tt>--no-thread</tt>, unless the <em>format.thread</em> configuration
+<div class="paragraph"><p>The default is <tt>--no-thread</tt>, unless the <em>format.thread</em> configuration
is set. If <tt>--thread</tt> is specified without a style, it defaults to the
style specified by <em>format.thread</em> if any, or else <tt>shallow</tt>.</p></div>
-<div class="para"><p>Beware that the default for <em>git send-email</em> is to thread emails
+<div class="paragraph"><p>Beware that the default for <em>git send-email</em> is to thread emails
itself. If you want <tt>git format-patch</tt> to take care of threading, you
will want to ensure that threading is disabled for <tt>git send-email</tt>.</p></div>
</dd>
-<dt>
+<dt class="hdlist1">
--in-reply-to=Message-Id
</dt>
<dd>
@@ -883,7 +979,7 @@ will want to ensure that threading is disabled for <tt>git send-email</tt>.</p><
provide a new patch series.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--ignore-if-in-upstream
</dt>
<dd>
@@ -895,7 +991,7 @@ will want to ensure that threading is disabled for <tt>git send-email</tt>.</p><
ignored.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--subject-prefix=&lt;Subject-Prefix&gt;
</dt>
<dd>
@@ -906,7 +1002,7 @@ will want to ensure that threading is disabled for <tt>git send-email</tt>.</p><
combined with the <tt>--numbered</tt> option.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--to=&lt;email&gt;
</dt>
<dd>
@@ -915,7 +1011,7 @@ will want to ensure that threading is disabled for <tt>git send-email</tt>.</p><
to any configured headers, and may be used multiple times.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--cc=&lt;email&gt;
</dt>
<dd>
@@ -924,7 +1020,7 @@ will want to ensure that threading is disabled for <tt>git send-email</tt>.</p><
to any configured headers, and may be used multiple times.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--add-header=&lt;header&gt;
</dt>
<dd>
@@ -934,7 +1030,7 @@ will want to ensure that threading is disabled for <tt>git send-email</tt>.</p><
For example, <tt>--add-header="Organization: git-foo"</tt>
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--cover-letter
</dt>
<dd>
@@ -944,18 +1040,18 @@ will want to ensure that threading is disabled for <tt>git send-email</tt>.</p><
fill in a description in the file before sending it out.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--[no]-signature=&lt;signature&gt;
</dt>
<dd>
<p>
Add a signature to each message produced. Per RFC 3676 the signature
- is separated from the body by a line with <em>-- </em> on it. If the
+ is separated from the body by a line with '-- ' on it. If the
signature option is omitted the signature defaults to the git version
number.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--suffix=.&lt;sfx&gt;
</dt>
<dd>
@@ -965,10 +1061,10 @@ will want to ensure that threading is disabled for <tt>git send-email</tt>.</p><
<tt>--suffix=.txt</tt>. Leaving this empty will remove the <tt>.patch</tt>
suffix.
</p>
-<div class="para"><p>Note that the leading character does not have to be a dot; for example,
+<div class="paragraph"><p>Note that the leading character does not have to be a dot; for example,
you can use <tt>--suffix=-patch</tt> to get <tt>0001-description-of-my-change-patch</tt>.</p></div>
</dd>
-<dt>
+<dt class="hdlist1">
--no-binary
</dt>
<dd>
@@ -979,7 +1075,7 @@ you can use <tt>--suffix=-patch</tt> to get <tt>0001-description-of-my-change-pa
still useful for code review.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--root
</dt>
<dd>
@@ -995,7 +1091,7 @@ you can use <tt>--suffix=-patch</tt> to get <tt>0001-description-of-my-change-pa
</div>
<h2 id="_configuration">CONFIGURATION</h2>
<div class="sectionbody">
-<div class="para"><p>You can specify extra mail header lines to be added to each message,
+<div class="paragraph"><p>You can specify extra mail header lines to be added to each message,
defaults for the subject prefix and file suffix, number patches when
outputting more than one patch, add "To" or "Cc:" headers, configure
attachments, and sign off patches with configuration variables.</p></div>
@@ -1014,7 +1110,7 @@ attachments, and sign off patches with configuration variables.</p></div>
</div>
<h2 id="_examples">EXAMPLES</h2>
<div class="sectionbody">
-<div class="ilist"><ul>
+<div class="ulist"><ul>
<li>
<p>
Extract commits between revisions R1 and R2, and apply them on top of
@@ -1034,7 +1130,7 @@ origin branch:
<div class="content">
<pre><tt>$ git format-patch origin</tt></pre>
</div></div>
-<div class="para"><p>For each commit a separate file is created in the current directory.</p></div>
+<div class="paragraph"><p>For each commit a separate file is created in the current directory.</p></div>
</li>
<li>
<p>
@@ -1054,10 +1150,10 @@ The same as the previous one:
<div class="content">
<pre><tt>$ git format-patch -M -B origin</tt></pre>
</div></div>
-<div class="para"><p>Additionally, it detects and handles renames and complete rewrites
+<div class="paragraph"><p>Additionally, it detects and handles renames and complete rewrites
intelligently to produce a renaming patch. A renaming patch reduces
the amount of text output, and generally makes it easier to review.
-Note that non-git "patch" programs won't understand renaming patches, so
+Note that non-git "patch" programs won&#8217;t understand renaming patches, so
use it only when you know the recipient uses git to apply your patch.</p></div>
</li>
<li>
@@ -1074,23 +1170,23 @@ as e-mailable patches:
</div>
<h2 id="_see_also">SEE ALSO</h2>
<div class="sectionbody">
-<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>
+<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>
</div>
<h2 id="_author">Author</h2>
<div class="sectionbody">
-<div class="para"><p>Written by Junio C Hamano &lt;gitster@pobox.com&gt;</p></div>
+<div class="paragraph"><p>Written by Junio C Hamano &lt;<a href="mailto:gitster@pobox.com">gitster@pobox.com</a>&gt;</p></div>
</div>
<h2 id="_documentation">Documentation</h2>
<div class="sectionbody">
-<div class="para"><p>Documentation by Junio C Hamano and the git-list &lt;git@vger.kernel.org&gt;.</p></div>
+<div class="paragraph"><p>Documentation by Junio C Hamano and the git-list &lt;<a href="mailto:git@vger.kernel.org">git@vger.kernel.org</a>&gt;.</p></div>
</div>
<h2 id="_git">GIT</h2>
<div class="sectionbody">
-<div class="para"><p>Part of the <a href="git.html">git(1)</a> suite</p></div>
+<div class="paragraph"><p>Part of the <a href="git.html">git(1)</a> suite</p></div>
</div>
<div id="footer">
<div id="footer-text">
-Last updated 2010-10-27 06:08:20 UTC
+Last updated 2010-11-06 00:41:57 UTC
</div>
</div>
</body>
generated by cgit 1.2.3-korg (git 2.39.0) at 2024-05-29 00:16:58 +0000