From: Rocco Rutte Date: Thu, 19 Mar 2009 16:19:44 +0000 (+0100) Subject: Improve section on patterns X-Git-Tag: neomutt-20160307~742 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=0be59041abac3fd31ab519ff489e190d9d784a38;p=neomutt Improve section on patterns --- diff --git a/ChangeLog b/ChangeLog index 73e5c9613..735b55988 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,15 @@ +2009-03-19 16:47 +0100 Rocco Rutte (de835501d8db) + + * curs_lib.c: Fix progress update debug message + +2009-03-19 15:35 +0100 Rocco Rutte (acfaa2273124) + + * ChangeLog, doc/manual.xml.head, doc/muttrc.man.head: Document kilo + and mega suffixes for range patterns + + Document it only for ~z (message size) as they don't make much sense + for other patterns like message score or number of attachments. + 2009-03-18 17:40 +0100 Rocco Rutte (8528b8e715da) * init.h: Properly initialize more structs diff --git a/doc/manual.xml.head b/doc/manual.xml.head index 31ae6b7e5..8bb02c427 100644 --- a/doc/manual.xml.head +++ b/doc/manual.xml.head @@ -4187,6 +4187,9 @@ they may or may not be available in stock libraries on various systems. Patterns: Searching, Limiting and Tagging + +Pattern Modifier + Many of Mutt's commands allow you to specify a pattern to match (limit, tag-pattern, @@ -4258,7 +4261,21 @@ threads containing messages from you: ~(~P) Where EXPR is a -regular expression. Special attention has to be +regular expression. + + + +*) The forms <[MAX], >[MIN], +[MIN]- and -[MAX] +are allowed, too. + + + +**) The suffixes K and M are allowed to specify kilobyte and megabyte respectively. + + + +Special attention has to be made when using regular expressions inside of patterns. Specifically, Mutt's parser for these patterns will strip one level of backslash (\), which is normally used for quoting. If it is your intention to use a @@ -4270,48 +4287,36 @@ the literal string *.*. Simple string matches are less powerful t regular expressions but can be considerably faster. This is especially true for IMAP folders, because string matches can be performed on the server instead of by fetching every message. IMAP treats =h specially: -it must be of the form "header: substring" and will not partially +it must be of the form header: substring and will not partially match header names. The substring part may be omitted if you simply wish to find messages containing a particular header without regard to its value. -*) The forms <[MAX], >[MIN], -[MIN]- and -[MAX] -are allowed, too. - - - -**) The suffixes K and M are allowed to specify kilobyte and megabyte respectively. - - - -Pattern Modifier - - - -Note that patterns matching 'lists' of addresses (notably c, C, p, P and t) +Patterns matching lists of addresses (notably c, C, p, P and t) match if there is at least one match in the whole list. If you want to make sure that all elements of that list match, you need to prefix your pattern with ˆ. This example matches all mails which only has recipients from Germany. - + +Matching all addresses in address lists ^~C \.de$ + - -Simple Patterns + +Simple Searches -Mutt supports two versions of so called simple searches which are +Mutt supports two versions of so called simple searches. These are issued if the query entered for searching, limiting and similar -operations does not seem to be a valid pattern (i.e. it does not contain +operations does not seem contain a valid pattern modifier (i.e. it does not contain one of these characters: ˜, = or %). If the query is supposed to contain one of these special characters, they must be escaped by prepending a backslash (\). @@ -4361,7 +4366,7 @@ for the composed complex query. -Complex Patterns +Nesting and Boolean Operators Logical AND is performed by specifying more than one criterion. For