DESCRIPTION:
------------

This is a binary version of Doug MacEachern's mod_perl, built for Win32.
This binary is concurrent with version 1.16 of mod_perl.

Mod_perl is an extremely useful module for the Apache HTTP server.  It
allows you to: achieve a significant speed increase over CGI, configure
your web server entirely in Perl, use Perl to intervene in any stage of an
HTTP request, etc.

This from the mod_perl README:

  "The Apache/Perl integration project brings together the full power of
  the Perl programming language and the Apache HTTP server.  This is
  achieved by linking the Perl runtime library into the server and
  providing an object oriented Perl interface to the server's C language
  API. 
  "These pieces are seamlessly glued together by the `mod_perl' server
  plugin, making it is possible to write Apache modules entirely in
  Perl.  In addition, the persistent interpreter embedded in the server
  avoids the overhead of starting an external interpreter program and
  the additional Perl start-up (compile) time."

WHERE TO FIND:
--------------

This mod_perl binary and the original sources can be found at any CPAN ftp
site under:

  .../CPAN/modules/by-module/Apache/
  .../CPAN/modules/by-category/15_World_Wide_Web_HTML_HTTP_CGI/Apache/
  .../CPAN/modules/by-authors/Jeffrey_Baker
  
Look for the file mod_perl-1.16-bin-bindist1-i386-win32-vc5.zip
  
To find the CPAN site nearest you, go to http://www.perl.com/CPAN

PREREQUISITES:
--------------

To use this binary of mod_perl, you need at least the following software:

Windows NT 4.0 sp3
Apache 1.3.3 (http://www.apache.org/dist)
Perl 5.005_05 (http://www.perl.com/CPAN/src/latest.tar.gz)

...and an Intel processor.

This binary was built using Microsoft Visual C++ 5.0 on Windows NT 4.0
(Build 1381) Sevice Pack 3.  It has been tested on this platform only, and
is not garaunteed to run on Windows 95.  If you successfully use this
binary on Windows 95, please let me know at jwb@tca.net

This binary absolutely will not work with any other perl other than 
5.005_02, and probably will not any version of Perl built with 
Borland C.  Anyone who writes to complain that this software doesn't
work with Gurusamy Sarathy's 5.004 perl binary will receive a round
thwapping.

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

This archive includes both the binary mod_perl library and the required perl
side of mod_perl.  To install, extract this archive to a temporary location 
and copy the perl\site\ tree to your Perl top level directory (e.g. c:\perl).  

**BE CAREFUL NOT TO CLOBBER YOUR PERL LIB TREE!**

Then, simply move apache\modules\ApacheModulePerl.dll to the modules directory under your 
apache tree (e.g. c:\apache\modules\)

To use mod_perl, you will need to add the following line to your
httpd.conf:

LoadModule perl_module modules/ApacheModulePerl

Please consult README for more info.

CAVEATS AND KNOWN PROBLEMS:
---------------------------

Don't run Apache 1.3 as a service.  Run it from the console.

FURTHER INFO:
-------------

For comments, questions, bug-reports, announcements, etc., join the
Apache/Perl mailing list by sending mail to
listserv@listproc.itribe.net with the string "subscribe modperl" in the
body.   

There is a hypermail archive for this list available from:
http://outside.organic.com/mail-archives/modperl/

The mod_perl FAQ is available from:
http://www.ping.de/~fdc/mod_perl/

For more general information see the Apache/Perl homepage:
http://perl.apache.org/ 
 or
http://apache.perl.org/

For comments or questions about this binary distribution ONLY, please email
jwb@tca.net