Integrate perlio:
[p5sagit/p5-mst-13.2.git] / pod / perltoc.pod
index 59c1467..52cdd6a 100644 (file)
@@ -348,6 +348,8 @@ regular expressions
 
 =item Lvalue subroutines
 
+Lvalue subroutines are EXPERIMENTAL
+
 =item Passing Symbol Table Entries (typeglobs)
 
 =item When to Still Use local()
@@ -426,25 +428,26 @@ 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
+ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my TYPE EXPR, my EXPR
+: ATTRS, my TYPE EXPR : ATTRS, 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 TYPE, our EXPR : ATTRS, our TYPE EXPR :
+ATTRS, 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,
@@ -455,21 +458,22 @@ sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH,
 splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split
 /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, sqrt EXPR,
 sqrt, srand EXPR, srand, stat FILEHANDLE, stat EXPR, stat, study SCALAR,
-study, sub BLOCK, sub NAME, sub NAME BLOCK, substr
-EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr
-EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
-FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread
-FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
-FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite
-FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH,
-syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie
-VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate
-FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR,
-ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack
-TEMPLATE,EXPR, untie VARIABLE, unshift ARRAY,LIST, use Module VERSION LIST,
-use Module VERSION, use Module LIST, use Module, use VERSION, utime LIST,
-values HASH, vec EXPR,OFFSET,BITS, wait, waitpid PID,FLAGS, wantarray, warn
-LIST, write FILEHANDLE, write EXPR, write, y///
+study, sub NAME BLOCK, sub NAME (PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub
+NAME (PROTO) : ATTRS BLOCK, substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr
+EXPR,OFFSET,LENGTH, substr EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall
+LIST, sysopen FILEHANDLE,FILENAME,MODE, sysopen
+FILEHANDLE,FILENAME,MODE,PERMS, sysread FILEHANDLE,SCALAR,LENGTH,OFFSET,
+sysread FILEHANDLE,SCALAR,LENGTH, sysseek FILEHANDLE,POSITION,WHENCE,
+system LIST, system PROGRAM LIST, syswrite FILEHANDLE,SCALAR,LENGTH,OFFSET,
+syswrite FILEHANDLE,SCALAR,LENGTH, syswrite FILEHANDLE,SCALAR, tell
+FILEHANDLE, tell, telldir DIRHANDLE, tie VARIABLE,CLASSNAME,LIST, tied
+VARIABLE, time, times, tr///, truncate FILEHANDLE,LENGTH, truncate
+EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR, ucfirst, umask EXPR, umask, undef
+EXPR, undef, unlink LIST, unlink, unpack TEMPLATE,EXPR, untie VARIABLE,
+unshift ARRAY,LIST, use Module VERSION LIST, use Module VERSION, use Module
+LIST, use Module, use VERSION, utime LIST, values HASH, vec
+EXPR,OFFSET,BITS, wait, waitpid PID,FLAGS, wantarray, warn LIST, write
+FILEHANDLE, write EXPR, write, y///
 
 =back
 
@@ -1127,6 +1131,8 @@ $ARGV, @ARGV, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr}
 
 =item File Locking
 
+=item IO Layers
+
 =back
 
 =item SEE ALSO 
@@ -1715,11 +1721,20 @@ safe subprocesses, sockets, and semaphores)
 
 =item Signals
 
+=over 4
+
+=item Handling the SIGHUP Signal in Daemons
+
+=back
+
 =item Named Pipes
 
 =over 4
 
-=item WARNING
+=item Deferred Signals
+
+Long running opcodes, Interrupting IO, Signals as "faults", Signals
+triggered by operating system state
 
 =back
 
@@ -1785,7 +1800,7 @@ Proto, LocalPort, Listen, Reuse
 
 =back
 
-=head2 perlfork - Perl's fork() emulation (EXPERIMENTAL, subject to change)
+=head2 perlfork - Perl's fork() emulation
 
 =over 4
 
@@ -1854,6 +1869,8 @@ string
 
 =item DESCRIPTION
 
+=item Status
+
 =item What Is A Thread Anyway?
 
 =item Threaded Program Models
@@ -1870,7 +1887,7 @@ string
 
 =item Native threads
 
-=item What kind of threads are perl threads?
+=item What kind of threads are Perl threads?
 
 =item Threadsafe Modules
 
@@ -1880,6 +1897,8 @@ string
 
 =item Basic Thread Support
 
+=item A Note about the Examples
+
 =item Creating Threads
 
 =item Giving up control
