markstos / CGI.pm

The CGI.pm perl module

This URL has Read+Write access

CGI.pm /
name age
history
message
file Changes Wed Dec 02 19:21:09 -0800 2009 Add Changes entry: url() now uses virtual_p... [Mark Stosberg]
file MANIFEST Wed Dec 02 19:19:12 -0800 2009 Add t/url.t to MANIFEST [Mark Stosberg]
file Makefile.PL Wed Aug 19 17:11:08 -0700 2009 Quit bundling an ancient copy of Test::More and... [Mark Stosberg]
file README Sun Nov 08 09:03:44 -0800 2009 Update README to account for CGI.pm being under... [Alex Vandiver]
file cgi-lib_porting.html Fri Jul 31 19:11:57 -0700 2009 Committing 3.44, unmodified. The generated ... [Mark Stosberg]
file cgi_docs.html Fri Jul 31 19:11:57 -0700 2009 Committing 3.44, unmodified. The generated ... [Mark Stosberg]
directory examples/ Mon Aug 31 10:34:10 -0700 2009 replace appearances of startform() in Pod and e... [eserte]
directory lib/ Sun Nov 29 07:57:36 -0800 2009 replacing server_port by virtual_port [Yanick Champoux]
directory t/ Sun Nov 29 09:04:56 -0800 2009 adding tests for url() [Yanick Champoux]
README
WHAT IS THIS?

This is CGI.pm, an easy-to-use Perl5 library for writing World
Wide Web CGI scripts.

HOW DO I INSTALL IT?

To install this module, cd to the directory that contains this README
file and type the following:

   perl Makefile.PL
   make
   make test
   make install

If this doesn't work for you, try:

   cp lib/CGI.pm /usr/local/lib/perl5

If you have trouble installing CGI.pm because you have insufficient
access privileges to add to the perl library directory, you can still
use CGI.pm.  See the docs for details.

WHAT SYSTEMS DOES IT WORK WITH?

This module works with NT, Windows, Macintosh, OS/2 and VMS servers,
although it hasn't been tested as extensively as it should be.  See
the docs for notes on your particular platform.

WHERE IS THE DOCUMENTATION?

Documentation is found in POD (plain old documentation) form in CGI.pm
itself.  When you install CGI, the MakeMaker program will
automatically install the manual pages for you (on Unix systems, type
"man CGI").

WHERE ARE THE EXAMPLES?

A collection of examples demonstrating various CGI features and
techniques are in the directory "examples".

WHERE IS THE ONLINE DOCUMENTATION?

Online documentation of for CGI.pm, and notifications of new versions
can be found at:

   http://search.cpan.org/~lds/

WHERE CAN I LEARN MORE?

I have written a book about CGI.pm called "The Official Guide to
Programming with CGI.pm" which was published by John Wiley & Sons in
May 1998.  If you like CGI.pm, you'll love this book.

IMPORTANT NOTES:

Version 2.69 emits XHTML by default.  To get the old behavior, use the
-no_xhtml pragma.

Versions 2.44-2.46 introduce two API changes that will affect
users of previous versions:

1) The accept() function has been renamed Accept() to avoid conflicting with
Perl's built-in function of the same name.

2) The sub() function has been renamed Sub() for similar reasons.

My apologies for these changes, but they were necessary in order for
CGI to pass the perl5.005 regression tests!

Have fun, and let me know how it turns out!

Lincoln D. Stein
lstein@cshl.org