From: Robert Thorpe <rt@robertthorpeconsulting.com>
Date: Mon, 14 Dec 2020 16:51:25 +0000 (+0100)
Subject: Mention how to handle user names with @ in rmail
X-Git-Tag: emacs-28.0.90~4713
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=b63cb95ad441a47afcf6c7848e6583b89b0e6755;p=emacs.git

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
---

diff --git a/doc/emacs/rmail.texi b/doc/emacs/rmail.texi
index 467c5269866..0c47812449b 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