Better options for rsync.
[p5sagit/p5-mst-13.2.git] / pod / perltoc.pod
index bbd842a..97975b3 100644 (file)
@@ -564,7 +564,7 @@ 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, crypt PLAINTEXT,SALT,
+connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt PLAINTEXT,SALT,
 dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR, defined, delete
 EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, dump LABEL, dump,
 each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval BLOCK, exec LIST,
@@ -590,12 +590,12 @@ mkdir FILENAME,MASK, mkdir FILENAME, msgctl ID,CMD,ARG, msgget KEY,FLAGS,
 msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my EXPR :
 ATTRIBUTES, next LABEL, next, no Module LIST, oct EXPR, oct, open
 FILEHANDLE,MODE,LIST, open FILEHANDLE,EXPR, open FILEHANDLE, opendir
-DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, pack TEMPLATE,LIST, package,
-package NAMESPACE, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR,
-pos, print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE FORMAT,
-LIST, printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/,
-qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta,
-rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
+DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, pack TEMPLATE,LIST, package
+NAMESPACE, package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos
+SCALAR, pos, print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE
+FORMAT, LIST, printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST,
+q/STRING/, qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR,
+quotemeta, rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
 FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
 readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo,
 ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR,
@@ -1019,6 +1019,40 @@ B<-w>, B<-W>, B<-X>
 
 =back
 
+=head2 perldebtut - Perl debugging tutorial
+
+=over
+
+=item DESCRIPTION
+
+=item use strict
+
+=item Looking at data and -w and w
+
+=item help
+
+=item Stepping through code
+
+=item Placeholder for a, w, t, T
+
+=item REGULAR EXPRESSIONS
+
+=item OUTPUT TIPS
+
+=item CGI
+
+=item GUIs
+
+=item SUMMARY
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item CONTRIBUTORS
+
+=back
+
 =head2 perldebug - Perl debugging
 
 =over
@@ -1353,36 +1387,6 @@ and optimizing the final combined regexp
 
 =back
 
-=head2 perlref - Perl references and nested data structures
-
-=over
-
-=item NOTE
-
-=item DESCRIPTION
-
-=over
-
-=item Making References
-
-=item Using References
-
-=item Symbolic references
-
-=item Not-so-symbolic references
-
-=item Pseudo-hashes: Using an array as a hash
-
-=item Function Templates
-
-=back
-
-=item WARNING
-
-=item SEE ALSO
-
-=back
-
 =head2 perlre - Perl regular expressions
 
 =over
@@ -1429,254 +1433,472 @@ C<(?(condition)yes-pattern|no-pattern)>
 
 =back
 
-=head2 perlform - Perl formats
+=head2 perlref - Perl references and nested data structures
 
 =over
 
+=item NOTE
+
 =item DESCRIPTION
 
 =over
 
-=item Format Variables
+=item Making References
 
-=back
+=item Using References
 
-=item NOTES
+=item Symbolic references
 
-=over
+=item Not-so-symbolic references
 
-=item Footers
+=item Pseudo-hashes: Using an array as a hash
 
-=item Accessing Formatting Internals
+=item Function Templates
 
 =back
 
-=item WARNINGS
+=item WARNING
+
+=item SEE ALSO
 
 =back
 
-=head2 perllocale - Perl locale handling (internationalization and
-localization)
+=head2 perlform - Perl formats
 
 =over
 
 =item DESCRIPTION
 
-=item PREPARING TO USE LOCALES
-
-=item USING LOCALES
-
 =over
 
-=item The use locale pragma
-
-=item The setlocale function
+=item Format Variables
 
-=item Finding locales
+=back
 
-=item LOCALE PROBLEMS
+=item NOTES
 
-=item Temporarily fixing locale problems
+=over
 
-=item Permanently fixing locale problems
+=item Footers
 
-=item Permanently fixing your system's locale configuration
+=item Accessing Formatting Internals
 
-=item Fixing system locale configuration
+=back
 
-=item The localeconv function
+=item WARNINGS
 
 =back
 
-=item LOCALE CATEGORIES
+=head2 perlboot - Beginner's Object-Oriented Tutorial
 
 =over
 
-=item Category LC_COLLATE: Collation
-
-=item Category LC_CTYPE: Character Types
+=item DESCRIPTION
 
-=item Category LC_NUMERIC: Numeric Formatting
+=over
 
-=item Category LC_MONETARY: Formatting of monetary amounts
+=item If we could talk to the animals...
 
-=item LC_TIME
+=item Introducing the method invocation arrow
 
-=item Other categories
+=item Invoking a barnyard
 
-=back
+=item The extra parameter of method invocation
 
-=item SECURITY
+=item Calling a second method to simplify things
 
-B<Comparison operators> (C<lt>, C<le>, C<ge>, C<gt> and C<cmp>):,
-B<Case-mapping interpolation> (with C<\l>, C<\L>, C<\u> or C<\U>),
-B<Matching operator> (C<m//>):, B<Substitution operator> (C<s///>):,
-B<Output formatting functions> (printf() and write()):, B<Case-mapping
-functions> (lc(), lcfirst(), uc(), ucfirst()):, B<POSIX locale-dependent
-functions> (localeconv(), strcoll(), strftime(), strxfrm()):, B<POSIX
-character class tests> (isalnum(), isalpha(), isdigit(), isgraph(),
-islower(), isprint(), ispunct(), isspace(), isupper(), isxdigit()):
+=item Inheriting the windpipes
 
-=item ENVIRONMENT
+=item A few notes about @ISA
 
-PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
-LC_NUMERIC, LC_TIME, LANG
+=item Overriding the methods
 
-=item NOTES
+=item Starting the search from a different place
 
-=over
+=item The SUPER way of doing things
 
-=item Backward compatibility
+=item Where we're at so far...
 
-=item I18N:Collate obsolete
+=item A horse is a horse, of course of course -- or is it?
 
-=item Sort speed and memory use impacts
+=item Invoking an instance method
 
-=item write() and LC_NUMERIC
+=item Accessing the instance data
 
-=item Freely available locale definitions
+=item How to build a horse
 
-=item I18n and l10n
+=item Inheriting the constructor
 
-=item An imperfect standard
+=item Making a method work with either classes or instances
 
-=back
+=item Adding parameters to a method
 
-=item BUGS
+=item More interesting instances
 
-=over
+=item A horse of a different color
 
-=item Broken systems
+=item Summary
 
 =back
 
 =item SEE ALSO
 
-=item HISTORY
+=item COPYRIGHT
 
 =back
 
-=head2 perlunicode - Unicode support in Perl
+=head2 perltoot - Tom's object-oriented tutorial for perl
 
 =over
 
 =item DESCRIPTION
 
-=over
-
-=item Important Caveat
+=item Creating a Class
 
-Input and Output Disciplines, Regular Expressions, C<use utf8> still needed
-to enable a few features
+=over
 
-=item Byte and Character semantics
+=item Object Representation
 
-=item Effects of character semantics
+=item Class Interface
 
-=item Character encodings for input and output
+=item Constructors and Instance Methods
 
-=back
+=item Planning for the Future: Better Constructors
 
-=item CAVEATS
+=item Destructors
 
-=item SEE ALSO
+=item Other Object Methods
 
 =back
 
-=head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
-safe subprocesses, sockets, and semaphores)
+=item Class Data
 
 =over
 
-=item DESCRIPTION
-
-=item Signals
+=item Accessing Class Data
 
-=item Named Pipes
+=item Debugging Methods
 
-=over
+=item Class Destructors
 
-=item WARNING
+=item Documenting the Interface
 
 =back
 
-=item Using open() for IPC
+=item Aggregation
+
+=item Inheritance
 
 =over
 
-=item Filehandles
+=item Overridden Methods
 
-=item Background Processes
+=item Multiple Inheritance
 
-=item Complete Dissociation of Child from Parent
+=item UNIVERSAL: The Root of All Objects
 
-=item Safe Pipe Opens
+=back
 
-=item Bidirectional Communication with Another Process
+=item Alternate Object Representations
 
-=item Bidirectional Communication with Yourself
+=over
+
+=item Arrays as Objects
+
+=item Closures as Objects
 
 =back
 
-=item Sockets: Client/Server Communication
+=item AUTOLOAD: Proxy Methods
 
 =over
 
-=item Internet Line Terminators
-
-=item Internet TCP Clients and Servers
+=item Autoloaded Data Methods
 
-=item Unix-Domain TCP Clients and Servers
+=item Inherited Autoloaded Data Methods
 
 =back
 
-=item TCP Clients with IO::Socket
+=item Metaclassical Tools
 
 =over
 
-=item A Simple Client
+=item Class::Struct
 
-C<Proto>, C<PeerAddr>, C<PeerPort>
+=item Data Members as Variables
 
-=item A Webget Client
+=item NOTES
 
-=item Interactive Client with IO::Socket
+=item Object Terminology
 
 =back
 
-=item TCP Servers with IO::Socket
-
-Proto, LocalPort, Listen, Reuse
-
-=item UDP: Message Passing
+=item SEE ALSO
 
-=item SysV IPC
+=item AUTHOR AND COPYRIGHT
 
-=item NOTES
+=item COPYRIGHT
 
-=item BUGS
+=over
 
-=item AUTHOR
+=item Acknowledgments
 
-=item SEE ALSO
+=back
 
 =back
 
-=head2 perlfork - Perl's fork() emulation
+=head2 perltootc - Tom's OO Tutorial for Class Data in Perl
 
 =over
 
-=item SYNOPSIS
-
 =item DESCRIPTION
 
+=item Class Data as Package Variables
+
 =over
 
-=item Behavior of other Perl features in forked pseudo-processes
+=item Putting All Your Eggs in One Basket
 
-$$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
-filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
-files, directories and network sockets
+=item Inheritance Concerns
+
+=item The Eponymous Meta-Object
+
+=item Indirect References to Class Data
+
+=item Monadic Classes
+
+=item Translucent Attributes
+
+=back
+
+=item Class Data as Lexical Variables
+
+=over
+
+=item Privacy and Responsibility 
+
+=item File-Scoped Lexicals
+
+=item More Inheritance Concerns
+
+=item Locking the Door and Throwing Away the Key
+
+=item Translucency Revisited
+
+=back
+
+=item NOTES
+
+=item SEE ALSO
+
+=item AUTHOR AND COPYRIGHT
+
+=item ACKNOWLEDGEMENTS
+
+=item HISTORY
+
+=back
+
+=head2 perlobj - Perl objects
+
+=over
+
+=item DESCRIPTION
+
+=over
+
+=item An Object is Simply a Reference
+
+=item A Class is Simply a Package
+
+=item A Method is Simply a Subroutine
+
+=item Method Invocation
+
+=item WARNING
+
+=item Default UNIVERSAL methods
+
+isa(CLASS), can(METHOD), VERSION( [NEED] )
+
+=item Destructors
+
+=item Summary
+
+=item Two-Phased Garbage Collection
+
+=back
+
+=item SEE ALSO
+
+=back
+
+=head2 perlbot - Bag'o Object Tricks (the BOT)
+
+=over
+
+=item DESCRIPTION
+
+=item OO SCALING TIPS
+
+=item INSTANCE VARIABLES
+
+=item SCALAR INSTANCE VARIABLES
+
+=item INSTANCE VARIABLE INHERITANCE
+
+=item OBJECT RELATIONSHIPS
+
+=item OVERRIDING SUPERCLASS METHODS
+
+=item USING RELATIONSHIP WITH SDBM
+
+=item THINKING OF CODE REUSE
+
+=item CLASS CONTEXT AND THE OBJECT
+
+=item INHERITING A CONSTRUCTOR
+
+=item DELEGATION
+
+=back
+
+=head2 perltie - how to hide an object class in a simple variable
+
+=over
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over
+
+=item Tying Scalars
+
+TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
+
+=item Tying Arrays
+
+TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
+DESTROY this
+
+=item Tying Hashes
+
+USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
+this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
+this, NEXTKEY this, lastkey, DESTROY this
+
+=item Tying FileHandles
+
+TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
+LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, DESTROY this
+
+=item The C<untie> Gotcha
+
+=back
+
+=item SEE ALSO
+
+=item BUGS
+
+=item AUTHOR
+
+=back
+
+=head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
+safe subprocesses, sockets, and semaphores)
+
+=over
+
+=item DESCRIPTION
+
+=item Signals
+
+=item Named Pipes
+
+=over
+
+=item WARNING
+
+=back
+
+=item Using open() for IPC
+
+=over
+
+=item Filehandles
+
+=item Background Processes
+
+=item Complete Dissociation of Child from Parent
+
+=item Safe Pipe Opens
+
+=item Bidirectional Communication with Another Process
+
+=item Bidirectional Communication with Yourself
+
+=back
+
+=item Sockets: Client/Server Communication
+
+=over
+
+=item Internet Line Terminators
+
+=item Internet TCP Clients and Servers
+
+=item Unix-Domain TCP Clients and Servers
+
+=back
+
+=item TCP Clients with IO::Socket
+
+=over
+
+=item A Simple Client
+
+C<Proto>, C<PeerAddr>, C<PeerPort>
+
+=item A Webget Client
+
+=item Interactive Client with IO::Socket
+
+=back
+
+=item TCP Servers with IO::Socket
+
+Proto, LocalPort, Listen, Reuse
+
+=item UDP: Message Passing
+
+=item SysV IPC
+
+=item NOTES
+
+=item BUGS
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
+=head2 perlfork - Perl's fork() emulation
+
+=over
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over
+
+=item Behavior of other Perl features in forked pseudo-processes
+
+$$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
+filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
+files, directories and network sockets
 
 =item Resource limits
 
@@ -1964,344 +2186,246 @@ v1.23, 10 July 1998
 
 =back
 
-=head2 perlsec - Perl security
+=head2 perllocale - Perl locale handling (internationalization and
+localization)
 
 =over
 
 =item DESCRIPTION
 
-=over
-
-=item Laundering and Detecting Tainted Data
-
-=item Switches On the "#!" Line
-
-=item Cleaning Up Your Path
-
-=item Security Bugs
-
-=item Protecting Your Programs
-
-=back
-
-=item SEE ALSO
-
-=back
-
-=head2 perlboot - Beginner's Object-Oriented Tutorial
-
-=over
+=item PREPARING TO USE LOCALES
 
-=item DESCRIPTION
+=item USING LOCALES
 
 =over
 
-=item If we could talk to the animals...
-
-=item Introducing the method invocation arrow
-
-=item Invoking a barnyard
-
-=item The extra parameter of method invocation
-
-=item Calling a second method to simplify things
-
-=item Inheriting the windpipes
-
-=item A few notes about @ISA
-
-=item Overriding the methods
-
-=item Starting the search from a different place
-
-=item The SUPER way of doing things
-
-=item Where we're at so far...
-
-=item A horse is a horse, of course of course -- or is it?
-
-=item Invoking an instance method
-
-=item Accessing the instance data
-
-=item How to build a horse
-
-=item Inheriting the constructor
+=item The use locale pragma
 
-=item Making a method work with either classes or instances
+=item The setlocale function
 
-=item Adding parameters to a method
+=item Finding locales
 
-=item More interesting instances
+=item LOCALE PROBLEMS
 
-=item A horse of a different color
+=item Temporarily fixing locale problems
 
-=item Summary
+=item Permanently fixing locale problems
 
-=back
+=item Permanently fixing your system's locale configuration
 
-=item SEE ALSO
+=item Fixing system locale configuration
 
-=item COPYRIGHT
+=item The localeconv function
 
 =back
 
-=head2 perltoot - Tom's object-oriented tutorial for perl
-
-=over
-
-=item DESCRIPTION
-
-=item Creating a Class
+=item LOCALE CATEGORIES
 
 =over
 
-=item Object Representation
-
-=item Class Interface
-
-=item Constructors and Instance Methods
-
-=item Planning for the Future: Better Constructors
-
-=item Destructors
-
-=item Other Object Methods
-
-=back
-
-=item Class Data
+=item Category LC_COLLATE: Collation
 
-=over
+=item Category LC_CTYPE: Character Types
 
-=item Accessing Class Data
+=item Category LC_NUMERIC: Numeric Formatting
 
-=item Debugging Methods
+=item Category LC_MONETARY: Formatting of monetary amounts
 
-=item Class Destructors
+=item LC_TIME
 
-=item Documenting the Interface
+=item Other categories
 
 =back
 
-=item Aggregation
-
-=item Inheritance
-
-=over
-
-=item Overridden Methods
+=item SECURITY
 
-=item Multiple Inheritance
+B<Comparison operators> (C<lt>, C<le>, C<ge>, C<gt> and C<cmp>):,
+B<Case-mapping interpolation> (with C<\l>, C<\L>, C<\u> or C<\U>),
+B<Matching operator> (C<m//>):, B<Substitution operator> (C<s///>):,
+B<Output formatting functions> (printf() and write()):, B<Case-mapping
+functions> (lc(), lcfirst(), uc(), ucfirst()):, B<POSIX locale-dependent
+functions> (localeconv(), strcoll(), strftime(), strxfrm()):, B<POSIX
+character class tests> (isalnum(), isalpha(), isdigit(), isgraph(),
+islower(), isprint(), ispunct(), isspace(), isupper(), isxdigit()):
 
-=item UNIVERSAL: The Root of All Objects
+=item ENVIRONMENT
 
-=back
+PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
+LC_NUMERIC, LC_TIME, LANG
 
-=item Alternate Object Representations
+=item NOTES
 
 =over
 
-=item Arrays as Objects
+=item Backward compatibility
 
-=item Closures as Objects
+=item I18N:Collate obsolete
 
-=back
+=item Sort speed and memory use impacts
 
-=item AUTOLOAD: Proxy Methods
+=item write() and LC_NUMERIC
 
-=over
+=item Freely available locale definitions
 
-=item Autoloaded Data Methods
+=item I18n and l10n
 
-=item Inherited Autoloaded Data Methods
+=item An imperfect standard
 
 =back
 
-=item Metaclassical Tools
+=item BUGS
 
 =over
 
-=item Class::Struct
-
-=item Data Members as Variables
-
-=item NOTES
-
-=item Object Terminology
+=item Broken systems
 
 =back
 
 =item SEE ALSO
 
-=item AUTHOR AND COPYRIGHT
-
-=item COPYRIGHT
-
-=over
-
-=item Acknowledgments
-
-=back
+=item HISTORY
 
 =back
 
-=head2 perltootc - Tom's OO Tutorial for Class Data in Perl
+=head2 perlunicode - Unicode support in Perl
 
 =over
 
 =item DESCRIPTION
 
-=item Class Data as Package Variables
-
 =over
 
-=item Putting All Your Eggs in One Basket
+=item Important Caveat
 
-=item Inheritance Concerns
+Input and Output Disciplines, Regular Expressions, C<use utf8> still needed
+to enable a few features
 
-=item The Eponymous Meta-Object
+=item Byte and Character semantics
 
-=item Indirect References to Class Data
+=item Effects of character semantics
 
-=item Monadic Classes
+=item Character encodings for input and output
 
-=item Translucent Attributes
+=back
+
+=item CAVEATS
+
+=item SEE ALSO
 
 =back
 
-=item Class Data as Lexical Variables
+=head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
 
 =over
 
-=item Privacy and Responsibility 
+=item DESCRIPTION
 
-=item File-Scoped Lexicals
+=item COMMON CHARACTER CODE SETS
 
-=item More Inheritance Concerns
+=over
 
-=item Locking the Door and Throwing Away the Key
+=item ASCII
 
-=item Translucency Revisited
+=item ISO 8859
 
-=back
+=item Latin 1 (ISO 8859-1)
 
-=item NOTES
+=item EBCDIC
 
-=item SEE ALSO
+=item 13 variant characters
 
-=item AUTHOR AND COPYRIGHT
+=item 0037
 
-=item ACKNOWLEDGEMENTS
+=item 1047
 
-=item HISTORY
+=item POSIX-BC
 
 =back
 
-=head2 perlobj - Perl objects
-
-=over
+=item SINGLE OCTET TABLES
 
-=item DESCRIPTION
+recipe 0, recipe 1, recipe 2, recipe 3, recipe 4
 
-=over
+=item IDENTIFYING CHARACTER CODE SETS
 
-=item An Object is Simply a Reference
+=item CONVERSIONS
 
-=item A Class is Simply a Package
+=item OPERATOR DIFFERENCES
 
-=item A Method is Simply a Subroutine
+=item FUNCTION DIFFERENCES
 
-=item Method Invocation
+chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
 
-=item WARNING
+=item REGULAR EXPRESSION DIFFERENCES
 
-=item Default UNIVERSAL methods
+=item SOCKETS
 
-isa(CLASS), can(METHOD), VERSION( [NEED] )
+=item SORTING
 
-=item Destructors
+=over
 
-=item Summary
+=item Ignore ASCII vs EBCDIC sort differences.
 
-=item Two-Phased Garbage Collection
+=item MONOCASE then sort data.
 
-=back
+=item Convert, sort data, then reconvert.
 
-=item SEE ALSO
+=item Perform sorting on one type of machine only.
 
 =back
 
-=head2 perlbot - Bag'o Object Tricks (the BOT)
+=item URL ENCODING and DECODING
 
-=over
+=item I18N AND L10N
 
-=item DESCRIPTION
+=item MULTI OCTET CHARACTER SETS
 
-=item OO SCALING TIPS
+=item OS ISSUES
 
-=item INSTANCE VARIABLES
+=over
 
-=item SCALAR INSTANCE VARIABLES
+=item OS/400 
 
-=item INSTANCE VARIABLE INHERITANCE
+IFS access
 
-=item OBJECT RELATIONSHIPS
+=item OS/390 
 
-=item OVERRIDING SUPERCLASS METHODS
+dataset access, locales
 
-=item USING RELATIONSHIP WITH SDBM
+=item VM/ESA?
 
-=item THINKING OF CODE REUSE
+=item POSIX-BC?
 
-=item CLASS CONTEXT AND THE OBJECT
+=back
 
-=item INHERITING A CONSTRUCTOR
+=item REFERENCES
 
-=item DELEGATION
+=item AUTHOR
 
 =back
 
-=head2 perltie - how to hide an object class in a simple variable
+=head2 perlsec - Perl security
 
 =over
 
-=item SYNOPSIS
-
 =item DESCRIPTION
 
 =over
 
-=item Tying Scalars
-
-TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
-
-=item Tying Arrays
-
-TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
-DESTROY this
-
-=item Tying Hashes
+=item Laundering and Detecting Tainted Data
 
-USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
-this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
-this, NEXTKEY this, lastkey, DESTROY this
+=item Switches On the "#!" Line
 
-=item Tying FileHandles
+=item Cleaning Up Your Path
 
-TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
-LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, DESTROY this
+=item Security Bugs
 
-=item The C<untie> Gotcha
+=item Protecting Your Programs
 
 =back
 
 =item SEE ALSO
 
-=item BUGS
-
-=item AUTHOR
-
 =back
 
 =head2 perlmod - Perl modules (packages and symbol tables)
@@ -2449,6 +2573,8 @@ module (sometimes unnecessary), B<INSTALL> the module
 
 =back
 
+=item PORTABILITY
+
 =item HEY
 
 =item AUTHOR
@@ -3219,8 +3345,6 @@ complete?
 
 =item How do I fork a daemon process?
 
-=item How do I make my program run with sh and csh?
-
 =item How do I find out if I'm running interactively or not?
 
 =item How do I timeout a slow event?
@@ -3769,7 +3893,7 @@ A, p, d, s, n, r, f, m, o, j, x
 
 =over
 
-=item Formatted Printing of IVs and UVs
+=item Formatted Printing of IVs, UVs, and NVs
 
 =item Source Documentation
 
@@ -4479,46 +4603,70 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =back
 
-=head2 perldelta - what's new for perl v5.8.0
+=head2 perldelta - what's new for perl v5.7.0
 
 =over
 
 =item DESCRIPTION
 
+=item Security Vulnerability Closed
+
+=item Incompatible Changes
+
 =item Core Enhancements
 
 =item Modules and Pragmata
 
+=over
+
+=item New Modules
+
+=item Updated And Improved Modules and Pragmata
+
+=back
+
 =item Utility Changes
 
-=item Improved Documentation
+=item New Documentation
 
-=item Performance enhancements
+=item Performance Enhancements
 
 =item Installation and Configuration Improvements
 
 =over
 
-=item gcc automatically tried if 'cc' does not seem to be working
+=item Generic Improvements
 
 =back
 
-=item Platform specific changes
+=item Selected Bug Fixes
 
-=item Significant bug fixes
+sort() arguments are now compiled in the right wantarray context (they were
+accidentally using the context of the sort() itself)
 
-=item New or Changed Diagnostics
+=over
 
-(perhaps you forgot to load "%s"?), Ambiguous range in transliteration
-operator
+=item Platform Specific Changes and Fixes
 
-=item New tests
+=back
 
-=item Incompatible Changes
+=item New or Changed Diagnostics
+
+=item Changed Internals
 
 =item Known Problems
 
-=item Obsolete Diagnostics
+=over
+
+=item Unicode Support Still Far From Perfect
+
+=item EBCDIC Still A Lost Platform
+
+=item Building Extensions Can Fail Because Of Largefiles
+
+In string, @%s now must be written as \@%s
+
+=back
 
 =item Reporting Bugs
 
@@ -5395,8 +5543,8 @@ C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>
 
 =item Suspicious Warnings
 
-Whoa There, I<dlsym()>, Win9x and C<d_eofnblk>, Checking how std your stdio
-is.., Compiler/Preprocessor defines
+I<dlsym()>, Win9x and C<d_eofnblk>, Checking how std your stdio is..,
+Compiler/Preprocessor defines
 
 =back
 
@@ -5670,6 +5818,8 @@ F<lib/io_pipe.t>, F<lib/io_sock.t>, F<op/stat.t>, F<lib/io_udp.t>
 
 =item Segfault in make
 
+=item op/sprintf test failure
+
 =back
 
 =item Specific (mis)features of OS/2 port
@@ -6460,8 +6610,11 @@ C<strict refs>, C<strict vars>, C<strict subs>
 
 =item DESCRIPTION
 
-use warnings::register, warnings::enabled([$category]),
-warnings::warn([$category,] $message)
+use warnings::register, warnings::enabled(), warnings::enabled($category),
+warnings::enabled($object), warnings::warn($message),
+warnings::warn($category, $message), warnings::warn($object, $message),
+warnings::warnif($message), warnings::warnif($category, $message),
+warnings::warnif($object, $message)
 
 =back
 
@@ -6692,7 +6845,7 @@ bytecode
 
 =item DESCRIPTION
 
-=item AUTHOR
+=item AUTHORS
 
 =back
 
@@ -6719,14 +6872,15 @@ bytecode
 =item OPTIONS
 
 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
-B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-fstrip-syntax-tree>,
-B<-On>, B<-D>, B<-Do>, B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-m>
+B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
+B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-Ppackage>    Stores package in the
+output.    =back
 
 =item EXAMPLES
 
 =item BUGS
 
-=item AUTHOR
+=item AUTHORS
 
 =back
 
@@ -7020,14 +7174,15 @@ STYLE ] ), cmpthese ( RESULTSHASHREF ), countit(TIME, CODE), disablecache (
 =item OPTIONS
 
 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
-B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-fstrip-syntax-tree>,
-B<-On>, B<-D>, B<-Do>, B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-m>
+B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
+B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-Ppackage>    Stores package in the
+output.    =back
 
 =item EXAMPLES
 
 =item BUGS
 
-=item AUTHOR
+=item AUTHORS
 
 =back
 
@@ -7086,8 +7241,8 @@ B<:standard>, B<:all>
 
 =item PRAGMAS
 
--any, -compile, -nosticky, -nph, -newstyle_urls, -oldstyle_urls, -autoload,
--no_debug, -debug, -private_tempfiles
+-any, -compile, -nosticky, -no_xhtml, -nph, -newstyle_urls, -oldstyle_urls,
+-autoload, -no_debug, -debug, -private_tempfiles
 
 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
 
@@ -7312,6 +7467,8 @@ other) error log
 
 =back
 
