undef/git-commit-vandalism
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

SubmittingPatches: update GMail section

Browse Source 
Even if you use imap-send to throw your drafts in the outbox, using their
web interface will mangle your patches.  Clarify that the imap-send is
meant to be used together with a real MUA that can use IMAP drafts, and
remove instructions related to the web interface, which is irrelevant.

Add description of send-email as an alternative.

Use --cover-letter, and do not use -C nor --no-color, on the example
command line for format-patch.

Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:
Junio C Hamano 2010-04-07 15:59:17 -07:00
parent a751b5cc96
commit df5753c4f6
1 changed files with 24 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
Documentation/SubmittingPatches
View File

@ -520,11 +520,9 @@ Gmail
GMail does not appear to have any way to turn off line wrapping in the web GMail does not appear to have any way to turn off line wrapping in the web
interface, so this will mangle any emails that you send. You can however interface, so this will mangle any emails that you send. You can however
use any IMAP email client to connect to the google imap server, and forward use any IMAP email client to connect to the google imap server, and forward
the emails through that. Just make sure to disable line wrapping in that the emails through that.
email client. Alternatively, use "git send-email" instead.
Submitting properly formatted patches via Gmail is simple now that To submit using the IMAP interface, first, edit your ~/.gitconfig to specify your
IMAP support is available. First, edit your ~/.gitconfig to specify your
account settings: account settings:
[imap] [imap]
@ -538,14 +536,29 @@ account settings:
You might need to instead use: folder = "[Google Mail]/Drafts" if you get an error You might need to instead use: folder = "[Google Mail]/Drafts" if you get an error
that the "Folder doesn't exist". that the "Folder doesn't exist".
Next, ensure that your Gmail settings are correct. In "Settings" the Once your commits are ready to be sent to the mailing list, run the
"Use Unicode (UTF-8) encoding for outgoing messages" should be checked. following command to send the patch emails to your Gmail Drafts
folder.
Once your commits are ready to send to the mailing list, run the following $ git format-patch --cover-letter -M --stdout origin/master | git imap-send
command to send the patch emails to your Gmail Drafts folder.
$ git format-patch -M --stdout origin/master | git imap-send Just make sure to disable line wrapping in the email client (GMail web
interface will line wrap no matter what, so you need to use a real
IMAP client).
Go to your Gmail account, open the Drafts folder, find the patch email, fill Alternatively, you can use "git send-email" and send your patches
in the To: and CC: fields and send away! through the GMail SMTP server. edit ~/.gitconfig to specify your
account settings:
[sendemail]
smtpencryption = tls
smtpserver = smtp.gmail.com
smtpuser = user@gmail.com
smtppass = p4ssw0rd
smtpserverport = 587
Once your commits are ready to be sent to the mailing list, run the
following commands:
$ git format-patch --cover-letter -M origin/master -o outgoing/
$ git send-email outgoing/*