| 1 |
README for "filter v2.6", the email filtering program originally from ELM |
| 2 |
|
| 3 |
|
| 4 |
This program is designed to look at each piece of email you get "locally", |
| 5 |
and separate it off into different "mail folders". |
| 6 |
It relies on you being able to create a $HOME/.forward file, or equivalent, |
| 7 |
that lets you "pipe" incoming email to a filter program. |
| 8 |
It takes action based on rules you put in $HOME/.filter/filter-rules. |
| 9 |
(NOTE: UNIX-style 'mail folders' are actually text files!!!) |
| 10 |
Those "folders" can normally then be read by the same program you normally |
| 11 |
read your email with. |
| 12 |
|
| 13 |
|
| 14 |
Why use 'filter', not 'procmail' ? Because procmail is too arcane. |
| 15 |
It's kind of a "why use pico, when there's emacs?" thing. |
| 16 |
I like to use actual english in config files whenever possible, so filter |
| 17 |
is definately MY choice of email filtering programs. |
| 18 |
|
| 19 |
See the manpage, or other stuff in the 'doc' subdirectory, for more details. |
| 20 |
|
| 21 |
|
| 22 |
Philip Brown |
| 23 |
[email protected] |
| 24 |
October 2003 |
| 25 |
|
| 26 |
It only gets better, if YOU ask for stuff! |
| 27 |
|
| 28 |
------------------------------------------------------------ |
| 29 |
------------------------------------------------------------ |
| 30 |
|
| 31 |
Safety note: If you are unsure of what you are doing, or just paranoid, you |
| 32 |
should hook filter into your email, by creating the file $HOME/.forward |
| 33 |
and putting in it |
| 34 |
|
| 35 |
/path/to/safetymbox,"|filter" |
| 36 |
|
| 37 |
|
| 38 |
"normally", you would just put "|filter", to pass all email to the filter |
| 39 |
program. But this also saves all email you receive, to whatever safetymbox |
| 40 |
you define. Be sure to clean it out regularly! |
| 41 |
|
| 42 |
Also, you should periodically clean out your filter logfile. It keeps a log of |
| 43 |
all email it sees, in $HOME/.filter/filter-log |
| 44 |
|
| 45 |
"filter -S" will summarise the logfile for you. |
| 46 |
"filter -c -s" will clean out the logfile. |
| 47 |
YOU MUST HAVE -s with -c !!! |
| 48 |
|
| 49 |
You might want to glance at the BUGS file, also. |
| 50 |
|