The existing wording in the 'Select the recipients for your patch' section of submitting-patches.rst states that contributors should 'copy' maintainers and lists, which might be interpreted to mean that patch e-mails should be sent 'Cc' such recipients without any 'To' recipients at all. Indeed, this does happen on occasion (and to be fair, examples of the practice predating the submitting-patches document exist in kernel mailing list archives). It isn't a problem on the protocol level, as SMTP itself deals only with SMTP commands (cf. 'RCPT TO'), but software that works with MIME headers in message text, perhaps in order to generate those commands, doesn't always handle the situation well. At present, when such an e-mail is sent to the vger listservs, the MIME header 'To: unlisted-recipients:; (no To-header on input)' is added to it somewhere along the chain. 'unlisted-recipients:;' is a valid RFC 5322 Group Address, but it (or '(no To-header on input)') sometimes goes on to cause problems itself further down the line. For example, in mutt, it can result in the silent removal of all 'Cc' recipients (e.g. kernel mailing lists) from a group reply, leaving the 'To' recipient that the original e-mail was 'From' as the only actual reply recipient [1]. Other issues [2] are possible in other software [3]. It also bears mentioning that a lack of 'To' headers is a characteristic of some spam, so such an e-mail may trigger some spam filters. To reduce ambiguity and eliminate this class of potential (albeit tangential) issues, prescribe sending patches 'To' maintainers and 'Cc' lists. While we're at it, strengthen the recommendation to use scripts/get_maintainer.pl to find patch recipients, and move Andrew Morton's callout as the maintainer of last resort to the next paragraph for better flow. Link: https://github.com/neomutt/neomutt/issues/2548 [1] Link: https://github.com/python/cpython/issues/83281 [2] Link: https://github.com/kvalo/pwcli/issues/15 [3] Signed-off-by: James Seo <james@xxxxxxxxxx> --- Documentation/process/submitting-patches.rst | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/Documentation/process/submitting-patches.rst b/Documentation/process/submitting-patches.rst index efac910e2659..53460f3cdc1d 100644 --- a/Documentation/process/submitting-patches.rst +++ b/Documentation/process/submitting-patches.rst @@ -231,14 +231,15 @@ patch. Select the recipients for your patch ------------------------------------ -You should always copy the appropriate subsystem maintainer(s) and list(s) on -any patch to code that they maintain; look through the MAINTAINERS file and the -source code revision history to see who those maintainers are. The script -scripts/get_maintainer.pl can be very useful at this step (pass paths to your -patches as arguments to scripts/get_maintainer.pl). If you cannot find a -maintainer for the subsystem you are working on, Andrew Morton -(akpm@xxxxxxxxxxxxxxxxxxxx) serves as a maintainer of last resort. - +You should always notify the appropriate subsystem maintainer(s) and list(s) +about any patch to code that they maintain. Identify them by looking through +the MAINTAINERS file and the source code revision history, and by using the +script scripts/get_maintainer.pl (pass paths to your patches as arguments to +scripts/get_maintainer.pl). Send your patch e-mail "To:" those maintainers and +"Cc:" those lists. + +If you cannot find a maintainer for the subsystem you are working on, Andrew +Morton (akpm@xxxxxxxxxxxxxxxxxxxx) serves as a maintainer of last resort. Also, linux-kernel@xxxxxxxxxxxxxxx should be used by default for all patches, but the volume on that list has caused a number of developers to tune it out. Please do not spam unrelated lists and unrelated people, though. -- 2.39.2
