Skip to content
Snippets Groups Projects
Commit e498257d authored by Michael J Gruber's avatar Michael J Gruber Committed by Junio C Hamano
Browse files

Documentation/SubmittingPatches: clarify GMail section and SMTP


We keep getting mangled submissions from GMail's web interface. Try to
be more proactive in SubmittingPatches by

- pointing to MUA specific instructions early on,
- structuring the GMail section more clearly,
- putting send-email/SMTP before imap-send/IMAP.

Signed-off-by: default avatarMichael J Gruber <git@drmicha.warpmail.net>
Signed-off-by: default avatarJunio C Hamano <gitster@pobox.com>
parent bd7440fe
No related branches found
No related tags found
No related merge requests found
...@@ -41,6 +41,7 @@ Checklist (and a short version for the impatient): ...@@ -41,6 +41,7 @@ Checklist (and a short version for the impatient):
maintainer (gitster@pobox.com) if (and only if) the patch maintainer (gitster@pobox.com) if (and only if) the patch
is ready for inclusion. If you use git-send-email(1), is ready for inclusion. If you use git-send-email(1),
please test it first by sending email to yourself. please test it first by sending email to yourself.
- see below for instructions specific to your mailer
Long version: Long version:
...@@ -519,9 +520,27 @@ Gmail ...@@ -519,9 +520,27 @@ 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 "git send e-mail" and send your patches through the GMail SMTP server, or
use any IMAP email client to connect to the google IMAP server and forward
the emails through that. the emails through that.
To use "git send-email" and send your patches 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/
$ edit outgoing/0000-*
$ git send-email outgoing/*
To submit using the IMAP interface, first, edit your ~/.gitconfig to specify your To submit using the IMAP interface, first, edit your ~/.gitconfig to specify your
account settings: account settings:
...@@ -537,8 +556,7 @@ You might need to instead use: folder = "[Google Mail]/Drafts" if you get an err ...@@ -537,8 +556,7 @@ You might need to instead use: folder = "[Google Mail]/Drafts" if you get an err
that the "Folder doesn't exist". that the "Folder doesn't exist".
Once your commits are ready to be sent to the mailing list, run the Once your commits are ready to be sent to the mailing list, run the
following command to send the patch emails to your Gmail Drafts following commands:
folder.
$ git format-patch --cover-letter -M --stdout origin/master | git imap-send $ git format-patch --cover-letter -M --stdout origin/master | git imap-send
...@@ -546,19 +564,3 @@ Just make sure to disable line wrapping in the email client (GMail web ...@@ -546,19 +564,3 @@ 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 interface will line wrap no matter what, so you need to use a real
IMAP client). IMAP client).
Alternatively, you can use "git send-email" and send your patches
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/*
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment