=item Tutorials
+=item Reference Manual
+
=item Internals and C Language Interface
=item Miscellaneous
=back
-=head2 perlfaq - frequently asked questions about Perl ($Date: 2001/10/16
-13:27:22 $)
+=head2 perlfaq - frequently asked questions about Perl ($Date: 2002/03/11
+21:32:23 $)
=over 4
=item L<perlfaq5>: Files and Formats
-=item L<perlfaq6>: Regexps
+=item L<perlfaq6>: Regular Expressions
=item L<perlfaq7>: General Perl Language Issues
NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
binmode FILEHANDLE, DISCIPLINE, binmode FILEHANDLE, bless REF,CLASSNAME,
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, 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,
-exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, fcntl
-FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock FILEHANDLE,OPERATION,
-fork, format, formline PICTURE,LIST, getc FILEHANDLE, getc, getlogin,
-getpeername SOCKET, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam
-NAME, getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname
-NAME, getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr
-ADDR,ADDRTYPE, 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, getsockname SOCKET,
-getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL,
-goto EXPR, goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex,
-import, index STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl
-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 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,EXPR, open FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST,
-open FILEHANDLE, opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR
-: ATTRIBUTES, 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
+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, 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, exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp,
+fcntl FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock
+FILEHANDLE,OPERATION, fork, format, formline PICTURE,LIST, getc FILEHANDLE,
+getc, getlogin, getpeername SOCKET, getpgrp PID, getppid, getpriority
+WHICH,WHO, getpwnam NAME, getgrnam NAME, gethostbyname NAME, getnetbyname
+NAME, getprotobyname NAME, getpwuid UID, getgrgid GID, getservbyname
+NAME,PROTO, gethostbyaddr ADDR,ADDRTYPE, 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, getsockname SOCKET, getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR,
+glob, gmtime EXPR, goto LABEL, goto EXPR, goto &NAME, grep BLOCK LIST, grep
+EXPR,LIST, hex EXPR, hex, import, index STR,SUBSTR,POSITION, index
+STR,SUBSTR, int EXPR, int, ioctl 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 THING, 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 VERSION LIST, no Module VERSION, no Module
+LIST, no Module, oct EXPR, oct, open FILEHANDLE,EXPR, open
+FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST, open
+FILEHANDLE,MODE,REFERENCE, open FILEHANDLE, opendir DIRHANDLE,EXPR, ord
+EXPR, ord, our EXPR, our EXPR : ATTRIBUTES, 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,
=over 4
-=item Declaration of a ARRAY OF ARRAYS
+=item Declaration of an ARRAY OF ARRAYS
-=item Generation of a ARRAY OF ARRAYS
+=item Generation of an ARRAY OF ARRAYS
-=item Access and Printing of a ARRAY OF ARRAYS
+=item Access and Printing of an ARRAY OF ARRAYS
=back
=over 4
-=item Declaration of a ARRAY OF HASHES
+=item Declaration of an ARRAY OF HASHES
-=item Generation of a ARRAY OF HASHES
+=item Generation of an ARRAY OF HASHES
-=item Access and Printing of a ARRAY OF HASHES
+=item Access and Printing of an ARRAY OF HASHES
=back
=item Parsing Traps
-Parsing, Parsing, Parsing, Parsing
+Parsing, Parsing, Parsing, Parsing, Parsing
=item Numerical Traps
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 ...'>,
B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
-B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>, B<-X>,
-B<-x> I<directory>
+B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>,
+B<-X>, B<-x> I<directory>
=back
HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLLIB, PERL5DB, PERL5SHELL
(specific to the Win32 port), PERL_DEBUG_MSTATS, PERL_DESTRUCT_LEVEL,
-PERL_ROOT (specific to the VMS port), SYS$LOGIN (specific to the VMS port)
+PERL_ENCODING, PERL_ROOT (specific to the VMS port), SYS$LOGIN (specific to
+the VMS port)
=back
=item use strict
-=item Looking at data and -w and w
+=item Looking at data and -w and v
=item help
=item Debugger Commands
-h [command], p expr, x expr, V [pkg [vars]], X [vars], T, s [expr], n
-[expr], r, <CR>, c [line|sub], l, l min+incr, l min-max, l line, l subname,
--, w [line], f filename, /pattern/, ?pattern?, L, S [[!]regex], t, t expr,
-b [line] [condition], b subname [condition], b postpone subname
-[condition], b load filename, b compile subname, d [line], D, a [line]
-command, a [line], A, W expr, W, O booloption .., O anyoption? .., O
-option=value .., < ?, < [ command ], << command, > ?, > command, >>
-command, { ?, { [ command ], {{ command, ! number, ! -number, ! pattern, !!
-cmd, @ file, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, man
-[manpage]
+h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], y
+[level [vars]], T, s [expr], n [expr], r, <CR>, c [line|sub], l, l
+min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/,
+?pattern?, L [abw], S [[!]regex], t, t expr, b, b [line] [condition], b
+subname [condition], b postpone subname [condition], b load filename, b
+compile subname, B line, B *, a [line] command, A line, A *, w expr, W
+expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [
+command ], << command, > ?, > command, >> command, { ?, { [ command ], {{
+command, ! number, ! -number, ! pattern, !! cmd, @ file, H -number, q or
+^D, R, |dbcmd, ||dbcmd, command, m expr, M, man [manpage]
=item Configurable Options
C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
-C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
-C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>, C<HighBit>,
-C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>, C<NonStop>
+C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>,
+C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>,
+C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>,
+C<NonStop>
=item Debugger input/output
$FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
IO::Handle->format_line_break_characters EXPR,
$FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed 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, ${^TAINT}, $PERL_VERSION,
-$^V, $WARNING, $^W, ${^WARNING_BITS}, ${^WIDE_SYSTEM_CALLS},
-$EXECUTABLE_NAME, $^X, ARGV, $ARGV, @ARGV, @F, @INC, @_, %INC, %ENV,
-$ENV{expr}, %SIG, $SIG{expr}
+$FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING},
+$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,
+${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
+0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R, $EXCEPTIONS_BEING_CAUGHT, $^S,
+$BASETIME, $^T, ${^TAINT}, $PERL_VERSION, $^V, $WARNING, $^W,
+${^WARNING_BITS}, ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, ARGV,
+$ARGV, @ARGV, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr}
=item Error Indicators
=back
+=head2 perlpacktut - tutorial on C<pack> and C<unpack>
+
+=over 4
+
+=item DESCRIPTION
+
+=item The Basic Principle
+
+=item Packing Text
+
+=item Packing Numbers
+
+=over 4
+
+=item Integers
+
+=item Unpacking a Stack Frame
+
+=item How to Eat an Egg on a Net
+
+=item Floating point Numbers
+
+=back
+
+=item Exotic Templates
+
+=over 4
+
+=item Bit Strings
+
+=item Uuencoding
+
+=item Doing Sums
+
+=item Unicode
+
+=item Another Portable Binary Encoding
+
+=back
+
+=item Lengths and Widths
+
+=over 4
+
+=item String Lengths
+
+=item Dynamic Templates
+
+=back
+
+=item Packing and Unpacking C Structures
+
+=over 4
+
+=item The Alignment Pit
+
+=item Alignment, Take 2
+
+=item Alignment, Take 3
+
+=item Pointers for How to Use Them
+
+=back
+
+=item Pack Recipes
+
+=item Funnies Section
+
+=item Authors
+
+=back
+
=head2 perlretut - Perl regular expressions tutorial
=over 4
=item Regular Expressions
-cntrl, graph, print, punct, xdigit
+[1], [2], [3], cntrl, graph, print, punct, xdigit
=item Extended Patterns
-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, exit EXPR, exit, 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,
+LIST, exit EXPR, exit, 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, sockatmark SOCKET,
=item AUTHORS / CONTRIBUTORS
-=item VERSION
-
=back
=head2 perllocale - Perl locale handling (internationalization and
=back
+=item Unicode and UTF-8
+
=item BUGS
=over 4
=back
+=head2 perluniintro - Perl Unicode introduction
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item Unicode
+
+=item Perl's Unicode Support
+
+=item Perl's Unicode Model
+
+=item Unicode and EBCDIC
+
+=item Creating Unicode
+
+=item Handling Unicode
+
+=item Legacy Encodings
+
+=item Unicode I/O
+
+=item Displaying Unicode As Text
+
+=item Special Cases
+
+=item Advanced Topics
+
+=item Miscellaneous
+
+=item Questions With Answers
+
+, , , , , ,
+
+=item Hexadecimal Notation
+
+=item Further Resources
+
+=back
+
+=item UNICODE IN OLDER PERLS
+
+=item SEE ALSO
+
+=item ACKNOWLEDGEMENTS
+
+=item AUTHOR, COPYRIGHT, AND LICENSE
+
+=back
+
=head2 perlunicode - Unicode support in Perl
=over 4
=item Character encodings for input and output
-=back
+=item Unicode Regular Expression Support Level
-=item CAVEATS
+=item Unicode Encodings
-=item UNICODE REGULAR EXPRESSION SUPPORT LEVEL
+=item Security Implications of Malformed UTF-8
+
+=item Unicode in Perl on EBCDIC
+
+=item Locales
+
+=item Using Unicode in XS
+
+=back
+
+=item BUGS
=item SEE ALSO
=item POSIX-BC
+=item Unicode code points versus EBCDIC code points
+
+=item Remaining Perl Unicode problems in EBCDIC
+
=item Unicode and UTF
+=item Using Encode
+
=back
=item SINGLE OCTET TABLES
=item Pragmatic Modules
-attributes, attrs, autouse, base, blib, bytes, charnames, constant,
-diagnostics, fields, filetest, integer, less, locale, open, ops, overload,
-re, sigtrap, strict, subs, threads, utf8, vars, warnings,
-warnings::register
+attributes, autouse, base, bigint, bignum, bigrat, blib, bytes, charnames,
+constant, diagnostics, encoding, fields, filetest, if, integer, less,
+locale, open, overload, re, sigtrap, sort, strict, subs, utf8, vars,
+vmsish, warnings, warnings::register
=item Standard Modules
-AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
-B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
-B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
-B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
-CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
-CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
-Class::Struct, Cwd, DB, DB_File, Devel::SelfStubber, Digest, DirHandle,
-Dumpvalue, Encode, Encode::EncodeFormat, Encode::Tcl, English, Env,
-Exporter, Exporter::Heavy, ExtUtils::Command, ExtUtils::Constant,
-ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist,
+AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, Benchmark, CGI,
+CGI::Apache, CGI::Carp, CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push,
+CGI::Switch, CGI::Util, CPAN, CPAN::FirstTime, CPAN::Nox, Carp,
+Carp::Heavy, Class::ISA, Class::Struct, Cwd, DB, Devel::SelfStubber,
+Digest, DirHandle, Dumpvalue, English, Env, Exporter, Exporter::Heavy,
+ExtUtils::Command, ExtUtils::Constant, ExtUtils::Embed, ExtUtils::Install,
+ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM_BeOS,
ExtUtils::MM_Cygwin, ExtUtils::MM_NW5, 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,
+ExtUtils::Packlist, ExtUtils::testlib, Fatal, File::Basename,
File::CheckTree, File::Compare, File::Copy, File::DosGlob, File::Find,
-File::Path, File::Spec, File::Spec::Epoc, File::Spec::Functions,
-File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, File::Spec::VMS,
-File::Spec::Win32, File::Temp, File::stat, FileCache, FileHandle,
-Filter::Simple, FindBin, Getopt::Long, Getopt::Std, I18N::Collate,
-I18N::LangTags, I18N::LangTags::List, IO, IPC::Open2, IPC::Open3,
-Lingua::KO::Hangul::Util, Locale::Constants, Locale::Country,
-Locale::Currency, Locale::Language, Locale::Maketext,
-Locale::Maketext::TPJ13, Math::BigFloat, Math::BigInt, Math::BigInt::Calc,
-Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire,
-Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File,
-Memoize::SDBM_File, Memoize::Saves, Memoize::Storable, NDBM_File, NEXT,
-Net::Cmd, Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc,
-Net::POP3, Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ,
-Net::netent, Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX,
-PerlIO, Pod::Checker, Pod::Find, Pod::Html, Pod::InputObjects, Pod::LaTeX,
-Pod::Man, Pod::ParseUtils, Pod::Parser, Pod::Plainer, Pod::Select,
+File::Path, File::Spec, File::Spec::Cygwin, File::Spec::Epoc,
+File::Spec::Functions, File::Spec::Mac, File::Spec::OS2, File::Spec::Unix,
+File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache,
+FileHandle, Filter::Simple, FindBin, Getopt::Long, Getopt::Std, Hash::Util,
+I18N::Collate, I18N::LangTags, I18N::LangTags::List, IPC::Open2,
+IPC::Open3, Locale::Constants, Locale::Country, Locale::Currency,
+Locale::Language, Locale::Maketext, Locale::Maketext::TPJ13,
+Locale::Script, Math::BigFloat, Math::BigInt, Math::BigInt::Calc,
+Math::BigRat, Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File,
+Memoize::Expire, Memoize::ExpireFile, Memoize::ExpireTest,
+Memoize::NDBM_File, Memoize::SDBM_File, Memoize::Storable, NEXT, Net::Cmd,
+Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, Net::POP3,
+Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, Net::netent,
+Net::protoent, Net::servent, PerlIO, Pod::Checker, Pod::Find,
+Pod::Functions, Pod::Html, Pod::InputObjects, Pod::LaTeX, Pod::Man,
+Pod::ParseLink, Pod::ParseUtils, Pod::Parser, Pod::Plainer, Pod::Select,
Pod::Text, Pod::Text::Color, Pod::Text::Overstrike, Pod::Text::Termcap,
-Pod::Usage, SDBM_File, Safe, Search::Dict, SelectSaver, SelfLoader, Shell,
-Socket, Storable, Switch, Symbol, Term::ANSIColor, Term::Cap,
-Term::Complete, Term::ReadLine, Test, Test::Harness, Test::More,
-Test::Simple, Test::Tutorial, Text::Abbrev, Text::Balanced,
-Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Tie::Array,
-Tie::Handle, Tie::Hash, Tie::RefHash, Tie::Scalar, Tie::SubstrHash,
-Time::Local, Time::gmtime, Time::localtime, Time::tm, UNIVERSAL,
-Unicode::Collate, Unicode::Normalize, Unicode::UCD, User::grent,
-User::pwent, Win32
+Pod::Usage, Pod::t::basic, Search::Dict, SelectSaver, SelfLoader, Shell,
+Switch, Symbol, Term::ANSIColor, Term::Cap, Term::Complete, Term::ReadLine,
+Test, Test::Builder, Test::Harness, Test::Harness::Assert,
+Test::Harness::Iterator, Test::Harness::Straps, Test::More, Test::Simple,
+Test::Tutorial, Text::Abbrev, Text::Balanced, Text::ParseWords,
+Text::Soundex, Text::Tabs, Text::Wrap, Thread, Tie::Array, Tie::File,
+Tie::Handle, Tie::Hash, Tie::Memoize, Tie::RefHash, Tie::Scalar,
+Tie::SubstrHash, Time::Local, Time::gmtime, Time::localtime, Time::tm,
+UNIVERSAL, Unicode::Collate, Unicode::UCD, User::grent, User::pwent, Win32
=item Extension Modules
=item Guidelines for Module Creation
-Adding a Copyright Notice
-
=item Guidelines for Converting Perl 4 Library Scripts into Modules
=item Guidelines for Reusing Application Code
=back
-=head2 perlfaq1 - General Questions About Perl ($Revision: 1.1 $, $Date:
-2001/09/20 03:03:00 $)
+=head2 perlfaq1 - General Questions About Perl ($Revision: 1.7 $, $Date:
+2002/02/21 14:49:15 $)
=over 4
=item Where can I get a list of Larry Wall witticisms?
=item How can I convince my sysadmin/supervisor/employees to use version
-5/5.005/Perl instead of some other language?
+5/5.6.1/Perl instead of some other language?
=back
=back
-=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.2 $,
-$Date: 2001/10/16 13:27:22 $)
+=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.9 $,
+$Date: 2002/03/09 21:01:13 $)
=over 4
=item Where do I send bug reports?
-=item What is perl.com? Perl Mongers? pm.org? perl.org?
+=item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?
=back
=back
-=head2 perlfaq3 - Programming Tools ($Revision: 1.8 $, $Date: 2001/10/17
-14:14:20 $)
+=head2 perlfaq3 - Programming Tools ($Revision: 1.15 $, $Date: 2002/02/11
+19:29:52 $)
=over 4
=item How can I generate simple menus without using CGI or Tk?
-=item What is undump?
-
=item How can I make my Perl program run faster?
=item How can I make my Perl program take less memory?
=item Where can I learn about CGI or Web programming in Perl?
+=item Where can I learn about object-oriented Perl programming?
+
=item Where can I learn about linking C with Perl? [h2xs, xsubpp]
=item I've read perlembed, perlguts, etc., but I can't embed perl in
my C program; what am I doing wrong?
-=item When I tried to run my script, I got this message. What does it
-mean?
+=item When I tried to run my script, I got this message. What does it mean?
=item What's MakeMaker?
=back
-=head2 perlfaq4 - Data Manipulation ($Revision: 1.5 $, $Date: 2001/10/12
-15:20:13 $)
+=head2 perlfaq4 - Data Manipulation ($Revision: 1.19 $, $Date: 2002/03/11
+22:15:19 $)
=over 4
=item Does Perl have a round() function? What about ceil() and floor()?
Trig functions?
-=item How do I convert bits into ints?
+=item How do I convert between numeric representations?
+
+B<How do I convert Hexadecimal into decimal:>, B<How do I convert from
+decimal to hexadecimal:>, B<How do I convert from octal to decimal:>, B<How
+do I convert from decimal to octal:>, B<How do I convert from binary to
+decimal:>, B<How do I convert from decimal to binary:>
=item Why doesn't & work the way I want it to?
=item Why aren't my random numbers random?
+=item How do I get a random number between X and Y?
+
=back
=item Data: Dates
=back
-=head2 perlfaq5 - Files and Formats ($Revision: 1.3 $, $Date: 2001/10/16
-13:27:22 $)
+=head2 perlfaq5 - Files and Formats ($Revision: 1.12 $, $Date: 2002/03/11
+22:25:25 $)
=over 4
=item How do I close a file descriptor by number?
-=item Why can't I use "C:\temp\foo" in DOS paths? What doesn't
+=item Why can't I use "C:\temp\foo" in DOS paths? Why doesn't
`C:\temp\foo.exe` work?
=item Why doesn't glob("*.*") get all the files?
=back
-=head2 perlfaq6 - Regexes ($Revision: 1.3 $, $Date: 2001/10/16 13:27:22 $)
+=head2 perlfaq6 - Regular Expressions ($Revision: 1.8 $, $Date: 2002/01/31
+04:27:55 $)
=over 4
=back
-=head2 perlfaq7 - Perl Language Issues ($Revision: 1.2 $, $Date: 2001/10/16
-13:27:22 $)
+=head2 perlfaq7 - General Perl Language Issues ($Revision: 1.7 $, $Date:
+2002/01/31 04:27:55 $)
=over 4
=back
-=head2 perlfaq8 - System Interaction ($Revision: 1.2 $, $Date: 2001/10/16
-13:27:22 $)
+=head2 perlfaq8 - System Interaction ($Revision: 1.6 $, $Date: 2002/01/28
+04:17:27 $)
=over 4
=back
-=head2 perlfaq9 - Networking ($Revision: 1.3 $, $Date: 2001/10/16 13:27:22
+=head2 perlfaq9 - Networking ($Revision: 1.7 $, $Date: 2002/01/28 04:17:27
$)
=over 4
=item The Optimized C Back End
-B, O, 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::Stash, B::Terse, B::Xref
-
=back
+=item Module List for the Compiler Suite
+
+B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
+B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex,
+B::Stackobj, B::Stash, B::Terse, B::Xref
+
=item KNOWN PROBLEMS
=item AUTHOR
=item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
+=item The C<length(NAME)> Keyword
+
=item Variable-length Parameter Lists
=item The C_ARGS: Keyword
=item The ALIAS: Keyword
+=item The OVERLOAD: Keyword
+
=item The INTERFACE: Keyword
=item The INTERFACE_MACRO: Keyword
=item The Typemap
+=item Safely Storing Static Data in XS
+
+MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT
+
=back
=item EXAMPLES
=item DESCRIPTION
+=item "Gimme" Values
+
+GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID
+
+=item Array Manipulation Functions
+
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,
-ax, bytes_from_utf8, bytes_to_utf8, call_argv, call_method, call_pv,
-call_sv, CLASS, Copy, croak, CvSTASH, cv_const_sv, dAX, dITEMS, dMARK,
-dORIGMARK, dSP, dXSARGS, dXSI32, ENTER, eval_pv, eval_sv, EXTEND,
-fbm_compile, fbm_instr, FREETMPS, getcwd_sv, get_av, get_cv, get_hv,
-get_sv, GIMME, GIMME_V, grok_bin, grok_hex, grok_number,
-grok_numeric_radix, grok_oct, 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, is_utf8_char, is_utf8_string, items,
-ix, LEAVE, load_module, 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, NEWSV, newSViv,
-newSVnv, newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv,
-newSVuv, newXS, newXSproto, Newz, Nullav, Nullch, Nullcv, Nullhv, Nullsv,
-ORIGMARK, perl_alloc, perl_clone, perl_construct, perl_destruct, perl_free,
-perl_parse, perl_run, PL_modglobal, PL_na, PL_sv_no, PL_sv_undef,
-PL_sv_yes, POPi, POPl, POPn, POPp, POPpbytex, POPpx, POPs, PUSHi, PUSHMARK,
-PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK, Renew, Renewc, require_pv, RETVAL,
-Safefree, savepv, savepvn, SAVETMPS, scan_bin, scan_hex, scan_oct,
-sharedsv_find, sharedsv_init, sharedsv_lock, sharedsv_new,
-sharedsv_thrcnt_dec, sharedsv_thrcnt_inc, sharedsv_unlock, sortsv, SP,
-SPAGAIN, ST, strEQ, strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE,
-StructCopy, SvCUR, SvCUR_set, SvEND, SvGETMAGIC, SvGROW, SvIOK, SvIOKp,
-SvIOK_notUV, SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV,
-SvIV, SvIVX, SvIVx, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp,
-SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX, SvNVx, SvOK, SvOOK, SvPOK,
-SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVbyte,
+get_av, newAV, Nullav, sortsv
+
+=item Callback Functions
+
+call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv,
+FREETMPS, LEAVE, SAVETMPS
+
+=item Character classes
+
+isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER
+
+=item Cloning an interpreter
+
+perl_clone
+
+=item CV Manipulation Functions
+
+CvSTASH, get_cv, Nullcv
+
+=item Embedding Functions
+
+load_module, nothreadhook, perl_alloc, perl_construct, perl_destruct,
+perl_free, perl_parse, perl_run, require_pv
+
+=item Functions in file pp_pack.c
+
+pack_cat, unpack_str
+
+=item Global Variables
+
+PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes
+
+=item GV Functions
+
+GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload,
+gv_fetchmeth_autoload, gv_stashpv, gv_stashsv
+
+=item Handy Values
+
+HEf_SVKEY, Nullch, Nullsv
+
+=item Hash Manipulation Functions
+
+get_hv, 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, newHV, Nullhv
+
+=item Magical Functions
+
+mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set,
+SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal,
+SvSetSV, SvSetSV_nosteal, SvSHARE
+
+=item Memory Management
+
+Copy, Move, New, Newc, NEWSV, Newz, Renew, Renewc, Safefree, savepv,
+savepvn, savesharedpv, StructCopy, Zero
+
+=item Miscellaneous Functions
+
+fbm_compile, fbm_instr, form, getcwd_sv, strEQ, strGE, strGT, strLE, strLT,
+strNE, strnEQ, strnNE
+
+=item Numeric functions
+
+grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin,
+scan_hex, scan_oct
+
+=item Optree Manipulation Functions
+
+cv_const_sv, newCONSTSUB, newXS
+
+=item Stack Manipulation Macros
+
+dMARK, dORIGMARK, dSP, EXTEND, MARK, ORIGMARK, POPi, POPl, POPn, POPp,
+POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu,
+PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XSRETURN,
+XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF,
+XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES
+
+=item SV Flags
+
+svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG
+
+=item SV Manipulation Functions
+
+get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv,
+newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv,
+new_vstring, SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV,
+SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIV, SvIVx,
+SvIVX, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, SvNOK_off,
+SvNOK_on, SvNOK_only, SvNV, SvNVX, SvNVx, SvOK, SvOOK, SvPOK, SvPOKp,
+SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVbyte,
SvPVbytex, SvPVbytex_force, SvPVbyte_force, SvPVbyte_nolen, SvPVutf8,
SvPVutf8x, SvPVutf8x_force, SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX,
SvPV_force, SvPV_force_nomg, SvPV_nolen, SvREFCNT, SvREFCNT_dec,
-SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSETMAGIC, SvSetMagicSV,
-SvSetMagicSV_nosteal, 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, SvUOK, SvUPGRADE,
-SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, SvUVx, sv_2bool, sv_2cv,
-sv_2io, sv_2iv, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen,
+SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSTASH, SvTAINT,
+SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, SvUNLOCK, SvUOK,
+SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, SvUVx, sv_2bool,
+sv_2cv, sv_2io, sv_2iv, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen,
sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv,
sv_backoff, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn,
sv_catpvn_flags, sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_flags,
-sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm, sv_dec,
-sv_derived_from, sv_eq, sv_force_normal, sv_force_normal_flags, sv_free,
-sv_gets, sv_grow, sv_inc, sv_insert, sv_isa, sv_isobject, sv_iv, sv_len,
-sv_len_utf8, sv_magic, sv_mortalcopy, sv_newmortal, sv_newref, sv_nv,
-sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte, sv_pvbyten, sv_pvbyten_force,
-sv_pvn, sv_pvn_force, sv_pvn_force_flags, sv_pvutf8, sv_pvutf8n,
-sv_pvutf8n_force, sv_reftype, sv_replace, sv_report_used, sv_reset,
-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_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg,
-sv_setuv, sv_setuv_mg, sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref,
-sv_unref_flags, sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg,
-sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade,
-sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn, THIS, toLOWER,
-toUPPER, utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop,
-utf8_length, utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8,
-uvuni_to_utf8, warn, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XS, XSRETURN,
-XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV,
-XSRETURN_UNDEF, XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV,
-XST_mUNDEF, XST_mYES, XS_VERSION, XS_VERSION_BOOTCHECK, Zero
+sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm,
+sv_copypv, sv_dec, sv_derived_from, sv_eq, sv_force_normal,
+sv_force_normal_flags, sv_free, sv_gets, sv_grow, sv_inc, sv_insert,
+sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8, sv_magic, sv_magicext,
+sv_mortalcopy, sv_newmortal, sv_newref, sv_nolocking, sv_nosharing,
+sv_nounlocking, sv_nv, sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte,
+sv_pvbyten, sv_pvbyten_force, sv_pvn, sv_pvn_force, sv_pvn_force_flags,
+sv_pvutf8, sv_pvutf8n, sv_pvutf8n_force, sv_reftype, sv_replace,
+sv_report_used, sv_reset, 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_setref_uv, sv_setsv, sv_setsv_flags,
+sv_setsv_mg, sv_setuv, sv_setuv_mg, sv_taint, sv_tainted, sv_true,
+sv_unmagic, sv_unref, sv_unref_flags, sv_untaint, sv_upgrade, sv_usepvn,
+sv_usepvn_mg, sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode,
+sv_utf8_upgrade, sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn
+
+=item Unicode Support
+
+bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string,
+pv_uni_display, sv_recode_to_utf8, sv_uni_display, to_utf8_case,
+to_utf8_fold, to_utf8_lower, to_utf8_title, to_utf8_upper, utf8n_to_uvchr,
+utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length, utf8_to_bytes,
+utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8, uvuni_to_utf8_flags
+
+=item Variables created by C<xsubpp> and C<xsubpp> internal functions
+
+ax, CLASS, dAX, dITEMS, dXSARGS, dXSI32, items, ix, newXSproto, RETVAL, ST,
+THIS, XS, XSRETURN_EMPTY, XS_VERSION, XS_VERSION_BOOTCHECK
+
+=item Warning and Dieing
+
+croak, warn
=item AUTHORS
=item DESCRIPTION
-djSP, is_gv_magical, LVRET, PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn,
-PL_last_in_gv, PL_ofs_sv, PL_rs, report_uninit, start_glob, sv_add_arena,
-sv_clean_all, sv_clean_objs, sv_free_arenas
+=item Global Variables
+
+PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv,
+PL_rs
+
+=item GV Functions
+
+is_gv_magical
+
+=item IO Functions
+
+start_glob
+
+=item Pad Data Structures
+
+CvPADLIST
+
+=item Stack Manipulation Macros
+
+djSP, LVRET
+
+=item SV Manipulation Functions
+
+report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas
=item AUTHORS
=item Data Structures
-1. The functions and attributes of the "layer class", 2. The per-instance
-data for a particular handle
-
=item Functions and Attributes
=item Per-instance Data
=item Methods in Detail
- IV (*Pushed)(PerlIO *f,const char *mode, SV *arg);, IV
- (*Popped)(PerlIO *f);, PerlIO * (*Open)(...);, SV *
-(*Getarg)(PerlIO *f);, IV (*Fileno)(PerlIO *f);, SSize_t
-(*Read)(PerlIO *f, void *vbuf, Size_t count);, SSize_t (*Unread)(PerlIO
-*f, const void *vbuf, Size_t count);, SSize_t (*Write)(PerlIO *f, const
-void *vbuf, Size_t count);, IV (*Seek)(PerlIO *f, Off_t
-offset, int whence);, Off_t (*Tell)(PerlIO *f);, IV
- (*Close)(PerlIO *f);, IV (*Flush)(PerlIO *f);, IV
- (*Fill)(PerlIO *f);, IV (*Eof)(PerlIO *f);, IV
- (*Error)(PerlIO *f);, void (*Clearerr)(PerlIO *f);, void
- (*Setlinebuf)(PerlIO *f);, STDCHAR * (*Get_base)(PerlIO *f);,
-Size_t (*Get_bufsiz)(PerlIO *f);, STDCHAR *
-(*Get_ptr)(PerlIO *f);, SSize_t (*Get_cnt)(PerlIO *f);, void
- (*Set_ptrcnt)(PerlIO *f,STDCHAR *ptr,SSize_t cnt);
+name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_CANCRLF, PERLIO_K_FASTGETS,
+PERLIO_K_MULTIARG, PERLIO_K_RAW, Pushed, Popped, Open, Getarg, Fileno, Dup,
+Read, Write, Seek, Tell, Close, Flush, Fill, Eof, Error, Clearerr,
+Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt, Set_ptrcnt
=item Core Layers
=back
+=item TODO
+
=back
=head2 perlapio - perl's IO abstraction interface.
=item Security audit shipped utilities
-=item Custom opcodes
+=item Sort out the uid-setting mess
-=item spawnvp() on Win32
+=item Custom opcodes
=item DLL Versioning
=item Memory leaks after failed eval
-=item pack "(stuff)*"
-
=item bitfields in pack
=item Cross compilation
=item Prototypes versus indirect objects
-=item Install HMTL
+=item Install HTML
=item Prototype method calls
=item IO tutorial
-=item pack/unpack tutorial
-
=item Rewrite perldoc
=item Install .3p manpages
=item Use fchown/fchmod internally
+=item Make v-strings overloaded objects
+
+=item Allow restricted hash assignment
+
=back
=item Vague ideas
=item Attach/detach debugger from running program
-=item Alternative RE syntax module
-
=item GUI::Native
=item foreach(reverse ...)
=over 4
+=item Alternative RE syntax module
+
=item Safe signal handling
=item Tie Modules
=item Create debugging macros
+=item truncate to the people
+
+=item pack/unpack tutorial
+
=back
=back
implementation?, Backwards compatibility, Could it be a module instead?, Is
the feature generic enough?, Does it potentially introduce new bugs?, Does
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
+the implementation generic enough to be portable?, Is the implementation
+tested?, Is there enough documentation?, Is there another way to do it?,
+Does it create too much work?, Patches speak louder than words
=over 4
It's easier to rsync the patches, It's a good reference, Finding a start
point, Finding how to fix a bug, Finding the source of misbehaviour
+=item Perlbug remote interface
+
+1 http://bugs.perl.org, 2 bugdb@perl.org, 3
+commands_and_bugdids@bugs.perl.org, notes, patches, tests
+
=item Submitting patches
L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
=item Writing a test
F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
-F<t/pod/>, F<t/run/>
+F<t/pod/>, F<t/run/>, t/base t/comp, t/cmd t/run t/io t/op, t/lib ext lib
=back
-h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
-z[ero]
+=item Miscellaneous tricks
+
=item CONCLUSION
I<The Road goes ever on and on, down from the door where it began.>
=back
-=head2 perldelta - what will be new for perl v5.8.0
-
-=over 4
-
-=item DESCRIPTION
-
-=item Reporting Bugs
-
-=item SEE ALSO
-
-=item HISTORY
-
-=back
-
-=head2 perl572delta - what's new for perl v5.7.2
+=head2 perldelta - what is new for perl v5.8.0
=over 4
=item DESCRIPTION
-=item Security Vulnerability Closed
+=item Highlights In 5.8.0
=item Incompatible Changes
=item AIX Dynaloading
+=item Attributes for C<my> variables now handled at run-time.
+
=item Socket Extension Dynamic in VMS
-=item Different Definition of the Unicode Character Classes \p{In...}
+=item IEEE-format Floating Point Default on OpenVMS Alpha
+
+=item New Unicode Properties
+
+=item REF(...) Instead Of SCALAR(...)
+
+=item pack/unpack D/F recycled
=item Deprecations
=item Core Enhancements
+=over 4
+
+=item PerlIO is Now The Default
+
+=item Safe Signals
+
+=item Unicode Overhaul
+
+=item Understanding of Numbers
+
+=item Miscellaneous Changes
+
+=back
+
=item Modules and Pragmata
=over 4
-=item New Modules and Distributions
+=item New Modules and Pragmata
=item Updated And Improved Modules and Pragmata
=item New Documentation
+=item Performance Enhancements
+
=item Installation and Configuration Improvements
=over 4
-=item New Or Improved Platforms
-
=item Generic Improvements
+=item New Or Improved Platforms
+
=back
=item Selected Bug Fixes
=item New or Changed Diagnostics
-=item Source Code Enhancements
-
-=over 4
-
-=item MAGIC constants
-
-=item Better commented code
-
-=item Regex pre-/post-compilation items matched up
-
-=item gcc -Wall
+=item Changed Internals
-=back
+=item Security Vulnerability Closed
=item New Tests
=item Amiga Perl Invoking Mystery
-=item lib/ftmp-security tests warn 'system possibly insecure'
+=item FreeBSD Failing locale Test 117 For ISO8859-15 Locales
-=item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
+=item mod_perl 1.26 Doesn't Build With Threaded Perl
-=item HP-UX lib/io_multihomed Fails When LP64-Configur
+=item lib/ftmp-security tests warn 'system possibly insecure'
=item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
=item Linux With Sfio Fails op/misc Test 48
-=item OS/390
+=item Mac OS X
-=item op/sprintf tests 129 and 130
+=item op/sprintf tests 91, 129, and 130
+
+=item Failure of Thread (5.005-style) tests
+
+=item UNICOS
+
+=item UNICOS and UNICOS/mk
+
+=item UNICOS/mk
+
+=item UTS
+
+=item VMS
+
+=item Win32
+
+=item XML::Parser not working
+
+=item Localising a Tied Variable Leaks Memory
+
+=item z/OS (OS/390)
+
+=item Localising Tied Arrays and Hashes Is Broken
+
+=item Self-tying of Arrays and Hashes Is Forbidden
+
+=item Building Extensions Can Fail Because Of Largefiles
+
+=item Unicode Support on EBCDIC Still Spotty
+
+=item The Compiler Suite Is Still Experimental
+
+=item The Long Double Support Is Still Experimental
+
+=item Seen In Perl 5.7 But Gone Now
+
+=back
+
+=item Reporting Bugs
+
+=item SEE ALSO
+
+=item HISTORY
+
+=back
+
+=head2 perl572delta - what's new for perl v5.7.2
+
+=over 4
+
+=item DESCRIPTION
+
+=item Security Vulnerability Closed
+
+=item Incompatible Changes
+
+=over 4
+
+=item 64-bit platforms and malloc
+
+=item AIX Dynaloading
+
+=item Socket Extension Dynamic in VMS
+
+=item Different Definition of the Unicode Character Classes \p{In...}
+
+=item Deprecations
+
+=back
+
+=item Core Enhancements
+
+=item Modules and Pragmata
+
+=over 4
+
+=item New Modules and Distributions
+
+=item Updated And Improved Modules and Pragmata
+
+=back
+
+=item Utility Changes
+
+=item New Documentation
+
+=item Installation and Configuration Improvements
+
+=over 4
+
+=item New Or Improved Platforms
+
+=item Generic Improvements
+
+=back
+
+=item Selected Bug Fixes
+
+=over 4
+
+=item Platform Specific Changes and Fixes
+
+=back
+
+=item New or Changed Diagnostics
+
+=item Source Code Enhancements
+
+=over 4
+
+=item MAGIC constants
+
+=item Better commented code
+
+=item Regex pre-/post-compilation items matched up
+
+=item gcc -Wall
+
+=back
+
+=item New Tests
+
+=item Known Problems
+
+=over 4
+
+=item AIX
+
+=item Amiga Perl Invoking Mystery
+
+=item lib/ftmp-security tests warn 'system possibly insecure'
+
+=item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
+
+=item HP-UX lib/io_multihomed Fails When LP64-Configured
+
+=item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
+
+=item Linux With Sfio Fails op/misc Test 48
+
+=item OS/390
+
+=item op/sprintf tests 129 and 130
=item Failure of Thread tests
=back
-=head2 perl56delta, perldelta - what's new for perl v5.6.0
+=head2 perl561delta - what's new for perl v5.6.x
=over 4
=item DESCRIPTION
+=item Summary of changes between 5.6.0 and 5.6.1
+
+=over 4
+
+=item Security Issues
+
+=item Core bug fixes
+
+C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
+Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
+references to special variables, Lexical warnings, Spurious warnings and
+errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
+map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
+Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
+Module;>, Tests
+
+=item Core features
+
+=item Configuration issues
+
+=item Documentation
+
+=item Bundled modules
+
+B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
+Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
+IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
+Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
+
+=item Platform-specific improvements
+
+NCR MP-RAS, NonStop-UX
+
+=back
+
=item Core Enhancements
=over 4
=item Enhanced Installation Directories
+=item gcc automatically tried if 'cc' does not seem to be working
+
=back
=item Platform specific changes
=over 4
-=item Thread test failures
-
-=item EBCDIC platforms not supported
+=item Localizing a tied hash element may leak memory
-=item In 64-bit HP-UX the lib/io_multihomed test may hang
+=item Known test failures
-=item NEXTSTEP 3.3 POSIX test failure
+, ,
-=item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
-gcc
+=item EBCDIC platforms not fully supported
=item UNICOS/mk CC failures during Configure run
=back
-=head2 perl5005delta, perldelta - what's new for perl5.005
+=head2 perl56delta - what's new for perl v5.6.0
=over 4
=item DESCRIPTION
-=item About the new versioning system
-
-=item Incompatible Changes
+=item Core Enhancements
=over 4
-=item WARNING: This version is not binary compatible with Perl 5.004.
+=item Interpreter cloning, threads, and concurrency
-=item Default installation structure has changed
+=item Lexically scoped warning categories
-=item Perl Source Compatibility
+=item Unicode and UTF-8 support
-=item C Source Compatibility
+=item Support for interpolating named characters
-=item Binary Compatibility
+=item "our" declarations
-=item Security fixes may affect compatibility
+=item Support for strings represented as a vector of ordinals
-=item Relaxed new mandatory warnings introduced in 5.004
+=item Improved Perl version numbering system
-=item Licensing
+=item New syntax for declaring subroutine attributes
-=back
+=item File and directory handles can be autovivified
-=item Core Changes
+=item open() with more than two arguments
-=over 4
+=item 64-bit support
-=item Threads
+=item Large file support
-=item Compiler
+=item Long doubles
-=item Regular Expressions
+=item "more bits"
-Many new and improved optimizations, Many bug fixes, New regular expression
-constructs, New operator for precompiled regular expressions, Other
-improvements, Incompatible changes
+=item Enhanced support for sort() subroutines
-=item Improved malloc()
+=item C<sort $coderef @foo> allowed
-=item Quicksort is internally implemented
+=item File globbing implemented internally
-=item Reliable signals
+=item Support for CHECK blocks
-=item Reliable stack pointers
+=item POSIX character class syntax [: :] supported
-=item More generous treatment of carriage returns
+=item Better pseudo-random number generator
-=item Memory leaks
+=item Improved C<qw//> operator
-=item Better support for multiple interpreters
+=item Better worst-case behavior of hashes
-=item Behavior of local() on array and hash elements is now well-defined
+=item pack() format 'Z' supported
-=item C<%!> is transparently tied to the L<Errno> module
+=item pack() format modifier '!' supported
-=item Pseudo-hashes are supported
+=item pack() and unpack() support counted strings
-=item C<EXPR foreach EXPR> is supported
+=item Comments in pack() templates
-=item Keywords can be globally overridden
+=item Weak references
-=item C<$^E> is meaningful on Win32
+=item Binary numbers supported
-=item C<foreach (1..1000000)> optimized
+=item Lvalue subroutines
-=item C<Foo::> can be used as implicitly quoted package name
+=item Some arrows may be omitted in calls through references
-=item C<exists $Foo::{Bar::}> tests existence of a package
+=item Boolean assignment operators are legal lvalues
-=item Better locale support
+=item exists() is supported on subroutine names
-=item Experimental support for 64-bit platforms
+=item exists() and delete() are supported on array elements
-=item prototype() returns useful results on builtins
+=item Pseudo-hashes work better
-=item Extended support for exception handling
+=item Automatic flushing of output buffers
-=item Re-blessing in DESTROY() supported for chaining DESTROY() methods
+=item Better diagnostics on meaningless filehandle operations
-=item All C<printf> format conversions are handled internally
+=item Where possible, buffered data discarded from duped input filehandle
-=item New C<INIT> keyword
+=item eof() has the same old magic as <>
-=item New C<lock> keyword
+=item binmode() can be used to set :crlf and :raw modes
-=item New C<qr//> operator
+=item C<-T> filetest recognizes UTF-8 encoded files as "text"
-=item C<our> is now a reserved word
+=item system(), backticks and pipe open now reflect exec() failure
-=item Tied arrays are now fully supported
+=item Improved diagnostics
-=item Tied handles support is better
+=item Diagnostics follow STDERR
-=item 4th argument to substr
+=item More consistent close-on-exec behavior
-=item Negative LENGTH argument to splice
+=item syswrite() ease-of-use
-=item Magic lvalues are now more magical
+=item Better syntax checks on parenthesized unary operators
-=item <> now reads in records
+=item Bit operators support full native integer width
+
+=item Improved security features
+
+=item 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
+
+=item Arrays now always interpolate into double-quoted strings
+
+=back
+
+=item Modules and Pragmata
+
+=over 4
+
+=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 4
+
+=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 4
+
+=item Simple sort() using { $a <=> $b } and the like are optimized
+
+=item Optimized assignments to lexical variables
+
+=item Faster subroutine calls
+
+=item delete(), each(), values() and hash iteration are faster
+
+=back
+
+=item Installation and Configuration Improvements
+
+=over 4
+
+=item -Dusethreads means something different
+
+=item New Configure flags
+
+=item Threadedness and 64-bitness now more daring
+
+=item Long Doubles
+
+=item -Dusemorebits
+
+=item -Duselargefiles
+
+=item installusrbinperl
+
+=item SOCKS support
+
+=item C<-A> flag
+
+=item Enhanced Installation Directories
+
+=back
+
+=item Platform specific changes
+
+=over 4
+
+=item Supported platforms
+
+=item DOS
+
+=item OS390 (OpenEdition MVS)
+
+=item VMS
+
+=item Win32
+
+=back
+
+=item Significant bug fixes
+
+=over 4
+
+=item <HANDLE> on empty files
+
+=item C<eval '...'> improvements
+
+=item All compilation errors are true errors
+
+=item Implicitly closed filehandles are safer
+
+=item Behavior of list slices is more consistent
+
+=item C<(\$)> prototype and C<$foo{a}>
+
+=item C<goto &sub> and AUTOLOAD
+
+=item C<-bareword> allowed under C<use integer>
+
+=item Failures in DESTROY()
+
+=item Locale bugs fixed
+
+=item Memory leaks
+
+=item Spurious subroutine stubs after failed subroutine calls
+
+=item Taint failures under C<-U>
+
+=item END blocks and the C<-c> switch
+
+=item Potential to leak DATA filehandles
+
+=back
+
+=item New or Changed Diagnostics
+
+"%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 unintended interpolation of %s in string,
+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
+
+=item New tests
+
+=item Incompatible Changes
+
+=over 4
+
+=item Perl Source Incompatibilities
+
+CHECK is a new keyword, Treatment of list slices of undef has changed,
+Format of $English::PERL_VERSION is different, 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(), each(),
+values() and C<\(%h)>, 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, Semantics of bit operators may have changed
+on 64-bit platforms, More builtins taint their results
+
+=item C Source Incompatibilities
+
+C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
+
+=item Compatible C Source API Changes
+
+C<PATCHLEVEL> is now C<PERL_VERSION>
+
+=item Binary Incompatibilities
+
+=back
+
+=item Known Problems
+
+=over 4
+
+=item Thread test failures
+
+=item EBCDIC platforms not supported
+
+=item In 64-bit HP-UX the lib/io_multihomed test may hang
+
+=item NEXTSTEP 3.3 POSIX test failure
+
+=item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
+gcc
+
+=item UNICOS/mk CC failures during Configure run
+
+=item Arrow operator and arrays
+
+=item Experimental features
+
+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 code constructs:
+
+=back
+
+=item Obsolete Diagnostics
+
+Character class syntax [: :] is reserved for future extensions, Ill-formed
+logical name |%s| in prime_env_iter, In string, @%s now must be written as
+\@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
+to mean "${$}<digit>" is deprecated
+
+=item Reporting Bugs
+
+=item SEE ALSO
+
+=item HISTORY
+
+=back
+
+=head2 perl5005delta - what's new for perl5.005
+
+=over 4
+
+=item DESCRIPTION
+
+=item About the new versioning system
+
+=item Incompatible Changes
+
+=over 4
+
+=item WARNING: This version is not binary compatible with Perl 5.004.
+
+=item Default installation structure has changed
+
+=item Perl Source Compatibility
+
+=item C Source Compatibility
+
+=item Binary Compatibility
+
+=item Security fixes may affect compatibility
+
+=item Relaxed new mandatory warnings introduced in 5.004
+
+=item Licensing
+
+=back
+
+=item Core Changes
+
+=over 4
+
+=item Threads
+
+=item Compiler
+
+=item Regular Expressions
+
+Many new and improved optimizations, Many bug fixes, New regular expression
+constructs, New operator for precompiled regular expressions, Other
+improvements, Incompatible changes
+
+=item Improved malloc()
+
+=item Quicksort is internally implemented
+
+=item Reliable signals
+
+=item Reliable stack pointers
+
+=item More generous treatment of carriage returns
+
+=item Memory leaks
+
+=item Better support for multiple interpreters
+
+=item Behavior of local() on array and hash elements is now well-defined
+
+=item C<%!> is transparently tied to the L<Errno> module
+
+=item Pseudo-hashes are supported
+
+=item C<EXPR foreach EXPR> is supported
+
+=item Keywords can be globally overridden
+
+=item C<$^E> is meaningful on Win32
+
+=item C<foreach (1..1000000)> optimized
+
+=item C<Foo::> can be used as implicitly quoted package name
+
+=item C<exists $Foo::{Bar::}> tests existence of a package
+
+=item Better locale support
+
+=item Experimental support for 64-bit platforms
+
+=item prototype() returns useful results on builtins
+
+=item Extended support for exception handling
+
+=item Re-blessing in DESTROY() supported for chaining DESTROY() methods
+
+=item All C<printf> format conversions are handled internally
+
+=item New C<INIT> keyword
+
+=item New C<lock> keyword
+
+=item New C<qr//> operator
+
+=item C<our> is now a reserved word
+
+=item Tied arrays are now fully supported
+
+=item Tied handles support is better
+
+=item 4th argument to substr
+
+=item Negative LENGTH argument to splice
+
+=item Magic lvalues are now more magical
+
+=item <> now reads in records
+
+=back
+
+=item Supported Platforms
+
+=over 4
+
+=item New Platforms
+
+=item Changes in existing support
+
+=back
+
+=item Modules and Pragmata
+
+=over 4
+
+=item New Modules
+
+B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
+ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
+Thread, attrs, fields, re
+
+=item Changes in existing modules
+
+Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
+MakeMaker, CPAN, Cwd
+
+=back
+
+=item Utility Changes
+
+=item Documentation Changes
+
+=item New Diagnostics
+
+Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
+while coercing array into hash, Bareword "%s" refers to nonexistent
+package, Can't call method "%s" on an undefined value, Can't check
+filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
+goto subroutine from an eval-string, Can't localize pseudo-hash element,
+Can't use %%! because Errno.pm is not available, Cannot find an opnumber
+for "%s", Character class syntax [. .] is reserved for future extensions,
+Character class syntax [: :] is reserved for future extensions, Character
+class syntax [= =] is reserved for future extensions, %s: Eval-group in
+insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
+Eval-group not allowed at run time, Explicit blessing to '' (assuming
+package main), Illegal hex digit ignored, No such array field, No such
+field "%s" in variable %s of type %s, Out of memory during ridiculously
+large request, Range iterator outside integer range, Recursive inheritance
+detected while looking for method '%s' %s, Reference found where even-sized
+list expected, Undefined value assigned to typeglob, Use of reserved word
+"%s" is deprecated, perl: warning: Setting locale failed
+
+=item Obsolete Diagnostics
+
+Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
+temporary file, regexp too big
+
+=item Configuration Changes
+
+=item BUGS
+
+=item SEE ALSO
+
+=item HISTORY
+
+=back
+
+=head2 perl5004delta - what's new for perl5.004
+
+=over 4
+
+=item DESCRIPTION
+
+=item Supported Environments
+
+=item Core Changes
+
+=over 4
+
+=item List assignment to %ENV works
+
+=item Change to "Can't locate Foo.pm in @INC" error
+
+=item Compilation option: Binary compatibility with 5.003
+
+=item $PERL5OPT environment variable
+
+=item Limitations on B<-M>, B<-m>, and B<-T> options
+
+=item More precise warnings
+
+=item Deprecated: Inherited C<AUTOLOAD> for non-methods
+
+=item Previously deprecated %OVERLOAD is no longer usable
+
+=item Subroutine arguments created only when they're modified
+
+=item Group vector changeable with C<$)>
+
+=item Fixed parsing of $$<digit>, &$<digit>, etc.
+
+=item Fixed localization of $<digit>, $&, etc.
+
+=item No resetting of $. on implicit close
+
+=item C<wantarray> may return undef
+
+=item C<eval EXPR> determines value of EXPR in scalar context
+
+=item Changes to tainting checks
+
+No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
+spawning if tainted $TERM doesn't look like a terminal name
+
+=item New Opcode module and revised Safe module
+
+=item Embedding improvements
+
+=item Internal change: FileHandle class based on IO::* classes
+
+=item Internal change: PerlIO abstraction interface
+
+=item New and changed syntax
+
+$coderef->(PARAMS)
+
+=item New and changed builtin constants
+
+__PACKAGE__
+
+=item New and changed builtin variables
+
+$^E, $^H, $^M
+
+=item New and changed builtin functions
+
+delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
+Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
+VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
+reset search position on failure, C<m//x> ignores whitespace before ?*+{},
+nested C<sub{}> closures work now, formats work right on changing lexicals
+
+=item New builtin methods
+
+isa(CLASS), can(METHOD), VERSION( [NEED] )
+
+=item TIEHANDLE now supported
+
+TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
+LIST, READLINE this, GETC this, DESTROY this
+
+=item Malloc enhancements
+
+-DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
+
+=item Miscellaneous efficiency enhancements
+
+=back
+
+=item Support for More Operating Systems
+
+=over 4
+
+=item Win32
+
+=item Plan 9
+
+=item QNX
+
+=item AmigaOS
+
+=back
+
+=item Pragmata
+
+use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
+constant NAME => VALUE, use locale, use ops, use vmsish
+
+=item Modules
+
+=over 4
+
+=item Required Updates
+
+=item Installation directories
+
+=item Module information summary
+
+=item Fcntl
+
+=item IO
+
+=item Math::Complex
+
+=item Math::Trig
+
+=item DB_File
+
+=item Net::Ping
+
+=item Object-oriented overrides for builtin operators
+
+=back
+
+=item Utility Changes
+
+=over 4
+
+=item pod2html
+
+Sends converted HTML to standard output
+
+=item xsubpp
+
+C<void> XSUBs now default to returning nothing
+
+=back
+
+=item C Language API Changes
+
+C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
+manipulating hashes
+
+=item Documentation Changes
+
+L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
+L<perlmodlib>, L<perldebug>, L<perlsec>
+
+=item New Diagnostics
+
+"my" variable %s masks earlier declaration in same scope, %s argument is
+not a HASH element or slice, Allocation too large: %lx, Allocation too
+large, Applying %s to %s will act on scalar(%s), Attempt to free
+nonexistent shared string, Attempt to use reference as lvalue in substr,
+Bareword "%s" refers to nonexistent package, Can't redefine active sort
+subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
+use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
+subroutine %s redefined, Constant subroutine %s undefined, Copy method did
+not return a reference, Died, Exiting pseudo-block via %s, Identifier too
+long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
+%s, Integer overflow in hex number, Integer overflow in octal number,
+internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
+in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
+possible typo, Null picture in formline, Offset outside string, Out of
+memory!, Out of memory during request for %s, panic: frexp, Possible
+attempt to put comments in qw() list, Possible attempt to separate words
+with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
+while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
+option, untie attempted while %d inner references still exist, Unrecognized
+character %s, Unsupported function fork, Use of "$$<digit>" to mean
+"${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
+Variable "%s" may be unavailable, Variable "%s" will not stay shared,
+Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
+Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
+long, Process terminated by SIG%s
+
+=item BUGS
+
+=item SEE ALSO
+
+=item HISTORY
+
+=back
+
+=head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item Compiling Perl 5 on AIX
+
+=item OS level
+
+=item Building Dynamic Extensions on AIX
+
+=item The IBM ANSI C Compiler
+
+=item Using GNU's gcc for building perl
+
+=item Using Large Files with Perl
+
+=item Threaded Perl
+
+=item 64-bit Perl
+
+=item AIX 4.2 and extensions using C++ with statics
+
+=back
+
+=item AUTHOR
+
+=item DATE
+
+=back
+
+=head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
+
+=over 4
+
+=item DESCRIPTION
+
+=item AUTHOR
+
+=back
+
+=head2 perlamiga - Perl under Amiga OS
+
+=over 4
+
+=item SYNOPSIS
+
+=back
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item Prerequisites for Compiling Perl on AmigaOS
+
+B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
+
+=item Starting Perl programs under AmigaOS
+
+=item Shortcomings of Perl under AmigaOS
+
+=back
+
+=item INSTALLATION
+
+=item Accessing documentation
+
+=over 4
+
+=item Manpages for Perl on AmigaOS
+
+=item Perl HTML Documentation on AmigaOS
+
+=item Perl GNU Info Files on AmigaOS
+
+=item Perl LaTeX Documentation on AmigaOS
+
+=back
+
+=item BUILDING PERL ON AMIGAOS
+
+=over 4
+
+=item Build Prerequisites for Perl on AmigaOS
+
+=item Getting the Perl Source for AmigaOS
+
+=item Making Perl on AmigaOS
+
+=item Testing Perl on AmigaOS
+
+=item Installing the built Perl on AmigaOS
+
+=back
+
+=item AUTHORS
+
+=item SEE ALSO
+
+=back
+
+=head2 perlbeos, README.beos - Perl version 5 on BeOS
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item General Issues with Perl on BeOS
+
+=item BeOS Release-specific Notes
+
+R4 x86, R4 PPC
+
+=item Contact Information
+
+=item Update 2002-03-02
+
+=back
+
+=back
+
+=head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item gzip on BS2000
+
+=item bison on BS2000
+
+=item Unpacking Perl Distribution on BS2000
+
+=item Compiling Perl on BS2000
+
+=item Testing Perl on BS2000
+
+=item Installing Perl on BS2000
+
+=item Using Perl in the Posix-Shell of BS2000
+
+=item Using Perl in "native" BS2000
+
+=item Floating point anomalies on BS2000
+
+=back
+
+=item AUTHORS
+
+=item SEE ALSO
+
+=over 4
+
+=item Mailing list
+
+=back
+
+=item HISTORY
+
+=back
+
+=over 4
+
+=item Name
+
+=item Description
+
+=item Build
+
+=over 4
+
+=item Tools & SDK
+
+=item Make
+
+=back
+
+=item Acknowledgements
+
+=item Author
+
+=back
+
+=head2 perlcygwin, README.cygwin - Perl for Cygwin
+
+=over 4
+
+=item SYNOPSIS
+
+=item PREREQUISITES FOR COMPILING PERL ON CYGWIN
+
+=over 4
+
+=item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
+
+=item Cygwin Configuration
+
+C<PATH>, I<nroff>, Permissions
+
+=back
+
+=item CONFIGURE PERL ON CYGWIN
+
+=over 4
+
+=item Stripping Perl Binaries on Cygwin
+
+=item Optional Libraries for Perl on Cygwin
+
+C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
+C<-lcygipc> (C<use IPC::SysV>)
+
+=item Configure-time Options for Perl on Cygwin
+
+C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
+C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
+C<-Dmksymlinks>
+
+=item Suspicious Warnings on Cygwin
+
+I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
+
+=back
+
+=item MAKE ON CYGWIN
+
+=over 4
+
+=item Warnings on Cygwin
+
+=item ld2 on Cygwin
+
+=back
+
+=item TEST ON CYGWIN
+
+=over 4
+
+=item File Permissions on Cygwin
+
+=item Script Portability on Cygwin
+
+Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous
+
+=back
+
+=item INSTALL PERL ON CYGWIN
+
+=item MANIFEST ON CYGWIN
+
+Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
+Source, Compiled Module Source, Perl Modules/Scripts
+
+=item BUGS ON CYGWIN
+
+=item AUTHORS
+
+=item HISTORY
=back
-=item Supported Platforms
+=head2 perldgux - Perl under DG/UX.
=over 4
-=item New Platforms
-
-=item Changes in existing support
+=item SYNOPSIS
=back
-=item Modules and Pragmata
+=over 4
+
+=item DESCRIPTION
+
+=item BUILDING PERL ON DG/UX
=over 4
-=item New Modules
+=item Non-threaded Perl on DG/UX
-B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
-ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
-Thread, attrs, fields, re
+=item Threaded Perl on DG/UX
-=item Changes in existing modules
+=item Testing Perl on DG/UX
-Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
-MakeMaker, CPAN, Cwd
+=item Installing the built perl on DG/UX
=back
-=item Utility Changes
+=item AUTHOR
-=item Documentation Changes
+=item SEE ALSO
-=item New Diagnostics
+=back
-Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
-while coercing array into hash, Bareword "%s" refers to nonexistent
-package, Can't call method "%s" on an undefined value, Can't check
-filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
-goto subroutine from an eval-string, Can't localize pseudo-hash element,
-Can't use %%! because Errno.pm is not available, Cannot find an opnumber
-for "%s", Character class syntax [. .] is reserved for future extensions,
-Character class syntax [: :] is reserved for future extensions, Character
-class syntax [= =] is reserved for future extensions, %s: Eval-group in
-insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
-Eval-group not allowed at run time, Explicit blessing to '' (assuming
-package main), Illegal hex digit ignored, No such array field, No such
-field "%s" in variable %s of type %s, Out of memory during ridiculously
-large request, Range iterator outside integer range, Recursive inheritance
-detected while looking for method '%s' %s, Reference found where even-sized
-list expected, Undefined value assigned to typeglob, Use of reserved word
-"%s" is deprecated, perl: warning: Setting locale failed
+=head2 perldos - Perl under DOS, W31, W95.
-=item Obsolete Diagnostics
+=over 4
-Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
-temporary file, regexp too big
+=item SYNOPSIS
-=item Configuration Changes
+=item DESCRIPTION
-=item BUGS
+=over 4
-=item SEE ALSO
+=item Prerequisites for Compiling Perl on DOS
-=item HISTORY
+DJGPP, Pthreads
-=back
+=item Shortcomings of Perl under DOS
-=head2 perl5004delta, perldelta - what's new for perl5.004
+=item Building Perl on DOS
-=over 4
+=item Testing Perl on DOS
-=item DESCRIPTION
+=item Installation of Perl on DOS
-=item Supported Environments
+=back
-=item Core Changes
+=item BUILDING AND INSTALLING MODULES ON DOS
=over 4
-=item List assignment to %ENV works
+=item Building Prerequisites for Perl on DOS
-=item Change to "Can't locate Foo.pm in @INC" error
+=item Unpacking CPAN Modules on DOS
-=item Compilation option: Binary compatibility with 5.003
+=item Building Non-XS Modules on DOS
-=item $PERL5OPT environment variable
+=item Building XS Modules on DOS
-=item Limitations on B<-M>, B<-m>, and B<-T> options
+=back
-=item More precise warnings
+=item AUTHOR
-=item Deprecated: Inherited C<AUTOLOAD> for non-methods
+=item SEE ALSO
-=item Previously deprecated %OVERLOAD is no longer usable
+=back
-=item Subroutine arguments created only when they're modified
+=head2 perlepoc, README.epoc - Perl for EPOC
-=item Group vector changeable with C<$)>
+=over 4
-=item Fixed parsing of $$<digit>, &$<digit>, etc.
+=item SYNOPSIS
-=item Fixed localization of $<digit>, $&, etc.
+=item INTRODUCTION
-=item No resetting of $. on implicit close
+=item INSTALLING PERL ON EPOC
-=item C<wantarray> may return undef
+=item STARTING PERL ON EPOC
-=item C<eval EXPR> determines value of EXPR in scalar context
+=over 4
-=item Changes to tainting checks
+=item Editors on Epoc
-No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
-spawning if tainted $TERM doesn't look like a terminal name
+=item Features of Perl on Epoc
-=item New Opcode module and revised Safe module
+=item Restrictions of Perl on Epoc
-=item Embedding improvements
+=item Compiling Perl 5 on the EPOC cross compiling environment
-=item Internal change: FileHandle class based on IO::* classes
+=back
-=item Internal change: PerlIO abstraction interface
+=item SUPPORT STATUS OF PERL ON EPOC
-=item New and changed syntax
+=item AUTHOR
-$coderef->(PARAMS)
+=item LAST UPDATE
-=item New and changed builtin constants
+=back
-__PACKAGE__
+=head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
+(HP-UX) systems
-=item New and changed builtin variables
+=over 4
-$^E, $^H, $^M
+=item DESCRIPTION
-=item New and changed builtin functions
+=over 4
-delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
-Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
-VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
-reset search position on failure, C<m//x> ignores whitespace before ?*+{},
-nested C<sub{}> closures work now, formats work right on changing lexicals
+=item Using perl as shipped with HP-UX
-=item New builtin methods
+=item Compiling Perl 5 on HP-UX
-isa(CLASS), can(METHOD), VERSION( [NEED] )
+=item PA-RISC
-=item TIEHANDLE now supported
+=item PA-RISC 1.0
-TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
-LIST, READLINE this, GETC this, DESTROY this
+=item PA-RISC 1.1
-=item Malloc enhancements
+=item PA-RISC 2.0
--DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
+=item Itanium
-=item Miscellaneous efficiency enhancements
+=item Portability Between PA-RISC Versions
-=back
+=item Itanium Processor Family and HP-UX
-=item Support for More Operating Systems
+=item Building Dynamic Extensions on HP-UX
-=over 4
+=item The HP ANSI C Compiler
-=item Win32
+=item Using Large Files with Perl on HP-UX
-=item Plan 9
+=item Threaded Perl on HP-UX
-=item QNX
+=item 64-bit Perl on HP-UX
-=item AmigaOS
+=item GDBM and Threads on HP-UX
-=back
+=item NFS filesystems and utime(2) on HP-UX
-=item Pragmata
+=item perl -P and // and HP-UX
-use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
-constant NAME => VALUE, use locale, use ops, use vmsish
+=item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
-=item Modules
+=back
-=over 4
+=item nss_delete core dump from op/pwent or op/grent
-=item Required Updates
+=item AUTHOR
-=item Installation directories
+=item DATE
-=item Module information summary
+=back
-=item Fcntl
+=head2 perlhurd, README.hurd - Perl version 5 on Hurd
-=item IO
+=over 4
-=item Math::Complex
+=item DESCRIPTION
-=item Math::Trig
+=over 4
-=item DB_File
+=item Known Problems with Perl on Hurd
-=item Net::Ping
+=back
-=item Object-oriented overrides for builtin operators
+=item AUTHOR
=back
-=item Utility Changes
+=head2 perlmachten, README.machten - Perl version 5 on Power MachTen
+systems
=over 4
-=item pod2html
+=item DESCRIPTION
-Sends converted HTML to standard output
+=over 4
-=item xsubpp
+=item Compiling Perl 5 on MachTen
-C<void> XSUBs now default to returning nothing
+=item Failures during C<make test> on MachTen
+
+op/lexassign.t, pragma/warnings.t
+
+=item Building external modules on MachTen
=back
-=item C Language API Changes
+=item AUTHOR
-C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
-manipulating hashes
+=item DATE
-=item Documentation Changes
+=back
-L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
-L<perlmodlib>, L<perldebug>, L<perlsec>
+=head2 perlmacos, README.macos - Perl under Mac OS (Classic)
-=item New Diagnostics
+=over 4
-"my" variable %s masks earlier declaration in same scope, %s argument is
-not a HASH element or slice, Allocation too large: %lx, Allocation too
-large, Applying %s to %s will act on scalar(%s), Attempt to free
-nonexistent shared string, Attempt to use reference as lvalue in substr,
-Bareword "%s" refers to nonexistent package, Can't redefine active sort
-subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
-use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
-subroutine %s redefined, Constant subroutine %s undefined, Copy method did
-not return a reference, Died, Exiting pseudo-block via %s, Identifier too
-long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
-%s, Integer overflow in hex number, Integer overflow in octal number,
-internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
-in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
-possible typo, Null picture in formline, Offset outside string, Out of
-memory!, Out of memory during request for %s, panic: frexp, Possible
-attempt to put comments in qw() list, Possible attempt to separate words
-with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
-while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
-option, untie attempted while %d inner references still exist, Unrecognized
-character %s, Unsupported function fork, Use of "$$<digit>" to mean
-"${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
-Variable "%s" may be unavailable, Variable "%s" will not stay shared,
-Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
-Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
-long, Process terminated by SIG%s
+=item SYNOPSIS
-=item BUGS
+=item DESCRIPTION
+
+=item AUTHOR
+
+=item DATE
+
+=back
+
+=head2 perlmint, README.mint - Perl version 5 on Atari MiNT
+
+=over 4
+
+=item DESCRIPTION
-=item SEE ALSO
+=item Known problems with Perl on MiNT
-=item HISTORY
+=item AUTHOR
=back
-=head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
+=head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
=over 4
-=item DESCRIPTION
+=item SYNOPSIS
-=over 4
+=item NOTE
-=item Compiling Perl 5 on AIX
+=item Binary distribution from HP
-=item OS level
+=item What's New in Perl for MPE/iX
-=item Building Dynamic Extensions on AIX
+=item Welcome to Perl/iX
-=item The IBM ANSI C Compiler
+=item System Requirements for Perl/iX
-=item Using GNU's gcc for building perl
+=item How to Obtain Perl/iX
-=item Using Large Files with Perl
+=item Perl/iX Distribution Contents Highlights
-=item Threaded Perl
+README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
+public_html/feedback.cgi, src/perl-5.6.0-mpe
-=item 64-bit Perl
+=item How to Compile Perl/iX
-=item AIX 4.2 and extensions using C++ with statics
+ 4, 6
-=back
+=item Getting Started with Perl/iX
+
+=item MPE/iX Implementation Considerations
+
+=item Known Perl/iX Bugs Under Investigation
+
+=item Perl/iX To-Do List
+
+=item Perl/iX Change History
=item AUTHOR
-=item DATE
+=item Name
-=back
+=item Description
-=head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
+=item Build
=over 4
-=item DESCRIPTION
+=item Tools & SDK
-=item AUTHOR
+=item Setup
+
+Buildtype.bat, SetNWBld.bat, MPKBuild.bat
+
+=item Make
+
+=item Interpreter
+
+=item Extensions
=back
-=head2 perlamiga - Perl under Amiga OS
+=item Install
+
+=item Build new extensions
+
+=item Known Issues
+
+=item Acknowledgements
+
+=item Authors
+
+=item Date
+
+=back
+
+=head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
=over 4
=over 4
-=item Prerequisites for Compiling Perl on AmigaOS
+=item Target
-B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
+=item Other OSes
-=item Starting Perl programs under AmigaOS
+=item Prerequisites
-=item Shortcomings of Perl under AmigaOS
+EMX, RSX, HPFS, pdksh
-=back
+=item Starting Perl programs under OS/2 (and DOS and...)
-=item INSTALLATION
+=item Starting OS/2 (and DOS) programs under Perl
-=item Accessing documentation
+=back
+
+=item Frequently asked questions
=over 4
-=item Manpages for Perl on AmigaOS
+=item "It does not work"
-=item Perl HTML Documentation on AmigaOS
+=item I cannot run external programs
-=item Perl GNU Info Files on AmigaOS
+=item I cannot embed perl into my program, or use F<perl.dll> from my
+program.
-=item Perl LaTeX Documentation on AmigaOS
+Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
+L<ExtUtils::Embed>?
+
+=item C<``> and pipe-C<open> do not work under DOS.
+
+=item Cannot start C<find.exe "pattern" file>
=back
-=item BUILDING PERL ON AMIGAOS
+=item INSTALLATION
=over 4
-=item Build Prerequisites for Perl on AmigaOS
+=item Automatic binary installation
-=item Getting the Perl Source for AmigaOS
+C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
-=item Making Perl on AmigaOS
+=item Manual binary installation
-=item Testing Perl on AmigaOS
+Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
+(statically linked), Executables for Perl utilities, Main Perl library,
+Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
+and utilities, Manpages for Perl modules, Source for Perl documentation,
+Perl manual in F<.INF> format, Pdksh
-=item Installing the built Perl on AmigaOS
+=item B<Warning>
=back
-=item AUTHORS
+=item Accessing documentation
-=item SEE ALSO
+=over 4
+
+=item OS/2 F<.INF> file
+
+=item Plain text
+
+=item Manpages
+
+=item HTML
+
+=item GNU C<info> files
+
+=item F<PDF> files
+
+=item C<LaTeX> docs
=back
-=head2 perlbeos, README.beos - Perl version 5 on BeOS
+=item BUILD
=over 4
-=item DESCRIPTION
+=item The short story
-=over 4
+=item Prerequisites
-=item General Issues with Perl on BeOS
+=item Getting perl source
-=item BeOS Release-specific Notes
+=item Application of the patches
-R4 x86, R4 PPC
+=item Hand-editing
-=item Contact Information
+=item Making
-=back
+=item Testing
+
+A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
+F<op/stat.t>
+
+=item Installing the built perl
+
+=item C<a.out>-style build
=back
-=head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
+=item Build FAQ
=over 4
-=item SYNOPSIS
+=item Some C</> became C<\> in pdksh.
-=item DESCRIPTION
+=item C<'errno'> - unresolved external
-=over 4
+=item Problems with tr or sed
-=item gzip on BS2000
+=item Some problem (forget which ;-)
-=item bison on BS2000
+=item Library ... not found
-=item Unpacking Perl Distribution on BS2000
+=item Segfault in make
-=item Compiling Perl on BS2000
+=item op/sprintf test failure
-=item Testing Perl on BS2000
+=back
-=item Installing Perl on BS2000
+=item Specific (mis)features of OS/2 port
-=item Using Perl in the Posix-Shell of BS2000
+=over 4
-=item Using Perl in "native" BS2000
+=item C<setpriority>, C<getpriority>
-=item Floating point anomalies on BS2000
+=item C<system()>
-=back
+=item C<extproc> on the first line
-=item AUTHORS
+=item Additional modules:
-=item SEE ALSO
+=item Prebuilt methods:
-=over 4
+C<File::Copy::syscopy>, C<DynaLoader::mod2fname>, C<Cwd::current_drive()>,
+ C<Cwd::sys_chdir(name)>, C<Cwd::change_drive(name)>,
+C<Cwd::sys_is_absolute(name)>, C<Cwd::sys_is_rooted(name)>,
+C<Cwd::sys_is_relative(name)>, C<Cwd::sys_cwd(name)>,
+C<Cwd::sys_abspath(name, dir)>, C<Cwd::extLibpath([type])>,
+C<Cwd::extLibpath_set( path [, type ] )>,
+C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
+OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
+C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
+C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
+OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>
-=item Mailing list
+=item Prebuilt variables:
-=back
+$OS2::emx_rev, $OS2::emx_env, $OS2::os_ver
-=item HISTORY
+=item Misfeatures
-=back
+=item Modifications
-=over 4
+C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
+C<flock>
-=item Name
+=item Identifying DLLs
-=item Description
+=item Centralized management of resources
-=item Build
+C<HAB>, C<HMQ>
+
+=back
+
+=item Perl flavors
=over 4
-=item Tools & SDK
+=item F<perl.exe>
-=item Make
+=item F<perl_.exe>
-=back
+=item F<perl__.exe>
-=item Acknowledgements
+=item F<perl___.exe>
-=item Author
+=item Why strange names?
+
+=item Why dynamic linking?
+
+=item Why chimera build?
=back
-=head2 perlcygwin, README.cygwin - Perl for Cygwin
+=item ENVIRONMENT
=over 4
-=item SYNOPSIS
+=item C<PERLLIB_PREFIX>
-=item PREREQUISITES FOR COMPILING PERL ON CYGWIN
+=item C<PERL_BADLANG>
-=over 4
+=item C<PERL_BADFREE>
-=item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
+=item C<PERL_SH_DIR>
-=item Cygwin Configuration
+=item C<USE_PERL_FLOCK>
-C<PATH>, I<nroff>, Permissions
+=item C<TMP> or C<TEMP>
=back
-=item CONFIGURE PERL ON CYGWIN
+=item Evolution
+
+=over 4
+
+=item Priorities
+
+=item DLL name mangling: pre 5.6.2
-=over 4
+=item DLL name mangling: 5.6.2 and beyond
-=item Stripping Perl Binaries on Cygwin
+Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
+C<LIBPATH>
-=item Optional Libraries for Perl on Cygwin
+=item DLL forwarder generation
-C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
-C<-lcygipc> (C<use IPC::SysV>)
+=item Threading
-=item Configure-time Options for Perl on Cygwin
+=item Calls to external programs
-C<-Uusedl>, C<-Uusemymalloc>, C<-Dusemultiplicity>, C<-Duseperlio>,
-C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>
+=item Memory allocation
-=item Suspicious Warnings on Cygwin
+=item Threads
-I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
+C<COND_WAIT>, F<os2.c>
=back
-=item MAKE ON CYGWIN
+=item BUGS
+
+=back
=over 4
-=item Warnings on Cygwin
+=item AUTHOR
-=item ld2 on Cygwin
+=item SEE ALSO
=back
-=item TEST ON CYGWIN
+=head2 perlos390, README.os390 - building and installing Perl for OS/390
+and z/OS
=over 4
-=item File Permissions on Cygwin
+=item SYNOPSIS
-=item Hard Links on Cygwin
+=item DESCRIPTION
-=item Filetime Granularity on Cygwin
+=over 4
-=item Tainting Checks on Cygwin
+=item Tools
-=item /etc/group on Cygwin
+=item Unpacking Perl distribution on OS/390
-=item Script Portability on Cygwin
+=item Setup and utilities for Perl on OS/390
-Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous
+=item Configure Perl on OS/390
-=back
+=item Build, Test, Install Perl on OS/390
-=item INSTALL PERL ON CYGWIN
+=item Build Anomalies with Perl on OS/390
-=item MANIFEST ON CYGWIN
+=item Testing Anomalies with Perl on OS/390
-Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
-Source, Compiled Module Source, Perl Modules/Scripts
+=item Installation Anomalies with Perl on OS/390
-=item BUGS ON CYGWIN
+=item Usage Hints for Perl on OS/390
-=item AUTHORS
+=item Floating Point Anomalies with Perl on OS/390
-=item HISTORY
+=item Modules and Extensions for Perl on OS/390
=back
-=head2 perldgux - Perl under DG/UX.
+=item AUTHORS
+
+=item SEE ALSO
=over 4
-=item SYNOPSIS
+=item Mailing list for Perl on OS/390
+
+=back
+
+=item HISTORY
=back
+=head2 perlqnx, README.qnx - Perl version 5 on QNX
+
=over 4
=item DESCRIPTION
-=item BUILDING PERL ON DG/UX
-
=over 4
-=item Non-threaded Perl on DG/UX
+=item Required Software for Compiling Perl on QNX4
-=item Threaded Perl on DG/UX
+/bin/sh, ar, nm, cpp, make
-=item Testing Perl on DG/UX
+=item Outstanding Issues with Perl on QNX4
-=item Installing the built perl on DG/UX
+=item QNX auxiliary files
+
+qnx/ar, qnx/cpp
+
+=item Outstanding issues with perl under QNX6
=back
=item AUTHOR
-=item SEE ALSO
-
=back
-=head2 perlepoc, README.epoc - Perl for EPOC
+=head2 perlplan9 - Plan 9-specific documentation for Perl
=over 4
-=item SYNOPSIS
-
-=item INTRODUCTION
-
-=item INSTALLING PERL ON EPOC
+=item DESCRIPTION
-=item STARTING PERL ON EPOC
+=over 4
-=item STOPPING PERL ON EPOC
+=item Invoking Perl
-=item USING PERL ON EPOC
+=item What's in Plan 9 Perl
-=over 4
+=item What's not in Plan 9 Perl
-=item I/O Redirection on Epoc
+=item Perl5 Functions not currently supported in Plan 9 Perl
-=item PATH Names on Epoc
+=item Signals in Plan 9 Perl
-=item Editors on Epoc
+=back
-=item Features of Perl on Epoc
+=item COMPILING AND INSTALLING PERL ON PLAN 9
-=item Restrictions of Perl on Epoc
+=over 4
-=item Compiling Perl 5 on the EPOC cross compiling environment
+=item Installing Perl Documentation on Plan 9
=back
-=item SUPPORT STATUS OF PERL ON EPOC
+=item BUGS
-=item AUTHOR
+=item Revision date
-=item LAST UPDATE
+=item AUTHOR
=back
-=head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
-(HP-UX) systems
+=head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
=over 4
=over 4
-=item Using perl as shipped with HP-UX
+=item Solaris Version Numbers.
-=item Compiling Perl 5 on HP-UX
+=back
-=item PA-RISC
+=item RESOURCES
-=item PA-RISC 1.0
+Solaris FAQ, Precompiled Binaries, Solaris Documentation
-=item PA-RISC 1.1
+=item SETTING UP
-=item PA-RISC 2.0
+=over 4
-=item Itanium
+=item File Extraction Problems on Solaris.
-=item Portability Between PA-RISC Versions
+=item Compiler and Related Tools on Solaris.
-=item Itanium Processor Family and HP-UX
+=item Environment for Compiling Perl on Solaris
-=item Building Dynamic Extensions on HP-UX
+=back
-=item The HP ANSI C Compiler
+=item RUN CONFIGURE.
-=item Using Large Files with Perl on HP-UX
+=over 4
-=item Threaded Perl on HP-UX
+=item 64-bit Issues with Perl on Solaris.
-=item 64-bit Perl on HP-UX
+=item Threads in Perl on Solaris.
-=item GDBM and Threads on HP-UX
+=item Malloc Issues with Perl on Solaris.
-=item NFS filesystems and utime(2) on HP-UX
+=back
-=item perl -P and // and HP-UX
+=item MAKE PROBLEMS.
-=item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
+Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
+relocation error:, dlopen: stub interception failed, #error "No
+DATAMODEL_NATIVE specified", sh: ar: not found
-=back
+=item MAKE TEST
-=item nss_delete core dump from op/pwent or op/grent
+=over 4
-=item AUTHOR
+=item op/stat.t test 4 in Solaris
-=item DATE
+=item nss_delete core dump from op/pwent or op/grent
=back
-=head2 perlhurd, README.hurd - Perl version 5 on Hurd
+=item PREBUILT BINARIES OF PERL FOR SOLARIS.
+
+=item RUNTIME ISSUES FOR PERL ON SOLARIS.
=over 4
-=item DESCRIPTION
+=item Limits on Numbers of Open Files on Solaris.
+
+=back
+
+=item SOLARIS-SPECIFIC MODULES.
+
+=item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
=over 4
-=item Known Problems with Perl on Hurd
+=item Proc::ProcessTable on Solaris
+
+=item BSD::Resource on Solaris
+
+=item Net::SSLeay on Solaris
=back
=item AUTHOR
+=item LAST MODIFIED
+
=back
-=head2 perlmachten, README.machten - Perl version 5 on Power MachTen
-systems
+=head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
+Digital UNIX formerly known as DEC OSF/1) systems
=over 4
=over 4
-=item Compiling Perl 5 on MachTen
+=item Compiling Perl 5 on Tru64
-=item Failures during C<make test> on MachTen
+=item Using Large Files with Perl on Tru64
-op/lexassign.t, pragma/warnings.t
+=item Threaded Perl on Tru64
-=item Building external modules on MachTen
+=item Long Doubles on Tru64
+
+=item 64-bit Perl on Tru64
+
+=item Warnings about floating-point overflow when compiling Perl on Tru64
=back
-=item AUTHOR
+=item Testing Perl on Tru64
-=item DATE
+=item ext/ODBM_File/odbm Test Failing With Static Builds
+
+=item AUTHOR
=back
-=head2 perlmacos, README.macos - Perl under Mac OS (Classic)
+=head2 perluts - Perl under UTS
=over 4
=item DESCRIPTION
-=item AUTHOR
+=item BUILDING PERL ON UTS
-=item DATE
+=item Installing the built perl on UTS
+
+=item AUTHOR
=back
-=head2 perlmint, README.mint - Perl version 5 on Atari MiNT
+=head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
=over 4
+=item SYNOPSIS
+
=item DESCRIPTION
-=item Known problems with Perl on MiNT
+=over 4
-=item AUTHOR
+=item Unpacking Perl Distribution on VM/ESA
+
+=item Setup Perl and utilities on VM/ESA
+
+=item Configure Perl on VM/ESA
+
+=item Testing Anomalies of Perl on VM/ESA
+
+=item Usage Hints for Perl on VM/ESA
=back
-=head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
+=item AUTHORS
+
+=item SEE ALSO
=over 4
-=item SYNOPSIS
+=item Mailing list for Perl on VM/ESA
-=item NOTE
+=back
-=item What's New in Perl ffor MPE/iX
+=back
-=item Welcome to Perl/iX
+=head2 perlvms - VMS-specific documentation for Perl
-=item System Requirements for Perl/iX
+=over 4
-=item How to Obtain Perl/iX
+=item DESCRIPTION
-=item Perl/iX Distribution Contents Highlights
+=item Installation
-README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
-public_html/feedback.cgi, src/perl-5.6.0-mpe
+=item Organization of Perl Images
-=item How to Compile Perl/iX
+=over 4
- 4, 6
+=item Core Images
-=item Getting Started with Perl/iX
+=item Perl Extensions
+
+=item Installing static extensions
+
+=item Installing dynamic extensions
+
+=back
-=item MPE/iX Implementation Considerations
+=item File specifications
-=item Known Perl/iX Bugs Under Investigation
+=over 4
-=item Perl/iX To-Do List
+=item Syntax
-=item Perl/iX Change History
+=item Wildcard expansion
-=item AUTHOR
+=item Pipes
-=item Name
+=back
-=item Description
+=item PERL5LIB and PERLLIB
-=item Build
+=item Command line
=over 4
-=item Tools & SDK
+=item I/O redirection and backgrounding
-=item Setup
+=item Command line switches
-Buildtype.bat, SetNWBld.bat, MPKBuild.bat
+-i, -S, -u
-=item Make
+=back
-=item Interpreter
+=item Perl functions
-=item Extensions
+File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
+exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
+(system call), stat EXPR, system LIST, time, times, unlink LIST, utime
+LIST, waitpid PID,FLAGS
-=back
+=item Perl variables
-=item Install
+%ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
-=item Build new extensions
+=item Standard modules with VMS-specific differences
-=item Known Issues
+=over 4
-=item Acknowledgements
+=item SDBM_File
-=item Authors
+=back
-=item Date
+=item Revision date
+
+=item AUTHOR
=back
-=head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
+=head2 perlvos, README.vos - Perl for Stratus VOS
=over 4
=item SYNOPSIS
-=back
-
=over 4
-=item DESCRIPTION
-
-=over 4
+=item Multiple methods to build perl for VOS
-=item Target
+=item Stratus POSIX Support
-=item Other OSes
+=back
-=item Prerequisites
+=item INSTALLING PERL IN VOS
-EMX, RSX, HPFS, pdksh
+=over 4
-=item Starting Perl programs under OS/2 (and DOS and...)
+=item Compiling Perl 5 on VOS
-=item Starting OS/2 (and DOS) programs under Perl
+=item Installing Perl 5 on VOS
=back
-=item Frequently asked questions
+=item USING PERL IN VOS
=over 4
-=item "It does not work"
+=item Unimplemented Features of Perl on VOS
-=item I cannot run external programs
+=item Restrictions of Perl on VOS
-=item I cannot embed perl into my program, or use F<perl.dll> from my
-program.
+=back
-Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
-L<ExtUtils::Embed>?
+=item SUPPORT STATUS
-=item C<``> and pipe-C<open> do not work under DOS.
+=item AUTHOR
-=item Cannot start C<find.exe "pattern" file>
+=item LAST UPDATE
=back
-=item INSTALLATION
+=head2 perlwin32 - Perl under Win32
=over 4
-=item Automatic binary installation
+=item SYNOPSIS
-C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
+=item DESCRIPTION
-=item Manual binary installation
+=over 4
-Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
-(statically linked), Executables for Perl utilities, Main Perl library,
-Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
-and utilities, Manpages for Perl modules, Source for Perl documentation,
-Perl manual in F<.INF> format, Pdksh
+=item Setting Up Perl on Win32
-=item B<Warning>
+Make, Command Shell, Borland C++, Microsoft Visual C++, Mingw32 with GCC
-=back
+=item Building
-=item Accessing documentation
+=item Testing Perl on Win32
-=over 4
+=item Installation of Perl on Win32
-=item OS/2 F<.INF> file
+=item Usage Hints for Perl on Win32
-=item Plain text
+Environment Variables, File Globbing, Using perl from the command line,
+Building Extensions, Command-line Wildcard Expansion, Win32 Specific
+Extensions, Running Perl Scripts, Miscellaneous Things
-=item Manpages
+=back
-=item HTML
+=item BUGS AND CAVEATS
-=item GNU C<info> files
+=item AUTHORS
-=item F<.PDF> files
+Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
+E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
+E<lt>nick@ing-simmons.netE<gt>
-=item C<LaTeX> docs
+=item SEE ALSO
-=back
+=item HISTORY
-=item BUILD
+=back
-=over 4
+=head1 PRAGMA DOCUMENTATION
-=item The short story
+=head2 attrs - set/get attributes of a subroutine (deprecated)
-=item Prerequisites
+=over 4
-=item Getting perl source
+=item SYNOPSIS
-=item Application of the patches
+=item DESCRIPTION
-=item Hand-editing
+method, locked
-=item Making
+=back
-=item Testing
+=head2 re - Perl pragma to alter regular expression behaviour
-A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
-F<op/stat.t>
+=over 4
-=item Installing the built perl
+=item SYNOPSIS
-=item C<a.out>-style build
+=item DESCRIPTION
=back
-=item Build FAQ
+=head2 threadshared::shared, threads::shared - Perl extension for sharing
+data structures between threads
=over 4
-=item Some C</> became C<\> in pdksh.
+=item SYNOPSIS
-=item C<'errno'> - unresolved external
+=item DESCRIPTION
-=item Problems with tr or sed
+=item EXPORT
-=item Some problem (forget which ;-)
+=item FUNCTIONS
-=item Library ... not found
+share VARIABLE, lock VARIABLE, unlock VARIABLE, cond_wait VARIABLE,
+cond_signal VARIABLE, cond_broadcast VARIABLE
-=item Segfault in make
+=item NOTES
-=item op/sprintf test failure
+=item BUGS
+
+=item AUTHOR
+
+=item SEE ALSO
=back
-=item Specific (mis)features of OS/2 port
+=head2 threads - Perl extension allowing use of interpreter based threads
+from perl
=over 4
-=item C<setpriority>, C<getpriority>
+=item SYNOPSIS
-=item C<system()>
+=item DESCRIPTION
-=item C<extproc> on the first line
+$thread = threads->create(function, LIST), $thread->join, $thread->detach,
+threads->self, $thread->tid
-=item Additional modules:
+=item WARNINGS
-=item Prebuilt methods:
+Cleanup skipped %d active threads
-C<File::Copy::syscopy>, C<DynaLoader::mod2fname>, C<Cwd::current_drive()>,
- C<Cwd::sys_chdir(name)>, C<Cwd::change_drive(name)>,
-C<Cwd::sys_is_absolute(name)>, C<Cwd::sys_is_rooted(name)>,
-C<Cwd::sys_is_relative(name)>, C<Cwd::sys_cwd(name)>,
-C<Cwd::sys_abspath(name, dir)>, C<Cwd::extLibpath([type])>,
-C<Cwd::extLibpath_set( path [, type ] )>,
-C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
-OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
-C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
-C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
-OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>
+=item TODO
-=item Prebuilt variables:
+Fix so the return value is returned when you join, Add join_all, Fix memory
+leaks!
-$OS2::emx_rev, $OS2::emx_env, $OS2::os_ver
+=item AUTHOR and COPYRIGHT
-=item Misfeatures
+=item BUGS
-=item Modifications
+creating a thread from within a thread is unsafe under win32,
+PERL_OLD_SIGNALS are not threadsafe, will not be
-C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
-C<flock>
+=item SEE ALSO
-=item Identifying DLLs
+=back
-=item Centralized management of resources
+=head2 attributes - get/set subroutine or variable attributes
-C<HAB>, C<HMQ>
+=over 4
-=back
+=item SYNOPSIS
-=item Perl flavors
+=item DESCRIPTION
=over 4
-=item F<perl.exe>
+=item Built-in Attributes
-=item F<perl_.exe>
+locked, method, lvalue
-=item F<perl__.exe>
+=item Available Subroutines
-=item F<perl___.exe>
+get, reftype
-=item Why strange names?
+=item Package-specific Attribute Handling
-=item Why dynamic linking?
+FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
-=item Why chimera build?
+=item Syntax of Attribute Lists
=back
-=item ENVIRONMENT
+=item EXPORTS
=over 4
-=item C<PERLLIB_PREFIX>
+=item Default exports
-=item C<PERL_BADLANG>
+=item Available exports
-=item C<PERL_BADFREE>
+=item Export tags defined
-=item C<PERL_SH_DIR>
+=back
-=item C<USE_PERL_FLOCK>
+=item EXAMPLES
-=item C<TMP> or C<TEMP>
+=item SEE ALSO
=back
-=item Evolution
+=head2 attrs - set/get attributes of a subroutine (deprecated)
=over 4
-=item Priorities
-
-=item DLL name mangling: pre 5.6.2
+=item SYNOPSIS
-=item DLL name mangling: 5.6.2 and beyond
+=item DESCRIPTION
-Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
-C<LIBPATH>
+method, locked
-=item DLL forwarder generation
+=back
-=item Threading
+=head2 autouse - postpone load of modules until a function is used
-=item Calls to external programs
+=over 4
-=item Memory allocation
+=item SYNOPSIS
-=item Threads
+=item DESCRIPTION
-C<COND_WAIT>, F<os2.c>
+=item WARNING
-=back
+=item AUTHOR
-=item BUGS
+=item SEE ALSO
=back
+=head2 base - Establish IS-A relationship with base class at compile time
+
=over 4
-=item AUTHOR
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item HISTORY
=item SEE ALSO
=back
-=head2 perlos390, README.os390 - building and installing Perl for OS/390.
+=head2 bigint - Transparent big integer support for Perl
=over 4
=over 4
-=item Unpacking Perl distribution on OS/390
-
-=item Setup and utilities for Perl on OS/390
-
-=item Configure Perl on OS/390
-
-=item Build, Test, Install Perl on OS/390
-
-=item Build Anomalies with Perl on OS/390
+=item OPTIONS
-=item Testing Anomalies with Perl on OS/390
+a or accuracy, p or precision, t or trace, l or lib, v or version
-=item Installation Anomalies with Perl on OS/390
+=item MATH LIBRARY
-=item Usage Hints for Perl on OS/390
+=item INTERNAL FORMAT
-=item Floating Point Anomalies with Perl on OS/390
+=item SIGN
-=item Modules and Extensions for Perl on OS/390
+=item METHODS
=back
-=item AUTHORS
-
-=item SEE ALSO
+=item MODULES USED
-=over 4
+=item EXAMPLES
-=item Mailing list for Perl on OS/390
+=item LICENSE
-=back
+=item SEE ALSO
-=item HISTORY
+=item AUTHORS
=back
-=head2 perlqnx, README.qnx - Perl version 5 on QNX
+=head2 bignum - Transparent BigNumber support for Perl
=over 4
+=item SYNOPSIS
+
=item DESCRIPTION
=over 4
-=item Required Software for Compiling Perl on QNX4
+=item OPTIONS
-/bin/sh, ar, nm, cpp, make
+a or accuracy, p or precision, t or trace, l or lib, v or version
-=item Outstanding Issues with Perl on QNX4
+=item MATH LIBRARY
-=item QNX auxiliary files
+=item INTERNAL FORMAT
-qnx/ar, qnx/cpp
+=item SIGN
-=item Outstanding issues with perl under QNX6
+=item METHODS
=back
-=item AUTHOR
+=item MODULES USED
+
+=item EXAMPLES
+
+=item LICENSE
+
+=item SEE ALSO
+
+=item AUTHORS
=back
-=head2 perlplan9 - Plan 9-specific documentation for Perl
+=head2 bigrat - Transparent BigNumber/BigRational support for Perl
=over 4
+=item SYNOPSIS
+
=item DESCRIPTION
=over 4
-=item Invoking Perl
-
-=item What's in Plan 9 Perl
+=item MODULES USED
-=item What's not in Plan 9 Perl
+=item MATH LIBRARY
-=item Perl5 Functions not currently supported in Plan 9 Perl
+=item SIGN
-=item Signals in Plan 9 Perl
+=item METHODS
=back
-=item COMPILING AND INSTALLING PERL ON PLAN 9
-
-=over 4
-
-=item Installing Perl Documentation on Plan 9
+=item EXAMPLES
-=back
+ perl -Mbigrat -le 'print sqrt(33)'
+ perl -Mbigrat -le 'print 2*255'
+ perl -Mbigrat -le 'print 4.5+2*255'
+ perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'
+ perl -Mbigrat -le 'print 12->is_odd()';
-=item BUGS
+=item LICENSE
-=item Revision date
+=item SEE ALSO
-=item AUTHOR
+=item AUTHORS
=back
-=head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
+=head2 blib - Use MakeMaker's uninstalled version of a package
=over 4
+=item SYNOPSIS
+
=item DESCRIPTION
-=over 4
+=item BUGS
-=item Solaris Version Numbers.
+=item AUTHOR
=back
-=item RESOURCES
-
-Solaris FAQ, Precompiled Binaries, Solaris Documentation
-
-=item SETTING UP
+=head2 bytes - Perl pragma to force byte semantics rather than character
+semantics
=over 4
-=item File Extraction Problems on Solaris.
+=item SYNOPSIS
-=item Compiler and Related Tools on Solaris.
+=item DESCRIPTION
-=item Environment for Compiling Perl on Solaris
+=item SEE ALSO
=back
-=item RUN CONFIGURE.
+=head2 charnames - define character names for C<\N{named}> string literal
+escapes
=over 4
-=item 64-bit Issues with Perl on Solaris.
-
-=item Threads in Perl on Solaris.
-
-=item Malloc Issues with Perl on Solaris.
+=item SYNOPSIS
-=back
+=item DESCRIPTION
-=item MAKE PROBLEMS.
+=item CUSTOM TRANSLATORS
-Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
-relocation error:, dlopen: stub interception failed, #error "No
-DATAMODEL_NATIVE specified", sh: ar: not found
+=item charnames::viacode(code)
-=item MAKE TEST
+=item charnames::vianame(code)
-=over 4
+=item ALIASES
-=item op/stat.t test 4 in Solaris
+=item ILLEGAL CHARACTERS
-=item nss_delete core dump from op/pwent or op/grent
+=item BUGS
=back
-=item PREBUILT BINARIES OF PERL FOR SOLARIS.
-
-=item RUNTIME ISSUES FOR PERL ON SOLARIS.
+=head2 constant - Perl pragma to declare constants
=over 4
-=item Limits on Numbers of Open Files on Solaris.
-
-=back
+=item SYNOPSIS
-=item SOLARIS-SPECIFIC MODULES.
+=item DESCRIPTION
-=item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
+=item NOTES
=over 4
-=item Proc::ProcessTable on Solaris
+=item List constants
-=item BSD::Resource on Solaris
+=item Defining multiple constants at once
-=item Net::SSLeay on Solaris
+=item Magic constants
=back
+=item TECHNICAL NOTES
+
+=item BUGS
+
=item AUTHOR
-=item LAST MODIFIED
+=item COPYRIGHT
=back
-=head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
-Digital UNIX formerly known as DEC OSF/1) systems
+=head2 diagnostics - Perl compiler pragma to force verbose warning
+diagnostics
=over 4
+=item SYNOPSIS
+
=item DESCRIPTION
=over 4
-=item Compiling Perl 5 on Tru64
-
-=item Using Large Files with Perl on Tru64
-
-=item Threaded Perl on Tru64
+=item The C<diagnostics> Pragma
-=item Long Doubles on Tru64
+=item The I<splain> Program
-=item 64-bit Perl on Tru64
+=back
-=item Warnings about floating-point overflow when compiling Perl on Tru64
+=item EXAMPLES
-=back
+=item INTERNALS
-=item Testing Perl on Tru64
+=item BUGS
=item AUTHOR
=back
-=head2 perluts - Perl under UTS
+=head2 encoding - allows you to write your script in non-asii or non-utf8
=over 4
=item SYNOPSIS
-=item DESCRIPTION
-
-=item BUILDING PERL ON UTS
-
-=item Installing the built perl on UTS
+=item ABSTRACT
-=item AUTHOR
+=item USAGE
-=back
+use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =>
+I<ENCNAME_IN> ...] ;, no encoding;
-=head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
+=item CAVEATS
=over 4
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=over 4
+=item NOT SCOPED
-=item Unpacking Perl Distribution on VM/ESA
+=item DO NOT MIX MULTIPLE ENCODINGS
-=item Setup Perl and utilities on VM/ESA
+=back
-=item Configure Perl on VM/ESA
+=item EXAMPLE - Greekperl
-=item Testing Anomalies of Perl on VM/ESA
+=item KNOWN PROBLEMS
-=item Usage Hints for Perl on VM/ESA
+=item SEE ALSO
=back
-=item AUTHORS
-
-=item SEE ALSO
+=head2 fields - compile-time class fields
=over 4
-=item Mailing list for Perl on VM/ESA
+=item SYNOPSIS
-=back
+=item DESCRIPTION
+
+new, phash
+
+=item SEE ALSO
=back
-=head2 perlvms - VMS-specific documentation for Perl
+=head2 filetest - Perl pragma to control the filetest permission operators
=over 4
-=item DESCRIPTION
-
-=item Installation
+=item SYNOPSIS
-=item Organization of Perl Images
+=item DESCRIPTION
=over 4
-=item Core Images
-
-=item Perl Extensions
-
-=item Installing static extensions
+=item subpragma access
-=item Installing dynamic extensions
+=back
=back
-=item File specifications
+=head2 if - C<use> a Perl module if a condition holds
=over 4
-=item Syntax
+=item SYNOPSIS
-=item Wildcard expansion
+=item DESCRIPTION
-=item Pipes
+=item BUGS
-=back
+=item AUTHOR
-=item PERL5LIB and PERLLIB
+=back
-=item Command line
+=head2 integer - Perl pragma to use integer arithmetic instead of floating
+point
=over 4
-=item I/O redirection and backgrounding
-
-=item Command line switches
+=item SYNOPSIS
--i, -S, -u
+=item DESCRIPTION
=back
-=item Perl functions
+=head2 less - perl pragma to request less of something from the compiler
-File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
-exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
-(system call), stat EXPR, system LIST, time, times, unlink LIST, utime
-LIST, waitpid PID,FLAGS
+=over 4
-=item Perl variables
+=item SYNOPSIS
-%ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
+=item DESCRIPTION
-=item Standard modules with VMS-specific differences
+=back
+
+=head2 lib - manipulate @INC at compile time
=over 4
-=item SDBM_File
+=item SYNOPSIS
-=back
+=item DESCRIPTION
-=item Revision date
+=over 4
-=item AUTHOR
+=item Adding directories to @INC
-=back
+=item Deleting directories from @INC
-=head2 perlvos, README.vos - Perl for Stratus VOS
+=item Restoring original @INC
-=over 4
+=back
-=item SYNOPSIS
+=item CAVEATS
-=over 4
+=item SEE ALSO
-=item Stratus POSIX Support
+=item AUTHOR
=back
-=item INSTALLING PERL IN VOS
+=head2 locale - Perl pragma to use and avoid POSIX locales for built-in
+operations
=over 4
-=item Compiling Perl 5 on VOS
+=item SYNOPSIS
-=item Installing Perl 5 on VOS
+=item DESCRIPTION
=back
-=item USING PERL IN VOS
+=head2 open - perl pragma to set default disciplines for input and output
=over 4
-=item Unimplemented Features of Perl on VOS
-
-=item Restrictions of Perl on VOS
+=item SYNOPSIS
-=back
+=item DESCRIPTION
-=item SUPPORT STATUS
+=item NONPERLIO FUNCTIONALITY
-=item AUTHOR
+=item IMPLEMENTATION DETAILS
-=item LAST UPDATE
+=item SEE ALSO
=back
-=head1 PRAGMA DOCUMENTATION
-
-=head2 attrs - set/get attributes of a subroutine (deprecated)
+=head2 ops - Perl pragma to restrict unsafe operations when compiling
=over 4
-=item SYNOPSIS
+=item SYNOPSIS
=item DESCRIPTION
-method, locked
+=item SEE ALSO
=back
-=head2 re - Perl pragma to alter regular expression behaviour
+=head2 overload - Package for overloading perl operations
=over 4
=item DESCRIPTION
-=back
-
-=head2 threads - Perl extension allowing use of interpreter based threads
-from perl
-
=over 4
-=item SYNOPSIS
+=item Declaration of overloaded functions
-=item DESCRIPTION
+=item Calling Conventions for Binary Operations
-new, function, LIST, $threads->join, $threads->detach, threads->self,
-$threads->tid
+FALSE, TRUE, C<undef>
-=item TODO
+=item Calling Conventions for Unary Operations
-Fix so the return value is returned when you join, Add join_all, Fix memory
-leaks!
+=item Calling Conventions for Mutators
-=item AUTHOR and COPYRIGHT
+C<++> and C<-->, C<x=> and other assignment versions
-=item BUGS
+=item Overloadable Operations
-creating a thread from within a thread is unsafe under win32,
-PERL_OLD_SIGNALS are not threadsafe, will not be
+I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
+I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
+and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
-=item SEE ALSO
+=item Inheritance and overloading
+
+Strings as values of C<use overload> directive, Overloading of an operation
+is inherited by derived classes
=back
-=head2 attributes - get/set subroutine or variable attributes
+=item SPECIAL SYMBOLS FOR C<use overload>
=over 4
-=item SYNOPSIS
+=item Last Resort
-=item DESCRIPTION
+=item Fallback
-=over 4
+C<undef>, TRUE, defined, but FALSE
-=item Built-in Attributes
+=item Copy Constructor
-locked, method, lvalue
+B<Example>
-=item Available Subroutines
+=back
-get, reftype
+=item MAGIC AUTOGENERATION
-=item Package-specific Attribute Handling
+I<Assignment forms of arithmetic operations>, I<Conversion operations>,
+I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
+I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
+I<Copy operator>
-FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
+=item Losing overloading
-=item Syntax of Attribute Lists
+=item Run-time Overloading
-=back
+=item Public functions
-=item EXPORTS
+overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
+
+=item Overloading constants
+
+integer, float, binary, q, qr
+
+=item IMPLEMENTATION
+
+=item Metaphor clash
+
+=item Cookbook
=over 4
-=item Default exports
+=item Two-face scalars
-=item Available exports
+=item Two-face references
-=item Export tags defined
+=item Symbolic calculator
+
+=item I<Really> symbolic calculator
=back
-=item EXAMPLES
+=item AUTHOR
-=item SEE ALSO
+=item DIAGNOSTICS
+
+Odd number of arguments for overload::constant, `%s' is not an overloadable
+type, `%s' is not a code reference
+
+=item BUGS
=back
-=head2 attrs - set/get attributes of a subroutine (deprecated)
+=head2 re - Perl pragma to alter regular expression behaviour
=over 4
=item DESCRIPTION
-method, locked
-
=back
-=head2 autouse - postpone load of modules until a function is used
+=head2 sigtrap - Perl pragma to enable simple signal handling
=over 4
=item DESCRIPTION
-=item WARNING
+=item OPTIONS
-=item AUTHOR
+=over 4
-=item SEE ALSO
+=item SIGNAL HANDLERS
+
+B<stack-trace>, B<die>, B<handler> I<your-handler>
+
+=item SIGNAL LISTS
+
+B<normal-signals>, B<error-signals>, B<old-interface-signals>
+
+=item OTHER
+
+B<untrapped>, B<any>, I<signal>, I<number>
=back
-=head2 base - Establish IS-A relationship with base class at compile time
+=item EXAMPLES
+
+=back
+
+=head2 sort - perl pragma to control sort() behaviour
=over 4
=item DESCRIPTION
-=item HISTORY
-
-=item SEE ALSO
+=item CAVEATS
=back
-=head2 blib - Use MakeMaker's uninstalled version of a package
+=head2 strict - Perl pragma to restrict unsafe constructs
=over 4
=item DESCRIPTION
-=item BUGS
-
-=item AUTHOR
+C<strict refs>, C<strict vars>, C<strict subs>
=back
-=head2 bytes - Perl pragma to force byte semantics rather than character
-semantics
+=head2 subs - Perl pragma to predeclare sub names
=over 4
=item DESCRIPTION
-=item SEE ALSO
-
=back
-=head2 charnames - define character names for C<\N{named}> string literal
-escape.
+=head2 threads - Perl extension allowing use of interpreter based threads
+from perl
=over 4
=item DESCRIPTION
-=item CUSTOM TRANSLATORS
+$thread = threads->create(function, LIST), $thread->join, $thread->detach,
+threads->self, $thread->tid
+
+=item WARNINGS
+
+Cleanup skipped %d active threads
+
+=item TODO
+
+Fix so the return value is returned when you join, Add join_all, Fix memory
+leaks!
+
+=item AUTHOR and COPYRIGHT
=item BUGS
+creating a thread from within a thread is unsafe under win32,
+PERL_OLD_SIGNALS are not threadsafe, will not be
+
+=item SEE ALSO
+
=back
-=head2 constant - Perl pragma to declare constants
+=head2 threadshared, threads::shared - Perl extension for sharing data
+structures between threads
=over 4
=item DESCRIPTION
-=item NOTES
-
-=over 4
-
-=item List constants
-
-=item Defining multiple constants at once
+=item EXPORT
-=item Magic constants
+=item FUNCTIONS
-=back
+share VARIABLE, lock VARIABLE, unlock VARIABLE, cond_wait VARIABLE,
+cond_signal VARIABLE, cond_broadcast VARIABLE
-=item TECHNICAL NOTES
+=item NOTES
=item BUGS
=item AUTHOR
-=item COPYRIGHT
+=item SEE ALSO
=back
-=head2 diagnostics - Perl compiler pragma to force verbose warning
-diagnostics
+=head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
+code
=over 4
=over 4
-=item The C<diagnostics> Pragma
+=item Utility functions
-=item The I<splain> Program
+$num_octets = utf8::upgrade($string);, utf8::downgrade($string[, FAIL_OK]),
+utf8::encode($string), $flag = utf8::decode($string), $flag =
+utf8::valid(STRING)
=back
-=item EXAMPLES
+=item SEE ALSO
-=item INTERNALS
+=back
-=item BUGS
+=head2 vars - Perl pragma to predeclare global variable names (obsolete)
-=item AUTHOR
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
=back
-=head2 fields - compile-time class fields
+=head2 vmsish - Perl pragma to control VMS-specific language features
=over 4
=item DESCRIPTION
-new, phash
-
-=item SEE ALSO
+C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
=back
-=head2 filetest - Perl pragma to control the filetest permission operators
+=head2 warnings - Perl pragma to control optional warnings
=over 4
=item DESCRIPTION
+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
+
+=head2 warnings::register - warnings import function
+
=over 4
-=item subpragma access
+=item SYNOPSIS
-=back
+=item DESCRIPTION
=back
-=head2 integer - Perl pragma to use integer arithmetic instead of floating
-point
+=head1 MODULE DOCUMENTATION
+
+=head2 AnyDBM_File - provide framework for multiple DBMs
=over 4
=item DESCRIPTION
-=back
+=over 4
-=head2 less - perl pragma to request less of something from the compiler
+=item DBM Comparisons
-=over 4
+[0], [1], [2], [3]
-=item SYNOPSIS
+=back
-=item DESCRIPTION
+=item SEE ALSO
=back
-=head2 lib - manipulate @INC at compile time
+=head2 Attribute::Handlers - Simpler definition of attribute handlers
=over 4
+=item VERSION
+
=item SYNOPSIS
=item DESCRIPTION
-=over 4
+[0], [1], [2], [3], [4], [5]
-=item Adding directories to @INC
+=over 4
-=item Deleting directories from @INC
+=item Typed lexicals
-=item Restoring original @INC
+=item Type-specific attribute handlers
-=back
+=item Non-interpretive attribute handlers
-=item SEE ALSO
+=item Phase-specific attribute handlers
-=item AUTHOR
+=item Attributes as C<tie> interfaces
=back
-=head2 locale - Perl pragma to use and avoid POSIX locales for built-in
-operations
+=item EXAMPLES
-=over 4
+=item DIAGNOSTICS
-=item SYNOPSIS
+C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
+attributes>, C<Declaration of %s attribute in package %s may clash with
+future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
+C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
+be able to apply END handler>
-=item DESCRIPTION
+=item AUTHOR
+
+=item BUGS
+
+=item COPYRIGHT
=back
-=head2 open - perl pragma to set default disciplines for input and output
+=head2 AutoLoader - load subroutines only on demand
=over 4
=item DESCRIPTION
-=item NONPERLIO FUNCTIONALITY
+=over 4
-=item IMPLEMENTATION DETAILS
+=item Subroutine Stubs
-=item SEE ALSO
+=item Using B<AutoLoader>'s AUTOLOAD Subroutine
-=back
+=item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
-=head2 ops - Perl pragma to restrict unsafe operations when compiling
+=item Package Lexicals
-=over 4
+=item Not Using AutoLoader
-=item SYNOPSIS
+=item B<AutoLoader> vs. B<SelfLoader>
-=item DESCRIPTION
+=back
+
+=item CAVEATS
=item SEE ALSO
=back
-=head2 overload - Package for overloading perl operations
+=head2 AutoSplit - split a package for autoloading
=over 4
=item DESCRIPTION
+$keep, $check, $modtime
+
=over 4
-=item Declaration of overloaded functions
+=item Multiple packages
-=item Calling Conventions for Binary Operations
+=back
-FALSE, TRUE, C<undef>
+=item DIAGNOSTICS
-=item Calling Conventions for Unary Operations
+=back
-=item Calling Conventions for Mutators
+=head2 B - The Perl Compiler
-C<++> and C<-->, C<x=> and other assignment versions
+=over 4
-=item Overloadable Operations
+=item SYNOPSIS
-I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
-I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
-and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
+=item DESCRIPTION
-=item Inheritance and overloading
+=item OVERVIEW OF CLASSES
-Strings as values of C<use overload> directive, Overloading of an operation
-is inherited by derived classes
+=over 4
-=back
+=item SV-RELATED CLASSES
-=item SPECIAL SYMBOLS FOR C<use overload>
+=item B::SV METHODS
-=over 4
+REFCNT, FLAGS
-=item Last Resort
+=item B::IV METHODS
-=item Fallback
+IV, IVX, UVX, int_value, needs64bits, packiv
-C<undef>, TRUE, defined, but FALSE
+=item B::NV METHODS
-=item Copy Constructor
+NV, NVX
-B<Example>
+=item B::RV METHODS
-=back
+RV
-=item MAGIC AUTOGENERATION
+=item B::PV METHODS
-I<Assignment forms of arithmetic operations>, I<Conversion operations>,
-I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
-I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
-I<Copy operator>
+PV, RV, PVX
-=item Losing overloading
+=item B::PVMG METHODS
-=item Run-time Overloading
+MAGIC, SvSTASH
-=item Public functions
+=item B::MAGIC METHODS
-overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
+MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
-=item Overloading constants
+=item B::PVLV METHODS
-integer, float, binary, q, qr
+TARGOFF, TARGLEN, TYPE, TARG
-=item IMPLEMENTATION
+=item B::BM METHODS
-=item Metaphor clash
+USEFUL, PREVIOUS, RARE, TABLE
-=item Cookbook
+=item B::GV METHODS
-=over 4
+is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
+LINE, FILE, FILEGV, GvREFCNT, FLAGS
-=item Two-face scalars
+=item B::IO METHODS
-=item Two-face references
+LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
+BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
-=item Symbolic calculator
+=item B::AV METHODS
-=item I<Really> symbolic calculator
+FILL, MAX, OFF, ARRAY, AvFLAGS
-=back
+=item B::CV METHODS
-=item AUTHOR
+STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY,
+CvFLAGS, const_sv
-=item DIAGNOSTICS
+=item B::HV METHODS
-Odd number of arguments for overload::constant, `%s' is not an overloadable
-type, `%s' is not a code reference
+FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
-=item BUGS
+=item OP-RELATED CLASSES
-=back
+=item B::OP METHODS
-=head2 re - Perl pragma to alter regular expression behaviour
+next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
-=over 4
+=item B::UNOP METHOD
-=item SYNOPSIS
+first
-=item DESCRIPTION
+=item B::BINOP METHOD
-=back
+last
-=head2 sigtrap - Perl pragma to enable simple signal handling
+=item B::LOGOP METHOD
-=over 4
+other
-=item SYNOPSIS
+=item B::LISTOP METHOD
-=item DESCRIPTION
+children
-=item OPTIONS
+=item B::PMOP METHODS
-=over 4
+pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
+pmpermflags, precomp, pmoffet
-=item SIGNAL HANDLERS
+=item B::SVOP METHOD
-B<stack-trace>, B<die>, B<handler> I<your-handler>
+sv, gv
-=item SIGNAL LISTS
+=item B::PADOP METHOD
-B<normal-signals>, B<error-signals>, B<old-interface-signals>
+padix
-=item OTHER
+=item B::PVOP METHOD
-B<untrapped>, B<any>, I<signal>, I<number>
+pv
-=back
+=item B::LOOP METHODS
-=item EXAMPLES
+redoop, nextop, lastop
-=back
+=item B::COP METHODS
-=head2 strict - Perl pragma to restrict unsafe constructs
+label, stash, file, cop_seq, arybase, line
-=over 4
+=back
-=item SYNOPSIS
+=item FUNCTIONS EXPORTED BY C<B>
-=item DESCRIPTION
+main_cv, init_av, begin_av, end_av, main_root, main_start, comppadlist,
+regex_padav, sv_undef, sv_yes, sv_no, amagic_generation, walkoptree(OP,
+METHOD), walkoptree_debug(DEBUG), walksymtable(SYMREF, METHOD, RECURSE,
+PREFIX), svref_2object(SV), ppname(OPNUM), hash(STR), cast_I32(I), minus_c,
+cstring(STR), perlstring(STR), class(OBJ), threadsv_names
-C<strict refs>, C<strict vars>, C<strict subs>
+=item AUTHOR
=back
-=head2 subs - Perl pragma to predeclare sub names
+=head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
+bytecode
=over 4
=item DESCRIPTION
+%insn_data, @insn_name, @optype, @specialsv_name
+
+=item AUTHOR
+
=back
-=head2 threads - Perl extension allowing use of interpreter based threads
-from perl
+=head2 B::Assembler - Assemble Perl bytecode
=over 4
=item DESCRIPTION
-new, function, LIST, $threads->join, $threads->detach, threads->self,
-$threads->tid
-
-=item TODO
-
-Fix so the return value is returned when you join, Add join_all, Fix memory
-leaks!
-
-=item AUTHOR and COPYRIGHT
-
-=item BUGS
-
-creating a thread from within a thread is unsafe under win32,
-PERL_OLD_SIGNALS are not threadsafe, will not be
-
-=item SEE ALSO
+=item AUTHORS
=back
-=head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
-code
+=head2 B::Bblock - Walk basic blocks
=over 4
=over 4
-=item Utility functions
+=item Functions
-$num_octets = utf8::upgrade($string);, utf8::downgrade($string[, CHECK]),
-utf8::encode($string), $flag = utf8::decode($string)
+B<find_leaders>
=back
-=item SEE ALSO
+=item AUTHOR
=back
-=head2 vars - Perl pragma to predeclare global variable names (obsolete)
+=head2 B::Bytecode - Perl compiler's bytecode backend
=over 4
=item DESCRIPTION
-=back
-
-=head2 warnings - Perl pragma to control optional warnings
+=item OPTIONS
-=over 4
+B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
+B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
+B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
-=item SYNOPSIS
+=item EXAMPLES
-=item DESCRIPTION
+=item BUGS
-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)
+=item AUTHORS
=back
-=head2 warnings::register - warnings import function
+=head2 B::C - Perl compiler's C backend
=over 4
=item DESCRIPTION
-=back
+=item OPTIONS
-=head1 MODULE DOCUMENTATION
+B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
+B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
+B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
+B<-llimit>
-=head2 AnyDBM_File - provide framework for multiple DBMs
+=item EXAMPLES
+
+=item BUGS
+
+=item AUTHOR
+
+=back
+
+=head2 B::CC - Perl compiler's optimized C translation backend
=over 4
=item DESCRIPTION
+=item OPTIONS
+
+B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
+B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
+B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
+
+=item EXAMPLES
+
+=item BUGS
+
+=item DIFFERENCES
+
=over 4
-=item DBM Comparisons
+=item Loops
-[0], [1], [2], [3]
+=item Context of ".."
+
+=item Arithmetic
+
+=item Deprecated features
=back
-=item SEE ALSO
+=item AUTHOR
=back
-=head2 Attribute::Handlers - Simpler definition of attribute handlers
+=head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
=over 4
-=item VERSION
-
=item SYNOPSIS
=item DESCRIPTION
-[0], [1], [2], [3], [4], [5]
+=item EXAMPLE
-=over 4
+=item OPTIONS
-=item Typed lexicals
+B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
+B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
+B<-terse>, B<-linenoise>, B<-debug>, B<-env>
-=item Type-specific attribute handlers
+=item FORMATTING SPECIFICATIONS
-=item Non-interpretive attribute handlers
+B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
+B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
+B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
+B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
+B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
+B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
+B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
+B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
-=item Phase-specific attribute handlers
+=item ABBREVIATIONS
-=item Attributes as C<tie> interfaces
+=over 4
-=back
+=item OP flags abbreviations
-=item EXAMPLES
+=item OP class abbreviations
-=item DIAGNOSTICS
+=back
-C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
-attributes>, C<Declaration of %s attribute in package %s may clash with
-future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
-C<Can't autotie a %s>, C<Internal error: %s symbol went missing>
+=item Using B::Concise outside of the O framework
=item AUTHOR
-=item BUGS
-
-=item COPYRIGHT
-
=back
-=head2 AutoLoader - load subroutines only on demand
+=head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
=over 4
=item DESCRIPTION
-=over 4
-
-=item Subroutine Stubs
-
-=item Using B<AutoLoader>'s AUTOLOAD Subroutine
-
-=item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
+=item AUTHOR
-=item Package Lexicals
+=back
-=item Not Using AutoLoader
+=head2 B::Deparse - Perl compiler backend to produce perl code
-=item B<AutoLoader> vs. B<SelfLoader>
+=over 4
-=back
+=item SYNOPSIS
-=item CAVEATS
+=item DESCRIPTION
-=item SEE ALSO
+=item OPTIONS
-=back
+B<-l>, B<-p>, B<-P>, B<-q>, B<-f>I<FILE>, B<-s>I<LETTERS>, B<C>,
+B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
-=head2 AutoSplit - split a package for autoloading
+=item USING B::Deparse AS A MODULE
=over 4
-=item SYNOPSIS
+=item Synopsis
-=item DESCRIPTION
+=item Description
-$keep, $check, $modtime
+=item new
-=over 4
+=item ambient_pragmas
-=item Multiple packages
+strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
+
+=item coderef2text
=back
-=item DIAGNOSTICS
+=item BUGS
+
+=item AUTHOR
=back
-=head2 B - The Perl Compiler
+=head2 B::Disassembler - Disassemble Perl bytecode
=over 4
=item DESCRIPTION
-=item OVERVIEW OF CLASSES
+=item AUTHOR
-=over 4
+=back
-=item SV-RELATED CLASSES
+=head2 B::Lint - Perl lint
-=item B::SV METHODS
+=over 4
-REFCNT, FLAGS
+=item SYNOPSIS
-=item B::IV METHODS
+=item DESCRIPTION
-IV, IVX, UVX, int_value, needs64bits, packiv
+=item OPTIONS AND LINT CHECKS
-=item B::NV METHODS
+B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>,
+B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none>
-NV, NVX
+=item NON LINT-CHECK OPTIONS
-=item B::RV METHODS
+B<-u Package>
-RV
+=item BUGS
-=item B::PV METHODS
+=item AUTHOR
-PV, PVX
+=back
-=item B::PVMG METHODS
+=head2 B::O, O - Generic interface to Perl Compiler backends
-MAGIC, SvSTASH
+=over 4
-=item B::MAGIC METHODS
+=item SYNOPSIS
-MOREMAGIC, PRIVATE, TYPE, FLAGS, OBJ, PTR
+=item DESCRIPTION
-=item B::PVLV METHODS
+=item CONVENTIONS
-TARGOFF, TARGLEN, TYPE, TARG
+=item IMPLEMENTATION
-=item B::BM METHODS
+=item AUTHOR
-USEFUL, PREVIOUS, RARE, TABLE
+=back
-=item B::GV METHODS
+=head2 B::Showlex - Show lexical variables used in functions or files
-is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
-LINE, FILE, FILEGV, GvREFCNT, FLAGS
+=over 4
-=item B::IO METHODS
+=item SYNOPSIS
-LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
-BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS
+=item DESCRIPTION
-=item B::AV METHODS
+=item AUTHOR
-FILL, MAX, OFF, ARRAY, AvFLAGS
+=back
-=item B::CV METHODS
+=head2 B::Stackobj - Helper module for CC backend
-STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY,
-CvFLAGS, const_sv
+=over 4
-=item B::HV METHODS
+=item SYNOPSIS
-FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
+=item DESCRIPTION
-=item OP-RELATED CLASSES
+=item AUTHOR
-=item B::OP METHODS
+=back
-next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
+=head2 B::Stash - show what stashes are loaded
-=item B::UNOP METHOD
+=head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
-first
+=over 4
-=item B::BINOP METHOD
+=item SYNOPSIS
-last
+=item DESCRIPTION
-=item B::LOGOP METHOD
+=item AUTHOR
-other
+=back
-=item B::LISTOP METHOD
+=head2 B::Xref - Generates cross reference reports for Perl programs
-children
+=over 4
-=item B::PMOP METHODS
+=item SYNOPSIS
-pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmpermflags, precomp
+=item DESCRIPTION
-=item B::SVOP METHOD
+=item OPTIONS
-sv, gv
+C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
-=item B::PADOP METHOD
+=item BUGS
-padix
+=item AUTHOR
-=item B::PVOP METHOD
+=back
-pv
+=head2 Bblock, B::Bblock - Walk basic blocks
-=item B::LOOP METHODS
+=over 4
-redoop, nextop, lastop
+=item SYNOPSIS
-=item B::COP METHODS
+=item DESCRIPTION
-label, stash, file, cop_seq, arybase, line
+=over 4
-=back
+=item Functions
-=item FUNCTIONS EXPORTED BY C<B>
+B<find_leaders>
-main_cv, init_av, main_root, main_start, comppadlist, sv_undef, sv_yes,
-sv_no, amagic_generation, walkoptree(OP, METHOD), walkoptree_debug(DEBUG),
-walksymtable(SYMREF, METHOD, RECURSE, PREFIX), svref_2object(SV),
-ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR), class(OBJ),
-threadsv_names
+=back
=item AUTHOR
=back
-=head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
-bytecode
+=head2 Benchmark - benchmark running times of Perl code
=over 4
=item DESCRIPTION
-=item AUTHOR
+=over 4
+
+=item Methods
+
+new, debug, iters
+
+=item Standard Exports
+
+timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
+timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
+TIMEDIFF, [ STYLE, [ FORMAT ] ] )
+
+=item Optional Exports
+
+clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUT, CODEHASHREF, [
+STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
+disablecache ( ), enablecache ( ), timesum ( T1, T2 )
=back
-=head2 B::Assembler - Assemble Perl bytecode
+=item NOTES
-=over 4
+=item EXAMPLES
+
+=item INHERITANCE
-=item SYNOPSIS
+=item CAVEATS
-=item DESCRIPTION
+=item SEE ALSO
=item AUTHORS
+=item MODIFICATION HISTORY
+
=back
-=head2 B::Bblock - Walk basic blocks
+=head2 ByteLoader - load byte compiled perl code
=over 4
=item AUTHOR
+=item SEE ALSO
+
=back
-=head2 B::Bytecode - Perl compiler's bytecode backend
+=head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
=over 4
=back
-=head2 B::C - Perl compiler's C backend
+=head2 CGI - Simple Common Gateway Interface Class
=over 4
=item SYNOPSIS
+=item ABSTRACT
+
=item DESCRIPTION
-=item OPTIONS
+=over 4
-B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
-B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fno-cog>, B<-On>, B<-llimit>
+=item PROGRAMMING STYLE
-=item EXAMPLES
+=item CALLING CGI.PM ROUTINES
-=item BUGS
+=item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
-=item AUTHOR
+=item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
-=back
+=item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
-=head2 B::CC - Perl compiler's optimized C translation backend
+=item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
-=over 4
+=item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
-=item SYNOPSIS
+=item SETTING THE VALUE(S) OF A NAMED PARAMETER:
-=item DESCRIPTION
+=item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
-=item OPTIONS
+=item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
-B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
-B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
-B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
+=item DELETING A PARAMETER COMPLETELY:
-=item EXAMPLES
+=item DELETING ALL PARAMETERS:
-=item BUGS
+=item DIRECT ACCESS TO THE PARAMETER LIST:
-=item DIFFERENCES
+=item FETCHING THE PARAMETER LIST AS A HASH:
-=over 4
+=item SAVING THE STATE OF THE SCRIPT TO A FILE:
-=item Loops
+=item RETRIEVING CGI ERRORS
-=item Context of ".."
+=item USING THE FUNCTION-ORIENTED INTERFACE
-=item Arithmetic
+B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
+B<:standard>, B<:all>
-=item Deprecated features
+=item PRAGMAS
-=back
+-any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
+-newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
+-private_tempfiles
-=item AUTHOR
+=item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
+
+1. start_table() (generates a <table> tag), 2. end_table() (generates a
+</table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
+a </ul> tag)
=back
-=head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
+=item GENERATING DYNAMIC DOCUMENTS
=over 4
-=item SYNOPSIS
+=item CREATING A STANDARD HTTP HEADER:
-=item DESCRIPTION
+=item GENERATING A REDIRECTION HEADER
-=item OPTIONS
+=item CREATING THE HTML DOCUMENT HEADER
-B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
-B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
-B<-terse>, B<-linenoise>, B<-debug>, B<-env>
+B<Parameters:>, 4, 5, 6..
-=item FORMATTING SPECIFICATIONS
+=item ENDING THE HTML DOCUMENT:
-B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
-B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
-B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
-B<#classym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
-B<#flags>, B<#flagval>, B<#hyphenseq>, B<#label>, B<#lastaddr>, B<#name>,
-B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
-B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
-B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
+=item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
-=item ABBREVIATIONS
+=item OBTAINING THE SCRIPT'S URL
+
+B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
+(B<-query_string>), B<-base>
+
+=item MIXING POST AND URL PARAMETERS
+
+=back
+
+=item CREATING STANDARD HTML ELEMENTS:
=over 4
-=item OP flags abbreviations
+=item PROVIDING ARGUMENTS TO HTML SHORTCUTS
-=item OP class abbreviations
+=item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
-=back
+=item HTML SHORTCUTS AND LIST INTERPOLATION
-=item Using B::Concise outside of the O framework
+=item NON-STANDARD HTML SHORTCUTS
-=item AUTHOR
+=item AUTOESCAPING HTML
+
+$escaped_string = escapeHTML("unescaped string");, $charset =
+charset([$charset]);, $flag = autoEscape([$flag]);
+
+=item PRETTY-PRINTING HTML
=back
-=head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
+=item CREATING FILL-OUT FORMS:
=over 4
-=item SYNOPSIS
+=item CREATING AN ISINDEX TAG
-=item DESCRIPTION
+=item STARTING AND ENDING A FORM
-=item AUTHOR
+B<application/x-www-form-urlencoded>, B<multipart/form-data>
-=back
+=item CREATING A TEXT FIELD
-=head2 B::Deparse - Perl compiler backend to produce perl code
+B<Parameters>
-=over 4
+=item CREATING A BIG TEXT FIELD
-=item SYNOPSIS
+=item CREATING A PASSWORD FIELD
-=item DESCRIPTION
+=item CREATING A FILE UPLOAD FIELD
-=item OPTIONS
+B<Parameters>
-B<-l>, B<-p>, B<-q>, B<-f>I<FILE>, B<-s>I<LETTERS>, B<C>, B<i>I<NUMBER>,
-B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
+=item CREATING A POPUP MENU
-=item USING B::Deparse AS A MODULE
+=item CREATING A SCROLLING LIST
-=over 4
+B<Parameters:>
-=item Synopsis
+=item CREATING A GROUP OF RELATED CHECKBOXES
-=item Description
+B<Parameters:>
-=item new
+=item CREATING A STANDALONE CHECKBOX
-=item ambient_pragmas
+B<Parameters:>
-strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
+=item CREATING A RADIO BUTTON GROUP
-=item coderef2text
+B<Parameters:>
-=back
+=item CREATING A SUBMIT BUTTON
-=item BUGS
+B<Parameters:>
-=item AUTHOR
+=item CREATING A RESET BUTTON
+
+=item CREATING A DEFAULT BUTTON
+
+=item CREATING A HIDDEN FIELD
+
+B<Parameters:>
+
+=item CREATING A CLICKABLE IMAGE BUTTON
+
+B<Parameters:>
+
+=item CREATING A JAVASCRIPT ACTION BUTTON
=back
-=head2 B::Disassembler - Disassemble Perl bytecode
+=item HTTP COOKIES
+
+1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
+B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
+
+=item WORKING WITH FRAMES
+
+1. Create a <Frameset> document, 2. Specify the destination for the
+document in the HTTP header, 3. Specify the destination for the document in
+the <form> tag
+
+=item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
+
+=item DEBUGGING
=over 4
-=item SYNOPSIS
+=item DUMPING OUT ALL THE NAME/VALUE PAIRS
-=item DESCRIPTION
+=back
-=item AUTHOR
+=item FETCHING ENVIRONMENT VARIABLES
+
+B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
+B<path_translated()>, B<remote_host()>, B<script_name()>, B<referer()>,
+B<auth_type ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
+B<server_software ()>, B<remote_user ()>, B<user_name ()>,
+B<request_method()>, B<content_type()>, B<http()>, B<https()>
+
+=item USING NPH SCRIPTS
+
+In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
+parameters
+
+=item Server Push
+
+multipart_init(), multipart_start(), multipart_end(), multipart_final()
+
+=item Avoiding Denial of Service Attacks
+
+B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
+basis>, B<2. Globally for all scripts>
+
+=item COMPATIBILITY WITH CGI-LIB.PL
+
+=item AUTHOR INFORMATION
+
+=item CREDITS
+
+Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
+(james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
+(mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
+(jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
+(applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
+(tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
+(tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
+MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
+(kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
+Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
+MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
+...and many many more..
+
+=item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
+
+=item BUGS
+
+=item SEE ALSO
=back
-=head2 B::Lint - Perl lint
+=head2 CGI::Apache - Backward compatibility module for CGI.pm
=over 4
=item SYNOPSIS
+=item ABSTRACT
+
=item DESCRIPTION
-=item OPTIONS AND LINT CHECKS
+=item AUTHOR INFORMATION
-B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>,
-B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none>
+=item BUGS
-=item NON LINT-CHECK OPTIONS
+=item SEE ALSO
-B<-u Package>
+=back
-=item BUGS
+=head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
+other) error log
-=item AUTHOR
+=over 4
-=back
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item REDIRECTING ERROR MESSAGES
-=head2 B::O, O - Generic interface to Perl Compiler backends
+=item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
=over 4
-=item SYNOPSIS
+=item Changing the default message
-=item DESCRIPTION
+=back
-=item CONVENTIONS
+=item MAKING WARNINGS APPEAR AS HTML COMMENTS
-=item IMPLEMENTATION
+=item CHANGE LOG
-=item AUTHOR
+=item AUTHORS
+
+=item SEE ALSO
=back
-=head2 B::Showlex - Show lexical variables used in functions or files
+=head2 CGI::Cookie - Interface to Netscape Cookies
=over 4
=item DESCRIPTION
-=item AUTHOR
-
-=back
+=item USING CGI::Cookie
-=head2 B::Stackobj - Helper module for CC backend
+B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
=over 4
-=item SYNOPSIS
-
-=item DESCRIPTION
+=item Creating New Cookies
-=item AUTHOR
+=item Sending the Cookie to the Browser
-=back
+=item Recovering Previous Cookies
-=head2 B::Stash - show what stashes are loaded
+=item Manipulating Cookies
-=head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
+B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
-=over 4
+=back
-=item SYNOPSIS
+=item AUTHOR INFORMATION
-=item DESCRIPTION
+=item BUGS
-=item AUTHOR
+=item SEE ALSO
=back
-=head2 B::Xref - Generates cross reference reports for Perl programs
+=head2 CGI::Fast - CGI Interface for Fast CGI
=over 4
=item DESCRIPTION
-=item OPTIONS
+=item OTHER PIECES OF THE PUZZLE
-C<-oFILENAME>, C<-r>, C<-D[tO]>
+=item WRITING FASTCGI PERL SCRIPTS
-=item BUGS
+=item INSTALLING FASTCGI SCRIPTS
-=item AUTHOR
+=item USING FASTCGI SCRIPTS AS CGI SCRIPTS
-=back
+=item EXTERNAL FASTCGI SERVER INVOCATION
-=head2 Bblock, B::Bblock - Walk basic blocks
+FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
-=over 4
+=item CAVEATS
-=item SYNOPSIS
+=item AUTHOR INFORMATION
-=item DESCRIPTION
+=item BUGS
-=item AUTHOR
+=item SEE ALSO
=back
-=head2 Benchmark - benchmark running times of Perl code
+=head2 CGI::Pretty - module to produce nicely formatted HTML code
=over 4
=over 4
-=item Methods
-
-new, debug, iters
-
-=item Standard Exports
-
-timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
-timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
-TIMEDIFF, [ STYLE, [ FORMAT ] ] )
-
-=item Optional Exports
+=item Tags that won't be formatted
-clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUT, CODEHASHREF, [
-STYLE ] ), cmpthese ( RESULTSHASHREF ), countit(TIME, CODE), disablecache (
-), enablecache ( ), timesum ( T1, T2 )
+=item Customizing the Indenting
=back
-=item NOTES
-
-=item EXAMPLES
-
-=item INHERITANCE
+=item BUGS
-=item CAVEATS
+=item AUTHOR
=item SEE ALSO
-=item AUTHORS
-
-=item MODIFICATION HISTORY
-
=back
-=head2 ByteLoader - load byte compiled perl code
+=head2 CGI::Push - Simple Interface to Server Push
=over 4
=item DESCRIPTION
-=item AUTHOR
-
-=item SEE ALSO
-
-=back
+=item USING CGI::Push
-=head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
+-next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
=over 4
-=item SYNOPSIS
+=item Heterogeneous Pages
-=item DESCRIPTION
+=item Changing the Page Delay on the Fly
-=item OPTIONS
+=back
-B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
-B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
-B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
+=item INSTALLING CGI::Push SCRIPTS
-=item EXAMPLES
+=item AUTHOR INFORMATION
=item BUGS
-=item AUTHORS
+=item SEE ALSO
=back
-=head2 CGI - Simple Common Gateway Interface Class
+=head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
=over 4
=item DESCRIPTION
-=over 4
-
-=item PROGRAMMING STYLE
-
-=item CALLING CGI.PM ROUTINES
-
-=item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
+=item AUTHOR INFORMATION
-=item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
+=item BUGS
-=item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
+=item SEE ALSO
-=item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
+=back
-=item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
+=head2 CGI::Util - Internal utilities used by CGI module
-=item SETTING THE VALUE(S) OF A NAMED PARAMETER:
+=over 4
-=item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
+=item SYNOPSIS
-=item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
+=item DESCRIPTION
-=item DELETING A PARAMETER COMPLETELY:
+=item AUTHOR INFORMATION
-=item DELETING ALL PARAMETERS:
+=item SEE ALSO
-=item DIRECT ACCESS TO THE PARAMETER LIST:
+=back
-=item FETCHING THE PARAMETER LIST AS A HASH:
+=head2 CPAN - query, download and build perl modules from CPAN sites
-=item SAVING THE STATE OF THE SCRIPT TO A FILE:
+=over 4
-=item RETRIEVING CGI ERRORS
+=item SYNOPSIS
-=item USING THE FUNCTION-ORIENTED INTERFACE
+=item DESCRIPTION
-B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:netscape>, B<:html>,
-B<:standard>, B<:all>
+=over 4
-=item PRAGMAS
+=item Interactive Mode
--any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
--newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
--private_tempfiles
+Searching for authors, bundles, distribution files and modules, make, test,
+install, clean modules or distributions, get, readme, look module or
+distribution, ls author, Signals
-=item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
+=item CPAN::Shell
-1. start_table() (generates a <TABLE> tag), 2. end_table() (generates a
-</TABLE> tag), 3. start_ul() (generates a <UL> tag), 4. end_ul() (generates
-a </UL> tag)
+=item autobundle
-=back
+=item recompile
-=item GENERATING DYNAMIC DOCUMENTS
+=item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
-=over 4
+=item Programmer's interface
-=item CREATING A STANDARD HTTP HEADER:
+expand($type,@things), expandany(@things), Programming Examples
-=item GENERATING A REDIRECTION HEADER
+=item Methods in the other Classes
-=item CREATING THE HTML DOCUMENT HEADER
+CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
+CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
+CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
+CPAN::Bundle::clean(), CPAN::Bundle::contains(),
+CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
+CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
+CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
+CPAN::Bundle::readme(), CPAN::Bundle::test(),
+CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
+CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
+CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
+CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
+CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
+CPAN::Distribution::look(), CPAN::Distribution::make(),
+CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
+CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
+CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
+CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
+CPAN::Module::clean(), CPAN::Module::cpan_file(),
+CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
+CPAN::Module::description(), CPAN::Module::force($method,@args),
+CPAN::Module::get(), CPAN::Module::inst_file(),
+CPAN::Module::inst_version(), CPAN::Module::install(),
+CPAN::Module::look(), CPAN::Module::make(),
+CPAN::Module::manpage_headline(), CPAN::Module::readme(),
+CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
-B<Parameters:>, 4, 5, 6..
+=item Cache Manager
-=item ENDING THE HTML DOCUMENT:
+=item Bundles
-=item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
+=item Prerequisites
-=item OBTAINING THE SCRIPT'S URL
+=item Finding packages and VERSION
-B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
-(B<-query_string>), B<-base>
+=item Debugging
-=item MIXING POST AND URL PARAMETERS
+=item Floppy, Zip, Offline Mode
=back
-=item CREATING STANDARD HTML ELEMENTS:
+=item CONFIGURATION
+
+C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
+E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
+optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
+[unshift|push|splice] E<lt>listE<gt>>
=over 4
-=item PROVIDING ARGUMENTS TO HTML SHORTCUTS
+=item Note on urllist parameter's format
-=item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
+=item urllist parameter has CD-ROM support
-=item HTML SHORTCUTS AND LIST INTERPOLATION
+=back
-=item NON-STANDARD HTML SHORTCUTS
+=item SECURITY
-=item AUTOESCAPING HTML
+=item EXPORT
-$escaped_string = escapeHTML("unescaped string");, $charset =
-charset([$charset]);, $flag = autoEscape([$flag]);
+=item POPULATE AN INSTALLATION WITH LOTS OF MODULES
-=item PRETTY-PRINTING HTML
+=item WORKING WITH CPAN.pm BEHIND FIREWALLS
-=back
+=over 4
-=item CREATING FILL-OUT FORMS:
+=item Three basic types of firewalls
-=over 4
+http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
-=item CREATING AN ISINDEX TAG
+=item Configuring lynx or ncftp for going through a firewall
-=item STARTING AND ENDING A FORM
+=back
-B<application/x-www-form-urlencoded>, B<multipart/form-data>
+=item FAQ
-=item CREATING A TEXT FIELD
+1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
-B<Parameters>
+=item BUGS
+
+=item AUTHOR
-=item CREATING A BIG TEXT FIELD
+=item TRANSLATIONS
-=item CREATING A PASSWORD FIELD
+=item SEE ALSO
-=item CREATING A FILE UPLOAD FIELD
+=back
-B<Parameters>
+=head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
-=item CREATING A POPUP MENU
+=over 4
-=item CREATING A SCROLLING LIST
+=item SYNOPSIS
-B<Parameters:>
+=item DESCRIPTION
-=item CREATING A GROUP OF RELATED CHECKBOXES
+=back
-B<Parameters:>
+=head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
+module
-=item CREATING A STANDALONE CHECKBOX
+=over 4
-B<Parameters:>
+=item SYNOPSIS
-=item CREATING A RADIO BUTTON GROUP
+=item DESCRIPTION
-B<Parameters:>
+=item SEE ALSO
-=item CREATING A SUBMIT BUTTON
+=back
-B<Parameters:>
+=head2 Carp, carp - warn of errors (from perspective of caller)
-=item CREATING A RESET BUTTON
+=over 4
-=item CREATING A DEFAULT BUTTON
+=item SYNOPSIS
-=item CREATING A HIDDEN FIELD
+=item DESCRIPTION
-B<Parameters:>
+=over 4
-=item CREATING A CLICKABLE IMAGE BUTTON
+=item Forcing a Stack Trace
-B<Parameters:>
+=back
-=item CREATING A JAVASCRIPT ACTION BUTTON
+=item BUGS
=back
-=item HTTP COOKIES
+=head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
-1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
-B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
+=head2 Class::ISA -- report the search path for a class's ISA tree
-=item WORKING WITH FRAMES
+=over 4
-1. Create a <Frameset> document, 2. Specify the destination for the
-document in the HTTP header, 3. Specify the destination for the document in
-the <FORM> tag
+=item SYNOPSIS
-=item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
+=item DESCRIPTION
-=item DEBUGGING
+=item FUNCTIONS
-=over 4
+the function Class::ISA::super_path($CLASS), the function
+Class::ISA::self_and_super_path($CLASS), the function
+Class::ISA::self_and_super_versions($CLASS)
-=item DUMPING OUT ALL THE NAME/VALUE PAIRS
+=item CAUTIONARY NOTES
-=back
+=item COPYRIGHT
-=item FETCHING ENVIRONMENT VARIABLES
+=item AUTHOR
-B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
-B<path_translated()>, B<remote_host()>, B<script_name()>, B<referer()>,
-B<auth_type ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
-B<server_software ()>, B<remote_user ()>, B<user_name ()>,
-B<request_method()>, B<content_type()>, B<http()>, B<https()>
+=back
-=item USING NPH SCRIPTS
+=head2 Class::Struct - declare struct-like datatypes as Perl classes
-In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
-parameters
+=over 4
-=item Server Push
+=item SYNOPSIS
-multipart_init(), multipart_start(), multipart_end(), multipart_final()
+=item DESCRIPTION
-=item Avoiding Denial of Service Attacks
+=over 4
-B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
-basis>, B<2. Globally for all scripts>
+=item The C<struct()> function
-=item COMPATIBILITY WITH CGI-LIB.PL
+=item Class Creation at Compile Time
-=item AUTHOR INFORMATION
+=item Element Types and Accessor Methods
-=item CREDITS
+Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
+C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
-Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
-(james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
-(mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
-(jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
-(applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
-(tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
-(tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
-MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
-(kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
-Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
-MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
-...and many many more..
+=item Initializing with C<new>
-=item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
+=back
-=item BUGS
+=item EXAMPLES
-=item SEE ALSO
+Example 1, Example 2, Example 3
+
+=item Author and Modification History
=back
-=head2 CGI::Apache - Backward compatibility module for CGI.pm
+=head2 Config - access Perl configuration information
=over 4
=item SYNOPSIS
-=item ABSTRACT
-
=item DESCRIPTION
-=item AUTHOR INFORMATION
-
-=item BUGS
+myconfig(), config_sh(), config_vars(@names)
-=item SEE ALSO
+=item EXAMPLE
-=back
+=item WARNING
-=head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
-other) error log
+=item GLOSSARY
=over 4
-=item SYNOPSIS
+=item _
-=item DESCRIPTION
+C<_a>, C<_exe>, C<_o>
-=item REDIRECTING ERROR MESSAGES
+=item a
-=item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
+C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
+C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
+C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
+C<asctime_r_proto>, C<awk>
-=over 4
+=item b
-=item Changing the default message
+C<baserev>, C<bash>, C<bin>, C<bincompat5005>, C<binexp>, C<bison>,
+C<byacc>, C<byteorder>
-=back
+=item c
-=item MAKING WARNINGS APPEAR AS HTML COMMENTS
+C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
+C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
+C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
+C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
+C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
+C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
+C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
-=item CHANGE LOG
+=item d
-=item AUTHORS
+C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>,
+C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>, C<d_bcmp>,
+C<d_bcopy>, C<d_bincompat5005>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>,
+C<d_bzero>, C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>,
+C<d_chroot>, C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>,
+C<d_const>, C<d_crypt>, C<d_crypt_r>, C<d_csh>, C<d_ctermid_r>,
+C<d_ctime_r>, C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>, C<d_difftime>,
+C<d_dirfd>, C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>,
+C<d_dosuid>, C<d_drand48_r>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>,
+C<d_endgrent>, C<d_endgrent_r>, C<d_endhent>, C<d_endhostent_r>,
+C<d_endnent>, C<d_endnetent_r>, C<d_endpent>, C<d_endprotoent_r>,
+C<d_endpwent>, C<d_endpwent_r>, C<d_endsent>, C<d_endservent_r>,
+C<d_eofnblk>, C<d_eunice>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>,
+C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>,
+C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>,
+C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>,
+C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>,
+C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>,
+C<d_fsync>, C<d_ftello>, C<d_ftime>, C<d_Gconvert>, C<d_getcwd>,
+C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>, C<d_getgrent_r>,
+C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>, C<d_gethbyaddr>,
+C<d_gethbyname>, C<d_gethent>, C<d_gethname>, C<d_gethostbyaddr_r>,
+C<d_gethostbyname_r>, C<d_gethostent_r>, C<d_gethostprotos>,
+C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>, C<d_getmnt>,
+C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>, C<d_getnent>,
+C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>,
+C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>,
+C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>,
+C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>,
+C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>,
+C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>,
+C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>,
+C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>,
+C<d_gettimeod>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
+C<d_htonl>, C<d_index>, C<d_inetaton>, C<d_int64_t>, C<d_isascii>,
+C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>, C<d_killpg>,
+C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>, C<d_locconv>,
+C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, C<d_lstat>,
+C<d_madvise>, C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>,
+C<d_memcmp>, C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>,
+C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>,
+C<d_mmap>, C<d_modfl>, C<d_modfl_pow32_bug>, C<d_mprotect>, C<d_msg>,
+C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>,
+C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>,
+C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>,
+C<d_nl_langinfo>, C<d_nv_preserves_uv>, C<d_off64_t>,
+C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
+C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>,
+C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>,
+C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>,
+C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>,
+C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>, C<d_pthread_atfork>,
+C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>, C<d_pwclass>,
+C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>, C<d_pwquota>,
+C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>, C<d_readdir>,
+C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>, C<d_rename>,
+C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, C<d_sanemcmp>,
+C<d_sbrkproto>, C<d_sched_yield>, C<d_scm_rights>, C<d_SCNfldbl>,
+C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>, C<d_semctl_semid_ds>,
+C<d_semctl_semun>, C<d_semget>, C<d_semop>, C<d_sendmsg>, C<d_setegid>,
+C<d_seteuid>, C<d_setgrent>, C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>,
+C<d_sethostent_r>, C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>,
+C<d_setlocale_r>, C<d_setnent>, C<d_setnetent_r>, C<d_setpent>,
+C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>, C<d_setprior>,
+C<d_setproctitle>, C<d_setprotoent_r>, C<d_setpwent>, C<d_setpwent_r>,
+C<d_setregid>, C<d_setresgid>, C<d_setresuid>, C<d_setreuid>, C<d_setrgid>,
+C<d_setruid>, C<d_setsent>, C<d_setservent_r>, 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_sigprocmask>, C<d_sigsetjmp>,
+C<d_sockatmark>, C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>,
+C<d_sockpair>, C<d_socks5_init>, C<d_sqrtl>, C<d_srand48_r>,
+C<d_srandom_r>, C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>,
+C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>,
+C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>,
+C<d_stdio_ptr_lval_sets_cnt>, C<d_stdio_stream_array>, C<d_stdiobase>,
+C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>,
+C<d_strerror>, C<d_strerror_r>, C<d_strftime>, C<d_strtod>, C<d_strtol>,
+C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>,
+C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>,
+C<d_syscallproto>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>,
+C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
+C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tm_tm_gmtoff>,
+C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, C<d_ttyname_r>, C<d_tzname>,
+C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>,
+C<d_unordered>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>,
+C<d_vendorbin>, C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>,
+C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
+C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
+C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
+C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
+C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
-=item SEE ALSO
+=item e
-=back
+C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
+C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
+C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
+C<expr>, C<extensions>, C<extras>
-=head2 CGI::Cookie - Interface to Netscape Cookies
+=item f
-=over 4
+C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
+C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
+C<full_sed>
-=item SYNOPSIS
+=item g
-=item DESCRIPTION
+C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>, C<getgrgid_r_proto>,
+C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>, C<gethostbyname_r_proto>,
+C<gethostent_r_proto>, C<getlogin_r_proto>, C<getnetbyaddr_r_proto>,
+C<getnetbyname_r_proto>, C<getnetent_r_proto>, C<getprotobyname_r_proto>,
+C<getprotobynumber_r_proto>, C<getprotoent_r_proto>, C<getpwent_r_proto>,
+C<getpwnam_r_proto>, C<getpwuid_r_proto>, C<getservbyname_r_proto>,
+C<getservbyport_r_proto>, C<getservent_r_proto>, C<getspnam_r_proto>,
+C<gidformat>, C<gidsign>, C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>,
+C<gmtime_r_proto>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
-=item USING CGI::Cookie
+=item h
-B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
+C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>
-=over 4
+=item i
-=item Creating New Cookies
+C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
+C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
+C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
+C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
+C<i_langinfo>, 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<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
-=item Sending the Cookie to the Browser
+=item k
-=item Recovering Previous Cookies
+C<known_extensions>, C<ksh>
-=item Manipulating Cookies
+=item l
-B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
+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<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
+C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
+C<lseektype>
-=back
+=item m
-=item AUTHOR INFORMATION
+C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
+C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
+C<man3direxp>, C<man3ext>
-=item BUGS
+=item M
-=item SEE ALSO
+C<Mcc>, C<mips_type>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>,
+C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname>
-=back
+=item n
-=head2 CGI::Fast - CGI Interface for Fast CGI
+C<n>, C<need_va_copy>, 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<nv_preserves_uv_bits>, C<nveformat>,
+C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
+C<nvsize>, C<nvtype>
-=over 4
+=item o
-=item SYNOPSIS
+C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
+C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
+
+=item p
-=item DESCRIPTION
+C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
+C<perl>, C<perl_patchlevel>
-=item OTHER PIECES OF THE PUZZLE
+=item P
-=item WRITING FASTCGI PERL SCRIPTS
+C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
+C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
+C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
+C<privlibexp>, C<procselfexe>, C<prototype>, C<ptrsize>
-=item INSTALLING FASTCGI SCRIPTS
+=item q
-=item USING FASTCGI SCRIPTS AS CGI SCRIPTS
+C<quadkind>, C<quadtype>
-=item EXTERNAL FASTCGI SERVER INVOCATION
+=item r
-FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
+C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
+C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
+C<rmail>, C<run>, C<runnm>
-=item CAVEATS
+=item s
-=item AUTHOR INFORMATION
+C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
+C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
+C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
+C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
+C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
+C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
+C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
+C<sitebinexp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>, C<siteprefix>,
+C<siteprefixexp>, C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>,
+C<sockethdr>, C<socketlib>, C<socksizetype>, C<sort>, C<spackage>,
+C<spitshell>, C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>,
+C<sPRIFUldbl>, C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>,
+C<sPRIu64>, C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>,
+C<srandom_r_proto>, C<src>, C<sSCNfldbl>, C<ssizetype>, C<startperl>,
+C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>, C<stdio_bufsiz>,
+C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>, C<stdio_stream_array>,
+C<strerror_r_proto>, C<strings>, C<submit>, C<subversion>, C<sysman>
-=item BUGS
+=item t
-=item SEE ALSO
+C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
+C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
+C<ttyname_r_proto>
-=back
+=item u
-=head2 CGI::Pretty - module to produce nicely formatted HTML code
+C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
+C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
+C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
+C<use64bitint>, C<usecrosscompile>, C<usedl>, C<useithreads>,
+C<uselargefiles>, C<uselongdouble>, C<usemorebits>, C<usemultiplicity>,
+C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>, C<useposix>,
+C<usereentrant>, 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<uvXUformat>
-=over 4
+=item v
-=item SYNOPSIS
+C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
+C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorprefix>,
+C<vendorprefixexp>, C<version>, C<version_patchlevel_string>,
+C<versiononly>, C<vi>, C<voidflags>
-=item DESCRIPTION
+=item x
-=over 4
+C<xlibpth>, C<xs_apiversion>
-=item Tags that won't be formatted
+=item y
-=item Customizing the Indenting
+C<yacc>, C<yaccflags>
-=back
+=item z
-=item BUGS
+C<zcat>, C<zip>
-=item AUTHOR
+=back
-=item SEE ALSO
+=item NOTE
=back
-=head2 CGI::Push - Simple Interface to Server Push
+=head2 Cwd - get pathname of current working directory
=over 4
=item DESCRIPTION
-=item USING CGI::Push
-
--next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
-
=over 4
-=item Heterogeneous Pages
+=item getcwd and friends
-=item Changing the Page Delay on the Fly
+getcwd, cwd, fastcwd, fastgetcwd
-=back
+=item abs_path and friends
-=item INSTALLING CGI::Push SCRIPTS
+abs_path, realpath, fast_abs_path
-=item AUTHOR INFORMATION
+=item $ENV{PWD}
-=item BUGS
+=back
+
+=item NOTES
=item SEE ALSO
=back
-=head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
+=head2 DB - programmatic interface to the Perl debugging API (draft,
+subject to
+change)
=over 4
=item SYNOPSIS
-=item ABSTRACT
-
=item DESCRIPTION
-=item AUTHOR INFORMATION
+=over 4
-=item BUGS
+=item Global Variables
-=item SEE ALSO
+ $DB::sub, %DB::sub, $DB::single, $DB::signal, $DB::trace, @DB::args,
+@DB::dbline, %DB::dbline, $DB::package, $DB::filename, $DB::subname,
+$DB::lineno
-=back
+=item API Methods
-=head2 CGI::Util - Internal utilities used by CGI module
+CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
+CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
-=over 4
+=item Client Callback Methods
-=item SYNOPSIS
+CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
+CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
+CLIENT->output(LIST)
-=item DESCRIPTION
+=back
-=item AUTHOR INFORMATION
+=item BUGS
-=item SEE ALSO
+=item AUTHOR
=back
-=head2 CPAN - query, download and build perl modules from CPAN sites
+=head2 DB_File - Perl5 access to Berkeley DB version 1.x
=over 4
=item DESCRIPTION
-=over 4
-
-=item Interactive Mode
-
-Searching for authors, bundles, distribution files and modules, make, test,
-install, clean modules or distributions, get, readme, look module or
-distribution, ls author, Signals
-
-=item CPAN::Shell
-
-=item autobundle
-
-=item recompile
-
-=item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
-
-=item Programmer's interface
-
-expand($type,@things), expandany(@things), Programming Examples
-
-=item Methods in the other Classes
-
-CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
-CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
-CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
-CPAN::Bundle::clean(), CPAN::Bundle::contains(),
-CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
-CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
-CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
-CPAN::Bundle::readme(), CPAN::Bundle::test(),
-CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
-CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
-CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
-CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
-CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
-CPAN::Distribution::look(), CPAN::Distribution::make(),
-CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
-CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
-CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
-CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
-CPAN::Module::clean(), CPAN::Module::cpan_file(),
-CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
-CPAN::Module::description(), CPAN::Module::force($method,@args),
-CPAN::Module::get(), CPAN::Module::inst_file(),
-CPAN::Module::inst_version(), CPAN::Module::install(),
-CPAN::Module::look(), CPAN::Module::make(),
-CPAN::Module::manpage_headline(), CPAN::Module::readme(),
-CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
+B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
-=item Cache Manager
+=over 4
-=item Bundles
+=item Using DB_File with Berkeley DB version 2 or greater
-=item Prerequisites
+=item Interface to Berkeley DB
-=item Finding packages and VERSION
+=item Opening a Berkeley DB Database File
-=item Debugging
+=item Default Parameters
-=item Floppy, Zip, Offline Mode
+=item In Memory Databases
=back
-=item CONFIGURATION
-
-C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
-E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
-optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
-[unshift|push|splice] E<lt>listE<gt>>
+=item DB_HASH
=over 4
-=item Note on urllist parameter's format
-
-=item urllist parameter has CD-ROM support
+=item A Simple Example
=back
-=item SECURITY
+=item DB_BTREE
-=item EXPORT
+=over 4
-=item POPULATE AN INSTALLATION WITH LOTS OF MODULES
+=item Changing the BTREE sort order
-=item WORKING WITH CPAN.pm BEHIND FIREWALLS
+=item Handling Duplicate Keys
-=over 4
+=item The get_dup() Method
-=item Three basic types of firewalls
+=item The find_dup() Method
-http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
+=item The del_dup() Method
-=item Configuring lynx or ncftp for going through a firewall
+=item Matching Partial Keys
=back
-=item FAQ
-
-1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
+=item DB_RECNO
-=item BUGS
+=over 4
-=item AUTHOR
+=item The 'bval' Option
-=item TRANSLATIONS
+=item A Simple Example
-=item SEE ALSO
+=item Extra RECNO Methods
-=back
+B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
+B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
+length, elements);>
-=head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
+=item Another Example
-=over 4
+=back
-=item SYNOPSIS
+=item THE API INTERFACE
-=item DESCRIPTION
+B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
+$X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
+$flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
+$value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
-=back
+=item DBM FILTERS
-=head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
-module
+B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
+B<filter_fetch_value>
=over 4
-=item SYNOPSIS
+=item The Filter
-=item DESCRIPTION
+=item An Example -- the NULL termination problem.
-=item SEE ALSO
+=item Another Example -- Key is a C int.
=back
-=head2 Carp, carp - warn of errors (from perspective of caller)
+=item HINTS AND TIPS
=over 4
-=item SYNOPSIS
+=item Locking: The Trouble with fd
-=item DESCRIPTION
+=item Safe ways to lock a database
-=over 4
+B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
-=item Forcing a Stack Trace
+=item Sharing Databases With C Applications
+
+=item The untie() Gotcha
=back
-=item BUGS
+=item COMMON QUESTIONS
+
+=over 4
-=back
+=item Why is there Perl source in my database?
-=head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
+=item How do I store complex data structures with DB_File?
-=head2 Class::ISA -- report the search path for a class's ISA tree
+=item What does "Invalid Argument" mean?
-=over 4
+=item What does "Bareword 'DB_File' not allowed" mean?
-=item SYNOPSIS
+=back
-=item DESCRIPTION
+=item REFERENCES
-=item FUNCTIONS
+=item HISTORY
-the function Class::ISA::super_path($CLASS), the function
-Class::ISA::self_and_super_path($CLASS), the function
-Class::ISA::self_and_super_versions($CLASS)
+=item BUGS
-=item CAUTIONARY NOTES
+=item AVAILABILITY
=item COPYRIGHT
+=item SEE ALSO
+
=item AUTHOR
=back
-=head2 Class::Struct - declare struct-like datatypes as Perl classes
+=head2 Data::Dumper - stringified perl data structures, suitable for both
+printing and C<eval>
=over 4
=over 4
-=item The C<struct()> function
+=item Methods
-=item Class Creation at Compile Time
+I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump I<or>
+I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
+I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
+I<$OBJ>->Reset
-=item Element Types and Accessor Methods
+=item Functions
-Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
-C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
+Dumper(I<LIST>)
-=item Initializing with C<new>
+=item Configuration Variables or Methods
+
+$Data::Dumper::Indent I<or> I<$OBJ>->Indent(I<[NEWVAL]>),
+$Data::Dumper::Purity I<or> I<$OBJ>->Purity(I<[NEWVAL]>),
+$Data::Dumper::Pad I<or> I<$OBJ>->Pad(I<[NEWVAL]>),
+$Data::Dumper::Varname I<or> I<$OBJ>->Varname(I<[NEWVAL]>),
+$Data::Dumper::Useqq I<or> I<$OBJ>->Useqq(I<[NEWVAL]>),
+$Data::Dumper::Terse I<or> I<$OBJ>->Terse(I<[NEWVAL]>),
+$Data::Dumper::Freezer I<or> $I<OBJ>->Freezer(I<[NEWVAL]>),
+$Data::Dumper::Toaster I<or> $I<OBJ>->Toaster(I<[NEWVAL]>),
+$Data::Dumper::Deepcopy I<or> $I<OBJ>->Deepcopy(I<[NEWVAL]>),
+$Data::Dumper::Quotekeys I<or> $I<OBJ>->Quotekeys(I<[NEWVAL]>),
+$Data::Dumper::Bless I<or> $I<OBJ>->Bless(I<[NEWVAL]>),
+$Data::Dumper::Maxdepth I<or> $I<OBJ>->Maxdepth(I<[NEWVAL]>),
+$Data::Dumper::Useperl I<or> $I<OBJ>->Useperl(I<[NEWVAL]>),
+$Data::Dumper::Sortkeys I<or> $I<OBJ>->Sortkeys(I<[NEWVAL]>),
+$Data::Dumper::Deparse I<or> $I<OBJ>->Deparse(I<[NEWVAL]>)
+
+=item Exports
+
+Dumper
=back
=item EXAMPLES
-Example 1, Example 2, Example 3
+=item BUGS
-=item Author and Modification History
+=item AUTHOR
+
+=item VERSION
+
+=item SEE ALSO
=back
-=head2 Config - access Perl configuration information
+=head2 Devel::DProf - a Perl code profiler
=over 4
=item DESCRIPTION
-myconfig(), config_sh(), config_vars(@names)
-
-=item EXAMPLE
-
-=item WARNING
-
-=item GLOSSARY
-
-=over 4
-
-=item _
+=item PROFILE FORMAT
-C<_a>, C<_exe>, C<_o>
+=item AUTOLOAD
-=item a
+=item ENVIRONMENT
-C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
-C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
-C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
-C<awk>
+=item BUGS
-=item b
+=item SEE ALSO
-C<baserev>, C<bash>, C<bin>, C<bincompat5005>, C<binexp>, C<bison>,
-C<byacc>, C<byteorder>
+=back
-=item c
+=head2 Devel::PPPort, Perl/Pollution/Portability
-C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
-C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
-C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
-C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
-C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
-C<cpprun>, C<cppstdin>, C<cppsymbols>, C<cryptlib>, C<csh>
+=over 4
-=item d
+=item SYNOPSIS
-C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>,
-C<d_atolf>, C<d_atoll>, C<d_attribut>, C<d_bcmp>, C<d_bcopy>,
-C<d_bincompat5005>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>,
-C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>,
-C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>,
-C<d_crypt>, C<d_csh>, C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>,
-C<d_difftime>, C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>,
-C<d_dosuid>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>,
-C<d_endhent>, C<d_endnent>, C<d_endpent>, C<d_endpwent>, C<d_endsent>,
-C<d_eofnblk>, C<d_eunice>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>,
-C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>,
-C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>,
-C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>,
-C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>,
-C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>,
-C<d_fsync>, C<d_ftello>, C<d_ftime>, C<d_Gconvert>, C<d_getcwd>,
-C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>, C<d_getgrps>,
-C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
-C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getmnt>,
-C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>, C<d_getnent>,
-C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>,
-C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>,
-C<d_getprior>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>,
-C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>, C<d_getservprotos>,
-C<d_getspnam>, C<d_gettimeod>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
-C<d_htonl>, C<d_index>, C<d_inetaton>, C<d_int64_t>, C<d_isascii>,
-C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>, C<d_killpg>,
-C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_locconv>, C<d_lockf>,
-C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, C<d_lstat>, C<d_madvise>,
-C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>,
-C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkdtemp>,
-C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, C<d_mmap>,
-C<d_modfl>, C<d_modfl_pow32_bug>, C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>,
-C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, C<d_msg_proxy>,
-C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>, C<d_msgsnd>,
-C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>, C<d_nl_langinfo>,
-C<d_nv_preserves_uv>, C<d_nv_preserves_uv_bits>, C<d_off64_t>,
-C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
-C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>,
-C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>,
-C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>,
-C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>,
-C<d_PRIx64>, C<d_PRIXU64>, C<d_pthread_atfork>, C<d_pthread_yield>,
-C<d_pwage>, C<d_pwchange>, C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>,
-C<d_pwgecos>, C<d_pwpasswd>, C<d_pwquota>, C<d_qgcvt>, C<d_quad>,
-C<d_readdir>, C<d_readlink>, C<d_readv>, C<d_recvmsg>, C<d_rename>,
-C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, C<d_sanemcmp>,
-C<d_sbrkproto>, C<d_sched_yield>, C<d_scm_rights>, C<d_SCNfldbl>,
-C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>, C<d_semctl_semid_ds>,
-C<d_semctl_semun>, C<d_semget>, C<d_semop>, C<d_sendmsg>, C<d_setegid>,
-C<d_seteuid>, C<d_setgrent>, C<d_setgrps>, C<d_sethent>, C<d_setitimer>,
-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_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_sigprocmask>,
-C<d_sigsetjmp>, C<d_sockatmark>, C<d_sockatmarkproto>, C<d_socket>,
-C<d_socklen_t>, C<d_sockpair>, C<d_socks5_init>, C<d_sqrtl>,
-C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>, C<d_statfs_f_flags>,
-C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>,
-C<d_stdio_ptr_lval_nochange_cnt>, C<d_stdio_ptr_lval_sets_cnt>,
-C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>,
-C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>, C<d_strftime>,
-C<d_strtod>, C<d_strtol>, C<d_strtold>, C<d_strtoll>, C<d_strtoq>,
-C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>,
-C<d_symlink>, C<d_syscall>, C<d_syscallproto>, C<d_sysconf>,
-C<d_sysernlst>, C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>,
-C<d_tcsetpgrp>, C<d_telldir>, C<d_telldirproto>, C<d_time>, C<d_times>,
-C<d_truncate>, C<d_tzname>, C<d_u32align>, C<d_ualarm>, C<d_umask>,
-C<d_uname>, C<d_union_semun>, C<d_unordered>, C<d_usleep>,
-C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>, C<d_vendorbin>,
-C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>,
-C<d_volatile>, C<d_vprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>,
-C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>, C<db_hashtype>,
-C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
-C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
-C<doublesize>, C<drand01>, C<dynamic_ext>
+=item DESCRIPTION
-=item e
+=over 4
-C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<eunicefix>,
-C<exe_ext>, C<expr>, C<extensions>, C<extras>
+=item WriteFile
-=item f
+=back
-C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
-C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
-C<full_sed>
+=item ppport.h
-=item g
+=item AUTHOR
-C<gccosandvers>, C<gccversion>, C<gidformat>, C<gidsign>, C<gidsize>,
-C<gidtype>, C<glibpth>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
+=item SEE ALSO
-=item h
+=back
-C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>
+=head2 Devel::Peek - A data debugging tool for the XS programmer
-=item i
+=over 4
-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_fp>,
-C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
-C<i_langinfo>, 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<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
+=item SYNOPSIS
-=item k
+=item DESCRIPTION
-C<known_extensions>, C<ksh>
+=over 4
-=item l
+=item Runtime debugging
-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 Memory footprint debugging
-=item m
+=back
-C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
-C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
-C<man3direxp>, C<man3ext>
+=item EXAMPLES
-=item M
+=over 4
-C<Mcc>, C<mips_type>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>,
-C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname>
+=item A simple scalar string
-=item n
+=item A simple scalar number
-C<n>, C<need_va_copy>, 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<nveformat>, C<nvEUformat>, C<nvfformat>,
-C<nvFUformat>, C<nvgformat>, C<nvGUformat>, C<nvsize>, C<nvtype>
+=item A simple scalar with an extra reference
-=item o
+=item A reference to a simple scalar
-C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
-C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
+=item A reference to an array
-=item p
+=item A reference to a hash
-C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
-C<perl>, C<perl_patchlevel>
+=item Dumping a large array or hash
-=item P
+=item A reference to an SV which holds a C pointer
-C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
-C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
-C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
-C<privlibexp>, C<prototype>, C<ptrsize>
+=item A reference to a subroutine
-=item q
+=back
-C<quadkind>, C<quadtype>
+=item EXPORTS
-=item r
+=item BUGS
-C<randbits>, C<randfunc>, C<randseedtype>, C<ranlib>, C<rd_nodata>,
-C<revision>, C<rm>, C<rmail>, C<run>, C<runnm>
+=item AUTHOR
-=item s
+=item SEE ALSO
-C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
-C<selectminbits>, C<selecttype>, C<sendmail>, C<sh>, C<shar>, C<sharpbang>,
-C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>, C<sig_count>,
-C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>, C<sig_size>,
-C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>, C<sitebinexp>,
-C<sitelib>, C<sitelib_stem>, C<sitelibexp>, C<siteprefix>,
-C<siteprefixexp>, C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>,
-C<sockethdr>, C<socketlib>, C<socksizetype>, C<sort>, C<spackage>,
-C<spitshell>, C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>,
-C<sPRIFUldbl>, C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>,
-C<sPRIu64>, C<sPRIx64>, C<sPRIXU64>, C<src>, C<sSCNfldbl>, C<ssizetype>,
-C<startperl>, C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>,
-C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>,
-C<stdio_stream_array>, C<strings>, C<submit>, C<subversion>, C<sysman>
+=back
-=item t
+=head2 Devel::SelfStubber - generate stubs for a SelfLoading module
-C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
-C<timetype>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>
+=over 4
-=item u
+=item SYNOPSIS
-C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
-C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
-C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
-C<use64bitint>, C<usecrosscompile>, C<usedl>, C<useithreads>,
-C<uselargefiles>, C<uselongdouble>, C<usemorebits>, C<usemultiplicity>,
-C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>, C<useposix>,
-C<usereentrant>, 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<uvXUformat>
+=item DESCRIPTION
-=item v
+=back
-C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
-C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorprefix>,
-C<vendorprefixexp>, C<version>, C<version_patchlevel_string>,
-C<versiononly>, C<vi>, C<voidflags>
+=head2 Digest:: - Modules that calculate message digests
-=item x
+=over 4
-C<xlibpth>, C<xs_apiversion>
+=item SYNOPSIS
-=item y
+=item DESCRIPTION
-C<yacc>, C<yaccflags>
+I<binary>, I<hex>, I<base64>
-=item z
+=item OO INTERFACE
-C<zcat>, C<zip>
+$ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
+Digest::XXX->new($arg,...), $ctx->reset, $ctx->add($data,...),
+$ctx->addfile($io_handle), $ctx->digest, $ctx->hexdigest, $ctx->b64digest
-=back
+=item SEE ALSO
-=item NOTE
+=item AUTHOR
=back
-=head2 Cwd - get pathname of current working directory
+=head2 Digest::MD5 - Perl interface to the MD5 Algorithm
=over 4
=item DESCRIPTION
-=over 4
+=item FUNCTIONS
-=item getcwd and friends
+md5($data,...), md5_hex($data,...), md5_base64($data,...)
-getcwd, cwd, fastcwd, fastgetcwd
+=item METHODS
-=item abs_path and friends
+$md5 = Digest::MD5->new, $md5->reset, $md5->add($data,...),
+$md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
-abs_path, realpath, fast_abs_path
+=item EXAMPLES
-=item $ENV{PWD}
+=item SEE ALSO
+
+=item COPYRIGHT
+
+=item AUTHORS
=back
-=item NOTES
+=head2 DirHandle - supply object methods for directory handles
-=item SEE ALSO
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item NOTES
=back
-=head2 DB - programmatic interface to the Perl debugging API (draft,
-subject to
-change)
+=head2 Dumpvalue - provides screen dump of Perl data.
=over 4
=over 4
-=item Global Variables
-
- $DB::sub, %DB::sub, $DB::single, $DB::signal, $DB::trace, @DB::args,
-@DB::dbline, %DB::dbline, $DB::package, $DB::filename, $DB::subname,
-$DB::lineno
+=item Creation
-=item API Methods
+C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
+C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
+C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
+stopDbSignal
-CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
-CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
+=item Methods
-=item Client Callback Methods
+dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
+compactDump, veryCompact, set, get
-CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
-CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
-CLIENT->output(LIST)
+=back
=back
-=item BUGS
+=head2 DynaLoader - Dynamically load C libraries into Perl code
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+@dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
+@dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
+dl_load_file(), dl_unload_file(), dl_loadflags(), dl_find_symbol(),
+dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
+bootstrap()
=item AUTHOR
=back
-=head2 DB_File - Perl5 access to Berkeley DB version 1.x
+=head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
+Perl code
=over 4
=item DESCRIPTION
-B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
+=item AUTHOR
-=over 4
+=back
-=item Using DB_File with Berkeley DB version 2 or 3
+=head2 Encode - character encodings
-=item Interface to Berkeley DB
+=over 4
-=item Opening a Berkeley DB Database File
+=item SYNOPSIS
-=item Default Parameters
+=over 4
-=item In Memory Databases
+=item Table of Contents
=back
-=item DB_HASH
+=item DESCRIPTION
=over 4
-=item A Simple Example
+=item TERMINOLOGY
=back
-=item DB_BTREE
-
-=over 4
+=item PERL ENCODING API
-=item Changing the BTREE sort order
+$bytes = encode(ENCODING, $string[, CHECK]), $string = decode(ENCODING,
+$bytes[, CHECK]), [$length =] from_to($string, FROM_ENCODING, TO_ENCODING[,
+CHECK])
-=item Handling Duplicate Keys
+=over 4
-=item The get_dup() Method
+=item Listing available encodings
-=item The find_dup() Method
+=item Defining Aliases
-=item The del_dup() Method
+=back
-=item Matching Partial Keys
+=item Encoding and IO
-=back
+=item Handling Malformed Data
-=item DB_RECNO
+Scheme 1, Scheme 2, Other Schemes
=over 4
-=item The 'bval' Option
+=item UTF-8 / utf8
-=item A Simple Example
+$bytes = encode_utf8($string);, $string = decode_utf8($bytes [, CHECK]);
-=item Extra RECNO Methods
+=back
-B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
-B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
-length, elements);>
+=item Defining Encodings
-=item Another Example
+=item Messing with Perl's Internals
-=back
+is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
-=item THE API INTERFACE
+=item SEE ALSO
-B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
-$X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
-$flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
-$value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
+=back
-=item DBM FILTERS
+=head2 Encode::10646_1, Encode::10656_1 -- for internal use only
-B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
-B<filter_fetch_value>
+=head2 Encode::Alias - alias defintions to encodings
=over 4
-=item The Filter
-
-=item An Example -- the NULL termination problem.
-
-=item Another Example -- Key is a C int.
+=item SYNOPSIS
-=back
+=item DESCRIPTION
-=item HINTS AND TIPS
+As a simple string, As a qr// compiled regular expression, e.g.:, As a code
+reference, e.g.:
=over 4
-=item Locking: The Trouble with fd
-
-=item Safe ways to lock a database
-
-B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
+=item Alias overloading
-=item Sharing Databases With C Applications
+=back
-=item The untie() Gotcha
+=item SEE ALSO
=back
-=item COMMON QUESTIONS
+=head2 Encode::Byte - Single Byte Encodings
=over 4
-=item Why is there Perl source in my database?
+=item SYNOPSIS
-=item How do I store complex data structures with DB_File?
+=item ABSTRACT
-=item What does "Invalid Argument" mean?
+=item DESCRIPTION
-=item What does "Bareword 'DB_File' not allowed" mean?
+=item SEE ALSO
=back
-=item REFERENCES
+=head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
-=item HISTORY
+=head2 Encode::CN - China-based Chinese Encodings
-=item BUGS
+=over 4
-=item AVAILABILITY
+=item SYNOPSIS
-=item COPYRIGHT
+=item DESCRIPTION
-=item SEE ALSO
+=item NOTES
-=item AUTHOR
+=item BUGS
+
+=item SEE ALSO
=back
-=head2 Data::Dumper - stringified perl data structures, suitable for both
-printing and C<eval>
+=head2 Encode::CN::HZ -- internally used by Encode::CN
+
+=head2 Encode::EBCDIC - EBCDIC Encodings
=over 4
=item SYNOPSIS
+=item ABSTRACT
+
=item DESCRIPTION
-=over 4
+=item SEE ALSO
-=item Methods
+=back
-I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump I<or>
-I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
-I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
-I<$OBJ>->Reset
+=head2 Encode::Encoding - Encode Implementation Base Class
-=item Functions
+=over 4
-Dumper(I<LIST>)
+=item SYNOPSIS
-=item Configuration Variables or Methods
+=item DESCRIPTION
-$Data::Dumper::Indent I<or> I<$OBJ>->Indent(I<[NEWVAL]>),
-$Data::Dumper::Purity I<or> I<$OBJ>->Purity(I<[NEWVAL]>),
-$Data::Dumper::Pad I<or> I<$OBJ>->Pad(I<[NEWVAL]>),
-$Data::Dumper::Varname I<or> I<$OBJ>->Varname(I<[NEWVAL]>),
-$Data::Dumper::Useqq I<or> I<$OBJ>->Useqq(I<[NEWVAL]>),
-$Data::Dumper::Terse I<or> I<$OBJ>->Terse(I<[NEWVAL]>),
-$Data::Dumper::Freezer I<or> $I<OBJ>->Freezer(I<[NEWVAL]>),
-$Data::Dumper::Toaster I<or> $I<OBJ>->Toaster(I<[NEWVAL]>),
-$Data::Dumper::Deepcopy I<or> $I<OBJ>->Deepcopy(I<[NEWVAL]>),
-$Data::Dumper::Quotekeys I<or> $I<OBJ>->Quotekeys(I<[NEWVAL]>),
-$Data::Dumper::Bless I<or> $I<OBJ>->Bless(I<[NEWVAL]>),
-$Data::Dumper::Maxdepth I<or> $I<OBJ>->Maxdepth(I<[NEWVAL]>),
-$Data::Dumper::Useperl I<or> $I<OBJ>->Useperl(I<[NEWVAL]>),
-$Data::Dumper::Sortkeys I<or> $I<OBJ>->Sortkeys(I<[NEWVAL]>)
+-E<gt>name, -E<gt>new_sequence, -E<gt>encode($string,$check),
+-E<gt>decode($octets,$check)
-=item Exports
+=over 4
-Dumper
+=item Compiled Encodings
=back
-=item EXAMPLES
-
-=item BUGS
-
-=item AUTHOR
-
-=item VERSION
-
=item SEE ALSO
=back
-=head2 Devel::DProf - a Perl code profiler
+=head2 Encode::Internal -- for internal use only
+
+=head2 Encode::JP - Japanese Encodings
=over 4
=item SYNOPSIS
-=item DESCRIPTION
-
-=item PROFILE FORMAT
+=item ABSTRACT
-=item AUTOLOAD
+=item DESCRIPTION
-=item ENVIRONMENT
+=item Note on ISO-2022-JP(-1)?
=item BUGS
=back
-=head2 Devel::Peek - A data debugging tool for the XS programmer
+=head2 Encode::JP::2022_JP -- internally used by Encode::JP
-=over 4
+=head2 Encode::JP::2022_JP1 -- internally used by Encode::JP
-=item SYNOPSIS
+=head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
+
+=head2 Encode::JP::JIS -- internally used by Encode::JP
+
+=head2 Encode::Supported -- Supported encodings by Encode
+
+=over 4
=item DESCRIPTION
=over 4
-=item Memory footprint debugging
+=item Encoding Names
=back
-=item EXAMPLES
+=item Supported Encodings
=over 4
-=item A simple scalar string
-
-=item A simple scalar number
-
-=item A simple scalar with an extra reference
+=item Built-in Encodings
-=item A reference to a simple scalar
+=item Encode::Byte -- Extended ASCII
-=item A reference to an array
+ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
+Cyrillic world
-=item A reference to a hash
+=item The CJK: Chinese, Japanese, Korean (Multibyte)
-=item Dumping a large array or hash
+Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
+Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN
-=item A reference to an SV which holds a C pointer
+=item Miscellaneous encodings
-=item A reference to a subroutine
+Encode::EBCDIC, Encode::Symbols
=back
-=item EXPORTS
-
-=item BUGS
-
-=item AUTHOR
+=item Unsupported encodings
-=item SEE ALSO
+ ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], various UP-UX
+encodings, Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], Thai
+encoding TCVN, Vietnamese encodings VPS, various Mac encodings, (Mac) Indic
+encodings
-=back
+=item Encoding vs. Charset -- terminology
-=head2 Devel::SelfStubber - generate stubs for a SelfLoading module
+=item Encoding Classification (by Anton Tagunov and Dan Kogai)
=over 4
-=item SYNOPSIS
+=item Microsoft-related naming mess
-=item DESCRIPTION
+KS_C_5601-1987, GB2312, Big5, Shift_JIS
=back
-=head2 Digest:: - Modules that calculate message digests
+=item Glossary
-=over 4
+character repertoire, coded character set (CCS), character encoding scheme
+(CES), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF, UTF-16
-=item SYNOPSIS
+=item See Also
-=item DESCRIPTION
+=item References
-I<binary>, I<hex>, I<base64>
+ECMA, EMCA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
+RFC, UC, Unicode Glossary
-=item OO INTERFACE
+=over 4
-$ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
-Digest::XXX->new($arg,...), $ctx->reset, $ctx->add($data,...),
-$ctx->addfile($io_handle), $ctx->digest, $ctx->hexdigest, $ctx->b64digest
+=item Other Notable Sites
-=item SEE ALSO
+czyborra.com, CJK.inf
-=item AUTHOR
+=back
=back
-=head2 Digest::MD5 - Perl interface to the MD5 Algorithm
+=head2 Encode::Symbol - Symbol Encodings
=over 4
=item SYNOPSIS
-=item DESCRIPTION
-
-=item FUNCTIONS
-
-md5($data,...), md5_hex($data,...), md5_base64($data,...)
-
-=item METHODS
-
-$md5 = Digest::MD5->new, $md5->reset, $md5->add($data,...),
-$md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
+=item ABSTRACT
-=item EXAMPLES
+=item DESCRIPTION
=item SEE ALSO
-=item COPYRIGHT
-
-=item AUTHORS
-
=back
-=head2 DirHandle - supply object methods for directory handles
+=head2 Encode::TW - Taiwan-based Chinese Encodings
=over 4
=item NOTES
+=item BUGS
+
+=item SEE ALSO
+
=back
-=head2 Dumpvalue - provides screen dump of Perl data.
+=head2 Encode::Unicode -- for internal use only
+
+=head2 Encode::XS -- for internal use only
+
+=head2 Encode::lib::Encode::10646_1, Encode::10656_1 -- for internal use
+only
+
+=head2 Encode::lib::Encode::Alias, Encode::Alias - alias defintions to
+encodings
=over 4
=item DESCRIPTION
-=over 4
+As a simple string, As a qr// compiled regular expression, e.g.:, As a code
+reference, e.g.:
-=item Creation
+=over 4
-C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
-C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
-C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
-stopDbSignal
+=item Alias overloading
-=item Methods
+=back
-dumpValue, dumpValues, dumpvars, set_quote, set_unctrl, compactDump,
-veryCompact, set, get
+=item SEE ALSO
=back
-=back
+=head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm --
+Internally used by Encode::??::ISO_2022_*
-=head2 DynaLoader - Dynamically load C libraries into Perl code
+=head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
+Encode::CN
+
+=head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
+Implementation Base Class
=over 4
=item DESCRIPTION
-@dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
-@dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
-dl_load_file(), dl_unload_file(), dl_loadflags(), dl_find_symbol(),
-dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
-bootstrap()
+-E<gt>name, -E<gt>new_sequence, -E<gt>encode($string,$check),
+-E<gt>decode($octets,$check)
-=item AUTHOR
+=over 4
+
+=item Compiled Encodings
=back
-=head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
-Perl code
+=item SEE ALSO
-=over 4
+=back
-=item SYNOPSIS
+=head2 Encode::lib::Encode::Internal, Encode::Internal -- for internal use
+only
-=item DESCRIPTION
+=head2 Encode::lib::Encode::JP::2022_JP, Encode::JP::2022_JP -- internally
+used by Encode::JP
-=item AUTHOR
+=head2 Encode::lib::Encode::JP::2022_JP1, Encode::JP::2022_JP1 --
+internally used by Encode::JP
-=back
+=head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
+Encode::JP::2022_JP*
-=head2 Encode - character encodings
+=head2 Encode::lib::Encode::JP::JIS, Encode::JP::JIS -- internally used by
+Encode::JP
-=over 4
+=head2 Encode::lib::Encode::Supported, Encode::Supported -- Supported
+encodings by Encode
-=item SYNOPSIS
+=over 4
=item DESCRIPTION
=over 4
-=item TERMINOLOGY
+=item Encoding Names
=back
-=item ENCODINGS
+=item Supported Encodings
=over 4
-=item Characteristics of an Encoding
+=item Built-in Encodings
-=item Types of Encodings
+=item Encode::Byte -- Extended ASCII
-Fixed length 8-bit (or less) encodings, Fixed length 16-bit encodings,
-Fixed length 32-bit encodings, Multi-byte encodings, "Escape" encodings
+ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
+Cyrillic world
-=item Specifying Encodings
+=item The CJK: Chinese, Japanese, Korean (Multibyte)
-1. By name, 2. As an object
+Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
+Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN
-=item Encoding Names
+=item Miscellaneous encodings
-The MIME name as defined in IETF RFC-XXXX, The name in the IANA registry,
-The name used by the the organization that defined it
+Encode::EBCDIC, Encode::Symbols
=back
-=item PERL ENCODING API
-
-=over 4
+=item Unsupported encodings
-=item Generic Encoding Interface
+ ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], various UP-UX
+encodings, Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], Thai
+encoding TCVN, Vietnamese encodings VPS, various Mac encodings, (Mac) Indic
+encodings
-=item Handling Malformed Data
+=item Encoding vs. Charset -- terminology
-Scheme 1, Scheme 2, Other Schemes
+=item Encoding Classification (by Anton Tagunov and Dan Kogai)
-=item UTF-8 / utf8
+=over 4
-=item Other Encodings of Unicode
+=item Microsoft-related naming mess
-=item Listing available encodings
+KS_C_5601-1987, GB2312, Big5, Shift_JIS
-=item Defining Aliases
+=back
-As a simple string, As a qr// compiled regular expression, e.g.:, As a code
-reference, e.g.:
+=item Glossary
-=item Defining Encodings
+character repertoire, coded character set (CCS), character encoding scheme
+(CES), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF, UTF-16
-=back
+=item See Also
-=item Encoding and IO
+=item References
-=item Encoding How to ...
+ECMA, EMCA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
+RFC, UC, Unicode Glossary
-IO with mixed content (faking iso-2020-*), MIME's Content-Length:, UTF-8
-strings in binary data, Perl/Encode wrappers on non-Unicode XS modules
+=over 4
-=item Messing with Perl's Internals
+=item Other Notable Sites
-is_utf8(STRING [, CHECK]), valid_utf8(STRING)
+czyborra.com, CJK.inf
-=item IMPLEMENTATION CLASSES
+=back
--E<gt>name, -E<gt>new_sequence, -E<gt>encode($string,$check),
--E<gt>decode($octets,$check)
+=back
-=over 4
+=head2 Encode::lib::Encode::Unicode, Encode::Unicode -- for internal use
+only
-=item Compiled Encodings
+=head2 Encode::lib::Encode::XS, Encode::XS -- for internal use only
-.enc, .ucm, .ucm, .c, .xs, ascii and iso-8859-*, IBM-1047 and two other
-variants of EBCDIC, symbol and dingbats as used by Tk on X11
+=head2 Encode::lib::Encode::ucs2_le, Encode::ucs2_le -- for internal use
+only
-=back
+=head2 Encode::lib::Encode::utf8, Encode::utf8 -- for internal use only
-=item SEE ALSO
+=head2 Encode::ucs2_le -- for internal use only
-=back
+=head2 Encode::utf8 -- for internal use only
-=head2 Encode::EncodeFormat, EncodeFormat - the format of encoding tables
-of the Encode extension
+=head2 Encodencoding, encoding - allows you to write your script in
+non-asii or non-utf8
=over 4
-=item DESCRIPTION
+=item SYNOPSIS
-[1] B<S>, [2] B<D>, [3] B<M>, [4] B<E>
+=item ABSTRACT
-=item KEYWORDS
+=item USAGE
-=item COPYRIGHT
+use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =>
+I<ENCNAME_IN> ...] ;, no encoding;
-=back
+=item CAVEATS
-=head2 Encode::Tcl - Tcl encodings
+=over 4
-=head2 EncodeFormat - the format of encoding tables of the Encode extension
+=item NOT SCOPED
-=over 4
+=item DO NOT MIX MULTIPLE ENCODINGS
-=item DESCRIPTION
+=back
-[1] B<S>, [2] B<D>, [3] B<M>, [4] B<E>
+=item EXAMPLE - Greekperl
-=item KEYWORDS
+=item KNOWN PROBLEMS
-=item COPYRIGHT
+=item SEE ALSO
=back
=item Selecting What To Export
+=item How to Import
+
+C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
+
+=back
+
+=item Advanced features
+
+=over 4
+
=item Specialised Import Lists
-=item Exporting without using Export's import method
+=item Exporting without using Exporter's import method
=item Module Version Checking
=item Tag Handling Utility Functions
+=item Generating combined tags
+
+=item C<AUTOLOAD>ed Constants
+
=back
=back
=over 4
-=item SYNOPIS
+=item SYNOPSIS
=item DESCRIPTION
=back
+=head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+B<test_harness>
+
+=back
+
=head2 ExtUtils::Constant - generate XS code to import C header constants
=over 4
C_stringify NAME
+perl_stringify NAME
+
constant_types
memEQ_clause NAME, CHECKED_AT, INDENT
dogfood
C_constant, name, type, value, macro, default, pre, post, def_pre =item
-def_post
+def_post, utf8
XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
=item DESCRIPTION
-For static extensions, For dynamic extensions, For dynamic extensions
+For static extensions, For dynamic extensions at build/link time, For
+dynamic extensions at load time
=over 4
=back
-=head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
-ExtUtils::MakeMaker
+=head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
=over 4
=item DESCRIPTION
-canonpath, cflags, manifypods, perl_archive
+=back
+
+=head2 ExtUtils::MM_Any - Platform agnostic MM methods
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item Inherently Cross-Platform Methods
+
+=over 4
+
+=item File::Spec wrappers B<DEPRECATED>
+
+canonpath
=back
-=head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
+=back
+
+catdir
+
+catfile
+
+curdir
+
+file_name_is_absolute
+
+path
+
+rootdir
+
+updir
+
+=over 4
+
+=item Thought To Be Cross-Platform Methods
+
+test_via_harness
+
+=back
+
+test_via_script
+
+=over 4
+
+=item AUTHOR
+
+=back
+
+=head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
ExtUtils::MakeMaker
=over 4
=back
-catfile
+perl_archive
-constants (o)
+=head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
+ExtUtils::MakeMaker
-static_lib (o)
+=over 4
-dynamic_bs (o)
+=item SYNOPSIS
-dynamic_lib (o)
+=item DESCRIPTION
-canonpath
+canonpath, cflags, manifypods, perl_archive
-perl_script
+=back
-pm_to_blib
+=head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
-test_via_harness (o)
+=over 4
-tool_autosplit (override)
+=item SYNOPSIS
-tools_other (o)
+=item DESCRIPTION
-xs_o (o)
+=over 4
-top_targets (o)
+=item Overridden methods
-htmlifypods (o)
+B<replace_manpage_separator>
-manifypods (o)
+=back
-dist_ci (o)
+=back
-dist_core (o)
+=over 4
-pasthru (o)
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
+=head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
+ExtUtils::MakeMaker
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
+constants (o)
+
+dynamic_lib (o)
=head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
ExtUtils::MakeMaker
perl_archive_after
-=head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
+=head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
=over 4
=item SYNOPSIS
-=item DESCRIPTION
+=item DESCRIPTION
+
+=over 4
+
+=item Overridden methods
+
+B<replace_manpage_separator>
+
+=back
-=item METHODS
+=back
=over 4
-=item Preloaded methods
+=item AUTHOR
-canonpath
+=item SEE ALSO
=back
-=back
+=head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
-catdir
+=over 4
-catfile
+=item SYNOPSIS
-curdir
+=item DESCRIPTION
-rootdir
+=item METHODS
-updir
+=back
=over 4
dist_core (o)
-dist_dir (o)
+dist_dir
-dist_test (o)
+dist_test
dlsyms (o)
extliblist
-file_name_is_absolute
-
find_perl
=over 4
has_link_code
-htmlifypods (o)
-
init_dirscan
init_main
init_others
+init_INST
+
+init_INSTALL
+
+init_PERL
+
+init_PERM
+
install (o)
installbin (o)
nicetext
-parse_version
-
parse_abstract
-pasthru (o)
+parse_version
-path
+pasthru (o)
perl_script
perldepend (o)
-ppd
-
perm_rw (o)
perm_rwx (o)
postamble (o)
+ppd
+
prefixify
processPL (o)
+quote_paren
+
realclean (o)
replace_manpage_separator
test (o)
-test_via_harness (o)
+test_via_harness (override)
-test_via_script (o)
+test_via_script (override)
tool_autosplit (o)
=back
-rootdir (override)
-
=over 4
-=item SelfLoaded methods
+=item Methods
guess_name (override)
find_perl (override)
-path (override)
-
maybe_command (override)
maybe_command_in_dirs (override)
perl_script (override)
-file_name_is_absolute (override)
-
replace_manpage_separator
+init_main (override)
+
init_others (override)
constants (override)
realclean (override)
-dist_basics (override)
-
dist_core (override)
-dist_dir (override)
-
dist_test (override)
install (override)
test (override)
-test_via_harness (override)
-
-test_via_script (override)
-
makeaperl (override)
nicetext (override)
=back
-catfile
-
constants (o)
static_lib (o)
dynamic_lib (o)
-canonpath
-
perl_script
pm_to_blib
-test_via_harness (o)
-
tool_autosplit (override)
tools_other (o)
top_targets (o)
-htmlifypods (o)
-
manifypods (o)
dist_ci (o)
pasthru (o)
+=head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
=head2 ExtUtils::MakeMaker - create an extension Makefile
=over 4
ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT,
-EXE_FILES, FIRST_MAKEFILE, FULLPERL, FUNCLIST, H, HTMLLIBPODS,
-HTMLSCRIPTPODS, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN,
-INSTALLDIRS, INSTALLHTMLPRIVLIBDIR, INSTALLHTMLSCRIPTDIR,
-INSTALLHTMLSITELIBDIR, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
-INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITELIB, INST_ARCHLIB, INST_BIN,
-INST_EXE, INST_HTMLLIBDIR, INST_HTMLSCRIPTDIR, INST_LIB, INST_MAN1DIR,
-INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A, LIBS, LINKTYPE,
-MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME,
-NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE, PERL, PERL_CORE,
-PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERLRUN, PERM_RW,
-PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
-PPM_INSTALL_SCRIPT, PREFIX, PREREQ_PM, PREREQ_FATAL, SKIP, TEST_LIBS,
+EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN, FULLPERLRUNINST,
+FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN,
+INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, INSTALLSCRIPT,
+INSTALLSITEARCH, INSTALLSITELIB, INST_ARCHLIB, INST_BIN, INST_LIB,
+INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A, LIBS,
+LINKTYPE, MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB,
+NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE, PERL,
+PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERLRUN,
+PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX, PL_FILES, PM, PMLIBDIRS,
+PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT, PREFIX,
+PREREQ_PM, PREREQ_FATAL, PREREQ_PRINT, PRINT_PREREQ, SKIP, TYPEMAPS,
VERSION, VERSION_FROM, XS, XSOPT, XSPROTOARG, XS_VERSION
=item Additional lowercase attributes
=item Distribution Support
make distcheck, make skipcheck, make distclean, make manifest,
- make distdir, make tardist, make dist, make uutardist, make
-shdist, make zipdist, make ci
+ make distdir, make disttest, make tardist, make dist, make
+uutardist, make shdist, make zipdist, make ci
=item Disabling an extension
=item ENVIRONMENT
-PERL_MM_OPT
+PERL_MM_OPT, PERL_MM_USE_DEFAULT
=item SEE ALSO
=back
-=head2 File::Find, find - traverse a file tree
+=head2 File::Find - Traverse a directory tree.
=over 4
=item DESCRIPTION
+B<find>, B<finddepth>
+
+=over 4
+
+=item %options
+
C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
C<untaint>, C<untaint_pattern>, C<untaint_skip>
+=item The wanted function
+
+C<$File::Find::dir> is the current directory name,, C<$_> is the current
+filename within that directory, C<$File::Find::name> is the complete
+pathname to the file
+
+=back
+
+=item WARNINGS
+
=item CAVEAT
+$dont_use_nlink, symlinks
+
=item NOTES
=item HISTORY
=back
-=head2 File::Spec::Epoc - methods for Epoc file specs
+=head2 File::Spec::Cygwin - methods for Cygwin file specs
=over 4
=item DESCRIPTION
-devnull
-
=back
-tmpdir
-
-path
-
-canonpath()
+=head2 File::Spec::Epoc - methods for Epoc file specs
-splitpath
+=over 4
-splitdir
+=item SYNOPSIS
-catpath
+=item DESCRIPTION
-abs2rel
+canonpath()
-rel2abs()
+=back
=over 4
splitdir
-catpath()
+catpath
abs2rel
=back
+canonpath
+
+splitpath
+
+splitdir
+
+catpath
+
=head2 File::Spec::OS2 - methods for OS/2 file specs
=over 4
=item All-in-one interface
+=item Filtering only specific components of source code
+
+C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
+C<"all">
+
+=item Filtering only the code parts of source code
+
+Most source code ceases to be grammatically correct when it is broken up
+into the pieces between string literals and regexes. So the C<'code'>
+component filter behaves slightly differently from the other partial
+filters
+described in the previous section.
+
+=item Using Filter::Simple with an explicit C<import> subroutine
+
=item Using Filter::Simple and Exporter together
=item How it works
=item Summary of Option Specifications
-!, +, s, i, o, f, : I<type> [ I<desttype> ]
+!, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
++ [ I<desttype> ]
=back
=item The lonesome dash
-=item Argument call-back
+=item Argument callback
=back
=item GetOptions does not return a false result when an option is not
supplied
+=item GetOptions does not split the command line correctly
+
+=item How do I put a "-?" option into a Getopt::Long?
+
=back
=item AUTHOR
=back
+=head2 Hash::Util - A selection of general-utility hash subroutines
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Restricted hashes
+
+lock_keys, unlock_keys
+
+=back
+
+=back
+
+lock_value, unlock_value
+
+B<lock_hash>, B<unlock_hash>
+
+=over 4
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
=head2 I18N::Collate - compare 8-bit scalar data according to the current
locale
=back
-=head2 Lingua::KO::Hangul::Util - utility functions for Hangul Syllables
-
-=over 4
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=over 4
-
-=item Composition and Decomposition
-
-C<$string_decomposed = decomposeHangul($codepoint)>, C<@codepoints =
-decomposeHangul($codepoint)>, C<$string_composed =
-composeHangul($src_string)>, C<@codepoints_composed =
-composeHangul($src_string)>
-
-=item Hangul Syllable Name
-
-C<$name = getHangulName($codepoint)>, C<$codepoint =
-parseHangulName($name)>
-
-=item EXPORT
-
-=back
-
-=item AUTHOR
-
-=item SEE ALSO
-
-http://www.unicode.org/unicode/reports/tr15
-
-=back
-
=head2 List::Util - A selection of general-utility list subroutines
=over 4
first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
BLOCK LIST, shuffle LIST, sum LIST
+=item KNOWN BUGS
+
=item SUGGESTED ADDITIONS
=item COPYRIGHT
first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
BLOCK LIST, shuffle LIST, sum LIST
+=item KNOWN BUGS
+
=item SUGGESTED ADDITIONS
=item COPYRIGHT
=item DESCRIPTION
-blessed EXPR, dualvar NUM, STRING, isweak EXPR, readonly SCALAR, reftype
+blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype
EXPR, tainted EXPR, weaken REF
+=item KNOWN BUGS
+
=item COPYRIGHT
=item BLATANT PLUG
=item SEE ALSO
-Locale::Language, Locale::Country, Locale::Currency
+Locale::Language, Locale::Country, Locale::Script, Locale::Currency
=item AUTHOR
=item SYNOPSIS
-=back
-
-=over 4
-
=item DESCRIPTION
B<alpha-2>, B<alpha-3>, B<numeric>
-=back
-
-=over 4
-
=item CONVERSION ROUTINES
code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
country_code2code( CODE, CODESET, CODESET )
-=back
-
-=over 4
-
=item QUERY ROUTINES
C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
-=back
+=item SEMI-PRIVATE ROUTINES
=over 4
-=item CODE ALIASING
+=item alias_code
-=back
+=item rename_country
-=over 4
+=back
=item EXAMPLES
=item SEE ALSO
-Locale::Language, Locale::Currency, ISO 3166,
-http://www.din.de/gremien/nas/nabd/iso3166ma/,
+Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
+3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
http://www.cia.gov/cia/publications/factbook/docs/app-f.html
=item SYNOPSIS
-=back
-
-=over 4
-
=item DESCRIPTION
XTS, XXX
-=back
-
-=over 4
-
=item CONVERSION ROUTINES
code2currency(), currency2code()
-=back
-
-=over 4
-
=item QUERY ROUTINES
C<all_currency_codes()>, C<all_currency_names()>
-=back
-
-=over 4
-
=item EXAMPLES
=item KNOWN BUGS AND LIMITATIONS
=item SEE ALSO
-Locale::Country, ISO 4217:1995, http://www.bsi-global.com/iso4217currency
+Locale::Country, Locale::Script, ISO 4217:1995,
+http://www.bsi-global.com/iso4217currency
=item AUTHOR
=item SYNOPSIS
-=back
-
-=over 4
-
=item DESCRIPTION
-=back
-
-=over 4
-
=item CONVERSION ROUTINES
code2language(), language2code()
-=back
-
-=over 4
-
=item QUERY ROUTINES
C<all_language_codes()>, C<all_language_names()>
-=back
-
-=over 4
-
=item EXAMPLES
=item KNOWN BUGS AND LIMITATIONS
=item SEE ALSO
-Locale::Country, Locale::Currency, ISO 639:1988 (E/F),
+Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
http://lcweb.loc.gov/standards/iso639-2/langhome.html
=item AUTHOR
=item HOW TO USE MAKETEXT
-=item SEE ALSO
+=item SEE ALSO
+
+=item COPYRIGHT AND DISCLAIMER
+
+=item AUTHOR
+
+=back
+
+=head2 Locale::Maketext::TPJ13 -- article about software localization
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item Localization and Perl: gettext breaks, Maketext fixes
+
+=over 4
+
+=item A Localization Horror Story: It Could Happen To You
+
+=item The Linguistic View
+
+=item Breaking gettext
+
+=item Replacing gettext
+
+=item Buzzwords: Abstraction and Encapsulation
+
+=item Buzzword: Isomorphism
+
+=item Buzzword: Inheritance
+
+=item Buzzword: Concision
+
+=item The Devil in the Details
+
+=item The Proof in the Pudding: Localizing Web Sites
-=item COPYRIGHT AND DISCLAIMER
+=item References
-=item AUTHOR
+=back
=back
-=head2 Locale::Maketext::TPJ13 -- article about software localization
+=head2 Locale::Script - ISO codes for script identification (ISO 15924)
=over 4
=item DESCRIPTION
-=item Localization and Perl: gettext breaks, Maketext fixes
+B<alpha-2>, B<alpha-3>, B<numeric>
=over 4
-=item A Localization Horror Story: It Could Happen To You
+=item SPECIAL CODES
-=item The Linguistic View
+=back
-=item Breaking gettext
+=item CONVERSION ROUTINES
-=item Replacing gettext
+code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
+script_code2code( CODE, CODESET, CODESET )
-=item Buzzwords: Abstraction and Encapsulation
+=item QUERY ROUTINES
-=item Buzzword: Isomorphism
+C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
-=item Buzzword: Inheritance
+=item EXAMPLES
-=item Buzzword: Concision
+=item KNOWN BUGS AND LIMITATIONS
-=item The Devil in the Details
+=item SEE ALSO
-=item The Proof in the Pudding: Localizing Web Sites
+Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
+http://www.evertype.com/standards/iso15924/
-=item References
+=item AUTHOR
-=back
+=item COPYRIGHT
=back
=item Autocreating constants
+=over 4
+
+=item Math library
+
+=item Using Math::BigInt::Lite
+
+=back
+
=item BUGS
=item CAVEAT
Canonical notation, Input, Output
+=item METHODS
+
+=over 4
+
+=item config
+
+=item accuracy
+
+=item brsft
+
+=item new
+
+=item bnan
+
+=item bzero
+
+=item binf
+
+=item bone
+
+=item is_one()/is_zero()/is_nan()/is_inf()
+
+=item is_positive()/is_negative()
+
+ $x->is_positive(); # true if >= 0
+ $x->is_negative(); # true if < 0
+
+=item is_odd()/is_even()/is_int()
+
+=item bcmp
+
+=item bacmp
+
+=item sign
+
+=item bcmp
+
+=item bneg
+
+=item babs
+
+=item bnorm
+
+=item bnot
+
+=item binc
+
+=item bdec
+
+=item badd
+
+=item bsub
+
+=item bmul
+
+=item bdiv
+
+=item bmod
+
+=item bpow
+
+=item blsft
+
+=item brsft
+
+=item band
+
+=item bior
+
+=item bxor
+
+=item bnot
+
+=item bsqrt
+
+=item bfac
+
+=item round
+
+=item bround
+
+=item bfround
+
+=item bfloor
+
+=item bceil
+
+=item bgcd
+
+=item blcm
+
+=item exponent
+
+=item mantissa
+
+=item parts
+
+=item copy
+
+=item as_number
+
+=item bsstr
+
+=item as_hex
+
+=item as_bin
+
+=back
+
=item ACCURACY and PRECISION
=over 4
=item EXAMPLES
- use Math::BigInt qw(bstr);
+ use Math::BigInt;
=item Autocreating constants
=item Alternative math libraries
+=item SUBCLASSING
+
+=back
+
+=item Subclassing Math::BigInt
+
+=item UPGRADING
+
+=over 4
+
+=item Auto-upgrade
+
+bsqrt(), div(), blog()
+
=back
=item BUGS
=item CAVEATS
-stringify, bstr(), bsstr() and 'cmp', int(), bdiv, bdiv, Modifying and =,
-bpow, Overloading -$x, Mixing different object types, bsqrt()
+stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity
+handling, Modifying and =, bpow, Overloading -$x, Mixing different object
+types, bsqrt(), brsft()
=item LICENSE
=back
+=head2 Math::BigRat - arbitrarily big rationals
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item MATH LIBRARY
+
+=back
+
+=item METHODS
+
+=over 4
+
+=item new
+
+=item numerator
+
+=item denominator
+
+ $d = $x->denominator();
+
+=item parts
+
+=back
+
+=item BUGS
+
+=item LICENSE
+
+=item SEE ALSO
+
+=item AUTHORS
+
+=back
+
=head2 Math::Complex - complex numbers and associated mathematical
functions
=back
-=head2 Memoize - Make your functions faster by trading space for time
+=head2 Memoize - Make functions faster by trading space for time
=over 4
=back
-=head2 Memoize::Saves - Plug-in module to specify which return values
-should be memoized
-
-=over 4
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=item CAVEATS
-
-=item AUTHOR
-
-=item SEE ALSO
-
-=back
-
=head2 Memoize::Storable - store Memoized data in Storable database
=over 4
=item DESCRIPTION
+=over 4
+
+=item Enforcing redispatch
+
+=item Avoiding repetitions
+
+=back
+
=item AUTHOR
=item BUGS AND IRRITATIONS
debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
]), unsupported (), response (), parse_response ( TEXT ), getline (),
-ungetline ( TEXT ), read_until_dot ()
+ungetline ( TEXT ), read_until_dot (), tied_fh ()
=item EXPORTS
=item METHODS
article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
-[ MSGID|MSGNUM ], [FH] ), nntpstat ( [ MSGID|MSGNUM ] ), group ( [ GROUP ]
-), ihave ( MSGID [, MESSAGE ]), last (), date (), postok (), authinfo (
-USER, PASS ), list (), newgroups ( SINCE [, DISTRIBUTIONS ]), newnews (
-SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (), post ( [ MESSAGE ] ), slave
-(), quit ()
+[ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
+MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
+), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
+postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
+DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
+post ( [ MESSAGE ] ), postfh (), slave (), quit ()
=over 4
=back
-=head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1081)
+=head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
=over 4
=item METHODS
-user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( USER,
-PASS ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM [,
-FH ] ), last (), popstat (), ping ( USER ), uidl ( [ MSGNUM ] ), delete (
-MSGNUM ), reset (), quit ()
+user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [,
+PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM
+[, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [
+MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
=item NOTES
=item DESCRIPTION
-icmp, udp, tcp, stream, external
-
=over 4
=item Functions
-Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [,
-$timeout]);, $p->open($host);, $p->close();, pingecho($host [, $timeout]);
+Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->hires( { 0 | 1 }
+);, $p->bind($local_addr);, $p->ping($host [, $timeout]);,
+$p->open($host);, $p->close();, pingecho($host [, $timeout]);
=back
+=item WARNING
+
=item NOTES
+=item AUTHORS
+
+=item COPYRIGHT
+
=back
=head2 Net::SMTP - Simple Mail Transfer Protocol Client
=item METHODS
-banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), mail ( ADDRESS [,
-OPTIONS] ), send ( ADDRESS ), send_or_mail ( ADDRESS ), send_and_mail (
-ADDRESS ), reset (), recipient ( ADDRESS [, ADDRESS [ ...]] [, OPTIONS ] ),
-to ( ADDRESS [, ADDRESS [...]] ), cc ( ADDRESS [, ADDRESS [...]] ), bcc (
-ADDRESS [, ADDRESS [...]] ), data ( [ DATA ] ), expand ( ADDRESS ), verify
-( ADDRESS ), help ( [ $subject ] ), quit ()
+banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME,
+PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail (
+ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [,
+ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc (
+ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
+DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
+quit ()
=item SEE ALSO
=over 4
-=item How do I download files from a FTP server ?
+=item How do I download files from an FTP server ?
=item How do I transfer files in binary mode ?
=item Can I do a reget operation like the ftp command ?
-=item How do I get a directory listing from a FTP server ?
+=item How do I get a directory listing from an FTP server ?
-=item Changeing directory to "" does not fail ?
+=item Changing directory to "" does not fail ?
=item I am behind a SOCKS firewall, but the Firewall option does not work ?
-=item I am behind a FTP proxy firewall, but cannot access machines outside
+=item I am behind an FTP proxy firewall, but cannot access machines outside
?
=item My ftp proxy firewall does not listen on port 21
=item WAIT
-Constants, Macros
+Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
+WTERMSIG, WIFSTOPPED, WSTOPSIG
=back
=item DESCRIPTION
-$class->PUSHED([$mode][,$fh]), $obj->POPPED([$fh]),
+$class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
$class->OPEN($path,$mode[,$fh]), $class->FDOPEN($fd),
$class->SYSOPEN($path,$imode,$perm,$fh), $obj->FILENO($fh),
$obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
$obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
$obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
+=over 4
+
+=item Example - a Hexadecimal Handle
+
+=back
+
=back
=head2 Pod::Checker, podchecker() - check pod documents for syntax errors
B<_replace_special_chars>
+B<_replace_special_chars_late>
+
B<_create_label>
B<_create_index>
B<_clean_latex_commands>
+B<_split_delimited>
+
=over 4
=item NOTES
=item DESCRIPTION
-center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, quotes,
+center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
release, section
=item DIAGNOSTICS
roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
-escape EE<lt>%sE<gt>, %s:%d: Unknown sequence %s, %s:%d: Unmatched =back
+escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
+=back
=item BUGS
+=item CAVEATS
+
=item SEE ALSO
=item AUTHOR
=back
+=head2 Pod::ParseLink -- Parse an LE<lt>E<gt> formatting code in POD text
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item AUTHOR
+
+=item COPYRIGHT AND LICENSE
+
+=back
+
=head2 Pod::ParseUtils - helpers for POD parsing and conversion
=over 4
=item DESCRIPTION
-alt, indent, loose, quotes, sentence, width
+alt, code, indent, loose, quotes, sentence, width
=item DIAGNOSTICS
-Bizarre space in item, Can't open %s for reading: %s, Invalid quote
-specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape:
-%s, Unknown sequence: %s, Unmatched =back
+Bizarre space in item, Item called without tag, Can't open %s for reading:
+%s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
+%s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
+Unmatched =back
=item RESTRICTIONS
=item DESCRIPTION
+=item NOTES
+
=item SEE ALSO
=item AUTHOR
=back
-=head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
-documentation
+=head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
+documentation
+
+=over 4
+
+=item SYNOPSIS
+
+=item ARGUMENTS
+
+C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
+C<-pathlist>
+
+=item DESCRIPTION
+
+=item EXAMPLES
+
+=over 4
+
+=item Recommended Use
+
+=back
+
+=item CAVEATS
+
+=item AUTHOR
+
+=item ACKNOWLEDGEMENTS
+
+=back
+
+=head2 Pod::t::basic, basic.pod - Test of various basic POD features in
+translators.
+
+=over 4
+
+=item HEADINGS
+
+=item This C<is> a "level 1" heading
+
+=over 4
+
+=item ``Level'' "2 I<heading>
+
+=back
+
+=item This C<is> a "level 1" heading
+
+=over 4
+
+=item ``Level'' 2 I<heading>
+
+=back
+
+=item LINKS
+
+=item OVER AND ITEMS
+
+This is a test, a, b, a, b, c, d, "foo", B<bar>, C<baz>, Some longer item
+text
+
+=item FORMATTING CODES
+
+E<amp>, E<apos>, E<lt>, E<gt>, E<quot>, E<sol>
+
+=item VERBATIM
+
+=item CONCLUSION
+
+=back
+
+=head2 Pod::t::htmlescp, Escape Sequences Test
+
+=over 4
+
+=item DESCRIPTION
+
+=back
+
+=head2 Pod::t::htmlview, Test HTML Rendering
=over 4
=item SYNOPSIS
-=item ARGUMENTS
-
-C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
-C<-pathlist>
-
=item DESCRIPTION
-=item EXAMPLES
+=item METHODS =E<gt> OTHER STUFF
=over 4
-=item Recommended Use
+=item new()
+
+foo, bar, baz, C<Black> Cat, Sat S<I<on> the>, MatE<lt>!E<gt>, 1 Cat, 2
+Sat, 3 Mat
+
+=item old()
=back
-=item CAVEATS
+=item TESTING FOR AND BEGIN
-=item AUTHOR
+=item TESTING URLs hyperlinking
-=item ACKNOWLEDGEMENTS
+=item SEE ALSO
=back
=item DESCRIPTION
-blessed EXPR, dualvar NUM, STRING, isweak EXPR, readonly SCALAR, reftype
+blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype
EXPR, tainted EXPR, weaken REF
+=item KNOWN BUGS
+
=item COPYRIGHT
=item BLATANT PLUG
=item DESCRIPTION
inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
-INADDR_LOOPBACK, INADDR_NONE, sockaddr_in PORT, ADDRESS, sockaddr_in
-SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS, unpack_sockaddr_in
-SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un SOCKADDR_UN,
-pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
+INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
+ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
+unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
+SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
=back
=back
+=item Storable magic
+
=item EXAMPLES
=item WARNING
=item BUGS
+=item LIMITATION
+
=item COPYRIGHT
=back
=item DESCRIPTION
openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
-setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02),
-closelog
+setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
+in 5.004_02), closelog
=item EXAMPLES
=item DESCRIPTION
openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
-setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02),
-closelog
+setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
+in 5.004_02), closelog
=item EXAMPLES
=item DESCRIPTION
+=over 4
+
+=item METHODS
+
+=back
+
+=back
+
+B<Tgetent>, OSPEED, TERM
+
+B<Tpad>, B<$string>, B<$cnt>, B<$FH>
+
+B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
+
+B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
+
+B<Trequire>
+
+=over 4
+
=item EXAMPLES
+=item COPYRIGHT AND LICENSE
+
+=item AUTHOR
+
+=item SEE ALSO
+
=back
=head2 Term::Complete - Perl word completion module
=item BUGS and CAVEATS
-=item TODO
+=item NOTE
=item SEE ALSO
B<is_eq>, B<is_num>
-B<like>
+B<isnt_eq>, B<isnt_num>
+
+B<like>, B<unlike>
+
+B<cmp_ok>
+
+B<BAILOUT>
B<skip>
+B<todo_skip>
+
B<skip_rest>
=over 4
=item EXAMPLES
-=item AUTHOR
-
=item SEE ALSO
+=item AUTHORS
+
+=item COPYRIGHT
+
=back
=head2 Test::Harness - run perl standard test scripts with statistics
=item The test script output
-B<'1..M'>, B<'ok', 'not ok'. Ok?>, B<test numbers>,
-B<$Test::Harness::verbose>, B<$Test::Harness::switches>, B<Skipping tests>,
-B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything else>
+B<'1..M'>, B<'ok', 'not ok'. Ok?>, B<test numbers>, B<test names>,
+B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
+else>
+
+=item Taint mode
+
+=item Configuration variables.
+
+B<$Test::Harness::verbose>, B<$Test::Harness::switches>
=item Failure
B<_mk_leader>
+B<_leader_width>
+
=over 4
=item EXPORT
=back
+=head2 Test::Harness::Assert - simple assert
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Functions
+
+B<assert>
+
+=back
+
+=back
+
+=over 4
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
+=head2 Test::Harness::Iterator - Internal Test::Harness Iterator
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
+=head2 Test::Harness::Straps - detailed analysis of test results
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Construction
+
+B<new>
+
+=back
+
+=back
+
+B<_init>
+
+=over 4
+
+=item Analysis
+
+B<analyze>
+
+=back
+
+B<analyze_fh>
+
+B<analyze_file>
+
+B<_switches>
+
+B<_INC2PERL5LIB>
+
+B<_filtered_INC>
+
+B<_restore_PERL5LIB>
+
+=over 4
+
+=item Parsing
+
+B<_is_comment>
+
+=back
+
+B<_is_header>
+
+B<_is_test>
+
+B<_is_bail_out>
+
+B<_reset_file_state>
+
+=over 4
+
+=item Results
+
+B<_detailize>
+
+=back
+
+=over 4
+
+=item EXAMPLES
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
=head2 Test::More - yet another framework for writing test scripts
=over 4
B<like>
+B<unlike>
+
+B<cmp_ok>
+
B<can_ok>
B<isa_ok>
=over 4
+=item Diagnostics
+
+B<diag>
+
+=back
+
+=over 4
+
=item Module tests
B<use_ok>
=back
-B<TODO: BLOCK>
+B<TODO: BLOCK>, B<todo_skip>
=over 4
-=item Comparision functions
+=item Comparison functions
B<is_deeply>
=over 4
+=item Extending and Embedding Test::More
+
+B<builder>
+
+=back
+
+=over 4
+
=item NOTES
=item BUGS and CAVEATS
-Making your own ok(), The eq_* family have some caveats, Test::Harness
+Making your own ok(), The eq_* family has some caveats, Test::Harness
upgrades
-=item AUTHOR
-
=item HISTORY
=item SEE ALSO
+=item AUTHORS
+
+=item COPYRIGHT
+
=back
=head2 Test::Simple - Basic utilities for writing tests.
=item HISTORY
-=item AUTHOR
-
=item SEE ALSO
-L<Test::More>, L<Test>, L<Test::Unit>, L<Pod::Tests>, L<SelfTest>,
+L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
L<Test::Harness>
+=item AUTHORS
+
+=item COPYRIGHT
+
=back
=head2 Test::Tutorial - A tutorial about writing really basic tests
=item FOOTNOTES
+=item AUTHORS
+
+=item COPYRIGHT
+
=back
=head2 Text::Abbrev, abbrev - create an abbreviation table from a list
=back
-=head2 Thread - manipulate threads in Perl (EXPERIMENTAL, subject to
-change)
+=head2 Thread - manipulate threads in Perl
=over 4
=item FUNCTIONS
-new \&start_sub, new \&start_sub, LIST, lock VARIABLE, async BLOCK;,
-Thread->self, Thread->list, cond_wait VARIABLE, cond_signal VARIABLE,
-cond_broadcast VARIABLE, yield
+$thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
+LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
+cond_signal VARIABLE, cond_broadcast VARIABLE, yield
=item METHODS
=back
+=head2 Tie::File - Access the lines of a disk file via a Perl array
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item C<recsep>
+
+=item C<autochomp>
+
+=item C<mode>
+
+=item C<memory>
+
+=item C<dw_size>
+
+=item Option Format
+
+=back
+
+=item Public Methods
+
+=over 4
+
+=item C<flock>
+
+=item C<autochomp>
+
+=item C<defer>, C<flush>, C<discard>, and C<autodefer>
+
+=back
+
+=item Tying to an already-opened filehandle
+
+=item Deferred Writing
+
+=over 4
+
+=item Autodeferring
+
+=back
+
+=item CAVEATS
+
+=item SUBCLASSING
+
+=item WHAT ABOUT C<DB_File>?
+
+=item AUTHOR
+
+=item LICENSE
+
+=item WARRANTY
+
+=item THANKS
+
+=item TODO
+
+=back
+
=head2 Tie::Handle, Tie::StdHandle - base class definitions for tied
handles
=back
-=head2 Tie::Hash, Tie::StdHash - base class definitions for tied hashes
+=head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
+tied hashes
=over 4
TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
-=item CAVEATS
+=item Inheriting from B<Tie::StdHash>
+
+=item Inheriting from B<Tie::ExtraHash>
+
+=item C<UNTIE> and C<DESTROY>
=item MORE INFORMATION
=back
+=head2 Tie::Memoize - add data to hash when needed
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item Inheriting from B<Tie::Memoize>
+
+=item EXAMPLE
+
+=item BUGS
+
+=item AUTHOR
+
+=back
+
=head2 Tie::RefHash - use references as hash keys
=over 4
=back
-=head2 Time::HiRes - High resolution ualarm, usleep, and gettimeofday
+=head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
+timers
=over 4
=item DESCRIPTION
-isa ( TYPE ), can ( METHOD ), VERSION ( [ REQUIRE ] ), UNIVERSAL::isa (
-VAL, TYPE ), UNIVERSAL::can ( VAL, METHOD )
+$obj->isa( TYPE ), CLASS->isa( TYPE ), isa( VAL, TYPE ), $obj->can( METHOD
+), CLASS->can( METHOD ), can( VAL, METHOD ), VERSION ( [ REQUIRE ] )
=back
=item Other methods
-C<@sorted = $UCA-E<gt>sort(@not_sorted)>, C<$result = $UCA-E<gt>cmp($a,
-$b)>, C<$sortKey = $UCA-E<gt>getSortKey($string)>, C<$position =
-$UCA-E<gt>index($string, $substring)>, C<($position, $length) =
-$UCA-E<gt>index($string, $substring)>
+C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
+$Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
+C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
+$b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
+$Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
+C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$position =
+$Collator-E<gt>index($string, $substring)>, C<($position, $length) =
+$Collator-E<gt>index($string, $substring)>
=item EXPORT
+=item TODO
+
=item CAVEAT
=back
=item SEE ALSO
-L<Lingua::KO::Hangul::Util>, L<Unicode::Normalize>, Unicode Collation
-Algorithm - Unicode TR #10
+Unicode Collation Algorithm - Unicode TR #10, L<Unicode::Normalize>
=back
=item DESCRIPTION
-C<$string_NFD = NFD($raw_string)>, C<$string_NFC = NFC($raw_string)>,
-C<$string_NFKD = NFKD($raw_string)>, C<$string_NFKC = NFKC($raw_string)>,
-C<$normalized_string = normalize($form_name, $raw_string)>
-
=over 4
+=item Normalization Forms
+
+C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
+C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
+C<$normalized_string = normalize($form_name, $string)>
+
+=item Decomposition and Composition
+
+C<$decomposed_string = decompose($string)>, C<$decomposed_string =
+decompose($string, $useCompatMapping)>, C<$reordered_string =
+reorder($string)>, C<$composed_string = compose($string)>
+
+=item Quick Check
+
+C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
+checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
+check($form_name, $string)>
+
+=item Character Data
+
+C<$canonical_decomposed = getCanon($codepoint)>,
+C<$compatibility_decomposed = getCompat($codepoint)>,
+C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
+C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
+isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
+C<$is_non_startar_decomposition = isNonStDecomp($codepoint)>,
+C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
+
=item EXPORT
=back
=item SEE ALSO
-L<Lingua::KO::Hangul::Util>, http://www.unicode.org/unicode/reports/tr15/
+http://www.unicode.org/unicode/reports/tr15/,
+http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt
=back
=over 4
+=item BUGS
+
=item AUTHOR
=back
Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
-Win32::RegisterServer(LIBRARYNAME), Win32::SetCwd(NEWDIRECTORY),
-Win32::SetLastError(ERROR), Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS,
-PID), Win32::UnregisterServer(LIBRARYNAME)
+Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
+Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
+Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
+Win32::UnregisterServer(LIBRARYNAME)
=back