@@ -1898,21 +1917,25 @@ string
 
 =item Thread Pitfalls: Races
 
-=item Controlling access: lock()
+=back
 
-=item Thread Pitfall: Deadlocks
+=item Synchronization and control
 
-=item Queues: Passing Data Around
+=over 4
 
-=back
+=item Controlling access: lock()
 
-=item Threads And Code
+=item A Thread Pitfall: Deadlocks
 
-=over 4
+=item Queues: Passing Data Around
 
 =item Semaphores: Synchronizing Data Access
 
-Basic semaphores, Advanced Semaphores
+=item Basic semaphores
+
+=item Advanced Semaphores
+
+=item cond_wait() and cond_signal()
 
 =back
 
@@ -1932,6 +1955,10 @@ Basic semaphores, Advanced Semaphores
 
 =item A Complete Example
 
+=item Performance considerations
+
+=item Threadsafety of System Libraries
+
 =item Conclusion
 
 =item Bibliography
@@ -2091,6 +2118,8 @@ portable
 
 =item System Interaction
 
+=item Command names versus file pathnames
+
 =item Interprocess Communication (IPC)
 
 =item External Subroutines (XS)
@@ -2319,8 +2348,6 @@ LC_NUMERIC, LC_TIME, LANG
 
 =item Questions With Answers
 
-, , , , , , 
-
 =item Hexadecimal Notation
 
 =item Further Resources
@@ -2331,7 +2358,7 @@ LC_NUMERIC, LC_TIME, LANG
 
 =item SEE ALSO
 
-=item ACKNOWLEDGEMENTS
+=item ACKNOWLEDGMENTS
 
 =item AUTHOR, COPYRIGHT, AND LICENSE
 
@@ -2350,17 +2377,17 @@ LC_NUMERIC, LC_TIME, LANG
 Input and Output Disciplines, Regular Expressions, C<use utf8> still needed
 to enable UTF-8/UTF-EBCDIC in scripts
 
-=item Byte and Character semantics
+=item Byte and Character Semantics
 
-=item Effects of character semantics
+=item Effects of Character Semantics
 
 =item Scripts
 
 =item Blocks
 
-=item User-defined Character Properties
+=item User-Defined Character Properties
 
-=item Character encodings for input and output
+=item Character Encodings for Input and Output
 
 =item Unicode Regular Expression Support Level
 
@@ -2380,11 +2407,11 @@ to enable UTF-8/UTF-EBCDIC in scripts
 
 =over 4
 
-=item Interaction with locales
+=item Interaction with Locales
 
-=item Interaction with extensions
+=item Interaction with Extensions
 
-=item speed
+=item Speed
 
 =back
 
@@ -2609,51 +2636,59 @@ module (sometimes unnecessary), B<INSTALL> the module
 
 =item Pragmatic Modules
 
-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
+attributes, attrs, autouse, base, bigint, bignum, bigrat, blib, bytes,
+charnames, constant, diagnostics, encoding, fields, filetest, if, integer,
+less, locale, open, ops, overload, re, sigtrap, sort, strict, subs,
+threads, utf8, vars, vmsish, warnings, warnings::register
 
 =item Standard Modules
 
-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, File::Basename,
-File::CheckTree, File::Compare, File::Copy, File::DosGlob, File::Find,
-File::Path, File::Spec, File::Spec::Cygwin, File::Spec::Epoc,
-File::Spec::Functions, File::Spec::Mac, File::Spec::OS2, File::Spec::Unix,
+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, Config, Cwd, DB, DB_File, Devel::SelfStubber, Digest,
+DirHandle, Dumpvalue, Encode, English, Env, Errno, Exporter,
+Exporter::Heavy, ExtUtils::Command, ExtUtils::Command::MM,
+ExtUtils::Constant, ExtUtils::Embed, ExtUtils::Install,
+ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_Any,
+ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS,
+ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_UWIN,
+ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
+ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker, ExtUtils::Manifest,
+ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::Packlist,
+ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree,
+File::Compare, File::Copy, File::DosGlob, File::Find, File::Path,
+File::Spec, File::Spec::Cygwin, File::Spec::Epoc, File::Spec::Functions,
+File::Spec::Mac, File::Spec::NW5, 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,
+I18N::Collate, I18N::LangTags, I18N::LangTags::List, IO, 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, 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,
+Memoize::NDBM_File, Memoize::SDBM_File, 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::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::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
+Text::Soundex, Text::Tabs, Text::Wrap, Thread, Thread::Queue,
+Thread::Semaphore, 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
 
