=back
+=head2 perlbook - Perl book information
+
+=over
+
+=item DESCRIPTION
+
+=back
+
=head2 perlsyn - Perl syntax
=over
bless REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE,
chomp LIST, chomp, chop VARIABLE, 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,
+connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt PLAINTEXT,SALT,
dbmclose HASH, dbmopen 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,
FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill SIGNAL, LIST,
last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length,
link 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, mkdir FILENAME, msgctl
-ID,CMD,ARG, msgget KEY,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd
-ID,MSG,FLAGS, my EXPR, my EXPR : ATTRIBUTES, next LABEL, next, no Module
-LIST, oct EXPR, oct, open FILEHANDLE,MODE,LIST, open FILEHANDLE,EXPR, open
-FILEHANDLE, opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, 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,LENGTH,FLAGS, redo LABEL, redo, ref EXPR, ref, rename
-OLDNAME,NEWNAME, require VERSION, 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
-EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir DIRHANDLE,POS, select
-FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, semctl
-ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
+lock, log EXPR, log, lstat EXPR, lstat, m//, map BLOCK LIST, map EXPR,LIST,
+mkdir FILENAME,MASK, mkdir FILENAME, msgctl ID,CMD,ARG, msgget KEY,FLAGS,
+msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my EXPR :
+ATTRIBUTES, next LABEL, next, no Module LIST, oct EXPR, oct, open
+FILEHANDLE,MODE,LIST, open FILEHANDLE,EXPR, open FILEHANDLE, opendir
+DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, pack TEMPLATE,LIST, package
+NAMESPACE, package, 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,LENGTH,FLAGS, redo LABEL, redo,
+ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, 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 EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir
+DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT,
+semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
=back
-=head2 perllol - Manipulating Arrays of Arrays in Perl
-
-=over
-
-=item DESCRIPTION
-
-=item Declaration and Access of Arrays of Arrays
-
-=item Growing Your Own
-
-=item Access and Printing
-
-=item Slices
-
-=item SEE ALSO
-
-=item AUTHOR
-
-=back
-
=head2 perlrequick - Perl regular expressions quick start
=over
=back
-=head2 perlretut - Perl regular expressions tutorial
+=head2 perlpod - plain old documentation
=over
=item DESCRIPTION
-=item Part 1: The basics
-
=over
-=item Simple word matching
+=item Verbatim Paragraph
-=item Using character classes
+=item Command Paragraph
-\d is a digit and represents [0-9], \s is a whitespace character and
-represents [\ \t\r\n\f], \w is a word character (alphanumeric or _) and
-represents [0-9a-zA-Z_], \D is a negated \d; it represents any character
-but a digit [^0-9], \S is a negated \s; it represents any non-whitespace
-character [^\s], \W is a negated \w; it represents any non-word character
-[^\w], The period '.' matches any character but "\n", no modifiers (//):
-Default behavior. C<'.'> matches any character except C<"\n">. C<^>
-matches only at the beginning of the string and C<$> matches only at the
-end or before a newline at the end, s modifier (//s): Treat string as a
-single long line. C<'.'> matches any character, even C<"\n">. C<^>
-matches only at the beginning of the string and C<$> matches only at the
-end or before a newline at the end, m modifier (//m): Treat string as a set
-of multiple lines. C<'.'> matches any character except C<"\n">. C<^> and
-C<$> are able to match at the start or end of I<any> line within the
-string, both s and m modifiers (//sm): Treat string as a single long line,
-but detect multiple lines. C<'.'> matches any character, even C<"\n">.
-C<^> and C<$>, however, are able to match at the start or end of I<any>
-line within the string
+=item Ordinary Block of Text
-=item Matching this or that
+=item The Intent
-=item Grouping things and hierarchical matching
+=item Embedding Pods in Perl Modules
-0 Start with the first letter in the string 'a', 1 Try the first
-alternative in the first group 'abd', 2 Match 'a' followed by 'b'. So far
-so good, 3 'd' in the regexp doesn't match 'c' in the string - a dead end.
-So backtrack two characters and pick the second alternative in the first
-group 'abc', 4 Match 'a' followed by 'b' followed by 'c'. We are on a roll
-and have satisfied the first group. Set $1 to 'abc', 5 Move on to the
-second group and pick the first alternative 'df', 6 Match the 'd', 7 'f' in
-the regexp doesn't match 'e' in the string, so a dead end. Backtrack one
-character and pick the second alternative in the second group 'd', 8 'd'
-matches. The second grouping is satisfied, so set $2 to 'd', 9 We are at
-the end of the regexp, so we are done! We have matched 'abcd' out of the
-string "abcde"
+=item Common Pod Pitfalls
-=item Extracting matches
+=back
-=item Matching repetitions
+=item SEE ALSO
-C<a?> = match 'a' 1 or 0 times, C<a*> = match 'a' 0 or more times, i.e.,
-any number of times, C<a+> = match 'a' 1 or more times, i.e., at least
-once, C<a{n,m}> = match at least C<n> times, but not more than C<m> times,
-C<a{n,}> = match at least C<n> or more times, C<a{n}> = match exactly C<n>
-times, Principle 0: Taken as a whole, any regexp will be matched at the
-earliest possible position in the string, Principle 1: In an alternation
-C<a|b|c...>, the leftmost alternative that allows a match for the whole
-regexp will be the one used, Principle 2: The maximal matching quantifiers
-C<?>, C<*>, C<+> and C<{n,m}> will in general match as much of the string
-as possible while still allowing the whole regexp to match, Principle 3: If
-there are two or more elements in a regexp, the leftmost greedy quantifier,
-if any, will match as much of the string as possible while still allowing
-the whole regexp to match. The next leftmost greedy quantifier, if any,
-will try to match as much of the string remaining available to it as
-possible, while still allowing the whole regexp to match. And so on, until
-all the regexp elements are satisfied, C<a??> = match 'a' 0 or 1 times. Try
-0 first, then 1, C<a*?> = match 'a' 0 or more times, i.e., any number of
-times, but as few times as possible, C<a+?> = match 'a' 1 or more times,
-i.e., at least once, but as few times as possible, C<a{n,m}?> = match at
-least C<n> times, not more than C<m> times, as few times as possible,
-C<a{n,}?> = match at least C<n> times, but as few times as possible,
-C<a{n}?> = match exactly C<n> times. Because we match exactly C<n> times,
-C<a{n}?> is equivalent to C<a{n}> and is just there for notational
-consistency, Principle 3: If there are two or more elements in a regexp,
-the leftmost greedy (non-greedy) quantifier, if any, will match as much
-(little) of the string as possible while still allowing the whole regexp to
-match. The next leftmost greedy (non-greedy) quantifier, if any, will try
-to match as much (little) of the string remaining available to it as
-possible, while still allowing the whole regexp to match. And so on, until
-all the regexp elements are satisfied, 0 Start with the first letter in the
-string 't', 1 The first quantifier '.*' starts out by matching the whole
-string 'the cat in the hat', 2 'a' in the regexp element 'at' doesn't match
-the end of the string. Backtrack one character, 3 'a' in the regexp
-element 'at' still doesn't match the last letter of the string 't', so
-backtrack one more character, 4 Now we can match the 'a' and the 't', 5
-Move on to the third element '.*'. Since we are at the end of the string
-and '.*' can match 0 times, assign it the empty string, 6 We are done!
+=item AUTHOR
-=item Building a regexp
+=back
-specifying the task in detail,, breaking down the problem into smaller
-parts,, translating the small parts into regexps,, combining the regexps,,
-and optimizing the final combined regexp
+=head2 perlstyle - Perl style guide
-=item Using regular expressions in Perl
+=over
+
+=item DESCRIPTION
=back
-=item Part 2: Power tools
+=head2 perltrap - Perl traps for the unwary
=over
-=item More on characters, strings, and character classes
+=item DESCRIPTION
-=item Compiling and saving regular expressions
+=over
-=item Embedding comments and modifiers in a regular expression
+=item Awk Traps
-=item Non-capturing groupings
+=item C Traps
-=item Looking ahead and looking behind
+=item Sed Traps
-=item Using independent subexpressions to prevent backtracking
+=item Shell Traps
-=item Conditional expressions
+=item Perl Traps
-=item A bit of magic: executing Perl code in a regular expression
+=item Perl4 to Perl5 Traps
-=item Pragmas and debugging
+Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
+Traps, General data type traps, Context Traps - scalar, list contexts,
+Precedence Traps, General Regular Expression Traps using s///, etc,
+Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
-=back
+=item Discontinuance, Deprecation, and BugFix traps
-=item BUGS
+Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
+Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
+Discontinuance, Deprecation, Discontinuance, Discontinuance
-=item SEE ALSO
+=item Parsing Traps
-=item AUTHOR AND COPYRIGHT
+Parsing, Parsing, Parsing, Parsing
-=over
+=item Numerical Traps
-=item Acknowledgments
+Numerical, Numerical, Numerical, Bitwise string ops
+
+=item General data type traps
+
+(Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String),
+(Constants), (Scalars), (Variable Suicide)
+
+=item Context Traps - scalar, list contexts
+
+(list context), (scalar context), (scalar context), (list, builtin)
+
+=item Precedence Traps
+
+Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
+Precedence
+
+=item General Regular Expression Traps using s///, etc.
+
+Regular Expression, Regular Expression, Regular Expression, Regular
+Expression, Regular Expression, Regular Expression, Regular Expression,
+Regular Expression
+
+=item Subroutine, Signal, Sorting Traps
+
+(Signals), (Sort Subroutine), warn() won't let you specify a filehandle
+
+=item OS Traps
+
+(SysV), (SysV)
+
+=item Interpolation Traps
+
+Interpolation, Interpolation, Interpolation, Interpolation, Interpolation,
+Interpolation, Interpolation, Interpolation, Interpolation
+
+=item DBM Traps
+
+DBM, DBM
+
+=item Unclassified Traps
+
+C<require>/C<do> trap using returned value, C<split> on empty string with
+LIMIT specified
=back
=item Command Switches
-B<-0>[I<digits>], B<-a>, B<-C>, B<-c>, B<-d>, B<-d:>I<foo>,
+B<-0>[I<digits>], B<-a>, B<-C>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>,
B<-D>I<letters>, B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>,
B<-h>, B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
=back
+=head2 perldiag - various Perl diagnostics
+
+=over
+
+=item DESCRIPTION
+
+=back
+
=head2 perllexwarn - Perl Lexical Warnings
=over
=back
+=head2 perldebtut - Perl debugging tutorial
+
+=over
+
+=item DESCRIPTION
+
+=item use strict
+
+=item Looking at data and -w and w
+
+=item help
+
+=item Stepping through code
+
+=item Placeholder for a, w, t, T
+
+=item REGULAR EXPRESSIONS
+
+=item OUTPUT TIPS
+
+=item CGI
+
+=item GUIs
+
+=item SUMMARY
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item CONTRIBUTORS
+
+=back
+
=head2 perldebug - Perl debugging
=over
=back
-=head2 perlopentut - tutorial on opening things in Perl
+=head2 perlvar - Perl predefined variables
=over
=item DESCRIPTION
-=item Open E<agrave> la shell
-
-=over
-
-=item Simple Opens
-
-=item Pipe Opens
-
-=item The Minus File
-
-=item Mixing Reads and Writes
-
-=item Filters
-
-=back
-
-=item Open E<agrave> la C
-
=over
-=item Permissions E<agrave> la mode
-
-=back
+=item Predefined Names
+
+$ARG, $_, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
+$LAST_PAREN_MATCH, $+, @LAST_MATCH_END, @+, $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, $-, @LAST_MATCH_START, @-, C<$`> is the same as
+C<substr($var, 0, $-[0])>, C<$&> is the same as C<substr($var, $-[0], $+[0]
+- $-[0])>, C<$'> is the same as C<substr($var, $+[0])>, C<$1> is the same
+as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2> is the same as
+C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as C<substr $var,
+$-[3], $+[3] - $-[3])>, 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, $[, $], $COMPILING, $^C,
+$DEBUGGING, $^D, $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M,
+$OSNAME, $^O, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
+0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R, $EXCEPTIONS_BEING_CAUGHT, $^S,
+$BASETIME, $^T, $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS},
+${^WIDE_SYSTEM_CALLS}, $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
+
+=back
+
+=head2 perllol - Manipulating Arrays of Arrays in Perl
+
+=over
+
+=item DESCRIPTION
+
+=item Declaration and Access of Arrays of Arrays
+
+=item Growing Your Own
+
+=item Access and Printing
+
+=item Slices
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=back
+
+=head2 perlopentut - tutorial on opening things in Perl
+
+=over
+
+=item DESCRIPTION
+
+=item Open E<agrave> la shell
+
+=over
+
+=item Simple Opens
+
+=item Pipe Opens
+
+=item The Minus File
+
+=item Mixing Reads and Writes
+
+=item Filters
+
+=back
+
+=item Open E<agrave> la C
+
+=over
+
+=item Permissions E<agrave> la mode
+
+=back
=item Obscure Open Tricks
=back
-=head2 perlvar - Perl predefined variables
+=head2 perlretut - Perl regular expressions tutorial
=over
=item DESCRIPTION
+=item Part 1: The basics
+
=over
-=item Predefined Names
+=item Simple word matching
-$ARG, $_, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
-$LAST_PAREN_MATCH, $+, @LAST_MATCH_END, @+, $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, $-, @LAST_MATCH_START, @-, C<$`> is the same as
-C<substr($var, 0, $-[0])>, C<$&> is the same as C<substr($var, $-[0], $+[0]
-- $-[0])>, C<$'> is the same as C<substr($var, $+[0])>, C<$1> is the same
-as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2> is the same as
-C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as C<substr $var,
-$-[3], $+[3] - $-[3])>, 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, $[, $], $COMPILING, $^C,
-$DEBUGGING, $^D, $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M,
-$OSNAME, $^O, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
-0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R, $EXCEPTIONS_BEING_CAUGHT, $^S,
-$BASETIME, $^T, $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS},
-${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, $ARGV, @ARGV, @INC, @_, %INC,
-%ENV, $ENV{expr}, %SIG, $SIG{expr}
+=item Using character classes
-=item Error Indicators
+\d is a digit and represents [0-9], \s is a whitespace character and
+represents [\ \t\r\n\f], \w is a word character (alphanumeric or _) and
+represents [0-9a-zA-Z_], \D is a negated \d; it represents any character
+but a digit [^0-9], \S is a negated \s; it represents any non-whitespace
+character [^\s], \W is a negated \w; it represents any non-word character
+[^\w], The period '.' matches any character but "\n", no modifiers (//):
+Default behavior. C<'.'> matches any character except C<"\n">. C<^>
+matches only at the beginning of the string and C<$> matches only at the
+end or before a newline at the end, s modifier (//s): Treat string as a
+single long line. C<'.'> matches any character, even C<"\n">. C<^>
+matches only at the beginning of the string and C<$> matches only at the
+end or before a newline at the end, m modifier (//m): Treat string as a set
+of multiple lines. C<'.'> matches any character except C<"\n">. C<^> and
+C<$> are able to match at the start or end of I<any> line within the
+string, both s and m modifiers (//sm): Treat string as a single long line,
+but detect multiple lines. C<'.'> matches any character, even C<"\n">.
+C<^> and C<$>, however, are able to match at the start or end of I<any>
+line within the string
-=item Technical Note on the Syntax of Variable Names
+=item Matching this or that
-=back
+=item Grouping things and hierarchical matching
-=item BUGS
+0 Start with the first letter in the string 'a', 1 Try the first
+alternative in the first group 'abd', 2 Match 'a' followed by 'b'. So far
+so good, 3 'd' in the regexp doesn't match 'c' in the string - a dead end.
+So backtrack two characters and pick the second alternative in the first
+group 'abc', 4 Match 'a' followed by 'b' followed by 'c'. We are on a roll
+and have satisfied the first group. Set $1 to 'abc', 5 Move on to the
+second group and pick the first alternative 'df', 6 Match the 'd', 7 'f' in
+the regexp doesn't match 'e' in the string, so a dead end. Backtrack one
+character and pick the second alternative in the second group 'd', 8 'd'
+matches. The second grouping is satisfied, so set $2 to 'd', 9 We are at
+the end of the regexp, so we are done! We have matched 'abcd' out of the
+string "abcde"
+
+=item Extracting matches
+
+=item Matching repetitions
+
+C<a?> = match 'a' 1 or 0 times, C<a*> = match 'a' 0 or more times, i.e.,
+any number of times, C<a+> = match 'a' 1 or more times, i.e., at least
+once, C<a{n,m}> = match at least C<n> times, but not more than C<m> times,
+C<a{n,}> = match at least C<n> or more times, C<a{n}> = match exactly C<n>
+times, Principle 0: Taken as a whole, any regexp will be matched at the
+earliest possible position in the string, Principle 1: In an alternation
+C<a|b|c...>, the leftmost alternative that allows a match for the whole
+regexp will be the one used, Principle 2: The maximal matching quantifiers
+C<?>, C<*>, C<+> and C<{n,m}> will in general match as much of the string
+as possible while still allowing the whole regexp to match, Principle 3: If
+there are two or more elements in a regexp, the leftmost greedy quantifier,
+if any, will match as much of the string as possible while still allowing
+the whole regexp to match. The next leftmost greedy quantifier, if any,
+will try to match as much of the string remaining available to it as
+possible, while still allowing the whole regexp to match. And so on, until
+all the regexp elements are satisfied, C<a??> = match 'a' 0 or 1 times. Try
+0 first, then 1, C<a*?> = match 'a' 0 or more times, i.e., any number of
+times, but as few times as possible, C<a+?> = match 'a' 1 or more times,
+i.e., at least once, but as few times as possible, C<a{n,m}?> = match at
+least C<n> times, not more than C<m> times, as few times as possible,
+C<a{n,}?> = match at least C<n> times, but as few times as possible,
+C<a{n}?> = match exactly C<n> times. Because we match exactly C<n> times,
+C<a{n}?> is equivalent to C<a{n}> and is just there for notational
+consistency, Principle 3: If there are two or more elements in a regexp,
+the leftmost greedy (non-greedy) quantifier, if any, will match as much
+(little) of the string as possible while still allowing the whole regexp to
+match. The next leftmost greedy (non-greedy) quantifier, if any, will try
+to match as much (little) of the string remaining available to it as
+possible, while still allowing the whole regexp to match. And so on, until
+all the regexp elements are satisfied, 0 Start with the first letter in the
+string 't', 1 The first quantifier '.*' starts out by matching the whole
+string 'the cat in the hat', 2 'a' in the regexp element 'at' doesn't match
+the end of the string. Backtrack one character, 3 'a' in the regexp
+element 'at' still doesn't match the last letter of the string 't', so
+backtrack one more character, 4 Now we can match the 'a' and the 't', 5
+Move on to the third element '.*'. Since we are at the end of the string
+and '.*' can match 0 times, assign it the empty string, 6 We are done!
+
+=item Building a regexp
+
+specifying the task in detail,, breaking down the problem into smaller
+parts,, translating the small parts into regexps,, combining the regexps,,
+and optimizing the final combined regexp
+
+=item Using regular expressions in Perl
=back
-=head2 perlmod - Perl modules (packages and symbol tables)
+=item Part 2: Power tools
=over
-=item DESCRIPTION
+=item More on characters, strings, and character classes
-=over
+=item Compiling and saving regular expressions
-=item Packages
+=item Embedding comments and modifiers in a regular expression
-=item Symbol Tables
+=item Non-capturing groupings
-=item Package Constructors and Destructors
+=item Looking ahead and looking behind
-=item Perl Classes
+=item Using independent subexpressions to prevent backtracking
-=item Perl Modules
+=item Conditional expressions
+
+=item A bit of magic: executing Perl code in a regular expression
+
+=item Pragmas and debugging
=back
+=item BUGS
+
=item SEE ALSO
+=item AUTHOR AND COPYRIGHT
+
+=over
+
+=item Acknowledgments
+
=back
-=head2 perlpod - plain old documentation
+=back
+
+=head2 perlre - Perl regular expressions
=over
=item DESCRIPTION
+i, m, s, x
+
=over
-=item Verbatim Paragraph
+=item Regular Expressions
-=item Command Paragraph
+cntrl, graph, print, punct, xdigit
-=item Ordinary Block of Text
+=item Extended Patterns
-=item The Intent
+C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
+C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
+code })>, C<(??{ code })>, C<< (?>pattern) >>,
+C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
-=item Embedding Pods in Perl Modules
+=item Backtracking
-=item Common Pod Pitfalls
+=item Version 8 Regular Expressions
-=back
+=item Warning on \1 vs $1
-=item SEE ALSO
+=item Repeated patterns matching zero-length substring
-=item AUTHOR
+=item Combining pieces together
-=back
+C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
+C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
+C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
+C<(?(condition)yes-pattern|no-pattern)>
-=head2 perlstyle - Perl style guide
+=item Creating custom RE engines
-=over
+=back
-=item DESCRIPTION
+=item BUGS
+
+=item SEE ALSO
=back
-=head2 perlmodlib - constructing new Perl modules and finding existing ones
+=head2 perlref - Perl references and nested data structures
=over
-=item DESCRIPTION
+=item NOTE
-=item THE PERL MODULE LIBRARY
+=item DESCRIPTION
=over
-=item Pragmatic Modules
+=item Making References
-attributes, attrs, autouse, base, blib, bytes, charnames, constant,
-diagnostics, fields, filetest, integer, less, locale, open, ops, overload,
-re, sigtrap, strict, subs, utf8, vars, warnings
+=item Using References
-=item Standard Modules
+=item Symbolic references
-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, ByteLoader, CGI,
-CGI::Apache, CGI::Carp, CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push,
-CGI::Switch, CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy,
-Class::Struct, Cwd, DB, DB_File, Devel::SelfStubber, DirHandle, Dumpvalue,
-English, Env, Exporter, Exporter::Heavy, ExtUtils::Command,
-ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist,
-ExtUtils::MM_Cygwin, ExtUtils::MM_OS2, ExtUtils::MM_Unix, ExtUtils::MM_VMS,
-ExtUtils::MM_Win32, ExtUtils::MakeMaker, ExtUtils::Manifest,
-ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::Packlist,
-ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree,
-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::Temp,
-File::stat, FileCache, FileHandle, FindBin, Getopt::Long, Getopt::Std,
-I18N::Collate, IO, IPC::Open2, IPC::Open3, Math::BigFloat, Math::BigInt,
-Math::Complex, Math::Trig, NDBM_File, Net::Ping, Net::hostent, Net::netent,
-Net::protoent, Net::servent, O, ODBM_File, Opcode, Pod::Checker, Pod::Find,
-Pod::Html, Pod::InputObjects, Pod::LaTeX, Pod::Man, Pod::ParseUtils,
-Pod::Parser, Pod::Plainer, Pod::Select, Pod::Text, Pod::Text::Color,
-Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe, Search::Dict, SelectSaver,
-SelfLoader, Shell, Socket, Symbol, Term::ANSIColor, Term::Cap,
-Term::Complete, Term::ReadLine, Test, Test::Harness, Text::Abbrev,
-Text::ParseWords, Text::Soundex, Text::Wrap, Tie::Array, Tie::Handle,
-Tie::Hash, Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::Local,
-Time::gmtime, Time::localtime, Time::tm, UNIVERSAL, User::grent,
-User::pwent
+=item Not-so-symbolic references
-=item Extension Modules
+=item Pseudo-hashes: Using an array as a hash
+
+=item Function Templates
=back
-=item CPAN
+=item WARNING
-Language Extensions and Documentation Tools, Development Support, Operating
-System Interfaces, Networking, Device Control (modems) and InterProcess
-Communication, Data Types and Data Type Utilities, Database Interfaces,
-User Interfaces, Interfaces to / Emulations of Other Programming Languages,
-File Names, File Systems and File Locking (see also File Handles), String
-Processing, Language Text Processing, Parsing, and Searching, Option,
-Argument, Parameter, and Configuration File Processing,
-Internationalization and Locale, Authentication, Security, and Encryption,
-World Wide Web, HTML, HTTP, CGI, MIME, Server and Daemon Utilities,
-Archiving and Compression, Images, Pixmap and Bitmap Manipulation, Drawing,
-and Graphing, Mail and Usenet News, Control Flow Utilities (callbacks and
-exceptions etc), File Handle and Input/Output Stream Utilities,
-Miscellaneous Modules, Africa, Asia, Australasia, Central America, Europe,
-North America, South America
+=item SEE ALSO
-=item Modules: Creation, Use, and Abuse
+=back
+
+=head2 perlform - Perl formats
=over
-=item Guidelines for Module Creation
+=item DESCRIPTION
-Do similar modules already exist in some form?, Try to design the new
-module to be easy to extend and reuse, Some simple style guidelines, Select
-what to export, Select a name for the module, Have you got it right?,
-README and other Additional Files, A description of the
-module/package/extension etc, A copyright notice - see below, Prerequisites
-- what else you may need to have, How to build it - possible changes to
-Makefile.PL etc, How to install it, Recent changes in this release,
-especially incompatibilities, Changes / enhancements you plan to make in
-the future, Adding a Copyright Notice, Give the module a
-version/issue/release number, How to release and distribute a module, Take
-care when changing a released module
+=over
-=item Guidelines for Converting Perl 4 Library Scripts into Modules
+=item Format Variables
-There is no requirement to convert anything, Consider the implications,
-Make the most of the opportunity, The pl2pm utility will get you started,
-Adds the standard Module prologue lines, Converts package specifiers from '
-to ::, Converts die(...) to croak(...), Several other minor changes
+=back
-=item Guidelines for Reusing Application Code
+=item NOTES
-Complete applications rarely belong in the Perl Module Library, Many
-applications contain some Perl code that could be reused, Break-out the
-reusable code into one or more separate module files, Take the opportunity
-to reconsider and redesign the interfaces, In some cases the 'application'
-can then be reduced to a small
+=over
+
+=item Footers
+
+=item Accessing Formatting Internals
=back
-=item NOTE
+=item WARNINGS
=back
-=head2 perlmodinstall - Installing CPAN Modules
+=head2 perlboot - Beginner's Object-Oriented Tutorial
=over
=over
-=item PREAMBLE
+=item If we could talk to the animals...
-B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
-module (sometimes unnecessary), B<INSTALL> the module
+=item Introducing the method invocation arrow
-=back
+=item Invoking a barnyard
-=item HEY
+=item The extra parameter of method invocation
-=item AUTHOR
+=item Calling a second method to simplify things
-=item COPYRIGHT
+=item Inheriting the windpipes
-=back
+=item A few notes about @ISA
+
+=item Overriding the methods
+
+=item Starting the search from a different place
-=head2 perlnewmod - preparing a new module for distribution
+=item The SUPER way of doing things
-=over
+=item Where we're at so far...
-=item DESCRIPTION
+=item A horse is a horse, of course of course -- or is it?
-=over
+=item Invoking an instance method
-=item Warning
+=item Accessing the instance data
-=item What should I make into a module?
+=item How to build a horse
-=item Step-by-step: Preparing the ground
+=item Inheriting the constructor
-Look around, Check it's new, Discuss the need, Choose a name, Check again
+=item Making a method work with either classes or instances
-=item Step-by-step: Making the module
+=item Adding parameters to a method
-Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use
-L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old
-documentation|perlpod>, Write tests, Write the README
+=item More interesting instances
-=item Step-by-step: Distributing your module
+=item A horse of a different color
-Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
-tarball, Announce to the modules list, Announce to clpa, Fix bugs!
+=item Summary
=back
-=item AUTHOR
-
=item SEE ALSO
+=item COPYRIGHT
+
=back
-=head2 perltrap - Perl traps for the unwary
+=head2 perltoot - Tom's object-oriented tutorial for perl
=over
=item DESCRIPTION
-=over
-
-=item Awk Traps
-
-=item C Traps
-
-=item Sed Traps
-
-=item Shell Traps
-
-=item Perl Traps
-
-=item Perl4 to Perl5 Traps
+=item Creating a Class
-Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
-Traps, General data type traps, Context Traps - scalar, list contexts,
-Precedence Traps, General Regular Expression Traps using s///, etc,
-Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
+=over
-=item Discontinuance, Deprecation, and BugFix traps
+=item Object Representation
-Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
-Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
-Discontinuance, Deprecation, Discontinuance, Discontinuance
+=item Class Interface
-=item Parsing Traps
+=item Constructors and Instance Methods
-Parsing, Parsing, Parsing, Parsing
+=item Planning for the Future: Better Constructors
-=item Numerical Traps
+=item Destructors
-Numerical, Numerical, Numerical, Bitwise string ops
+=item Other Object Methods
-=item General data type traps
+=back
-(Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String),
-(Constants), (Scalars), (Variable Suicide)
+=item Class Data
-=item Context Traps - scalar, list contexts
+=over
-(list context), (scalar context), (scalar context), (list, builtin)
+=item Accessing Class Data
-=item Precedence Traps
+=item Debugging Methods
-Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
-Precedence
+=item Class Destructors
-=item General Regular Expression Traps using s///, etc.
+=item Documenting the Interface
-Regular Expression, Regular Expression, Regular Expression, Regular
-Expression, Regular Expression, Regular Expression, Regular Expression,
-Regular Expression
+=back
-=item Subroutine, Signal, Sorting Traps
+=item Aggregation
-(Signals), (Sort Subroutine), warn() won't let you specify a filehandle
+=item Inheritance
-=item OS Traps
+=over
-(SysV), (SysV)
+=item Overridden Methods
-=item Interpolation Traps
+=item Multiple Inheritance
-Interpolation, Interpolation, Interpolation, Interpolation, Interpolation,
-Interpolation, Interpolation, Interpolation, Interpolation
+=item UNIVERSAL: The Root of All Objects
-=item DBM Traps
+=back
-DBM, DBM
+=item Alternate Object Representations
-=item Unclassified Traps
+=over
-C<require>/C<do> trap using returned value, C<split> on empty string with
-LIMIT specified
+=item Arrays as Objects
-=back
+=item Closures as Objects
=back
-=head2 perlport - Writing portable Perl
+=item AUTOLOAD: Proxy Methods
=over
-=item DESCRIPTION
-
-Not all Perl programs have to be portable, Nearly all of Perl already I<is>
-portable
-
-=item ISSUES
+=item Autoloaded Data Methods
-=over
+=item Inherited Autoloaded Data Methods
-=item Newlines
+=back
-=item Numbers endianness and Width
+=item Metaclassical Tools
-=item Files and Filesystems
+=over
-=item System Interaction
+=item Class::Struct
-=item Interprocess Communication (IPC)
+=item Data Members as Variables
-=item External Subroutines (XS)
+=item NOTES
-=item Standard Modules
+=item Object Terminology
-=item Time and Date
+=back
-=item Character sets and character encoding
+=item SEE ALSO
-=item Internationalisation
+=item AUTHOR AND COPYRIGHT
-=item System Resources
+=item COPYRIGHT
-=item Security
+=over
-=item Style
+=item Acknowledgments
=back
-=item CPAN Testers
-
-Mailing list: cpan-testers@perl.org, Testing results:
-http://testers.cpan.org/
+=back
-=item PLATFORMS
+=head2 perltootc - Tom's OO Tutorial for Class Data in Perl
=over
-=item Unix
+=item DESCRIPTION
-=item DOS and Derivatives
+=item Class Data as Package Variables
-Build instructions for OS/2, L<perlos2>
+=over
-=item S<Mac OS>
+=item Putting All Your Eggs in One Basket
-=item VMS
+=item Inheritance Concerns
-=item VOS
+=item The Eponymous Meta-Object
-=item EBCDIC Platforms
+=item Indirect References to Class Data
-=item Acorn RISC OS
+=item Monadic Classes
-=item Other perls
+=item Translucent Attributes
=back
-=item FUNCTION IMPLEMENTATIONS
+=item Class Data as Lexical Variables
=over
-=item Alphabetical Listing of Perl Functions
+=item Privacy and Responsibility
--I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode
-FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt
-PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec
-LIST, fcntl FILEHANDLE,FUNCTION,SCALAR, flock FILEHANDLE,OPERATION, fork,
-getlogin, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam NAME,
-getgrnam NAME, getnetbyname NAME, getpwuid UID, getgrgid GID, getnetbyaddr
-ADDR,ADDRTYPE, getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent,
-getgrent, gethostent, getnetent, getprotoent, getservent, setpwent,
-setgrent, sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN,
-setservent STAYOPEN, endpwent, endgrent, endhostent, endnetent,
-endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob,
-ioctl FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link OLDFILE,NEWFILE,
-lstat FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS,
-msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR,
-open FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink EXPR, readlink,
-select RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget
-KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
-setpriority WHICH,WHO,PRIORITY, setpwent, 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, sysopen
-FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
-FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
-wait, waitpid PID,FLAGS
+=item File-Scoped Lexicals
-=back
+=item More Inheritance Concerns
-=item CHANGES
+=item Locking the Door and Throwing Away the Key
-v1.47, 22 March 2000, v1.46, 12 February 2000, v1.45, 20 December 1999,
-v1.44, 19 July 1999, 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 Translucency Revisited
-=item Supported Platforms
+=back
+
+=item NOTES
=item SEE ALSO
-=item AUTHORS / CONTRIBUTORS
+=item AUTHOR AND COPYRIGHT
-=item VERSION
+=item ACKNOWLEDGEMENTS
+
+=item HISTORY
=back
-=head2 perlsec - Perl security
+=head2 perlobj - Perl objects
=over
=over
-=item Laundering and Detecting Tainted Data
+=item An Object is Simply a Reference
-=item Switches On the "#!" Line
+=item A Class is Simply a Package
-=item Cleaning Up Your Path
+=item A Method is Simply a Subroutine
-=item Security Bugs
+=item Method Invocation
-=item Protecting Your Programs
+=item WARNING
+
+=item Default UNIVERSAL methods
+
+isa(CLASS), can(METHOD), VERSION( [NEED] )
+
+=item Destructors
+
+=item Summary
+
+=item Two-Phased Garbage Collection
=back
=back
-=head2 perlref - Perl references and nested data structures
+=head2 perlbot - Bag'o Object Tricks (the BOT)
=over
-=item NOTE
-
=item DESCRIPTION
-=over
+=item OO SCALING TIPS
-=item Making References
+=item INSTANCE VARIABLES
-=item Using References
+=item SCALAR INSTANCE VARIABLES
+
+=item INSTANCE VARIABLE INHERITANCE
-=item Symbolic references
+=item OBJECT RELATIONSHIPS
-=item Not-so-symbolic references
+=item OVERRIDING SUPERCLASS METHODS
-=item Pseudo-hashes: Using an array as a hash
+=item USING RELATIONSHIP WITH SDBM
-=item Function Templates
+=item THINKING OF CODE REUSE
-=back
+=item CLASS CONTEXT AND THE OBJECT
-=item WARNING
+=item INHERITING A CONSTRUCTOR
-=item SEE ALSO
+=item DELEGATION
=back
-=head2 perlre - Perl regular expressions
+=head2 perltie - how to hide an object class in a simple variable
=over
-=item DESCRIPTION
+=item SYNOPSIS
-i, m, s, x
+=item DESCRIPTION
=over
-=item Regular Expressions
-
-cntrl, graph, print, punct, xdigit
-
-=item Extended Patterns
+=item Tying Scalars
-C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
-C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
-code })>, C<(??{ code })>, C<< (?>pattern) >>,
-C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
+TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
-=item Backtracking
+=item Tying Arrays
-=item Version 8 Regular Expressions
+TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
+DESTROY this
-=item Warning on \1 vs $1
+=item Tying Hashes
-=item Repeated patterns matching zero-length substring
+USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
+this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
+this, NEXTKEY this, lastkey, DESTROY this
-=item Combining pieces together
+=item Tying FileHandles
-C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
-C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
-C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
-C<(?(condition)yes-pattern|no-pattern)>
+TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
+LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, DESTROY this
-=item Creating custom RE engines
+=item The C<untie> Gotcha
=back
+=item SEE ALSO
+
=item BUGS
-=item SEE ALSO
+=item AUTHOR
=back
-=head2 perlform - Perl formats
+=head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
+safe subprocesses, sockets, and semaphores)
=over
=item DESCRIPTION
+=item Signals
+
+=item Named Pipes
+
=over
-=item Format Variables
+=item WARNING
=back
-=item NOTES
+=item Using open() for IPC
=over
-=item Footers
-
-=item Accessing Formatting Internals
-
-=back
+=item Filehandles
-=item WARNINGS
+=item Background Processes
-=back
+=item Complete Dissociation of Child from Parent
-=head2 perllocale - Perl locale handling (internationalization and
-localization)
+=item Safe Pipe Opens
-=over
+=item Bidirectional Communication with Another Process
-=item DESCRIPTION
+=item Bidirectional Communication with Yourself
-=item PREPARING TO USE LOCALES
+=back
-=item USING LOCALES
+=item Sockets: Client/Server Communication
=over
-=item The use locale pragma
+=item Internet Line Terminators
-=item The setlocale function
+=item Internet TCP Clients and Servers
-=item Finding locales
+=item Unix-Domain TCP Clients and Servers
-=item LOCALE PROBLEMS
+=back
-=item Temporarily fixing locale problems
+=item TCP Clients with IO::Socket
-=item Permanently fixing locale problems
+=over
-=item Permanently fixing your system's locale configuration
+=item A Simple Client
-=item Fixing system locale configuration
+C<Proto>, C<PeerAddr>, C<PeerPort>
-=item The localeconv function
+=item A Webget Client
+
+=item Interactive Client with IO::Socket
=back
-=item LOCALE CATEGORIES
+=item TCP Servers with IO::Socket
-=over
+Proto, LocalPort, Listen, Reuse
-=item Category LC_COLLATE: Collation
+=item UDP: Message Passing
-=item Category LC_CTYPE: Character Types
+=item SysV IPC
-=item Category LC_NUMERIC: Numeric Formatting
+=item NOTES
-=item Category LC_MONETARY: Formatting of monetary amounts
+=item BUGS
-=item LC_TIME
+=item AUTHOR
-=item Other categories
+=item SEE ALSO
=back
-=item SECURITY
-
-B<Comparison operators> (C<lt>, C<le>, C<ge>, C<gt> and C<cmp>):,
-B<Case-mapping interpolation> (with C<\l>, C<\L>, C<\u> or C<\U>),
-B<Matching operator> (C<m//>):, B<Substitution operator> (C<s///>):,
-B<Output formatting functions> (printf() and write()):, B<Case-mapping
-functions> (lc(), lcfirst(), uc(), ucfirst()):, B<POSIX locale-dependent
-functions> (localeconv(), strcoll(), strftime(), strxfrm()):, B<POSIX
-character class tests> (isalnum(), isalpha(), isdigit(), isgraph(),
-islower(), isprint(), ispunct(), isspace(), isupper(), isxdigit()):
+=head2 perlfork - Perl's fork() emulation
-=item ENVIRONMENT
+=over
-PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
-LC_NUMERIC, LC_TIME, LANG
+=item SYNOPSIS
-=item NOTES
+=item DESCRIPTION
=over
-=item Backward compatibility
+=item Behavior of other Perl features in forked pseudo-processes
-=item I18N:Collate obsolete
+$$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
+filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
+files, directories and network sockets
-=item Sort speed and memory use impacts
+=item Resource limits
-=item write() and LC_NUMERIC
+=item Killing the parent process
-=item Freely available locale definitions
+=item Lifetime of the parent process and pseudo-processes
-=item I18n and l10n
+=item CAVEATS AND LIMITATIONS
-=item An imperfect standard
+BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
+Global state maintained by XSUBs, Interpreter embedded in larger
+application, Thread-safety of extensions
=back
=item BUGS
-=over
-
-=item Broken systems
-
-=back
+=item AUTHOR
=item SEE ALSO
-=item HISTORY
-
=back
-=head2 perlunicode - Unicode support in Perl
-
-=over
-
-=item DESCRIPTION
+=head2 perlnumber - semantics of numbers and numeric operations in Perl
=over
-=item Important Caveat
+=item SYNOPSIS
-Input and Output Disciplines, Regular Expressions, C<use utf8> still needed
-to enable a few features
+=item DESCRIPTION
-=item Byte and Character semantics
+=item Storing numbers
-=item Effects of character semantics
+=item Numeric operators and numeric conversions
-=item Character encodings for input and output
+=item Flavors of Perl numeric operations
-=back
+Arithmetic operators except, C<no integer>, Arithmetic operators except,
+C<use integer>, Bitwise operators, C<no integer>, Bitwise operators, C<use
+integer>, Operators which expect an integer, Operators which expect a
+string
-=item CAVEATS
+=item AUTHOR
=item SEE ALSO
=back
-=head2 perlboot - Beginner's Object-Oriented Tutorial
+=head2 perlthrtut - tutorial on threads in Perl
=over
=item DESCRIPTION
-=over
-
-=item If we could talk to the animals...
-
-=item Introducing the method invocation arrow
+=item What Is A Thread Anyway?
-=item Invoking a barnyard
+=item Threaded Program Models
-=item The extra parameter of method invocation
+=over
-=item Calling a second method to simplify things
+=item Boss/Worker
-=item Inheriting the windpipes
+=item Work Crew
-=item A few notes about @ISA
+=item Pipeline
-=item Overriding the methods
+=back
-=item Starting the search from a different place
+=item Native threads
-=item The SUPER way of doing things
+=item What kind of threads are perl threads?
-=item Where we're at so far...
+=item Threadsafe Modules
-=item A horse is a horse, of course of course -- or is it?
+=item Thread Basics
-=item Invoking an instance method
+=over
-=item Accessing the instance data
+=item Basic Thread Support
-=item How to build a horse
+=item Creating Threads
-=item Inheriting the constructor
+=item Giving up control
-=item Making a method work with either classes or instances
+=item Waiting For A Thread To Exit
-=item Adding parameters to a method
+=item Errors In Threads
-=item More interesting instances
+=item Ignoring A Thread
-=item A horse of a different color
+=back
-=item Summary
+=item Threads And Data
-=back
+=over
-=item SEE ALSO
+=item Shared And Unshared Data
-=item COPYRIGHT
+=item Thread Pitfall: Races
-=back
+=item Controlling access: lock()
-=head2 perltoot - Tom's object-oriented tutorial for perl
+=item Thread Pitfall: Deadlocks
-=over
+=item Queues: Passing Data Around
-=item DESCRIPTION
+=back
-=item Creating a Class
+=item Threads And Code
=over
-=item Object Representation
+=item Semaphores: Synchronizing Data Access
-=item Class Interface
+Basic semaphores, Advanced Semaphores
-=item Constructors and Instance Methods
+=item Attributes: Restricting Access To Subroutines
-=item Planning for the Future: Better Constructors
+=item Subroutine Locks
-=item Destructors
+=item Methods
-=item Other Object Methods
+=item Locking A Subroutine
=back
-=item Class Data
+=item General Thread Utility Routines
=over
-=item Accessing Class Data
+=item What Thread Am I In?
-=item Debugging Methods
+=item Thread IDs
-=item Class Destructors
+=item Are These Threads The Same?
-=item Documenting the Interface
+=item What Threads Are Running?
=back
-=item Aggregation
+=item A Complete Example
-=item Inheritance
+=item Conclusion
+
+=item Bibliography
=over
-=item Overridden Methods
+=item Introductory Texts
-=item Multiple Inheritance
+=item OS-Related References
-=item UNIVERSAL: The Root of All Objects
+=item Other References
=back
-=item Alternate Object Representations
-
-=over
+=item Acknowledgements
-=item Arrays as Objects
+=item AUTHOR
-=item Closures as Objects
+=item Copyrights
=back
-=item AUTOLOAD: Proxy Methods
+=head2 perlport - Writing portable Perl
=over
-=item Autoloaded Data Methods
-
-=item Inherited Autoloaded Data Methods
+=item DESCRIPTION
-=back
+Not all Perl programs have to be portable, Nearly all of Perl already I<is>
+portable
-=item Metaclassical Tools
+=item ISSUES
=over
-=item Class::Struct
+=item Newlines
-=item Data Members as Variables
+=item Numbers endianness and Width
-=item NOTES
+=item Files and Filesystems
-=item Object Terminology
+=item System Interaction
-=back
+=item Interprocess Communication (IPC)
-=item SEE ALSO
+=item External Subroutines (XS)
-=item AUTHOR AND COPYRIGHT
+=item Standard Modules
-=item COPYRIGHT
+=item Time and Date
-=over
+=item Character sets and character encoding
-=item Acknowledgments
+=item Internationalisation
-=back
+=item System Resources
+
+=item Security
+
+=item Style
=back
-=head2 perltootc - Tom's OO Tutorial for Class Data in Perl
+=item CPAN Testers
+
+Mailing list: cpan-testers@perl.org, Testing results:
+http://testers.cpan.org/
+
+=item PLATFORMS
=over
-=item DESCRIPTION
+=item Unix
-=item Class Data as Package Variables
+=item DOS and Derivatives
-=over
+Build instructions for OS/2, L<perlos2>
-=item Putting All Your Eggs in One Basket
+=item S<Mac OS>
-=item Inheritance Concerns
+=item VMS
-=item The Eponymous Meta-Object
+=item VOS
-=item Indirect References to Class Data
+=item EBCDIC Platforms
-=item Monadic Classes
+=item Acorn RISC OS
-=item Translucent Attributes
+=item Other perls
=back
-=item Class Data as Lexical Variables
+=item FUNCTION IMPLEMENTATIONS
=over
-=item Privacy and Responsibility
-
-=item File-Scoped Lexicals
+=item Alphabetical Listing of Perl Functions
-=item More Inheritance Concerns
+-I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode
+FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt
+PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec
+LIST, fcntl FILEHANDLE,FUNCTION,SCALAR, flock FILEHANDLE,OPERATION, fork,
+getlogin, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam NAME,
+getgrnam NAME, getnetbyname NAME, getpwuid UID, getgrgid GID, getnetbyaddr
+ADDR,ADDRTYPE, getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent,
+getgrent, gethostent, getnetent, getprotoent, getservent, setpwent,
+setgrent, sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN,
+setservent STAYOPEN, endpwent, endgrent, endhostent, endnetent,
+endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob,
+ioctl FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link OLDFILE,NEWFILE,
+lstat FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS,
+msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR,
+open FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink EXPR, readlink,
+select RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget
+KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
+setpriority WHICH,WHO,PRIORITY, setpwent, 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, sysopen
+FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
+FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
+wait, waitpid PID,FLAGS
-=item Locking the Door and Throwing Away the Key
+=back
-=item Translucency Revisited
+=item CHANGES
-=back
+v1.47, 22 March 2000, v1.46, 12 February 2000, v1.45, 20 December 1999,
+v1.44, 19 July 1999, 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 NOTES
+=item Supported Platforms
=item SEE ALSO
-=item AUTHOR AND COPYRIGHT
-
-=item ACKNOWLEDGEMENTS
+=item AUTHORS / CONTRIBUTORS
-=item HISTORY
+=item VERSION
=back
-=head2 perlobj - Perl objects
+=head2 perllocale - Perl locale handling (internationalization and
+localization)
=over
=item DESCRIPTION
-=over
+=item PREPARING TO USE LOCALES
-=item An Object is Simply a Reference
+=item USING LOCALES
-=item A Class is Simply a Package
+=over
-=item A Method is Simply a Subroutine
+=item The use locale pragma
-=item Method Invocation
+=item The setlocale function
-=item WARNING
+=item Finding locales
-=item Default UNIVERSAL methods
+=item LOCALE PROBLEMS
-isa(CLASS), can(METHOD), VERSION( [NEED] )
+=item Temporarily fixing locale problems
-=item Destructors
+=item Permanently fixing locale problems
-=item Summary
+=item Permanently fixing your system's locale configuration
-=item Two-Phased Garbage Collection
+=item Fixing system locale configuration
+
+=item The localeconv function
=back
-=item SEE ALSO
+=item LOCALE CATEGORIES
+
+=over
+
+=item Category LC_COLLATE: Collation
+
+=item Category LC_CTYPE: Character Types
+
+=item Category LC_NUMERIC: Numeric Formatting
+
+=item Category LC_MONETARY: Formatting of monetary amounts
+
+=item LC_TIME
+
+=item Other categories
=back
-=head2 perlbot - Bag'o Object Tricks (the BOT)
+=item SECURITY
-=over
+B<Comparison operators> (C<lt>, C<le>, C<ge>, C<gt> and C<cmp>):,
+B<Case-mapping interpolation> (with C<\l>, C<\L>, C<\u> or C<\U>),
+B<Matching operator> (C<m//>):, B<Substitution operator> (C<s///>):,
+B<Output formatting functions> (printf() and write()):, B<Case-mapping
+functions> (lc(), lcfirst(), uc(), ucfirst()):, B<POSIX locale-dependent
+functions> (localeconv(), strcoll(), strftime(), strxfrm()):, B<POSIX
+character class tests> (isalnum(), isalpha(), isdigit(), isgraph(),
+islower(), isprint(), ispunct(), isspace(), isupper(), isxdigit()):
-=item DESCRIPTION
+=item ENVIRONMENT
-=item OO SCALING TIPS
+PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
+LC_NUMERIC, LC_TIME, LANG
-=item INSTANCE VARIABLES
+=item NOTES
-=item INSTANCE VARIABLE INHERITANCE
+=over
-=item OBJECT RELATIONSHIPS
+=item Backward compatibility
-=item OVERRIDING SUPERCLASS METHODS
+=item I18N:Collate obsolete
-=item USING RELATIONSHIP WITH SDBM
+=item Sort speed and memory use impacts
-=item THINKING OF CODE REUSE
+=item write() and LC_NUMERIC
-=item CLASS CONTEXT AND THE OBJECT
+=item Freely available locale definitions
-=item INHERITING A CONSTRUCTOR
+=item I18n and l10n
-=item DELEGATION
+=item An imperfect standard
=back
-=head2 perltie - how to hide an object class in a simple variable
+=item BUGS
=over
-=item SYNOPSIS
+=item Broken systems
-=item DESCRIPTION
+=back
-=over
+=item SEE ALSO
-=item Tying Scalars
+=item HISTORY
-TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
+=back
-=item Tying Arrays
+=head2 perlunicode - Unicode support in Perl
-TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
-DESTROY this
+=over
-=item Tying Hashes
+=item DESCRIPTION
-USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
-this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
-this, NEXTKEY this, lastkey, DESTROY this
+=over
+
+=item Important Caveat
-=item Tying FileHandles
+Input and Output Disciplines, Regular Expressions, C<use utf8> still needed
+to enable a few features
-TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
-LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, DESTROY this
+=item Byte and Character semantics
-=item The C<untie> Gotcha
+=item Effects of character semantics
-=back
+=item Character encodings for input and output
-=item SEE ALSO
+=back
-=item BUGS
+=item CAVEATS
-=item AUTHOR
+=item SEE ALSO
=back
-=head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
-safe subprocesses, sockets, and semaphores)
+=head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
=over
=item DESCRIPTION
-=item Signals
-
-=item Named Pipes
+=item COMMON CHARACTER CODE SETS
=over
-=item WARNING
-
-=back
-
-=item Using open() for IPC
+=item ASCII
-=over
+=item ISO 8859
-=item Filehandles
+=item Latin 1 (ISO 8859-1)
-=item Background Processes
+=item EBCDIC
-=item Complete Dissociation of Child from Parent
+=item 13 variant characters
-=item Safe Pipe Opens
+=item 0037
-=item Bidirectional Communication with Another Process
+=item 1047
-=item Bidirectional Communication with Yourself
+=item POSIX-BC
=back
-=item Sockets: Client/Server Communication
-
-=over
+=item SINGLE OCTET TABLES
-=item Internet Line Terminators
+recipe 0, recipe 1, recipe 2, recipe 3, recipe 4
-=item Internet TCP Clients and Servers
+=item IDENTIFYING CHARACTER CODE SETS
-=item Unix-Domain TCP Clients and Servers
+=item CONVERSIONS
-=back
+=item OPERATOR DIFFERENCES
-=item TCP Clients with IO::Socket
+=item FUNCTION DIFFERENCES
-=over
+chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
-=item A Simple Client
+=item REGULAR EXPRESSION DIFFERENCES
-C<Proto>, C<PeerAddr>, C<PeerPort>
+=item SOCKETS
-=item A Webget Client
+=item SORTING
-=item Interactive Client with IO::Socket
+=over
-=back
+=item Ignore ASCII vs EBCDIC sort differences.
-=item TCP Servers with IO::Socket
+=item MONOCASE then sort data.
-Proto, LocalPort, Listen, Reuse
+=item Convert, sort data, then reconvert.
-=item UDP: Message Passing
+=item Perform sorting on one type of machine only.
-=item SysV IPC
+=back
-=item NOTES
+=item URL ENCODING and DECODING
-=item BUGS
+=item I18N AND L10N
-=item AUTHOR
+=item MULTI OCTET CHARACTER SETS
-=item SEE ALSO
+=item OS ISSUES
-=back
+=over
-=head2 perlnumber - semantics of numbers and numeric operations in Perl
+=item OS/400
-=over
+IFS access
-=item SYNOPSIS
+=item OS/390
-=item DESCRIPTION
+dataset access, locales
-=item Storing numbers
+=item VM/ESA?
-=item Numeric operators and numeric conversions
+=item POSIX-BC?
-=item Flavors of Perl numeric operations
+=back
-Arithmetic operators except, C<no integer>, Arithmetic operators except,
-C<use integer>, Bitwise operators, C<no integer>, Bitwise operators, C<use
-integer>, Operators which expect an integer, Operators which expect a
-string
+=item REFERENCES
=item AUTHOR
-=item SEE ALSO
-
=back
-=head2 perlfork - Perl's fork() emulation
+=head2 perlsec - Perl security
=over
-=item SYNOPSIS
-
=item DESCRIPTION
=over
-=item Behavior of other Perl features in forked pseudo-processes
-
-$$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
-filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
-files, directories and network sockets
-
-=item Resource limits
+=item Laundering and Detecting Tainted Data
-=item Killing the parent process
+=item Switches On the "#!" Line
-=item Lifetime of the parent process and pseudo-processes
+=item Cleaning Up Your Path
-=item CAVEATS AND LIMITATIONS
+=item Security Bugs
-BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
-Global state maintained by XSUBs, Interpreter embedded in larger
-application, Thread-safety of extensions
+=item Protecting Your Programs
=back
-=item BUGS
-
-=item AUTHOR
-
=item SEE ALSO
=back
-=head2 perlthrtut - tutorial on threads in Perl
+=head2 perlmod - Perl modules (packages and symbol tables)
=over
=item DESCRIPTION
-=item What Is A Thread Anyway?
+=over
-=item Threaded Program Models
+=item Packages
-=over
+=item Symbol Tables
-=item Boss/Worker
+=item Package Constructors and Destructors
-=item Work Crew
+=item Perl Classes
-=item Pipeline
+=item Perl Modules
=back
-=item Native threads
-
-=item What kind of threads are perl threads?
+=item SEE ALSO
-=item Threadsafe Modules
+=back
-=item Thread Basics
+=head2 perlmodlib - constructing new Perl modules and finding existing ones
=over
-=item Basic Thread Support
+=item DESCRIPTION
-=item Creating Threads
+=item THE PERL MODULE LIBRARY
-=item Giving up control
+=over
-=item Waiting For A Thread To Exit
+=item Pragmatic Modules
-=item Errors In Threads
+attributes, attrs, autouse, base, blib, bytes, charnames, constant,
+diagnostics, fields, filetest, integer, less, lib, locale, open, ops,
+overload, re, sigtrap, strict, subs, utf8, vars, warnings
-=item Ignoring A Thread
+=item Standard Modules
+
+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, ByteLoader, CGI,
+CGI::Apache, CGI::Carp, CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push,
+CGI::Switch, CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy,
+Class::Struct, Cwd, DB, DB_File, Devel::SelfStubber, DirHandle, Dumpvalue,
+English, Env, Exporter, Exporter::Heavy, ExtUtils::Command,
+ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist,
+ExtUtils::MM_Cygwin, ExtUtils::MM_OS2, ExtUtils::MM_Unix, ExtUtils::MM_VMS,
+ExtUtils::MM_Win32, ExtUtils::MakeMaker, ExtUtils::Manifest,
+ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::Packlist,
+ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree,
+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::Temp,
+File::stat, FileCache, FileHandle, FindBin, Getopt::Long, Getopt::Std,
+I18N::Collate, IO, IPC::Open2, IPC::Open3, Math::BigFloat, Math::BigInt,
+Math::Complex, Math::Trig, NDBM_File, Net::Ping, Net::hostent, Net::netent,
+Net::protoent, Net::servent, O, ODBM_File, Opcode, Pod::Checker, Pod::Find,
+Pod::Html, Pod::InputObjects, Pod::Man, Pod::ParseUtils, Pod::Parser,
+Pod::Plainer, Pod::Select, Pod::Text, Pod::Text::Color, Pod::Text::Termcap,
+Pod::Usage, SDBM_File, Safe, Search::Dict, SelectSaver, SelfLoader, Shell,
+Socket, Symbol, Term::ANSIColor, Term::Cap, Term::Complete, Term::ReadLine,
+Test, Test::Harness, Text::Abbrev, Text::ParseWords, Text::Soundex,
+Text::Wrap, Tie::Array, Tie::Handle, Tie::Hash, Tie::RefHash, Tie::Scalar,
+Tie::SubstrHash, Time::Local, Time::gmtime, Time::localtime, Time::tm,
+UNIVERSAL, User::grent, User::pwent
+
+=item Extension Modules
=back
-=item Threads And Data
+=item CPAN
+
+Language Extensions and Documentation Tools, Development Support, Operating
+System Interfaces, Networking, Device Control (modems) and InterProcess
+Communication, Data Types and Data Type Utilities, Database Interfaces,
+User Interfaces, Interfaces to / Emulations of Other Programming Languages,
+File Names, File Systems and File Locking (see also File Handles), String
+Processing, Language Text Processing, Parsing, and Searching, Option,
+Argument, Parameter, and Configuration File Processing,
+Internationalization and Locale, Authentication, Security, and Encryption,
+World Wide Web, HTML, HTTP, CGI, MIME, Server and Daemon Utilities,
+Archiving and Compression, Images, Pixmap and Bitmap Manipulation, Drawing,
+and Graphing, Mail and Usenet News, Control Flow Utilities (callbacks and
+exceptions etc), File Handle and Input/Output Stream Utilities,
+Miscellaneous Modules, Africa, Asia, Australasia, Central America, Europe,
+North America, South America
+
+=item Modules: Creation, Use, and Abuse
=over
-=item Shared And Unshared Data
+=item Guidelines for Module Creation
-=item Thread Pitfall: Races
+Do similar modules already exist in some form?, Try to design the new
+module to be easy to extend and reuse, Some simple style guidelines, Select
+what to export, Select a name for the module, Have you got it right?,
+README and other Additional Files, A description of the
+module/package/extension etc, A copyright notice - see below, Prerequisites
+- what else you may need to have, How to build it - possible changes to
+Makefile.PL etc, How to install it, Recent changes in this release,
+especially incompatibilities, Changes / enhancements you plan to make in
+the future, Adding a Copyright Notice, Give the module a
+version/issue/release number, How to release and distribute a module, Take
+care when changing a released module
-=item Controlling access: lock()
+=item Guidelines for Converting Perl 4 Library Scripts into Modules
-=item Thread Pitfall: Deadlocks
+There is no requirement to convert anything, Consider the implications,
+Make the most of the opportunity, The pl2pm utility will get you started,
+Adds the standard Module prologue lines, Converts package specifiers from '
+to ::, Converts die(...) to croak(...), Several other minor changes
-=item Queues: Passing Data Around
+=item Guidelines for Reusing Application Code
+
+Complete applications rarely belong in the Perl Module Library, Many
+applications contain some Perl code that could be reused, Break-out the
+reusable code into one or more separate module files, Take the opportunity
+to reconsider and redesign the interfaces, In some cases the 'application'
+can then be reduced to a small
=back
-=item Threads And Code
+=item NOTE
-=over
+=back
-=item Semaphores: Synchronizing Data Access
+=head2 perlmodinstall - Installing CPAN Modules
-Basic semaphores, Advanced Semaphores
+=over
-=item Attributes: Restricting Access To Subroutines
+=item DESCRIPTION
-=item Subroutine Locks
+=over
-=item Methods
+=item PREAMBLE
-=item Locking A Subroutine
+B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
+module (sometimes unnecessary), B<INSTALL> the module
=back
-=item General Thread Utility Routines
-
-=over
-
-=item What Thread Am I In?
+=item PORTABILITY
-=item Thread IDs
+=item HEY
-=item Are These Threads The Same?
+=item AUTHOR
-=item What Threads Are Running?
+=item COPYRIGHT
=back
-=item A Complete Example
+=head2 perlnewmod - preparing a new module for distribution
-=item Conclusion
+=over
-=item Bibliography
+=item DESCRIPTION
=over
-=item Introductory Texts
+=item Warning
-=item OS-Related References
+=item What should I make into a module?
-=item Other References
+=item Step-by-step: Preparing the ground
-=back
+Look around, Check it's new, Discuss the need, Choose a name, Check again
-=item Acknowledgements
+=item Step-by-step: Making the module
-=item AUTHOR
+Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use
+L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old
+documentation|perlpod>, Write tests, Write the README
-=item Copyrights
+=item Step-by-step: Distributing your module
+
+Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
+tarball, Announce to the modules list, Announce to clpa, Fix bugs!
=back
-=head2 perldiag - various Perl diagnostics
-
-=over
+=item AUTHOR
-=item DESCRIPTION
+=item SEE ALSO
=back
=item How do I fork a daemon process?
-=item How do I make my program run with sh and csh?
-
=item How do I find out if I'm running interactively or not?
=item How do I timeout a slow event?
=back
+=item Internal Functions
+
+A, p, d, s, n, r, f, m, o, j, x
+
+=over
+
+=item Formatted Printing of IVs, UVs, and NVs
+
+=item Source Documentation
+
+=back
+
+=item Unicode Support
+
+=over
+
+=item What B<is> Unicode, anyway?
+
+=item How can I recognise a UTF8 string?
+
+=item How does UTF8 represent Unicode characters?
+
+=item How does Perl store UTF8 strings?
+
+=item How do I convert a string to UTF8?
+
+=item Is there anything else I need to know?
+
+=back
+
=item AUTHORS
=item SEE ALSO
=item DESCRIPTION
-AvFILL, av_clear, av_extend, av_fetch, av_len, av_make, av_pop, av_push,
-av_shift, av_store, av_undef, av_unshift, bytes_to_utf8, call_argv,
-call_method, call_pv, call_sv, CLASS, Copy, croak, CvSTASH, dMARK,
-dORIGMARK, dSP, dXSARGS, dXSI32, ENTER, eval_pv, eval_sv, EXTEND,
-fbm_compile, fbm_instr, FREETMPS, get_av, get_cv, get_hv, get_sv, GIMME,
-GIMME_V, GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload,
-gv_stashpv, gv_stashsv, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR,
-G_VOID, HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force,
-HeSVKEY_set, HeVAL, HvNAME, 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, 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_length, mg_magical, mg_set, Move, New, newAV,
-Newc, newCONSTSUB, newHV, newRV_inc, newRV_noinc, NEWSV, newSViv, newSVnv,
-newSVpv, newSVpvf, newSVpvn, newSVrv, newSVsv, newSVuv, newXS, newXSproto,
-Newz, Nullav, Nullch, Nullcv, Nullhv, Nullsv, ORIGMARK, perl_alloc,
-perl_construct, perl_destruct, perl_free, perl_parse, perl_run,
-PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_modglobal, PL_na,
-PL_sv_no, PL_sv_undef, PL_sv_yes, POPi, POPl, POPn, POPp, POPs, PUSHi,
-PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK, Renew, Renewc, require_pv,
-RETVAL, Safefree, savepv, savepvn, SAVETMPS, SP, SPAGAIN, ST, strEQ, strGE,
-strGT, strLE, strLT, strNE, strnEQ, strnNE, StructCopy, SvCUR, SvCUR_set,
-SvEND, SvGETMAGIC, SvGROW, SvIOK, SvIOKp, SvIOK_off, SvIOK_on, SvIOK_only,
-SvIV, SvIVX, SvLEN, SvLOCK, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp,
-SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX, SvOK, SvOOK, SvPOK, SvPOKp,
-SvPOK_off, SvPOK_on, SvPOK_only, SvPV, SvPVX, SvPV_force, SvPV_nolen,
-SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV,
-SvSETMAGIC, SvSetSV, SvSetSV_nosteal, SvSTASH, SvTAINT, SvTAINTED,
-SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, svtype, SVt_IV, SVt_NV,
-SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, SvUNLOCK, SvUPGRADE, SvUV,
+AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
+av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
+bytes_to_utf8, call_argv, call_method, call_pv, call_sv, CLASS, Copy,
+croak, CvSTASH, dMARK, dORIGMARK, dSP, dXSARGS, dXSI32, ENTER, eval_pv,
+eval_sv, EXTEND, fbm_compile, fbm_instr, FREETMPS, get_av, get_cv, get_hv,
+get_sv, GIMME, GIMME_V, GvSV, gv_fetchmeth, gv_fetchmethod,
+gv_fetchmethod_autoload, gv_stashpv, gv_stashsv, G_ARRAY, G_DISCARD,
+G_EVAL, G_NOARGS, G_SCALAR, G_VOID, HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV,
+HeSVKEY, HeSVKEY_force, HeSVKEY_set, HeVAL, HvNAME, 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, 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_length, mg_magical,
+mg_set, Move, New, newAV, Newc, newCONSTSUB, newHV, newRV_inc, newRV_noinc,
+NEWSV, newSViv, newSVnv, newSVpv, newSVpvf, newSVpvn, newSVrv, newSVsv,
+newSVuv, newXS, newXSproto, Newz, Nullav, Nullch, Nullcv, Nullhv, Nullsv,
+ORIGMARK, perl_alloc, perl_construct, perl_destruct, perl_free, perl_parse,
+perl_run, PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_modglobal,
+PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes, POPi, POPl, POPn, POPp, POPs,
+PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK, Renew, Renewc,
+require_pv, RETVAL, Safefree, savepv, savepvn, SAVETMPS, SP, SPAGAIN, ST,
+strEQ, strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, StructCopy,
+SvCUR, SvCUR_set, SvEND, SvGETMAGIC, SvGROW, SvIOK, SvIOKp, SvIOK_off,
+SvIOK_on, SvIOK_only, SvIV, SvIVX, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off,
+SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX, SvOK, SvOOK,
+SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only, SvPV, SvPVX, SvPV_force,
+SvPV_nolen, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off,
+SvROK_on, SvRV, SvSETMAGIC, SvSetSV, SvSetSV_nosteal, SvSTASH, SvTAINT,
+SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, svtype, SvTYPE, SVt_IV,
+SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, SvUPGRADE, SvUV,
SvUVX, sv_2mortal, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn,
-sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_mg, sv_chop, sv_cmp, sv_dec,
-sv_derived_from, sv_eq, sv_grow, sv_inc, sv_insert, sv_isa, sv_isobject,
-sv_len, sv_magic, sv_mortalcopy, sv_newmortal, sv_setiv, sv_setiv_mg,
-sv_setnv, sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpviv,
-sv_setpviv_mg, sv_setpvn, sv_setpvn_mg, sv_setpv_mg, sv_setref_iv,
-sv_setref_nv, sv_setref_pv, sv_setref_pvn, sv_setsv, sv_setsv_mg, sv_setuv,
-sv_setuv_mg, sv_unref, sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_vcatpvfn,
+sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_mg, sv_chop, sv_clear,
+sv_cmp, sv_cmp_locale, sv_dec, sv_derived_from, sv_eq, sv_free, sv_gets,
+sv_grow, sv_inc, sv_insert, sv_isa, sv_isobject, sv_len, sv_len_utf8,
+sv_magic, sv_mortalcopy, sv_newmortal, sv_pvn_force, sv_pvutf8n_force,
+sv_reftype, sv_replace, sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv,
+sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg,
+sv_setpvn, sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv,
+sv_setref_pv, sv_setref_pvn, sv_setsv, sv_setsv_mg, sv_setuv, sv_setuv_mg,
+sv_true, sv_unmagic, sv_unref, sv_upgrade, sv_usepvn, sv_usepvn_mg,
+sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade, sv_vcatpvfn,
sv_vsetpvfn, THIS, toLOWER, toUPPER, U8 *s, utf8_to_bytes, warn, XPUSHi,
XPUSHn, XPUSHp, XPUSHs, XPUSHu, XS, XSRETURN, XSRETURN_EMPTY, XSRETURN_IV,
XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_YES,
it preclude other desirable features?, Is the implementation robust?, Is
the implementation generic enough to be portable?, Is there enough
documentation?, Is there another way to do it?, Does it create too much
-work?, Patches speak louder than words
-
-=item AUTHOR
-
-=back
-
-=head2 perlhist - the Perl history records
-
-=over
-
-=item DESCRIPTION
-
-=item INTRODUCTION
-
-=item THE KEEPERS OF THE PUMPKIN
-
-=over
-
-=item PUMPKIN?
-
-=back
-
-=item THE RECORDS
-
-=over
-
-=item SELECTED RELEASE SIZES
-
-=item SELECTED PATCH SIZES
-
-=back
-
-=item THE KEEPERS OF THE RECORDS
-
-=back
-
-=head2 perldelta - what's new for perl v5.6.0
-
-=over
-
-=item DESCRIPTION
-
-=item Core Enhancements
-
-=over
-
-=item Interpreter cloning, threads, and concurrency
-
-=item Lexically scoped warning categories
-
-=item Unicode and UTF-8 support
-
-=item Support for interpolating named characters
-
-=item "our" declarations
-
-=item Support for strings represented as a vector of ordinals
-
-=item Improved Perl version numbering system
-
-=item New syntax for declaring subroutine attributes
-
-=item File and directory handles can be autovivified
-
-=item open() with more than two arguments
-
-=item 64-bit support
-
-=item Large file support
-
-=item Long doubles
-
-=item "more bits"
-
-=item Enhanced support for sort() subroutines
-
-=item C<sort $coderef @foo> allowed
-
-=item File globbing implemented internally
-
-Support for CHECK blocks
-
-=item POSIX character class syntax [: :] supported
-
-Better pseudo-random number generator
-
-=item Improved C<qw//> operator
-
-Better worst-case behavior of hashes
-
-=item pack() format 'Z' supported
-
-=item pack() format modifier '!' supported
-
-=item pack() and unpack() support counted strings
-
-=item Comments in pack() templates
-
-=item Weak references
-
-=item Binary numbers supported
-
-=item Lvalue subroutines
-
-=item Some arrows may be omitted in calls through references
-
-=item Boolean assignment operators are legal lvalues
-
-=item exists() is supported on subroutine names
-
-=item exists() and delete() are supported on array elements
-
-=item Pseudo-hashes work better
-
-=item Automatic flushing of output buffers
-
-=item Better diagnostics on meaningless filehandle operations
-
-=item Where possible, buffered data discarded from duped input filehandle
-
-=item eof() has the same old magic as <>
-
-=item binmode() can be used to set :crlf and :raw modes
-
-=item C<-T> filetest recognizes UTF-8 encoded files as "text"
-
-=item system(), backticks and pipe open now reflect exec() failure
-
-=item Improved diagnostics
-
-=item Diagnostics follow STDERR
-
-More consistent close-on-exec behavior
-
-=item syswrite() ease-of-use
-
-=item Better syntax checks on parenthesized unary operators
-
-=item Bit operators support full native integer width
-
-=item Improved security features
-
-More functional bareword prototype (*)
-
-=item C<require> and C<do> may be overridden
-
-=item $^X variables may now have names longer than one character
-
-=item New variable $^C reflects C<-c> switch
-
-=item New variable $^V contains Perl version as a string
-
-=item Optional Y2K warnings
-
-=back
-
-=item Modules and Pragmata
-
-=over
-
-=item Modules
-
-attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
-DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
-Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
-File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
-Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
-podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
-pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
-Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
-
-=item Pragmata
-
-=back
-
-=item Utility Changes
-
-=over
-
-=item dprofpp
-
-=item find2perl
-
-=item h2xs
-
-=item perlcc
-
-=item perldoc
-
-=item The Perl Debugger
-
-=back
-
-=item Improved Documentation
-
-perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
-perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
-perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
-perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
-
-=item Performance enhancements
-
-=over
-
-=item Simple sort() using { $a <=> $b } and the like are optimized
-
-=item Optimized assignments to lexical variables
-
-=item Faster subroutine calls
-
-delete(), each(), values() and hash iteration are faster
-
-=back
-
-=item Installation and Configuration Improvements
+work?, Patches speak louder than words, L<perlguts>, L<perlxstut> and
+L<perlxs>, L<perlapi>, F<Porting/pumpkin.pod>, The perl5-porters FAQ
=over
-=item -Dusethreads means something different
-
-=item New Configure flags
-
-=item Threadedness and 64-bitness now more daring
+=item Finding Your Way Around
-=item Long Doubles
+Core modules, Documentation, Configure, Interpreter
-=item -Dusemorebits
+=item Elements of the interpreter
-=item -Duselargefiles
+Startup, Parsing, Optimization, Running
-=item installusrbinperl
+=item Internal Variable Types
-=item SOCKS support
+=item Op Trees
-=item C<-A> flag
+=item Stacks
-=item Enhanced Installation Directories
+Argument stack, Mark stack, Save stack
-=back
+=item Millions of Macros
-=item Platform specific changes
+=item Poking at Perl
-=over
+=item Using a source-level debugger
-=item Supported platforms
+run [args], break function_name, break source.c:xxx, step, next, continue,
+finish, print
-=item DOS
+=item Dumping Perl Data Structures
-=item OS390 (OpenEdition MVS)
+=item Patching
-=item VMS
+=item CONCLUSION
-=item Win32
+I<The Road goes ever on and on, down from the door where it began.>
=back
-=item Significant bug fixes
-
-=over
+=item AUTHOR
-=item <HANDLE> on empty files
+=back
-=item C<eval '...'> improvements
+=head2 perlhist - the Perl history records
-=item All compilation errors are true errors
+=over
-=item Implicitly closed filehandles are safer
+=item DESCRIPTION
-=item Behavior of list slices is more consistent
+=item INTRODUCTION
-=item C<(\$)> prototype and C<$foo{a}>
+=item THE KEEPERS OF THE PUMPKIN
-=item C<goto &sub> and AUTOLOAD
+=over
-=item C<-bareword> allowed under C<use integer>
+=item PUMPKIN?
-=item Failures in DESTROY()
+=back
-=item Locale bugs fixed
+=item THE RECORDS
-=item Memory leaks
+=over
-=item Spurious subroutine stubs after failed subroutine calls
+=item SELECTED RELEASE SIZES
-=item Taint failures under C<-U>
+=item SELECTED PATCH SIZES
-=item END blocks and the C<-c> switch
+=back
-=item Potential to leak DATA filehandles
+=item THE KEEPERS OF THE RECORDS
=back
-=item New or Changed Diagnostics
+=head2 perldelta - what's new for perl v5.7.0
-(perhaps you forgot to load "%s"?), "%s" variable %s masks earlier
-declaration in same %s, "my sub" not yet implemented, "our" variable %s
-redeclared, '!' allowed only after types %s, / cannot take a count, / must
-be followed by a, A or Z, / must be followed by a*, A* or Z*, / must follow
-a numeric type, /%s/: Unrecognized escape \\%c passed through, /%s/:
-Unrecognized escape \\%c in character class passed through, /%s/ should
-probably be written as "%s", %s() called too early to check prototype, %s
-argument is not a HASH or ARRAY element, %s argument is not a HASH or ARRAY
-element or slice, %s argument is not a subroutine name, %s package
-attribute may clash with future reserved word: %s, (in cleanup) %s, <>
-should be quotes, Attempt to join self, Bad evalled substitution pattern,
-Bad realloc() ignored, Bareword found in conditional, Binary number >
-0b11111111111111111111111111111111 non-portable, Bit vector size > 32
-non-portable, Buffer overflow in prime_env_iter: %s, Can't check filesystem
-of script "%s", Can't declare class for non-scalar %s in "%s", Can't
-declare %s in "%s", Can't ignore signal CHLD, forcing to default, Can't
-modify non-lvalue subroutine call, Can't read CRTL environ, Can't remove
-%s: %s, skipping file, Can't return %s from lvalue subroutine, Can't weaken
-a nonreference, Character class [:%s:] unknown, Character class syntax [%s]
-belongs inside character classes, Constant is not %s reference,
-constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
-defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
-"local" instead of "our"?), Document contains no data, entering effective
-%s failed, false [] range "%s" in regexp, Filehandle %s opened only for
-output, flock() on closed filehandle %s, Global symbol "%s" requires
-explicit package name, Hexadecimal number > 0xffffffff non-portable,
-Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
-|%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
-number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
-%s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
-separator character %s in attribute list, Invalid separator character %s in
-subroutine attribute list, leaving effective %s failed, Lvalue subs
-returning %s not implemented yet, Method %s not permitted, Missing
-%sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
-No %s specified for -%c, No package name allowed for variable %s in "our",
-No space allowed after -%c, no UTC offset information; assuming local time
-is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
-panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
-around "%s" list, Possible Y2K bug: %s, pragma "attrs" is deprecated, use
-"sub NAME : ATTRS" instead, Premature end of script headers, Repeat count
-in pack overflows, Repeat count in unpack overflows, realloc() of freed
-memory ignored, Reference is already weak, setpgrp can't take arguments,
-Strange *+?{} on zero-length expression, switching effective %s is not
-implemented, This Perl can't reset CRTL environ elements (%s), This Perl
-can't set CRTL environ elements (%s=%s), Too late to run %s block, Unknown
-open() mode '%s', Unknown process %x sent message to prime_env_iter: %s,
-Unrecognized escape \\%c passed through, Unterminated attribute parameter
-in attribute list, Unterminated attribute list, Unterminated attribute
-parameter in subroutine attribute list, Unterminated subroutine attribute
-list, Value of CLI symbol "%s" too long, Version number must be a constant
-number
+=over
-=item New tests
+=item DESCRIPTION
+
+=item Security Vulnerability Closed
=item Incompatible Changes
-=over
+=item Core Enhancements
-=item Perl Source Incompatibilities
+=item Modules and Pragmata
-CHECK is a new keyword, Treatment of list slices of undef has changed
+=over
-=item Format of $English::PERL_VERSION is different
+=item New Modules
-Literals of the form C<1.2.3> parse differently, Possibly changed
-pseudo-random number generator, Hashing function for hash keys has changed,
-C<undef> fails on read only values, Close-on-exec bit may be set on pipe
-and socket handles, Writing C<"$$1"> to mean C<"${$}1"> is unsupported,
-delete(), values() and C<\(%h)> operate on aliases to values, not copies,
-vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS, Text of some diagnostic
-output has changed, C<%@> has been removed, Parenthesized not() behaves
-like a list operator, Semantics of bareword prototype C<(*)> have changed
+=item Updated And Improved Modules and Pragmata
-=item Semantics of bit operators may have changed on 64-bit platforms
+=back
-=item More builtins taint their results
+=item Utility Changes
-=item C Source Incompatibilities
+=item New Documentation
-C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
+=item Performance Enhancements
-=item Compatible C Source API Changes
+=item Installation and Configuration Improvements
-C<PATCHLEVEL> is now C<PERL_VERSION>
+=over
-=item Binary Incompatibilities
+=item Generic Improvements
=back
-=item Known Problems
+=item Selected Bug Fixes
+
+sort() arguments are now compiled in the right wantarray context (they were
+accidentally using the context of the sort() itself)
=over
-=item Thread test failures
+=item Platform Specific Changes and Fixes
-=item EBCDIC platforms not supported
+=back
-=item In 64-bit HP-UX the lib/io_multihomed test may hang
+=item New or Changed Diagnostics
-=item NEXTSTEP 3.3 POSIX test failure
+=item Changed Internals
-=item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
-gcc
+=item Known Problems
-=item UNICOS/mk CC failures during Configure run
+=over
-=item Arrow operator and arrays
+=item Unicode Support Still Far From Perfect
-=item Windows 2000
+=item EBCDIC Still A Lost Platform
-=item Experimental features
+=item Building Extensions Can Fail Because Of Largefiles
-Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
-pseudo-hash data type, The Compiler suite, Internal implementation of file
-globbing, The DB module, The regular expression constructs C<(?{ code })>
-and C<(??{ code })>
+In string, @%s now must be written as \@%s
=back
-=item Obsolete Diagnostics
-
-Character class syntax [: :] is reserved for future extensions, Ill-formed
-logical name |%s| in prime_env_iter, Probable precedence problem on %s,
-regexp too big, Use of "$$<digit>" to mean "${$}<digit>" is deprecated
-
=item Reporting Bugs
=item SEE ALSO
=item Suspicious Warnings
-Whoa There, I<dlsym()>, Win9x and C<d_eofnblk>, Checking how std your stdio
-is.., Compiler/Preprocessor defines
+I<dlsym()>, Win9x and C<d_eofnblk>, Checking how std your stdio is..,
+Compiler/Preprocessor defines
=back
=item NFS filesystems and utime(2)
+=item perl -P and //
+
=back
=item AUTHOR
=item Segfault in make
+=item op/sprintf test failure
+
=back
=item Specific (mis)features of OS/2 port
=back
+=head2 perlposix-bc, README.posix-bc - building and installing Perl for
+BS2000 POSIX.
+
+=over
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over
+
+=item gzip
+
+=item bison
+
+=item Unpacking
+
+=item Compiling
+
+=item Testing
+
+=item Install
+
+=item Using Perl
+
+=back
+
+=item AUTHORS
+
+=item SEE ALSO
+
+=over
+
+=item Mailing list
+
+=back
+
+=item HISTORY
+
+=back
+
=head2 perlvms - VMS-specific documentation for Perl
=over
=item DESCRIPTION
-use warnings::register, warnings::enabled([$category]),
-warnings::warn([$category,] $message)
+use warnings::register, warnings::enabled(), warnings::enabled($category),
+warnings::enabled($object), warnings::warn($message),
+warnings::warn($category, $message), warnings::warn($object, $message),
+warnings::warnif($message), warnings::warnif($category, $message),
+warnings::warnif($object, $message)
=back
=item Package Lexicals
+=item Not Using AutoLoader
+
=item B<AutoLoader> vs. B<SelfLoader>
=back
=item PRAGMAS
--any, -compile, -nosticky, -nph, -newstyle_urls, -oldstyle_urls, -autoload,
--no_debug, -debug, -private_tempfiles
+-any, -compile, -nosticky, -no_xhtml, -nph, -newstyle_urls, -oldstyle_urls,
+-autoload, -no_debug, -debug, -private_tempfiles
=item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
=back
+=item MAKING WARNINGS APPEAR AS HTML COMMENTS
+
=item CHANGE LOG
=item AUTHORS
=back
-=head2 CGI::Util - various utilities
-
=head2 CPAN - query, download and build perl modules from CPAN sites
=over
=item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
-=item ProgrammerE<39>s interface
+=item Programmer's interface
expand($type,@things), Programming Examples
=item WORKING WITH CPAN.pm BEHIND FIREWALLS
+=over
+
+=item Three basic types of firewalls
+
http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
+=item Configuring lynx or ncftp for going through the firewall
+
+=back
+
+=item FAQ
+
+I installed a new version of module X but CPAN keeps saying, I have
+the old version installed, So why is UNINST=1 not the default?, When I
+install bundles or multiple modules with one command there is too
+much output to keep track of
+
=item BUGS
=item AUTHOR
=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<charsize>, C<chgrp>,
-C<chmod>, C<chown>, C<clocktype>, C<comm>, C<compress>
+C<ccflags_uselargefiles>, C<ccsymbols>, C<cf_by>, C<cf_email>, C<cf_time>,
+C<charsize>, C<chgrp>, C<chmod>, C<chown>, C<clocktype>, C<comm>,
+C<compress>
=item C
C<d_semctl_semun>, C<d_semget>, C<d_semop>, 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_setprior>, C<d_setproctitle>, 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_socklen_t>, C<d_sockpair>, C<d_sqrtl>,
C<d_statblks>, C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>,
=item g
-C<gccversion>, C<gidformat>, C<gidsign>, C<gidsize>, C<gidtype>,
-C<glibpth>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
+C<gccosandvers>, C<gccversion>, C<gidformat>, C<gidsign>, C<gidsize>,
+C<gidtype>, C<glibpth>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
=item h
C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
C<i8size>, C<i8type>, 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_iconv>, C<i_ieeefp>, 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_prot>, C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>,
-C<i_shadow>, C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>,
-C<i_string>, C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>,
-C<i_sysfilio>, C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>,
-C<i_sysmode>, 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_sysstatfs>,
-C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
-C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
-C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
-C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
-C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
-C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installman1dir>,
-C<installman3dir>, C<installprefix>, C<installprefixexp>,
-C<installprivlib>, C<installscript>, C<installsitearch>, C<installsitebin>,
-C<installsitelib>, C<installstyle>, C<installusrbinperl>,
-C<installvendorarch>, C<installvendorbin>, C<installvendorlib>, C<intsize>,
-C<ivdformat>, C<ivsize>, C<ivtype>
+C<i_grp>, C<i_iconv>, C<i_ieeefp>, C<i_inttypes>, C<i_libutil>,
+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_prot>, C<i_pthread>, C<i_pwd>,
+C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>, C<i_socks>,
+C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>, C<i_sunmath>,
+C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>, C<i_sysin>,
+C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>, 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_sysstatfs>, C<i_sysstatvfs>,
+C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>, C<i_sysuio>,
+C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>, C<i_termio>,
+C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>, C<i_values>,
+C<i_varargs>, C<i_varhdr>, C<i_vfork>, C<ignore_versioned_solibs>,
+C<inc_version_list>, C<inc_version_list_init>, C<incpath>, C<inews>,
+C<installarchlib>, C<installbin>, C<installman1dir>, C<installman3dir>,
+C<installprefix>, C<installprefixexp>, C<installprivlib>, C<installscript>,
+C<installsitearch>, C<installsitebin>, C<installsitelib>, C<installstyle>,
+C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>,
+C<installvendorlib>, C<intsize>, C<ivdformat>, C<ivsize>, C<ivtype>
=item k
=item l
-C<large>, C<ld>, C<lddlflags>, C<ldflags>, C<ldlibpthname>, C<less>,
-C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
-C<libsfiles>, C<libsfound>, C<libspath>, 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>
+C<large>, C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>,
+C<ldlibpthname>, C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>,
+C<libs>, C<libsdirs>, C<libsfiles>, C<libsfound>, C<libspath>,
+C<libswanted>, C<libswanted_uselargefiles>, 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<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>,
-C<nvsize>, C<nvtype>
+C<nveformat>, C<nvEformat>, C<nvfformat>, C<nvFformat>, C<nvgformat>,
+C<nvGformat>, C<nvsize>, C<nvtype>
=item o
C<usenm>, C<useopcode>, C<useperlio>, C<useposix>, C<usesfio>,
C<useshrplib>, C<usesocks>, C<usethreads>, C<usevendorprefix>, C<usevfork>,
C<usrinc>, C<uuname>, C<uvoformat>, C<uvsize>, C<uvtype>, C<uvuformat>,
-C<uvxformat>
+C<uvxformat>, C<uvXformat>
=item v
=item Specialised Import Lists
-=item Constants can be inlined
-
=item Exporting without using Export's import method
=item Module Version Checking
=item DESCRIPTION
-C<wanted>, C<bydepth>, C<follow>, C<follow_fast>, C<follow_skip>,
-C<no_chdir>, C<untaint>, C<untaint_pattern>, C<untaint_skip>
+C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
+C<follow_fast>, C<follow_skip>, C<no_chdir>, C<untaint>,
+C<untaint_pattern>, C<untaint_skip>
=item CAVEAT
=over
+=item PORTABILITY
+
=item SYNOPSIS
=item DESCRIPTION
=over
+=item Object oriented interface
+
=item Documentation and help texts
=item Storing options in a hash
=item Configuring Getopt::Long
-default, auto_abbrev, getopt_compat, require_order, permute, bundling
-(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)
+default, posix_default, auto_abbrev, getopt_compat, require_order, permute,
+bundling (default: disabled), bundling_override (default: disabled),
+ignore_case (default: enabled), ignore_case_always (default: disabled),
+pass_through (default: disabled), prefix, prefix_pattern, debug (default:
+disabled)
=item Return values and Errors
=back
+=item Trouble Shooting
+
+=over
+
+=item Warning: Ignoring '!' modifier for short option
+
+=item GetOptions does not return a false result when an option is not
+supplied
+
+=back
+
=item AUTHOR
=item COPYRIGHT AND DISCLAIMER
=item SYNOPSIS
-=item DESCRIPTION
+C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
+
+=item DIAGNOSTICS
+
+=over
+
+=item C<ndbm store returned -1, errno 22, key "..." at ...>
+
+=back
+
+=item BUGS AND WARNINGS
=back
=item SYNOPSIS
-=item DESCRIPTION
+C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
+
+=item DIAGNOSTICS
+
+=over
+
+=item C<odbm store returned -1, errno 22, key "..." at ...>
+
+=back
+
+=item BUGS AND WARNINGS
=back
=item Warnings
-multiple occurence of link target I<name>, line containing nothing but
+multiple occurrence of link target I<name>, line containing nothing but
whitespace in paragraph, file does not start with =head, No numeric
argument for =over, previous =item has no contents, preceding non-item
paragraph(s), =item type mismatch (I<one> vs. I<two>), I<N> unescaped
C<E<lt>E<gt>> in paragraph, Unknown entity, No items in =over, No argument
for =item, empty section in previous paragraph, Verbatim paragraph in NAME
-section, Hyperlinks
+section
+
+=item Hyperlinks
+
+collapsing newlines to blanks, ignoring leading/trailing whitespace in
+link, (section) in '$page' deprecated, alternative text/node '%s' contains
+non-escaped | or /
=back
=back
+C<Pod::Checker-E<gt>new( %options )>
+
C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
@args )>
=item DESCRIPTION
-=item OPTIONS
+=back
+
+=over
+
+=item C<pod_find( { %opts } , @directories )>
+
+C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
+1>
+
+=back
+
+=over
+
+=item C<simplify_name( $str )>
+
+=back
+
+=over
+
+=item C<pod_where( { %opts }, $pod )>
+
+C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
+1>
-B<-verbose>, B<-perl>, B<-script>, B<-inc>
+=back
+
+=over
+
+=item C<contains_pod( $file , $verbose )>
+
+=back
+
+=over
=item AUTHOR
=item DESCRIPTION
-B<Pod::InputSource>, B<Pod::Paragraph>, B<Pod::InteriorSequence>,
-B<Pod::ParseTree>
+package B<Pod::InputSource>, package B<Pod::Paragraph>, package
+B<Pod::InteriorSequence>, package B<Pod::ParseTree>
=back
=over
-=item B<new()>
+=item Pod::Paragraph-E<gt>B<new()>
=back
=over
-=item B<cmd_name()>
+=item $pod_para-E<gt>B<cmd_name()>
=back
=over
-=item B<text()>
+=item $pod_para-E<gt>B<text()>
=back
=over
-=item B<raw_text()>
+=item $pod_para-E<gt>B<raw_text()>
=back
=over
-=item B<cmd_prefix()>
+=item $pod_para-E<gt>B<cmd_prefix()>
=back
=over
-=item B<cmd_separator()>
+=item $pod_para-E<gt>B<cmd_separator()>
=back
=over
-=item B<parse_tree()>
+=item $pod_para-E<gt>B<parse_tree()>
=back
=over
-=item B<file_line()>
+=item $pod_para-E<gt>B<file_line()>
=back
=over
-=item B<new()>
+=item Pod::InteriorSequence-E<gt>B<new()>
=back
=over
-=item B<cmd_name()>
+=item $pod_seq-E<gt>B<cmd_name()>
=back
=over
-=item B<prepend()>
+=item $pod_seq-E<gt>B<prepend()>
=back
=over
-=item B<append()>
+=item $pod_seq-E<gt>B<append()>
=back
=over
-=item B<nested()>
+=item $pod_seq-E<gt>B<nested()>
=back
=over
-=item B<raw_text()>
+=item $pod_seq-E<gt>B<raw_text()>
=back
=over
-=item B<left_delimiter()>
+=item $pod_seq-E<gt>B<left_delimiter()>
=back
=over
-=item B<right_delimiter()>
+=item $pod_seq-E<gt>B<right_delimiter()>
=back
=over
-=item B<parse_tree()>
+=item $pod_seq-E<gt>B<parse_tree()>
=back
=over
-=item B<file_line()>
+=item $pod_seq-E<gt>B<file_line()>
=back
=over
-=item B<DESTROY()>
+=item Pod::InteriorSequence::B<DESTROY()>
=back
=over
-=item B<new()>
+=item Pod::ParseTree-E<gt>B<new()>
=back
=over
-=item B<top()>
+=item $ptree-E<gt>B<top()>
=back
=over
-=item B<children()>
+=item $ptree-E<gt>B<children()>
=back
=over
-=item B<prepend()>
+=item $ptree-E<gt>B<prepend()>
=back
=over
-=item B<append()>
+=item $ptree-E<gt>B<append()>
=back
=over
-=item B<raw_text()>
+=item $ptree-E<gt>B<raw_text()>
=back
=over
-=item B<DESTROY()>
+=item Pod::ParseTree::B<DESTROY()>
=back
=item Pod::List
-new()
+Pod::List-E<gt>new()
=back
-file()
+$list-E<gt>file()
-start()
+$list-E<gt>start()
-indent()
+$list-E<gt>indent()
-type()
+$list-E<gt>type()
-rx()
+$list-E<gt>rx()
-item()
+$list-E<gt>item()
-parent()
+$list-E<gt>parent()
-tag()
+$list-E<gt>tag()
=over
=item Pod::Hyperlink
-new()
+Pod::Hyperlink-E<gt>new()
=back
-parse($string)
+$link-E<gt>parse($string)
-markup($string)
+$link-E<gt>markup($string)
-text()
+$link-E<gt>text()
-warning()
+$link-E<gt>warning()
-line(), file()
+$link-E<gt>file(), $link-E<gt>line()
-page()
+$link-E<gt>page()
-node()
+$link-E<gt>node()
-alttext()
+$link-E<gt>alttext()
-type()
+$link-E<gt>type()
-link()
+$link-E<gt>link()
=over
=item Pod::Cache
-new()
+Pod::Cache-E<gt>new()
=back
-item()
+$cache-E<gt>item()
-find_page($name)
+$cache-E<gt>find_page($name)
=over
=item Pod::Cache::Item
-new()
+Pod::Cache::Item-E<gt>new()
=back
-page()
+$cacheitem-E<gt>page()
-description()
+$cacheitem-E<gt>description()
-path()
+$cacheitem-E<gt>path()
-file()
+$cacheitem-E<gt>file()
-nodes()
+$cacheitem-E<gt>nodes()
-find_node($name)
+$cacheitem-E<gt>find_node($name)
-idx()
+$cacheitem-E<gt>idx()
=over
=item DESCRIPTION
+C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
+
+=item DIAGNOSTICS
+
+=over
+
+=item C<sdbm store returned -1, errno 22, key "..." at ...>
+
+=back
+
+=item BUGS AND WARNINGS
+
=back
=head2 Safe - Compile and execute code in restricted compartments
=item DESCRIPTION
+=over
+
+=item OBJECT ORIENTED SYNTAX
+
+=back
+
=item AUTHOR
=back
=back
+=head2 Storable - persistency for perl data structures
+
+=over
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item MEMORY STORE
+
+=item SPEED
+
+=item CANONICAL REPRESENTATION
+
+=item ERROR REPORTING
+
+=item WIZARDS ONLY
+
+=over
+
+=item Hooks
+
+C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
+I<serialized>, ..
+
+=item Predicates
+
+C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
+C<Storable::is_retrieving>
+
+=item Recursion
+
+=item Deep Cloning
+
+=back
+
+=item EXAMPLES
+
+=item WARNING
+
+=item BUGS
+
+=item CREDITS
+
+=item TRANSLATIONS
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
=head2 Symbol - manipulate Perl symbols and their names
=over
=item DIAGNOSTICS
-Invalid attribute name %s, Identifier %s used only once: possible typo, No
-comma allowed after filehandle, Bareword %s not allowed while "strict subs"
-in use
+Invalid attribute name %s, Name "%s" used only once: possible typo, No
+comma allowed after filehandle, Bareword "%s" not allowed while "strict
+subs" in use
=item RESTRICTIONS
+=item NOTES
+
=item AUTHORS
=back
projects / p5sagit/p5-mst-13.2.git / blobdiff