CGI::Response, Version 0.03 Copyright (c) 1995 Marc Hedlund All rights reserved. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the Artistic License for more details. You should have received a copy of the Artistic License with this Kit, in the file named "LICENSE". If not, I'll be glad to provide one. -------------------------------------------------------------------------- CGI::Response is one of several Perl5 modules designed to help create easy and sophisticated CGI applications. THIS IS AN ALPHA TEST RELEASE, which means that future releases are _NOT_ guaranteed to be backwards-compatible. The interface to this module will be frozen once it reaches beta release (version 0.1). WARNING FOR VERSION 0.03! ------------------------- There have been a number of changes to the Simple Interface that will break older scripts using Simple Interface methods. Please see the file CHANGES for notes on upgrading old scripts. DEPENDENCIES ------------ First, I very strongly recommend that you install Perl version 5.001m or later. If you are unsure which version of Perl you have, type 'perl -v'. This module depends on several other modules which are not part of the standard Perl distribution. You must install these modules before using CGI::Response. Sources for each of these modules are listed in the paragraphs below. However, it would be easier to retrieve all of them from a CPAN archive. (CPAN, the Comprehensive Perl Archive Network, is a set of sites which archive all perl-related materials in an easy-to-use fashion.) For a list of CPAN mirror sites see . CGI::* ------ The CGI::* modules are maintained by Lincoln Stein , and are available at . Get the package entitled 'CGI-modules.tar.gz'. If the CGI::Base module is already installed on your system, you may skip this step, though I recommend getting the current version if you are going to use CGI::Response regularly. HTTP::* ------- The HTTP::* modules are maintained by Gisle Aas and are available in the libwww-perl-5 package, which you can get from . NOTE: This version of libwww-perl is _NOT_ the same as the Perl4 version of the same name. Be sure you install the right package! SelfLoader.pm ------------- SelfLoader.pm is maintained by Jack Shirazi and is available from (although the version at CPAN may be more current). INSTALLATION ------------ After you have unpacked your kit, you should have all the files listed in MANIFEST. The following should work on most systems: perl Makefile.PL make make test make install If that doesn't work, you can always just copy the 'lib/CGI/Response.pm' file into the 'CGI' directory of your perl5 lib directory (probably /usr/local/lib/perl5/). If you have any trouble, please feel free to write me at the address below. I cannot promise to answer all questions, but if you raise an installation issue, I will try to address it. USAGE ----- Documentation is provided in pod ("plain old documentation") format, embedded within the Response.pm module itself. Pod can be converted to man page or HTML format using tools provided in the Perl distribution (pod2man and pod2html). You can also read the pod by typing 'perldoc CGI::Response' once you have installed the module. For more information about perldoc, type 'perldoc perldoc'. AUTHOR ------ Marc Hedlund