public inbox for git@vger.kernel.org 
 help / color / mirror / Atom feed
* [PATCH] docs: update sendmail docs to use more secure SMTP server for Gmail
@ 2025-08-25  6:55 Aditya Garg
  2025-08-26 14:51 ` Junio C Hamano
  2025-08-26 15:09 ` [PATCH v2] " Aditya Garg
  0 siblings, 2 replies; 4+ messages in thread
From: Aditya Garg @ 2025-08-25  6:55 UTC (permalink / raw)
  To: git, Junio C Hamano; +Cc: Eric Sunshine, Ben Knoble, brian m . carlson

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.

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
 ----
 
-- 
2.51.0


^ permalink raw reply related	[flat|nested] 4+ messages in thread

* Re: [PATCH] docs: update sendmail docs to use more secure SMTP server for Gmail
  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
  2025-08-26 15:07   ` Aditya Garg
  2025-08-26 15:09 ` [PATCH v2] " Aditya Garg
  1 sibling, 1 reply; 4+ messages in thread
From: Junio C Hamano @ 2025-08-26 14:51 UTC (permalink / raw)
  To: Aditya Garg; +Cc: git, Eric Sunshine, Ben Knoble, brian m . carlson

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
>  ----

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: [PATCH] docs: update sendmail docs to use more secure SMTP server for Gmail
  2025-08-26 14:51 ` Junio C Hamano
@ 2025-08-26 15:07   ` Aditya Garg
  0 siblings, 0 replies; 4+ messages in thread
From: Aditya Garg @ 2025-08-26 15:07 UTC (permalink / raw)
  To: Junio C Hamano; +Cc: git, Eric Sunshine, Ben Knoble, brian m . carlson



On 26/08/25 8:21 pm, Junio C Hamano wrote:
>     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.

Fixed in v2


^ permalink raw reply	[flat|nested] 4+ messages in thread

* [PATCH v2] docs: update sendmail docs to use more secure SMTP server for Gmail
  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
@ 2025-08-26 15:09 ` Aditya Garg
  1 sibling, 0 replies; 4+ messages in thread
From: Aditya Garg @ 2025-08-26 15:09 UTC (permalink / raw)
  To: git@vger•kernel.org, Junio C Hamano
  Cc: Eric Sunshine, Ben Knoble, brian m . carlson

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 daddaae36d..8aa54e36e7 100644
--- a/Documentation/git-send-email.adoc
+++ b/Documentation/git-send-email.adoc
@@ -565,10 +565,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`.
@@ -586,10 +586,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
 ----
 

Range-diff against v1:
-:  ---------- > 1:  6b73d4bb6c docs: update sendmail docs to use more secure SMTP server for Gmail
-- 
2.51.0


^ permalink raw reply related	[flat|nested] 4+ messages in thread

end of thread, other threads:[~2025-08-26 15:09 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
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
2025-08-26 15:07   ` Aditya Garg
2025-08-26 15:09 ` [PATCH v2] " Aditya Garg

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox