From: Philip Oakley <philipoakley@iee.email>
To: sndanailov@wired4ever.net, git@vger.kernel.org
Cc: gitster@pobox.com, sandals@crustytoothpaste.net, aaron@schrab.com
Subject: Re: [PATCH v3] docs: git-send-email: difference between ssl and tls smtp-encryption
Date: Wed, 12 Oct 2022 17:49:53 +0100 [thread overview]
Message-ID: <19e5b678-6014-d783-347f-9169371aaa09@iee.email> (raw)
In-Reply-To: <20221012150619.12877-1-sndanailov@wired4ever.net>
Hi Sotir,
On 12/10/2022 16:06, sndanailov@wired4ever.net wrote:
> From: Sotir Danailov <sndanailov@wired4ever.net>
>
> New explanation for the difference between these values.
> It's hard to understand what they do based only on the names.
> New description of used default ports.
>
> Signed-off-by: Sotir Danailov <sndanailov@wired4ever.net>
> ---
> Changes since v1: Expanded explanation, covering more terms.
> Link to v1: https://public-inbox.org/git/20221010172859.13832-1-sndanailov@wired4ever.net/
>
> Changes since v2: Added a description of what the option actually does.
> Link to v2: https://public-inbox.org/git/20221011164927.1516-1-sndanailov@wired4ever.net/
>
> Documentation/git-send-email.txt | 15 ++++++++++++---
> 1 file changed, 12 insertions(+), 3 deletions(-)
>
> diff --git a/Documentation/git-send-email.txt b/Documentation/git-send-email.txt
> index 3290043053..765b2df853 100644
> --- a/Documentation/git-send-email.txt
> +++ b/Documentation/git-send-email.txt
> @@ -178,9 +178,18 @@ Sending
> for `sendmail` in `/usr/sbin`, `/usr/lib` and $PATH.
>
> --smtp-encryption=<encryption>::
> - Specify the encryption to use, either 'ssl' or 'tls'. Any other
> - value reverts to plain SMTP. Default is the value of
> - `sendemail.smtpEncryption`.
> + Specify in what way encrypting begins for the SMTP connection.
> + Valid values are 'ssl' and 'tls'. Any other value reverts to plain
> + (unencrypted) SMTP, which defaults to port 25.
> + Despite the names, both values will use the same newer version of TLS,
> + but for historic reasons have these names. 'ssl' refers to "implicit"
> + encryption (sometimes called SMTPS), that uses port 465 by default.
> + 'tls' refers to "explicit" encryption (often known as STARTTLS),
> + that uses port 25 by default. Other ports might be used by the SMTP
> + server, which are not the default. Commonly found alternative port for
> + 'tls' and unencrypted is 587.
Can we insert a sentence something like "Use the `--smtp-server-port`
option to set non-default ports." to direct users that need it?
> You need to check your provider's
> + documentation or your server configuration to make sure
> + for your own case. Default is the value of `sendemail.smtpEncryption`.
>
> --smtp-domain=<FQDN>::
> Specifies the Fully Qualified Domain Name (FQDN) used in the
--
Philip
next prev parent reply other threads:[~2022-10-12 16:50 UTC|newest]
Thread overview: 5+ messages / expand[flat|nested] mbox.gz Atom feed top
2022-10-12 15:06 [PATCH v3] docs: git-send-email: difference between ssl and tls smtp-encryption sndanailov
2022-10-12 16:49 ` Philip Oakley [this message]
2022-10-12 21:27 ` brian m. carlson
2022-10-12 21:38 ` Junio C Hamano
2022-10-13 10:54 ` Sotir Danailov
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
List information: http://vger.kernel.org/majordomo-info.html
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=19e5b678-6014-d783-347f-9169371aaa09@iee.email \
--to=philipoakley@iee.email \
--cc=aaron@schrab.com \
--cc=git@vger.kernel.org \
--cc=gitster@pobox.com \
--cc=sandals@crustytoothpaste.net \
--cc=sndanailov@wired4ever.net \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://80x24.org/mirrors/git.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).