summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEduardo Chappa <chappa@washington.edu>2019-08-01 23:23:52 -0600
committerEduardo Chappa <chappa@washington.edu>2019-08-01 23:23:52 -0600
commit7c5899d54f194bac2eb799706aec08cda8ab7aa3 (patch)
treea450163c4b1392d4fed74c18d7328d55cd45a0dc
parentc81d2e8c36f45764436db4fd44cbae2b0ba9c9e0 (diff)
downloadalpine-7c5899d54f194bac2eb799706aec08cda8ab7aa3.tar.xz
* 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.
-rw-r--r--pith/pine.hlp23
1 files changed, 15 insertions, 8 deletions
diff --git a/pith/pine.hlp b/pith/pine.hlp
index 8ad4120..ffcf12a 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>