From: Nicholas Clark Date: Wed, 11 Apr 2007 14:15:19 +0000 (+0000) Subject: Run pod/buildtoc --build-all X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=f4fee1ae61e02e37337727b540a7d3ca4e7b7d0e;p=p5sagit%2Fp5-mst-13.2.git Run pod/buildtoc --build-all p4raw-id: //depot/perl@30910 --- diff --git a/MANIFEST b/MANIFEST index bcb74cc..3ddb745 100644 --- a/MANIFEST +++ b/MANIFEST @@ -2170,8 +2170,8 @@ lib/Module/Build/t/pod_parser.t Module::Build lib/Module/Build/t/ppm.t Module::Build lib/Module/Build/t/runthrough.t Module::Build lib/Module/Build/t/signature.t Module::Build -lib/Module/Build/t/test_type.t Module::Build lib/Module/Build/t/test_types.t Module::Build +lib/Module/Build/t/test_type.t Module::Build lib/Module/Build/t/tilde.t Module::Build lib/Module/Build/t/versions.t Module::Build lib/Module/Build/t/xs.t Module::Build diff --git a/pod/perltoc.pod b/pod/perltoc.pod index 73e53a1..2a3594a 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -337,8 +337,22 @@ X X X =item Extracting matches +=item Backreferences + +=item Relative backreferences + +=item Named backreferences + +=item Alternative capture group numbering + +=item Position information + +=item Non-capturing groupings + =item Matching repetitions +=item Possessive quantifiers + =item Building a regexp =item Using regular expressions in Perl @@ -353,9 +367,9 @@ X X X =item Compiling and saving regular expressions -=item Embedding comments and modifiers in a regular expression +=item Composing regular expressions at runtime -=item Non-capturing groupings +=item Embedding comments and modifiers in a regular expression =item Looking ahead and looking behind @@ -363,8 +377,14 @@ X X X =item Conditional expressions +=item Defining named patterns + +=item Recursive patterns + =item A bit of magic: executing Perl code in a regular expression +=item Backtracking control verbs + =item Pragmas and debugging =back @@ -808,7 +828,7 @@ LIMIT specified =back -=head2 perlfaq - frequently asked questions about Perl ($Revision: 3606 $) +=head2 perlfaq - frequently asked questions about Perl =over 4 @@ -863,7 +883,7 @@ Interaction, perlfaq9 - Networking =back -=head2 perlfaq1 - General Questions About Perl ($Revision: 3606 $) +=head2 perlfaq1 - General Questions About Perl ($Revision: 8539 $) =over 4 @@ -879,7 +899,7 @@ Interaction, perlfaq9 - Networking =item What are perl4, perl5, or perl6? -=item What is Ponie? +=item What was Ponie? =item What is perl6? @@ -915,7 +935,7 @@ http://www.perl.org/advocacy/whyperl.html =back -=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 3606 $) +=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 8539 $) =over 4 @@ -970,7 +990,7 @@ References, Tutorials, Task-Oriented, Special Topics =back -=head2 perlfaq3 - Programming Tools ($Revision: 3606 $) +=head2 perlfaq3 - Programming Tools ($Revision: 8539 $) =over 4 @@ -1028,8 +1048,6 @@ stringification, Pass by reference, Tie large variables to disk =item How can I compile my Perl program into byte code or C? -=item How can I compile Perl into Java? - =item How can I get C<#!perl> to work on [MS-DOS,NT,...]? =item Can I write useful Perl programs on the command line? @@ -1057,7 +1075,7 @@ program; what am I doing wrong? =back -=head2 perlfaq4 - Data Manipulation ($Revision: 3606 $) +=head2 perlfaq4 - Data Manipulation ($Revision: 8539 $) =over 4 @@ -1114,7 +1132,7 @@ from decimal to binary =item How do I find yesterday's date? -=item Does Perl have a Year 2000 problem? Is Perl Y2K compliant? +=item Does Perl have a Year 2000 problem? Is Perl Y2K compliant? =back @@ -1226,6 +1244,7 @@ it? =item How do I sort a hash (optionally by value instead of key)? =item How can I always keep my hash sorted? +X =item What's the difference between "delete" and "undef" with hashes? @@ -1275,7 +1294,7 @@ array of hashes or arrays? =back -=head2 perlfaq5 - Files and Formats ($Revision: 3606 $) +=head2 perlfaq5 - Files and Formats ($Revision: 8579 $) =over 4 @@ -1286,8 +1305,8 @@ array of hashes or arrays? =item How do I flush/unbuffer an output filehandle? Why must I do this? X X X X -=item How do I change one line in a file/delete a line in a file/insert a -line in the middle of a file/append to the beginning of a file? +=item How do I change, delete, or insert a line in a file, or append to the +beginning of a file? X =item How do I count the number of lines in a file? @@ -1306,7 +1325,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? @@ -1378,13 +1397,13 @@ X X =item How can I tell whether there's a character waiting on a filehandle? =item How do I do a C in perl? -X +X X X X =item How do I dup() a filehandle in Perl? X =item How do I close a file descriptor by number? -X +X X X =item Why can't I use "C:\temp\foo" in DOS paths? Why doesn't `C:\temp\foo.exe` work? @@ -1409,7 +1428,7 @@ X =back -=head2 perlfaq6 - Regular Expressions ($Revision: 3606 $) +=head2 perlfaq6 - Regular Expressions ($Revision: 8539 $) =over 4 @@ -1450,7 +1469,7 @@ X X X X =item What is C really for? -X +X X =item How do I use a regular expression to strip C style comments from a file? @@ -1491,9 +1510,12 @@ X =item How can I match strings with multibyte characters? X X -X +X X X -=item How do I match a pattern that is supplied by the user? +=item How do I match a regular expression that's in a variable? +X X X X X<\Q, regex> +X<\E, regex>, X =back @@ -1503,7 +1525,7 @@ X =back -=head2 perlfaq7 - General Perl Language Issues ($Revision: 3606 $) +=head2 perlfaq7 - General Perl Language Issues ($Revision: 9309 $) =over 4 @@ -1586,7 +1608,7 @@ methods? =back -=head2 perlfaq8 - System Interaction ($Revision: 3606 $) +=head2 perlfaq8 - System Interaction ($Revision: 8539 $) =over 4 @@ -1717,7 +1739,7 @@ search path? =back -=head2 perlfaq9 - Networking ($Revision: 3606 $) +=head2 perlfaq9 - Networking ($Revision: 8539 $) =over 4 @@ -1739,7 +1761,7 @@ Server Error) =item How do I download a file from the user's machine? How do I open a file on another machine? -=item How do I make a pop-up menu in HTML? +=item How do I make an HTML pop-up menu with Perl? =item How do I fetch an HTML file? @@ -1993,18 +2015,22 @@ 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<''>, -'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<<< << >>>, Double Quotes, Single -Quotes, Backticks +qr/STRING/msixpo X X X X X X X

, +m/PATTERN/msixpogc X X X X +X X X X X X X

X X X, +/PATTERN/msixpogc, ?PATTERN? X, s/PATTERN/REPLACEMENT/msixpogce +X X X X X X X X X X

X X X X + +=item Quote-Like Operators +X + +q/STRING/ X X X<'> X<''>, 'STRING', qq/STRING/ X +X X<"> X<"">, "STRING", qx/STRING/ X X<`> X<``> +X, `STRING`, qw/STRING/ X X X, +tr/SEARCHLIST/REPLACEMENTLIST/cds X X X X X +X, y/SEARCHLIST/REPLACEMENTLIST/cds, < X +X X<<< << >>>, Double Quotes, Single Quotes, Backticks =item Gory details of parsing quoted constructs X @@ -2206,35 +2232,35 @@ X, mkdir FILENAME, mkdir, msgctl ID,CMD,ARG X, msgget KEY,FLAGS X, msgrcv ID,VAR,SIZE,TYPE,FLAGS X, msgsnd ID,MSG,FLAGS X, my EXPR X, my TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS, next LABEL X X, next, no Module VERSION -LIST X, no Module VERSION, no Module LIST, no Module, oct EXPR X -X X X X X, oct, open FILEHANDLE,EXPR -X X X X, open FILEHANDLE,MODE,EXPR, open -FILEHANDLE,MODE,EXPR,LIST, open FILEHANDLE,MODE,REFERENCE, open FILEHANDLE, -opendir DIRHANDLE,EXPR X, ord EXPR X X, ord, our -EXPR X X, our TYPE EXPR, our EXPR : ATTRS, our TYPE EXPR : -ATTRS, pack TEMPLATE,LIST X, package NAMESPACE X X -X, package, pipe READHANDLE,WRITEHANDLE X, pop ARRAY -X X, pop, pos SCALAR X X, pos, print -FILEHANDLE LIST X, print LIST, print, printf FILEHANDLE FORMAT, LIST -X, printf FORMAT, LIST, prototype FUNCTION X, push -ARRAY,LIST X, X, q/STRING/, qq/STRING/, qr/STRING/, -qx/STRING/, qw/STRING/, quotemeta EXPR X X, -quotemeta, rand EXPR X X, rand, read -FILEHANDLE,SCALAR,LENGTH,OFFSET X X, read -FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE X, readline EXPR -X X X, readlink EXPR X, readlink, readpipe -EXPR X, recv SOCKET,SCALAR,LENGTH,FLAGS X, redo LABEL -X, redo, ref EXPR X X, ref, rename OLDNAME,NEWNAME -X X X X, require VERSION X, require EXPR, -require, reset EXPR X, reset, return EXPR X, return, reverse -LIST X X X, rewinddir DIRHANDLE X, rindex -STR,SUBSTR,POSITION X, rindex STR,SUBSTR, rmdir FILENAME X -X X, rmdir, s///, say FILEHANDLE LIST X, say -LIST, say, scalar EXPR X X, seek -FILEHANDLE,POSITION,WHENCE X X X, -seekdir DIRHANDLE,POS X, select FILEHANDLE X, semctl -ID,SEMNUM,CMD,ARG X, semget KEY,NSEMS,FLAGS X, semop +LIST X, no Module VERSION, no Module LIST, no Module, no VERSION, oct +EXPR X X X X X X, oct, open +FILEHANDLE,EXPR X X X X, open +FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST, open +FILEHANDLE,MODE,REFERENCE, open FILEHANDLE, opendir DIRHANDLE,EXPR +X, ord EXPR X X, ord, our EXPR X X, +our TYPE EXPR, our EXPR : ATTRS, our TYPE EXPR : ATTRS, pack TEMPLATE,LIST +X, package NAMESPACE X X X, package, pipe +READHANDLE,WRITEHANDLE X, pop ARRAY X X, pop, pos SCALAR +X X, pos, print FILEHANDLE LIST X, print LIST, +print, printf FILEHANDLE FORMAT, LIST X, printf FORMAT, LIST, +prototype FUNCTION X, push ARRAY,LIST X X, +q/STRING/, qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR +X X, quotemeta, rand EXPR X X, +rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET X X, read +FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE X, readline EXPR, +readline X X X, readlink EXPR X, readlink, +readpipe EXPR, readpipe X, recv SOCKET,SCALAR,LENGTH,FLAGS +X, redo LABEL X, redo, ref EXPR X X, ref, +rename OLDNAME,NEWNAME X X X X, require VERSION +X, require EXPR, require, reset EXPR X, reset, return EXPR +X, return, reverse LIST X X X, rewinddir +DIRHANDLE X, rindex STR,SUBSTR,POSITION X, rindex +STR,SUBSTR, rmdir FILENAME X X X, rmdir, +s///, say FILEHANDLE LIST X, say LIST, say, scalar EXPR X +X, seek FILEHANDLE,POSITION,WHENCE X X X, seekdir DIRHANDLE,POS X, select FILEHANDLE X, +semctl ID,SEMNUM,CMD,ARG X, semget KEY,NSEMS,FLAGS X, semop KEY,OPSTRING X, send SOCKET,MSG,FLAGS,TO X, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP X X, setpriority WHICH,WHO,PRIORITY X X X X, setsockopt @@ -2755,13 +2781,14 @@ X =item Predefined Names $ARG, $_ X<$_> X<$ARG>, $a, $b X<$a> X<$b>, $> 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, -IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/ -X<$/> X<$RS> X<$INPUT_RECORD_SEPARATOR>, HANDLE->autoflush(EXPR), +$MATCH, $& X<$&> X<$MATCH>, ${^MATCH} X<${^MATCH}>, $PREMATCH, $` X<$`> +X<$PREMATCH>, ${^PREMATCH} X<${^PREMATCH}>, $POSTMATCH, $' X<$'> +X<$POSTMATCH>, ${^POSTMATCH} X<${^POSTMATCH}>, $LAST_PAREN_MATCH, $+ X<$+> +X<$LAST_PAREN_MATCH>, $^N X<$^N>, @LAST_MATCH_END, @+ X<@+> +X<@LAST_MATCH_END>, %+ X<%+>, HANDLE->input_line_number(EXPR), +$INPUT_LINE_NUMBER, $NR, $. X<$.> X<$NR> X<$INPUT_LINE_NUMBER> X, IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, +$RS, $/ X<$/> X<$RS> X<$INPUT_RECORD_SEPARATOR>, HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $| X<$|> X X X<$OUTPUT_AUTOFLUSH>, IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $, X<$,> X<$OFS> X<$OUTPUT_FIELD_SEPARATOR>, @@ -2777,8 +2804,8 @@ X<@-> X<@LAST_MATCH_START>, C<$`> is the same as C, C<$&> is the same as C, C<$'> is the same as C, C<$1> is the same as C, C<$2> is the same as C, C<$3> is the same as C, -HANDLE->format_name(EXPR), $FORMAT_NAME, $~ X<$~> X<$FORMAT_NAME>, +$-[2])>, C<$3> is the same as C, %- +X<%->, 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, @@ -2825,13 +2852,16 @@ X X =item DESCRIPTION -i X X X X, m X X X X, s X X -X X, x X - =over 4 +=item Modifiers + +m X X X X, s X X X X, i X X X X, x X, p X

