Bogofilter 1.1.2
a fast Bayesian spam filter 
for OS/2 and eComStation
===========================================
02/Dec/2006 - Yuri Dario <mc6530@mclink.it>


General:
--------
This is the OS/2 port of BogoFilter, a fast spam filter: this package provides
only basic stuffs to get it working (this means you have to edit scripts and read
docs before getting it to work).

NEW With 0.95.2 BerkeleyDB has been replaced with Sqlite backend to allow transaction
recovery: wordlist must be exported with old version (bogoutil -d) and reimported 
with the new bogoutil (bogoutil -l).

Starting with 0.14.xxx, the single wordlist database is the default option; if
you have two distinct databases, it is possible to continue working with them, or
merge them into a single database. It is preferred to work with a single database,
since this fixes some issues with database locking when many bogofilter processes
are simultaneous running.
To merge databases, plese use the supplied bin/merge.cmd: you need also some gnu
utilities (cat, awk, sort) and some editing of the cmd file to meet your enviroment
(if you can make a better script, please mail it to me and I will include it in
future releases).

NEW: with 0.15.xxx, header parsing has changed: use -H (check documentation)
     or retrain your database.

Included here is also the script/instructions for using BogoFilter with InetPowerServer;
other people are using it successfully with other OS/2 smtp servers.

Two training scripts are provided for training BogoFilter using PMMail messages; also
these scripts need editing to adapt to your installation.

Please read documentation at http://bogofilter.sourceforge.net included in the
distribution source code package.


Contribs:
---------
Included are some rexx command files for database merge, cleanup and training.
Code is partially taken from other scripts/utilities. Feel free to change and post
me changes. 


InetPowerServer install:
------------------------
Place bogofilter.rexx into your ips\scripts\smtp directory, modify BOGOFILTER_DIR
and add onData hook in your ips\config\main\main.cfg [SMTP-1] section (adjust
on your real configuration).
Two scripts are provided for initial training, keep in mind that databases are
saved into your $HOME if BOGOFILTER_DIR is not present in the current enviroment.

Create a new user named bogofilter (see ips\bogofilter for sample) with the
following aliases:
spam		(send here wrong spam messages)
nonspam		(send here wrong non-spam messages)
register-spam	(send to register new spam messages)
register-nonspam (send to register new non-spam messages)

Add EnableEMXCompatibility=1 to your ips\config\ips.cfg in [GLOBAL] section.


Requirements:
-------------
Innotek LIBC 0.6csd1: ftp://ftp.netlabs.org/pub/gcc/libc-0.6.1-csd1.zip


Building:
---------
(build sqllite)
apply patches
edit configure.os2 for your paths
sh -c configure.os2
convert src\tests\inputs and src\tests\outputs to CRLF (zip -ml x * & unzip x & del x.zip)
run make
run make check (needs gnu util sort utility in your path, not OS/2 one)
run make install


Support
-------
Since this is a OpenSource freeware product there are no
formal support options available.


Donations
---------
Since this software is ported for free, donations are welcome! you can use PayPal
to donate me and support OS/2 developement. See my homepage for details, or ask :-)
At least, a post card is welcome!


History
-------
02/12/2006
	bogofilter 1.1.2

01/12/2006
	bogofilter 1.1.1

26/07/2005 
	bogofilter 0.95.2

30/06/2005 
	bogofilter 0.94.14 with sqlite support

===============================================================================
Yuri Dario <mc6530@mclink.it>
http://www.os2power.com/yuri
