summaryrefslogtreecommitdiffstats
path: root/git-format-patch.txt
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.txt
parent0706c80eb5150908b5a08c163848c7e9328923b4 (diff)
downloadgit-htmldocs-9572e92f03dbe32702c906280c22868b3b57caa4.tar.gz
Autogenerated HTML docs for v1.6.2.1-469-gdffc
Diffstat (limited to 'git-format-patch.txt')
-rw-r--r--git-format-patch.txt26
1 files changed, 17 insertions, 9 deletions
diff --git a/git-format-patch.txt b/git-format-patch.txt
index c2eb5fab4..db3bdb565 100644
--- a/git-format-patch.txt
+++ b/git-format-patch.txt
@@ -40,15 +40,11 @@ There are two ways to specify which commits to operate on.
REVISIONS" section in linkgit:git-rev-parse[1]) means the
commits in the specified range.
-A single commit, when interpreted as a <revision range>
-expression, means "everything that leads to that commit", but
-if you write 'git format-patch <commit>', 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>".
+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 '\--root' option: "git format-patch
+\--root <commit>". If you want to format only <commit> itself, you
+can do this with "git format-patch -1 <commit>".
By default, each output file is numbered sequentially from 1, and uses the
first line of the commit message (massaged for pathname safety) as
@@ -161,6 +157,11 @@ if that is not set.
Add a "Cc:" header to the email headers. This is in addition
to any configured headers, and may be used multiple times.
+--add-header=<header>::
+ 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"
+
--cover-letter::
In addition to the patches, generate a cover letter file
containing the shortlog and the overall diffstat. You can
@@ -182,6 +183,13 @@ not add any suffix.
applied. By default the contents of changes in those files are
encoded in the patch.
+--root::
+ 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.
+
CONFIGURATION
-------------
You can specify extra mail header lines to be added to each message