README for pop3spam
===================

pop3spam is a POP3 client which connects to a POP3 server and deletes
unsolicited mail. It's possible to check for messages that exceed a certain
limit and to scan header lines for special patterns (regular expressions). If a
message has been identified as unsolicited, it can be deleted directly from the
POP3 server without the need to download it first. Eventually your normal
mail-retrieval utility (e.g. fetchmail) can gather all (cleaned) mail as usual.

The program is intended for people with low bandwidth. It's very annoying if
you first have to download lots of large messages just for the sole purpose of
deleting them afterwards because your *local* spam filter debunked them as
spam. It's also annoying to download very large messages (attachments) at all.

For (generic) installation instructions see INSTALL. Note that you need Philip
Hazel's Perl Compatible Regular Expressions (PCRE) library in order to build
pop3spam. See

	ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/

pop3spam doesn't use any hard wired regular expressions so it should basically
work with any recent version.

For information about the configuration and use of pop3spam, take a look at the
man pages pop3spam(1) and pop3spamrc(5). A sample configuration file can be
found in the directory doc/ in the source tree.

The latest version of pop3spam can be found under

	http://www.michnet.de/pop3spam/

See the file COPYING for license terms. The file src/libext.c is covered by
a different license (see this file for further details).

If you have any comments, suggestions, complaints, bug reports, etc. feel
free to contact me via email!

Have fun!

Michael Velten <michael@michnet.de>
