Thread-safety doc tweaks from Jörg Walter <jwalt@cpan.org>;

[p5sagit/p5-mst-13.2.git] / pod / perltoc.pod

diff --git a/pod/perltoc.pod b/pod/perltoc.pod
index d7d8e89..6f10ab6 100644 (file)
--- a/pod/perltoc.pod
+++ b/pod/perltoc.pod
@@ -455,24 +455,25 @@ EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST,
 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 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///
+/PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, format
+parameter index, flags, vector flag, (minimum) width, precision, or maximum
+width, size, sqrt EXPR, sqrt, srand EXPR, srand, stat FILEHANDLE, stat
+EXPR, stat, study SCALAR, 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
 
@@ -1851,8 +1852,8 @@ application, Thread-safety of extensions
 
 =item Flavors of Perl numeric operations
 
-Arithmetic operators except, C<no integer>, Arithmetic operators except,
-C<use integer>, Bitwise operators, C<no integer>, Bitwise operators, C<use
+Arithmetic operators, ++, Arithmetic operators during C<use integer>, Other
+mathematical operators, Bitwise operators, Bitwise operators during C<use
 integer>, Operators which expect an integer, Operators which expect a
 string
 
@@ -5289,6 +5290,8 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item IEEE-format Floating Point Default on OpenVMS Alpha
 
+=item New Unicode Semantics (no more C<use utf8>, almost)
+
 =item New Unicode Properties
 
 =item REF(...) Instead Of SCALAR(...)
@@ -5369,6 +5372,42 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =over 4
 
+=item The Compiler Suite Is Still Very Experimental
+
+=item Localising Tied Arrays and Hashes Is Broken
+
+=item Building Extensions Can Fail Because Of Largefiles
+
+=item Modifying $_ Inside for(..)
+
+=item mod_perl 1.26 Doesn't Build With Threaded Perl
+
+=item lib/ftmp-security tests warn 'system possibly insecure'
+
+=item libwww-perl (LWP) fails base/date #51
+
+=item PDL failing some tests
+
+=item Perl_get_sv
+
+=item Self-tying Problems
+
+=item ext/threads/t/libc
+
+=item Failure of Thread (5.005-style) tests
+
+=item Timing problems
+
+=item Tied/Magical Array/Hash Elements Do Not Autovivify
+
+=item Unicode in package/class and subroutine names does not work
+
+=back
+
+=item Platform Specific Problems
+
+=over 4
+
 =item AIX
 
 =item Alpha systems with old gccs fail several tests
@@ -5381,21 +5420,13 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item Cygwin ndbm tests fail on FAT
 
-=item DJGPP does not build
-
-=item ext/threads/t/libc
+=item DJGPP Failures
 
 =item FreeBSD built with ithreads coredumps reading large directories
 
 =item FreeBSD Failing locale Test 117 For ISO 8859-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
-
-=item lib/ftmp-security tests warn 'system possibly insecure'
+=item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5
 
 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
 
@@ -5403,10 +5434,10 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item Linux With Sfio Fails op/misc Test 48
 
-=item libwww-perl (LWP) fails base/date #51
-
 =item Mac OS X
 
+=item Mac OS X dyld undefined symbols
+
 =item OS/2 Test Failures
 
 =item op/sprintf tests 91, 129, and 130
@@ -5417,18 +5448,8 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item SUPER-UX (NEC SX)
 
-=item PDL failing some tests
-
-=item Perl_get_sv
-
 =item Term::ReadKey not working on Win32
 
-=item Failure of Thread (5.005-style) tests
-
-=item Timing problems
-
-=item Unicode in package/class and subroutine names does not work
-
 =item UNICOS/mk
 
 =item UTS
@@ -5443,18 +5464,8 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item z/OS (OS/390)
 
-=item Localising Tied Arrays and Hashes Is Broken
-
-=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 Very Experimental
-
 =item Seen In Perl 5.7 But Gone Now
 
 =back
@@ -14947,7 +14958,7 @@ C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
-http://www.cia.gov/cia/publications/factbook/docs/app-f.html
+http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html
 
 =item AUTHOR
 
@@ -15997,9 +16008,9 @@ MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
 
 =item Functions
 
-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 [,
+Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [,
+$timeout]);, $p->source_verify( { 0 | 1 } );, $p->hires( { 0 | 1 } );,
+$p->bind($local_addr);, $p->open($host);, $p->close();, pingecho($host [,
 $timeout]);
 
 =back
@@ -16008,6 +16019,8 @@ $timeout]);
 
 =item NOTES
 
+=item INSTALL
+
 =item AUTHORS
 
 =item COPYRIGHT