From 7c5899d54f194bac2eb799706aec08cda8ab7aa3 Mon Sep 17 00:00:00 2001 From: Eduardo Chappa Date: Thu, 1 Aug 2019 23:23:52 -0600 Subject: * Improvements to the documentation on the meaning of the /tls unary parameter to make sure the user understands that this is used when the STARTLS command is needed and not when a TLS encryption is needed. --- pith/pine.hlp | 23 +++++++++++++++-------- 1 file changed, 15 insertions(+), 8 deletions(-) diff --git a/pith/pine.hlp b/pith/pine.hlp index 8ad4120c..ffcf12a1 100644 --- a/pith/pine.hlp +++ b/pith/pine.hlp @@ -140,7 +140,7 @@ with help text for the config screen and the composer that didn't have any reasonable place to be called from. Dummy change to get revision in pine.hlp ============= h_revision ================= -Alpine Commit 361 2019-07-31 22:42:27 +Alpine Commit 362 2019-08-01 23:23:44 ============= h_news ================= @@ -20876,14 +20876,21 @@ An example might be:
TLS
-Normally, when a new connection is made an attempt is made to -negotiate a secure (encrypted) session using Transport Layer Security (TLS). -If that fails then a non-encrypted connection will be attempted instead. This is a unary parameter indicating communication with the server must -take place over a TLS connection. If the attempt to use TLS fails then -this parameter will cause the connection to fail instead of falling -back to an unsecure connection. Learn more -about security considerations when you use this option. +take place over a TLS connection. If you use this parameter, Alpine will +establish an insecure connection to the server, and later will attempts to +use a secure encrypted connection. If the attempt to use TLS fails then +this parameter will cause the connection to fail instead of falling back +to an insecure connection. +

+Use this option when you are told to use STARTTLS. If you are told to use +SSL or TLS on port 993, use the /ssl unary parameter instead, and not this +parameter. Use this parameter when establishing a connection to a server +on an insecure port (normally port 143 for IMAP) and then needing to +establish a secure connection using STARTTLS. + +

Learn more about security +considerations when you use this option.

/tls
-- cgit v1.2.3-70-g09d2