aboutsummaryrefslogtreecommitdiffstats
path: root/help
diff options
context:
space:
mode:
authorAaron Weber <aaron@ximian.com>2002-12-07 04:50:39 +0800
committerAaron Weber <aaron@src.gnome.org>2002-12-07 04:50:39 +0800
commit2dd2e06fc2ae1205d0e1913bb33ce5d5c6e28925 (patch)
tree979dcc7bb03fc7e02ee53c875233855f4e0a98f2 /help
parent7bb980e76d7207855e87ffefbffaa304dd779372 (diff)
downloadgsoc2013-evolution-2dd2e06fc2ae1205d0e1913bb33ce5d5c6e28925.tar
gsoc2013-evolution-2dd2e06fc2ae1205d0e1913bb33ce5d5c6e28925.tar.gz
gsoc2013-evolution-2dd2e06fc2ae1205d0e1913bb33ce5d5c6e28925.tar.bz2
gsoc2013-evolution-2dd2e06fc2ae1205d0e1913bb33ce5d5c6e28925.tar.lz
gsoc2013-evolution-2dd2e06fc2ae1205d0e1913bb33ce5d5c6e28925.tar.xz
gsoc2013-evolution-2dd2e06fc2ae1205d0e1913bb33ce5d5c6e28925.tar.zst
gsoc2013-evolution-2dd2e06fc2ae1205d0e1913bb33ce5d5c6e28925.zip
add spam filtering help.
2002-12-06 Aaron Weber <aaron@ximian.com> * C/usage-mail-org.xml: add spam filtering help. svn path=/trunk/; revision=19044
Diffstat (limited to 'help')
-rw-r--r--help/C/config-prefs.xml2
-rw-r--r--help/C/usage-mail-org.xml169
2 files changed, 132 insertions, 39 deletions
diff --git a/help/C/config-prefs.xml b/help/C/config-prefs.xml
index ab1af1bb0d..03a78ab0a5 100644
--- a/help/C/config-prefs.xml
+++ b/help/C/config-prefs.xml
@@ -435,7 +435,7 @@ smtp.omniport.com:143
linkend="usage-mail-getnsend-get-attach-html"/>.
</para>
<para>
- To hange the font which <application>Ximian
+ To change the font which <application>Ximian
Evolution</application> uses to display mail, do the
following:
<orderedlist numeration="arabic">
diff --git a/help/C/usage-mail-org.xml b/help/C/usage-mail-org.xml
index bb21abcf17..3b992a4bbd 100644
--- a/help/C/usage-mail-org.xml
+++ b/help/C/usage-mail-org.xml
@@ -702,18 +702,6 @@
<note id="when-filters-go-wrong">
<title>When Are Filters Applied?</title>
<para>
- If you move mail from your server into your local system
- using POP mail, filters are applied to incoming mail every
- time you check for mail.
- </para>
- <para>
- If you store your mail on the mail server and check your
- mail with IMAP, filters are applied to the INBOX when you
- open it. In some cases, you will see a number of unread
- messages in the INBOX, click the INBOX, and then have the
- messages move elsewhere as they are filtered out.
- </para>
- <para>
If you use Ximian Connector to store your mail on an
Exchange server, filters are not applied until you open
your INBOX folder and select
@@ -722,22 +710,34 @@
<keycombo><keycap>Ctrl</keycap><keycap>Y</keycap></keycombo>
</para>
</note>
+
<example id="filter-example">
<title>Using a Filter to Avoid Spam</title>
<para>
- A good deal of bulk mail is eventually tagged with the
- <computeroutput>Precedence: Bulk</computeroutput> header at
- one point or another. Not all of it is, of course, and
- there are "good" messages (mailing lists you subscribe to,
- for example) that are also considered "Bulk" mail.
- However, if you filter out all the mail with that header,
- you'll catch a lot of the mail you don't want to get.
+ Spam, also known as unsolicited commercial email (UCE), is
+ the bane of many email boxes, but it doesn't have to
+ be. Using Ximian Evolution filters and an external Spam
+ detection tool like SpamAssassin (<ulink
+ url="http://spamassassin.org/">http://spamassassin.org/</ulink>),
+ you can catch the vast majority of junk mail and drop it
+ directly into the trash.
+ </para>
+ <para>
+ The easiest way to do this is to get your system
+ administrator to install SpamAssassin (or its equivalent)
+ on your mail server. There, it will flag messages it
+ suspects of being Spam with the "X-Spam-Status" header to
+ your mail, which you can then search for in a
+ filter. Because SpamAssassin scores mails based on the
+ likelyhood that messages are junk, you can even choose how
+ strict you want it to be. If you don't have a friendly
+ network administrator, never fear: you can install
+ SpamAssassin on your own system, then pipe messages through
+ it before reading them.
</para>
-
<para>
- To catch them and automatically mark them for deletion, do
- the following:
+ If your system administrator or ISP has SpamAssassin, here's how to siphon off the junk mail:
<orderedlist>
<listitem><para>
@@ -745,15 +745,15 @@
</para></listitem>
<listitem><para>
- Click <guibutton>New</guibutton>.
+ Click <guibutton>Add</guibutton>.
</para></listitem>
<listitem><para>
- Set the first part of your search critera to look in a <guilabel>Specific header</guilabel>.
+ Set the first part of your search criterion to look in a <guilabel>Specific header</guilabel>.
</para></listitem>
<listitem><para>
- Enter <userinput>Precedence</userinput> as the name of the header.
+ Enter <userinput>X-Spam-Flag</userinput> as the name of the header.
</para></listitem>
<listitem><para>
@@ -761,31 +761,124 @@
</para></listitem>
<listitem><para>
- Enter <userinput>Bulk</userinput> as the content to search for.
- You're now working with all email that has the word "Bulk" in the
- "Precedence" header.
+ Enter <userinput>YES</userinput> as the content to search for.
+ You're now working with all email that has the word "YES" in the
+ "X-Spam-Status" header.
</para></listitem>
<listitem><para>
- For actions, select "Move to Folder" and choose the
- folder where you'd like to place bulk mail.
+ For actions, choose what you'd like to do with the
+ messages. You can delete the messages automatically, but
+ it's more prudent to place them in a "Possible Junk Mail"
+ folder, and check them over just to make sure a genuine
+ message didn't get flagged by accident.
</para></listitem>
- <listitem><para> If you like, add another action and
- choose <guilabel>Delete</guilabel>.
- </para></listitem>
-
<listitem><para>
Click OK. You're done.
</para></listitem>
</orderedlist>
</para>
- </example>
- </sect2>
+ <para>
+ If you don't have SpamAssassin or other junk mail filtering
+ on your mail server, there's still hope, although it's not
+ quite as simple. First, download
+ and install SpamAssassin from <ulink
+ url="http://spamassassin.org">http://spamassassin.org</ulink>. Instructions
+ for installation are on the site; you'll need to download the "spamassassin"
+ and "perl-Mail-SpamAssassin"
+ packages. You can install them with Red Carpet by selecting
+ <guimenuitem>Install Local Packages</guimenuitem> from the
+ <guimenu>File</guimenu> menu.) Once you have the software
+ installed, do the following:
+ <orderedlist>
+ <listitem>
+ <para>
+ Open a new create a text file with any text editor (
+ <menuchoice>
+ <guimenu>
+ Programs
+ </guimenu>
+ <guisubmenu>
+ Accessories
+ </guisubmenu>
+ <guimenuitem>
+ Text Editor
+ </guimenuitem>
+ </menuchoice> is the most convenient) and paste in the following:
+ <screen>
+ spamassassin -e &lt;
+ </screen>
+ This will run the SpamAssassin command and report back 0
+ if the message is not junk.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Create a directory called "bin" in your home directory, and save the file there as "spam-filter.sh"
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Mark the file as an executable program:
+ Open your home directory in Nautilus, right click on
+ filterscript.sh there, and select
+ <guimenuitem>Properties</guimenuitem>. Then, click the
+ "Permissions" tab and check the box in the
+ <guilabel>Execute</guilabel> column and the
+ <guilabel>Owner</guilabel> row. Alternately, open a terminal
+ (<menuchoice>
+ <guimenu>
+ Programs
+ </guimenu>
+ <guisubmenu>
+ Accessories
+ </guisubmenu>
+ <guimenuitem>
+ Terminal
+ </guimenuitem>
+ </menuchoice>) and enter the command: chmod +x bin/spam-filter.sh.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Back in Evolution, create a new filter: Select
+ <menuchoice><guimenu>Tools</guimenu><guimenuitem>Filters</guimenuitem></menuchoice>,
+ then click <guibutton>Add</guibutton>.
+ </para>
+ </listitem>
-
- <sect2 id="filters-edit">
+ <listitem><para>
+ Select "Pipe Message to Shell Command" as the first portion of the criterion.
+ </para></listitem>
+
+ <listitem><para>
+ Enter "/home/username/bin/spam-filter.sh" as the shell command, then select
+ "Does Not Return" and "0" as the remaining two
+ items. Substitute your username for "username" so that
+ Evolution can find the script.
+ </para></listitem>
+
+ <listitem><para>
+ For actions, choose what you'd like to do with the
+ messages. You can delete the messages automatically, but
+ it's more prudent to place them in a "Possible Junk Mail"
+ folder, and check them over just to make sure a genuine
+ message didn't get flagged by accident.
+ </para></listitem>
+ <listitem>
+ <para>
+ You're done. Click "OK" to close the filter and "OK" to
+ close the filter editor.
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </example>
+ </sect2>
+
+ <sect2 id="filters-edit">
<title>Editing Filters</title>
<para>
To edit a filter: