CGI::Cache 1.04

Perl extension to help cache output of time- intensive CGI scripts so that
subsequent visits to such scripts will not cost as much time.


WARNING! The interface in this version of CGI::Cache is incompatible
with the interface of version 1.00 and earlier. You will need to
modify any existing scripts you have to use the new interface if you
install this version.

WARNING! The interface changed slightly in version 1.20.


NEW IN THIS VERSION

1.20
- Added a FORCE_INSTALL option to Makefile.PL to skip warnings about possibly
  incompatible versions.
- Many thanks to Benjamin Goldberg for helping to fix the tie'ing of STDOUT so
  that it works well with FastCGI. CGI::Cache is now fully compatible with
  FastCGI and mod_perl, and no extra work needs to be done on the part of the
  user. Thanks also to "doggy" for raising the issue.
- Migrated over to Cache::Cache from File::Cache. The interface has changed
  slightly, and is not fully backward compatible with previous versions.
- Changed test script to use the same perl interpreter for testing as the one
  that was used to run the test script itself. (Thanks to Honza Pazdziora for
  the patch.)
- Added features to explictly identify the handles to monitor and the handles
  upon which to output. This allows CGI::Cache to interoperate better with
  other modules which attempt to bind to STDOUT and STDERR, and allows the
  user to cache output to files.
- Side-effects of CGI::Cache (tie'ing of handles, rebinding of warn() and
  die()) now only occur when CGI::Cache is actually caching output.
- CGI::Cache::start() now returns 0 instead of exiting after cached output is
  printed. This provides better compatibility with persistent CGI scripts
  implemented using mod_perl or FastCGI.
- Added several new test cases


MODULE DEPENDENCIES

You will need to install Cache::Cache to use CGI::Cache. You can get the
latest version from:

  http://www.perl.com/CPAN/authors/id/D/DC/DCLINTON/

Alternatively, installation of Cache::Cache and its dependencies can be done
automatically using the CPAN module:

  perl -MCPAN -e 'install Cache::Cache'


INSTALLATION

To install this package, change to the directory where you
unarchived this distribution and type the following:

	perl Makefile.PL
	make
	make test
	make install

You can also use "perl Makefile.PL FORCE_INSTALL" to avoid prompts which ask
if it is okay to install the new version even if it is potentially
incompatible with scripts written using the older version found on the
system.

During the 'make test', there are some tests that take a while
longer to run. While testing that caching is working, CPU times
are being recorded on some badly written code to see that
performance will actually be increased on subsequent visits.
Don't panic. It may take a couple of minutes to run, depending
on your system.

If you do not have root access on your machine, then you may
not have the ability to install this module in the standard
perl library path. You may direct the installation into your
own space, e.g.,

	perl Makefile.PL LIB='/home/userid/lib'

or perhaps the entire installation, e.g.,

	perl Makefile.PL PREFIX='/home/userid'

If you make the installation into your own directory, then
remember that you must tell perl where to search for modules
before trying to 'use' them. For example:

	use lib '/home/userid/lib';
	use CGI::Cache;


NOTES

Please let me know if you are using this module. Tell me what
bugs you find or what can be done to improve it.


HOMEPAGE

Visit http://cgicache.sourceforge.net/ for the latest version, mailing
lists, discussion forums, CVS access, and more.


COPYRIGHT

Copyright (c) 1998-Sep 1 2000 Broc Seib. Copyright (c) Sep 1 2000-2001 David
Coppit. All rights reserved.


LICENSE

This code is distributed under the GNU General Public License (GPL).
See http://www.opensource.org/gpl-license.html and
http://www.opensource.org/.


AUTHOR

David Coppit, david@coppit.org (current maintainer)
Broc Seib, bseib@purdue.edu (original author)
