On 2022-10-10 at 17:28:59, sndanailov@xxxxxxxxxxxxxx wrote: > From: Sotir Danailov <sndanailov@xxxxxxxxxxxxxx> > > New explanation for the difference between these values. > It's hard to understand what they do based only on the names. > > Signed-off-by: Sotir Danailov <sndanailov@xxxxxxxxxxxxxx> > --- > Documentation/git-send-email.txt | 7 +++++-- > 1 file changed, 5 insertions(+), 2 deletions(-) > > diff --git a/Documentation/git-send-email.txt b/Documentation/git-send-email.txt > index 3290043053..4db32f05f0 100644 > --- a/Documentation/git-send-email.txt > +++ b/Documentation/git-send-email.txt > @@ -178,8 +178,11 @@ 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 > + Specify the encryption to use, either 'ssl' or 'tls'. Any other > + value reverts to plain SMTP. The difference between the two for Git is > + that 'ssl' uses implicit encryption and defaults to port 465, 'tls' > + uses explicit encryption and defaults to port 25. Other ports might be > + used by the SMTP server. Default is the value of > `sendemail.smtpEncryption`. This is a definite improvement, but maybe we'd want to say that 'tls' is really STARTTLS, while 'ssl' is always-on encryption over a dedicated port. It might also be worth mentioning that the choice of name doesn't affect the actual protocol and version used and the user is almost certainly using TLS either way. -- brian m. carlson (he/him or they/them) Toronto, Ontario, CA
Attachment:
signature.asc
Description: PGP signature