+=item MAKING WARNINGS APPEAR AS HTML COMMENTS
+
 =item CHANGE LOG
 
 =item AUTHORS
@@ -7452,8 +7609,6 @@ B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
 
 =back
 
-=head2 CGI::Util - various utilities
-
 =head2 CPAN - query, download and build perl modules from CPAN sites
 
 =over
@@ -7478,7 +7633,7 @@ distribution, Signals
 
 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
 
-=item ProgrammerE<39>s interface
+=item Programmer's interface
 
 expand($type,@things), Programming Examples
 
@@ -7521,8 +7676,23 @@ optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
 
 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
 
+=over
+
+=item Three basic types of firewalls
+
 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
 
+=item Configuring lynx or ncftp for going through the firewall
+
+=back
+
+=item FAQ
+
+I installed a new version of module X but CPAN keeps saying, I      have
+the old version installed, So why is UNINST=1 not the default?, When I
+install bundles or multiple modules with one command      there is too
+much output to keep track of
+
 =item BUGS
 
 =item AUTHOR
@@ -7647,8 +7817,9 @@ C<byacc>, C<byteorder>
 =item c
 
 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
-C<ccsymbols>, C<cf_by>, C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>,
-C<chmod>, C<chown>, C<clocktype>, C<comm>, C<compress>
+C<ccflags_uselargefiles>, C<ccsymbols>, C<cf_by>, C<cf_email>, C<cf_time>,
+C<charsize>, C<chgrp>, C<chmod>, C<chown>, C<clocktype>, C<comm>,
+C<compress>
 
 =item C
 
@@ -7704,9 +7875,9 @@ 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_setegid>, C<d_seteuid>,
 C<d_setgrent>, C<d_setgrps>, C<d_sethent>, C<d_setlinebuf>, C<d_setlocale>,
 C<d_setnent>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>,
-C<d_setprior>, C<d_setpwent>, C<d_setregid>, C<d_setresgid>,
-C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>,
-C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>,
+C<d_setprior>, C<d_setproctitle>, C<d_setpwent>, C<d_setregid>,
+C<d_setresgid>, C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, C<d_setruid>,
+C<d_setsent>, C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>,
 C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>,
 C<d_sigsetjmp>, C<d_socket>, C<d_socklen_t>, C<d_sockpair>, C<d_sqrtl>,
 C<d_statblks>, C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>,
@@ -7736,8 +7907,8 @@ C<fpossize>, C<fpostype>, C<freetype>, C<full_ar>, C<full_csh>, C<full_sed>
 
 =item g
 
-C<gccversion>, C<gidformat>, C<gidsign>, C<gidsize>, C<gidtype>,
-C<glibpth>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
+C<gccosandvers>, C<gccversion>, C<gidformat>, C<gidsign>, C<gidsize>,
+C<gidtype>, C<glibpth>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
 
 =item h
 
@@ -7748,26 +7919,26 @@ C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<huge>
 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_db>, C<i_dbm>,
 C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>, C<i_gdbm>,
-C<i_grp>, C<i_iconv>, C<i_ieeefp>, C<i_inttypes>, C<i_limits>, C<i_locale>,
-C<i_machcthr>, C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>,
-C<i_netdb>, C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>,
-C<i_prot>, C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>,
-C<i_shadow>, C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>,
-C<i_string>, C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>,
-C<i_sysfilio>, C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>,
-C<i_sysmode>, C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>,
-C<i_syssecrt>, C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
-C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
-C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
-C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
-C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
-C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
-C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installman1dir>,
-C<installman3dir>, C<installprefix>, C<installprefixexp>,
-C<installprivlib>, C<installscript>, C<installsitearch>, C<installsitebin>,
-C<installsitelib>, C<installstyle>, C<installusrbinperl>,
-C<installvendorarch>, C<installvendorbin>, C<installvendorlib>, C<intsize>,
-C<ivdformat>, C<ivsize>, C<ivtype>
+C<i_grp>, C<i_iconv>, C<i_ieeefp>, C<i_inttypes>, C<i_libutil>,
+C<i_limits>, C<i_locale>, C<i_machcthr>, C<i_malloc>, C<i_math>,
+C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>, C<i_neterrno>,
+C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>, C<i_pthread>, C<i_pwd>,
+C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>, C<i_socks>,
+C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>, C<i_sunmath>,
+C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>, C<i_sysin>,
+C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>, C<i_sysmount>,
+C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>, C<i_sysselct>,
+C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>, C<i_sysstatvfs>,
+C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>, C<i_sysuio>,
+C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>, C<i_termio>,
+C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>, C<i_values>,
+C<i_varargs>, C<i_varhdr>, C<i_vfork>, C<ignore_versioned_solibs>,
+C<inc_version_list>, C<inc_version_list_init>, C<incpath>, C<inews>,
+C<installarchlib>, C<installbin>, C<installman1dir>, C<installman3dir>,
+C<installprefix>, C<installprefixexp>, C<installprivlib>, C<installscript>,
+C<installsitearch>, C<installsitebin>, C<installsitelib>, C<installstyle>,
+C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>,
+C<installvendorlib>, C<intsize>, C<ivdformat>, C<ivsize>, C<ivtype>
 
 =item k
 
@@ -7775,12 +7946,12 @@ C<known_extensions>, C<ksh>
 
 =item l
 
-C<large>, C<ld>, C<lddlflags>, C<ldflags>, C<ldlibpthname>, C<less>,
-C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
-C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>, C<line>, C<lint>,
-C<lkflags>, C<ln>, C<lns>, C<locincpth>, C<loclibpth>, C<longdblsize>,
-C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
-C<lseektype>
+C<large>, C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>,
+C<ldlibpthname>, C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>,
+C<libs>, C<libsdirs>, C<libsfiles>, C<libsfound>, C<libspath>,
+C<libswanted>, C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>,
+C<ln>, C<lns>, C<locincpth>, C<loclibpth>, C<longdblsize>, C<longlongsize>,
+C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>, C<lseektype>
 
 =item m
 
@@ -7798,7 +7969,8 @@ C<myhostname>, C<myuname>
 
 C<n>, C<netdb_hlen_type>, C<netdb_host_type>, C<netdb_name_type>,
 C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>, C<nonxs_ext>, C<nroff>,
-C<nvsize>, C<nvtype>
+C<nveformat>, C<nvEformat>, C<nvfformat>, C<nvFformat>, C<nvgformat>,
+C<nvGformat>, C<nvsize>, C<nvtype>
 
 =item o
 
@@ -7858,7 +8030,7 @@ C<uselongdouble>, C<usemorebits>, C<usemultiplicity>, C<usemymalloc>,
 C<usenm>, C<useopcode>, C<useperlio>, C<useposix>, C<usesfio>,
 C<useshrplib>, C<usesocks>, C<usethreads>, C<usevendorprefix>, C<usevfork>,
 C<usrinc>, C<uuname>, C<uvoformat>, C<uvsize>, C<uvtype>, C<uvuformat>,
-C<uvxformat>
+C<uvxformat>, C<uvXformat>
 
 =item v
 
