master b63cb95 1/2: Mention how to handle user names with @ in rmail

[Lars Ingebrigtsen]

branch: master
commit b63cb95ad441a47afcf6c7848e6583b89b0e6755
Author: Robert Thorpe <rt@robertthorpeconsulting.com>
Commit: Lars Ingebrigtsen <larsi@gnus.org>

    Mention how to handle user names with @ in rmail
    
    * doc/emacs/rmail.texi (Remote Mailboxes): Mention how to work
    around the problem with user names like foo@example.com (bug#16946).
    
    Copyright-paperwork-exempt: yes
---
 doc/emacs/rmail.texi | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/doc/emacs/rmail.texi b/doc/emacs/rmail.texi
index 467c526..0c47812 100644
--- a/doc/emacs/rmail.texi
+++ b/doc/emacs/rmail.texi
@@ -1591,6 +1591,14 @@ value is used.
 Otherwise, Rmail will ask you for the password to use.
 @end enumerate
 
+On some mail servers the usernames include domain information, which
+can mean they contain the @samp{@@} character.  The inbox specifier
+string uses @samp{@@} to signal the start of the mailserver name.
+This creates confusion for movemail.  If your username contains
+@samp{@@} and you're using Mailutils @command{movemail} then you can
+fix this: Replace @code{@@} in the user name with its @acronym{URL}
+encoding @samp{%40}.
+
 @vindex rmail-movemail-flags
   If you need to pass additional command-line flags to @command{movemail},
 set the variable @code{rmail-movemail-flags} a list of the flags you