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

[Junio C Hamano <gitster@pobox.com>]

sndanailov@wired4ever.net writes:

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

True.  The names we use, 'ssl' and 'tls', emerged historically and
are not the best ones in retrospect.

It may also help understanding if you mentioned STARTTLS somewhere
in the description of "explicit" one, as (some) readers may be more
familiar with that term than "implicit vs explicit".

>  --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`.
>  
>  --smtp-domain=<FQDN>::