@@ -9146,8 +9318,9 @@ rmscopy($from,$to[,$date_flag])
 
 =item DESCRIPTION
 
-C<wanted>, C<bydepth>, C<follow>, C<follow_fast>, C<follow_skip>,
-C<no_chdir>, C<untaint>, C<untaint_pattern>, C<untaint_skip>
+C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
+C<follow_fast>, C<follow_skip>, C<no_chdir>, C<untaint>,
+C<untaint_pattern>, C<untaint_skip>
 
 =item CAVEAT
 
@@ -9422,6 +9595,8 @@ catpath
 
 =over
 
+=item PORTABILITY
+
 =item SYNOPSIS
 
 =item DESCRIPTION
@@ -9616,6 +9791,8 @@ $fh->print, $fh->printf, $fh->getline, $fh->getlines
 
 =over
 
+=item Object oriented interface
+
 =item Documentation and help texts
 
 =item Storing options in a hash
@@ -9630,10 +9807,11 @@ $fh->print, $fh->printf, $fh->getline, $fh->getlines
 
 =item Configuring Getopt::Long
 
-default, auto_abbrev, getopt_compat, require_order, permute, bundling
-(default: reset), bundling_override (default: reset), ignore_case 
-(default: set), ignore_case_always (default: reset), pass_through (default:
-reset), prefix, prefix_pattern, debug (default: reset)
+default, posix_default, auto_abbrev, getopt_compat, require_order, permute,
+bundling (default: disabled), bundling_override (default: disabled),
+ignore_case  (default: enabled), ignore_case_always (default: disabled),
+pass_through (default: disabled), prefix, prefix_pattern, debug (default:
+disabled)
 
 =item Return values and Errors
 
@@ -9649,6 +9827,17 @@ reset), prefix, prefix_pattern, debug (default: reset)
 
 =back
 
+=item Trouble Shooting
+
+=over
+
+=item Warning: Ignoring '!' modifier for short option
+
+=item GetOptions does not return a false result when an option is not
+supplied
+
+=back
+
 =item AUTHOR
 
 =item COPYRIGHT AND DISCLAIMER
@@ -10417,7 +10606,17 @@ cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
 
 =item SYNOPSIS
 
-=item DESCRIPTION
+C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
+
+=item DIAGNOSTICS
+
+=over
+
+=item C<ndbm store returned -1, errno 22, key "..." at ...>
+
+=back
+
+=item BUGS AND WARNINGS
 
 =back
 
@@ -10532,7 +10731,17 @@ functions
 
 =item SYNOPSIS
 
-=item DESCRIPTION
+C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
+
+=item DIAGNOSTICS
+
+=over
+
+=item C<odbm store returned -1, errno 22, key "..." at ...>
+
+=back
+
+=item BUGS AND WARNINGS
 
 =back
 
@@ -10793,13 +11002,19 @@ after =back
 
 =item Warnings
 
-multiple occurence of link target I<name>, line containing nothing but
+multiple occurrence of link target I<name>, line containing nothing but
 whitespace in paragraph, file does not start with =head, No numeric
 argument for =over, previous =item has no contents, preceding non-item
 paragraph(s), =item type mismatch (I<one> vs. I<two>), I<N> unescaped
 C<E<lt>E<gt>> in paragraph, Unknown entity, No items in =over, No argument
 for =item, empty section in previous paragraph, Verbatim paragraph in NAME
-section, Hyperlinks
+section
+
+=item Hyperlinks
+
+collapsing newlines to blanks, ignoring leading/trailing whitespace in
+link, (section) in '$page' deprecated, alternative text/node '%s' contains
+non-escaped | or /
 
 =back
 
@@ -10811,6 +11026,8 @@ section, Hyperlinks
 
 =back
 
+C<Pod::Checker-E<gt>new( %options )>
+
 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
 @args )>
 
@@ -10838,9 +11055,39 @@ C<$checker-E<gt>hyperlink()>
 
 =item DESCRIPTION
 
-=item OPTIONS
+=back
+
+=over
+
+=item C<pod_find( { %opts } , @directories )>
+
+C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
+1>
+
+=back
 
-B<-verbose>, B<-perl>, B<-script>, B<-inc>
+=over
+
+=item C<simplify_name( $str )>
+
+=back
+
+=over
+
+=item C<pod_where( { %opts }, $pod )>
+
+C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
+1>
+
+=back
+
+=over
+
+=item C<contains_pod( $file , $verbose )>
+
+=back
+
+=over
 
 =item AUTHOR
 
@@ -10887,8 +11134,8 @@ commands, etc.
 
 =item DESCRIPTION
 
-B<Pod::InputSource>, B<Pod::Paragraph>, B<Pod::InteriorSequence>,
-B<Pod::ParseTree>
+package B<Pod::InputSource>, package B<Pod::Paragraph>, package
+B<Pod::InteriorSequence>, package B<Pod::ParseTree>
 
 =back
 
@@ -10930,49 +11177,49 @@ B<Pod::ParseTree>
 
 =over
 
-=item B<new()>
+=item Pod::Paragraph-E<gt>B<new()>
 
 =back
 
 =over
 
-=item B<cmd_name()>
+=item $pod_para-E<gt>B<cmd_name()>
 
 =back
 
 =over
 
-=item B<text()>
+=item $pod_para-E<gt>B<text()>
 
 =back
 
 =over
 
-=item B<raw_text()>
+=item $pod_para-E<gt>B<raw_text()>
 
 =back
 
 =over
 
-=item B<cmd_prefix()>
+=item $pod_para-E<gt>B<cmd_prefix()>
 
 =back
 
 =over
 
-=item B<cmd_separator()>
+=item $pod_para-E<gt>B<cmd_separator()>
 
 =back
 
 =over
 
-=item B<parse_tree()>
+=item $pod_para-E<gt>B<parse_tree()>
 
 =back
 
 =over
 
-=item B<file_line()>
+=item $pod_para-E<gt>B<file_line()>
 
 =back
 
