3.11 Filter Folder

A folder to access virtual folder which collects all messages that satisfy a condition.

Format:

`/' condition `/' target-folder

In the condition part, you can specify following.

1. Partial filter: `first:number', `last:number'

   first: number messages are picked from top of folder. last: number messages are picked from bottom of folder.

   Example:

   /last:10/-fj.os.linux -> Latest 10 messages from -fj.os.linux are picked. /first:20/%inbox -> First 20 messages from %inbox are picked.

2. Date filter: `since:date', `before:date'

   since: only messages arrived since date are picked (date is included). before: only messages arrived before date are picked (date is not included).

   You can specify following as date.

   yesterday -> a day before today. lastweek -> same day of last week. lastmonth -> same day of last month. lastyear -> same day of last year. numberdaysago -> number days ago. (e.x. '3daysago') day-month-year -> specify date directly (ex. 1-Nov-1998)

   Example:

   /since:3daysago/+inbox -> messages arrived since 3 days ago in +inbox are picked. /before:yesterday/+inbox -> messages arrived before yesterday in +inbox are picked.

3. Field filter: `field:value'

   All messages that have field and its value is value are picked. field and value are case insensitive.

   Example:

   /from:teranisi/+inbox -> In +inbox, messages which have From: field and its value includes "teranisi" string are picked. /body:foo/%inbox -> In %inbox, messages which have "foo" text are picked.

4. Flag filter: `flag:flag-name'

   Pick up messages with flag specified by flag-name.

   You can specify following flag names:

   unread -> unread important -> important answered -> replied forwarded -> forwarded digest -> unread or important any -> unread or replied or forwarded or global-flag.

   You can also use flags which you have set as `global-flag'. global-flag is a flag which has arbitrary name. You can put global-flag on messages by invoking wl-summary-set-flags (Key F). By default, `important' flag is prepared. You can view messages with global-flag by visiting the subfolder of `'flag' folder.

   See section 3.13 Internal folder.

   Example:

   /flag:digest/%inbox -> a folder consist of unread or important message in %inbox. /flag:wl/+ML/Wanderlust -> a folder consist of messages with global flag wl in +ML/Wanderlust.

5. Compound condition

   A condition starting with `!' indicates a negation. If you combine conditions by character `|', it is considered as OR condition. `&' is considered as AND condition, likewise. Condition can be grouped by parentheses (`(', and `)').

   `/tocc:xxxx/' is an abbreviation of `/to:xxxx|cc:xxxx/'. `/!tocc:xxxx/' is an abbreviation of `/!to:xxxx&!cc:xxxx/'.

   Example:

   /from:teranisi&!to:teranisi/+inbox -> In +inbox, messages are picked if the message's From: field includes "teranisi" and To: field doesn't include "teranisi". /tocc:"Yuuichi Teranishi"/+inbox -> In +inbox, messages are picked if the message's To: field or Cc: field includes "Yuuichi Teranishi". /(from:yt|from:teranisi)&subject:report/+inbox -> In +inbox, messages are picked if the message's From: field includes "yt" or "teranisi", and Subject includes "report".

Tip for string description:

Space character, `"', `/',`)',`|' and `&' should be enclosed with `"' in value string. (`"' should be escaped with `\' in it). You can enclose the string with `"' even it does not contain these characters.

Advanced example:

*%inbox,/from:teranisi/%inbox@server
       -> Messages in %inbox or
          message is in the %inbox@server folder and it's From field
          includes "teranisi" are collected.

/last:100//to:teranisi/*+inbox,%inbox
       -> Latest 100 messages which is in the +inbox or %inbox folder
          and To: field matches "teranisi".

/from:hogehoge//last:20//tocc:teranisi/%#mh/inbox@localhost
       -> Pick messages which have From: field and it includes "hogehoge"
          from latest 20 messages in the %#mh/inbox@localhost
          and To: or Cc: field includes "teranisi".