X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperltoc.pod;h=8a23663a08abafbaf99069847521fad28f853d03;hb=d672126634c5e568812ed35d4c8ea53a9a55ee4c;hp=683026d423534c5eb6099f7338fe7103684c9819;hpb=a9d2c4968fafc4250f2b18ecf25005d42ddccbf2;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perltoc.pod b/pod/perltoc.pod index 683026d..8a23663 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -400,54 +400,53 @@ in perl5 I<-X> FILEHANDLE, I<-X> EXPR, I<-X>, abs VALUE, abs, accept NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME, -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, 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, exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, -fcntl FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock -FILEHANDLE,OPERATION, fork, format, formline PICTURE,LIST, getc FILEHANDLE, -getc, getlogin, getpeername SOCKET, getpgrp PID, getppid, getpriority -WHICH,WHO, getpwnam NAME, getgrnam NAME, gethostbyname NAME, getnetbyname -NAME, getprotobyname NAME, getpwuid UID, getgrgid GID, getservbyname -NAME,PROTO, gethostbyaddr ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, -getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent, getgrent, -gethostent, getnetent, getprotoent, getservent, setpwent, setgrent, -sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, setservent -STAYOPEN, endpwent, endgrent, endhostent, endnetent, endprotoent, -endservent, getsockname SOCKET, getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, -glob, gmtime EXPR, goto LABEL, goto EXPR, goto &NAME, grep BLOCK LIST, grep -EXPR,LIST, hex EXPR, hex, import, index STR,SUBSTR,POSITION, index -STR,SUBSTR, int EXPR, int, ioctl FILEHANDLE,FUNCTION,SCALAR, join -EXPR,LIST, keys HASH, kill SIGNAL, LIST, last LABEL, last, lc EXPR, lc, -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 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 +binmode FILEHANDLE, LAYER, 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, 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, +exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, fcntl +FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock FILEHANDLE,OPERATION, +fork, format, formline PICTURE,LIST, getc FILEHANDLE, getc, getlogin, +getpeername SOCKET, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam +NAME, getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname +NAME, getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr +ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER, +getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent, +getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent +STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, +endhostent, endnetent, endprotoent, endservent, getsockname SOCKET, +getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL, +goto EXPR, goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex, +import, index STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl +FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill SIGNAL, LIST, +last LABEL, last, lc EXPR, lc, 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 +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, @@ -456,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 @@ -960,8 +960,8 @@ subname [condition], b postpone subname [condition], b load filename, b compile subname, B line, B *, a [line] command, A line, A *, w expr, W expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [ command ], << command, > ?, > command, >> command, { ?, { [ command ], {{ -command, ! number, ! -number, ! pattern, !! cmd, @ file, H -number, q or -^D, R, |dbcmd, ||dbcmd, command, m expr, M, man [manpage] +command, ! number, ! -number, ! pattern, !! cmd, source file, H -number, q +or ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man [manpage] =item Configurable Options @@ -1039,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 @@ -1852,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 @@ -1889,7 +1890,7 @@ string =item What kind of threads are Perl threads? -=item Threadsafe Modules +=item Thread-Safe Modules =item Thread Basics @@ -1957,7 +1958,9 @@ string =item Performance considerations -=item Threadsafety of System Libraries +=item Process-scope Changes + +=item Thread-Safety of System Libraries =item Conclusion @@ -2374,8 +2377,8 @@ LC_NUMERIC, LC_TIME, LANG =item Important Caveats -Input and Output Disciplines, Regular Expressions, C still needed -to enable UTF-8/UTF-EBCDIC in scripts +Input and Output Layers, Regular Expressions, C still needed to +enable UTF-8/UTF-EBCDIC in scripts =item Byte and Character Semantics @@ -2662,9 +2665,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::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, +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, 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, @@ -2675,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, @@ -2700,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 @@ -4661,10 +4692,11 @@ PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS =item Methods in Detail -name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_CANCRLF, PERLIO_K_FASTGETS, -PERLIO_K_MULTIARG, PERLIO_K_RAW, Pushed, Popped, Open, Getarg, Fileno, Dup, -Read, Write, Seek, Tell, Close, Flush, Fill, Eof, Error, Clearerr, -Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt, Set_ptrcnt +fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF, +PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode, +Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof, +Error, Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt, +Set_ptrcnt =item Core Layers @@ -4672,7 +4704,7 @@ Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt, Set_ptrcnt =item Extension Layers -":encoding", ":Scalar", ":Via" +":encoding", ":scalar", ":via" =back @@ -4704,7 +4736,7 @@ B, B, B =item Co-existence with stdio -B, B, +B, B, B, B =item "Fast gets" Functions @@ -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 FreeBSD built with ithreads coredumps reading large directories - -=item FreeBSD Failing locale Test 117 For ISO8859-15 Locales +=item Cygwin ndbm tests fail on FAT -=item IRIX fails ext/List/Util/t/shuffle.t +=item DJGPP Failures -=item Modifying $_ Inside for(..) +=item FreeBSD built with ithreads coredumps reading large directories -=item mod_perl 1.26 Doesn't Build With Threaded Perl +=item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales -=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,12 @@ 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 =item Solaris 2.5 @@ -5379,14 +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 UNICOS/mk =item UTS @@ -5401,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 @@ -6990,6 +7044,8 @@ long, Process terminated by SIG%s =over 4 +=item NOTE + =item SYNOPSIS =back @@ -7042,6 +7098,8 @@ B, B =back +=item PERL 5.8.0 BROKEN IN AMIGAOS + =item AUTHORS =item SEE ALSO @@ -7193,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 @@ -7334,7 +7394,7 @@ DJGPP, Pthreads =item $^X doesn't always contain a full path in FreeBSD -=item Perl will no more be part of "base FreeBSD" +=item Perl will no longer be part of "base FreeBSD" =back @@ -7435,7 +7495,7 @@ DJGPP, Pthreads =item Malloc in Irix -=item Building with threads +=item Building with threads in Irix =back @@ -7726,11 +7786,13 @@ C, C, OS2::SysInfo(), OS2::BootDrive(), C, C, C, C, C, -OS2::get_control87(), C +OS2::get_control87(), C, +C =item Prebuilt variables: -$OS2::emx_rev, $OS2::emx_env, $OS2::os_ver +$OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork, +$OS2::nsyserror =item Misfeatures @@ -7743,7 +7805,10 @@ C =item Centralized management of resources -C, C +C, C, Treating errors reported by OS/2 API, +C, C, C, +C, C, +C, C, Loading DLLs and ordinals in DLLs =back @@ -7789,6 +7854,8 @@ C, C =over 4 +=item Text-mode filehandles + =item Priorities =item DLL name mangling: pre 5.6.2 @@ -8294,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 @@ -8361,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 -Parent-Child threads, tid is I32, Returning objects, PERL_OLD_SIGNALS are -not threadsafe, will not be +=item BUGS + +Parent-Child threads, Returning objects, Creating threads inside BEGIN +blocks, PERL_OLD_SIGNALS are not threadsafe, will not be =item AUTHOR and COPYRIGHT @@ -8819,7 +8857,7 @@ operations =back -=head2 open - perl pragma to set default disciplines for input and output +=head2 open - perl pragma to set default PerlIO layers for input and output =over 4 @@ -9030,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 @@ -9074,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 @@ -9124,6 +9133,8 @@ utf8::valid(STRING) =back +=item BUGS + =item SEE ALSO =back @@ -12974,15 +12985,15 @@ INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB, INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLVENDORARCH, INSTALLVENDORBIN, INSTALLVENDORLIB, INSTALLVENDORMAN1DIR, INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN, -INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A, -LIBS, LINKTYPE, MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, -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, -TYPEMAPS, VENDORPREFIX, VERBINST, VERSION, VERSION_FROM, XS, XSOPT, -XSPROTOARG, XS_VERSION +INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT, LDDLFLAGS, LDFROM, LIB, +LIBPERL_A, LIBS, LINKTYPE, MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, +MAP_TARGET, 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_FATAL, PREREQ_PM, PREREQ_PRINT, +PRINT_PREREQ, SITEPREFIX, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION, +VERSION_FROM, XS, XSOPT, XSPROTOARG, XS_VERSION =item Additional lowercase attributes @@ -12991,6 +13002,10 @@ tool_autosplit =item Overriding MakeMaker Methods +=item The End Of Cargo Cult Programming + +C< ' '>> + =item Hintsfile support =item Distribution Support @@ -13415,36 +13430,6 @@ 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 @@ -13602,6 +13587,12 @@ catpath =over 4 +=item Note For File::Spec::Win32 Maintainers + +=back + +=over 4 + =item SEE ALSO =back @@ -13704,6 +13695,8 @@ TopSystemUID =item DESCRIPTION +=item BUGS + =item NOTE =item AUTHOR @@ -13908,6 +13901,8 @@ B<$_>, B<$status>, B and B, B =item Object oriented interface +=item Thread Safety + =item Documentation and help texts =item Storing options in a hash @@ -14968,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 @@ -16018,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 @@ -16029,6 +16024,8 @@ $timeout]); =item NOTES +=item INSTALL + =item AUTHORS =item COPYRIGHT @@ -16553,10 +16550,12 @@ name space =item DESCRIPTION -unix, stdio, perlio, crlf, utf8, bytes, raw +unix, stdio, perlio, crlf, utf8, bytes, raw, pop =over 4 +=item Alternatives to raw + =item Defaults and how to override them =back @@ -16567,7 +16566,19 @@ unix, stdio, perlio, crlf, utf8, bytes, raw =back -=head2 PerlIO::Scalar - support module for in-memory IO. +=head2 PerlIO::encoding - encoding layer + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=back + +=head2 PerlIO::scalar - support module for in-memory IO. =over 4 @@ -16577,7 +16588,7 @@ unix, stdio, perlio, crlf, utf8, bytes, raw =back -=head2 PerlIO::Via - Helper class for PerlIO layers implemented in perl +=head2 PerlIO::via - Helper class for PerlIO layers implemented in perl =over 4 @@ -16585,13 +16596,18 @@ unix, stdio, perlio, crlf, utf8, bytes, raw =item DESCRIPTION +=item EXPECTED METHODS + $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]), -$class->OPEN($path,$mode[,$fh]), $class->FDOPEN($fd), -$class->SYSOPEN($path,$imode,$perm,$fh), $obj->FILENO($fh), -$obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh), -$obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh), -$obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh), -$obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh) +$obj->OPEN($path,$mode[,$fh]), $obj->BINMODE([,$fh]), +$obj->FDOPEN($fd[,$fh]), $obj->SYSOPEN($path,$imode,$perm,[,$fh]), +$obj->FILENO($fh), $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), +$obj->FILL($fh), $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), +$obj->TELL($fh), $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), +$obj->SETLINEBUF($fh), $obj->CLEARERR($fh), $obj->ERROR($fh), +$obj->EOF($fh) + +=item EXAMPLES =over 4 @@ -16601,7 +16617,7 @@ $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh) =back -=head2 PerlIO::encoding - encoding layer +=head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings =over 4 @@ -16611,6 +16627,8 @@ $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh) =item SEE ALSO +=item COPYRIGHT + =back =head2 Pod::Checker, podchecker() - check pod documents for syntax errors @@ -17148,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 @@ -17156,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 @@ -17698,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 @@ -18171,7 +18191,7 @@ ANSI_COLORS_DISABLED =item AUTHORS -=item LICENSE +=item COPYRIGHT AND LICENSE =back @@ -18403,6 +18423,8 @@ B<_my_exit> =over 4 +=item THREADS + =item EXAMPLES =item SEE ALSO @@ -18665,6 +18687,8 @@ B B, B +When do I use SKIP vs. TODO? + =over 4 =item Comparison functions @@ -18947,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 @@ -18965,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 @@ -18982,9 +19002,12 @@ new, new NUMBER, down, down NUMBER, up, up NUMBER =back =head2 Thread::Signal - Start a thread which runs signal handlers reliably +(for old code) =over 4 +=item CAVEAT + =item SYNOPSIS =item DESCRIPTION @@ -19554,51 +19577,6 @@ 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, B, B, B, -B, B, B, B, B - -=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 - -=item SYNOPSIS - -=item DESCRIPTION - -=back - -=over 4 - -=item NOTES - -=item AUTHOR - -=back - =head2 XSLoader - Dynamically load C libraries into Perl code =over 4