Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Fetching contributors…

Octocat-spinner-32-eaf2f5

Cannot retrieve contributors at this time

file 84 lines (54 sloc) 2.451 kb
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83
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 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?

You'll find very verbose documentation in the file cgi_docs.html,
located in the top level directory.

Terser 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". Many more examples of CGI
scripts of various degrees of complexity can be found at:

   http://www.genome.wi.mit.edu/WWW/examples/Ch9/

WHERE IS THE ONLINE DOCUMENTATION?

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

   http://stein.cshl.org/WWW/software/CGI/

A copy of the HTML documentation can be found in the package in the
file cgi_docs.html or in the standard POD pages.

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
Something went wrong with that request. Please try again.