SubmittingPatches: document how to handle multiple patches
authorRené Scharfe <l.s.r@web.de>
Wed, 27 Nov 2013 00:28:39 +0000 (01:28 +0100)
committerJunio C Hamano <gitster@pobox.com>
Wed, 27 Nov 2013 19:05:58 +0000 (11:05 -0800)
Signed-off-by: Rene Scharfe <l.s.r@web.de>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/SubmittingPatches
index d0a4733e456777d97555ffd475799b468dc8b9de..9d230b3eb24745d00a32d63bda8c49c74c33c6f2 100644 (file)
@@ -126,8 +126,15 @@ People on the Git mailing list need to be able to read and
 comment on the changes you are submitting.  It is important for
 a developer to be able to "quote" your changes, using standard
 e-mail tools, so that they may comment on specific portions of
 comment on the changes you are submitting.  It is important for
 a developer to be able to "quote" your changes, using standard
 e-mail tools, so that they may comment on specific portions of
-your code.  For this reason, all patches should be submitted
-"inline".  If your log message (including your name on the
+your code.  For this reason, each patch should be submitted
+"inline" in a separate message.
+
+Multiple related patches should be grouped into their own e-mail
+thread to help readers find all parts of the series.  To that end,
+send them as replies to either an additional "cover letter" message
+(see below), the first patch, or the respective preceding patch.
+
+If your log message (including your name on the
 Signed-off-by line) is not writable in ASCII, make sure that
 you send off a message in the correct encoding.
 
 Signed-off-by line) is not writable in ASCII, make sure that
 you send off a message in the correct encoding.