*** cgi_buffer for Perl


REQUIREMENTS
------------
cgi_buffer.pm is a Perl (http://www.perl.com/) library, and has been
tested with Perl 5.004, on Linux. There should be no great issues using it
with Windows platforms, but the author has little experience using CGI on
them, and CANNOT SUPPORT WINDOWS INSTALLATIONS.

The following libraries need to be installed; see CPAN (http://www.cpan.org/)
for more information:

* MD5
* IO::String
* Compress::Zlib


INSTALLATION
------------
After untarring the distribution, copy cgi_buffer.pm into your @INC  path
(typically /usr/lib/perl5/site_perl/5.00x/). Or, copy it directly into your
CGI directory.


USE AS A LIBRARY
----------------
The easiest way to integrate cgi_buffer into your Perl scripts is to
simply import it; at the beginning of your script, insert:

  require cgi_buffer;
  
You can fine-tune cgi_buffer's behaviour by setting flags in the library; 
for example,

  require cgi_buffer;
  $cgi_buffer::generate_etag = 0;
  
will turn off ETag generation in the library. See the source for a complete 
listing.


QUESTIONS?
----------
If you have any problems, questions or comments, please check the Web page
first, and then try mailing me:
  http://www.mnot.net/cgi_buffer/
  mailto:mnot@pobox.com