typos in pods
[p5sagit/p5-mst-13.2.git] / pod / perltoc.pod
index c20160c..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,
@@ -1027,21 +1027,23 @@ B<-w>, B<-W>, B<-X>
 
 =item use strict
 
-=item Looking at data and -w
+=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 REGULAR EXPRESSIONS
 
-=item Some ideas for output
+=item OUTPUT TIPS
 
 =item CGI
 
 =item GUIs
 
-=item Summary
+=item SUMMARY
 
 =item SEE ALSO
 
@@ -1385,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
@@ -1461,6 +1433,36 @@ C<(?(condition)yes-pattern|no-pattern)>
 
 =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 perlform - Perl formats
 
 =over
@@ -1487,108 +1489,217 @@ C<(?(condition)yes-pattern|no-pattern)>
 
 =back
 
-=head2 perllocale - Perl locale handling (internationalization and
-localization)
+=head2 perlboot - Beginner's Object-Oriented Tutorial
 
 =over
 
 =item DESCRIPTION
 
-=item PREPARING TO USE LOCALES
+=over
 
-=item USING LOCALES
+=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 Making a method work with either classes or instances
+
+=item Adding parameters to a method
+
+=item More interesting instances
+
+=item A horse of a different color
+
+=item Summary
+
+=back
+
+=item SEE ALSO
+
+=item COPYRIGHT
+
+=back
+
+=head2 perltoot - Tom's object-oriented tutorial for perl
 
 =over
 
-=item The use locale pragma
+=item DESCRIPTION
 
-=item The setlocale function
+=item Creating a Class
 
-=item Finding locales
+=over
 
-=item LOCALE PROBLEMS
+=item Object Representation
 
-=item Temporarily fixing locale problems
+=item Class Interface
 
-=item Permanently fixing locale problems
+=item Constructors and Instance Methods
 
-=item Permanently fixing your system's locale configuration
+=item Planning for the Future: Better Constructors
 
-=item Fixing system locale configuration
+=item Destructors
 
-=item The localeconv function
+=item Other Object Methods
 
 =back
 
-=item LOCALE CATEGORIES
+=item Class Data
 
 =over
 
-=item Category LC_COLLATE: Collation
+=item Accessing Class Data
 
-=item Category LC_CTYPE: Character Types
+=item Debugging Methods
 
-=item Category LC_NUMERIC: Numeric Formatting
+=item Class Destructors
 
-=item Category LC_MONETARY: Formatting of monetary amounts
+=item Documenting the Interface
 
-=item LC_TIME
+=back
 
-=item Other categories
+=item Aggregation
+
+=item Inheritance
+
+=over
+
+=item Overridden Methods
+
+=item Multiple Inheritance
+
+=item UNIVERSAL: The Root of All Objects
 
 =back
 
-=item SECURITY
+=item Alternate Object Representations
 
-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()):
+=over
 
-=item ENVIRONMENT
+=item Arrays as Objects
 
-PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
-LC_NUMERIC, LC_TIME, LANG
+=item Closures as Objects
+
+=back
+
+=item AUTOLOAD: Proxy Methods
+
+=over
+
+=item Autoloaded Data Methods
+
+=item Inherited Autoloaded Data Methods
+
+=back
+
+=item Metaclassical Tools
+
+=over
+
+=item Class::Struct
+
+=item Data Members as Variables
 
 =item NOTES
 
+=item Object Terminology
+
+=back
+
+=item SEE ALSO
+
+=item AUTHOR AND COPYRIGHT
+
+=item COPYRIGHT
+
 =over
 
-=item Backward compatibility
+=item Acknowledgments
 
-=item I18N:Collate obsolete
+=back
 
-=item Sort speed and memory use impacts
+=back
 
-=item write() and LC_NUMERIC
+=head2 perltootc - Tom's OO Tutorial for Class Data in Perl
 
-=item Freely available locale definitions
+=over
 
-=item I18n and l10n
+=item DESCRIPTION
 
-=item An imperfect standard
+=item Class Data as Package Variables
+
+=over
+
+=item Putting All Your Eggs in One Basket
+
+=item Inheritance Concerns
+
+=item The Eponymous Meta-Object
+
+=item Indirect References to Class Data
+
+=item Monadic Classes
+
+=item Translucent Attributes
 
 =back
 
-=item BUGS
+=item Class Data as Lexical Variables
 
 =over
 
-=item Broken systems
+=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 perlunicode - Unicode support in Perl
+=head2 perlobj - Perl objects
 
 =over
 
@@ -1596,23 +1707,102 @@ LC_NUMERIC, LC_TIME, LANG
 
 =over
 
-=item Important Caveat
+=item An Object is Simply a Reference
 
-Input and Output Disciplines, Regular Expressions, C<use utf8> still needed
-to enable a few features
+=item A Class is Simply a Package
 
-=item Byte and Character semantics
+=item A Method is Simply a Subroutine
 
-=item Effects of character semantics
+=item Method Invocation
 
-=item Character encodings for input and output
+=item WARNING
+
+=item Default UNIVERSAL methods
+
+isa(CLASS), can(METHOD), VERSION( [NEED] )
+
+=item Destructors
+
+=item Summary
+
+=item Two-Phased Garbage Collection
 
 =back
 
