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

    26 May 2000                          Jeffrey Baker <jwbaker@acm.org>

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

DESCRIPTION
-----------

This is Apache::Session 1.50.

These modules provide persistent storage for arbitrary data, in arbitrary
backing stores.  The details of interacting with the backing store are
abstracted to make all backing stores behave alike.  The programmer simply
interacts with a tied hash.

Apache::Session is Copyright(c) 1998, 1999, 2000 Jeffrey William Baker
<jwbaker@acm.org>.  Distribute under the same terms as Perl itself.

PREREQUISITES
-------------

To use this distribution of Apache::Session, you need the Storable and 
MD5 modules from CPAN.  If you intend to extend this module for your own
purposes, you may not need these prerequisites.

If you wish to use the DBI backing stores, you need the latest version of DBI
and the driver for your database.  Currently MySQL, Postgres, and Oracle are
supported.

INSTALLATION
------------

tar -xvzf Apache-Session-1.50.tar.gz
cd Apache-Session-1.50
perl Makefile.PL
make
make test
make install

Substitute "nmake" for "make" above if you are using Windows.

EXAMPLE
-------

See eg/example.perl.  This program is intended to be run under mod_perl.

AUTHORS
-------
Jeffrey William Baker <jwbaker@acm.org> is the author of 
Apache::Session.

Andreas J. Koenig <andreas.koenig@anima.de> contributed valuable CPAN
advice and also Apache::Session::Tree and Apache::Session::Counted.

Gerald Richter <richter@ecos.de> had the idea for a tied hash interface
and provided the initial code for it.  He also uses Apache::Session in
his Embperl module and is the author of Apache::Session::Embperl.

Jochen Wiedmann <joe@ipsoft.de> contributed patches for bugs and
improved performance.

Steve Shreeve <shreeve@uci.edu> squashed a bug in 0.99.0 whereby
a cleared hash or deleted key failed to set the modified bit.

Peter Kaas <Peter.Kaas@lunatech.com> sent quite a bit of feedback
with ideas for interface improvements.

Randy Harmon <rjharmon@uptimecomputers.com> contributed the original
storage-independent object interface with input from:

  Bavo De Ridder <bavo@ace.ulyssis.student.kuleuven.ac.be>
  Jules Bean <jmlb2@hermes.cam.ac.uk>
  Lincoln Stein <lstein@cshl.org>

FURTHER INFORMATION:
--------------------

Apache   by Apache Group    comp.infosystems.www.servers.unix
                            http://www.apache.org/
                            
mod_perl by Doug MacEachern modperl@apache.org
                            http://perl.apache.org/
                            
