Re: [PATCH] docs: git-send-email: difference between ssl and tls smtp-encryption

From: Aaron Schrab <aaron@schrab.com>
Date: Oct 11, 2022, 00:20 UTC
Message-ID: <Y0S2wyfUF1mZaryi@pug.qqx.org>
In-Reply-To: <xmqq35bvz10b.fsf@gitster.g>

At 16:56 -0700 10 Oct 2022, Junio C Hamano <gitster@pobox.com> wrote:

Show 5 quoted lines

>        Specify how SMTP connection should be entered into encrypted
>        mode.  The valid values are 'ssl' and 'tls'. Any other value
>        reverts to plain (unencrypted) SMTP.  'ssl' refers to "implicit"
>        encryption (sometimes calls SMTPS) that uses port 465 or 587 by
>        default.

There can be only one actual default port for each of the settings and here that is 465.

Also, port 587 belongs with the 'tls' value. Perhaps saying something like:

     uses port 25 by default, but port 587 is often used as well.

>        'tls' refers to "explicit" encryption (often known as
>        STARTTLS) that uses port 25 by default.  Despite their names, it
>        is likely the user is using the newer TLS protocol, not the
>        deprecated SSL, for the actual encryption protocol either way.