[Emacs-diffs] master e3c1534 2/2: In the manual, mention pops and imaps

[Glenn Morris]

branch: master
commit e3c15342a5459135765789a7e19a70b1e655fd1e
Author: Glenn Morris <address@hidden>
Commit: Glenn Morris <address@hidden>

    In the manual, mention pops and imaps
    
    * doc/emacs/rmail.texi (Movemail, Remote Mailboxes):
    Mention pops and imaps protocols.
---
 doc/emacs/rmail.texi | 22 ++++++++++++++++------
 1 file changed, 16 insertions(+), 6 deletions(-)

diff --git a/doc/emacs/rmail.texi b/doc/emacs/rmail.texi
index 59955ca..046087e 100644
--- a/doc/emacs/rmail.texi
+++ b/doc/emacs/rmail.texi
@@ -1388,7 +1388,7 @@ command line syntax and the same basic subset of options. 
 However, the
 Mailutils version offers additional features.
 
   The Emacs version of @command{movemail} can retrieve mail from the
-usual Unix mailbox formats.  Although it can also use the POP3
+usual Unix mailbox formats.  @strong{Warning}: Although it can also use the 
POP3
 protocol, this is not recommended because it does not support POP3 via
 encrypted TLS channels.
 
@@ -1454,18 +1454,24 @@ Any local mailbox format.  Its actual format is 
detected automatically
 by @command{movemail}.
 
 @item pop
address@hidden pops
 A remote mailbox to be accessed via POP3 protocol.  @var{user}
 specifies the remote user name to use, @var{pass} may be used to
 specify the user password, @var{host-or-file-name} is the name or IP
 address of the remote mail server to connect to, and @var{port} is the
 port number; e.g., @code{pop://smith:guessme@@remote.server.net:995}.
+If the server supports it, @command{movemail} tries to use an
+encrypted connection---use the @samp{pops} form to require one.
 
 @item imap
address@hidden imaps
 A remote mailbox to be accessed via IMAP4 protocol.  @var{user}
 specifies the remote user name to use, @var{pass} may be used to
 specify the user password, @var{host-or-file-name} is the name or IP
 address of the remote mail server to connect to, and @var{port} is the
 port number; e.g., @code{imap://smith:guessme@@remote.server.net:993}.
+If the server supports it, @command{movemail} tries to use an
+encrypted connection---use the @samp{imaps} form to require one.
 @end table
 
   Alternatively, you can specify the file name of the mailbox to use.
@@ -1491,10 +1497,11 @@ listed in @code{rmail-movemail-search-path}, then in 
@code{exec-path}
   Some sites use a method called POP for accessing users' inbox data
 instead of storing the data in inbox files.  The Mailutils
 @command{movemail} by default supports POP with TLS encryption.
-Although the @command{Emacs movemail} supports unencrypted POP, this
-is not recommended due to the lack of encryption.  Both versions of
address@hidden work only with POP3, not with older versions of
-POP.
address@hidden:} Although the @command{Emacs movemail} supports POP,
+its use for this is not recommended since it does not support encrypted
+connections---the Mailutils version does.
+Both versions of @command{movemail} work only with POP3, not with
+older versions of POP.
 
 @cindex @env{MAILHOST} environment variable
 @cindex POP mailboxes
@@ -1510,6 +1517,8 @@ Additionally, you may specify the password in the mailbox 
@acronym{URL}:
 case, @var{password} takes preference over the one set by
 @code{rmail-remote-password} (see below).  This is especially useful
 if you have several remote mailboxes with different passwords.
+If using Mailutils @command{movemail}, you may wish to use
address@hidden in place of @samp{pop}.
 
   For backward compatibility, Rmail also supports an alternative way of
 specifying remote POP mailboxes.  Specifying an inbox name in the form
@@ -1523,7 +1532,8 @@ the machine on which to look for the POP server.
 supported only by the Mailutils @command{movemail}.  To specify an IMAP
 mailbox in the inbox list, use the following mailbox @acronym{URL}:
 @samp{imap://@var{username}[:@var{password}]@@@var{hostname}:@var{port}}.  The
address@hidden part is optional, as described above.
address@hidden part is optional, as described above.  You may wish to
+use @samp{imaps} in place of @samp{imap}.
 
 @vindex rmail-remote-password
 @vindex rmail-remote-password-required