X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperltoc.pod;h=8a23663a08abafbaf99069847521fad28f853d03;hb=d672126634c5e568812ed35d4c8ea53a9a55ee4c;hp=cd9046c3e56ad357599000fde9bb08f44e14f26b;hpb=c133c03fba8fc439e535e387ad9f4605abbe0e8c;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perltoc.pod b/pod/perltoc.pod index cd9046c..8a23663 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -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() @@ -398,45 +400,45 @@ 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 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 +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, @@ -453,10 +455,12 @@ 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 BLOCK, sub NAME, sub NAME BLOCK, substr -EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr +/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 @@ -956,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 @@ -1035,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 @@ -1127,6 +1132,8 @@ $ARGV, @ARGV, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr} =item File Locking +=item IO Layers + =back =item SEE ALSO @@ -1715,11 +1722,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 +1801,7 @@ Proto, LocalPort, Listen, Reuse =back -=head2 perlfork - Perl's fork() emulation (EXPERIMENTAL, subject to change) +=head2 perlfork - Perl's fork() emulation =over 4 @@ -1837,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 @@ -1874,7 +1890,7 @@ string =item What kind of threads are Perl threads? -=item Threadsafe Modules +=item Thread-Safe Modules =item Thread Basics @@ -1882,6 +1898,8 @@ string =item Basic Thread Support +=item A Note about the Examples + =item Creating Threads =item Giving up control @@ -1940,6 +1958,10 @@ string =item Performance considerations +=item Process-scope Changes + +=item Thread-Safety of System Libraries + =item Conclusion =item Bibliography @@ -2099,6 +2121,8 @@ portable =item System Interaction +=item Command names versus file pathnames + =item Interprocess Communication (IPC) =item External Subroutines (XS) @@ -2327,8 +2351,6 @@ LC_NUMERIC, LC_TIME, LANG =item Questions With Answers -, , , , , , - =item Hexadecimal Notation =item Further Resources @@ -2339,7 +2361,7 @@ LC_NUMERIC, LC_TIME, LANG =item SEE ALSO -=item ACKNOWLEDGEMENTS +=item ACKNOWLEDGMENTS =item AUTHOR, COPYRIGHT, AND LICENSE @@ -2355,20 +2377,20 @@ 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 +=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 @@ -2388,11 +2410,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 @@ -2630,13 +2652,14 @@ 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, Cwd, DB, DB_File, Devel::SelfStubber, Digest, DirHandle, -Dumpvalue, Encode, English, Env, 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, +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, @@ -2655,19 +2678,20 @@ 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, Pod::t::basic, +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, 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 @@ -2679,18 +2703,46 @@ UNIVERSAL, Unicode::Collate, 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 @@ -3033,8 +3085,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 @@ -3054,10 +3106,10 @@ Trig functions? =item How do I convert between numeric representations? -B, B, B, B, B, B +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? @@ -3250,8 +3302,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 @@ -3343,8 +3395,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 @@ -3489,8 +3541,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 @@ -4483,8 +4535,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 @@ -4640,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 @@ -4651,7 +4704,7 @@ Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt, Set_ptrcnt =item Extension Layers -":encoding", ":Scalar", ":Via" +":encoding", ":scalar", ":via" =back @@ -4683,7 +4736,7 @@ B, B, B =item Co-existence with stdio -B, B, +B, B, B, B =item "Fast gets" Functions @@ -4724,12 +4777,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 @@ -4754,8 +4805,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 @@ -4828,8 +4877,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 @@ -5087,7 +5134,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 @@ -5163,7 +5210,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 @@ -5240,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 @@ -5260,16 +5311,20 @@ 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] + =item Miscellaneous Changes =back @@ -5312,7 +5367,7 @@ I =item Changed Internals -=item Security Vulnerability Closed +=item Security Vulnerability Closed [561] =item New Tests @@ -5320,11 +5375,11 @@ I =over 4 -=item AIX +=item The Compiler Suite Is Still Very Experimental -=item Amiga Perl Invoking Mystery +=item Localising Tied Arrays and Hashes Is Broken -=item FreeBSD Failing locale Test 117 For ISO8859-15 Locales +=item Building Extensions Can Fail Because Of Largefiles =item Modifying $_ Inside for(..) @@ -5332,24 +5387,78 @@ I =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 + +=item AmigaOS + +=item BeOS + +=item Cygwin "unable to remap" + +=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 or Digest::MD5 + =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 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 -=item Failure of Thread (5.005-style) tests +=item Solaris x86 Fails Tests With -Duse64bitint -=item UNICOS +=item SUPER-UX (NEC SX) + +=item Term::ReadKey not working on Win32 =item UNICOS/mk =item UTS +=item VOS (Stratus) + =item VMS =item Win32 @@ -5358,18 +5467,8 @@ I =item z/OS (OS/390) -=item Localising Tied Arrays and Hashes Is Broken - -=item Self-tying of Arrays and Hashes Is Forbidden - -=item Building Extensions Can Fail Because Of Largefiles - =item Unicode Support on EBCDIC Still Spotty -=item The Compiler Suite Is Still Experimental - -=item The Long Double Support Is Still Experimental - =item Seen In Perl 5.7 But Gone Now =back @@ -6110,8 +6209,6 @@ C is now C =item Known test failures -, , - =item EBCDIC platforms not fully supported =item UNICOS/mk CC failures during Configure run @@ -6947,6 +7044,8 @@ long, Process terminated by SIG%s =over 4 +=item NOTE + =item SYNOPSIS =back @@ -6999,6 +7098,8 @@ B, B =back +=item PERL 5.8.0 BROKEN IN AMIGAOS + =item AUTHORS =item SEE ALSO @@ -7021,7 +7122,7 @@ R4 x86, R4 PPC =item Contact Information -=item Update 2002-03-02 +=item Update 2002-05-30 =back @@ -7120,7 +7221,7 @@ C, I, Permissions =item Optional Libraries for Perl on Cygwin C<-lcrypt>, C<-lgdbm> (C), C<-ldb> (C), -C<-lcygipc> (C) +C<-lcygipc> (C), C<-lutil> =item Configure-time Options for Perl on Cygwin @@ -7150,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 @@ -7203,6 +7306,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 @@ -7235,6 +7382,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 longer be part of "base FreeBSD" + +=back + +=item AUTHOR + +=back + =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix (HP-UX) systems @@ -7274,6 +7441,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 @@ -7308,6 +7477,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 in Irix + +=back + +=item AUTHOR + +=back + =head2 perlmachten, README.machten - Perl version 5 on Power MachTen systems @@ -7410,7 +7605,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 @@ -7424,8 +7619,6 @@ Buildtype.bat, SetNWBld.bat, MPKBuild.bat =item Build new extensions -=item Known Issues - =item Acknowledgements =item Authors @@ -7593,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 @@ -7610,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 @@ -7656,6 +7854,8 @@ C, C =over 4 +=item Text-mode filehandles + =item Priorities =item DLL name mangling: pre 5.6.2 @@ -7915,6 +8115,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 @@ -8074,8 +8276,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 @@ -8084,9 +8290,7 @@ LIST, waitpid PID,FLAGS =back -=head1 PRAGMA DOCUMENTATION - -=head2 attrs - set/get attributes of a subroutine (deprecated) +=head2 perlwin32 - Perl under Windows =over 4 @@ -8094,38 +8298,48 @@ LIST, waitpid PID,FLAGS =item DESCRIPTION -method, locked +=over 4 -=back +=item Setting Up Perl on Win32 -=head2 re - Perl pragma to alter regular expression behaviour +Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform +SDK 64-bit Compiler, Mingw32 with GCC -=over 4 +=item Building -=item SYNOPSIS +=item Testing Perl on Win32 -=item DESCRIPTION +=item Installation of Perl on Win32 -=back +=item Usage Hints for Perl on Win32 -=head2 threadshared::queue, threads::shared::queue - thread-safe queues +Environment Variables, File Globbing, Using perl from the command line, +Building Extensions, Command-line Wildcard Expansion, Win32 Specific +Extensions, Notes on 64-bit Windows -=over 4 +=item Running Perl Scripts -=item SYNOPSIS +Miscellaneous Things -=item DESCRIPTION +=back -=item FUNCTIONS AND METHODS +=item BUGS AND CAVEATS -new, enqueue LIST, dequeue, dequeue_nb, pending +=item AUTHORS + +Gary Ng E71564.1743@CompuServe.COME, Gurusamy Sarathy +Egsar@activestate.comE, Nick Ing-Simmons +Enick@ing-simmons.netE =item SEE ALSO +=item HISTORY + =back -=head2 threadshared::semaphore, threads::shared::semaphore - thread-safe -semaphores +=head1 PRAGMA DOCUMENTATION + +=head2 attrs - set/get attributes of a subroutine (deprecated) =over 4 @@ -8133,9 +8347,17 @@ semaphores =item DESCRIPTION -=item FUNCTIONS AND METHODS +method, locked -new, new NUMBER, down, down NUMBER, up, up NUMBER +=back + +=head2 re - Perl pragma to alter regular expression behaviour + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION =back @@ -8152,8 +8374,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 @@ -8175,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 @@ -8427,7 +8651,7 @@ escapes =item charnames::viacode(code) -=item charnames::vianame(code) +=item charnames::vianame(name) =item ALIASES @@ -8614,6 +8838,8 @@ point =item CAVEATS +=item NOTES + =item SEE ALSO =item AUTHOR @@ -8631,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 @@ -8842,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 -Cleanup skipped %d active threads +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 @@ -8873,8 +9101,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 @@ -8886,37 +9114,6 @@ cond_signal VARIABLE, 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 @@ -8936,6 +9133,8 @@ utf8::valid(STRING) =back +=item BUGS + =item SEE ALSO =back @@ -10476,7 +10675,8 @@ C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C +C, C, C, C, C, +C =item h @@ -12785,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 @@ -12802,6 +13002,10 @@ tool_autosplit =item Overriding MakeMaker Methods +=item The End Of Cargo Cult Programming + +C< ' '>> + =item Hintsfile support =item Distribution Support @@ -13383,6 +13587,12 @@ catpath =over 4 +=item Note For File::Spec::Win32 Maintainers + +=back + +=over 4 + =item SEE ALSO =back @@ -13485,6 +13695,8 @@ TopSystemUID =item DESCRIPTION +=item BUGS + =item NOTE =item AUTHOR @@ -13689,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 @@ -14749,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 @@ -15122,6 +15336,10 @@ Canonical notation, Input, Output =item bmod +=item bmodinv + +=item bmodpow + =item bpow =item blsft @@ -15291,15 +15509,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 @@ -15787,9 +16013,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->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 @@ -15797,6 +16024,8 @@ $p->open($host);, $p->close();, pingecho($host [, $timeout]); =item NOTES +=item INSTALL + =item AUTHORS =item COPYRIGHT @@ -15827,6 +16056,8 @@ ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [ DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ), quit () +=item ADDRESSES + =item SEE ALSO =item AUTHOR @@ -16319,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 @@ -16333,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 @@ -16343,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 @@ -16351,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 @@ -16367,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 @@ -16377,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 @@ -16415,7 +16667,7 @@ after =back =item Warnings -multiple occurence of link target I, line containing nothing but +multiple occurrence of link target I, 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 vs. I), I unescaped CE> in paragraph, Unknown entity, No @@ -16914,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 @@ -16922,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 @@ -17464,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 @@ -17797,6 +18051,12 @@ C =item BUGS +=over 4 + +=item 64 bit data in perl 5.6.0 and 5.6.1 + +=back + =item CREDITS =item AUTHOR @@ -17931,7 +18191,7 @@ ANSI_COLORS_DISABLED =item AUTHORS -=item LICENSE +=item COPYRIGHT AND LICENSE =back @@ -18163,6 +18423,8 @@ B<_my_exit> =over 4 +=item THREADS + =item EXAMPLES =item SEE ALSO @@ -18425,6 +18687,8 @@ B B, B +When do I use SKIP vs. TODO? + =over 4 =item Comparison functions @@ -18681,7 +18945,7 @@ unexpand(1) =back -=head2 Thread - manipulate threads in Perl +=head2 Thread - manipulate threads in Perl (for old code only) =over 4 @@ -18738,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 @@ -19294,7 +19561,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), @@ -19310,24 +19577,6 @@ Win32::UnregisterServer(LIBRARYNAME) =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