From f3719df4d257f80d0aaed71da601a89ee8e13b2e Mon Sep 17 00:00:00 2001
From: Nikolaus Schulz <microschulz@web.de>
Date: Tue, 23 Oct 2007 23:11:29 +0000
Subject: Updated documentation WRT to the new quoted usernames/passwords in
 IMAP URLs.

---
 archivemail.sgml | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

(limited to 'archivemail.sgml')

diff --git a/archivemail.sgml b/archivemail.sgml
index 8b100ee..ff3ecd5 100644
--- a/archivemail.sgml
+++ b/archivemail.sgml
@@ -35,7 +35,7 @@
 
 <RefEntry>
 
-<DocInfo><Date>2 November 2006</Date></DocInfo>
+<DocInfo><Date>23 October 2007</Date></DocInfo>
 
 <RefMeta>
 <RefEntryTitle>archivemail</RefEntryTitle>
@@ -349,11 +349,14 @@ Display brief summary information about how to run <Command/archivemail/.
 <Para>
 To archive an <application/IMAP/-format mailbox, use the format
 <command>imap://username:password@server/mailbox</command> to specify the
-mailbox. You can omit the password from the <acronym/URL/; use the
-<option>--pwfile</option> option to make <command/archivemail/ read the
-password from a file, or just enter it upon request. Substitute '<acronym/imap/'
-with '<acronym/imaps/', and <command/archivemail/ will establish a secure
-<acronym/SSL/ connection. 
+mailbox. If your username or password contains the '@' or ':' character,
+you can double-quote it like this:
+<command>imap://"username@bogus.com":"password"@server/mailbox</command>. Use a
+backslash to escape double-quotes that are part of a quoted username or password.
+You can omit the password from the <acronym/URL/; use the <option>--pwfile</option> 
+option to make <command/archivemail/ read the password from a file, or just 
+enter it upon request. Substitute '<acronym/imap/' with '<acronym/imaps/', and 
+<command/archivemail/ will establish a secure <acronym/SSL/ connection. 
 </Para>
 
 <Para>
-- 
cgit v1.2.3