From f5435a89ec6fc58f51927a5cc4b3ac8b3740384a Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Sun, 10 Apr 2016 03:57:57 +0200 Subject: small improvements to "submitting patches" section MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- using-git.texinfo | 23 +++++++++++++++++++---- 1 file changed, 19 insertions(+), 4 deletions(-) diff --git a/using-git.texinfo b/using-git.texinfo index bbb3cb7..b2a7a4e 100644 --- a/using-git.texinfo +++ b/using-git.texinfo @@ -89,7 +89,7 @@ This manual is aimed at technical people. @copying -Copyright @copyright{} 2013, 2014, 2015 Mattias Andrée +Copyright @copyright{} 2013, 2014, 2015, 2016 Mattias Andrée @quotation Permission is granted to copy, distribute and/or modify this document @@ -722,14 +722,15 @@ you began from @code{upstream/master}: git format-patch upstream/master @end example -This command will create a patch whose name -will be printed by @command{git format-patch}. +This command will create a patch for each +commit whose names will be printed by +@command{git format-patch}. Creating a patch this way will keep track of the commit messages, and the individual commits. Another advantage with this is that it can easily be submitted to a mailing list, -which the common way for large projects for +which is the common way for large projects for accepting patches. The created patch file is formatted as an @@ -758,6 +759,13 @@ sender, by adding an option: --envelope-sender=SENDER_EMAIL_ADDRESS @end example +When using an envelop sender you also need to +specify the commiter with both name and e-mail: + +@example +--from='NAME ' +@end example + You will also need the specify which SMTP server to use, authorisation and configurations: @@ -784,6 +792,13 @@ normal e-mail, but use the forwarding e-mail address as the envelop-sender, most e-mail server should accept this. +You should configure these settings@footnote{Except +for the passphrase of course.} in @file{~/.gitconfig}. +These settings are stored in the @code{[sendemail]} +section. The key names are the same as the +command line options, except in camel case +instead of hyphens. + If you are replying to a message in the mailing list, perhaps with an updated patch, you should specify the message ID of the message to reply -- cgit v1.2.3-70-g09d2