@@ -3019,8 +3054,8 @@ my C program; what am I doing wrong?
 
 =back
 
-=head2 perlfaq4 - Data Manipulation ($Revision: 1.21 $, $Date: 2002/05/06
-13:08:46 $)
+=head2 perlfaq4 - Data Manipulation ($Revision: 1.25 $, $Date: 2002/05/30
+07:04:25 $)
 
 =over 4
 
@@ -3040,10 +3075,10 @@ Trig functions?
 
 =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:>
+How do I convert hexadecimal into decimal, How do I convert from decimal to
+hexadecimal, How do I convert from octal to decimal, How do I convert from
+decimal to octal, How do I convert from binary to decimal, How do I convert
+from decimal to binary
 
 =item Why doesn't & work the way I want it to?
 
@@ -3236,8 +3271,8 @@ array of hashes or arrays?
 
 =back
 
-=head2 perlfaq5 - Files and Formats ($Revision: 1.15 $, $Date: 2002/04/12
-02:02:05 $)
+=head2 perlfaq5 - Files and Formats ($Revision: 1.18 $, $Date: 2002/05/30
+07:04:25 $)
 
 =over 4
 
@@ -3329,8 +3364,8 @@ protected files?  Isn't this a bug in Perl?
 
 =back
 
-=head2 perlfaq6 - Regular Expressions ($Revision: 1.10 $, $Date: 2002/04/07
-18:32:57 $)
+=head2 perlfaq6 - Regular Expressions ($Revision: 1.12 $, $Date: 2002/06/01
+22:31:09 $)
 
 =over 4
 
@@ -3475,8 +3510,8 @@ is in scope?
 
 =back
 
-=head2 perlfaq8 - System Interaction ($Revision: 1.7 $, $Date: 2002/04/18
-14:23:15 $)
+=head2 perlfaq8 - System Interaction ($Revision: 1.8 $, $Date: 2002/05/16
+12:41:42 $)
 
 =over 4
 
@@ -4469,8 +4504,8 @@ SvSetSV, SvSetSV_nosteal, SvSHARE
 
 =item Memory Management
 
-Copy, Move, New, Newc, NEWSV, Newz, Renew, Renewc, Safefree, savepv,
-savepvn, savesharedpv, StructCopy, Zero
+Copy, Move, New, Newc, NEWSV, Newz, Poison, Renew, Renewc, Safefree,
+savepv, savepvn, savesharedpv, StructCopy, Zero
 
 =item Miscellaneous Functions
 
@@ -4669,7 +4704,7 @@ B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
 
 =item Co-existence with stdio
 
-B<PerlIO_importFILE(f,flags)>, B<PerlIO_exportFILE(f,flags)>,
+B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>,
 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
 
 =item "Fast gets" Functions
@@ -4710,12 +4745,10 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =item Unicode
 
-=item use Thread for iThreads
-
-=item make perl_clone optionally clone ops
-
 =item Work out exit/die semantics for threads
 
+=item Better support for nonpreemptive threading systems like GNU pth
+
 =item Typed lexicals for compiler
 
 =item Compiler workarounds for Win32
@@ -4740,8 +4773,6 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =item Locales
 
-=item Thread-safe regexes
-
 =item Arithmetic on non-Arabic numerals
 
 =item POSIX Unicode character classes
@@ -4814,8 +4845,6 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =item Cache recently used regexps
 
-=item Re-entrant functions
-
 =item Cross-compilation support
 
 =item Bit-shifting bitvectors
@@ -5073,7 +5102,7 @@ NFS, rsync'ing the patches
 
 =item Why rsync the source tree
 
-It's easier to rsync the source tree, It's more recent, It's more reliable
+It's easier to rsync the source tree, It's more reliable
 
 =item Why rsync the patches
 
@@ -5149,7 +5178,7 @@ ucheck.third, test.torture torturetest, utest ucheck test.utf8 check.utf8
 
 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
 
-=item Compaq's/Digital's Third Degree
+=item Compaq's/Digital's/HP's Third Degree
 
 =item PERL_DESTRUCT_LEVEL
 
@@ -5256,6 +5285,8 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item Understanding of Numbers
 
+=item Arrays now always interpolate into double-quoted strings [561]
+
 =item Miscellaneous Changes
 
 =back
@@ -5298,7 +5329,7 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item Changed Internals
 
-=item Security Vulnerability Closed
+=item Security Vulnerability Closed [561]
 
 =item New Tests
 
