From: Rafael Garcia-Suarez Date: Tue, 15 Aug 2006 09:43:40 +0000 (+0000) Subject: Regenerate perlmodlib and perltoc X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=498e06b7c83cbfee61f8ec4e9a393512863c3400;p=p5sagit%2Fp5-mst-13.2.git Regenerate perlmodlib and perltoc p4raw-id: //depot/perl@28723 --- diff --git a/pod/perlmodlib.pod b/pod/perlmodlib.pod index 2e485ff..223b7df 100644 --- a/pod/perlmodlib.pod +++ b/pod/perlmodlib.pod @@ -181,7 +181,7 @@ Predeclare sub names =item threads -Perl extension allowing use of interpreter based threads from perl +Perl interpreter-based threads =item threads::shared @@ -393,13 +393,13 @@ Report the search path for a class's ISA tree Declare struct-like datatypes as Perl classes -=item Compress::Zlib +=item Compress::Raw::Zlib -Interface to zlib compression library +Low-Level Interface to zlib compression library -=item Compress::Zlib::pod::FAQ +=item Compress::Zlib -Frequently Asked Questions about Compress::Zlib +Interface to zlib compression library =item Config @@ -417,6 +417,26 @@ Programmatic interface to the Perl debugging API (draft, subject to Filter DBM keys/values +=item DBM_Filter::compress + +Filter for DBM_Filter + +=item DBM_Filter::encode + +Filter for DBM_Filter + +=item DBM_Filter::int32 + +Filter for DBM_Filter + +=item DBM_Filter::null + +Filter for DBM_Filter + +=item DBM_Filter::utf8 + +Filter for DBM_Filter + =item DB_File Perl5 access to Berkeley DB version 1.x @@ -429,10 +449,6 @@ Stringified perl data structures, suitable for both printing and C A Perl code profiler -=item Devel::PPPort - -Perl/Pollution/Portability - =item Devel::Peek A data debugging tool for the XS programmer @@ -873,6 +889,10 @@ Process single-character switches with switch clustering A selection of general-utility hash subroutines +=item Hash::Util::FieldHash + +Associate references with data + =item I18N::Collate Compare 8-bit scalar data according to the current locale @@ -897,17 +917,25 @@ Query locale information Load various IO modules +=item IO::Compress::Base + +Base Class for IO::Compress modules + =item IO::Compress::Deflate -Perl interface to write RFC 1950 files/buffers +Write RFC 1950 files/buffers =item IO::Compress::Gzip -Perl interface to write RFC 1952 files/buffers +Write RFC 1952 files/buffers =item IO::Compress::RawDeflate -Perl interface to write RFC 1951 files/buffers +Write RFC 1951 files/buffers + +=item IO::Compress::Zip + +Write zip files/buffers =item IO::Dir @@ -951,19 +979,31 @@ Object interface for AF_UNIX domain sockets =item IO::Uncompress::AnyInflate -Perl interface to read RFC 1950, 1951 & 1952 files/buffers +Uncompress zlib-based (zip, gzip) file/buffer + +=item IO::Uncompress::AnyUncompress + +Uncompress gzip, zip, bzip2 or lzop file/buffer + +=item IO::Uncompress::Base + +Base Class for IO::Uncompress modules =item IO::Uncompress::Gunzip -Perl interface to read RFC 1952 files/buffers +Read RFC 1952 files/buffers =item IO::Uncompress::Inflate -Perl interface to read RFC 1950 files/buffers +Read RFC 1950 files/buffers =item IO::Uncompress::RawInflate -Perl interface to read RFC 1951 files/buffers +Read RFC 1951 files/buffers + +=item IO::Uncompress::Unzip + +Read zip files/buffers =item IO::Zlib @@ -1093,10 +1133,118 @@ Glue to provide EXISTS for SDBM_File for Storable use Store Memoized data in Storable database +=item Module::Build + +Build and install Perl modules + +=item Module::Build::API + +API Reference for Module Authors + +=item Module::Build::Authoring + +Authoring Module::Build modules + +=item Module::Build::Base + +Default methods for Module::Build + +=item Module::Build::Compat + +Compatibility with ExtUtils::MakeMaker + +=item Module::Build::ConfigData + +Configuration for Module::Build + +=item Module::Build::Cookbook + +Examples of Module::Build Usage + +=item Module::Build::ModuleInfo + +Gather package and POD information from a perl module files + +=item Module::Build::Notes + +Configuration for $module_name + +=item Module::Build::PPMMaker + +Perl Package Manager file creation + +=item Module::Build::Platform::Amiga + +Builder class for Amiga platforms + +=item Module::Build::Platform::Default + +Stub class for unknown platforms + +=item Module::Build::Platform::EBCDIC + +Builder class for EBCDIC platforms + +=item Module::Build::Platform::MPEiX + +Builder class for MPEiX platforms + +=item Module::Build::Platform::MacOS + +Builder class for MacOS platforms + +=item Module::Build::Platform::RiscOS + +Builder class for RiscOS platforms + +=item Module::Build::Platform::Unix + +Builder class for Unix platforms + +=item Module::Build::Platform::VMS + +Builder class for VMS platforms + +=item Module::Build::Platform::VOS + +Builder class for VOS platforms + +=item Module::Build::Platform::Windows + +Builder class for Windows platforms + +=item Module::Build::Platform::aix + +Builder class for AIX platform + +=item Module::Build::Platform::cygwin + +Builder class for Cygwin platform + +=item Module::Build::Platform::darwin + +Builder class for Mac OS X platform + +=item Module::Build::Platform::os2 + +Builder class for OS/2 platform + +=item Module::Build::YAML + +Provides just enough YAML support so that Module::Build works even if YAML.pm is not installed + =item Module::CoreList What modules shipped with versions of perl +=item Module::Load + +Runtime require of both modules and files + +=item Module::Loaded + +Mark modules as loaded or unloaded + =item NDBM_File Tied access to ndbm files @@ -1181,6 +1329,10 @@ Disable named opcodes when compiling perl code Perl interface to IEEE Std 1003.1 +=item Package::Constants + +List all constants declared in a package + =item PerlIO On demand loader for PerlIO layers and root of PerlIO::* name space @@ -1505,6 +1657,10 @@ Detailed analysis of test results Documentation for the TAP format +=item Test::Harness::Util + +Utility functions for Test::Harness::* + =item Test::More Yet another framework for writing test scripts diff --git a/pod/perltoc.pod b/pod/perltoc.pod index e611429..6536974 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -71,6 +71,8 @@ through to locate the proper section you're looking for. =item Running Perl programs +=item Safety net + =item Basic syntax overview =item Perl variable types @@ -1891,7 +1893,7 @@ X X X<*> =over 4 -=item Operator Precedence and Associativity +=item Operator Precedence and Associativity X X X =item Terms and List Operators (Leftward) @@ -1984,34 +1986,35 @@ X X<(TYPE)> unary &, unary *, (TYPE) =item Quote and Quote-like Operators -X X X X X X X +X X X X X X X X X X X<'> X<''> X<"> X<""> X X<`> X<``> X<<< << >>> X X =item Regexp Quote-Like Operators X -?PATTERN? X, m/PATTERN/cgimosx X X X X X X X X X X -X X, /PATTERN/cgimosx, q/STRING/ X X X<'> X<''>, -C<'STRING'>, qq/STRING/ X X X<"> X<"">, "STRING", +?PATTERN? X, m/PATTERN/cgimosx X X X X X X X X X X X +X, /PATTERN/cgimosx, q/STRING/ X X X<'> X<''>, +'STRING', qq/STRING/ X X X<"> X<"">, "STRING", qr/STRING/imosx X X X X X X, qx/STRING/ X X<`> X<``> X, `STRING`, qw/STRING/ X X X, s/PATTERN/REPLACEMENT/egimosx X X X X X X X X X X X X, tr/SEARCHLIST/REPLACEMENTLIST/cds X X X X X X, y/SEARCHLIST/REPLACEMENTLIST/cds, < X X X<<< << >>> +X X X X<<< << >>>, Double Quotes, Single +Quotes, Backticks =item Gory details of parsing quoted constructs X -Finding the end, Removal of backslashes before delimiters, Interpolation -X, C<<<'EOF'>, C, C, C, C, C<''>, -C, C<"">, C<``>, C, C, C<< >>, C, -C, C, C,, Interpolation of regular expressions -X, Optimization of regular expressions X +Finding the end, Interpolation X, C<<<'EOF'>, C, the +pattern of C, C<''>, C, C, C, the replacement of +C, C, C, C<"">, C<``>, C, C, C<< +>>, C<<<"EOF">, the replacement of C, C in C, C, +C, C,, parsing regular expressions X, +Optimization of regular expressions X =item I/O Operators X X X X X @@ -2054,7 +2057,8 @@ X X X X X X X =item Persistent Private Variables -X X X X +X X X X X X =item Temporary Values via local() X X X X @@ -2135,85 +2139,88 @@ X X X -I FILEHANDLE X<-r>X<-w>X<-x>X<-o>X<-R>X<-W>X<-X>X<-O>X<-e>X<-z>X<-s>X<-f>X<-d>X<-l>X<-p> X<-S>X<-b>X<-c>X<-t>X<-u>X<-g>X<-k>X<-T>X<-B>X<-M>X<-A>X<-C>, -I EXPR, --I, abs VALUE X X, abs, accept NEWSOCKET,GENERICSOCKET -X, alarm SECONDS X X X, alarm, atan2 Y,X -X X X X, bind SOCKET,NAME X, binmode -FILEHANDLE, LAYER X X X X X, binmode -FILEHANDLE, bless REF,CLASSNAME X, bless REF, break, caller EXPR -X X X X, caller, chdir EXPR -X X, chdir FILEHANDLE, chdir DIRHANDLE, chdir, chmod LIST -X X X, chomp VARIABLE X -X X<$/> X X, chomp( LIST ), chomp, -chop VARIABLE X, chop( LIST ), chop, chown LIST X X -X X, chr NUMBER X X X X, chr, -chroot FILENAME X X, chroot, close FILEHANDLE X, -close, closedir DIRHANDLE X, connect SOCKET,NAME X, -continue BLOCK X, continue, cos EXPR X X X -X, cos, crypt PLAINTEXT,SALT X X X X -X X<password> X<decrypt> X<cryptography> X<passwd>, dbmclose -HASH X<dbmclose>, dbmopen HASH,DBNAME,MASK X<dbmopen> X<dbm> X<ndbm> -X<sdbm> X<gdbm>, defined EXPR X<defined> X<undef> X<undefined>, defined, -delete EXPR X<delete>, die LIST X<die> X<throw> X<exception> X<raise> X<$@> -X<abort>, do BLOCK X<do> X<block>, do SUBROUTINE(LIST) X<do>, do EXPR -X<do>, dump LABEL X<dump> X<core> X<undump>, dump, each HASH X<each> -X<hash, iterator>, eof FILEHANDLE X<eof> X<end of file> X<end-of-file>, eof -(), eof, eval EXPR X<eval> X<try> X<catch> X<evaluate> X<parse> X<execute>, -eval BLOCK, eval, exec LIST X<exec> X<execute>, exec PROGRAM LIST, exists -EXPR X<exists> X<autovivification>, exit EXPR X<exit> X<terminate> -X<abort>, exit, exp EXPR X<exp> X<exponential> X<antilog> X<antilogarithm> -X<e>, exp, fcntl FILEHANDLE,FUNCTION,SCALAR X<fcntl>, fileno FILEHANDLE -X<fileno>, flock FILEHANDLE,OPERATION X<flock> X<lock> X<locking>, fork -X<fork> X<child> X<parent>, format X<format>, formline PICTURE,LIST -X<formline>, getc FILEHANDLE X<getc> X<getchar>, getc, getlogin X<getlogin> -X<login>, getpeername SOCKET X<getpeername> X<peer>, getpgrp PID X<getpgrp> -X<group>, getppid X<getppid> X<parent> X<pid>, getpriority WHICH,WHO -X<getpriority> X<priority> X<nice>, getpwnam NAME X<getpwnam> X<getgrnam> -X<gethostbyname> X<getnetbyname> X<getprotobyname> X<getpwuid> X<getgrgid> -X<getservbyname> X<gethostbyaddr> X<getnetbyaddr> X<getprotobynumber> -X<getservbyport> X<getpwent> X<getgrent> X<gethostent> X<getnetent> -X<getprotoent> X<getservent> X<setpwent> X<setgrent> X<sethostent> -X<setnetent> X<setprotoent> X<setservent> X<endpwent> X<endgrent> -X<endhostent> X<endnetent> X<endprotoent> X<endservent>, 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 X<getsockname>, -getsockopt SOCKET,LEVEL,OPTNAME X<getsockopt>, glob EXPR X<glob> -X<wildcard> X<filename, expansion> X<expand>, glob, gmtime EXPR X<gmtime> -X<UTC> X<Greenwich>, gmtime, goto LABEL X<goto> X<jump> X<jmp>, goto EXPR, -goto &NAME, grep BLOCK LIST X<grep>, grep EXPR,LIST, hex EXPR X<hex> +-I<X> DIRHANDLE, -I<X>, abs VALUE X<abs> X<absolute>, abs, accept +NEWSOCKET,GENERICSOCKET X<accept>, alarm SECONDS X<alarm> X<SIGALRM> +X<timer>, alarm, atan2 Y,X X<atan2> X<arctangent> X<tan> X<tangent>, bind +SOCKET,NAME X<bind>, binmode FILEHANDLE, LAYER X<binmode> X<binary> X<text> +X<DOS> X<Windows>, binmode FILEHANDLE, bless REF,CLASSNAME X<bless>, bless +REF, break, caller EXPR X<caller> X<call stack> X<stack> X<stack trace>, +caller, chdir EXPR X<chdir> X<cd> X<directory, change>, chdir FILEHANDLE, +chdir DIRHANDLE, chdir, chmod LIST X<chmod> X<permission> X<mode>, chomp +VARIABLE X<chomp> X<INPUT_RECORD_SEPARATOR> X<$/> X<newline> X<eol>, chomp( +LIST ), chomp, chop VARIABLE X<chop>, chop( LIST ), chop, chown LIST +X<chown> X<owner> X<user> X<group>, chr NUMBER X<chr> X<character> X<ASCII> +X<Unicode>, chr, chroot FILENAME X<chroot> X<root>, chroot, close +FILEHANDLE X<close>, close, closedir DIRHANDLE X<closedir>, connect +SOCKET,NAME X<connect>, continue BLOCK X<continue>, continue, cos EXPR +X<cos> X<cosine> X<acos> X<arccosine>, cos, crypt PLAINTEXT,SALT X<crypt> +X<digest> X<hash> X<salt> X<plaintext> X<password> X<decrypt> +X<cryptography> X<passwd> X<encrypt>, dbmclose HASH X<dbmclose>, dbmopen +HASH,DBNAME,MASK X<dbmopen> X<dbm> X<ndbm> X<sdbm> X<gdbm>, defined EXPR +X<defined> X<undef> X<undefined>, defined, delete EXPR X<delete>, die LIST +X<die> X<throw> X<exception> X<raise> X<$@> X<abort>, do BLOCK X<do> +X<block>, do SUBROUTINE(LIST) X<do>, do EXPR X<do>, dump LABEL X<dump> +X<core> X<undump>, dump, each HASH X<each> X<hash, iterator>, eof +FILEHANDLE X<eof> X<end of file> X<end-of-file>, eof (), eof, eval EXPR +X<eval> X<try> X<catch> X<evaluate> X<parse> X<execute> X<error, handling> +X<exception, handling>, eval BLOCK, eval, exec LIST X<exec> X<execute>, +exec PROGRAM LIST, exists EXPR X<exists> X<autovivification>, exit EXPR +X<exit> X<terminate> X<abort>, exit, exp EXPR X<exp> X<exponential> +X<antilog> X<antilogarithm> X<e>, exp, fcntl FILEHANDLE,FUNCTION,SCALAR +X<fcntl>, fileno FILEHANDLE X<fileno>, flock FILEHANDLE,OPERATION X<flock> +X<lock> X<locking>, fork X<fork> X<child> X<parent>, format X<format>, +formline PICTURE,LIST X<formline>, getc FILEHANDLE X<getc> X<getchar> +X<character> X<file, read>, getc, getlogin X<getlogin> X<login>, +getpeername SOCKET X<getpeername> X<peer>, getpgrp PID X<getpgrp> X<group>, +getppid X<getppid> X<parent> X<pid>, getpriority WHICH,WHO X<getpriority> +X<priority> X<nice>, getpwnam NAME X<getpwnam> X<getgrnam> X<gethostbyname> +X<getnetbyname> X<getprotobyname> X<getpwuid> X<getgrgid> X<getservbyname> +X<gethostbyaddr> X<getnetbyaddr> X<getprotobynumber> X<getservbyport> +X<getpwent> X<getgrent> X<gethostent> X<getnetent> X<getprotoent> +X<getservent> X<setpwent> X<setgrent> X<sethostent> X<setnetent> +X<setprotoent> X<setservent> X<endpwent> X<endgrent> X<endhostent> +X<endnetent> X<endprotoent> X<endservent>, 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 X<getsockname>, getsockopt +SOCKET,LEVEL,OPTNAME X<getsockopt>, glob EXPR X<glob> X<wildcard> +X<filename, expansion> X<expand>, glob, gmtime EXPR X<gmtime> X<UTC> +X<Greenwich>, gmtime, goto LABEL X<goto> X<jump> X<jmp>, goto EXPR, goto +&NAME, grep BLOCK LIST X<grep>, grep EXPR,LIST, hex EXPR X<hex> X<hexadecimal>, hex, import LIST X<import>, index STR,SUBSTR,POSITION X<index> X<indexOf> X<InStr>, index STR,SUBSTR, int EXPR X<int> X<integer> -X<truncate> X<trunc>, int, ioctl FILEHANDLE,FUNCTION,SCALAR X<ioctl>, join -EXPR,LIST X<join>, keys HASH X<keys> X<key>, kill SIGNAL, LIST X<kill> -X<signal>, last LABEL X<last> X<break>, last, lc EXPR X<lc> X<lowercase>, -lc, lcfirst EXPR X<lcfirst> X<lowercase>, lcfirst, length EXPR X<length> -X<size>, length, link OLDFILE,NEWFILE X<link>, listen SOCKET,QUEUESIZE -X<listen>, local EXPR X<local>, localtime EXPR X<localtime>, localtime, -lock THING X<lock>, log EXPR X<log> X<logarithm> X<e> X<ln> X<base>, log, -lstat EXPR X<lstat>, lstat, m//, map BLOCK LIST X<map>, map EXPR,LIST, -mkdir FILENAME,MASK X<mkdir> X<md> X<directory, create>, mkdir FILENAME, -mkdir, msgctl ID,CMD,ARG X<msgctl>, msgget KEY,FLAGS X<msgget>, msgrcv -ID,VAR,SIZE,TYPE,FLAGS X<msgrcv>, msgsnd ID,MSG,FLAGS X<msgsnd>, my EXPR -X<my>, my TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS, next LABEL -X<next> X<continue>, next, no Module VERSION LIST X<no>, no Module VERSION, -no Module LIST, no Module, oct EXPR X<oct> X<octal> X<hex> X<hexadecimal> -X<binary> X<bin>, oct, open FILEHANDLE,EXPR X<open> X<pipe> X<file, open> -X<fopen>, open FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST, open -FILEHANDLE,MODE,REFERENCE, open FILEHANDLE, opendir DIRHANDLE,EXPR -X<opendir>, ord EXPR X<ord> X<encoding>, ord, our EXPR X<our> X<global>, -our EXPR TYPE, our EXPR : ATTRS, our TYPE EXPR : ATTRS, pack TEMPLATE,LIST -X<pack>, package NAMESPACE X<package> X<module> X<namespace>, package, pipe -READHANDLE,WRITEHANDLE X<pipe>, pop ARRAY X<pop> X<stack>, pop, pos SCALAR -X<pos> X<match, position>, pos, print FILEHANDLE LIST X<print>, print LIST, -print, printf FILEHANDLE FORMAT, LIST X<printf>, printf FORMAT, LIST, -prototype FUNCTION X<prototype>, push ARRAY,LIST X<push>, X<stack>, -q/STRING/, qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR -X<quotemeta> X<metacharacter>, quotemeta, rand EXPR X<rand> X<random>, -rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET X<read>, read +X<truncate> X<trunc> X<floor>, int, ioctl FILEHANDLE,FUNCTION,SCALAR +X<ioctl>, join EXPR,LIST X<join>, keys HASH X<keys> X<key>, kill SIGNAL, +LIST X<kill> X<signal>, last LABEL X<last> X<break>, last, lc EXPR X<lc> +X<lowercase>, lc, lcfirst EXPR X<lcfirst> X<lowercase>, lcfirst, length +EXPR X<length> X<size>, length, link OLDFILE,NEWFILE X<link>, listen +SOCKET,QUEUESIZE X<listen>, local EXPR X<local>, localtime EXPR +X<localtime> X<ctime>, localtime, lock THING X<lock>, log EXPR X<log> +X<logarithm> X<e> X<ln> X<base>, log, lstat EXPR X<lstat>, lstat, m//, map +BLOCK LIST X<map>, map EXPR,LIST, mkdir FILENAME,MASK X<mkdir> X<md> +X<directory, create>, mkdir FILENAME, mkdir, msgctl ID,CMD,ARG X<msgctl>, +msgget KEY,FLAGS X<msgget>, msgrcv ID,VAR,SIZE,TYPE,FLAGS X<msgrcv>, msgsnd +ID,MSG,FLAGS X<msgsnd>, my EXPR X<my>, my TYPE EXPR, my EXPR : ATTRS, my +TYPE EXPR : ATTRS, next LABEL X<next> X<continue>, next, no Module VERSION +LIST X<no>, no Module VERSION, no Module LIST, no Module, oct EXPR X<oct> +X<octal> X<hex> X<hexadecimal> X<binary> X<bin>, oct, open FILEHANDLE,EXPR +X<open> X<pipe> X<file, open> X<fopen>, open FILEHANDLE,MODE,EXPR, open +FILEHANDLE,MODE,EXPR,LIST, open FILEHANDLE,MODE,REFERENCE, open FILEHANDLE, +opendir DIRHANDLE,EXPR X<opendir>, ord EXPR X<ord> X<encoding>, ord, our +EXPR X<our> X<global>, our TYPE EXPR, our EXPR : ATTRS, our TYPE EXPR : +ATTRS, pack TEMPLATE,LIST X<pack>, package NAMESPACE X<package> X<module> +X<namespace>, package, pipe READHANDLE,WRITEHANDLE X<pipe>, pop ARRAY +X<pop> X<stack>, pop, pos SCALAR X<pos> X<match, position>, pos, print +FILEHANDLE LIST X<print>, print LIST, print, printf FILEHANDLE FORMAT, LIST +X<printf>, printf FORMAT, LIST, prototype FUNCTION X<prototype>, push +ARRAY,LIST X<push>, X<stack>, q/STRING/, qq/STRING/, qr/STRING/, +qx/STRING/, qw/STRING/, quotemeta EXPR X<quotemeta> X<metacharacter>, +quotemeta, rand EXPR X<rand> X<random>, rand, read +FILEHANDLE,SCALAR,LENGTH,OFFSET X<read> X<file, read>, read FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE X<readdir>, readline EXPR X<readline> X<gets> X<fgets>, readlink EXPR X<readlink>, readlink, readpipe EXPR X<readpipe>, recv SOCKET,SCALAR,LENGTH,FLAGS X<recv>, redo LABEL @@ -2245,13 +2252,14 @@ split /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST X<sprintf>, format parameter index, flags, vector flag, (minimum) width, precision, or maximum width X<precision>, size, order of arguments, sqrt EXPR X<sqrt> X<root> X<square root>, sqrt, srand EXPR X<srand> X<seed> -X<randseed>, srand, stat FILEHANDLE X<stat> X<file, status>, stat EXPR, -stat, study SCALAR X<study>, study, sub NAME BLOCK X<sub>, sub NAME (PROTO) -BLOCK, sub NAME : ATTRS BLOCK, sub NAME (PROTO) : ATTRS BLOCK, substr -EXPR,OFFSET,LENGTH,REPLACEMENT X<substr> X<substring> X<mid> X<left> -X<right>, substr EXPR,OFFSET,LENGTH, substr EXPR,OFFSET, symlink -OLDFILE,NEWFILE X<symlink> X<link> X<symbolic link> X<link, symbolic>, -syscall NUMBER, LIST X<syscall> X<system call>, sysopen +X<randseed>, srand, stat FILEHANDLE X<stat> X<file, status> X<ctime>, stat +EXPR, stat DIRHANDLE, stat, state EXPR X<state>, state TYPE EXPR, state +EXPR : ATTRS, state TYPE EXPR : ATTRS, study SCALAR X<study>, study, sub +NAME BLOCK X<sub>, sub NAME (PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub NAME +(PROTO) : ATTRS BLOCK, substr EXPR,OFFSET,LENGTH,REPLACEMENT X<substr> +X<substring> X<mid> X<left> X<right>, substr EXPR,OFFSET,LENGTH, substr +EXPR,OFFSET, symlink OLDFILE,NEWFILE X<symlink> X<link> X<symbolic link> +X<link, symbolic>, syscall NUMBER, LIST X<syscall> X<system call>, sysopen FILEHANDLE,FILENAME,MODE X<sysopen>, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread FILEHANDLE,SCALAR,LENGTH,OFFSET X<sysread>, sysread FILEHANDLE,SCALAR,LENGTH, sysseek @@ -2264,9 +2272,9 @@ X<epoch>, times X<times>, tr///, truncate FILEHANDLE,LENGTH X<truncate>, truncate EXPR,LENGTH, uc EXPR X<uc> X<uppercase> X<toupper>, uc, ucfirst EXPR X<ucfirst> X<uppercase>, ucfirst, umask EXPR X<umask>, umask, undef EXPR X<undef> X<undefine>, undef, unlink LIST X<unlink> X<delete> X<remove> -X<rm>, unlink, unpack TEMPLATE,EXPR X<unpack>, unpack TEMPLATE, untie -VARIABLE X<untie>, unshift ARRAY,LIST X<unshift>, use Module VERSION LIST -X<use> X<module> X<import>, use Module VERSION, use Module LIST, use +X<rm> X<del>, unlink, unpack TEMPLATE,EXPR X<unpack>, unpack TEMPLATE, +untie VARIABLE X<untie>, unshift ARRAY,LIST X<unshift>, use Module VERSION +LIST X<use> X<module> X<import>, use Module VERSION, use Module LIST, use Module, use VERSION, utime LIST X<utime>, values HASH X<values>, vec EXPR,OFFSET,BITS X<vec> X<bit> X<bit vector>, wait X<wait>, waitpid PID,FLAGS X<waitpid>, wantarray X<wantarray> X<context>, warn LIST X<warn> @@ -2746,41 +2754,62 @@ X<memory usage> =item Predefined Names -$ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $', -$LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, -HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $, -IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/, -HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|, -IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,, +$ARG, $_ X<$_> X<$ARG>, $a, $b X<$a> X<$b>, $<I<digits>> X<$1> X<$2> X<$3>, +$MATCH, $& X<$&> X<$MATCH>, $PREMATCH, $` X<$`> X<$PREMATCH>, $POSTMATCH, +$' X<$'> X<$POSTMATCH>, $LAST_PAREN_MATCH, $+ X<$+> X<$LAST_PAREN_MATCH>, +$^N X<$^N>, @LAST_MATCH_END, @+ X<@+> X<@LAST_MATCH_END>, +HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $. X<$.> X<$NR> +X<$INPUT_LINE_NUMBER> X<line number>, +IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/ +X<$/> X<$RS> X<$INPUT_RECORD_SEPARATOR>, HANDLE->autoflush(EXPR), +$OUTPUT_AUTOFLUSH, $| X<$|> X<autoflush> X<flush> X<$OUTPUT_AUTOFLUSH>, +IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $, +X<$,> X<$OFS> X<$OUTPUT_FIELD_SEPARATOR>, IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS, -$\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, -HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%, -HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=, -HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START, -@-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as -C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var, -$+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2> -is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as -C<substr($var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR), -$FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^, -IO::Handle->format_line_break_characters EXPR, -$FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR, -$FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, -${^CHILD_ERROR_NATIVE}, ${^ENCODING}, $OS_ERROR, $ERRNO, $!, %!, -$EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@, $PROCESS_ID, $PID, $$, -$REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID, $>, $REAL_GROUP_ID, -$GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $), $PROGRAM_NAME, $0, $[, $], -$COMPILING, $^C, $DEBUGGING, $^D, ${^RE_DEBUG_FLAGS}, ${^RE_TRIE_MAXBUF}, -$SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O, -${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80, -0x100, 0x200, 0x400, $LAST_REGEXP_CODE_RESULT, $^R, -$EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, ${^TAINT}, ${^UNICODE}, -${^UTF8CACHE}, ${^UTF8LOCALE}, $PERL_VERSION, $^V, $WARNING, $^W, -${^WARNING_BITS}, ${^WIN32_SLOPPY_STAT}, $EXECUTABLE_NAME, $^X, ARGV, -$ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, -$SIG{expr} +$\ X<$\> X<$ORS> X<$OUTPUT_RECORD_SEPARATOR>, $LIST_SEPARATOR, $" X<$"> +X<$LIST_SEPARATOR>, $SUBSCRIPT_SEPARATOR, $SUBSEP, $; X<$;> X<$SUBSEP> +X<SUBSCRIPT_SEPARATOR>, HANDLE->format_page_number(EXPR), +$FORMAT_PAGE_NUMBER, $% X<$%> X<$FORMAT_PAGE_NUMBER>, +HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $= X<$=> +X<$FORMAT_LINES_PER_PAGE>, HANDLE->format_lines_left(EXPR), +$FORMAT_LINES_LEFT, $- X<$-> X<$FORMAT_LINES_LEFT>, @LAST_MATCH_START, @- +X<@-> X<@LAST_MATCH_START>, C<$`> is the same as C<substr($var, 0, $-[0])>, +C<$&> is the same as C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the +same as C<substr($var, $+[0])>, C<$1> is the same as C<substr($var, $-[1], +$+[1] - $-[1])>, C<$2> is the same as C<substr($var, $-[2], $+[2] - +$-[2])>, C<$3> is the same as C<substr($var, $-[3], $+[3] - $-[3])>, +HANDLE->format_name(EXPR), $FORMAT_NAME, $~ X<$~> X<$FORMAT_NAME>, +HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^ X<$^> +X<$FORMAT_TOP_NAME>, IO::Handle->format_line_break_characters EXPR, +$FORMAT_LINE_BREAK_CHARACTERS, $: X<$:> X<FORMAT_LINE_BREAK_CHARACTERS>, +IO::Handle->format_formfeed EXPR, $FORMAT_FORMFEED, $^L X<$^L> +X<$FORMAT_FORMFEED>, $ACCUMULATOR, $^A X<$^A> X<$ACCUMULATOR>, +$CHILD_ERROR, $? X<$?> X<$CHILD_ERROR>, ${^CHILD_ERROR_NATIVE} +X<$^CHILD_ERROR_NATIVE>, ${^ENCODING} X<$^ENCODING>, $OS_ERROR, $ERRNO, $! +X<$!> X<$ERRNO> X<$OS_ERROR>, %! X<%!>, $EXTENDED_OS_ERROR, $^E X<$^E> +X<$EXTENDED_OS_ERROR>, $EVAL_ERROR, $@ X<$@> X<$EVAL_ERROR>, $PROCESS_ID, +$PID, $$ X<$$> X<$PID> X<$PROCESS_ID>, $REAL_USER_ID, $UID, $< X<< $< >> +X<$UID> X<$REAL_USER_ID>, $EFFECTIVE_USER_ID, $EUID, $> X<< $> >> X<$EUID> +X<$EFFECTIVE_USER_ID>, $REAL_GROUP_ID, $GID, $( X<$(> X<$GID> +X<$REAL_GROUP_ID>, $EFFECTIVE_GROUP_ID, $EGID, $) X<$)> X<$EGID> +X<$EFFECTIVE_GROUP_ID>, $PROGRAM_NAME, $0 X<$0> X<$PROGRAM_NAME>, $[ X<$[>, +$] X<$]>, $COMPILING, $^C X<$^C> X<$COMPILING>, $DEBUGGING, $^D X<$^D> +X<$DEBUGGING>, ${^RE_DEBUG_FLAGS}, ${^RE_TRIE_MAXBUF}, $SYSTEM_FD_MAX, $^F +X<$^F> X<$SYSTEM_FD_MAX>, $^H, %^H, $INPLACE_EDIT, $^I X<$^I> +X<$INPLACE_EDIT>, $^M X<$^M>, $OSNAME, $^O X<$^O> X<$OSNAME>, ${^OPEN}, +$PERLDB, $^P X<$^P> X<$PERLDB>, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, +0x80, 0x100, 0x200, 0x400, $LAST_REGEXP_CODE_RESULT, $^R X<$^R> +X<$LAST_REGEXP_CODE_RESULT>, $EXCEPTIONS_BEING_CAUGHT, $^S X<$^S> +X<$EXCEPTIONS_BEING_CAUGHT>, $BASETIME, $^T X<$^T> X<$BASETIME>, ${^TAINT}, +${^UNICODE}, ${^UTF8CACHE}, ${^UTF8LOCALE}, $PERL_VERSION, $^V X<$^V> +X<$PERL_VERSION>, $WARNING, $^W X<$^W> X<$WARNING>, ${^WARNING_BITS}, +${^WIN32_SLOPPY_STAT}, $EXECUTABLE_NAME, $^X X<$^X> X<$EXECUTABLE_NAME>, +ARGV X<ARGV>, $ARGV X<$ARGV>, @ARGV X<@ARGV>, ARGVOUT X<ARGVOUT>, @F X<@F>, +@INC X<@INC>, @ARG, @_ X<@_> X<@ARG>, %INC X<%INC>, %ENV, $ENV{expr} +X<%ENV>, %SIG, $SIG{expr} X<%SIG> =item Error Indicators +X<error> X<exception> =item Technical Note on the Syntax of Variable Names @@ -4067,17 +4096,18 @@ 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, CPAN::Version, Carp, Carp::Heavy, Class::ISA, Class::Struct, -Compress::Zlib, Compress::Zlib::pod::FAQ, Config, Cwd, DB, DBM_Filter, -DB_File, Data::Dumper, Devel::DProf, Devel::PPPort, Devel::Peek, -Devel::SelfStubber, Digest, Digest::MD5, Digest::SHA, Digest::base, -Digest::file, DirHandle, Dumpvalue, DynaLoader, Encode, Encode::Alias, -Encode::Byte, Encode::CJKConstants, Encode::CN, Encode::CN::HZ, -Encode::Config, Encode::EBCDIC, Encode::Encoder, Encode::Encoding, -Encode::Guess, Encode::JP, Encode::JP::H2Z, Encode::JP::JIS7, Encode::KR, -Encode::KR::2022_KR, Encode::MIME::Header, Encode::PerlIO, -Encode::Supported, Encode::Symbol, Encode::TW, Encode::Unicode, -Encode::Unicode::UTF7, English, Env, Errno, Exporter, Exporter::Heavy, -ExtUtils::CBuilder, ExtUtils::CBuilder::Platform::Windows, +Compress::Raw::Zlib, Compress::Zlib, Config, Cwd, DB, DBM_Filter, +DBM_Filter::compress, DBM_Filter::encode, DBM_Filter::int32, +DBM_Filter::null, DBM_Filter::utf8, DB_File, Data::Dumper, Devel::DProf, +Devel::Peek, Devel::SelfStubber, Digest, Digest::MD5, Digest::SHA, +Digest::base, Digest::file, DirHandle, Dumpvalue, DynaLoader, Encode, +Encode::Alias, Encode::Byte, Encode::CJKConstants, Encode::CN, +Encode::CN::HZ, Encode::Config, Encode::EBCDIC, Encode::Encoder, +Encode::Encoding, Encode::Guess, Encode::JP, Encode::JP::H2Z, +Encode::JP::JIS7, Encode::KR, Encode::KR::2022_KR, Encode::MIME::Header, +Encode::PerlIO, Encode::Supported, Encode::Symbol, Encode::TW, +Encode::Unicode, Encode::Unicode::UTF7, English, Env, Errno, Exporter, +Exporter::Heavy, ExtUtils::CBuilder, ExtUtils::CBuilder::Platform::Windows, ExtUtils::Command, ExtUtils::Command::MM, ExtUtils::Constant, ExtUtils::Constant::Base, ExtUtils::Constant::Utils, ExtUtils::Constant::XS, ExtUtils::Embed, ExtUtils::Install, @@ -4096,13 +4126,16 @@ File::GlobMapper, File::Path, File::Spec, File::Spec::Cygwin, File::Spec::Epoc, File::Spec::Functions, File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache, FileHandle, Filter::Simple, Filter::Util::Call, -FindBin, GDBM_File, Getopt::Long, Getopt::Std, Hash::Util, I18N::Collate, -I18N::LangTags, I18N::LangTags::Detect, I18N::LangTags::List, -I18N::Langinfo, IO, IO::Compress::Deflate, IO::Compress::Gzip, -IO::Compress::RawDeflate, IO::Dir, IO::File, IO::Handle, IO::Pipe, -IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET, -IO::Socket::UNIX, IO::Uncompress::AnyInflate, IO::Uncompress::Gunzip, -IO::Uncompress::Inflate, IO::Uncompress::RawInflate, IO::Zlib, IPC::Open2, +FindBin, GDBM_File, Getopt::Long, Getopt::Std, Hash::Util, +Hash::Util::FieldHash, I18N::Collate, I18N::LangTags, +I18N::LangTags::Detect, I18N::LangTags::List, I18N::Langinfo, IO, +IO::Compress::Base, IO::Compress::Deflate, IO::Compress::Gzip, +IO::Compress::RawDeflate, IO::Compress::Zip, IO::Dir, IO::File, IO::Handle, +IO::Pipe, IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET, +IO::Socket::UNIX, IO::Uncompress::AnyInflate, +IO::Uncompress::AnyUncompress, IO::Uncompress::Base, +IO::Uncompress::Gunzip, IO::Uncompress::Inflate, +IO::Uncompress::RawInflate, IO::Uncompress::Unzip, IO::Zlib, IPC::Open2, IPC::Open3, IPC::SysV, IPC::SysV::Msg, IPC::SysV::Semaphore, List::Util, Locale::Constants, Locale::Country, Locale::Currency, Locale::Language, Locale::Maketext, Locale::Maketext::TPJ13, Locale::Script, MIME::Base64, @@ -4110,11 +4143,22 @@ MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt, Math::BigInt::Calc, Math::BigInt::CalcEmu, Math::BigInt::FastCalc, Math::BigRat, Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire, Memoize::ExpireFile, Memoize::ExpireTest, -Memoize::NDBM_File, Memoize::SDBM_File, Memoize::Storable, -Module::CoreList, 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, PerlIO::encoding, +Memoize::NDBM_File, Memoize::SDBM_File, Memoize::Storable, Module::Build, +Module::Build::API, Module::Build::Authoring, Module::Build::Base, +Module::Build::Compat, Module::Build::ConfigData, Module::Build::Cookbook, +Module::Build::ModuleInfo, Module::Build::Notes, Module::Build::PPMMaker, +Module::Build::Platform::Amiga, Module::Build::Platform::Default, +Module::Build::Platform::EBCDIC, Module::Build::Platform::MPEiX, +Module::Build::Platform::MacOS, Module::Build::Platform::RiscOS, +Module::Build::Platform::Unix, Module::Build::Platform::VMS, +Module::Build::Platform::VOS, Module::Build::Platform::Windows, +Module::Build::Platform::aix, Module::Build::Platform::cygwin, +Module::Build::Platform::darwin, Module::Build::Platform::os2, +Module::Build::YAML, Module::CoreList, Module::Load, Module::Loaded, +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, Package::Constants, PerlIO, PerlIO::encoding, PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint, Pod::Checker, Pod::Escapes, Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects, Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser, @@ -4136,13 +4180,14 @@ Term::ANSIColor, Term::Cap, Term::Complete, Term::ReadLine, Test, Test::Builder, Test::Builder::Module, Test::Builder::Tester, Test::Builder::Tester::Color, Test::Harness, Test::Harness::Assert, Test::Harness::Iterator, Test::Harness::Point, Test::Harness::Straps, -Test::Harness::TAP, Test::More, Test::Simple, Test::Tutorial, Text::Abbrev, -Text::Balanced, Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, -Thread, Thread::Queue, Thread::Semaphore, Thread::Signal, Thread::Specific, -Tie::Array, Tie::File, Tie::Handle, Tie::Hash, Tie::Memoize, Tie::RefHash, -Tie::Scalar, Tie::SubstrHash, Time::HiRes, Time::Local, Time::gmtime, -Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate, Unicode::Normalize, -Unicode::UCD, User::grent, User::pwent, XS::APItest, XS::Typemap, XSLoader +Test::Harness::TAP, Test::Harness::Util, Test::More, Test::Simple, +Test::Tutorial, Text::Abbrev, Text::Balanced, Text::ParseWords, +Text::Soundex, Text::Tabs, Text::Wrap, Thread, Thread::Queue, +Thread::Semaphore, Thread::Signal, Thread::Specific, Tie::Array, Tie::File, +Tie::Handle, Tie::Hash, Tie::Memoize, Tie::RefHash, Tie::Scalar, +Tie::SubstrHash, Time::HiRes, Time::Local, Time::gmtime, Time::localtime, +Time::tm, UNIVERSAL, Unicode::Collate, Unicode::Normalize, Unicode::UCD, +User::grent, User::pwent, XS::APItest, XS::Typemap, XSLoader =item Extension Modules @@ -5308,17 +5353,24 @@ callback =item Structure of a Regexp Program -regnode_1, regnode_2, regnode_string, regnode_charclass, -regnode_charclass_class +C<regnode_1>, C<regnode_2>, C<regnode_string>, C<regnode_charclass>, +C<regnode_charclass_class> =back -=item PROCESS OVERVIEW +=item Process Overview + +A. Compilation, 1. Parsing for size, 2. Parsing for construction, 3. +Peep-hole optimisation and analysis, B. Execution, 4. Start position and +no-match optimisations, 5. Program execution =over 4 =item Compilation +anchored fixed strings, floating fixed strings, minimum and maximum length +requirements, start class, Beginning/End of line positions + =item Execution =back @@ -5327,13 +5379,21 @@ regnode_charclass_class =over 4 -=item UNICODE and Localization Support +=item Unicode and Localisation Support + +=item Base Struct + +-, -, -, - + +=item De-allocation and Cloning =back +=item SEE ALSO + =item AUTHOR -=item LICENSE +=item LICENCE =item REFERENCES @@ -5388,6 +5448,10 @@ X<nothreadhook>, perl_alloc X<perl_alloc>, perl_construct X<perl_construct>, perl_destruct X<perl_destruct>, perl_free X<perl_free>, perl_parse X<perl_parse>, perl_run X<perl_run>, require_pv X<require_pv> +=item Functions in file dump.c + +pv_display X<pv_display>, pv_escape X<pv_escape>, pv_pretty X<pv_pretty> + =item Functions in file mathoms.c gv_fetchmethod X<gv_fetchmethod>, pack_cat X<pack_cat>, sv_2pvbyte_nolen @@ -5553,8 +5617,9 @@ X<SvTRUE>, SvTYPE X<SvTYPE>, SvUOK X<SvUOK>, SvUPGRADE X<SvUPGRADE>, SvUTF8 X<SvUTF8>, SvUTF8_off X<SvUTF8_off>, SvUTF8_on X<SvUTF8_on>, SvUV X<SvUV>, SvUVX X<SvUVX>, SvUVx X<SvUVx>, SvUV_nomg X<SvUV_nomg>, SvUV_set X<SvUV_set>, SvVOK X<SvVOK>, sv_catpvn_nomg X<sv_catpvn_nomg>, -sv_catsv_nomg X<sv_catsv_nomg>, sv_derived_from X<sv_derived_from>, -sv_report_used X<sv_report_used>, sv_setsv_nomg X<sv_setsv_nomg> +sv_catsv_nomg X<sv_catsv_nomg>, sv_derived_from X<sv_derived_from>, sv_does +X<sv_does>, sv_report_used X<sv_report_used>, sv_setsv_nomg +X<sv_setsv_nomg> =item SV-Body Allocation @@ -5880,6 +5945,24 @@ Argument stack, Mark stack, Save stack =item The .i Targets +=back + +=item SOURCE CODE STATIC ANALYSIS + +=over 4 + +=item lint, splint + +=item Coverity + +=item cpd (cut-and-paste detector) + +=item gcc warnings + +=item Warnings of other C compilers + +=item DEBUGGING + =item Poking at Perl =item Using a source-level debugger @@ -5915,6 +5998,14 @@ check.utf8, minitest.utf16 test.utf16, test_harness, test-notty test_notty -v, -torture, -re=PATTERN, -re LIST OF PATTERNS, PERL_CORE=1, PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST +=item Common problems when patching Perl source code + +=item Perl environment problems + +=item Portability problems + +=item Security problems + =back =item EXTERNAL TOOLS FOR DEBUGGING PERL @@ -5954,12 +6045,12 @@ DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug =item Miscellaneous tricks +=back + =item CONCLUSION I<The Road goes ever on and on, down from the door where it began.> -=back - =item AUTHOR =back @@ -5982,12 +6073,8 @@ I<The Road goes ever on and on, down from the door where it began.> =over 4 -=item Needed for a 5.9.4 release - =item Needed for a 5.9.5 release -Implement L</_ prototype character>, Implement L</state variables> - =item Needed for a 5.9.6 release =back @@ -6032,10 +6119,12 @@ Implement L</_ prototype character>, Implement L</state variables> =item Add a code coverage target to the Makefile -=item Make Config.pm cope with differences between build and installed perl +=item Make Config.pm cope with differences between built and installed perl =item linker specification files +=item Cross-compile support + =back =item Tasks that need a little C knowledge @@ -6052,7 +6141,7 @@ Implement L</_ prototype character>, Implement L</state variables> =item Allocate OPs from arenas -=item Merge the win32 and wince codebases +=item Improve win32/wince.c =back @@ -6062,8 +6151,6 @@ Implement L</_ prototype character>, Implement L</state variables> =item shrink C<PVBM>s -=item Implicit Latin 1 => Unicode translation - =item autovivification =item Unicode in Filenames @@ -6078,14 +6165,14 @@ Implement L</_ prototype character>, Implement L</state variables> =item readpipe(LIST) +=item strcat(), strcpy(), strncat(), strncpy(), sprintf(), vsprintf() + =back =item Tasks that need a knowledge of the interpreter =over 4 -=item lexical pragmas - =item Attach/detach debugger from running program =item LVALUE functions for lists @@ -6094,12 +6181,14 @@ Implement L</_ prototype character>, Implement L</state variables> =item _ prototype character -=item state variables - =item regexp optimiser optional =item UNITCHECK +=item delete &function + +=item Make readpipe overridable + =item optional optimizer =item You WANT *how* many @@ -6201,34 +6290,120 @@ B<-V> =item chdir FOO +=item Handling of pmc files + +=item @- and @+ in patterns + +=item $AUTOLOAD can now be tainted + =back =item Core Enhancements -=item Modules and Pragmata +=over 4 + +=item state() variables + +=item UNIVERSAL::DOES() + +=item Exceptions in constant folding + +=item Source filters in @INC + +=item MAD + +=back + +=item Modules and Pragmas + +=over 4 + +=item New Core Modules + +=back =item Utility Changes +=over 4 + +=item config_data + +=back + =item Documentation +=over 4 + +=item New manpage, perlpragma + +=item New manpage, perlreguts + +=item New manpage, perlunitut + +=back + =item Performance Enhancements +=over 4 + +=item Memory optimisations + +=item UTF-8 cache optimisation + +=item Regular expressions + +Engine de-recursivised, Single char char-classes treated as literals, Trie +optimisation of literal string alternations, Aho-Corasick start-point +optimisation + +=item Sloppy stat on Windows + +=back + =item Installation and Configuration Improvements -=item Selected Bug Fixes +=over 4 -=item New or Changed Diagnostics +=item Relocatable installations -=item Changed Internals +=item Ports -=item Known Problems +=item Compilation improvements + +=item New probes + +=item Windows build improvements + +Building XS extensions, Support for 64-bit compiler + +=back + +=item Selected Bug Fixes =over 4 -=item Platform Specific Problems +=item PERL5SHELL and tainting + +=item Using *FILE{IO} + +=item Overloading and reblessing + +=item Overloading and UTF-8 + +=item eval memory leaks fixed + +=item Random device on Windows =back +=item New or Changed Diagnostics + +State variable %s will be reinitialized + +=item Changed Internals + +=item Known Problems + =item Reporting Bugs =item SEE ALSO @@ -6247,34 +6422,120 @@ B<-V> =item chdir FOO +=item Handling of pmc files + +=item @- and @+ in patterns + +=item $AUTOLOAD can now be tainted + =back =item Core Enhancements -=item Modules and Pragmata +=over 4 + +=item state() variables + +=item UNIVERSAL::DOES() + +=item Exceptions in constant folding + +=item Source filters in @INC + +=item MAD + +=back + +=item Modules and Pragmas + +=over 4 + +=item New Core Modules + +=back =item Utility Changes +=over 4 + +=item config_data + +=back + =item Documentation +=over 4 + +=item New manpage, perlpragma + +=item New manpage, perlreguts + +=item New manpage, perlunitut + +=back + =item Performance Enhancements +=over 4 + +=item Memory optimisations + +=item UTF-8 cache optimisation + +=item Regular expressions + +Engine de-recursivised, Single char char-classes treated as literals, Trie +optimisation of literal string alternations, Aho-Corasick start-point +optimisation + +=item Sloppy stat on Windows + +=back + =item Installation and Configuration Improvements -=item Selected Bug Fixes +=over 4 -=item New or Changed Diagnostics +=item Relocatable installations -=item Changed Internals +=item Ports -=item Known Problems +=item Compilation improvements + +=item New probes + +=item Windows build improvements + +Building XS extensions, Support for 64-bit compiler + +=back + +=item Selected Bug Fixes =over 4 -=item Platform Specific Problems +=item PERL5SHELL and tainting + +=item Using *FILE{IO} + +=item Overloading and reblessing + +=item Overloading and UTF-8 + +=item eval memory leaks fixed + +=item Random device on Windows =back +=item New or Changed Diagnostics + +State variable %s will be reinitialized + +=item Changed Internals + +=item Known Problems + =item Reporting Bugs =item SEE ALSO @@ -10634,6 +10895,11 @@ method, locked =item DESCRIPTION +Compile related options, COMPILE, PARSE, OPTIMISE, TRIE_COMPILE, DUMP, +OFFSETS, Execute related options, EXECUTE, MATCH, TRIE_EXECUTE, INTUIT, +Extra debugging options, EXTRA, TRIE_MORE, OFFSETS_DEBUG, Other useful +flags, ALL, All, MORE, More + =back =head2 threadshared::shared, threads::shared - Perl extension for sharing @@ -10676,7 +10942,20 @@ ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE $thr = threads->create(FUNCTION, ARGS), $thr->join(), $thr->detach(), threads->detach(), threads->self(), $thr->tid(), threads->tid(), threads->object($tid), threads->yield(), threads->list(), -$thr1->equal($thr2), async BLOCK;, $thr->_handle(), threads->_handle() +threads->list(threads::all), threads->list(threads::running), +threads->list(threads::joinable), $thr1->equal($thr2), async BLOCK;, +$thr->_handle(), threads->_handle() + +=item EXITING A THREAD + +threads->exit(), threads->exit(status), die(), exit(status), use threads +'exit' => 'thread_only', threads->create({'exit' => 'thread_only'}, ...), +$thr->set_thread_exit_only(boolean), threads->set_thread_exit_only(boolean) + +=item THREAD STATE + +$thr->is_running(), $thr->is_joinable(), $thr->is_detached(), +threads->is_detached() =item THREAD CONTEXT @@ -10686,6 +10965,10 @@ $thr1->equal($thr2), async BLOCK;, $thr->_handle(), threads->_handle() =item Implicit context +=item $thr->wantarray() + +=item threads->wantarray() + =back =item THREAD STACK SIZE @@ -10701,16 +10984,16 @@ $thr->kill('SIG...'); =item WARNINGS -A thread exited while # other threads were still running, Thread creation -failed: pthread_create returned #, Thread # terminated abnormally: .., -Using minimum thread stack size of #, Thread creation failed: -pthread_attr_setstacksize(I<SIZE>) returned 22 +Perl exited with active threads:, Thread creation failed: pthread_create +returned #, Thread # terminated abnormally: .., Using minimum thread stack +size of #, Thread creation failed: pthread_attr_setstacksize(I<SIZE>) +returned 22 =item ERRORS This Perl not built to support threads, Cannot change stack size of an -existing thread, Cannot signal other threads without safe signals, -Unrecognized signal name: .. +existing thread, Cannot signal threads without safe signals, Unrecognized +signal name: .. =item BUGS @@ -11630,6 +11913,10 @@ utf8::is_utf8(STRING), $flag = utf8::valid(STRING) Be consistent, Be careful +=item Using modules that use version.pm + +Numeric versions always work, Extended version work sometimes + =item What IS a version Numeric Versions, Extended Versions @@ -11841,6 +12128,12 @@ FILE, HARDLINK, SYMLINK, CHARDEV, BLOCKDEV, DIR, FIFO, SOCKET =over 4 +=item $tar->setcwd( $cwd ); + +=back + +=over 4 + =item $bool = $tar->has_io_string =back @@ -11912,9 +12205,10 @@ FILE, HARDLINK, SYMLINK, CHARDEV, BLOCKDEV, DIR, FIFO, SOCKET What's the minimum perl version required to run Archive::Tar?, Isn't Archive::Tar slow?, Isn't Archive::Tar heavier on memory than /bin/tar?, Can't you lazy-load data instead?, How much memory will an X kb tar file -need?, What do you do with unsupported filetypes in an archive?, How do I -extract only files that have property X from an archive?, How do I access -.tar.Z files? +need?, What do you do with unsupported filetypes in an archive?, I'm using +WinZip, or some other non-POSIX client, and files are not being extracted +properly!, How do I extract only files that have property X from an +archive?, How do I access .tar.Z files? =item TODO @@ -11922,6 +12216,14 @@ Check if passed in handles are open for read/write, Allow archives to be passed in as string, Facilitate processing an opened filehandle of a compressed archive +=item SEE ALSO + +The GNU tar specification, The PAX format specication, A comparison of GNU +and POSIX tar standards; +C<http://www.delorie.com/gnu/docs/tar/tar_114.html>, GNU tar intends to +switch to POSIX compatibility, A Comparison between various tar +implementations + =item AUTHOR =item ACKNOWLEDGEMENTS @@ -13252,6 +13554,8 @@ Signals =item recompile +=item upgrade + =item mkmyconfig =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution @@ -13355,6 +13659,8 @@ http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade =item BUGS +=item SECURITY ADVICE + =item AUTHOR =item TRANSLATIONS @@ -13581,8 +13887,8 @@ Reference, An Output FileGlob =item Optional Parameters -AutoClose =E<gt> 0|1, BinModeOut =E<gt> 0|1, -Append =E<gt> 0|1, --MultiStream =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >> =item Examples @@ -13598,9 +13904,9 @@ A filename, A filehandle, A scalar reference =item Constructor Options --AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string, --Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size, --Append =E<gt> 0|1, -Strict =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string +>>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength => +$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =item Examples @@ -13640,6 +13946,10 @@ A filename, A filehandle, A scalar reference =item close +=item nextStream + +=item trailingData + =back =item Importing @@ -13704,7 +14014,7 @@ Reference, An Output FileGlob =item Optional Parameters -AutoClose =E<gt> 0|1, BinModeIn =E<gt> 0|1, -Append =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> =item Examples @@ -13720,8 +14030,8 @@ A filename, A filehandle, A scalar reference =item Constructor Options -AutoClose =E<gt> 0|1, Append =E<gt> 0|1, A Buffer, A Filename, A -Filehandle, Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A +Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> =item Examples @@ -13761,8 +14071,6 @@ Filehandle, Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1 =item newStream([OPTS]) -Level - =item deflateParams =back @@ -13810,7 +14118,7 @@ Reference, An Output FileGlob =item Optional Parameters -AutoClose =E<gt> 0|1, BinModeIn =E<gt> 0|1, -Append =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> =item Examples @@ -13826,11 +14134,12 @@ A filename, A filehandle, A scalar reference =item Constructor Options -AutoClose =E<gt> 0|1, Append =E<gt> 0|1, A Buffer, A Filename, A -Filehandle, Merge =E<gt> 0|1, -Level, -Strategy, -Minimal =E<gt> 0|1, --Comment =E<gt> $comment, -Name =E<gt> $string, -Time =E<gt> $number, --TextFlag =E<gt> 0|1, -HeaderCRC =E<gt> 0|1, -OS_Code =E<gt> $value, --ExtraField =E<gt> $data, -ExtraFlags =E<gt> $value, -Strict =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A +Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Minimal => 0|1 >>, +C<< Comment => $comment >>, C<< Name => $string >>, C<< Time => $number >>, +C<< TextFlag => 0|1 >>, C<< HeaderCRC => 0|1 >>, C<< OS_Code => $value >>, +C<< ExtraField => $data >>, C<< ExtraFlags => $value >>, C<< Strict => 0|1 +>> =item Examples @@ -13870,8 +14179,6 @@ Filehandle, Merge =E<gt> 0|1, -Level, -Strategy, -Minimal =E<gt> 0|1, =item newStream([OPTS]) -Level - =item deflateParams =back @@ -13919,7 +14226,7 @@ Reference, An Output FileGlob =item Optional Parameters -AutoClose =E<gt> 0|1, BinModeIn =E<gt> 0|1, -Append =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> =item Examples @@ -13935,8 +14242,8 @@ A filename, A filehandle, A scalar reference =item Constructor Options -AutoClose =E<gt> 0|1, Append =E<gt> 0|1, A Buffer, A Filename, A -Filehandle, Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A +Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> =item Examples @@ -13976,8 +14283,6 @@ Filehandle, Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1 =item newStream([OPTS]) -Level - =item deflateParams =back @@ -14025,7 +14330,7 @@ Reference, An Output FileGlob =item Optional Parameters -AutoClose =E<gt> 0|1, BinModeIn =E<gt> 0|1, -Append =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> =item Examples @@ -14041,13 +14346,13 @@ A filename, A filehandle, A scalar reference =item Constructor Options -AutoClose =E<gt> 0|1, Append =E<gt> 0|1, A Buffer, A Filename, A -Filehandle, -Name =E<gt> $string, -Time =E<gt> $number, -exTime =E<gt> -[$atime, $mtime, $ctime], -Comment =E<gt> $comment, -ZipComment =E<gt> -$comment, Method =E<gt> $method, Stream =E<gt> 0|1, -TextFlag =E<gt> 0|1, -ExtraFieldLocal =E<gt> $data =item ExtraFieldCentral =E<gt> $data, Minimal -=E<gt> 1|0, BlockSize100K =E<gt> number, WorkFactor =E<gt> number, -Level, --Strategy, -Strict =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A +Filehandle, C<< Name => $string >>, C<< Time => $number >>, C<< exTime => +[$atime, $mtime, $ctime] >>, C<< Comment => $comment >>, C<< ZipComment => +$comment >>, C<< Method => $method >>, C<< Stream => 0|1 >>, C<< TextFlag +=> 0|1 >>, C<< ExtraFieldLocal => $data >> =item C<< ExtraFieldCentral => +$data >>, C<< Minimal => 1|0 >>, C<< BlockSize100K => number >>, C<< +WorkFactor => number >>, -Level, -Strategy, C<< Strict => 0|1 >> =item Examples @@ -14087,8 +14392,6 @@ ExtraFieldLocal =E<gt> $data =item ExtraFieldCentral =E<gt> $data, Minimal =item newStream([OPTS]) -Level - =item deflateParams =back @@ -14136,8 +14439,8 @@ Reference, An Output FileGlob =item Optional Parameters -AutoClose =E<gt> 0|1, BinModeOut =E<gt> 0|1, -Append =E<gt> 0|1, --MultiStream =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >> =item Examples @@ -14153,9 +14456,10 @@ A filename, A filehandle, A scalar reference =item Constructor Options --AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string, --Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size, --Append =E<gt> 0|1, -Strict =E<gt> 0|1, -ParseExtra =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string +>>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength => +$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< ParseExtra => 0|1 +>> =item Examples @@ -14197,6 +14501,10 @@ A filename, A filehandle, A scalar reference =item close +=item nextStream + +=item trailingData + =back =item Importing @@ -14242,8 +14550,8 @@ Reference, An Output FileGlob =item Optional Parameters -AutoClose =E<gt> 0|1, BinModeOut =E<gt> 0|1, -Append =E<gt> 0|1, --MultiStream =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >> =item Examples @@ -14259,9 +14567,10 @@ A filename, A filehandle, A scalar reference =item Constructor Options --AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string, --Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size, --Append =E<gt> 0|1, -Strict =E<gt> 0|1, -ParseExtra =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string +>>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength => +$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< ParseExtra => 0|1 +>> =item Examples @@ -14305,6 +14614,10 @@ Name, Comment =item close +=item nextStream + +=item trailingData + =back =item Importing @@ -14350,8 +14663,8 @@ Reference, An Output FileGlob =item Optional Parameters -AutoClose =E<gt> 0|1, BinModeOut =E<gt> 0|1, -Append =E<gt> 0|1, --MultiStream =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >> =item Examples @@ -14367,9 +14680,9 @@ A filename, A filehandle, A scalar reference =item Constructor Options --AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string, --Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size, --Append =E<gt> 0|1, -Strict =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string +>>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength => +$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =item Examples @@ -14411,6 +14724,10 @@ A filename, A filehandle, A scalar reference =item close +=item nextStream + +=item trailingData + =back =item Importing @@ -14456,8 +14773,8 @@ Reference, An Output FileGlob =item Optional Parameters -AutoClose =E<gt> 0|1, BinModeOut =E<gt> 0|1, -Append =E<gt> 0|1, --MultiStream =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >> =item Examples @@ -14473,9 +14790,9 @@ A filename, A filehandle, A scalar reference =item Constructor Options --AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string, --Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size, --Append =E<gt> 0|1, -Strict =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string +>>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength => +$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =item Examples @@ -14517,6 +14834,10 @@ A filename, A filehandle, A scalar reference =item close +=item nextStream + +=item trailingData + =back =item Importing @@ -14562,8 +14883,8 @@ Reference, An Output FileGlob =item Optional Parameters -AutoClose =E<gt> 0|1, BinModeOut =E<gt> 0|1, -Append =E<gt> 0|1, --MultiStream =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >> =item Examples @@ -14579,9 +14900,9 @@ A filename, A filehandle, A scalar reference =item Constructor Options --AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string, --Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size, --Append =E<gt> 0|1, -Strict =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string +>>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength => +$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =item Examples @@ -14623,6 +14944,10 @@ A filename, A filehandle, A scalar reference =item close +=item nextStream + +=item trailingData + =back =item Importing @@ -14931,8 +15256,6 @@ B<-WindowBits>, B<-Bufsize>, B<-Dictionary> =item CHECKSUM FUNCTIONS -=item ACCESSING ZIP FILES - =item CONSTANTS =item SEE ALSO @@ -15040,8 +15363,6 @@ B<-WindowBits>, B<-Bufsize>, B<-Dictionary> =item CHECKSUM FUNCTIONS -=item ACCESSING ZIP FILES - =item CONSTANTS =item SEE ALSO @@ -15108,36 +15429,37 @@ C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_builtin_choose_expr>, C<d_builtin_expect>, C<d_bzero>, C<d_c99_variadic_macros>, C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>, C<d_chsize>, C<d_class>, C<d_clearenv>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>, -C<d_copysignl>, C<d_crypt>, C<d_crypt_r>, C<d_csh>, C<d_ctermid_r>, -C<d_ctime_r>, C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>, C<d_difftime>, -C<d_dirfd>, C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, -C<d_dosuid>, C<d_drand48_r>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, -C<d_endgrent>, C<d_endgrent_r>, C<d_endhent>, C<d_endhostent_r>, -C<d_endnent>, C<d_endnetent_r>, C<d_endpent>, C<d_endprotoent_r>, -C<d_endpwent>, C<d_endpwent_r>, C<d_endsent>, C<d_endservent_r>, -C<d_eofnblk>, C<d_eunice>, C<d_faststdio>, C<d_fchdir>, C<d_fchmod>, -C<d_fchown>, C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>, -C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>, -C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>, -C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>, -C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>, -C<d_fsync>, C<d_ftello>, C<d_ftime>, C<d_futimes>, C<d_Gconvert>, -C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>, -C<d_getgrent_r>, C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>, -C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>, -C<d_gethostbyaddr_r>, C<d_gethostbyname_r>, C<d_gethostent_r>, -C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>, -C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>, -C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>, -C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>, -C<d_getpent>, C<d_getpgid>, C<d_getpgrp>, C<d_getpgrp2>, C<d_getppid>, -C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>, -C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>, -C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>, -C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>, -C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>, -C<d_gettimeod>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, -C<d_htonl>, C<d_ilogbl>, C<d_inc_version_list>, C<d_index>, C<d_inetaton>, +C<d_cplusplus>, C<d_copysignl>, C<d_crypt>, C<d_crypt_r>, C<d_csh>, +C<d_ctermid_r>, C<d_ctime_r>, C<d_cuserid>, C<d_dbl_dig>, +C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>, C<d_dirnamlen>, C<d_dlerror>, +C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>, C<d_drand48_r>, C<d_drand48proto>, +C<d_dup2>, C<d_eaccess>, C<d_endgrent>, C<d_endgrent_r>, C<d_endhent>, +C<d_endhostent_r>, C<d_endnent>, C<d_endnetent_r>, C<d_endpent>, +C<d_endprotoent_r>, C<d_endpwent>, C<d_endpwent_r>, C<d_endsent>, +C<d_endservent_r>, C<d_eofnblk>, C<d_eunice>, C<d_faststdio>, C<d_fchdir>, +C<d_fchmod>, C<d_fchown>, C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>, +C<d_fd_set>, C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>, +C<d_flexfnam>, C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>, +C<d_fpathconf>, C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>, +C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>, +C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>, C<d_ftello>, C<d_ftime>, +C<d_futimes>, C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>, +C<d_getgrent>, C<d_getgrent_r>, C<d_getgrgid_r>, C<d_getgrnam_r>, +C<d_getgrps>, C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, +C<d_gethname>, C<d_gethostbyaddr_r>, C<d_gethostbyname_r>, +C<d_gethostent_r>, C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, +C<d_getlogin_r>, C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, +C<d_getnbyname>, C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, +C<d_getnetent_r>, C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, +C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>, C<d_getpgrp>, C<d_getpgrp2>, +C<d_getppid>, C<d_getprior>, C<d_getprotobyname_r>, +C<d_getprotobynumber_r>, C<d_getprotoent_r>, C<d_getprotoprotos>, +C<d_getprpwnam>, C<d_getpwent>, C<d_getpwent_r>, C<d_getpwnam_r>, +C<d_getpwuid_r>, C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>, +C<d_getservbyname_r>, C<d_getservbyport_r>, C<d_getservent_r>, +C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>, C<d_gettimeod>, +C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>, +C<d_ilogbl>, C<d_inc_version_list>, C<d_index>, C<d_inetaton>, C<d_int64_t>, C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>, C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, C<d_libm_lib_version>, C<d_link>, C<d_localtime_r>, C<d_locconv>, @@ -15997,6 +16319,8 @@ $md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest =item NIST STATEMENT ON SHA-1 +=item BASE64 DIGESTS + =item EXPORT =item EXPORTABLE FUNCTIONS @@ -16009,8 +16333,7 @@ B<sha224_base64($data, ...)>, B<sha256_base64($data, ...)>, B<sha384_base64($data, ...)>, B<sha512_base64($data, ...)>, B<new($alg)>, B<reset($alg)>, B<hashsize>, B<algorithm>, B<clone>, B<add($data, ...)>, B<add_bits($data, $nbits)>, B<add_bits($bits)>, B<addfile(*FILE)>, -B<addfile($filename [, $mode])>, B<"b"> read file in binary mode, -B<"p"> use portable mode, B<dump($filename)>, B<load($filename)>, +B<addfile($filename [, $mode])>, B<dump($filename)>, B<load($filename)>, B<digest>, B<hexdigest>, B<b64digest>, B<hmac_sha1($data, $key)>, B<hmac_sha224($data, $key)>, B<hmac_sha256($data, $key)>, B<hmac_sha384($data, $key)>, B<hmac_sha512($data, $key)>, @@ -18501,13 +18824,13 @@ suffix. =back -C<fileparse> +C<fileparse> X<fileparse> -C<basename> +C<basename> X<basename> X<filename> -C<dirname> +C<dirname> X<dirname> -C<fileparse_set_fstype> +C<fileparse_set_fstype> X<filesystem> =over 4 @@ -18551,13 +18874,8 @@ C<fileparse_set_fstype> =item DESCRIPTION -=over 4 - -=item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32) - -rmscopy($from,$to[,$date_flag]) - -=back +copy X<copy> X<cp>, move X<move> X<mv> X<rename>, syscopy X<syscopy>, +rmscopy($from,$to[,$date_flag]) X<rmscopy> =item RETURN @@ -19435,6 +19753,8 @@ with switch clustering =over 4 +=item Field hashes + =item Restricted hashes B<lock_keys>, B<unlock_keys> @@ -19479,6 +19799,107 @@ unlock_hashref_recurse, hash_ref_unlocked, legal_ref_keys, hidden_ref_keys =back +=head2 Hash::Util::FieldHash - Associate references with data + +=over 4 + +=item SYNOPSIS + +=item Functions + +fieldhash, fieldhashes + +=item Description + +=over 4 + +=item Features + +Key exchange, Thread support, Garbage collection + +=item Rationale + +Stringification, Thread Dependency, Garbage Collection + +=item How to use + +=item Examples + +=item Garbage-Collected Hashes + +=back + +=item Guts + +=over 4 + +=item The C<PERL_MAGIC_uvar> interface for hashes + +=item Weakrefs call uvar magic + +=item How field hashes work + +=item Internal function Hash::Util::FieldHash::_fieldhash + +=back + +=item AUTHOR + +=item COPYRIGHT AND LICENSE + +=back + +=head2 Hash::Util::FieldHash::lib::Hash::Util::FieldHash, +Hash::Util::FieldHash - Associate references with data + +=over 4 + +=item SYNOPSIS + +=item Functions + +fieldhash, fieldhashes + +=item Description + +=over 4 + +=item Features + +Key exchange, Thread support, Garbage collection + +=item Rationale + +Stringification, Thread Dependency, Garbage Collection + +=item How to use + +=item Examples + +=item Garbage-Collected Hashes + +=back + +=item Guts + +=over 4 + +=item The C<PERL_MAGIC_uvar> interface for hashes + +=item Weakrefs call uvar magic + +=item How field hashes work + +=item Internal function Hash::Util::FieldHash::_fieldhash + +=back + +=item AUTHOR + +=item COPYRIGHT AND LICENSE + +=back + =head2 Hash::Utilib::Hash::Util, Hash::Util - A selection of general-utility hash subroutines @@ -19490,6 +19911,8 @@ general-utility hash subroutines =over 4 +=item Field hashes + =item Restricted hashes B<lock_keys>, B<unlock_keys> @@ -19839,7 +20262,7 @@ Reference, An Output FileGlob =item Optional Parameters -AutoClose =E<gt> 0|1, BinModeIn =E<gt> 0|1, -Append =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> =item Examples @@ -19855,8 +20278,8 @@ A filename, A filehandle, A scalar reference =item Constructor Options -AutoClose =E<gt> 0|1, Append =E<gt> 0|1, A Buffer, A Filename, A -Filehandle, Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A +Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> =item Examples @@ -19896,8 +20319,6 @@ Filehandle, Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1 =item newStream([OPTS]) -Level - =item deflateParams =back @@ -19944,7 +20365,7 @@ Reference, An Output FileGlob =item Optional Parameters -AutoClose =E<gt> 0|1, BinModeIn =E<gt> 0|1, -Append =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> =item Examples @@ -19960,11 +20381,12 @@ A filename, A filehandle, A scalar reference =item Constructor Options -AutoClose =E<gt> 0|1, Append =E<gt> 0|1, A Buffer, A Filename, A -Filehandle, Merge =E<gt> 0|1, -Level, -Strategy, -Minimal =E<gt> 0|1, --Comment =E<gt> $comment, -Name =E<gt> $string, -Time =E<gt> $number, --TextFlag =E<gt> 0|1, -HeaderCRC =E<gt> 0|1, -OS_Code =E<gt> $value, --ExtraField =E<gt> $data, -ExtraFlags =E<gt> $value, -Strict =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A +Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Minimal => 0|1 >>, +C<< Comment => $comment >>, C<< Name => $string >>, C<< Time => $number >>, +C<< TextFlag => 0|1 >>, C<< HeaderCRC => 0|1 >>, C<< OS_Code => $value >>, +C<< ExtraField => $data >>, C<< ExtraFlags => $value >>, C<< Strict => 0|1 +>> =item Examples @@ -20004,8 +20426,6 @@ Filehandle, Merge =E<gt> 0|1, -Level, -Strategy, -Minimal =E<gt> 0|1, =item newStream([OPTS]) -Level - =item deflateParams =back @@ -20052,7 +20472,7 @@ Reference, An Output FileGlob =item Optional Parameters -AutoClose =E<gt> 0|1, BinModeIn =E<gt> 0|1, -Append =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> =item Examples @@ -20068,8 +20488,8 @@ A filename, A filehandle, A scalar reference =item Constructor Options -AutoClose =E<gt> 0|1, Append =E<gt> 0|1, A Buffer, A Filename, A -Filehandle, Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A +Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> =item Examples @@ -20109,8 +20529,6 @@ Filehandle, Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1 =item newStream([OPTS]) -Level - =item deflateParams =back @@ -20157,7 +20575,7 @@ Reference, An Output FileGlob =item Optional Parameters -AutoClose =E<gt> 0|1, BinModeIn =E<gt> 0|1, -Append =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> =item Examples @@ -20173,13 +20591,13 @@ A filename, A filehandle, A scalar reference =item Constructor Options -AutoClose =E<gt> 0|1, Append =E<gt> 0|1, A Buffer, A Filename, A -Filehandle, -Name =E<gt> $string, -Time =E<gt> $number, -exTime =E<gt> -[$atime, $mtime, $ctime], -Comment =E<gt> $comment, -ZipComment =E<gt> -$comment, Method =E<gt> $method, Stream =E<gt> 0|1, -TextFlag =E<gt> 0|1, -ExtraFieldLocal =E<gt> $data =item ExtraFieldCentral =E<gt> $data, Minimal -=E<gt> 1|0, BlockSize100K =E<gt> number, WorkFactor =E<gt> number, -Level, --Strategy, -Strict =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A +Filehandle, C<< Name => $string >>, C<< Time => $number >>, C<< exTime => +[$atime, $mtime, $ctime] >>, C<< Comment => $comment >>, C<< ZipComment => +$comment >>, C<< Method => $method >>, C<< Stream => 0|1 >>, C<< TextFlag +=> 0|1 >>, C<< ExtraFieldLocal => $data >> =item C<< ExtraFieldCentral => +$data >>, C<< Minimal => 1|0 >>, C<< BlockSize100K => number >>, C<< +WorkFactor => number >>, -Level, -Strategy, C<< Strict => 0|1 >> =item Examples @@ -20219,8 +20637,6 @@ ExtraFieldLocal =E<gt> $data =item ExtraFieldCentral =E<gt> $data, Minimal =item newStream([OPTS]) -Level - =item deflateParams =back @@ -20508,8 +20924,8 @@ Reference, An Output FileGlob =item Optional Parameters -AutoClose =E<gt> 0|1, BinModeOut =E<gt> 0|1, -Append =E<gt> 0|1, --MultiStream =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >> =item Examples @@ -20525,9 +20941,10 @@ A filename, A filehandle, A scalar reference =item Constructor Options --AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string, --Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size, --Append =E<gt> 0|1, -Strict =E<gt> 0|1, -ParseExtra =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string +>>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength => +$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< ParseExtra => 0|1 +>> =item Examples @@ -20569,6 +20986,10 @@ A filename, A filehandle, A scalar reference =item close +=item nextStream + +=item trailingData + =back =item Importing @@ -20614,8 +21035,8 @@ Reference, An Output FileGlob =item Optional Parameters -AutoClose =E<gt> 0|1, BinModeOut =E<gt> 0|1, -Append =E<gt> 0|1, --MultiStream =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >> =item Examples @@ -20631,9 +21052,9 @@ A filename, A filehandle, A scalar reference =item Constructor Options --AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string, --Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size, --Append =E<gt> 0|1, -Strict =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string +>>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength => +$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =item Examples @@ -20673,6 +21094,10 @@ A filename, A filehandle, A scalar reference =item close +=item nextStream + +=item trailingData + =back =item Importing @@ -20735,8 +21160,8 @@ Reference, An Output FileGlob =item Optional Parameters -AutoClose =E<gt> 0|1, BinModeOut =E<gt> 0|1, -Append =E<gt> 0|1, --MultiStream =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >> =item Examples @@ -20752,9 +21177,10 @@ A filename, A filehandle, A scalar reference =item Constructor Options --AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string, --Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size, --Append =E<gt> 0|1, -Strict =E<gt> 0|1, -ParseExtra =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string +>>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength => +$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< ParseExtra => 0|1 +>> =item Examples @@ -20798,6 +21224,10 @@ Name, Comment =item close +=item nextStream + +=item trailingData + =back =item Importing @@ -20842,8 +21272,8 @@ Reference, An Output FileGlob =item Optional Parameters -AutoClose =E<gt> 0|1, BinModeOut =E<gt> 0|1, -Append =E<gt> 0|1, --MultiStream =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >> =item Examples @@ -20859,9 +21289,9 @@ A filename, A filehandle, A scalar reference =item Constructor Options --AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string, --Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size, --Append =E<gt> 0|1, -Strict =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string +>>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength => +$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =item Examples @@ -20903,6 +21333,10 @@ A filename, A filehandle, A scalar reference =item close +=item nextStream + +=item trailingData + =back =item Importing @@ -20947,8 +21381,8 @@ Reference, An Output FileGlob =item Optional Parameters -AutoClose =E<gt> 0|1, BinModeOut =E<gt> 0|1, -Append =E<gt> 0|1, --MultiStream =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >> =item Examples @@ -20964,9 +21398,9 @@ A filename, A filehandle, A scalar reference =item Constructor Options --AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string, --Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size, --Append =E<gt> 0|1, -Strict =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string +>>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength => +$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =item Examples @@ -21008,6 +21442,10 @@ A filename, A filehandle, A scalar reference =item close +=item nextStream + +=item trailingData + =back =item Importing @@ -21052,8 +21490,8 @@ Reference, An Output FileGlob =item Optional Parameters -AutoClose =E<gt> 0|1, BinModeOut =E<gt> 0|1, -Append =E<gt> 0|1, --MultiStream =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >> =item Examples @@ -21069,9 +21507,9 @@ A filename, A filehandle, A scalar reference =item Constructor Options --AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string, --Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size, --Append =E<gt> 0|1, -Strict =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string +>>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength => +$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =item Examples @@ -21113,6 +21551,10 @@ A filename, A filehandle, A scalar reference =item close +=item nextStream + +=item trailingData + =back =item Importing @@ -22402,6 +22844,12 @@ functions =item USAGE +=over 4 + +=item PI + +=back + =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS @@ -22434,6 +22882,9 @@ B<tan> =item PLANE ANGLE CONVERSIONS +deg2rad, grad2rad, rad2deg, grad2deg, deg2grad, rad2grad, rad2rad, deg2deg, +grad2grad + =item RADIAL COORDINATE CONVERSIONS =over 4 @@ -22449,6 +22900,22 @@ cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical =item GREAT CIRCLE DISTANCES AND DIRECTIONS +=over 4 + +=item great_circle_distance + +=item great_circle_direction + +=item great_circle_bearing + +=item great_circle_destination + +=item great_circle_midpoint + +=item great_circle_waypoint + +=back + =item EXAMPLES =over 4 @@ -22617,7 +23084,7 @@ versioninstall =item Command Line Options -quiet, use_rcfile, verbose +quiet, use_rcfile, verbose, allow_mb_mismatch =item Default Options File (F<.modulebuildrc>) @@ -22626,15 +23093,7 @@ quiet, use_rcfile, verbose =item INSTALL PATHS lib, arch, script, bin, bindoc, libdoc, binhtml, libhtml, installdirs, -install_path, install_base, destdir - -=over 4 - -=item About PREFIX Support - -Why PREFIX is not recommended, Alternatives to PREFIX - -=back +install_path, install_base, destdir, prefix =item MOTIVATIONS @@ -22697,15 +23156,15 @@ $default) =item Autogenerated Accessors -PL_files(), autosplit(), base_dir(), bindoc_dirs(), blib(), build_bat(), -build_class(), build_elements(), build_requires(), build_script(), -c_source(), config(), config_dir(), conflicts(), create_makefile_pl(), -create_packlist(), create_readme(), debugger(), destdir(), get_options(), -html_css(), include_dirs(), install_base(), install_sets(), installdirs(), -libdoc_dirs(), license(), magic_number(), mb_version(), meta_add(), -meta_merge(), metafile(), module_name(), orig_dir(), original_prefix(), -perl(), pm_files(), pod_files(), pollute(), prefix(), -prereq_action_types(), quiet(), recommends(), recurse_into(), +PL_files(), allow_mb_mismatch(), autosplit(), base_dir(), bindoc_dirs(), +blib(), build_bat(), build_class(), build_elements(), build_requires(), +build_script(), c_source(), config(), config_dir(), conflicts(), +create_makefile_pl(), create_packlist(), create_readme(), debugger(), +destdir(), get_options(), html_css(), include_dirs(), install_base(), +install_sets(), installdirs(), libdoc_dirs(), license(), magic_number(), +mb_version(), meta_add(), meta_merge(), metafile(), module_name(), +orig_dir(), original_prefix(), perl(), pm_files(), pod_files(), pollute(), +prefix(), prereq_action_types(), quiet(), recommends(), recurse_into(), recursive_test_files(), requires(), scripts(), use_rcfile(), verbose(), xs_files() @@ -22828,6 +23287,8 @@ auto_feature_names(), write() =item Installing to a non-standard directory +=item Installing in the same location as ExtUtils::MakeMaker + =item Running a single test file =back @@ -23156,6 +23617,62 @@ Module::Build works even if YAML.pm is not installed =back +=head2 Module::Load - runtime require of both modules and files + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item Rules + +=item Caveats + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 Module::Loaded - mark modules as loaded or unloaded + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item FUNCTIONS + +=over 4 + +=item $bool = mark_as_loaded( PACKAGE ); + +=back + +=back + +=over 4 + +=item $bool = mark_as_unloaded( PACKAGE ); + +=back + +=over 4 + +=item $loc = is_loaded( PACKAGE ); + +=back + +=over 4 + +=item AUTHOR + +=item COPYRIGHT + +=back + =head2 NDBM_File - Tied access to ndbm files =over 4 @@ -23958,6 +24475,44 @@ WTERMSIG, WIFSTOPPED, WSTOPSIG =back +=head2 Package::Constants - List all constants declared in a package + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CLASS METHODS + +=over 4 + +=item @const = Package::Constants->list( PACKAGE_NAME ); + +=back + +=back + +=over 4 + +=item GLOBAL VARIABLES + +=over 4 + +=item $Package::Constants::DEBUG + +=back + +=back + +=over 4 + +=item AUTHOR + +=item COPYRIGHT + +=back + =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::* name space @@ -26029,6 +26584,8 @@ set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF =back +B<_make_cmd> + =head2 Shell - run shell commands transparently within perl =over 4 @@ -26642,7 +27199,7 @@ Test::Builder =over 4 -=item Methods +=item Functions test_out, test_err @@ -27356,6 +27913,8 @@ unexpand(1) =item DESCRIPTION +=item EXAMPLE + =item BUGS =item LICENSE @@ -27372,7 +27931,7 @@ unexpand(1) =item OVERRIDES -=item EXAMPLE +=item EXAMPLES =item LICENSE @@ -27707,8 +28266,14 @@ $flags = 0), clock() =item DESCRIPTION +=item FUNCTIONS + =over 4 +=item Year Value Interpretation + +=item Limits of time_t + =item Ambiguous Local Times (DST) =item Non-Existent Local Times (DST) @@ -27778,9 +28343,9 @@ function =item DESCRIPTION C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C<< eval { VAL->isa( -TYPE ) } >>, C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->can( METHOD ) ->>, C<< CLASS->can( METHOD ) >>, C<< eval { VAL->can( METHOD ) } >>, -C<VERSION ( [ REQUIRE ] )> +TYPE ) } >>, C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->DOES( ROLE ) >>, +C<< CLASS->DOES( ROLE ) >>, C<< $obj->can( METHOD ) >>, C<< CLASS->can( +METHOD ) >>, C<< eval { VAL->can( METHOD ) } >>, C<VERSION ( [ REQUIRE ] )> =item EXPORTS @@ -27867,9 +28432,9 @@ C<$normalized_string = normalize($form_name, $string)> =item Decomposition and Composition -C<$decomposed_string = decompose($string)>, C<$decomposed_string = -decompose($string, $useCompatMapping)>, C<$reordered_string = -reorder($string)>, C<$composed_string = compose($string)> +C<$decomposed_string = decompose($string [, $useCompatMapping])>, +C<$reordered_string = reorder($string)>, C<$composed_string = +compose($string)> =item Quick Check @@ -27880,13 +28445,19 @@ check($form_name, $string)> =item Character Data -C<$canonical_decomposed = getCanon($codepoint)>, -C<$compatibility_decomposed = getCompat($codepoint)>, -C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>, -C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion = -isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>, -C<$is_non_starter_decomposition = isNonStDecomp($codepoint)>, -C<$may_be_composed_with_prev_char = isComp2nd($codepoint)> +C<$canonical_decomposition = getCanon($code_point)>, +C<$compatibility_decomposition = getCompat($code_point)>, +C<$code_point_composite = getComposite($code_point_here, +$code_point_next)>, C<$combining_class = getCombinClass($code_point)>, +C<$may_be_composed_with_prev_char = isComp2nd($code_point)>, +C<$is_exclusion = isExclusion($code_point)>, C<$is_singleton = +isSingleton($code_point)>, C<$is_non_starter_decomposition = +isNonStDecomp($code_point)>, C<$is_Full_Composition_Exclusion = +isComp_Ex($code_point)>, C<$NFD_is_NO = isNFD_NO($code_point)>, +C<$NFC_is_NO = isNFC_NO($code_point)>, C<$NFC_is_MAYBE = +isNFC_MAYBE($code_point)>, C<$NFKD_is_NO = isNFKD_NO($code_point)>, +C<$NFKC_is_NO = isNFKC_NO($code_point)>, C<$NFKC_is_MAYBE = +isNFKC_MAYBE($code_point)> =back @@ -27902,6 +28473,7 @@ Revised definition of canonical composition =item SEE ALSO http://www.unicode.org/reports/tr15/, +http://www.unicode.org/Public/UNIDATA/CompositionExclusions.txt, http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt, http://www.unicode.org/Public/UNIDATA/NormalizationCorrections.txt, http://www.unicode.org/review/pr-29.html, http://www.unicode.org/notes/tn5/