changeset: 6426:aac979f8b529
user:      Kevin McCarthy <ke...@8t8.us>
date:      Tue Mar 17 16:28:54 2015 -0700
link:      http://dev.mutt.org/hg/mutt/rev/aac979f8b529

Clarify hook documentation to specify regexp instead of pattern.

Account-hook, crypt-hook, and mbox-hook accept a regexp parameter, not a
pattern.

changeset: 6427:ab101844dc07
user:      Kevin McCarthy <ke...@8t8.us>
date:      Tue Mar 17 16:28:56 2015 -0700
link:      http://dev.mutt.org/hg/mutt/rev/ab101844dc07

Add entries for =B and =h in pattern modifier table.

Since these operate differently for IMAP, it's worth adding explicit
entries to the table for these two.

changeset: 6428:59bd9030e898
user:      Kevin McCarthy <ke...@8t8.us>
date:      Tue Mar 17 16:28:56 2015 -0700
link:      http://dev.mutt.org/hg/mutt/rev/59bd9030e898

Document limitation of color index and server-side searches. (see #3723)

diffs (84 lines):

diff -r 09be71b645a7 -r 59bd9030e898 doc/manual.xml.head
--- a/doc/manual.xml.head       Wed Mar 04 19:24:31 2015 -0800
+++ b/doc/manual.xml.head       Tue Mar 17 16:28:56 2015 -0700
@@ -2628,7 +2628,9 @@
 <emphasis>header</emphasis> and <emphasis>body</emphasis> match
 <emphasis>regexp</emphasis> in the header/body of a message,
 <emphasis>index</emphasis> matches <emphasis>pattern</emphasis> (see
-<xref linkend="patterns"/>) in the message index.
+<xref linkend="patterns"/>) in the message index.  Note that IMAP
+server-side searches (=b, =B, =h) are not supported for color index
+patterns.
 </para>
 
 <para>
@@ -3175,7 +3177,7 @@
 <cmdsynopsis>
 <command>mbox-hook</command>
 <arg choice="plain">
-<replaceable class="parameter">[!]pattern</replaceable>
+<replaceable class="parameter">[!]regexp</replaceable>
 </arg>
 <arg choice="plain">
 <replaceable class="parameter">mailbox</replaceable>
@@ -3185,7 +3187,7 @@
 <para>
 This command is used to move read messages from a specified mailbox to a
 different mailbox automatically when you quit or change folders.
-<emphasis>pattern</emphasis> is a regular expression specifying the
+<emphasis>regexp</emphasis> is a regular expression specifying the
 mailbox to treat as a <quote>spool</quote> mailbox and
 <emphasis>mailbox</emphasis> specifies where mail should be saved when
 read.
@@ -3193,7 +3195,7 @@
 
 <para>
 Unlike some of the other <emphasis>hook</emphasis> commands, only the
-<emphasis>first</emphasis> matching pattern is used (it is not possible
+<emphasis>first</emphasis> matching regexp is used (it is not possible
 to save read mail in more than a single mailbox).
 </para>
 
@@ -3409,7 +3411,7 @@
 <para>
 This command is used to save outgoing mail in a mailbox other than <link
 linkend="record">$record</link>.  Mutt searches the initial list of
-message recipients for the first matching <emphasis>regexp</emphasis>
+message recipients for the first matching <emphasis>pattern</emphasis>
 and uses <emphasis>mailbox</emphasis> as the default Fcc: mailbox.  If
 no match is found the message will be saved to <link
 linkend="record">$record</link> mailbox.
@@ -3616,7 +3618,7 @@
 <cmdsynopsis>
 <command>crypt-hook</command>
 <arg choice="plain">
-<replaceable class="parameter">pattern</replaceable>
+<replaceable class="parameter">regexp</replaceable>
 </arg>
 <arg choice="plain">
 <replaceable class="parameter">keyid</replaceable>
@@ -4968,6 +4970,7 @@
 <row><entry>~b <emphasis>EXPR</emphasis></entry><entry>messages which contain 
<emphasis>EXPR</emphasis> in the message body</entry></row>
 <row><entry>=b <emphasis>STRING</emphasis></entry><entry>messages which 
contain <emphasis>STRING</emphasis> in the message body. If IMAP is enabled, 
searches for <emphasis>STRING</emphasis> on the server, rather than downloading 
each message and searching it locally.</entry></row>
 <row><entry>~B <emphasis>EXPR</emphasis></entry><entry>messages which contain 
<emphasis>EXPR</emphasis> in the whole message</entry></row>
+<row><entry>=B <emphasis>STRING</emphasis></entry><entry>messages which 
contain <emphasis>STRING</emphasis> in the whole message. If IMAP is enabled, 
searches for <emphasis>STRING</emphasis> on the server, rather than downloading 
each message and searching it locally.</entry></row>
 <row><entry>~c <emphasis>EXPR</emphasis></entry><entry>messages carbon-copied 
to <emphasis>EXPR</emphasis></entry></row>
 <row><entry>%c <emphasis>GROUP</emphasis></entry><entry>messages carbon-copied 
to any member of <emphasis>GROUP</emphasis></entry></row>
 <row><entry>~C <emphasis>EXPR</emphasis></entry><entry>messages either to: or 
cc: <emphasis>EXPR</emphasis></entry></row>
@@ -4983,6 +4986,7 @@
 <row><entry>~g</entry><entry>cryptographically signed messages</entry></row>
 <row><entry>~G</entry><entry>cryptographically encrypted messages</entry></row>
 <row><entry>~h <emphasis>EXPR</emphasis></entry><entry>messages which contain 
<emphasis>EXPR</emphasis> in the message header</entry></row>
+<row><entry>=h <emphasis>STRING</emphasis></entry><entry>messages which 
contain <emphasis>STRING</emphasis> in the message header. If IMAP is enabled, 
searches for <emphasis>STRING</emphasis> on the server, rather than downloading 
each message and searching it locally; <emphasis>STRING</emphasis> must be of 
the form <quote>header: substring</quote> (see below).</entry></row>
 <row><entry>~H <emphasis>EXPR</emphasis></entry><entry>messages with a spam 
attribute matching <emphasis>EXPR</emphasis></entry></row>
 <row><entry>~i <emphasis>EXPR</emphasis></entry><entry>messages which match 
<emphasis>EXPR</emphasis> in the <quote>Message-ID</quote> field</entry></row>
 <row><entry>~k</entry><entry>messages which contain PGP key 
material</entry></row>
@@ -7656,7 +7660,7 @@
 <cmdsynopsis>
 <command>account-hook</command>
 <arg choice="plain">
-<replaceable class="parameter">pattern</replaceable>
+<replaceable class="parameter">regexp</replaceable>
 </arg>
 <arg choice="plain">
 <replaceable class="parameter">command</replaceable>

Reply via email to