#-------------------------------------------------------
#
# $Id: README,v 0.22 1998/04/24 01:39:30 jbaker Exp $
#
#-------------------------------------------------------


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

This is a binary version of Doug MacEachern's mod_perl, built for Win32.
This binary is concurrent with version 1.11 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.11-bin-bindist1-i386-win32-vc5.tar.gz
	
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.3b5 or 1.3b6 (http://www.apache.org/dist)
Perl 5.004_04 (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 jeff@godzilla.tamu.edu.

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 lib\ tree to your Perl top level directory (e.g. c:\perl).  

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

Find the library you need in the top level of this directory.  For instance,
if you are using Apache 1.3b5, use ApacheModulePerl-Release-1.3b5.dll.
Rename this library to ApacheModulePerl.dll.  Then, simply move 
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:
---------------------------

For some reason, rand() is completely broken on mod_perl under Win32.  
Don't use it unless you want the same number everytime.

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
jeff@godzilla.tamu.edu

