Skip to content

Commit 16088d8

Browse files
committed
format-patch documentation: mention the special case of showing a single commit
Even long timers seem to have missed that "format-patch -1 $commit" is a much simpler and more obvious way to say "format-patch $commit^..$commit" from the current documentation (and an example "format-patch -3 $commit" to get three patches). Add an explicit instruction in a much earlier part of the documentation to make it easier to find. Signed-off-by: Junio C Hamano <[email protected]>
1 parent a5a323f commit 16088d8

File tree

1 file changed

+2
-1
lines changed

1 file changed

+2
-1
lines changed

Documentation/git-format-patch.txt

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,8 @@ applies to that command line and you do not get "everything
4646
since the beginning of the time". If you want to format
4747
everything since project inception to one commit, say "git
4848
format-patch \--root <commit>" to make it clear that it is the
49-
latter case.
49+
latter case. If you want to format a single commit, you can do
50+
this with "git format-patch -1 <commit>".
5051

5152
By default, each output file is numbered sequentially from 1, and uses the
5253
first line of the commit message (massaged for pathname safety) as

0 commit comments

Comments
 (0)