=item DESCRIPTION
-Many usability enhancements, Simplified grammar, Lexical scoping,
-Arbitrarily nested data structures, Modularity and reusability,
-Object-oriented programming, Embeddable and Extensible, POSIX compliant,
-Package constructors and destructors, Multiple simultaneous DBM
-implementations, Subroutine definitions may now be autoloaded, Regular
-expression enhancements, Innumerable Unbundled Modules, Compilability
+modularity and reusability using innumerable modules, embeddable and
+extensible, roll-your-own magic variables (including multiple simultaneous
+DBM implementations), subroutines can now be overridden, autoloaded, and
+prototyped, arbitrarily nested data structures and anonymous functions,
+object-oriented programming, compilability into C code or Perl bytecode,
+support for light-weight processes (threads), support for
+internationalization, localization, and Unicode, lexical scoping, regular
+expression enhancements, enhanced debugger and interactive Perl
+environment, with integrated editor support, POSIX 1003.1 compliant library
+
+=item AVAILABILITY
=item ENVIRONMENT
=item NOTES
-=head2 perlfaq - frequently asked questions about Perl ($Date: 1998/07/20
-23:12:17 $)
+=head2 perlfaq - frequently asked questions about Perl ($Date: 1999/05/23
+20:38:02 $)
=item DESCRIPTION
perlfaq: Structural overview of the FAQ, L<perlfaq1>: General Questions
-About Perl, L<perlfaq2>: Obtaining and Learning about Perl, L<perlfaq3>:
-Programming Tools, L<perlfaq4>: Data Manipulation, L<perlfaq5>: Files and
-Formats, L<perlfaq6>: Regexps, L<perlfaq7>: General Perl Language Issues,
-L<perlfaq8>: System Interaction, L<perlfaq9>: Networking
+About Perl, What is Perl?, Who supports Perl? Who develops it? Why is it
+free?, Which version of Perl should I use?, What are perl4 and perl5?, What
+is perl6?, How stable is Perl?, Is Perl difficult to learn?, How does Perl
+compare with other languages like Java, Python, REXX, Scheme, or Tcl?, Can
+I do [task] in Perl?, When shouldn't I program in Perl?, What's the
+difference between "perl" and "Perl"?, Is it a Perl program or a Perl
+script?, What is a JAPH?, Where can I get a list of Larry Wall witticisms?,
+How can I convince my sysadmin/supervisor/employees to use version
+(5/5.005/Perl instead of some other language)?, L<perlfaq2>: Obtaining and
+Learning about Perl, What machines support Perl? Where do I get it?, How
+can I get a binary version of Perl?, I don't have a C compiler on my
+system. How can I compile perl?, I copied the Perl binary from one machine
+to another, but scripts don't work, I grabbed the sources and tried to
+compile but gdbm/dynamic loading/malloc/linking/... failed. How do I make
+it work?, What modules and extensions are available for Perl? What is
+CPAN? What does CPAN/src/... mean?, Is there an ISO or ANSI certified
+version of Perl?, Where can I get information on Perl?, What are the Perl
+newsgroups on USENET? Where do I post questions?, Where should I post
+source code?, Perl Books, Perl in Magazines, Perl on the Net: FTP and WWW
+Access, What mailing lists are there for perl?, Archives of
+comp.lang.perl.misc, Where can I buy a commercial version of Perl?, Where
+do I send bug reports?, What is perl.com?, L<perlfaq3>: Programming Tools,
+How do I do (anything)?, How can I use Perl interactively?, Is there a Perl
+shell?, How do I debug my Perl programs?, How do I profile my Perl
+programs?, How do I cross-reference my Perl programs?, Is there a
+pretty-printer (formatter) for Perl?, Is there a ctags for Perl?, Is there
+an IDE or Windows Perl Editor?, Where can I get Perl macros for vi?, Where
+can I get perl-mode for emacs?, How can I use curses with Perl?, How can I
+use X or Tk with Perl?, How can I generate simple menus without using CGI
+or Tk?, What is undump?, How can I make my Perl program run faster?, How
+can I make my Perl program take less memory?, Is it unsafe to return a
+pointer to local data?, How can I free an array or hash so my program
+shrinks?, How can I make my CGI script more efficient?, How can I hide the
+source for my Perl program?, How can I compile my Perl program into byte
+code or C?, How can I compile Perl into Java?, How can I get C<#!perl> to
+work on [MS-DOS,NT,...]?, Can I write useful perl programs on the command
+line?, Why don't perl one-liners work on my DOS/Mac/VMS system?, Where can
+I learn about CGI or Web programming in Perl?, Where can I learn about
+object-oriented Perl programming?, Where can I learn about linking C with
+Perl? [h2xs, xsubpp], I've read perlembed, perlguts, etc., but I can't
+embed perl inmy C program, what am I doing wrong?, When I tried to run my
+script, I got this message. What does itmean?, What's MakeMaker?,
+L<perlfaq4>: Data Manipulation, Why am I getting long decimals (eg,
+19.9499999999999) instead of the numbers I should be getting (eg, 19.95)?,
+Why isn't my octal data interpreted correctly?, Does Perl have a round()
+function? What about ceil() and floor()? Trig functions?, How do I
+convert bits into ints?, Why doesn't & work the way I want it to?, How do I
+multiply matrices?, How do I perform an operation on a series of integers?,
+How can I output Roman numerals?, Why aren't my random numbers random?, How
+do I find the week-of-the-year/day-of-the-year?, How do I find the current
+century or millennium?, How can I compare two dates and find the
+difference?, How can I take a string and turn it into epoch seconds?, How
+can I find the Julian Day?, How do I find yesterday's date?, Does Perl have
+a year 2000 problem? Is Perl Y2K compliant?, How do I validate input?, How
+do I unescape a string?, How do I remove consecutive pairs of characters?,
+How do I expand function calls in a string?, How do I find matching/nesting
+anything?, How do I reverse a string?, How do I expand tabs in a string?,
+How do I reformat a paragraph?, How can I access/change the first N letters
+of a string?, How do I change the Nth occurrence of something?, How can I
+count the number of occurrences of a substring within a string?, How do I
+capitalize all the words on one line?, How can I split a [character]
+delimited string except when inside[character]? (Comma-separated files),
+How do I strip blank space from the beginning/end of a string?, How do I
+pad a string with blanks or pad a number with zeroes?, How do I extract
+selected columns from a string?, How do I find the soundex value of a
+string?, How can I expand variables in text strings?, What's wrong with
+always quoting "$vars"?, Why don't my E<lt>E<lt>HERE documents work?, What
+is the difference between a list and an array?, What is the difference
+between $array[1] and @array[1]?, How can I remove duplicate elements from
+a list or array?, How can I tell whether a list or array contains a certain
+element?, How do I compute the difference of two arrays? How do I compute
+the intersection of two arrays?, How do I test whether two arrays or hashes
+are equal?, How do I find the first array element for which a condition is
+true?, How do I handle linked lists?, How do I handle circular lists?, How
+do I shuffle an array randomly?, How do I process/modify each element of an
+array?, How do I select a random element from an array?, How do I permute N
+elements of a list?, How do I sort an array by (anything)?, How do I
+manipulate arrays of bits?, Why does defined() return true on empty arrays
+and hashes?, How do I process an entire hash?, What happens if I add or
+remove keys from a hash while iterating over it?, How do I look up a hash
+element by value?, How can I know how many entries are in a hash?, How do I
+sort a hash (optionally by value instead of key)?, How can I always keep my
+hash sorted?, What's the difference between "delete" and "undef" with
+hashes?, Why don't my tied hashes make the defined/exists distinction?, How
+do I reset an each() operation part-way through?, How can I get the unique
+keys from two hashes?, How can I store a multidimensional array in a DBM
+file?, How can I make my hash remember the order I put elements into it?,
+Why does passing a subroutine an undefined element in a hash create it?,
+How can I make the Perl equivalent of a C structure/C++ class/hash or array
+of hashes or arrays?, How can I use a reference as a hash key?, How do I
+handle binary data correctly?, How do I determine whether a scalar is a
+number/whole/integer/float?, How do I keep persistent data across program
+calls?, How do I print out or copy a recursive data structure?, How do I
+define methods for every class/object?, How do I verify a credit card
+checksum?, How do I pack arrays of doubles or floats for XS code?,
+L<perlfaq5>: Files and Formats, How do I flush/unbuffer an output
+filehandle? Why must I do this?, How do I change one line in a file/delete
+a line in a file/insert a line in the middle of a file/append to the
+beginning of a file?, How do I count the number of lines in a file?, How do
+I make a temporary file name?, How can I manipulate fixed-record-length
+files?, How can I make a filehandle local to a subroutine? How do I pass
+filehandles between subroutines? How do I make an array of filehandles?,
+How can I use a filehandle indirectly?, How can I set up a footer format to
+be used with write()?, How can I write() into a string?, How can I output
+my numbers with commas added?, How can I translate tildes (~) in a
+filename?, How come when I open a file read-write it wipes it out?, Why do
+I sometimes get an "Argument list too long" when I use E<lt>*E<gt>?, Is
+there a leak/bug in glob()?, How can I open a file with a leading "E<gt>"
+or trailing blanks?, How can I reliably rename a file?, How can I lock a
+file?, Why can't I just open(FH, ">file.lock")?, I still don't get locking.
+ I just want to increment the number in the file. How can I do this?, How
+do I randomly update a binary file?, How do I get a file's timestamp in
+perl?, How do I set a file's timestamp in perl?, How do I print to more
+than one file at once?, How can I read in an entire file all at once?, How
+can I read in a file by paragraphs?, How can I read a single character from
+a file? From the keyboard?, How can I tell whether there's a character
+waiting on a filehandle?, How do I do a C<tail -f> in perl?, How do I dup()
+a filehandle in Perl?, How do I close a file descriptor by number?, Why
+can't I use "C:\temp\foo" in DOS paths? What doesn't `C:\temp\foo.exe`
+work?, Why doesn't glob("*.*") get all the files?, Why does Perl let me
+delete read-only files? Why does C<-i> clobber protected files? Isn't
+this a bug in Perl?, How do I select a random line from a file?, Why do I
+get weird spaces when I print an array of lines?, L<perlfaq6>: Regexps, How
+can I hope to use regular expressions without creating illegible and
+unmaintainable code?, I'm having trouble matching over more than one line.
+What's wrong?, How can I pull out lines between two patterns that are
+themselves on different lines?, I put a regular expression into $/ but it
+didn't work. What's wrong?, How do I substitute case insensitively on the
+LHS, but preserving case on the RHS?, How can I make C<\w> match national
+character sets?, How can I match a locale-smart version of C</[a-zA-Z]/>?,
+How can I quote a variable to use in a regex?, What is C</o> really for?,
+How do I use a regular expression to strip C style comments from a file?,
+Can I use Perl regular expressions to match balanced text?, What does it
+mean that regexes are greedy? How can I get around it?, How do I process
+each word on each line?, How can I print out a word-frequency or
+line-frequency summary?, How can I do approximate matching?, How do I
+efficiently match many regular expressions at once?, Why don't
+word-boundary searches with C<\b> work for me?, Why does using $&, $`, or
+$' slow my program down?, What good is C<\G> in a regular expression?, Are
+Perl regexes DFAs or NFAs? Are they POSIX compliant?, What's wrong with
+using grep or map in a void context?, How can I match strings with
+multibyte characters?, How do I match a pattern that is supplied by the
+user?, L<perlfaq7>: General Perl Language Issues, Can I get a BNF/yacc/RE
+for the Perl language?, What are all these $@%&* punctuation signs, and how
+do I know when to use them?, Do I always/never have to quote my strings or
+use semicolons and commas?, How do I skip some return values?, How do I
+temporarily block warnings?, What's an extension?, Why do Perl operators
+have different precedence than C operators?, How do I declare/create a
+structure?, How do I create a module?, How do I create a class?, How can I
+tell if a variable is tainted?, What's a closure?, What is variable suicide
+and how can I prevent it?, How can I pass/return a {Function, FileHandle,
+Array, Hash, Method, Regex}?, How do I create a static variable?, What's
+the difference between dynamic and lexical (static) scoping? Between
+local() and my()?, How can I access a dynamic variable while a similarly
+named lexical is in scope?, What's the difference between deep and shallow
+binding?, Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?, How do I
+redefine a builtin function, operator, or method?, What's the difference
+between calling a function as &foo and foo()?, How do I create a switch or
+case statement?, How can I catch accesses to undefined
+variables/functions/methods?, Why can't a method included in this same file
+be found?, How can I find out my current package?, How can I comment out a
+large block of perl code?, How do I clear a package?, How can I use a
+variable as a variable name?, L<perlfaq8>: System Interaction, How do I
+find out which operating system I'm running under?, How come exec() doesn't
+return?, How do I do fancy stuff with the keyboard/screen/mouse?, How do I
+print something out in color?, How do I read just one key without waiting
+for a return key?, How do I check whether input is ready on the keyboard?,
+How do I clear the screen?, How do I get the screen size?, How do I ask the
+user for a password?, How do I read and write the serial port?, How do I
+decode encrypted password files?, How do I start a process in the
+background?, How do I trap control characters/signals?, How do I modify the
+shadow password file on a Unix system?, How do I set the time and date?,
+How can I sleep() or alarm() for under a second?, How can I measure time
+under a second?, How can I do an atexit() or setjmp()/longjmp()? (Exception
+handling), Why doesn't my sockets program work under System V (Solaris)?
+What does the error message "Protocol not supported" mean?, How can I call
+my system's unique C functions from Perl?, Where do I get the include files
+to do ioctl() or syscall()?, Why do setuid perl scripts complain about
+kernel problems?, How can I open a pipe both to and from a command?, Why
+can't I get the output of a command with system()?, How can I capture
+STDERR from an external command?, Why doesn't open() return an error when a
+pipe open fails?, What's wrong with using backticks in a void context?, How
+can I call backticks without shell processing?, Why can't my script read
+from STDIN after I gave it EOF (^D on Unix, ^Z on MS-DOS)?, How can I
+convert my shell script to perl?, Can I use perl to run a telnet or ftp
+session?, How can I write expect in Perl?, Is there a way to hide perl's
+command line from programs such as "ps"?, I {changed directory, modified my
+environment} in a perl script. How come the change disappeared when I
+exited the script? How do I get my changes to be visible?, How do I close
+a process's filehandle without waiting for it to complete?, How do I fork a
+daemon process?, How do I make my program run with sh and csh?, How do I
+find out if I'm running interactively or not?, How do I timeout a slow
+event?, How do I set CPU limits?, How do I avoid zombies on a Unix system?,
+How do I use an SQL database?, How do I make a system() exit on control-C?,
+How do I open a file without blocking?, How do I install a module from
+CPAN?, What's the difference between require and use?, How do I keep my own
+module/library directory?, How do I add the directory my program lives in
+to the module/library search path?, How do I add a directory to my include
+path at runtime?, What is socket.ph and where do I get it?, L<perlfaq9>:
+Networking, My CGI script runs from the command line but not the browser.
+(500 Server Error), How can I get better error messages from a CGI
+program?, How do I remove HTML from a string?, How do I extract URLs?, How
+do I download a file from the user's machine? How do I open a file on
+another machine?, How do I make a pop-up menu in HTML?, How do I fetch an
+HTML file?, How do I automate an HTML form submission?, How do I decode or
+create those %-encodings on the web?, How do I redirect to another page?,
+How do I put a password on my web pages?, How do I edit my .htpasswd and
+.htgroup files with Perl?, How do I make sure users can't enter values into
+a form that cause my CGI script to do bad things?, How do I parse a mail
+header?, How do I decode a CGI form?, How do I check a valid mail address?,
+How do I decode a MIME/BASE64 string?, How do I return the user's mail
+address?, How do I send mail?, How do I read mail?, How do I find out my
+hostname/domainname/IP address?, How do I fetch a news article or the
+active newsgroups?, How do I fetch/put an FTP file?, How can I do RPC in
+Perl?
=over
=item Changes
-24/April/97, 23/April/97, 25/March/97, 18/March/97, 17/March/97 Version,
-Initial Release: 11/March/97
+23/May/99, 13/April/99, 7/January/99, 22/June/98, 24/April/97, 23/April/97,
+25/March/97, 18/March/97, 17/March/97 Version, Initial Release: 11/March/97
-=head2 perlfaq1 - General Questions About Perl ($Revision: 1.14 $, $Date:
-1998/06/14 22:15:25 $)
+=head2 perlfaq1 - General Questions About Perl ($Revision: 1.23 $, $Date:
+1999/05/23 16:08:30 $)
=item DESCRIPTION
=item What are perl4 and perl5?
+=item What is perl6?
+
=item How stable is Perl?
=item Is Perl difficult to learn?
=item Where can I get a list of Larry Wall witticisms?
=item How can I convince my sysadmin/supervisor/employees to use version
-(5/5.004/Perl instead of some other language)?
+(5/5.005/Perl instead of some other language)?
=back
=item AUTHOR AND COPYRIGHT
-=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.24 $,
-$Date: 1998/07/20 23:40:28 $)
+=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.31 $,
+$Date: 1999/04/14 03:46:19 $)
=item DESCRIPTION
=item I grabbed the sources and tried to compile but gdbm/dynamic
loading/malloc/linking/... failed. How do I make it work?
-=item What modules and extensions are available for Perl? What is CPAN?
+=item What modules and extensions are available for Perl? What is CPAN?
What does CPAN/src/... mean?
=item Is there an ISO or ANSI certified version of Perl?
=item Perl Books
-References, Tutorials
-*Learning Perl [2nd edition]
-by Randal L. Schwartz and Tom Christiansen, Task-Oriented, Special Topics
+References, Tutorials
+ *Learning Perl [2nd edition]
+ by Randal L. Schwartz and Tom Christiansen
+ with foreword by Larry Wall, Task-Oriented, Special Topics
=item Perl in Magazines
=item What mailing lists are there for perl?
-MacPerl, Perl5-Porters, NTPerl, Perl-Packrats
-
=item Archives of comp.lang.perl.misc
=item Where can I buy a commercial version of Perl?
=item Where do I send bug reports?
-=item What is perl.com? perl.org? The Perl Institute?
-
-=item How do I learn about object-oriented Perl programming?
+=item What is perl.com?
=back
=item AUTHOR AND COPYRIGHT
-=head2 perlfaq3 - Programming Tools ($Revision: 1.28 $, $Date: 1998/07/16
-22:08:49 $)
+=head2 perlfaq3 - Programming Tools ($Revision: 1.38 $, $Date: 1999/05/23
+16:08:30 $)
=item DESCRIPTION
=item Is there a ctags for Perl?
+=item Is there an IDE or Windows Perl Editor?
+
=item Where can I get Perl macros for vi?
=item Where can I get perl-mode for emacs?
=item How can I compile my Perl program into byte code or C?
+=item How can I compile Perl into Java?
+
=item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
=item Can I write useful perl programs on the command line?
=item AUTHOR AND COPYRIGHT
-=head2 perlfaq4 - Data Manipulation ($Revision: 1.25 $, $Date: 1998/07/16
-22:49:55 $)
+=head2 perlfaq4 - Data Manipulation ($Revision: 1.49 $, $Date: 1999/05/23
+20:37:49 $)
=item DESCRIPTION
=item Why isn't my octal data interpreted correctly?
-=item Does perl have a round function? What about ceil() and floor()?
+=item Does Perl have a round() function? What about ceil() and floor()?
Trig functions?
=item How do I convert bits into ints?
+=item Why doesn't & work the way I want it to?
+
=item How do I multiply matrices?
=item How do I perform an operation on a series of integers?
=item How do I find the week-of-the-year/day-of-the-year?
+=item How do I find the current century or millennium?
+
=item How can I compare two dates and find the difference?
=item How can I take a string and turn it into epoch seconds?
=item How can I find the Julian Day?
+=item How do I find yesterday's date?
+
=item Does Perl have a year 2000 problem? Is Perl Y2K compliant?
=back
=item How do I strip blank space from the beginning/end of a string?
+=item How do I pad a string with blanks or pad a number with zeroes?
+
=item How do I extract selected columns from a string?
=item How do I find the soundex value of a string?
=item What's wrong with always quoting "$vars"?
-=item Why don't my <<HERE documents work?
+=item Why don't my E<lt>E<lt>HERE documents work?
1. There must be no space after the << part, 2. There (probably) should be
a semicolon at the end, 3. You can't (easily) have any space in front of
=over
+=item What is the difference between a list and an array?
+
=item What is the difference between $array[1] and @array[1]?
-=item How can I extract just the unique elements of an array?
+=item How can I remove duplicate elements from a list or array?
a) If @in is sorted, and you want @out to be sorted:(this assumes all true
values in the array), b) If you don't know whether @in is sorted:, c) Like
=item How do I compute the difference of two arrays? How do I compute the
intersection of two arrays?
+=item How do I test whether two arrays or hashes are equal?
+
=item How do I find the first array element for which a condition is true?
=item How do I handle linked lists?
=item How do I verify a credit card checksum?
+=item How do I pack arrays of doubles or floats for XS code?
+
=back
=item AUTHOR AND COPYRIGHT
-=head2 perlfaq5 - Files and Formats ($Revision: 1.24 $, $Date: 1998/07/05
-15:07:20 $)
+=head2 perlfaq5 - Files and Formats ($Revision: 1.38 $, $Date: 1999/05/23
+16:08:30 $)
=item DESCRIPTION
=item How come when I open a file read-write it wipes it out?
-=item Why do I sometimes get an "Argument list too long" when I use <*>?
+=item Why do I sometimes get an "Argument list too long" when I use
+E<lt>*E<gt>?
=item Is there a leak/bug in glob()?
=item How can I lock a file?
-=item What can't I just open(FH, ">file.lock")?
+=item Why can't I just open(FH, ">file.lock")?
=item I still don't get locking. I just want to increment the number in
the file. How can I do this?
=item How do I print to more than one file at once?
+=item How can I read in an entire file all at once?
+
=item How can I read in a file by paragraphs?
=item How can I read a single character from a file? From the keyboard?
-=item How can I tell if there's a character waiting on a filehandle?
+=item How can I tell whether there's a character waiting on a filehandle?
=item How do I do a C<tail -f> in perl?
=item How do I select a random line from a file?
+=item Why do I get weird spaces when I print an array of lines?
+
=back
=item AUTHOR AND COPYRIGHT
-=head2 perlfaq6 - Regexps ($Revision: 1.22 $, $Date: 1998/07/16 14:01:07 $)
+=head2 perlfaq6 - Regexes ($Revision: 1.27 $, $Date: 1999/05/23 16:08:30 $)
=item DESCRIPTION
=item How can I hope to use regular expressions without creating illegible
and unmaintainable code?
-Comments Outside the Regexp, Comments Inside the Regexp, Different
-Delimiters
+Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
=item I'm having trouble matching over more than one line. What's wrong?
=item How can I match a locale-smart version of C</[a-zA-Z]/>?
-=item How can I quote a variable to use in a regexp?
+=item How can I quote a variable to use in a regex?
=item What is C</o> really for?
=item Can I use Perl regular expressions to match balanced text?
-=item What does it mean that regexps are greedy? How can I get around it?
+=item What does it mean that regexes are greedy? How can I get around it?
=item How do I process each word on each line?
=item What good is C<\G> in a regular expression?
-=item Are Perl regexps DFAs or NFAs? Are they POSIX compliant?
+=item Are Perl regexes DFAs or NFAs? Are they POSIX compliant?
=item What's wrong with using grep or map in a void context?
=item How can I match strings with multibyte characters?
+=item How do I match a pattern that is supplied by the user?
+
=back
=item AUTHOR AND COPYRIGHT
-=head2 perlfaq7 - Perl Language Issues ($Revision: 1.21 $, $Date:
-1998/06/22 15:20:07 $)
+=head2 perlfaq7 - Perl Language Issues ($Revision: 1.28 $, $Date:
+1999/05/23 20:36:18 $)
=item DESCRIPTION
=item Can I get a BNF/yacc/RE for the Perl language?
-=item What are all these $@%* punctuation signs, and how do I know when to
+=item What are all these $@%&* punctuation signs, and how do I know when to
use them?
=item Do I always/never have to quote my strings or use semicolons and
=item What is variable suicide and how can I prevent it?
=item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
-Regexp}?
+Regex}?
-Passing Variables and Functions, Passing Filehandles, Passing Regexps,
+Passing Variables and Functions, Passing Filehandles, Passing Regexes,
Passing Methods
=item How do I create a static variable?
-=item What's the difference between dynamic and lexical (static) scoping?
+=item What's the difference between dynamic and lexical (static) scoping?
Between local() and my()?
=item How can I access a dynamic variable while a similarly named lexical
=item What's the difference between deep and shallow binding?
-=item Why doesn't "my($foo) = <FILE>;" work right?
+=item Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?
=item How do I redefine a builtin function, operator, or method?
=item How can I comment out a large block of perl code?
+=item How do I clear a package?
+
+=item How can I use a variable as a variable name?
+
=back
=item AUTHOR AND COPYRIGHT
-=head2 perlfaq8 - System Interaction ($Revision: 1.25 $, $Date: 1998/07/05
-15:07:20 $)
+=head2 perlfaq8 - System Interaction ($Revision: 1.39 $, $Date: 1999/05/23
+18:37:57 $)
=item DESCRIPTION
=item How do I open a file without blocking?
-=item How do I install a CPAN module?
+=item How do I install a module from CPAN?
=item What's the difference between require and use?
=item How do I add a directory to my include path at runtime?
+=item What is socket.ph and where do I get it?
+
=back
=item AUTHOR AND COPYRIGHT
-=head2 perlfaq9 - Networking ($Revision: 1.20 $, $Date: 1998/06/22 18:31:09
+=head2 perlfaq9 - Networking ($Revision: 1.26 $, $Date: 1999/05/23 16:08:30
$)
=item DESCRIPTION
=item AUTHOR AND COPYRIGHT
-=head2 perldelta - what's new for perl5.005
+=head2 perldelta - what's new for perl5.006 (as of 5.005_56)
=item DESCRIPTION
-=item About the new versioning system
-
=item Incompatible Changes
=over
-=item WARNING: This version is not binary compatible with Perl 5.004.
-
-=item Default installation structure has changed
-
-=item Perl Source Compatibility
-
-=item C Source Compatibility
+=item Perl Source Incompatibilities
-Core sources now require ANSI C compiler, All Perl global variables must
-now be referenced with an explicit prefix, Enabling threads has source
-compatibility issues
+=item C Source Incompatibilities
-=item Binary Compatibility
+C<PERL_POLLUTE>, C<PERL_POLLUTE_MALLOC>, C<PL_na> and C<dTHR> Issues
-=item Security fixes may affect compatibility
+=item Compatible C Source API Changes
-=item Relaxed new mandatory warnings introduced in 5.004
+C<PATCHLEVEL> is now C<PERL_VERSION>
-=item Licensing
+=item Binary Incompatibilities
=back
=over
-=item Threads
-
-=item Compiler
-
-=item Regular Expressions
-
-Many new and improved optimizations, Many bug fixes, New regular expression
-constructs, New operator for precompiled regular expressions, Other
-improvements, Incompatible changes
-
-=item Improved malloc()
-
-=item Quicksort is internally implemented
-
-=item Reliable signals
-
-=item Reliable stack pointers
+=item Unicode and UTF-8 support
-=item More generous treatment of carriage returns
+=item Lexically scoped warning categories
-=item Memory leaks
+=item Binary numbers supported
-=item Better support for multiple interpreters
+=item syswrite() ease-of-use
-=item Behavior of local() on array and hash elements is now well-defined
+=item 64-bit support
-=item C<%!> is transparently tied to the L<Errno> module
+=item Better syntax checks on parenthesized unary operators
-=item Pseudo-hashes are supported
+=item Improved C<qw//> operator
-=item C<EXPR foreach EXPR> is supported
+=item pack() format 'Z' supported
-=item Keywords can be globally overridden
+=item pack() format modifier '!' supported
-=item C<$^E> is meaningful on Win32
+=item $^X variables may now have names longer than one character
-=item C<foreach (1..1000000)> optimized
-
-=item C<Foo::> can be used as implicitly quoted package name
-
-=item C<exists $Foo::{Bar::}> tests existence of a package
-
-=item Better locale support
-
-=item Experimental support for 64-bit platforms
-
-=item prototype() returns useful results on builtins
-
-=item Extended support for exception handling
-
-=item Re-blessing in DESTROY() supported for chaining DESTROY() methods
-
-=item All C<printf> format conversions are handled internally
-
-=item New C<INIT> keyword
-
-=item New C<lock> keyword
-
-=item New C<qr//> operator
-
-=item C<our> is now a reserved word
-
-=item Tied arrays are now fully supported
+=back
-=item Tied handles support is better
+=item Significant bug fixes
-=item 4th argument to substr
+=over
-=item Negative LENGTH argument to splice
+=item E<lt>HANDLEE<gt> on empty files
-=item Magic lvalues are now more magical
+=item C<eval '...'> improvements
-=item E<lt>E<gt> now reads in records
+=item Automatic flushing of output buffers
=back
=item Supported Platforms
-=over
-
-=item New Platforms
-
-=item Changes in existing support
-
-=back
+=item New tests
=item Modules and Pragmata
=over
-=item New Modules
+=item Modules
-B, Data::Dumper, Errno, File::Spec, ExtUtils::Installed,
-ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
-Thread, attrs, fields, re
+Dumpvalue, Benchmark, Devel::Peek, Fcntl, File::Spec,
+File::Spec::Functions, Math::BigInt, Math::Complex, Math::Trig, SDBM_File,
+Time::Local, Win32, DBM Filters
-=item Changes in existing modules
-
-CGI, POSIX, DB_File, MakeMaker, CPAN, Cwd, Benchmark
+=item Pragmata
=back
=item Documentation Changes
+perlopentut.pod, perlreftut.pod, perltootc.pod
+
=item New Diagnostics
-Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
-while coercing array into hash, Bareword "%s" refers to nonexistent
-package, Can't call method "%s" on an undefined value, Can't coerce array
-into hash, Can't goto subroutine from an eval-string, Can't localize
-pseudo-hash element, Can't use %%! because Errno.pm is not available,
-Cannot find an opnumber for "%s", Character class syntax [. .] is reserved
-for future extensions, Character class syntax [: :] is reserved for future
-extensions, Character class syntax [= =] is reserved for future extensions,
-%s: Eval-group in insecure regular expression, %s: Eval-group not allowed,
-use re 'eval', %s: Eval-group not allowed at run time, Explicit blessing to
-'' (assuming package main), Illegal hex digit ignored, No such array field,
-No such field "%s" in variable %s of type %s, Out of memory during
-ridiculously large request, Range iterator outside integer range, Recursive
-inheritance detected while looking for method '%s' in package '%s',
-Reference found where even-sized list expected, Undefined value assigned to
-typeglob, Use of reserved word "%s" is deprecated, perl: warning: Setting
-locale failed
+/%s/: Unrecognized escape \\%c passed through, Unrecognized escape \\%c
+passed through, Missing command in piped open, defined(@array) is
+deprecated (and not really meaningful), defined(%hash) is deprecated (and
+not really meaningful)
=item Obsolete Diagnostics
-Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
-temporary file
+=item Configuration Changes
=item BUGS
=item List value constructors
+=item Slices
+
=item Typeglobs and Filehandles
=back
+=item SEE ALSO
+
=head2 perlsyn - Perl syntax
=item DESCRIPTION
?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
-s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
-y/SEARCHLIST/REPLACEMENTLIST/cds
+s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cdsUC,
+y/SEARCHLIST/REPLACEMENTLIST/cdsUC
=item Gory details of parsing quoted constructs
=item Regular Expressions
-C<(?#text)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>, C<(?=pattern)>,
-C<(?!pattern)>, C<(?E<lt>=pattern)>, C<(?<!pattern)>, C<(?{ code })>,
-C<(?E<gt>pattern)>, C<(?(condition)yes-pattern|no-pattern)>,
-C<(?(condition)yes-pattern)>, C<(?imsx-imsx)>
+=item Extended Patterns
+
+C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
+C<(?=pattern)>, C<(?!pattern)>, C<(?E<lt>=pattern)>, C<(?<!pattern)>, C<(?{
+code })>, C<(?p{ code })>, C<(?E<gt>pattern)>,
+C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
=item Backtracking
=item Version 8 Regular Expressions
-=item WARNING on \1 vs $1
+=item Warning on \1 vs $1
=item Repeated patterns matching zero-length substring
=item Creating custom RE engines
-=item SEE ALSO
-
=back
+=item BUGS
+
+=item SEE ALSO
+
=head2 perlrun - how to execute the Perl interpreter
=item SYNOPSIS
=item #! and quoting on non-Unix systems
-OS/2, MS-DOS, Win95/NT, Macintosh
+OS/2, MS-DOS, Win95/NT, Macintosh, VMS
=item Location of Perl
-=item Switches
+=item Command Switches
B<-0>[I<digits>], B<-a>, B<-c>, B<-d>, B<-d:>I<foo>, B<-D>I<letters>,
B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>, B<-h>,
=item ENVIRONMENT
HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLLIB, PERL5DB, PERL5SHELL
-(specific to WIN32 port), PERL_DEBUG_MSTATS, PERL_DESTRUCT_LEVEL
+(specific to the Win32 port), PERL_DEBUG_MSTATS, PERL_DESTRUCT_LEVEL
=head2 perlfunc - Perl builtin functions
info, Time-related functions, Functions new in perl5, Functions obsoleted
in perl5
+=item Portability
+
=item Alphabetical Listing of Perl Functions
I<-X> FILEHANDLE, I<-X> EXPR, I<-X>, abs VALUE, abs, accept
chop LIST, chop, chown LIST, chr NUMBER, chr, chroot FILENAME, chroot,
close FILEHANDLE, close, closedir DIRHANDLE, connect SOCKET,NAME, continue
BLOCK, cos EXPR, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen
-HASH,DBNAME,MODE, defined EXPR, defined, delete EXPR, die LIST, do BLOCK,
-do SUBROUTINE(LIST), do EXPR, dump LABEL, each HASH, eof FILEHANDLE, eof
-(), eof, eval EXPR, eval BLOCK, exec LIST, exec PROGRAM LIST, exists EXPR,
-exit EXPR, exp EXPR, exp, fcntl FILEHANDLE,FUNCTION,SCALAR, fileno
+HASH,DBNAME,MASK, defined EXPR, defined, delete EXPR, die LIST, do BLOCK,
+do SUBROUTINE(LIST), do EXPR, dump LABEL, dump, each HASH, eof FILEHANDLE,
+eof (), eof, eval EXPR, eval BLOCK, exec LIST, exec PROGRAM LIST, exists
+EXPR, exit EXPR, exp EXPR, exp, fcntl FILEHANDLE,FUNCTION,SCALAR, fileno
FILEHANDLE, flock FILEHANDLE,OPERATION, fork, format, formline
PICTURE,LIST, getc FILEHANDLE, getc, getlogin, getpeername SOCKET, getpgrp
PID, getppid, getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME,
STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl
FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill LIST, last
LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length, link
-OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR, log
-EXPR, log, lstat FILEHANDLE, lstat EXPR, lstat, m//, map BLOCK LIST, map
-EXPR,LIST, mkdir FILENAME,MODE, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd
-ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, my EXPR, next LABEL, next, no
-Module LIST, oct EXPR, oct, open FILEHANDLE,EXPR, open FILEHANDLE, opendir
-DIRHANDLE,EXPR, ord EXPR, ord, pack TEMPLATE,LIST, package, package
+OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR, lock,
+log EXPR, log, lstat FILEHANDLE, lstat EXPR, lstat, m//, map BLOCK LIST,
+map EXPR,LIST, mkdir FILENAME,MASK, msgctl ID,CMD,ARG, msgget KEY,FLAGS,
+msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, my EXPR, next LABEL,
+next, no Module LIST, oct EXPR, oct, open FILEHANDLE,EXPR, open FILEHANDLE,
+opendir DIRHANDLE,EXPR, ord EXPR, ord, pack TEMPLATE,LIST, package, package
NAMESPACE, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos,
print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST,
printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/,
qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta,
rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
-readlink, readpipe EXPR, recv SOCKET,SCALAR,LEN,FLAGS, redo LABEL, redo,
+readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo,
ref EXPR, ref, rename OLDNAME,NEWNAME, require EXPR, require, reset EXPR,
reset, return EXPR, return, reverse LIST, rewinddir DIRHANDLE, rindex
STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, rmdir, s///, scalar
sysread FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH,
sysseek FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST,
syswrite FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite
-FILEHANDLE,SCALAR,LENGTH, tell FILEHANDLE, tell, telldir DIRHANDLE, tie
-VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate
-FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR,
-ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack
-TEMPLATE,EXPR, untie VARIABLE, unshift ARRAY,LIST, use Module LIST, use
-Module, use Module VERSION LIST, use VERSION, utime LIST, values HASH, vec
-EXPR,OFFSET,BITS, wait, waitpid PID,FLAGS, wantarray, warn LIST, write
-FILEHANDLE, write EXPR, write, y///
+FILEHANDLE,SCALAR,LENGTH, syswrite FILEHANDLE,SCALAR, tell FILEHANDLE,
+tell, telldir DIRHANDLE, tie VARIABLE,CLASSNAME,LIST, tied VARIABLE, time,
+times, tr///, truncate FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR,
+uc, ucfirst EXPR, ucfirst, umask EXPR, umask, undef EXPR, undef, unlink
+LIST, unlink, unpack TEMPLATE,EXPR, untie VARIABLE, unshift ARRAY,LIST, use
+Module LIST, use Module, use Module VERSION LIST, use VERSION, utime LIST,
+values HASH, vec EXPR,OFFSET,BITS, wait, waitpid PID,FLAGS, wantarray, warn
+LIST, write FILEHANDLE, write EXPR, write, y///
=back
=item Predefined Names
$ARG, $_, $E<lt>I<digits>E<gt>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
-$LAST_PAREN_MATCH, $+, $MULTILINE_MATCHING, $*, input_line_number HANDLE
-EXPR, $INPUT_LINE_NUMBER, $NR, $, input_record_separator HANDLE EXPR,
-$INPUT_RECORD_SEPARATOR, $RS, $/, autoflush HANDLE EXPR, $OUTPUT_AUTOFLUSH,
-$|, output_field_separator HANDLE EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
-output_record_separator HANDLE EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS, $\,
-$LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#,
-format_page_number HANDLE EXPR, $FORMAT_PAGE_NUMBER, $%,
-format_lines_per_page HANDLE EXPR, $FORMAT_LINES_PER_PAGE, $=,
-format_lines_left HANDLE EXPR, $FORMAT_LINES_LEFT, $-, format_name HANDLE
-EXPR, $FORMAT_NAME, $~, format_top_name HANDLE EXPR, $FORMAT_TOP_NAME, $^,
+$LAST_PAREN_MATCH, $+, @+, $MULTILINE_MATCHING, $*, input_line_number
+HANDLE EXPR, $INPUT_LINE_NUMBER, $NR, $, input_record_separator HANDLE
+EXPR, $INPUT_RECORD_SEPARATOR, $RS, $/, autoflush HANDLE EXPR,
+$OUTPUT_AUTOFLUSH, $|, output_field_separator HANDLE EXPR,
+$OUTPUT_FIELD_SEPARATOR, $OFS, $,, output_record_separator HANDLE EXPR,
+$OUTPUT_RECORD_SEPARATOR, $ORS, $\, $LIST_SEPARATOR, $",
+$SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#, format_page_number HANDLE
+EXPR, $FORMAT_PAGE_NUMBER, $%, format_lines_per_page HANDLE EXPR,
+$FORMAT_LINES_PER_PAGE, $=, format_lines_left HANDLE EXPR,
+$FORMAT_LINES_LEFT, $-, @-, format_name HANDLE EXPR, $FORMAT_NAME, $~,
+format_top_name HANDLE EXPR, $FORMAT_TOP_NAME, $^,
format_line_break_characters HANDLE EXPR, $FORMAT_LINE_BREAK_CHARACTERS,
$:, format_formfeed HANDLE EXPR, $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A,
$CHILD_ERROR, $?, $OS_ERROR, $ERRNO, $!, $EXTENDED_OS_ERROR, $^E,
$EVAL_ERROR, $@, $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<,
$EFFECTIVE_USER_ID, $EUID, $>, $REAL_GROUP_ID, $GID, $(,
$EFFECTIVE_GROUP_ID, $EGID, $), $PROGRAM_NAME, $0, $[, $PERL_VERSION, $],
-$DEBUGGING, $^D, $SYSTEM_FD_MAX, $^F, $^H, $INPLACE_EDIT, $^I, $^M,
-$OSNAME, $^O, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, $^R, $^S,
-$BASETIME, $^T, $WARNING, $^W, $EXECUTABLE_NAME, $^X, $ARGV, @ARGV, @INC,
-@_, %INC, %ENV $ENV{expr}, %SIG $SIG{expr}
+$COMPILING, $^C, $DEBUGGING, $^D, $SYSTEM_FD_MAX, $^F, $^H, $INPLACE_EDIT,
+$^I, $^M, $OSNAME, $^O, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20,
+$^R, $^S, $BASETIME, $^T, $WARNING, $^W, $EXECUTABLE_NAME, $^X, $ARGV,
+@ARGV, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr}
=item Error Indicators
+=item Technical Note on the Syntax of Variable Names
+
=back
+=item BUGS
+
=head2 perlsub - Perl subroutines
=item SYNOPSIS
=over
-=item Private Variables via C<my()>
+=item Private Variables via my()
=item Persistent Private Variables
=item When to Still Use local()
-1. You need to give a global variable a temporary value, especially C<$_>,
-2. You need to create a local file or directory handle or a local function,
-3. You want to temporarily change just one element of an array or hash
+1. You need to give a global variable a temporary value, especially $_, 2.
+You need to create a local file or directory handle or a local function, 3.
+You want to temporarily change just one element of an array or hash
=item Pass by Reference
=item Constant Functions
-=item Overriding Builtin Functions
+=item Overriding Built-in Functions
=item Autoloading
=item Pragmatic Modules
-use autouse MODULE => qw(sub1 sub2 sub3), blib, diagnostics, integer, less,
-lib, locale, ops, overload, re, sigtrap, strict, subs, vmsish, vars
+attrs, autouse, base, blib, constant, diagnostics, fields, filetest,
+integer, less, lib, locale, ops, overload, re, sigtrap, strict, subs, utf8,
+vars, vmsish, warnings
=item Standard Modules
-AnyDBM_File, AutoLoader, AutoSplit, Benchmark, CPAN, CPAN::FirstTime,
-CPAN::Nox, Carp, Class::Struct, Config, Cwd, DB_File, Devel::SelfStubber,
-DirHandle, DynaLoader, English, Env, Exporter, ExtUtils::Embed,
-ExtUtils::Install, ExtUtils::Liblist, ExtUtils::MM_OS2, ExtUtils::MM_Unix,
-ExtUtils::MM_VMS, ExtUtils::MakeMaker, ExtUtils::Manifest,
-ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::testlib, Fatal,
-Fcntl, File::Basename, File::CheckTree, File::Compare, File::Copy,
-File::Find, File::Path, File::stat, FileCache, FileHandle, FindBin,
-GDBM_File, Getopt::Long, Getopt::Std, I18N::Collate, IO, IO::File,
-IO::Handle, IO::Pipe, IO::Seekable, IO::Select, IO::Socket, IPC::Open2,
-IPC::Open3, Math::BigFloat, Math::BigInt, Math::Complex, Math::Trig,
-NDBM_File, Net::Ping, Net::hostent, Net::netent, Net::protoent,
-Net::servent, Opcode, Pod::Text, POSIX, SDBM_File, Safe, Search::Dict,
-SelectSaver, SelfLoader, Shell, Socket, Symbol, Sys::Hostname, Sys::Syslog,
-Term::Cap, Term::Complete, Term::ReadLine, Test::Harness, Text::Abbrev,
-Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Tie::Hash,
-Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::Local, Time::gmtime,
-Time::localtime, Time::tm, UNIVERSAL, User::grent, User::pwent
+AnyDBM_File, AutoLoader, AutoSplit, B, B::Asmdata, B::Assembler, B::Bblock,
+B::Bytecode, B::C, B::CC, B::Debug, B::Deparse, B::Disassembler, B::Lint,
+B::Showlex, B::Stackobj, B::Terse, B::Xref, Benchmark, CGI, CGI::Apache,
+CGI::Carp, CGI::Cookie, CGI::Fast, CGI::Push, CGI::Switch, CPAN,
+CPAN::FirstTime, CPAN::Nox, Carp, Class::Struct, Config, Cwd, DB, DB_File,
+Data::Dumper, Devel::Peek, Devel::SelfStubber, DirHandle, Dumpvalue,
+DynaLoader, English, Env, Errno, Exporter, ExtUtils::Command,
+ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist,
+ExtUtils::MM_OS2, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
+ExtUtils::MakeMaker, ExtUtils::Manifest, ExtUtils::Miniperl,
+ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::Packlist,
+ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::Compare, File::Copy,
+File::DosGlob, File::Find, File::Path, File::Spec, File::Spec::Functions,
+File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, File::Spec::VMS,
+File::Spec::Win32, File::stat, FileCache, FileHandle, FindBin, GDBM_File,
+Getopt::Long, Getopt::Std, I18N::Collate, IO, IO::Dir, IO::File,
+IO::Handle, IO::Pipe, IO::Poll, IO::Seekable, IO::Select, IO::Socket,
+IO::Socket::INET, IO::Socket::UNIX, IPC::Msg, IPC::Open2, IPC::Open3,
+IPC::Semaphore, IPC::SysV, Math::BigFloat, Math::BigInt, Math::Complex,
+Math::Trig, NDBM_File, Net::Ping, Net::hostent, Net::netent, Net::protoent,
+Net::servent, O, Opcode, POSIX, Pod::Html, Pod::Text, SDBM_File, Safe,
+Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Symbol,
+Sys::Hostname, Sys::Syslog, Term::Cap, Term::Complete, Term::ReadLine,
+Test, Test::Harness, Text::Abbrev, Text::ParseWords, Text::Soundex,
+Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
+unexpand(1), Text::Wrap, Thread, Thread::Queue, Thread::Semaphore,
+Thread::Signal, Thread::Specific, Tie::Array, Tie::Handle, Tie::Hash,
+Tie::StdHash, Tie::RefHash, Tie::Scalar, Tie::StdScalar, Tie::SubstrHash,
+Time::Local, Time::gmtime, Time::localtime, Time::tm, UNIVERSAL,
+User::grent, User::pwent
=item Extension Modules
=item Permanently fixing your locale configuration
-=item Permanently fixing system locale configuration
+=item Fixing system locale configuration
=item The localeconv function
=item ENVIRONMENT
-PERL_BADLANG, LC_ALL, LC_CTYPE, LC_COLLATE, LC_MONETARY, LC_NUMERIC,
-LC_TIME, LANG
+PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
+LC_NUMERIC, LC_TIME, LANG
=item NOTES
=head2 perlref - Perl references and nested data structures
+=item NOTE
+
=item DESCRIPTION
=over
=item SEE ALSO
+=head2 perlreftut - Mark's very short tutorial about references
+
+=item DESCRIPTION
+
+=item Who Needs Complicated Data Structures?
+
+=item The Solution
+
+=item Syntax
+
+=over
+
+=item Making References
+
+=item Using References
+
+=back
+
+=item An Example
+
+=item Arrow Rule
+
+=item Solution
+
+=item The Rest
+
+=item Summary
+
+=item Credits
+
+=over
+
+=item Distribution Conditions
+
+=back
+
=head2 perldsc - Perl Data Structures Cookbook
=item DESCRIPTION
=item CODE EXAMPLES
-=item LISTS OF LISTS
+=item ARRAYS OF ARRAYS
=over
-=item Declaration of a LIST OF LISTS
+=item Declaration of a ARRAY OF ARRAYS
-=item Generation of a LIST OF LISTS
+=item Generation of a ARRAY OF ARRAYS
-=item Access and Printing of a LIST OF LISTS
+=item Access and Printing of a ARRAY OF ARRAYS
=back
-=item HASHES OF LISTS
+=item HASHES OF ARRAYS
=over
-=item Declaration of a HASH OF LISTS
+=item Declaration of a HASH OF ARRAYS
-=item Generation of a HASH OF LISTS
+=item Generation of a HASH OF ARRAYS
-=item Access and Printing of a HASH OF LISTS
+=item Access and Printing of a HASH OF ARRAYS
=back
-=item LISTS OF HASHES
+=item ARRAYS OF HASHES
=over
-=item Declaration of a LIST OF HASHES
+=item Declaration of a ARRAY OF HASHES
-=item Generation of a LIST OF HASHES
+=item Generation of a ARRAY OF HASHES
-=item Access and Printing of a LIST OF HASHES
+=item Access and Printing of a ARRAY OF HASHES
=back
=item AUTHOR
-=head2 perllol, perlLoL - Manipulating Lists of Lists in Perl
+=head2 perllol - Manipulating Arrays of Arrays in Perl
=item DESCRIPTION
-=item Declaration and Access of Lists of Lists
+=item Declaration and Access of Arrays of Arrays
=item Growing Your Own
=back
+=head2 perltootc - Tom's OO Tutorial for Class Data in Perl
+
+=item DESCRIPTION
+
+=item Class Data as Package Variables
+
+=over
+
+=item Putting All Your Eggs in One Basket
+
+=item Inheritance Concerns
+
+=item The Eponymous Meta-Object
+
+=item Indirect References to Class Data
+
+=item Monadic Classes
+
+=item Translucent Attributes
+
+=back
+
+=item Class Data as Lexical Variables
+
+=over
+
+=item Privacy and Responsibility
+
+=item File-Scoped Lexicals
+
+=item More Inheritance Concerns
+
+=item Locking the Door and Throwing Away the Key
+
+=item Translucency Revisited
+
+=back
+
+=item NOTES
+
+=item SEE ALSO
+
+=item AUTHOR AND COPYRIGHT
+
+=item ACKNOWLEDGEMENTS
+
+=item HISTORY
+
=head2 perlobj - Perl objects
=item DESCRIPTION
=item Method Invocation
+=item WARNING
+
=item Default UNIVERSAL methods
isa(CLASS), can(METHOD), VERSION( [NEED] )
=item Destructors
-=item WARNING
-
=item Summary
=item Two-Phased Garbage Collection
=item SEE ALSO
+=head2 perldbmfilter - Perl DBM Filters
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
+B<filter_fetch_value>
+
+=over
+
+=item The Filter
+
+=item An Example -- the NULL termination problem.
+
+=item Another Example -- Key is a C int.
+
+=back
+
+=item SEE ALSO
+
+=item AUTHOR
+
=head2 perldebug - Perl debugging
=item DESCRIPTION
=item DESCRIPTION
-Not all Perl programs have to be portable, The vast majority of Perl B<is>
+Not all Perl programs have to be portable, Nearly all of Perl already I<is>
portable
=item ISSUES
=item Newlines
-=item File Paths
+=item Numbers endianness and Width
+
+=item Files and Filesystems
=item System Interaction
=item Time and Date
+=item Character sets and character encoding
+
+=item Internationalisation
+
=item System Resources
=item Security
=back
-=item CPAN TESTERS
+=item CPAN Testers
Mailing list: cpan-testers@perl.org, Testing results:
-C<http://www.connect.net/gbarr/cpan-test/>
+C<http://www.perl.org/cpan-testers/>
=item PLATFORMS
The djgpp environment for DOS, C<http://www.delorie.com/djgpp/>, The EMX
environment for DOS, OS/2, etc.
-C<emx@iaehv.nl>,C<http://www.leo.org/pub/comp/os/os2/leo/gnu/emx+gcc/index.html>,
-C<ftp://hobbes.nmsu.edu/pub/os2/dev/emx>. Build instructions
-for Win32, L<perlwin32>, The ActiveState Pages,
-C<http://www.activestate.com/>
+C<emx@iaehv.nl>,C<http://www.leo.org/pub/comp/os/os2/leo/gnu/emx+gcc/index.
+html> or
+C<ftp://hobbes.nmsu.edu/pub/os2/dev/emx>, Build instructions for Win32,
+L<perlwin32>, The ActiveState Pages, C<http://www.activestate.com/>
-=item MacPerl
+=item S<Mac OS>
-The MacPerl Pages, C<http://www.ptf.com/macperl/>, The MacPerl mailing
-list, C<mac-perl-request@iis.ee.ethz.ch>
+The MacPerl Pages, C<http://www.macperl.com/>, The MacPerl mailing lists,
+C<http://www.macperl.org/>, MacPerl Module Porters,
+C<http://pudge.net/mmp/>
=item VMS
-L<perlvms.pod>, vmsperl list, C<vmsperl-request@newman.upenn.edu>, vmsperl
-on the web, C<http://www.sidhe.org/vmsperl/index.html>
+L<perlvms.pod>, vmsperl list, C<majordomo@perl.org>, vmsperl on the web,
+C<http://www.sidhe.org/vmsperl/index.html>
+
+=item VOS
+
+L<README.vos>, VOS mailing list, VOS Perl on the web at
+C<http://ftp.stratus.com/pub/vos/vos.html>
=item EBCDIC Platforms
-perl-mvs list, AS/400 Perl information at C<http://as400.rochester.ibm.com>
+perl-mvs list, AS/400 Perl information at
+C<http://as400.rochester.ibm.com/>
+
+=item Acorn RISC OS
=item Other perls
Atari, Guido Flohr's page C<http://stud.uni-sb.de/~gufl0000/>, HP 300
-MPE/iX C<http://www.cccd.edu/~markb/perlix.html>, Novell Netware
+MPE/iX C<http://www.cccd.edu/~markb/perlix.html>, Novell Netware
=back
WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl
ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE, shmwrite
ID,STRING,POS,SIZE, socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat
-FILEHANDLE, stat EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, system
-LIST, times, truncate FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR,
-umask, utime LIST, wait, waitpid PID,FLAGS
+FILEHANDLE, stat EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
+FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
+FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
+wait, waitpid PID,FLAGS
=back
+=item CHANGES
+
+v1.43, 24 May 1999, v1.42, 22 May 1999, v1.41, 19 May 1999, v1.40, 11 April
+1999, v1.39, 11 February 1999, v1.38, 31 December 1998, v1.37, 19 December
+1998, v1.36, 9 September 1998, v1.35, 13 August 1998, v1.33, 06 August
+1998, v1.32, 05 August 1998, v1.30, 03 August 1998, v1.23, 10 July 1998
+
=item AUTHORS / CONTRIBUTORS
=item VERSION
FREETMPS, G_ARRAY, G_DISCARD, G_EVAL, GIMME, GIMME_V, G_NOARGS, G_SCALAR,
gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload, G_VOID, gv_stashpv,
gv_stashsv, GvSV, HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY,
-HeSVKEY_force, HeSVKEY_set, HeVAL, hv_clear, hv_delayfree_ent, hv_delete,
-hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent,
-hv_free_ent, hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext,
-hv_iternextsv, hv_iterval, hv_magic, HvNAME, hv_store, hv_store_ent,
-hv_undef, isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, items, ix,
-LEAVE, looks_like_number, MARK, mg_clear, mg_copy, mg_find, mg_free,
-mg_get, mg_len, mg_magical, mg_set, Move, PL_na, New, newAV, Newc,
-newCONSTSUB, newHV, newRV_inc, newRV_noinc, NEWSV, newSViv, newSVnv,
-newSVpv, newSVpvf, newSVpvn, newSVrv, newSVsv, newXS, newXSproto, Newz,
-Nullav, Nullch, Nullcv, Nullhv, Nullsv, ORIGMARK, perl_alloc,
-perl_call_argv, perl_call_method, perl_call_pv, perl_call_sv,
+HeSVKEY_force, HeSVKEY_set, HeVAL, hv_clear, hv_delete, hv_delete_ent,
+hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey,
+hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iterval, hv_magic, HvNAME,
+hv_store, hv_store_ent, hv_undef, isALNUM, isALPHA, isDIGIT, isLOWER,
+isSPACE, isUPPER, items, ix, LEAVE, looks_like_number, MARK, mg_clear,
+mg_copy, mg_find, mg_free, mg_get, mg_len, mg_magical, mg_set, modglobal,
+Move, PL_na, New, newAV, Newc, newCONSTSUB, newHV, newRV_inc, newRV_noinc,
+NEWSV, newSViv, newSVnv, newSVpv, newSVpvf, newSVpvn, newSVrv, newSVsv,
+newXS, newXSproto, Newz, Nullav, Nullch, Nullcv, Nullhv, Nullsv, ORIGMARK,
+perl_alloc, perl_call_argv, perl_call_method, perl_call_pv, perl_call_sv,
perl_construct, perl_destruct, perl_eval_sv, perl_eval_pv, perl_free,
perl_get_av, perl_get_cv, perl_get_hv, perl_get_sv, perl_parse,
perl_require_pv, perl_run, POPi, POPl, POPp, POPn, POPs, PUSHMARK, PUSHi,
strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, sv_2mortal, sv_bless,
sv_catpv, sv_catpv_mg, sv_catpvn, sv_catpvn_mg, sv_catpvf, sv_catpvf_mg,
sv_catsv, sv_catsv_mg, sv_chop, sv_cmp, SvCUR, SvCUR_set, sv_dec,
-sv_derived_from, sv_derived_from, SvEND, sv_eq, SvGETMAGIC, SvGROW,
-sv_grow, sv_inc, sv_insert, SvIOK, SvIOK_off, SvIOK_on, SvIOK_only, SvIOKp,
-sv_isa, sv_isobject, SvIV, SvIVX, SvLEN, sv_len, sv_magic, sv_mortalcopy,
+sv_derived_from, SvEND, sv_eq, SvGETMAGIC, SvGROW, sv_grow, sv_inc,
+sv_insert, SvIOK, SvIOK_off, SvIOK_on, SvIOK_only, SvIOKp, sv_isa,
+sv_isobject, SvIV, SvIVX, SvLEN, sv_len, sv_magic, sv_mortalcopy,
sv_newmortal, SvNIOK, SvNIOK_off, SvNIOKp, PL_sv_no, SvNOK, SvNOK_off,
SvNOK_on, SvNOK_only, SvNOKp, SvNV, SvNVX, SvOK, SvOOK, SvPOK, SvPOK_off,
-SvPOK_on, SvPOK_only, SvPOKp, SvPV, SvPV_force, SvPVX, SvREFCNT,
-SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSETMAGIC,
-sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv, sv_setpv_mg,
-sv_setpviv, sv_setpviv_mg, sv_setpvn, sv_setpvn_mg, sv_setpvf,
+SvPOK_on, SvPOK_only, SvPOKp, SvPV, SvPV_force, SvPV_nolen, SvPVX,
+SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV,
+SvSETMAGIC, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv,
+sv_setpv_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn, sv_setpvn_mg, sv_setpvf,
sv_setpvf_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv, sv_setref_pvn,
SvSetSV, SvSetSV_nosteal, sv_setsv, sv_setsv_mg, sv_setuv, sv_setuv_mg,
SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on, SVt_IV, SVt_PV,
=item THE PERL_CALL FUNCTIONS
-B<perl_call_sv>, B<perl_call_pv>, B<perl_call_method>, B<perl_call_argv>
+perl_call_sv, perl_call_pv, perl_call_method, perl_call_argv
=item FLAG VALUES
=item DESCRIPTION
+=head2 attrs - set/get attributes of a subroutine
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+method, locked
+
=head2 autouse - postpone load of modules until a function is used
=item SYNOPSIS
=item DESCRIPTION
+=item HISTORY
+
=item SEE ALSO
=head2 blib - Use MakeMaker's uninstalled version of a package
=item AUTHOR
+=head2 caller - inherit pragmatic attributes from the context of the caller
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+encoding
+
=head2 constant - Perl pragma to declare constants
=item SYNOPSIS
=item SEE ALSO
+=head2 filetest - Perl pragma to control the filetest permission operators
+
+=item SYNOPSIS
+
+ $can_perhaps_read = -r "file"; # use the mode bits
+ {
+ use filetest 'access'; # intuit harder
+ $can_really_read = -r "file";
+ }
+ $can_perhaps_read = -r "file"; # use the mode bits again
+
+=item DESCRIPTION
+
+=over
+
+=item subpragma access
+
+=back
+
=head2 integer - Perl pragma to compute arithmetic in integer instead of
double
=item DESCRIPTION
+=head2 ops - Perl pragma to restrict unsafe operations when compiling
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
=head2 overload - Package for overloading perl operations
=item SYNOPSIS
-=item CAVEAT SCRIPTOR
-
=item DESCRIPTION
=over
=item Calling Conventions for Unary Operations
+=item Calling Conventions for Mutators
+
+C<++> and C<-->, C<x=> and other assignment versions
+
=item Overloadable Operations
I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
-and numeric conversion>, I<Special>
+and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
=item Inheritance and overloading
I<Assignment forms of arithmetic operations>, I<Conversion operations>,
I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
-I<Concatenation>, I<Comparison operations>, I<Copy operator>
+I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
+I<Copy operator>
-=item WARNING
+=item Losing overloading
=item Run-time Overloading
=item IMPLEMENTATION
+=item Metaphor clash
+
+=item Cookbook
+
+=over
+
+=item Two-face scalars
+
+=item Two-face references
+
+=item Symbolic calculator
+
+=item I<Really> symbolic calculator
+
+=back
+
=item AUTHOR
=item DIAGNOSTICS
=item BUGS
+=head2 re - Perl pragma to alter regular expression behaviour
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
=head2 sigtrap - Perl pragma to enable simple signal handling
=item SYNOPSIS
=item DESCRIPTION
+=head2 utf8 - Perl pragma to turn on UTF-8 and Unicode support
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CAVEATS
+
=head2 vars - Perl pragma to predeclare global variable names
=item SYNOPSIS
=item DESCRIPTION
+=head2 warnings - Perl pragma to control optional warnings
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+C<warning deprecated>
+
=head1 MODULE DOCUMENTATION
=head2 AnyDBM_File - provide framework for multiple DBMs
=item B::CV METHODS
-STASH, START, ROOT, GV, FILEGV, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY
+STASH, START, ROOT, GV, FILEGV, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY,
+CvFLAGS
=item B::HV METHODS
other
-=item B::CONDOP METHODS
-
-true, false
-
=item B::LISTOP METHOD
children
=item FUNCTIONS EXPORTED BY C<B>
-main_cv, main_root, main_start, comppadlist, sv_undef, sv_yes, sv_no,
-walkoptree(OP, METHOD), walkoptree_debug(DEBUG), walksymtable(SYMREF,
-METHOD, RECURSE), svref_2object(SV), ppname(OPNUM), hash(STR), cast_I32(I),
-minus_c, cstring(STR), class(OBJ), threadsv_names, byteload_fh(FILEHANDLE)
+main_cv, init_av, main_root, main_start, comppadlist, sv_undef, sv_yes,
+sv_no, amagic_generation, walkoptree(OP, METHOD), walkoptree_debug(DEBUG),
+walksymtable(SYMREF, METHOD, RECURSE), svref_2object(SV), ppname(OPNUM),
+hash(STR), cast_I32(I), minus_c, cstring(STR), class(OBJ), threadsv_names
=item AUTHOR
B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-fstrip-syntax-tree>,
B<-On>, B<-D>, B<-Do>, B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-m>
+=item EXAMPLES
+
=item BUGS
=item AUTHOR
=item OPTIONS
-B<-p>, B<-u>I<PACKAGE>, B<-l>, B<-s>I<LETTERS>, B<C>
+B<-l>, B<-p>, B<-q>, B<-u>I<PACKAGE>, B<-s>I<LETTERS>, B<C>
=item BUGS
=item AUTHOR
+=head2 Bblock, B::Bblock - Walk basic blocks
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item AUTHOR
+
=head2 Benchmark - benchmark running times of code
=item SYNOPSIS
=item Standard Exports
timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
-timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
-TIMEDIFF, [ STYLE, [ FORMAT ] ] )
+timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timesum (
+T1, T2 ), timestr ( TIMEDIFF, [ STYLE, [ FORMAT ] ] )
=item Optional Exports
=item MODIFICATION HISTORY
-=head2 CGI - Simple Common Gateway Interface Class
+=head2 ByteLoader - load byte compiled perl code
=item SYNOPSIS
-=item ABSTRACT
-
=item DESCRIPTION
-=over
-
-=item PROGRAMMING STYLE
+=item AUTHOR
-=item CALLING CGI.PM ROUTINES
+=item SEE ALSO
-1. Use another name for the argument, if one is available. Forexample,
--value is an alias for -values, 2. Change the capitalization, e.g. -Values,
-3. Put quotes around the argument name, e.g. '-values'
+=head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
-=item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
+=item SYNOPSIS
-=item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
+=item DESCRIPTION
-=item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
+=item OPTIONS
-=item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
+B<-ofilename>, B<-->, B<-f>, B<-fcompress-nullops>,
+B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-fstrip-syntax-tree>,
+B<-On>, B<-D>, B<-Do>, B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-m>
+
+=item EXAMPLES
+
+=item BUGS
+
+=item AUTHOR
+
+=head2 CGI - Simple Common Gateway Interface Class
+
+=item SYNOPSIS
+
+=item ABSTRACT
+
+=item DESCRIPTION
+
+=over
+
+=item PROGRAMMING STYLE
+
+=item CALLING CGI.PM ROUTINES
+
+1. Use another name for the argument, if one is available. Forexample,
+-value is an alias for -values, 2. Change the capitalization, e.g. -Values,
+3. Put quotes around the argument name, e.g. '-values'
+
+=item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
+
+=item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
+
+=item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
+
+=item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
=item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
=item DIRECT ACCESS TO THE PARAMETER LIST:
+=item FETCHING THE PARAMETER LIST AS A HASH:
+
=item SAVING THE STATE OF THE SCRIPT TO A FILE:
+=item RETRIEVING CGI ERRORS
+
=item USING THE FUNCTION-ORIENTED INTERFACE
B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:netscape>, B<:html>,
=item PRAGMAS
--any, -compile, -nph, -autoload, -no_debug, -private_tempfiles
+-any, -compile, -nph, -newstyle_urls, -autoload, -no_debug,
+-private_tempfiles
+
+=item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
+
+1. start_table() (generates a <TABLE> tag), 2. end_table() (generates a
+</TABLE> tag), 3. start_ul() (generates a <UL> tag), 4. end_ul() (generates
+a </UL> tag)
=back
B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
(B<-query_string>)
+=item MIXING POST AND URL PARAMETERS
+
=back
=item CREATING STANDARD HTML ELEMENTS:
=item NON-STANDARD HTML SHORTCUTS
+=item PRETTY-PRINTING HTML
+
=back
=item CREATING FILL-OUT FORMS:
=back
-=item NETSCAPE COOKIES
+=item HTTP COOKIES
1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
-=item WORKING WITH NETSCAPE FRAMES
+=item WORKING WITH FRAMES
1. Create a <Frameset> document, 2. Specify the destination for the
document in the HTTP header, 3. Specify the destination for the document in
=item FETCHING ENVIRONMENT VARIABLES
-B<accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
+B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
B<path_translated()>, B<remote_host()>, B<script_name()>Return the script
name as a partial URL, for self-refering
scripts, B<referer()>, B<auth_type ()>, B<server_name ()>, B<virtual_host
()>, B<server_software ()>, B<remote_user ()>, B<user_name ()>,
-B<request_method()>
+B<request_method()>, B<content_type()>, B<http()>, B<https()>
=item USING NPH SCRIPTS
=item Server Push
multipart_init()
-multipart_init(-boundary=>$boundary);, multipart_start(), multipart_end()
+ multipart_init(-boundary=>$boundary);, multipart_start(), multipart_end()
=item Avoiding Denial of Service Attacks
Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
(james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
(mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
-(jh@axis.se), Laurent Delfosse (delfosse@csgrad1.cs.wvu.edu), Richard
-Resnick (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony
-Curtis (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom
-Christiansen (tchrist@convex.com), Andreas Koenig
-(k@franz.ww.TU-Berlin.DE), Tim MacKenzie (Tim.MacKenzie@fulcrum.com.au),
-Kevin B. Hendricks (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen
-(joyfire@inxpress.net), Ed Jordan (ed@fidalgo.net), David Alan Pisoni
-(david@cnation.com), Doug MacEachern (dougm@opengroup.org), Robin Houston
-(robin@oneworld.org), ...and many many more..
+(jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
+(applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
+(tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
+(tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
+MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
+(kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
+Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
+MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
+...and many many more..
=item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
=item INSTALLING CGI::Push SCRIPTS
-=item CAVEATS
-
=item AUTHOR INFORMATION
=item BUGS
expand($type,@things), Programming Examples
-=item Methods in the four
+=item Methods in the four Classes
=item Cache Manager
=item Debugging
-=item Floppy, Zip, and all that Jazz
+=item Floppy, Zip, Offline Mode
=back
=over
-=item CD-ROM support
+=item Note on urllist parameter's format
+
+=item urllist parameter has CD-ROM support
=back
=item EXPORT
+=item POPULATE AN INSTALLATION WITH LOTS OF MODULES
+
+=item WORKING WITH CPAN.pm BEHIND FIREWALLS
+
+http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
+
=item BUGS
=item AUTHOR
=back
+=item BUGS
+
=head2 Class::Struct - declare struct-like datatypes as Perl classes
=item SYNOPSIS
Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
+=item Initializing with C<new>
+
=back
=item EXAMPLES
-Example 1, Example 2
+Example 1, Example 2, Example 3
=item Author and Modification History
+=head2 Config - access Perl configuration information
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+myconfig(), config_sh(), config_vars(@names)
+
+=item EXAMPLE
+
+=item WARNING
+
+=item GLOSSARY
+
+=over
+
+=item _
+
+C<_a>, C<_exe>, C<_o>
+
+=item a
+
+C<afs>, C<alignbytes>, C<ansi2knr>, C<aphostname>, C<apiversion>, C<ar>,
+C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>, C<awk>
+
+=item b
+
+C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
+
+=item c
+
+C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
+C<ccsymbols>, C<cf_by>, C<cf_email>, C<cf_time>, C<chgrp>, C<chmod>,
+C<chown>, C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>,
+C<cpp>, C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>,
+C<cppminus>, C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crosscompile>,
+C<cryptlib>, C<csh>
+
+=item d
+
+C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>, C<d_attribut>,
+C<d_bcmp>, C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>,
+C<d_bzero>, C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>,
+C<d_chroot>, C<d_chsize>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>,
+C<d_crypt>, C<d_csh>, C<d_cuserid>, C<d_dbl_dig>, C<d_dbmclose64>,
+C<d_dbminit64>, C<d_delete64>, C<d_difftime>, C<d_dirent64_s>,
+C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>,
+C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>, C<d_endhent>,
+C<d_endnent>, C<d_endpent>, C<d_endpwent>, C<d_endsent>, C<d_eofnblk>,
+C<d_eunice>, C<d_fchmod>, C<d_fchown>, C<d_fcntl>, C<d_fd_macros>,
+C<d_fd_set>, C<d_fds_bits>, C<d_fetch64>, C<d_fgetpos64>, C<d_fgetpos>,
+C<d_firstkey64>, C<d_flexfnam>, C<d_flock64_s>, C<d_flock>, C<d_fopen64>,
+C<d_fork>, C<d_fpathconf>, C<d_freopen64>, C<d_fseek64>, C<d_fseeko64>,
+C<d_fseeko>, C<d_fsetpos64>, C<d_fsetpos>, C<d_fstat64>, C<d_fstatfs>,
+C<d_fstatvfs>, C<d_ftell64>, C<d_ftello64>, C<d_ftello>, C<d_ftime>,
+C<d_ftruncate64>, C<d_Gconvert>, C<d_getgrent>, C<d_getgrps>,
+C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
+C<d_gethostprotos>, C<d_getlogin>, C<d_getmntent>, C<d_getnbyaddr>,
+C<d_getnbyname>, C<d_getnent>, C<d_getnetprotos>, C<d_getpbyname>,
+C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>,
+C<d_getppid>, C<d_getprior>, C<d_getprotoprotos>, C<d_getpwent>,
+C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>, C<d_getservprotos>,
+C<d_gettimeod>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>,
+C<d_index>, C<d_inetaton>, C<d_ino64_t>, C<d_int64t>, C<d_iovec_s>,
+C<d_isascii>, C<d_killpg>, C<d_lchown>, C<d_link>, C<d_llseek>,
+C<d_locconv>, C<d_lockf64>, C<d_lockf>, C<d_longdbl>, C<d_longlong>,
+C<d_lseek64>, C<d_lstat64>, C<d_lstat>, C<d_madvise>, C<d_mblen>,
+C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>, C<d_memcpy>,
+C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkfifo>, C<d_mktime>, C<d_mmap>,
+C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>,
+C<d_msg_peek>, C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>,
+C<d_msgrcv>, C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>,
+C<d_nextkey64>, C<d_nice>, C<d_off64_t>, C<d_offset_t>,
+C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
+C<d_open3>, C<d_open64>, C<d_opendir64>, C<d_pathconf>, C<d_pause>,
+C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_pthread_yield>,
+C<d_pwage>, C<d_pwchange>, C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>,
+C<d_pwgecos>, C<d_pwpasswd>, C<d_pwquota>, C<d_readdir64>, C<d_readdir>,
+C<d_readlink>, C<d_readv>, C<d_recvmsg>, C<d_rename>, C<d_rewinddir>,
+C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, C<d_sanemcmp>, C<d_sched_yield>,
+C<d_scm_rights>, C<d_seekdir64>, C<d_seekdir>, C<d_select>, C<d_sem>,
+C<d_semctl>, C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>,
+C<d_semop>, C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>,
+C<d_setgrps>, C<d_sethent>, C<d_setlinebuf>, C<d_setlocale>, C<d_setnent>,
+C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>, C<d_setprior>,
+C<d_setpwent>, C<d_setregid>, C<d_setresgid>, C<d_setresuid>,
+C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, C<d_setsid>,
+C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>, C<d_shmatprototype>,
+C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>, C<d_sigsetjmp>,
+C<d_socket>, C<d_sockpair>, C<d_stat64>, C<d_statblks>, C<d_statfs>,
+C<d_statfsflags>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>,
+C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_store64>,
+C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>,
+C<d_strtod>, C<d_strtol>, C<d_strtoul>, C<d_strxfrm>, C<d_suidsafe>,
+C<d_symlink>, C<d_syscall>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>,
+C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir64>, C<d_telldir>,
+C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tmpfile64>, C<d_truncate64>,
+C<d_truncate>, C<d_tzname>, C<d_umask>, C<d_uname>, C<d_union_semun>,
+C<d_vfork>, C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>, C<d_volatile>,
+C<d_vprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>,
+C<d_writev>, C<d_xenix>, C<date>, C<db_hashtype>, C<db_prefixtype>,
+C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>, C<doublesize>,
+C<drand01>, C<dynamic_ext>
+
+=item e
+
+C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<eunicefix>,
+C<exe_ext>, C<expr>, C<extensions>
+
+=item f
+
+C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
+C<fpostype>, C<freetype>, C<full_ar>, C<full_csh>, C<full_sed>
+
+=item g
+
+C<gccversion>, C<gidtype>, C<glibpth>, C<grep>, C<groupcat>, C<groupstype>,
+C<gzip>
+
+=item h
+
+C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<huge>
+
+=item i
+
+C<i_arpainet>, C<i_bsdioctl>, C<i_db>, C<i_dbm>, C<i_dirent>, C<i_dld>,
+C<i_dlfcn>, C<i_fcntl>, C<i_float>, C<i_gdbm>, C<i_grp>, C<i_inttypes>,
+C<i_limits>, C<i_locale>, C<i_machcthr>, C<i_malloc>, C<i_math>,
+C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>, C<i_neterrno>,
+C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_pthread>, C<i_pwd>,
+C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_stdarg>, C<i_stddef>,
+C<i_stdlib>, C<i_string>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>,
+C<i_sysfilio>, C<i_sysin>, C<i_sysioctl>, C<i_sysmman>, C<i_sysmount>,
+C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>, C<i_sysselct>,
+C<i_syssockio>, C<i_sysstat>, C<i_sysstatvfs>, C<i_systime>, C<i_systimek>,
+C<i_systimes>, C<i_systypes>, C<i_sysuio>, C<i_sysun>, C<i_syswait>,
+C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_utime>, C<i_values>,
+C<i_varargs>, C<i_varhdr>, C<i_vfork>, C<ignore_versioned_solibs>,
+C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installman1dir>,
+C<installman3dir>, C<installprivlib>, C<installscript>, C<installsitearch>,
+C<installsitelib>, C<installusrbinperl>, C<intsize>
+
+=item k
+
+C<known_extensions>, C<ksh>
+
+=item l
+
+C<large>, C<ld>, C<lddlflags>, C<ldflags>, C<less>, C<lib_ext>, C<libc>,
+C<libperl>, C<libpth>, C<libs>, C<libswanted>, C<line>, C<lint>,
+C<lkflags>, C<ln>, C<lns>, C<locincpth>, C<loclibpth>, C<longdblsize>,
+C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
+C<lseektype>
+
+=item m
+
+C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
+C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
+C<man3direxp>, C<man3ext>
+
+=item M
+
+C<Mcc>, C<medium>, C<mips_type>, C<mkdir>, C<mmaptype>, C<models>,
+C<modetype>, C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>,
+C<myhostname>, C<myuname>
+
+=item n
+
+C<n>, C<netdb_hlen_type>, C<netdb_host_type>, C<netdb_name_type>,
+C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>, C<nonxs_ext>, C<nroff>
+
+=item o
+
+C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
+C<orderlib>, C<osname>, C<osvers>
+
+=item p
+
+C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl>,
+C<perladmin>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
+C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, C<privlibexp>,
+C<prototype>, C<ptrsize>
+
+=item r
+
+C<randbits>, C<randfunc>, C<randseedtype>, C<ranlib>, C<rd_nodata>, C<rm>,
+C<rmail>, C<runnm>
+
+=item s
+
+C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
+C<selectminbits>, C<selecttype>, C<sendmail>, C<sh>, C<shar>, C<sharpbang>,
+C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>, C<sig_count>,
+C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>, C<signal_t>,
+C<sitearch>, C<sitearchexp>, C<sitelib>, C<sitelibexp>, C<sizetype>,
+C<sleep>, C<smail>, C<small>, C<so>, C<sockethdr>, C<socketlib>, C<sort>,
+C<spackage>, C<spitshell>, C<split>, C<src>, C<ssizetype>, C<startperl>,
+C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>, C<stdio_bufsiz>,
+C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>, C<stdio_stream_array>,
+C<strings>, C<submit>, C<subversion>, C<sysman>
+
+=item t
+
+C<tail>, C<tar>, C<tbl>, C<tee>, C<test>, C<timeincl>, C<timetype>,
+C<touch>, C<tr>, C<trnl>, C<troff>
+
+=item u
+
+C<uidtype>, C<uname>, C<uniq>, C<use64bits>, C<usedl>, C<usemultiplicity>,
+C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>, C<useposix>,
+C<usesfio>, C<useshrplib>, C<usethreads>, C<usevfork>, C<usrinc>, C<uuname>
+
+=item v
+
+C<version>, C<vi>, C<voidflags>
+
+=item x
+
+C<xlibpth>
+
+=item z
+
+C<zcat>, C<zip>
+
+=back
+
+=item NOTE
+
=head2 Cwd, getcwd - get pathname of current working directory
=item SYNOPSIS
=item DESCRIPTION
+=head2 DB - programmatic interface to the Perl debugging API (draft,
+subject to
+change)
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over
+
+=item Global Variables
+
+ $DB::sub, %DB::sub, $DB::single, $DB::signal, $DB::trace, @DB::args,
+@DB::dbline, %DB::dbline, $DB::package, $DB::filename, $DB::subname,
+$DB::lineno
+
+=item API Methods
+
+CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
+CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
+
+=item Client Callback Methods
+
+CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
+CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
+CLIENT->output(LIST)
+
+=back
+
+=item BUGS
+
+=item AUTHOR
+
=head2 DB_File - Perl5 access to Berkeley DB version 1.x
=item SYNOPSIS
=item The get_dup() Method
+=item The find_dup() Method
+
+=item The del_dup() Method
+
=item Matching Partial Keys
=back
=item A Simple Example
-=item Extra Methods
+=item Extra RECNO Methods
B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>
=item Methods
-I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump I<or>
-I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dumpxs I<or>
+I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump I<or>
+I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dumpxs I<or>
I<PACKAGE>->Dumpxs(I<ARRAYREF [>, I<ARRAYREF]>),
I<$OBJ>->Seen(I<[HASHREF]>), I<$OBJ>->Values(I<[ARRAYREF]>),
I<$OBJ>->Names(I<[ARRAYREF]>), I<$OBJ>->Reset
=item SEE ALSO
+=head2 Devel::Peek - A data debugging tool for the XS programmer
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item EXAMPLES
+
+=over
+
+=item A simple scalar string
+
+=item A simple scalar number
+
+=item A simple scalar with an extra reference
+
+=item A reference to a simple scalar
+
+=item A reference to an array
+
+=item A reference to a hash
+
+=item Dumping a large array or hash
+
+=item A reference to an SV which holds a C pointer
+
+=item A reference to a subroutine
+
+=back
+
+=item EXPORTS
+
+=item BUGS
+
+=item AUTHOR
+
+=item SEE ALSO
+
=head2 Devel::SelfStubber - generate stubs for a SelfLoading module
=item SYNOPSIS
=item DESCRIPTION
+=head2 Dumpvalue - provides screen dump of Perl data.
+
+=item SYNOPSYS
+
+=item DESCRIPTION
+
+=over
+
+=item Creation
+
+C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
+C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<tick>, C<HighBit>,
+C<printUndef>, C<UsageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
+stopDbSignal
+
+=item Methods
+
+dumpValue, dumpValues, dumpvars, set_quote, set_unctrl, compactDump,
+veryCompact, set, get
+
+=back
+
+=head2 DynaLoader - Dynamically load C libraries into Perl code
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+@dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
+@dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
+dl_load_file(), dl_loadflags(), dl_find_symbol(),
+dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
+bootstrap()
+
+=item AUTHOR
+
=head2 English - use nice English (or awk) names for ugly punctuation
variables
=item AUTHOR
+=head2 Errno - System errno constants
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item AUTHOR
+
+=item COPYRIGHT
+
=head2 Exporter - Implements default import method for modules
=item SYNOPSIS
=item SEE ALSO
+=head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
+ExtUtils::MakeMaker
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+canonpath, cflags, manifypods, perl_archive
+
=head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
ExtUtils::MakeMaker
replace_manpage_separator, static (o), static_lib (o), staticmake (o),
subdir_x (o), subdirs (o), test (o), test_via_harness (o), test_via_script
(o), tool_autosplit (o), tools_other (o), tool_xsubpp (o), top_targets (o),
-writedoc, xs_c (o), xs_o (o), perl_archive, export_list
+writedoc, xs_c (o), xs_cpp (o), xs_o (o), perl_archive, export_list
=back
=item Using Attributes and Parameters
-C, CCFLAGS, CONFIG, CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS,
-EXCLUDE_EXT, EXE_FILES, NO_VC, FIRST_MAKEFILE, FULLPERL, H, IMPORTS, INC,
+AUTHOR, ABSTRACT, ABSTRACT_FROM, BINARY_LOCATION, C, CAPI, CCFLAGS, CONFIG,
+CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT,
+EXE_FILES, FIRST_MAKEFILE, FULLPERL, FUNCLIST, H, IMPORTS, INC,
INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR,
-INSTALLMAN3DIR, INSTALLPRIVLIB, INSTALLSCRIPT, INSTALLSITELIB,
-INSTALLSITEARCH, INST_ARCHLIB, INST_BIN, INST_EXE, INST_LIB, INST_MAN1DIR,
-INST_MAN3DIR, INST_SCRIPT, LDFROM, LIBPERL_A, LIB, LIBS, LINKTYPE,
+INSTALLMAN3DIR, INSTALLPRIVLIB, INSTALLSCRIPT, INSTALLSITEARCH,
+INSTALLSITELIB, INST_ARCHLIB, INST_BIN, INST_EXE, INST_LIB, INST_MAN1DIR,
+INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A, LIBS, LINKTYPE,
MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME,
-NEEDS_LINKING, NOECHO, NORECURS, OBJECT, OPTIMIZE, PERL, PERLMAINCC,
+NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE, PERL, PERLMAINCC,
PERL_ARCHLIB, PERL_LIB, PERL_SRC, PERM_RW, PERM_RWX, PL_FILES, PM,
-PMLIBDIRS, PREFIX, PREREQ_PM, SKIP, TYPEMAPS, VERSION, VERSION_FROM, XS,
-XSOPT, XSPROTOARG, XS_VERSION
+PMLIBDIRS, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT, PREFIX,
+PREREQ_PM, SKIP, TYPEMAPS, VERSION, VERSION_FROM, XS, XSOPT, XSPROTOARG,
+XS_VERSION
=item Additional lowercase attributes
-clean, depend, dist, dynamic_lib, installpm, linkext, macro, realclean,
+clean, depend, dist, dynamic_lib, linkext, macro, realclean, test,
tool_autosplit
=item Overriding MakeMaker Methods
=item Distribution Support
-make distcheck, make skipcheck, make distclean, make manifest,
-make distdir, make tardist, make dist, make uutardist, make
+ make distcheck, make skipcheck, make distclean, make manifest,
+ make distdir, make tardist, make dist, make uutardist, make
shdist, make zipdist, make ci
=item Disabling an extension
=back
+=item ENVIRONMENT
+
+PERL_MM_OPT
+
=item SEE ALSO
=item AUTHORS
=item AUTHOR
+=head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
=head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
=item SYNOPSIS
=item DESCRIPTION
-NAME, DL_FUNCS, DL_VARS, FILE, FUNCLIST, DLBASE
+DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
=item AUTHOR
=over
-=item Special behavior if C<syscopy> is defined (VMS and OS/2)
+=item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
rmscopy($from,$to[,$date_flag])
=item AUTHORS
-=item REVISION
-
=head2 File::Spec - portably perform operations on file names
=item SYNOPSIS
=item AUTHORS
+=head2 File::Spec::Functions - portably perform operations on file names
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over
+
+=item Exports
+
+=back
+
+=item SEE ALSO
+
=head2 File::Spec::Mac - File::Spec for MacOS
=item SYNOPSIS
=item METHODS
-canonpath, catdir, catfile, curdir, rootdir, updir, file_name_is_absolute,
-path
+canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
+file_name_is_absolute, path
=item SEE ALSO
=item METHODS
-canonpath, catdir, catfile, curdir, rootdir, updir, no_upwards,
-file_name_is_absolute, path, join, nativename
+canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
+no_upwards, file_name_is_absolute, path, join, splitpath, splitdir,
+catpath, abs2rel, rel2abs
=item SEE ALSO
=item Methods always loaded
-catdir, catfile, curdir (override), rootdir (override), updir (override),
-path (override), file_name_is_absolute (override)
+catdir, catfile, curdir (override), devnull (override), rootdir (override),
+tmpdir (override), updir (override), path (override), file_name_is_absolute
+(override)
=back
+=item SEE ALSO
+
=head2 File::Spec::Win32 - methods for Win32 file specs
=item SYNOPSIS
=item DESCRIPTION
-catfile, canonpath
+devnull, tmpdir, catfile, canonpath, splitpath, splitdir, catpath, abs2rel,
+rel2abs
+
+=item SEE ALSO
=head2 File::stat - by-name interface to Perl's built-in stat() functions
=item COPYRIGHT
-=item REVISION
-
=head2 GDBM_File - Perl5 access to the gdbm library.
=item SYNOPSIS
=item CONFIGURATION OPTIONS
default, auto_abbrev, getopt_compat, require_order, permute, bundling
-(default: reset), bundling_override (default: reset), ignore_case
+(default: reset), bundling_override (default: reset), ignore_case
(default: set), ignore_case_always (default: reset), pass_through (default:
reset), prefix, prefix_pattern, debug (default: reset)
=item DESCRIPTION
-=head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
+=head2 IO::Dir - supply object methods for directory handles
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
+rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=head2 IO::File - supply object methods for filehandles
=item SYNOPSIS
=item CONSTRUCTOR
-new ([ ARGS ] ), new_tmpfile
+new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
=item METHODS
=item HISTORY
-=head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
-handles
+=head2 IO::Handle - supply object methods for I/O handles
=item SYNOPSIS
=item METHODS
-$fh->fdopen ( FD, MODE ), $fh->opened, $fh->getline, $fh->getlines,
-$fh->ungetc ( ORD ), $fh->write ( BUF, LEN [, OFFSET }\] ), $fh->flush,
-$fh->error, $fh->clearerr, $fh->untaint
+$io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
+$io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
+$io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
+$io->blocking ( [ BOOL ] ), $io->untaint
=item NOTE
=item HISTORY
-=head2 IO::lib::IO::Pipe, IO::pipe - supply object methods for pipes
+=head2 IO::Pipe - supply object methods for pipes
=item SYNOPSIS
=item DESCRIPTION
-=item CONSTRCUTOR
+=item CONSTRUCTOR
new ( [READER, WRITER] )
=item COPYRIGHT
-=head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
-I/O objects
+=head2 IO::Poll - Object interface to system poll call
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item METHODS
+
+mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
+IO ), handles( [ EVENT_MASK ] )
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=head2 IO::Seekable - supply seek based methods for I/O objects
=item SYNOPSIS
=item HISTORY
-=head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
-call
+=head2 IO::Select - OO interface to the select system call
=item SYNOPSIS
=item METHODS
add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
-[ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_error ( [ TIMEOUT ] ), count
-(), bits(), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
+[ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
+count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
=item EXAMPLE
=item COPYRIGHT
-=head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
-communications
+=head2 IO::Socket - Object interface to socket communications
=item SYNOPSIS
=item METHODS
accept([PKG]), timeout([VAL]), sockopt(OPT [, VAL]), sockdomain, socktype,
-protocol
+protocol, connected
-=item SUB-CLASSES
+=item SEE ALSO
-=over
+=item AUTHOR
-=item IO::Socket::INET
+=item COPYRIGHT
-=item METHODS
+=head2 IO::Socket::INET - Object interface for AF_INET domain sockets
-sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
-()
+=item SYNOPSIS
-=item IO::Socket::UNIX
+=item DESCRIPTION
-=item METHODS
+=item CONSTRUCTOR
-hostpath(), peerpath()
+new ( [ARGS] )
-=back
+=over
+
+=item METHODS
+
+sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
+()
+
+=back
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CONSTRUCTOR
+
+new ( [ARGS] )
+
+=item METHODS
+
+hostpath(), peerpath()
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
+handles
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
+rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CONSTRUCTOR
+
+new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
+
+=item METHODS
+
+open( FILENAME [,MODE [,PERMS]] )
+
+=item SEE ALSO
+
+=item HISTORY
+
+=head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
+handles
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CONSTRUCTOR
+
+new (), new_from_fd ( FD, MODE )
+
+=item METHODS
+
+$io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
+$io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
+$io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
+$io->blocking ( [ BOOL ] ), $io->untaint
+
+=item NOTE
+
+=item SEE ALSO
+
+=item BUGS
+
+=item HISTORY
+
+=head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CONSTRUCTOR
+
+new ( [READER, WRITER] )
+
+=item METHODS
+
+reader ([ARGS]), writer ([ARGS]), handles ()
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item METHODS
+
+mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
+IO ), handles( [ EVENT_MASK ] )
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
+I/O objects
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=item HISTORY
+
+=head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
+call
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CONSTRUCTOR
+
+new ( [ HANDLES ] )
+
+=item METHODS
+
+add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
+[ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
+count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
+
+=item EXAMPLE
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
+communications
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CONSTRUCTOR
+
+new ( [ARGS] )
+
+=item METHODS
+
+accept([PKG]), timeout([VAL]), sockopt(OPT [, VAL]), sockdomain, socktype,
+protocol, connected
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
+AF_INET domain sockets
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CONSTRUCTOR
+
+new ( [ARGS] )
+
+=over
+
+=item METHODS
+
+sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
+()
+
+=back
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
+AF_UNIX domain sockets
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CONSTRUCTOR
+
+new ( [ARGS] )
+
+=item METHODS
+
+hostpath(), peerpath()
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=head2 IPC::Msg - SysV Msg IPC object class
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item METHODS
+
+new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
+( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
+FLAGS ] ), stat
=item SEE ALSO
=item WARNING
+=head2 IPC::Semaphore - SysV Semaphore IPC object class
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item METHODS
+
+new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
+getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
+set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
+, VALUE ), stat
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
=head2 IPC::SysV - SysV IPC constants
=item SYNOPSIS
=item DESCRIPTION
-number format, Error returns 'NaN', Division is computed to
+number format, Error returns 'NaN', Division is computed to, Rounding is
+performed
=item BUGS
=item AUTHOR
+=head2 O - Generic interface to Perl Compiler backends
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CONVENTIONS
+
+=item IMPLEMENTATION
+
+=item AUTHOR
+
=head2 ODBM_File - Tied access to odbm files
=item SYNOPSIS
=head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
compiling
-=item SYNOPSIS
+=item SYNOPSIS
=item DESCRIPTION
=item CREATION
+=head2 Pod::Checker, podchecker() - check pod documents for syntax errors
+
+=item SYNOPSIS
+
+=item OPTIONS/ARGUMENTS
+
+=item DESCRIPTION
+
+=item EXAMPLES
+
+=item AUTHOR
+
=head2 Pod::Html - module to convert pod files to HTML
=item SYNOPSIS
=item ARGUMENTS
-help, htmlroot, infile, outfile, podroot, podpath, libpods, netscape,
-nonetscape, index, noindex, recurse, norecurse, title, verbose
+help, htmldir, htmlroot, infile, outfile, podroot, podpath, libpods,
+netscape, nonetscape, index, noindex, recurse, norecurse, title, verbose
=item EXAMPLE
=item COPYRIGHT
+=head2 Pod::InputObjects - objects representing POD input paragraphs,
+commands, etc.
+
+=item SYNOPSIS
+
+=item REQUIRES
+
+=item EXPORTS
+
+=item DESCRIPTION
+
+B<Pod::InputSource>, B<Pod::Paragraph>, B<Pod::InteriorSequence>,
+B<Pod::ParseTree>
+
+=item B<Pod::InputSource>
+
+=over
+
+=item B<new()>
+
+=item B<name()>
+
+=item B<handle()>
+
+=item B<was_cutting()>
+
+=back
+
+=item B<Pod::Paragraph>
+
+=over
+
+=item B<new()>
+
+=item B<cmd_name()>
+
+=item B<text()>
+
+=item B<raw_text()>
+
+=item B<cmd_prefix()>
+
+=item B<cmd_separator()>
+
+=item B<parse_tree()>
+
+=item B<file_line()>
+
+=back
+
+=item B<Pod::InteriorSequence>
+
+=over
+
+=item B<new()>
+
+=item B<cmd_name()>
+
+=item B<prepend()>
+
+=item B<append()>
+
+=item B<nested()>
+
+=item B<raw_text()>
+
+=item B<left_delimiter()>
+
+=item B<right_delimiter()>
+
+=item B<parse_tree()>
+
+=item B<file_line()>
+
+=item B<DESTROY()>
+
+=back
+
+=item B<Pod::ParseTree>
+
+=over
+
+=item B<new()>
+
+=item B<top()>
+
+=item B<children()>
+
+=item B<prepend()>
+
+=item B<append()>
+
+=item B<raw_text()>
+
+=item B<DESTROY()>
+
+=back
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=head2 Pod::Parser - base class for creating POD filters and translators
+
+=item SYNOPSIS
+
+=item REQUIRES
+
+=item EXPORTS
+
+=item DESCRIPTION
+
+=item QUICK OVERVIEW
+
+=item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
+
+=item B<command()>
+
+C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
+
+=item B<verbatim()>
+
+C<$text>, C<$line_num>, C<$pod_para>
+
+=item B<textblock()>
+
+C<$text>, C<$line_num>, C<$pod_para>
+
+=item B<interior_sequence()>
+
+=item OPTIONAL SUBROUTINE/METHOD OVERRIDES
+
+=item B<new()>
+
+=item B<initialize()>
+
+=item B<begin_pod()>
+
+=item B<begin_input()>
+
+=item B<end_input()>
+
+=item B<end_pod()>
+
+=item B<preprocess_line()>
+
+=item B<preprocess_paragraph()>
+
+=item METHODS FOR PARSING AND PROCESSING
+
+=item B<parse_text()>
+
+B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
+I<code-ref>|I<method-name>
+
+=item B<interpolate()>
+
+=item B<parse_paragraph()>
+
+=item B<parse_from_filehandle()>
+
+=item B<parse_from_file()>
+
+=item ACCESSOR METHODS
+
+=item B<cutting()>
+
+=item B<output_file()>
+
+=item B<output_handle()>
+
+=item B<input_file()>
+
+=item B<input_handle()>
+
+=item B<input_streams()>
+
+=item B<top_stream()>
+
+=item PRIVATE METHODS AND DATA
+
+=item B<_push_input_stream()>
+
+=item B<_pop_input_stream()>
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=head2 Pod::PlainText, pod2plaintext - function to convert POD data to
+formatted ASCII text
+
+=item SYNOPSIS
+
+=item REQUIRES
+
+=item EXPORTS
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=head2 Pod::Select, podselect() - extract selected sections of POD from
+input
+
+=item SYNOPSIS
+
+=item REQUIRES
+
+=item EXPORTS
+
+=item DESCRIPTION
+
+=item SECTION SPECIFICATIONS
+
+=item RANGE SPECIFICATIONS
+
+=item OBJECT METHODS
+
+=item B<curr_headings()>
+
+=item B<select()>
+
+=item B<add_selection()>
+
+=item B<clear_selections()>
+
+=item B<match_section()>
+
+=item B<is_selected()>
+
+=item EXPORTED FUNCTIONS
+
+=item B<podselect()>
+
+B<-output>, B<-sections>, B<-ranges>
+
+=item PRIVATE METHODS AND DATA
+
+=item B<_compile_section_spec()>
+
+=over
+
+=item $self->{_SECTION_HEADINGS}
+
+=item $self->{_SELECTED_SECTIONS}
+
+=back
+
+=item SEE ALSO
+
+=item AUTHOR
+
=head2 Pod::Text - convert POD data to formatted ASCII text
=item SYNOPSIS
=item TODO
+=head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
+documentation
+
+=item SYNOPSIS
+
+=item ARGUMENTS
+
+C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
+C<-pathlist>
+
+=item DESCRIPTION
+
+=item EXAMPLES
+
+=over
+
+=item Recommended Use
+
+=back
+
+=item CAVEATS
+
+=item AUTHOR
+
+=item ACKNOWLEDGEMENTS
+
=head2 SDBM_File - Tied access to sdbm files
=item SYNOPSIS
=item DESCRIPTION
+=head2 Safe - Compile and execute code in restricted compartments
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+a new namespace, an operator mask
+
+=item WARNING
+
+=over
+
+=item RECENT CHANGES
+
+=item Methods in class Safe
+
+permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
+...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
+(PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
+root (NAMESPACE), mask (MASK)
+
+=item Some Safety Issues
+
+Memory, CPU, Snooping, Signals, State Changes
+
+=item AUTHOR
+
+=back
+
=head2 Search::Dict, look - search for key in dictionary file
=item SYNOPSIS
=item ENVIRONMENT
-=head2 Test - provides a simple framework for writing test scripts
+=head2 Test - provides a simple framework for writing test scripts
=item SYNOPSIS
NORMAL TESTS, SKIPPED TESTS, TODO TESTS
+=item RETURN VALUE
+
=item ONFAIL
=item SEE ALSO
=item EXAMPLE
-=item BUGS
-
=item AUTHOR
=head2 Thread - multithreading
new \&start_sub, new \&start_sub, LIST, lock VARIABLE, async BLOCK;,
Thread->self, Thread->list, cond_wait VARIABLE, cond_signal VARIABLE,
-cond_broadcast VARIABLE
+cond_broadcast VARIABLE, yield
=item METHODS
-join, eval, tid
+join, eval, detach, equal, tid
=item LIMITATIONS
=item SYNOPSIS
+=item DESCRIPTION
+
=head2 Tie::Array - base class for tied arrays
-=item SYNOPSIS
+=item SYNOPSIS
-=item DESCRIPTION
+=item DESCRIPTION
TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
FETCHSIZE this, STORESIZE this, count, EXTEND this, count, CLEAR this,
=item AUTHOR
-=head2 Tie::Handle - base class definitions for tied handles
+=head2 Tie::Handle, Tie::StdHandle - base class definitions for tied
+handles
=item SYNOPSIS
TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
-READLINE this, GETC this, DESTROY this
+READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
+EOF this, TELL this, SEEK this, offset, whence, DESTROY this
=item MORE INFORMATION
=item DESCRIPTION
+=item IMPLEMENTATION
+
+=item BUGS
+
=head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
function