@@ -5308,10 +5339,22 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item AIX
 
-=item Amiga Perl Invoking Mystery
+=item Alpha systems with old gccs fail several tests
+
+=item AmigaOS
+
+=item BeOS
+
+=item Cygwin "unable to remap"
+
+=item ext/threads/t/libc
+
+=item FreeBSD built with ithreads coredumps reading large directories
 
 =item FreeBSD Failing locale Test 117 For ISO8859-15 Locales
 
+=item IRIX fails ext/List/Util/t/shuffle.t
+
 =item Modifying $_ Inside for(..)
 
 =item mod_perl 1.26 Doesn't Build With Threaded Perl
@@ -5320,22 +5363,38 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
 
+=item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
+
 =item Linux With Sfio Fails op/misc Test 48
 
+=item libwww-perl (LWP) fails base/date #51
+
 =item Mac OS X
 
+=item OS/2 Test Failures
+
 =item op/sprintf tests 91, 129, and 130
 
 =item Solaris 2.5
 
+=item Solaris x86 Fails Tests With -Duse64bitint
+
+=item SUPER-UX (NEC SX)
+
+=item PDL failing some tests
+
+=item Term::ReadKey not working on Win32
+
 =item Failure of Thread (5.005-style) tests
 
-=item UNICOS
+=item Timing problems
 
 =item UNICOS/mk
 
 =item UTS
 
+=item VOS (Stratus)
+
 =item VMS
 
 =item Win32
@@ -5346,13 +5405,15 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item Localising Tied Arrays and Hashes Is Broken
 
-=item Self-tying of Arrays and Hashes Is Forbidden
+=item Self-tying Problems
+
+=item Tied/Magical Array/Hash Elements Do Not Autovivify
 
 =item Building Extensions Can Fail Because Of Largefiles
 
 =item Unicode Support on EBCDIC Still Spotty
 
-=item The Compiler Suite Is Still Experimental
+=item The Compiler Suite Is Still Very Experimental
 
 =item The Long Double Support Is Still Experimental
 
@@ -6096,8 +6157,6 @@ C<PATCHLEVEL> is now C<PERL_VERSION>
 
 =item Known test failures
 
-, , 
-
 =item EBCDIC platforms not fully supported
 
 =item UNICOS/mk CC failures during Configure run
@@ -6933,6 +6992,8 @@ long, Process terminated by SIG%s
 
 =over 4
 
+=item NOTE
+
 =item SYNOPSIS
 
 =back
@@ -6985,6 +7046,8 @@ B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
 
 =back
 
+=item PERL 5.8.0 BROKEN IN AMIGAOS
+
 =item AUTHORS
 
 =item SEE ALSO
@@ -7007,7 +7070,7 @@ R4 x86, R4 PPC
 
 =item Contact Information
 
-=item Update 2002-03-02
+=item Update 2002-05-30
 
 =back
 
@@ -7106,7 +7169,7 @@ C<PATH>, I<nroff>, Permissions
 =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>)
+C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
 
 =item Configure-time Options for Perl on Cygwin
 
@@ -7189,6 +7252,50 @@ Source, Compiled Module Source, Perl Modules/Scripts
 
 =back
 
+=head2 perldos - Perl under DOS, W31, W95.
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Prerequisites for Compiling Perl on DOS
+
+DJGPP, Pthreads
+
+=item Shortcomings of Perl under DOS
+
+=item Building Perl on DOS
+
+=item Testing Perl on DOS
+
+=item Installation of Perl on DOS
+
+=back
+
+=item BUILDING AND INSTALLING MODULES ON DOS
+
+=over 4
+
+=item Building Prerequisites for Perl on DOS
+
+=item Unpacking CPAN Modules on DOS
+
+=item Building Non-XS Modules on DOS
+
+=item Building XS Modules on DOS
+
+=back
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
 =head2 perlepoc, README.epoc - Perl for EPOC
 
 =over 4
@@ -7221,6 +7328,26 @@ Source, Compiled Module Source, Perl Modules/Scripts
 
 =back
 
+=head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item FreeBSD core dumps from readdir_r with ithreads
+
+=item $^X doesn't always contain a full path in FreeBSD
+
+=item Perl will no more be part of "base FreeBSD"
+
+=back
+
+=item AUTHOR
+
+=back
+
 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
 (HP-UX) systems
 
@@ -7260,6 +7387,8 @@ Source, Compiled Module Source, Perl Modules/Scripts
 
 =item 64-bit Perl on HP-UX
 
