Notes on Windows support for BannerFilter 1.31
----------------------------------------------

BannerFilter runs on Microsoft Windows with SquidNT and ActivePerl.
This document is intended to suppliment, not replace, the standard
README file.  You can open the README file in WordPad, or any other
text editor which can read UNIX line endings (i.e. not Notepad).

SquidNT may be obtained from:
http://www.acmeconsulting.it/pagine/opensource/squid/SquidNT.htm

ActivePerl may be obtained from:
http://www.activestate.com/Products/ActivePerl/


INSTALLATION:
-------------

Unzip BannerFilter and place it in the C:\squid directory, or anywhere
else you'd like.  StuffIt Expander (http://www.stuffit.com) and recent
versions of WinZip (http://www.winzip.com/) should both handle tar-gzip
files.

Add this line to C:\squid\etc\squid.conf:
redirect_program C:/perl/bin/perl.exe C:/squid/bannerfilter-1.31/redirector.pl

Notice the forward slashes (/) instead of backslashes (\).  Substitute
the correct locations of perl.exe and redirector.pl if you've put them
somewhere else.


CONFIGURATION:
--------------

To edit bannerfilter.conf or the data files, you'll need to use a decent
text editor that handles UNIX line endings, or open the files in WordPad
which will convert them to Windows line endings (once you've saved them
in WordPad you can re-open them in Notepad if you prefer).

For file paths in the configuration file, you can use either forward
slashes (/) or backslashes (\).

If you're using IIS as your web server, you can either move the contents
of the www directory to C:\Inetpub\wwwroot\bannerfilter, or create a
virtual directory pointing to C:\squid\bannerfilter-1.31\www.  Of course
you can do something similar in Apache or whatever web server you're using.


UPDATES:
--------

The update script is not officially supported on Windows, but update.sh
can be made to work using Cygwin (http://www.cygwin.com/).  You'll need
to install wget, or something else that can do HTTP downloads, and turn
off the RELOAD option in the update script (or change it to something that
works).  If SquidNT is installed as a service, you can restart it with:
net stop squidnt
net start squidnt


ACKNOWLEDGEMENTS:
-----------------

Thanks to Andre Swanepoel for inspiration and ideas.