Installing NoSpam:


	Warning:  This software is undergoing testing and further
        development; it is being distributed solely for experimental
        purposes.  Using it on a real Waffle account could result in
        the loss of e-mail messages.

	Post useful comments, improvements, bugfixes, etc. to
        comp.bbs.waffle.


NoSpam Requirements:

  Waffle DOS v1.65 installed and running
  Perl 5 installed (www.perl.org, www.perl.com/perl/, www.perl.hip.com)

  Note: This installation is only for Waffle machines which initiate all
  UUCP calls.

------------------------------------------------------------------------------

In the examples below, items in uppercase are default examples: your system
may be configured differently.  (Eventually an installation utility could
replace some of these instructions.)


1. In a temporary directory (such as C:\TEMP), unpack this archive:

  C:\TEMP> pkunzip -e nospam.zip


2. Copy NOSPAM.PL to the Waffle bin directory:

  C:\TEMP> copy nospam.pl C:\WAFFLE\BIN


3. Edit the Waffle POLL.BAT file, prepending and appending a line for each
   user for whom the spamfilter is to be installed, saving the file when done.

  C:\TEMP>  edit C:\WAFFLE\BIN\poll.bat

  (the revised file:)
   C:\PERL5\perl \WAFFLE\bin\nospam.pl -nUSER -d
   C:\PERL5\perl \WAFFLE\bin\nospam.pl -nJOHN -d
   C:\PERL5\perl \WAFFLE\bin\nospam.pl -nIAN  -d
   C:\PERL5\perl \WAFFLE\bin\nospam.pl -nJUAN -d
   batch -sNEIGHBOUR
   uucico -S ALL
   BSCAN		<If you use it...)
   uuxqt
   C:\PERL5\perl \WAFFLE\bin\nospam.pl -nUSER -s
   C:\PERL5\perl \WAFFLE\bin\nospam.pl -nJOHN -s
   C:\PERL5\perl \WAFFLE\bin\nospam.pl -nIAN  -s
   C:\PERL5\perl \WAFFLE\bin\nospam.pl -nJUAN -s


4. In each user's directory, unpack a copy of the USERDIR.ZIP file:
  C:\TEMP> cd \USER\JOHN
  C:\USER\JOHN> pkunzip -e C:\TEMP\userdir

That's all that's necessary.

------------------------------------------------------------------------------

Additional "tunings" possible in the poll.bat file:


Before outgoing mail is sent, it is searched for possible new recipients
which, if found, are automatically registered.  It is assumed that if you
send e-mail to someone it is okay for them to respond.

  Processing outgoing mail:
  nospam -n<login> -d [-o] [-v]
	-n<login>	User's login name.
	-d		Look for new e-mail destinations.
	-o		Show Option settings.
	-v		Verbose mode (may be helpful if problem arises).


Mailboxes are searched after incoming mail is delivered in order to locate
and divert (or drop) messages from unknown senders.  The -s option is
especially encouraged.

  Processing mailbox after incoming e-mail:
  nospam -n<login> [-s] [-p<hours>] [-r<retries>] [-o] [-v]
	-n<login>	User's login name.
	-s		Save presumed spam in mailbox folder SPAM.
	-r<retries>	Number of retires a probationer gets.
	-o		Show Option settings.
	-v		Verbose mode.

------------------------------------------------------------------------------

Additional information for the user:

The user will find four ASCII text files in the his directory, which he is
encouraged to edit.  (Eventually a User's Guide will be included.)  These are:

  NOSPAM.KEY	is a list of words or phrases, one of which will be randomly
  		selected and sent back to a previously unknown sender.  That
  		sender must respond with e-mail containing that key in the
  		first line, within the timeout period (default: 72 hours), in
  		order to have all subsequent passed through the spamfilter.
  NOSPAM.Mnn	One of these files will be randomly selected to be sent to an
  		unknown sender.  More of these can be created; "%e" will be
  		automatically replaced with the date and time by which the
  		unknown sender must send the key, "%k" will be replaced by the
  		randomly chosen key, and "%u" by the user's e-mail address.
  NOSPAM.OK	This file is sent when the unknown sender returns the key.


The user will eventually see two other important files appear in his home
directory, NOSPAM.REG and NOSPAM.PRO.

  NOSPAM.REG is a list of addresses, mail from which the spamfilter will
  automatically pass.  If he wants, he can manually add addresses with an
  ASCII editor, one per line. The date and time are only there to tell when
  that address was registered; he may leave that item blank.

  NOSPAM.PRO tells who is currently "on probation"; they have attempted to
  send e-mail but were rejected.  If the sender is to be permanently
  rejected, change the date and time text to "FOREVER".  Warning: tabs in
  this file MUST be preserved.  (Another utility to be written...?)

  Other files will also appear in the directory after nospam.pl has been
  invoked.  Not all files will be present at any time, and some (the temporary
  files) the user will hopefully never see.  These files are:

	mailbox.f         Normal Waffle mailbox file.
	mailbox.i         Index file.
	spam.f            Spam mailbox file (created if -s option is used).
	spam.i            Index file.

	nospam.pro        Probationed senders file created/altered by NoSpam.
	nospam.reg        Registry of approved senders.  Editable by user.
	nospam.key        List of keys.  Editable by user.
	nospam.m00..99    Spamfilter messages. Creatable/editable by user.
	nospam.ok         Spamfilter "approved" message. Editable by user.

	mailspam.bat      Temporary outgoing mail sender batch file.
	mailspam.000..999 Temporary outgoing messages.

	mailbox.bak       Backup mailbox.
	nospam.pr1        Backup probationed senders file.
	nospam.re1        Backup registry.

	mailbox.new       Temporary mailbox.
	nospam.tmp        Temporary working file.

------------------------------------------------------------------------------