@@ -10984,67 +11231,67 @@ B<Pod::ParseTree>
 
 =over
 
-=item B<new()>
+=item Pod::InteriorSequence-E<gt>B<new()>
 
 =back
 
 =over
 
-=item B<cmd_name()>
+=item $pod_seq-E<gt>B<cmd_name()>
 
 =back
 
 =over
 
-=item B<prepend()>
+=item $pod_seq-E<gt>B<prepend()>
 
 =back
 
 =over
 
-=item B<append()>
+=item $pod_seq-E<gt>B<append()>
 
 =back
 
 =over
 
-=item B<nested()>
+=item $pod_seq-E<gt>B<nested()>
 
 =back
 
 =over
 
-=item B<raw_text()>
+=item $pod_seq-E<gt>B<raw_text()>
 
 =back
 
 =over
 
-=item B<left_delimiter()>
+=item $pod_seq-E<gt>B<left_delimiter()>
 
 =back
 
 =over
 
-=item B<right_delimiter()>
+=item $pod_seq-E<gt>B<right_delimiter()>
 
 =back
 
 =over
 
-=item B<parse_tree()>
+=item $pod_seq-E<gt>B<parse_tree()>
 
 =back
 
 =over
 
-=item B<file_line()>
+=item $pod_seq-E<gt>B<file_line()>
 
 =back
 
 =over
 
-=item B<DESTROY()>
+=item Pod::InteriorSequence::B<DESTROY()>
 
 =back
 
@@ -11056,43 +11303,43 @@ B<Pod::ParseTree>
 
 =over
 
-=item B<new()>
+=item Pod::ParseTree-E<gt>B<new()>
 
 =back
 
 =over
 
-=item B<top()>
+=item $ptree-E<gt>B<top()>
 
 =back
 
 =over
 
-=item B<children()>
+=item $ptree-E<gt>B<children()>
 
 =back
 
 =over
 
-=item B<prepend()>
+=item $ptree-E<gt>B<prepend()>
 
 =back
 
 =over
 
-=item B<append()>
+=item $ptree-E<gt>B<append()>
 
 =back
 
 =over
 
-=item B<raw_text()>
+=item $ptree-E<gt>B<raw_text()>
 
 =back
 
 =over
 
-=item B<DESTROY()>
+=item Pod::ParseTree::B<DESTROY()>
 
 =back
 
@@ -11260,87 +11507,87 @@ EE<lt>%sE<gt>, Unknown sequence %s, Unmatched =back
 
 =item Pod::List
 
-new()
+Pod::List-E<gt>new()
 
 =back
 
-file()
+$list-E<gt>file()
 
-start()
+$list-E<gt>start()
 
-indent()
+$list-E<gt>indent()
 
-type()
+$list-E<gt>type()
 
-rx()
+$list-E<gt>rx()
 
-item()
+$list-E<gt>item()
 
-parent()
+$list-E<gt>parent()
 
-tag()
+$list-E<gt>tag()
 
 =over
 
 =item Pod::Hyperlink
 
-new()
+Pod::Hyperlink-E<gt>new()
 
 =back
 
-parse($string)
+$link-E<gt>parse($string)
 
-markup($string)
+$link-E<gt>markup($string)
 
-text()
+$link-E<gt>text()
 
-warning()
+$link-E<gt>warning()
 
-line(), file()
+$link-E<gt>file(), $link-E<gt>line()
 
-page()
+$link-E<gt>page()
 
-node()
+$link-E<gt>node()
 
-alttext()
+$link-E<gt>alttext()
 
-type()
+$link-E<gt>type()
 
-link()
+$link-E<gt>link()
 
 =over
 
 =item Pod::Cache
 
-new()
+Pod::Cache-E<gt>new()
 
 =back
 
-item()
+$cache-E<gt>item()
 
-find_page($name)
+$cache-E<gt>find_page($name)
 
 =over
 
 =item Pod::Cache::Item
 
-new()
+Pod::Cache::Item-E<gt>new()
 
 =back
 
-page()
+$cacheitem-E<gt>page()
 
-description()
+$cacheitem-E<gt>description()
 
-path()
+$cacheitem-E<gt>path()
 
-file()
+$cacheitem-E<gt>file()
 
-nodes()
+$cacheitem-E<gt>nodes()
 
-find_node($name)
+$cacheitem-E<gt>find_node($name)
 
-idx()
+$cacheitem-E<gt>idx()
 
 =over
 
@@ -11913,6 +12160,12 @@ Memory, CPU, Snooping, Signals, State Changes
 
 =item DESCRIPTION
 
+=over
+
+=item OBJECT ORIENTED SYNTAX
+
+=back
+
 =item AUTHOR
 
 =back
@@ -11934,6 +12187,58 @@ pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
 
 =back
 
+=head2 Storable - persistency for perl data structures
+
+=over
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item MEMORY STORE
+
+=item SPEED
+
+=item CANONICAL REPRESENTATION
+
+=item ERROR REPORTING
+
+=item WIZARDS ONLY
+
+=over
+
+=item Hooks
+
+C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
+I<serialized>, ..
+
+=item Predicates
+
+C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
+C<Storable::is_retrieving>
+
+=item Recursion
+
+=item Deep Cloning
+
+=back
+
+=item EXAMPLES
+
+=item WARNING
+
+=item BUGS
+
+=item CREDITS
+
+=item TRANSLATIONS
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
 =head2 Symbol - manipulate Perl symbols and their names
 
 =over
@@ -12008,12 +12313,14 @@ closelog
 
 =item DIAGNOSTICS
 
-Invalid attribute name %s, Identifier %s used only once: possible typo, No
-comma allowed after filehandle, Bareword %s not allowed while "strict subs"
-in use
+Invalid attribute name %s, Name "%s" used only once: possible typo, No
+comma allowed after filehandle, Bareword "%s" not allowed while "strict
+subs" in use
 
 =item RESTRICTIONS
 
+=item NOTES
+
 =item AUTHORS
 
 =back