aboutsummaryrefslogtreecommitdiff
path: root/Documentation
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2007-08-28 21:58:53 -0700
committerJunio C Hamano <gitster@pobox.com>2007-08-28 21:58:53 -0700
commit2f6a3823700cbfda236c2c1f023c43601adae9af (patch)
treeb5a8e537cc416e75e1e4cee0a288b77f81fc9c70 /Documentation
parent04b508f22b34e1b7461ab6414e1612547d87f08e (diff)
downloadgit-2f6a3823700cbfda236c2c1f023c43601adae9af.tar.gz
git-2f6a3823700cbfda236c2c1f023c43601adae9af.tar.xz
format-patch documentation: reword to hint "--root <one-commit>" more clearly
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/git-format-patch.txt17
1 files changed, 10 insertions, 7 deletions
diff --git a/Documentation/git-format-patch.txt b/Documentation/git-format-patch.txt
index 5e6d5373a..c9857a2d6 100644
--- a/Documentation/git-format-patch.txt
+++ b/Documentation/git-format-patch.txt
@@ -34,13 +34,16 @@ There are two ways to specify which commits to operate on.
2. Generic <revision range> expression (see "SPECIFYING
REVISIONS" section in gitlink: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 that is taken as
- the special case above. If you want to format everything
- since project inception to one commit, say "git format-patch
- \--root <that-commit>", as showing the root commit as patch
- requires \--root option anyway.
+ 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.
By default, each output file is numbered sequentially from 1, and uses the
first line of the commit message (massaged for pathname safety) as