Description
-----------
This is version 1.00 of Apache::SessionManager

This package is an HTTP session manager.
Apache::SessionManager is a mod_perl module that helps
session management of a web application. This simple module is a
wrapper around Apache::Session persistence framework for session data.
It creates a session object and makes it available to all other handlers
transparenlty by putting it in pnotes.

See perldoc Apache::SessionManager for module documentation and use
See perldoc Apache::SessionManager::cookpod for more info about module use

Changes from previous version
-----------------------------

       + Added mod_perl 2 and mod_perl 1 full compatibility
       + Added OO interface. Now Apache::SessionManager inherits from Apache class
       + Added new cookpod section: "Using Apache::SessionManager without root privileges"
       + Added new cookpod section: "Using Apache::SessionManager with Apache::DBI"
       + Added new cookpod section: "Expiration policies on the client side"
       + Added t/lib/PerlEnvOO.pm simple mod_perl handler to test OO interface
       ! Updated Makefile.PL in order to:
               - accept command line switch '-n' which
                 doesn't ask at prompt and doesn't run live Apache tests. This is to pack
                 easier this package for Debian (suggested by Krzysztof Krzyzaniak
                 <[email protected]>)
               - check correctly environment: test mod_perl generation
                 and test suite. Added messages before configuring test
               - add httpd.conf extra lines for testing with Apache::DBI
       ! Updated PODS
               - SessionManager.pm PODS (VERSION section)
               - added L<> in every module name
               - documented mp1/mp2 bug with "PerlSetVar Foo 0"
               - Switched use of $ENV{'GATEWAY_INTERFACE'} to $ENV{'MOD_PERL'} in cookbook samples
               - Fix 'Expire' with 'Expires'
       ! Bug fix: SessionManagerExpire: '0' => (none|no|disabled) value means no
         expiration time
       ! Moved tests to run only under Apache::testold mod_perl 1 test suite
       ! Ported t/lib/*.pm sample modules to work either with mod_perl 1.0 and 2.0

Installation
------------
In order to install and use this package you will need Perl version
5.005 or better.  Installation as usual:

  % perl Makefile.PL
  % make
  % make test
  % su
    Password: *******
  % make install

Prerequisites
-------------
- mod_perl (of course) >= 1.24 with the appropriate call-back hooks (PERL_TRANS=1,
 PERL_HEADER_PARSER=1)
- Apache::Session >= 0.53 is required
    (http://www.cpan.org/modules/by-module/Apache/Apache-Session-x.yy.tar.gz)
- Apache::Request >= 0.33 (libapreq) is preferred but not required. If not
    present CGI::Cookie will be used instead.
    (http://www.cpan.org/modules/by-module/Apache/libapreq-x.yy.tar.gz)

Copyright (C) 2001-2003 Enrico Sorcinelli. All rights reserved.
This program is free software; you can redistribute it
and/or modify it under the same terms as Perl itself.

Author: Enrico Sorcinelli <[email protected]>

Part of Makefile.PL contains Perl (cool!) code of Joshua Chamas
Apache-ASP Makefile.PL installation script