-=item CAVEATS
+=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,
@@ -1996,344 +2186,246 @@ v1.23, 10 July 1998
 
 =back
 
-=head2 perlsec - Perl security
-
-=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
+=head2 perllocale - Perl locale handling (internationalization and
+localization)
 
 =over
 
 =item DESCRIPTION
 
-=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 Making a method work with either classes or instances
-
-=item Adding parameters to a method
-
-=item More interesting instances
-
-=item A horse of a different color
-
-=item Summary
-
-=back
-
-=item SEE ALSO
-
-=item COPYRIGHT
-
-=back
-
-=head2 perltoot - Tom's object-oriented tutorial for perl
-
-=over
-
-=item DESCRIPTION
+=item PREPARING TO USE LOCALES
 
-=item Creating a Class
+=item USING LOCALES
 
 =over
 
-=item Object Representation
-
-=item Class Interface
-
-=item Constructors and Instance Methods
-
-=item Planning for the Future: Better Constructors
-
-=item Destructors
+=item The use locale pragma
 
-=item Other Object Methods
+=item The setlocale function
 
-=back
+=item Finding locales
 
-=item Class Data
+=item LOCALE PROBLEMS
 
-=over
+=item Temporarily fixing locale problems
 
-=item Accessing Class Data
+=item Permanently fixing locale problems
 
-=item Debugging Methods
+=item Permanently fixing your system's locale configuration
 
-=item Class Destructors
+=item Fixing system locale configuration
 
-=item Documenting the Interface
+=item The localeconv function
 
 =back
 
-=item Aggregation
-
-=item Inheritance
+=item LOCALE CATEGORIES
 
 =over
 
-=item Overridden Methods
-
-=item Multiple Inheritance
-
-=item UNIVERSAL: The Root of All Objects
+=item Category LC_COLLATE: Collation
 
-=back
+=item Category LC_CTYPE: Character Types
 
-=item Alternate Object Representations
+=item Category LC_NUMERIC: Numeric Formatting
 
-=over
+=item Category LC_MONETARY: Formatting of monetary amounts
 
-=item Arrays as Objects
+=item LC_TIME
 
-=item Closures as Objects
+=item Other categories
 
 =back
 
-=item AUTOLOAD: Proxy Methods
-
-=over
+=item SECURITY
 
-=item Autoloaded Data Methods
+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 Inherited Autoloaded Data Methods
+=item ENVIRONMENT
 
-=back
+PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
+LC_NUMERIC, LC_TIME, LANG
 
-=item Metaclassical Tools
+=item NOTES
 
 =over
 
-=item Class::Struct
+=item Backward compatibility
 
-=item Data Members as Variables
+=item I18N:Collate obsolete
 
-=item NOTES
+=item Sort speed and memory use impacts
 
-=item Object Terminology
+=item write() and LC_NUMERIC
 
-=back
+=item Freely available locale definitions
 
-=item SEE ALSO
+=item I18n and l10n
 
-=item AUTHOR AND COPYRIGHT
+=item An imperfect standard
 
-=item COPYRIGHT
+=back
+
+=item BUGS
 
 =over
 
-=item Acknowledgments
+=item Broken systems
 
 =back
 
+=item SEE ALSO
+
+=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)
@@ -2481,6 +2573,8 @@ module (sometimes unnecessary), B<INSTALL> the module
 
 =back
 
+=item PORTABILITY
+
 =item HEY
 
 =item AUTHOR
@@ -3251,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?
@@ -3801,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
 
@@ -4511,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
 
@@ -5702,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
@@ -6492,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
 
@@ -6724,7 +6845,7 @@ bytecode
 
 =item DESCRIPTION
 
-=item AUTHOR
+=item AUTHORS
 
 =back
 
@@ -6751,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
 
@@ -7052,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
 
@@ -7559,7 +7682,7 @@ optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
 
 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
 
-=item Configuring lynx or ncftp for going throught the firewall
+=item Configuring lynx or ncftp for going through the firewall
 
 =back
 
@@ -7694,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
 
@@ -7751,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>,
@@ -7783,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
 
@@ -7795,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
 
@@ -7822,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
 
@@ -7845,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
 
@@ -7905,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
 
@@ -9470,6 +9595,8 @@ catpath
 
 =over
 
+=item PORTABILITY
+
 =item SYNOPSIS
 
 =item DESCRIPTION
@@ -10479,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
 
@@ -10594,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
 
@@ -10855,7 +11002,7 @@ 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
@@ -11689,31 +11836,6 @@ I<code-ref>|I<method-name>
 
 =back
 
-=head2 Pod::PlainText - Convert POD data to formatted ASCII text
-
-=over
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-alt, indent, loose, sentence, width
-
-=item DIAGNOSTICS
-
-Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s,
-Unknown sequence: %s, Unmatched =back
-
-=item RESTRICTIONS
-
-=item NOTES
-
-=item SEE ALSO
-
-=item AUTHOR
-
-=back
-
 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
 
 =over
@@ -12038,6 +12160,12 @@ Memory, CPU, Snooping, Signals, State Changes
 
 =item DESCRIPTION
 
+=over
+
+=item OBJECT ORIENTED SYNTAX
+
+=back
+
 =item AUTHOR
 
 =back
@@ -12059,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