Since our fellow monk garyj sounds like he might be rather new to the whole Perl thing let me clarify a bit about this POD thing. (A year ago, I would have had not a clue on how to "read the POD inside the module".)

On most Unix systems you can type from the command line perldoc CGI.pm and read the POD (Plain Old Documentation) for the module. I believe man CGI will have the same result on many systems. If you are on a system that has ActiveState's ActivePerl distribution - it comes with some excellent 'html-ized' POD documentation. I've gone so far to copy their documentation from a Win2k box to my Linux machine just to have it available.

This site is itself a splended resource - by going to Super Search and looking for "CGI" or "use CGI" you are bound to find plentiful examples. Additionally by just going to the top of this screen and entering use CGI you'll find countless more examples.

One last note is that by looking at http://search.cpan.org/ you can perform searches to find every module that has anything to do with CGI.

Good luck,
{NULE}
--
http://www.nule.org