+=item Oracle on HP-UX
+
 =item GDBM and Threads on HP-UX
 
 =item NFS filesystems and utime(2) on HP-UX
@@ -7294,6 +7423,32 @@ Source, Compiled Module Source, Perl Modules/Scripts
 
 =back
 
+=head2 perlirix, README.irix - Perl version 5 on Irix systems
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item Building 32-bit Perl in Irix
+
+=item Building 64-bit Perl in Irix
+
+=item About Compiler Versions of Irix
+
+=item Linker Problems in Irix
+
+=item Malloc in Irix
+
+=item Building with threads
+
+=back
+
+=item AUTHOR
+
+=back
+
 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
 systems
 
@@ -7396,7 +7551,7 @@ public_html/feedback.cgi, src/perl-5.6.0-mpe
 
 =item Setup
 
-Buildtype.bat, SetNWBld.bat, MPKBuild.bat
+SetNWBld.bat, Buildtype.bat
 
 =item Make
 
@@ -7410,8 +7565,6 @@ Buildtype.bat, SetNWBld.bat, MPKBuild.bat
 
 =item Build new extensions
 
-=item Known Issues
-
 =item Acknowledgements
 
 =item Authors
@@ -7901,6 +8054,8 @@ Digital UNIX formerly known as DEC OSF/1) systems
 
 =item ext/ODBM_File/odbm Test Failing With Static Builds
 
+=item Perl Fails Because Of Unresolved Symbol sockatmark
+
 =item AUTHOR
 
 =back
@@ -8060,8 +8215,12 @@ LIST, waitpid PID,FLAGS
 
 =item Restrictions of Perl on VOS
 
+=item Handling of underflow and overflow
+
 =back
 
+=item TEST STATUS
+
 =item SUPPORT STATUS
 
 =item AUTHOR
@@ -8070,6 +8229,53 @@ LIST, waitpid PID,FLAGS
 
 =back
 
+=head2 perlwin32 - Perl under Windows
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Setting Up Perl on Win32
+
+Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform
+SDK 64-bit Compiler, Mingw32 with GCC
+
+=item Building
+
+=item Testing Perl on Win32
+
+=item Installation of Perl on Win32
+
+=item Usage Hints for Perl on Win32
+
+Environment Variables, File Globbing, Using perl from the command line,
+Building Extensions, Command-line Wildcard Expansion, Win32 Specific
+Extensions, Notes on 64-bit Windows
+
+=item Running Perl Scripts
+
+Miscellaneous Things
+
+=back
+
+=item BUGS AND CAVEATS
+
+=item AUTHORS
+
+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 SEE ALSO
+
+=item HISTORY
+
+=back
+
 =head1 PRAGMA DOCUMENTATION
 
 =head2 attrs - set/get attributes of a subroutine (deprecated)
@@ -8138,8 +8344,8 @@ data structures between threads
 
 =item FUNCTIONS
 
-share VARIABLE, lock VARIABLE, unlock VARIABLE, cond_wait VARIABLE,
-cond_signal VARIABLE, cond_broadcast VARIABLE
+share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
+cond_broadcast VARIABLE
 
 =item NOTES
 
@@ -8166,7 +8372,7 @@ BLOCK;
 
 =item WARNINGS
 
-Cleanup skipped %d active threads
+A thread exited while %d other threads were still running
 
 =item BUGS / TODO
 
@@ -8413,7 +8619,7 @@ escapes
 
 =item charnames::viacode(code)
 
-=item charnames::vianame(code)
+=item charnames::vianame(name)
 
 =item ALIASES
 
@@ -8600,6 +8806,8 @@ point
 
 =item CAVEATS
 
+=item NOTES
+
 =item SEE ALSO
 
 =item AUTHOR
@@ -8833,7 +9041,7 @@ BLOCK;
 
 =item WARNINGS
 
-Cleanup skipped %d active threads
+A thread exited while %d other threads were still running
 
 =item BUGS / TODO
 
@@ -8859,8 +9067,8 @@ structures between threads
 
 =item FUNCTIONS
 
-share VARIABLE, lock VARIABLE, unlock VARIABLE, cond_wait VARIABLE,
-cond_signal VARIABLE, cond_broadcast VARIABLE
+share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
+cond_broadcast VARIABLE
 
 =item NOTES
 
@@ -10462,7 +10670,8 @@ 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>
+C<gmtime_r_proto>, C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>,
+C<gzip>
 
 =item h
 