+X X + =item Regular Expressions [1], [2], [3], cntrl X, graph X, print X, punct @@ -2839,18 +2869,34 @@ X, xdigit X =item Extended Patterns -C<(?#text)> X<(?#)>, C<(?imsx-imsx)> X<(?)>, C<(?:pattern)> X<(?:)>, -C<(?imsx-imsx:pattern)>, C<(?=pattern)> X<(?=)> X -X, C<(?!pattern)> X<(?!)> X -X, C<(?<=pattern)> X<(?<=)> X -X, C<(? X<(? X -X, C<(?{ code })> X<(?{})> X -X X, C<(??{ code })> -X<(??{})> X X X X X X, C<< (?>pattern) >> X X, -C<(?(condition)yes-pattern|no-pattern)> X<(?()>, -C<(?(condition)yes-pattern)> +C<(?#text)> X<(?#)>, C<(?kimsx-imsx)> X<(?)>, C<(?:pattern)> X<(?:)>, +C<(?imsx-imsx:pattern)>, C<(?|pattern)> X<(?|)> X, +Look-Around Assertions X X +X X, C<(?=pattern)> X<(?=)> X X, C<(?!pattern)> X<(?!)> X X, C<(?<=pattern)> C<\K> X<(?<=)> +X X X<\K>, C<(? +X<(? X X, +C<(?'NAME'pattern)>, C<< (?pattern) >> X<< (?) >> X<(?'NAME')> +X X, C<< \k >>, C<< \k'NAME' >>, C<(?{ code +})> X<(?{})> X X X, C<(??{ code })> X<(??{})> X X X, C<(?PARNO)> C<(?-PARNO)> +C<(?+PARNO)> C<(?R)> C<(?0)> X<(?PARNO)> X<(?1)> X<(?R)> X<(?0)> X<(?-1)> +X<(?+1)> X<(?-PARNO)> X<(?+PARNO)> X X +X X, C<(?&NAME)> +X<(?&NAME)>, C<(?(condition)yes-pattern|no-pattern)> X<(?()>, +C<(?(condition)yes-pattern)>, (1) (2) .., () ('NAME'), (?{ CODE }), +(R), (R1) (R2) .., (R&NAME), (DEFINE), C<< (?>pattern) >> X +X X X + +=item Special Backtracking Control Verbs + +Verbs that take an argument, C<(*PRUNE)> C<(*PRUNE:NAME)> X<(*PRUNE)> +X<(*PRUNE:NAME)> X<\v>, C<(*SKIP)> C<(*SKIP:NAME)> X<(*SKIP)>, +C<(*MARK:NAME)> C<(*:NAME)> X<(*MARK)> C<(*MARK:NAME)> C<(*:NAME)>, +C<(*THEN)> C<(*THEN:NAME)>, C<(*COMMIT)> X<(*COMMIT)>, Verbs without an +argument, C<(*FAIL)> C<(*F)> X<(*FAIL)> X<(*F)>, C<(*ACCEPT)> X<(*ACCEPT)> =item Backtracking X X @@ -2858,21 +2904,25 @@ X X =item Version 8 Regular Expressions X X X -=item Warning on \1 vs $1 +=item Warning on \1 Instead of $1 -=item Repeated patterns matching zero-length substring +=item Repeated Patterns Matching a Zero-length Substring -=item Combining pieces together +=item Combining RE Pieces C, C, C, C, C, C, C, C, C, C, C, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>, -C<(?!S)>, C<(?, C<(??{ EXPR })>, +C<(?!S)>, C<(?, C<(??{ EXPR })>, C<(?PARNO)>, C<(?(condition)yes-pattern|no-pattern)> -=item Creating custom RE engines +=item Creating Custom RE Engines =back +=item PCRE/Python Support + +C<< (?PENAMEEpattern) >>, C<< (?P=NAME) >>, C<< (?P>NAME) >> + =item BUGS =item SEE ALSO @@ -2941,9 +2991,6 @@ lexical> X X X, 5. X X, =item Using References X X X -2. X<${}> X<@{}> X<%{}>, 3. X X<< -> >> X, 4. -X - =item Symbolic references X X X X @@ -3174,7 +3221,7 @@ safe subprocesses, sockets, and semaphores) =item Deferred Signals (Safe Signals) -Long running opcodes, Interrupting IO, Restartable system calls, Signals as +Long-running opcodes, Interrupting IO, Restartable system calls, Signals as "faults", Signals triggered by operating system state =back @@ -3304,14 +3351,12 @@ string =back -=head2 perlthrtut - tutorial on threads in Perl +=head2 perlthrtut - Tutorial on threads in Perl =over 4 =item DESCRIPTION -=item Status - =item What Is A Thread Anyway? =item Threaded Program Models @@ -3372,7 +3417,7 @@ string =item Advanced Semaphores -=item cond_wait() and cond_signal() +=item Waiting for a Condition =item Giving up control @@ -3404,6 +3449,8 @@ string =item Conclusion +=item SEE ALSO + =item Bibliography =over 4 @@ -3699,6 +3746,12 @@ localization) PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY, LC_NUMERIC, LC_TIME, LANG +=over 4 + +=item Examples + +=back + =item NOTES =over 4 @@ -3850,6 +3903,60 @@ classes, Use of "Is" Prefix, Blocks =back +=head2 perlunifaq - Perl Unicode FAQ + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item perlunitut isn't really a Unicode tutorial, is it? + +=item What about binary data, like images? + +=item What about the UTF8 flag? + +=item When should I decode or encode? + +=item What if I don't decode? + +=item What if I don't encode? + +=item Is there a way to automatically decode or encode? + +=item Cheat?! Tell me, how can I cheat? + +=item What if I don't know which encoding was used? + +=item Can I use Unicode in my Perl sources? + +=item Data::Dumper doesn't restore the UTF8 flag; is it broken? + +=item How can I determine if a string is a text string or a binary string? + +=item How do I convert from encoding FOO to encoding BAR? + +=item What about the C pragma? + +=item What are C and C? + +=item What's the difference between C and C? + +=item I lost track; what encoding is the internal format really? + +=item What character encodings does Perl support? + +=item Which version of perl should I use? + +=back + +=item AUTHOR + +=item SEE ALSO + +=back + =head2 perlunitut - Perl Unicode Tutorial =over 4 @@ -3864,12 +3971,12 @@ classes, Use of "Is" Prefix, Blocks =item I/O flow (the actual 5 minute tutorial) -=item Q and A - =back =item SUMMARY +=item Q and A (or FAQ) + =item ACKNOWLEDGEMENTS =item AUTHOR @@ -4050,8 +4157,8 @@ X X X X X =item Symbol Tables X X X<%::> X<%main::> X X X -=item BEGIN, CHECK, INIT and END -X X X X +=item BEGIN, UNITCHECK, CHECK, INIT and END +X X X X X =item Perl Classes X X<@ISA> @@ -4459,8 +4566,8 @@ L, L, L =item Development L, L, L and L, -L, L, L, L, L, -L, L +L, L, L, L, L, +L =item General tools @@ -4486,7 +4593,7 @@ L, L =item Layout -B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref +B::Lint, B::Deparse, B::Xref =back @@ -4502,19 +4609,12 @@ i, &, s, r =item The Lint Back End -=item The Simple C Back End - -=item The Bytecode Back End - -=item The Optimized C Back End - =back =item Module List for the Compiler Suite -B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, -B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex, -B::Stackobj, B::Stash, B::Terse, B::Xref +B, O, B::Concise, B::Debug, B::Deparse, B::Lint, B::Showlex, B::Terse, +B::Xref =item KNOWN PROBLEMS @@ -5040,6 +5140,8 @@ MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT, aMY_CXT/pMY_CXT, MY_CXT_CLONE, MY_CXT_INIT_INTERP(my_perl), dMY_CXT_INTERP(my_perl) +=item Thread-aware system interfaces + =back =item EXAMPLES @@ -5381,9 +5483,17 @@ requirements, start class, Beginning/End of line positions =item Unicode and Localisation Support -=item Base Struct +=item Base Structures --, -, -, - +C, C, C C, C, C +C, C, C, C, and C, +C, C, C, C, C C +C, C, C, C, C, C, +C + +=item Pluggable Interface + +comp, exec, intuit, checkstr, free, dupe =item De-allocation and Cloning @@ -5414,7 +5524,9 @@ G_VOID X =item Array Manipulation Functions -AvFILL X, av_clear X, av_delete X, av_exists +AvFILL X, av_clear X, av_create_and_push +X, av_create_and_unshift_one +X, av_delete X, av_exists X, av_extend X, av_fetch X, av_fill X, av_len X, av_make X, av_pop X, av_push X, av_shift X, av_store X, av_undef @@ -5439,7 +5551,7 @@ perl_clone X =item CV Manipulation Functions -CvSTASH X, get_cv X +CvSTASH X, get_cv X, get_cvn_flags X =item Embedding Functions @@ -5517,8 +5629,9 @@ Copy X, CopyD X, Move X, MoveD X, Newx X, Newxc X, Newxz X, Poison X, PoisonFree X, PoisonNew X, PoisonWith X, Renew X, Renewc X, Safefree X, savepv X, savepvn X, -savepvs X, savesharedpv X, savesvpv X, -StructCopy X, Zero X, ZeroD X +savepvs X, savesharedpv X, savesharedpvn +X, savesvpv X, StructCopy X, Zero +X, ZeroD X =item Miscellaneous Functions @@ -5539,8 +5652,9 @@ X, PUSH_MULTICALL X =item Numeric functions grok_bin X, grok_hex X, grok_number X, -grok_numeric_radix X, grok_oct X, scan_bin -X, scan_hex X, scan_oct X +grok_numeric_radix X, grok_oct X, +Perl_signbit X, scan_bin X, scan_hex X, +scan_oct X =item Optree Manipulation Functions @@ -5628,27 +5742,28 @@ X, newSVhek X, newSViv X, newSVnv X, newSVpv X, newSVpvf X, newSVpvn X, newSVpvn_share X, newSVpvs X, newSVpvs_share X, newSVrv X, newSVsv X, newSVuv -X, sv_2bool X, sv_2cv X, sv_2io X, -sv_2iv_flags X, sv_2mortal X, sv_2nv X, -sv_2pvbyte X, sv_2pvutf8 X, sv_2pv_flags -X, sv_2uv_flags X, sv_backoff X, -sv_bless X, sv_catpv X, sv_catpvf X, -sv_catpvf_mg X, sv_catpvn X, sv_catpvn_flags -X, sv_catpvs X, sv_catpv_mg X, -sv_catsv X, sv_catsv_flags X, sv_chop X, -sv_clear X, sv_cmp X, sv_cmp_locale X, -sv_collxfrm X, sv_copypv X, sv_dec X, sv_eq -X, sv_force_normal_flags X, sv_free -X, sv_gets X, sv_grow X, sv_inc X, -sv_insert X, sv_isa X, sv_isobject X, -sv_len X, sv_len_utf8 X, sv_magic X, -sv_magicext X, sv_mortalcopy X, sv_newmortal -X, sv_newref X, sv_pos_b2u X, -sv_pos_u2b X, sv_pvbyten_force X, -sv_pvn_force X, sv_pvn_force_flags X, -sv_pvutf8n_force X, sv_reftype X, sv_replace -X, sv_reset X, sv_rvweaken X, sv_setiv -X, sv_setiv_mg X, sv_setnv X, sv_setnv_mg +X, newSV_type X, sv_2bool X, sv_2cv +X, sv_2io X, sv_2iv_flags X, sv_2mortal +X, sv_2nv X, sv_2pvbyte X, sv_2pvutf8 +X, sv_2pv_flags X, sv_2uv_flags X, +sv_backoff X, sv_bless X, sv_catpv X, +sv_catpvf X, sv_catpvf_mg X, sv_catpvn +X, sv_catpvn_flags X, sv_catpvs X, +sv_catpv_mg X, sv_catsv X, sv_catsv_flags +X, sv_chop X, sv_clear X, sv_cmp +X, sv_cmp_locale X, sv_collxfrm X, +sv_copypv X, sv_dec X, sv_eq X, +sv_force_normal_flags X, sv_free X, sv_gets +X, sv_grow X, sv_inc X, sv_insert X, +sv_isa X, sv_isobject X, sv_len X, sv_len_utf8 +X, sv_magic X, sv_magicext X, +sv_mortalcopy X, sv_newmortal X, sv_newref +X, sv_pos_b2u X, sv_pos_u2b X, +sv_pvbyten_force X, sv_pvn_force X, +sv_pvn_force_flags X, sv_pvutf8n_force +X, sv_reftype X, sv_replace X, +sv_reset X, sv_rvweaken X, sv_setiv X, +sv_setiv_mg X, sv_setnv X, sv_setnv_mg X, sv_setpv X, sv_setpvf X, sv_setpvf_mg X, sv_setpviv X, sv_setpviv_mg X, sv_setpvn X, sv_setpvn_mg X, sv_setpvs @@ -6004,6 +6119,8 @@ PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST =item Portability problems +=item Problematic System Interfaces + =item Security problems =back @@ -6073,9 +6190,7 @@ I =over 4 -=item Needed for a 5.9.5 release - -=item Needed for a 5.9.6 release +=item Needed for the final 5.10.0 release =back @@ -6107,6 +6222,8 @@ I =item embed.pl/makedef.pl +=item use strict; and AutoLoad + =back =item Tasks that need a little sysadmin-type knowledge @@ -6137,26 +6254,26 @@ I =item Profile Perl - am I hot or not? -=item Shrink struct context - =item Allocate OPs from arenas =item Improve win32/wince.c +=item Use secure CRT functions when building with VC8 on Win32 + =back =item Tasks that need a knowledge of XS =over 4 -=item shrink Cs - =item autovivification =item Unicode in Filenames =item Unicode in %ENV +=item Unicode and glob() + =item use less 'memory' =item Re-implement C<:unique> in a way that is actually thread-safe @@ -6167,27 +6284,31 @@ I =item strcat(), strcpy(), strncat(), strncpy(), sprintf(), vsprintf() +=item Audit the code for destruction ordering assumptions + +=item Extend PerlIO and PerlIO::Scalar + +=item -C on the #! line + =back =item Tasks that need a knowledge of the interpreter =over 4 +=item Implement $value ~~ 0 .. $range + =item Attach/detach debugger from running program =item LVALUE functions for lists =item LVALUE functions in the debugger -=item _ prototype character - =item regexp optimiser optional -=item UNITCHECK - =item delete &function -=item Make readpipe overridable +=item C regex modifier =item optional optimizer @@ -6205,6 +6326,8 @@ I =item Properly Unicode safe tokeniser and pads. +=item The yada yada yada operators + =back =item Big projects @@ -6219,6 +6342,8 @@ I =item A re-entrant regexp engine +=item Add class set operations to regexp engine + =back =back @@ -6278,7 +6403,7 @@ B<-V> =back -=head2 perldelta - what is new for perl v5.9.4 +=head2 perldelta - what is new for perl v5.9.5 =over 4 @@ -6288,13 +6413,15 @@ B<-V> =over 4 -=item chdir FOO +=item Tainting and printf -=item Handling of pmc files +=item undef and signal handlers -=item @- and @+ in patterns +=item strictures and array/hash dereferencing in defined() -=item $AUTOLOAD can now be tainted +=item Removal of the bytecode compiler and of perlcc + +=item Removal of the JPL =back @@ -6302,15 +6429,20 @@ B<-V> =over 4 -=item state() variables +=item Regular expressions -=item UNIVERSAL::DOES() +Recursive Patterns, Named Capture Buffers, Possessive Quantifiers, +Backtracking control verbs, Relative backreferences, C<\K> escape -=item Exceptions in constant folding +=item The C<_> prototype -=item Source filters in @INC +=item UNITCHECK blocks -=item MAD +=item readpipe() is now overridable + +=item UCD 5.0.0 + +=item Smart match =back @@ -6320,90 +6452,137 @@ B<-V> =item New Core Modules +=item Module changes + +C, C, C, C, C, C + =back =item Utility Changes +=item Documentation + +=item Performance Enhancements + +=item Installation and Configuration Improvements + =over 4 -=item config_data +=item C++ compatibility + +=item Static build on Win32 + +=item Ports =back -=item Documentation +=item Selected Bug Fixes + +=item New or Changed Diagnostics + +=item Changed Internals + +=item Known Problems =over 4 -=item New manpage, perlpragma +=item Platform Specific Problems -=item New manpage, perlreguts +=back -=item New manpage, perlunitut +=item Reporting Bugs + +=item SEE ALSO =back -=item Performance Enhancements +=head2 perl595delta, perldelta - what is new for perl v5.9.5 =over 4 -=item Memory optimisations +=item DESCRIPTION -=item UTF-8 cache optimisation +=item Incompatible Changes -=item Regular expressions +=over 4 -Engine de-recursivised, Single char char-classes treated as literals, Trie -optimisation of literal string alternations, Aho-Corasick start-point -optimisation +=item Tainting and printf -=item Sloppy stat on Windows +=item undef and signal handlers + +=item strictures and array/hash dereferencing in defined() + +=item Removal of the bytecode compiler and of perlcc + +=item Removal of the JPL =back -=item Installation and Configuration Improvements +=item Core Enhancements =over 4 -=item Relocatable installations +=item Regular expressions -=item Ports +Recursive Patterns, Named Capture Buffers, Possessive Quantifiers, +Backtracking control verbs, Relative backreferences, C<\K> escape -=item Compilation improvements +=item The C<_> prototype -=item New probes +=item UNITCHECK blocks -=item Windows build improvements +=item readpipe() is now overridable -Building XS extensions, Support for 64-bit compiler +=item UCD 5.0.0 + +=item Smart match =back -=item Selected Bug Fixes +=item Modules and Pragmas =over 4 -=item PERL5SHELL and tainting +=item New Core Modules -=item Using *FILE{IO} +=item Module changes -=item Overloading and reblessing +C, C, C, C, C, C -=item Overloading and UTF-8 +=back -=item eval memory leaks fixed +=item Utility Changes -=item Random device on Windows +=item Documentation + +=item Performance Enhancements + +=item Installation and Configuration Improvements + +=over 4 + +=item C++ compatibility + +=item Static build on Win32 + +=item Ports =back -=item New or Changed Diagnostics +=item Selected Bug Fixes -State variable %s will be reinitialized +=item New or Changed Diagnostics =item Changed Internals =item Known Problems +=over 4 + +=item Platform Specific Problems + +=back + =item Reporting Bugs =item SEE ALSO @@ -9520,8 +9699,8 @@ B, B Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's celib-sources, Rainer Keuchel's console-sources, go to C<./win32> -subdirectory, edit file C, run compile.bat, run -compile.bat dist +subdirectory, edit file C<./win32/ce-helpers/compile.bat>, run +compile.bat, run compile.bat dist =back @@ -9803,9 +9982,9 @@ DJGPP, Pthreads =item PA-RISC 2.0 -=item Itanium Processor Family and HP-UX +=item Itanium Processor Family (IPF) and HP-UX -=item Itanium & Itanium 2 +=item Itanium, Itanium 2 & Madison 6 =item Building Dynamic Extensions on HP-UX @@ -10835,8 +11014,9 @@ utime LIST, waitpid PID,FLAGS =item Setting Up Perl on Win32 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Visual -C++ Toolkit 2003, Microsoft Platform SDK 64-bit Compiler, MinGW release 3 -with gcc, MinGW release 1 with gcc +C++ 2005 Express Edition, Microsoft Visual C++ Toolkit 2003, Microsoft +Platform SDK 64-bit Compiler, MinGW release 3 with gcc, MinGW release 1 +with gcc =item Building @@ -10895,10 +11075,30 @@ 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 +=over 4 + +=item 'taint' mode + +=item 'eval' mode + +=item 'debug' mode + +=item 'Debug' mode + +Compile related options, COMPILE, PARSE, OPTIMISE, TRIEC, DUMP, Execute +related options, EXECUTE, MATCH, TRIEE, INTUIT, Extra debugging options, +EXTRA, BUFFERS, TRIEM, STATE, STACK, OPTIMISEM, OFFSETS, OFFSETSDBG, Other +useful flags, ALL, All, MORE, More + +=item Exportable Functions + +is_regexp($ref), regexp_pattern($ref), regmust($ref), regname($name,$all), +regnames($all), regnames_iterinit(), regnames_iternext($all), +regnames_count() + +=back + +=item SEE ALSO =back @@ -10907,6 +11107,8 @@ data structures between threads =over 4 +=item VERSION + =item SYNOPSIS =item DESCRIPTION @@ -10915,18 +11117,21 @@ data structures between threads =item FUNCTIONS -share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR, -LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR, -ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE +share VARIABLE, is_shared VARIABLE, lock VARIABLE, cond_wait VARIABLE, +cond_wait CONDVAR, LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, +cond_timedwait CONDVAR, ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, +cond_broadcast VARIABLE -=item NOTES +=item OBJECTS -=item BUGS +=item NOTES -=item AUTHOR +=item BUGS AND LIMITATIONS =item SEE ALSO +=item AUTHOR + =back =head2 threads - Perl interpreter-based threads @@ -10940,16 +11145,16 @@ ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE =item DESCRIPTION $thr = threads->create(FUNCTION, ARGS), $thr->join(), $thr->detach(), -threads->detach(), threads->self(), $thr->tid(), threads->tid(), +threads->detach(), threads->self(), $thr->tid(), threads->tid(), "$thr", 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() +$thr->error(), $thr->_handle(), threads->_handle() =item EXITING A THREAD threads->exit(), threads->exit(status), die(), exit(status), use threads -'exit' => 'thread_only', threads->create({'exit' => 'thread_only'}, ...), +'exit' => 'threads_only', threads->create({'exit' => 'thread_only'}, ...), $thr->set_thread_exit_only(boolean), threads->set_thread_exit_only(boolean) =item THREAD STATE @@ -10995,13 +11200,14 @@ 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 +=item BUGS AND LIMITATIONS -Parent-child threads, Creating threads inside special blocks, Unsafe -signals, Perl was been built with C (see C), The -environment variable C is set to C (see -L), The module L is used, -Returning closures from threads, Perl Bugs and the CPAN Version of +Using non-threadsafe modules, Parent-child threads, Creating threads inside +special blocks, Unsafe signals, Perl has been built with +C (see C), The environment variable +C is set to C (see L), The +module L is used, Returning closures from threads, +Returning objects from threads, Perl Bugs and the CPAN Version of L =item REQUIREMENTS @@ -11184,6 +11390,10 @@ a or accuracy, p or precision, t or trace, l or lib, v or version =item Methods +inf(), NaN(), upgrade() + +=item MATH LIBRARY + =item Caveat =back @@ -11258,7 +11468,11 @@ inf(), NaN(), upgrade() =item Methods -=item Caveat +inf(), NaN(), upgrade() + +=item MATH LIBRARY + +=item Cavaet =item Options @@ -11273,6 +11487,7 @@ a or accuracy, p or precision, t or trace, l or lib, v or version perl -Mbigrat -le 'print 4.5+2*255' perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3' perl -Mbigrat -le 'print 12->is_odd()'; + perl -Mbignum=l,GMP -le 'print 7 ** 7777' =item LICENSE @@ -11418,6 +11633,10 @@ escapes =item Implicit upgrading for byte strings +=item Side effects + +=item Side effects + =back =item FEATURES THAT REQUIRE 5.8.1 @@ -11518,22 +11737,24 @@ upgrading for byte-strings =over 4 -=item The 'switch' feature +=item Lexical effect + +=item C -=item The '~~' feature +=item The 'switch' feature =item The 'say' feature =item the 'err' feature -=item the 'dor' feature - =item the 'state' feature =back =item FEATURE BUNDLES +=item IMPLICIT LOADING + =back =head2 fields - compile-time class fields @@ -11591,7 +11812,7 @@ point =back -=head2 less - perl pragma to request less of something from the compiler +=head2 less - perl pragma to request less of something =over 4 @@ -11599,6 +11820,20 @@ point =item DESCRIPTION +=item FOR MODULE AUTHORS + +=over 4 + +=item C<< BOOLEAN = less->of( FEATURE ) >> + +=item C<< FEATURES = less->of() >> + +=back + +=item CAVEATS + +This probably does nothing, This works only on 5.10+ + =back =head2 lib - manipulate @INC at compile time @@ -11842,6 +12077,8 @@ structures between threads =over 4 +=item VERSION + =item SYNOPSIS =item DESCRIPTION @@ -11850,18 +12087,21 @@ structures between threads =item FUNCTIONS -share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR, -LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR, -ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE +share VARIABLE, is_shared VARIABLE, lock VARIABLE, cond_wait VARIABLE, +cond_wait CONDVAR, LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, +cond_timedwait CONDVAR, ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, +cond_broadcast VARIABLE -=item NOTES +=item OBJECTS -=item BUGS +=item NOTES -=item AUTHOR +=item BUGS AND LIMITATIONS =item SEE ALSO +=item AUTHOR + =back =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source @@ -11878,7 +12118,7 @@ code =item Utility functions $num_octets = utf8::upgrade($string), $success = utf8::downgrade($string[, -FAIL_OK]), utf8::encode($string), utf8::decode($string), $flag = +FAIL_OK]), utf8::encode($string), $success = utf8::decode($string), $flag = utf8::is_utf8(STRING), $flag = utf8::valid(STRING) =back @@ -12014,7 +12254,7 @@ warnings::warnif($object, $message) =back -=head2 Archive::Tar - module for manipulations of tar archives +=head2 Archive::Extract - A generic archive extracting mechanism =over 4 @@ -12022,11 +12262,18 @@ warnings::warnif($object, $message) =item DESCRIPTION -=item Object Methods +=back =over 4 -=item Archive::Tar->new( [$file, $compressed] ) +=item METHODS + +=over 4 + +=item $ae = Archive::Extract->new(archive => '/path/to/archive',[type => +TYPE]) + +tar, tgz, gz, zip, bz2, tbz =back @@ -12034,17 +12281,123 @@ warnings::warnif($object, $message) =over 4 -=item $tar->read ( $filename|$handle, $compressed, {opt => 'val'} ) +=item $ae->extract( [to => '/output/path'] ) -limit, extract +$ae->extract_path, $ae->files =back =over 4 -=item $tar->contains_file( $filename ) - -=back +=item ACCESSORS + +=over 4 + +=item $ae->error([BOOL]) + +=item $ae->extract_path + +=item $ae->files + +=item $ae->archive + +=item $ae->type + +=item $ae->types + +=back + +=back + +=over 4 + +=item $ae->is_tgz + +=item $ae->is_tar + +=item $ae->is_gz + +=item $ae->is_zip + +=back + +=over 4 + +=item $ae->bin_tar + +=item $ae->bin_gzip + +=item $ae->bin_unzip + +=back + +=over 4 + +=item HOW IT WORKS + +=item CAVEATS + +=over 4 + +=item File Extensions + +=item Bzip2 Support + +=back + +=item GLOBAL VARIABLES + +=over 4 + +=item $Archive::Extract::DEBUG + +=item $Archive::Extract::WARN + +=item $Archive::Extract::PREFER_BIN + +=back + +=item TODO + +Mime magic support + +=item AUTHORS + +=item COPYRIGHT + +=back + +=head2 Archive::Tar - module for manipulations of tar archives + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item Object Methods + +=over 4 + +=item Archive::Tar->new( [$file, $compressed] ) + +=back + +=back + +=over 4 + +=item $tar->read ( $filename|$handle, $compressed, {opt => 'val'} ) + +limit, extract + +=back + +=over 4 + +=item $tar->contains_file( $filename ) + +=back =over 4 @@ -12325,7 +12678,7 @@ is_socket, is_longlink, is_label, is_unknown =item DESCRIPTION -[0], [1], [2], [3], [4], [5] +[0], [1], [2], [3], [4], [5], [6], [7] =over 4 @@ -12427,7 +12780,7 @@ $keep, $check, $modtime objects sv_undef, sv_yes, sv_no, svref_2object(SVREF), amagic_generation, init_av, -check_av, begin_av, end_av, comppadlist, regex_padav, main_cv +check_av, unitcheck_av, begin_av, end_av, comppadlist, regex_padav, main_cv =item Functions for Examining the Symbol Table @@ -12534,8 +12887,8 @@ children =item B::PMOP Methods -pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, extflags, -precomp, pmoffset +pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, extflags, precomp, +pmoffset =item B::SVOP METHOD @@ -12563,8 +12916,7 @@ label, stash, stashpv, file, cop_seq, arybase, line, warnings, io, hints =back -=head2 B::Asmdata - Autogenerated data about Perl ops, used to generate -bytecode +=head2 B::Asmdata - Autogenerated data about Perl ops =over 4 @@ -12578,119 +12930,6 @@ bytecode =back -=head2 B::Assembler - Assemble Perl bytecode - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=item AUTHORS - -=back - -=head2 B::Bblock - Walk basic blocks - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=over 4 - -=item Functions - -B - -=back - -=item AUTHOR - -=back - -=head2 B::Bytecode - Perl compiler's bytecode backend - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=item EXAMPLE - -=item OPTIONS - -B<-b>, B<-H>, B<-k>, B<-o>I, B<-s> - -=item KNOWN BUGS - -=item NOTICE - -=item AUTHORS - -=back - -=head2 B::C - Perl compiler's C backend - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=item OPTIONS - -B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>, -B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>, -B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>, -B<-llimit> - -=item EXAMPLES - -=item BUGS - -=item AUTHOR - -=back - -=head2 B::CC - Perl compiler's optimized C translation backend - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=item OPTIONS - -B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>, -B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>, -B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On> - -=item EXAMPLES - -=item BUGS - -=item DIFFERENCES - -=over 4 - -=item Loops - -=item Context of ".." - -=item Arithmetic - -=item Deprecated features - -=back - -=item AUTHOR - -=back - =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops =over 4 @@ -12843,18 +13082,6 @@ strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits =back -=head2 B::Disassembler - Disassemble Perl bytecode - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=item AUTHOR - -=back - =head2 B::Lint - Perl lint =over 4 @@ -12928,20 +13155,6 @@ validate against older perls =back -=head2 B::Stackobj - Helper module for CC backend - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=item AUTHOR - -=back - -=head2 B::Stash - show what stashes are loaded - =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops =over 4 @@ -12972,26 +13185,6 @@ C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]> =back -=head2 Bblock, B::Bblock - Walk basic blocks - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=over 4 - -=item Functions - -B - -=back - -=item AUTHOR - -=back - =head2 Benchmark - benchmark running times of Perl code =over 4 @@ -13038,42 +13231,6 @@ disablecache ( ), enablecache ( ), timesum ( T1, T2 ) =back -=head2 ByteLoader - load byte compiled perl code - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=item AUTHOR - -=item SEE ALSO - -=back - -=head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=item EXAMPLE - -=item OPTIONS - -B<-b>, B<-H>, B<-k>, B<-o>I, B<-s> - -=item KNOWN BUGS - -=item NOTICE - -=item AUTHORS - -=back - =head2 CGI - Simple Common Gateway Interface Class =over 4 @@ -13367,6 +13524,8 @@ other) error log =back +=item DOING MORE THAN PRINTING A MESSAGE IN THE EVENT OF PERL ERRORS + =item MAKING WARNINGS APPEAR AS HTML COMMENTS =item OVERRIDING THE NAME OF THE PROGRAM @@ -13387,7 +13546,8 @@ other) error log =item USING CGI::Cookie -B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag> +B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>, B<4. +httponly flag> =over 4 @@ -13533,37 +13693,97 @@ FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE =item SYNOPSIS -=item STATUS - -=item COMPATIBILITY - =item DESCRIPTION =over 4 -=item Interactive Mode +=item CPAN::shell([$prompt, $command]) Starting Interactive Mode -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_expression, failed, Lockfile, -Signals +Searching for authors, bundles, distribution files and modules, C, +C, C, C, C modules or distributions, C, +C, C module or distribution, C author, C +globbing_expression, C, Persistence between sessions, The C +and the C pragma, Lockfile, Signals =item CPAN::Shell =item autobundle +=item hosts + +=item mkmyconfig + =item recompile -=item upgrade +=item report Bundle|Distribution|Module -=item mkmyconfig +=item upgrade [Module|/Regex/]... =item The four C Classes: Author, Bundle, Module, Distribution -=item Programmer's interface +=item Integrating local directories + +=back + +=item CONFIGURATION + +completion support, displaying some help: o conf help, displaying current +values: o conf [KEY], changing of scalar values: o conf KEY VALUE, changing +of list values: o conf KEY SHIFT|UNSHIFT|PUSH|POP|SPLICE|LIST, reverting to +saved: o conf defaults, saving the config: o conf commit + +=over 4 + +=item Config Variables + +Cscalar optionE>, Cscalar optionE +EvalueE>, Clist optionE>, Clist +optionE [shift|pop]>, Clist optionE +[unshift|push|splice] ElistE>, interactive editing: o conf init +[MATCH|LIST] + +=item CPAN::anycwd($path): Note on config variable getcwd + +cwd, getcwd, fastcwd, backtickcwd + +=item Note on the format of the urllist parameter + +=item The urllist parameter has CD-ROM support + +=item Maintaining the urllist parameter + +=item The C and C dependency declarations + +=item Configuration for individual distributions (I) + +=item Filenames + +=item Fallback Data::Dumper and Storable + +=item Blueprint + +=item Language Specs + +comment [scalar], cpanconfig [hash], disabled [boolean], goto [string], +install [hash], make [hash], match [hash], patches [array], pl [hash], test +[hash] + +=item Processing Instructions + +args [array], commandline, eexpect [hash], env [hash], expect [array] + +=item Schema verification with C + +=item Example Distroprefs Files + +=back + +=item PROGRAMMER'S INTERFACE expand($type,@things), expandany(@things), Programming Examples +=over 4 + =item Methods in the other Classes CPAN::Author::as_glimpse(), CPAN::Author::as_string(), @@ -13579,19 +13799,22 @@ 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::install_tested(), CPAN::Distribution::isa_perl(), +CPAN::Distribution::is_tested(), CPAN::Distribution::look(), CPAN::Distribution::make(), CPAN::Distribution::perldoc(), -CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(), -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::Distribution::prefs(), CPAN::Distribution::prereq_pm(), +CPAN::Distribution::readme(), 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::available_file(), CPAN::Module::inst_version(), +CPAN::Module::available_version(), CPAN::Module::install(), +CPAN::Module::look(), CPAN::Module::make(), CPAN::Module::manpage_headline(), CPAN::Module::perldoc(), CPAN::Module::readme(), CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid() @@ -13600,30 +13823,25 @@ CPAN::Module::userid() =item Bundles -=item Prerequisites - -=item Finding packages and VERSION +=back -=item Debugging +=item PREREQUISITES -=item Floppy, Zip, Offline Mode +=item UTILITIES -=back +=over 4 -=item CONFIGURATION +=item Finding packages and VERSION -Cscalar optionE>, Cscalar optionE -EvalueE>, Clist optionE>, Clist -optionE [shift|pop]>, Clist optionE -[unshift|push|splice] ElistE> +=item Debugging -=over 4 +o debug package.., o debug -package.., o debug all, o debug number -=item Not on config variable getcwd +=item Floppy, Zip, Offline Mode -=item Note on urllist parameter's format +=item Basic Utilities for Programmers -=item urllist parameter has CD-ROM support +has_inst($module), has_usable($module), instance($module) =back @@ -13655,14 +13873,26 @@ http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade =item FAQ -1), 2), 3), 4), 5), 6), 7), 8), 9), 10), 11), 12), 13), 14) +1), 2), 3), 4), 5), 6), 7), 8), 9), 10), 11), 12), 13), 14), 15) -=item BUGS +=item COMPATIBILITY + +=over 4 + +=item OLD PERL VERSIONS + +=item CPANPLUS + +=back =item SECURITY ADVICE +=item BUGS + =item AUTHOR +=item LICENSE + =item TRANSLATIONS =item SEE ALSO @@ -13677,9 +13907,11 @@ http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade =item DESCRIPTION +=item LICENSE + =back -=head2 CPAN::Version - utility functions to compare CPAN versions +=head2 CPAN::Kwalify - Interface between CPAN.pm and Kwalify.pm =over 4 @@ -13687,10 +13919,15 @@ http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade =item DESCRIPTION +_validate($schema_name, $data, $file, $doc), yaml($schema_name) + +=item AUTHOR + +=item LICENSE + =back -=head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS -module +=head2 CPAN::Version - utility functions to compare CPAN versions =over 4 @@ -13698,47 +13935,66 @@ module =item DESCRIPTION -=item SEE ALSO +=item LICENSE =back -=head2 Carp, carp - warn of errors (from perspective of caller) +=head2 CPANPLUS - API & CLI access to the CPAN mirrors =over 4 =item SYNOPSIS -=item DESCRIPTION +=item GUIDE TO DOCUMENTATION =over 4 -=item Forcing a Stack Trace +=item GENERAL USAGE + +=item API REFERENCE =back -=item GLOBAL VARIABLES +=back =over 4 -=item $Carp::CarpLevel +=item COMMANDLINE TOOLS -=item $Carp::MaxEvalLen +=over 4 -=item $Carp::MaxArgLen +=item STARTING AN INTERACTIVE SHELL -=item $Carp::MaxArgNums +=item BUILDING PACKAGES -=item $Carp::Verbose +=item $bool = install( Module::Name | /A/AU/AUTHOR/Module-Name-1.tgz ) -=back +=item $where = fetch( Module::Name | /A/AU/AUTHOR/Module-Name-1.tgz ) -=item BUGS +=item $where = get( Module::Name | /A/AU/AUTHOR/Module-Name-1.tgz ) + +=item shell() =back -=head2 Carp::Heavy - heavy machinery, no user serviceable parts inside +=item FAQ -=head2 Class::ISA -- report the search path for a class's ISA tree +=item BUG REPORTS + +=item AUTHOR + +=item COPYRIGHT + +=item SEE ALSO + +=item CONTACT INFORMATION + +Bug reporting: I, Questions & suggestions: +I + +=back + +=head2 CPANPLUS::Backend =over 4 @@ -13746,122 +14002,129 @@ module =item DESCRIPTION -=item FUNCTIONS +=item ENVIRONMENT -the function Class::ISA::super_path($CLASS), the function -Class::ISA::self_and_super_path($CLASS), the function -Class::ISA::self_and_super_versions($CLASS) +=item METHODS -=item CAUTIONARY NOTES +=over 4 -=item COPYRIGHT +=item $cb = CPANPLUS::Backend->new( [CONFIGURE_OBJ] ) -=item AUTHOR +Provide a valid C object, No arguments =back -=head2 Class::Struct - declare struct-like datatypes as Perl classes +=back =over 4 -=item SYNOPSIS +=item $href = $cb->module_tree( [@modules_names_list] ) -=item DESCRIPTION +=back =over 4 -=item The C function - -=item Class Creation at Compile Time +=item $href = $cb->author_tree( [@author_names_list] ) -=item Element Types and Accessor Methods +=back -Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or -C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>) +=over 4 -=item Initializing with C +=item $conf = $cb->configure_object () =back -=item EXAMPLES - -Example 1, Example 2, Example 3 +=over 4 -=item Author and Modification History +=item $su = $cb->selfupdate_object; =back -=head2 Compress::IO::Base::lib::File::GlobMapper, File::GlobMapper - Extend -File Glob to Allow Input and Output Files - =over 4 -=item SYNOPSIS - -=item DESCRIPTION +=item @mods = $cb->search( type => TYPE, allow => AREF, [data => AREF, +verbose => BOOL] ) -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 -=item Behind The Scenes +=item $backend_rv = $cb->fetch( modules => \@mods ) -=item Limitations +=item $backend_rv = $cb->extract( modules => \@mods ) -=item Input File Glob +=item $backend_rv = $cb->install( modules => \@mods ) -B<~>, B<~user>, B<.>, B<*>, B, B<\>, B<[]>, B<{,}>, B<()> +=item $backend_rv = $cb->readme( modules => \@mods ) -=item Output File Glob +=item $backend_rv = $cb->files( modules => \@mods ) -"*", #1 +=item $backend_rv = $cb->distributions( modules => \@mods ) -=item Returned Data +=back + +=over 4 + +=item $mod_obj = $cb->parse_module( module => $modname|$distname|$modobj ) + +Text::Bastardize, Text-Bastardize, Text-Bastardize-1.06, +AYRNIEU/Text-Bastardize, AYRNIEU/Text-Bastardize-1.06, +AYRNIEU/Text-Bastardize-1.06.tar.gz, +http://example.com/Text-Bastardize-1.06.tar.gz, +file:///tmp/Text-Bastardize-1.06.tar.gz =back -=item EXAMPLES +=over 4 + +=item $bool = $cb->reload_indices( [update_source => BOOL, verbose => BOOL] +); + +=back =over 4 -=item A Rename script +=item $bool = $cb->flush(CACHE_NAME) -=item A few example globmaps +C, C, C, C, C, C =back -=item SEE ALSO - -=item AUTHOR +=over 4 -=item COPYRIGHT AND LICENSE +=item @mods = $cb->installed() =back -=head2 Compress::IO::Base::lib::IO::Compress::Base, IO::Compress::Base - -Base Class for IO::Compress modules +=over 4 + +=item $bool = $cb->local_mirror([path => '/dir/to/save/to', index_files => +BOOL, force => BOOL, verbose => BOOL] ) + +path, index_files, force, verbose + +=back =over 4 -=item SYNOPSIS +=item $file = $cb->autobundle([path => OUTPUT_PATH, force => BOOL, verbose +=> BOOL]) -=item DESCRIPTION +=back -=item SEE ALSO +=over 4 + +=item BUG REPORTS =item AUTHOR -=item MODIFICATION HISTORY +=item COPYRIGHT -=item COPYRIGHT AND LICENSE +=item SEE ALSO =back -=head2 Compress::IO::Base::lib::IO::Uncompress::AnyUncompress, -IO::Uncompress::AnyUncompress - Uncompress gzip, zip, bzip2 or lzop -file/buffer +=head2 CPANPLUS::Backend::RV =over 4 @@ -13869,107 +14132,103 @@ file/buffer =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, RFC 1950, RFC 1951, gzip (RFC 1952), zip, bzip2, lzop - -=item Functional Interface +=item METHODS =over 4 -=item anyuncompress $input => $output [, OPTS] +=item new( ok => BOOL, args => DATA, rv => DATA, [function => $method_name] +) -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 +ok, args, rv, function -=item Notes +=back -=item Optional Parameters +=back -C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, -C<< MultiStream => 0|1 >> +=over 4 -=item Examples +=item BUG REPORTS + +=item AUTHOR + +=item COPYRIGHT =back -=item OO Interface +=head2 CPANPLUS::Configure =over 4 -=item Constructor +=item SYNOPSIS -A filename, A filehandle, A scalar reference +=item DESCRIPTION -=item Constructor Options +=item METHODS -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 >> +=over 4 -=item Examples +=item $Configure = CPANPLUS::Configure->new( load_configs => BOOL ) =back -=item Methods +=back =over 4 -=item read +=item $bool = $Configure->init( [rescan => BOOL]) -=item read +=back -=item getline +=over 4 -=item getc +=item can_save( [$config_location] ) -=item ungetc +=back -=item getHeaderInfo +=over 4 -=item tell +=item $file = $conf->save( [$package_name] ) -=item eof +=back -=item seek +=over 4 -=item binmode +=item options( type => TYPE ) -=item opened +=back -=item autoflush +=over 4 -=item input_line_number +=item ACCESSORS -=item fileno +=over 4 -=item close +=item get_SOMETHING( ITEM, [ITEM, ITEM, ... ] ); -=item nextStream +=item set_SOMETHING( ITEM => VAL, [ITEM => VAL, ITEM => VAL, ... ] ); -=item trailingData +=item add_SOMETHING( ITEM => VAL, [ITEM => VAL, ITEM => VAL, ... ] ); + +set|get_conf, set|get_program, _set|_get_build, _set|_get_source, +_set|_get_mirror, _set|_get_dist, _set|_get_fetch, _set|_get_daemon =back -=item Importing +=back -:all - -=item EXAMPLES +=over 4 -=item SEE ALSO +=item BUG REPORTS =item AUTHOR -=item MODIFICATION HISTORY +=item COPYRIGHT -=item COPYRIGHT AND LICENSE +=item SEE ALSO =back -=head2 Compress::IO::Base::lib::IO::Uncompress::Base, IO::Uncompress::Base -- Base Class for IO::Uncompress modules +=head2 CPANPLUS::Dist =over 4 @@ -13977,334 +14236,308 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =item DESCRIPTION -=item SEE ALSO +=item ACCESSORS -=item AUTHOR +parent(), status() -=item MODIFICATION HISTORY +=item STATUS ACCESSORS -=item COPYRIGHT AND LICENSE +created(), installed(), uninstalled(), dist() =back -=head2 Compress::IO::Zlib::IO::Compress::Deflate, IO::Compress::Deflate - -Write RFC 1950 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 $dist = CPANPLUS::Dist->new( module => MODOBJ, [format => DIST_TYPE] +); -=item Functional Interface +=back =over 4 -=item deflate $input => $output [, OPTS] +=item @dists = CPANPLUS::Dist->dist_types; -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 +=over 4 -=item Optional Parameters +=item prereq_satisfied( modobj => $modobj, version => $version_spec ) -C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> +=back -=item Examples +=over 4 + +=item _resolve_prereqs =back -=item OO Interface +=head2 CPANPLUS::Dist::Base - Base class for custom distribution classes =over 4 -=item Constructor - -A filename, A filehandle, A scalar reference +=item SYNOPSIS -=item Constructor Options +=item DESCRIPTION -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 FLOW -=item Examples +=item METHODS =back -=item Methods - =over 4 -=item print +=item $bool = $Class->format_available -=item printf +=back -=item syswrite +=over 4 -=item write +=item $bool = $dist->init -=item flush +=back -=item tell +=over 4 -=item eof +=item $bool = $dist->prepare -=item seek +=back -=item binmode +=over 4 -=item opened +=item $bool = $dist->create -=item autoflush +=back -=item input_line_number +=over 4 -=item fileno +=item $bool = $dist->install -=item close +=back -=item newStream([OPTS]) +=over 4 -=item deflateParams +=item $bool = $dist->uninstall =back -=item Importing +=head2 CPANPLUS::Dist::MM -:all, :constants, :flush, :level, :strategy +=over 4 -=item EXAMPLES +=item SYNOPSIS -=item SEE ALSO +=item ACCESSORS -=item AUTHOR +parent(), status() -=item MODIFICATION HISTORY +=item STATUS ACCESSORS -=item COPYRIGHT AND LICENSE +makefile (), make (), test (), prepared (), distdir (), created (), +installed (), uninstalled (), _create_args (), _install_args () =back -=head2 Compress::IO::Zlib::IO::Compress::Gzip, IO::Compress::Gzip - Write -RFC 1952 files/buffers - =over 4 -=item SYNOPSIS +=item METHODS -=item DESCRIPTION +=over 4 -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 $bool = $dist->format_available(); -=item Functional Interface +=back + +=back =over 4 -=item gzip $input => $output [, OPTS] +=item $href = $dist->_find_prereqs( file => '/path/to/Makefile', [verbose +=> BOOL]) -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 +=over 4 -=item Optional Parameters +=item $bool = $dist->create([perl => '/path/to/perl', make => +'/path/to/make', makeflags => 'EXTRA=FLAGS', prereq_target => TARGET, +skiptest => BOOL, force => BOOL, verbose => BOOL]) -C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> +=back -=item Examples +=over 4 -=back +=item $bool = $dist->install([make => '/path/to/make', makemakerflags => +'EXTRA=FLAGS', force => BOOL, verbose => BOOL]) -=item OO Interface +=back =over 4 -=item Constructor +=item $bool = $dist->write_makefile_pl([force => BOOL, verbose => BOOL]) -A filename, A filehandle, A scalar reference +=back -=item Constructor Options +=head2 CPANPLUS::Dist::Sample -- Sample code to create your own Dist::* +plugin -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 ->> +=over 4 -=item Examples +=item Description. =back -=item Methods +=head2 CPANPLUS::Error =over 4 -=item print +=item SYNOPSIS -=item printf +=item DESCRIPTION -=item syswrite +=item FUNCTIONS -=item write +=over 4 -=item flush +=item cp_msg("message string" [,VERBOSE]) -=item tell +=item msg() -=item eof +=item cp_error("error string" [,VERBOSE]) -=item seek +=item error() -=item binmode +=back -=item opened +=item CLASS METHODS -=item autoflush +=over 4 -=item input_line_number +=item CPANPLUS::Error->stack() -=item fileno +=item CPANPLUS::Error->stack_as_string([TRACE]) -=item close +=item CPANPLUS::Error->flush() -=item newStream([OPTS]) +=back -=item deflateParams +=back + +=over 4 + +=item GLOBAL VARIABLES + +$ERROR_FH, $MSG_FH =back -=item Importing +=head2 CPANPLUS::FAQ -:all, :constants, :flush, :level, :strategy +=over 4 -=item EXAMPLES +=item DESCRIPTION -=item SEE ALSO +=item BUG REPORTS =item AUTHOR -=item MODIFICATION HISTORY - -=item COPYRIGHT AND LICENSE +=item COPYRIGHT =back -=head2 Compress::IO::Zlib::IO::Compress::RawDeflate, -IO::Compress::RawDeflate - Write RFC 1951 files/buffers +=head2 CPANPLUS::Hacking =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 OBTAINING CPANPLUS -=item Functional Interface +=item INSTALLING CPANPLUS -=over 4 +=item CONFIGURING CPANPLUS -=item rawdeflate $input => $output [, OPTS] +=item RUNNING CPANPLUS FROM DEVELOPMENT ENVIRONMENT -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 RUNNING CPANPLUS TESTS -=item Notes +=item FINDING BUGS -=item Optional Parameters +Problem description, Program demonstrating the bug, [OPTIONAL] A patch to +the test suite to test for the bug, [OPTIONAL] A patch to the code + tests ++ documentation -C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> +=item SUPPLYING PATCHES -=item Examples +In C or C format, From the root of the snapshot, +Including patches for code + tests + docs, Sent per mail to +cpanplus-devel@lists.sourceforge.net, With subject containing C<[PATCH]> + +description of the patch =back -=item OO Interface +=head2 CPANPLUS::Internals =over 4 -=item Constructor - -A filename, A filehandle, A scalar reference +=item SYNOPSIS -=item Constructor Options +=item DESCRIPTION -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 ACCESSORS -=item Examples +_conf, _id, _lib, _perl5lib =back -=item Methods - =over 4 -=item print - -=item printf - -=item syswrite +=item METHODS -=item write +=over 4 -=item flush +=item $internals = CPANPLUS::Internals->_init( _conf => CONFIG_OBJ ) -=item tell +=back -=item eof +=back -=item seek +=over 4 -=item binmode +=item $bool = $internals->_flush( list => \@caches ) -=item opened +=back -=item autoflush +=over 4 -=item input_line_number +=item $bool = $internals->_register_callback( name => CALLBACK_NAME, code +=> CODEREF ); -=item fileno +install_prerequisite, send_test_report, munge_test_report, edit_test_report -=item close +=back -=item newStream([OPTS]) +=over 4 -=item deflateParams +=item $bool = $internals->_add_to_includepath( directories => \@dirs ) =back -=item Importing - -:all, :constants, :flush, :level, :strategy +=over 4 -=item EXAMPLES +=item $id = CPANPLUS::Internals->_last_id -=item SEE ALSO +=item $id = CPANPLUS::Internals->_store_id( $internals ) -=item AUTHOR +=item $obj = CPANPLUS::Internals->_retrieve_id( $ID ) -=item MODIFICATION HISTORY +=item CPANPLUS::Internals->_remove_id( $ID ) -=item COPYRIGHT AND LICENSE +=item @objs = CPANPLUS::Internals->_return_all_objects =back -=head2 Compress::IO::Zlib::IO::Compress::Zip, IO::Compress::Zip - Write zip -files/buffers +=head2 CPANPLUS::Internals::Extract =over 4 @@ -14312,108 +14545,120 @@ 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 +=over 4 -=item Functional Interface +=item $dir = _extract( module => $modobj, [perl => '/path/to/perl', +extractdir => '/path/to/extract/to', prefer_bin => BOOL, verbose => BOOL, +force => BOOL] ) -=over 4 +module, extractdir, prefer_bin, perl, verbose, force -=item zip $input => $output [, OPTS] +=back -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 +=head2 CPANPLUS::Internals::Fetch -=item Optional Parameters +=over 4 -C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> +=item SYNOPSIS -=item Examples +=item DESCRIPTION -=back +=item METHODS -=item OO Interface +=back =over 4 -=item Constructor +=item $path = _fetch( module => $modobj, [fetchdir => '/path/to/save/to', +fetch_from => 'scheme://path/to/fetch/from', verbose => BOOL, force => +BOOL, prefer_bin => BOOL] ) -A filename, A filehandle, A scalar reference +=back -=item Constructor Options +=over 4 -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 _add_fail_host( host => $host_hashref ) -=item Examples +=item _host_ok( host => $host_hashref ) =back -=item Methods +=head2 CPANPLUS::Internals::Report =over 4 -=item print +=item SYNOPSIS -=item printf +=item DESCRIPTION -=item syswrite +=item METHODS -=item write +=over 4 -=item flush +=item $bool = $cb->_have_query_report_modules -=item tell +=item $bool = $cb->_have_send_report_modules -=item eof +=back -=item seek +=back -=item binmode +=over 4 -=item opened +=item @list = $cb->_query_report( module => $modobj, [all_versions => BOOL, +verbose => BOOL] ) -=item autoflush +=back -=item input_line_number +=over 4 -=item fileno +=item $bool = $cb->_send_report( module => $modobj, buffer => $make_output, +failed => BOOL, [save => BOOL, address => $email_to, dontcc => BOOL, +verbose => BOOL, force => BOOL]); -=item close +module, buffer, failed, save, address, dontcc, verbose, force -=item newStream([OPTS]) +=back -=item deflateParams +=head2 CPANPLUS::Internals::Search + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS + +=over 4 + +=item _search_module_tree( type => TYPE, allow => \@regexex, [data => +\@previous_results ] ) + +type, allow, data =back -=item Importing +=back -:all, :constants, :flush, :level, :strategy, :zip_method +=over 4 -=item EXAMPLES +=item _search_author_tree( type => TYPE, allow => \@regexex, [data => +\@previous_results ] ) -=item SEE ALSO +type, allow, data -=item AUTHOR +=back -=item MODIFICATION HISTORY +=over 4 -=item COPYRIGHT AND LICENSE +=item _all_installed() =back -=head2 Compress::IO::Zlib::IO::Uncompress::AnyInflate, -IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip) file/buffer +=head2 CPANPLUS::Internals::Source =over 4 @@ -14421,110 +14666,97 @@ IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip) file/buffer =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, RFC 1950, RFC 1951, gzip (RFC 1952), zip +=item METHODS -=item Functional Interface +=back =over 4 -=item anyinflate $input => $output [, OPTS] +=item $cb->_check_trees( [update_source => BOOL, path => PATH, verbose => +BOOL] ) -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 +update_source, path, verbose -=item Notes +=back -=item Optional Parameters +=over 4 -C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, -C<< MultiStream => 0|1 >> +=item $cb->__check_uptodate( file => $file, name => $name, [update_source +=> BOOL, verbose => BOOL] ) -=item Examples +file, name, update_source, verbose =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 >>, C<< ParseExtra => 0|1 ->> +=item $cb->_update_source( name => $name, [path => $path, verbose => BOOL] +) -=item Examples +name, path, verbose =back -=item Methods - =over 4 -=item read +=item $cb->_build_trees( uptodate => BOOL, [use_stored => BOOL, path => +$path, verbose => BOOL] ) -=item read +uptodate, path, verbose, use_stored -=item getline +=back -=item getc +=over 4 -=item ungetc +=item $cb->__retrieve_source(name => $name, [path => $path, uptodate => +BOOL, verbose => BOOL]) -=item inflateSync +name, uptodate, path, verbose -=item getHeaderInfo +=back -=item tell +=over 4 -=item eof +=item $cb->_save_source([verbose => BOOL, path => $path]) -=item seek +path, verbose -=item binmode +=back -=item opened +=over 4 -=item autoflush +=item $cb->__create_author_tree([path => $path, uptodate => BOOL, verbose +=> BOOL]) -=item input_line_number +uptodate, path, verbose -=item fileno +=back -=item close +=over 4 -=item nextStream +=item $cb->_create_mod_tree([path => $path, uptodate => BOOL, verbose => +BOOL]) -=item trailingData +uptodate, path, verbose =back -=item Importing - -:all +=over 4 -=item EXAMPLES +=item $cb->__create_dslip_tree([path => $path, uptodate => BOOL, verbose => +BOOL]) -=item SEE ALSO +uptodate, path, verbose -=item AUTHOR +=back -=item MODIFICATION HISTORY +=over 4 -=item COPYRIGHT AND LICENSE +=item $cb->_dslip_defs () =back -=head2 Compress::IO::Zlib::IO::Uncompress::Gunzip, IO::Uncompress::Gunzip - -Read RFC 1952 files/buffers +=head2 CPANPLUS::Internals::Utils =over 4 @@ -14532,112 +14764,91 @@ Read RFC 1952 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 +=item METHODS =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, An Array -Reference, An Output FileGlob +=item $cb->_mkdir( dir => '/some/dir' ) -=item Notes +=back -=item Optional Parameters +=back -C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, -C<< MultiStream => 0|1 >> +=over 4 -=item Examples +=item $cb->_chdir( dir => '/some/dir' ) =back -=item OO Interface - =over 4 -=item Constructor - -A filename, A filehandle, A scalar reference +=item $cb->_rmdir( dir => '/some/dir' ); -=item Constructor Options +=back -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 ->> +=over 4 -=item Examples +=item $cb->_perl_version ( perl => 'some/perl/binary' ); =back -=item Methods - =over 4 -=item read +=item $cb->_version_to_number( version => $version ); -=item read +=back -=item getline +=over 4 -=item getc +=item $cb->_whoami -=item ungetc +=back -=item inflateSync +=over 4 -=item getHeaderInfo +=item _get_file_contents( file => $file ); -Name, Comment +=back -=item tell +=over 4 -=item eof +=item $cb->_mode_plus_w( file => '/path/to/file' ); -=item seek +=back -=item binmode +=over 4 -=item opened +=item $uri = $cb->_host_to_uri( scheme => SCHEME, host => HOST, path => +PATH ); -=item autoflush +=back -=item input_line_number +=over 4 -=item fileno +=item $cb->_vcmp( VERSION, VERSION ); -=item close +=back -=item nextStream +=over 4 -=item trailingData +=item $cb->_home_dir =back -=item Importing - -:all - -=item EXAMPLES +=over 4 -=item SEE ALSO +=item $path = $cb->_safe_path( path => $path ); -=item AUTHOR +=back -=item MODIFICATION HISTORY +=over 4 -=item COPYRIGHT AND LICENSE +=item ($pkg, $version, $ext) = $cb->_split_package_string( package => +PACKAGE_STRING ); =back -=head2 Compress::IO::Zlib::IO::Uncompress::Inflate, IO::Uncompress::Inflate -- Read RFC 1950 files/buffers +=head2 CPANPLUS::Module =over 4 @@ -14645,219 +14856,217 @@ Name, Comment =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 +=back -=item Functional Interface +=over 4 + +=item CLASS METHODS =over 4 -=item inflate $input => $output [, OPTS] +=item accessors () -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 +=back -=item Optional Parameters +=over 4 -C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, -C<< MultiStream => 0|1 >> +=item ACCESSORS -=item Examples +name, module, version, path, comment, package, description, dslip, status, +author, parent =back -=item OO Interface - =over 4 -=item Constructor +=item STATUS ACCESSORS -A filename, A filehandle, A scalar reference +installer_type, dist_cpan, dist, prereqs, signature, extract, fetch, +readme, uninstall, created, installed, checksums, checksum_ok, +checksum_value -=item Constructor Options +=item METHODS -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 >> +=over 4 -=item Examples +=item $self = CPANPLUS::Module::new( OPTIONS ) =back -=item Methods +=back =over 4 -=item read - -=item read +=item $mod->package_name -=item getline +=item $mod->package_version -=item getc +=item $mod->package_extension -=item ungetc +=item $mod->package_is_perl_core -=item inflateSync +=item $mod->module_is_supplied_with_perl_core( [version => $]] ) -=item getHeaderInfo +=item $mod->is_bundle -=item tell +=item $mod->is_third_party -=item eof +=item $mod->third_party_information -=item seek +=back -=item binmode +=over 4 -=item opened +=item $clone = $self->clone -=item autoflush +=back -=item input_line_number +=over 4 -=item fileno +=item $where = $self->fetch -=item close +=back -=item nextStream +=over 4 -=item trailingData +=item $path = $self->extract =back -=item Importing +=over 4 -:all +=item $type = $self->get_installer_type([prefer_makefile => BOOL]) -=item EXAMPLES +=back -=item SEE ALSO +=over 4 -=item AUTHOR +=item $dist = $self->dist([target => 'prepare|create', format => +DISTRIBUTION_TYPE, args => {key => val}]); -=item MODIFICATION HISTORY +=back -=item COPYRIGHT AND LICENSE +=over 4 -=back +=item $bool = $mod->prepare( ) -=head2 Compress::IO::Zlib::IO::Uncompress::RawInflate, -IO::Uncompress::RawInflate - Read RFC 1951 files/buffers - -=over 4 +Convenience method around C that prepares a module +without actually building it. This is equivalent to invoking C +with C set to C -=item SYNOPSIS +=back -=item DESCRIPTION +=over 4 -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 $bool = $mod->create( ) -=item Functional Interface +=back =over 4 -=item rawinflate $input => $output [, OPTS] +=item $bool = $mod->test( ) -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 +=over 4 -=item Optional Parameters +=item $bool = $self->install([ target => 'prepare|create|install', format +=> FORMAT_TYPE, extractdir => DIRECTORY, fetchdir => DIRECTORY, prefer_bin +=> BOOL, force => BOOL, verbose => BOOL, ..... ]); -C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, -C<< MultiStream => 0|1 >> +=back -=item Examples +=over 4 -=back +=item $text = $self->readme -=item OO Interface +=back =over 4 -=item Constructor +=item $version = $self->installed_version() -A filename, A filehandle, A scalar reference +=item $where = $self->installed_file() -=item Constructor Options +=item $bool = $self->is_uptodate([version => VERSION_NUMBER]) -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 >> +=back -=item Examples +=over 4 + +=item $href = $self->details() =back -=item Methods +=over 4 + +=item @list = $self->contains() + +=back =over 4 -=item read +=item @list_of_hrefs = $self->fetch_report() -=item read +=back -=item getline +=over 4 -=item getc +=item $bool = $self->uninstall([type => [all|man|prog]) -=item ungetc +=back -=item inflateSync +=over 4 -=item getHeaderInfo +=item @modobj = $self->distributions() -=item tell +=back -=item eof +=over 4 -=item seek +=item @list = $self->files () -=item binmode +=back -=item opened +=over 4 -=item autoflush +=item @list = $self->directory_tree () -=item input_line_number +=back -=item fileno +=over 4 -=item close +=item @list = $self->packlist () -=item nextStream +=back -=item trailingData +=over 4 + +=item @list = $self->validate () =back -=item Importing +=over 4 -:all +=item $bool = $self->add_to_includepath; -=item EXAMPLES +=item $path = $self->best_path_to_module_build(); -=item SEE ALSO +=back -=item AUTHOR +=over 4 -=item MODIFICATION HISTORY +=item BUG REPORTS -=item COPYRIGHT AND LICENSE +=item AUTHOR + +=item COPYRIGHT =back -=head2 Compress::IO::Zlib::IO::Uncompress::Unzip, IO::Uncompress::Unzip - -Read zip files/buffers +=head2 CPANPLUS::Module::Author =over 4 @@ -14865,109 +15074,112 @@ Read zip 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 ACCESSORS -=item Functional Interface +author, cpanid, email, parent + +=back =over 4 -=item unzip $input => $output [, OPTS] +=item METHODS -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 $auth = CPANPLUS::Module::Author->new( author => AUTHOR_NAME, cpanid +=> CPAN_ID, _id => INTERNALS_ID [, email => AUTHOR_EMAIL] ) -=item Optional Parameters +=back -C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, -C<< MultiStream => 0|1 >> +=back -=item Examples +=over 4 -=back +=item @mod_objs = $auth->modules() -=item OO Interface +=back =over 4 -=item Constructor +=item @dists = $auth->distributions() -A filename, A filehandle, A scalar reference +=back -=item Constructor Options +=over 4 -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 CLASS METHODS -=item Examples +=over 4 + +=item accessors () =back -=item Methods +=back + +=head2 CPANPLUS::Module::Author::Fake =over 4 -=item read +=item SYNOPSIS -=item read +=item DESCRIPTION -=item getline +=item METHODS -=item getc +=over 4 -=item ungetc +=item new( _id => DIGIT ) -=item inflateSync +=back -=item getHeaderInfo +=back -=item tell +=head2 CPANPLUS::Module::Checksums -=item eof +=over 4 -=item seek +=item SYNOPSIS -=item binmode +=item DESCRIPTION -=item opened +=item METHODS -=item autoflush +=over 4 -=item input_line_number +=item $mod->checksums -=item fileno +=back -=item close +=back -=item nextStream +=head2 CPANPLUS::Module::Fake -=item trailingData +=over 4 -=back +=item SYNOPSIS -=item Importing +=item DESCRIPTION -:all +=item METHODS -=item EXAMPLES +=over 4 -=item SEE ALSO +=item new( module => $mod, path => $path, package => $pkg, [_id => DIGIT] ) -=item AUTHOR +=back -=item MODIFICATION HISTORY +=back -=item COPYRIGHT AND LICENSE +=head2 CPANPLUS::inc + +=over 4 + +=item DESCRIPTION =back -=head2 Compress::Raw::Zlib - Low-Level Interface to zlib compression -library +=head2 CPANPLUS::inc - runtime inclusion of privately bundled modules =over 4 @@ -14975,194 +15187,192 @@ library =item DESCRIPTION -=item Compress::Raw::Zlib::Deflate +Put a coderef at the beginning of C<@INC>, Add the full path to the +C directory to C<$ENV{PERL5LIB> + +=item METHODS =over 4 -=item B<($d, $status) = new Compress::Raw::Zlib::Deflate( [OPT] ) > +=item CPANPLUS::inc->inc_path() -B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>, -B<-Dictionary>, B<-Bufsize>, B<-AppendOutput>, B<-CRC32>, B<-ADLER32> +=item CPANPLUS::inc->my_path() -=item B<$status = $d-Edeflate($input, $output)> +=item CPANPLUS::inc->installer_path() -=item B<$status = $d-Eflush($output [, $flush_type]) > +=back -=item B<$status = $d-EdeflateParams([OPT])> +=back -B<-Level>, B<-Strategy>, B<-BufSize> +=over 4 -=item B<$status = $d-EdeflateTune($good_length, $max_lazy, -$nice_length, $max_chain)> +=item CPANPLUS::inc->original_perl5lib -=item B<$d-Edict_adler()> +=item CPANPLUS::inc->original_perl5opt -=item B<$d-Ecrc32()> +=item CPANPLUS::inc->original_inc -=item B<$d-Eadler32()> +=item CPANPLUS::inc->limited_perl5opt(@modules); -=item B<$d-Emsg()> +=back -=item B<$d-Etotal_in()> +=over 4 -=item B<$d-Etotal_out()> +=item CPANPLUS::inc->interesting_modules() -=item B<$d-Eget_Strategy()> +=back -=item B<$d-Eget_Level()> +=over 4 -=item B<$d-Eget_BufSize()> +=item INTERESTING MODULES -=item Example +Loop over your @INC, Check the version on every suitable module found in +@INC =back -=item Compress::Raw::Zlib::Inflate - =over 4 -=item B< ($i, $status) = new Compress::Raw::Zlib::Inflate( [OPT] ) > +=item DEBUG -B<-WindowBits>, B<-Bufsize>, B<-Dictionary>, B<-AppendOutput>, B<-CRC32>, -B<-ADLER32>, B<-ConsumeInput> +=item CAVEATS -=item B< $status = $i-Einflate($input, $output [,$eof]) > +On multiple C calls, our coderef may not be the first in @INC, +Non-directories in @INC -=item B<$status = $i-EinflateSync($input)> +=back -=item B<$i-Edict_adler()> +=head2 CPANPLUSelfupdate, CPANPLUS::Selfupdate -=item B<$i-Ecrc32()> +=over 4 -=item B<$i-Eadler32()> +=item SYNOPSIS -=item B<$i-Emsg()> +=back -=item B<$i-Etotal_in()> +=over 4 -=item B<$i-Etotal_out()> +=item METHODS -=item B<$d-Eget_BufSize()> +=over 4 -=item Example +=item $self = CPANPLUS::Selfupdate->new( $backend_object ); =back -=item CHECKSUM FUNCTIONS - -=item ACCESSING ZIP FILES +=back -=item CONSTANTS +=over 4 -=item SEE ALSO +=item $bool = $self->selfupdate( update => +"core|dependencies|enabled_features|features|all", latest => BOOL ) -=item AUTHOR +=back -=item MODIFICATION HISTORY +=over 4 -=item COPYRIGHT AND LICENSE +=item @features = $self->list_features =back -=head2 Compress::Raw::Zlib::Compress::Raw::Zlib, Compress::Raw::Zlib - -Low-Level Interface to zlib compression library - =over 4 -=item SYNOPSIS - -=item DESCRIPTION +=item @features = $self->list_enabled_features -=item Compress::Raw::Zlib::Deflate +=back =over 4 -=item B<($d, $status) = new Compress::Raw::Zlib::Deflate( [OPT] ) > +=item @mods = $self->modules_for_feature( FEATURE [,AS_HASH] ) -B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>, -B<-Dictionary>, B<-Bufsize>, B<-AppendOutput>, B<-CRC32>, B<-ADLER32> +=back -=item B<$status = $d-Edeflate($input, $output)> +=over 4 -=item B<$status = $d-Eflush($output [, $flush_type]) > +=item @mods = $self->list_core_dependencies( [AS_HASH] ) -=item B<$status = $d-EdeflateParams([OPT])> +=back -B<-Level>, B<-Strategy>, B<-BufSize> +=over 4 -=item B<$status = $d-EdeflateTune($good_length, $max_lazy, -$nice_length, $max_chain)> +=item @mods = $self->list_core_modules( [AS_HASH] ) -=item B<$d-Edict_adler()> - -=item B<$d-Ecrc32()> +=back -=item B<$d-Eadler32()> +=over 4 -=item B<$d-Emsg()> +=item CPANPLUS::Selfupdate::Module -=item B<$d-Etotal_in()> +=back -=item B<$d-Etotal_out()> +=over 4 -=item B<$d-Eget_Strategy()> +=item $version = $mod->version_required -=item B<$d-Eget_Level()> +=back -=item B<$d-Eget_BufSize()> +=over 4 -=item Example +=item $bool = $mod->is_installed_version_sufficient =back -=item Compress::Raw::Zlib::Inflate - =over 4 -=item B< ($i, $status) = new Compress::Raw::Zlib::Inflate( [OPT] ) > +=item BUG REPORTS -B<-WindowBits>, B<-Bufsize>, B<-Dictionary>, B<-AppendOutput>, B<-CRC32>, -B<-ADLER32>, B<-ConsumeInput> +=item AUTHOR -=item B< $status = $i-Einflate($input, $output [,$eof]) > +=item COPYRIGHT -=item B<$status = $i-EinflateSync($input)> +=back -=item B<$i-Edict_adler()> +=head2 CPANPLUShell, CPANPLUS::Shell -=item B<$i-Ecrc32()> +=over 4 -=item B<$i-Eadler32()> +=item SYNOPSIS -=item B<$i-Emsg()> +=item DESCRIPTION -=item B<$i-Etotal_in()> +=back -=item B<$i-Etotal_out()> +=over 4 -=item B<$d-Eget_BufSize()> +=item BUG REPORTS -=item Example +=item AUTHOR + +=item COPYRIGHT + +=item SEE ALSO =back -=item CHECKSUM FUNCTIONS +=head2 CPANPLUShell::Classic, CPANPLUS::Shell::Classic - CPAN.pm emulation +for CPANPLUS -=item ACCESSING ZIP FILES +=over 4 -=item CONSTANTS +=item DESCRIPTION -=item SEE ALSO +=item BUG REPORTS =item AUTHOR -=item MODIFICATION HISTORY +=item COPYRIGHT -=item COPYRIGHT AND LICENSE +=item SEE ALSO =back -=head2 Compress::Zlib - Interface to zlib compression library +=over 4 + +=item SEE ALSO + +=back + +=head2 CPANPLUShell::Default, CPANPLUS::Shell::Default =over 4 @@ -15170,106 +15380,119 @@ B<-ADLER32>, B<-ConsumeInput> =item DESCRIPTION +=back + =over 4 -=item Notes for users of Compress::Zlib version 1 +=item BUG REPORTS + +=item AUTHOR + +=item COPYRIGHT + +=item SEE ALSO =back -=item GZIP INTERFACE +=head2 CPANPLUShell::Default::Plugins::HOWTO, +CPANPLUS::Shell::Default::Plugins::HOWTO -- documentation on how to write +your own plugins -B<$gz = gzopen($filename, $mode)>, B<$gz = gzopen($filehandle, $mode)>, -B<$bytesread = $gz-Egzread($buffer [, $size]) ;>, B<$bytesread = -$gz-Egzreadline($line) ;>, B<$byteswritten = $gz-Egzwrite($buffer) -;>, B<$status = $gz-Egzflush($flush_type) ;>, B<$offset = -$gz-Egztell() ;>, B<$status = $gz-Egzseek($offset, $whence) ;>, -B<$gz-Egzclose>, B<$gz-Egzsetparams($level, $strategy>, B<$level>, -B<$strategy>, B<$gz-Egzerror>, B<$gzerrno> +=over 4 + +=item SYNOPSIS + +=item HOWTO =over 4 -=item Examples +=item Registering Plugin Modules -=item Compress::Zlib::memGzip +=item Registering Plugin Commands -=item Compress::Zlib::memGunzip +=item Registering Plugin Help + +=item Arguments to Plugin Commands + +Classname -- The name of your plugin class, Shell -- The +CPANPLUS::Shell::Default object, Backend -- The CPANPLUS::Backend object, +Command -- The command issued by the user, Input -- The input string +from the user, Options -- A hashref of options provided by the user =back -=item COMPRESS/UNCOMPRESS +=item BUG REPORTS -B<$dest = compress($source [, $level] ) ;>, B<$dest = uncompress($source) -;> +=item AUTHOR -=item Deflate Interface +=item COPYRIGHT -=over 4 +=item SEE ALSO -=item B<($d, $status) = deflateInit( [OPT] )> +=back -B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>, -B<-Dictionary>, B<-Bufsize> +=head2 CPANPLUShell::Default::Plugins::Remote, +CPANPLUS::Shell::Default::Plugins::Remote -=item B<($out, $status) = $d-Edeflate($buffer)> +=over 4 -=item B<($out, $status) = $d-Eflush([flush_type])> +=item SYNOPSIS -=item B<$status = $d-EdeflateParams([OPT])> +=item DESCRIPTION -B<-Level>, B<-Strategy> +=back -=item B<$d-Edict_adler()> +=over 4 -=item B<$d-Emsg()> +=item BUG REPORTS -=item B<$d-Etotal_in()> +=item AUTHOR -=item B<$d-Etotal_out()> +=item COPYRIGHT -=item Example +=item SEE ALSO =back -=item Inflate Interface +=head2 CPANPLUShell::Default::Plugins::Source, +CPANPLUS::Shell::Default::Plugins::Source =over 4 -=item B<($i, $status) = inflateInit()> - -B<-WindowBits>, B<-Bufsize>, B<-Dictionary> +=item SYNOPSIS -=item B<($out, $status) = $i-Einflate($buffer)> +=item DESCRIPTION -=item B<$status = $i-EinflateSync($buffer)> +=back -=item B<$i-Edict_adler()> +=over 4 -=item B<$i-Emsg()> +=item BUG REPORTS -=item B<$i-Etotal_in()> +=item AUTHOR -=item B<$i-Etotal_out()> +=item COPYRIGHT -=item Example +=item SEE ALSO =back -=item CHECKSUM FUNCTIONS +=head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS +module -=item CONSTANTS +=over 4 -=item SEE ALSO +=item SYNOPSIS -=item AUTHOR +=item DESCRIPTION -=item MODIFICATION HISTORY +=item LICENSE -=item COPYRIGHT AND LICENSE +=item SEE ALSO =back -=head2 Compress::Zlib::Compress::Zlib, Compress::Zlib - Interface to zlib -compression library +=head2 Carp, carp - warn of errors (from perspective of caller) =over 4 @@ -15279,103 +15502,91 @@ compression library =over 4 -=item Notes for users of Compress::Zlib version 1 +=item Forcing a Stack Trace =back -=item GZIP INTERFACE - -B<$gz = gzopen($filename, $mode)>, B<$gz = gzopen($filehandle, $mode)>, -B<$bytesread = $gz-Egzread($buffer [, $size]) ;>, B<$bytesread = -$gz-Egzreadline($line) ;>, B<$byteswritten = $gz-Egzwrite($buffer) -;>, B<$status = $gz-Egzflush($flush_type) ;>, B<$offset = -$gz-Egztell() ;>, B<$status = $gz-Egzseek($offset, $whence) ;>, -B<$gz-Egzclose>, B<$gz-Egzsetparams($level, $strategy>, B<$level>, -B<$strategy>, B<$gz-Egzerror>, B<$gzerrno> +=item GLOBAL VARIABLES =over 4 -=item Examples +=item $Carp::MaxEvalLen -=item Compress::Zlib::memGzip +=item $Carp::MaxArgLen -=item Compress::Zlib::memGunzip +=item $Carp::MaxArgNums -=back +=item $Carp::Verbose -=item COMPRESS/UNCOMPRESS +=item %Carp::Internal -B<$dest = compress($source [, $level] ) ;>, B<$dest = uncompress($source) -;> +=item %Carp::CarpInternal -=item Deflate Interface +=item $Carp::CarpLevel -=over 4 +=back -=item B<($d, $status) = deflateInit( [OPT] )> +=item BUGS -B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>, -B<-Dictionary>, B<-Bufsize> +=back -=item B<($out, $status) = $d-Edeflate($buffer)> +=head2 Carp::Heavy - heavy machinery, no user serviceable parts inside -=item B<($out, $status) = $d-Eflush([flush_type])> +=head2 Class::ISA -- report the search path for a class's ISA tree -=item B<$status = $d-EdeflateParams([OPT])> +=over 4 -B<-Level>, B<-Strategy> +=item SYNOPSIS -=item B<$d-Edict_adler()> +=item DESCRIPTION -=item B<$d-Emsg()> +=item FUNCTIONS -=item B<$d-Etotal_in()> +the function Class::ISA::super_path($CLASS), the function +Class::ISA::self_and_super_path($CLASS), the function +Class::ISA::self_and_super_versions($CLASS) -=item B<$d-Etotal_out()> +=item CAUTIONARY NOTES -=item Example +=item COPYRIGHT + +=item AUTHOR =back -=item Inflate Interface +=head2 Class::Struct - declare struct-like datatypes as Perl classes =over 4 -=item B<($i, $status) = inflateInit()> - -B<-WindowBits>, B<-Bufsize>, B<-Dictionary> +=item SYNOPSIS -=item B<($out, $status) = $i-Einflate($buffer)> +=item DESCRIPTION -=item B<$status = $i-EinflateSync($buffer)> +=over 4 -=item B<$i-Edict_adler()> +=item The C function -=item B<$i-Emsg()> +=item Class Creation at Compile Time -=item B<$i-Etotal_in()> +=item Element Types and Accessor Methods -=item B<$i-Etotal_out()> +Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or +C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>) -=item Example +=item Initializing with C =back -=item CHECKSUM FUNCTIONS - -=item CONSTANTS - -=item SEE ALSO - -=item AUTHOR +=item EXAMPLES -=item MODIFICATION HISTORY +Example 1, Example 2, Example 3 -=item COPYRIGHT AND LICENSE +=item Author and Modification History =back -=head2 Config - access Perl configuration information +=head2 Compress::Raw::Zlib - Low-Level Interface to zlib compression +library =over 4 @@ -15383,519 +15594,2432 @@ B<-WindowBits>, B<-Bufsize>, B<-Dictionary> =item DESCRIPTION -myconfig(), config_sh(), config_re($regex), config_vars(@names) +=item Compress::Raw::Zlib::Deflate -=item EXAMPLE +=over 4 -=item WARNING +=item B<($d, $status) = new Compress::Raw::Zlib::Deflate( [OPT] ) > -=item GLOSSARY +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-Edeflate($input, $output)> -=item _ +=item B<$status = $d-Eflush($output [, $flush_type]) > -C<_a>, C<_exe>, C<_o> +=item B<$status = $d-EdeflateParams([OPT])> + +B<-Level>, B<-Strategy>, B<-BufSize> + +=item B<$status = $d-EdeflateTune($good_length, $max_lazy, +$nice_length, $max_chain)> + +=item B<$d-Edict_adler()> + +=item B<$d-Ecrc32()> + +=item B<$d-Eadler32()> + +=item B<$d-Emsg()> + +=item B<$d-Etotal_in()> + +=item B<$d-Etotal_out()> + +=item B<$d-Eget_Strategy()> + +=item B<$d-Eget_Level()> + +=item B<$d-Eget_BufSize()> + +=item Example + +=back + +=item Compress::Raw::Zlib::Inflate + +=over 4 + +=item B< ($i, $status) = new Compress::Raw::Zlib::Inflate( [OPT] ) > + +B<-WindowBits>, B<-Bufsize>, B<-Dictionary>, B<-AppendOutput>, B<-CRC32>, +B<-ADLER32>, B<-ConsumeInput> + +=item B< $status = $i-Einflate($input, $output [,$eof]) > + +=item B<$status = $i-EinflateSync($input)> + +=item B<$i-Edict_adler()> + +=item B<$i-Ecrc32()> + +=item B<$i-Eadler32()> + +=item B<$i-Emsg()> + +=item B<$i-Etotal_in()> + +=item B<$i-Etotal_out()> + +=item B<$d-Eget_BufSize()> + +=item Example + +=back + +=item CHECKSUM FUNCTIONS + +=item ACCESSING ZIP FILES + +=item CONSTANTS + +=item SEE ALSO + +=item AUTHOR + +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE + +=back + +=head2 Compress::Raw::Zlib::Compress::Raw::Zlib, Compress::Raw::Zlib - +Low-Level Interface to zlib compression library + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item Compress::Raw::Zlib::Deflate + +=over 4 + +=item B<($d, $status) = new Compress::Raw::Zlib::Deflate( [OPT] ) > + +B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>, +B<-Dictionary>, B<-Bufsize>, B<-AppendOutput>, B<-CRC32>, B<-ADLER32> + +=item B<$status = $d-Edeflate($input, $output)> + +=item B<$status = $d-Eflush($output [, $flush_type]) > + +=item B<$status = $d-EdeflateParams([OPT])> + +B<-Level>, B<-Strategy>, B<-BufSize> + +=item B<$status = $d-EdeflateTune($good_length, $max_lazy, +$nice_length, $max_chain)> + +=item B<$d-Edict_adler()> + +=item B<$d-Ecrc32()> + +=item B<$d-Eadler32()> + +=item B<$d-Emsg()> + +=item B<$d-Etotal_in()> + +=item B<$d-Etotal_out()> + +=item B<$d-Eget_Strategy()> + +=item B<$d-Eget_Level()> + +=item B<$d-Eget_BufSize()> + +=item Example + +=back + +=item Compress::Raw::Zlib::Inflate + +=over 4 + +=item B< ($i, $status) = new Compress::Raw::Zlib::Inflate( [OPT] ) > + +B<-WindowBits>, B<-Bufsize>, B<-Dictionary>, B<-AppendOutput>, B<-CRC32>, +B<-ADLER32>, B<-ConsumeInput> + +=item B< $status = $i-Einflate($input, $output [,$eof]) > + +=item B<$status = $i-EinflateSync($input)> + +=item B<$i-Edict_adler()> + +=item B<$i-Ecrc32()> + +=item B<$i-Eadler32()> + +=item B<$i-Emsg()> + +=item B<$i-Etotal_in()> + +=item B<$i-Etotal_out()> + +=item B<$d-Eget_BufSize()> + +=item Example + +=back + +=item CHECKSUM FUNCTIONS + +=item ACCESSING ZIP FILES + +=item CONSTANTS + +=item SEE ALSO + +=item AUTHOR + +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE + +=back + +=head2 Compress::Zlib - Interface to zlib compression library + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Notes for users of Compress::Zlib version 1 + +=back + +=item GZIP INTERFACE + +B<$gz = gzopen($filename, $mode)>, B<$gz = gzopen($filehandle, $mode)>, +B<$bytesread = $gz-Egzread($buffer [, $size]) ;>, B<$bytesread = +$gz-Egzreadline($line) ;>, B<$byteswritten = $gz-Egzwrite($buffer) +;>, B<$status = $gz-Egzflush($flush_type) ;>, B<$offset = +$gz-Egztell() ;>, B<$status = $gz-Egzseek($offset, $whence) ;>, +B<$gz-Egzclose>, B<$gz-Egzsetparams($level, $strategy>, B<$level>, +B<$strategy>, B<$gz-Egzerror>, B<$gzerrno> + +=over 4 + +=item Examples + +=item Compress::Zlib::memGzip + +=item Compress::Zlib::memGunzip + +=back + +=item COMPRESS/UNCOMPRESS + +B<$dest = compress($source [, $level] ) ;>, B<$dest = uncompress($source) +;> + +=item Deflate Interface + +=over 4 + +=item B<($d, $status) = deflateInit( [OPT] )> + +B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>, +B<-Dictionary>, B<-Bufsize> + +=item B<($out, $status) = $d-Edeflate($buffer)> + +=item B<($out, $status) = $d-Eflush([flush_type])> + +=item B<$status = $d-EdeflateParams([OPT])> + +B<-Level>, B<-Strategy> + +=item B<$d-Edict_adler()> + +=item B<$d-Emsg()> + +=item B<$d-Etotal_in()> + +=item B<$d-Etotal_out()> + +=item Example + +=back + +=item Inflate Interface + +=over 4 + +=item B<($i, $status) = inflateInit()> + +B<-WindowBits>, B<-Bufsize>, B<-Dictionary> + +=item B<($out, $status) = $i-Einflate($buffer)> + +=item B<$status = $i-EinflateSync($buffer)> + +=item B<$i-Edict_adler()> + +=item B<$i-Emsg()> + +=item B<$i-Etotal_in()> + +=item B<$i-Etotal_out()> + +=item Example + +=back + +=item CHECKSUM FUNCTIONS + +=item CONSTANTS + +=item SEE ALSO + +=item AUTHOR + +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE + +=back + +=head2 Compress::Zlib::Compress::Zlib, Compress::Zlib - Interface to zlib +compression library + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Notes for users of Compress::Zlib version 1 + +=back + +=item GZIP INTERFACE + +B<$gz = gzopen($filename, $mode)>, B<$gz = gzopen($filehandle, $mode)>, +B<$bytesread = $gz-Egzread($buffer [, $size]) ;>, B<$bytesread = +$gz-Egzreadline($line) ;>, B<$byteswritten = $gz-Egzwrite($buffer) +;>, B<$status = $gz-Egzflush($flush_type) ;>, B<$offset = +$gz-Egztell() ;>, B<$status = $gz-Egzseek($offset, $whence) ;>, +B<$gz-Egzclose>, B<$gz-Egzsetparams($level, $strategy>, B<$level>, +B<$strategy>, B<$gz-Egzerror>, B<$gzerrno> + +=over 4 + +=item Examples + +=item Compress::Zlib::memGzip + +=item Compress::Zlib::memGunzip + +=back + +=item COMPRESS/UNCOMPRESS + +B<$dest = compress($source [, $level] ) ;>, B<$dest = uncompress($source) +;> + +=item Deflate Interface + +=over 4 + +=item B<($d, $status) = deflateInit( [OPT] )> + +B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>, +B<-Dictionary>, B<-Bufsize> + +=item B<($out, $status) = $d-Edeflate($buffer)> + +=item B<($out, $status) = $d-Eflush([flush_type])> + +=item B<$status = $d-EdeflateParams([OPT])> + +B<-Level>, B<-Strategy> + +=item B<$d-Edict_adler()> + +=item B<$d-Emsg()> + +=item B<$d-Etotal_in()> + +=item B<$d-Etotal_out()> + +=item Example + +=back + +=item Inflate Interface + +=over 4 + +=item B<($i, $status) = inflateInit()> + +B<-WindowBits>, B<-Bufsize>, B<-Dictionary> + +=item B<($out, $status) = $i-Einflate($buffer)> + +=item B<$status = $i-EinflateSync($buffer)> + +=item B<$i-Edict_adler()> + +=item B<$i-Emsg()> + +=item B<$i-Etotal_in()> + +=item B<$i-Etotal_out()> + +=item Example + +=back + +=item CHECKSUM FUNCTIONS + +=item CONSTANTS + +=item SEE ALSO + +=item AUTHOR + +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE + +=back + +=head2 Config - access Perl configuration information + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +myconfig(), config_sh(), config_re($regex), config_vars(@names) + +=item EXAMPLE + +=item WARNING + +=item GLOSSARY + +=over 4 + +=item _ + +C<_a>, C<_exe>, C<_o> =item a -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, C, -C, C +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, C, +C, C + +=item b + +C, C, C, C, C, C, C + +=item c + +C, C, C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C + +=item d + +C, C, C, C, C, +C, C, C, C, +C, C, C, +C, C, C, +C, C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, +C, C, C, C, C, +C, C, C, C + +=item e + +C, C, C, C, C, C, +C, C, C, +C, C, C, C, +C, C, C + +=item f + +C, C, C, C, C, +C, C, C, C, C, C, +C + +=item g + +C, C, C, C, +C, C, C, +C, C, C, +C, C, C, +C, C, +C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C + +=item h + +C, C, C, C, C, C, +C, C + +=item i + +C, C, C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, +C, C, C, C, +C, C, C, +C, C, C, +C, C, C, +C, C, C, +C, C, C, +C, C, C, C, C, +C + +=item k + +C, C + +=item l + +C, C, C, C, C, +C, C, C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, C, +C + +=item m + +C, C, C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C + +=item M + +C, C, C, C, C, C, +C, C, C, C, C, C, +C + +=item n + +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C + +=item o + +C, C, C, C, +C, C, C, C + +=item p + +C, C, C, C, C, C, +C + +=item P + +C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, C, C, +C, C, C + +=item q + +C, C + +=item r + +C, C, C, C, C, +C, C, C, C, C, +C, C, C + +=item s + +C, C, C, C, C, +C, C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C + +=item t + +C, C, C, C, C, C, C, +C, C, C, C, C, C, C, +C + +=item u + +C, C, C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C + +=item v + +C, C, C, C, +C, C, C, +C, C, C, C, +C, C, C, +C, C, C, C, +C, C, C, +C, C, C + +=item x + +C + +=item y + +C, C + +=item z + +C, C + +=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, B, B + +=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-Epush(list) ;>, B<$value = $X-Epop ;>, B<$X-Eshift>, +B<$X-Eunshift(list) ;>, B<$X-Elength>, B<$X-Esplice(offset, +length, elements);> + +=item Another Example + +=back + +=item THE API INTERFACE + +B<$status = $X-Eget($key, $value [, $flags]) ;>, B<$status = +$X-Eput($key, $value [, $flags]) ;>, B<$status = $X-Edel($key [, +$flags]) ;>, B<$status = $X-Efd ;>, B<$status = $X-Eseq($key, +$value, $flags) ;>, B<$status = $X-Esync([$flags]) ;> + +=item DBM FILTERS + +B, B, B, +B + +=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, B, B + +=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 + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Methods + +I->new(I, I), I<$OBJ>->Dump I +I->Dump(I, I), I<$OBJ>->Seen(I<[HASHREF]>), +I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>), +I<$OBJ>->Reset + +=item Functions + +Dumper(I) + +=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::Arena - Perl extension for inspecting the core's arena +structures + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item EXPORT + +sv_stats [DONT_SHARE], shared_string_table, sizes, HEK_size STRING, +shared_string_table_effectiveness, write_stats_at_END + +=back + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT AND LICENSE + +=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::InnerPackage - find all the inner packages of a package + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS + +=over 4 + +=item list_packages + +=back + +=back + +=over 4 + +=item AUTHOR + +=item COPYING + +=item BUGS + +=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.5, 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 Devel::Size - Perl extension for finding the memory usage of Perl +variables + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item FUNCTIONS + +=over 4 + +=item size($ref) + +=item total_size($ref) + +=back + +=item EXPORT + +=item UNDERSTANDING MEMORY ALLOCATION + +=over 4 + +=item The C library + +=item Perl + +=back + +=item DANGERS + +=item Messages: texts originating from this module. + +=over 4 + +=item Errors + +=item warnings + +=back + +=item BUGS + +=item AUTHOR + +=item COPYRIGHT + +=item SEE ALSO + +=back + +=head2 Digest - Modules that calculate message digests + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +I, I, I + +=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 PADDING OF BASE64 DIGESTS + +=item EXPORT + +=item EXPORTABLE FUNCTIONS + +B, B, B, +B, B, B, +B, B, B, B, B, +B, B, +B, B, B, +B, B, B, B, B, +B, B, B, +B, B, B, +B, B, B, B, +B, B, +B, B, +B, B, +B, B, +B, B, +B, B, +B, B + +=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, C, C, C, C, +C, C, C, C, C, +C, C, 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 + +=item Backward compatible boilerplate + +=back + +=item Order of initialization: early load() + +=over 4 + +=item The most hairy case + +=back + +=item DIAGNOSTICS + +C, C, +C, +C + +=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 Not all encoding support this feature, I = +Encode::FB_DEFAULT ( == 0), I = Encode::FB_CROAK ( == 1), I = +Encode::FB_QUIET, I = Encode::FB_WARN, perlqq mode (I = +Encode::FB_PERLQQ), HTML charref mode (I = Encode::FB_HTMLCREF), XML +charref mode (I = Encode::FB_XMLCREF), The bitmask, +Encode::LEAVE_SRC + +=over 4 + +=item coderef for CHECK + +=back + +=item Defining Encodings + +=item The UTF8 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 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 + +-Eencode($string [,$check]), -Edecode($octets [,$check]), +-Ecat_decode($destination, $octets, $offset, $terminator [,$check]) + +=item Other methods defined in Encode::Encodings + +-Ename, -Erenew, -Erenewed, -Eperlio_ok(), +-Eneeds_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]) + +=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), 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 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 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 + +-Eencode($string [,$check]), -Edecode($octets [,$check]), +-Ecat_decode($destination, $octets, $offset, $terminator [,$check]) + +=item Other methods defined in Encode::Encodings -=item b +-Ename, -Erenew, -Erenewed, -Eperlio_ok(), +-Eneeds_lines() -C, C, C, C, C, C, C +=item Example: Encode::ROT13 -=item c +=back -C, C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C +=item Why the heck Encode API is different? -=item d +=over 4 -C, C, C, C, C, -C, C, C, C, -C, C, C, -C, C, C, -C, C, C, C, -C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, -C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, -C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, -C, C, C, C, C, -C, C, C, C +=item Compiled Encodings -=item e +=back -C, C, C, C, C, C, -C, C, C, -C, C, C, C, -C, C, C +=item SEE ALSO -=item f +Scheme 1, Scheme 2, Other Schemes -C, C, C, C, C, -C, C, C, C, C, C, -C +=back -=item g +=head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from +data -C, C, C, C, -C, C, C, -C, C, C, -C, C, C, -C, C, -C, C, C, -C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C +=over 4 -=item h +=item SYNOPSIS -C, C, C, C, C, C, -C, C +=item ABSTRACT -=item i +=item DESCRIPTION -C, C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, -C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, -C, C, C, C, -C, C, C, -C, C, C, -C, C, C, -C, C, C, -C, C, C, -C, C, C, C, C, -C +Encode::Guess->set_suspects, Encode::Guess->add_suspects, +Encode::decode("Guess" ...), Encode::Guess->guess($data), +guess_encoding($data, [, I]) -=item k +=item CAVEATS -C, C +=item TO DO -=item l +=item SEE ALSO -C, C, C, C, C, -C, C, C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, C, -C +=back -=item m +=head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by +Encode::JP::2022_JP* -C, C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C +=head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used +by Encode::JP -=item M +=head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally +used by Encode::KR -C, C, C, C, C, C, -C, C, C, C, C, C, -C +=head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B' +and 'Q' header encoding -=item n +=over 4 -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C +=item SYNOPSIS -=item o +=item ABSTRACT -C, C, C, C, -C, C, C, C +=item DESCRIPTION -=item p +=item BUGS -C, C, C, C, C, C, -C +=item SEE ALSO -=item P +=back -C, C, C, -C, C, C, -C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, C, -C, C, C +=head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document +on Encode and PerlIO -=item q +=over 4 -C, C +=item Overview -=item r +=item How does it work? -C, C, C, C, C, -C, C, C, C, C, -C, C, C +=item Line Buffering -=item s +=over 4 -C, C, C, C, C, -C, C, C, C, -C, C, C, -C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C +=item How can I tell whether my encoding fully supports PerlIO ? -=item t +=back -C, C, C, C, C, C, C, -C, C, C, C, C, C, C, -C +=item SEE ALSO -=item u +=back -C, C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C +=head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings +supported by Encode -=item v +=over 4 -C, C, C, C, -C, C, C, -C, C, C, C, -C, C, C, -C, C, C, C, -C, C, C, -C, C, C +=item DESCRIPTION + +=over 4 + +=item Encoding Names + +=back + +=item Supported Encodings + +=over 4 + +=item Built-in Encodings -=item x +=item Encode::Unicode -- other Unicode encodings -C +=item Encode::Byte -- Extended ASCII -=item y +ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for +the Cyrillic world, gsm0338 - Hentai Latin 1 -C, C +=item CJK: Chinese, Japanese, Korean (Multibyte) -=item z +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 -C, C +=item Miscellaneous encodings + +Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess =back -=item NOTE +=item Unsupported encodings -=back + 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 -=over 4 +=item Encoding vs. Charset -- terminology -=item SYNOPSIS +=item Encoding Classification (by Anton Tagunov and Dan Kogai) -=item DESCRIPTION +=over 4 -dynamic, nonxs, static +=item Microsoft-related naming mess -=item AUTHOR +KS_C_5601-1987, GB2312, Big5, Shift_JIS =back -=head2 Cwd - get pathname of current working directory +=item Glossary -=over 4 +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 SYNOPSIS +=item See Also -=item DESCRIPTION +=item References + +ECMA, ECMA-035 (eq C), IANA, Assigned Charset Names by IANA, ISO, +RFC, UC, Unicode Glossary =over 4 -=item getcwd and friends +=item Other Notable Sites -getcwd, cwd, fastcwd, fastgetcwd, getdcwd +czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org: +"Introduction to i18n" -=item abs_path and friends +=item Offline sources -abs_path, realpath, fast_abs_path +C by Ken Lunde -=item $ENV{PWD} +=back =back -=item NOTES +=head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7 +encoding -=item AUTHOR +=over 4 -=item COPYRIGHT +=item SYNOPSIS + +=item ABSTRACT + +=item In Practice =item SEE ALSO =back -=head2 DB - programmatic interface to the Perl debugging API (draft, -subject to -change) +=head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder =over 4 =item SYNOPSIS -=item DESCRIPTION +=item ABSTRACT + +=item Description =over 4 -=item Global Variables +=item Predefined Methods - $DB::sub, %DB::sub, $DB::single, $DB::signal, $DB::trace, @DB::args, -@DB::dbline, %DB::dbline, $DB::package, $DB::filename, $DB::subname, -$DB::lineno +$e = Encode::Encoder-Enew([$data, $encoding]);, encoder(), +$e-Edata([$data]), $e-Eencoding([$encoding]), +$e-Ebytes([$encoding]) -=item API Methods +=item Example: base64 transcoder -CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'), -CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done() +=item Operator Overloading -=item Client Callback Methods +=back -CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(), -CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(), -CLIENT->output(LIST) +=item SEE ALSO =back -=item BUGS +=head2 Encodencoding, encoding - allows you to write your script in +non-ascii or non-utf8 -=item AUTHOR +=over 4 -=back +=item SYNOPSIS -=head2 DBM_Filter -- Filter DBM keys/values +=item ABSTRACT =over 4 -=item SYNOPSIS +=item Literal Conversions -=item DESCRIPTION +=item PerlIO layers for C -=item What is a DBM Filter? +=item Implicit upgrading for byte strings -=over 4 +=item Side effects -=item So what's new? +=item Side effects =back -=item METHODS - -=over 4 +=item FEATURES THAT REQUIRE 5.8.1 -=item $db->Filter_Push() +"NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle -=item $db->Filter_Key_Push() +=item USAGE -=item $db->Filter_Value_Push() +use encoding [I] ;, use encoding I [ STDIN =E +I ...] ;, use encoding I Filter=E1;, no encoding; -Filter_Push, Filter_Key_Push, Filter_Value_Push +=item The Filter Option -=item $db->Filter_Pop() +=over 4 -=item $db->Filtered() +=item Filter-related changes at Encode version 1.87 =back -=item Writing a Filter +=item CAVEATS =over 4 -=item Immediate Filters +=item NOT SCOPED -=item Canned Filters +=item DO NOT MIX MULTIPLE ENCODINGS -"name", params +=item tr/// with ranges + +Legend of characters above =back -=item Filters Included +=item EXAMPLE - Greekperl -utf8, encode, compress, int32, null +=item KNOWN PROBLEMS -=item NOTES +literals in regex that are longer than 127 bytes, EBCDIC, format =over 4 -=item Maintain Round Trip Integrity - -=item Don't mix filtered & non-filtered data in the same database file. +=item The Logic of :locale =back -=item EXAMPLE +=item HISTORY =item SEE ALSO -=item AUTHOR - =back -=head2 DBM_Filter::compress - filter for DBM_Filter +=head2 Encoder, Encode::Encoder -- Object Oriented Encoder =over 4 =item SYNOPSIS -=item DESCRIPTION +=item ABSTRACT -=item SEE ALSO +=item Description -=item AUTHOR +=over 4 -=back +=item Predefined Methods -=head2 DBM_Filter::encode - filter for DBM_Filter +$e = Encode::Encoder-Enew([$data, $encoding]);, encoder(), +$e-Edata([$data]), $e-Eencoding([$encoding]), +$e-Ebytes([$encoding]) -=over 4 +=item Example: base64 transcoder -=item SYNOPSIS +=item Operator Overloading -=item DESCRIPTION +=back =item SEE ALSO -=item AUTHOR - =back -=head2 DBM_Filter::int32 - filter for DBM_Filter +=head2 English - use nice English (or awk) names for ugly punctuation +variables =over 4 @@ -15903,13 +18027,12 @@ utf8, encode, compress, int32, null =item DESCRIPTION -=item SEE ALSO - -=item AUTHOR +=item PERFORMANCE =back -=head2 DBM_Filter::null - filter for DBM_Filter +=head2 Env - perl module that imports environment variables as scalars or +arrays =over 4 @@ -15917,13 +18040,13 @@ utf8, encode, compress, int32, null =item DESCRIPTION -=item SEE ALSO +=item LIMITATIONS =item AUTHOR =back -=head2 DBM_Filter::utf8 - filter for DBM_Filter +=head2 Errno - System errno constants =over 4 @@ -15931,13 +18054,15 @@ utf8, encode, compress, int32, null =item DESCRIPTION -=item SEE ALSO +=item CAVEATS =item AUTHOR +=item COPYRIGHT + =back -=head2 DB_File - Perl5 access to Berkeley DB version 1.x +=head2 Exporter - Implements default import method for modules =over 4 @@ -15945,127 +18070,134 @@ utf8, encode, compress, int32, null =item DESCRIPTION -B, B, B - =over 4 -=item Using DB_File with Berkeley DB version 2 or greater - -=item Interface to Berkeley DB +=item How to Export -=item Opening a Berkeley DB Database File +=item Selecting What To Export -=item Default Parameters +=item How to Import -=item In Memory Databases +C, C, C =back -=item DB_HASH +=item Advanced features =over 4 -=item A Simple Example +=item Specialised Import Lists -=back +=item Exporting without using Exporter's import method -=item DB_BTREE +=item Exporting without inheriting from Exporter -=over 4 +=item Module Version Checking -=item Changing the BTREE sort order +=item Managing Unknown Symbols -=item Handling Duplicate Keys +=item Tag Handling Utility Functions -=item The get_dup() Method +=item Generating combined tags -=item The find_dup() Method +=item Ced Constants -=item The del_dup() Method +=back -=item Matching Partial Keys +=back + +=head2 Exporter::Heavy - Exporter guts + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION =back -=item DB_RECNO +=head2 ExtUtils::CBuilder - Compile and link C code for Perl modules =over 4 -=item The 'bval' Option +=item SYNOPSIS -=item A Simple Example +=item DESCRIPTION -=item Extra RECNO Methods +=item METHODS -B<$X-Epush(list) ;>, B<$value = $X-Epop ;>, B<$X-Eshift>, -B<$X-Eunshift(list) ;>, B<$X-Elength>, B<$X-Esplice(offset, -length, elements);> +new, have_compiler, compile, C, C, +C, 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 -=item Another Example +=item HISTORY -=back +=item AUTHOR -=item THE API INTERFACE +=item COPYRIGHT -B<$status = $X-Eget($key, $value [, $flags]) ;>, B<$status = -$X-Eput($key, $value [, $flags]) ;>, B<$status = $X-Edel($key [, -$flags]) ;>, B<$status = $X-Efd ;>, B<$status = $X-Eseq($key, -$value, $flags) ;>, B<$status = $X-Esync([$flags]) ;> +=item SEE ALSO -=item DBM FILTERS +=back -B, B, B, -B +=head2 ExtUtils::CBuilder::Platform::Windows - Builder class for Windows +platforms =over 4 -=item The Filter +=item DESCRIPTION -=item An Example -- the NULL termination problem. +=item AUTHOR -=item Another Example -- Key is a C int. +=item SEE ALSO =back -=item HINTS AND TIPS +=head2 ExtUtils::Command - utilities to replace common UNIX commands in +Makefiles etc. =over 4 -=item Locking: The Trouble with fd +=item SYNOPSIS -=item Safe ways to lock a database +=item DESCRIPTION -B, B, B +=over 4 -=item Sharing Databases With C Applications +=item FUNCTIONS -=item The untie() Gotcha +=back =back -=item COMMON QUESTIONS +cat -=over 4 +eqtime -=item Why is there Perl source in my database? +rm_rf -=item How do I store complex data structures with DB_File? +rm_f -=item What does "Invalid Argument" mean? +touch -=item What does "Bareword 'DB_File' not allowed" mean? +mv -=back +cp -=item REFERENCES +chmod -=item HISTORY +mkpath -=item BUGS +test_f -=item AVAILABILITY +test_d -=item COPYRIGHT +dos2unix + +=over 4 =item SEE ALSO @@ -16073,8 +18205,7 @@ B, B, B =back -=head2 Data::Dumper - stringified perl data structures, suitable for both -printing and C +=head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles =over 4 @@ -16082,116 +18213,116 @@ printing and C =item DESCRIPTION -=over 4 +B -=item Methods +=back -I->new(I, I), I<$OBJ>->Dump I -I->Dump(I, I), I<$OBJ>->Seen(I<[HASHREF]>), -I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>), -I<$OBJ>->Reset +B -=item Functions +B -Dumper(I) +B -=item Configuration Variables or Methods +B -=item Exports +=head2 ExtUtils::Constant - generate XS code to import C header constants -Dumper +=over 4 -=back +=item SYNOPSIS -=item EXAMPLES +=item DESCRIPTION -=item BUGS +=item USAGE -=over 4 +IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF -=item NOTE +=item FUNCTIONS =back -=item AUTHOR +constant_types -=item VERSION +XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME -=item SEE ALSO +autoload PACKAGE, VERSION, AUTOLOADER -=back +WriteMakefileSnippet -=head2 Devel::DProf - a Perl code profiler +WriteConstants ATTRIBUTE =E VALUE [, ...], NAME, DEFAULT_TYPE, +BREAKOUT_AT, NAMES, C_FH, C_FILE, XS_FH, XS_FILE, SUBNAME, C_SUBNAME =over 4 -=item SYNOPSIS +=item AUTHOR -=item DESCRIPTION +=back -=item PROFILE FORMAT +=head2 ExtUtils::Constant::Base - base class for ExtUtils::Constant objects -=item AUTOLOAD +=over 4 -=item ENVIRONMENT +=item SYNOPSIS -=item BUGS +=item DESCRIPTION -=item SEE ALSO +=item USAGE =back -=head2 Devel::PPPort - Perl/Pollution/Portability +header -=over 4 +memEQ_clause args_hashref -=item SYNOPSIS +dump_names arg_hashref, ITEM.. -=item DESCRIPTION +assign arg_hashref, VALUE.. -=over 4 +return_clause arg_hashref, ITEM -=item Why use ppport.h? +switch_clause arg_hashref, NAMELEN, ITEMHASH, ITEM.. -=item How to use ppport.h +params WHAT -=item Running ppport.h +dogfood arg_hashref, ITEM.. -=back +normalise_items args, default_type, seen_types, seen_items, ITEM.. -=item FUNCTIONS +C_constant arg_hashref, ITEM.., name, type, value, macro, default, pre, +post, def_pre, def_post, utf8, weight =over 4 -=item WriteFile +=item BUGS + +=item AUTHOR =back -=item COMPATIBILITY +=head2 ExtUtils::Constant::Utils - helper functions for ExtUtils::Constant =over 4 -=item Provided Perl compatibility API +=item SYNOPSIS -=item Perl API not supported by ppport.h +=item DESCRIPTION -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 +=item USAGE -=back +C_stringify NAME -=item BUGS +=back -=item AUTHORS +perl_stringify NAME -=item COPYRIGHT +=over 4 -=item SEE ALSO +=item AUTHOR =back -=head2 Devel::Peek - A data debugging tool for the XS programmer +=head2 ExtUtils::Constant::XS, ExtUtils::Constant::Base - base class for +ExtUtils::Constant objects =over 4 @@ -16199,161 +18330,128 @@ perl 5.6.0, perl 5.005_03, perl 5.005, perl 5.004_05, perl 5.004 =item DESCRIPTION -=over 4 - -=item Runtime debugging +=item BUGS -=item Memory footprint debugging +=item AUTHOR =back -=item EXAMPLES +=head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications =over 4 -=item A simple scalar string - -=item A simple scalar number +=item SYNOPSIS -=item A simple scalar with an extra reference +=item DESCRIPTION -=item A reference to a simple scalar +=item @EXPORT -=item A reference to an array +=item FUNCTIONS -=item A reference to a hash +xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(), +ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules) -=item Dumping a large array or hash +=item EXAMPLES -=item A reference to an SV which holds a C pointer +=item SEE ALSO -=item A reference to a subroutine +=item AUTHOR =back -=item EXPORTS +=head2 ExtUtils::Install - install files from here to there -=item BUGS +=over 4 -=item AUTHOR +=item SYNOPSIS -=item SEE ALSO +=item DESCRIPTION + +_chmod($$;$), _warnonce(@), _choke(@) =back -=head2 Devel::SelfStubber - generate stubs for a SelfLoading module +_move_file_at_boot( $file, $target, $moan ) + +_unlink_or_rename( $file, $tryhard, $installing ) =over 4 -=item SYNOPSIS +=item Functions -=item DESCRIPTION +B =back -=head2 Digest - Modules that calculate message digests - -=over 4 +_get_install_skip -=item SYNOPSIS +_have_write_access -=item DESCRIPTION +_can_write_dir(C<$dir>) -I, I, I +_mkpath($dir,$show,$mode,$verbose,$fake) -=item OO INTERFACE +_copy($from,$to,$verbose,$fake) -$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 +_chdir($from) -=item Digest speed +_do_cleanup -=item SEE ALSO +install_rooted_file( $file ), install_rooted_dir( $dir ) -=item AUTHOR +forceunlink( $file, $tryhard ) -=back +directory_not_empty( $dir ) -=head2 Digest::MD5 - Perl interface to the MD5 Algorithm +B I -=over 4 +B -=item SYNOPSIS +inc_uninstall($filepath,$libdir,$verbose,$nonono,$ignore) -=item DESCRIPTION +run_filter($cmd,$src,$dest) -=item FUNCTIONS +B -md5($data,...), md5_hex($data,...), md5_base64($data,...) +_autosplit -=item METHODS +_invokant -$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 +=over 4 -=item EXAMPLES +=item ENVIRONMENT -=item SEE ALSO +B, B, +B -=item COPYRIGHT +=item AUTHOR -=item AUTHORS +=item LICENSE =back -=head2 Digest::SHA - Perl extension for SHA-1/224/256/384/512 +=head2 ExtUtils::Installed - Inventory management of installed modules =over 4 -=item SYNOPSIS (SHA) - -=item SYNOPSIS (HMAC-SHA) - -=item ABSTRACT +=item SYNOPSIS =item DESCRIPTION -=item NIST STATEMENT ON SHA-1 - -=item BASE64 DIGESTS - -=item EXPORT +=item USAGE -=item EXPORTABLE FUNCTIONS +=item FUNCTIONS -B, B, B, -B, B, B, -B, B, B, B, B, -B, B, -B, B, B, -B, B, B, B, B, -B, B, B, -B, B, B, -B, B, B, B, -B, B, -B, B, -B, B, -B, B, -B, B, -B, B, -B, B +new(), modules(), files(), directories(), directory_tree(), validate(), +packlist(), version() -=item SEE ALSO +=item EXAMPLE =item AUTHOR -=item ACKNOWLEDGMENTS - -=item COPYRIGHT AND LICENSE - =back -=head2 Digest::base - Digest base class +=head2 ExtUtils::Liblist - determine libraries to use and how to use them =over 4 @@ -16361,27 +18459,34 @@ B, B =item DESCRIPTION -=item SEE ALSO +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 -=head2 Digest::file - Calculate digests of files +=item PORTABILITY =over 4 -=item SYNOPSIS +=item VMS implementation -=item DESCRIPTION +=item Win32 implementation -digest_file( $file, $algorithm, [$arg,...] ), digest_file_hex( $file, -$algorithm, [$arg,...] ), digest_file_base64( $file, $algorithm, [$arg,...] -) +=back =item SEE ALSO =back -=head2 DirHandle - supply object methods for directory handles +=head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass =over 4 @@ -16389,11 +18494,9 @@ $algorithm, [$arg,...] ), digest_file_base64( $file, $algorithm, [$arg,...] =item DESCRIPTION -=item NOTES - =back -=head2 Dumpvalue - provides screen dump of Perl data. +=head2 ExtUtils::MM_AIX - AIX specific subclass of ExtUtils::MM_Unix =over 4 @@ -16403,23 +18506,21 @@ $algorithm, [$arg,...] ), digest_file_base64( $file, $algorithm, [$arg,...] =over 4 -=item Creation +=item Overridden methods -C, C, C, C, C, -C, C, C, C, C, -C, C, unctrl, subdump, bareStringify, quoteHighBit, -stopDbSignal +=back -=item Methods +=back -dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl, -compactDump, veryCompact, set, get +=over 4 -=back +=item AUTHOR + +=item SEE ALSO =back -=head2 DynaLoader - Dynamically load C libraries into Perl code +=head2 ExtUtils::MM_Any - Platform-agnostic MM methods =over 4 @@ -16427,137 +18528,126 @@ 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 METHODS -=item AUTHOR +=over 4 + +=item Cross-platform helper methods =back -=head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into -Perl code +=back =over 4 -=item VERSION - -=item SYNOPSIS +=item Targets -=item DESCRIPTION +=back =over 4 -=item Migration from C - -=item Backward compatible boilerplate +=item Init methods =back -=item Order of initialization: early load() - =over 4 -=item The most hairy case +=item Tools =back -=item DIAGNOSTICS +=over 4 -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 File::Spec wrappers -=item LIMITATIONS +=back -=item BUGS +=over 4 -=item SEE ALSO +=item Misc -=item AUTHORS +=back -=item COPYRIGHT +=over 4 + +=item AUTHOR =back -=head2 Encode - character encodings +=head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in +ExtUtils::MakeMaker =over 4 =item SYNOPSIS -=over 4 - -=item Table of Contents +=item DESCRIPTION =back -=item DESCRIPTION +os_flavor + +init_linker + +=head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in +ExtUtils::MakeMaker =over 4 -=item TERMINOLOGY +=item SYNOPSIS -=back +=item DESCRIPTION -=item PERL ENCODING API +os_flavor -$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]); +=back -=over 4 +cflags -=item Listing available encodings +replace_manpage_separator -=item Defining Aliases +init_linker -=back +=head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix -=item Encoding via PerlIO +=over 4 -=item Handling Malformed Data +=item SYNOPSIS -B Not all encoding support this feature, I = -Encode::FB_DEFAULT ( == 0), I = Encode::FB_CROAK ( == 1), I = -Encode::FB_QUIET, I = Encode::FB_WARN, perlqq mode (I = -Encode::FB_PERLQQ), HTML charref mode (I = Encode::FB_HTMLCREF), XML -charref mode (I = Encode::FB_XMLCREF), The bitmask +=item DESCRIPTION =over 4 -=item coderef for CHECK +=item Overridden methods -=back +os_flavor -=item Defining Encodings +=back -=item The UTF-8 flag +=back -Goal #1:, Goal #2:, Goal #3:, Goal #4: +B =over 4 -=item Messing with Perl's Internals +=item AUTHOR -is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING) +=item SEE ALSO =back -=item UTF-8 vs. utf8 +=head2 ExtUtils::MM_MacOS - once produced Makefiles for MacOS Classic -=item SEE ALSO +=over 4 -=item MAINTAINER +=item SYNOPSIS -=item COPYRIGHT +=item DESCRIPTION =back -=head2 Encode::Alias - alias definitions to encodings +=head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in +ExtUtils::MakeMaker =over 4 @@ -16565,36 +18655,38 @@ 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.: +=back -=over 4 +os_flavor -=item Alias overloading +init_platform, platform_constants -=back +const_cccmd -=item SEE ALSO +static_lib -=back +dynamic_lib -=head2 Encode::Byte - Single Byte Encodings +=head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in +ExtUtils::MakeMaker =over 4 =item SYNOPSIS -=item ABSTRACT - =item DESCRIPTION -=item SEE ALSO +=item METHODS + +init_dist =back -=head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_* +init_linker -=head2 Encode::CN - China-based Chinese Encodings +os_flavor + +=head2 ExtUtils::MM_QNX - QNX specific subclass of ExtUtils::MM_Unix =over 4 @@ -16602,33 +18694,23 @@ reference, e.g.: =item DESCRIPTION -=item NOTES - -=item BUGS +=over 4 -=item SEE ALSO +=item Overridden methods =back -=head2 Encode::CN::HZ -- internally used by Encode::CN - -=head2 Encode::Config -- internally used by Encode - -=head2 Encode::EBCDIC - EBCDIC Encodings +=back =over 4 -=item SYNOPSIS - -=item ABSTRACT - -=item DESCRIPTION +=item AUTHOR =item SEE ALSO =back -=head2 Encode::Encoding - Encode Implementation Base Class +=head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix =over 4 @@ -16638,645 +18720,632 @@ reference, e.g.: =over 4 -=item Methods you should implement - --Eencode($string [,$check]), -Edecode($octets [,$check]), --Ecat_decode($destination, $octets, $offset, $terminator [,$check]) - -=item Other methods defined in Encode::Encodings +=item Overridden methods --Ename, -Erenew, -Erenewed, -Eperlio_ok(), --Eneeds_lines() +os_flavor -=item Example: Encode::ROT13 +=back =back -=item Why the heck Encode API is different? +B =over 4 -=item Compiled Encodings - -=back +=item AUTHOR =item SEE ALSO -Scheme 1, Scheme 2, Other Schemes - =back -=head2 Encode::Guess -- Guesses encoding from data +=head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker =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]) +=item METHODS -=item CAVEATS +=back -=item TO DO +=over 4 -=item SEE ALSO +=item Methods + +os_flavor =back -=head2 Encode::JP - Japanese Encodings +c_o (o) -=over 4 +cflags (o) -=item SYNOPSIS +const_cccmd (o) -=item ABSTRACT +const_config (o) -=item DESCRIPTION +const_loadlibs (o) -=item Note on ISO-2022-JP(-1)? +constants (o) -=item BUGS +depend (o) -=item SEE ALSO +init_DEST -=back +init_dist -=head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP* +dist (o) -=head2 Encode::JP::JIS7 -- internally used by Encode::JP +dist_basics (o) -=head2 Encode::KR - Korean Encodings +dist_ci (o) -=over 4 +dist_core (o) -=item SYNOPSIS +B -=item DESCRIPTION +B -=item BUGS +B -=item SEE ALSO +B -=back +zipfile_target -=head2 Encode::KR::2022_KR -- internally used by Encode::KR +uutardist_target -=head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding +shdist_target -=over 4 +dlsyms (o) -=item SYNOPSIS +dynamic_bs (o) -=item ABSTRACT +dynamic_lib (o) -=item DESCRIPTION +exescan -=item BUGS +extliblist -=item SEE ALSO +find_perl -=back +fixin -=head2 Encode::PerlIO -- a detailed document on Encode and PerlIO +force (o) -=over 4 +guess_name -=item Overview +has_link_code -=item How does it work? +init_dirscan -=item Line Buffering +init_MANPODS -=over 4 +init_MAN1PODS -=item How can I tell whether my encoding fully supports PerlIO ? +init_MAN3PODS -=back +init_PM -=item SEE ALSO +init_DIRFILESEP -=back +init_main -=head2 Encode::Supported -- Encodings supported by Encode +init_others -=over 4 +init_linker -=item DESCRIPTION +init_lib2arch -=over 4 +init_PERL -=item Encoding Names +init_platform, platform_constants -=back +init_PERM -=item Supported Encodings +init_xs -=over 4 +install (o) -=item Built-in Encodings +installbin (o) -=item Encode::Unicode -- other Unicode encodings +linkext (o) -=item Encode::Byte -- Extended ASCII +lsdir -ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for -the Cyrillic world, gsm0338 - Hentai Latin 1 +macro (o) -=item CJK: Chinese, Japanese, Korean (Multibyte) +makeaperl (o) -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 +makefile (o) -=item Miscellaneous encodings +maybe_command -Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess +needs_linking (o) -=back +nicetext -=item Unsupported encodings +parse_abstract - 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 +parse_version -=item Encoding vs. Charset -- terminology +pasthru (o) -=item Encoding Classification (by Anton Tagunov and Dan Kogai) +perl_script -=over 4 +perldepend (o) -=item Microsoft-related naming mess +perm_rw (o) -KS_C_5601-1987, GB2312, Big5, Shift_JIS +perm_rwx (o) -=back +pm_to_blib -=item Glossary +post_constants (o) -character repertoire, coded character set (CCS), character encoding scheme -(CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF, -UTF-16 +post_initialize (o) -=item See Also +postamble (o) -=item References +ppd -ECMA, ECMA-035 (eq C), IANA, Assigned Charset Names by IANA, ISO, -RFC, UC, Unicode Glossary +prefixify -=over 4 +processPL (o) -=item Other Notable Sites +quote_paren -czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org: -"Introduction to i18n" +replace_manpage_separator -=item Offline sources +cd -C by Ken Lunde +oneliner -=back +quote_literal -=back +escape_newlines -=head2 Encode::Symbol - Symbol Encodings +max_exec_len -=over 4 +static (o) -=item SYNOPSIS +static_lib (o) -=item ABSTRACT +staticmake (o) -=item DESCRIPTION +subdir_x (o) -=item SEE ALSO +subdirs (o) -=back +test (o) -=head2 Encode::TW - Taiwan-based Chinese Encodings +test_via_harness (override) -=over 4 +test_via_script (override) -=item SYNOPSIS +tools_other (o) -=item DESCRIPTION +tool_xsubpp (o) -=item NOTES +all_target -=item BUGS +top_targets (o) + +writedoc + +xs_c (o) + +xs_cpp (o) + +xs_o (o) + +=over 4 =item SEE ALSO =back -=head2 Encode::Unicode -- Various Unicode Transformation Formats +=head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in +ExtUtils::MakeMaker =over 4 =item SYNOPSIS -=item ABSTRACT - -L says:, Quick Reference - -=item Size, Endianness, and BOM +=item DESCRIPTION =over 4 -=item by size +=item Methods always loaded -=item by endianness +wraplist -BOM as integer when fetched in network byte order +=back =back -=item Surrogate Pairs +=over 4 -=item Error Checking +=item Methods -=item SEE ALSO +guess_name (override) =back -=head2 Encode::Unicode::UTF7 -- UTF-7 encoding - -=over 4 - -=item SYNOPSIS - -=item ABSTRACT +find_perl (override) -=item In Practice +maybe_command (override) -=item SEE ALSO +pasthru (override) -=back +pm_to_blib (override) -=head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to -encodings +perl_script (override) -=over 4 +replace_manpage_separator -=item SYNOPSIS +init_DEST -=item DESCRIPTION +init_DIRFILESEP -As a simple string, As a qr// compiled regular expression, e.g.:, As a code -reference, e.g.: +init_main (override) -=over 4 +init_others (override) -=item Alias overloading +init_platform (override) -=back +platform_constants -=item SEE ALSO +init_VERSION (override) -=back +constants (override) -=head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm -- -Internally used by Encode::??::ISO_2022_* +special_targets -=head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by -Encode::CN +cflags (override) -=head2 Encode::lib::Encode::Config, Encode::Config -- internally used by -Encode +const_cccmd (override) -=head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode -Implementation Base Class +tools_other (override) -=over 4 +init_dist (override) -=item SYNOPSIS +c_o (override) -=item DESCRIPTION +xs_c (override) -=over 4 +xs_o (override) -=item Methods you should implement +dlsyms (override) --Eencode($string [,$check]), -Edecode($octets [,$check]), --Ecat_decode($destination, $octets, $offset, $terminator [,$check]) +dynamic_lib (override) -=item Other methods defined in Encode::Encodings +static_lib (override) --Ename, -Erenew, -Erenewed, -Eperlio_ok(), --Eneeds_lines() +extra_clean_files -=item Example: Encode::ROT13 +zipfile_target, tarfile_target, shdist_target -=back +install (override) -=item Why the heck Encode API is different? +perldepend (override) -=over 4 +makeaperl (override) -=item Compiled Encodings +nicetext (override) -=back +prefixify (override) -=item SEE ALSO +cd -Scheme 1, Scheme 2, Other Schemes +oneliner -=back +B -=head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from -data +quote_literal -=over 4 +escape_newlines -=item SYNOPSIS +max_exec_len -=item ABSTRACT +init_linker -=item DESCRIPTION +eliminate_macros -Encode::Guess->set_suspects, Encode::Guess->add_suspects, -Encode::decode("Guess" ...), Encode::Guess->guess($data), -guess_encoding($data, [, I]) +fixpath -=item CAVEATS +os_flavor -=item TO DO +=over 4 -=item SEE ALSO +=item AUTHOR =back -=head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by -Encode::JP::2022_JP* +=head2 ExtUtils::MM_VOS - VOS specific subclass of ExtUtils::MM_Unix -=head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used -by Encode::JP +=over 4 -=head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally -used by Encode::KR +=item SYNOPSIS -=head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B' -and 'Q' header encoding +=item DESCRIPTION =over 4 -=item SYNOPSIS +=item Overridden methods -=item ABSTRACT +=back -=item DESCRIPTION +=back -=item BUGS +=over 4 + +=item AUTHOR =item SEE ALSO =back -=head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document -on Encode and PerlIO +=head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in +ExtUtils::MakeMaker =over 4 -=item Overview +=item SYNOPSIS -=item How does it work? +=item DESCRIPTION -=item Line Buffering +=back =over 4 -=item How can I tell whether my encoding fully supports PerlIO ? - -=back +=item Overridden methods -=item SEE ALSO +B =back -=head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings -supported by Encode +replace_manpage_separator -=over 4 +B -=item DESCRIPTION +B -=over 4 +B -=item Encoding Names +init_platform, platform_constants -=back +special_targets -=item Supported Encodings +static_lib -=over 4 +dynamic_lib -=item Built-in Encodings +extra_clean_files -=item Encode::Unicode -- other Unicode encodings +init_linker -=item Encode::Byte -- Extended ASCII +perl_script -ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for -the Cyrillic world, gsm0338 - Hentai Latin 1 +xs_o -=item CJK: Chinese, Japanese, Korean (Multibyte) +pasthru -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 +oneliner -=item Miscellaneous encodings +cd -Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess +max_exec_len -=back +os_flavor -=item Unsupported encodings +=head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X - 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 +=over 4 -=item Encoding vs. Charset -- terminology +=item SYNOPSIS -=item Encoding Classification (by Anton Tagunov and Dan Kogai) +=item DESCRIPTION =over 4 -=item Microsoft-related naming mess +=item Overridden methods -KS_C_5601-1987, GB2312, Big5, Shift_JIS +xs_c =back -=item Glossary +=back -character repertoire, coded character set (CCS), character encoding scheme -(CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF, -UTF-16 +xs_cpp -=item See Also +xs_o -=item References +max_exec_len -ECMA, ECMA-035 (eq C), IANA, Assigned Charset Names by IANA, ISO, -RFC, UC, Unicode Glossary +os_flavor =over 4 -=item Other Notable Sites +=item AUTHOR -czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org: -"Introduction to i18n" +=back -=item Offline sources +=head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization -C by Ken Lunde +=over 4 -=back +=item SYNOPSIS + +=item DESCRIPTION =back -=head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7 -encoding +=head2 ExtUtils::MakeMaker - Create a module Makefile =over 4 =item SYNOPSIS -=item ABSTRACT +=item DESCRIPTION -=item In Practice +=over 4 -=item SEE ALSO +=item How To Write A Makefile.PL -=back +=item Default Makefile Behaviour -=head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder +=item make test -=over 4 +=item make testdb -=item SYNOPSIS +=item make install -=item ABSTRACT +=item INSTALL_BASE -=item Description +=item PREFIX and LIB attribute -=over 4 +=item AFS users -=item Predefined Methods +=item Static Linking of a new Perl Binary + +=item Determination of Perl Library and Installation Locations + +=item Which architecture dependent directory? + +=item Using Attributes and Parameters + +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, 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 -$e = Encode::Encoder-Enew([$data, $encoding]);, encoder(), -$e-Edata([$data]), $e-Eencoding([$encoding]), -$e-Ebytes([$encoding]) +=item Additional lowercase attributes -=item Example: base64 transcoder +clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean, +test, tool_autosplit -=item Operator Overloading +=item Overriding MakeMaker Methods -=back +=item The End Of Cargo Cult Programming -=item SEE ALSO +C<< MAN3PODS => ' ' >> -=back +=item Hintsfile support -=head2 Encodencoding, encoding - allows you to write your script in -non-ascii or non-utf8 +=item Distribution Support -=over 4 + 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 SYNOPSIS +=item Module Meta-Data -=item ABSTRACT +=item Disabling an extension -=over 4 +=item Other Handy Functions -=item Literal Conversions +prompt -=item PerlIO layers for C +=back -=item Implicit upgrading for byte strings +=item ENVIRONMENT -=back +PERL_MM_OPT, PERL_MM_USE_DEFAULT, PERL_CORE -=item FEATURES THAT REQUIRE 5.8.1 +=item SEE ALSO -"NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle +=item AUTHORS -=item USAGE +=item LICENSE -use encoding [I] ;, use encoding I [ STDIN =E -I ...] ;, use encoding I Filter=E1;, no encoding; +=back -=item The Filter Option +=head2 ExtUtils::MakeMaker::Config - Wrapper around Config.pm =over 4 -=item Filter-related changes at Encode version 1.87 +=item SYNOPSIS + +=item DESCRIPTION =back -=item CAVEATS +=head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About +MakeMaker =over 4 -=item NOT SCOPED +=item DESCRIPTION -=item DO NOT MIX MULTIPLE ENCODINGS +=over 4 -=item tr/// with ranges +=item Module Installation -Legend of characters above +How do I install a module into my home directory?, How do I get MakeMaker +and Module::Build to install to the same place?, How do I keep from +installing man pages?, How do I use a module without installing it? -=back +=item Philosophy and History -=item EXAMPLE - Greekperl +Why not just use ?, 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 KNOWN PROBLEMS +=item Module Writing -literals in regex that are longer than 127 bytes, EBCDIC, format +How do I keep my $VERSION up to date without resetting it manually?, What's +this F thing and how did it get in my F?!, How do I +delete everything not in my F? -=over 4 +=item XS -=item The Logic of :locale +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? =back -=item HISTORY +=item PATCHING + +=item AUTHOR =item SEE ALSO =back -=head2 Encoder, Encode::Encoder -- Object Oriented Encoder +=head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker =over 4 =item SYNOPSIS -=item ABSTRACT - -=item Description +=item DESCRIPTION =over 4 -=item Predefined Methods - -$e = Encode::Encoder-Enew([$data, $encoding]);, encoder(), -$e-Edata([$data]), $e-Eencoding([$encoding]), -$e-Ebytes([$encoding]) +=item The Mantra -=item Example: base64 transcoder +=item The Layout -=item Operator Overloading +Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP, +bin/ =back @@ -17284,8 +19353,7 @@ $e-Ebytes([$encoding]) =back -=head2 English - use nice English (or awk) names for ugly punctuation -variables +=head2 ExtUtils::MakeMaker::bytes - Version-agnostic bytes.pm =over 4 @@ -17293,12 +19361,9 @@ variables =item DESCRIPTION -=item PERFORMANCE - =back -=head2 Env - perl module that imports environment variables as scalars or -arrays +=head2 ExtUtils::MakeMaker::vmsish - Platform-agnostic vmsish.pm =over 4 @@ -17306,13 +19371,9 @@ arrays =item DESCRIPTION -=item LIMITATIONS - -=item AUTHOR - =back -=head2 Errno - System errno constants +=head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file =over 4 @@ -17320,69 +19381,64 @@ arrays =item DESCRIPTION -=item CAVEATS +=over 4 -=item AUTHOR +=item Functions -=item COPYRIGHT +mkmanifest =back -=head2 Exporter - Implements default import method for modules - -=over 4 - -=item SYNOPSIS +=back -=item DESCRIPTION +manifind -=over 4 +manicheck -=item How to Export +filecheck -=item Selecting What To Export +fullcheck -=item How to Import +skipcheck -C, C, C +maniread -=back +manicopy -=item Advanced features +maniadd =over 4 -=item Specialised Import Lists - -=item Exporting without using Exporter's import method +=item MANIFEST -=item Exporting without inheriting from Exporter +=item MANIFEST.SKIP -=item Module Version Checking +#!include_default, #!include /Path/to/another/manifest.skip -=item Managing Unknown Symbols +=item EXPORT_OK -=item Tag Handling Utility Functions +=item GLOBAL VARIABLES -=item Generating combined tags +=back -=item Ced Constants +=over 4 -=back +=item DIAGNOSTICS -=back +C I, C I, C I, +C I<$!>, C I -=head2 Exporter::Heavy - Exporter guts +=item ENVIRONMENT -=over 4 +B -=item SYNOPSIS +=item SEE ALSO -=item DESCRIPTION +=item AUTHOR =back -=head2 ExtUtils::CBuilder - Compile and link C code for Perl modules +=head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c =over 4 @@ -17390,40 +19446,22 @@ C, C, C =item DESCRIPTION -=item METHODS - -new, have_compiler, compile, C, C, -C, 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 - -=item HISTORY - -=item AUTHOR - -=item COPYRIGHT - =item SEE ALSO =back -=head2 ExtUtils::CBuilder::Platform::Windows - Builder class for Windows -platforms +=head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader =over 4 -=item DESCRIPTION - -=item AUTHOR +=item SYNOPSIS -=item SEE ALSO +=item DESCRIPTION =back -=head2 ExtUtils::Command - utilities to replace common UNIX commands in -Makefiles etc. +=head2 ExtUtils::Mksymlists - write linker options files for dynamic +extension =over 4 @@ -17431,59 +19469,61 @@ Makefiles etc. =item DESCRIPTION -=back +DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME -cat +=item AUTHOR -eqtime +=item REVISION -rm_rf +mkfh() -rm_f +=back -touch +__find_relocations -mv +=head2 ExtUtils::Packlist - manage .packlist files -cp +=over 4 -chmod +=item SYNOPSIS -mkpath +=item DESCRIPTION -test_f +=item USAGE -dos2unix +=item FUNCTIONS -=over 4 +new(), read(), write(), validate(), packlist_file() -=item SEE ALSO +=item EXAMPLE =item AUTHOR =back -=head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles +=head2 ExtUtils::ParseXS - converts Perl XS code into C code =over 4 =item SYNOPSIS -=item DESCRIPTION +=item EXPORT -B +=item FUNCTIONS -=back +process_xs(), B, B, B, B, B, +B, B, B, B, B, B, +errors() -B +=item AUTHOR -B +=item COPYRIGHT -B +=item SEE ALSO -B +=back -=head2 ExtUtils::Constant - generate XS code to import C header constants +=head2 ExtUtils::testlib - add blib/* directories to @INC =over 4 @@ -17491,32 +19531,23 @@ B =item DESCRIPTION -=item USAGE - -IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF - -=item FUNCTIONS - =back -constant_types - -XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME +=head2 Fatal - replace functions with equivalents which succeed or die -autoload PACKAGE, VERSION, AUTOLOADER +=over 4 -WriteMakefileSnippet +=item SYNOPSIS -WriteConstants ATTRIBUTE =E VALUE [, ...], NAME, DEFAULT_TYPE, -BREAKOUT_AT, NAMES, C_FH, C_FILE, XS_FH, XS_FILE, SUBNAME, C_SUBNAME +=item DESCRIPTION -=over 4 +=item BUGS =item AUTHOR =back -=head2 ExtUtils::Constant::Base - base class for ExtUtils::Constant objects +=head2 Fcntl - load the C Fcntl.h defines =over 4 @@ -17524,40 +19555,38 @@ BREAKOUT_AT, NAMES, C_FH, C_FILE, XS_FH, XS_FILE, SUBNAME, C_SUBNAME =item DESCRIPTION -=item USAGE +=item NOTE -=back +=item EXPORTED SYMBOLS -header +=back -memEQ_clause args_hashref +=head2 File::Basename - Parse file paths into directory, filename and +suffix. -dump_names arg_hashref, ITEM.. +=over 4 -assign arg_hashref, VALUE.. +=item SYNOPSIS -return_clause arg_hashref, ITEM +=item DESCRIPTION -switch_clause arg_hashref, NAMELEN, ITEMHASH, ITEM.. +=back -params WHAT +C X -dogfood arg_hashref, ITEM.. +C X X -normalise_items args, default_type, seen_types, seen_items, ITEM.. +C X -C_constant arg_hashref, ITEM.., name, type, value, macro, default, pre, -post, def_pre, def_post, utf8, weight +C X =over 4 -=item BUGS - -=item AUTHOR +=item SEE ALSO =back -=head2 ExtUtils::Constant::Utils - helper functions for ExtUtils::Constant +=head2 File::CheckTree, validate - run many filetest checks on a tree =over 4 @@ -17565,22 +19594,27 @@ post, def_pre, def_post, utf8, weight =item DESCRIPTION -=item USAGE +=item AUTHOR -C_stringify NAME +=item HISTORY =back -perl_stringify NAME +=head2 File::Compare - Compare files or filehandles =over 4 +=item SYNOPSIS + +=item DESCRIPTION + +=item RETURN + =item AUTHOR =back -=head2 ExtUtils::Constant::XS, ExtUtils::Constant::Base - base class for -ExtUtils::Constant objects +=head2 File::Copy - Copy files or filehandles =over 4 @@ -17588,13 +19622,18 @@ ExtUtils::Constant objects =item DESCRIPTION -=item BUGS +copy X X, move X X X, syscopy X, +rmscopy($from,$to[,$date_flag]) X + +=item RETURN + +=item NOTES =item AUTHOR =back -=head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications +=head2 File::DosGlob - DOS like globbing and then some =over 4 @@ -17602,22 +19641,21 @@ ExtUtils::Constant objects =item DESCRIPTION -=item @EXPORT +=item NOTES -=item FUNCTIONS +=item EXPORTS (by request only) -xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(), -ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules) +=item BUGS -=item EXAMPLES +=item AUTHOR -=item SEE ALSO +=item HISTORY -=item AUTHOR +=item SEE ALSO =back -=head2 ExtUtils::Install - install files from here to there +=head2 File::Fetch - A generic file fetching mechanism =over 4 @@ -17625,91 +19663,91 @@ ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules) =item DESCRIPTION -_chmod($$;$), _warnonce(@), _choke(@) +=item ACCESSORS -=back +$ff->uri, $ff->scheme, $ff->host, $ff->path, $ff->file -_move_file_at_boot( $file, $target, $moan ) +=back -_unlink_or_rename( $file, $tryhard, $installing ) +$ff->output_file =over 4 -=item Functions - -B - -=back +=item METHODS -_get_install_skip +=over 4 -_have_write_access +=item $ff = File::Fetch->new( uri => 'http://some.where.com/dir/file.txt' +); -_can_write_dir(C<$dir>) +=back -_mkpath($dir,$show,$mode,$verbose,$fake) +=back -_copy($from,$to,$verbose,$fake) +=over 4 -_chdir($from) +=item $ff->fetch( [to => /my/output/dir/] ) -_do_cleanup +=back -install_rooted_file( $file ), install_rooted_dir( $dir ) +=over 4 -forceunlink( $file, $tryhard ) +=item $ff->error([BOOL]) -directory_not_empty( $dir ) +=back -B I +=over 4 -B +=item HOW IT WORKS -inc_uninstall($filepath,$libdir,$verbose,$nonono,$ignore) +=item GLOBAL VARIABLES -run_filter($cmd,$src,$dest) +=over 4 -B +=item $File::Fetch::FROM_EMAIL -_autosplit +=item $File::Fetch::USER_AGENT -_invokant +=item $File::Fetch::FTP_PASSIVE -=over 4 +=item $File::Fetch::TIMEOUT -=item ENVIRONMENT +=item $File::Fetch::WARN -B, B, -B +=item $File::Fetch::DEBUG -=item AUTHOR +=item $File::Fetch::BLACKLIST -=item LICENSE +=item $File::Fetch::METHOD_FAIL =back -=head2 ExtUtils::Installed - Inventory management of installed modules +=item MAPPING + +=item FREQUENTLY ASKED QUESTIONS =over 4 -=item SYNOPSIS +=item So how do I use a proxy with File::Fetch? -=item DESCRIPTION +=item I used 'lynx' to fetch a file, but its contents is all wrong! -=item USAGE +=item Files I'm trying to fetch have reserved characters or non-ASCII +characters in them. What do I do? -=item FUNCTIONS +=back -new(), modules(), files(), directories(), directory_tree(), validate(), -packlist(), version() +=item TODO -=item EXAMPLE +Implement $PREFER_BIN -=item AUTHOR +=item AUTHORS + +=item COPYRIGHT =back -=head2 ExtUtils::Liblist - determine libraries to use and how to use them +=head2 File::Find - Traverse a directory tree. =over 4 @@ -17717,34 +19755,39 @@ packlist(), version() =item DESCRIPTION -For static extensions, For dynamic extensions at build/link time, For -dynamic extensions at load time +B, B =over 4 -=item EXTRALIBS +=item %options -=item LDLOADLIBS and LD_RUN_PATH +C, C, C, C, C, +C, C, C, C, +C, C, C -=item BSLOADLIBS +=item The wanted function + +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 =back -=item PORTABILITY +=item WARNINGS -=over 4 +=item CAVEAT -=item VMS implementation +$dont_use_nlink, symlinks -=item Win32 implementation +=item NOTES -=back +=item BUGS AND CAVEATS -=item SEE ALSO +=item HISTORY =back -=head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass +=head2 File::Glob - Perl extension for BSD glob routine =over 4 @@ -17752,9 +19795,31 @@ dynamic extensions at load time =item DESCRIPTION +=over 4 + +=item META CHARACTERS + +=item POSIX FLAGS + +C, C, C, C, C, +C, C, C, C, +C, C, C + =back -=head2 ExtUtils::MM_AIX - AIX specific subclass of ExtUtils::MM_Unix +=item DIAGNOSTICS + +C, C + +=item NOTES + +=item SEE ALSO + +=item AUTHOR + +=back + +=head2 File::GlobMapper - Extend File Glob to Allow Input and Output Files =over 4 @@ -17762,23 +19827,47 @@ dynamic extensions at load time =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 -=back +=item Limitations + +=item Input File Glob + +B<~>, B<~user>, B<.>, B<*>, B, B<\>, B<[]>, B<{,}>, B<()> + +=item Output File Glob + +"*", #1 + +=item Returned Data =back +=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_Any - Platform-agnostic MM methods +=head2 File::Path - create or remove directory trees =over 4 @@ -17786,54 +19875,82 @@ dynamic extensions at load time =item DESCRIPTION -=item METHODS - -=over 4 +=item DIAGNOSTICS -=item Cross-platform helper methods +=item AUTHORS =back -=back +=head2 File::Spec - portably perform operations on file names =over 4 -=item Targets +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS + +canonpath X, catdir X, catfile X, curdir +X, devnull X, rootdir X, tmpdir X, updir +X, no_upwards, case_tolerant, file_name_is_absolute, path X, +join X, splitpath X X, splitdir +X X, catpath(), abs2rel X X +X, rel2abs() X X X + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT =back +=head2 File::Spec::Cygwin - methods for Cygwin file specs + =over 4 -=item Init methods +=item SYNOPSIS + +=item DESCRIPTION =back -=over 4 +canonpath -=item Tools +file_name_is_absolute -=back +tmpdir (override) =over 4 -=item File::Spec wrappers +=item COPYRIGHT =back +=head2 File::Spec::Epoc - methods for Epoc file specs + =over 4 -=item Misc +=item SYNOPSIS + +=item DESCRIPTION =back +canonpath() + =over 4 =item AUTHOR +=item COPYRIGHT + +=item SEE ALSO + =back -=head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in -ExtUtils::MakeMaker +=head2 File::Spec::Functions - portably perform operations on file names =over 4 @@ -17841,14 +19958,19 @@ ExtUtils::MakeMaker =item DESCRIPTION +=over 4 + +=item Exports + =back -os_flavor +=item COPYRIGHT -init_linker +=item SEE ALSO -=head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in -ExtUtils::MakeMaker +=back + +=head2 File::Spec::Mac - File::Spec for Mac OS (Classic) =over 4 @@ -17856,45 +19978,51 @@ ExtUtils::MakeMaker =item DESCRIPTION -os_flavor +=item METHODS + +canonpath =back -cflags +catdir() -replace_manpage_separator +catfile -init_linker +curdir -=head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix +devnull -=over 4 +rootdir -=item SYNOPSIS +tmpdir -=item DESCRIPTION +updir -=over 4 +file_name_is_absolute -=item Overridden methods +path -os_flavor +splitpath -=back +splitdir -=back +catpath -B +abs2rel + +rel2abs =over 4 -=item AUTHOR +=item AUTHORS + +=item COPYRIGHT =item SEE ALSO =back -=head2 ExtUtils::MM_MacOS - once produced Makefiles for MacOS Classic +=head2 File::Spec::OS2 - methods for OS/2 file specs =over 4 @@ -17902,10 +20030,14 @@ B =item DESCRIPTION +tmpdir, splitpath + +=item COPYRIGHT + =back -=head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in -ExtUtils::MakeMaker +=head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec +modules =over 4 @@ -17913,299 +20045,305 @@ ExtUtils::MakeMaker =item DESCRIPTION -=back +=item METHODS -os_flavor +canonpath() -init_platform, platform_constants +=back -const_cccmd +catdir() -static_lib +catfile -dynamic_lib +curdir -=head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in -ExtUtils::MakeMaker +devnull -=over 4 +rootdir -=item SYNOPSIS +tmpdir -=item DESCRIPTION +updir -=item METHODS +no_upwards -init_dist +case_tolerant -=back +file_name_is_absolute -init_linker +path -os_flavor +join -=head2 ExtUtils::MM_QNX - QNX specific subclass of ExtUtils::MM_Unix +splitpath -=over 4 +splitdir -=item SYNOPSIS +catpath() -=item DESCRIPTION +abs2rel + +rel2abs() =over 4 -=item Overridden methods +=item COPYRIGHT -=back +=item SEE ALSO =back +=head2 File::Spec::VMS - methods for VMS file specs + =over 4 -=item AUTHOR +=item SYNOPSIS -=item SEE ALSO +=item DESCRIPTION + +canonpath (override) =back -=head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix +catdir (override) -=over 4 +catfile (override) -=item SYNOPSIS +curdir (override) -=item DESCRIPTION +devnull (override) -=over 4 +rootdir (override) -=item Overridden methods +tmpdir (override) -os_flavor +updir (override) -=back +case_tolerant (override) -=back +path (override) -B +file_name_is_absolute (override) -=over 4 +splitpath (override) -=item AUTHOR +splitdir (override) -=item SEE ALSO +catpath (override) -=back +abs2rel (override) -=head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker +rel2abs (override) =over 4 -=item SYNOPSIS - -=item DESCRIPTION +=item COPYRIGHT -=item METHODS +=item SEE ALSO =back +=head2 File::Spec::Win32 - methods for Win32 file specs + =over 4 -=item Methods +=item SYNOPSIS -os_flavor +=item DESCRIPTION + +devnull =back -c_o (o) +tmpdir -cflags (o) +catfile -const_cccmd (o) +canonpath -const_config (o) +splitpath -const_loadlibs (o) +splitdir -constants (o) +catpath -depend (o) +=over 4 -init_DEST +=item Note For File::Spec::Win32 Maintainers -init_dist +=back -dist (o) +=over 4 -dist_basics (o) +=item COPYRIGHT -dist_ci (o) +=item SEE ALSO -dist_core (o) +=back -B +=head2 File::Temp - return name and handle of a temporary file safely -B +=over 4 -B +=item PORTABILITY -B +=item SYNOPSIS -zipfile_target +=item DESCRIPTION -uutardist_target +=back -shdist_target +=over 4 -dlsyms (o) +=item OBJECT-ORIENTED INTERFACE -dynamic_bs (o) +B -dynamic_lib (o) +=back -exescan +B -extliblist +B -find_perl +B -fixin +=over 4 -force (o) +=item FUNCTIONS -guess_name +B -has_link_code +=back -init_dirscan +B -init_MANPODS +=over 4 -init_MAN1PODS +=item MKTEMP FUNCTIONS -init_MAN3PODS +B -init_PM +=back -init_DIRFILESEP +B -init_main +B -init_others +B -init_linker +=over 4 -init_lib2arch +=item POSIX FUNCTIONS -init_PERL +B -init_platform, platform_constants +=back -init_PERM +B -init_xs +=over 4 -install (o) +=item ADDITIONAL FUNCTIONS -installbin (o) +B -linkext (o) +=back -lsdir +=over 4 -macro (o) +=item UTILITY FUNCTIONS -makeaperl (o) +B -makefile (o) +=back -maybe_command +B -needs_linking (o) +B -nicetext +B -parse_abstract +=over 4 -parse_version +=item PACKAGE VARIABLES -pasthru (o) +B, STANDARD, MEDIUM, HIGH -perl_script +=back -perldepend (o) +TopSystemUID -perm_rw (o) +B<$KEEP_ALL>, B<$DEBUG> -perm_rwx (o) +=over 4 -pm_to_blib +=item WARNING -post_constants (o) +=over 4 -post_initialize (o) +=item Temporary files and NFS -postamble (o) +=item Forking -ppd +=item BINMODE -prefixify +=back -processPL (o) +=item HISTORY -quote_paren +=item SEE ALSO -replace_manpage_separator +=item AUTHOR -cd +=back -oneliner +=head2 File::stat - by-name interface to Perl's built-in stat() functions -quote_literal +=over 4 -escape_newlines +=item SYNOPSIS -max_exec_len +=item DESCRIPTION -static (o) +=item BUGS -static_lib (o) +=item NOTE -staticmake (o) +=item AUTHOR -subdir_x (o) +=back -subdirs (o) +=head2 FileCache - keep more files open than the system permits -test (o) +=over 4 -test_via_harness (override) +=item SYNOPSIS -test_via_script (override) +=item DESCRIPTION -tools_other (o) +cacheout EXPR, cacheout MODE, EXPR -tool_xsubpp (o) +=item CAVEATS -all_target +=item BUGS -top_targets (o) +=back -writedoc +=head2 FileHandle - supply object methods for filehandles -xs_c (o) +=over 4 -xs_cpp (o) +=item SYNOPSIS -xs_o (o) +=item DESCRIPTION -=over 4 +$fh->print, $fh->printf, $fh->getline, $fh->getlines =item SEE ALSO =back -=head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in -ExtUtils::MakeMaker +=head2 Filter::Simple - Simplified source filtering =over 4 @@ -18215,113 +20353,120 @@ ExtUtils::MakeMaker =over 4 -=item Methods always loaded +=item The Problem -wraplist +=item A Solution -=back +=item Disabling or changing behaviour -=back +=item All-in-one interface -=over 4 +=item Filtering only specific components of source code -=item Methods +C<"code">, C<"code_no_comments">, C<"executable">, +C<"executable_no_comments">, C<"quotelike">, C<"string">, C<"regex">, +C<"all"> -guess_name (override) +=item Filtering only the code parts of source code -=back +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. -find_perl (override) +=item Using Filter::Simple with an explicit C subroutine -maybe_command (override) +=item Using Filter::Simple and Exporter together -pasthru (override) +=item How it works -pm_to_blib (override) +=back -perl_script (override) +=item AUTHOR -replace_manpage_separator +=item COPYRIGHT -init_DEST +=back -init_DIRFILESEP +=head2 Filter::Util::Call - Perl Source Filter Utility Module -init_main (override) +=over 4 -init_others (override) +=item SYNOPSIS -init_platform (override) +=item DESCRIPTION -platform_constants +=over 4 -init_VERSION (override) +=item B -constants (override) +=item B -special_targets +=item B -cflags (override) +B<$_>, B<$status>, B and B, B -const_cccmd (override) +=back -tools_other (override) +=item EXAMPLES -init_dist (override) +=over 4 -c_o (override) +=item Example 1: A simple filter. -xs_c (override) +=item Example 2: Using the context -xs_o (override) +=item Example 3: Using the context within the filter -dlsyms (override) +=item Example 4: Using filter_del -dynamic_lib (override) +=back -static_lib (override) +=item Filter::Simple -extra_clean_files +=item AUTHOR -zipfile_target, tarfile_target, shdist_target +=item DATE -install (override) +=back -perldepend (override) +=head2 FindBin - Locate directory of original perl script -makeaperl (override) +=over 4 -nicetext (override) +=item SYNOPSIS -prefixify (override) +=item DESCRIPTION -cd +=item EXPORTABLE VARIABLES -oneliner +=item KNOWN ISSUES -B +=item KNOWN BUGS -quote_literal +=item AUTHORS -escape_newlines +=item COPYRIGHT -max_exec_len +=back -init_linker +=head2 GDBM_File - Perl5 access to the gdbm library. -eliminate_macros +=over 4 -fixpath +=item SYNOPSIS -os_flavor +=item DESCRIPTION -=over 4 +=item AVAILABILITY -=item AUTHOR +=item BUGS + +=item SEE ALSO =back -=head2 ExtUtils::MM_VOS - VOS specific subclass of ExtUtils::MM_Unix +=head2 Getopt::Long - Extended processing of command line options =over 4 @@ -18329,108 +20474,119 @@ os_flavor =item DESCRIPTION +=item Command Line Options, an Introduction + +=item Getting Started with Getopt::Long + =over 4 -=item Overridden methods +=item Simple options -=back +=item A little bit less simple options -=back +=item Mixing command line option with other arguments -=over 4 +=item Options with values -=item AUTHOR +=item Options with multiple values -=item SEE ALSO +=item Options with hash values -=back +=item User-defined subroutines to handle options -=head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in -ExtUtils::MakeMaker +=item Options with multiple names -=over 4 +=item Case and abbreviations -=item SYNOPSIS +=item Summary of Option Specifications -=item DESCRIPTION +!, +, s, i, o, f, : I [ I ], : I [ I ], : ++ [ I ] =back -=over 4 - -=item Overridden methods +=item Advanced Possibilities -B +=over 4 -=back +=item Object oriented interface -replace_manpage_separator +=item Thread Safety -B +=item Documentation and help texts -B +=item Parsing options from an arbitrary array -B +=item Parsing options from an arbitrary string -init_platform, platform_constants +=item Storing options values in a hash -special_targets +=item Bundling -static_lib +=item The lonesome dash -dynamic_lib +=item Argument callback -extra_clean_files +=back -init_linker +=item Configuring Getopt::Long -perl_script +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) -xs_o +=item Exportable Methods -pasthru +VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage -oneliner +=item Return values and Errors -cd +=item Legacy -max_exec_len +=over 4 -os_flavor +=item Default destinations -=head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X +=item Alternative option starters -=over 4 +=item Configuration variables -=item SYNOPSIS +=back -=item DESCRIPTION +=item Tips and Techniques =over 4 -=item Overridden methods - -xs_c +=item Pushing multiple values in a hash option =back -=back +=item Trouble Shooting -xs_cpp +=over 4 -xs_o +=item GetOptions does not return a false result when an option is not +supplied -max_exec_len +=item GetOptions does not split the command line correctly -os_flavor +=item Undefined subroutine &main::GetOptions called -=over 4 +=item How do I put a "-?" option into a Getopt::Long? + +=back =item AUTHOR +=item COPYRIGHT AND DISCLAIMER + =back -=head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization +=head2 Getopt::Std, getopt, getopts - Process single-character switches +with switch clustering =over 4 @@ -18438,9 +20594,11 @@ os_flavor =item DESCRIPTION +=item C<--help> and C<--version> + =back -=head2 ExtUtils::MakeMaker - Create a module Makefile +=head2 Hash::Util - A selection of general-utility hash subroutines =over 4 @@ -18450,184 +20608,155 @@ os_flavor =over 4 -=item How To Write A Makefile.PL - -=item Default Makefile Behaviour - -=item make test - -=item make testdb +=item Field hashes -=item make install +=item Restricted hashes -=item PREFIX and LIB attribute +B, B -=item AFS users +=back -=item Static Linking of a new Perl Binary +=back -=item Determination of Perl Library and Installation Locations +B -=item Which architecture dependent directory? +B, B -=item Using Attributes and Parameters +B, B -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 +B, B -=item Additional lowercase attributes +B -clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean, -test, tool_autosplit +b, B, B, B -=item Overriding MakeMaker Methods +B -=item The End Of Cargo Cult Programming +=over 4 -C<< MAN3PODS => ' ' >> +=item Operating on references to hashes. -=item Hintsfile support +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 -=item Distribution Support +=back - make distcheck, make skipcheck, make distclean, make manifest, - make distdir, make disttest, make tardist, make dist, make -uutardist, make shdist, make zipdist, make ci +=over 4 -=item Module Meta-Data +=item CAVEATS -=item Disabling an extension +=item BUGS -=item Other Handy Functions +=item AUTHOR -prompt +=item SEE ALSO =back -=item ENVIRONMENT - -PERL_MM_OPT, PERL_MM_USE_DEFAULT, PERL_CORE +=head2 Hash::Util::FieldHash - Associate references with data -=item SEE ALSO +=over 4 -=item AUTHORS +=item SYNOPSIS -=item LICENSE +=item Functions -=back +fieldhash, fieldhashes -=head2 ExtUtils::MakeMaker::Config - Wrapper around Config.pm +=item Description =over 4 -=item SYNOPSIS - -=item DESCRIPTION +=item Features -=back +Key exchange, Thread support, Garbage collection -=head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About -MakeMaker +=item Rationale -=over 4 +Stringification, Thread Dependency, Garbage Collection -=item DESCRIPTION +=item How to use -=over 4 +=item Examples -=item Module Installation +=item Garbage-Collected Hashes -How do I keep from installing man pages?, How do I use a module without -installing it? +=back -=item Philosophy and History +=item Guts -Why not just use ?, 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 +=over 4 -=item Module Writing +=item The C interface for hashes -How do I keep my $VERSION up to date without resetting it manually?, What's -this F thing and how did it get in my F?! +=item Weakrefs call uvar magic -=item XS +=item How field hashes work -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 Internal function Hash::Util::FieldHash::_fieldhash =back -=item PATCHING - =item AUTHOR -=item SEE ALSO +=item COPYRIGHT AND LICENSE =back -=head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker +=head2 Hash::Util::FieldHash::lib::Hash::Util::FieldHash, +Hash::Util::FieldHash - Associate references with data =over 4 =item SYNOPSIS -=item DESCRIPTION +=item Functions + +fieldhash, fieldhashes + +=item Description =over 4 -=item The Mantra +=item Features -=item The Layout +Key exchange, Thread support, Garbage collection -Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP, -bin/ +=item Rationale -=back +Stringification, Thread Dependency, Garbage Collection -=item SEE ALSO +=item How to use + +=item Examples + +=item Garbage-Collected Hashes =back -=head2 ExtUtils::MakeMaker::bytes - Version-agnostic bytes.pm +=item Guts =over 4 -=item SYNOPSIS +=item The C interface for hashes -=item DESCRIPTION +=item Weakrefs call uvar magic -=back +=item How field hashes work -=head2 ExtUtils::MakeMaker::vmsish - Platform-agnostic vmsish.pm +=item Internal function Hash::Util::FieldHash::_fieldhash -=over 4 +=back -=item SYNOPSIS +=item AUTHOR -=item DESCRIPTION +=item COPYRIGHT AND LICENSE =back -=head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file +=head2 Hash::Utilib::Hash::Util, Hash::Util - A selection of +general-utility hash subroutines =over 4 @@ -18637,60 +20766,54 @@ bin/ =over 4 -=item Functions +=item Field hashes -mkmanifest +=item Restricted hashes -=back +B, B =back -manifind - -manicheck - -filecheck +=back -fullcheck +B -skipcheck +B, B -maniread +B, B -manicopy +B, B -maniadd +B -=over 4 +b, B, B, B -=item MANIFEST +B -=item MANIFEST.SKIP +=over 4 -=item EXPORT_OK +=item Operating on references to hashes. -=item GLOBAL VARIABLES +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 DIAGNOSTICS - -C I, C I, C I, -C I<$!>, C I +=item CAVEATS -=item ENVIRONMENT +=item BUGS -B +=item AUTHOR =item SEE ALSO -=item AUTHOR - =back -=head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c +=head2 I18N::Collate - compare 8-bit scalar data according to the current +locale =over 4 @@ -18698,11 +20821,10 @@ B =item DESCRIPTION -=item SEE ALSO - =back -=head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader +=head2 I18N::LangTags - functions for dealing with RFC3066-style language +tags =over 4 @@ -18712,70 +20834,64 @@ B =back -=head2 ExtUtils::Mksymlists - write linker options files for dynamic -extension +the function is_language_tag($lang1) -=over 4 +the function extract_language_tags($whatever) -=item SYNOPSIS +the function same_language_tag($lang1, $lang2) -=item DESCRIPTION +the function similarity_language_tag($lang1, $lang2) -DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME +the function is_dialect_of($lang1, $lang2) -=item AUTHOR +the function super_languages($lang1) -=item REVISION +the function locale2language_tag($locale_identifier) -mkfh() +the function encode_language_tag($lang1) -=back +the function alternate_language_tags($lang1) -__find_relocations +the function @langs = panic_languages(@accept_languages) -=head2 ExtUtils::Packlist - manage .packlist files +the function implicate_supers( ...languages... ), the function +implicate_supers_strictly( ...languages... ) =over 4 -=item SYNOPSIS - -=item DESCRIPTION - -=item USAGE +=item ABOUT LOWERCASING -=item FUNCTIONS +=item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS -new(), read(), write(), validate(), packlist_file() +=item SEE ALSO -=item EXAMPLE +=item COPYRIGHT =item AUTHOR =back -=head2 ExtUtils::ParseXS - converts Perl XS code into C code +=head2 I18N::LangTags::Detect - detect the user's language preferences =over 4 =item SYNOPSIS -=item EXPORT +=item DESCRIPTION =item FUNCTIONS -process_xs(), B, B, B, B, B, -B, B, B, B, B, B, -errors() +=item ENVIRONMENT -=item AUTHOR +=item SEE ALSO =item COPYRIGHT -=item SEE ALSO +=item AUTHOR =back -=head2 ExtUtils::testlib - add blib/* directories to @INC +=head2 I18N::LangTags::List -- tags and names for human languages =over 4 @@ -18783,9 +20899,147 @@ errors() =item DESCRIPTION +=item ABOUT LANGUAGE TAGS + +=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 COPYRIGHT AND DISCLAIMER + +=item AUTHOR + =back -=head2 Fatal - replace functions with equivalents which succeed or die +=head2 I18N::Langinfo - query locale information =over 4 @@ -18793,13 +21047,21 @@ errors() =item DESCRIPTION -=item BUGS +=over 4 + +=item EXPORT + +=back + +=item SEE ALSO =item AUTHOR +=item COPYRIGHT AND LICENSE + =back -=head2 Fcntl - load the C Fcntl.h defines +=head2 IO - load various IO modules =over 4 @@ -18807,14 +21069,30 @@ errors() =item DESCRIPTION -=item NOTE +=item DEPRECATED -=item EXPORTED SYMBOLS +=back + +=head2 IO::Compress::Base - Base Class for IO::Compress modules + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=item AUTHOR + +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE =back -=head2 File::Basename - Parse file paths into directory, filename and -suffix. +=head2 IO::Compress::Base::lib::File::GlobMapper, File::GlobMapper - Extend +File Glob to Allow Input and Output Files =over 4 @@ -18822,37 +21100,48 @@ suffix. =item DESCRIPTION -=back +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! -C X +=over 4 -C X X +=item Behind The Scenes -C X +=item Limitations -C X +=item Input File Glob -=over 4 +B<~>, B<~user>, B<.>, B<*>, B, B<\>, B<[]>, B<{,}>, B<()> -=item SEE ALSO +=item Output File Glob + +"*", #1 + +=item Returned Data =back -=head2 File::CheckTree, validate - run many filetest checks on a tree +=item EXAMPLES =over 4 -=item SYNOPSIS +=item A Rename script -=item DESCRIPTION +=item A few example globmaps + +=back + +=item SEE ALSO =item AUTHOR -=item HISTORY +=item COPYRIGHT AND LICENSE =back -=head2 File::Compare - Compare files or filehandles +=head2 IO::Compress::Base::lib::IO::Compress::Base, IO::Compress::Base - +Base Class for IO::Compress modules =over 4 @@ -18860,13 +21149,19 @@ C X =item DESCRIPTION -=item RETURN +=item SEE ALSO =item AUTHOR +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE + =back -=head2 File::Copy - Copy files or filehandles +=head2 IO::Compress::Base::lib::IO::Uncompress::AnyUncompress, +IO::Uncompress::AnyUncompress - Uncompress gzip, zip, bzip2 or lzop +file/buffer =over 4 @@ -18874,112 +21169,124 @@ C X =item DESCRIPTION -copy X X, move X X X, syscopy X, -rmscopy($from,$to[,$date_flag]) X +RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip, bzip2, lzop, lzf -=item RETURN +=item Functional Interface -=item NOTES +=over 4 -=item AUTHOR +=item anyuncompress $input => $output [, OPTS] -=back +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 -=head2 File::DosGlob - DOS like globbing and then some +=item Notes -=over 4 +=item Optional Parameters -=item SYNOPSIS +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >> -=item DESCRIPTION +=item Examples -=item NOTES +=back -=item EXPORTS (by request only) +=item OO Interface -=item BUGS +=over 4 -=item AUTHOR +=item Constructor -=item HISTORY +A filename, A filehandle, A scalar reference -=item SEE ALSO +=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 >>, C<< RawInflate => 0|1 +>> + +=item Examples =back -=head2 File::Find - Traverse a directory tree. +=item Methods =over 4 -=item SYNOPSIS +=item read -=item DESCRIPTION +=item read -B, B +=item getline -=over 4 +=item getc -=item %options +=item ungetc -C, C, C, C, C, -C, C, C, C, -C, C, C +=item getHeaderInfo -=item The wanted function +=item tell -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 +=item eof -=back +=item seek -=item WARNINGS +=item binmode -=item CAVEAT +=item opened -$dont_use_nlink, symlinks +=item autoflush -=item NOTES +=item input_line_number -=item BUGS AND CAVEATS +=item fileno -=item HISTORY +=item close -=back +=item nextStream -=head2 File::Glob - Perl extension for BSD glob routine +=item trailingData -=over 4 +=back -=item SYNOPSIS +=item Importing -=item DESCRIPTION +:all -=over 4 +=item EXAMPLES -=item META CHARACTERS +=item SEE ALSO -=item POSIX FLAGS +=item AUTHOR -C, C, C, C, C, -C, C, C, C, -C, C, C +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE =back -=item DIAGNOSTICS +=head2 IO::Compress::Base::lib::IO::Uncompress::Base, IO::Uncompress::Base +- Base Class for IO::Uncompress modules -C, C +=over 4 -=item NOTES +=item SYNOPSIS + +=item DESCRIPTION =item SEE ALSO =item AUTHOR +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE + =back -=head2 File::GlobMapper - Extend File Glob to Allow Input and Output Files +=head2 IO::Compress::Deflate - Write RFC 1950 files/buffers =over 4 @@ -18987,105 +21294,98 @@ C, C =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 Functional Interface =over 4 -=item Behind The Scenes - -=item Limitations +=item deflate $input => $output [, OPTS] -=item Input File Glob +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 -B<~>, B<~user>, B<.>, B<*>, B, B<\>, B<[]>, B<{,}>, B<()> +=item Notes -=item Output File Glob +=item Optional Parameters -"*", #1 +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> -=item Returned Data +=item Examples =back -=item EXAMPLES +=item OO Interface =over 4 -=item A Rename script - -=item A few example globmaps +=item Constructor -=back +A filename, A filehandle, A scalar reference -=item SEE ALSO +=item Constructor Options -=item AUTHOR +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 COPYRIGHT AND LICENSE +=item Examples =back -=head2 File::Path - create or remove directory trees +=item Methods =over 4 -=item SYNOPSIS - -=item DESCRIPTION +=item print -=item DIAGNOSTICS +=item printf -=item AUTHORS +=item syswrite -=back +=item write -=head2 File::Spec - portably perform operations on file names +=item flush -=over 4 +=item tell -=item SYNOPSIS +=item eof -=item DESCRIPTION +=item seek -=item METHODS +=item binmode -canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir, -no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath, -splitdir, catpath(), abs2rel, rel2abs() +=item opened -=item SEE ALSO +=item autoflush -=item AUTHOR +=item input_line_number -=item COPYRIGHT +=item fileno -=back +=item close -=head2 File::Spec::Cygwin - methods for Cygwin file specs +=item newStream([OPTS]) -=over 4 +=item deflateParams -=item SYNOPSIS +=back -=item DESCRIPTION +=item Importing -=back +:all, :constants, :flush, :level, :strategy -canonpath +=item EXAMPLES -file_name_is_absolute +=item SEE ALSO -tmpdir (override) +=item AUTHOR -=over 4 +=item MODIFICATION HISTORY -=item COPYRIGHT +=item COPYRIGHT AND LICENSE =back -=head2 File::Spec::Epoc - methods for Epoc file specs +=head2 IO::Compress::Gzip - Write RFC 1952 files/buffers =over 4 @@ -19093,93 +21393,102 @@ tmpdir (override) =item DESCRIPTION -=back - -canonpath() +=item Functional Interface =over 4 -=item AUTHOR +=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, An Array +Reference, An Output FileGlob + +=item Notes + +=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::Functions - portably perform operations on file names +=item OO Interface =over 4 -=item SYNOPSIS - -=item DESCRIPTION - -=over 4 +=item Constructor -=item Exports +A filename, A filehandle, A scalar reference -=back +=item Constructor Options -=item COPYRIGHT +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 SEE ALSO +=item Examples =back -=head2 File::Spec::Mac - File::Spec for Mac OS (Classic) +=item Methods =over 4 -=item SYNOPSIS +=item print -=item DESCRIPTION +=item printf -=item METHODS +=item syswrite -canonpath +=item write -=back +=item flush -catdir() +=item tell -catfile +=item eof -curdir +=item seek -devnull +=item binmode -rootdir +=item opened -tmpdir +=item autoflush -updir +=item input_line_number -file_name_is_absolute +=item fileno -path +=item close -splitpath +=item newStream([OPTS]) -splitdir +=item deflateParams -catpath +=back -abs2rel +=item Importing -rel2abs +:all, :constants, :flush, :level, :strategy -=over 4 +=item EXAMPLES -=item AUTHORS +=item SEE ALSO -=item COPYRIGHT +=item AUTHOR -=item SEE ALSO +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE =back -=head2 File::Spec::OS2 - methods for OS/2 file specs +=head2 IO::Compress::RawDeflate - Write RFC 1951 files/buffers =over 4 @@ -19187,274 +21496,304 @@ rel2abs =item DESCRIPTION -tmpdir, splitpath - -=item COPYRIGHT +=item Functional Interface -=back +=over 4 -=head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec -modules +=item rawdeflate $input => $output [, OPTS] -=over 4 +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 SYNOPSIS +=item Notes -=item DESCRIPTION +=item Optional Parameters -=item METHODS +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> -canonpath() +=item Examples =back -catdir() +=item OO Interface -catfile +=over 4 -curdir +=item Constructor -devnull +A filename, A filehandle, A scalar reference -rootdir +=item Constructor Options -tmpdir +C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A +Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> -updir +=item Examples -no_upwards +=back -case_tolerant +=item Methods -file_name_is_absolute +=over 4 -path +=item print -join +=item printf -splitpath +=item syswrite -splitdir +=item write -catpath() +=item flush -abs2rel +=item tell -rel2abs() +=item eof -=over 4 +=item seek -=item COPYRIGHT +=item binmode -=item SEE ALSO +=item opened -=back +=item autoflush -=head2 File::Spec::VMS - methods for VMS file specs +=item input_line_number -=over 4 +=item fileno -=item SYNOPSIS +=item close -=item DESCRIPTION +=item newStream([OPTS]) -canonpath (override) +=item deflateParams =back -catdir (override) - -catfile (override) - -curdir (override) +=item Importing -devnull (override) +:all, :constants, :flush, :level, :strategy -rootdir (override) +=item EXAMPLES -tmpdir (override) +=item SEE ALSO -updir (override) +=item AUTHOR -case_tolerant (override) +=item MODIFICATION HISTORY -path (override) +=item COPYRIGHT AND LICENSE -file_name_is_absolute (override) +=back -splitpath (override) +=head2 IO::Compress::Zip - Write zip files/buffers -splitdir (override) +=over 4 -catpath (override) +=item SYNOPSIS -abs2rel (override) +=item DESCRIPTION -rel2abs (override) +=item Functional Interface =over 4 -=item COPYRIGHT +=item zip $input => $output [, OPTS] -=item SEE ALSO +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 -=head2 File::Spec::Win32 - methods for Win32 file specs +=item Optional Parameters -=over 4 +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> -=item SYNOPSIS +=item Examples -=item DESCRIPTION +=back -devnull +=item OO Interface -=back +=over 4 -tmpdir +=item Constructor -catfile +A filename, A filehandle, A scalar reference -canonpath +=item Constructor Options -splitpath +C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A +Filehandle, C<< Name => $string >>, C<< Time => $number >>, C<< ExtAttr => +$attr >>, C<< exTime => [$atime, $mtime, $ctime] >>, C<< Comment => +$comment >>, C<< ZipComment => $comment >>, C<< Method => $method >>, C<< +Stream => 0|1 >>, C<< Zip64 => 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 >> -splitdir +=item Examples -catpath +=back + +=item Methods =over 4 -=item Note For File::Spec::Win32 Maintainers +=item print -=back +=item printf -=over 4 +=item syswrite -=item COPYRIGHT +=item write -=item SEE ALSO +=item flush -=back +=item tell -=head2 File::Temp - return name and handle of a temporary file safely +=item eof -=over 4 +=item seek -=item PORTABILITY +=item binmode -=item SYNOPSIS +=item opened -=item DESCRIPTION +=item autoflush -=back +=item input_line_number -=over 4 +=item fileno -=item OBJECT-ORIENTED INTERFACE +=item close -B +=item newStream([OPTS]) + +=item deflateParams =back -B +=item Importing -B +:all, :constants, :flush, :level, :strategy, :zip_method + +=item EXAMPLES -B +=item SEE ALSO -=over 4 +=item AUTHOR -=item FUNCTIONS +=item MODIFICATION HISTORY -B +=item COPYRIGHT AND LICENSE =back -B +=head2 IO::Compress::Zlib::IO::Compress::Deflate, IO::Compress::Deflate - +Write RFC 1950 files/buffers =over 4 -=item MKTEMP FUNCTIONS +=item SYNOPSIS -B +=item DESCRIPTION -=back +=item Functional Interface -B +=over 4 -B +=item deflate $input => $output [, OPTS] -B +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 POSIX FUNCTIONS +=item Optional Parameters -B +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> + +=item Examples =back -B +=item OO Interface =over 4 -=item ADDITIONAL FUNCTIONS +=item Constructor -B +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 UTILITY FUNCTIONS +=item print -B +=item printf -=back +=item syswrite -B +=item write -B +=item flush -B +=item tell -=over 4 +=item eof -=item PACKAGE VARIABLES +=item seek -B, STANDARD, MEDIUM, HIGH +=item binmode -=back +=item opened -TopSystemUID +=item autoflush -B<$KEEP_ALL>, B<$DEBUG> +=item input_line_number -=over 4 +=item fileno -=item WARNING +=item close -=over 4 +=item newStream([OPTS]) -=item Temporary files and NFS +=item deflateParams -=item Forking +=back -=item BINMODE +=item Importing -=back +:all, :constants, :flush, :level, :strategy -=item HISTORY +=item EXAMPLES =item SEE ALSO =item AUTHOR +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE + =back -=head2 File::stat - by-name interface to Perl's built-in stat() functions +=head2 IO::Compress::Zlib::IO::Compress::Gzip, IO::Compress::Gzip - Write +RFC 1952 files/buffers =over 4 @@ -19462,90 +21801,103 @@ B<$KEEP_ALL>, B<$DEBUG> =item DESCRIPTION -=item BUGS +=item Functional Interface -=item NOTE +=over 4 -=item AUTHOR +=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, 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 -=head2 FileCache - keep more files open than the system permits +=item OO Interface =over 4 -=item SYNOPSIS +=item Constructor -=item DESCRIPTION +A filename, A filehandle, A scalar reference -cacheout EXPR, cacheout MODE, EXPR +=item Constructor Options -=item CAVEATS +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 BUGS +=item Examples =back -=head2 FileHandle - supply object methods for filehandles +=item Methods =over 4 -=item SYNOPSIS - -=item DESCRIPTION +=item print -$fh->print, $fh->printf, $fh->getline, $fh->getlines +=item printf -=item SEE ALSO +=item syswrite -=back +=item write -=head2 Filter::Simple - Simplified source filtering +=item flush -=over 4 +=item tell -=item SYNOPSIS +=item eof -=item DESCRIPTION +=item seek -=over 4 +=item binmode -=item The Problem +=item opened -=item A Solution +=item autoflush -=item Disabling or changing behaviour +=item input_line_number -=item All-in-one interface +=item fileno -=item Filtering only specific components of source code +=item close -C<"code">, C<"code_no_comments">, C<"executable">, -C<"executable_no_comments">, C<"quotelike">, C<"string">, C<"regex">, -C<"all"> +=item newStream([OPTS]) -=item Filtering only the code parts of source code +=item deflateParams -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 subroutine +=item Importing -=item Using Filter::Simple and Exporter together +:all, :constants, :flush, :level, :strategy -=item How it works +=item EXAMPLES -=back +=item SEE ALSO =item AUTHOR -=item COPYRIGHT +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE =back -=head2 Filter::Util::Call - Perl Source Filter Utility Module +=head2 IO::Compress::Zlib::IO::Compress::RawDeflate, +IO::Compress::RawDeflate - Write RFC 1951 files/buffers =over 4 @@ -19553,77 +21905,99 @@ from the other partial filters described in the previous section. =item DESCRIPTION +=item Functional Interface + =over 4 -=item B +=item rawdeflate $input => $output [, OPTS] -=item B +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 +=item Notes -B<$_>, B<$status>, B and B, B +=item Optional Parameters + +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> + +=item Examples =back -=item EXAMPLES +=item OO Interface =over 4 -=item Example 1: A simple filter. +=item Constructor -=item Example 2: Using the context +A filename, A filehandle, A scalar reference -=item Example 3: Using the context within the filter +=item Constructor Options -=item Example 4: Using filter_del +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 Filter::Simple +=item Methods -=item AUTHOR +=over 4 -=item DATE +=item print -=back +=item printf -=head2 FindBin - Locate directory of original perl script +=item syswrite -=over 4 +=item write -=item SYNOPSIS +=item flush -=item DESCRIPTION +=item tell -=item EXPORTABLE VARIABLES +=item eof -=item KNOWN ISSUES +=item seek -=item KNOWN BUGS +=item binmode -=item AUTHORS +=item opened -=item COPYRIGHT +=item autoflush + +=item input_line_number + +=item fileno + +=item close + +=item newStream([OPTS]) + +=item deflateParams =back -=head2 GDBM_File - Perl5 access to the gdbm library. +=item Importing -=over 4 +:all, :constants, :flush, :level, :strategy -=item SYNOPSIS +=item EXAMPLES -=item DESCRIPTION +=item SEE ALSO -=item AVAILABILITY +=item AUTHOR -=item BUGS +=item MODIFICATION HISTORY -=item SEE ALSO +=item COPYRIGHT AND LICENSE =back -=head2 Getopt::Long - Extended processing of command line options +=head2 IO::Compress::Zlib::IO::Compress::Zip, IO::Compress::Zip - Write zip +files/buffers =over 4 @@ -19631,119 +22005,105 @@ B<$_>, B<$status>, B and B, B =item DESCRIPTION -=item Command Line Options, an Introduction - -=item Getting Started with Getopt::Long +=item Functional Interface =over 4 -=item Simple options - -=item A little bit less simple options - -=item Mixing command line option with other arguments - -=item Options with values - -=item Options with multiple values - -=item Options with hash values +=item zip $input => $output [, OPTS] -=item User-defined subroutines to handle options +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 Options with multiple names +=item Notes -=item Case and abbreviations +=item Optional Parameters -=item Summary of Option Specifications +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> -!, +, s, i, o, f, : I [ I ], : I [ I ], : -+ [ I ] +=item Examples =back -=item Advanced Possibilities +=item OO Interface =over 4 -=item Object oriented interface - -=item Thread Safety - -=item Documentation and help texts +=item Constructor -=item Storing option values in a hash +A filename, A filehandle, A scalar reference -=item Bundling +=item Constructor Options -=item The lonesome dash +C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A +Filehandle, C<< Name => $string >>, C<< Time => $number >>, C<< ExtAttr => +$attr >>, C<< exTime => [$atime, $mtime, $ctime] >>, C<< Comment => +$comment >>, C<< ZipComment => $comment >>, C<< Method => $method >>, C<< +Stream => 0|1 >>, C<< Zip64 => 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 Argument callback +=item Examples =back -=item Configuring Getopt::Long +=item Methods -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) +=over 4 -=item Exportable Methods +=item print -VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage +=item printf -=item Return values and Errors +=item syswrite -=item Legacy +=item write -=over 4 +=item flush -=item Default destinations +=item tell -=item Alternative option starters +=item eof -=item Configuration variables +=item seek -=back +=item binmode -=item Trouble Shooting +=item opened -=over 4 +=item autoflush -=item GetOptions does not return a false result when an option is not -supplied +=item input_line_number -=item GetOptions does not split the command line correctly +=item fileno -=item Undefined subroutine &main::GetOptions called +=item close -=item How do I put a "-?" option into a Getopt::Long? +=item newStream([OPTS]) -=back +=item deflateParams -=item AUTHOR +=back -=item COPYRIGHT AND DISCLAIMER +=item Importing -=back +:all, :constants, :flush, :level, :strategy, :zip_method -=head2 Getopt::Std, getopt, getopts - Process single-character switches -with switch clustering +=item EXAMPLES -=over 4 +=item SEE ALSO -=item SYNOPSIS +=item AUTHOR -=item DESCRIPTION +=item MODIFICATION HISTORY -=item C<--help> and C<--version> +=item COPYRIGHT AND LICENSE =back -=head2 Hash::Util - A selection of general-utility hash subroutines +=head2 IO::Compress::Zlib::IO::Uncompress::AnyInflate, +IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip) file/buffer =over 4 @@ -19751,225 +22111,221 @@ with switch clustering =item DESCRIPTION -=over 4 - -=item Field hashes - -=item Restricted hashes +RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip -B, B +=item Functional Interface -=back +=over 4 -=back +=item anyinflate $input => $output [, OPTS] -B +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 -B, B +=item Notes -B, B +=item Optional Parameters -B, B +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >> -B +=item Examples -b, B, B, B +=back -B +=item OO Interface =over 4 -=item Operating on references to hashes. +=item Constructor -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 +A filename, A filehandle, A scalar reference -=back +=item Constructor Options -=over 4 +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<< RawInflate => 0|1 +>>, C<< ParseExtra => 0|1 >> If the gzip FEXTRA header field is present and +this option is set, it will force the module to check that it conforms to +the sub-field structure as defined in RFC 1952 -=item CAVEATS +=item Examples -=item BUGS +=back -=item AUTHOR +=item Methods -=item SEE ALSO +=over 4 -=back +=item read -=head2 Hash::Util::FieldHash - Associate references with data +=item read -=over 4 +=item getline -=item SYNOPSIS +=item getc -=item Functions +=item ungetc -fieldhash, fieldhashes +=item inflateSync -=item Description +=item getHeaderInfo -=over 4 +=item tell -=item Features +=item eof -Key exchange, Thread support, Garbage collection +=item seek -=item Rationale +=item binmode -Stringification, Thread Dependency, Garbage Collection +=item opened -=item How to use +=item autoflush -=item Examples +=item input_line_number -=item Garbage-Collected Hashes +=item fileno -=back +=item close -=item Guts +=item nextStream -=over 4 +=item trailingData -=item The C interface for hashes +=back -=item Weakrefs call uvar magic +=item Importing -=item How field hashes work +:all -=item Internal function Hash::Util::FieldHash::_fieldhash +=item EXAMPLES -=back +=item SEE ALSO =item AUTHOR +=item MODIFICATION HISTORY + =item COPYRIGHT AND LICENSE =back -=head2 Hash::Util::FieldHash::lib::Hash::Util::FieldHash, -Hash::Util::FieldHash - Associate references with data +=head2 IO::Compress::Zlib::IO::Uncompress::Gunzip, IO::Uncompress::Gunzip - +Read RFC 1952 files/buffers =over 4 =item SYNOPSIS -=item Functions - -fieldhash, fieldhashes +=item DESCRIPTION -=item Description +=item Functional Interface =over 4 -=item Features +=item gunzip $input => $output [, OPTS] -Key exchange, Thread support, Garbage collection +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 Rationale +=item Notes -Stringification, Thread Dependency, Garbage Collection +=item Optional Parameters -=item How to use +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >> =item Examples -=item Garbage-Collected Hashes - =back -=item Guts +=item OO Interface =over 4 -=item The C interface for hashes - -=item Weakrefs call uvar magic - -=item How field hashes work +=item Constructor -=item Internal function Hash::Util::FieldHash::_fieldhash +A filename, A filehandle, A scalar reference -=back +=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 +>> If the gzip FEXTRA header field is present and this option is set, it +will force the module to check that it conforms to the sub-field structure +as defined in RFC 1952 -=item COPYRIGHT AND LICENSE +=item Examples =back -=head2 Hash::Utilib::Hash::Util, Hash::Util - A selection of -general-utility hash subroutines +=item Methods =over 4 -=item SYNOPSIS +=item read + +=item read -=item DESCRIPTION +=item getline -=over 4 +=item getc -=item Field hashes +=item ungetc -=item Restricted hashes +=item inflateSync -B, B +=item getHeaderInfo -=back +Name, Comment -=back +=item tell -B +=item eof -B, B +=item seek -B, B +=item binmode -B, B +=item opened -B +=item autoflush -b, B, B, B +=item input_line_number -B +=item fileno -=over 4 +=item close -=item Operating on references to hashes. +=item nextStream -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 +=item trailingData =back -=over 4 - -=item CAVEATS +=item Importing -=item BUGS +:all -=item AUTHOR +=item EXAMPLES =item SEE ALSO -=back - -=head2 I18N::Collate - compare 8-bit scalar data according to the current -locale - -=over 4 +=item AUTHOR -=item SYNOPSIS +=item MODIFICATION HISTORY -=item DESCRIPTION +=item COPYRIGHT AND LICENSE =back -=head2 I18N::LangTags - functions for dealing with RFC3066-style language -tags +=head2 IO::Compress::Zlib::IO::Uncompress::Inflate, IO::Uncompress::Inflate +- Read RFC 1950 files/buffers =over 4 @@ -19977,214 +22333,105 @@ tags =item DESCRIPTION -=back - -the function is_language_tag($lang1) - -the function extract_language_tags($whatever) +=item Functional Interface -the function same_language_tag($lang1, $lang2) +=over 4 -the function similarity_language_tag($lang1, $lang2) +=item inflate $input => $output [, OPTS] -the function is_dialect_of($lang1, $lang2) +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 -the function super_languages($lang1) +=item Notes -the function locale2language_tag($locale_identifier) +=item Optional Parameters -the function encode_language_tag($lang1) +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >> -the function alternate_language_tags($lang1) +=item Examples -the function @langs = panic_languages(@accept_languages) +=back -the function implicate_supers( ...languages... ), the function -implicate_supers_strictly( ...languages... ) +=item OO Interface =over 4 -=item ABOUT LOWERCASING +=item Constructor -=item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS +A filename, A filehandle, A scalar reference -=item SEE ALSO +=item Constructor Options -=item COPYRIGHT +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 AUTHOR +=item Examples =back -=head2 I18N::LangTags::Detect - detect the user's language preferences +=item Methods =over 4 -=item SYNOPSIS +=item read -=item DESCRIPTION +=item read -=item FUNCTIONS +=item getline -=item ENVIRONMENT +=item getc -=item SEE ALSO +=item ungetc -=item COPYRIGHT +=item inflateSync -=item AUTHOR +=item getHeaderInfo -=back +=item tell -=head2 I18N::LangTags::List -- tags and names for human languages +=item eof -=over 4 +=item seek -=item SYNOPSIS +=item binmode -=item DESCRIPTION +=item opened -=item ABOUT LANGUAGE TAGS +=item autoflush -=item LIST OF LANGUAGES +=item input_line_number -{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 fileno -=item SEE ALSO +=item close -=item COPYRIGHT AND DISCLAIMER +=item nextStream + +=item trailingData + +=back + +=item Importing + +:all + +=item EXAMPLES + +=item SEE ALSO =item AUTHOR +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE + =back -=head2 I18N::Langinfo - query locale information +=head2 IO::Compress::Zlib::IO::Uncompress::RawInflate, +IO::Uncompress::RawInflate - Read RFC 1951 files/buffers =over 4 @@ -20192,39 +22439,92 @@ Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd} =item DESCRIPTION +=item Functional Interface + =over 4 -=item EXPORT +=item rawinflate $input => $output [, OPTS] -=back +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 SEE ALSO +=item Notes -=item AUTHOR +=item Optional Parameters -=item COPYRIGHT AND LICENSE +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >> + +=item Examples =back -=head2 IO - load various IO modules +=item OO Interface =over 4 -=item SYNOPSIS +=item Constructor -=item DESCRIPTION +A filename, A filehandle, A scalar reference -=item DEPRECATED +=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 IO::Compress::Base - Base Class for IO::Compress modules +=item Methods =over 4 -=item SYNOPSIS +=item read -=item DESCRIPTION +=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 EXAMPLES =item SEE ALSO @@ -20236,7 +22536,8 @@ Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd} =back -=head2 IO::Compress::Deflate - Write RFC 1950 files/buffers +=head2 IO::Compress::Zlib::IO::Uncompress::Unzip, IO::Uncompress::Unzip - +Read zip files/buffers =over 4 @@ -20244,15 +22545,11 @@ Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd} =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 deflate $input => $output [, OPTS] +=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 @@ -20262,7 +22559,8 @@ Reference, An Output FileGlob =item Optional Parameters -C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >> =item Examples @@ -20278,8 +22576,9 @@ 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 >> +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 @@ -20289,57 +22588,197 @@ Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 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 =item eof -=item seek +=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 EXAMPLES + +=item SEE ALSO + +=item AUTHOR + +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE + +=back + +=head2 IO::Dir - supply object methods for directory handles + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +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 IO::File - supply object methods for filehandles + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CONSTRUCTOR + +new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile + +=item METHODS + +open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( +[LAYER] ) + +=item NOTE + +=item SEE ALSO + +=item HISTORY + +=back + +=head2 IO::Handle - supply object methods for I/O handles + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CONSTRUCTOR + +new (), new_from_fd ( FD, MODE ) + +=item METHODS + +$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 NOTE + +=item SEE ALSO + +=item BUGS + +=item HISTORY + +=back + +=head2 IO::Pipe - supply object methods for pipes + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CONSTRUCTOR + +new ( [READER, WRITER] ) + +=item METHODS + +reader ([ARGS]), writer ([ARGS]), handles () + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 IO::Poll - Object interface to system poll call -=item binmode +=over 4 -=item opened +=item SYNOPSIS -=item autoflush +=item DESCRIPTION -=item input_line_number +=item METHODS -=item fileno +mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( +IO ), handles( [ EVENT_MASK ] ) -=item close +=item SEE ALSO -=item newStream([OPTS]) +=item AUTHOR -=item deflateParams +=item COPYRIGHT =back -=item Importing +=head2 IO::Seekable - supply seek based methods for I/O objects -:all, :constants, :flush, :level, :strategy +=over 4 -=item EXAMPLES +=item SYNOPSIS -=item SEE ALSO +=item DESCRIPTION -=item AUTHOR +$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 MODIFICATION HISTORY +=item SEE ALSO -=item COPYRIGHT AND LICENSE +=item HISTORY =back -=head2 IO::Compress::Gzip - Write RFC 1952 files/buffers +=head2 IO::Select - OO interface to the select system call =over 4 @@ -20347,106 +22786,104 @@ Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> =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 CONSTRUCTOR -=item gzip $input => $output [, OPTS] +new ( [ HANDLES ] ) -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 METHODS -=item Notes +add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( +[ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), +count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) -=item Optional Parameters +=item EXAMPLE -C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> +=item AUTHOR -=item Examples +=item COPYRIGHT =back -=item OO Interface +=head2 IO::Socket - Object interface to socket communications =over 4 -=item Constructor +=item SYNOPSIS -A filename, A filehandle, A scalar reference +=item DESCRIPTION -=item Constructor Options +=item CONSTRUCTOR -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 ->> +new ( [ARGS] ) -=item Examples +=item METHODS + +accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, +protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT =back -=item Methods +=head2 IO::Socket::INET - Object interface for AF_INET domain sockets =over 4 -=item print +=item SYNOPSIS -=item printf +=item DESCRIPTION -=item syswrite +=item CONSTRUCTOR -=item write +new ( [ARGS] ) -=item flush +=over 4 -=item tell +=item METHODS -=item eof +sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost +() -=item seek +=back -=item binmode +=item SEE ALSO -=item opened +=item AUTHOR -=item autoflush +=item COPYRIGHT -=item input_line_number +=back -=item fileno +=head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets -=item close +=over 4 -=item newStream([OPTS]) +=item SYNOPSIS -=item deflateParams +=item DESCRIPTION -=back +=item CONSTRUCTOR -=item Importing +new ( [ARGS] ) -:all, :constants, :flush, :level, :strategy +=item METHODS -=item EXAMPLES +hostpath(), peerpath() =item SEE ALSO =item AUTHOR -=item MODIFICATION HISTORY - -=item COPYRIGHT AND LICENSE +=item COPYRIGHT =back -=head2 IO::Compress::RawDeflate - Write RFC 1951 files/buffers +=head2 IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip) +file/buffer =over 4 @@ -20454,15 +22891,13 @@ C<< ExtraField => $data >>, C<< ExtraFlags => $value >>, C<< Strict => 0|1 =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 +RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip =item Functional Interface =over 4 -=item rawdeflate $input => $output [, OPTS] +=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, An Array @@ -20472,7 +22907,8 @@ Reference, An Output FileGlob =item Optional Parameters -C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >> =item Examples @@ -20488,8 +22924,12 @@ 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 >> +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<< RawInflate => 0|1 +>>, C<< ParseExtra => 0|1 >> If the gzip FEXTRA header field is present and +this option is set, it will force the module to check that it conforms to +the sub-field structure as defined in RFC 1952 =item Examples @@ -20499,15 +22939,19 @@ Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 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 @@ -20527,15 +22971,15 @@ Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> =item close -=item newStream([OPTS]) +=item nextStream -=item deflateParams +=item trailingData =back =item Importing -:all, :constants, :flush, :level, :strategy +:all =item EXAMPLES @@ -20549,7 +22993,8 @@ Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> =back -=head2 IO::Compress::Zip - Write zip files/buffers +=head2 IO::Uncompress::AnyUncompress - Uncompress gzip, zip, bzip2 or lzop +file/buffer =over 4 @@ -20557,15 +23002,13 @@ Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> =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 +RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip, bzip2, lzop, lzf =item Functional Interface =over 4 -=item zip $input => $output [, OPTS] +=item anyuncompress $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 @@ -20575,7 +23018,8 @@ Reference, An Output FileGlob =item Optional Parameters -C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >> =item Examples @@ -20591,13 +23035,10 @@ 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<< 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 >> +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<< RawInflate => 0|1 +>> =item Examples @@ -20607,15 +23048,17 @@ WorkFactor => number >>, -Level, -Strategy, C<< Strict => 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 getHeaderInfo =item tell @@ -20635,15 +23078,15 @@ WorkFactor => number >>, -Level, -Strategy, C<< Strict => 0|1 >> =item close -=item newStream([OPTS]) +=item nextStream -=item deflateParams +=item trailingData =back =item Importing -:all, :constants, :flush, :level, :strategy, :zip_method +:all =item EXAMPLES @@ -20657,7 +23100,7 @@ WorkFactor => number >>, -Level, -Strategy, C<< Strict => 0|1 >> =back -=head2 IO::Dir - supply object methods for directory handles +=head2 IO::Uncompress::Base - Base Class for IO::Uncompress modules =over 4 @@ -20665,18 +23108,17 @@ WorkFactor => number >>, -Level, -Strategy, C<< Strict => 0|1 >> =item DESCRIPTION -new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), -rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] - =item SEE ALSO =item AUTHOR -=item COPYRIGHT +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE =back -=head2 IO::File - supply object methods for filehandles +=head2 IO::Uncompress::Gunzip - Read RFC 1952 files/buffers =over 4 @@ -20684,116 +23126,109 @@ rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] =item DESCRIPTION -=item CONSTRUCTOR +=item Functional Interface -new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile +=over 4 -=item METHODS +=item gunzip $input => $output [, OPTS] -open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( -[LAYER] ) +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 NOTE +=item Notes -=item SEE ALSO +=item Optional Parameters -=item HISTORY +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >> + +=item Examples =back -=head2 IO::Handle - supply object methods for I/O handles +=item OO Interface =over 4 -=item SYNOPSIS - -=item DESCRIPTION - -=item CONSTRUCTOR - -new (), new_from_fd ( FD, MODE ) - -=item METHODS - -$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 Constructor -=item NOTE +A filename, A filehandle, A scalar reference -=item SEE ALSO +=item Constructor Options -=item BUGS +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 +>> If the gzip FEXTRA header field is present and this option is set, it +will force the module to check that it conforms to the sub-field structure +as defined in RFC 1952 -=item HISTORY +=item Examples =back -=head2 IO::Pipe - supply object methods for pipes +=item Methods =over 4 -=item SYNOPSIS +=item read -=item DESCRIPTION +=item read -=item CONSTRUCTOR +=item getline -new ( [READER, WRITER] ) +=item getc -=item METHODS +=item ungetc -reader ([ARGS]), writer ([ARGS]), handles () +=item inflateSync -=item SEE ALSO +=item getHeaderInfo -=item AUTHOR +Name, Comment -=item COPYRIGHT +=item tell -=back +=item eof -=head2 IO::Poll - Object interface to system poll call +=item seek -=over 4 +=item binmode -=item SYNOPSIS +=item opened -=item DESCRIPTION +=item autoflush -=item METHODS +=item input_line_number -mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( -IO ), handles( [ EVENT_MASK ] ) +=item fileno -=item SEE ALSO +=item close -=item AUTHOR +=item nextStream -=item COPYRIGHT +=item trailingData =back -=head2 IO::Seekable - supply seek based methods for I/O objects +=item Importing -=over 4 +:all -=item SYNOPSIS +=item EXAMPLES -=item DESCRIPTION +=item SEE ALSO -$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 AUTHOR -=item SEE ALSO +=item MODIFICATION HISTORY -=item HISTORY +=item COPYRIGHT AND LICENSE =back -=head2 IO::Select - OO interface to the select system call +=head2 IO::Uncompress::Inflate - Read RFC 1950 files/buffers =over 4 @@ -20801,104 +23236,104 @@ $io->tell =item DESCRIPTION -=item CONSTRUCTOR +=item Functional Interface -new ( [ HANDLES ] ) +=over 4 -=item METHODS +=item inflate $input => $output [, OPTS] -add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( -[ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), -count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) +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 EXAMPLE +=item Notes -=item AUTHOR +=item Optional Parameters -=item COPYRIGHT +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >> + +=item Examples =back -=head2 IO::Socket - Object interface to socket communications +=item OO Interface =over 4 -=item SYNOPSIS - -=item DESCRIPTION - -=item CONSTRUCTOR - -new ( [ARGS] ) - -=item METHODS +=item Constructor -accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, -protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) +A filename, A filehandle, A scalar reference -=item SEE ALSO +=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 >> -=item COPYRIGHT +=item Examples =back -=head2 IO::Socket::INET - Object interface for AF_INET domain sockets +=item Methods =over 4 -=item SYNOPSIS +=item read -=item DESCRIPTION +=item read -=item CONSTRUCTOR +=item getline -new ( [ARGS] ) +=item getc -=over 4 +=item ungetc -=item METHODS +=item inflateSync -sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost -() +=item getHeaderInfo -=back +=item tell -=item SEE ALSO +=item eof -=item AUTHOR +=item seek -=item COPYRIGHT +=item binmode -=back +=item opened -=head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets +=item autoflush -=over 4 +=item input_line_number -=item SYNOPSIS +=item fileno -=item DESCRIPTION +=item close -=item CONSTRUCTOR +=item nextStream -new ( [ARGS] ) +=item trailingData -=item METHODS +=back -hostpath(), peerpath() +=item Importing + +:all + +=item EXAMPLES =item SEE ALSO =item AUTHOR -=item COPYRIGHT +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE =back -=head2 IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip) -file/buffer +=head2 IO::Uncompress::RawInflate - Read RFC 1951 files/buffers =over 4 @@ -20906,15 +23341,11 @@ file/buffer =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, RFC 1950, RFC 1951, gzip (RFC 1952), zip - =item Functional Interface =over 4 -=item anyinflate $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, An Array @@ -20925,7 +23356,7 @@ Reference, An Output FileGlob =item Optional Parameters C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, -C<< MultiStream => 0|1 >> +C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >> =item Examples @@ -20943,8 +23374,7 @@ A filename, A filehandle, A scalar reference 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 ->> +$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =item Examples @@ -21008,8 +23438,7 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< ParseExtra => 0|1 =back -=head2 IO::Uncompress::AnyUncompress - Uncompress gzip, zip, bzip2 or lzop -file/buffer +=head2 IO::Uncompress::Unzip - Read zip files/buffers =over 4 @@ -21017,15 +23446,11 @@ file/buffer =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, RFC 1950, RFC 1951, gzip (RFC 1952), zip, bzip2, lzop - =item Functional Interface =over 4 -=item anyuncompress $input => $output [, OPTS] +=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 @@ -21036,7 +23461,7 @@ Reference, An Output FileGlob =item Optional Parameters C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, -C<< MultiStream => 0|1 >> +C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >> =item Examples @@ -21074,6 +23499,8 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =item ungetc +=item inflateSync + =item getHeaderInfo =item tell @@ -21116,7 +23543,7 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =back -=head2 IO::Uncompress::Base - Base Class for IO::Uncompress modules +=head2 IO::Zlib - IO:: style interface to L =over 4 @@ -21124,129 +23551,143 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =item DESCRIPTION -=item SEE ALSO +=item CONSTRUCTOR -=item AUTHOR +new ( [ARGS] ) -=item MODIFICATION HISTORY +=item OBJECT METHODS -=item COPYRIGHT AND LICENSE +open ( FILENAME, MODE ), opened, close, getc, getline, getlines, print ( +ARGS... ), read ( BUF, NBYTES, [OFFSET] ), eof, seek ( OFFSET, WHENCE ), +tell, setpos ( POS ), getpos ( POS ) -=back +=item USING THE EXTERNAL GZIP -=head2 IO::Uncompress::Gunzip - Read RFC 1952 files/buffers +=item CLASS METHODS -=over 4 +has_Compress_Zlib, gzip_external, gzip_used, gzip_read_open, +gzip_write_open -=item SYNOPSIS +=item DIAGNOSTICS -=item DESCRIPTION +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::WRITE: too long LENGTH, IO::Zlib::WRITE: OFFSET is not supported -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 SEE ALSO -=item Functional Interface +=item HISTORY + +=item COPYRIGHT + +=back + +=head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory +handles =over 4 -=item gunzip $input => $output [, OPTS] +=item SYNOPSIS -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 DESCRIPTION -=item Notes +new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), +rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] -=item Optional Parameters +=item SEE ALSO -C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, -C<< MultiStream => 0|1 >> +=item AUTHOR -=item Examples +=item COPYRIGHT =back -=item OO Interface +=head2 IO::lib::IO::File, IO::File - supply object methods for filehandles =over 4 -=item Constructor +=item SYNOPSIS -A filename, A filehandle, A scalar reference +=item DESCRIPTION -=item Constructor Options +=item CONSTRUCTOR -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 ->> +new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile -=item Examples +=item METHODS -=back +open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( +[LAYER] ) -=item Methods +=item NOTE -=over 4 +=item SEE ALSO -=item read +=item HISTORY -=item read +=back -=item getline +=head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O +handles -=item getc +=over 4 -=item ungetc +=item SYNOPSIS -=item inflateSync +=item DESCRIPTION -=item getHeaderInfo +=item CONSTRUCTOR -Name, Comment +new (), new_from_fd ( FD, MODE ) -=item tell +=item METHODS -=item eof +$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 seek +=item NOTE -=item binmode +=item SEE ALSO -=item opened +=item BUGS -=item autoflush +=item HISTORY -=item input_line_number +=back -=item fileno +=head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes -=item close +=over 4 -=item nextStream +=item SYNOPSIS -=item trailingData +=item DESCRIPTION -=back +=item CONSTRUCTOR -=item Importing +new ( [READER, WRITER] ) -:all +=item METHODS -=item EXAMPLES +reader ([ARGS]), writer ([ARGS]), handles () =item SEE ALSO =item AUTHOR -=item MODIFICATION HISTORY - -=item COPYRIGHT AND LICENSE +=item COPYRIGHT =back -=head2 IO::Uncompress::Inflate - Read RFC 1950 files/buffers +=head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call =over 4 @@ -21254,108 +23695,93 @@ Name, Comment =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, An Array -Reference, An Output FileGlob +=item METHODS -=item Notes +mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( +IO ), handles( [ EVENT_MASK ] ) -=item Optional Parameters +=item SEE ALSO -C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, -C<< MultiStream => 0|1 >> +=item AUTHOR -=item Examples +=item COPYRIGHT =back -=item OO Interface +=head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for +I/O objects =over 4 -=item Constructor +=item SYNOPSIS -A filename, A filehandle, A scalar reference +=item DESCRIPTION -=item Constructor Options +$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 -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 SEE ALSO -=item Examples +=item HISTORY =back -=item Methods +=head2 IO::lib::IO::Select, IO::Select - OO interface to the select system +call =over 4 -=item read - -=item read - -=item getline - -=item getc - -=item ungetc +=item SYNOPSIS -=item inflateSync +=item DESCRIPTION -=item getHeaderInfo +=item CONSTRUCTOR -=item tell +new ( [ HANDLES ] ) -=item eof +=item METHODS -=item seek +add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( +[ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), +count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) -=item binmode +=item EXAMPLE -=item opened +=item AUTHOR -=item autoflush +=item COPYRIGHT -=item input_line_number +=back -=item fileno +=head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket +communications -=item close +=over 4 -=item nextStream +=item SYNOPSIS -=item trailingData +=item DESCRIPTION -=back +=item CONSTRUCTOR -=item Importing +new ( [ARGS] ) -:all +=item METHODS -=item EXAMPLES +accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, +protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) =item SEE ALSO =item AUTHOR -=item MODIFICATION HISTORY - -=item COPYRIGHT AND LICENSE +=item COPYRIGHT =back -=head2 IO::Uncompress::RawInflate - Read RFC 1951 files/buffers +=head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for +AF_INET domain sockets =over 4 @@ -21363,108 +23789,106 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =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 CONSTRUCTOR -=item Functional Interface +new ( [ARGS] ) =over 4 -=item rawinflate $input => $output [, OPTS] +=item METHODS -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 +sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost +() -=item Notes +=back -=item Optional Parameters +=item SEE ALSO -C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, -C<< MultiStream => 0|1 >> +=item AUTHOR -=item Examples +=item COPYRIGHT =back -=item OO Interface +=head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for +AF_UNIX domain sockets =over 4 -=item Constructor +=item SYNOPSIS -A filename, A filehandle, A scalar reference +=item DESCRIPTION -=item Constructor Options +=item CONSTRUCTOR -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 >> +new ( [ARGS] ) -=item Examples +=item METHODS -=back +hostpath(), peerpath() -=item Methods +=item SEE ALSO -=over 4 +=item AUTHOR -=item read +=item COPYRIGHT -=item read +=back -=item getline +=head2 IPC::Msg - SysV Msg IPC object class -=item getc +=over 4 -=item ungetc +=item SYNOPSIS -=item inflateSync +=item DESCRIPTION -=item getHeaderInfo +=item METHODS -=item tell +new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set +( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, +FLAGS ] ), stat -=item eof +=item SEE ALSO -=item seek +=item AUTHOR -=item binmode +=item COPYRIGHT -=item opened +=back -=item autoflush +=head2 IPC::Open2, open2 - open a process for both reading and writing -=item input_line_number +=over 4 -=item fileno +=item SYNOPSIS -=item close +=item DESCRIPTION -=item nextStream +=item WARNING -=item trailingData +=item SEE ALSO =back -=item Importing +=head2 IPC::Open3, open3 - open a process for reading, writing, and error +handling -:all +=over 4 -=item EXAMPLES +=item SYNOPSIS -=item SEE ALSO +=item DESCRIPTION -=item AUTHOR +=item See Also -=item MODIFICATION HISTORY +L, L -=item COPYRIGHT AND LICENSE +=item WARNING =back -=head2 IO::Uncompress::Unzip - Read zip files/buffers +=head2 IPC::Semaphore - SysV Semaphore IPC object class =over 4 @@ -21472,174 +23896,170 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =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 METHODS -=item Notes +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 Optional Parameters +=item SEE ALSO -C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, -C<< MultiStream => 0|1 >> +=item AUTHOR -=item Examples +=item COPYRIGHT =back -=item OO Interface +=head2 IPC::SysV - SysV IPC constants =over 4 -=item Constructor +=item SYNOPSIS + +=item DESCRIPTION -A filename, A filehandle, A scalar reference +ftok( PATH, ID ) -=item Constructor Options +=item SEE ALSO -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 AUTHORS -=item Examples +=item COPYRIGHT =back -=item Methods +=head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class =over 4 -=item read - -=item read +=item SYNOPSIS -=item getline +=item DESCRIPTION -=item getc +=item METHODS -=item ungetc +new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set +( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, +FLAGS ] ), stat -=item inflateSync +=item SEE ALSO -=item getHeaderInfo +=item AUTHOR -=item tell +=item COPYRIGHT -=item eof +=back -=item seek +=head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object +class -=item binmode +=over 4 -=item opened +=item SYNOPSIS -=item autoflush +=item DESCRIPTION -=item input_line_number +=item METHODS -=item fileno +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 close +=item SEE ALSO -=item nextStream +=item AUTHOR -=item trailingData +=item COPYRIGHT =back -=item Importing +=head2 IPCmd, IPC::Cmd - finding and running system commands made easy -:all +=over 4 -=item EXAMPLES +=item SYNOPSIS -=item SEE ALSO +=item DESCRIPTION -=item AUTHOR +=item CLASS METHODS -=item MODIFICATION HISTORY +=over 4 -=item COPYRIGHT AND LICENSE +=item $bool = IPC::Cmd->can_use_ipc_run( [VERBOSE] ) =back -=head2 IO::Zlib - IO:: style interface to L +=back =over 4 -=item SYNOPSIS +=item $bool = IPC::Cmd->can_use_ipc_open3( [VERBOSE] ) -=item DESCRIPTION +=back -=item CONSTRUCTOR +=over 4 -new ( [ARGS] ) +=item $bool = IPC::Cmd->can_capture_buffer -=item OBJECT METHODS +=back -open ( FILENAME, MODE ), opened, close, getc, getline, getlines, print ( -ARGS... ), read ( BUF, NBYTES, [OFFSET] ), eof, seek ( OFFSET, WHENCE ), -tell, setpos ( POS ), getpos ( POS ) +=over 4 -=item USING THE EXTERNAL GZIP +=item FUNCTIONS -=item CLASS METHODS +=over 4 -has_Compress_Zlib, gzip_external, gzip_used, gzip_read_open, -gzip_write_open +=item $path = can_run( PROGRAM ); -=item DIAGNOSTICS +=back -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 +=back -=item SEE ALSO +=over 4 -=item HISTORY +=item $ok | ($ok, $err, $full_buf, $stdout_buff, $stderr_buff) = run( +command => COMMAND, [verbose => BOOL, buffer => \$SCALAR] ); -=item COPYRIGHT +command, verbose, buffer, success, errorcode, full_buffer, out_buffer, +error_buffer =back -=head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory -handles +=over 4 + +=item HOW IT WORKS + +=item Global Variables =over 4 -=item SYNOPSIS +=item $IPC::Cmd::VERBOSE -=item DESCRIPTION +=item $IPC::Cmd::USE_IPC_RUN -new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), -rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] +=item $IPC::Cmd::USE_IPC_OPEN3 -=item SEE ALSO +=item $IPC::Cmd::WARN + +=back + +=item Caveats + +Whitespace, IO Redirect + +=item See Also =item AUTHOR +=item ACKNOWLEDGEMENTS + =item COPYRIGHT =back -=head2 IO::lib::IO::File, IO::File - supply object methods for filehandles +=head2 List::Util - A selection of general-utility list subroutines =over 4 @@ -21647,25 +24067,21 @@ rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] =item DESCRIPTION -=item CONSTRUCTOR - -new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile - -=item METHODS +first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce +BLOCK LIST, shuffle LIST, sum LIST -open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( -[LAYER] ) +=item KNOWN BUGS -=item NOTE +=item SUGGESTED ADDITIONS =item SEE ALSO -=item HISTORY +=item COPYRIGHT =back -=head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O -handles +=head2 List::Utilib::List::Util, List::Util - A selection of +general-utility list subroutines =over 4 @@ -21673,28 +24089,21 @@ handles =item DESCRIPTION -=item CONSTRUCTOR - -new (), new_from_fd ( FD, MODE ) - -=item METHODS +first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce +BLOCK LIST, shuffle LIST, sum LIST -$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 KNOWN BUGS -=item NOTE +=item SUGGESTED ADDITIONS =item SEE ALSO -=item BUGS - -=item HISTORY +=item COPYRIGHT =back -=head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes +=head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of +general-utility scalar subroutines =over 4 @@ -21702,23 +24111,21 @@ $io->blocking ( [ BOOL ] ), $io->untaint =item DESCRIPTION -=item CONSTRUCTOR - -new ( [READER, WRITER] ) - -=item METHODS +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 -reader ([ARGS]), writer ([ARGS]), handles () +=item KNOWN BUGS =item SEE ALSO -=item AUTHOR - =item COPYRIGHT +=item BLATANT PLUG + =back -=head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call +=head2 Locale::Constants - constants for Locale codes =over 4 @@ -21726,21 +24133,19 @@ reader ([ARGS]), writer ([ARGS]), handles () =item DESCRIPTION -=item METHODS - -mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( -IO ), handles( [ EVENT_MASK ] ) +=item KNOWN BUGS AND LIMITATIONS =item SEE ALSO +Locale::Language, Locale::Country, Locale::Script, Locale::Currency + =item AUTHOR =item COPYRIGHT =back -=head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for -I/O objects +=head2 Locale::Country - ISO codes for country identification (ISO 3166) =over 4 @@ -21748,36 +24153,39 @@ 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, B, B -=item SEE ALSO +=item CONVERSION ROUTINES -=item HISTORY +code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ), +country_code2code( CODE, CODESET, CODESET ) -=back +=item QUERY ROUTINES -=head2 IO::lib::IO::Select, IO::Select - OO interface to the select system -call +C, C + +=item SEMI-PRIVATE ROUTINES =over 4 -=item SYNOPSIS +=item alias_code -=item DESCRIPTION +=item rename_country -=item CONSTRUCTOR +=back -new ( [ HANDLES ] ) +=item EXAMPLES -=item METHODS +=item DOMAIN NAMES -add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( -[ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), -count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) +=item KNOWN BUGS AND LIMITATIONS -=item EXAMPLE +=item SEE ALSO + +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 AUTHOR @@ -21785,8 +24193,8 @@ count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) =back -=head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket -communications +=head2 Locale::Currency - ISO three letter codes for currency +identification (ISO 4217) =over 4 @@ -21794,25 +24202,33 @@ communications =item DESCRIPTION -=item CONSTRUCTOR +XTS, XXX -new ( [ARGS] ) +=item CONVERSION ROUTINES -=item METHODS +code2currency(), currency2code() -accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, -protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) +=item QUERY ROUTINES + +C, C + +=item EXAMPLES + +=item KNOWN BUGS AND LIMITATIONS =item SEE ALSO +Locale::Country, Locale::Script, ISO 4217:1995, +http://www.bsi-global.com/iso4217currency + =item AUTHOR =item COPYRIGHT =back -=head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for -AF_INET domain sockets +=head2 Locale::Language - ISO two letter codes for language identification +(ISO 639) =over 4 @@ -21820,29 +24236,30 @@ AF_INET domain sockets =item DESCRIPTION -=item CONSTRUCTOR +=item CONVERSION ROUTINES -new ( [ARGS] ) +code2language(), language2code() -=over 4 +=item QUERY ROUTINES -=item METHODS +C, C -sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost -() +=item EXAMPLES -=back +=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::Socket::UNIX, IO::Socket::UNIX - Object interface for -AF_UNIX domain sockets +=head2 Locale::Maketext - framework for localization =over 4 @@ -21850,99 +24267,101 @@ AF_UNIX domain sockets =item DESCRIPTION -=item CONSTRUCTOR - -new ( [ARGS] ) +=item QUICK OVERVIEW =item METHODS -hostpath(), peerpath() +=over 4 -=item SEE ALSO +=item Construction Methods -=item AUTHOR +=item The "maketext" Method -=item COPYRIGHT +$lh->fail_with I $lh->fail_with(I), $lh->failure_handler_auto + +=item Utility Methods + +$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 Language Handle Attributes and Internals =back -=head2 IPC::Msg - SysV Msg IPC object class +=item LANGUAGE CLASS HIERARCHIES -=over 4 +=item ENTRIES IN EACH LEXICON -=item SYNOPSIS +=item BRACKET NOTATION -=item DESCRIPTION +=item AUTO LEXICONS -=item METHODS +=item CONTROLLING LOOKUP FAILURE -new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set -( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, -FLAGS ] ), stat +=item HOW TO USE MAKETEXT =item SEE ALSO -=item AUTHOR +=item COPYRIGHT AND DISCLAIMER -=item COPYRIGHT +=item AUTHOR =back -=head2 IPC::Open2, open2 - open a process for both reading and writing +=head2 Locale::Maketext::Simple - Simple interface to +Locale::Maketext::Lexicon =over 4 +=item VERSION + =item SYNOPSIS =item DESCRIPTION -=item WARNING - -=item SEE ALSO +=item OPTIONS -=back +=over 4 -=head2 IPC::Open3, open3 - open a process for reading, writing, and error -handling +=item Class -=over 4 +=item Path -=item SYNOPSIS +=item Style -=item DESCRIPTION +=item Export -=item See Also +=item Subclass -L, L +=item Decode -=item WARNING +=item Encoding =back -=head2 IPC::Semaphore - SysV Semaphore IPC object class +=back =over 4 -=item SYNOPSIS +=item ACKNOWLEDGMENTS -=item DESCRIPTION +=item SEE ALSO -=item METHODS +=item AUTHORS -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 COPYRIGHT -=item SEE ALSO +=over 4 -=item AUTHOR +=item The "MIT" License -=item COPYRIGHT +=back =back -=head2 IPC::SysV - SysV IPC constants +=head2 Locale::Maketext::TPJ13 -- article about software localization =over 4 @@ -21950,40 +24369,37 @@ set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N =item DESCRIPTION -ftok( PATH, ID ) +=item Localization and Perl: gettext breaks, Maketext fixes -=item SEE ALSO +=over 4 -=item AUTHORS +=item A Localization Horror Story: It Could Happen To You -=item COPYRIGHT +=item The Linguistic View -=back +=item Breaking gettext -=head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class +=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 -new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set -( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, -FLAGS ] ), stat +=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 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object -class +=head2 Locale::Script - ISO codes for script identification (ISO 15924) =over 4 @@ -21991,42 +24407,39 @@ class =item DESCRIPTION -=item METHODS +B, B, B -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 +=over 4 -=item SEE ALSO +=item SPECIAL CODES -=item AUTHOR +=back -=item COPYRIGHT +=item CONVERSION ROUTINES -=back +code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ), +script_code2code( CODE, CODESET, CODESET ) -=head2 List::Util - A selection of general-utility list subroutines +=item QUERY ROUTINES -=over 4 +C, C -=item SYNOPSIS +=item EXAMPLES -=item DESCRIPTION +=item KNOWN BUGS AND LIMITATIONS -first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce -BLOCK LIST, shuffle LIST, sum LIST +=item SEE ALSO -=item KNOWN BUGS +Locale::Language, Locale::Currency, Locale::Country, ISO 15924, +http://www.evertype.com/standards/iso15924/ -=item SUGGESTED ADDITIONS +=item AUTHOR =item COPYRIGHT =back -=head2 List::Utilib::List::Util, List::Util - A selection of -general-utility list subroutines +=head2 Log::Message - A generic message storing mechanism; =over 4 @@ -22034,108 +24447,94 @@ general-utility list subroutines =item DESCRIPTION -first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce -BLOCK LIST, shuffle LIST, sum LIST +=item Hierarchy -=item KNOWN BUGS +Log::Message, Log::Message::Item, Log::Message::Handlers, +Log::Message::Config -=item SUGGESTED ADDITIONS +=item Options -=item COPYRIGHT +config, private, verbose, tag, level, remove, chrono =back -=head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of -general-utility scalar subroutines - =over 4 -=item SYNOPSIS - -=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 - -=item KNOWN BUGS +=item Methods -=item COPYRIGHT +=over 4 -=item BLATANT PLUG +=item new =back -=head2 Locale::Constants - constants for Locale codes +=back =over 4 -=item SYNOPSIS - -=item DESCRIPTION +=item store -=item KNOWN BUGS AND LIMITATIONS +message, tag, level, extra -=item SEE ALSO +=back -Locale::Language, Locale::Country, Locale::Script, Locale::Currency +=over 4 -=item AUTHOR +=item retrieve -=item COPYRIGHT +tag, level, message, amount, chrono, remove =back -=head2 Locale::Country - ISO codes for country identification (ISO 3166) - =over 4 -=item SYNOPSIS +=item first -=item DESCRIPTION +=back -B, B, B +=over 4 -=item CONVERSION ROUTINES +=item last -code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ), -country_code2code( CODE, CODESET, CODESET ) +=back -=item QUERY ROUTINES +=over 4 -C, C +=item flush -=item SEMI-PRIVATE ROUTINES +=back =over 4 -=item alias_code +=item SEE ALSO -=item rename_country +=item AUTHOR + +=item Acknowledgements + +=item COPYRIGHT =back -=item EXAMPLES +=head2 Log::Message::Config - Configuration options for Log::Message -=item DOMAIN NAMES +=over 4 -=item KNOWN BUGS AND LIMITATIONS +=item SYNOPSIS -=item SEE ALSO +=item DESCRIPTION -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 SEE ALSO =item AUTHOR +=item Acknowledgements + =item COPYRIGHT =back -=head2 Locale::Currency - ISO three letter codes for currency -identification (ISO 4217) +=head2 Log::Message::Handlers - Message handlers for Log::Message =over 4 @@ -22143,64 +24542,73 @@ identification (ISO 4217) =item DESCRIPTION -XTS, XXX +=item Default Handlers -=item CONVERSION ROUTINES +=over 4 -code2currency(), currency2code() +=item log -=item QUERY ROUTINES +=back -C, C +=back -=item EXAMPLES +=over 4 -=item KNOWN BUGS AND LIMITATIONS +=item carp -=item SEE ALSO +=back -Locale::Country, Locale::Script, ISO 4217:1995, -http://www.bsi-global.com/iso4217currency +=over 4 + +=item croak + +=back + +=over 4 + +=item cluck + +=back -=item AUTHOR +=over 4 -=item COPYRIGHT +=item confess =back -=head2 Locale::Language - ISO two letter codes for language identification -(ISO 639) - =over 4 -=item SYNOPSIS +=item die -=item DESCRIPTION +=back -=item CONVERSION ROUTINES +=over 4 -code2language(), language2code() +=item warn -=item QUERY ROUTINES +=back -C, C +=over 4 -=item EXAMPLES +=item trace -=item KNOWN BUGS AND LIMITATIONS +=back -=item SEE ALSO +=over 4 -Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F), -http://lcweb.loc.gov/standards/iso639-2/langhome.html +=item Custom Handlers + +=item SEE ALSO =item AUTHOR +=item Acknowledgements + =item COPYRIGHT =back -=head2 Locale::Maketext - framework for localization +=head2 Log::Message::Item - Message objects for Log::Message =over 4 @@ -22208,50 +24616,41 @@ http://lcweb.loc.gov/standards/iso639-2/langhome.html =item DESCRIPTION -=item QUICK OVERVIEW - -=item METHODS +=item Methods and Accessors =over 4 -=item Construction Methods - -=item The "maketext" Method - -$lh->fail_with I $lh->fail_with(I), $lh->failure_handler_auto - -=item Utility Methods +=item remove -$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 id -=item Language Handle Attributes and Internals +=item when -=back +=item message -=item LANGUAGE CLASS HIERARCHIES +=item level -=item ENTRIES IN EACH LEXICON +=item tag -=item BRACKET NOTATION +=item shortmess -=item AUTO LEXICONS +=item longmess -=item CONTROLLING LOOKUP FAILURE +=item parent -=item HOW TO USE MAKETEXT +=back =item SEE ALSO -=item COPYRIGHT AND DISCLAIMER - =item AUTHOR +=item Acknowledgements + +=item COPYRIGHT + =back -=head2 Locale::Maketext::TPJ13 -- article about software localization +=head2 Log::Message::Simple =over 4 @@ -22259,73 +24658,53 @@ $language->language_tag(), $language->encoding() =item DESCRIPTION -=item Localization and Perl: gettext breaks, Maketext fixes +=item FUNCTIONS =over 4 -=item A Localization Horror Story: It Could Happen To You - -=item The Linguistic View - -=item Breaking gettext - -=item Replacing gettext - -=item Buzzwords: Abstraction and Encapsulation - -=item Buzzword: Isomorphism - -=item Buzzword: Inheritance - -=item Buzzword: Concision - -=item The Devil in the Details +=item msg("message string" [,VERBOSE]) -=item The Proof in the Pudding: Localizing Web Sites +=item debug("message string" [,VERBOSE]) -=item References +=item error("error string" [,VERBOSE]) =back =back -=head2 Locale::Script - ISO codes for script identification (ISO 15924) - =over 4 -=item SYNOPSIS - -=item DESCRIPTION +=item carp(); -B, B, B +=item croak(); -=over 4 +=item confess(); -=item SPECIAL CODES +=item cluck(); =back -=item CONVERSION ROUTINES +=over 4 -code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ), -script_code2code( CODE, CODESET, CODESET ) +=item CLASS METHODS -=item QUERY ROUTINES +=over 4 -C, C +=item Log::Message::Simple->stack() -=item EXAMPLES +=item Log::Message::Simple->stack_as_string([TRACE]) -=item KNOWN BUGS AND LIMITATIONS +=item Log::Message::Simple->flush() -=item SEE ALSO +=back -Locale::Language, Locale::Currency, Locale::Country, ISO 15924, -http://www.evertype.com/standards/iso15924/ +=back -=item AUTHOR +=over 4 -=item COPYRIGHT +=item GLOBAL VARIABLES + +$ERROR_FH, $MSG_FH, $DEBUG_FH, $STACKTRACE_ON_ERROR =back @@ -22437,7 +24816,8 @@ ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround ( +$scale =item CAVEATS -stringify, bstr(), bdiv, Modifying and =, bpow, precision() vs. accuracy() +stringify, bstr(), bdiv, brsft, Modifying and =, bpow, precision() vs. +accuracy() =item SEE ALSO @@ -22461,114 +24841,136 @@ Input, Output =over 4 -=item config +=item config() -=item accuracy +=item accuracy() -=item precision +=item precision() -=item brsft +=item brsft() -=item new +=item new() + +=item from_oct() -=item bnan +=item from_hex() -=item bzero +=item from_bin() -=item binf +=item bnan() -=item bone +=item bzero() + +=item binf() + +=item bone() =item is_one()/is_zero()/is_nan()/is_inf() -=item is_pos()/is_neg() +=item is_pos()/is_neg()/is_positive()/is_negative() $x->is_pos(); # true if > 0 $x->is_neg(); # true if < 0 =item is_odd()/is_even()/is_int() -=item bcmp +=item bcmp() + +=item bacmp() + +=item sign() + +=item digit() + +=item bneg() + +=item babs() + +=item bnorm() -=item bacmp +=item bnot() -=item sign +=item binc() -=item digit +=item bdec() -=item bneg +=item badd() -=item babs +=item bsub() -=item bnorm +=item bmul() -=item bnot +=item bdiv() -=item binc +=item bmod() + +=item bmodinv() -=item bdec +=item bmodpow() -=item badd +=item bpow() + +=item blog() -=item bsub +=item bexp() -=item bmul +=item blsft() -=item bdiv +=item brsft() -=item bmod +=item band() -=item bmodinv +=item bior() -=item bmodpow +=item bxor() -=item bpow +=item bnot() -=item blsft +=item bsqrt() -=item brsft +=item bfac() -=item band +=item round() -=item bior +=item bround() -=item bxor +=item bfround() -=item bnot +=item bfloor() -=item bsqrt +=item bceil() -=item bfac +=item bgcd() -=item round +=item blcm() -=item bround +=item exponent() -=item bfround +=item mantissa() -=item bfloor +=item parts() -=item bceil +=item copy() -=item bgcd +=item as_int()/as_number() -=item blcm +=item bsstr() -=item exponent +=item as_hex() -=item mantissa +=item as_bin() -=item parts +=item as_oct() -=item copy +=item numify() -=item as_int +=item modify() -=item bsstr +=item upgrade()/downgrade() -=item as_hex +=item div_scale() -=item as_bin +=item round_mode() =back @@ -22584,8 +24986,8 @@ Input, Output =item Rounding mode R -'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy -(significant digits), Setting/Accessing, Creating numbers, Usage, +'trunc', 'even', 'odd', '+inf', '-inf', 'zero', 'common', Precision, +Accuracy (significant digits), Setting/Accessing, Creating numbers, Usage, Precedence, Overriding globals, Local settings, Rounding, Default values, Remarks @@ -22631,7 +25033,7 @@ oct()/hex(), log(-inf), exp(), cos(), sin(), atan2() =item Auto-upgrade -bsqrt(), div(), blog() +bsqrt(), div(), blog(), bexp() =back @@ -22765,12 +25167,24 @@ the same terms as Perl itself. =item parts() -=item as_int() +=item numify() + +=item as_int()/as_number() =item as_hex() =item as_bin() +=item as_oct() + +=item from_hex()/from_bin()/from_oct() + +=item length() + +=item digit() + +=item bnorm() + =item bfac() =item blog() @@ -22779,13 +25193,15 @@ the same terms as Perl itself. =item bmod() +=item bneg() + =item is_one() =item is_zero() -=item is_pos() +=item is_pos()/is_positive() -=item is_neg() +=item is_neg()/is_negative() =item is_int() @@ -22803,7 +25219,23 @@ the same terms as Perl itself. $x->bsqrt(); -=item config +=item broot() + + $x->broot($n); + +=item badd()/bmul()/bsub()/bdiv()/bdec()/binc() + +=item copy() + +=item bstr()/bsstr() + +=item bacmp()/bcmp() + +=item blsft()/brsft() + +=item bpow() + +=item config() =back @@ -23074,9 +25506,9 @@ Cookbook (L) 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 +manifest, manpages, pardist, ppd, ppmdist, prereq_report, pure_install, +realclean, retest, skipcheck, test, testall, testcover, testdb, testpod, +testpodcoverage, versioninstall =item OPTIONS @@ -23135,13 +25567,14 @@ new_from_context(%args), resume(), subclass() 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), +$version), compare_versions($v1, $op, $v2), config($key), config($key, +$value), config() [deprecated], 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 => @@ -23158,7 +25591,7 @@ $default) 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(), +build_script(), c_source(), 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(), @@ -23488,7 +25921,7 @@ new(), make_executable(), dispatch(), ACTION_realclean() =item Overridden Methods -new +_set_defaults =back @@ -23500,6 +25933,16 @@ manpage_separator prefixify +_quote_args + +have_forkpipe + +_backticks + +do_system + +_infer_xs_spec + =over 4 =item AUTHOR @@ -23539,51 +25982,162 @@ platforms =item DESCRIPTION -=item AUTHOR +=item AUTHOR + +=item SEE ALSO + +=back + +=head2 Module::Build::Platform::cygwin - Builder class for Cygwin platform + +=over 4 + +=item DESCRIPTION + +=item AUTHOR + +=item SEE ALSO + +=back + +=head2 Module::Build::Platform::darwin - Builder class for Mac OS X +platform + +=over 4 + +=item DESCRIPTION + +=item AUTHOR + +=item SEE ALSO + +=back + +=head2 Module::Build::Platform::os2 - Builder class for OS/2 platform + +=over 4 + +=item DESCRIPTION + +=item AUTHOR + +=item SEE ALSO + +=back + +=head2 Module::Build::YAML - Provides just enough YAML support so that +Module::Build works even if YAML.pm is not installed + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item AUTHOR + +=item COPYRIGHT + +=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 Module::Load - runtime require of both modules and files + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item Rules + +=item Caveats + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 Module::Load::Conditional - Looking up module information / loading +at runtime + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item Methods + +=item $href = check_install( module => NAME [, version => VERSION, verbose +=> BOOL ] ); -=item SEE ALSO +module, version, verbose, file, version, uptodate =back -=head2 Module::Build::Platform::cygwin - Builder class for Cygwin platform - =over 4 -=item DESCRIPTION +=item $bool = can_load( modules => { NAME => VERSION [,NAME => VERSION] }, +[verbose => BOOL, nocache => BOOL] ) -=item AUTHOR +modules, verbose, nocache -=item SEE ALSO +=back + +=over 4 + +=item @list = requires( MODULE ); =back -=head2 Module::Build::Platform::darwin - Builder class for Mac OS X -platform +=over 4 + +=item Global Variables =over 4 -=item DESCRIPTION +=item $Module::Load::Conditional::VERBOSE -=item AUTHOR +=item $Module::Load::Conditional::FIND_VERSION -=item SEE ALSO +=item $Module::Load::Conditional::CHECK_INC_HASH -=back +=item $Module::Load::Conditional::CACHE -=head2 Module::Build::Platform::os2 - Builder class for OS/2 platform +=item $Module::Load::Conditional::ERROR -=over 4 +=back -=item DESCRIPTION +=item See Also =item AUTHOR -=item SEE ALSO +=item COPYRIGHT =back -=head2 Module::Build::YAML - Provides just enough YAML support so that -Module::Build works even if YAML.pm is not installed +=head2 Module::Loaded - mark modules as loaded or unloaded =over 4 @@ -23591,85 +26145,113 @@ Module::Build works even if YAML.pm is not installed =item DESCRIPTION -=item AUTHOR +=item FUNCTIONS -=item COPYRIGHT +=over 4 + +=item $bool = mark_as_loaded( PACKAGE ); =back -=head2 Module::CoreList - what modules shipped with versions of perl +=back =over 4 -=item SYNOPSIS +=item $bool = mark_as_unloaded( PACKAGE ); -=item DESCRIPTION +=back -=item CAVEATS +=over 4 -=item HISTORY +=item $loc = is_loaded( PACKAGE ); + +=back + +=over 4 =item AUTHOR =item COPYRIGHT -=item SEE ALSO - =back -=head2 Module::Load - runtime require of both modules and files +=head2 Module::Pluggable - automatically give your module the ability to +have plugins =over 4 =item SYNOPSIS +=item EXAMPLE + =item DESCRIPTION -=item Rules +=item ADVANCED USAGE -=item Caveats +=item INNER PACKAGES -=item AUTHOR +=item OPTIONS -=item COPYRIGHT +=over 4 -=back +=item sub_name -=head2 Module::Loaded - mark modules as loaded or unloaded +=item search_path -=over 4 +=item search_dirs -=item SYNOPSIS +=item instantiate -=item DESCRIPTION +=item require -=item FUNCTIONS +=item inner -=over 4 +=item only -=item $bool = mark_as_loaded( PACKAGE ); +=item except -=back +=item package + +=item file_regex =back +=item METHODs + =over 4 -=item $bool = mark_as_unloaded( PACKAGE ); +=item search_path =back -=over 4 +=item FUTURE PLANS -=item $loc = is_loaded( PACKAGE ); +=item AUTHOR + +=item COPYING + +=item BUGS + +=item SEE ALSO =back +=head2 Module::Pluggable::Object - automatically give your module the +ability to have plugins + =over 4 +=item SYNOPSIS + +=item DESCRIPTION + =item AUTHOR -=item COPYRIGHT +=item COPYING + +=item BUGS + +=item SEE ALSO =back @@ -24249,6 +26831,126 @@ C, C, C =back +=head2 Object::Accessor + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS + +=over 4 + +=item $object = Object::Accessor->new( [ARGS] ); + +=back + +=back + +=over 4 + +=item $bool = $object->mk_accessors( @ACCESSORS | \%ACCESSOR_MAP ); + +=back + +=over 4 + +=item @list = $self->ls_accessors; + +=back + +=over 4 + +=item $ref = $self->ls_allow(KEY) + +=back + +=over 4 + +=item $clone = $self->mk_clone; + +=back + +=over 4 + +=item $bool = $self->mk_flush; + +=back + +=over 4 + +=item $bool = $self->mk_verify; + +=back + +=over 4 + +=item $bool = $self->register_callback( sub { ... } ); + +=back + +=over 4 + +=item $bool = $self->can( METHOD_NAME ) + +=back + +=over 4 + +=item $val = $self->___get( METHOD_NAME ); + +=back + +=over 4 + +=item $bool = $self->___set( METHOD_NAME => VALUE ); + +=back + +=over 4 + +=item LVALUE ACCESSORS + +=over 4 + +=item CAVEATS + +Allow handlers, Callbacks + +=back + +=back + +=over 4 + +=item GLOBAL VARIABLES + +=over 4 + +=item $Object::Accessor::FATAL + +=item $Object::Accessor::DEBUG + +=back + +=item TODO + +=over 4 + +=item Create read-only accessors + +=back + +=item CAVEATS + +=item AUTHOR + +=item COPYRIGHT + +=back + =head2 Opcode - Disable named opcodes when compiling perl code =over 4 @@ -24513,6 +27215,80 @@ WTERMSIG, WIFSTOPPED, WSTOPSIG =back +=head2 Params::Check - A generic input parsing/checking mechanism. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item Template + +default, required, strict_type, defined, no_override, store, allow + +=item Functions + +=over 4 + +=item check( \%tmpl, \%args, [$verbose] ); + +Template, Arguments, Verbose + +=back + +=back + +=over 4 + +=item allow( $test_me, \@criteria ); + +string, regexp, subroutine, array ref + +=back + +=over 4 + +=item last_error() + +=back + +=over 4 + +=item Global Variables + +=over 4 + +=item $Params::Check::VERBOSE + +=item $Params::Check::STRICT_TYPE + +=item $Params::Check::ALLOW_UNKNOWN + +=item $Params::Check::STRIP_LEADING_DASHES + +=item $Params::Check::NO_DUPLICATES + +=item $Params::Check::PRESERVE_CASE + +=item $Params::Check::ONLY_ALLOW_DEFINED + +=item $Params::Check::SANITY_CHECK_TEMPLATE + +=item $Params::Check::WARNINGS_FATAL + +=item $Params::Check::CALLER_DEPTH + +=back + +=item AUTHOR + +=item Acknowledgements + +=item COPYRIGHT + +=back + =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::* name space @@ -25536,6 +28312,8 @@ I|I =item TREE-BASED PARSING +=item CAVEATS + =item SEE ALSO =item AUTHOR @@ -26457,7 +29235,7 @@ C<-input>, C<-pathlist>, C<-noperldoc> =item AUTHOR -=item ACKNOWLEDGEMENTS +=item ACKNOWLEDGMENTS =back @@ -26530,6 +29308,8 @@ set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF =item KNOWN BUGS +=item SEE ALSO + =item COPYRIGHT =item BLATANT PLUG @@ -26775,8 +29555,8 @@ $buffer ), $info = Storable::read_magic( $buffer, $must_be_file ) B, B, B, B, B, B, -B (added in 5.004_02), -B +B (added in Perl 5.004_02), +B, B =item EXAMPLES @@ -26834,8 +29614,8 @@ calls B, B, B, B, B, B, -B (added in 5.004_02), -B +B (added in Perl 5.004_02), +B, B =item EXAMPLES @@ -26987,6 +29767,121 @@ C, C, C =back +=head2 Term::UI - Term::ReadLine UI made easy + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item HOW IT WORKS + +=item METHODS + +=over 4 + +=item $reply = $term->get_reply( prompt => 'question?', [choices => \@list, +default => $list[0], multi => BOOL, print_me => "extra text to print & +record", allow => $ref] ); + +=back + +=back + +=over 4 + +=item $bool = $term->ask_yn( prompt => "your question", [default => +(y|1,n|0), print_me => "extra text to print & record"] ) + +=back + +=over 4 + +=item ($opts, $munged) = $term->parse_options( STRING ); + +=back + +=over 4 + +=item $str = $term->history_as_string + +=back + +=over 4 + +=item GLOBAL VARIABLES + +=over 4 + +=item $Term::UI::VERBOSE + +=item $Term::UI::AUTOREPLY + +=item $Term::UI::INVALID + +=item $Term::UI::History::HISTORY_FH + +=back + +=item EXAMPLES + +=over 4 + +=item Basic get_reply sample + +=item get_reply with choices + +=item get_reply with choices and default + +=item get_reply using print_me & multi + +=item get_reply & allow + +=item an elaborate ask_yn sample + +=back + +=item See Also + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 Term::UI::History, Log::Message::Simple + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item FUNCTIONS + +=over 4 + +=item history("message string" [,VERBOSE]) + +=back + +=back + +=over 4 + +=item GLOBAL VARIABLES + +$HISTORY_FH + +=item See Also + +=item AUTHOR + +=item COPYRIGHT + +=back + =head2 Test - provides a simple framework for writing test scripts =over 4 @@ -27088,12 +29983,16 @@ B, B B, B -B - B +=over 4 + +=item Other Testing Methods + B +=back + B B @@ -27102,6 +30001,18 @@ B =over 4 +=item Test building utility methods + +B + +=back + +B<_try> + +B + +=over 4 + =item Test style B @@ -27126,6 +30037,8 @@ B<_print_diag> B, B, B +carp, croak + =over 4 =item Test Status and Info @@ -27312,7 +30225,8 @@ C, C C, C, C, C, C, C, -C, C, C +C, C, C, +C =item EXAMPLE @@ -27409,6 +30323,31 @@ ok, number =back +=head2 Test::Harness::Results - object for tracking results from a single +test file + +=over 4 + +=item SYNOPSIS + +=item CONSTRUCTION + +=over 4 + +=item new() + +=back + +=back + +=over 4 + +=item ACCESSORS + +wait, exit + +=back + =head2 Test::Harness::Straps - detailed analysis of test results =over 4 @@ -27453,8 +30392,6 @@ ok, number =over 4 -=item Results - =item EXAMPLES =item AUTHOR @@ -27900,7 +30837,9 @@ by Knuth =item LIMITATIONS -=item AUTHOR +=item MAINTAINER + +=item HISTORY =back @@ -27915,8 +30854,6 @@ unexpand(1) =item EXAMPLE -=item BUGS - =item LICENSE =back @@ -28148,6 +31085,18 @@ this, SCALAR this =back +=head2 Tie::Hash::NamedCapture - Named regexp capture buffers + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=back + =head2 Tie::Memoize - add data to hash when needed =over 4 @@ -28231,8 +31180,8 @@ $useconds [, $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ), alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer ( $which, $floating_seconds [, $interval_floating_seconds ] ), getitimer ( $which ), clock_gettime ( -$which ), clock_getres ( $which ), clock_nanosleep ( $which, $seconds, -$flags = 0), clock() +$which ), clock_getres ( $which ), clock_nanosleep ( $which, $nanoseconds, +$flags = 0), clock(), stat, stat FH, stat EXPR =item EXAMPLES @@ -28242,6 +31191,8 @@ $flags = 0), clock() =over 4 +=item useconds or interval more than ... + =item negative time not invented yet =item internal error: useconds < 0 (unsigned ... signed ...) @@ -28292,6 +31243,81 @@ $flags = 0), clock() =back +=head2 Time::Piece - Object Oriented time objects + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item USAGE + +=over 4 + +=item Local Locales + +=item Date Calculations + +=item Date Comparisons + +=item Date Parsing + +=item YYYY-MM-DDThh:mm:ss + +=item Week Number + +=item Global Overriding + +=back + +=item AUTHOR + +=item License + +=item SEE ALSO + +=item BUGS + +=back + +=head2 Time::Piece::Seconds, Time::Seconds - a simple API to convert +seconds to other date values + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS + +=item AUTHOR + +=item LICENSE + +=item Bugs + +=back + +=head2 Time::Seconds - a simple API to convert seconds to other date values + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS + +=item AUTHOR + +=item LICENSE + +=item Bugs + +=back + =head2 Time::gmtime - by-name interface to Perl's built-in gmtime() function @@ -28616,6 +31642,183 @@ March 18th, 2000 =back +=head2 Win32 - Interfaces to some Win32 API Functions + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Alphabetical Listing of Win32 Functions + +Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(), +Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(), +Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE), +Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(), +Win32::GetChipName(), Win32::GetCwd(), Win32::GetFileVersion(FILENAME), +Win32::GetFolderPath(FOLDER [, CREATE]), Win32::GetFullPathName(FILENAME), +Win32::GetLastError(), Win32::GetLongPathName(PATHNAME), +Win32::GetNextAvailDrive(), Win32::GetOSVersion(), Win32::GetOSName(), +Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE, +PROCNAME), Win32::GetTickCount(), Win32::GuidGen(), Win32::IsAdminUser(), +Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME), +Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID, +SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE), +Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(), +Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW), +Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR), +Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID), +Win32::UnregisterServer(LIBRARYNAME) + +=back + +=back + +=head2 Win32API::File - Low-level access to Win32 system API calls for +files/dirs. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Object Oriented/Tied Handle Interface + +=item Exports + +C<":Func">, attrLetsToBits, C<$uBits= attrLetsToBits( $sAttributeLetters +)>, C<"a">, C<"c">, C<"h">, C<"o">, C<"r">, C<"s">, C<"t">, createFile, +C<$hObject= createFile( $sPath )>, C<$hObject= createFile( $sPath, +$rvhvOptions )>, C<$hObject= createFile( $sPath, $svAccess )>, C<$hObject= +createFile( $sPath, $svAccess, $rvhvOptions )>, C<$hObject= createFile( +$sPath, $svAccess, $svShare )>, C<$hObject= createFile( $sPath, $svAccess, +$svShare, $rvhvOptions )>, C<"q">, C<"r">, C<"w">, C<"k">, C<"t">, C<"n">, +C<"c">, C<"e">, C<"kc">, C<"ke">, C<"tc">, C<"te">, C<"nc">, C<"ne">, Flags +=> $uFlags, Attributes => $sAttributes, Security => $pSecurityAttributes, +Model => $hModelFile, Access => $sAccess, Access => $uAccess, Create => +$sCreate, Create => $uCreate, Share => $sShare, Share => $uShare, +getLogicalDrives, C<@roots= getLogicalDrives()>, CloseHandle, +C, CopyFile, C, CreateFile, C<$hObject= CreateFile( +$sPath, $uAccess, $uShare, $pSecAttr, $uCreate, $uFlags, $hModel )>, +C<"//./PhysicalDrive0">, C<"//./C:">, C<"//./A:">, C<"//./PIPE/PipeName">, +DefineDosDevice, C, C, C, +C, DeleteFile, C, +DeviceIoControl, C, FdGetOsFHandle, +C<$hNativeHandle= FdGetOsFHandle( $ivFd )>, fileConstant, C<$value= +fileConstant( $sConstantName )>, fileLastError, C<$svError= +fileLastError();>, C, GetDriveType, +C<$uDriveType= GetDriveType( $sRootPath )>, C, +C, C, C, C, +C, C, GetFileAttributes, C<$uAttrs = +GetFileAttributes( $sPath )>, C, +C, C, +C, C, +C, C, +C, C, +C, C, +C, C, +C, GetFileType, C<$uFileType= GetFileType( $hFile +)>, C, C, C, +C, getFileSize, C<$size= getFileSize( $hFile )>, +GetFileSize, C<$iSizeLow= GetFileSize($win32Handle, $iSizeHigh)>, +GetOverlappedResult, C<$bRetval= GetOverlappedResult( $win32Handle, +$pOverlapped, $numBytesTransferred, $bWait )>, GetLogicalDrives, +C<$uDriveBits= GetLogicalDrives()>, GetLogicalDriveStrings, C<$olOutLength= +GetLogicalDriveStrings( $lBufSize, $osBuffer )>, GetHandleInformation, +C, GetOsFHandle, +C<$hNativeHandle= GetOsFHandle( FILE )>, GetVolumeInformation, +C, C, +C, C, C, +C, C, IsRecognizedPartition, +C, IsContainerPartition, +C, MoveFile, C, MoveFileEx, C, C, C, +C, C, OsFHandleOpen, +C, OsFHandleOpenFd, C<$ivFD= +OsFHandleOpenFd( $hNativeHandle, $uMode )>, QueryDosDevice, C<$olTargetLen= +QueryDosDevice( $sDosDeviceName, $osTargetPath, $lTargetBuf )>, ReadFile, +C, +SetErrorMode, C<$uOldMode= SetErrorMode( $uNewMode )>, +C, C, +C, C, setFilePointer, +C<$uNewPos = setFilePointer( $hFile, $ivOffset, $uFromWhere )>, +SetFilePointer, C<$uNewPos = SetFilePointer( $hFile, $ivOffset, +$ioivOffsetHigh, $uFromWhere )>, SetHandleInformation, +C, WriteFile, +C, +C<":FuncA">, C<":FuncW">, CopyFileW, C, CreateFileW, C<$hObject= CreateFileW( +$swPath, $uAccess, $uShare, $pSecAttr, $uCreate, $uFlags, $hModel )>, +DefineDosDeviceW, C, DeleteFileW, C, +GetDriveTypeW, C<$uDriveType= GetDriveTypeW( $swRootPath )>, +GetFileAttributesW, C<$uAttrs= GetFileAttributesW( $swPath )>, +GetLogicalDriveStringsW, C<$olwOutLength= GetLogicalDriveStringsW( +$lwBufSize, $oswBuffer )>, GetVolumeInformationW, C, MoveFileW, C, MoveFileExW, C, QueryDosDeviceW, C<$olwTargetLen= QueryDosDeviceW( $swDeviceName, +$oswTargetPath, $lwTargetBuf )>, C<":Misc">, C<":DDD_">, C<":DRIVE_">, +C<":FILE_">, C<":FILE_ATTRIBUTE_">, C<":FILE_FLAG_">, C<":FILE_SHARE_">, +C<":FILE_TYPE_">, C<":FS_">, C<":HANDLE_FLAG_">, HANDLE_FLAG_INHERIT, +HANDLE_FLAG_PROTECT_FROM_CLOSE, C<":IOCTL_STORAGE_">, +C, C, +C, C, +C, C, +C, C, +C<$ucCylsLow[$i]>, C<$ivcCylsHigh[$i]>, C<$uMediaType[$i]>, +C<$uTracksPerCyl[$i]>, C<$uSectsPerTrack[$i]>, C<$uBytesPerSect[$i]>, +C<":IOCTL_DISK_">, C, C<$ucCylsLow>, +C<$ivcCylsHigh>, C<$uMediaType>, C<$uTracksPerCyl>, C<$uSectsPerTrack>, +C<$uBytesPerSect>, C, C<$uStartLow> and +C<$ivStartHigh>, C<$ucHiddenSects>, C<$uPartitionSeqNumber>, +C<$uPartitionType>, C<$bActive>, C<$bRecognized>, C<$bToRewrite>, +C, C, +C<$cPartitions>, C<$uDiskSignature>, C, +C, C, C<$uStartOffsetLow> +and C<$ivStartOffsetHigh>, C<$uLength>, C, +C, C, +C, C, DISK_LOGGING_START, +DISK_LOGGING_STOP, DISK_LOGGING_DUMP, DISK_LOGGING_BINNING, +C, C, +C, C, +C, C, C<":FSCTL_">, +C, C, +C, C<":GENERIC_">, C<":MEDIA_TYPE">, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C<":MOVEFILE_">, C<":SECURITY_">, +C<":SEM_">, C<":PARTITION_">, C<":ALL"> + +=back + +=item BUGS + +=item AUTHOR + +=item SEE ALSO + +=back + +=over 4 + +=item DESCRIPTION + +=item HISTORY + +=back + =head2 XSLoader - Dynamically load C libraries into Perl code =over 4 @@ -28644,9 +31847,9 @@ March 18th, 2000 =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) +C, C, +C, +C =item LIMITATIONS diff --git a/vms/descrip_mms.template b/vms/descrip_mms.template index f1a6caf..d5741a3 100644 --- a/vms/descrip_mms.template +++ b/vms/descrip_mms.template @@ -391,10 +391,10 @@ pod0 = [.lib.pods]perl.pod [.lib.pods]perl5004delta.pod [.lib.pods]perl5005delta pod1 = [.lib.pods]perl570delta.pod [.lib.pods]perl571delta.pod [.lib.pods]perl572delta.pod [.lib.pods]perl573delta.pod [.lib.pods]perl581delta.pod pod2 = [.lib.pods]perl582delta.pod [.lib.pods]perl583delta.pod [.lib.pods]perl584delta.pod [.lib.pods]perl585delta.pod [.lib.pods]perl586delta.pod pod3 = [.lib.pods]perl587delta.pod [.lib.pods]perl588delta.pod [.lib.pods]perl58delta.pod [.lib.pods]perl590delta.pod [.lib.pods]perl591delta.pod -pod4 = [.lib.pods]perl592delta.pod [.lib.pods]perl593delta.pod [.lib.pods]perl594delta.pod [.lib.pods]perl595delta.pod [.lib.pods]perlaix.pod [.lib.pods]perlamiga.pod -pod5 = [.lib.pods]perlapi.pod [.lib.pods]perlapio.pod [.lib.pods]perlapollo.pod [.lib.pods]perlartistic.pod [.lib.pods]perlbeos.pod [.lib.pods]perlbook.pod -pod6 = [.lib.pods]perlboot.pod [.lib.pods]perlbot.pod [.lib.pods]perlbs2000.pod [.lib.pods]perlcall.pod [.lib.pods]perlce.pod [.lib.pods]perlcheat.pod -pod7 = [.lib.pods]perlclib.pod [.lib.pods]perlcn.pod [.lib.pods]perlcompile.pod [.lib.pods]perlcygwin.pod [.lib.pods]perldata.pod +pod4 = [.lib.pods]perl592delta.pod [.lib.pods]perl593delta.pod [.lib.pods]perl594delta.pod [.lib.pods]perl595delta.pod [.lib.pods]perlaix.pod +pod5 = [.lib.pods]perlamiga.pod [.lib.pods]perlapi.pod [.lib.pods]perlapio.pod [.lib.pods]perlapollo.pod [.lib.pods]perlartistic.pod [.lib.pods]perlbeos.pod +pod6 = [.lib.pods]perlbook.pod [.lib.pods]perlboot.pod [.lib.pods]perlbot.pod [.lib.pods]perlbs2000.pod [.lib.pods]perlcall.pod [.lib.pods]perlce.pod +pod7 = [.lib.pods]perlcheat.pod [.lib.pods]perlclib.pod [.lib.pods]perlcn.pod [.lib.pods]perlcompile.pod [.lib.pods]perlcygwin.pod [.lib.pods]perldata.pod pod8 = [.lib.pods]perldbmfilter.pod [.lib.pods]perldebguts.pod [.lib.pods]perldebtut.pod [.lib.pods]perldebug.pod [.lib.pods]perldelta.pod pod9 = [.lib.pods]perldgux.pod [.lib.pods]perldiag.pod [.lib.pods]perldoc.pod [.lib.pods]perldos.pod [.lib.pods]perldsc.pod [.lib.pods]perlebcdic.pod pod10 = [.lib.pods]perlembed.pod [.lib.pods]perlepoc.pod [.lib.pods]perlfaq.pod [.lib.pods]perlfaq1.pod [.lib.pods]perlfaq2.pod [.lib.pods]perlfaq3.pod @@ -412,9 +412,9 @@ pod21 = [.lib.pods]perlpragma.pod [.lib.pods]perlqnx.pod [.lib.pods]perlre.pod [ pod22 = [.lib.pods]perlrequick.pod [.lib.pods]perlreref.pod [.lib.pods]perlretut.pod [.lib.pods]perlriscos.pod [.lib.pods]perlrun.pod [.lib.pods]perlsec.pod pod23 = [.lib.pods]perlsolaris.pod [.lib.pods]perlstyle.pod [.lib.pods]perlsub.pod [.lib.pods]perlsymbian.pod [.lib.pods]perlsyn.pod pod24 = [.lib.pods]perlthrtut.pod [.lib.pods]perltie.pod [.lib.pods]perltoc.pod [.lib.pods]perltodo.pod [.lib.pods]perltooc.pod [.lib.pods]perltoot.pod -pod25 = [.lib.pods]perltrap.pod [.lib.pods]perltru64.pod [.lib.pods]perltw.pod [.lib.pods]perlunicode.pod [.lib.pods]perlunifaq.pod [.lib.pods]perluniintro.pod -pod26 = [.lib.pods]perlunitut.pod [.lib.pods]perlutil.pod [.lib.pods]perluts.pod [.lib.pods]perlvar.pod [.lib.pods]perlvmesa.pod [.lib.pods]perlvms.pod -pod27 = [.lib.pods]perlvos.pod [.lib.pods]perlwin32.pod [.lib.pods]perlxs.pod [.lib.pods]perlxstut.pod +pod25 = [.lib.pods]perltrap.pod [.lib.pods]perltru64.pod [.lib.pods]perltw.pod [.lib.pods]perlunicode.pod [.lib.pods]perlunifaq.pod +pod26 = [.lib.pods]perluniintro.pod [.lib.pods]perlunitut.pod [.lib.pods]perlutil.pod [.lib.pods]perluts.pod [.lib.pods]perlvar.pod [.lib.pods]perlvmesa.pod +pod27 = [.lib.pods]perlvms.pod [.lib.pods]perlvos.pod [.lib.pods]perlwin32.pod [.lib.pods]perlxs.pod [.lib.pods]perlxstut.pod pod = $(pod0) $(pod1) $(pod2) $(pod3) $(pod4) $(pod5) $(pod6) $(pod7) $(pod8) $(pod9) $(pod10) $(pod11) $(pod12) $(pod13) $(pod14) $(pod15) $(pod16) $(pod17) $(pod18) $(pod19) $(pod20) $(pod21) $(pod22) $(pod23) $(pod24) $(pod25) $(pod26) $(pod27) # Would be useful to automate the generation of this rule from pod/buildtoc