X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperltoc.pod;h=8a23663a08abafbaf99069847521fad28f853d03;hb=dd2155a49b710f23bc6d72169e5b1d71d8b3aa03;hp=109b1f1377386ae66f9051b9c88fa0434d66f5d0;hpb=e934609f7db1163b003ba7314f8d52ebfc1e2f12;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perltoc.pod b/pod/perltoc.pod index 109b1f1..8a23663 100644 --- 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, order of arguments, 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 @@ -1038,7 +1039,8 @@ ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80, 0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R, $EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, ${^TAINT}, $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS}, ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, ARGV, -$ARGV, @ARGV, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr} +$ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, +$SIG{expr} =item Error Indicators @@ -1851,8 +1853,8 @@ application, Thread-safety of extensions =item Flavors of Perl numeric operations -Arithmetic operators except, C, Arithmetic operators except, -C, Bitwise operators, C, Bitwise operators, C, Other +mathematical operators, Bitwise operators, Bitwise operators during C, Operators which expect an integer, Operators which expect a string @@ -1888,7 +1890,7 @@ string =item What kind of threads are Perl threads? -=item Threadsafe Modules +=item Thread-Safe Modules =item Thread Basics @@ -1956,7 +1958,9 @@ string =item Performance considerations -=item Threadsafety of System Libraries +=item Process-scope Changes + +=item Thread-Safety of System Libraries =item Conclusion @@ -2674,13 +2678,13 @@ 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, +PerlIO, PerlIO::via::QuotedPrint, 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, Thread::Queue, @@ -2699,18 +2703,46 @@ Unicode::UCD, User::grent, User::pwent, Win32 =item Africa +South Africa + =item Asia +China, India, Indonesia, Israel, Japan, Korea, Philippines, Russian +Federation, Saudi Arabia, Singapore, South Korea, Taiwan, Thailand + =item Central America +Costa Rica + =item Europe +Austria, Belgium, Bulgaria, Croatia, Czech Republic, Denmark, Estonia, +Finland, France, Germany, Greece, Hungary, Iceland, Ireland, Italy, Latvia, +Lithuania, Netherlands, Norway, Poland, Portugal, Romania, Russia, +Slovakia, Slovenia, Spain, Sweden, Switzerland, Turkey, Ukraine, United +Kingdom + =item North America +Alberta, Manitoba, Nova Scotia, Ontario, Quebec, Mexico + +=item United States + +Alabama, California, Colorado, Delaware, District of Columbia, Florida, +Illinois, Indiana, Kentucky, Massachusetts, Michigan, New Jersey, New York, +North Carolina, Ohio, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas, +Utah, Virginia, ashington, Wisconsin + =item Oceania +Australia, New Zealand + =item South America +Argentina, Brazil, Chile + +=item RSYNC Mirrors + =back =item Modules: Creation, Use, and Abuse @@ -4672,7 +4704,7 @@ Set_ptrcnt =item Extension Layers -":encoding", ":Scalar", ":Via" +":encoding", ":scalar", ":via" =back @@ -5255,18 +5287,22 @@ I =item AIX Dynaloading -=item Attributes for C variables now handled at run-time. +=item Attributes for C variables now handled at run-time =item Socket Extension Dynamic in VMS =item IEEE-format Floating Point Default on OpenVMS Alpha +=item New Unicode Semantics (no more C, almost) + =item New Unicode Properties =item REF(...) Instead Of SCALAR(...) =item pack/unpack D/F recycled +=item glob() now returns filenames in alphabetical order + =item Deprecations =back @@ -5275,14 +5311,16 @@ I =over 4 +=item Unicode Overhaul + =item PerlIO is Now The Default +=item ithreads + =item Restricted Hashes =item Safe Signals -=item Unicode Overhaul - =item Understanding of Numbers =item Arrays now always interpolate into double-quoted strings [561] @@ -5337,6 +5375,42 @@ I =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 @@ -5347,19 +5421,15 @@ I =item Cygwin "unable to remap" -=item ext/threads/t/libc +=item Cygwin ndbm tests fail on FAT + +=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 @@ -5367,10 +5437,10 @@ I =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 @@ -5381,16 +5451,8 @@ I =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 Timing problems - -=item Unicode in package/class and subroutine names does not work - =item UNICOS/mk =item UTS @@ -5405,20 +5467,8 @@ I =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 The Long Double Support Is Still Experimental - =item Seen In Perl 5.7 But Gone Now =back @@ -7201,6 +7251,8 @@ I, Win9x and C, Compiler/Preprocessor defines =item File Permissions on Cygwin +=item NDBM_File does not work on FAT filesystems + =item Script Portability on Cygwin Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous @@ -8309,37 +8361,6 @@ method, locked =back -=head2 threadshared::queue, threads::shared::queue - thread-safe queues - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=item FUNCTIONS AND METHODS - -new, enqueue LIST, dequeue, dequeue_nb, pending - -=item SEE ALSO - -=back - -=head2 threadshared::semaphore, threads::shared::semaphore - thread-safe -semaphores - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=item FUNCTIONS AND METHODS - -new, new NUMBER, down, down NUMBER, up, up NUMBER - -=back - =head2 threadshared::shared, threads::shared - Perl extension for sharing data structures between threads @@ -8376,17 +8397,19 @@ from perl =item DESCRIPTION $thread = threads->create(function, LIST), $thread->join, $thread->detach, -threads->self, $thread->tid, threads->yield();, threads->list();, async -BLOCK; +threads->self, $thread->tid, threads->object( tid ), threads->yield();, +threads->list();, async BLOCK; =item WARNINGS A thread exited while %d other threads were still running -=item BUGS / TODO +=item TODO + +=item BUGS -Parent-Child threads, tid is I32, Returning objects, PERL_OLD_SIGNALS are -not threadsafe, will not be +Parent-Child threads, Returning objects, Creating threads inside BEGIN +blocks, PERL_OLD_SIGNALS are not threadsafe, will not be =item AUTHOR and COPYRIGHT @@ -9045,17 +9068,19 @@ from perl =item DESCRIPTION $thread = threads->create(function, LIST), $thread->join, $thread->detach, -threads->self, $thread->tid, threads->yield();, threads->list();, async -BLOCK; +threads->self, $thread->tid, threads->object( tid ), threads->yield();, +threads->list();, async BLOCK; =item WARNINGS A thread exited while %d other threads were still running -=item BUGS / TODO +=item TODO + +=item BUGS -Parent-Child threads, tid is I32, Returning objects, PERL_OLD_SIGNALS are -not threadsafe, will not be +Parent-Child threads, Returning objects, Creating threads inside BEGIN +blocks, PERL_OLD_SIGNALS are not threadsafe, will not be =item AUTHOR and COPYRIGHT @@ -9089,37 +9114,6 @@ cond_broadcast VARIABLE =back -=head2 threadshared::queue, threads::shared::queue - thread-safe queues - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=item FUNCTIONS AND METHODS - -new, enqueue LIST, dequeue, dequeue_nb, pending - -=item SEE ALSO - -=back - -=head2 threadshared::semaphore, threads::shared::semaphore - thread-safe -semaphores - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=item FUNCTIONS AND METHODS - -new, new NUMBER, down, down NUMBER, up, up NUMBER - -=back - =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source code @@ -13701,6 +13695,8 @@ TopSystemUID =item DESCRIPTION +=item BUGS + =item NOTE =item AUTHOR @@ -14967,7 +14963,7 @@ C, C 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 @@ -16017,9 +16013,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 @@ -16028,6 +16024,8 @@ $timeout]); =item NOTES +=item INSTALL + =item AUTHORS =item COPYRIGHT @@ -16552,7 +16550,7 @@ name space =item DESCRIPTION -unix, stdio, perlio, crlf, utf8, bytes, raw +unix, stdio, perlio, crlf, utf8, bytes, raw, pop =over 4 @@ -17168,7 +17166,7 @@ escape EE%sE, %s:%d: Unknown formatting code %s, %s:%d: Unmatched =back -=head2 Pod::ParseLink -- Parse an LEE formatting code in POD text +=head2 Pod::ParseLink - Parse an LEE formatting code in POD text =over 4 @@ -17176,6 +17174,8 @@ escape EE%sE, %s:%d: Unknown formatting code %s, %s:%d: Unmatched =item DESCRIPTION +=item SEE ALSO + =item AUTHOR =item COPYRIGHT AND LICENSE @@ -17718,8 +17718,8 @@ text =back -=head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII -text with format escapes +=head2 Pod::Text::Termcap - Convert POD data to ASCII text with format +escapes =over 4 @@ -18191,7 +18191,7 @@ ANSI_COLORS_DISABLED =item AUTHORS -=item LICENSE +=item COPYRIGHT AND LICENSE =back @@ -18971,12 +18971,10 @@ join, eval, detach, equal, tid, flags, done =back -=head2 Thread::Queue - thread-safe queues (for old code only) +=head2 Thread::Queue - thread-safe queues =over 4 -=item CAVEAT - =item SYNOPSIS =item DESCRIPTION @@ -18989,12 +18987,10 @@ new, enqueue LIST, dequeue, dequeue_nb, pending =back -=head2 Thread::Semaphore - thread-safe semaphores (for old code only) +=head2 Thread::Semaphore - thread-safe semaphores =over 4 -=item CAVEAT - =item SYNOPSIS =item DESCRIPTION