From 7c5899d54f194bac2eb799706aec08cda8ab7aa3 Mon Sep 17 00:00:00 2001
From: Eduardo Chappa <chappa@washington.edu>
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(-)

(limited to 'pith/pine.hlp')

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 =================
 <HTML>
 <HEAD>
@@ -20876,14 +20876,21 @@ An example might be:
 
 <DT>TLS</DT>
 <DD>
-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. <A href="h_security_considerations">Learn more</A>
-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.
+<P>
+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.
+
+<P><A href="h_security_considerations">Learn more</A> about security 
+considerations when you use this option.
 
 <P>
 <CENTER><SAMP>/tls</SAMP></CENTER>
-- 
cgit v1.2.3-54-g00ecf

