Re: what shows %b?

[TAKAHASHI Tamotsu <ttakah@xxxxxxxxxxxxxxxxx>]

* Thu Apr 27 2006 Rado S <rado@xxxxxxxxxxxxxxxxxxx>

> [=- TAKAHASHI Tamotsu wrote on Fri 28.Apr'06 at  0:27:20 +0900 -=]

> > > WTF hasn't this usage of %-codes in hooks ever been documented?!
> > 
> > Dunno. I guess that's because there are many good FAQ and
> > example muttrc's, including wiki.mutt.org.
> 
> Nah, come on, that's a too important/ useful feature to miss in
> the manual, as "official" source. 3rd party docs (including wiki)
> can't be relied on for "supported" features: it might work now,
> but maybe it's removed/ changed _silently_ in the future.

Okay, here is a patch though I am not good at writing English.
Someone would make a complete patch and commit it if it were
important enough.

-- 
tamo

Index: doc/manual.xml.head
===================================================================
RCS file: /home/roessler/cvs/mutt/doc/manual.xml.head,v
retrieving revision 3.14
diff -p -u -r3.14 manual.xml.head
--- doc/manual.xml.head 30 Mar 2006 19:50:01 -0000      3.14
+++ doc/manual.xml.head 28 Apr 2006 12:10:24 -0000
@@ -2333,17 +2333,28 @@ hdr&lowbar;order From Date: From: To: Cc
 </sect2>
 
 <sect2 id="save-hook">
-<title>Specify default save filename</title>
+<title>Specify default save mailbox</title>
 
 <para>
-Usage: <literal>save-hook</literal> &lsqb;!&rsqb;<emphasis>pattern</emphasis> 
<emphasis>filename</emphasis>
+Usage: <literal>save-hook</literal> &lsqb;!&rsqb;<emphasis>pattern</emphasis> 
<emphasis>mailbox</emphasis>
 </para>
 
 <para>
-This command is used to override the default filename used when saving
-messages.  <emphasis>filename</emphasis> will be used as the default filename 
if the message is
-<emphasis>From:</emphasis> an address matching <emphasis>regexp</emphasis> or 
if you are the author and the
-message is addressed <emphasis>to:</emphasis> something matching 
<emphasis>regexp</emphasis>.
+This command is used to override the default mailbox used when saving
+messages. <emphasis>mailbox</emphasis> will be used as the default
+pathname if the message matches <emphasis>pattern</emphasis>.
+<!--
+Otherwise the default mailbox will be <emphasis>Reply-To:</emphasis>,
+<emphasis>From:</emphasis>, <emphasis>To:</emphasis>, or
+<emphasis>Cc:</emphasis> unless you are the author.
+If you are the author of the message, the default will be
+<emphasis>To:</emphasis> or <emphasis>Cc:</emphasis>.
+-->
+</para>
+
+<para>
+<emphasis>mailbox</emphasis> may contain &percnt;-sequences like
+<link linkend="index-format">&dollar;index&lowbar;format</link>.
 </para>
 
 <para>
@@ -2359,6 +2370,7 @@ Examples:
 <screen>
 save-hook me@(turing\\.)?cs\\.hmc\\.edu$ +elkins
 save-hook aol\\.com$ +spam
+save-hook ~l +%B
 </screen>
 
 </para>
@@ -2385,6 +2397,11 @@ to <link linkend="record">&dollar;record
 </para>
 
 <para>
+<emphasis>mailbox</emphasis> can contain &percnt;-sequences like
+<link linkend="index-format">&dollar;index&lowbar;format</link>.
+</para>
+
+<para>
 See <xref linkend="pattern-hook"/> for information on the exact format of 
<emphasis>pattern</emphasis>.
 </para>