From: Junio C Hamano <gitster@pobox•com>
To: Aditya Garg <gargaditya08@live•com>
Cc: git@vger•kernel.org, Eric Sunshine <sunshine@sunshineco•com>,
Ben Knoble <ben.knoble@gmail•com>,
"brian m . carlson" <sandals@crustytoothpaste•net>
Subject: Re: [PATCH] docs: update sendmail docs to use more secure SMTP server for Gmail
Date: Tue, 26 Aug 2025 07:51:50 -0700 [thread overview]
Message-ID: <xmqqcy8im8zd.fsf@gitster.g> (raw)
In-Reply-To: <PN3PR01MB95973B72C16F68D63BE2B410B83EA@PN3PR01MB9597.INDPRD01.PROD.OUTLOOK.COM> (Aditya Garg's message of "Mon, 25 Aug 2025 12:25:15 +0530")
Aditya Garg <gargaditya08@live•com> writes:
> Gmail's SMTP server also has a port 465 with SSL/TLS encryption. It is
> more secure than port 587 with STARTTLS encryption. Update the docs to
> reflect this change.
"Update the docs to reflect this change"? When there is no change
other than the changes this patch is making to the documentation,
that is a very strange thing to say.
I would have explained it this way instead, perhaps.
Earlier recommendation by IETF with RFC 2595 was to deprecate
implicit TLS in preference for upgrade an initially unencrypted
connection with STARTTLS command. These days, however, IETF
recommends that connections be made using "Implicit TLS", in
preference to STARTTLS and the like, completely reversing their
earlier position, in RFC8314.
Update the GMail example to use the implicit TLS to match the
current recommendation at port 465.
> Signed-off-by: Aditya Garg <gargaditya08@live•com>
> ---
> Documentation/git-send-email.adoc | 8 ++++----
> 1 file changed, 4 insertions(+), 4 deletions(-)
>
> diff --git a/Documentation/git-send-email.adoc b/Documentation/git-send-email.adoc
> index 5335502d68..c610909a92 100644
> --- a/Documentation/git-send-email.adoc
> +++ b/Documentation/git-send-email.adoc
> @@ -521,10 +521,10 @@ edit `~/.gitconfig` to specify your account settings:
>
> ----
> [sendemail]
> - smtpEncryption = tls
> + smtpEncryption = ssl
> smtpServer = smtp.gmail.com
> smtpUser = yourname@gmail•com
> - smtpServerPort = 587
> + smtpServerPort = 465
> ----
>
> Gmail does not allow using your regular password for `git send-email`.
> @@ -542,10 +542,10 @@ if you want to use `OAUTHBEARER`, edit your `~/.gitconfig` file and add
>
> ----
> [sendemail]
> - smtpEncryption = tls
> + smtpEncryption = ssl
> smtpServer = smtp.gmail.com
> smtpUser = yourname@gmail•com
> - smtpServerPort = 587
> + smtpServerPort = 465
> smtpAuth = OAUTHBEARER
> ----
next prev parent reply other threads:[~2025-08-26 14:51 UTC|newest]
Thread overview: 4+ messages / expand[flat|nested] mbox.gz Atom feed top
2025-08-25 6:55 [PATCH] docs: update sendmail docs to use more secure SMTP server for Gmail Aditya Garg
2025-08-26 14:51 ` Junio C Hamano [this message]
2025-08-26 15:07 ` Aditya Garg
2025-08-26 15:09 ` [PATCH v2] " Aditya Garg
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=xmqqcy8im8zd.fsf@gitster.g \
--to=gitster@pobox$(echo .)com \
--cc=ben.knoble@gmail$(echo .)com \
--cc=gargaditya08@live$(echo .)com \
--cc=git@vger$(echo .)kernel.org \
--cc=sandals@crustytoothpaste$(echo .)net \
--cc=sunshine@sunshineco$(echo .)com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox