svn commit: rev 47343 - spamassassin/trunk

[qu...@apache.org]

Author: quinlan
Date: Mon Sep 27 16:49:24 2004
New Revision: 47343

Modified:
   spamassassin/trunk/INSTALL
Log:
bug 3822: clean up requirements documentation


Modified: spamassassin/trunk/INSTALL
==============================================================================
--- spamassassin/trunk/INSTALL	(original)
+++ spamassassin/trunk/INSTALL	Mon Sep 27 16:49:24 2004
@@ -163,16 +163,23 @@
 be able to find these through those mechanisms, too, if you prefer.
 
 
-Required Perl/Module Versions
------------------------------
+Required Perl Interpreter
+-------------------------
 
-Perl 5.6.1, and its associated modules, are required for SpamAssassin
-3.0.0 and later.
+Perl 5.6.1 or a later version is required.
 
-In additional, the following non-standard modules are also required for
-SpamAssassin to run:
 
-  - Digest::SHA1    (from CPAN)
+Required Perl Modules
+---------------------
+
+In addition to the modules associated with Perl, some additional modules
+need to be installed or upgraded depending on the version of Perl that you
+are running.
+
+The list of required modules that do not ship with Perl and must be
+installed:
+
+  - Digest::SHA1 (from CPAN)
 
     The Digest::SHA1 module is used as a cryptographic hash for some
     tests and the Bayes subsystem.  It is also used by Razor2.
@@ -190,7 +197,7 @@
     Debian: apt-get install libhtml-parser-perl
     Gentoo: emerge dev-perl/HTML-Parser
 
-  - Storable             (from CPAN)
+  - Storable (from CPAN)
 
     This is a required module if you use spamd and allow user
     configurations to be used (ie: you don't use -x, -u, -q/--sql-config,
@@ -202,14 +209,17 @@
     Debian: apt-get install libstorable-perl
     Gentoo: emerge dev-perl/Storable
 
-Optional Additional Modules
----------------------------
+Optional Modules
+----------------
 
 In addition, the following modules will be used for some checks, if
-available.  If they are not available, SpamAssassin will still work, just
-not as effectively -- some of the spam-detection tests will have to be
+available and the version is high enough.  If they are not available or if
+their version is too low, SpamAssassin will still work, just not as
+effectively because some of the spam-detection tests will have to be
 skipped.
 
+Note: SpamAssassin will not warn you if these are installed, but the
+version is too low for them to be used.
 
   - DB_File         (from CPAN, included in many distributions)
 
@@ -280,6 +290,41 @@
 
     More info is at http://wiki.apache.org/spamassassin/UsingRazor
 
+  - Net::Ident      (from CPAN)
+
+    If you plan to use the --auth-ident option to spamd, you will need
+    to install this module.
+
+
+  - IO::Socket::SSL (from CPAN)
+
+    If you wish to use SSL encryption to communicate between spamc and
+    spamd (the --ssl option to spamd), you need to install this
+    module. (You will need the OpenSSL libraries and use the
+    ENABLE_SSL="yes" argument to Makefile.PL to build and run an SSL
+    compatibile spamc.)
+
+
+  - Time::HiRes    (from CPAN)
+
+    If this module is installed, the processing times are logged/reported
+    more precisely.
+
+
+  - DBI *and* DBD driver/modules for your database  (from CPAN)
+
+    If you intend to use SpamAssassin with an SQL database backend for
+    user configuration data, Bayes storage, or AWL storage, you will need
+    to have these installed; both the basic DBI module and the driver for
+    your database.
+
+
+Optional Programs
+-----------------
+
+These are non-Perl programs that can increase the overall effectiveness of
+SpamAssassin if they are installed.
+
   - DCC             http://www.rhyolite.com/anti-spam/dcc/
 
     DCC (Distributed Checksum Clearinghouse) is a system similar to Razor.
@@ -347,7 +392,7 @@
 
     Pyzor requires at least Python 2.2.1 which can be found at
     http://www.python.org/ .
- 
+
     To install Pyzor, download the latest revision from
     https://sourceforge.net/project/showfiles.php?group_id=50000 and
     perform the following steps:
@@ -375,34 +420,6 @@
     default.
 
     More info is at http://wiki.apache.org/spamassassin/UsingPyzor
-
-  - Net::Ident      (from CPAN)
-
-    If you plan to use the --auth-ident option to spamd, you will need
-    to install this module.
-
-
-  - IO::Socket::SSL (from CPAN)
-
-    If you wish to use SSL encryption to communicate between spamc and
-    spamd (the --ssl option to spamd), you need to install this
-    module. (You will need the OpenSSL libraries and use the
-    ENABLE_SSL="yes" argument to Makefile.PL to build and run an SSL
-    compatibile spamc.)
-
-
-  - Time::HiRes    (from CPAN)
-
-    If this module is installed, the processing times are logged/reported
-    more precisely.
-
-
-  - DBI *and* DBD driver/modules for your database  (from CPAN)
-
-    If you intend to use SpamAssassin with an SQL database backend for
-    user configuration data, Bayes storage, or AWL storage, you will need
-    to have these installed; both the basic DBI module and the driver for
-    your database.
 
 
 What Next?