docs: git-send-email: difference between ssl and tls smtp-encryption
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> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Sotir Danailov committed
Oct 12, 2022 at 17:06 UTC
a2634646eba81923b66fa752535e24969be2fa82
1 file changed
+12
-3
Documentation/git-send-email.txt
+12
-3
@@ -178,9 +178,18 @@ Sending
178
for `sendmail` in `/usr/sbin`, `/usr/lib` and $PATH.
179
180
--smtp-encryption=<encryption>::
181
- Specify the encryption to use, either 'ssl' or 'tls'. Any other
182
- value reverts to plain SMTP. Default is the value of
183
- `sendemail.smtpEncryption`.
181
+ Specify in what way encrypting begins for the SMTP connection.
182
+ Valid values are 'ssl' and 'tls'. Any other value reverts to plain
183
+ (unencrypted) SMTP, which defaults to port 25.
184
+ Despite the names, both values will use the same newer version of TLS,
185
+ but for historic reasons have these names. 'ssl' refers to "implicit"
186
+ encryption (sometimes called SMTPS), that uses port 465 by default.
187
+ 'tls' refers to "explicit" encryption (often known as STARTTLS),
188
+ that uses port 25 by default. Other ports might be used by the SMTP
189
+ server, which are not the default. Commonly found alternative port for
190
+ 'tls' and unencrypted is 587. You need to check your provider's
191
+ documentation or your server configuration to make sure
192
+ for your own case. Default is the value of `sendemail.smtpEncryption`.
193
194
--smtp-domain=<FQDN>::
195
Specifies the Fully Qualified Domain Name (FQDN) used in the