aboutsummaryrefslogtreecommitdiffstats
path: root/doc/C/usage-mail.sgml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/C/usage-mail.sgml')
-rw-r--r--doc/C/usage-mail.sgml154
1 files changed, 92 insertions, 62 deletions
diff --git a/doc/C/usage-mail.sgml b/doc/C/usage-mail.sgml
index c06259ad17..9184b77b82 100644
--- a/doc/C/usage-mail.sgml
+++ b/doc/C/usage-mail.sgml
@@ -1009,9 +1009,10 @@ possibly never will be due to security evil. -->
The <interface>filter assistant</interface> window contains a
list of your current filters, sorted by the order in which
they will be performed. From the drop-down box at the top of
- the window, choose whether to display all your filters, only
- those filters which are performed on incoming mail, or only
- filters for outgoing mail.
+ the window, choose <guilabel>Incoming</guilabel> to display
+ those filters which are performed on incoming mail, and
+ <guilabel>On Demand</guilabel> for those which are performed
+ only when you want.
</para>
<para>
The <interface>filter assistant</interface> also has a set of
@@ -1030,10 +1031,9 @@ possibly never will be due to security evil. -->
<guibutton>Delete</guibutton> &mdash; Delete the selected filter.
</para></listitem>
- <listitem><para>
- <guibutton>Up</guibutton> &mdash; Move the selected filter up in the list,
- so it will be performed sooner.
- </para></listitem>
+ <listitem><para> <guibutton>Up</guibutton> &mdash; Move the
+ selected filter up in the list, so it will be performed
+ sooner. </para></listitem>
<listitem><para>
<guibutton>Down</guibutton> &mdash; Move the selected filter down
@@ -1041,10 +1041,11 @@ possibly never will be due to security evil. -->
</para></listitem>
</itemizedlist>
- If you don't have any filters set up, the only one you can
- click is <guibutton>Add</guibutton>. When you do that, (or
- when you click <guibutton>Edit</guibutton> with a filter
- selected), the <interface>Add Rule</interface> window appears.
+ If you don't have any filters set up, the only one of those
+ buttons you can click is <guibutton>Add</guibutton>. When you
+ do that, (or when you click <guibutton>Edit</guibutton> with a
+ filter selected), the <interface>Add Rule</interface> window
+ appears.
</para>
<para>
That window, shown in <xref
@@ -1061,17 +1062,14 @@ possibly never will be due to security evil. -->
</figure>
</para>
<para>
- Enter a name for your filter in the <guilabel>Name</guilabel>
- field, and then begin choosing criteria. Choose how many
- criteria you'd like by pressing <guibutton>More</guibutton>
- and <guibutton>Fewer</guibutton>. You can choose from five
- types of criteria, and you can have as many as you like; at
- least, I've never found a maximum. If you have multiple
- criteria, you'll want to decide between <guilabel>Match all
- parts</guilabel>, which will make the filter affect only those
- messages which meet all the criteria you're about to describe,
- and <guilabel>Match any part</guilabel>, which will make the
- filter affect any message that meets even one of the criteria.
+ Enter a name for your filter in the <guilabel>Rule
+ Name</guilabel> field, and then begin choosing criteria.
+ Choose how many criteria you'd like by pressing <guibutton>Add
+ Criterion</guibutton> and <guibutton>Remove
+ Criterion</guibutton>. If you have multiple criteria, you
+ should then decide whether to have the filter do its job only
+ <guilabel>if all criteria are met</guilabel>, or <guilabel>if
+ any criteria are met</guilabel>.
</para>
<para>
For each of your filter criteria, you must first select what
@@ -1098,56 +1096,75 @@ possibly never will be due to security evil. -->
</para></listitem>
</varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Specific Header</guilabel></term>
+ <listitem><para> The filter can look at any header you
+ want, even obscure or custom ones like X-Bonus or
+ X-Archive. Enter the header name, and what you'd like to
+ match inside it. </para></listitem>
+ </varlistentry>
+
<varlistentry>
<term><guilabel>Message Body</guilabel></term>
<listitem><para>
- The message body.
+ The actual text of the message.
</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Expression</guilabel></term>
+ <listitem><para> Enter a <glossterm
+ linkend="regular-expression">regular
+ expression</glossterm>, and
+ <application>Evolution</application> will search the
+ entire message, headers and all, to match it for you.
+ </para></listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term><guilabel>Date Sent</guilabel></term>
<listitem><para>
- Enter a <glossterm linkend="regular-expression">regular expression</glossterm>, and
- <application>Evolution</application> will match it for
- you.
- </para></listitem>
+ You can filter messages by when they were sent: First,
+ choose how you'd like to match the time&mdash;
+ <guilabel>before</guilabel>,
+ <guilabel>after</guilabel> and so forth. Then, choose
+ the time. The filter compare the message's time-stamp
+ to the system clock when the filter is run, or to a
+ specific time and date you choose from a calendar.
+ You can even have it look for messages within a range
+ of time relative to the filter. For example, you could have
+ the filter catch all messages sent less
+ than a week before the filter is run.
+ </para></listitem>
</varlistentry>
- </variablelist>
- </para>
- <para>
- Then choose a rule for matching:
- <variablelist>
+
<varlistentry>
- <term><guilabel>Contains</guilabel></term>
+ <term><guilabel>Date Recieved</guilabel></term>
<listitem><para>
- If the part of the message examined contains the text you enter,
- the filter will perform its selected action.
+ This works the same way as the <guilabel>Date Sent</guilabel>
+ option, except that it compares the time you got the message
+ with the dates you specify.
</para></listitem>
</varlistentry>
<varlistentry>
- <term><guilabel>Does not contain</guilabel></term>
+ <term><guilabel>Priority</guilabel></term>
<listitem><para>
- If the part of the message examined does not contain
- the text you enter,
- the filter will perform its selected action.
+ Emails have a standard priority range from -3 (least
+ important) to 3 (most important). If you can persuade
+ your friends and co-workers to use the priority levels
+ honestly, you can filter with them as well.
</para></listitem>
</varlistentry>
</variablelist>
-
</para>
- <para>
- Then, enter the text you want the filter to find, and you're
- done telling <application>Evolution</application> what sort of
- messages you want it to filter.
- </para>
-
- <para>
+ <para>
Now, tell it what to do with those messages. If you want multiple
- actions, click <guibutton>More</guibutton>; if you want fewer,
- click <guibutton>Fewer</guibutton>. And choose again:
+ actions, click <guibutton>Add Action</guibutton>; if you want fewer,
+ click <guibutton>Remove Action</guibutton>. And choose again:
<variablelist>
<varlistentry>
<term><guilabel>Move to Folder</guilabel></term>
@@ -1191,6 +1208,16 @@ possibly never will be due to security evil. -->
will mark the message with whatever color you please.
</para></listitem>
</varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Assign Score</guilabel></term>
+ <listitem><para> Priority numbers alone don't work, so you
+ can score emails on the same scale. Then, you can tell
+ which ones you want to read, or have scored messages
+ moved, copied, or colored in a subsequent filter.
+ </para></listitem>
+ </varlistentry>
+
</variablelist>
</para>
<para>
@@ -1307,18 +1334,18 @@ possibly never will be due to security evil. -->
<!-- (INSERT SCREENSHOT HERE: vFolders in action) -->
<para>
- To create a vFolder, select <guimenuitem>vFolder
- Editor</guimenuitem> from the <guimenu>Tools</guimenu>
- menu in the <interface>main window</interface>. This
- will bring up a dialog box that looks suspiciously like
- the Filter Assistant (for more information on filters, see
- <xref linkend="usage-mail-organize-filters">), and which
+ To create a vFolder, select <menuchoice>
+ <guimenu>Tools</guimenu> <guimenuitem>vFolder
+ Editor</guimenuitem> </menuchoice>. This will bring up a
+ dialog box that looks suspiciously like the filter window
+ (for more information on filters, see <xref
+ linkend="usage-mail-organize-filters">), and which
presents you with a list of vFolders you have previously
- created. If you have already created vFolders, you can
- click on them in the frame labelled <guilabel>Select Rule
- Type</guilabel>, and edit or remove them. If you have
- not created any, there will be only one available option:
- click <guibutton>Add</guibutton> to add a new vFolder.
+ created. If you have created any vFolders, they are listed
+ here, and you can select, edit or remove them if you wish.
+ If you have not created any, there will be only one available
+ option: click <guibutton>Add</guibutton> to add a new
+ vFolder.
</para>
<para>
You can enter a name for your vFolder in the
@@ -1328,7 +1355,9 @@ possibly never will be due to security evil. -->
between <guilabel>Match all parts</guilabel> and
<guilabel>Match any part</guilabel>, then choose what part of
the message to look in, what sort of matching to perform, and
- specify exactly what text it is that you want to find.
+ specify exactly what it is that you want to find, be it a
+ line of text, a score, a regular expression, or a particular date or
+ range of dates.
</para>
<para>
The second part, however, is slightly different. In the
@@ -1356,4 +1385,5 @@ possibly never will be due to security evil. -->
</para>
</sect2>
</sect1>
-</chapter> \ No newline at end of file
+</chapter>
+