@@ -12777,7 +12986,7 @@ 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, SITEPREFIX, SKIP,
+PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT, PRINT_PREREQ, SITEPREFIX, SKIP,
 TYPEMAPS, VENDORPREFIX, VERBINST, VERSION, VERSION_FROM, XS, XSOPT,
 XSPROTOARG, XS_VERSION
 
@@ -13212,6 +13421,36 @@ rel2abs
 
 =back
 
+=head2 File::Spec::NW5 - methods for NW5 file specs
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+devnull
+
+=back
+
+tmpdir
+
+catfile
+
+canonpath
+
+splitpath
+
+splitdir
+
+catpath
+
+=over 4
+
+=item SEE ALSO
+
+=back
+
 canonpath
 
 splitpath
@@ -15108,6 +15347,10 @@ Canonical notation, Input, Output
 
 =item bmod
 
+=item bmodinv
+
+=item bmodpow
+
 =item bpow
 
 =item blsft
@@ -15277,15 +15520,23 @@ the same terms as Perl itself.
 
 =over 4
 
-=item new
+=item new()
 
-=item numerator
+=item numerator()
 
-=item denominator
+=item denominator()
 
        $d = $x->denominator();
 
-=item parts
+=item parts()
+
+=item as_number()
+
+=item bfac()
+
+=item blog()
+
+=item bround()/round()/bfround()
 
 =back
 
@@ -15773,9 +16024,10 @@ MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
 
 =item Functions
 
-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]);
+Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->source_verify( {
+0 | 1 } );, $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->ping($host
+[, $timeout]);, $p->open($host);, $p->close();, pingecho($host [,
+$timeout]);
 
 =back
 
@@ -15813,6 +16065,8 @@ ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
 DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
 quit ()
 
+=item ADDRESSES
+
 =item SEE ALSO
 
 =item AUTHOR
@@ -16401,7 +16655,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, 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
@@ -17783,6 +18037,12 @@ C<Storable::is_retrieving>
 
 =item BUGS
 
+=over 4
+
+=item 64 bit data in perl 5.6.0 and 5.6.1
+
+=back
+
 =item CREDITS
 
 =item AUTHOR
@@ -18213,7 +18473,7 @@ B<_leader_width>
 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
-%s>, C<FAILED--Further testing stopped%s>
+%s>, C<FAILED--Further testing stopped: %s>
 
 =item ENVIRONMENT
 
@@ -18667,7 +18927,7 @@ unexpand(1)
 
 =back
 
-=head2 Thread - manipulate threads in Perl
+=head2 Thread - manipulate threads in Perl (for old code only)
 
 =over 4
 
@@ -18693,10 +18953,12 @@ join, eval, detach, equal, tid, flags, done
 
 =back
 
-=head2 Thread::Queue - thread-safe queues
+=head2 Thread::Queue - thread-safe queues (for old code only)
 
 =over 4
 
+=item CAVEAT
+
 =item SYNOPSIS
 
 =item DESCRIPTION
@@ -18709,10 +18971,12 @@ new, enqueue LIST, dequeue, dequeue_nb, pending
 
 =back
 
-=head2 Thread::Semaphore - thread-safe semaphores
+=head2 Thread::Semaphore - thread-safe semaphores (for old code only)
 
 =over 4
 
+=item CAVEAT
+
 =item SYNOPSIS
 
 =item DESCRIPTION
@@ -19280,7 +19544,7 @@ Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME),
 Win32::GetLastError(), Win32::GetLongPathName(PATHNAME),
-Win32::GetNextAvailDrive(), Win32::GetOSVersion(),
+Win32::GetNextAvailDrive(), Win32::GetOSVersion(), Win32::GetOSName(),
 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
@@ -19296,6 +19560,33 @@ Win32::UnregisterServer(LIBRARYNAME)
 
 =back
 
+=head2 XS::APItest - Test the perl C API
+
+=over 4
+
+=item SYNOPSIS
+
+=item ABSTRACT
+
+=item DESCRIPTION
+
+=over 4
+
+=item EXPORT
+
+B<print_double>, B<print_long_double>, B<have_long_double>, B<print_nv>,
+B<print_iv>, B<print_uv>, B<print_int>, B<print_long>, B<print_float>
+
+=back
+
+=item SEE ALSO
+
+=item AUTHORS
+
+=item COPYRIGHT AND LICENSE
+
+=back
+
 =head2 XS::Typemap - module to test the XS typemaps distributed with perl
 
 =over 4