summaryrefslogtreecommitdiffstats
path: root/git-format-patch.html
diff options
context:
space:
mode:
authorJunio C Hamano <junio@hera.kernel.org>2009-04-02 06:52:03 +0000
committerJunio C Hamano <junio@hera.kernel.org>2009-04-02 06:52:03 +0000
commit9572e92f03dbe32702c906280c22868b3b57caa4 (patch)
treef53f3bc945a1ce27df7614b1db532ed83ce19d5b /git-format-patch.html
parent0706c80eb5150908b5a08c163848c7e9328923b4 (diff)
downloadgit-htmldocs-9572e92f03dbe32702c906280c22868b3b57caa4.tar.gz
Autogenerated HTML docs for v1.6.2.1-469-gdffc
Diffstat (limited to 'git-format-patch.html')
-rw-r--r--git-format-patch.html38
1 files changed, 28 insertions, 10 deletions
diff --git a/git-format-patch.html b/git-format-patch.html
index dc331192c..0ca29f757 100644
--- a/git-format-patch.html
+++ b/git-format-patch.html
@@ -357,15 +357,11 @@ Generic &lt;revision range&gt; expression (see "SPECIFYING
</p>
</li>
</ol></div>
-<div class="para"><p>A single commit, when interpreted as a &lt;revision range&gt;
-expression, means "everything that leads to that commit", but
-if you write <em>git format-patch &lt;commit&gt;</em>, the previous rule
-applies to that command line and you do not get "everything
-since the beginning of the time". If you want to format
-everything since project inception to one commit, say "git
-format-patch --root &lt;commit&gt;" to make it clear that it is the
-latter case. If you want to format a single commit, you can do
-this with "git format-patch -1 &lt;commit&gt;".</p></div>
+<div class="para"><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: "git format-patch
+--root &lt;commit&gt;". If you want to format only &lt;commit&gt; itself, you
+can do this with "git format-patch -1 &lt;commit&gt;".</p></div>
<div class="para"><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 --numbered-files option, the output file names
@@ -1053,6 +1049,16 @@ if that is not set.</p></div>
</p>
</dd>
<dt>
+--add-header=&lt;header&gt;
+</dt>
+<dd>
+<p>
+ Add an arbitrary header to the email headers. This is in addition
+ to any configured headers, and may be used multiple times.
+ For example, --add-header="Organization: git-foo"
+</p>
+</dd>
+<dt>
--cover-letter
</dt>
<dd>
@@ -1087,6 +1093,18 @@ not add any suffix.</p></div>
encoded in the patch.
</p>
</dd>
+<dt>
+--root
+</dt>
+<dd>
+<p>
+ Treat the revision argument as a &lt;revision range&gt;, even if it
+ is just a single commit (that would normally be treated as a
+ &lt;since&gt;). Note that root commits included in the specified
+ range are always formatted as creation patches, independently
+ of this flag.
+</p>
+</dd>
</dl></div>
</div>
<h2 id="_configuration">CONFIGURATION</h2>
@@ -1184,7 +1202,7 @@ as e-mailable patches:
</div>
<div id="footer">
<div id="footer-text">
-Last updated 2009-03-22 08:21:22 UTC
+Last updated 2009-04-02 06:49:52 UTC
</div>
</div>
</body>