From: Thomas Roessler <roessler@does-not-exist.org>
Date: Mon, 2 Jul 2001 14:19:51 +0000 (+0000)
Subject: documentation from Brendan Cully.
X-Git-Tag: mutt-1-3-20-rel~17
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=56e4e030dd1ec4463ea8c1a2692fe986e4a008e9;p=mutt

documentation from Brendan Cully.
---

diff --git a/doc/manual.sgml.head b/doc/manual.sgml.head
index e2ea85e7..b1f37d08 100644
--- a/doc/manual.sgml.head
+++ b/doc/manual.sgml.head
@@ -2260,6 +2260,24 @@ There are a few variables which control authentication:
   listed above).
 </itemize>
 
+<sect1>Managing multiple IMAP/POP accounts (OPTIONAL)<label id="account-hook">
+<p>
+
+If you happen to have accounts on multiple IMAP and/or POP servers,
+you may find managing all the authentication settings inconvenient and
+error-prone.  The account-hook command may help. This hook works like
+folder-hook but is invoked whenever you access a remote mailbox
+(including inside the folder browser), not just when you open the
+mailbox.
+<p>
+Some examples:
+
+<tscreen><verb>
+account-hook . 'unset imap_user; unset imap_pass; unset tunnel'
+account-hook imap://host1/ 'set imap_user=me1 imap_pass=foo'
+account-hook imap://host2/ 'set tunnel="ssh host2 /usr/libexec/imapd"'
+</verb></tscreen>
+
 <sect1>Start a WWW Browser on URLs (EXTERNAL)<label id="urlview">
 <p>
 If a message contains URLs (<em/unified ressource locator/ = address in the
@@ -2809,6 +2827,8 @@ The following are the commands understood by mutt.
 
 <itemize>
 <item>
+<tt><ref id="account-hook" name="account-hook"></tt> <em/pattern/ <em/command/
+<item>
 <tt><ref id="alias" name="alias"></tt> <em/key/ <em/address/ &lsqb; , <em/address/, ... &rsqb;
 <item>
 <tt><ref id="alias" name="unalias"></tt> <em/key/ &lsqb; <em/key/ ... &rsqb;