Manual: Add an example of how to manage multiple accounts using folder-hook

diff --git a/ChangeLog b/ChangeLog
index 262c9cc369da62e72cda47097c0e427ab7735fe7..b4d2651f817ad60b3ef8477ff001803128b8f0f3 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,15 @@
+2009-03-31 14:50 +0200  Rocco Rutte  <pdmef@gmx.net>  (269e3da22cc2)
+
+       * UPDATING, doc/manual.xml.head, mutt.h, pattern.c: Perform case
+       insensitive string search if pattern is lower case
+
+       ...since we do that for regex patterns already. It doesn't work for
+       IMAP server-side searches.
+
+2009-03-31 13:19 +0200  Rocco Rutte  <pdmef@gmx.net>  (6e6c6b9b4b67)
+
+       * ChangeLog, doc/manual.xml.head: Manual: Fix markup of ".muttrc"
+
 2009-03-31 13:11 +0200  Rocco Rutte  <pdmef@gmx.net>  (d258178d0bd5)
 
        * doc/manual.xml.head: Manual: Always spell mutt as "Mutt"

diff --git a/doc/manual.xml.head b/doc/manual.xml.head
index 423251171dde3bbe9cd1b71e6cb8690b56c7c89b..feba75fc5c62bd3949d8e2fe3570212e253aa8a5 100644 (file)
--- a/doc/manual.xml.head
+++ b/doc/manual.xml.head
@@ -6761,7 +6761,7 @@ from most-secure to least-secure.
 If you happen to have accounts on multiple IMAP, POP and/or SMTP servers,
 you may find managing all the authentication settings inconvenient and
 error-prone. The <link linkend="account-hook">account-hook</link> command may help. This hook works like
-<link linkend="folder-hook">folder-hook</link> but is invoked whenever you access a remote mailbox
+<link linkend="folder-hook">folder-hook</link> but is invoked whenever Mutt needs to access a remote mailbox
 (including inside the folder browser), not just when you open the
 mailbox. This includes (for example) polling for new mail, storing Fcc
 messages and saving messages to a folder. As a consequence,
@@ -6782,6 +6782,45 @@ account-hook imap://host2/ 'set tunnel="ssh host2 /usr/libexec/imapd"'
 account-hook smtp://user@host3/ 'set tunnel="ssh host3 /usr/libexec/smtpd"'
 </screen>
 
+<para>
+To manage multiple accounts with, for example, different values of
+<link linkend="record">&dollar;record</link> or sender addresses,
+<link linkend="folder-hook">folder-hook</link>
+has to be be used together with
+the <link linkend="mailboxes">mailboxes</link> command.
+</para>
+
+<example id="ex-multiaccount">
+<title>Managing multiple accounts</title>
+<screen>
+mailboxes imap://user@host1/INBOX
+folder-hook imap://user@host1/ 'set folder=imap://host1/ ; set record=+INBOX/Sent'
+
+mailboxes imap://user@host2/INBOX
+folder-hook imap://user@host2/ 'set folder=imap://host2/ ; set record=+INBOX/Sent'
+</screen>
+</example>
+
+<para>
+In example
+<xref linkend="ex-multiaccount"/> the folders are defined using
+<link linkend="mailboxes">mailboxes</link> so Mutt polls them for new
+mail. Each <link linkend="folder-hook">folder-hook</link> triggers when
+one mailbox below each IMAP account is opened and sets
+<link linkend="folder">&dollar;folder</link> to the account's root
+folder. Next, it sets <link linkend="record">&dollar;record</link> to
+the <emphasis>INBOX/Sent</emphasis> folder below the newly
+set <link linkend="folder">&dollar;folder</link>. Please notice that the
+value the <quote>+</quote>
+<link linkend="shortcuts">mailbox shortcut</link> refers to depends on
+the <emphasis>current</emphasis> value
+of <link linkend="folder">&dollar;folder</link> and therefore has to be set
+separatedly per account. Setting other values
+like <link linkend="from">&dollar;from</link>
+or <link linkend="signature">&dollar;signature</link> is analogous to setting
+<link linkend="record">&dollar;record</link>.
+</para>
+
 </sect1>
 
 <sect1 id="caching">