Regen toc.
[p5sagit/p5-mst-13.2.git] / pod / perltoc.pod
index 35d0b47..28ef019 100644 (file)
@@ -1717,6 +1717,12 @@ safe subprocesses, sockets, and semaphores)
 
 =item Signals
 
+=over 4
+
+=item Handling the SIGHUP Signal in Daemons
+
+=back
+
 =item Named Pipes
 
 =over 4
@@ -1887,6 +1893,8 @@ string
 
 =item Basic Thread Support
 
+=item A Note about the Examples
+
 =item Creating Threads
 
 =item Giving up control
@@ -2106,6 +2114,8 @@ portable
 
 =item System Interaction
 
+=item Command names versus file pathnames
+
 =item Interprocess Communication (IPC)
 
 =item External Subroutines (XS)
@@ -2334,8 +2344,6 @@ LC_NUMERIC, LC_TIME, LANG
 
 =item Questions With Answers
 
-, , , , , , 
-
 =item Hexadecimal Notation
 
 =item Further Resources
@@ -2649,9 +2657,9 @@ 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::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,
+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, IO, IPC::Open2,
 IPC::Open3, Locale::Constants, Locale::Country, Locale::Currency,
 Locale::Language, Locale::Maketext, Locale::Maketext::TPJ13,
@@ -3041,8 +3049,8 @@ my C program; what am I doing wrong?
 
 =back
 
-=head2 perlfaq4 - Data Manipulation ($Revision: 1.24 $, $Date: 2002/05/20
-16:50:08 $)
+=head2 perlfaq4 - Data Manipulation ($Revision: 1.25 $, $Date: 2002/05/30
+07:04:25 $)
 
 =over 4
 
@@ -3062,10 +3070,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?
 
@@ -3183,6 +3191,8 @@ intersection of two arrays?
 
 =item How do I process/modify each element of an array?
 
+=item How do I select a random element from an array?
+
 =item How do I permute N elements of a list?
 
 =item How do I sort an array by (anything)?
@@ -3256,8 +3266,8 @@ array of hashes or arrays?
 
 =back
 
-=head2 perlfaq5 - Files and Formats ($Revision: 1.17 $, $Date: 2002/05/23
-19:33:50 $)
+=head2 perlfaq5 - Files and Formats ($Revision: 1.18 $, $Date: 2002/05/30
+07:04:25 $)
 
 =over 4
 
@@ -3349,8 +3359,8 @@ protected files?  Isn't this a bug in Perl?
 
 =back
 
-=head2 perlfaq6 - Regular Expressions ($Revision: 1.11 $, $Date: 2002/05/23
-15:47:37 $)
+=head2 perlfaq6 - Regular Expressions ($Revision: 1.12 $, $Date: 2002/06/01
+22:31:09 $)
 
 =over 4
 
@@ -5222,6 +5232,8 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =back
 
+=head2 perldelta - what is new for perl v5.8.0
+
 =over 4
 
 =item DESCRIPTION
@@ -5268,6 +5280,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
@@ -5310,7 +5324,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
 
@@ -5320,12 +5334,22 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item AIX
 
+=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
@@ -5334,26 +5358,34 @@ 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 op/sprintf tests 91, 129, and 130
 
 =item Solaris 2.5
 
-=item Stratus VOS
+=item SUPER-UX (NEC SX)
 
 =item Term::ReadKey not working on Win32
 
 =item Failure of Thread (5.005-style) tests
 
+=item Timing problems
+
 =item UNICOS
 
 =item UNICOS/mk
 
 =item UTS
 
+=item VOS (Stratus)
+
 =item VMS
 
 =item Win32
@@ -5364,7 +5396,7 @@ 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 Building Extensions Can Fail Because Of Largefiles
 
@@ -6114,8 +6146,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
@@ -7025,7 +7055,7 @@ R4 x86, R4 PPC
 
 =item Contact Information
 
-=item Update 2002-05-25
+=item Update 2002-05-30
 
 =back
 
@@ -7283,6 +7313,26 @@ DJGPP, Pthreads
 
 =back
 
+=head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item core dumps from readdir_r with ithreads
+
+=item $^X doesn't always contain a full path
+
+=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
 
@@ -7322,6 +7372,8 @@ DJGPP, Pthreads
 
 =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
@@ -7356,6 +7408,32 @@ DJGPP, Pthreads
 
 =back
 
+=head2 perlirix, README.irix - Perl version 5 on Irix systems
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item Building 32-bit
+
+=item Building 64-bot
+
+=item About Compiler Versions
+
+=item Linker Problems
+
+=item Malloc
+
+=item Building with threads
+
+=back
+
+=item AUTHOR
+
+=back
+
 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
 systems
 
@@ -7458,7 +7536,7 @@ public_html/feedback.cgi, src/perl-5.6.0-mpe
 
 =item Setup
 
-SetNWDef.bat, Custom Build Environment, Buildtype.bat, SetNWBld.bat
+SetNWBld.bat, Buildtype.bat
 
 =item Make
 
@@ -7470,8 +7548,6 @@ SetNWDef.bat, Custom Build Environment, Buildtype.bat, SetNWBld.bat
 
 =item Install
 
-=item Build new extensions
-
 =item Acknowledgements
 
 =item Authors
@@ -8161,8 +8237,11 @@ SDK 64-bit Compiler, Mingw32 with GCC
 
 Environment Variables, File Globbing, Using perl from the command line,
 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
-Extensions, Notes on 64-bit Windows, Running Perl Scripts, Miscellaneous
-Things
+Extensions, Notes on 64-bit Windows
+
+=item Running Perl Scripts
+
+Miscellaneous Things
 
 =back
 
@@ -8710,6 +8789,8 @@ point
 
 =item CAVEATS
 
+=item NOTES
+
 =item SEE ALSO
 
 =item AUTHOR
@@ -10572,7 +10653,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
 
@@ -10646,7 +10728,7 @@ C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
 =item p
 
 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
-C<perl>, C<perl_patchlevel>
+C<perl5>, C<perl>, C<perl_patchlevel>
 
 =item P
 
@@ -10716,7 +10798,7 @@ C<xlibpth>, C<xs_apiversion>
 
 =item y
 
-C<yacc>, C<yaccflags>
+C<yaccflags>
 
 =item z
 
@@ -13322,6 +13404,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
@@ -15218,6 +15330,10 @@ Canonical notation, Input, Output
 
 =item bmod
 
+=item bmodinv
+
+=item bmodpow
+
 =item bpow
 
 =item blsft
@@ -15387,15 +15503,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
 
@@ -15923,6 +16047,8 @@ ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
 DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
 quit ()
 
+=item ADDRESSES
+
 =item SEE ALSO
 
 =item AUTHOR
@@ -16511,7 +16637,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
@@ -17893,6 +18019,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
@@ -18777,7 +18909,7 @@ unexpand(1)
 
 =back
 
-=head2 Thread - manipulate threads in Perl
+=head2 Thread - manipulate threads in Perl (for old code only)
 
 =over 4
 
@@ -18803,10 +18935,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
@@ -18819,10 +18953,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
@@ -19390,7 +19526,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),