diff options
author | Junio C Hamano <junio@hera.kernel.org> | 2009-04-02 06:52:03 +0000 |
---|---|---|
committer | Junio C Hamano <junio@hera.kernel.org> | 2009-04-02 06:52:03 +0000 |
commit | 9572e92f03dbe32702c906280c22868b3b57caa4 (patch) | |
tree | f53f3bc945a1ce27df7614b1db532ed83ce19d5b /git-format-patch.html | |
parent | 0706c80eb5150908b5a08c163848c7e9328923b4 (diff) | |
download | git-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.html | 38 |
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 <revision range> expression (see "SPECIFYING </p>
</li>
</ol></div>
-<div class="para"><p>A single commit, when interpreted as a <revision range>
-expression, means "everything that leads to that commit", but
-if you write <em>git format-patch <commit></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 <commit>" 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 <commit>".</p></div>
+<div class="para"><p>The first rule takes precedence in the case of a single <commit>. To
+apply the second rule, i.e., format everything since the beginning of
+history up until <commit>, use the <em>--root</em> option: "git format-patch
+--root <commit>". If you want to format only <commit> itself, you
+can do this with "git format-patch -1 <commit>".</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=<header>
+</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 <revision range>, even if it
+ is just a single commit (that would normally be treated as a
+ <since>). 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>
|