X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperltoc.pod;h=6536974f8cacc13e7c0b732a6c60c42f0943650e;hb=d7d7d533fb289d8ec4fa1b5fb02f927ed0cb90cc;hp=6878ef8a555dc2bf73f1455f15d7b98014c0552b;hpb=6477b3196903f6403644261bc4a2e5ebc6ff1948;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perltoc.pod b/pod/perltoc.pod index 6878ef8..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 @@ -806,8 +808,7 @@ LIMIT specified =back -=head2 perlfaq - frequently asked questions about Perl ($Date: 2005/12/30 -15:04:07 $) +=head2 perlfaq - frequently asked questions about Perl ($Revision: 3606 $) =over 4 @@ -820,21 +821,13 @@ LIMIT specified =item How to contribute to the perlfaq =item What will happen if you mail your Perl programming problems to the -authors +authors? =back -=item Credits - -=item Author and Copyright Information - -=over 4 - -=item Bundled Distributions - -=item Disclaimer +=item CREDITS -=back +=item AUTHOR AND COPYRIGHT =item Table of Contents @@ -870,8 +863,7 @@ Interaction, perlfaq9 - Networking =back -=head2 perlfaq1 - General Questions About Perl ($Revision: 1.19 $, $Date: -2005/12/31 00:54:37 $) +=head2 perlfaq1 - General Questions About Perl ($Revision: 3606 $) =over 4 @@ -910,17 +902,20 @@ Scheme, or Tcl? =item Where can I get a list of Larry Wall witticisms? -=item How can I convince my sysadmin/supervisor/employees to use version -5/5.6.1/Perl instead of some other language? +=item How can I convince others to use Perl? + +http://perltraining.com.au/whyperl.html, +http://www.perl.org/advocacy/whyperl.html =back +=item REVISION + =item AUTHOR AND COPYRIGHT =back -=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.38 $, -$Date: 2005/12/31 00:54:37 $) +=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 3606 $) =over 4 @@ -955,13 +950,11 @@ What does CPAN/src/... mean? References, Tutorials, Task-Oriented, Special Topics -=item Perl in Magazines - -=item Perl on the Net: FTP and WWW Access +=item Which magazines have Perl content? =item What mailing lists are there for Perl? -=item Archives of comp.lang.perl.misc +=item Where are the archives for comp.lang.perl.misc? =item Where can I buy a commercial version of perl? @@ -971,12 +964,13 @@ References, Tutorials, Task-Oriented, Special Topics =back +=item REVISION + =item AUTHOR AND COPYRIGHT =back -=head2 perlfaq3 - Programming Tools ($Revision: 1.56 $, $Date: 2005/12/31 -00:54:37 $) +=head2 perlfaq3 - Programming Tools ($Revision: 3606 $) =over 4 @@ -1057,12 +1051,13 @@ program; what am I doing wrong? =back +=item REVISION + =item AUTHOR AND COPYRIGHT =back -=head2 perlfaq4 - Data Manipulation ($Revision: 1.73 $, $Date: 2005/12/31 -00:54:37 $) +=head2 perlfaq4 - Data Manipulation ($Revision: 3606 $) =over 4 @@ -1274,12 +1269,13 @@ array of hashes or arrays? =back +=item REVISION + =item AUTHOR AND COPYRIGHT =back -=head2 perlfaq5 - Files and Formats ($Revision: 1.42 $, $Date: 2005/12/31 -00:54:37 $) +=head2 perlfaq5 - Files and Formats ($Revision: 3606 $) =over 4 @@ -1310,7 +1306,7 @@ X X X =item How can I make a filehandle local to a subroutine? How do I pass -filehandles between subroutines? How do I make an array of filehandles? +filehandles between subroutines? How do I make an array of filehandles? X X X =item How can I use a filehandle indirectly? @@ -1407,12 +1403,13 @@ X =back +=item REVISION + =item AUTHOR AND COPYRIGHT =back -=head2 perlfaq6 - Regular Expressions ($Revision: 1.38 $, $Date: 2005/12/31 -00:54:37 $) +=head2 perlfaq6 - Regular Expressions ($Revision: 3606 $) =over 4 @@ -1500,12 +1497,13 @@ X =back +=item REVISION + =item AUTHOR AND COPYRIGHT =back -=head2 perlfaq7 - General Perl Language Issues ($Revision: 1.28 $, $Date: -2005/12/31 00:54:37 $) +=head2 perlfaq7 - General Perl Language Issues ($Revision: 3606 $) =over 4 @@ -1582,12 +1580,13 @@ methods? =back +=item REVISION + =item AUTHOR AND COPYRIGHT =back -=head2 perlfaq8 - System Interaction ($Revision: 1.27 $, $Date: 2005/12/31 -00:54:37 $) +=head2 perlfaq8 - System Interaction ($Revision: 3606 $) =over 4 @@ -1712,12 +1711,13 @@ search path? =back +=item REVISION + =item AUTHOR AND COPYRIGHT =back -=head2 perlfaq9 - Networking ($Revision: 1.28 $, $Date: 2005/12/31 00:54:37 -$) +=head2 perlfaq9 - Networking ($Revision: 3606 $) =over 4 @@ -1784,6 +1784,8 @@ gethostbyname, Socket, Net::Domain, Sys::Hostname> =back +=item REVISION + =item AUTHOR AND COPYRIGHT =back @@ -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,40 +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}, -${^UTF8LOCALE}, $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS}, -$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 @@ -3773,12 +3803,15 @@ autodetected, C<use encoding> needed to upgrade non-Latin-1 byte strings =item Effects of Character Semantics -=item Scripts +=item Unicode Character Properties -=item Blocks +General Category, Bidirectional Character Types, Scripts, Extended property +classes, Use of "Is" Prefix, Blocks =item User-Defined Character Properties +=item User-Defined Case Mappings + =item Character Encodings for Input and Output =item Unicode Regular Expression Support Level @@ -3817,6 +3850,34 @@ autodetected, C<use encoding> needed to upgrade non-Latin-1 byte strings =back +=head2 perlunitut - Perl Unicode Tutorial + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Definitions + +=item Your new toolkit + +=item I/O flow (the actual 5 minute tutorial) + +=item Q and A + +=back + +=item SUMMARY + +=item ACKNOWLEDGEMENTS + +=item AUTHOR + +=item SEE ALSO + +=back + =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms =over 4 @@ -4035,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::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, @@ -4064,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, @@ -4078,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, @@ -4104,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 @@ -4342,38 +4419,61 @@ tarball, Announce to the modules list, Announce to clpa, Fix bugs! =back +=head2 perlpragma - how to write a user pragma + +=over 4 + +=item DESCRIPTION + +=item A basic example + +=item Implementation details + +=back + =head2 perlutil - utilities packaged with the Perl distribution =over 4 =item DESCRIPTION +=item LIST OF UTILITIES + =over 4 -=item DOCUMENTATION +=item Documentation L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>, L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>, L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>, L<roffitall|roffitall> -=item CONVERTORS +=item Convertors -L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl> +L<a2p|a2p>, L<s2p|s2p> and L<psed>, L<find2perl|find2perl> =item Administration -L<libnetcfg|libnetcfg> +L<config_data|config_data>, L<libnetcfg|libnetcfg>, L<perlivp> =item Development L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>, -L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc> +L<h2xs|h2xs>, L<enc2xs>, L<xsubpp>, L<dprofpp|dprofpp>, L<perlcc|perlcc>, +L<prove>, L<corelist> -=item SEE ALSO +=item General tools + +L<piconv>, L<ptar>, L<ptardiff>, L<shasum> + +=item Installation + +L<cpan>, L<instmodsh> =back +=item SEE ALSO + =back =head2 perlcompile - Introduction to the Perl Compiler-Translator @@ -4676,6 +4776,8 @@ Perl?>, B<Use C from C?>, B<Use Perl from C?> =item Execution of END blocks +=item $0 assignments + =item Maintaining multiple interpreter instances =item Using Perl modules, which themselves use C libraries, from your C @@ -5107,7 +5209,7 @@ save_hptr(HV **hptr)> =item Internal Functions -A, p, d, s, n, r, f, M, o, x, m, X, E, b +A, p, d, s, n, r, f, M, o, x, m, X, E, b, others =over 4 @@ -5235,6 +5337,68 @@ callback =back +=head2 perlreguts - Description of the Perl regular expression engine. + +=over 4 + +=item DESCRIPTION + +=item OVERVIEW + +=over 4 + +=item A quick note on terms + +=item What is a regular expression engine? + +=item Structure of a Regexp Program + +C<regnode_1>, C<regnode_2>, C<regnode_string>, C<regnode_charclass>, +C<regnode_charclass_class> + +=back + +=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 + +=item MISCELLANEOUS + +=over 4 + +=item Unicode and Localisation Support + +=item Base Struct + +-, -, -, - + +=item De-allocation and Cloning + +=back + +=item SEE ALSO + +=item AUTHOR + +=item LICENCE + +=item REFERENCES + +=back + =head2 perlapi - autogenerated documentation for the perl public API =over 4 @@ -5284,21 +5448,25 @@ 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>, sv_2pvbyte_nolen X<sv_2pvbyte_nolen>, -sv_2pvutf8_nolen X<sv_2pvutf8_nolen>, sv_2pv_nolen X<sv_2pv_nolen>, -sv_catpvn_mg X<sv_catpvn_mg>, sv_catsv_mg X<sv_catsv_mg>, sv_force_normal -X<sv_force_normal>, sv_iv X<sv_iv>, sv_nolocking X<sv_nolocking>, -sv_nounlocking X<sv_nounlocking>, sv_nv X<sv_nv>, sv_pv X<sv_pv>, sv_pvbyte -X<sv_pvbyte>, sv_pvbyten X<sv_pvbyten>, sv_pvn X<sv_pvn>, sv_pvutf8 -X<sv_pvutf8>, sv_pvutf8n X<sv_pvutf8n>, sv_taint X<sv_taint>, sv_unref -X<sv_unref>, sv_uv X<sv_uv> +gv_fetchmethod X<gv_fetchmethod>, pack_cat X<pack_cat>, sv_2pvbyte_nolen +X<sv_2pvbyte_nolen>, sv_2pvutf8_nolen X<sv_2pvutf8_nolen>, sv_2pv_nolen +X<sv_2pv_nolen>, sv_catpvn_mg X<sv_catpvn_mg>, sv_catsv_mg X<sv_catsv_mg>, +sv_force_normal X<sv_force_normal>, sv_iv X<sv_iv>, sv_nolocking +X<sv_nolocking>, sv_nounlocking X<sv_nounlocking>, sv_nv X<sv_nv>, sv_pv +X<sv_pv>, sv_pvbyte X<sv_pvbyte>, sv_pvbyten X<sv_pvbyten>, sv_pvn +X<sv_pvn>, sv_pvutf8 X<sv_pvutf8>, sv_pvutf8n X<sv_pvutf8n>, sv_taint +X<sv_taint>, sv_unref X<sv_unref>, sv_usepvn X<sv_usepvn>, sv_usepvn_mg +X<sv_usepvn_mg>, sv_uv X<sv_uv>, unpack_str X<unpack_str> =item Functions in file pp_pack.c -packlist X<packlist>, pack_cat X<pack_cat>, unpackstring X<unpackstring>, -unpack_str X<unpack_str> +packlist X<packlist>, unpackstring X<unpackstring> =item Global Variables @@ -5310,7 +5478,7 @@ PL_sv_undef X<PL_sv_undef>, PL_sv_yes X<PL_sv_yes> GvSV X<GvSV>, gv_const_sv X<gv_const_sv>, gv_fetchmeth X<gv_fetchmeth>, gv_fetchmethod_autoload X<gv_fetchmethod_autoload>, gv_fetchmeth_autoload X<gv_fetchmeth_autoload>, gv_stashpv X<gv_stashpv>, gv_stashpvn -X<gv_stashpvn>, gv_stashsv X<gv_stashsv> +X<gv_stashpvn>, gv_stashpvs X<gv_stashpvs>, gv_stashsv X<gv_stashsv> =item Handy Values @@ -5325,13 +5493,13 @@ X<HeSVKEY_force>, HeSVKEY_set X<HeSVKEY_set>, HeVAL X<HeVAL>, HvNAME X<HvNAME>, hv_assert X<hv_assert>, hv_clear X<hv_clear>, hv_clear_placeholders X<hv_clear_placeholders>, hv_delete X<hv_delete>, hv_delete_ent X<hv_delete_ent>, hv_exists X<hv_exists>, hv_exists_ent -X<hv_exists_ent>, hv_fetch X<hv_fetch>, hv_fetch_ent X<hv_fetch_ent>, -hv_iterinit X<hv_iterinit>, hv_iterkey X<hv_iterkey>, hv_iterkeysv -X<hv_iterkeysv>, hv_iternext X<hv_iternext>, hv_iternextsv -X<hv_iternextsv>, hv_iternext_flags X<hv_iternext_flags>, hv_iterval -X<hv_iterval>, hv_magic X<hv_magic>, hv_scalar X<hv_scalar>, hv_store -X<hv_store>, hv_store_ent X<hv_store_ent>, hv_undef X<hv_undef>, newHV -X<newHV> +X<hv_exists_ent>, hv_fetch X<hv_fetch>, hv_fetchs X<hv_fetchs>, +hv_fetch_ent X<hv_fetch_ent>, hv_iterinit X<hv_iterinit>, hv_iterkey +X<hv_iterkey>, hv_iterkeysv X<hv_iterkeysv>, hv_iternext X<hv_iternext>, +hv_iternextsv X<hv_iternextsv>, hv_iternext_flags X<hv_iternext_flags>, +hv_iterval X<hv_iterval>, hv_magic X<hv_magic>, hv_scalar X<hv_scalar>, +hv_store X<hv_store>, hv_stores X<hv_stores>, hv_store_ent X<hv_store_ent>, +hv_undef X<hv_undef>, newHV X<newHV> =item Magical Functions @@ -5346,20 +5514,22 @@ X<SvUNLOCK> =item Memory Management Copy X<Copy>, CopyD X<CopyD>, Move X<Move>, MoveD X<MoveD>, Newx X<Newx>, -Newxc X<Newxc>, Newxz X<Newxz>, Poison X<Poison>, Renew X<Renew>, Renewc +Newxc X<Newxc>, Newxz X<Newxz>, Poison X<Poison>, PoisonFree X<PoisonFree>, +PoisonNew X<PoisonNew>, PoisonWith X<PoisonWith>, Renew X<Renew>, Renewc X<Renewc>, Safefree X<Safefree>, savepv X<savepv>, savepvn X<savepvn>, -savesharedpv X<savesharedpv>, savesvpv X<savesvpv>, StructCopy -X<StructCopy>, Zero X<Zero>, ZeroD X<ZeroD> +savepvs X<savepvs>, savesharedpv X<savesharedpv>, savesvpv X<savesvpv>, +StructCopy X<StructCopy>, Zero X<Zero>, ZeroD X<ZeroD> =item Miscellaneous Functions fbm_compile X<fbm_compile>, fbm_instr X<fbm_instr>, form X<form>, getcwd_sv -X<getcwd_sv>, my_sprintf X<my_sprintf>, new_version X<new_version>, -scan_version X<scan_version>, strEQ X<strEQ>, strGE X<strGE>, strGT -X<strGT>, strLE X<strLE>, strLT X<strLT>, strNE X<strNE>, strnEQ X<strnEQ>, -strnNE X<strnNE>, sv_nosharing X<sv_nosharing>, upg_version X<upg_version>, -vcmp X<vcmp>, vnormal X<vnormal>, vnumify X<vnumify>, vstringify -X<vstringify>, vverify X<vverify> +X<getcwd_sv>, my_snprintf X<my_snprintf>, my_sprintf X<my_sprintf>, +my_vsnprintf X<my_vsnprintf>, new_version X<new_version>, scan_version +X<scan_version>, strEQ X<strEQ>, strGE X<strGE>, strGT X<strGT>, strLE +X<strLE>, strLT X<strLT>, strNE X<strNE>, strnEQ X<strnEQ>, strnNE +X<strnNE>, sv_nosharing X<sv_nosharing>, upg_version X<upg_version>, vcmp +X<vcmp>, vnormal X<vnormal>, vnumify X<vnumify>, vstringify X<vstringify>, +vverify X<vverify> =item Multicall Functions @@ -5412,15 +5582,11 @@ X<SVt_PVMG> =item SV Manipulation Functions -get_sv X<get_sv>, looks_like_number X<looks_like_number>, newRV_inc -X<newRV_inc>, newRV_noinc X<newRV_noinc>, NEWSV X<NEWSV>, newSV X<newSV>, -newSVhek X<newSVhek>, newSViv X<newSViv>, newSVnv X<newSVnv>, newSVpv -X<newSVpv>, newSVpvf X<newSVpvf>, newSVpvn X<newSVpvn>, newSVpvn_share -X<newSVpvn_share>, newSVrv X<newSVrv>, newSVsv X<newSVsv>, newSVuv -X<newSVuv>, SvCUR X<SvCUR>, SvCUR_set X<SvCUR_set>, SvEND X<SvEND>, SvGROW -X<SvGROW>, SvIOK X<SvIOK>, SvIOKp X<SvIOKp>, SvIOK_notUV X<SvIOK_notUV>, -SvIOK_off X<SvIOK_off>, SvIOK_on X<SvIOK_on>, SvIOK_only X<SvIOK_only>, -SvIOK_only_UV X<SvIOK_only_UV>, SvIOK_UV X<SvIOK_UV>, SvIsCOW X<SvIsCOW>, +get_sv X<get_sv>, newRV_inc X<newRV_inc>, SvCUR X<SvCUR>, SvCUR_set +X<SvCUR_set>, SvEND X<SvEND>, SvGAMAGIC X<SvGAMAGIC>, SvGROW X<SvGROW>, +SvIOK X<SvIOK>, SvIOKp X<SvIOKp>, SvIOK_notUV X<SvIOK_notUV>, SvIOK_off +X<SvIOK_off>, SvIOK_on X<SvIOK_on>, SvIOK_only X<SvIOK_only>, SvIOK_only_UV +X<SvIOK_only_UV>, SvIOK_UV X<SvIOK_UV>, SvIsCOW X<SvIsCOW>, SvIsCOW_shared_hash X<SvIsCOW_shared_hash>, SvIV X<SvIV>, SvIVX X<SvIVX>, SvIVx X<SvIVx>, SvIV_nomg X<SvIV_nomg>, SvIV_set X<SvIV_set>, SvLEN X<SvLEN>, SvLEN_set X<SvLEN_set>, SvMAGIC_set X<SvMAGIC_set>, SvNIOK @@ -5438,52 +5604,67 @@ X<SvPVutf8_nolen>, SvPVX X<SvPVX>, SvPVx X<SvPVx>, SvPV_force X<SvPV_force>, SvPV_force_nomg X<SvPV_force_nomg>, SvPV_nolen X<SvPV_nolen>, SvPV_nomg X<SvPV_nomg>, SvPV_set X<SvPV_set>, SvREFCNT X<SvREFCNT>, SvREFCNT_dec X<SvREFCNT_dec>, SvREFCNT_inc X<SvREFCNT_inc>, -SvROK X<SvROK>, SvROK_off X<SvROK_off>, SvROK_on X<SvROK_on>, SvRV X<SvRV>, -SvRV_set X<SvRV_set>, SvSTASH X<SvSTASH>, SvSTASH_set X<SvSTASH_set>, -SvTAINT X<SvTAINT>, SvTAINTED X<SvTAINTED>, SvTAINTED_off X<SvTAINTED_off>, -SvTAINTED_on X<SvTAINTED_on>, SvTRUE 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_2bool X<sv_2bool>, sv_2cv X<sv_2cv>, sv_2io X<sv_2io>, sv_2iv_flags -X<sv_2iv_flags>, sv_2mortal X<sv_2mortal>, sv_2nv X<sv_2nv>, sv_2pvbyte -X<sv_2pvbyte>, sv_2pvutf8 X<sv_2pvutf8>, sv_2pv_flags X<sv_2pv_flags>, -sv_2uv_flags X<sv_2uv_flags>, sv_backoff X<sv_backoff>, sv_bless -X<sv_bless>, sv_catpv X<sv_catpv>, sv_catpvf X<sv_catpvf>, sv_catpvf_mg -X<sv_catpvf_mg>, sv_catpvn X<sv_catpvn>, sv_catpvn_flags -X<sv_catpvn_flags>, sv_catpvn_nomg X<sv_catpvn_nomg>, sv_catpv_mg -X<sv_catpv_mg>, sv_catsv X<sv_catsv>, sv_catsv_flags X<sv_catsv_flags>, -sv_catsv_nomg X<sv_catsv_nomg>, sv_chop X<sv_chop>, sv_clear X<sv_clear>, -sv_cmp X<sv_cmp>, sv_cmp_locale X<sv_cmp_locale>, sv_collxfrm -X<sv_collxfrm>, sv_copypv X<sv_copypv>, sv_dec X<sv_dec>, sv_derived_from -X<sv_derived_from>, sv_eq X<sv_eq>, sv_force_normal_flags -X<sv_force_normal_flags>, sv_free X<sv_free>, sv_gets X<sv_gets>, sv_grow -X<sv_grow>, sv_inc X<sv_inc>, sv_insert X<sv_insert>, sv_isa X<sv_isa>, -sv_isobject X<sv_isobject>, sv_len X<sv_len>, sv_len_utf8 X<sv_len_utf8>, -sv_magic X<sv_magic>, sv_magicext X<sv_magicext>, sv_mortalcopy -X<sv_mortalcopy>, sv_newmortal X<sv_newmortal>, sv_newref X<sv_newref>, -sv_pos_b2u X<sv_pos_b2u>, sv_pos_u2b X<sv_pos_u2b>, sv_pvbyten_force -X<sv_pvbyten_force>, sv_pvn_force X<sv_pvn_force>, sv_pvn_force_flags -X<sv_pvn_force_flags>, sv_pvutf8n_force X<sv_pvutf8n_force>, sv_reftype -X<sv_reftype>, sv_replace X<sv_replace>, sv_report_used X<sv_report_used>, -sv_reset X<sv_reset>, sv_rvweaken X<sv_rvweaken>, sv_setiv X<sv_setiv>, -sv_setiv_mg X<sv_setiv_mg>, sv_setnv X<sv_setnv>, sv_setnv_mg +SvREFCNT_inc_NN X<SvREFCNT_inc_NN>, SvREFCNT_inc_simple +X<SvREFCNT_inc_simple>, SvREFCNT_inc_simple_NN X<SvREFCNT_inc_simple_NN>, +SvREFCNT_inc_simple_void X<SvREFCNT_inc_simple_void>, +SvREFCNT_inc_simple_void_NN X<SvREFCNT_inc_simple_void_NN>, +SvREFCNT_inc_void X<SvREFCNT_inc_void>, SvREFCNT_inc_void_NN +X<SvREFCNT_inc_void_NN>, SvROK X<SvROK>, SvROK_off X<SvROK_off>, SvROK_on +X<SvROK_on>, SvRV X<SvRV>, SvRV_set X<SvRV_set>, SvSTASH X<SvSTASH>, +SvSTASH_set X<SvSTASH_set>, SvTAINT X<SvTAINT>, SvTAINTED X<SvTAINTED>, +SvTAINTED_off X<SvTAINTED_off>, SvTAINTED_on X<SvTAINTED_on>, SvTRUE +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_does +X<sv_does>, sv_report_used X<sv_report_used>, sv_setsv_nomg +X<sv_setsv_nomg> + +=item SV-Body Allocation + +looks_like_number X<looks_like_number>, newRV_noinc X<newRV_noinc>, newSV +X<newSV>, newSVhek X<newSVhek>, newSViv X<newSViv>, newSVnv X<newSVnv>, +newSVpv X<newSVpv>, newSVpvf X<newSVpvf>, newSVpvn X<newSVpvn>, +newSVpvn_share X<newSVpvn_share>, newSVpvs X<newSVpvs>, newSVpvs_share +X<newSVpvs_share>, newSVrv X<newSVrv>, newSVsv X<newSVsv>, newSVuv +X<newSVuv>, sv_2bool X<sv_2bool>, sv_2cv X<sv_2cv>, sv_2io X<sv_2io>, +sv_2iv_flags X<sv_2iv_flags>, sv_2mortal X<sv_2mortal>, sv_2nv X<sv_2nv>, +sv_2pvbyte X<sv_2pvbyte>, sv_2pvutf8 X<sv_2pvutf8>, sv_2pv_flags +X<sv_2pv_flags>, sv_2uv_flags X<sv_2uv_flags>, sv_backoff X<sv_backoff>, +sv_bless X<sv_bless>, sv_catpv X<sv_catpv>, sv_catpvf X<sv_catpvf>, +sv_catpvf_mg X<sv_catpvf_mg>, sv_catpvn X<sv_catpvn>, sv_catpvn_flags +X<sv_catpvn_flags>, sv_catpvs X<sv_catpvs>, sv_catpv_mg X<sv_catpv_mg>, +sv_catsv X<sv_catsv>, sv_catsv_flags X<sv_catsv_flags>, sv_chop X<sv_chop>, +sv_clear X<sv_clear>, sv_cmp X<sv_cmp>, sv_cmp_locale X<sv_cmp_locale>, +sv_collxfrm X<sv_collxfrm>, sv_copypv X<sv_copypv>, sv_dec X<sv_dec>, sv_eq +X<sv_eq>, sv_force_normal_flags X<sv_force_normal_flags>, sv_free +X<sv_free>, sv_gets X<sv_gets>, sv_grow X<sv_grow>, sv_inc X<sv_inc>, +sv_insert X<sv_insert>, sv_isa X<sv_isa>, sv_isobject X<sv_isobject>, +sv_len X<sv_len>, sv_len_utf8 X<sv_len_utf8>, sv_magic X<sv_magic>, +sv_magicext X<sv_magicext>, sv_mortalcopy X<sv_mortalcopy>, sv_newmortal +X<sv_newmortal>, sv_newref X<sv_newref>, sv_pos_b2u X<sv_pos_b2u>, +sv_pos_u2b X<sv_pos_u2b>, sv_pvbyten_force X<sv_pvbyten_force>, +sv_pvn_force X<sv_pvn_force>, sv_pvn_force_flags X<sv_pvn_force_flags>, +sv_pvutf8n_force X<sv_pvutf8n_force>, sv_reftype X<sv_reftype>, sv_replace +X<sv_replace>, sv_reset X<sv_reset>, sv_rvweaken X<sv_rvweaken>, sv_setiv +X<sv_setiv>, sv_setiv_mg X<sv_setiv_mg>, sv_setnv X<sv_setnv>, sv_setnv_mg X<sv_setnv_mg>, sv_setpv X<sv_setpv>, sv_setpvf X<sv_setpvf>, sv_setpvf_mg X<sv_setpvf_mg>, sv_setpviv X<sv_setpviv>, sv_setpviv_mg X<sv_setpviv_mg>, -sv_setpvn X<sv_setpvn>, sv_setpvn_mg X<sv_setpvn_mg>, sv_setpv_mg -X<sv_setpv_mg>, sv_setref_iv X<sv_setref_iv>, sv_setref_nv X<sv_setref_nv>, -sv_setref_pv X<sv_setref_pv>, sv_setref_pvn X<sv_setref_pvn>, sv_setref_uv -X<sv_setref_uv>, sv_setsv X<sv_setsv>, sv_setsv_flags X<sv_setsv_flags>, -sv_setsv_mg X<sv_setsv_mg>, sv_setsv_nomg X<sv_setsv_nomg>, sv_setuv +sv_setpvn X<sv_setpvn>, sv_setpvn_mg X<sv_setpvn_mg>, sv_setpvs +X<sv_setpvs>, sv_setpv_mg X<sv_setpv_mg>, sv_setref_iv X<sv_setref_iv>, +sv_setref_nv X<sv_setref_nv>, sv_setref_pv X<sv_setref_pv>, sv_setref_pvn +X<sv_setref_pvn>, sv_setref_uv X<sv_setref_uv>, sv_setsv X<sv_setsv>, +sv_setsv_flags X<sv_setsv_flags>, sv_setsv_mg X<sv_setsv_mg>, sv_setuv X<sv_setuv>, sv_setuv_mg X<sv_setuv_mg>, sv_tainted X<sv_tainted>, sv_true X<sv_true>, sv_unmagic X<sv_unmagic>, sv_unref_flags X<sv_unref_flags>, -sv_untaint X<sv_untaint>, sv_upgrade X<sv_upgrade>, sv_usepvn X<sv_usepvn>, -sv_usepvn_mg X<sv_usepvn_mg>, sv_utf8_decode X<sv_utf8_decode>, -sv_utf8_downgrade X<sv_utf8_downgrade>, sv_utf8_encode X<sv_utf8_encode>, -sv_utf8_upgrade X<sv_utf8_upgrade>, sv_utf8_upgrade_flags -X<sv_utf8_upgrade_flags>, sv_vcatpvf X<sv_vcatpvf>, sv_vcatpvfn -X<sv_vcatpvfn>, sv_vcatpvf_mg X<sv_vcatpvf_mg>, sv_vsetpvf X<sv_vsetpvf>, -sv_vsetpvfn X<sv_vsetpvfn>, sv_vsetpvf_mg X<sv_vsetpvf_mg> +sv_untaint X<sv_untaint>, sv_upgrade X<sv_upgrade>, sv_usepvn_flags +X<sv_usepvn_flags>, sv_utf8_decode X<sv_utf8_decode>, sv_utf8_downgrade +X<sv_utf8_downgrade>, sv_utf8_encode X<sv_utf8_encode>, sv_utf8_upgrade +X<sv_utf8_upgrade>, sv_utf8_upgrade_flags X<sv_utf8_upgrade_flags>, +sv_vcatpvf X<sv_vcatpvf>, sv_vcatpvfn X<sv_vcatpvfn>, sv_vcatpvf_mg +X<sv_vcatpvf_mg>, sv_vsetpvf X<sv_vsetpvf>, sv_vsetpvfn X<sv_vsetpvfn>, +sv_vsetpvf_mg X<sv_vsetpvf_mg> =item Unicode Support @@ -5559,13 +5740,18 @@ X<PL_ofs_sv>, PL_rs X<PL_rs> is_gv_magical X<is_gv_magical>, is_gv_magical_sv X<is_gv_magical_sv> +=item Hash Manipulation Functions + +refcounted_he_chain_2hv X<refcounted_he_chain_2hv>, refcounted_he_free +X<refcounted_he_free>, refcounted_he_new X<refcounted_he_new> + =item IO Functions start_glob X<start_glob> =item Magical Functions -mg_localize X<mg_localize> +magic_sethint X<magic_sethint>, mg_localize X<mg_localize> =item Pad Data Structures @@ -5759,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 @@ -5794,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 @@ -5833,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 @@ -5861,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 @@ -5897,26 +6105,26 @@ Implement L</_ prototype character>, Implement L</state variables> =item POSIX memory footprint +=item embed.pl/makedef.pl + =back =item Tasks that need a little sysadmin-type knowledge =over 4 -=item Relocatable perl - =item make HTML install work =item compressed man pages =item Add a code coverage target to the Makefile -=item Make Config.pm cope with differences between build and installed perl - -=item make parallel builds work +=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 @@ -5925,17 +6133,15 @@ Implement L</_ prototype character>, Implement L</state variables> =item Make it clear from -v if this is the exact official release -=item Tidy up global variables - =item Ordering of "global" variables. -=item bincompat functions +=item Profile Perl - am I hot or not? -=item am I hot or not? +=item Shrink struct context -=item emulate the per-thread memory pool on Unix +=item Allocate OPs from arenas -=item reduce duplication in sv_setsv_flags +=item Improve win32/wince.c =back @@ -5943,15 +6149,7 @@ Implement L</_ prototype character>, Implement L</state variables> =over 4 -=item IPv6 - -=item shrink C<GV>s, C<CV>s - -=item merge Perl_sv_2[inpu]v - -=item UTF8 caching code - -=item Implicit Latin 1 => Unicode translation +=item shrink C<PVBM>s =item autovivification @@ -5967,32 +6165,30 @@ 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 Constant folding - =item LVALUE functions for lists =item LVALUE functions in the debugger =item _ prototype character -=item state variables - -=item @INC source filter to Filter::Simple - =item regexp optimiser optional =item UNITCHECK +=item delete &function + +=item Make readpipe overridable + =item optional optimizer =item You WANT *how* many @@ -6007,6 +6203,8 @@ Implement L</_ prototype character>, Implement L</state variables> =item What hooks would assertions need? +=item Properly Unicode safe tokeniser and pads. + =back =item Big projects @@ -6080,7 +6278,7 @@ B<-V> =back -=head2 perldelta - what is new for perl v5.9.3 +=head2 perldelta - what is new for perl v5.9.4 =over 4 @@ -6090,15 +6288,13 @@ B<-V> =over 4 -=item Parsing of C<-f _> - -=item C<mkdir()> +=item chdir FOO -=item Magic goto and eval +=item Handling of pmc files -=item C<$#> has been removed +=item @- and @+ in patterns -=item C<:unique> +=item $AUTOLOAD can now be tainted =back @@ -6106,37 +6302,23 @@ B<-V> =over 4 -=item Switch and Smart Match operator - -=item C<say()> - -=item C<CLONE_SKIP()> +=item state() variables -=item C<${^CHILD_ERROR_NATIVE}> +=item UNIVERSAL::DOES() -=item Assertions +=item Exceptions in constant folding -=item Unicode Character Database 4.1.0 +=item Source filters in @INC -=item C<no VERSION> +=item MAD =back -=item Modules and Pragmata +=item Modules and Pragmas =over 4 -=item C<feature> - -=item C<assertions::compat> - -=item C<Math::BigInt::FastCalc> - -=item C<Compress::Zlib> - -=item C<IO::Zlib> - -=item C<Archive::Tar> +=item New Core Modules =back @@ -6144,7 +6326,7 @@ B<-V> =over 4 -=item C<ptar> +=item config_data =back @@ -6152,62 +6334,75 @@ B<-V> =over 4 -=item Perl Glossary +=item New manpage, perlpragma + +=item New manpage, perlreguts + +=item New manpage, perlunitut =back =item Performance Enhancements -=item Installation and Configuration Improvements - =over 4 -=item New Or Improved Platforms +=item Memory optimisations -=item Module auxiliary files +=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 Selected Bug Fixes +=item Installation and Configuration Improvements =over 4 -=item C<defined $$x> +=item Relocatable installations -=item Smaller fixes +=item Ports -=item More Unicode Fixes +=item Compilation improvements + +=item New probes + +=item Windows build improvements + +Building XS extensions, Support for 64-bit compiler =back -=item New or Changed Diagnostics +=item Selected Bug Fixes =over 4 -=item Attempt to set length of freed array - -=item Search pattern not terminated or ternary operator parsed as search -pattern +=item PERL5SHELL and tainting -=item "%s" variable %s masks earlier declaration +=item Using *FILE{IO} -=back +=item Overloading and reblessing -=item Changed Internals +=item Overloading and UTF-8 -=over 4 +=item eval memory leaks fixed -=item B:: modules inheritance changed +=item Random device on Windows =back -=item Known Problems +=item New or Changed Diagnostics -=over 4 +State variable %s will be reinitialized -=item Platform Specific Problems +=item Changed Internals -=back +=item Known Problems =item Reporting Bugs @@ -6215,7 +6410,7 @@ pattern =back -=head2 perl593delta, perldelta - what is new for perl v5.9.3 +=head2 perl594delta, perldelta - what is new for perl v5.9.4 =over 4 @@ -6225,15 +6420,13 @@ pattern =over 4 -=item Parsing of C<-f _> - -=item C<mkdir()> +=item chdir FOO -=item Magic goto and eval +=item Handling of pmc files -=item C<$#> has been removed +=item @- and @+ in patterns -=item C<:unique> +=item $AUTOLOAD can now be tainted =back @@ -6241,37 +6434,23 @@ pattern =over 4 -=item Switch and Smart Match operator - -=item C<say()> - -=item C<CLONE_SKIP()> +=item state() variables -=item C<${^CHILD_ERROR_NATIVE}> +=item UNIVERSAL::DOES() -=item Assertions +=item Exceptions in constant folding -=item Unicode Character Database 4.1.0 +=item Source filters in @INC -=item C<no VERSION> +=item MAD =back -=item Modules and Pragmata +=item Modules and Pragmas =over 4 -=item C<feature> - -=item C<assertions::compat> - -=item C<Math::BigInt::FastCalc> - -=item C<Compress::Zlib> - -=item C<IO::Zlib> - -=item C<Archive::Tar> +=item New Core Modules =back @@ -6279,7 +6458,7 @@ pattern =over 4 -=item C<ptar> +=item config_data =back @@ -6287,27 +6466,215 @@ pattern =over 4 -=item Perl Glossary +=item New manpage, perlpragma + +=item New manpage, perlreguts + +=item New manpage, perlunitut =back =item Performance Enhancements -=item Installation and Configuration Improvements - =over 4 -=item New Or Improved Platforms +=item Memory optimisations -=item Module auxiliary files +=item UTF-8 cache optimisation -=back +=item Regular expressions -=item Selected Bug Fixes +Engine de-recursivised, Single char char-classes treated as literals, Trie +optimisation of literal string alternations, Aho-Corasick start-point +optimisation -=over 4 +=item Sloppy stat on Windows -=item C<defined $$x> +=back + +=item Installation and Configuration Improvements + +=over 4 + +=item Relocatable installations + +=item Ports + +=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 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 + +=back + +=head2 perl593delta, perldelta - what is new for perl v5.9.3 + +=over 4 + +=item DESCRIPTION + +=item Incompatible Changes + +=over 4 + +=item Parsing of C<-f _> + +=item C<mkdir()> + +=item Magic goto and eval + +=item C<$#> has been removed + +=item C<:unique> + +=item Scoping of the C<sort> pragma + +=back + +=item Core Enhancements + +=over 4 + +=item The C<feature> pragma + +=item Switch and Smart Match operator + +=item C<say()> + +=item C<CLONE_SKIP()> + +=item C<${^CHILD_ERROR_NATIVE}> + +=item Assertions + +=item Unicode Character Database 4.1.0 + +=item C<no VERSION> + +=item Recursive sort subs + +=item Effect of pragmas in eval + +=item New B<-E> command-line switch + +=item C<chdir>, C<chmod> and C<chown> on filehandles + +=item OS groups + +=back + +=item Modules and Pragmata + +=over 4 + +=item New Core Modules + +=back + +=item Utility Changes + +=over 4 + +=item C<ptar> + +=item C<ptardiff> + +=item C<shasum> + +=item C<h2xs> enhancements + +=item C<perlivp> enhancements + +=back + +=item Documentation + +=over 4 + +=item Perl Glossary + +=back + +=item Performance Enhancements + +=over 4 + +=item XS-assisted SWASHGET + +=item Constant subroutines + +=item C<PERL_DONT_CREATE_GVSV> + +=item Weak references are cheaper + +=item sort() enhancements + +=back + +=item Installation and Configuration Improvements + +=over 4 + +=item Compilation improvements + +=item New Or Improved Platforms + +=item New probes + +=item Module auxiliary files + +=back + +=item Selected Bug Fixes + +=over 4 + +=item C<defined $$x> + +=item Calling CORE::require() + +=item Subscripts of slices + +=item Remove over-optimisation + +=item sprintf() fixes + +=item no warnings 'category' works correctly with -w =item Smaller fixes @@ -6321,11 +6688,15 @@ pattern =item Attempt to set length of freed array +=item Non-string passed as bitmask + =item Search pattern not terminated or ternary operator parsed as search pattern =item "%s" variable %s masks earlier declaration +=item readdir()/closedir()/etc. attempted on invalid dirhandle + =back =item Changed Internals @@ -6336,14 +6707,6 @@ pattern =back -=item Known Problems - -=over 4 - -=item Platform Specific Problems - -=back - =item Reporting Bugs =item SEE ALSO @@ -6671,6 +7034,73 @@ Win32::GetOSVersion =back +=head2 perl588delta, perldelta - what is new for perl v5.8.8 + +=over 4 + +=item DESCRIPTION + +=item Incompatible Changes + +=item Core Enhancements + +=item Modules and Pragmata + +=item Utility Changes + +=over 4 + +=item C<h2xs> enhancements + +=item C<perlivp> enhancements + +=back + +=item New Documentation + +=item Performance Enhancements + +=item Installation and Configuration Improvements + +=item Selected Bug Fixes + +=over 4 + +=item no warnings 'category' works correctly with -w + +=item Remove over-optimisation + +=item sprintf() fixes + +=item Debugger and Unicode slowdown + +=item Smaller fixes + +=back + +=item New or Changed Diagnostics + +=over 4 + +=item Attempt to set length of freed array + +=item Non-string passed as bitmask + +=item Search pattern not terminated or ternary operator parsed as search +pattern + +=back + +=item Changed Internals + +=item Platform Specific Problems + +=item Reporting Bugs + +=item SEE ALSO + +=back + =head2 perl587delta, perldelta - what is new for perl v5.8.7 =over 4 @@ -9089,9 +9519,9 @@ B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS> =item BUILD Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's -celib-sources, Rainer Keuchel's console-sources, go to ./wince -subdirectory, edit file compile.bat, run compile.bat, run compile.bat -dist +celib-sources, Rainer Keuchel's console-sources, go to C<./win32> +subdirectory, edit file C<compile.bat>, run compile.bat, run +compile.bat dist =back @@ -9105,9 +9535,9 @@ dist =item ENVIRONMENT -=item REGISTRY +PERL5LIB, PATH, TMP, UNIXROOTPATH, ROWS/COLS, HOME, CONSOLEFONTSIZE -=item PERLFILES +=item REGISTRY =item XS @@ -9119,6 +9549,8 @@ dist =item ACKNOWLEDGEMENTS +=item History of WinCE port + =item AUTHORS Rainer Keuchel <coyxc@rainer-keuchel.de>, Vadim Konovalov @@ -9520,15 +9952,15 @@ op/lexassign.t, pragma/warnings.t =item Installation Prefix -=item libperl and Prebinding +=item SDK support -=item Updating Apple-supplied Perl +=item Universal Binary support -=item 64-bit Perl +=item 64-bit PPC support -=item Intel processor support +=item libperl and Prebinding -=item Universal binaries +=item Updating Apple's Perl =item Known problems @@ -10066,6 +10498,18 @@ qnx/ar, qnx/cpp =back +=head2 perlriscos, README.riscos - Perl version 5 for RISC OS + +=over 4 + +=item DESCRIPTION + +=item BUILD + +=item AUTHOR + +=back + =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems =over 4 @@ -10110,8 +10554,7 @@ Solaris FAQ, Precompiled Binaries, Solaris Documentation Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal: relocation error:, dlopen: stub interception failed, #error "No -DATAMODEL_NATIVE specified", sh: ar: not found, warning: dead part of -constant expression is nonconstant +DATAMODEL_NATIVE specified", sh: ar: not found =item MAKE TEST @@ -10310,6 +10753,8 @@ Digital UNIX formerly known as DEC OSF/1) systems =item PERL5LIB and PERLLIB +=item PERL_VMS_EXCEPTION_DEBUG + =item Command line =over 4 @@ -10450,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 @@ -10479,53 +10929,108 @@ ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE =back -=head2 threads - Perl extension allowing use of interpreter based threads -from perl +=head2 threads - Perl interpreter-based threads =over 4 +=item VERSION + =item SYNOPSIS =item DESCRIPTION -$thread = threads->create(function, LIST), $thread->join, $thread->detach, -threads->self, $thread->tid, threads->object( tid ), threads->yield();, -threads->list();, async BLOCK; +$thr = threads->create(FUNCTION, ARGS), $thr->join(), $thr->detach(), +threads->detach(), threads->self(), $thr->tid(), threads->tid(), +threads->object($tid), threads->yield(), threads->list(), +threads->list(threads::all), threads->list(threads::running), +threads->list(threads::joinable), $thr1->equal($thr2), async BLOCK;, +$thr->_handle(), threads->_handle() -=item WARNINGS +=item EXITING A THREAD -A thread exited while %d other threads were still running +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 TODO +=item THREAD STATE -=item BUGS +$thr->is_running(), $thr->is_joinable(), $thr->is_detached(), +threads->is_detached() -Parent-Child threads, tid is I32, Returning objects, Creating threads -inside BEGIN blocks, PERL_OLD_SIGNALS are not threadsafe, will not be +=item THREAD CONTEXT -=item AUTHOR and COPYRIGHT +=over 4 -=item SEE ALSO +=item Explicit context -=back +=item Implicit context -=head2 assertions - select assertions in blocks of code +=item $thr->wantarray() -=over 4 +=item threads->wantarray() -=item SYNOPSIS +=back -=item DESCRIPTION +=item THREAD STACK SIZE -=over 4 +threads->get_stack_size();, $size = $thr->get_stack_size();, $old_size = +threads->set_stack_size($new_size);, use threads ('stack_size' => VALUE);, +$ENV{'PERL5_ITHREADS_STACK_SIZE'}, threads->create({'stack_size' => VALUE}, +FUNCTION, ARGS), $thr2 = $thr1->create(FUNCTION, ARGS) -=item Selecting assertions +=item THREAD SIGNALLING -=item Handling assertions your own way +$thr->kill('SIG...'); -enabled($on), enabled(), seen($on), seen() +=item WARNINGS -=back +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 threads without safe signals, Unrecognized +signal name: .. + +=item BUGS + +Parent-child threads, Creating threads inside special blocks, Unsafe +signals, Perl was been built with C<PERL_OLD_SIGNALS> (see C<perl -V>), The +environment variable C<PERL_SIGNALS> is set to C<unsafe> (see +L<perlrun/"PERL_SIGNALS">), The module L<Perl::Unsafe::Signals> is used, +Returning closures from threads, Perl Bugs and the CPAN Version of +L<threads> + +=item REQUIREMENTS + +=item SEE ALSO + +=item AUTHOR + +=item ACKNOWLEDGEMENTS + +=back + +=head2 assertions - select assertions in blocks of code + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Selecting assertions + +=item Handling assertions your own way + +enabled($on), enabled(), seen($on), seen() + +=back =item COMPATIBILITY @@ -10806,36 +11311,6 @@ semantics =back -=head2 c, constant - Perl pragma to declare constants - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=item NOTES - -=over 4 - -=item List constants - -=item Defining multiple constants at once - -=item Magic constants - -=back - -=item TECHNICAL NOTES - -=item BUGS - -=item AUTHOR - -=item COPYRIGHT - -=back - =head2 charnames - define character names for C<\N{named}> string literal escapes @@ -11051,6 +11526,10 @@ upgrading for byte-strings =item the 'err' feature +=item the 'dor' feature + +=item the 'state' feature + =back =item FEATURE BUNDLES @@ -11232,10 +11711,10 @@ is inherited by derived classes =item Fallback -=item Smart Match - C<undef>, TRUE, defined, but FALSE +=item Smart Match + =item Copy Constructor B<Example> @@ -11249,6 +11728,8 @@ I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>, I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>, I<Copy operator> +=item Minimal set of overloaded operations + =item Losing overloading =item Run-time Overloading @@ -11432,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 @@ -11631,6 +12116,8 @@ limit, extract =item $tar->add_data ( $filename, $data, [$opthashref] ) +FILE, HARDLINK, SYMLINK, CHARDEV, BLOCKDEV, DIR, FIFO, SOCKET + =back =over 4 @@ -11641,6 +12128,12 @@ limit, extract =over 4 +=item $tar->setcwd( $cwd ); + +=back + +=over 4 + =item $bool = $tar->has_io_string =back @@ -11712,12 +12205,24 @@ limit, extract 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 -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 -Check if passed in handles are open for read/write +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 @@ -12050,7 +12555,7 @@ redoop, nextop, lastop =item B::COP Methods -label, stash, stashpv, file, cop_seq, arybase, line, warnings, io +label, stash, stashpv, file, cop_seq, arybase, line, warnings, io, hints =back @@ -12248,10 +12753,11 @@ B<~> B<#>I<var>, B<#>I<var>I<N>, B<#>I<Var>, B<#addr>, B<#arg>, B<#class>, B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>, -B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>, -B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>, -B<#seq>, B<#seqnum>, B<#opt>, B<#static>, B<#sibaddr>, B<#svaddr>, -B<#svclass>, B<#svval>, B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum> +B<#flags>, B<#flagval>, B<#hints>, B<#hintsval>, B<#hyphseq>, B<#label>, +B<#lastaddr>, B<#name>, B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, +B<#private>, B<#privval>, B<#seq>, B<#seqnum>, B<#opt>, B<#static>, +B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>, B<#targ>, B<#targarg>, +B<#targarglife>, B<#typenum> =back @@ -12359,8 +12865,8 @@ strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits =item OPTIONS AND LINT CHECKS -B<context>, B<implicit-read> and B<implicit-write>, B<bare-subs>, -B<dollar-underscore>, B<private-names>, B<undefined-subs>, +B<magic-diamond>, B<context>, B<implicit-read> and B<implicit-write>, +B<bare-subs>, B<dollar-underscore>, B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none> =item NON LINT-CHECK OPTIONS @@ -12369,6 +12875,11 @@ B<-u Package> =item EXTENDING LINT +=item TODO + +while(<FH>) stomps $_, strict oo, unchecked system calls, more tests, +validate against older perls + =item BUGS =item AUTHOR @@ -13024,6 +13535,8 @@ FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE =item STATUS +=item COMPATIBILITY + =item DESCRIPTION =over 4 @@ -13032,7 +13545,8 @@ FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE Searching for authors, bundles, distribution files and modules, make, test, install, clean modules or distributions, get, readme, perldoc, look module -or distribution, ls author, ls globbing_expresion, Signals +or distribution, ls author, ls globbing_expression, failed, Lockfile, +Signals =item CPAN::Shell @@ -13040,6 +13554,10 @@ or distribution, ls author, ls globbing_expresion, Signals =item recompile +=item upgrade + +=item mkmyconfig + =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution =item Programmer's interface @@ -13057,23 +13575,25 @@ CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(), CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(), CPAN::Bundle::readme(), CPAN::Bundle::test(), CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(), -CPAN::Distribution::clean(), CPAN::Distribution::containsmods(), -CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(), -CPAN::Distribution::force($method,@args), CPAN::Distribution::get(), -CPAN::Distribution::install(), CPAN::Distribution::isa_perl(), -CPAN::Distribution::look(), CPAN::Distribution::make(), +CPAN::Distribution::author, CPAN::Distribution::clean(), +CPAN::Distribution::containsmods(), CPAN::Distribution::cvs_import(), +CPAN::Distribution::dir(), CPAN::Distribution::force($method,@args), +CPAN::Distribution::get(), CPAN::Distribution::install(), +CPAN::Distribution::isa_perl(), CPAN::Distribution::look(), +CPAN::Distribution::make(), CPAN::Distribution::perldoc(), CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(), -CPAN::Distribution::perldoc(), CPAN::Distribution::test(), +CPAN::Distribution::read_yaml(), CPAN::Distribution::test(), CPAN::Distribution::uptodate(), CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(), CPAN::Module::as_glimpse(), CPAN::Module::as_string(), CPAN::Module::clean(), CPAN::Module::cpan_file(), CPAN::Module::cpan_version(), CPAN::Module::cvs_import(), CPAN::Module::description(), +CPAN::Module::distribution(), CPAN::Module::dslip_status(), CPAN::Module::force($method,@args), CPAN::Module::get(), CPAN::Module::inst_file(), CPAN::Module::inst_version(), CPAN::Module::install(), CPAN::Module::look(), CPAN::Module::make(), -CPAN::Module::manpage_headline(), CPAN::Module::readme(), -CPAN::Module::perldoc(), CPAN::Module::test(), CPAN::Module::uptodate(), +CPAN::Module::manpage_headline(), CPAN::Module::perldoc(), +CPAN::Module::readme(), CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid() =item Cache Manager @@ -13099,6 +13619,8 @@ optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt> =over 4 +=item Not on config variable getcwd + =item Note on urllist parameter's format =item urllist parameter has CD-ROM support @@ -13115,6 +13637,8 @@ optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt> =item EXPORT +=item ENVIRONMENT + =item POPULATE AN INSTALLATION WITH LOTS OF MODULES =item WORKING WITH CPAN.pm BEHIND FIREWALLS @@ -13131,10 +13655,12 @@ http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade =item FAQ -1), 2), 3), 4), 5), 6), 7), 8), 9), 10), 11) +1), 2), 3), 4), 5), 6), 7), 8), 9), 10), 11), 12), 13), 14) =item BUGS +=item SECURITY ADVICE + =item AUTHOR =item TRANSLATIONS @@ -13265,7 +13791,8 @@ Example 1, Example 2, Example 3 =back -=head2 Compress::Zlib - Interface to zlib compression library +=head2 Compress::IO::Base::lib::File::GlobMapper, File::GlobMapper - Extend +File Glob to Allow Input and Output Files =over 4 @@ -13273,162 +13800,163 @@ Example 1, Example 2, Example 3 =item DESCRIPTION -=item GZIP INTERFACE - -B<$gz = gzopen($filename, $mode)>, B<$gz = gzopen($filehandle, $mode)>, -B<$bytesread = $gz-E<gt>gzread($buffer [, $size]) ;>, B<$bytesread = -$gz-E<gt>gzreadline($line) ;>, B<$byteswritten = $gz-E<gt>gzwrite($buffer) -;>, B<$status = $gz-E<gt>gzflush($flush_type) ;>, B<$offset = -$gz-E<gt>gztell() ;>, B<$status = $gz-E<gt>gzseek($offset, $whence) ;>, -B<$gz-E<gt>gzclose>, B<$gz-E<gt>gzsetparams($level, $strategy>, B<$level>, -B<$strategy>, B<$gz-E<gt>gzerror>, B<$gzerrno> +This code is a work in progress, There are known bugs, The interface +defined here is tentative, There are portability issues, Do not use in +production code, Consider yourself warned! =over 4 -=item Examples - -=item Compress::Zlib::memGzip +=item Behind The Scenes -=item Compress::Zlib::memGunzip +=item Limitations -=back +=item Input File Glob -=item COMPRESS/UNCOMPRESS +B<~>, B<~user>, B<.>, B<*>, B<?>, B<\>, B<[]>, B<{,}>, B<()> -B<$dest = compress($source [, $level] ) ;>, B<$dest = uncompress($source) -;> +=item Output File Glob -=item CHECKSUM FUNCTIONS +"*", #1 -=item Compress::Zlib::Deflate +=item Returned Data -=over 4 +=back -=item B<($d, $status) = new Compress::Zlib::Deflate( [OPT] ) > +=item EXAMPLES -B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>, -B<-Dictionary>, B<-Bufsize>, B<-AppendOutput>, B<-CRC32>, B<-ADLER32> +=over 4 -=item B<$status = $d-E<gt>deflate($input, $output)> +=item A Rename script -=item B<$status = $d-E<gt>flush($output [, $flush_type]) > +=item A few example globmaps -=item B<$status = $d-E<gt>deflateParams([OPT])> +=back -B<-Level>, B<-Strategy>, B<-BufSize> +=item SEE ALSO -=item B<$status = $d-E<gt>deflateTune($good_length, $max_lazy, -$nice_length, $max_chain)> +=item AUTHOR -=item B<$d-E<gt>dict_adler()> +=item COPYRIGHT AND LICENSE -=item B<$d-E<gt>crc32()> +=back -=item B<$d-E<gt>adler32()> +=head2 Compress::IO::Base::lib::IO::Compress::Base, IO::Compress::Base - +Base Class for IO::Compress modules -=item B<$d-E<gt>msg()> +=over 4 -=item B<$d-E<gt>total_in()> +=item SYNOPSIS -=item B<$d-E<gt>total_out()> +=item DESCRIPTION -=item B<$d-E<gt>get_Strategy()> +=item SEE ALSO -=item B<$d-E<gt>get_Level()> +=item AUTHOR -=item B<$d-E<gt>get_BufSize()> +=item MODIFICATION HISTORY -=item Example +=item COPYRIGHT AND LICENSE =back -=item Compress::Zlib::Inflate +=head2 Compress::IO::Base::lib::IO::Uncompress::AnyUncompress, +IO::Uncompress::AnyUncompress - Uncompress gzip, zip, bzip2 or lzop +file/buffer =over 4 -=item B< ($i, $status) = new Compress::Zlib::Inflate( [OPT] ) > - -B<-WindowBits>, B<-Bufsize>, B<-Dictionary>, B<-AppendOutput>, B<-CRC32>, -B<-ADLER32>, B<-ConsumeInput> +=item SYNOPSIS -=item B< $status = $i-E<gt>inflate($input, $output) > +=item DESCRIPTION -=item B<$status = $i-E<gt>inflateSync($input)> +DO NOT use in production code, The documentation is incomplete in places, +Parts of the interface defined here are tentative, Please report any +problems you find, RFC 1950, RFC 1951, gzip (RFC 1952), zip, bzip2, lzop -=item B<$i-E<gt>dict_adler()> +=item Functional Interface -=item B<$i-E<gt>crc32()> +=over 4 -=item B<$i-E<gt>adler32()> +=item anyuncompress $input => $output [, OPTS] -=item B<$i-E<gt>msg()> +A filename, A filehandle, A scalar reference, An array reference, An Input +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob -=item B<$i-E<gt>total_in()> +=item Notes -=item B<$i-E<gt>total_out()> +=item Optional Parameters -=item B<$d-E<gt>get_BufSize()> +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >> -=item Example +=item Examples =back -=item Compress::Zlib 1.x Deflate Interface +=item OO Interface =over 4 -=item B<($d, $status) = deflateInit( [OPT] )> +=item Constructor -B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>, -B<-Dictionary>, B<-Bufsize> +A filename, A filehandle, A scalar reference -=item B<($out, $status) = $d-E<gt>deflate($buffer)> +=item Constructor Options -=item B<($out, $status) = $d-E<gt>flush([flush_type])> +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 B<$status = $d-E<gt>deflateParams([OPT])> +=item Examples -B<-Level>, B<-Strategy> +=back -=item B<$d-E<gt>dict_adler()> +=item Methods -=item B<$d-E<gt>msg()> +=over 4 -=item B<$d-E<gt>total_in()> +=item read -=item B<$d-E<gt>total_out()> +=item read -=item Example +=item getline -=back +=item getc -=item Compress::Zlib 1.x Inflate Interface +=item ungetc -=over 4 +=item getHeaderInfo -=item B<($i, $status) = inflateInit()> +=item tell -B<-WindowBits>, B<-Bufsize>, B<-Dictionary> +=item eof -=item B<($out, $status) = $i-E<gt>inflate($buffer)> +=item seek -=item B<$status = $i-E<gt>inflateSync($buffer)> +=item binmode -=item B<$i-E<gt>dict_adler()> +=item opened -=item B<$i-E<gt>msg()> +=item autoflush -=item B<$i-E<gt>total_in()> +=item input_line_number -=item B<$i-E<gt>total_out()> +=item fileno -=item Example +=item close + +=item nextStream + +=item trailingData =back -=item ACCESSING ZIP FILES +=item Importing -=item CONSTANTS +:all + +=item EXAMPLES =item SEE ALSO @@ -13440,8 +13968,8 @@ B<-WindowBits>, B<-Bufsize>, B<-Dictionary> =back -=head2 Compress::Zlib::File::GlobMapper, File::GlobMapper - Extend File -Glob to Allow Input and Output Files +=head2 Compress::IO::Base::lib::IO::Uncompress::Base, IO::Uncompress::Base +- Base Class for IO::Uncompress modules =over 4 @@ -13449,48 +13977,122 @@ Glob to Allow Input and Output Files =item DESCRIPTION -This code is a work in progress, There are known bugs, The interface -defined here is tentative, There are portability issues, Do not use in -production code, Consider yourself warned! +=item SEE ALSO -=over 4 +=item AUTHOR -=item Behind The Scenes +=item MODIFICATION HISTORY -=item Limitations +=item COPYRIGHT AND LICENSE -=item Input File Glob +=back -B<~>, B<~user>, B<.>, B<*>, B<?>, B<\>, B<[]>, B<{,}>, B<()> +=head2 Compress::IO::Zlib::IO::Compress::Deflate, IO::Compress::Deflate - +Write RFC 1950 files/buffers -=item Output File Glob +=over 4 -"*", #1 +=item SYNOPSIS -=item Returned Data +=item DESCRIPTION -=back +DO NOT use in production code, The documentation is incomplete in places, +Parts of the interface defined here are tentative, Please report any +problems you find -=item EXAMPLES +=item Functional Interface =over 4 -=item A Rename script +=item deflate $input => $output [, OPTS] -=item A few example globmaps +A filename, A filehandle, A scalar reference, An array reference, An Input +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob + +=item Notes + +=item Optional Parameters + +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> + +=item Examples + +=back + +=item OO Interface + +=over 4 + +=item Constructor + +A filename, A filehandle, A scalar reference + +=item Constructor Options + +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 + +=back + +=item Methods + +=over 4 + +=item print + +=item printf + +=item syswrite + +=item write + +=item flush + +=item tell + +=item eof + +=item seek + +=item binmode + +=item opened + +=item autoflush + +=item input_line_number + +=item fileno + +=item close + +=item newStream([OPTS]) + +=item deflateParams =back +=item Importing + +:all, :constants, :flush, :level, :strategy + +=item EXAMPLES + =item SEE ALSO =item AUTHOR +=item MODIFICATION HISTORY + =item COPYRIGHT AND LICENSE =back -=head2 Compress::Zlib::IO::Compress::Deflate, IO::Compress::Deflate - -Perl interface to write RFC 1950 files/buffers +=head2 Compress::IO::Zlib::IO::Compress::Gzip, IO::Compress::Gzip - Write +RFC 1952 files/buffers =over 4 @@ -13506,22 +14108,17 @@ problems you find =over 4 -=item deflate $input => $output [, OPTS] +=item gzip $input => $output [, OPTS] A filename, A filehandle, A scalar reference, An array reference, An Input -FileGlob string, A filename, A filehandle, A scalar reference, A Hash -Reference, An Array Reference, An Output FileGlob - -=item deflate \%hash [, OPTS] - -undef, A filename, A filehandle, A scalar reference, A Hash Reference, An -Array Reference +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob =item Notes =item Optional Parameters -AutoClose =E<gt> 0|1, -Append =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> =item Examples @@ -13537,8 +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, -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 @@ -13566,11 +14167,17 @@ Filehandle, -Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1 =item binmode +=item opened + +=item autoflush + +=item input_line_number + =item fileno =item close -=item newStream +=item newStream([OPTS]) =item deflateParams @@ -13592,8 +14199,8 @@ Filehandle, -Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1 =back -=head2 Compress::Zlib::IO::Compress::Gzip, IO::Compress::Gzip - Perl -interface to write RFC 1952 files/buffers +=head2 Compress::IO::Zlib::IO::Compress::RawDeflate, +IO::Compress::RawDeflate - Write RFC 1951 files/buffers =over 4 @@ -13609,22 +14216,17 @@ problems you find =over 4 -=item gzip $input => $output [, OPTS] +=item rawdeflate $input => $output [, OPTS] A filename, A filehandle, A scalar reference, An array reference, An Input -FileGlob string, A filename, A filehandle, A scalar reference, A Hash -Reference, An Array Reference, An Output FileGlob - -=item gzip \%hash [, OPTS] - -undef, A filename, A filehandle, A scalar reference, A Hash Reference, An -Array Reference +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob =item Notes =item Optional Parameters -AutoClose =E<gt> 0|1, -Append =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> =item Examples @@ -13640,11 +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, -Mimimal =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<< Strict => 0|1 >> =item Examples @@ -13672,11 +14271,17 @@ Filehandle, -Merge =E<gt> 0|1, -Level, -Strategy, -Mimimal =E<gt> 0|1, =item binmode +=item opened + +=item autoflush + +=item input_line_number + =item fileno =item close -=item newStream +=item newStream([OPTS]) =item deflateParams @@ -13698,8 +14303,8 @@ Filehandle, -Merge =E<gt> 0|1, -Level, -Strategy, -Mimimal =E<gt> 0|1, =back -=head2 Compress::Zlib::IO::Compress::RawDeflate, IO::Compress::RawDeflate - - Perl interface to write RFC 1951 files/buffers +=head2 Compress::IO::Zlib::IO::Compress::Zip, IO::Compress::Zip - Write zip +files/buffers =over 4 @@ -13715,22 +14320,17 @@ problems you find =over 4 -=item rawdeflate $input => $output [, OPTS] +=item zip $input => $output [, OPTS] A filename, A filehandle, A scalar reference, An array reference, An Input -FileGlob string, A filename, A filehandle, A scalar reference, A Hash -Reference, An Array Reference, An Output FileGlob - -=item rawdeflate \%hash [, OPTS] - -undef, A filename, A filehandle, A scalar reference, A Hash Reference, An -Array Reference +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob =item Notes =item Optional Parameters -AutoClose =E<gt> 0|1, -Append =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> =item Examples @@ -13746,8 +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, -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<< 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 @@ -13775,11 +14380,17 @@ Filehandle, -Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1 =item binmode +=item opened + +=item autoflush + +=item input_line_number + =item fileno =item close -=item newStream +=item newStream([OPTS]) =item deflateParams @@ -13787,7 +14398,7 @@ Filehandle, -Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1 =item Importing -:all, :constants, :flush, :level, :strategy +:all, :constants, :flush, :level, :strategy, :zip_method =item EXAMPLES @@ -13801,9 +14412,8 @@ Filehandle, -Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1 =back -=head2 Compress::Zlib::IO::Uncompress::AnyInflate, -IO::Uncompress::AnyInflate - Perl interface to read RFC 1950, 1951 & 1952 -files/buffers +=head2 Compress::IO::Zlib::IO::Uncompress::AnyInflate, +IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip) file/buffer =over 4 @@ -13813,7 +14423,7 @@ files/buffers DO NOT use in production code, The documentation is incomplete in places, Parts of the interface defined here are tentative, Please report any -problems you find +problems you find, RFC 1950, RFC 1951, gzip (RFC 1952), zip =item Functional Interface @@ -13822,19 +14432,15 @@ problems you find =item anyinflate $input => $output [, OPTS] A filename, A filehandle, A scalar reference, An array reference, An Input -FileGlob string, A filename, A filehandle, A scalar reference, A Hash -Reference, An Array Reference, An Output FileGlob - -=item anyinflate \%hash [, OPTS] - -undef, A filename, A filehandle, A scalar reference, A Hash Reference, An -Array Reference +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob =item Notes =item Optional Parameters -AutoClose =E<gt> 0|1, -Append =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >> =item Examples @@ -13850,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 @@ -13884,10 +14491,20 @@ A filename, A filehandle, A scalar reference =item binmode +=item opened + +=item autoflush + +=item input_line_number + =item fileno =item close +=item nextStream + +=item trailingData + =back =item Importing @@ -13906,8 +14523,8 @@ A filename, A filehandle, A scalar reference =back -=head2 Compress::Zlib::IO::Uncompress::Gunzip, IO::Uncompress::Gunzip - -Perl interface to read RFC 1952 files/buffers +=head2 Compress::IO::Zlib::IO::Uncompress::Gunzip, IO::Uncompress::Gunzip - +Read RFC 1952 files/buffers =over 4 @@ -13926,19 +14543,15 @@ problems you find =item gunzip $input => $output [, OPTS] A filename, A filehandle, A scalar reference, An array reference, An Input -FileGlob string, A filename, A filehandle, A scalar reference, A Hash -Reference, An Array Reference, An Output FileGlob - -=item gunzip \%hash [, OPTS] - -undef, A filename, A filehandle, A scalar reference, A Hash Reference, An -Array Reference +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob =item Notes =item Optional Parameters -AutoClose =E<gt> 0|1, -Append =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >> =item Examples @@ -13954,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 @@ -13980,7 +14594,7 @@ A filename, A filehandle, A scalar reference =item getHeaderInfo -Comment +Name, Comment =item tell @@ -13990,10 +14604,20 @@ Comment =item binmode +=item opened + +=item autoflush + +=item input_line_number + =item fileno =item close +=item nextStream + +=item trailingData + =back =item Importing @@ -14012,8 +14636,8 @@ Comment =back -=head2 Compress::Zlib::IO::Uncompress::Inflate, IO::Uncompress::Inflate - -Perl interface to read RFC 1950 files/buffers +=head2 Compress::IO::Zlib::IO::Uncompress::Inflate, IO::Uncompress::Inflate +- Read RFC 1950 files/buffers =over 4 @@ -14032,19 +14656,15 @@ problems you find =item inflate $input => $output [, OPTS] A filename, A filehandle, A scalar reference, An array reference, An Input -FileGlob string, A filename, A filehandle, A scalar reference, A Hash -Reference, An Array Reference, An Output FileGlob - -=item inflate \%hash [, OPTS] - -undef, A filename, A filehandle, A scalar reference, A Hash Reference, An -Array Reference +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob =item Notes =item Optional Parameters -AutoClose =E<gt> 0|1, -Append =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >> =item Examples @@ -14060,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 @@ -14094,10 +14714,20 @@ A filename, A filehandle, A scalar reference =item binmode +=item opened + +=item autoflush + +=item input_line_number + =item fileno =item close +=item nextStream + +=item trailingData + =back =item Importing @@ -14116,8 +14746,8 @@ A filename, A filehandle, A scalar reference =back -=head2 Compress::Zlib::IO::Uncompress::RawInflate, -IO::Uncompress::RawInflate - Perl interface to read RFC 1951 files/buffers +=head2 Compress::IO::Zlib::IO::Uncompress::RawInflate, +IO::Uncompress::RawInflate - Read RFC 1951 files/buffers =over 4 @@ -14136,19 +14766,15 @@ problems you find =item rawinflate $input => $output [, OPTS] A filename, A filehandle, A scalar reference, An array reference, An Input -FileGlob string, A filename, A filehandle, A scalar reference, A Hash -Reference, An Array Reference, An Output FileGlob - -=item rawinflate \%hash [, OPTS] - -undef, A filename, A filehandle, A scalar reference, A Hash Reference, An -Array Reference +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob =item Notes =item Optional Parameters -AutoClose =E<gt> 0|1, -Append =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >> =item Examples @@ -14164,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 @@ -14198,10 +14824,20 @@ A filename, A filehandle, A scalar reference =item binmode +=item opened + +=item autoflush + +=item input_line_number + =item fileno =item close +=item nextStream + +=item trailingData + =back =item Importing @@ -14220,384 +14856,216 @@ A filename, A filehandle, A scalar reference =back -=head2 Compress::Zlib::pod::FAQ, Compress::Zlib::FAQ -- Frequently Asked -Questions about Compress::Zlib +=head2 Compress::IO::Zlib::IO::Uncompress::Unzip, IO::Uncompress::Unzip - +Read zip files/buffers =over 4 +=item SYNOPSIS + =item DESCRIPTION +DO NOT use in production code, The documentation is incomplete in places, +Parts of the interface defined here are tentative, Please report any +problems you find + +=item Functional Interface + =over 4 -=item Compatibility with Unix compress/uncompress. +=item unzip $input => $output [, OPTS] + +A filename, A filehandle, A scalar reference, An array reference, An Input +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob + +=item Notes -=item Accessing .tar.Z files +=item Optional Parameters -=item Accessing Zip Files +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >> -=item Zlib Library Version Support +=item Examples =back -=item SEE ALSO +=item OO Interface -=item AUTHOR +=over 4 -=item MODIFICATION HISTORY +=item Constructor -=item COPYRIGHT AND LICENSE +A filename, A filehandle, A scalar reference + +=item Constructor Options + +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 =back -=head2 Config - access Perl configuration information +=item Methods =over 4 -=item SYNOPSIS +=item read -=item DESCRIPTION +=item read -myconfig(), config_sh(), config_re($regex), config_vars(@names) +=item getline -=item EXAMPLE +=item getc -=item WARNING +=item ungetc -=item GLOSSARY +=item inflateSync -=over 4 +=item getHeaderInfo -=item _ +=item tell -C<_a>, C<_exe>, C<_o> +=item eof -=item a +=item seek -C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>, -C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>, -C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>, -C<asctime_r_proto>, C<awk> +=item binmode -=item b +=item opened -C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder> +=item autoflush -=item c +=item input_line_number -C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>, -C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>, -C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>, -C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>, -C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>, -C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>, -C<csh>, C<ctermid_r_proto>, C<ctime_r_proto> +=item fileno -=item d +=item close -C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>, -C<d_archlib>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>, -C<d_attribute_format>, C<d_attribute_malloc>, C<d_attribute_nonnull>, -C<d_attribute_noreturn>, C<d_attribute_pure>, C<d_attribute_unused>, -C<d_attribute_warn_unused_result>, C<d_bcmp>, C<d_bcopy>, C<d_bsd>, -C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>, 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_getpgrp2>, C<d_getpgrp>, 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_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_link>, C<d_localtime_r>, -C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, -C<d_lstat>, C<d_madvise>, C<d_malloc_size>, C<d_malloc_good_size>, -C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>, -C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkdtemp>, -C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, C<d_mmap>, -C<d_modfl>, C<d_modfl_pow32_bug>, C<d_modflproto>, C<d_mprotect>, C<d_msg>, -C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, -C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>, -C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>, -C<d_nl_langinfo>, C<d_nv_preserves_uv>, C<d_nv_zero_is_allbits_zero>, -C<d_off64_t>, C<d_old_pthread_create_joinable>, C<d_oldpthreads>, -C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>, -C<d_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>, -C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, -C<d_PRIFUldbl>, C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, -C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>, -C<d_pthread_atfork>, C<d_pthread_attr_setscope>, C<d_pthread_yield>, -C<d_pwage>, C<d_pwchange>, C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, -C<d_pwgecos>, C<d_pwpasswd>, C<d_pwquota>, C<d_qgcvt>, C<d_quad>, -C<d_random_r>, C<d_readdir64_r>, C<d_readdir>, C<d_readdir_r>, -C<d_readlink>, C<d_readv>, C<d_recvmsg>, C<d_rename>, C<d_rewinddir>, -C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, C<d_sanemcmp>, C<d_sbrkproto>, -C<d_scalbnl>, C<d_sched_yield>, C<d_scm_rights>, C<d_SCNfldbl>, -C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>, C<d_semctl_semid_ds>, -C<d_semctl_semun>, C<d_semget>, C<d_semop>, C<d_sendmsg>, C<d_setegid>, -C<d_seteuid>, C<d_setgrent>, C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>, -C<d_sethostent_r>, C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>, -C<d_setlocale_r>, C<d_setnent>, C<d_setnetent_r>, C<d_setpent>, -C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>, C<d_setprior>, -C<d_setproctitle>, C<d_setprotoent_r>, C<d_setpwent>, C<d_setpwent_r>, -C<d_setregid>, C<d_setresgid>, C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, -C<d_setruid>, C<d_setsent>, C<d_setservent_r>, C<d_setsid>, C<d_setvbuf>, -C<d_sfio>, C<d_shm>, C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>, -C<d_shmdt>, C<d_shmget>, C<d_sigaction>, C<d_sigprocmask>, C<d_sigsetjmp>, -C<d_sockatmark>, C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>, -C<d_sockpair>, C<d_socks5_init>, C<d_sprintf_returns_strlen>, C<d_sqrtl>, -C<d_srand48_r>, C<d_srandom_r>, C<d_sresgproto>, C<d_sresuproto>, -C<d_statblks>, C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>, -C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>, -C<d_stdio_ptr_lval_sets_cnt>, C<d_stdio_stream_array>, C<d_stdiobase>, -C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, -C<d_strerror>, C<d_strerror_r>, C<d_strftime>, C<d_strlcat>, C<d_strlcpy>, -C<d_strtod>, C<d_strtol>, C<d_strtold>, C<d_strtoll>, C<d_strtoq>, -C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, -C<d_symlink>, C<d_syscall>, C<d_syscallproto>, C<d_sysconf>, -C<d_sysernlst>, C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>, -C<d_tcsetpgrp>, C<d_telldir>, C<d_telldirproto>, C<d_time>, C<d_times>, -C<d_tm_tm_gmtoff>, C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, -C<d_ttyname_r>, C<d_tzname>, C<d_u32align>, C<d_ualarm>, C<d_umask>, -C<d_uname>, C<d_union_semun>, C<d_unordered>, C<d_unsetenv>, C<d_usleep>, -C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>, C<d_vendorbin>, -C<d_vendorlib>, C<d_vendorscript>, C<d_vfork>, C<d_void_closedir>, -C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>, -C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>, -C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>, -C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>, -C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext> +=item nextStream -=item e +=item trailingData -C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>, -C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>, -C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>, -C<expr>, C<extensions>, C<extras> +=back -=item f +=item Importing -C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>, -C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>, -C<full_sed> +:all -=item g +=item EXAMPLES -C<gccansipedantic>, C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>, -C<getgrgid_r_proto>, C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>, -C<gethostbyname_r_proto>, C<gethostent_r_proto>, C<getlogin_r_proto>, -C<getnetbyaddr_r_proto>, C<getnetbyname_r_proto>, C<getnetent_r_proto>, -C<getprotobyname_r_proto>, C<getprotobynumber_r_proto>, -C<getprotoent_r_proto>, C<getpwent_r_proto>, C<getpwnam_r_proto>, -C<getpwuid_r_proto>, C<getservbyname_r_proto>, C<getservbyport_r_proto>, -C<getservent_r_proto>, C<getspnam_r_proto>, C<gidformat>, C<gidsign>, -C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, C<gmtime_r_proto>, -C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, C<gzip> +=item SEE ALSO -=item h +=item AUTHOR -C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<html1dir>, C<html1direxp>, -C<html3dir>, C<html3direxp> +=item MODIFICATION HISTORY -=item i +=item COPYRIGHT AND LICENSE -C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>, -C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>, -C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>, -C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>, -C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>, -C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>, -C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>, -C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>, -C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>, -C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>, -C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>, -C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>, -C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>, -C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>, -C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>, -C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>, -C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>, -C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>, -C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installhtml1dir>, -C<installhtml3dir>, C<installman1dir>, C<installman3dir>, C<installprefix>, -C<installprefixexp>, C<installprivlib>, C<installscript>, -C<installsitearch>, C<installsitebin>, C<installsitehtml1dir>, -C<installsitehtml3dir>, C<installsitelib>, C<installsiteman1dir>, -C<installsiteman3dir>, C<installsitescript>, C<installstyle>, -C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>, -C<installvendorhtml1dir>, C<installvendorhtml3dir>, C<installvendorlib>, -C<installvendorman1dir>, C<installvendorman3dir>, C<installvendorscript>, -C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype> +=back -=item k +=head2 Compress::Raw::Zlib - Low-Level Interface to zlib compression +library -C<known_extensions>, C<ksh> +=over 4 -=item l +=item SYNOPSIS -C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>, -C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>, -C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>, -C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>, -C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>, -C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>, -C<lseektype> +=item DESCRIPTION -=item m +=item Compress::Raw::Zlib::Deflate -C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>, -C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>, -C<man3direxp>, C<man3ext> +=over 4 -=item M +=item B<($d, $status) = new Compress::Raw::Zlib::Deflate( [OPT] ) > -C<Mcc>, C<mips_type>, C<mistrustnm>, C<mkdir>, C<mmaptype>, C<modetype>, -C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, -C<myuname> +B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>, +B<-Dictionary>, B<-Bufsize>, B<-AppendOutput>, B<-CRC32>, B<-ADLER32> -=item n +=item B<$status = $d-E<gt>deflate($input, $output)> -C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>, -C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>, -C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>, -C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>, -C<nvsize>, C<nvtype> +=item B<$status = $d-E<gt>flush($output [, $flush_type]) > -=item o +=item B<$status = $d-E<gt>deflateParams([OPT])> -C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>, -C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs> +B<-Level>, B<-Strategy>, B<-BufSize> -=item p +=item B<$status = $d-E<gt>deflateTune($good_length, $max_lazy, +$nice_length, $max_chain)> -C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>, -C<perl>, C<perl_patchlevel> +=item B<$d-E<gt>dict_adler()> -=item P +=item B<$d-E<gt>crc32()> -C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>, -C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>, -C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, C<privlibexp>, -C<procselfexe>, C<prototype>, C<ptrsize> +=item B<$d-E<gt>adler32()> -=item q +=item B<$d-E<gt>msg()> -C<quadkind>, C<quadtype> +=item B<$d-E<gt>total_in()> -=item r +=item B<$d-E<gt>total_out()> -C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>, -C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>, -C<rmail>, C<run>, C<runnm> +=item B<$d-E<gt>get_Strategy()> -=item s +=item B<$d-E<gt>get_Level()> -C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>, -C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>, -C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>, -C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>, -C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>, -C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>, -C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>, -C<sitebinexp>, C<sitehtml1dir>, C<sitehtml1direxp>, C<sitehtml3dir>, -C<sitehtml3direxp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>, -C<siteman1dir>, C<siteman1direxp>, C<siteman3dir>, C<siteman3direxp>, -C<siteprefix>, C<siteprefixexp>, C<sitescript>, C<sitescriptexp>, -C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>, -C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>, -C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>, -C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>, -C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>, C<srandom_r_proto>, C<src>, -C<sSCNfldbl>, C<ssizetype>, C<startperl>, C<startsh>, C<static_ext>, -C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>, -C<stdio_ptr>, C<stdio_stream_array>, C<strerror_r_proto>, C<strings>, -C<submit>, C<subversion>, C<sysman> +=item B<$d-E<gt>get_BufSize()> -=item t +=item Example -C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>, -C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>, -C<ttyname_r_proto> +=back -=item u +=item Compress::Raw::Zlib::Inflate -C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>, -C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>, -C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>, -C<use64bitint>, C<usecrosscompile>, C<usedl>, C<usefaststdio>, -C<useithreads>, C<uselargefiles>, C<uselongdouble>, C<usemallocwrap>, -C<usemorebits>, C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>, -C<useperlio>, C<useposix>, C<usereentrant>, C<userelocatableinc>, -C<usesfio>, C<useshrplib>, C<usesocks>, C<usethreads>, C<usevendorprefix>, -C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>, C<uvsize>, C<uvtype>, -C<uvuformat>, C<uvxformat>, C<uvXUformat> +=over 4 -=item v +=item B< ($i, $status) = new Compress::Raw::Zlib::Inflate( [OPT] ) > -C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>, -C<vendorhtml1dir>, C<vendorhtml1direxp>, C<vendorhtml3dir>, -C<vendorhtml3direxp>, C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, -C<vendorman1dir>, C<vendorman1direxp>, C<vendorman3dir>, -C<vendorman3direxp>, C<vendorprefix>, C<vendorprefixexp>, C<vendorscript>, -C<vendorscriptexp>, C<version>, C<version_patchlevel_string>, -C<versiononly>, C<vi>, C<voidflags> +B<-WindowBits>, B<-Bufsize>, B<-Dictionary>, B<-AppendOutput>, B<-CRC32>, +B<-ADLER32>, B<-ConsumeInput> -=item x +=item B< $status = $i-E<gt>inflate($input, $output [,$eof]) > -C<xlibpth> +=item B<$status = $i-E<gt>inflateSync($input)> -=item y +=item B<$i-E<gt>dict_adler()> -C<yacc>, C<yaccflags> +=item B<$i-E<gt>crc32()> -=item z +=item B<$i-E<gt>adler32()> -C<zcat>, C<zip> +=item B<$i-E<gt>msg()> -=back +=item B<$i-E<gt>total_in()> -=item NOTE +=item B<$i-E<gt>total_out()> + +=item B<$d-E<gt>get_BufSize()> + +=item Example =back -=over 4 +=item CHECKSUM FUNCTIONS -=item SYNOPSIS +=item ACCESSING ZIP FILES -=item DESCRIPTION +=item CONSTANTS -dynamic, nonxs, static +=item SEE ALSO =item AUTHOR +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE + =back -=head2 Cwd - get pathname of current working directory +=head2 Compress::Raw::Zlib::Compress::Raw::Zlib, Compress::Raw::Zlib - +Low-Level Interface to zlib compression library =over 4 @@ -14605,273 +15073,203 @@ dynamic, nonxs, static =item DESCRIPTION -=over 4 +=item Compress::Raw::Zlib::Deflate -=item getcwd and friends +=over 4 -getcwd, cwd, fastcwd, fastgetcwd, getdcwd +=item B<($d, $status) = new Compress::Raw::Zlib::Deflate( [OPT] ) > -=item abs_path and friends +B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>, +B<-Dictionary>, B<-Bufsize>, B<-AppendOutput>, B<-CRC32>, B<-ADLER32> -abs_path, realpath, fast_abs_path +=item B<$status = $d-E<gt>deflate($input, $output)> -=item $ENV{PWD} +=item B<$status = $d-E<gt>flush($output [, $flush_type]) > -=back +=item B<$status = $d-E<gt>deflateParams([OPT])> -=item NOTES +B<-Level>, B<-Strategy>, B<-BufSize> -=item AUTHOR +=item B<$status = $d-E<gt>deflateTune($good_length, $max_lazy, +$nice_length, $max_chain)> -=item COPYRIGHT +=item B<$d-E<gt>dict_adler()> -=item SEE ALSO +=item B<$d-E<gt>crc32()> -=back +=item B<$d-E<gt>adler32()> -=head2 DB - programmatic interface to the Perl debugging API (draft, -subject to -change) +=item B<$d-E<gt>msg()> -=over 4 +=item B<$d-E<gt>total_in()> -=item SYNOPSIS +=item B<$d-E<gt>total_out()> -=item DESCRIPTION +=item B<$d-E<gt>get_Strategy()> -=over 4 +=item B<$d-E<gt>get_Level()> -=item Global Variables +=item B<$d-E<gt>get_BufSize()> - $DB::sub, %DB::sub, $DB::single, $DB::signal, $DB::trace, @DB::args, -@DB::dbline, %DB::dbline, $DB::package, $DB::filename, $DB::subname, -$DB::lineno +=item Example -=item API Methods +=back -CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'), -CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done() +=item Compress::Raw::Zlib::Inflate -=item Client Callback Methods +=over 4 -CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(), -CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(), -CLIENT->output(LIST) +=item B< ($i, $status) = new Compress::Raw::Zlib::Inflate( [OPT] ) > -=back +B<-WindowBits>, B<-Bufsize>, B<-Dictionary>, B<-AppendOutput>, B<-CRC32>, +B<-ADLER32>, B<-ConsumeInput> -=item BUGS +=item B< $status = $i-E<gt>inflate($input, $output [,$eof]) > -=item AUTHOR +=item B<$status = $i-E<gt>inflateSync($input)> -=back +=item B<$i-E<gt>dict_adler()> -=head2 DBM_Filter -- Filter DBM keys/values +=item B<$i-E<gt>crc32()> -=over 4 +=item B<$i-E<gt>adler32()> -=item SYNOPSIS +=item B<$i-E<gt>msg()> -=item DESCRIPTION +=item B<$i-E<gt>total_in()> -=item What is a DBM Filter? +=item B<$i-E<gt>total_out()> -=over 4 +=item B<$d-E<gt>get_BufSize()> -=item So what's new? +=item Example =back -=item METHODS - -=over 4 +=item CHECKSUM FUNCTIONS -=item $db->Filter_Push() +=item ACCESSING ZIP FILES -=item $db->Filter_Key_Push() +=item CONSTANTS -=item $db->Filter_Value_Push() +=item SEE ALSO -Filter_Push, Filter_Key_Push, Filter_Value_Push +=item AUTHOR -=item $db->Filter_Pop() +=item MODIFICATION HISTORY -=item $db->Filtered() +=item COPYRIGHT AND LICENSE =back -=item Writing a Filter +=head2 Compress::Zlib - Interface to zlib compression library =over 4 -=item Immediate Filters - -=item Canned Filters - -"name", params - -=back - -=item Filters Included - -utf8, encode, compress, int32, null +=item SYNOPSIS -=item NOTES +=item DESCRIPTION =over 4 -=item Maintain Round Trip Integrity - -=item Don't mix filtered & non-filtered data in the same database file. +=item Notes for users of Compress::Zlib version 1 =back -=item EXAMPLE - -=item SEE ALSO - -=item AUTHOR - -=back - -=head2 DB_File - Perl5 access to Berkeley DB version 1.x - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION +=item GZIP INTERFACE -B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO> +B<$gz = gzopen($filename, $mode)>, B<$gz = gzopen($filehandle, $mode)>, +B<$bytesread = $gz-E<gt>gzread($buffer [, $size]) ;>, B<$bytesread = +$gz-E<gt>gzreadline($line) ;>, B<$byteswritten = $gz-E<gt>gzwrite($buffer) +;>, B<$status = $gz-E<gt>gzflush($flush_type) ;>, B<$offset = +$gz-E<gt>gztell() ;>, B<$status = $gz-E<gt>gzseek($offset, $whence) ;>, +B<$gz-E<gt>gzclose>, B<$gz-E<gt>gzsetparams($level, $strategy>, B<$level>, +B<$strategy>, B<$gz-E<gt>gzerror>, B<$gzerrno> =over 4 -=item Using DB_File with Berkeley DB version 2 or greater - -=item Interface to Berkeley DB - -=item Opening a Berkeley DB Database File - -=item Default Parameters - -=item In Memory Databases - -=back - -=item DB_HASH +=item Examples -=over 4 +=item Compress::Zlib::memGzip -=item A Simple Example +=item Compress::Zlib::memGunzip =back -=item DB_BTREE - -=over 4 - -=item Changing the BTREE sort order - -=item Handling Duplicate Keys - -=item The get_dup() Method - -=item The find_dup() Method - -=item The del_dup() Method - -=item Matching Partial Keys +=item COMPRESS/UNCOMPRESS -=back +B<$dest = compress($source [, $level] ) ;>, B<$dest = uncompress($source) +;> -=item DB_RECNO +=item Deflate Interface =over 4 -=item The 'bval' Option - -=item A Simple Example - -=item Extra RECNO Methods - -B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>, -B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset, -length, elements);> +=item B<($d, $status) = deflateInit( [OPT] )> -=item Another Example +B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>, +B<-Dictionary>, B<-Bufsize> -=back +=item B<($out, $status) = $d-E<gt>deflate($buffer)> -=item THE API INTERFACE +=item B<($out, $status) = $d-E<gt>flush([flush_type])> -B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status = -$X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [, -$flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key, -$value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;> +=item B<$status = $d-E<gt>deflateParams([OPT])> -=item DBM FILTERS +B<-Level>, B<-Strategy> -B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>, -B<filter_fetch_value> +=item B<$d-E<gt>dict_adler()> -=over 4 +=item B<$d-E<gt>msg()> -=item The Filter +=item B<$d-E<gt>total_in()> -=item An Example -- the NULL termination problem. +=item B<$d-E<gt>total_out()> -=item Another Example -- Key is a C int. +=item Example =back -=item HINTS AND TIPS +=item Inflate Interface =over 4 -=item Locking: The Trouble with fd - -=item Safe ways to lock a database - -B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock> - -=item Sharing Databases With C Applications +=item B<($i, $status) = inflateInit()> -=item The untie() Gotcha +B<-WindowBits>, B<-Bufsize>, B<-Dictionary> -=back +=item B<($out, $status) = $i-E<gt>inflate($buffer)> -=item COMMON QUESTIONS +=item B<$status = $i-E<gt>inflateSync($buffer)> -=over 4 +=item B<$i-E<gt>dict_adler()> -=item Why is there Perl source in my database? +=item B<$i-E<gt>msg()> -=item How do I store complex data structures with DB_File? +=item B<$i-E<gt>total_in()> -=item What does "Invalid Argument" mean? +=item B<$i-E<gt>total_out()> -=item What does "Bareword 'DB_File' not allowed" mean? +=item Example =back -=item REFERENCES - -=item HISTORY - -=item BUGS - -=item AVAILABILITY +=item CHECKSUM FUNCTIONS -=item COPYRIGHT +=item CONSTANTS =item SEE ALSO =item AUTHOR +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE + =back -=head2 Data::Dumper - stringified perl data structures, suitable for both -printing and C<eval> +=head2 Compress::Zlib::Compress::Zlib, Compress::Zlib - Interface to zlib +compression library =over 4 @@ -14881,118 +15279,103 @@ printing and C<eval> =over 4 -=item Methods - -I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump I<or> -I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>), -I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>), -I<$OBJ>->Reset - -=item Functions - -Dumper(I<LIST>) - -=item Configuration Variables or Methods - -=item Exports - -Dumper +=item Notes for users of Compress::Zlib version 1 =back -=item EXAMPLES +=item GZIP INTERFACE -=item BUGS +B<$gz = gzopen($filename, $mode)>, B<$gz = gzopen($filehandle, $mode)>, +B<$bytesread = $gz-E<gt>gzread($buffer [, $size]) ;>, B<$bytesread = +$gz-E<gt>gzreadline($line) ;>, B<$byteswritten = $gz-E<gt>gzwrite($buffer) +;>, B<$status = $gz-E<gt>gzflush($flush_type) ;>, B<$offset = +$gz-E<gt>gztell() ;>, B<$status = $gz-E<gt>gzseek($offset, $whence) ;>, +B<$gz-E<gt>gzclose>, B<$gz-E<gt>gzsetparams($level, $strategy>, B<$level>, +B<$strategy>, B<$gz-E<gt>gzerror>, B<$gzerrno> =over 4 -=item NOTE - -=back - -=item AUTHOR +=item Examples -=item VERSION +=item Compress::Zlib::memGzip -=item SEE ALSO +=item Compress::Zlib::memGunzip =back -=head2 Devel::DProf - a Perl code profiler +=item COMPRESS/UNCOMPRESS -=over 4 +B<$dest = compress($source [, $level] ) ;>, B<$dest = uncompress($source) +;> -=item SYNOPSIS +=item Deflate Interface -=item DESCRIPTION +=over 4 -=item PROFILE FORMAT +=item B<($d, $status) = deflateInit( [OPT] )> -=item AUTOLOAD +B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>, +B<-Dictionary>, B<-Bufsize> -=item ENVIRONMENT +=item B<($out, $status) = $d-E<gt>deflate($buffer)> -=item BUGS +=item B<($out, $status) = $d-E<gt>flush([flush_type])> -=item SEE ALSO +=item B<$status = $d-E<gt>deflateParams([OPT])> -=back +B<-Level>, B<-Strategy> -=head2 Devel::PPPort - Perl/Pollution/Portability +=item B<$d-E<gt>dict_adler()> -=over 4 +=item B<$d-E<gt>msg()> -=item SYNOPSIS +=item B<$d-E<gt>total_in()> -=item DESCRIPTION +=item B<$d-E<gt>total_out()> -=over 4 +=item Example -=item Why use ppport.h? +=back -You should use F<ppport.h> in modern code so that your code will work -with the widest range of Perl interpreters possible, without significant -additional work. +=item Inflate Interface -=item How to use ppport.h +=over 4 -=item Running ppport.h +=item B<($i, $status) = inflateInit()> -=back +B<-WindowBits>, B<-Bufsize>, B<-Dictionary> -=item FUNCTIONS +=item B<($out, $status) = $i-E<gt>inflate($buffer)> -=over 4 +=item B<$status = $i-E<gt>inflateSync($buffer)> -=item WriteFile +=item B<$i-E<gt>dict_adler()> -=back +=item B<$i-E<gt>msg()> -=item COMPATIBILITY +=item B<$i-E<gt>total_in()> -=over 4 +=item B<$i-E<gt>total_out()> -=item Provided Perl compatibility API +=item Example -=item Perl API not supported by ppport.h +=back -perl 5.9.2, perl 5.9.1, perl 5.9.0, perl 5.8.3, perl 5.8.1, perl 5.8.0, -perl 5.7.3, perl 5.7.2, perl 5.7.1, perl 5.6.1, perl 5.6.0, perl 5.005_03, -perl 5.005, perl 5.004_05, perl 5.004_04, perl 5.004 +=item CHECKSUM FUNCTIONS -=back +=item CONSTANTS -=item BUGS +=item SEE ALSO -=item AUTHORS +=item AUTHOR -=item COPYRIGHT +=item MODIFICATION HISTORY -=item SEE ALSO +=item COPYRIGHT AND LICENSE =back -=head2 Devel::Peek - A data debugging tool for the XS programmer +=head2 Config - access Perl configuration information =over 4 @@ -15000,49 +15383,1909 @@ perl 5.005, perl 5.004_05, perl 5.004_04, perl 5.004 =item DESCRIPTION -=over 4 - -=item Runtime debugging +myconfig(), config_sh(), config_re($regex), config_vars(@names) -=item Memory footprint debugging +=item EXAMPLE -=back +=item WARNING -=item EXAMPLES +=item GLOSSARY =over 4 -=item A simple scalar string +=item _ -=item A simple scalar number +C<_a>, C<_exe>, C<_o> -=item A simple scalar with an extra reference +=item a + +C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>, +C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>, +C<ar>, C<archlib>, C<archlibexp>, C<archname>, C<archname64>, C<archobjs>, +C<asctime_r_proto>, C<awk> + +=item b + +C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder> + +=item c + +C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>, +C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>, +C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>, +C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>, +C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>, +C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>, +C<csh>, C<ctermid_r_proto>, C<ctime_r_proto> + +=item d + +C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>, +C<d_archlib>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>, +C<d_attribute_format>, C<d_attribute_malloc>, C<d_attribute_nonnull>, +C<d_attribute_noreturn>, C<d_attribute_pure>, C<d_attribute_unused>, +C<d_attribute_warn_unused_result>, C<d_bcmp>, C<d_bcopy>, C<d_bsd>, +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_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>, +C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, C<d_lstat>, +C<d_madvise>, C<d_malloc_good_size>, C<d_malloc_size>, C<d_mblen>, +C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>, C<d_memcpy>, +C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, +C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, C<d_mmap>, C<d_modfl>, +C<d_modfl_pow32_bug>, C<d_modflproto>, C<d_mprotect>, C<d_msg>, +C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, +C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>, +C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>, +C<d_nl_langinfo>, C<d_nv_preserves_uv>, C<d_nv_zero_is_allbits_zero>, +C<d_off64_t>, C<d_old_pthread_create_joinable>, C<d_oldpthreads>, +C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>, +C<d_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>, +C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, +C<d_PRIFUldbl>, C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, +C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>, +C<d_pthread_atfork>, C<d_pthread_attr_setscope>, C<d_pthread_yield>, +C<d_pwage>, C<d_pwchange>, C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, +C<d_pwgecos>, C<d_pwpasswd>, C<d_pwquota>, C<d_qgcvt>, C<d_quad>, +C<d_random_r>, C<d_readdir>, C<d_readdir64_r>, C<d_readdir_r>, +C<d_readlink>, C<d_readv>, C<d_recvmsg>, C<d_rename>, C<d_rewinddir>, +C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, C<d_sanemcmp>, C<d_sbrkproto>, +C<d_scalbnl>, C<d_sched_yield>, C<d_scm_rights>, C<d_SCNfldbl>, +C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>, C<d_semctl_semid_ds>, +C<d_semctl_semun>, C<d_semget>, C<d_semop>, C<d_sendmsg>, C<d_setegid>, +C<d_seteuid>, C<d_setgrent>, C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>, +C<d_sethostent_r>, C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>, +C<d_setlocale_r>, C<d_setnent>, C<d_setnetent_r>, C<d_setpent>, +C<d_setpgid>, C<d_setpgrp>, C<d_setpgrp2>, C<d_setprior>, +C<d_setproctitle>, C<d_setprotoent_r>, C<d_setpwent>, C<d_setpwent_r>, +C<d_setregid>, C<d_setresgid>, C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, +C<d_setruid>, C<d_setsent>, C<d_setservent_r>, C<d_setsid>, C<d_setvbuf>, +C<d_sfio>, C<d_shm>, C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>, +C<d_shmdt>, C<d_shmget>, C<d_sigaction>, C<d_sigprocmask>, C<d_sigsetjmp>, +C<d_sitearch>, C<d_snprintf>, C<d_sockatmark>, C<d_sockatmarkproto>, +C<d_socket>, C<d_socklen_t>, C<d_sockpair>, C<d_socks5_init>, +C<d_sprintf_returns_strlen>, C<d_sqrtl>, C<d_srand48_r>, C<d_srandom_r>, +C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>, C<d_statfs_f_flags>, +C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>, +C<d_stdio_ptr_lval_nochange_cnt>, C<d_stdio_ptr_lval_sets_cnt>, +C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>, +C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>, C<d_strerror_r>, +C<d_strftime>, C<d_strlcat>, C<d_strlcpy>, C<d_strtod>, C<d_strtol>, +C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>, +C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>, +C<d_syscallproto>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>, +C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>, +C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tm_tm_gmtoff>, +C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, C<d_ttyname_r>, C<d_tzname>, +C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>, +C<d_unordered>, C<d_unsetenv>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>, +C<d_vendorarch>, C<d_vendorbin>, C<d_vendorlib>, C<d_vendorscript>, +C<d_vfork>, C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>, C<d_volatile>, +C<d_vprintf>, C<d_vsnprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>, +C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>, C<db_hashtype>, +C<db_prefixtype>, C<db_version_major>, C<db_version_minor>, +C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>, +C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext> + +=item e + +C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>, +C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>, +C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>, +C<expr>, C<extensions>, C<extras> + +=item f + +C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>, +C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>, +C<full_sed> + +=item g + +C<gccansipedantic>, C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>, +C<getgrgid_r_proto>, C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>, +C<gethostbyname_r_proto>, C<gethostent_r_proto>, C<getlogin_r_proto>, +C<getnetbyaddr_r_proto>, C<getnetbyname_r_proto>, C<getnetent_r_proto>, +C<getprotobyname_r_proto>, C<getprotobynumber_r_proto>, +C<getprotoent_r_proto>, C<getpwent_r_proto>, C<getpwnam_r_proto>, +C<getpwuid_r_proto>, C<getservbyname_r_proto>, C<getservbyport_r_proto>, +C<getservent_r_proto>, C<getspnam_r_proto>, C<gidformat>, C<gidsign>, +C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, C<gmtime_r_proto>, +C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, C<gzip> + +=item h + +C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<html1dir>, C<html1direxp>, +C<html3dir>, C<html3direxp> + +=item i + +C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>, +C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>, +C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>, +C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>, +C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>, +C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>, +C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>, +C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>, +C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>, +C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>, +C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>, +C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>, +C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>, +C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>, +C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>, +C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>, +C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>, +C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>, +C<incpath>, C<inews>, C<initialinstalllocation>, C<installarchlib>, +C<installbin>, C<installhtml1dir>, C<installhtml3dir>, C<installman1dir>, +C<installman3dir>, C<installprefix>, C<installprefixexp>, +C<installprivlib>, C<installscript>, C<installsitearch>, C<installsitebin>, +C<installsitehtml1dir>, C<installsitehtml3dir>, C<installsitelib>, +C<installsiteman1dir>, C<installsiteman3dir>, C<installsitescript>, +C<installstyle>, C<installusrbinperl>, C<installvendorarch>, +C<installvendorbin>, C<installvendorhtml1dir>, C<installvendorhtml3dir>, +C<installvendorlib>, C<installvendorman1dir>, C<installvendorman3dir>, +C<installvendorscript>, C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>, +C<ivtype> + +=item k + +C<known_extensions>, C<ksh> + +=item l + +C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>, +C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>, +C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>, +C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>, +C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>, +C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>, +C<lseektype> + +=item m + +C<mad>, C<madlyh>, C<madlyobj>, C<madlysrc>, C<mail>, C<mailx>, C<make>, +C<make_set_make>, C<mallocobj>, C<mallocsrc>, C<malloctype>, C<man1dir>, +C<man1direxp>, C<man1ext>, C<man3dir>, C<man3direxp>, C<man3ext> + +=item M + +C<Mcc>, C<mips_type>, C<mistrustnm>, C<mkdir>, C<mmaptype>, C<modetype>, +C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, +C<myuname> + +=item n + +C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>, +C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>, +C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>, +C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>, +C<nvsize>, C<nvtype> + +=item o + +C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>, +C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs> + +=item p + +C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl>, +C<perl5> + +=item P + +C<PERL_API_REVISION>, C<PERL_API_SUBVERSION>, C<PERL_API_VERSION>, +C<PERL_CONFIG_SH>, C<PERL_PATCHLEVEL>, C<perl_patchlevel>, +C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>, +C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>, +C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, C<privlibexp>, +C<procselfexe>, C<prototype>, C<ptrsize> + +=item q + +C<quadkind>, C<quadtype> + +=item r + +C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>, +C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>, +C<rmail>, C<run>, C<runnm> + +=item s + +C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>, +C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>, +C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>, +C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>, +C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>, +C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>, +C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>, +C<sitebinexp>, C<sitehtml1dir>, C<sitehtml1direxp>, C<sitehtml3dir>, +C<sitehtml3direxp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>, +C<siteman1dir>, C<siteman1direxp>, C<siteman3dir>, C<siteman3direxp>, +C<siteprefix>, C<siteprefixexp>, C<sitescript>, C<sitescriptexp>, +C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>, +C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>, +C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>, +C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>, +C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>, C<srandom_r_proto>, C<src>, +C<sSCNfldbl>, C<ssizetype>, C<startperl>, C<startsh>, C<static_ext>, +C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>, +C<stdio_ptr>, C<stdio_stream_array>, C<strerror_r_proto>, C<strings>, +C<submit>, C<subversion>, C<sysman> + +=item t + +C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>, +C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>, +C<ttyname_r_proto> + +=item u + +C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>, +C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>, +C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>, +C<use64bitint>, C<usecrosscompile>, C<usedl>, C<usefaststdio>, +C<useithreads>, C<uselargefiles>, C<uselongdouble>, C<usemallocwrap>, +C<usemorebits>, C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>, +C<useperlio>, C<useposix>, C<usereentrant>, C<userelocatableinc>, +C<usesfio>, C<useshrplib>, C<usesitecustomize>, C<usesocks>, C<usethreads>, +C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>, +C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>, C<uvXUformat> + +=item v + +C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>, +C<vendorhtml1dir>, C<vendorhtml1direxp>, C<vendorhtml3dir>, +C<vendorhtml3direxp>, C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, +C<vendorman1dir>, C<vendorman1direxp>, C<vendorman3dir>, +C<vendorman3direxp>, C<vendorprefix>, C<vendorprefixexp>, C<vendorscript>, +C<vendorscriptexp>, C<version>, C<version_patchlevel_string>, +C<versiononly>, C<vi>, C<voidflags> + +=item x + +C<xlibpth> + +=item y + +C<yacc>, C<yaccflags> + +=item z + +C<zcat>, C<zip> + +=back + +=item NOTE + +=back + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +dynamic, nonxs, static + +=item AUTHOR + +=back + +=head2 Cwd - get pathname of current working directory + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item getcwd and friends + +getcwd, cwd, fastcwd, fastgetcwd, getdcwd + +=item abs_path and friends + +abs_path, realpath, fast_abs_path + +=item $ENV{PWD} + +=back + +=item NOTES + +=item AUTHOR + +=item COPYRIGHT + +=item SEE ALSO + +=back + +=head2 DB - programmatic interface to the Perl debugging API (draft, +subject to +change) + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Global Variables + + $DB::sub, %DB::sub, $DB::single, $DB::signal, $DB::trace, @DB::args, +@DB::dbline, %DB::dbline, $DB::package, $DB::filename, $DB::subname, +$DB::lineno + +=item API Methods + +CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'), +CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done() + +=item Client Callback Methods + +CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(), +CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(), +CLIENT->output(LIST) + +=back + +=item BUGS + +=item AUTHOR + +=back + +=head2 DBM_Filter -- Filter DBM keys/values + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item What is a DBM Filter? + +=over 4 + +=item So what's new? + +=back + +=item METHODS + +=over 4 + +=item $db->Filter_Push() + +=item $db->Filter_Key_Push() + +=item $db->Filter_Value_Push() + +Filter_Push, Filter_Key_Push, Filter_Value_Push + +=item $db->Filter_Pop() + +=item $db->Filtered() + +=back + +=item Writing a Filter + +=over 4 + +=item Immediate Filters + +=item Canned Filters + +"name", params + +=back + +=item Filters Included + +utf8, encode, compress, int32, null + +=item NOTES + +=over 4 + +=item Maintain Round Trip Integrity + +=item Don't mix filtered & non-filtered data in the same database file. + +=back + +=item EXAMPLE + +=item SEE ALSO + +=item AUTHOR + +=back + +=head2 DBM_Filter::compress - filter for DBM_Filter + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=item AUTHOR + +=back + +=head2 DBM_Filter::encode - filter for DBM_Filter + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=item AUTHOR + +=back + +=head2 DBM_Filter::int32 - filter for DBM_Filter + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=item AUTHOR + +=back + +=head2 DBM_Filter::null - filter for DBM_Filter + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=item AUTHOR + +=back + +=head2 DBM_Filter::utf8 - filter for DBM_Filter + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=item AUTHOR + +=back + +=head2 DB_File - Perl5 access to Berkeley DB version 1.x + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO> + +=over 4 + +=item Using DB_File with Berkeley DB version 2 or greater + +=item Interface to Berkeley DB + +=item Opening a Berkeley DB Database File + +=item Default Parameters + +=item In Memory Databases + +=back + +=item DB_HASH + +=over 4 + +=item A Simple Example + +=back + +=item DB_BTREE + +=over 4 + +=item Changing the BTREE sort order + +=item Handling Duplicate Keys + +=item The get_dup() Method + +=item The find_dup() Method + +=item The del_dup() Method + +=item Matching Partial Keys + +=back + +=item DB_RECNO + +=over 4 + +=item The 'bval' Option + +=item A Simple Example + +=item Extra RECNO Methods + +B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>, +B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset, +length, elements);> + +=item Another Example + +=back + +=item THE API INTERFACE + +B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status = +$X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [, +$flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key, +$value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;> + +=item DBM FILTERS + +B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>, +B<filter_fetch_value> + +=over 4 + +=item The Filter + +=item An Example -- the NULL termination problem. + +=item Another Example -- Key is a C int. + +=back + +=item HINTS AND TIPS + +=over 4 + +=item Locking: The Trouble with fd + +=item Safe ways to lock a database + +B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock> + +=item Sharing Databases With C Applications + +=item The untie() Gotcha + +=back + +=item COMMON QUESTIONS + +=over 4 + +=item Why is there Perl source in my database? + +=item How do I store complex data structures with DB_File? + +=item What does "Invalid Argument" mean? + +=item What does "Bareword 'DB_File' not allowed" mean? + +=back + +=item REFERENCES + +=item HISTORY + +=item BUGS + +=item AVAILABILITY + +=item COPYRIGHT + +=item SEE ALSO + +=item AUTHOR + +=back + +=head2 Data::Dumper - stringified perl data structures, suitable for both +printing and C<eval> + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Methods + +I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump I<or> +I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>), +I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>), +I<$OBJ>->Reset + +=item Functions + +Dumper(I<LIST>) + +=item Configuration Variables or Methods + +=item Exports + +Dumper + +=back + +=item EXAMPLES + +=item BUGS + +=over 4 + +=item NOTE + +=back + +=item AUTHOR + +=item VERSION + +=item SEE ALSO + +=back + +=head2 Devel::DProf - a Perl code profiler + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item PROFILE FORMAT + +=item AUTOLOAD + +=item ENVIRONMENT + +=item BUGS + +=item SEE ALSO + +=back + +=head2 Devel::PPPort - Perl/Pollution/Portability + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Why use ppport.h? + +=item How to use ppport.h + +=item Running ppport.h + +=back + +=item FUNCTIONS + +=over 4 + +=item WriteFile + +=back + +=item COMPATIBILITY + +=over 4 + +=item Provided Perl compatibility API + +=item Perl API not supported by ppport.h + +perl 5.9.4, perl 5.9.3, perl 5.9.2, perl 5.9.1, perl 5.9.0, perl 5.8.3, +perl 5.8.1, perl 5.8.0, perl 5.7.3, perl 5.7.2, perl 5.7.1, perl 5.6.1, +perl 5.6.0, perl 5.005_03, perl 5.005, perl 5.004_05, perl 5.004 + +=back + +=item BUGS + +=item AUTHORS + +=item COPYRIGHT + +=item SEE ALSO + +=back + +=head2 Devel::Peek - A data debugging tool for the XS programmer + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Runtime debugging + +=item Memory footprint debugging + +=back + +=item EXAMPLES + +=over 4 + +=item A simple scalar string + +=item A simple scalar number + +=item A simple scalar with an extra reference + +=item A reference to a simple scalar + +=item A reference to an array + +=item A reference to a hash + +=item Dumping a large array or hash + +=item A reference to an SV which holds a C pointer + +=item A reference to a subroutine + +=back + +=item EXPORTS + +=item BUGS + +=item AUTHOR + +=item SEE ALSO + +=back + +=head2 Devel::SelfStubber - generate stubs for a SelfLoading module + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=back + +=head2 Digest - Modules that calculate message digests + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +I<binary>, I<hex>, I<base64> + +=item OO INTERFACE + +$ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx = +Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset, +$ctx->add( $data ), $ctx->add( $chunk1, $chunk2, ... ), $ctx->addfile( +$io_handle ), $ctx->add_bits( $data, $nbits ), $ctx->add_bits( $bitstring +), $ctx->digest, $ctx->hexdigest, $ctx->b64digest + +=item Digest speed + +=item SEE ALSO + +=item AUTHOR + +=back + +=head2 Digest::MD5 - Perl interface to the MD5 Algorithm + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item FUNCTIONS + +md5($data,...), md5_hex($data,...), md5_base64($data,...) + +=item METHODS + +$md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...), +$md5->addfile($io_handle), $md5->add_bits($data, $nbits), +$md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest + +=item EXAMPLES + +=item SEE ALSO + +=item COPYRIGHT + +=item AUTHORS + +=back + +=head2 Digest::SHA - Perl extension for SHA-1/224/256/384/512 + +=over 4 + +=item SYNOPSIS (SHA) + +=item SYNOPSIS (HMAC-SHA) + +=item ABSTRACT + +=item DESCRIPTION + +=item NIST STATEMENT ON SHA-1 + +=item BASE64 DIGESTS + +=item EXPORT + +=item EXPORTABLE FUNCTIONS + +B<sha1($data, ...)>, B<sha224($data, ...)>, B<sha256($data, ...)>, +B<sha384($data, ...)>, B<sha512($data, ...)>, B<sha1_hex($data, ...)>, +B<sha224_hex($data, ...)>, B<sha256_hex($data, ...)>, B<sha384_hex($data, +...)>, B<sha512_hex($data, ...)>, B<sha1_base64($data, ...)>, +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<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)>, +B<hmac_sha1_hex($data, $key)>, B<hmac_sha224_hex($data, $key)>, +B<hmac_sha256_hex($data, $key)>, B<hmac_sha384_hex($data, $key)>, +B<hmac_sha512_hex($data, $key)>, B<hmac_sha1_base64($data, $key)>, +B<hmac_sha224_base64($data, $key)>, B<hmac_sha256_base64($data, $key)>, +B<hmac_sha384_base64($data, $key)>, B<hmac_sha512_base64($data, $key)> + +=item SEE ALSO + +=item AUTHOR + +=item ACKNOWLEDGMENTS + +=item COPYRIGHT AND LICENSE + +=back + +=head2 Digest::base - Digest base class + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=back + +=head2 Digest::file - Calculate digests of files + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +digest_file( $file, $algorithm, [$arg,...] ), digest_file_hex( $file, +$algorithm, [$arg,...] ), digest_file_base64( $file, $algorithm, [$arg,...] +) + +=item SEE ALSO + +=back + +=head2 DirHandle - supply object methods for directory handles + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item NOTES + +=back + +=head2 Dumpvalue - provides screen dump of Perl data. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Creation + +C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>, +C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>, +C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit, +stopDbSignal + +=item Methods + +dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl, +compactDump, veryCompact, set, get + +=back + +=back + +=head2 DynaLoader - Dynamically load C libraries into Perl code + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +@dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs, +@dl_modules, @dl_shared_objects, dl_error(), $dl_debug, dl_findfile(), +dl_expandspec(), dl_load_file(), dl_unload_file(), dl_load_flags(), +dl_find_symbol(), dl_find_symbol_anywhere(), dl_undef_symbols(), +dl_install_xsub(), bootstrap() + +=item AUTHOR + +=back + +=head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into +Perl code + +=over 4 + +=item VERSION + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Migration from C<DynaLoader> + +=item Backward compatible boilerplate + +=back + +=item Order of initialization: early load() + +=over 4 + +=item The most hairy case + +=back + +=item DIAGNOSTICS + +Can't find '%s' symbol in %s, Can't load '%s' for module %s: %s, Undefined +symbols present after loading %s: %s, XSLoader::load('Your::Module', +$Your::Module::VERSION) + +=item LIMITATIONS + +=item BUGS + +=item SEE ALSO + +=item AUTHORS + +=item COPYRIGHT + +=back + +=head2 Encode - character encodings + +=over 4 + +=item SYNOPSIS + +=over 4 + +=item Table of Contents + +=back + +=item DESCRIPTION + +=over 4 + +=item TERMINOLOGY + +=back + +=item PERL ENCODING API + +$octets = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING, +$octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [, +CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [, +CHECK]); + +=over 4 + +=item Listing available encodings + +=item Defining Aliases + +=back + +=item Encoding via PerlIO + +=item Handling Malformed Data + +B<NOTE:> Not all encoding support this feature, I<CHECK> = +Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1), I<CHECK> = +Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode (I<CHECK> = +Encode::FB_PERLQQ), HTML charref mode (I<CHECK> = Encode::FB_HTMLCREF), XML +charref mode (I<CHECK> = Encode::FB_XMLCREF), The bitmask + +=over 4 + +=item coderef for CHECK + +=back + +=item Defining Encodings + +=item The UTF-8 flag + +Goal #1:, Goal #2:, Goal #3:, Goal #4: + +=over 4 + +=item Messing with Perl's Internals + +is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING) + +=back + +=item UTF-8 vs. utf8 + +=item SEE ALSO + +=item MAINTAINER + +=item COPYRIGHT + +=back + +=head2 Encode::Alias - alias definitions to encodings + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +As a simple string, As a qr// compiled regular expression, e.g.:, As a code +reference, e.g.: + +=over 4 + +=item Alias overloading + +=back + +=item SEE ALSO + +=back + +=head2 Encode::Byte - Single Byte Encodings + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +=item DESCRIPTION + +=item SEE ALSO + +=back + +=head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_* + +=head2 Encode::CN - China-based Chinese Encodings + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item NOTES + +=item BUGS + +=item SEE ALSO + +=back + +=head2 Encode::CN::HZ -- internally used by Encode::CN + +=head2 Encode::Config -- internally used by Encode + +=head2 Encode::EBCDIC - EBCDIC Encodings + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +=item DESCRIPTION + +=item SEE ALSO + +=back + +=head2 Encode::Encoding - Encode Implementation Base Class + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Methods you should implement + +-E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]), +-E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check]) + +=item Other methods defined in Encode::Encodings + +-E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(), +-E<gt>needs_lines() + +=item Example: Encode::ROT13 + +=back + +=item Why the heck Encode API is different? + +=over 4 + +=item Compiled Encodings + +=back + +=item SEE ALSO + +Scheme 1, Scheme 2, Other Schemes + +=back + +=head2 Encode::Guess -- Guesses encoding from data + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +=item DESCRIPTION + +Encode::Guess->set_suspects, Encode::Guess->add_suspects, +Encode::decode("Guess" ...), Encode::Guess->guess($data), +guess_encoding($data, [, I<list of suspects>]) + +=item CAVEATS + +=item TO DO + +=item SEE ALSO + +=back + +=head2 Encode::JP - Japanese Encodings + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +=item DESCRIPTION + +=item Note on ISO-2022-JP(-1)? + +=item BUGS + +=item SEE ALSO + +=back + +=head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP* + +=head2 Encode::JP::JIS7 -- internally used by Encode::JP + +=head2 Encode::KR - Korean Encodings + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item BUGS + +=item SEE ALSO + +=back + +=head2 Encode::KR::2022_KR -- internally used by Encode::KR + +=head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +=item DESCRIPTION + +=item BUGS + +=item SEE ALSO + +=back + +=head2 Encode::PerlIO -- a detailed document on Encode and PerlIO + +=over 4 + +=item Overview + +=item How does it work? + +=item Line Buffering + +=over 4 + +=item How can I tell whether my encoding fully supports PerlIO ? + +=back + +=item SEE ALSO + +=back + +=head2 Encode::Supported -- Encodings supported by Encode + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Encoding Names + +=back + +=item Supported Encodings + +=over 4 + +=item Built-in Encodings + +=item Encode::Unicode -- other Unicode encodings + +=item Encode::Byte -- Extended ASCII + +ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for +the Cyrillic world, gsm0338 - Hentai Latin 1 + +=item CJK: Chinese, Japanese, Korean (Multibyte) + +Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea, +Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN, +Encode::JIS2K -- JIS X 0213 encodings via CPAN + +=item Miscellaneous encodings + +Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess + +=back + +=item Unsupported encodings + + ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings, +Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran +System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS, +Various Mac encodings, (Mac) Indic encodings + +=item Encoding vs. Charset -- terminology + +=item Encoding Classification (by Anton Tagunov and Dan Kogai) + +=over 4 + +=item Microsoft-related naming mess + +KS_C_5601-1987, GB2312, Big5, Shift_JIS + +=back + +=item Glossary + +character repertoire, coded character set (CCS), character encoding scheme +(CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF, +UTF-16 + +=item See Also + +=item References + +ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO, +RFC, UC, Unicode Glossary + +=over 4 + +=item Other Notable Sites + +czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org: +"Introduction to i18n" + +=item Offline sources + +C<CJKV Information Processing> by Ken Lunde + +=back + +=back + +=head2 Encode::Symbol - Symbol Encodings + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +=item DESCRIPTION + +=item SEE ALSO + +=back + +=head2 Encode::TW - Taiwan-based Chinese Encodings + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item NOTES + +=item BUGS + +=item SEE ALSO + +=back + +=head2 Encode::Unicode -- Various Unicode Transformation Formats + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +L<http://www.unicode.org/glossary/> says:, Quick Reference + +=item Size, Endianness, and BOM + +=over 4 + +=item by size + +=item by endianness + +BOM as integer when fetched in network byte order + +=back + +=item Surrogate Pairs + +=item Error Checking + +=item SEE ALSO + +=back + +=head2 Encode::Unicode::UTF7 -- UTF-7 encoding + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +=item In Practice + +=item SEE ALSO + +=back + +=head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to +encodings + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +As a simple string, As a qr// compiled regular expression, e.g.:, As a code +reference, e.g.: + +=over 4 + +=item Alias overloading + +=back + +=item SEE ALSO + +=back + +=head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm -- +Internally used by Encode::??::ISO_2022_* + +=head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by +Encode::CN + +=head2 Encode::lib::Encode::Config, Encode::Config -- internally used by +Encode + +=head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode +Implementation Base Class + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Methods you should implement + +-E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]), +-E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check]) + +=item Other methods defined in Encode::Encodings + +-E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(), +-E<gt>needs_lines() + +=item Example: Encode::ROT13 + +=back + +=item Why the heck Encode API is different? + +=over 4 + +=item Compiled Encodings + +=back + +=item SEE ALSO + +Scheme 1, Scheme 2, Other Schemes + +=back + +=head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from +data + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +=item DESCRIPTION + +Encode::Guess->set_suspects, Encode::Guess->add_suspects, +Encode::decode("Guess" ...), Encode::Guess->guess($data), +guess_encoding($data, [, I<list of suspects>]) + +=item CAVEATS + +=item TO DO + +=item SEE ALSO + +=back + +=head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by +Encode::JP::2022_JP* + +=head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used +by Encode::JP + +=head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally +used by Encode::KR + +=head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B' +and 'Q' header encoding + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +=item DESCRIPTION + +=item BUGS + +=item SEE ALSO + +=back + +=head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document +on Encode and PerlIO + +=over 4 + +=item Overview + +=item How does it work? + +=item Line Buffering + +=over 4 + +=item How can I tell whether my encoding fully supports PerlIO ? + +=back + +=item SEE ALSO + +=back + +=head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings +supported by Encode + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Encoding Names + +=back + +=item Supported Encodings + +=over 4 + +=item Built-in Encodings + +=item Encode::Unicode -- other Unicode encodings + +=item Encode::Byte -- Extended ASCII + +ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for +the Cyrillic world, gsm0338 - Hentai Latin 1 + +=item CJK: Chinese, Japanese, Korean (Multibyte) + +Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea, +Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN, +Encode::JIS2K -- JIS X 0213 encodings via CPAN + +=item Miscellaneous encodings + +Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess + +=back + +=item Unsupported encodings + + ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings, +Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran +System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS, +Various Mac encodings, (Mac) Indic encodings + +=item Encoding vs. Charset -- terminology + +=item Encoding Classification (by Anton Tagunov and Dan Kogai) + +=over 4 + +=item Microsoft-related naming mess + +KS_C_5601-1987, GB2312, Big5, Shift_JIS + +=back + +=item Glossary + +character repertoire, coded character set (CCS), character encoding scheme +(CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF, +UTF-16 + +=item See Also + +=item References + +ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO, +RFC, UC, Unicode Glossary + +=over 4 + +=item Other Notable Sites + +czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org: +"Introduction to i18n" + +=item Offline sources + +C<CJKV Information Processing> by Ken Lunde + +=back + +=back + +=head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7 +encoding + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +=item In Practice + +=item SEE ALSO + +=back + +=head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +=item Description + +=over 4 + +=item Predefined Methods + +$e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(), +$e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]), +$e-E<gt>bytes([$encoding]) + +=item Example: base64 transcoder + +=item Operator Overloading + +=back + +=item SEE ALSO + +=back + +=head2 Encodencoding, encoding - allows you to write your script in +non-ascii or non-utf8 + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +=over 4 + +=item Literal Conversions + +=item PerlIO layers for C<STD(IN|OUT)> + +=item Implicit upgrading for byte strings + +=back + +=item FEATURES THAT REQUIRE 5.8.1 + +"NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle + +=item USAGE + +use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt> +I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding; + +=item The Filter Option + +=over 4 + +=item Filter-related changes at Encode version 1.87 + +=back + +=item CAVEATS + +=over 4 + +=item NOT SCOPED + +=item DO NOT MIX MULTIPLE ENCODINGS + +=item tr/// with ranges + +Legend of characters above + +=back + +=item EXAMPLE - Greekperl + +=item KNOWN PROBLEMS + +literals in regex that are longer than 127 bytes, EBCDIC, format + +=over 4 + +=item The Logic of :locale + +=back + +=item HISTORY + +=item SEE ALSO -=item A reference to a simple scalar +=back -=item A reference to an array +=head2 Encoder, Encode::Encoder -- Object Oriented Encoder -=item A reference to a hash +=over 4 -=item Dumping a large array or hash +=item SYNOPSIS -=item A reference to an SV which holds a C pointer +=item ABSTRACT -=item A reference to a subroutine +=item Description -=back +=over 4 -=item EXPORTS +=item Predefined Methods -=item BUGS +$e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(), +$e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]), +$e-E<gt>bytes([$encoding]) -=item AUTHOR +=item Example: base64 transcoder + +=item Operator Overloading + +=back =item SEE ALSO =back -=head2 Devel::SelfStubber - generate stubs for a SelfLoading module +=head2 English - use nice English (or awk) names for ugly punctuation +variables =over 4 @@ -15050,10 +17293,12 @@ perl 5.005, perl 5.004_05, perl 5.004_04, perl 5.004 =item DESCRIPTION +=item PERFORMANCE + =back -=head2 Devel::Size - Perl extension for finding the memory usage of Perl -variables +=head2 Env - perl module that imports environment variables as scalars or +arrays =over 4 @@ -15061,77 +17306,73 @@ variables =item DESCRIPTION -=item FUNCTIONS +=item LIMITATIONS -=over 4 +=item AUTHOR -=item size($ref) +=back -=item total_size($ref) +=head2 Errno - System errno constants -=back +=over 4 -=item EXPORT +=item SYNOPSIS -=item UNDERSTANDING MEMORY ALLOCATION +=item DESCRIPTION -=over 4 +=item CAVEATS -=item The C library +=item AUTHOR -=item Perl +=item COPYRIGHT =back -=item DANGERS - -=item Messages: texts originating from this module. +=head2 Exporter - Implements default import method for modules =over 4 -=item Errors +=item SYNOPSIS -=item warnings +=item DESCRIPTION -=back +=over 4 -=item BUGS +=item How to Export -=item AUTHOR +=item Selecting What To Export -=item COPYRIGHT +=item How to Import -=item SEE ALSO +C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);> =back -=head2 Digest - Modules that calculate message digests +=item Advanced features =over 4 -=item SYNOPSIS +=item Specialised Import Lists -=item DESCRIPTION +=item Exporting without using Exporter's import method -I<binary>, I<hex>, I<base64> +=item Exporting without inheriting from Exporter -=item OO INTERFACE +=item Module Version Checking -$ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx = -Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset, -$ctx->add( $data, ... ), $ctx->addfile( $io_handle ), $ctx->add_bits( -$data, $nbits ), $ctx->add_bits( $bitstring ), $ctx->digest, -$ctx->hexdigest, $ctx->b64digest +=item Managing Unknown Symbols -=item Digest speed +=item Tag Handling Utility Functions -=item SEE ALSO +=item Generating combined tags -=item AUTHOR +=item C<AUTOLOAD>ed Constants =back -=head2 Digest::MD5 - Perl interface to the MD5 Algorithm +=back + +=head2 Exporter::Heavy - Exporter guts =over 4 @@ -15139,73 +17380,90 @@ $ctx->hexdigest, $ctx->b64digest =item DESCRIPTION -=item FUNCTIONS +=back -md5($data,...), md5_hex($data,...), md5_base64($data,...) +=head2 ExtUtils::CBuilder - Compile and link C code for Perl modules + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION =item METHODS -$md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...), -$md5->addfile($io_handle), $md5->add_bits($data, $nbits), -$md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest +new, have_compiler, compile, C<object_file>, C<include_dirs>, +C<extra_compiler_flags>, link, lib_file, module_name, extra_linker_flags, +link_executable, exe_file, object_file, lib_file, exe_file, prelink, +need_prelink, extra_link_args_after_prelink -=item EXAMPLES +=item TO DO -=item SEE ALSO +=item HISTORY + +=item AUTHOR =item COPYRIGHT -=item AUTHORS +=item SEE ALSO =back -=head2 Digest::SHA - Perl extension for SHA-1/224/256/384/512 +=head2 ExtUtils::CBuilder::Platform::Windows - Builder class for Windows +platforms =over 4 -=item SYNOPSIS (SHA) +=item DESCRIPTION -=item SYNOPSIS (HMAC-SHA) +=item AUTHOR -=item ABSTRACT +=item SEE ALSO + +=back + +=head2 ExtUtils::Command - utilities to replace common UNIX commands in +Makefiles etc. + +=over 4 + +=item SYNOPSIS =item DESCRIPTION -=item NIST STATEMENT ON SHA-1 +=back -=item EXPORT +cat -=item EXPORTABLE FUNCTIONS +eqtime -B<sha1($data, ...)>, B<sha224($data, ...)>, B<sha256($data, ...)>, -B<sha384($data, ...)>, B<sha512($data, ...)>, B<sha1_hex($data, ...)>, -B<sha224_hex($data, ...)>, B<sha256_hex($data, ...)>, B<sha384_hex($data, -...)>, B<sha512_hex($data, ...)>, B<sha1_base64($data, ...)>, -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<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)>, B<hmac_sha1_hex($data, $key)>, -B<hmac_sha224_hex($data, $key)>, B<hmac_sha256_hex($data, $key)>, -B<hmac_sha384_hex($data, $key)>, B<hmac_sha512_hex($data, $key)>, -B<hmac_sha1_base64($data, $key)>, B<hmac_sha224_base64($data, $key)>, -B<hmac_sha256_base64($data, $key)>, B<hmac_sha384_base64($data, $key)>, -B<hmac_sha512_base64($data, $key)> +rm_rf -=item SEE ALSO +rm_f -=item AUTHOR +touch -=item ACKNOWLEDGMENTS +mv -=item COPYRIGHT AND LICENSE +cp + +chmod + +mkpath + +test_f + +dos2unix + +=over 4 + +=item SEE ALSO + +=item AUTHOR =back -=head2 Digest::base - Digest base class +=head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles =over 4 @@ -15213,11 +17471,19 @@ B<hmac_sha512_base64($data, $key)> =item DESCRIPTION -=item SEE ALSO +B<test_harness> =back -=head2 Digest::file - Calculate digests of files +B<pod2man> + +B<warn_if_old_packlist> + +B<perllocal_install> + +B<uninstall> + +=head2 ExtUtils::Constant - generate XS code to import C header constants =over 4 @@ -15225,15 +17491,32 @@ B<hmac_sha512_base64($data, $key)> =item DESCRIPTION -digest_file( $file, $algorithm, [$arg,...] ), digest_file_hex( $file, -$algorithm, [$arg,...] ), digest_file_base64( $file, $algorithm, [$arg,...] -) +=item USAGE -=item SEE ALSO +IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF + +=item FUNCTIONS =back -=head2 DirHandle - supply object methods for directory handles +constant_types + +XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME + +autoload PACKAGE, VERSION, AUTOLOADER + +WriteMakefileSnippet + +WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE, +BREAKOUT_AT, NAMES, C_FH, C_FILE, XS_FH, XS_FILE, SUBNAME, C_SUBNAME + +=over 4 + +=item AUTHOR + +=back + +=head2 ExtUtils::Constant::Base - base class for ExtUtils::Constant objects =over 4 @@ -15241,11 +17524,40 @@ $algorithm, [$arg,...] ), digest_file_base64( $file, $algorithm, [$arg,...] =item DESCRIPTION -=item NOTES +=item USAGE =back -=head2 Dumpvalue - provides screen dump of Perl data. +header + +memEQ_clause args_hashref + +dump_names arg_hashref, ITEM.. + +assign arg_hashref, VALUE.. + +return_clause arg_hashref, ITEM + +switch_clause arg_hashref, NAMELEN, ITEMHASH, ITEM.. + +params WHAT + +dogfood arg_hashref, ITEM.. + +normalise_items args, default_type, seen_types, seen_items, ITEM.. + +C_constant arg_hashref, ITEM.., name, type, value, macro, default, pre, +post, def_pre, def_post, utf8, weight + +=over 4 + +=item BUGS + +=item AUTHOR + +=back + +=head2 ExtUtils::Constant::Utils - helper functions for ExtUtils::Constant =over 4 @@ -15253,25 +17565,22 @@ $algorithm, [$arg,...] ), digest_file_base64( $file, $algorithm, [$arg,...] =item DESCRIPTION -=over 4 +=item USAGE -=item Creation +C_stringify NAME -C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>, -C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>, -C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit, -stopDbSignal +=back -=item Methods +perl_stringify NAME -dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl, -compactDump, veryCompact, set, get +=over 4 -=back +=item AUTHOR =back -=head2 DynaLoader - Dynamically load C libraries into Perl code +=head2 ExtUtils::Constant::XS, ExtUtils::Constant::Base - base class for +ExtUtils::Constant objects =over 4 @@ -15279,135 +17588,128 @@ compactDump, veryCompact, set, get =item DESCRIPTION -@dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs, -@dl_modules, @dl_shared_objects, dl_error(), $dl_debug, dl_findfile(), -dl_expandspec(), dl_load_file(), dl_unload_file(), dl_load_flags(), -dl_find_symbol(), dl_find_symbol_anywhere(), dl_undef_symbols(), -dl_install_xsub(), bootstrap() +=item BUGS =item AUTHOR =back -=head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into -Perl code +=head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications =over 4 -=item VERSION - =item SYNOPSIS =item DESCRIPTION -=over 4 +=item @EXPORT -=item Migration from C<DynaLoader> +=item FUNCTIONS -=item Backward compatible boilerplate +xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(), +ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules) + +=item EXAMPLES + +=item SEE ALSO + +=item AUTHOR =back -=item Order of initialization: early load() +=head2 ExtUtils::Install - install files from here to there =over 4 -=item The most hairy case +=item SYNOPSIS -=back +=item DESCRIPTION -=item DIAGNOSTICS +_chmod($$;$), _warnonce(@), _choke(@) -Can't find '%s' symbol in %s, Can't load '%s' for module %s: %s, Undefined -symbols present after loading %s: %s, XSLoader::load('Your::Module', -$Your::Module::VERSION) +=back -=item LIMITATIONS +_move_file_at_boot( $file, $target, $moan ) -=item BUGS +_unlink_or_rename( $file, $tryhard, $installing ) -=item SEE ALSO +=over 4 -=item AUTHORS +=item Functions -=item COPYRIGHT +B<install> =back -=head2 Encode - character encodings - -=over 4 - -=item SYNOPSIS +_get_install_skip -=over 4 +_have_write_access -=item Table of Contents +_can_write_dir(C<$dir>) -=back +_mkpath($dir,$show,$mode,$verbose,$fake) -=item DESCRIPTION +_copy($from,$to,$verbose,$fake) -=over 4 +_chdir($from) -=item TERMINOLOGY +_do_cleanup -=back +install_rooted_file( $file ), install_rooted_dir( $dir ) -=item PERL ENCODING API +forceunlink( $file, $tryhard ) -$octets = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING, -$octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [, -CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [, -CHECK]); +directory_not_empty( $dir ) -=over 4 +B<install_default> I<DISCOURAGED> -=item Listing available encodings +B<uninstall> -=item Defining Aliases +inc_uninstall($filepath,$libdir,$verbose,$nonono,$ignore) -=back +run_filter($cmd,$src,$dest) -=item Encoding via PerlIO +B<pm_to_blib> -=item Handling Malformed Data +_autosplit -B<NOTE:> Not all encoding support this feature, I<CHECK> = -Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1), I<CHECK> = -Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode (I<CHECK> = -Encode::FB_PERLQQ), HTML charref mode (I<CHECK> = Encode::FB_HTMLCREF), XML -charref mode (I<CHECK> = Encode::FB_XMLCREF), The bitmask +_invokant =over 4 -=item coderef for CHECK +=item ENVIRONMENT -=back +B<PERL_INSTALL_ROOT>, B<EU_INSTALL_IGNORE_SKIP>, +B<EU_INSTALL_SITE_SKIPFILE> -=item Defining Encodings +=item AUTHOR -=item The UTF-8 flag +=item LICENSE -Goal #1:, Goal #2:, Goal #3:, Goal #4: +=back + +=head2 ExtUtils::Installed - Inventory management of installed modules =over 4 -=item Messing with Perl's Internals +=item SYNOPSIS -is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING) +=item DESCRIPTION -=back +=item USAGE -=item UTF-8 vs. utf8 +=item FUNCTIONS -=item SEE ALSO +new(), modules(), files(), directories(), directory_tree(), validate(), +packlist(), version() -=item MAINTAINER +=item EXAMPLE + +=item AUTHOR =back -=head2 Encode::Alias - alias definitions to encodings +=head2 ExtUtils::Liblist - determine libraries to use and how to use them =over 4 @@ -15415,36 +17717,34 @@ is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING) =item DESCRIPTION -As a simple string, As a qr// compiled regular expression, e.g.:, As a code -reference, e.g.: +For static extensions, For dynamic extensions at build/link time, For +dynamic extensions at load time =over 4 -=item Alias overloading +=item EXTRALIBS -=back +=item LDLOADLIBS and LD_RUN_PATH -=item SEE ALSO +=item BSLOADLIBS =back -=head2 Encode::Byte - Single Byte Encodings +=item PORTABILITY =over 4 -=item SYNOPSIS +=item VMS implementation -=item ABSTRACT +=item Win32 implementation -=item DESCRIPTION +=back =item SEE ALSO =back -=head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_* - -=head2 Encode::CN - China-based Chinese Encodings +=head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass =over 4 @@ -15452,33 +17752,33 @@ reference, e.g.: =item DESCRIPTION -=item NOTES +=back -=item BUGS +=head2 ExtUtils::MM_AIX - AIX specific subclass of ExtUtils::MM_Unix -=item SEE ALSO +=over 4 -=back +=item SYNOPSIS -=head2 Encode::CN::HZ -- internally used by Encode::CN +=item DESCRIPTION -=head2 Encode::Config -- internally used by Encode +=over 4 -=head2 Encode::EBCDIC - EBCDIC Encodings +=item Overridden methods -=over 4 +=back -=item SYNOPSIS +=back -=item ABSTRACT +=over 4 -=item DESCRIPTION +=item AUTHOR =item SEE ALSO =back -=head2 Encode::Encoding - Encode Implementation Base Class +=head2 ExtUtils::MM_Any - Platform-agnostic MM methods =over 4 @@ -15486,81 +17786,69 @@ reference, e.g.: =item DESCRIPTION +=item METHODS + =over 4 -=item Methods you should implement +=item Cross-platform helper methods --E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]), --E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check]) +=back -=item Other methods defined in Encode::Encodings +=back --E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(), --E<gt>needs_lines() +=over 4 -=item Example: Encode::ROT13 +=item Targets =back -=item Why the heck Encode API is different? - =over 4 -=item Compiled Encodings +=item Init methods =back -=item SEE ALSO +=over 4 -Scheme 1, Scheme 2, Other Schemes +=item Tools =back -=head2 Encode::Guess -- Guesses encoding from data - =over 4 -=item SYNOPSIS +=item File::Spec wrappers -=item ABSTRACT +=back -=item DESCRIPTION +=over 4 -Encode::Guess->set_suspects, Encode::Guess->add_suspects, -Encode::decode("Guess" ...), Encode::Guess->guess($data), -guess_encoding($data, [, I<list of suspects>]) +=item Misc -=item CAVEATS +=back -=item TO DO +=over 4 -=item SEE ALSO +=item AUTHOR =back -=head2 Encode::JP - Japanese Encodings +=head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in +ExtUtils::MakeMaker =over 4 =item SYNOPSIS -=item ABSTRACT - =item DESCRIPTION -=item Note on ISO-2022-JP(-1)? - -=item BUGS - -=item SEE ALSO - =back -=head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP* +os_flavor -=head2 Encode::JP::JIS7 -- internally used by Encode::JP +init_linker -=head2 Encode::KR - Korean Encodings +=head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in +ExtUtils::MakeMaker =over 4 @@ -15568,149 +17856,119 @@ guess_encoding($data, [, I<list of suspects>]) =item DESCRIPTION -=item BUGS - -=item SEE ALSO +os_flavor =back -=head2 Encode::KR::2022_KR -- internally used by Encode::KR +cflags -=head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding +replace_manpage_separator + +init_linker + +=head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix =over 4 =item SYNOPSIS -=item ABSTRACT - =item DESCRIPTION -=item BUGS - -=item SEE ALSO - -=back - -=head2 Encode::PerlIO -- a detailed document on Encode and PerlIO - =over 4 -=item Overview - -=item How does it work? - -=item Line Buffering - -=over 4 +=item Overridden methods -=item How can I tell whether my encoding fully supports PerlIO ? +os_flavor =back -=item SEE ALSO - =back -=head2 Encode::Supported -- Encodings supported by Encode +B<replace_manpage_separator> =over 4 -=item DESCRIPTION - -=over 4 +=item AUTHOR -=item Encoding Names +=item SEE ALSO =back -=item Supported Encodings +=head2 ExtUtils::MM_MacOS - once produced Makefiles for MacOS Classic =over 4 -=item Built-in Encodings - -=item Encode::Unicode -- other Unicode encodings +=item SYNOPSIS -=item Encode::Byte -- Extended ASCII +=item DESCRIPTION -ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for -the Cyrillic world, gsm0338 - Hentai Latin 1 +=back -=item CJK: Chinese, Japanese, Korean (Multibyte) +=head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in +ExtUtils::MakeMaker -Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea, -Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN, -Encode::JIS2K -- JIS X 0213 encodings via CPAN +=over 4 -=item Miscellaneous encodings +=item SYNOPSIS -Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess +=item DESCRIPTION =back -=item Unsupported encodings +os_flavor - ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings, -Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran -System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS, -Various Mac encodings, (Mac) Indic encodings +init_platform, platform_constants -=item Encoding vs. Charset -- terminology +const_cccmd -=item Encoding Classification (by Anton Tagunov and Dan Kogai) +static_lib + +dynamic_lib + +=head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in +ExtUtils::MakeMaker =over 4 -=item Microsoft-related naming mess +=item SYNOPSIS -KS_C_5601-1987, GB2312, Big5, Shift_JIS +=item DESCRIPTION -=back +=item METHODS -=item Glossary +init_dist -character repertoire, coded character set (CCS), character encoding scheme -(CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF, -UTF-16 +=back -=item See Also +init_linker -=item References +os_flavor -ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO, -RFC, UC, Unicode Glossary +=head2 ExtUtils::MM_QNX - QNX specific subclass of ExtUtils::MM_Unix =over 4 -=item Other Notable Sites +=item SYNOPSIS -czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org: -"Introduction to i18n" +=item DESCRIPTION -=item Offline sources +=over 4 -C<CJKV Information Processing> by Ken Lunde +=item Overridden methods =back =back -=head2 Encode::Symbol - Symbol Encodings - =over 4 -=item SYNOPSIS - -=item ABSTRACT - -=item DESCRIPTION +=item AUTHOR =item SEE ALSO =back -=head2 Encode::TW - Taiwan-based Chinese Encodings +=head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix =over 4 @@ -15718,424 +17976,377 @@ C<CJKV Information Processing> by Ken Lunde =item DESCRIPTION -=item NOTES +=over 4 -=item BUGS +=item Overridden methods -=item SEE ALSO +os_flavor =back -=head2 Encode::Unicode -- Various Unicode Transformation Formats +=back + +B<replace_manpage_separator> =over 4 -=item SYNOPSIS +=item AUTHOR -=item ABSTRACT +=item SEE ALSO -L<http://www.unicode.org/glossary/> says:, Quick Reference +=back -=item Size, Endianness, and BOM +=head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker =over 4 -=item by size +=item SYNOPSIS -=item by endianness +=item DESCRIPTION -BOM as integer when fetched in network byte order +=item METHODS =back -=item Surrogate Pairs +=over 4 -=item Error Checking +=item Methods -=item SEE ALSO +os_flavor =back -=head2 Encode::Unicode::UTF7 -- UTF-7 encoding +c_o (o) -=over 4 +cflags (o) -=item SYNOPSIS +const_cccmd (o) -=item ABSTRACT +const_config (o) -=item In Practice +const_loadlibs (o) -=item SEE ALSO +constants (o) -=back +depend (o) -=head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to -encodings +init_DEST -=over 4 +init_dist -=item SYNOPSIS +dist (o) -=item DESCRIPTION +dist_basics (o) -As a simple string, As a qr// compiled regular expression, e.g.:, As a code -reference, e.g.: +dist_ci (o) -=over 4 +dist_core (o) -=item Alias overloading +B<dist_target> -=back +B<tardist_target> -=item SEE ALSO +B<zipdist_target> -=back +B<tarfile_target> -=head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm -- -Internally used by Encode::??::ISO_2022_* +zipfile_target -=head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by -Encode::CN +uutardist_target -=head2 Encode::lib::Encode::Config, Encode::Config -- internally used by -Encode +shdist_target -=head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode -Implementation Base Class +dlsyms (o) -=over 4 +dynamic_bs (o) -=item SYNOPSIS +dynamic_lib (o) -=item DESCRIPTION +exescan -=over 4 +extliblist -=item Methods you should implement +find_perl --E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]), --E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check]) +fixin -=item Other methods defined in Encode::Encodings +force (o) --E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(), --E<gt>needs_lines() +guess_name -=item Example: Encode::ROT13 +has_link_code -=back +init_dirscan -=item Why the heck Encode API is different? +init_MANPODS -=over 4 +init_MAN1PODS -=item Compiled Encodings +init_MAN3PODS -=back +init_PM -=item SEE ALSO +init_DIRFILESEP -Scheme 1, Scheme 2, Other Schemes +init_main -=back +init_others -=head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from -data +init_linker -=over 4 +init_lib2arch -=item SYNOPSIS +init_PERL -=item ABSTRACT +init_platform, platform_constants -=item DESCRIPTION +init_PERM -Encode::Guess->set_suspects, Encode::Guess->add_suspects, -Encode::decode("Guess" ...), Encode::Guess->guess($data), -guess_encoding($data, [, I<list of suspects>]) +init_xs -=item CAVEATS +install (o) -=item TO DO +installbin (o) -=item SEE ALSO +linkext (o) -=back +lsdir -=head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by -Encode::JP::2022_JP* +macro (o) -=head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used -by Encode::JP +makeaperl (o) -=head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally -used by Encode::KR +makefile (o) -=head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B' -and 'Q' header encoding +maybe_command -=over 4 +needs_linking (o) -=item SYNOPSIS +nicetext -=item ABSTRACT +parse_abstract -=item DESCRIPTION +parse_version -=item BUGS +pasthru (o) -=item SEE ALSO +perl_script -=back +perldepend (o) -=head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document -on Encode and PerlIO +perm_rw (o) -=over 4 +perm_rwx (o) -=item Overview +pm_to_blib -=item How does it work? +post_constants (o) -=item Line Buffering +post_initialize (o) -=over 4 +postamble (o) -=item How can I tell whether my encoding fully supports PerlIO ? +ppd -=back +prefixify -=item SEE ALSO +processPL (o) -=back +quote_paren + +replace_manpage_separator -=head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings -supported by Encode +cd -=over 4 +oneliner -=item DESCRIPTION +quote_literal -=over 4 +escape_newlines -=item Encoding Names +max_exec_len -=back +static (o) -=item Supported Encodings +static_lib (o) -=over 4 +staticmake (o) -=item Built-in Encodings +subdir_x (o) -=item Encode::Unicode -- other Unicode encodings +subdirs (o) -=item Encode::Byte -- Extended ASCII +test (o) -ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for -the Cyrillic world, gsm0338 - Hentai Latin 1 +test_via_harness (override) -=item CJK: Chinese, Japanese, Korean (Multibyte) +test_via_script (override) -Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea, -Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN, -Encode::JIS2K -- JIS X 0213 encodings via CPAN +tools_other (o) -=item Miscellaneous encodings +tool_xsubpp (o) -Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess +all_target -=back +top_targets (o) -=item Unsupported encodings +writedoc - ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings, -Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran -System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS, -Various Mac encodings, (Mac) Indic encodings +xs_c (o) -=item Encoding vs. Charset -- terminology +xs_cpp (o) -=item Encoding Classification (by Anton Tagunov and Dan Kogai) +xs_o (o) =over 4 -=item Microsoft-related naming mess - -KS_C_5601-1987, GB2312, Big5, Shift_JIS +=item SEE ALSO =back -=item Glossary - -character repertoire, coded character set (CCS), character encoding scheme -(CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF, -UTF-16 +=head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in +ExtUtils::MakeMaker -=item See Also +=over 4 -=item References +=item SYNOPSIS -ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO, -RFC, UC, Unicode Glossary +=item DESCRIPTION =over 4 -=item Other Notable Sites - -czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org: -"Introduction to i18n" - -=item Offline sources +=item Methods always loaded -C<CJKV Information Processing> by Ken Lunde +wraplist =back =back -=head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7 -encoding - =over 4 -=item SYNOPSIS - -=item ABSTRACT - -=item In Practice +=item Methods -=item SEE ALSO +guess_name (override) =back -=head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder - -=over 4 +find_perl (override) -=item SYNOPSIS +maybe_command (override) -=item ABSTRACT +pasthru (override) -=item Description +pm_to_blib (override) -=over 4 +perl_script (override) -=item Predefined Methods +replace_manpage_separator -$e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(), -$e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]), -$e-E<gt>bytes([$encoding]) +init_DEST -=item Example: base64 transcoder +init_DIRFILESEP -=item Operator Overloading +init_main (override) -=back +init_others (override) -=item SEE ALSO +init_platform (override) -=back +platform_constants -=head2 Encodencoding, encoding - allows you to write your script in -non-ascii or non-utf8 +init_VERSION (override) -=over 4 +constants (override) -=item SYNOPSIS +special_targets -=item ABSTRACT +cflags (override) -=over 4 +const_cccmd (override) -=item Literal Conversions +tools_other (override) -=item PerlIO layers for C<STD(IN|OUT)> +init_dist (override) -=item Implicit upgrading for byte strings +c_o (override) -=back +xs_c (override) -=item FEATURES THAT REQUIRE 5.8.1 +xs_o (override) -"NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle +dlsyms (override) -=item USAGE +dynamic_lib (override) -use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt> -I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding; +static_lib (override) -=item The Filter Option +extra_clean_files -=over 4 +zipfile_target, tarfile_target, shdist_target -=item Filter-related changes at Encode version 1.87 +install (override) -=back +perldepend (override) -=item CAVEATS +makeaperl (override) -=over 4 +nicetext (override) -=item NOT SCOPED +prefixify (override) -=item DO NOT MIX MULTIPLE ENCODINGS +cd -=item tr/// with ranges +oneliner -Legend of characters above +B<echo> -=back +quote_literal -=item EXAMPLE - Greekperl +escape_newlines -=item KNOWN PROBLEMS +max_exec_len -literals in regex that are longer than 127 bytes, EBCDIC, format +init_linker -=over 4 +eliminate_macros -=item The Logic of :locale +fixpath -=back +os_flavor -=item HISTORY +=over 4 -=item SEE ALSO +=item AUTHOR =back -=head2 Encoder, Encode::Encoder -- Object Oriented Encoder +=head2 ExtUtils::MM_VOS - VOS specific subclass of ExtUtils::MM_Unix =over 4 =item SYNOPSIS -=item ABSTRACT - -=item Description +=item DESCRIPTION =over 4 -=item Predefined Methods +=item Overridden methods -$e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(), -$e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]), -$e-E<gt>bytes([$encoding]) +=back -=item Example: base64 transcoder +=back -=item Operator Overloading +=over 4 -=back +=item AUTHOR =item SEE ALSO =back -=head2 English - use nice English (or awk) names for ugly punctuation -variables +=head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in +ExtUtils::MakeMaker =over 4 @@ -16143,86 +18354,83 @@ variables =item DESCRIPTION -=item PERFORMANCE - =back -=head2 Env - perl module that imports environment variables as scalars or -arrays - =over 4 -=item SYNOPSIS +=item Overridden methods -=item DESCRIPTION +B<dlsyms> -=item LIMITATIONS +=back -=item AUTHOR +replace_manpage_separator -=back +B<maybe_command> -=head2 Errno - System errno constants +B<init_DIRFILESEP> -=over 4 +B<init_others> -=item SYNOPSIS +init_platform, platform_constants -=item DESCRIPTION +special_targets -=item CAVEATS +static_lib -=item AUTHOR +dynamic_lib -=item COPYRIGHT +extra_clean_files -=back +init_linker -=head2 Exporter - Implements default import method for modules +perl_script -=over 4 +xs_o -=item SYNOPSIS +pasthru -=item DESCRIPTION +oneliner -=over 4 +cd -=item How to Export +max_exec_len -=item Selecting What To Export +os_flavor -=item How to Import +=head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X -C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);> +=over 4 -=back +=item SYNOPSIS -=item Advanced features +=item DESCRIPTION =over 4 -=item Specialised Import Lists +=item Overridden methods -=item Exporting without using Exporter's import method +xs_c -=item Exporting without inheriting from Exporter +=back -=item Module Version Checking +=back -=item Managing Unknown Symbols +xs_cpp -=item Tag Handling Utility Functions +xs_o -=item Generating combined tags +max_exec_len -=item C<AUTOLOAD>ed Constants +os_flavor -=back +=over 4 + +=item AUTHOR =back -=head2 Exporter::Heavy - Exporter guts +=head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization =over 4 @@ -16232,7 +18440,7 @@ C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);> =back -=head2 ExtUtils::CBuilder - Compile and link C code for Perl modules +=head2 ExtUtils::MakeMaker - Create a module Makefile =over 4 @@ -16240,80 +18448,92 @@ C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);> =item DESCRIPTION -=item METHODS - -new, have_compiler, compile, C<object_file>, C<include_dirs>, -C<extra_compiler_flags>, link, lib_file, module_name, extra_linker_flags, -link_executable, exe_file, object_file, lib_file, exe_file, prelink, -need_prelink, extra_link_args_after_prelink - -=item TO DO +=over 4 -=item HISTORY +=item How To Write A Makefile.PL -=item AUTHOR +=item Default Makefile Behaviour -=item COPYRIGHT +=item make test -=item SEE ALSO +=item make testdb -=back +=item make install -=head2 ExtUtils::CBuilder::Platform::Windows - Builder class for Windows -platforms +=item PREFIX and LIB attribute -=over 4 +=item AFS users -=item DESCRIPTION +=item Static Linking of a new Perl Binary -=item AUTHOR +=item Determination of Perl Library and Installation Locations -=item SEE ALSO +=item Which architecture dependent directory? -=back +=item Using Attributes and Parameters -=head2 ExtUtils::Command - utilities to replace common UNIX commands in -Makefiles etc. +ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG, +CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS, +EXCLUDE_EXT, EXE_FILES, EXTRA_META, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN, +FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, +INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, +INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB, +INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLSITESCRIPT, +INSTALLVENDORARCH, INSTALLVENDORBIN, INSTALLVENDORLIB, +INSTALLVENDORMAN1DIR, INSTALLVENDORMAN3DIR, INSTALLVENDORSCRIPT, +INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT, +LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS, LICENSE, LINKTYPE, MAKE, +MAKEAPERL, MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME, +NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT, OPTIMIZE, PERL, +PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERLPREFIX, +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, SIGN, +SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION, VERSION_FROM, VERSION_SYM, +XS, XSOPT, XSPROTOARG, XS_VERSION -=over 4 +=item Additional lowercase attributes -=item SYNOPSIS +clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean, +test, tool_autosplit -=item DESCRIPTION +=item Overriding MakeMaker Methods -=back +=item The End Of Cargo Cult Programming -cat +C<< MAN3PODS => ' ' >> -eqtime +=item Hintsfile support -rm_rf +=item Distribution Support -rm_f + make distcheck, make skipcheck, make distclean, make manifest, + make distdir, make disttest, make tardist, make dist, make +uutardist, make shdist, make zipdist, make ci -touch +=item Module Meta-Data -mv +=item Disabling an extension -cp +=item Other Handy Functions -chmod +prompt -mkpath +=back -test_f +=item ENVIRONMENT -dos2unix +PERL_MM_OPT, PERL_MM_USE_DEFAULT, PERL_CORE -=over 4 +=item SEE ALSO -=item SEE ALSO +=item AUTHORS -=item AUTHOR +=item LICENSE =back -=head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles +=head2 ExtUtils::MakeMaker::Config - Wrapper around Config.pm =over 4 @@ -16321,52 +18541,50 @@ dos2unix =item DESCRIPTION -B<test_harness> - =back -B<pod2man> - -B<warn_if_old_packlist> - -B<perllocal_install> - -B<uninstall> - -=head2 ExtUtils::Constant - generate XS code to import C header constants +=head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About +MakeMaker =over 4 -=item SYNOPSIS - =item DESCRIPTION -=item USAGE +=over 4 -IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF +=item Module Installation -=item FUNCTIONS +How do I keep from installing man pages?, How do I use a module without +installing it? -=back +=item Philosophy and History -constant_types +Why not just use <insert other build config tool here>?, What is +Module::Build and how does it relate to MakeMaker?, pure perl. no make, no +shell commands, easier to customize, cleaner internals, less cruft -XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME +=item Module Writing -autoload PACKAGE, VERSION, AUTOLOADER +How do I keep my $VERSION up to date without resetting it manually?, What's +this F<META.yml> thing and how did it get in my F<MANIFEST>?! -WriteMakefileSnippet +=item XS -WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE, -BREAKOUT_AT, NAMES, C_FH, C_FILE, XS_FH, XS_FILE, SUBNAME, C_SUBNAME +How to I prevent "object version X.XX does not match bootstrap parameter +Y.YY" errors?, How do I make two or more XS files coexist in the same +directory? -=over 4 +=back + +=item PATCHING =item AUTHOR +=item SEE ALSO + =back -=head2 ExtUtils::Constant::Base - base class for ExtUtils::Constant objects +=head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker =over 4 @@ -16374,40 +18592,42 @@ BREAKOUT_AT, NAMES, C_FH, C_FILE, XS_FH, XS_FILE, SUBNAME, C_SUBNAME =item DESCRIPTION -=item USAGE +=over 4 -=back +=item The Mantra -header +=item The Layout -memEQ_clause args_hashref +Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP, +bin/ -dump_names arg_hashref, ITEM.. +=back -assign arg_hashref, VALUE.. +=item SEE ALSO -return_clause arg_hashref, ITEM +=back -switch_clause arg_hashref, NAMELEN, ITEMHASH, ITEM.. +=head2 ExtUtils::MakeMaker::bytes - Version-agnostic bytes.pm -params WHAT +=over 4 -dogfood arg_hashref, ITEM.. +=item SYNOPSIS -normalise_items args, default_type, seen_types, seen_items, ITEM.. +=item DESCRIPTION -C_constant arg_hashref, ITEM.., name, type, value, macro, default, pre, -post, def_pre, def_post, utf8, weight +=back + +=head2 ExtUtils::MakeMaker::vmsish - Platform-agnostic vmsish.pm =over 4 -=item BUGS +=item SYNOPSIS -=item AUTHOR +=item DESCRIPTION =back -=head2 ExtUtils::Constant::Utils - helper functions for ExtUtils::Constant +=head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file =over 4 @@ -16415,51 +18635,54 @@ post, def_pre, def_post, utf8, weight =item DESCRIPTION -=item USAGE +=over 4 -C_stringify NAME +=item Functions + +mkmanifest =back -perl_stringify NAME +=back -=over 4 +manifind -=item AUTHOR +manicheck -=back +filecheck -=head2 ExtUtils::Constant::XS, ExtUtils::Constant::Base - base class for -ExtUtils::Constant objects +fullcheck -=over 4 +skipcheck -=item SYNOPSIS +maniread -=item DESCRIPTION +manicopy -=item BUGS +maniadd -=item AUTHOR +=over 4 -=back +=item MANIFEST -=head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications +=item MANIFEST.SKIP -=over 4 +=item EXPORT_OK -=item SYNOPSIS +=item GLOBAL VARIABLES -=item DESCRIPTION +=back -=item @EXPORT +=over 4 -=item FUNCTIONS +=item DIAGNOSTICS -xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(), -ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules) +C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>, +C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file> -=item EXAMPLES +=item ENVIRONMENT + +B<PERL_MM_MANIFEST_DEBUG> =item SEE ALSO @@ -16467,7 +18690,7 @@ ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules) =back -=head2 ExtUtils::Install - install files from here to there +=head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c =over 4 @@ -16475,37 +18698,42 @@ ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules) =item DESCRIPTION -=over 4 - -=item Functions - -B<install> +=item SEE ALSO =back -=back +=head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader + +=over 4 -B<install_default> I<DISCOURAGED> +=item SYNOPSIS -B<uninstall> +=item DESCRIPTION -B<pm_to_blib> +=back -_autosplit +=head2 ExtUtils::Mksymlists - write linker options files for dynamic +extension =over 4 -=item ENVIRONMENT +=item SYNOPSIS + +=item DESCRIPTION -B<PERL_INSTALL_ROOT> +DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME =item AUTHOR -=item LICENSE +=item REVISION + +mkfh() =back -=head2 ExtUtils::Installed - Inventory management of installed modules +__find_relocations + +=head2 ExtUtils::Packlist - manage .packlist files =over 4 @@ -16517,8 +18745,7 @@ B<PERL_INSTALL_ROOT> =item FUNCTIONS -new(), modules(), files(), directories(), directory_tree(), validate(), -packlist(), version() +new(), read(), write(), validate(), packlist_file() =item EXAMPLE @@ -16526,42 +18753,29 @@ packlist(), version() =back -=head2 ExtUtils::Liblist - determine libraries to use and how to use them +=head2 ExtUtils::ParseXS - converts Perl XS code into C code =over 4 =item SYNOPSIS -=item DESCRIPTION - -For static extensions, For dynamic extensions at build/link time, For -dynamic extensions at load time - -=over 4 - -=item EXTRALIBS - -=item LDLOADLIBS and LD_RUN_PATH - -=item BSLOADLIBS - -=back - -=item PORTABILITY +=item EXPORT -=over 4 +=item FUNCTIONS -=item VMS implementation +process_xs(), B<C++>, B<hiertype>, B<except>, B<typemap>, B<prototypes>, +B<versioncheck>, B<linenumbers>, B<optimize>, B<inout>, B<argtypes>, B<s>, +errors() -=item Win32 implementation +=item AUTHOR -=back +=item COPYRIGHT =item SEE ALSO =back -=head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass +=head2 ExtUtils::testlib - add blib/* directories to @INC =over 4 @@ -16571,7 +18785,7 @@ dynamic extensions at load time =back -=head2 ExtUtils::MM_AIX - AIX specific subclass of ExtUtils::MM_Unix +=head2 Fatal - replace functions with equivalents which succeed or die =over 4 @@ -16579,23 +18793,13 @@ dynamic extensions at load time =item DESCRIPTION -=over 4 - -=item Overridden methods - -=back - -=back - -=over 4 +=item BUGS =item AUTHOR -=item SEE ALSO - =back -=head2 ExtUtils::MM_Any - Platform-agnostic MM methods +=head2 Fcntl - load the C Fcntl.h defines =over 4 @@ -16603,54 +18807,52 @@ dynamic extensions at load time =item DESCRIPTION -=item METHODS - -=over 4 +=item NOTE -=item Cross-platform helper methods +=item EXPORTED SYMBOLS =back -=back +=head2 File::Basename - Parse file paths into directory, filename and +suffix. =over 4 -=item Targets - -=back - -=over 4 +=item SYNOPSIS -=item Init methods +=item DESCRIPTION =back -=over 4 +C<fileparse> X<fileparse> -=item Tools +C<basename> X<basename> X<filename> -=back +C<dirname> X<dirname> + +C<fileparse_set_fstype> X<filesystem> =over 4 -=item File::Spec wrappers +=item SEE ALSO =back -=over 4 +=head2 File::CheckTree, validate - run many filetest checks on a tree -=item Misc +=over 4 -=back +=item SYNOPSIS -=over 4 +=item DESCRIPTION =item AUTHOR +=item HISTORY + =back -=head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in -ExtUtils::MakeMaker +=head2 File::Compare - Compare files or filehandles =over 4 @@ -16658,14 +18860,13 @@ ExtUtils::MakeMaker =item DESCRIPTION -=back +=item RETURN -os_flavor +=item AUTHOR -init_linker +=back -=head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in -ExtUtils::MakeMaker +=head2 File::Copy - Copy files or filehandles =over 4 @@ -16673,17 +18874,18 @@ ExtUtils::MakeMaker =item DESCRIPTION -os_flavor +copy X<copy> X<cp>, move X<move> X<mv> X<rename>, syscopy X<syscopy>, +rmscopy($from,$to[,$date_flag]) X<rmscopy> -=back +=item RETURN -cflags +=item NOTES -replace_manpage_separator +=item AUTHOR -init_linker +=back -=head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix +=head2 File::DosGlob - DOS like globbing and then some =over 4 @@ -16691,27 +18893,21 @@ init_linker =item DESCRIPTION -=over 4 - -=item Overridden methods - -os_flavor - -=back - -=back +=item NOTES -B<replace_manpage_separator> +=item EXPORTS (by request only) -=over 4 +=item BUGS =item AUTHOR +=item HISTORY + =item SEE ALSO =back -=head2 ExtUtils::MM_MacOS - once produced Makefiles for MacOS Classic +=head2 File::Find - Traverse a directory tree. =over 4 @@ -16719,49 +18915,39 @@ B<replace_manpage_separator> =item DESCRIPTION -=back - -=head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in -ExtUtils::MakeMaker +B<find>, B<finddepth> =over 4 -=item SYNOPSIS - -=item DESCRIPTION - -=back - -os_flavor +=item %options -init_platform, platform_constants +C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>, +C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>, +C<untaint>, C<untaint_pattern>, C<untaint_skip> -const_cccmd +=item The wanted function -static_lib +C<$File::Find::dir> is the current directory name,, C<$_> is the current +filename within that directory, C<$File::Find::name> is the complete +pathname to the file -dynamic_lib +=back -=head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in -ExtUtils::MakeMaker +=item WARNINGS -=over 4 +=item CAVEAT -=item SYNOPSIS +$dont_use_nlink, symlinks -=item DESCRIPTION +=item NOTES -=item METHODS +=item BUGS AND CAVEATS -init_dist +=item HISTORY =back -init_linker - -os_flavor - -=head2 ExtUtils::MM_QNX - QNX specific subclass of ExtUtils::MM_Unix +=head2 File::Glob - Perl extension for BSD glob routine =over 4 @@ -16771,21 +18957,29 @@ os_flavor =over 4 -=item Overridden methods +=item META CHARACTERS -=back +=item POSIX FLAGS + +C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>, +C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>, +C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT> =back -=over 4 +=item DIAGNOSTICS -=item AUTHOR +C<GLOB_NOSPACE>, C<GLOB_ABEND> + +=item NOTES =item SEE ALSO +=item AUTHOR + =back -=head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix +=head2 File::GlobMapper - Extend File Glob to Allow Input and Output Files =over 4 @@ -16793,27 +18987,47 @@ os_flavor =item DESCRIPTION +This code is a work in progress, There are known bugs, The interface +defined here is tentative, There are portability issues, Do not use in +production code, Consider yourself warned! + =over 4 -=item Overridden methods +=item Behind The Scenes -os_flavor +=item Limitations -=back +=item Input File Glob + +B<~>, B<~user>, B<.>, B<*>, B<?>, B<\>, B<[]>, B<{,}>, B<()> + +=item Output File Glob + +"*", #1 + +=item Returned Data =back -B<replace_manpage_separator> +=item EXAMPLES =over 4 -=item AUTHOR +=item A Rename script + +=item A few example globmaps + +=back =item SEE ALSO +=item AUTHOR + +=item COPYRIGHT AND LICENSE + =back -=head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker +=head2 File::Path - create or remove directory trees =over 4 @@ -16821,425 +19035,426 @@ B<replace_manpage_separator> =item DESCRIPTION -=item METHODS - -=back - -=over 4 - -=item Methods +=item DIAGNOSTICS -os_flavor +=item AUTHORS =back -c_o (o) +=head2 File::Spec - portably perform operations on file names -cflags (o) +=over 4 -const_cccmd (o) +=item SYNOPSIS -const_config (o) +=item DESCRIPTION -const_loadlibs (o) +=item METHODS -constants (o) +canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir, +no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath, +splitdir, catpath(), abs2rel, rel2abs() -depend (o) +=item SEE ALSO -init_DEST +=item AUTHOR -init_dist +=item COPYRIGHT -dist (o) +=back -dist_basics (o) +=head2 File::Spec::Cygwin - methods for Cygwin file specs -dist_ci (o) +=over 4 -dist_core (o) +=item SYNOPSIS -B<dist_target> +=item DESCRIPTION -B<tardist_target> +=back -B<zipdist_target> +canonpath -B<tarfile_target> +file_name_is_absolute -zipfile_target +tmpdir (override) -uutardist_target +=over 4 -shdist_target +=item COPYRIGHT -dlsyms (o) +=back -dynamic_bs (o) +=head2 File::Spec::Epoc - methods for Epoc file specs -dynamic_lib (o) +=over 4 -exescan +=item SYNOPSIS -extliblist +=item DESCRIPTION -find_perl +=back -fixin +canonpath() -force (o) +=over 4 -guess_name +=item AUTHOR -has_link_code +=item COPYRIGHT -init_dirscan +=item SEE ALSO -init_DIRFILESEP +=back -init_main +=head2 File::Spec::Functions - portably perform operations on file names -init_others +=over 4 -init_linker +=item SYNOPSIS -init_lib2arch +=item DESCRIPTION -init_PERL +=over 4 -init_platform, platform_constants +=item Exports -init_PERM +=back -init_xs +=item COPYRIGHT -install (o) +=item SEE ALSO -installbin (o) +=back -linkext (o) +=head2 File::Spec::Mac - File::Spec for Mac OS (Classic) -lsdir +=over 4 -macro (o) +=item SYNOPSIS -makeaperl (o) +=item DESCRIPTION -makefile (o) +=item METHODS -maybe_command +canonpath -needs_linking (o) +=back -nicetext +catdir() -parse_abstract +catfile -parse_version +curdir -pasthru (o) +devnull -perl_script +rootdir -perldepend (o) +tmpdir -perm_rw (o) +updir -perm_rwx (o) +file_name_is_absolute -pm_to_blib +path -post_constants (o) +splitpath -post_initialize (o) +splitdir -postamble (o) +catpath -ppd +abs2rel -prefixify +rel2abs -processPL (o) +=over 4 -quote_paren +=item AUTHORS -replace_manpage_separator +=item COPYRIGHT -cd +=item SEE ALSO -oneliner +=back -quote_literal +=head2 File::Spec::OS2 - methods for OS/2 file specs -escape_newlines +=over 4 -max_exec_len +=item SYNOPSIS -static (o) +=item DESCRIPTION -static_lib (o) +tmpdir, splitpath -staticmake (o) +=item COPYRIGHT -subdir_x (o) +=back -subdirs (o) +=head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec +modules -test (o) +=over 4 -test_via_harness (override) +=item SYNOPSIS -test_via_script (override) +=item DESCRIPTION -tools_other (o) +=item METHODS -tool_xsubpp (o) +canonpath() -all_target +=back -top_targets (o) +catdir() -writedoc +catfile -xs_c (o) +curdir -xs_cpp (o) +devnull -xs_o (o) +rootdir -=over 4 +tmpdir -=item SEE ALSO +updir -=back +no_upwards -=head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in -ExtUtils::MakeMaker +case_tolerant -=over 4 +file_name_is_absolute -=item SYNOPSIS +path -=item DESCRIPTION +join -=over 4 +splitpath -=item Methods always loaded +splitdir -wraplist +catpath() -=back +abs2rel -=back +rel2abs() =over 4 -=item Methods +=item COPYRIGHT -guess_name (override) +=item SEE ALSO =back -find_perl (override) - -maybe_command (override) - -pasthru (override) +=head2 File::Spec::VMS - methods for VMS file specs -pm_to_blib (override) +=over 4 -perl_script (override) +=item SYNOPSIS -replace_manpage_separator +=item DESCRIPTION -init_DEST +canonpath (override) -init_DIRFILESEP +=back -init_main (override) +catdir (override) -init_others (override) +catfile (override) -init_platform (override) +curdir (override) -platform_constants +devnull (override) -init_VERSION (override) +rootdir (override) -constants (override) +tmpdir (override) -special_targets +updir (override) -cflags (override) +case_tolerant (override) -const_cccmd (override) +path (override) -tools_other (override) +file_name_is_absolute (override) -init_dist (override) +splitpath (override) -c_o (override) +splitdir (override) -xs_c (override) +catpath (override) -xs_o (override) +abs2rel (override) -dlsyms (override) +rel2abs (override) -dynamic_lib (override) +=over 4 -static_lib (override) +=item COPYRIGHT -extra_clean_files +=item SEE ALSO -zipfile_target, tarfile_target, shdist_target +=back -install (override) +=head2 File::Spec::Win32 - methods for Win32 file specs -perldepend (override) +=over 4 -makeaperl (override) +=item SYNOPSIS -nicetext (override) +=item DESCRIPTION -prefixify (override) +devnull -cd +=back -oneliner +tmpdir -B<echo> +catfile -quote_literal +canonpath -escape_newlines +splitpath -max_exec_len +splitdir -init_linker +catpath -eliminate_macros +=over 4 -fixpath +=item Note For File::Spec::Win32 Maintainers -os_flavor +=back =over 4 -=item AUTHOR +=item COPYRIGHT + +=item SEE ALSO =back -=head2 ExtUtils::MM_VOS - VOS specific subclass of ExtUtils::MM_Unix +=head2 File::Temp - return name and handle of a temporary file safely =over 4 +=item PORTABILITY + =item SYNOPSIS =item DESCRIPTION +=back + =over 4 -=item Overridden methods +=item OBJECT-ORIENTED INTERFACE -=back +B<new> =back +B<filename> + +B<unlink_on_destroy> + +B<DESTROY> + =over 4 -=item AUTHOR +=item FUNCTIONS -=item SEE ALSO +B<tempfile> =back -=head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in -ExtUtils::MakeMaker +B<tempdir> =over 4 -=item SYNOPSIS +=item MKTEMP FUNCTIONS -=item DESCRIPTION +B<mkstemp> =back +B<mkstemps> + +B<mkdtemp> + +B<mktemp> + =over 4 -=item Overridden methods +=item POSIX FUNCTIONS -B<dlsyms> +B<tmpnam> =back -replace_manpage_separator +B<tmpfile> -B<maybe_command> +=over 4 -B<init_DIRFILESEP> +=item ADDITIONAL FUNCTIONS -B<init_others> +B<tempnam> -init_platform, platform_constants +=back -special_targets +=over 4 -static_lib +=item UTILITY FUNCTIONS -dynamic_lib +B<unlink0> -extra_clean_files +=back -init_linker +B<cmpstat> -perl_script +B<unlink1> -xs_o +B<cleanup> -pasthru +=over 4 -oneliner +=item PACKAGE VARIABLES -cd +B<safe_level>, STANDARD, MEDIUM, HIGH -max_exec_len +=back -os_flavor +TopSystemUID -=head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X +B<$KEEP_ALL>, B<$DEBUG> =over 4 -=item SYNOPSIS - -=item DESCRIPTION +=item WARNING =over 4 -=item Overridden methods +=item Temporary files and NFS -xs_c +=item Forking -=back +=item BINMODE =back -xs_cpp - -xs_o - -max_exec_len - -os_flavor +=item HISTORY -=over 4 +=item SEE ALSO =item AUTHOR =back -=head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization +=head2 File::stat - by-name interface to Perl's built-in stat() functions =over 4 @@ -17247,9 +19462,15 @@ os_flavor =item DESCRIPTION +=item BUGS + +=item NOTE + +=item AUTHOR + =back -=head2 ExtUtils::MakeMaker - Create a module Makefile +=head2 FileCache - keep more files open than the system permits =over 4 @@ -17257,92 +19478,74 @@ os_flavor =item DESCRIPTION -=over 4 - -=item How To Write A Makefile.PL +cacheout EXPR, cacheout MODE, EXPR -=item Default Makefile Behaviour +=item CAVEATS -=item make test +=item BUGS -=item make testdb +=back -=item make install +=head2 FileHandle - supply object methods for filehandles -=item PREFIX and LIB attribute +=over 4 -=item AFS users +=item SYNOPSIS -=item Static Linking of a new Perl Binary +=item DESCRIPTION -=item Determination of Perl Library and Installation Locations +$fh->print, $fh->printf, $fh->getline, $fh->getlines -=item Which architecture dependent directory? +=item SEE ALSO -=item Using Attributes and Parameters +=back -ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG, -CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS, -EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN, -FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, -INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, -INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB, -INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLSITESCRIPT, -INSTALLVENDORARCH, INSTALLVENDORBIN, INSTALLVENDORLIB, -INSTALLVENDORMAN1DIR, INSTALLVENDORMAN3DIR, INSTALLVENDORSCRIPT, -INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT, -LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS, LINKTYPE, MAKEAPERL, -MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME, -NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT, OPTIMIZE, PERL, -PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERLPREFIX, -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, SIGN, -SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION, VERSION_FROM, VERSION_SYM, -XS, XSOPT, XSPROTOARG, XS_VERSION +=head2 Filter::Simple - Simplified source filtering -=item Additional lowercase attributes +=over 4 -clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean, -test, tool_autosplit +=item SYNOPSIS -=item Overriding MakeMaker Methods +=item DESCRIPTION -=item The End Of Cargo Cult Programming +=over 4 -C<< MAN3PODS => ' ' >> +=item The Problem -=item Hintsfile support +=item A Solution -=item Distribution Support +=item Disabling or changing <no> behaviour - make distcheck, make skipcheck, make distclean, make manifest, - make distdir, make disttest, make tardist, make dist, make -uutardist, make shdist, make zipdist, make ci +=item All-in-one interface -=item Module Meta-Data +=item Filtering only specific components of source code -=item Disabling an extension +C<"code">, C<"code_no_comments">, C<"executable">, +C<"executable_no_comments">, C<"quotelike">, C<"string">, C<"regex">, +C<"all"> -=item Other Handy Functions +=item Filtering only the code parts of source code -prompt +Most source code ceases to be grammatically correct when it is broken up +into the pieces between string literals and regexes. So the C<'code'> +and C<'code_no_comments'> component filter behave slightly differently +from the other partial filters described in the previous section. -=back +=item Using Filter::Simple with an explicit C<import> subroutine -=item ENVIRONMENT +=item Using Filter::Simple and Exporter together -PERL_MM_OPT, PERL_MM_USE_DEFAULT, PERL_CORE +=item How it works -=item SEE ALSO +=back -=item AUTHORS +=item AUTHOR -=item LICENSE +=item COPYRIGHT =back -=head2 ExtUtils::MakeMaker::Config - Wrapper around Config.pm +=head2 Filter::Util::Call - Perl Source Filter Utility Module =over 4 @@ -17350,50 +19553,41 @@ PERL_MM_OPT, PERL_MM_USE_DEFAULT, PERL_CORE =item DESCRIPTION -=back - -=head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About -MakeMaker - =over 4 -=item DESCRIPTION +=item B<use Filter::Util::Call> -=over 4 +=item B<import()> -=item Module Installation +=item B<filter() and anonymous sub> -How do I keep from installing man pages?, How do I use a module without -installing it? +B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del> -=item Philosophy and History +=back -Why not just use <insert other build config tool here>?, What is -Module::Build and how does it relate to MakeMaker?, pure perl. no make, no -shell commands, easier to customize, cleaner internals, less cruft +=item EXAMPLES -=item Module Writing +=over 4 -How do I keep my $VERSION up to date without resetting it manually?, What's -this F<META.yml> thing and how did it get in my F<MANIFEST>?! +=item Example 1: A simple filter. -=item XS +=item Example 2: Using the context -How to I prevent "object version X.XX does not match bootstrap parameter -Y.YY" errors?, How do I make two or more XS files coexist in the same -directory? +=item Example 3: Using the context within the filter + +=item Example 4: Using filter_del =back -=item PATCHING +=item Filter::Simple =item AUTHOR -=item SEE ALSO +=item DATE =back -=head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker +=head2 FindBin - Locate directory of original perl script =over 4 @@ -17401,22 +19595,19 @@ directory? =item DESCRIPTION -=over 4 - -=item The Mantra +=item EXPORTABLE VARIABLES -=item The Layout +=item KNOWN ISSUES -Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP, -bin/ +=item KNOWN BUGS -=back +=item AUTHORS -=item SEE ALSO +=item COPYRIGHT =back -=head2 ExtUtils::MakeMaker::bytes - Version-agnostic bytes.pm +=head2 GDBM_File - Perl5 access to the gdbm library. =over 4 @@ -17424,19 +19615,15 @@ bin/ =item DESCRIPTION -=back - -=head2 ExtUtils::MakeMaker::vmsish - Platform-agnostic vmsish.pm - -=over 4 +=item AVAILABILITY -=item SYNOPSIS +=item BUGS -=item DESCRIPTION +=item SEE ALSO =back -=head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file +=head2 Getopt::Long - Extended processing of command line options =over 4 @@ -17444,101 +19631,107 @@ bin/ =item DESCRIPTION +=item Command Line Options, an Introduction + +=item Getting Started with Getopt::Long + =over 4 -=item Functions +=item Simple options -mkmanifest +=item A little bit less simple options -=back +=item Mixing command line option with other arguments -=back +=item Options with values -manifind +=item Options with multiple values -manicheck +=item Options with hash values -filecheck +=item User-defined subroutines to handle options -fullcheck +=item Options with multiple names -skipcheck +=item Case and abbreviations -maniread +=item Summary of Option Specifications -manicopy +!, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], : ++ [ I<desttype> ] -maniadd +=back + +=item Advanced Possibilities =over 4 -=item MANIFEST +=item Object oriented interface -=item MANIFEST.SKIP +=item Thread Safety -=item EXPORT_OK +=item Documentation and help texts -=item GLOBAL VARIABLES +=item Storing option values in a hash -=back +=item Bundling -=over 4 +=item The lonesome dash -=item DIAGNOSTICS +=item Argument callback -C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>, -C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file> +=back -=item ENVIRONMENT +=item Configuring Getopt::Long -B<PERL_MM_MANIFEST_DEBUG> +default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt, +require_order, permute, bundling (default: disabled), bundling_override +(default: disabled), ignore_case (default: enabled), ignore_case_always +(default: disabled), auto_version (default:disabled), auto_help +(default:disabled), pass_through (default: disabled), prefix, +prefix_pattern, long_prefix_pattern, debug (default: disabled) -=item SEE ALSO +=item Exportable Methods -=item AUTHOR +VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage -=back +=item Return values and Errors -=head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c +=item Legacy =over 4 -=item SYNOPSIS +=item Default destinations -=item DESCRIPTION +=item Alternative option starters -=item SEE ALSO +=item Configuration variables =back -=head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader +=item Trouble Shooting =over 4 -=item SYNOPSIS - -=item DESCRIPTION - -=back - -=head2 ExtUtils::Mksymlists - write linker options files for dynamic -extension +=item GetOptions does not return a false result when an option is not +supplied -=over 4 +=item GetOptions does not split the command line correctly -=item SYNOPSIS +=item Undefined subroutine &main::GetOptions called -=item DESCRIPTION +=item How do I put a "-?" option into a Getopt::Long? -DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME +=back =item AUTHOR -=item REVISION +=item COPYRIGHT AND DISCLAIMER =back -=head2 ExtUtils::Packlist - manage .packlist files +=head2 Getopt::Std, getopt, getopts - Process single-character switches +with switch clustering =over 4 @@ -17546,190 +19739,169 @@ DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME =item DESCRIPTION -=item USAGE - -=item FUNCTIONS - -new(), read(), write(), validate(), packlist_file() - -=item EXAMPLE - -=item AUTHOR +=item C<--help> and C<--version> =back -=head2 ExtUtils::ParseXS - converts Perl XS code into C code +=head2 Hash::Util - A selection of general-utility hash subroutines =over 4 =item SYNOPSIS -=item EXPORT +=item DESCRIPTION -=item FUNCTIONS +=over 4 -process_xs(), B<C++>, B<hiertype>, B<except>, B<typemap>, B<prototypes>, -B<versioncheck>, B<linenumbers>, B<optimize>, B<inout>, B<argtypes>, B<s>, -errors() +=item Field hashes -=item AUTHOR +=item Restricted hashes -=item COPYRIGHT +B<lock_keys>, B<unlock_keys> -=item SEE ALSO +=back =back -=head2 ExtUtils::testlib - add blib/* directories to @INC +B<lock_keys_plus> -=over 4 +B<lock_value>, B<unlock_value> -=item SYNOPSIS +B<lock_hash>, B<unlock_hash> -=item DESCRIPTION +B<lock_hash_recurse>, B<unlock_hash_recurse> -=back +B<hash_unlocked> -=head2 Fatal - replace functions with equivalents which succeed or die +b<legal_keys>, B<hidden_keys>, B<all_keys>, B<hash_seed> -=over 4 +B<hv_store> -=item SYNOPSIS +=over 4 -=item DESCRIPTION +=item Operating on references to hashes. -=item AUTHOR +lock_ref_keys, unlock_ref_keys, lock_ref_keys_plus, lock_ref_value, +unlock_ref_value, lock_hashref, unlock_hashref, lock_hashref_recurse, +unlock_hashref_recurse, hash_ref_unlocked, legal_ref_keys, hidden_ref_keys =back -=head2 Fcntl - load the C Fcntl.h defines - =over 4 -=item SYNOPSIS +=item CAVEATS -=item DESCRIPTION +=item BUGS -=item NOTE +=item AUTHOR -=item EXPORTED SYMBOLS +=item SEE ALSO =back -=head2 Fcntl2 - load the C Fcntl2.h defines +=head2 Hash::Util::FieldHash - Associate references with data =over 4 =item SYNOPSIS -=item DESCRIPTION +=item Functions -=item NOTE +fieldhash, fieldhashes -=item EXPORTED SYMBOLS +=item Description -=back +=over 4 -=head2 File::Basename - Parse file paths into directory, filename and -suffix. +=item Features -=over 4 +Key exchange, Thread support, Garbage collection -=item SYNOPSIS +=item Rationale -=item DESCRIPTION +Stringification, Thread Dependency, Garbage Collection -=back +=item How to use -C<fileparse> +=item Examples -C<basename> +=item Garbage-Collected Hashes -C<dirname> +=back -C<fileparse_set_fstype> +=item Guts =over 4 -=item SEE ALSO - -=back +=item The C<PERL_MAGIC_uvar> interface for hashes -=head2 File::CheckTree, validate - run many filetest checks on a tree +=item Weakrefs call uvar magic -=over 4 +=item How field hashes work -=item SYNOPSIS +=item Internal function Hash::Util::FieldHash::_fieldhash -=item DESCRIPTION +=back =item AUTHOR -=item HISTORY +=item COPYRIGHT AND LICENSE =back -=head2 File::Compare - Compare files or filehandles +=head2 Hash::Util::FieldHash::lib::Hash::Util::FieldHash, +Hash::Util::FieldHash - Associate references with data =over 4 =item SYNOPSIS -=item DESCRIPTION - -=item RETURN - -=item AUTHOR +=item Functions -=back +fieldhash, fieldhashes -=head2 File::Copy - Copy files or filehandles +=item Description =over 4 -=item SYNOPSIS - -=item DESCRIPTION - -=over 4 +=item Features -=item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32) +Key exchange, Thread support, Garbage collection -rmscopy($from,$to[,$date_flag]) +=item Rationale -=back +Stringification, Thread Dependency, Garbage Collection -=item RETURN +=item How to use -=item NOTES +=item Examples -=item AUTHOR +=item Garbage-Collected Hashes =back -=head2 File::DosGlob - DOS like globbing and then some +=item Guts =over 4 -=item SYNOPSIS +=item The C<PERL_MAGIC_uvar> interface for hashes -=item DESCRIPTION +=item Weakrefs call uvar magic -=item NOTES +=item How field hashes work -=item EXPORTS (by request only) +=item Internal function Hash::Util::FieldHash::_fieldhash -=item BUGS +=back =item AUTHOR -=item HISTORY - -=item SEE ALSO +=item COPYRIGHT AND LICENSE =back -=head2 File::Find - Traverse a directory tree. +=head2 Hash::Utilib::Hash::Util, Hash::Util - A selection of +general-utility hash subroutines =over 4 @@ -17737,71 +19909,67 @@ rmscopy($from,$to[,$date_flag]) =item DESCRIPTION -B<find>, B<finddepth> - =over 4 -=item %options - -C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>, -C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>, -C<untaint>, C<untaint_pattern>, C<untaint_skip> +=item Field hashes -=item The wanted function +=item Restricted hashes -C<$File::Find::dir> is the current directory name,, C<$_> is the current -filename within that directory, C<$File::Find::name> is the complete -pathname to the file +B<lock_keys>, B<unlock_keys> =back -=item WARNINGS +=back -=item CAVEAT +B<lock_keys_plus> -$dont_use_nlink, symlinks +B<lock_value>, B<unlock_value> -=item NOTES +B<lock_hash>, B<unlock_hash> -=item BUGS AND CAVEATS +B<lock_hash_recurse>, B<unlock_hash_recurse> -=item HISTORY +B<hash_unlocked> -=back +b<legal_keys>, B<hidden_keys>, B<all_keys>, B<hash_seed> -=head2 File::Glob - Perl extension for BSD glob routine +B<hv_store> =over 4 -=item SYNOPSIS +=item Operating on references to hashes. -=item DESCRIPTION +lock_ref_keys, unlock_ref_keys, lock_ref_keys_plus, lock_ref_value, +unlock_ref_value, lock_hashref, unlock_hashref, lock_hashref_recurse, +unlock_hashref_recurse, hash_ref_unlocked, legal_ref_keys, hidden_ref_keys + +=back =over 4 -=item META CHARACTERS +=item CAVEATS -=item POSIX FLAGS +=item BUGS -C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>, -C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>, -C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT> +=item AUTHOR -=back +=item SEE ALSO -=item DIAGNOSTICS +=back -C<GLOB_NOSPACE>, C<GLOB_ABEND> +=head2 I18N::Collate - compare 8-bit scalar data according to the current +locale -=item NOTES +=over 4 -=item SEE ALSO +=item SYNOPSIS -=item AUTHOR +=item DESCRIPTION =back -=head2 File::GlobMapper - Extend File Glob to Allow Input and Output Files +=head2 I18N::LangTags - functions for dealing with RFC3066-style language +tags =over 4 @@ -17809,47 +19977,46 @@ C<GLOB_NOSPACE>, C<GLOB_ABEND> =item DESCRIPTION -This code is a work in progress, There are known bugs, The interface -defined here is tentative, There are portability issues, Do not use in -production code, Consider yourself warned! +=back -=over 4 +the function is_language_tag($lang1) -=item Behind The Scenes +the function extract_language_tags($whatever) -=item Limitations +the function same_language_tag($lang1, $lang2) -=item Input File Glob +the function similarity_language_tag($lang1, $lang2) -B<~>, B<~user>, B<.>, B<*>, B<?>, B<\>, B<[]>, B<{,}>, B<()> +the function is_dialect_of($lang1, $lang2) -=item Output File Glob +the function super_languages($lang1) -"*", #1 +the function locale2language_tag($locale_identifier) -=item Returned Data +the function encode_language_tag($lang1) -=back +the function alternate_language_tags($lang1) -=item EXAMPLES +the function @langs = panic_languages(@accept_languages) -=over 4 +the function implicate_supers( ...languages... ), the function +implicate_supers_strictly( ...languages... ) -=item A Rename script +=over 4 -=item A few example globmaps +=item ABOUT LOWERCASING -=back +=item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS =item SEE ALSO -=item AUTHOR +=item COPYRIGHT -=item COPYRIGHT AND LICENSE +=item AUTHOR =back -=head2 File::Path - create or remove directory trees +=head2 I18N::LangTags::Detect - detect the user's language preferences =over 4 @@ -17857,13 +20024,19 @@ B<~>, B<~user>, B<.>, B<*>, B<?>, B<\>, B<[]>, B<{,}>, B<()> =item DESCRIPTION -=item DIAGNOSTICS +=item FUNCTIONS -=item AUTHORS +=item ENVIRONMENT + +=item SEE ALSO + +=item COPYRIGHT + +=item AUTHOR =back -=head2 File::Spec - portably perform operations on file names +=head2 I18N::LangTags::List -- tags and names for human languages =over 4 @@ -17871,21 +20044,147 @@ B<~>, B<~user>, B<.>, B<*>, B<?>, B<\>, B<[]>, B<{,}>, B<()> =item DESCRIPTION -=item METHODS +=item ABOUT LANGUAGE TAGS -canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir, -no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath, -splitdir, catpath(), abs2rel, rel2abs() +=item LIST OF LANGUAGES + +{ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} : +Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : +Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian, +{ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)], +{am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic, +{arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} +: Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} : +Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} : +Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae} +: Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} : +Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai} +: Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} : +Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} : +Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber +(Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini, +{bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} : +Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} : +Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian +(Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central +American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages], +{ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb} +: Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} : +Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} : +Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree, +{mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf} +: French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based +Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} : +Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} : +Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru) +Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri, +{dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch, +{dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi} +: Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} : +English, {enm} : Old English (1100-1500), {ang} : Old English +(ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} : +Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat} +: Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} : +Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French +(ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} : +Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan, +{lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian, +{de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High +German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon} +: Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient +Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} : +Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian, +{he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} : +Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian, +{hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo, +{ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European +(Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua +(International Auxiliary Language Association), {ie} : Interlingue, {iu} : +Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} : +Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian +languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} : +Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle, +{kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} : +Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar} +: Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh, +{kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese, +{ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz, +{i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} : +Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama, +{kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} : +Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} : +Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} : +Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban +(Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui} +: Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, +{mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili, +{mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : +Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} : +Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} : +Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai, +[{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} : +Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} : +Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)], +{lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple +languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan, +{na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, +{ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} : +Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean, +{nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} : +Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} : +Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi} +: Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} : +Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian +languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} : +Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} : +Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian +(ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon} +: Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages], +{pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} : +Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan, +[{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} : +Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan +languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} : +Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami, +[{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} : +Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak, +{sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian, +{srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign +Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} : +Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave +(Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian, +{sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} : +Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} : +South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} : +Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati, +{sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} : +Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao, +{tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} : +Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} : +Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau, +{tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian, +{ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} : +Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh} +: Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : +Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, +{umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : +Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} +: Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was} +: Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private +Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} : +Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd} +: Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu, +{zun} : Zuni =item SEE ALSO -=item AUTHOR +=item COPYRIGHT AND DISCLAIMER -=item COPYRIGHT +=item AUTHOR =back -=head2 File::Spec::Cygwin - methods for Cygwin file specs +=head2 I18N::Langinfo - query locale information =over 4 @@ -17893,21 +20192,21 @@ splitdir, catpath(), abs2rel, rel2abs() =item DESCRIPTION -=back +=over 4 -canonpath +=item EXPORT -file_name_is_absolute +=back -tmpdir (override) +=item SEE ALSO -=over 4 +=item AUTHOR -=item COPYRIGHT +=item COPYRIGHT AND LICENSE =back -=head2 File::Spec::Epoc - methods for Epoc file specs +=head2 IO - load various IO modules =over 4 @@ -17915,21 +20214,29 @@ tmpdir (override) =item DESCRIPTION +=item DEPRECATED + =back -canonpath() +=head2 IO::Compress::Base - Base Class for IO::Compress modules =over 4 -=item AUTHOR +=item SYNOPSIS -=item COPYRIGHT +=item DESCRIPTION =item SEE ALSO +=item AUTHOR + +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE + =back -=head2 File::Spec::Functions - portably perform operations on file names +=head2 IO::Compress::Deflate - Write RFC 1950 files/buffers =over 4 @@ -17937,86 +20244,102 @@ canonpath() =item DESCRIPTION +DO NOT use in production code, The documentation is incomplete in places, +Parts of the interface defined here are tentative, Please report any +problems you find + +=item Functional Interface + =over 4 -=item Exports +=item deflate $input => $output [, OPTS] + +A filename, A filehandle, A scalar reference, An array reference, An Input +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob + +=item Notes -=back +=item Optional Parameters -=item COPYRIGHT +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> -=item SEE ALSO +=item Examples =back -=head2 File::Spec::Mac - File::Spec for Mac OS (Classic) +=item OO Interface =over 4 -=item SYNOPSIS +=item Constructor -=item DESCRIPTION +A filename, A filehandle, A scalar reference -=item METHODS +=item Constructor Options -canonpath +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 =back -catdir() +=item Methods -catfile +=over 4 -curdir +=item print -devnull +=item printf -rootdir +=item syswrite -tmpdir +=item write -updir +=item flush -file_name_is_absolute +=item tell -path +=item eof -splitpath +=item seek -splitdir +=item binmode -catpath +=item opened -abs2rel +=item autoflush -rel2abs +=item input_line_number -=over 4 +=item fileno -=item AUTHORS +=item close -=item COPYRIGHT +=item newStream([OPTS]) -=item SEE ALSO +=item deflateParams =back -=head2 File::Spec::OS2 - methods for OS/2 file specs +=item Importing -=over 4 +:all, :constants, :flush, :level, :strategy -=item SYNOPSIS +=item EXAMPLES -=item DESCRIPTION +=item SEE ALSO -tmpdir, splitpath +=item AUTHOR -=item COPYRIGHT +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE =back -=head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec -modules +=head2 IO::Compress::Gzip - Write RFC 1952 files/buffers =over 4 @@ -18024,105 +20347,106 @@ modules =item DESCRIPTION -=item METHODS - -canonpath() +DO NOT use in production code, The documentation is incomplete in places, +Parts of the interface defined here are tentative, Please report any +problems you find -=back +=item Functional Interface -catdir() +=over 4 -catfile +=item gzip $input => $output [, OPTS] -curdir +A filename, A filehandle, A scalar reference, An array reference, An Input +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob -devnull +=item Notes -rootdir +=item Optional Parameters -tmpdir +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> -updir +=item Examples -no_upwards +=back -case_tolerant +=item OO Interface -file_name_is_absolute +=over 4 -path +=item Constructor -join +A filename, A filehandle, A scalar reference -splitpath +=item Constructor Options -splitdir +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 +>> -catpath() +=item Examples -abs2rel +=back -rel2abs() +=item Methods =over 4 -=item COPYRIGHT - -=item SEE ALSO - -=back - -=head2 File::Spec::VMS - methods for VMS file specs +=item print -=over 4 +=item printf -=item SYNOPSIS +=item syswrite -=item DESCRIPTION +=item write -canonpath (override) +=item flush -=back +=item tell -catdir (override) +=item eof -catfile (override) +=item seek -curdir (override) +=item binmode -devnull (override) +=item opened -rootdir (override) +=item autoflush -tmpdir (override) +=item input_line_number -updir (override) +=item fileno -case_tolerant (override) +=item close -path (override) +=item newStream([OPTS]) -file_name_is_absolute (override) +=item deflateParams -splitpath (override) +=back -splitdir (override) +=item Importing -catpath (override) +:all, :constants, :flush, :level, :strategy -abs2rel (override) +=item EXAMPLES -rel2abs (override) +=item SEE ALSO -=over 4 +=item AUTHOR -=item COPYRIGHT +=item MODIFICATION HISTORY -=item SEE ALSO +=item COPYRIGHT AND LICENSE =back -=head2 File::Spec::Win32 - methods for Win32 file specs +=head2 IO::Compress::RawDeflate - Write RFC 1951 files/buffers =over 4 @@ -18130,185 +20454,210 @@ rel2abs (override) =item DESCRIPTION -devnull - -=back +DO NOT use in production code, The documentation is incomplete in places, +Parts of the interface defined here are tentative, Please report any +problems you find -tmpdir +=item Functional Interface -catfile +=over 4 -canonpath +=item rawdeflate $input => $output [, OPTS] -splitpath +A filename, A filehandle, A scalar reference, An array reference, An Input +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob -splitdir +=item Notes -catpath +=item Optional Parameters -=over 4 +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> -=item Note For File::Spec::Win32 Maintainers +=item Examples =back +=item OO Interface + =over 4 -=item COPYRIGHT +=item Constructor -=item SEE ALSO +A filename, A filehandle, A scalar reference -=back +=item Constructor Options -=head2 File::Temp - return name and handle of a temporary file safely +C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A +Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> -=over 4 +=item Examples -=item PORTABILITY +=back -=item SYNOPSIS +=item Methods -=item DESCRIPTION +=over 4 -=back +=item print -=over 4 +=item printf -=item OBJECT-ORIENTED INTERFACE +=item syswrite -B<new> +=item write -=back +=item flush -B<filename> +=item tell -B<unlink_on_destroy> +=item eof -B<DESTROY> +=item seek -=over 4 +=item binmode -=item FUNCTIONS +=item opened -B<tempfile> +=item autoflush -=back +=item input_line_number -B<tempdir> +=item fileno -=over 4 +=item close -=item MKTEMP FUNCTIONS +=item newStream([OPTS]) -B<mkstemp> +=item deflateParams =back -B<mkstemps> +=item Importing -B<mkdtemp> +:all, :constants, :flush, :level, :strategy -B<mktemp> +=item EXAMPLES -=over 4 +=item SEE ALSO -=item POSIX FUNCTIONS +=item AUTHOR -B<tmpnam> +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE =back -B<tmpfile> +=head2 IO::Compress::Zip - Write zip files/buffers =over 4 -=item ADDITIONAL FUNCTIONS +=item SYNOPSIS -B<tempnam> +=item DESCRIPTION -=back +DO NOT use in production code, The documentation is incomplete in places, +Parts of the interface defined here are tentative, Please report any +problems you find + +=item Functional Interface =over 4 -=item UTILITY FUNCTIONS +=item zip $input => $output [, OPTS] -B<unlink0> +A filename, A filehandle, A scalar reference, An array reference, An Input +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob -=back +=item Notes -B<cmpstat> +=item Optional Parameters + +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> + +=item Examples -B<unlink1> +=back -B<cleanup> +=item OO Interface =over 4 -=item PACKAGE VARIABLES +=item Constructor -B<safe_level>, STANDARD, MEDIUM, HIGH +A filename, A filehandle, A scalar reference -=back +=item Constructor Options -TopSystemUID +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 >> -B<$KEEP_ALL>, B<$DEBUG> +=item Examples -=over 4 +=back -=item WARNING +=item Methods =over 4 -=item Temporary files and NFS +=item print -=item Forking +=item printf -=item BINMODE +=item syswrite -=back +=item write -=item HISTORY +=item flush -=item SEE ALSO +=item tell -=item AUTHOR +=item eof -=back +=item seek -=head2 File::stat - by-name interface to Perl's built-in stat() functions +=item binmode -=over 4 +=item opened -=item SYNOPSIS +=item autoflush -=item DESCRIPTION +=item input_line_number -=item BUGS +=item fileno -=item NOTE +=item close -=item AUTHOR +=item newStream([OPTS]) + +=item deflateParams =back -=head2 FileCache - keep more files open than the system permits +=item Importing -=over 4 +:all, :constants, :flush, :level, :strategy, :zip_method -=item SYNOPSIS +=item EXAMPLES -=item DESCRIPTION +=item SEE ALSO -cacheout EXPR, cacheout MODE, EXPR +=item AUTHOR -=item CAVEATS +=item MODIFICATION HISTORY -=item BUGS +=item COPYRIGHT AND LICENSE =back -=head2 FileHandle - supply object methods for filehandles +=head2 IO::Dir - supply object methods for directory handles =over 4 @@ -18316,13 +20665,18 @@ cacheout EXPR, cacheout MODE, EXPR =item DESCRIPTION -$fh->print, $fh->printf, $fh->getline, $fh->getlines +new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), +rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] =item SEE ALSO +=item AUTHOR + +=item COPYRIGHT + =back -=head2 Filter::Simple - Simplified source filtering +=head2 IO::File - supply object methods for filehandles =over 4 @@ -18330,44 +20684,24 @@ $fh->print, $fh->printf, $fh->getline, $fh->getlines =item DESCRIPTION -=over 4 - -=item The Problem - -=item A Solution - -=item Disabling or changing <no> behaviour - -=item All-in-one interface - -=item Filtering only specific components of source code - -C<"code">, C<"code_no_comments">, C<"executable">, -C<"executable_no_comments">, C<"quotelike">, C<"string">, C<"regex">, -C<"all"> - -=item Filtering only the code parts of source code - -Most source code ceases to be grammatically correct when it is broken up -into the pieces between string literals and regexes. So the C<'code'> -and C<'code_no_comments'> component filter behave slightly differently -from the other partial filters described in the previous section. +=item CONSTRUCTOR -=item Using Filter::Simple with an explicit C<import> subroutine +new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile -=item Using Filter::Simple and Exporter together +=item METHODS -=item How it works +open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( +[LAYER] ) -=back +=item NOTE -=item AUTHOR +=item SEE ALSO -=item COPYRIGHT +=item HISTORY =back -=head2 Filter::Util::Call - Perl Source Filter Utility Module +=head2 IO::Handle - supply object methods for I/O handles =over 4 @@ -18375,41 +20709,52 @@ from the other partial filters described in the previous section. =item DESCRIPTION -=over 4 +=item CONSTRUCTOR -=item B<use Filter::Util::Call> +new (), new_from_fd ( FD, MODE ) -=item B<import()> +=item METHODS -=item B<filter() and anonymous sub> +$io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines, +$io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error, +$io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ), +$io->blocking ( [ BOOL ] ), $io->untaint -B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del> +=item NOTE + +=item SEE ALSO + +=item BUGS + +=item HISTORY =back -=item EXAMPLES +=head2 IO::Pipe - supply object methods for pipes =over 4 -=item Example 1: A simple filter. +=item SYNOPSIS -=item Example 2: Using the context +=item DESCRIPTION -=item Example 3: Using the context within the filter +=item CONSTRUCTOR -=item Example 4: Using filter_del +new ( [READER, WRITER] ) -=back +=item METHODS -=item Filter::Simple +reader ([ARGS]), writer ([ARGS]), handles () + +=item SEE ALSO =item AUTHOR -=item DATE +=item COPYRIGHT =back -=head2 FindBin - Locate directory of original perl script +=head2 IO::Poll - Object interface to system poll call =over 4 @@ -18417,19 +20762,20 @@ B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del> =item DESCRIPTION -=item EXPORTABLE VARIABLES +=item METHODS -=item KNOWN ISSUES +mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( +IO ), handles( [ EVENT_MASK ] ) -=item KNOWN BUGS +=item SEE ALSO -=item AUTHORS +=item AUTHOR =item COPYRIGHT =back -=head2 GDBM_File - Perl5 access to the gdbm library. +=head2 IO::Seekable - supply seek based methods for I/O objects =over 4 @@ -18437,15 +20783,17 @@ B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del> =item DESCRIPTION -=item AVAILABILITY - -=item BUGS +$io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET), +WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ), +$io->tell =item SEE ALSO +=item HISTORY + =back -=head2 Getopt::Long - Extended processing of command line options +=head2 IO::Select - OO interface to the select system call =over 4 @@ -18453,107 +20801,104 @@ B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del> =item DESCRIPTION -=item Command Line Options, an Introduction - -=item Getting Started with Getopt::Long - -=over 4 +=item CONSTRUCTOR -=item Simple options +new ( [ HANDLES ] ) -=item A little bit less simple options +=item METHODS -=item Mixing command line option with other arguments +add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( +[ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), +count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) -=item Options with values +=item EXAMPLE -=item Options with multiple values +=item AUTHOR -=item Options with hash values +=item COPYRIGHT -=item User-defined subroutines to handle options +=back -=item Options with multiple names +=head2 IO::Socket - Object interface to socket communications -=item Case and abbreviations +=over 4 -=item Summary of Option Specifications +=item SYNOPSIS -!, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], : -+ [ I<desttype> ] +=item DESCRIPTION -=back +=item CONSTRUCTOR -=item Advanced Possibilities +new ( [ARGS] ) -=over 4 +=item METHODS -=item Object oriented interface +accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, +protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) -=item Thread Safety +=item SEE ALSO -=item Documentation and help texts +=item AUTHOR -=item Storing option values in a hash +=item COPYRIGHT -=item Bundling +=back -=item The lonesome dash +=head2 IO::Socket::INET - Object interface for AF_INET domain sockets -=item Argument callback +=over 4 -=back +=item SYNOPSIS -=item Configuring Getopt::Long +=item DESCRIPTION -default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt, -require_order, permute, bundling (default: disabled), bundling_override -(default: disabled), ignore_case (default: enabled), ignore_case_always -(default: disabled), auto_version (default:disabled), auto_help -(default:disabled), pass_through (default: disabled), prefix, -prefix_pattern, long_prefix_pattern, debug (default: disabled) +=item CONSTRUCTOR -=item Exportable Methods +new ( [ARGS] ) -VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage +=over 4 -=item Return values and Errors +=item METHODS -=item Legacy +sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost +() -=over 4 +=back -=item Default destinations +=item SEE ALSO -=item Alternative option starters +=item AUTHOR -=item Configuration variables +=item COPYRIGHT =back -=item Trouble Shooting +=head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets =over 4 -=item GetOptions does not return a false result when an option is not -supplied +=item SYNOPSIS + +=item DESCRIPTION + +=item CONSTRUCTOR -=item GetOptions does not split the command line correctly +new ( [ARGS] ) -=item Undefined subroutine &main::GetOptions called +=item METHODS -=item How do I put a "-?" option into a Getopt::Long? +hostpath(), peerpath() -=back +=item SEE ALSO =item AUTHOR -=item COPYRIGHT AND DISCLAIMER +=item COPYRIGHT =back -=head2 Getopt::Std, getopt, getopts - Process single-character switches -with switch clustering +=head2 IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip) +file/buffer =over 4 @@ -18561,104 +20906,110 @@ with switch clustering =item DESCRIPTION -=item C<--help> and C<--version> - -=back +DO NOT use in production code, The documentation is incomplete in places, +Parts of the interface defined here are tentative, Please report any +problems you find, RFC 1950, RFC 1951, gzip (RFC 1952), zip -=head2 Hash::Util - A selection of general-utility hash subroutines +=item Functional Interface =over 4 -=item SYNOPSIS +=item anyinflate $input => $output [, OPTS] -=item DESCRIPTION +A filename, A filehandle, A scalar reference, An array reference, An Input +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob -=over 4 +=item Notes -=item Restricted hashes +=item Optional Parameters -lock_keys, unlock_keys +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >> -=back +=item Examples =back -lock_value, unlock_value +=item OO Interface -B<lock_hash>, B<unlock_hash> +=over 4 -B<hash_seed> +=item Constructor -=over 4 +A filename, A filehandle, A scalar reference -=item CAVEATS +=item Constructor Options -=item AUTHOR +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 SEE ALSO +=item Examples =back -=head2 I18N::Collate - compare 8-bit scalar data according to the current -locale +=item Methods =over 4 -=item SYNOPSIS +=item read -=item DESCRIPTION +=item read -=back +=item getline -=head2 I18N::LangTags - functions for dealing with RFC3066-style language -tags +=item getc -=over 4 +=item ungetc -=item SYNOPSIS +=item inflateSync -=item DESCRIPTION +=item getHeaderInfo -=back +=item tell -the function is_language_tag($lang1) +=item eof -the function extract_language_tags($whatever) +=item seek -the function same_language_tag($lang1, $lang2) +=item binmode -the function similarity_language_tag($lang1, $lang2) +=item opened -the function is_dialect_of($lang1, $lang2) +=item autoflush -the function super_languages($lang1) +=item input_line_number -the function locale2language_tag($locale_identifier) +=item fileno -the function encode_language_tag($lang1) +=item close -the function alternate_language_tags($lang1) +=item nextStream -the function @langs = panic_languages(@accept_languages) +=item trailingData -the function implicate_supers( ...languages... ), the function -implicate_supers_strictly( ...languages... ) +=back -=over 4 +=item Importing -=item ABOUT LOWERCASING +:all -=item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS +=item EXAMPLES =item SEE ALSO -=item COPYRIGHT - =item AUTHOR +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE + =back -=head2 I18N::LangTags::Detect - detect the user's language preferences +=head2 IO::Uncompress::AnyUncompress - Uncompress gzip, zip, bzip2 or lzop +file/buffer =over 4 @@ -18666,189 +21017,106 @@ implicate_supers_strictly( ...languages... ) =item DESCRIPTION -=item FUNCTIONS +DO NOT use in production code, The documentation is incomplete in places, +Parts of the interface defined here are tentative, Please report any +problems you find, RFC 1950, RFC 1951, gzip (RFC 1952), zip, bzip2, lzop -=item ENVIRONMENT +=item Functional Interface -=item SEE ALSO +=over 4 -=item COPYRIGHT +=item anyuncompress $input => $output [, OPTS] -=item AUTHOR +A filename, A filehandle, A scalar reference, An array reference, An Input +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob + +=item Notes + +=item Optional Parameters + +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >> + +=item Examples =back -=head2 I18N::LangTags::List -- tags and names for human languages +=item OO Interface =over 4 -=item SYNOPSIS +=item Constructor -=item DESCRIPTION +A filename, A filehandle, A scalar reference -=item ABOUT LANGUAGE TAGS +=item Constructor Options -=item LIST OF LANGUAGES +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 >> -{ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} : -Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : -Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian, -{ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)], -{am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic, -{arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} -: Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} : -Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} : -Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae} -: Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} : -Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai} -: Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} : -Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} : -Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber -(Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini, -{bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} : -Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} : -Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian -(Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central -American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages], -{ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb} -: Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} : -Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} : -Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree, -{mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf} -: French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based -Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} : -Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} : -Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru) -Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri, -{dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch, -{dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi} -: Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} : -English, {enm} : Old English (1100-1500), {ang} : Old English -(ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} : -Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat} -: Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} : -Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French -(ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} : -Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan, -{lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian, -{de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High -German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon} -: Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient -Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} : -Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian, -{he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} : -Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian, -{hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo, -{ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European -(Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua -(International Auxiliary Language Association), {ie} : Interlingue, {iu} : -Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} : -Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian -languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} : -Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle, -{kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} : -Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar} -: Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh, -{kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese, -{ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz, -{i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} : -Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama, -{kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} : -Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} : -Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} : -Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban -(Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui} -: Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, -{mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili, -{mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : -Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} : -Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} : -Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai, -[{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} : -Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} : -Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)], -{lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple -languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan, -{na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, -{ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} : -Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean, -{nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} : -Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} : -Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi} -: Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} : -Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian -languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} : -Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} : -Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian -(ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon} -: Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages], -{pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} : -Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan, -[{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} : -Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan -languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} : -Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami, -[{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} : -Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak, -{sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian, -{srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign -Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} : -Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave -(Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian, -{sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} : -Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} : -South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} : -Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati, -{sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} : -Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao, -{tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} : -Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} : -Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau, -{tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian, -{ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} : -Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh} -: Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : -Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, -{umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : -Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} -: Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was} -: Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private -Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} : -Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd} -: Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu, -{zun} : Zuni +=item Examples + +=back + +=item Methods + +=over 4 + +=item read + +=item read + +=item getline -=item SEE ALSO +=item getc -=item COPYRIGHT AND DISCLAIMER +=item ungetc -=item AUTHOR +=item getHeaderInfo -=back +=item tell -=head2 I18N::Langinfo - query locale information +=item eof -=over 4 +=item seek -=item SYNOPSIS +=item binmode -=item DESCRIPTION +=item opened -=over 4 +=item autoflush -=item EXPORT +=item input_line_number + +=item fileno + +=item close + +=item nextStream + +=item trailingData =back +=item Importing + +:all + +=item EXAMPLES + =item SEE ALSO =item AUTHOR +=item MODIFICATION HISTORY + =item COPYRIGHT AND LICENSE =back -=head2 IO - load various IO modules +=head2 IO::Uncompress::Base - Base Class for IO::Uncompress modules =over 4 @@ -18856,12 +21124,17 @@ Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd} =item DESCRIPTION -=item DEPRECATED +=item SEE ALSO + +=item AUTHOR + +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE =back -=head2 IO::Compress::Deflate - Perl interface to write RFC 1950 -files/buffers +=head2 IO::Uncompress::Gunzip - Read RFC 1952 files/buffers =over 4 @@ -18877,22 +21150,18 @@ problems you find =over 4 -=item deflate $input => $output [, OPTS] +=item gunzip $input => $output [, OPTS] A filename, A filehandle, A scalar reference, An array reference, An Input -FileGlob string, A filename, A filehandle, A scalar reference, A Hash -Reference, An Array Reference, An Output FileGlob - -=item deflate \%hash [, OPTS] - -undef, A filename, A filehandle, A scalar reference, A Hash Reference, An -Array Reference +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob =item Notes =item Optional Parameters -AutoClose =E<gt> 0|1, -Append =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >> =item Examples @@ -18908,8 +21177,10 @@ 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<< 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 @@ -18919,15 +21190,21 @@ Filehandle, -Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1 =over 4 -=item print +=item read -=item printf +=item read -=item syswrite +=item getline -=item write +=item getc -=item flush +=item ungetc + +=item inflateSync + +=item getHeaderInfo + +Name, Comment =item tell @@ -18937,19 +21214,25 @@ Filehandle, -Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1 =item binmode +=item opened + +=item autoflush + +=item input_line_number + =item fileno =item close -=item newStream +=item nextStream -=item deflateParams +=item trailingData =back =item Importing -:all, :constants, :flush, :level, :strategy +:all =item EXAMPLES @@ -18963,8 +21246,7 @@ Filehandle, -Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1 =back -=head2 IO::Compress::Gzip - Perl interface to write RFC 1952 -files/buffers +=head2 IO::Uncompress::Inflate - Read RFC 1950 files/buffers =over 4 @@ -18980,22 +21262,18 @@ problems you find =over 4 -=item gzip $input => $output [, OPTS] +=item inflate $input => $output [, OPTS] A filename, A filehandle, A scalar reference, An array reference, An Input -FileGlob string, A filename, A filehandle, A scalar reference, A Hash -Reference, An Array Reference, An Output FileGlob - -=item gzip \%hash [, OPTS] - -undef, A filename, A filehandle, A scalar reference, A Hash Reference, An -Array Reference +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob =item Notes =item Optional Parameters -AutoClose =E<gt> 0|1, -Append =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >> =item Examples @@ -19011,11 +21289,9 @@ 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, -Mimimal =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<< 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 @@ -19025,15 +21301,19 @@ Filehandle, -Merge =E<gt> 0|1, -Level, -Strategy, -Mimimal =E<gt> 0|1, =over 4 -=item print +=item read -=item printf +=item read -=item syswrite +=item getline -=item write +=item getc -=item flush +=item ungetc + +=item inflateSync + +=item getHeaderInfo =item tell @@ -19043,19 +21323,25 @@ Filehandle, -Merge =E<gt> 0|1, -Level, -Strategy, -Mimimal =E<gt> 0|1, =item binmode +=item opened + +=item autoflush + +=item input_line_number + =item fileno =item close -=item newStream +=item nextStream -=item deflateParams +=item trailingData =back =item Importing -:all, :constants, :flush, :level, :strategy +:all =item EXAMPLES @@ -19069,8 +21355,7 @@ Filehandle, -Merge =E<gt> 0|1, -Level, -Strategy, -Mimimal =E<gt> 0|1, =back -=head2 IO::Compress::RawDeflate - Perl interface to write RFC 1951 -files/buffers +=head2 IO::Uncompress::RawInflate - Read RFC 1951 files/buffers =over 4 @@ -19086,22 +21371,127 @@ problems you find =over 4 -=item rawdeflate $input => $output [, OPTS] +=item rawinflate $input => $output [, OPTS] A filename, A filehandle, A scalar reference, An array reference, An Input -FileGlob string, A filename, A filehandle, A scalar reference, A Hash -Reference, An Array Reference, An Output FileGlob +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob + +=item Notes + +=item Optional Parameters + +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >> + +=item Examples + +=back + +=item OO Interface + +=over 4 + +=item Constructor + +A filename, A filehandle, A scalar reference + +=item Constructor Options + +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 + +=back + +=item Methods + +=over 4 + +=item read + +=item read + +=item getline + +=item getc + +=item ungetc + +=item inflateSync + +=item getHeaderInfo + +=item tell + +=item eof + +=item seek + +=item binmode + +=item opened + +=item autoflush + +=item input_line_number + +=item fileno + +=item close + +=item nextStream + +=item trailingData + +=back + +=item Importing + +:all -=item rawdeflate \%hash [, OPTS] +=item EXAMPLES + +=item SEE ALSO + +=item AUTHOR + +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE + +=back + +=head2 IO::Uncompress::Unzip - Read zip files/buffers + +=over 4 + +=item SYNOPSIS -undef, A filename, A filehandle, A scalar reference, A Hash Reference, An -Array Reference +=item DESCRIPTION + +DO NOT use in production code, The documentation is incomplete in places, +Parts of the interface defined here are tentative, Please report any +problems you find + +=item Functional Interface + +=over 4 + +=item unzip $input => $output [, OPTS] + +A filename, A filehandle, A scalar reference, An array reference, An Input +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob =item Notes =item Optional Parameters -AutoClose =E<gt> 0|1, -Append =E<gt> 0|1 +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >> =item Examples @@ -19117,8 +21507,9 @@ 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<< 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 @@ -19128,15 +21519,19 @@ Filehandle, -Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1 =over 4 -=item print +=item read -=item printf +=item read -=item syswrite +=item getline -=item write +=item getc -=item flush +=item ungetc + +=item inflateSync + +=item getHeaderInfo =item tell @@ -19146,33 +21541,86 @@ Filehandle, -Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1 =item binmode +=item opened + +=item autoflush + +=item input_line_number + =item fileno =item close -=item newStream +=item nextStream -=item deflateParams +=item trailingData =back =item Importing -:all, :constants, :flush, :level, :strategy +:all =item EXAMPLES =item SEE ALSO -=item AUTHOR - -=item MODIFICATION HISTORY +=item AUTHOR + +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE + +=back + +=head2 IO::Zlib - IO:: style interface to L<Compress::Zlib> + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CONSTRUCTOR + +new ( [ARGS] ) + +=item OBJECT METHODS + +open ( FILENAME, MODE ), opened, close, getc, getline, getlines, print ( +ARGS... ), read ( BUF, NBYTES, [OFFSET] ), eof, seek ( OFFSET, WHENCE ), +tell, setpos ( POS ), getpos ( POS ) + +=item USING THE EXTERNAL GZIP + +=item CLASS METHODS + +has_Compress_Zlib, gzip_external, gzip_used, gzip_read_open, +gzip_write_open + +=item DIAGNOSTICS + +IO::Zlib::getlines: must be called in list context, +IO::Zlib::gzopen_external: mode '...' is illegal, IO::Zlib::import: '...' +is illegal, IO::Zlib::import: ':gzip_external' requires an argument, +IO::Zlib::import: 'gzip_read_open' requires an argument, IO::Zlib::import: +'gzip_read' '...' is illegal, IO::Zlib::import: 'gzip_write_open' requires +an argument, IO::Zlib::import: 'gzip_write_open' '...' is illegal, +IO::Zlib::import: no Compress::Zlib and no external gzip, IO::Zlib::open: +needs a filename, IO::Zlib::READ: NBYTES must be specified, IO::Zlib::READ: +OFFSET is not supported, IO::Zlib::WRITE: too long LENGTH, IO::Zlib::WRITE: +OFFSET is not supported + +=item SEE ALSO + +=item HISTORY -=item COPYRIGHT AND LICENSE +=item COPYRIGHT =back -=head2 IO::Dir - supply object methods for directory handles +=head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory +handles =over 4 @@ -19191,7 +21639,7 @@ rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] =back -=head2 IO::File - supply object methods for filehandles +=head2 IO::lib::IO::File, IO::File - supply object methods for filehandles =over 4 @@ -19216,7 +21664,8 @@ open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( =back -=head2 IO::Handle - supply object methods for I/O handles +=head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O +handles =over 4 @@ -19245,7 +21694,7 @@ $io->blocking ( [ BOOL ] ), $io->untaint =back -=head2 IO::Pipe - supply object methods for pipes +=head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes =over 4 @@ -19269,7 +21718,7 @@ reader ([ARGS]), writer ([ARGS]), handles () =back -=head2 IO::Poll - Object interface to system poll call +=head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call =over 4 @@ -19290,7 +21739,8 @@ IO ), handles( [ EVENT_MASK ] ) =back -=head2 IO::Seekable - supply seek based methods for I/O objects +=head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for +I/O objects =over 4 @@ -19308,7 +21758,8 @@ $io->tell =back -=head2 IO::Select - OO interface to the select system call +=head2 IO::lib::IO::Select, IO::Select - OO interface to the select system +call =over 4 @@ -19334,7 +21785,8 @@ count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) =back -=head2 IO::Socket - Object interface to socket communications +=head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket +communications =over 4 @@ -19359,7 +21811,8 @@ protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) =back -=head2 IO::Socket::INET - Object interface for AF_INET domain sockets +=head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for +AF_INET domain sockets =over 4 @@ -19388,7 +21841,8 @@ sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost =back -=head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets +=head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for +AF_UNIX domain sockets =over 4 @@ -19412,8 +21866,7 @@ hostpath(), peerpath() =back -=head2 IO::Uncompress::AnyInflate - Perl interface to read RFC 1950, 1951 & -1952 files/buffers +=head2 IPC::Msg - SysV Msg IPC object class =over 4 @@ -19421,103 +21874,21 @@ hostpath(), peerpath() =item DESCRIPTION -DO NOT use in production code, The documentation is incomplete in places, -Parts of the interface defined here are tentative, Please report any -problems you find - -=item Functional Interface - -=over 4 - -=item anyinflate $input => $output [, OPTS] - -A filename, A filehandle, A scalar reference, An array reference, An Input -FileGlob string, A filename, A filehandle, A scalar reference, A Hash -Reference, An Array Reference, An Output FileGlob - -=item anyinflate \%hash [, OPTS] - -undef, A filename, A filehandle, A scalar reference, A Hash Reference, An -Array Reference - -=item Notes - -=item Optional Parameters - -AutoClose =E<gt> 0|1, -Append =E<gt> 0|1 - -=item Examples - -=back - -=item OO Interface - -=over 4 - -=item Constructor - -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 - -=item Examples - -=back - -=item Methods - -=over 4 - -=item read - -=item read - -=item getline - -=item getc - -=item ungetc - -=item inflateSync - -=item getHeaderInfo - -=item tell - -=item eof - -=item seek - -=item binmode - -=item fileno - -=item close - -=back - -=item Importing - -:all +=item METHODS -=item EXAMPLES +new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set +( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, +FLAGS ] ), stat =item SEE ALSO =item AUTHOR -=item MODIFICATION HISTORY - -=item COPYRIGHT AND LICENSE +=item COPYRIGHT =back -=head2 IO::Uncompress::Gunzip - Perl interface to read RFC 1952 -files/buffers +=head2 IPC::Open2, open2 - open a process for both reading and writing =over 4 @@ -19525,105 +21896,53 @@ files/buffers =item DESCRIPTION -DO NOT use in production code, The documentation is incomplete in places, -Parts of the interface defined here are tentative, Please report any -problems you find - -=item Functional Interface - -=over 4 - -=item gunzip $input => $output [, OPTS] - -A filename, A filehandle, A scalar reference, An array reference, An Input -FileGlob string, A filename, A filehandle, A scalar reference, A Hash -Reference, An Array Reference, An Output FileGlob - -=item gunzip \%hash [, OPTS] - -undef, A filename, A filehandle, A scalar reference, A Hash Reference, An -Array Reference - -=item Notes - -=item Optional Parameters - -AutoClose =E<gt> 0|1, -Append =E<gt> 0|1 +=item WARNING -=item Examples +=item SEE ALSO =back -=item OO Interface +=head2 IPC::Open3, open3 - open a process for reading, writing, and error +handling =over 4 -=item Constructor +=item SYNOPSIS -A filename, A filehandle, A scalar reference +=item DESCRIPTION -=item Constructor Options +=item See Also --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 +L<IPC::Open2>, L<IPC::Run> -=item Examples +=item WARNING =back -=item Methods +=head2 IPC::Semaphore - SysV Semaphore IPC object class =over 4 -=item read - -=item read - -=item getline - -=item getc - -=item ungetc - -=item inflateSync - -=item getHeaderInfo - -Comment - -=item tell - -=item eof - -=item seek - -=item binmode - -=item fileno - -=item close - -=back +=item SYNOPSIS -=item Importing +=item DESCRIPTION -:all +=item METHODS -=item EXAMPLES +new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), +getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), +set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N +, VALUE ), stat =item SEE ALSO =item AUTHOR -=item MODIFICATION HISTORY - -=item COPYRIGHT AND LICENSE +=item COPYRIGHT =back -=head2 IO::Uncompress::Inflate - Perl interface to read RFC 1950 -files/buffers +=head2 IPC::SysV - SysV IPC constants =over 4 @@ -19631,103 +21950,83 @@ files/buffers =item DESCRIPTION -DO NOT use in production code, The documentation is incomplete in places, -Parts of the interface defined here are tentative, Please report any -problems you find - -=item Functional Interface - -=over 4 - -=item inflate $input => $output [, OPTS] - -A filename, A filehandle, A scalar reference, An array reference, An Input -FileGlob string, A filename, A filehandle, A scalar reference, A Hash -Reference, An Array Reference, An Output FileGlob - -=item inflate \%hash [, OPTS] - -undef, A filename, A filehandle, A scalar reference, A Hash Reference, An -Array Reference - -=item Notes +ftok( PATH, ID ) -=item Optional Parameters +=item SEE ALSO -AutoClose =E<gt> 0|1, -Append =E<gt> 0|1 +=item AUTHORS -=item Examples +=item COPYRIGHT =back -=item OO Interface +=head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class =over 4 -=item Constructor - -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 - -=item Examples +=item SYNOPSIS -=back +=item DESCRIPTION -=item Methods +=item METHODS -=over 4 +new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set +( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, +FLAGS ] ), stat -=item read +=item SEE ALSO -=item read +=item AUTHOR -=item getline +=item COPYRIGHT -=item getc +=back -=item ungetc +=head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object +class -=item inflateSync +=over 4 -=item getHeaderInfo +=item SYNOPSIS -=item tell +=item DESCRIPTION -=item eof +=item METHODS -=item seek +new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), +getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), +set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N +, VALUE ), stat -=item binmode +=item SEE ALSO -=item fileno +=item AUTHOR -=item close +=item COPYRIGHT =back -=item Importing +=head2 List::Util - A selection of general-utility list subroutines -:all +=over 4 -=item EXAMPLES +=item SYNOPSIS -=item SEE ALSO +=item DESCRIPTION -=item AUTHOR +first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce +BLOCK LIST, shuffle LIST, sum LIST -=item MODIFICATION HISTORY +=item KNOWN BUGS -=item COPYRIGHT AND LICENSE +=item SUGGESTED ADDITIONS + +=item COPYRIGHT =back -=head2 IO::Uncompress::RawInflate - Perl interface to read RFC 1951 -files/buffers +=head2 List::Utilib::List::Util, List::Util - A selection of +general-utility list subroutines =over 4 @@ -19735,102 +22034,108 @@ files/buffers =item DESCRIPTION -DO NOT use in production code, The documentation is incomplete in places, -Parts of the interface defined here are tentative, Please report any -problems you find +first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce +BLOCK LIST, shuffle LIST, sum LIST -=item Functional Interface +=item KNOWN BUGS -=over 4 +=item SUGGESTED ADDITIONS -=item rawinflate $input => $output [, OPTS] +=item COPYRIGHT -A filename, A filehandle, A scalar reference, An array reference, An Input -FileGlob string, A filename, A filehandle, A scalar reference, A Hash -Reference, An Array Reference, An Output FileGlob +=back -=item rawinflate \%hash [, OPTS] +=head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of +general-utility scalar subroutines -undef, A filename, A filehandle, A scalar reference, A Hash Reference, An -Array Reference +=over 4 -=item Notes +=item SYNOPSIS -=item Optional Parameters +=item DESCRIPTION + +blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR, +looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR, +set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF -AutoClose =E<gt> 0|1, -Append =E<gt> 0|1 +=item KNOWN BUGS -=item Examples +=item COPYRIGHT + +=item BLATANT PLUG =back -=item OO Interface +=head2 Locale::Constants - constants for Locale codes =over 4 -=item Constructor +=item SYNOPSIS -A filename, A filehandle, A scalar reference +=item DESCRIPTION -=item Constructor Options +=item KNOWN BUGS AND LIMITATIONS --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 +=item SEE ALSO -=item Examples +Locale::Language, Locale::Country, Locale::Script, Locale::Currency -=back +=item AUTHOR -=item Methods +=item COPYRIGHT -=over 4 +=back -=item read +=head2 Locale::Country - ISO codes for country identification (ISO 3166) -=item read +=over 4 -=item getline +=item SYNOPSIS -=item getc +=item DESCRIPTION -=item ungetc +B<alpha-2>, B<alpha-3>, B<numeric> -=item inflateSync +=item CONVERSION ROUTINES -=item getHeaderInfo +code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ), +country_code2code( CODE, CODESET, CODESET ) -=item tell +=item QUERY ROUTINES -=item eof +C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )> -=item seek +=item SEMI-PRIVATE ROUTINES -=item binmode +=over 4 -=item fileno +=item alias_code -=item close +=item rename_country =back -=item Importing +=item EXAMPLES -:all +=item DOMAIN NAMES -=item EXAMPLES +=item KNOWN BUGS AND LIMITATIONS =item SEE ALSO -=item AUTHOR +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-d-1.html -=item MODIFICATION HISTORY +=item AUTHOR -=item COPYRIGHT AND LICENSE +=item COPYRIGHT =back -=head2 IO::Zlib - IO:: style interface to L<Compress::Zlib> +=head2 Locale::Currency - ISO three letter codes for currency +identification (ISO 4217) =over 4 @@ -19838,46 +22143,33 @@ A filename, A filehandle, A scalar reference =item DESCRIPTION -=item CONSTRUCTOR - -new ( [ARGS] ) - -=item OBJECT METHODS +XTS, XXX -open ( FILENAME, MODE ), opened, close, getc, getline, getlines, print ( -ARGS... ), read ( BUF, NBYTES, [OFFSET] ), eof, seek ( OFFSET, WHENCE ), -tell, setpos ( POS ), getpos ( POS ) +=item CONVERSION ROUTINES -=item USING THE EXTERNAL GZIP +code2currency(), currency2code() -=item CLASS METHODS +=item QUERY ROUTINES -has_Compress_Zlib, gzip_external, gzip_used, gzip_read_open, -gzip_write_open +C<all_currency_codes()>, C<all_currency_names()> -=item DIAGNOSTICS +=item EXAMPLES -IO::Zlib::getlines: must be called in list context, -IO::Zlib::gzopen_external: mode '...' is illegal, IO::Zlib::import: '...' -is illegal, IO::Zlib::import: ':gzip_external' requires an argument, -IO::Zlib::import: 'gzip_read_open' requires an argument, IO::Zlib::import: -'gzip_read' '...' is illegal, IO::Zlib::import: 'gzip_write_open' requires -an argument, IO::Zlib::import: 'gzip_write_open' '...' is illegal, -IO::Zlib::import: no Compress::Zlib and no external gzip, IO::Zlib::open: -needs a filename, IO::Zlib::READ: NBYTES must be specified, IO::Zlib::READ: -OFFSET is not supported, IO::Zlib::WRITE: too long LENGTH, IO::Zlib::WRITE: -OFFSET is not supported +=item KNOWN BUGS AND LIMITATIONS =item SEE ALSO -=item HISTORY +Locale::Country, Locale::Script, ISO 4217:1995, +http://www.bsi-global.com/iso4217currency + +=item AUTHOR =item COPYRIGHT =back -=head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory -handles +=head2 Locale::Language - ISO two letter codes for language identification +(ISO 639) =over 4 @@ -19885,18 +22177,30 @@ handles =item DESCRIPTION -new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), -rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] +=item CONVERSION ROUTINES + +code2language(), language2code() + +=item QUERY ROUTINES + +C<all_language_codes()>, C<all_language_names()> + +=item EXAMPLES + +=item KNOWN BUGS AND LIMITATIONS =item SEE ALSO +Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F), +http://lcweb.loc.gov/standards/iso639-2/langhome.html + =item AUTHOR =item COPYRIGHT =back -=head2 IO::lib::IO::File, IO::File - supply object methods for filehandles +=head2 Locale::Maketext - framework for localization =over 4 @@ -19904,54 +22208,50 @@ rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] =item DESCRIPTION -=item CONSTRUCTOR - -new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile +=item QUICK OVERVIEW =item METHODS -open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( -[LAYER] ) +=over 4 -=item NOTE +=item Construction Methods -=item SEE ALSO +=item The "maketext" Method -=item HISTORY +$lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto -=back +=item Utility Methods -=head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O -handles +$language->quant($number, $singular), $language->quant($number, $singular, +$plural), $language->quant($number, $singular, $plural, $negative), +$language->numf($number), $language->sprintf($format, @items), +$language->language_tag(), $language->encoding() -=over 4 +=item Language Handle Attributes and Internals -=item SYNOPSIS +=back -=item DESCRIPTION +=item LANGUAGE CLASS HIERARCHIES -=item CONSTRUCTOR +=item ENTRIES IN EACH LEXICON -new (), new_from_fd ( FD, MODE ) +=item BRACKET NOTATION -=item METHODS +=item AUTO LEXICONS -$io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines, -$io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error, -$io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ), -$io->blocking ( [ BOOL ] ), $io->untaint +=item CONTROLLING LOOKUP FAILURE -=item NOTE +=item HOW TO USE MAKETEXT =item SEE ALSO -=item BUGS +=item COPYRIGHT AND DISCLAIMER -=item HISTORY +=item AUTHOR =back -=head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes +=head2 Locale::Maketext::TPJ13 -- article about software localization =over 4 @@ -19959,45 +22259,37 @@ $io->blocking ( [ BOOL ] ), $io->untaint =item DESCRIPTION -=item CONSTRUCTOR - -new ( [READER, WRITER] ) - -=item METHODS - -reader ([ARGS]), writer ([ARGS]), handles () +=item Localization and Perl: gettext breaks, Maketext fixes -=item SEE ALSO +=over 4 -=item AUTHOR +=item A Localization Horror Story: It Could Happen To You -=item COPYRIGHT +=item The Linguistic View -=back +=item Breaking gettext -=head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call +=item Replacing gettext -=over 4 +=item Buzzwords: Abstraction and Encapsulation -=item SYNOPSIS +=item Buzzword: Isomorphism -=item DESCRIPTION +=item Buzzword: Inheritance -=item METHODS +=item Buzzword: Concision -mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( -IO ), handles( [ EVENT_MASK ] ) +=item The Devil in the Details -=item SEE ALSO +=item The Proof in the Pudding: Localizing Web Sites -=item AUTHOR +=item References -=item COPYRIGHT +=back =back -=head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for -I/O objects +=head2 Locale::Script - ISO codes for script identification (ISO 15924) =over 4 @@ -20005,36 +22297,31 @@ I/O objects =item DESCRIPTION -$io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET), -WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ), -$io->tell +B<alpha-2>, B<alpha-3>, B<numeric> -=item SEE ALSO +=over 4 -=item HISTORY +=item SPECIAL CODES =back -=head2 IO::lib::IO::Select, IO::Select - OO interface to the select system -call - -=over 4 +=item CONVERSION ROUTINES -=item SYNOPSIS +code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ), +script_code2code( CODE, CODESET, CODESET ) -=item DESCRIPTION +=item QUERY ROUTINES -=item CONSTRUCTOR +C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )> -new ( [ HANDLES ] ) +=item EXAMPLES -=item METHODS +=item KNOWN BUGS AND LIMITATIONS -add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( -[ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), -count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) +=item SEE ALSO -=item EXAMPLE +Locale::Language, Locale::Currency, Locale::Country, ISO 15924, +http://www.evertype.com/standards/iso15924/ =item AUTHOR @@ -20042,8 +22329,7 @@ count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) =back -=head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket -communications +=head2 MIME::Base64 - Encoding and decoding of base64 strings =over 4 @@ -20051,25 +22337,23 @@ communications =item DESCRIPTION -=item CONSTRUCTOR - -new ( [ARGS] ) - -=item METHODS +encode_base64($str), encode_base64($str, $eol);, decode_base64($str) -accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, -protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) +=item DIAGNOSTICS -=item SEE ALSO +Premature end of base64 data, Premature padding of base64 data, Wide +character in subroutine entry -=item AUTHOR +=item EXAMPLES =item COPYRIGHT +=item SEE ALSO + =back -=head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for -AF_INET domain sockets +=head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding +of quoted-printable strings =over 4 @@ -20077,29 +22361,34 @@ AF_INET domain sockets =item DESCRIPTION -=item CONSTRUCTOR +encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode), +decode_qp($str); -new ( [ARGS] ) +=item COPYRIGHT -=over 4 +=item SEE ALSO -=item METHODS +=back -sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost -() +=head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable +strings -=back +=over 4 -=item SEE ALSO +=item SYNOPSIS -=item AUTHOR +=item DESCRIPTION + +encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode), +decode_qp($str); =item COPYRIGHT +=item SEE ALSO + =back -=head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for -AF_UNIX domain sockets +=head2 Math::BigFloat - Arbitrary size floating point math package =over 4 @@ -20107,60 +22396,58 @@ AF_UNIX domain sockets =item DESCRIPTION -=item CONSTRUCTOR +=over 4 -new ( [ARGS] ) +=item Canonical notation -=item METHODS +=item Output -hostpath(), peerpath() +=item C<mantissa()>, C<exponent()> and C<parts()> -=item SEE ALSO +=item Accuracy vs. Precision -=item AUTHOR +=item Rounding -=item COPYRIGHT +ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround ( +$scale +), fround ( -$scale ) and fround ( 0 ) =back -=head2 IPC::Msg - SysV Msg IPC object class +=item METHODS =over 4 -=item SYNOPSIS +=item accuracy -=item DESCRIPTION +=item precision() -=item METHODS +=back -new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set -( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, -FLAGS ] ), stat +=item Autocreating constants -=item SEE ALSO +=over 4 -=item AUTHOR +=item Math library -=item COPYRIGHT +=item Using Math::BigInt::Lite =back -=head2 IPC::Open2, open2 - open a process for both reading and writing +=item BUGS -=over 4 +=item CAVEATS -=item SYNOPSIS +stringify, bstr(), bdiv, Modifying and =, bpow, precision() vs. accuracy() -=item DESCRIPTION +=item SEE ALSO -=item WARNING +=item LICENSE -=item SEE ALSO +=item AUTHORS =back -=head2 IPC::Open3, open3 - open a process for reading, writing, and error -handling +=head2 Math::BigInt - Arbitrary size integer/float math package =over 4 @@ -20168,227 +22455,232 @@ handling =item DESCRIPTION -=item WARNING - -=back +Input, Output -=head2 IPC::Semaphore - SysV Semaphore IPC object class +=item METHODS =over 4 -=item SYNOPSIS +=item config -=item DESCRIPTION +=item accuracy -=item METHODS +=item precision -new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), -getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), -set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N -, VALUE ), stat +=item brsft -=item SEE ALSO +=item new -=item AUTHOR +=item bnan -=item COPYRIGHT +=item bzero -=back +=item binf -=head2 IPC::SysV - SysV IPC constants +=item bone -=over 4 +=item is_one()/is_zero()/is_nan()/is_inf() -=item SYNOPSIS +=item is_pos()/is_neg() -=item DESCRIPTION + $x->is_pos(); # true if > 0 + $x->is_neg(); # true if < 0 -ftok( PATH, ID ) +=item is_odd()/is_even()/is_int() -=item SEE ALSO +=item bcmp -=item AUTHORS +=item bacmp -=item COPYRIGHT +=item sign -=back +=item digit -=head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class +=item bneg -=over 4 +=item babs -=item SYNOPSIS +=item bnorm -=item DESCRIPTION +=item bnot -=item METHODS +=item binc -new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set -( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, -FLAGS ] ), stat +=item bdec -=item SEE ALSO +=item badd -=item AUTHOR +=item bsub -=item COPYRIGHT +=item bmul -=back +=item bdiv -=head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object -class +=item bmod -=over 4 +=item bmodinv -=item SYNOPSIS +=item bmodpow -=item DESCRIPTION +=item bpow -=item METHODS +=item blsft -new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), -getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), -set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N -, VALUE ), stat +=item brsft -=item SEE ALSO +=item band -=item AUTHOR +=item bior -=item COPYRIGHT +=item bxor -=back +=item bnot -=head2 List::Util - A selection of general-utility list subroutines +=item bsqrt -=over 4 +=item bfac -=item SYNOPSIS +=item round -=item DESCRIPTION +=item bround -first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce -BLOCK LIST, shuffle LIST, sum LIST +=item bfround -=item KNOWN BUGS +=item bfloor + +=item bceil + +=item bgcd + +=item blcm + +=item exponent + +=item mantissa + +=item parts + +=item copy + +=item as_int + +=item bsstr -=item SUGGESTED ADDITIONS +=item as_hex -=item COPYRIGHT +=item as_bin =back -=head2 List::Utilib::List::Util, List::Util - A selection of -general-utility list subroutines +=item ACCURACY and PRECISION =over 4 -=item SYNOPSIS - -=item DESCRIPTION +=item Precision P -first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce -BLOCK LIST, shuffle LIST, sum LIST +=item Accuracy A -=item KNOWN BUGS +=item Fallback F -=item SUGGESTED ADDITIONS +=item Rounding mode R -=item COPYRIGHT +'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy +(significant digits), Setting/Accessing, Creating numbers, Usage, +Precedence, Overriding globals, Local settings, Rounding, Default values, +Remarks =back -=head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of -general-utility scalar subroutines +=item Infinity and Not a Number + +oct()/hex(), log(-inf), exp(), cos(), sin(), atan2() + +=item INTERNALS =over 4 -=item SYNOPSIS +=item MATH LIBRARY -=item DESCRIPTION +=item SIGN -blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR, -looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR, -set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF +=item mantissa(), exponent() and parts() -=item KNOWN BUGS +=back -=item COPYRIGHT +=item EXAMPLES -=item BLATANT PLUG + use Math::BigInt; -=back +=item Autocreating constants -=head2 Locale::Constants - constants for Locale codes +=item PERFORMANCE =over 4 -=item SYNOPSIS +=item Alternative math libraries -=item DESCRIPTION +=item SUBCLASSING -=item KNOWN BUGS AND LIMITATIONS +=back -=item SEE ALSO +=item Subclassing Math::BigInt -Locale::Language, Locale::Country, Locale::Script, Locale::Currency +=item UPGRADING -=item AUTHOR +=over 4 -=item COPYRIGHT +=item Auto-upgrade -=back +bsqrt(), div(), blog() -=head2 Locale::Country - ISO codes for country identification (ISO 3166) +=back -=over 4 +=item BUGS -=item SYNOPSIS +broot() does not work, Out of Memory!, Fails to load Calc on Perl prior +5.6.0 -=item DESCRIPTION +=item CAVEATS -B<alpha-2>, B<alpha-3>, B<numeric> +bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity handling, +Modifying and =, bpow, Overloading -$x, Mixing different object types, +bsqrt(), brsft() -=item CONVERSION ROUTINES +=item LICENSE -code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ), -country_code2code( CODE, CODESET, CODESET ) +=item SEE ALSO -=item QUERY ROUTINES +=item AUTHORS -C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )> +=back -=item SEMI-PRIVATE ROUTINES +=head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt =over 4 -=item alias_code - -=item rename_country +=item SYNOPSIS -=back +=item DESCRIPTION -=item EXAMPLES +=item STORAGE -=item DOMAIN NAMES +=item METHODS -=item KNOWN BUGS AND LIMITATIONS +=item WRAP YOUR OWN -=item SEE ALSO +=item LICENSE -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-d-1.html +This program is free software; you may redistribute it and/or modify it +under +the same terms as Perl itself. -=item AUTHOR +=item AUTHORS -=item COPYRIGHT +=item SEE ALSO =back -=head2 Locale::Currency - ISO three letter codes for currency -identification (ISO 4217) +=head2 Math::BigInt::CalcEmu - Emulate low-level math with BigInt code =over 4 @@ -20396,33 +22688,32 @@ identification (ISO 4217) =item DESCRIPTION -XTS, XXX - -=item CONVERSION ROUTINES +=item METHODS -code2currency(), currency2code() +=over 4 -=item QUERY ROUTINES +=item __emu_bxor -C<all_currency_codes()>, C<all_currency_names()> +=item __emu_band -=item EXAMPLES +=item __emu_bior -=item KNOWN BUGS AND LIMITATIONS +=back -=item SEE ALSO +=item LICENSE -Locale::Country, Locale::Script, ISO 4217:1995, -http://www.bsi-global.com/iso4217currency +This program is free software; you may redistribute it and/or modify it +under +the same terms as Perl itself. -=item AUTHOR +=item AUTHORS -=item COPYRIGHT +=item SEE ALSO =back -=head2 Locale::Language - ISO two letter codes for language identification -(ISO 639) +=head2 Math::BigInt::FastCalc - Math::BigInt::Calc with some XS for more +speed =over 4 @@ -20430,30 +22721,23 @@ http://www.bsi-global.com/iso4217currency =item DESCRIPTION -=item CONVERSION ROUTINES - -code2language(), language2code() +=item STORAGE -=item QUERY ROUTINES +=item METHODS -C<all_language_codes()>, C<all_language_names()> +=item LICENSE -=item EXAMPLES +This program is free software; you may redistribute it and/or modify it +under +the same terms as Perl itself. -=item KNOWN BUGS AND LIMITATIONS +=item AUTHORS =item SEE ALSO -Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F), -http://lcweb.loc.gov/standards/iso639-2/langhome.html - -=item AUTHOR - -=item COPYRIGHT - =back -=head2 Locale::Maketext - framework for localization +=head2 Math::BigRat - Arbitrary big rational numbers =over 4 @@ -20461,187 +22745,192 @@ http://lcweb.loc.gov/standards/iso639-2/langhome.html =item DESCRIPTION -=item QUICK OVERVIEW +=over 4 + +=item MATH LIBRARY + +=back =item METHODS =over 4 -=item Construction Methods +=item new() -=item The "maketext" Method +=item numerator() -$lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto +=item denominator() -=item Utility Methods + $d = $x->denominator(); -$language->quant($number, $singular), $language->quant($number, $singular, -$plural), $language->quant($number, $singular, $plural, $negative), -$language->numf($number), $language->sprintf($format, @items), -$language->language_tag(), $language->encoding() +=item parts() -=item Language Handle Attributes and Internals +=item as_int() -=back +=item as_hex() -=item LANGUAGE CLASS HIERARCHIES +=item as_bin() -=item ENTRIES IN EACH LEXICON +=item bfac() -=item BRACKET NOTATION +=item blog() -=item AUTO LEXICONS +=item bround()/round()/bfround() -=item CONTROLLING LOOKUP FAILURE +=item bmod() -=item HOW TO USE MAKETEXT +=item is_one() -=item SEE ALSO +=item is_zero() -=item COPYRIGHT AND DISCLAIMER +=item is_pos() -=item AUTHOR +=item is_neg() -=back +=item is_int() -=head2 Locale::Maketext::TPJ13 -- article about software localization +=item is_odd() -=over 4 +=item is_even() -=item SYNOPSIS +=item bceil() -=item DESCRIPTION +=item bfloor() -=item Localization and Perl: gettext breaks, Maketext fixes + $x->bfloor(); -=over 4 +=item bsqrt() -=item A Localization Horror Story: It Could Happen To You + $x->bsqrt(); -=item The Linguistic View +=item config -=item Breaking gettext +=back -=item Replacing gettext +=item BUGS -=item Buzzwords: Abstraction and Encapsulation +inf handling (partial), NaN handling (partial), rounding (not implemented +except for bceil/bfloor), $x ** $y where $y is not an integer, bmod(), +blog(), bmodinv() and bmodpow() (partial) -=item Buzzword: Isomorphism +=item LICENSE -=item Buzzword: Inheritance +=item SEE ALSO -=item Buzzword: Concision +=item AUTHORS -=item The Devil in the Details +=back -=item The Proof in the Pudding: Localizing Web Sites +=head2 Math::Complex - complex numbers and associated mathematical +functions -=item References +=over 4 -=back +=item SYNOPSIS -=back +=item DESCRIPTION + +=item OPERATIONS + +=item CREATION -=head2 Locale::Script - ISO codes for script identification (ISO 15924) +=item DISPLAYING =over 4 -=item SYNOPSIS +=item CHANGED IN PERL 5.6 -=item DESCRIPTION +=back -B<alpha-2>, B<alpha-3>, B<numeric> +=item USAGE =over 4 -=item SPECIAL CODES +=item PI =back -=item CONVERSION ROUTINES - -code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ), -script_code2code( CODE, CODESET, CODESET ) +=item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO -=item QUERY ROUTINES +=item ERRORS DUE TO INDIGESTIBLE ARGUMENTS -C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )> +=item BUGS -=item EXAMPLES +=item AUTHORS -=item KNOWN BUGS AND LIMITATIONS +=back -=item SEE ALSO +=head2 Math::Trig - trigonometric functions -Locale::Language, Locale::Currency, Locale::Country, ISO 15924, -http://www.evertype.com/standards/iso15924/ +=over 4 -=item AUTHOR +=item SYNOPSIS -=item COPYRIGHT +=item DESCRIPTION -=back +=item TRIGONOMETRIC FUNCTIONS -=head2 MIME::Base64 - Encoding and decoding of base64 strings +B<tan> =over 4 -=item SYNOPSIS +=item ERRORS DUE TO DIVISION BY ZERO -=item DESCRIPTION +=item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS -encode_base64($str), encode_base64($str, $eol);, decode_base64($str) +=back -=item DIAGNOSTICS +=item PLANE ANGLE CONVERSIONS -Premature end of base64 data, Premature padding of base64 data, Wide -character in subroutine entry +deg2rad, grad2rad, rad2deg, grad2deg, deg2grad, rad2grad, rad2rad, deg2deg, +grad2grad -=item EXAMPLES +=item RADIAL COORDINATE CONVERSIONS -=item COPYRIGHT +=over 4 -=item SEE ALSO +=item COORDINATE SYSTEMS + +=item 3-D ANGLE CONVERSIONS + +cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian, +cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical =back -=head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding -of quoted-printable strings +=item GREAT CIRCLE DISTANCES AND DIRECTIONS =over 4 -=item SYNOPSIS +=item great_circle_distance -=item DESCRIPTION +=item great_circle_direction -encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode), -decode_qp($str); +=item great_circle_bearing -=item COPYRIGHT +=item great_circle_destination -=item SEE ALSO +=item great_circle_midpoint + +=item great_circle_waypoint =back -=head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable -strings +=item EXAMPLES =over 4 -=item SYNOPSIS - -=item DESCRIPTION +=item CAVEAT FOR GREAT CIRCLE FORMULAS -encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode), -decode_qp($str); +=back -=item COPYRIGHT +=item BUGS -=item SEE ALSO +=item AUTHORS =back -=head2 Math::BigFloat - Arbitrary size floating point math package +=head2 Memoize - Make functions faster by trading space for time =over 4 @@ -20649,265 +22938,295 @@ decode_qp($str); =item DESCRIPTION -=over 4 +=item DETAILS -=item Canonical notation +=item OPTIONS -=item Output +=over 4 -=item C<mantissa()>, C<exponent()> and C<parts()> +=item INSTALL -=item Accuracy vs. Precision +=item NORMALIZER -=item Rounding +=item C<SCALAR_CACHE>, C<LIST_CACHE> -ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround ( +$scale -), fround ( -$scale ) and fround ( 0 ) +C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE> =back -=item METHODS +=item OTHER FACILITIES =over 4 -=item accuracy +=item C<unmemoize> -=item precision() +=item C<flush_cache> =back -=item Autocreating constants - -=over 4 - -=item Math library +=item CAVEATS -=item Using Math::BigInt::Lite +=item PERSISTENT CACHE SUPPORT -=back +=item EXPIRATION SUPPORT =item BUGS -=item CAVEATS - -stringify, bstr(), bdiv, Modifying and =, bpow, precision() vs. accuracy() +=item MAILING LIST -=item SEE ALSO +=item AUTHOR -=item LICENSE +=item COPYRIGHT AND LICENSE -=item AUTHORS +=item THANK YOU =back -=head2 Math::BigInt - Arbitrary size integer/float math package +=head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for +Storable use =over 4 -=item SYNOPSIS - =item DESCRIPTION -Input, Output +=back -=item METHODS +=head2 Memoize::Expire - Plug-in module for automatic expiration of +memoized values =over 4 -=item config - -=item accuracy - -=item precision - -=item brsft +=item SYNOPSIS -=item new +=item DESCRIPTION -=item bnan +=item INTERFACE -=item bzero + TIEHASH, EXISTS, STORE -=item binf +=item ALTERNATIVES -=item bone +=item CAVEATS -=item is_one()/is_zero()/is_nan()/is_inf() +=item AUTHOR -=item is_pos()/is_neg() +=item SEE ALSO - $x->is_pos(); # true if > 0 - $x->is_neg(); # true if < 0 +=back -=item is_odd()/is_even()/is_int() +=head2 Memoize::ExpireFile - test for Memoize expiration semantics -=item bcmp +=over 4 -=item bacmp +=item DESCRIPTION -=item sign +=back -=item digit +=head2 Memoize::ExpireTest - test for Memoize expiration semantics -=item bneg +=over 4 -=item babs +=item DESCRIPTION -=item bnorm +=back -=item bnot +=head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for +Storable use -=item binc +=over 4 -=item bdec +=item DESCRIPTION -=item badd +=back -=item bsub +=head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for +Storable use -=item bmul +=over 4 -=item bdiv +=item DESCRIPTION -=item bmod +=back -=item bmodinv +=head2 Memoize::Storable - store Memoized data in Storable database -=item bmodpow +=over 4 -=item bpow +=item DESCRIPTION -=item blsft +=back -=item brsft +=head2 Module::Build - Build and install Perl modules -=item band +=over 4 -=item bior +=item SYNOPSIS -=item bxor +=item DESCRIPTION -=item bnot +=item GUIDE TO DOCUMENTATION -=item bsqrt +General Usage (L<Module::Build>), Authoring Reference +(L<Module::Build::Authoring>), API Reference (L<Module::Build::API>), +Cookbook (L<Module::Build::Cookbook>) -=item bfac +=item ACTIONS -=item round +build, clean, code, config_data, diff, dist, distcheck, distclean, distdir, +distmeta, distsign, disttest, docs, fakeinstall, help, html, install, +manifest, manpages, ppd, ppmdist, prereq_report, pure_install, realclean, +skipcheck, test, testcover, testdb, testpod, testpodcoverage, +versioninstall -=item bround +=item OPTIONS -=item bfround +=over 4 -=item bfloor +=item Command Line Options -=item bceil +quiet, use_rcfile, verbose, allow_mb_mismatch -=item bgcd +=item Default Options File (F<.modulebuildrc>) -=item blcm +=back -=item exponent +=item INSTALL PATHS -=item mantissa +lib, arch, script, bin, bindoc, libdoc, binhtml, libhtml, installdirs, +install_path, install_base, destdir, prefix -=item parts +=item MOTIVATIONS -=item copy ++, + -=item as_int +=item TO DO -=item bsstr +=item AUTHOR -=item as_hex +=item COPYRIGHT -=item as_bin +=item SEE ALSO =back -=item ACCURACY and PRECISION +=head2 Module::Build::API - API Reference for Module Authors =over 4 -=item Precision P - -=item Accuracy A - -=item Fallback F - -=item Rounding mode R +=item DESCRIPTION -'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy -(significant digits), Setting/Accessing, Creating numbers, Usage, -Precedence, Overriding globals, Local settings, Rounding, Default values, -Remarks +=over 4 -=back +=item CONSTRUCTORS -=item Infinity and Not a Number +current(), new(), add_to_cleanup, auto_features, autosplit, build_class, +build_requires, create_packlist, c_source, conflicts, create_makefile_pl, +create_readme, dist_abstract, dist_author, dist_name, dist_version, +dist_version_from, dynamic_config, extra_compiler_flags, +extra_linker_flags, get_options, type, store, default, include_dirs, +install_path, installdirs, license, apache, artistic, bsd, gpl, lgpl, mit, +mozilla, open_source, perl, restrictive, unrestricted, meta_add, +meta_merge, module_name, PL_files, pm_files, pod_files, recommends, +recursive_test_files, requires, script_files, sign, test_files, xs_files, +new_from_context(%args), resume(), subclass() -oct()/hex(), log(-inf), exp(), cos(), sin(), atan2() +=item METHODS -=item INTERNALS +add_build_element($type), add_to_cleanup(@files), args(), +autosplit_file($from, $to), base_dir(), build_requires(), +check_installed_status($module, $version), check_installed_version($module, +$version), compare_versions($v1, $op, $v2), config(), config_data($name), +config_data($name => $value), conflicts(), contains_pod($file), +copy_if_modified(%parameters), create_build_script(), current_action(), +depends_on(@actions), dir_contains($first_dir, $second_dir), +dispatch($action, %args), dist_dir(), dist_name(), dist_version(), +do_system($cmd, @args), feature($name), feature($name => $value), +have_c_compiler(), install_base_relpaths(), install_base_relpaths($type), +install_base_relpaths($type => $path), install_destination($type), +install_path(), install_path($type), install_path($type => $path), +install_types(), invoked_action(), notes(), notes($key), notes($key => +$value), orig_dir(), os_type(), prefix_relpaths(), +prefix_relpaths($installdirs), prefix_relpaths($installdirs, $type), +prefix_relpaths($installdirs, $type => $path), prepare_metadata(), +prereq_failures(), prereq_report(), prompt($message, $default), +recommends(), requires(), rscan_dir($dir, $pattern), runtime_params(), +runtime_params($key), script_files(), up_to_date($source_file, +$derived_file), up_to_date(\@source_files, \@derived_files), y_n($message, +$default) + +=item Autogenerated Accessors + +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() -=over 4 +=back -=item MATH LIBRARY +=item AUTHOR -=item SIGN +=item COPYRIGHT -=item mantissa(), exponent() and parts() +=item SEE ALSO =back -=item EXAMPLES +=head2 Module::Build::Authoring - Authoring Module::Build modules - use Math::BigInt; +=over 4 -=item Autocreating constants +=item DESCRIPTION -=item PERFORMANCE +=item STRUCTURE -=over 4 +=item SUBCLASSING -=item Alternative math libraries +=item PREREQUISITES -=item SUBCLASSING +=over 4 + +=item Format of prerequisites =back -=item Subclassing Math::BigInt +=item SAVING CONFIGURATION INFORMATION -=item UPGRADING +=item STARTING MODULE DEVELOPMENT -=over 4 +=item AUTOMATION -=item Auto-upgrade +=item MIGRATION -bsqrt(), div(), blog() +=item AUTHOR + +=item SEE ALSO =back -=item BUGS +=head2 Module::Build::Base - Default methods for Module::Build -broot() does not work, Out of Memory!, Fails to load Calc on Perl prior -5.6.0 +=over 4 -=item CAVEATS +=item SYNOPSIS -bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity handling, -Modifying and =, bpow, Overloading -$x, Mixing different object types, -bsqrt(), brsft() +=item DESCRIPTION -=item LICENSE +=item AUTHOR -=item SEE ALSO +=item COPYRIGHT -=item AUTHORS +=item SEE ALSO =back -=head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt +=head2 Module::Build::Compat - Compatibility with ExtUtils::MakeMaker =over 4 @@ -20915,25 +23234,22 @@ bsqrt(), brsft() =item DESCRIPTION -=item STORAGE - =item METHODS -=item WRAP YOUR OWN +create_makefile_pl($style, $build), small, passthrough, traditional, +run_build_pl(args => \@ARGV), args, script, write_makefile(), makefile -=item LICENSE +=item SCENARIOS -This program is free software; you may redistribute it and/or modify it -under -the same terms as Perl itself. +=item AUTHOR -=item AUTHORS +=item COPYRIGHT =item SEE ALSO =back -=head2 Math::BigInt::CalcEmu - Emulate low-level math with BigInt code +=head2 Module::Build::ConfigData - Configuration for Module::Build =over 4 @@ -20943,284 +23259,331 @@ the same terms as Perl itself. =item METHODS +config($name), feature($name), set_config($name, $value), +set_feature($name, $value), config_names(), feature_names(), +auto_feature_names(), write() + +=item AUTHOR + +=back + +=head2 Module::Build::Cookbook - Examples of Module::Build Usage + =over 4 -=item __emu_bxor +=item DESCRIPTION -=item __emu_band +=item BASIC RECIPES -=item __emu_bior +=over 4 -=back +=item The basic installation recipe for modules that use Module::Build -=item LICENSE +=item Making a CPAN.pm-compatible distribution -This program is free software; you may redistribute it and/or modify it -under -the same terms as Perl itself. +=item Installing modules using the programmatic interface -=item AUTHORS +=item Installing to a temporary directory -=item SEE ALSO +=item Installing to a non-standard directory + +=item Installing in the same location as ExtUtils::MakeMaker + +=item Running a single test file =back -=head2 Math::BigInt::FastCalc - Math::BigInt::Calc with some XS for more -speed +=item ADVANCED RECIPES =over 4 -=item SYNOPSIS +=item Changing the order of the build process -=item DESCRIPTION +=item Adding new file types to the build process -=item STORAGE +=item Adding new elements to the install process -=item METHODS +=back -=item LICENSE +=item EXAMPLES ON CPAN -This program is free software; you may redistribute it and/or modify it -under -the same terms as Perl itself. +=over 4 -=item AUTHORS +=item SVN-Notify-Mirror + +1. Using C<auto_features>, I check to see whether two optional modules are +available - SVN::Notify::Config and Net::SSH;, 2. If the S::N::Config +module is loaded, I automatically generate testfiles for it during Build +(using the C<PL_files> property), 3. If the C<ssh_feature> is available, I +ask if the user wishes to perform the ssh tests (since it requires a little +preliminary setup);, 4. Only if the user has C<ssh_feature> and answers yes +to the testing, do I generate a test file + +=item Modifying an action + +=back + +=item AUTHOR + +=item COPYRIGHT =item SEE ALSO =back -=head2 Math::BigRat - Arbitrary big rational numbers +=head2 Module::Build::ModuleInfo, ModuleInfo - Gather package and POD +information from a perl module files =over 4 -=item SYNOPSIS - =item DESCRIPTION -=over 4 +new_from_file($filename, collect_pod => 1), new_from_module($module, +collect_pod => 1, inc => \@dirs), name(), version($package), filename(), +packages_inside(), pod_inside(), contains_pod(), pod($section), +find_module_by_name($module, \@dirs), find_module_dir_by_name($module, +\@dirs) -=item MATH LIBRARY +=item AUTHOR + +=item COPYRIGHT + +=item SEE ALSO =back -=item METHODS +=head2 Module::Build::Notes, $notes_name - Configuration for $module_name =over 4 -=item new() +=item SYNOPSIS -=item numerator() +=item DESCRIPTION -=item denominator() +=item METHODS - $d = $x->denominator(); +config(\$name), feature(\$name), set_config(\$name, \$value), +set_feature(\$name, \$value), config_names(), feature_names(), +auto_feature_names(), write() -=item parts() +=item AUTHOR -=item as_int() +=back -=item as_hex() +=head2 Module::Build::PPMMaker - Perl Package Manager file creation -=item as_bin() +=over 4 -=item bfac() +=item SYNOPSIS -=item blog() +=item DESCRIPTION -=item bround()/round()/bfround() +=item AUTHOR -=item bmod() +=item COPYRIGHT -=item is_one() +=item SEE ALSO -=item is_zero() +=back -=item is_pos() +=head2 Module::Build::Platform::Amiga - Builder class for Amiga platforms -=item is_neg() +=over 4 -=item is_int() +=item DESCRIPTION -=item is_odd() +=item AUTHOR -=item is_even() +=item SEE ALSO -=item bceil() +=back -=item bfloor() +=head2 Module::Build::Platform::Default - Stub class for unknown platforms - $x->bfloor(); +=over 4 -=item bsqrt() +=item DESCRIPTION - $x->bsqrt(); +=item AUTHOR -=item config +=item SEE ALSO =back -=item BUGS +=head2 Module::Build::Platform::EBCDIC - Builder class for EBCDIC platforms -inf handling (partial), NaN handling (partial), rounding (not implemented -except for bceil/bfloor), $x ** $y where $y is not an integer, bmod(), -blog(), bmodinv() and bmodpow() (partial) +=over 4 -=item LICENSE +=item DESCRIPTION -=item SEE ALSO +=item AUTHOR -=item AUTHORS +=item SEE ALSO =back -=head2 Math::Complex - complex numbers and associated mathematical -functions +=head2 Module::Build::Platform::MPEiX - Builder class for MPEiX platforms =over 4 -=item SYNOPSIS - =item DESCRIPTION -=item OPERATIONS +=item AUTHOR -=item CREATION +=item SEE ALSO -=item DISPLAYING +=back + +=head2 Module::Build::Platform::MacOS - Builder class for MacOS platforms =over 4 -=item CHANGED IN PERL 5.6 +=item DESCRIPTION -=back +=over 4 -=item USAGE +=item Overriden Methods -=item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO +new(), make_executable(), dispatch(), ACTION_realclean() -=item ERRORS DUE TO INDIGESTIBLE ARGUMENTS +=back -=item BUGS +=item AUTHOR -=item AUTHORS +=item SEE ALSO =back -=head2 Math::Trig - trigonometric functions +=head2 Module::Build::Platform::RiscOS - Builder class for RiscOS platforms =over 4 -=item SYNOPSIS - =item DESCRIPTION -=item TRIGONOMETRIC FUNCTIONS +=item AUTHOR -B<tan> +=item SEE ALSO + +=back + +=head2 Module::Build::Platform::Unix - Builder class for Unix platforms =over 4 -=item ERRORS DUE TO DIVISION BY ZERO +=item DESCRIPTION -=item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS +=item AUTHOR + +=item SEE ALSO =back -=item PLANE ANGLE CONVERSIONS +=head2 Module::Build::Platform::VMS - Builder class for VMS platforms -=item RADIAL COORDINATE CONVERSIONS +=over 4 + +=item DESCRIPTION =over 4 -=item COORDINATE SYSTEMS +=item Overridden Methods -=item 3-D ANGLE CONVERSIONS +new -cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian, -cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical +=back =back -=item GREAT CIRCLE DISTANCES AND DIRECTIONS +cull_args -=item EXAMPLES +manpage_separator + +prefixify =over 4 -=item CAVEAT FOR GREAT CIRCLE FORMULAS +=item AUTHOR + +=item SEE ALSO =back -=item BUGS +=head2 Module::Build::Platform::VOS - Builder class for VOS platforms -=item AUTHORS +=over 4 + +=item DESCRIPTION + +=item AUTHOR + +=item SEE ALSO =back -=head2 Memoize - Make functions faster by trading space for time +=head2 Module::Build::Platform::Windows - Builder class for Windows +platforms =over 4 -=item SYNOPSIS - =item DESCRIPTION -=item DETAILS +=item AUTHOR -=item OPTIONS +=item SEE ALSO -=over 4 +=back -=item INSTALL +=head2 Module::Build::Platform::aix - Builder class for AIX platform -=item NORMALIZER +=over 4 -=item C<SCALAR_CACHE>, C<LIST_CACHE> +=item DESCRIPTION -C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE> +=item AUTHOR + +=item SEE ALSO =back -=item OTHER FACILITIES +=head2 Module::Build::Platform::cygwin - Builder class for Cygwin platform =over 4 -=item C<unmemoize> - -=item C<flush_cache> +=item DESCRIPTION -=back +=item AUTHOR -=item CAVEATS +=item SEE ALSO -=item PERSISTENT CACHE SUPPORT +=back -=item EXPIRATION SUPPORT +=head2 Module::Build::Platform::darwin - Builder class for Mac OS X +platform -=item BUGS +=over 4 -=item MAILING LIST +=item DESCRIPTION =item AUTHOR -=item COPYRIGHT AND LICENSE - -=item THANK YOU +=item SEE ALSO =back -=head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for -Storable use +=head2 Module::Build::Platform::os2 - Builder class for OS/2 platform =over 4 =item DESCRIPTION +=item AUTHOR + +=item SEE ALSO + =back -=head2 Memoize::Expire - Plug-in module for automatic expiration of -memoized values +=head2 Module::Build::YAML - Provides just enough YAML support so that +Module::Build works even if YAML.pm is not installed =over 4 @@ -21228,80 +23591,86 @@ memoized values =item DESCRIPTION -=item INTERFACE +=item AUTHOR - TIEHASH, EXISTS, STORE +=item COPYRIGHT -=item ALTERNATIVES +=back + +=head2 Module::CoreList - what modules shipped with versions of perl + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION =item CAVEATS +=item HISTORY + =item AUTHOR +=item COPYRIGHT + =item SEE ALSO =back -=head2 Memoize::ExpireFile - test for Memoize expiration semantics +=head2 Module::Load - runtime require of both modules and files =over 4 +=item SYNOPSIS + =item DESCRIPTION -=back +=item Rules -=head2 Memoize::ExpireTest - test for Memoize expiration semantics +=item Caveats -=over 4 +=item AUTHOR -=item DESCRIPTION +=item COPYRIGHT =back -=head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for -Storable use +=head2 Module::Loaded - mark modules as loaded or unloaded =over 4 -=item DESCRIPTION +=item SYNOPSIS -=back +=item DESCRIPTION -=head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for -Storable use +=item FUNCTIONS =over 4 -=item DESCRIPTION +=item $bool = mark_as_loaded( PACKAGE ); =back -=head2 Memoize::Storable - store Memoized data in Storable database +=back =over 4 -=item DESCRIPTION +=item $bool = mark_as_unloaded( PACKAGE ); =back -=head2 Module::CoreList - what modules shipped with versions of perl - =over 4 -=item SYNOPSIS - -=item DESCRIPTION +=item $loc = is_loaded( PACKAGE ); -=item CAVEATS +=back -=item HISTORY +=over 4 =item AUTHOR =item COPYRIGHT -=item SEE ALSO - =back =head2 NDBM_File - Tied access to ndbm files @@ -22106,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 @@ -22370,13 +24777,21 @@ C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt> =item DESCRIPTION -=item ARGUMENTS +=item FUNCTIONS + +=over 4 + +=item pod2html backlink, cachedir, css, flush, header, help, hiddendirs, htmldir, htmlroot, index, infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse, title, verbose -=item EXAMPLE +=item htmlify + +=item anchorify + +=back =item ENVIRONMENT @@ -24169,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 @@ -24386,14 +26803,14 @@ path not available =item SEE ALSO -=item AUTHOR +=item AUTHORS =item BUGS =item SUPPORT AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request -tracker, Search CPAN +tracker, Search CPAN, Kobes' CPAN Search, Perl Documentation =item LICENSE @@ -24445,14 +26862,14 @@ path not available =item SEE ALSO -=item AUTHOR +=item AUTHORS =item BUGS =item SUPPORT AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request -tracker, Search CPAN +tracker, Search CPAN, Kobes' CPAN Search, Perl Documentation =item LICENSE @@ -24782,7 +27199,7 @@ Test::Builder =over 4 -=item Methods +=item Functions test_out, test_err @@ -24856,26 +27273,25 @@ C<$Test::Harness::Timer> =item Failure -B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of -Failed> +B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<List of Failed> -=item Functions +=back -B<runtests> +=item FUNCTIONS -=back +=over 4 -=back +=item runtests( @test_files ) -B<_all_ok> +=back -B<_globdir> +=back -B<_run_all_tests> +=over 4 -B<_mk_leader> +=item execute_tests( tests => \@test_files, out => \*FH ) -B<_leader_width> +=back =over 4 @@ -24895,8 +27311,8 @@ C<HARNESS_ACTIVE>, C<HARNESS_VERSION> =item ENVIRONMENT VARIABLES THAT AFFECT TEST::HARNESS C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>, C<HARNESS_DEBUG>, -C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>, -C<HARNESS_PERL>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE> +C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_NOTTY>, C<HARNESS_PERL>, +C<HARNESS_PERL_SWITCHES>, C<HARNESS_TIMER>, C<HARNESS_VERBOSE> =item EXAMPLE @@ -24906,6 +27322,13 @@ C<HARNESS_PERL>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE> =item BUGS +=item SUPPORT + +AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request +tracker, Search CPAN + +=item SOURCE CODE + =item AUTHORS =item COPYRIGHT @@ -25006,12 +27429,6 @@ ok, number =over 4 -=item $strap->_init - -=back - -=over 4 - =item ANALYSIS =over 4 @@ -25024,86 +27441,14 @@ ok, number =over 4 -=item $strap->analyze_fh( $name, $test_filehandle ) - -=back - -=over 4 - =item $strap->analyze_file( $test_file ) =back =over 4 -=item $strap->_command_line( $file ) - -=back - -=over 4 - -=item $strap->_command() - -=back - -=over 4 - -=item $strap->_switches( $file ) - -=back - -=over 4 - -=item $strap->_cleaned_switches( @switches_from_user ) - -=back - -=over 4 - -=item $strap->_INC2PERL5LIB - -=back - -=over 4 - -=item $strap->_filtered_INC() - -=back - -=over 4 - -=item $strap->_restore_PERL5LIB() - -=back - -=over 4 - =item Parsing -=over 4 - -=item C<_is_diagnostic> - -=back - -=back - -=over 4 - -=item C<_is_header> - -=back - -=over 4 - -=item C<_is_bail_out> - -=back - -=over 4 - -=item C<_reset_file_state> - =back =over 4 @@ -25186,6 +27531,25 @@ C<ok> or C<not ok>, Test number, Description, Directive, ok/not ok =back +=item Non-Perl TAP + +=over 4 + +=item C/C++ + +Specify a test plan, Run tests, Skip tests in certain situations, Have TODO +tests, Produce TAP compatible diagnostics + +=item Python + +=item JavaScript + +=item PHP + +phpt, PHPUnit, SimpleTest, Apache-Test + +=back + =item AUTHORS =item ACKNOWLEDGEMENTS @@ -25194,6 +27558,36 @@ C<ok> or C<not ok>, Test number, Description, Directive, ok/not ok =back +=head2 Test::Harness::Util - Utility functions for Test::Harness::* + +=over 4 + +=item SYNOPSIS + +=item PUBLIC FUNCTIONS + +=over 4 + +=item all_in( {parm => value, parm => value} ) + +start, recurse + +=back + +=back + +=over 4 + +=item shuffle( @list ) + +=back + +=over 4 + +=item blibdir() + +=back + =head2 Test::More - yet another framework for writing test scripts =over 4 @@ -25450,6 +27844,8 @@ C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>, =item C<gen_delimited_pat> +=item C<delimited_pat> + =back =item DIAGNOSTICS @@ -25517,6 +27913,8 @@ unexpand(1) =item DESCRIPTION +=item EXAMPLE + =item BUGS =item LICENSE @@ -25533,7 +27931,7 @@ unexpand(1) =item OVERRIDES -=item EXAMPLE +=item EXAMPLES =item LICENSE @@ -25778,9 +28176,15 @@ this, SCALAR this =item EXAMPLE -=item AUTHOR +=item THREAD SUPPORT -=item VERSION +=item STORABLE SUPPORT + +=item RELIC SUPPORT + +=item MAINTAINER + +=item AUTHOR =item SEE ALSO @@ -25862,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) @@ -25933,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 @@ -26022,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 @@ -26035,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 @@ -26057,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/