From: Nicholas Clark Date: Fri, 19 May 2006 20:11:57 +0000 (+0000) Subject: Rebuild perltoc.pod. X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=af2c4e9c219c73ed9ba213a7098e36ef44468d02;p=p5sagit%2Fp5-mst-13.2.git Rebuild perltoc.pod. p4raw-id: //depot/perl@28242 --- diff --git a/pod/perltoc.pod b/pod/perltoc.pod index 53c343d..d183bfb 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -806,7 +806,7 @@ LIMIT specified =back -=head2 perlfaq - frequently asked questions about Perl +=head2 perlfaq - frequently asked questions about Perl ($Revision: 3606 $) =over 4 @@ -861,8 +861,7 @@ Interaction, perlfaq9 - Networking =back -=head2 perlfaq1 - General Questions About Perl ($Revision: 1.19 $, $Date: -2005/12/31 00:54:37 $) +=head2 perlfaq1 - General Questions About Perl ($Revision: 3606 $) =over 4 @@ -901,17 +900,20 @@ Scheme, or Tcl? =item Where can I get a list of Larry Wall witticisms? -=item How can I convince my sysadmin/supervisor/employees to use version -5/5.6.1/Perl instead of some other language? +=item How can I convince others to use Perl? + +http://perltraining.com.au/whyperl.html, +http://www.perl.org/advocacy/whyperl.html =back +=item REVISION + =item AUTHOR AND COPYRIGHT =back -=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.39 $, -$Date: 2006/01/08 14:27:07 $) +=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 3606 $) =over 4 @@ -960,12 +962,13 @@ References, Tutorials, Task-Oriented, Special Topics =back +=item REVISION + =item AUTHOR AND COPYRIGHT =back -=head2 perlfaq3 - Programming Tools ($Revision: 1.56 $, $Date: 2005/12/31 -00:54:37 $) +=head2 perlfaq3 - Programming Tools ($Revision: 3606 $) =over 4 @@ -1046,12 +1049,13 @@ program; what am I doing wrong? =back +=item REVISION + =item AUTHOR AND COPYRIGHT =back -=head2 perlfaq4 - Data Manipulation ($Revision: 1.73 $, $Date: 2005/12/31 -00:54:37 $) +=head2 perlfaq4 - Data Manipulation ($Revision: 3606 $) =over 4 @@ -1263,12 +1267,13 @@ array of hashes or arrays? =back +=item REVISION + =item AUTHOR AND COPYRIGHT =back -=head2 perlfaq5 - Files and Formats ($Revision: 1.42 $, $Date: 2005/12/31 -00:54:37 $) +=head2 perlfaq5 - Files and Formats ($Revision: 3606 $) =over 4 @@ -1299,7 +1304,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? @@ -1396,12 +1401,13 @@ X =back +=item REVISION + =item AUTHOR AND COPYRIGHT =back -=head2 perlfaq6 - Regular Expressions ($Revision: 1.38 $, $Date: 2005/12/31 -00:54:37 $) +=head2 perlfaq6 - Regular Expressions ($Revision: 3606 $) =over 4 @@ -1489,12 +1495,13 @@ X =back +=item REVISION + =item AUTHOR AND COPYRIGHT =back -=head2 perlfaq7 - General Perl Language Issues ($Revision: 1.28 $, $Date: -2005/12/31 00:54:37 $) +=head2 perlfaq7 - General Perl Language Issues ($Revision: 3606 $) =over 4 @@ -1571,12 +1578,13 @@ methods? =back +=item REVISION + =item AUTHOR AND COPYRIGHT =back -=head2 perlfaq8 - System Interaction ($Revision: 1.27 $, $Date: 2005/12/31 -00:54:37 $) +=head2 perlfaq8 - System Interaction ($Revision: 3606 $) =over 4 @@ -1701,12 +1709,13 @@ search path? =back +=item REVISION + =item AUTHOR AND COPYRIGHT =back -=head2 perlfaq9 - Networking ($Revision: 1.28 $, $Date: 2005/12/31 00:54:37 -$) +=head2 perlfaq9 - Networking ($Revision: 3606 $) =over 4 @@ -1773,6 +1782,8 @@ gethostbyname, Socket, Net::Domain, Sys::Hostname> =back +=item REVISION + =item AUTHOR AND COPYRIGHT =back @@ -2764,9 +2775,10 @@ $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O, ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80, 0x100, 0x200, 0x400, $LAST_REGEXP_CODE_RESULT, $^R, $EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, ${^TAINT}, ${^UNICODE}, -${^UTF8LOCALE}, $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS}, -$EXECUTABLE_NAME, $^X, ARGV, $ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC, -%ENV, $ENV{expr}, %SIG, $SIG{expr} +${^UTF8CACHE}, ${^UTF8LOCALE}, $PERL_VERSION, $^V, $WARNING, $^W, +${^WARNING_BITS}, ${^WIN32_SLOPPY_STAT}, $EXECUTABLE_NAME, $^X, ARGV, +$ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, +$SIG{expr} =item Error Indicators @@ -4331,38 +4343,61 @@ tarball, Announce to the modules list, Announce to clpa, Fix bugs! =back +=head2 perlpragma - how to write a user pragma + +=over 4 + +=item DESCRIPTION + +=item A basic example + +=item Implementation details + +=back + =head2 perlutil - utilities packaged with the Perl distribution =over 4 =item DESCRIPTION +=item LIST OF UTILITIES + =over 4 -=item DOCUMENTATION +=item Documentation L, L and L, L and L, L, L, L, L, L -=item CONVERTORS +=item Convertors -L, L, L +L, L and L, L =item Administration -L +L, L, L =item Development L, L, L and L, -L, L, L +L, L, L, L, L, +L, L -=item SEE ALSO +=item General tools + +L, L, L, L + +=item Installation + +L, L =back +=item SEE ALSO + =back =head2 perlcompile - Introduction to the Perl Compiler-Translator @@ -5277,19 +5312,19 @@ perl_parse X, perl_run X, require_pv X =item Functions in file mathoms.c -gv_fetchmethod X, sv_2pvbyte_nolen X, -sv_2pvutf8_nolen X, sv_2pv_nolen X, -sv_catpvn_mg X, sv_catsv_mg X, sv_force_normal -X, sv_iv X, sv_nolocking X, -sv_nounlocking X, sv_nv X, sv_pv X, sv_pvbyte -X, sv_pvbyten X, sv_pvn X, sv_pvutf8 -X, sv_pvutf8n X, sv_taint X, sv_unref -X, sv_uv X +gv_fetchmethod X, pack_cat X, sv_2pvbyte_nolen +X, sv_2pvutf8_nolen X, sv_2pv_nolen +X, sv_catpvn_mg X, sv_catsv_mg X, +sv_force_normal X, sv_iv X, sv_nolocking +X, sv_nounlocking X, sv_nv X, sv_pv +X, sv_pvbyte X, sv_pvbyten X, sv_pvn +X, sv_pvutf8 X, sv_pvutf8n X, sv_taint +X, sv_unref X, sv_usepvn X, sv_usepvn_mg +X, sv_uv X, unpack_str X =item Functions in file pp_pack.c -packlist X, pack_cat X, unpackstring X, -unpack_str X +packlist X, unpackstring X =item Global Variables @@ -5337,20 +5372,22 @@ X =item Memory Management Copy X, CopyD X, Move X, MoveD X, Newx X, -Newxc X, Newxz X, Poison X, Renew X, Renewc -X, Safefree X, savepv X, savepvn X, -savesharedpv X, savesvpv X, StructCopy -X, Zero X, ZeroD X +Newxc X, Newxz X, Poison X, PoisonNew X, +PoisonWith X, Renew X, Renewc X, Safefree +X, savepv X, savepvn X, savesharedpv +X, savesvpv X, StructCopy X, Zero +X, ZeroD X =item Miscellaneous Functions fbm_compile X, fbm_instr X, form X
, getcwd_sv -X, my_sprintf X, new_version X, -scan_version X, strEQ X, strGE X, strGT -X, strLE X, strLT X, strNE X, strnEQ X, -strnNE X, sv_nosharing X, upg_version X, -vcmp X, vnormal X, vnumify X, vstringify -X, vverify X +X, my_snprintf X, my_sprintf X, +my_vsnprintf X, new_version X, scan_version +X, strEQ X, strGE X, strGT X, strLE +X, strLT X, strNE X, strnEQ X, strnNE +X, sv_nosharing X, upg_version X, vcmp +X, vnormal X, vnumify X, vstringify X, +vverify X =item Multicall Functions @@ -5403,15 +5440,11 @@ X =item SV Manipulation Functions -get_sv X, looks_like_number X, newRV_inc -X, newRV_noinc X, newSV X, newSVhek -X, newSViv X, newSVnv X, newSVpv X, -newSVpvf X, newSVpvn X, newSVpvn_share -X, newSVrv X, newSVsv X, newSVuv -X, SvCUR X, SvCUR_set X, SvEND X, SvGROW -X, SvIOK X, SvIOKp X, SvIOK_notUV X, -SvIOK_off X, SvIOK_on X, SvIOK_only X, -SvIOK_only_UV X, SvIOK_UV X, SvIsCOW X, +get_sv X, newRV_inc X, SvCUR X, SvCUR_set +X, SvEND X, SvGAMAGIC X, SvGROW X, +SvIOK X, SvIOKp X, SvIOK_notUV X, SvIOK_off +X, SvIOK_on X, SvIOK_only X, SvIOK_only_UV +X, SvIOK_UV X, SvIsCOW X, SvIsCOW_shared_hash X, SvIV X, SvIVX X, SvIVx X, SvIV_nomg X, SvIV_set X, SvLEN X, SvLEN_set X, SvMAGIC_set X, SvNIOK @@ -5429,34 +5462,46 @@ X, SvPVX X, SvPVx X, SvPV_force X, SvPV_force_nomg X, SvPV_nolen X, SvPV_nomg X, SvPV_set X, SvREFCNT X, SvREFCNT_dec X, SvREFCNT_inc X, -SvROK X, SvROK_off X, SvROK_on X, SvRV X, +SvREFCNT_inc_NN X, SvREFCNT_inc_simple +X, SvREFCNT_inc_simple_NN X, +SvREFCNT_inc_simple_void X, SvREFCNT_inc_void +X, SvREFCNT_inc_void_NN X, SvROK +X, SvROK_off X, SvROK_on X, SvRV X, SvRV_set X, SvSTASH X, SvSTASH_set X, SvTAINT X, SvTAINTED X, SvTAINTED_off X, SvTAINTED_on X, SvTRUE X, SvTYPE X, SvUOK X, SvUPGRADE X, SvUTF8 X, SvUTF8_off X, SvUTF8_on X, SvUV X, SvUVX X, SvUVx X, SvUV_nomg X, SvUV_set X, SvVOK 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_catpvn_nomg X, sv_catpv_mg -X, sv_catsv X, sv_catsv_flags X, -sv_catsv_nomg X, sv_chop X, sv_clear X, +sv_catpvn_nomg X, sv_catsv_nomg X, +sv_derived_from X, sv_report_used X, +sv_setsv_nomg X + +=item SV-Body Allocation + +looks_like_number X, newRV_noinc X, newSV +X, newSVhek X, newSViv X, newSVnv X, +newSVpv X, newSVpvf X, newSVpvn X, +newSVpvn_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_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_derived_from -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_report_used X, +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 @@ -5465,16 +5510,15 @@ sv_setpvn X, sv_setpvn_mg X, sv_setpv_mg X, sv_setref_iv X, sv_setref_nv X, sv_setref_pv X, sv_setref_pvn X, sv_setref_uv X, sv_setsv X, sv_setsv_flags X, -sv_setsv_mg X, sv_setsv_nomg X, sv_setuv -X, sv_setuv_mg X, sv_tainted X, sv_true -X, sv_unmagic X, sv_unref_flags X, -sv_untaint X, sv_upgrade X, sv_usepvn X, -sv_usepvn_mg X, sv_utf8_decode X, -sv_utf8_downgrade X, sv_utf8_encode X, -sv_utf8_upgrade X, sv_utf8_upgrade_flags -X, sv_vcatpvf X, sv_vcatpvfn -X, sv_vcatpvf_mg X, sv_vsetpvf X, -sv_vsetpvfn X, sv_vsetpvf_mg X +sv_setsv_mg X, sv_setuv X, sv_setuv_mg +X, sv_tainted X, sv_true X, sv_unmagic +X, sv_unref_flags X, sv_untaint X, +sv_upgrade X, sv_usepvn_flags X, +sv_utf8_decode X, sv_utf8_downgrade X, +sv_utf8_encode X, sv_utf8_upgrade X, +sv_utf8_upgrade_flags X, sv_vcatpvf X, +sv_vcatpvfn X, sv_vcatpvf_mg X, sv_vsetpvf +X, sv_vsetpvfn X, sv_vsetpvf_mg X =item Unicode Support @@ -5550,13 +5594,18 @@ X, PL_rs X is_gv_magical X, is_gv_magical_sv X +=item Hash Manipulation Functions + +refcounted_he_chain_2hv X, refcounted_he_free +X, refcounted_he_new X + =item IO Functions start_glob X =item Magical Functions -mg_localize X +magic_sethint X, mg_localize X =item Pad Data Structures @@ -5888,14 +5937,14 @@ Implement L, Implement L =item POSIX memory footprint +=item embed.pl/makedef.pl + =back =item Tasks that need a little sysadmin-type knowledge =over 4 -=item Relocatable perl - =item make HTML install work =item compressed man pages @@ -5904,8 +5953,6 @@ Implement L, Implement L =item Make Config.pm cope with differences between build and installed perl -=item make parallel builds work - =item linker specification files =back @@ -5916,17 +5963,15 @@ Implement L, Implement L =item Make it clear from -v if this is the exact official release -=item Tidy up global variables - =item Ordering of "global" variables. -=item bincompat functions +=item Profile Perl - am I hot or not? -=item am I hot or not? +=item Shrink struct context -=item emulate the per-thread memory pool on Unix +=item Allocate OPs from arenas -=item reduce duplication in sv_setsv_flags +=item Merge the win32 and wince codebases =back @@ -5934,13 +5979,7 @@ Implement L, Implement L =over 4 -=item IPv6 - -=item shrink Cs, Cs - -=item merge Perl_sv_2[inpu]v - -=item UTF8 caching code +=item shrink Cs =item Implicit Latin 1 => Unicode translation @@ -5968,8 +6007,6 @@ Implement L, Implement L =item Attach/detach debugger from running program -=item Constant folding - =item LVALUE functions for lists =item LVALUE functions in the debugger @@ -5978,8 +6015,6 @@ Implement L, Implement L =item state variables -=item @INC source filter to Filter::Simple - =item regexp optimiser optional =item UNITCHECK @@ -5998,6 +6033,8 @@ Implement L, Implement L =item What hooks would assertions need? +=item Properly Unicode safe tokeniser and pads. + =back =item Big projects @@ -6079,6 +6116,12 @@ B<-V> =item Incompatible Changes +=over 4 + +=item chdir FOO + +=back + =item Core Enhancements =item Modules and Pragmata @@ -6119,6 +6162,12 @@ B<-V> =item Incompatible Changes +=over 4 + +=item chdir FOO + +=back + =item Core Enhancements =item Modules and Pragmata @@ -9128,9 +9177,9 @@ B, B =item BUILD Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's -celib-sources, Rainer Keuchel's console-sources, go to ./wince -subdirectory, edit file compile.bat, run compile.bat, run compile.bat -dist +celib-sources, Rainer Keuchel's console-sources, go to C<./win32> +subdirectory, edit file C, run compile.bat, run +compile.bat dist =back @@ -9144,9 +9193,9 @@ dist =item ENVIRONMENT -=item REGISTRY +PERL5LIB, PATH, TMP, UNIXROOTPATH, ROWS/COLS, HOME, CONSOLEFONTSIZE -=item PERLFILES +=item REGISTRY =item XS @@ -9158,6 +9207,8 @@ dist =item ACKNOWLEDGEMENTS +=item History of WinCE port + =item AUTHORS Rainer Keuchel , Vadim Konovalov @@ -9563,6 +9614,8 @@ op/lexassign.t, pragma/warnings.t =item Universal Binary support +=item 64-bit PPC support + =item libperl and Prebinding =item Updating Apple's Perl @@ -10103,6 +10156,18 @@ qnx/ar, qnx/cpp =back +=head2 perlriscos, README.riscos - Perl version 5 for RISC OS + +=over 4 + +=item DESCRIPTION + +=item BUILD + +=item AUTHOR + +=back + =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems =over 4 @@ -10346,6 +10411,8 @@ Digital UNIX formerly known as DEC OSF/1) systems =item PERL5LIB and PERLLIB +=item PERL_VMS_EXCEPTION_DEBUG + =item Command line =over 4 @@ -10515,34 +10582,62 @@ ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE =back -=head2 threads - Perl extension allowing use of interpreter based threads -from perl +=head2 threads - Perl interpreter-based threads =over 4 +=item VERSION + =item SYNOPSIS =item DESCRIPTION -$thread = threads->create(function, LIST), $thread->join, $thread->detach, -threads->self, $thread->tid, threads->object( tid ), threads->yield();, -threads->list();, async BLOCK; +$thr = threads->create(FUNCTION, ARGS), $thr->join(), $thr->detach(), +threads->detach(), threads->self(), $thr->tid(), threads->tid(), +threads->object($tid), threads->yield(), threads->list(), +$thr1->equal($thr2), async BLOCK;, $thr->_handle(), threads->_handle() + +=item THREAD STACK SIZE + +threads->get_stack_size();, $size = $thr->get_stack_size();, $old_size = +threads->set_stack_size($new_size);, use threads ('stack_size' => VALUE);, +$ENV{'PERL5_ITHREADS_STACK_SIZE'}, threads->create({'stack_size' => VALUE}, +FUNCTION, ARGS), $thr2 = $thr1->create(FUNCTION, ARGS) + +=item THREAD SIGNALLING + +$thr->kill('SIG...'); =item WARNINGS -A thread exited while %d other threads were still running +A thread exited while # other threads were still running, Thread creation +failed: pthread_create returned #, Thread # terminated abnormally: .., +Using minimum thread stack size of #, Thread creation failed: +pthread_attr_setstacksize(I) returned 22 -=item TODO +=item ERRORS + +This Perl not built to support threads, Cannot change stack size of an +existing thread, Cannot signal other threads without safe signals, +Unrecognized signal name: .. =item BUGS -Parent-Child threads, tid is I32, Returning objects, Creating threads -inside BEGIN blocks, PERL_OLD_SIGNALS are not threadsafe, will not be +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 +L -=item AUTHOR and COPYRIGHT +=item REQUIREMENTS =item SEE ALSO +=item AUTHOR + +=item ACKNOWLEDGEMENTS + =back =head2 assertions - select assertions in blocks of code @@ -11057,6 +11152,8 @@ upgrading for byte-strings =item the 'err' feature +=item the 'state' feature + =back =item FEATURE BUNDLES @@ -11238,10 +11335,10 @@ is inherited by derived classes =item Fallback -=item Smart Match - C, TRUE, defined, but FALSE +=item Smart Match + =item Copy Constructor B @@ -11255,6 +11352,8 @@ I, C, I, I, I, I, I, I, I +=item Minimal set of overloaded operations + =item Losing overloading =item Run-time Overloading @@ -11721,7 +11820,8 @@ What's the minimum perl version required to run Archive::Tar?, Isn't Archive::Tar slow?, Isn't Archive::Tar heavier on memory than /bin/tar?, Can't you lazy-load data instead?, How much memory will an X kb tar file need?, What do you do with unsupported filetypes in an archive?, How do I -access .tar.Z files? +extract only files that have property X from an archive?, How do I access +.tar.Z files? =item TODO @@ -13034,6 +13134,8 @@ FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE =item STATUS +=item COMPATIBILITY + =item DESCRIPTION =over 4 @@ -13051,6 +13153,8 @@ Signals =item recompile +=item mkmyconfig + =item The four C Classes: Author, Bundle, Module, Distribution =item Programmer's interface @@ -13068,23 +13172,25 @@ CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(), CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(), CPAN::Bundle::readme(), CPAN::Bundle::test(), CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(), -CPAN::Distribution::clean(), CPAN::Distribution::containsmods(), -CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(), -CPAN::Distribution::force($method,@args), CPAN::Distribution::get(), -CPAN::Distribution::install(), CPAN::Distribution::isa_perl(), -CPAN::Distribution::look(), CPAN::Distribution::make(), +CPAN::Distribution::author, CPAN::Distribution::clean(), +CPAN::Distribution::containsmods(), CPAN::Distribution::cvs_import(), +CPAN::Distribution::dir(), CPAN::Distribution::force($method,@args), +CPAN::Distribution::get(), CPAN::Distribution::install(), +CPAN::Distribution::isa_perl(), CPAN::Distribution::look(), +CPAN::Distribution::make(), CPAN::Distribution::perldoc(), CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(), -CPAN::Distribution::perldoc(), CPAN::Distribution::test(), +CPAN::Distribution::read_yaml(), CPAN::Distribution::test(), CPAN::Distribution::uptodate(), CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(), CPAN::Module::as_glimpse(), CPAN::Module::as_string(), CPAN::Module::clean(), CPAN::Module::cpan_file(), CPAN::Module::cpan_version(), CPAN::Module::cvs_import(), CPAN::Module::description(), +CPAN::Module::distribution(), CPAN::Module::dslip_status(), CPAN::Module::force($method,@args), CPAN::Module::get(), CPAN::Module::inst_file(), CPAN::Module::inst_version(), CPAN::Module::install(), CPAN::Module::look(), CPAN::Module::make(), -CPAN::Module::manpage_headline(), CPAN::Module::readme(), -CPAN::Module::perldoc(), CPAN::Module::test(), CPAN::Module::uptodate(), +CPAN::Module::manpage_headline(), CPAN::Module::perldoc(), +CPAN::Module::readme(), CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid() =item Cache Manager @@ -13146,7 +13252,7 @@ http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade =item FAQ -1), 2), 3), 4), 5), 6), 7), 8), 9), 10), 11) +1), 2), 3), 4), 5), 6), 7), 8), 9), 10), 11), 12), 13), 14) =item BUGS @@ -13280,7 +13386,8 @@ Example 1, Example 2, Example 3 =back -=head2 Compress::Zlib - Interface to zlib compression library +=head2 Compress::IO::Base::lib::File::GlobMapper, File::GlobMapper - Extend +File Glob to Allow Input and Output Files =over 4 @@ -13288,162 +13395,159 @@ Example 1, Example 2, Example 3 =item DESCRIPTION -=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> +This code is a work in progress, There are known bugs, The interface +defined here is tentative, There are portability issues, Do not use in +production code, Consider yourself warned! =over 4 -=item Examples - -=item Compress::Zlib::memGzip +=item Behind The Scenes -=item Compress::Zlib::memGunzip +=item Limitations -=back +=item Input File Glob -=item COMPRESS/UNCOMPRESS +B<~>, B<~user>, B<.>, B<*>, B, B<\>, B<[]>, B<{,}>, B<()> -B<$dest = compress($source [, $level] ) ;>, B<$dest = uncompress($source) -;> +=item Output File Glob -=item CHECKSUM FUNCTIONS +"*", #1 -=item Compress::Zlib::Deflate +=item Returned Data -=over 4 +=back -=item B<($d, $status) = new Compress::Zlib::Deflate( [OPT] ) > +=item EXAMPLES -B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>, -B<-Dictionary>, B<-Bufsize>, B<-AppendOutput>, B<-CRC32>, B<-ADLER32> +=over 4 -=item B<$status = $d-Edeflate($input, $output)> +=item A Rename script -=item B<$status = $d-Eflush($output [, $flush_type]) > +=item A few example globmaps -=item B<$status = $d-EdeflateParams([OPT])> +=back -B<-Level>, B<-Strategy>, B<-BufSize> +=item SEE ALSO -=item B<$status = $d-EdeflateTune($good_length, $max_lazy, -$nice_length, $max_chain)> +=item AUTHOR -=item B<$d-Edict_adler()> +=item COPYRIGHT AND LICENSE -=item B<$d-Ecrc32()> +=back -=item B<$d-Eadler32()> +=head2 Compress::IO::Base::lib::IO::Compress::Base, IO::Compress::Base - +Base Class for IO::Compress modules -=item B<$d-Emsg()> +=over 4 -=item B<$d-Etotal_in()> +=item SYNOPSIS -=item B<$d-Etotal_out()> +=item DESCRIPTION -=item B<$d-Eget_Strategy()> +=item SEE ALSO -=item B<$d-Eget_Level()> +=item AUTHOR -=item B<$d-Eget_BufSize()> +=item MODIFICATION HISTORY -=item Example +=item COPYRIGHT AND LICENSE =back -=item Compress::Zlib::Inflate +=head2 Compress::IO::Base::lib::IO::Uncompress::AnyUncompress, +IO::Uncompress::AnyUncompress - Uncompress gzip, zip, bzip2 or lzop +file/buffer =over 4 -=item B< ($i, $status) = new Compress::Zlib::Inflate( [OPT] ) > - -B<-WindowBits>, B<-Bufsize>, B<-Dictionary>, B<-AppendOutput>, B<-CRC32>, -B<-ADLER32>, B<-ConsumeInput> +=item SYNOPSIS -=item B< $status = $i-Einflate($input, $output [,$eof]) > +=item DESCRIPTION -=item B<$status = $i-EinflateSync($input)> +DO NOT use in production code, The documentation is incomplete in places, +Parts of the interface defined here are tentative, Please report any +problems you find, RFC 1950, RFC 1951, gzip (RFC 1952), zip, bzip2, lzop -=item B<$i-Edict_adler()> +=item Functional Interface -=item B<$i-Ecrc32()> +=over 4 -=item B<$i-Eadler32()> +=item anyuncompress $input => $output [, OPTS] -=item B<$i-Emsg()> +A filename, A filehandle, A scalar reference, An array reference, An Input +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob -=item B<$i-Etotal_in()> +=item Notes -=item B<$i-Etotal_out()> +=item Optional Parameters -=item B<$d-Eget_BufSize()> +AutoClose =E 0|1, BinModeOut =E 0|1, -Append =E 0|1, +-MultiStream =E 0|1 -=item Example +=item Examples =back -=item Compress::Zlib 1.x Deflate Interface +=item OO Interface =over 4 -=item B<($d, $status) = deflateInit( [OPT] )> +=item Constructor -B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>, -B<-Dictionary>, B<-Bufsize> +A filename, A filehandle, A scalar reference -=item B<($out, $status) = $d-Edeflate($buffer)> +=item Constructor Options -=item B<($out, $status) = $d-Eflush([flush_type])> +-AutoClose =E 0|1, -MultiStream =E 0|1, -Prime =E $string, +-Transparent =E 0|1, -BlockSize =E $num, -InputLength =E $size, +-Append =E 0|1, -Strict =E 0|1 -=item B<$status = $d-EdeflateParams([OPT])> +=item Examples -B<-Level>, B<-Strategy> +=back -=item B<$d-Edict_adler()> +=item Methods -=item B<$d-Emsg()> +=over 4 -=item B<$d-Etotal_in()> +=item read -=item B<$d-Etotal_out()> +=item read -=item Example +=item getline -=back +=item getc -=item Compress::Zlib 1.x Inflate Interface +=item ungetc -=over 4 +=item getHeaderInfo -=item B<($i, $status) = inflateInit()> +=item tell -B<-WindowBits>, B<-Bufsize>, B<-Dictionary> +=item eof -=item B<($out, $status) = $i-Einflate($buffer)> +=item seek -=item B<$status = $i-EinflateSync($buffer)> +=item binmode -=item B<$i-Edict_adler()> +=item opened -=item B<$i-Emsg()> +=item autoflush -=item B<$i-Etotal_in()> +=item input_line_number -=item B<$i-Etotal_out()> +=item fileno -=item Example +=item close =back -=item ACCESSING ZIP FILES +=item Importing -=item CONSTANTS +:all + +=item EXAMPLES =item SEE ALSO @@ -13455,8 +13559,8 @@ B<-WindowBits>, B<-Bufsize>, B<-Dictionary> =back -=head2 Compress::Zlib::File::GlobMapper, File::GlobMapper - Extend File -Glob to Allow Input and Output Files +=head2 Compress::IO::Base::lib::IO::Uncompress::Base, IO::Uncompress::Base +- Base Class for IO::Uncompress modules =over 4 @@ -13464,48 +13568,124 @@ Glob to Allow Input and Output Files =item DESCRIPTION -This code is a work in progress, There are known bugs, The interface -defined here is tentative, There are portability issues, Do not use in -production code, Consider yourself warned! +=item SEE ALSO -=over 4 +=item AUTHOR -=item Behind The Scenes +=item MODIFICATION HISTORY -=item Limitations +=item COPYRIGHT AND LICENSE -=item Input File Glob +=back -B<~>, B<~user>, B<.>, B<*>, B, B<\>, B<[]>, B<{,}>, B<()> +=head2 Compress::IO::Zlib::IO::Compress::Deflate, IO::Compress::Deflate - +Write RFC 1950 files/buffers -=item Output File Glob +=over 4 -"*", #1 +=item SYNOPSIS -=item Returned Data +=item DESCRIPTION + +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] + +A filename, A filehandle, A scalar reference, An array reference, An Input +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob + +=item Notes + +=item Optional Parameters + +AutoClose =E 0|1, BinModeIn =E 0|1, -Append =E 0|1 + +=item Examples =back -=item EXAMPLES +=item OO Interface =over 4 -=item A Rename script +=item Constructor -=item A few example globmaps +A filename, A filehandle, A scalar reference + +=item Constructor Options + +AutoClose =E 0|1, Append =E 0|1, A Buffer, A Filename, A +Filehandle, Merge =E 0|1, -Level, -Strategy, -Strict =E 0|1 + +=item Examples + +=back + +=item Methods + +=over 4 + +=item print + +=item printf + +=item syswrite + +=item write + +=item flush + +=item tell + +=item eof + +=item seek + +=item binmode + +=item opened + +=item autoflush + +=item input_line_number + +=item fileno + +=item close + +=item newStream([OPTS]) + +Level + +=item deflateParams =back +=item Importing + +:all, :constants, :flush, :level, :strategy + +=item EXAMPLES + =item SEE ALSO =item AUTHOR +=item MODIFICATION HISTORY + =item COPYRIGHT AND LICENSE =back -=head2 Compress::Zlib::IO::Compress::Deflate, IO::Compress::Deflate - -Perl interface to write RFC 1950 files/buffers +=head2 Compress::IO::Zlib::IO::Compress::Gzip, IO::Compress::Gzip - Write +RFC 1952 files/buffers =over 4 @@ -13521,7 +13701,7 @@ problems you find =over 4 -=item deflate $input => $output [, OPTS] +=item gzip $input => $output [, OPTS] A filename, A filehandle, A scalar reference, An array reference, An Input FileGlob string, A filename, A filehandle, A scalar reference, An Array @@ -13547,8 +13727,11 @@ A filename, A filehandle, A scalar reference =item Constructor Options --AutoClose =E 0|1, -Append =E 0|1, A Buffer, A Filename, A -Filehandle, -Merge =E 0|1, -Level, -Strategy, -Strict =E 0|1 +AutoClose =E 0|1, Append =E 0|1, A Buffer, A Filename, A +Filehandle, Merge =E 0|1, -Level, -Strategy, -Minimal =E 0|1, +-Comment =E $comment, -Name =E $string, -Time =E $number, +-TextFlag =E 0|1, -HeaderCRC =E 0|1, -OS_Code =E $value, +-ExtraField =E $data, -ExtraFlags =E $value, -Strict =E 0|1 =item Examples @@ -13576,13 +13759,19 @@ Filehandle, -Merge =E 0|1, -Level, -Strategy, -Strict =E 0|1 =item binmode +=item opened + +=item autoflush + +=item input_line_number + =item fileno =item close =item newStream([OPTS]) -Level, TODO +Level =item deflateParams @@ -13604,8 +13793,8 @@ Level, TODO =back -=head2 Compress::Zlib::IO::Compress::Gzip, IO::Compress::Gzip - Perl -interface to write RFC 1952 files/buffers +=head2 Compress::IO::Zlib::IO::Compress::RawDeflate, +IO::Compress::RawDeflate - Write RFC 1951 files/buffers =over 4 @@ -13621,7 +13810,7 @@ problems you find =over 4 -=item gzip $input => $output [, OPTS] +=item rawdeflate $input => $output [, OPTS] A filename, A filehandle, A scalar reference, An array reference, An Input FileGlob string, A filename, A filehandle, A scalar reference, An Array @@ -13647,11 +13836,8 @@ A filename, A filehandle, A scalar reference =item Constructor Options --AutoClose =E 0|1, -Append =E 0|1, A Buffer, A Filename, A -Filehandle, -Merge =E 0|1, -Level, -Strategy, -Minimal =E 0|1, --Comment =E $comment, -Name =E $string, -Time =E $number, --TextFlag =E 0|1, -HeaderCRC =E 0|1, -OS_Code =E $value, --ExtraField =E $data, -ExtraFlags =E $value, -Strict =E 0|1 +AutoClose =E 0|1, Append =E 0|1, A Buffer, A Filename, A +Filehandle, Merge =E 0|1, -Level, -Strategy, -Strict =E 0|1 =item Examples @@ -13679,13 +13865,19 @@ Filehandle, -Merge =E 0|1, -Level, -Strategy, -Minimal =E 0|1, =item binmode +=item opened + +=item autoflush + +=item input_line_number + =item fileno =item close =item newStream([OPTS]) -Level, TODO +Level =item deflateParams @@ -13707,8 +13899,8 @@ Level, TODO =back -=head2 Compress::Zlib::IO::Compress::RawDeflate, IO::Compress::RawDeflate - - Perl interface to write RFC 1951 files/buffers +=head2 Compress::IO::Zlib::IO::Compress::Zip, IO::Compress::Zip - Write zip +files/buffers =over 4 @@ -13724,7 +13916,7 @@ problems you find =over 4 -=item rawdeflate $input => $output [, OPTS] +=item zip $input => $output [, OPTS] A filename, A filehandle, A scalar reference, An array reference, An Input FileGlob string, A filename, A filehandle, A scalar reference, An Array @@ -13750,8 +13942,13 @@ A filename, A filehandle, A scalar reference =item Constructor Options --AutoClose =E 0|1, -Append =E 0|1, A Buffer, A Filename, A -Filehandle, -Merge =E 0|1, -Level, -Strategy, -Strict =E 0|1 +AutoClose =E 0|1, Append =E 0|1, A Buffer, A Filename, A +Filehandle, -Name =E $string, -Time =E $number, -exTime =E +[$atime, $mtime, $ctime], -Comment =E $comment, -ZipComment =E +$comment, Method =E $method, Stream =E 0|1, -TextFlag =E 0|1, +ExtraFieldLocal =E $data =item ExtraFieldCentral =E $data, Minimal +=E 1|0, BlockSize100K =E number, WorkFactor =E number, -Level, +-Strategy, -Strict =E 0|1 =item Examples @@ -13779,13 +13976,19 @@ Filehandle, -Merge =E 0|1, -Level, -Strategy, -Strict =E 0|1 =item binmode +=item opened + +=item autoflush + +=item input_line_number + =item fileno =item close =item newStream([OPTS]) -Level, TODO +Level =item deflateParams @@ -13793,7 +13996,7 @@ Level, TODO =item Importing -:all, :constants, :flush, :level, :strategy +:all, :constants, :flush, :level, :strategy, :zip_method =item EXAMPLES @@ -13807,9 +14010,8 @@ Level, TODO =back -=head2 Compress::Zlib::IO::Uncompress::AnyInflate, -IO::Uncompress::AnyInflate - Perl interface to read RFC 1950, 1951 & 1952 -files/buffers +=head2 Compress::IO::Zlib::IO::Uncompress::AnyInflate, +IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip) file/buffer =over 4 @@ -13819,7 +14021,7 @@ files/buffers DO NOT use in production code, The documentation is incomplete in places, Parts of the interface defined here are tentative, Please report any -problems you find +problems you find, RFC 1950, RFC 1951, gzip (RFC 1952), zip =item Functional Interface @@ -13886,6 +14088,12 @@ A filename, A filehandle, A scalar reference =item binmode +=item opened + +=item autoflush + +=item input_line_number + =item fileno =item close @@ -13908,8 +14116,8 @@ A filename, A filehandle, A scalar reference =back -=head2 Compress::Zlib::IO::Uncompress::Gunzip, IO::Uncompress::Gunzip - -Perl interface to read RFC 1952 files/buffers +=head2 Compress::IO::Zlib::IO::Uncompress::Gunzip, IO::Uncompress::Gunzip - +Read RFC 1952 files/buffers =over 4 @@ -13988,6 +14196,12 @@ Name, Comment =item binmode +=item opened + +=item autoflush + +=item input_line_number + =item fileno =item close @@ -14010,8 +14224,8 @@ Name, Comment =back -=head2 Compress::Zlib::IO::Uncompress::Inflate, IO::Uncompress::Inflate - -Perl interface to read RFC 1950 files/buffers +=head2 Compress::IO::Zlib::IO::Uncompress::Inflate, IO::Uncompress::Inflate +- Read RFC 1950 files/buffers =over 4 @@ -14088,6 +14302,12 @@ A filename, A filehandle, A scalar reference =item binmode +=item opened + +=item autoflush + +=item input_line_number + =item fileno =item close @@ -14110,8 +14330,8 @@ A filename, A filehandle, A scalar reference =back -=head2 Compress::Zlib::IO::Uncompress::RawInflate, -IO::Uncompress::RawInflate - Perl interface to read RFC 1951 files/buffers +=head2 Compress::IO::Zlib::IO::Uncompress::RawInflate, +IO::Uncompress::RawInflate - Read RFC 1951 files/buffers =over 4 @@ -14188,6 +14408,12 @@ A filename, A filehandle, A scalar reference =item binmode +=item opened + +=item autoflush + +=item input_line_number + =item fileno =item close @@ -14210,418 +14436,212 @@ A filename, A filehandle, A scalar reference =back -=head2 Compress::Zlib::pod::FAQ, Compress::Zlib::FAQ -- Frequently Asked -Questions about Compress::Zlib +=head2 Compress::IO::Zlib::IO::Uncompress::Unzip, IO::Uncompress::Unzip - +Read zip files/buffers =over 4 -=item DESCRIPTION +=item SYNOPSIS -=over 4 +=item DESCRIPTION -=item Compatibility with Unix compress/uncompress. +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 Accessing .tar.Z files +=item Functional Interface -=item Accessing Zip Files +=over 4 -=item Zlib Library Version Support +=item unzip $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 MODIFICATION HISTORY +AutoClose =E 0|1, BinModeOut =E 0|1, -Append =E 0|1, +-MultiStream =E 0|1 -=item COPYRIGHT AND LICENSE +=item Examples =back -=head2 Config - access Perl configuration information +=item OO Interface =over 4 -=item SYNOPSIS +=item Constructor -=item DESCRIPTION +A filename, A filehandle, A scalar reference -myconfig(), config_sh(), config_re($regex), config_vars(@names) +=item Constructor Options -=item EXAMPLE +-AutoClose =E 0|1, -MultiStream =E 0|1, -Prime =E $string, +-Transparent =E 0|1, -BlockSize =E $num, -InputLength =E $size, +-Append =E 0|1, -Strict =E 0|1 -=item WARNING +=item Examples -=item GLOSSARY +=back + +=item Methods =over 4 -=item _ +=item read -C<_a>, C<_exe>, C<_o> +=item read -=item a +=item getline -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, C, -C, C +=item getc -=item b +=item ungetc -C, C, C, C, C, C, C +=item inflateSync -=item c +=item getHeaderInfo -C, C, C, C, C, C, C, -C, C, C, C, C, -C, C, 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 tell -=item d +=item eof -C, C, C, C, C, -C, C, C, C, -C, C, C, -C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, -C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, -C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -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 seek -=item e +=item binmode -C, C, C, C, C, C, -C, C, C, -C, C, C, C, -C, C, C +=item opened -=item f +=item autoflush -C, C, C, C, C, -C, C, C, C, C, C, -C +=item input_line_number -=item g +=item fileno -C, C, C, C, -C, C, C, -C, C, C, -C, 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 close -=item h +=back -C, C, C, C, C, C, -C, C +=item Importing -=item i +:all -C, C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, -C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, 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 +=item EXAMPLES -=item M +=item SEE ALSO -C, C, C, C, C, C, -C, C, C, C, C, C, -C +=item AUTHOR -=item n +=item MODIFICATION HISTORY -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C +=item COPYRIGHT AND LICENSE -=item o +=back -C, C, C, C, -C, C, C, C +=head2 Compress::Raw::Zlib - Low-Level Interface to zlib compression +library -=item p +=over 4 -C, C, C, C, C, C, -C, C +=item SYNOPSIS -=item P +=item DESCRIPTION -C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, C, -C, C, C +=item Compress::Raw::Zlib::Deflate -=item q +=over 4 -C, C +=item B<($d, $status) = new Compress::Raw::Zlib::Deflate( [OPT] ) > -=item r +B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>, +B<-Dictionary>, B<-Bufsize>, B<-AppendOutput>, B<-CRC32>, B<-ADLER32> -C, C, C, C, C, -C, C, C, C, C, -C, C, C +=item B<$status = $d-Edeflate($input, $output)> -=item s +=item B<$status = $d-Eflush($output [, $flush_type]) > -C, C, C, C, C, -C, C, C, C, -C, C, C, -C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, 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<$status = $d-EdeflateParams([OPT])> -=item t +B<-Level>, B<-Strategy>, B<-BufSize> -C, C, C, C, C, C, C, -C, C, C, C, C, C, C, -C +=item B<$status = $d-EdeflateTune($good_length, $max_lazy, +$nice_length, $max_chain)> -=item u +=item B<$d-Edict_adler()> -C, C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, 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<$d-Ecrc32()> -=item v +=item B<$d-Eadler32()> -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<$d-Emsg()> -=item x +=item B<$d-Etotal_in()> -C +=item B<$d-Etotal_out()> -=item y +=item B<$d-Eget_Strategy()> -C, C +=item B<$d-Eget_Level()> -=item z +=item B<$d-Eget_BufSize()> -C, C +=item Example =back -=item NOTE - -=back +=item Compress::Raw::Zlib::Inflate =over 4 -=item SYNOPSIS +=item B< ($i, $status) = new Compress::Raw::Zlib::Inflate( [OPT] ) > -=item DESCRIPTION +B<-WindowBits>, B<-Bufsize>, B<-Dictionary>, B<-AppendOutput>, B<-CRC32>, +B<-ADLER32>, B<-ConsumeInput> -dynamic, nonxs, static +=item B< $status = $i-Einflate($input, $output [,$eof]) > -=item AUTHOR +=item B<$status = $i-EinflateSync($input)> -=back +=item B<$i-Edict_adler()> -=head2 Cwd - get pathname of current working directory +=item B<$i-Ecrc32()> -=over 4 +=item B<$i-Eadler32()> -=item SYNOPSIS +=item B<$i-Emsg()> -=item DESCRIPTION +=item B<$i-Etotal_in()> -=over 4 +=item B<$i-Etotal_out()> -=item getcwd and friends +=item B<$d-Eget_BufSize()> -getcwd, cwd, fastcwd, fastgetcwd, getdcwd +=item Example -=item abs_path and friends +=back -abs_path, realpath, fast_abs_path +=item CHECKSUM FUNCTIONS -=item $ENV{PWD} +=item ACCESSING ZIP FILES -=back +=item CONSTANTS -=item NOTES +=item SEE ALSO =item AUTHOR -=item COPYRIGHT +=item MODIFICATION HISTORY -=item SEE ALSO +=item COPYRIGHT AND LICENSE =back -=head2 DB - programmatic interface to the Perl debugging API (draft, -subject to -change) +=head2 Compress::Raw::Zlib::Compress::Raw::Zlib, Compress::Raw::Zlib - +Low-Level Interface to zlib compression library =over 4 @@ -14629,239 +14649,205 @@ change) =item DESCRIPTION +=item Compress::Raw::Zlib::Deflate + =over 4 -=item Global Variables +=item B<($d, $status) = new Compress::Raw::Zlib::Deflate( [OPT] ) > - $DB::sub, %DB::sub, $DB::single, $DB::signal, $DB::trace, @DB::args, -@DB::dbline, %DB::dbline, $DB::package, $DB::filename, $DB::subname, -$DB::lineno +B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>, +B<-Dictionary>, B<-Bufsize>, B<-AppendOutput>, B<-CRC32>, B<-ADLER32> -=item API Methods +=item B<$status = $d-Edeflate($input, $output)> -CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'), -CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done() +=item B<$status = $d-Eflush($output [, $flush_type]) > -=item Client Callback Methods +=item B<$status = $d-EdeflateParams([OPT])> -CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(), -CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(), -CLIENT->output(LIST) +B<-Level>, B<-Strategy>, B<-BufSize> -=back +=item B<$status = $d-EdeflateTune($good_length, $max_lazy, +$nice_length, $max_chain)> -=item BUGS +=item B<$d-Edict_adler()> -=item AUTHOR +=item B<$d-Ecrc32()> -=back +=item B<$d-Eadler32()> -=head2 DBM_Filter -- Filter DBM keys/values +=item B<$d-Emsg()> -=over 4 +=item B<$d-Etotal_in()> -=item SYNOPSIS +=item B<$d-Etotal_out()> -=item DESCRIPTION +=item B<$d-Eget_Strategy()> -=item What is a DBM Filter? +=item B<$d-Eget_Level()> -=over 4 +=item B<$d-Eget_BufSize()> -=item So what's new? +=item Example =back -=item METHODS +=item Compress::Raw::Zlib::Inflate =over 4 -=item $db->Filter_Push() +=item B< ($i, $status) = new Compress::Raw::Zlib::Inflate( [OPT] ) > -=item $db->Filter_Key_Push() +B<-WindowBits>, B<-Bufsize>, B<-Dictionary>, B<-AppendOutput>, B<-CRC32>, +B<-ADLER32>, B<-ConsumeInput> -=item $db->Filter_Value_Push() +=item B< $status = $i-Einflate($input, $output [,$eof]) > -Filter_Push, Filter_Key_Push, Filter_Value_Push +=item B<$status = $i-EinflateSync($input)> -=item $db->Filter_Pop() +=item B<$i-Edict_adler()> -=item $db->Filtered() +=item B<$i-Ecrc32()> -=back +=item B<$i-Eadler32()> -=item Writing a Filter +=item B<$i-Emsg()> -=over 4 +=item B<$i-Etotal_in()> -=item Immediate Filters +=item B<$i-Etotal_out()> -=item Canned Filters +=item B<$d-Eget_BufSize()> -"name", params +=item Example =back -=item Filters Included +=item CHECKSUM FUNCTIONS -utf8, encode, compress, int32, null +=item ACCESSING ZIP FILES -=item NOTES +=item CONSTANTS -=over 4 +=item SEE ALSO -=item Maintain Round Trip Integrity +=item AUTHOR -=item Don't mix filtered & non-filtered data in the same database file. +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE =back -=item EXAMPLE +=head2 Compress::Zlib - Interface to zlib compression library -=item SEE ALSO - -=item AUTHOR - -=back - -=head2 DB_File - Perl5 access to Berkeley DB version 1.x - -=over 4 +=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 +=item Notes for users of Compress::Zlib version 1 =back -=item DB_HASH - -=over 4 - -=item A Simple Example - -=back +=item GZIP INTERFACE -=item DB_BTREE +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 Changing the BTREE sort order - -=item Handling Duplicate Keys - -=item The get_dup() Method - -=item The find_dup() Method +=item Examples -=item The del_dup() Method +=item Compress::Zlib::memGzip -=item Matching Partial Keys +=item Compress::Zlib::memGunzip =back -=item DB_RECNO - -=over 4 +=item COMPRESS/UNCOMPRESS -=item The 'bval' Option +B<$dest = compress($source [, $level] ) ;>, B<$dest = uncompress($source) +;> -=item A Simple Example +=item Deflate Interface -=item Extra RECNO Methods +=over 4 -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 B<($d, $status) = deflateInit( [OPT] )> -=item Another Example +B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>, +B<-Dictionary>, B<-Bufsize> -=back +=item B<($out, $status) = $d-Edeflate($buffer)> -=item THE API INTERFACE +=item B<($out, $status) = $d-Eflush([flush_type])> -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 B<$status = $d-EdeflateParams([OPT])> -=item DBM FILTERS +B<-Level>, B<-Strategy> -B, B, B, -B +=item B<$d-Edict_adler()> -=over 4 +=item B<$d-Emsg()> -=item The Filter +=item B<$d-Etotal_in()> -=item An Example -- the NULL termination problem. +=item B<$d-Etotal_out()> -=item Another Example -- Key is a C int. +=item Example =back -=item HINTS AND TIPS +=item Inflate Interface =over 4 -=item Locking: The Trouble with fd - -=item Safe ways to lock a database - -B, B, B - -=item Sharing Databases With C Applications +=item B<($i, $status) = inflateInit()> -=item The untie() Gotcha +B<-WindowBits>, B<-Bufsize>, B<-Dictionary> -=back +=item B<($out, $status) = $i-Einflate($buffer)> -=item COMMON QUESTIONS +=item B<$status = $i-EinflateSync($buffer)> -=over 4 +=item B<$i-Edict_adler()> -=item Why is there Perl source in my database? +=item B<$i-Emsg()> -=item How do I store complex data structures with DB_File? +=item B<$i-Etotal_in()> -=item What does "Invalid Argument" mean? +=item B<$i-Etotal_out()> -=item What does "Bareword 'DB_File' not allowed" mean? +=item Example =back -=item REFERENCES - -=item HISTORY - -=item BUGS +=item CHECKSUM FUNCTIONS -=item AVAILABILITY +=item ACCESSING ZIP FILES -=item COPYRIGHT +=item CONSTANTS =item SEE ALSO =item AUTHOR +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE + =back -=head2 Data::Dumper - stringified perl data structures, suitable for both -printing and C +=head2 Compress::Zlib::Compress::Zlib, Compress::Zlib - Interface to zlib +compression library =over 4 @@ -14871,114 +14857,105 @@ printing and C =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 +=item Notes for users of Compress::Zlib version 1 =back -=item EXAMPLES +=item GZIP INTERFACE -=item BUGS +B<$gz = gzopen($filename, $mode)>, B<$gz = gzopen($filehandle, $mode)>, +B<$bytesread = $gz-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 NOTE +=item Examples -=back +=item Compress::Zlib::memGzip -=item AUTHOR +=item Compress::Zlib::memGunzip -=item VERSION +=back -=item SEE ALSO +=item COMPRESS/UNCOMPRESS -=back +B<$dest = compress($source [, $level] ) ;>, B<$dest = uncompress($source) +;> -=head2 Devel::DProf - a Perl code profiler +=item Deflate Interface =over 4 -=item SYNOPSIS +=item B<($d, $status) = deflateInit( [OPT] )> -=item DESCRIPTION +B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>, +B<-Dictionary>, B<-Bufsize> -=item PROFILE FORMAT +=item B<($out, $status) = $d-Edeflate($buffer)> -=item AUTOLOAD +=item B<($out, $status) = $d-Eflush([flush_type])> -=item ENVIRONMENT +=item B<$status = $d-EdeflateParams([OPT])> -=item BUGS +B<-Level>, B<-Strategy> -=item SEE ALSO +=item B<$d-Edict_adler()> -=back +=item B<$d-Emsg()> -=head2 Devel::PPPort - Perl/Pollution/Portability +=item B<$d-Etotal_in()> -=over 4 +=item B<$d-Etotal_out()> -=item SYNOPSIS +=item Example -=item DESCRIPTION +=back -=over 4 +=item Inflate Interface -=item Why use ppport.h? +=over 4 -=item How to use ppport.h +=item B<($i, $status) = inflateInit()> -=item Running ppport.h +B<-WindowBits>, B<-Bufsize>, B<-Dictionary> -=back +=item B<($out, $status) = $i-Einflate($buffer)> -=item FUNCTIONS +=item B<$status = $i-EinflateSync($buffer)> -=over 4 +=item B<$i-Edict_adler()> -=item WriteFile +=item B<$i-Emsg()> -=back +=item B<$i-Etotal_in()> -=item COMPATIBILITY +=item B<$i-Etotal_out()> -=over 4 +=item Example -=item Provided Perl compatibility API +=back -=item Perl API not supported by ppport.h +=item CHECKSUM FUNCTIONS -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 ACCESSING ZIP FILES -=back +=item CONSTANTS -=item BUGS +=item SEE ALSO -=item AUTHORS +=item AUTHOR -=item COPYRIGHT +=item MODIFICATION HISTORY -=item SEE ALSO +=item COPYRIGHT AND LICENSE =back -=head2 Devel::Peek - A data debugging tool for the XS programmer +=head2 Config - access Perl configuration information =over 4 @@ -14986,59 +14963,1622 @@ perl 5.005_03, perl 5.005, perl 5.004_05, perl 5.004 =item DESCRIPTION -=over 4 - -=item Runtime debugging +myconfig(), config_sh(), config_re($regex), config_vars(@names) -=item Memory footprint debugging +=item EXAMPLE -=back +=item WARNING -=item EXAMPLES +=item GLOSSARY =over 4 -=item A simple scalar string +=item _ -=item A simple scalar number +C<_a>, C<_exe>, C<_o> -=item A simple scalar with an extra reference +=item a -=item A reference to a simple scalar +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, C, +C, C -=item A reference to an array +=item b -=item A reference to a hash +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 + +=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::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.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 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 + +=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 + +Can't find '%s' symbol in %s, Can't load '%s' for module %s: %s, Undefined +symbols present after loading %s: %s, XSLoader::load('Your::Module', +$Your::Module::VERSION) + +=item LIMITATIONS + +=item BUGS + +=item SEE ALSO + +=item AUTHORS + +=item COPYRIGHT + +=back + +=head2 Encode - character encodings + +=over 4 + +=item SYNOPSIS + +=over 4 + +=item Table of Contents + +=back + +=item DESCRIPTION + +=over 4 + +=item TERMINOLOGY + +=back + +=item PERL ENCODING API + +$octets = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING, +$octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [, +CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [, +CHECK]); + +=over 4 + +=item Listing available encodings + +=item Defining Aliases + +=back + +=item Encoding via PerlIO + +=item Handling Malformed Data + +B 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 + +=over 4 + +=item coderef for CHECK + +=back + +=item Defining Encodings + +=item The UTF-8 flag + +Goal #1:, Goal #2:, Goal #3:, Goal #4: + +=over 4 + +=item Messing with Perl's Internals + +is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING) + +=back + +=item UTF-8 vs. utf8 + +=item SEE ALSO + +=item MAINTAINER + +=item COPYRIGHT + +=back + +=head2 Encode::Alias - alias definitions to encodings + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +As a simple string, As a qr// compiled regular expression, e.g.:, As a code +reference, e.g.: + +=over 4 + +=item Alias overloading + +=back + +=item SEE ALSO + +=back + +=head2 Encode::Byte - Single Byte Encodings + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +=item DESCRIPTION + +=item SEE ALSO + +=back + +=head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_* + +=head2 Encode::CN - China-based Chinese Encodings + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item NOTES + +=item BUGS + +=item SEE ALSO + +=back + +=head2 Encode::CN::HZ -- internally used by Encode::CN + +=head2 Encode::Config -- internally used by Encode + +=head2 Encode::EBCDIC - EBCDIC Encodings + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +=item DESCRIPTION + +=item SEE ALSO + +=back + +=head2 Encode::Encoding - Encode Implementation Base Class + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Methods you should implement + +-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 Dumping a large array or hash +=item SYNOPSIS -=item A reference to an SV which holds a C pointer +=item ABSTRACT -=item A reference to a subroutine +=item DESCRIPTION + +=item SEE ALSO =back -=item EXPORTS +=head2 Encode::TW - Taiwan-based Chinese Encodings + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item NOTES =item BUGS -=item AUTHOR +=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 Devel::SelfStubber - generate stubs for a SelfLoading module +=head2 Encode::Unicode::UTF7 -- UTF-7 encoding =over 4 =item SYNOPSIS -=item DESCRIPTION +=item ABSTRACT + +=item In Practice + +=item SEE ALSO =back -=head2 Digest - Modules that calculate message digests +=head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to +encodings =over 4 @@ -15046,25 +16586,30 @@ perl 5.005_03, perl 5.005, perl 5.004_05, perl 5.004 =item DESCRIPTION -I, I, I +As a simple string, As a qr// compiled regular expression, e.g.:, As a code +reference, e.g.: -=item OO INTERFACE +=over 4 -$ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx = -Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset, -$ctx->add( $data, ... ), $ctx->addfile( $io_handle ), $ctx->add_bits( -$data, $nbits ), $ctx->add_bits( $bitstring ), $ctx->digest, -$ctx->hexdigest, $ctx->b64digest +=item Alias overloading -=item Digest speed +=back =item SEE ALSO -=item AUTHOR - =back -=head2 Digest::MD5 - Perl interface to the MD5 Algorithm +=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 @@ -15072,288 +16617,323 @@ $ctx->hexdigest, $ctx->b64digest =item DESCRIPTION -=item FUNCTIONS +=over 4 -md5($data,...), md5_hex($data,...), md5_base64($data,...) +=item Methods you should implement -=item METHODS +-Eencode($string [,$check]), -Edecode($octets [,$check]), +-Ecat_decode($destination, $octets, $offset, $terminator [,$check]) -$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 Other methods defined in Encode::Encodings -=item EXAMPLES +-Ename, -Erenew, -Erenewed, -Eperlio_ok(), +-Eneeds_lines() -=item SEE ALSO +=item Example: Encode::ROT13 -=item COPYRIGHT +=back -=item AUTHORS +=item Why the heck Encode API is different? + +=over 4 + +=item Compiled Encodings =back -=head2 Digest::SHA - Perl extension for SHA-1/224/256/384/512 +=item SEE ALSO -=over 4 +Scheme 1, Scheme 2, Other Schemes -=item SYNOPSIS (SHA) +=back -=item SYNOPSIS (HMAC-SHA) +=head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from +data + +=over 4 + +=item SYNOPSIS =item ABSTRACT =item DESCRIPTION -=item NIST STATEMENT ON SHA-1 - -=item EXPORT +Encode::Guess->set_suspects, Encode::Guess->add_suspects, +Encode::decode("Guess" ...), Encode::Guess->guess($data), +guess_encoding($data, [, I]) -=item EXPORTABLE FUNCTIONS +=item CAVEATS -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 TO DO =item SEE ALSO -=item AUTHOR +=back -=item ACKNOWLEDGMENTS +=head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by +Encode::JP::2022_JP* -=item COPYRIGHT AND LICENSE +=head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used +by Encode::JP -=back +=head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally +used by Encode::KR -=head2 Digest::base - Digest base class +=head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B' +and 'Q' header encoding =over 4 =item SYNOPSIS +=item ABSTRACT + =item DESCRIPTION +=item BUGS + =item SEE ALSO =back -=head2 Digest::file - Calculate digests of files +=head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document +on Encode and PerlIO =over 4 -=item SYNOPSIS +=item Overview -=item DESCRIPTION +=item How does it work? -digest_file( $file, $algorithm, [$arg,...] ), digest_file_hex( $file, -$algorithm, [$arg,...] ), digest_file_base64( $file, $algorithm, [$arg,...] -) +=item Line Buffering + +=over 4 + +=item How can I tell whether my encoding fully supports PerlIO ? + +=back =item SEE ALSO =back -=head2 DirHandle - supply object methods for directory handles +=head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings +supported by Encode =over 4 -=item SYNOPSIS - =item DESCRIPTION -=item NOTES +=over 4 + +=item Encoding Names =back -=head2 Dumpvalue - provides screen dump of Perl data. +=item Supported Encodings =over 4 -=item SYNOPSIS +=item Built-in Encodings -=item DESCRIPTION +=item Encode::Unicode -- other Unicode encodings -=over 4 +=item Encode::Byte -- Extended ASCII -=item Creation +ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for +the Cyrillic world, gsm0338 - Hentai Latin 1 -C, C, C, C, C, -C, C, C, C, C, -C, C, unctrl, subdump, bareStringify, quoteHighBit, -stopDbSignal +=item CJK: Chinese, Japanese, Korean (Multibyte) -=item Methods +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 -dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl, -compactDump, veryCompact, set, get +=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 -=head2 DynaLoader - Dynamically load C libraries into Perl code +=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 SYNOPSIS +=item Other Notable Sites -=item DESCRIPTION +czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org: +"Introduction to i18n" -@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 Offline sources -=item AUTHOR +C by Ken Lunde =back -=head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into -Perl code +=back -=over 4 +=head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7 +encoding -=item VERSION +=over 4 =item SYNOPSIS -=item DESCRIPTION - -=over 4 +=item ABSTRACT -=item Migration from C +=item In Practice -=item Backward compatible boilerplate +=item SEE ALSO =back -=item Order of initialization: early load() +=head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder =over 4 -=item The most hairy case +=item SYNOPSIS -=back +=item ABSTRACT -=item DIAGNOSTICS +=item Description -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) +=over 4 -=item LIMITATIONS +=item Predefined Methods -=item BUGS +$e = Encode::Encoder-Enew([$data, $encoding]);, encoder(), +$e-Edata([$data]), $e-Eencoding([$encoding]), +$e-Ebytes([$encoding]) -=item SEE ALSO +=item Example: base64 transcoder -=item AUTHORS +=item Operator Overloading -=item COPYRIGHT +=back + +=item SEE ALSO =back -=head2 Encode - character encodings +=head2 Encodencoding, encoding - allows you to write your script in +non-ascii or non-utf8 =over 4 =item SYNOPSIS +=item ABSTRACT + =over 4 -=item Table of Contents +=item Literal Conversions -=back +=item PerlIO layers for C -=item DESCRIPTION +=item Implicit upgrading for byte strings -=over 4 +=back -=item TERMINOLOGY +=item FEATURES THAT REQUIRE 5.8.1 -=back +"NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle -=item PERL ENCODING API +=item USAGE -$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]); +use encoding [I] ;, use encoding I [ STDIN =E +I ...] ;, use encoding I Filter=E1;, no encoding; -=over 4 +=item The Filter Option -=item Listing available encodings +=over 4 -=item Defining Aliases +=item Filter-related changes at Encode version 1.87 =back -=item Encoding via PerlIO +=item CAVEATS -=item Handling Malformed Data +=over 4 -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 NOT SCOPED -=over 4 +=item DO NOT MIX MULTIPLE ENCODINGS -=item coderef for CHECK +=item tr/// with ranges + +Legend of characters above =back -=item Defining Encodings +=item EXAMPLE - Greekperl -=item The UTF-8 flag +=item KNOWN PROBLEMS -Goal #1:, Goal #2:, Goal #3:, Goal #4: +literals in regex that are longer than 127 bytes, EBCDIC, format =over 4 -=item Messing with Perl's Internals - -is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING) +=item The Logic of :locale =back -=item UTF-8 vs. utf8 +=item HISTORY =item SEE ALSO -=item MAINTAINER - =back -=head2 Encode::Alias - alias definitions to encodings +=head2 Encoder, Encode::Encoder -- Object Oriented Encoder =over 4 =item SYNOPSIS -=item DESCRIPTION +=item ABSTRACT -As a simple string, As a qr// compiled regular expression, e.g.:, As a code -reference, e.g.: +=item Description =over 4 -=item Alias overloading +=item Predefined Methods + +$e = Encode::Encoder-Enew([$data, $encoding]);, encoder(), +$e-Edata([$data]), $e-Eencoding([$encoding]), +$e-Ebytes([$encoding]) + +=item Example: base64 transcoder + +=item Operator Overloading =back @@ -15361,23 +16941,21 @@ reference, e.g.: =back -=head2 Encode::Byte - Single Byte Encodings +=head2 English - use nice English (or awk) names for ugly punctuation +variables =over 4 =item SYNOPSIS -=item ABSTRACT - =item DESCRIPTION -=item SEE ALSO +=item PERFORMANCE =back -=head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_* - -=head2 Encode::CN - China-based Chinese Encodings +=head2 Env - perl module that imports environment variables as scalars or +arrays =over 4 @@ -15385,33 +16963,29 @@ reference, e.g.: =item DESCRIPTION -=item NOTES - -=item BUGS +=item LIMITATIONS -=item SEE ALSO +=item AUTHOR =back -=head2 Encode::CN::HZ -- internally used by Encode::CN - -=head2 Encode::Config -- internally used by Encode - -=head2 Encode::EBCDIC - EBCDIC Encodings +=head2 Errno - System errno constants =over 4 =item SYNOPSIS -=item ABSTRACT - =item DESCRIPTION -=item SEE ALSO +=item CAVEATS + +=item AUTHOR + +=item COPYRIGHT =back -=head2 Encode::Encoding - Encode Implementation Base Class +=head2 Exporter - Implements default import method for modules =over 4 @@ -15421,229 +16995,263 @@ reference, e.g.: =over 4 -=item Methods you should implement - --Eencode($string [,$check]), -Edecode($octets [,$check]), --Ecat_decode($destination, $octets, $offset, $terminator [,$check]) +=item How to Export -=item Other methods defined in Encode::Encodings +=item Selecting What To Export --Ename, -Erenew, -Erenewed, -Eperlio_ok(), --Eneeds_lines() +=item How to Import -=item Example: Encode::ROT13 +C, C, C =back -=item Why the heck Encode API is different? +=item Advanced features =over 4 -=item Compiled Encodings +=item Specialised Import Lists -=back +=item Exporting without using Exporter's import method -=item SEE ALSO +=item Exporting without inheriting from Exporter -Scheme 1, Scheme 2, Other Schemes +=item Module Version Checking + +=item Managing Unknown Symbols + +=item Tag Handling Utility Functions + +=item Generating combined tags + +=item Ced Constants =back -=head2 Encode::Guess -- Guesses encoding from data +=back + +=head2 Exporter::Heavy - Exporter guts =over 4 =item SYNOPSIS -=item ABSTRACT +=item DESCRIPTION + +=back + +=head2 ExtUtils::CBuilder - Compile and link C code for Perl modules + +=over 4 + +=item SYNOPSIS =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 +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 Encode::JP - Japanese Encodings +=head2 ExtUtils::CBuilder::Platform::Windows - Builder class for Windows +platforms =over 4 -=item SYNOPSIS +=item DESCRIPTION -=item ABSTRACT +=item AUTHOR -=item DESCRIPTION +=item SEE ALSO -=item Note on ISO-2022-JP(-1)? +=back -=item BUGS +=head2 ExtUtils::Command - utilities to replace common UNIX commands in +Makefiles etc. -=item SEE ALSO +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION =back -=head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP* +cat -=head2 Encode::JP::JIS7 -- internally used by Encode::JP +eqtime -=head2 Encode::KR - Korean Encodings +rm_rf -=over 4 +rm_f + +touch + +mv + +cp + +chmod + +mkpath + +test_f -=item SYNOPSIS +dos2unix -=item DESCRIPTION +=over 4 -=item BUGS +=item SEE ALSO -=item SEE ALSO +=item AUTHOR =back -=head2 Encode::KR::2022_KR -- internally used by Encode::KR - -=head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding +=head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles =over 4 =item SYNOPSIS -=item ABSTRACT - =item DESCRIPTION -=item BUGS - -=item SEE ALSO +B =back -=head2 Encode::PerlIO -- a detailed document on Encode and PerlIO +B -=over 4 +B -=item Overview +B -=item How does it work? +B -=item Line Buffering +=head2 ExtUtils::Constant - generate XS code to import C header constants =over 4 -=item How can I tell whether my encoding fully supports PerlIO ? +=item SYNOPSIS -=back +=item DESCRIPTION -=item SEE ALSO +=item USAGE + +IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF + +=item FUNCTIONS =back -=head2 Encode::Supported -- Encodings supported by Encode +constant_types -=over 4 +XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME -=item DESCRIPTION +autoload PACKAGE, VERSION, AUTOLOADER + +WriteMakefileSnippet + +WriteConstants ATTRIBUTE =E VALUE [, ...], NAME, DEFAULT_TYPE, +BREAKOUT_AT, NAMES, C_FH, C_FILE, XS_FH, XS_FILE, SUBNAME, C_SUBNAME =over 4 -=item Encoding Names +=item AUTHOR =back -=item Supported Encodings +=head2 ExtUtils::Constant::Base - base class for ExtUtils::Constant objects =over 4 -=item Built-in Encodings +=item SYNOPSIS -=item Encode::Unicode -- other Unicode encodings +=item DESCRIPTION -=item Encode::Byte -- Extended ASCII +=item USAGE -ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for -the Cyrillic world, gsm0338 - Hentai Latin 1 +=back -=item CJK: Chinese, Japanese, Korean (Multibyte) +header -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 +memEQ_clause args_hashref -=item Miscellaneous encodings +dump_names arg_hashref, ITEM.. -Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess +assign arg_hashref, VALUE.. -=back +return_clause arg_hashref, ITEM -=item Unsupported encodings +switch_clause arg_hashref, NAMELEN, ITEMHASH, ITEM.. - 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 +params WHAT -=item Encoding vs. Charset -- terminology +dogfood arg_hashref, ITEM.. -=item Encoding Classification (by Anton Tagunov and Dan Kogai) +normalise_items args, default_type, seen_types, seen_items, ITEM.. + +C_constant arg_hashref, ITEM.., name, type, value, macro, default, pre, +post, def_pre, def_post, utf8, weight =over 4 -=item Microsoft-related naming mess +=item BUGS -KS_C_5601-1987, GB2312, Big5, Shift_JIS +=item AUTHOR =back -=item Glossary - -character repertoire, coded character set (CCS), character encoding scheme -(CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF, -UTF-16 +=head2 ExtUtils::Constant::Utils - helper functions for ExtUtils::Constant -=item See Also +=over 4 -=item References +=item SYNOPSIS -ECMA, ECMA-035 (eq C), IANA, Assigned Charset Names by IANA, ISO, -RFC, UC, Unicode Glossary +=item DESCRIPTION -=over 4 +=item USAGE -=item Other Notable Sites +C_stringify NAME -czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org: -"Introduction to i18n" +=back -=item Offline sources +perl_stringify NAME -C by Ken Lunde +=over 4 -=back +=item AUTHOR =back -=head2 Encode::Symbol - Symbol Encodings +=head2 ExtUtils::Constant::XS, ExtUtils::Constant::Base - base class for +ExtUtils::Constant objects =over 4 =item SYNOPSIS -=item ABSTRACT - =item DESCRIPTION -=item SEE ALSO +=item BUGS + +=item AUTHOR =back -=head2 Encode::TW - Taiwan-based Chinese Encodings +=head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications =over 4 @@ -15651,91 +17259,93 @@ C by Ken Lunde =item DESCRIPTION -=item NOTES +=item @EXPORT -=item BUGS +=item FUNCTIONS + +xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(), +ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules) + +=item EXAMPLES =item SEE ALSO +=item AUTHOR + =back -=head2 Encode::Unicode -- Various Unicode Transformation Formats +=head2 ExtUtils::Install - install files from here to there =over 4 =item SYNOPSIS -=item ABSTRACT +=item DESCRIPTION -L says:, Quick Reference +_chmod($$;$), _warnonce(@), _choke(@) -=item Size, Endianness, and BOM +=back -=over 4 +_move_file_at_boot( $file, $target, $moan ) -=item by size +_unlink_or_rename( $file, $tryhard, $installing ) -=item by endianness +=over 4 -BOM as integer when fetched in network byte order +=item Functions -=back +B -=item Surrogate Pairs +=back -=item Error Checking +_get_install_skip -=item SEE ALSO +_have_write_access -=back +_can_write_dir(C<$dir>) -=head2 Encode::Unicode::UTF7 -- UTF-7 encoding +_mkpath($dir,$show,$mode,$verbose,$fake) -=over 4 +_copy($from,$to,$verbose,$fake) -=item SYNOPSIS +_chdir($from) -=item ABSTRACT +_do_cleanup -=item In Practice +install_rooted_file( $file ), install_rooted_dir( $dir ) -=item SEE ALSO +forceunlink( $file, $tryhard ) -=back +directory_not_empty( $dir ) -=head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to -encodings +B I -=over 4 +B -=item SYNOPSIS +inc_uninstall($filepath,$libdir,$verbose,$nonono,$ignore) -=item DESCRIPTION +run_filter($cmd,$src,$dest) -As a simple string, As a qr// compiled regular expression, e.g.:, As a code -reference, e.g.: +B -=over 4 +_autosplit -=item Alias overloading +_invokant -=back +=over 4 -=item SEE ALSO +=item ENVIRONMENT -=back +B, B, +B -=head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm -- -Internally used by Encode::??::ISO_2022_* +=item AUTHOR -=head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by -Encode::CN +=item LICENSE -=head2 Encode::lib::Encode::Config, Encode::Config -- internally used by -Encode +=back -=head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode -Implementation Base Class +=head2 ExtUtils::Installed - Inventory management of installed modules =over 4 @@ -15743,332 +17353,307 @@ Implementation Base Class =item DESCRIPTION -=over 4 - -=item Methods you should implement +=item USAGE --Eencode($string [,$check]), -Edecode($octets [,$check]), --Ecat_decode($destination, $octets, $offset, $terminator [,$check]) +=item FUNCTIONS -=item Other methods defined in Encode::Encodings +new(), modules(), files(), directories(), directory_tree(), validate(), +packlist(), version() --Ename, -Erenew, -Erenewed, -Eperlio_ok(), --Eneeds_lines() +=item EXAMPLE -=item Example: Encode::ROT13 +=item AUTHOR =back -=item Why the heck Encode API is different? +=head2 ExtUtils::Liblist - determine libraries to use and how to use them =over 4 -=item Compiled Encodings +=item SYNOPSIS -=back +=item DESCRIPTION -=item SEE ALSO +For static extensions, For dynamic extensions at build/link time, For +dynamic extensions at load time -Scheme 1, Scheme 2, Other Schemes +=over 4 -=back +=item EXTRALIBS -=head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from -data +=item LDLOADLIBS and LD_RUN_PATH -=over 4 +=item BSLOADLIBS -=item SYNOPSIS +=back -=item ABSTRACT +=item PORTABILITY -=item DESCRIPTION +=over 4 -Encode::Guess->set_suspects, Encode::Guess->add_suspects, -Encode::decode("Guess" ...), Encode::Guess->guess($data), -guess_encoding($data, [, I]) +=item VMS implementation -=item CAVEATS +=item Win32 implementation -=item TO DO +=back =item SEE ALSO =back -=head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by -Encode::JP::2022_JP* - -=head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used -by Encode::JP - -=head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally -used by Encode::KR - -=head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B' -and 'Q' header encoding - +=head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass + =over 4 =item SYNOPSIS -=item ABSTRACT - =item DESCRIPTION -=item BUGS - -=item SEE ALSO - =back -=head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document -on Encode and PerlIO +=head2 ExtUtils::MM_AIX - AIX specific subclass of ExtUtils::MM_Unix =over 4 -=item Overview - -=item How does it work? +=item SYNOPSIS -=item Line Buffering +=item DESCRIPTION =over 4 -=item How can I tell whether my encoding fully supports PerlIO ? +=item Overridden methods + +=back =back +=over 4 + +=item AUTHOR + =item SEE ALSO =back -=head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings -supported by Encode +=head2 ExtUtils::MM_Any - Platform-agnostic MM methods =over 4 +=item SYNOPSIS + =item DESCRIPTION +=item METHODS + =over 4 -=item Encoding Names +=item Cross-platform helper methods =back -=item Supported Encodings +=back =over 4 -=item Built-in Encodings - -=item Encode::Unicode -- other Unicode encodings +=item Targets -=item Encode::Byte -- Extended ASCII +=back -ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for -the Cyrillic world, gsm0338 - Hentai Latin 1 +=over 4 -=item CJK: Chinese, Japanese, Korean (Multibyte) +=item Init methods -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 +=back -=item Miscellaneous encodings +=over 4 -Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess +=item Tools =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 +=over 4 -=item Encoding vs. Charset -- terminology +=item File::Spec wrappers -=item Encoding Classification (by Anton Tagunov and Dan Kogai) +=back =over 4 -=item Microsoft-related naming mess - -KS_C_5601-1987, GB2312, Big5, Shift_JIS +=item Misc =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 +=over 4 -=item See Also +=item AUTHOR -=item References +=back -ECMA, ECMA-035 (eq C), IANA, Assigned Charset Names by IANA, ISO, -RFC, UC, Unicode Glossary +=head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in +ExtUtils::MakeMaker =over 4 -=item Other Notable Sites - -czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org: -"Introduction to i18n" - -=item Offline sources +=item SYNOPSIS -C by Ken Lunde +=item DESCRIPTION =back -=back +os_flavor -=head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7 -encoding +init_linker + +=head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in +ExtUtils::MakeMaker =over 4 =item SYNOPSIS -=item ABSTRACT - -=item In Practice +=item DESCRIPTION -=item SEE ALSO +os_flavor =back -=head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder +cflags + +replace_manpage_separator + +init_linker + +=head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix =over 4 =item SYNOPSIS -=item ABSTRACT - -=item Description +=item DESCRIPTION =over 4 -=item Predefined Methods - -$e = Encode::Encoder-Enew([$data, $encoding]);, encoder(), -$e-Edata([$data]), $e-Eencoding([$encoding]), -$e-Ebytes([$encoding]) +=item Overridden methods -=item Example: base64 transcoder +os_flavor -=item Operator Overloading +=back =back +B + +=over 4 + +=item AUTHOR + =item SEE ALSO =back -=head2 Encodencoding, encoding - allows you to write your script in -non-ascii or non-utf8 +=head2 ExtUtils::MM_MacOS - once produced Makefiles for MacOS Classic =over 4 =item SYNOPSIS -=item ABSTRACT +=item DESCRIPTION -=over 4 +=back -=item Literal Conversions +=head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in +ExtUtils::MakeMaker -=item PerlIO layers for C +=over 4 -=item Implicit upgrading for byte strings +=item SYNOPSIS + +=item DESCRIPTION =back -=item FEATURES THAT REQUIRE 5.8.1 +os_flavor -"NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle +init_platform, platform_constants -=item USAGE +const_cccmd -use encoding [I] ;, use encoding I [ STDIN =E -I ...] ;, use encoding I Filter=E1;, no encoding; +static_lib -=item The Filter Option +dynamic_lib -=over 4 +=head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in +ExtUtils::MakeMaker -=item Filter-related changes at Encode version 1.87 +=over 4 -=back +=item SYNOPSIS -=item CAVEATS +=item DESCRIPTION -=over 4 +=item METHODS -=item NOT SCOPED +init_dist -=item DO NOT MIX MULTIPLE ENCODINGS +=back -=item tr/// with ranges +init_linker -Legend of characters above +os_flavor -=back +=head2 ExtUtils::MM_QNX - QNX specific subclass of ExtUtils::MM_Unix -=item EXAMPLE - Greekperl +=over 4 -=item KNOWN PROBLEMS +=item SYNOPSIS -literals in regex that are longer than 127 bytes, EBCDIC, format +=item DESCRIPTION =over 4 -=item The Logic of :locale +=item Overridden methods =back -=item HISTORY +=back + +=over 4 + +=item AUTHOR =item SEE ALSO =back -=head2 Encoder, Encode::Encoder -- Object Oriented Encoder +=head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix =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 Overridden methods -=item Example: base64 transcoder +os_flavor -=item Operator Overloading +=back =back +B + +=over 4 + +=item AUTHOR + =item SEE ALSO =back -=head2 English - use nice English (or awk) names for ugly punctuation -variables +=head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker =over 4 @@ -16076,331 +17661,324 @@ variables =item DESCRIPTION -=item PERFORMANCE +=item METHODS =back -=head2 Env - perl module that imports environment variables as scalars or -arrays - =over 4 -=item SYNOPSIS +=item Methods -=item DESCRIPTION +os_flavor -=item LIMITATIONS +=back -=item AUTHOR +c_o (o) -=back +cflags (o) -=head2 Errno - System errno constants +const_cccmd (o) -=over 4 +const_config (o) -=item SYNOPSIS +const_loadlibs (o) -=item DESCRIPTION +constants (o) -=item CAVEATS +depend (o) -=item AUTHOR +init_DEST -=item COPYRIGHT +init_dist -=back +dist (o) -=head2 Exporter - Implements default import method for modules +dist_basics (o) + +dist_ci (o) -=over 4 +dist_core (o) -=item SYNOPSIS +B -=item DESCRIPTION +B -=over 4 +B -=item How to Export +B -=item Selecting What To Export +zipfile_target -=item How to Import +uutardist_target -C, C, C +shdist_target -=back +dlsyms (o) -=item Advanced features +dynamic_bs (o) -=over 4 +dynamic_lib (o) -=item Specialised Import Lists +exescan -=item Exporting without using Exporter's import method +extliblist -=item Exporting without inheriting from Exporter +find_perl -=item Module Version Checking +fixin -=item Managing Unknown Symbols +force (o) -=item Tag Handling Utility Functions +guess_name -=item Generating combined tags +has_link_code -=item Ced Constants +init_dirscan -=back +init_MANPODS -=back +init_MAN1PODS -=head2 Exporter::Heavy - Exporter guts +init_MAN3PODS -=over 4 +init_PM -=item SYNOPSIS +init_DIRFILESEP -=item DESCRIPTION +init_main -=back +init_others -=head2 ExtUtils::CBuilder - Compile and link C code for Perl modules +init_linker -=over 4 +init_lib2arch -=item SYNOPSIS +init_PERL -=item DESCRIPTION +init_platform, platform_constants -=item METHODS +init_PERM -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 +init_xs -=item TO DO +install (o) -=item HISTORY +installbin (o) -=item AUTHOR +linkext (o) -=item COPYRIGHT +lsdir -=item SEE ALSO +macro (o) -=back +makeaperl (o) -=head2 ExtUtils::CBuilder::Platform::Windows - Builder class for Windows -platforms +makefile (o) -=over 4 +maybe_command -=item DESCRIPTION +needs_linking (o) -=item AUTHOR +nicetext -=item SEE ALSO +parse_abstract -=back +parse_version -=head2 ExtUtils::Command - utilities to replace common UNIX commands in -Makefiles etc. +pasthru (o) -=over 4 +perl_script -=item SYNOPSIS +perldepend (o) -=item DESCRIPTION +perm_rw (o) -=back +perm_rwx (o) -cat +pm_to_blib -eqtime +post_constants (o) -rm_rf +post_initialize (o) -rm_f +postamble (o) -touch +ppd -mv +prefixify -cp +processPL (o) -chmod +quote_paren -mkpath +replace_manpage_separator -test_f +cd -dos2unix +oneliner -=over 4 +quote_literal -=item SEE ALSO +escape_newlines -=item AUTHOR +max_exec_len -=back +static (o) -=head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles +static_lib (o) -=over 4 +staticmake (o) -=item SYNOPSIS +subdir_x (o) -=item DESCRIPTION +subdirs (o) -B +test (o) -=back +test_via_harness (override) -B +test_via_script (override) -B +tools_other (o) -B +tool_xsubpp (o) -B +all_target -=head2 ExtUtils::Constant - generate XS code to import C header constants +top_targets (o) -=over 4 +writedoc -=item SYNOPSIS +xs_c (o) -=item DESCRIPTION +xs_cpp (o) -=item USAGE +xs_o (o) -IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF +=over 4 -=item FUNCTIONS +=item SEE ALSO =back -constant_types - -XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME +=head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in +ExtUtils::MakeMaker -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 AUTHOR +=item Methods always loaded + +wraplist =back -=head2 ExtUtils::Constant::Base - base class for ExtUtils::Constant objects +=back =over 4 -=item SYNOPSIS - -=item DESCRIPTION +=item Methods -=item USAGE +guess_name (override) =back -header +find_perl (override) -memEQ_clause args_hashref +maybe_command (override) -dump_names arg_hashref, ITEM.. +pasthru (override) -assign arg_hashref, VALUE.. +pm_to_blib (override) -return_clause arg_hashref, ITEM +perl_script (override) -switch_clause arg_hashref, NAMELEN, ITEMHASH, ITEM.. +replace_manpage_separator -params WHAT +init_DEST -dogfood arg_hashref, ITEM.. +init_DIRFILESEP -normalise_items args, default_type, seen_types, seen_items, ITEM.. +init_main (override) -C_constant arg_hashref, ITEM.., name, type, value, macro, default, pre, -post, def_pre, def_post, utf8, weight +init_others (override) -=over 4 +init_platform (override) -=item BUGS +platform_constants -=item AUTHOR +init_VERSION (override) -=back +constants (override) -=head2 ExtUtils::Constant::Utils - helper functions for ExtUtils::Constant +special_targets -=over 4 +cflags (override) -=item SYNOPSIS +const_cccmd (override) -=item DESCRIPTION +tools_other (override) -=item USAGE +init_dist (override) -C_stringify NAME +c_o (override) -=back +xs_c (override) -perl_stringify NAME +xs_o (override) -=over 4 +dlsyms (override) -=item AUTHOR +dynamic_lib (override) -=back +static_lib (override) -=head2 ExtUtils::Constant::XS, ExtUtils::Constant::Base - base class for -ExtUtils::Constant objects +extra_clean_files -=over 4 +zipfile_target, tarfile_target, shdist_target -=item SYNOPSIS +install (override) -=item DESCRIPTION +perldepend (override) -=item BUGS +makeaperl (override) -=item AUTHOR +nicetext (override) + +prefixify (override) + +cd -=back +oneliner -=head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications +B -=over 4 +quote_literal -=item SYNOPSIS +escape_newlines -=item DESCRIPTION +max_exec_len -=item @EXPORT +init_linker -=item FUNCTIONS +eliminate_macros -xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(), -ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules) +fixpath -=item EXAMPLES +os_flavor -=item SEE ALSO +=over 4 =item AUTHOR =back -=head2 ExtUtils::Install - install files from here to there +=head2 ExtUtils::MM_VOS - VOS specific subclass of ExtUtils::MM_Unix =over 4 @@ -16410,35 +17988,22 @@ ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules) =over 4 -=item Functions - -B +=item Overridden methods =back =back -B I - -B - -B - -_autosplit - =over 4 -=item ENVIRONMENT - -B - =item AUTHOR -=item LICENSE +=item SEE ALSO =back -=head2 ExtUtils::Installed - Inventory management of installed modules +=head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in +ExtUtils::MakeMaker =over 4 @@ -16446,65 +18011,51 @@ B =item DESCRIPTION -=item USAGE - -=item FUNCTIONS - -new(), modules(), files(), directories(), directory_tree(), validate(), -packlist(), version() - -=item EXAMPLE - -=item AUTHOR - =back -=head2 ExtUtils::Liblist - determine libraries to use and how to use them - =over 4 -=item SYNOPSIS +=item Overridden methods -=item DESCRIPTION +B -For static extensions, For dynamic extensions at build/link time, For -dynamic extensions at load time +=back -=over 4 +replace_manpage_separator -=item EXTRALIBS +B -=item LDLOADLIBS and LD_RUN_PATH +B -=item BSLOADLIBS +B -=back +init_platform, platform_constants -=item PORTABILITY +special_targets -=over 4 +static_lib -=item VMS implementation +dynamic_lib -=item Win32 implementation +extra_clean_files -=back +init_linker -=item SEE ALSO +perl_script -=back +xs_o -=head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass +pasthru -=over 4 +oneliner -=item SYNOPSIS +cd -=item DESCRIPTION +max_exec_len -=back +os_flavor -=head2 ExtUtils::MM_AIX - AIX specific subclass of ExtUtils::MM_Unix +=head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X =over 4 @@ -16516,19 +18067,27 @@ dynamic extensions at load time =item Overridden methods +xs_c + =back =back +xs_cpp + +xs_o + +max_exec_len + +os_flavor + =over 4 =item AUTHOR -=item SEE ALSO - =back -=head2 ExtUtils::MM_Any - Platform-agnostic MM methods +=head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization =over 4 @@ -16536,147 +18095,153 @@ dynamic extensions at load time =item DESCRIPTION -=item METHODS - -=over 4 - -=item Cross-platform helper methods - =back -=back +=head2 ExtUtils::MakeMaker - Create a module Makefile =over 4 -=item Targets +=item SYNOPSIS -=back +=item DESCRIPTION =over 4 -=item Init methods - -=back - -=over 4 +=item How To Write A Makefile.PL -=item Tools +=item Default Makefile Behaviour -=back +=item make test -=over 4 +=item make testdb -=item File::Spec wrappers +=item make install -=back +=item PREFIX and LIB attribute -=over 4 +=item AFS users -=item Misc +=item Static Linking of a new Perl Binary -=back +=item Determination of Perl Library and Installation Locations -=over 4 +=item Which architecture dependent directory? -=item AUTHOR +=item Using Attributes and Parameters -=back +ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG, +CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS, +EXCLUDE_EXT, EXE_FILES, 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 -=head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in -ExtUtils::MakeMaker +=item Additional lowercase attributes -=over 4 +clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean, +test, tool_autosplit -=item SYNOPSIS +=item Overriding MakeMaker Methods -=item DESCRIPTION +=item The End Of Cargo Cult Programming -=back +C<< MAN3PODS => ' ' >> -os_flavor +=item Hintsfile support -init_linker +=item Distribution Support -=head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in -ExtUtils::MakeMaker + 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 SYNOPSIS +=item Disabling an extension -=item DESCRIPTION +=item Other Handy Functions -os_flavor +prompt =back -cflags +=item ENVIRONMENT -replace_manpage_separator +PERL_MM_OPT, PERL_MM_USE_DEFAULT, PERL_CORE -init_linker +=item SEE ALSO -=head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix +=item AUTHORS -=over 4 +=item LICENSE -=item SYNOPSIS +=back -=item DESCRIPTION +=head2 ExtUtils::MakeMaker::Config - Wrapper around Config.pm =over 4 -=item Overridden methods - -os_flavor +=item SYNOPSIS -=back +=item DESCRIPTION =back -B +=head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About +MakeMaker =over 4 -=item AUTHOR - -=item SEE ALSO - -=back - -=head2 ExtUtils::MM_MacOS - once produced Makefiles for MacOS Classic +=item DESCRIPTION =over 4 -=item SYNOPSIS +=item Module Installation -=item DESCRIPTION +How do I keep from installing man pages?, How do I use a module without +installing it? -=back +=item Philosophy and History -=head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in -ExtUtils::MakeMaker +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 SYNOPSIS +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 DESCRIPTION +=item XS -=back +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? -os_flavor +=back -init_platform, platform_constants +=item PATCHING -const_cccmd +=item AUTHOR -static_lib +=item SEE ALSO -dynamic_lib +=back -=head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in -ExtUtils::MakeMaker +=head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker =over 4 @@ -16684,17 +18249,22 @@ ExtUtils::MakeMaker =item DESCRIPTION -=item METHODS +=over 4 -init_dist +=item The Mantra + +=item The Layout + +Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP, +bin/ =back -init_linker +=item SEE ALSO -os_flavor +=back -=head2 ExtUtils::MM_QNX - QNX specific subclass of ExtUtils::MM_Unix +=head2 ExtUtils::MakeMaker::bytes - Version-agnostic bytes.pm =over 4 @@ -16702,23 +18272,19 @@ os_flavor =item DESCRIPTION -=over 4 - -=item Overridden methods - =back -=back +=head2 ExtUtils::MakeMaker::vmsish - Platform-agnostic vmsish.pm =over 4 -=item AUTHOR +=item SYNOPSIS -=item SEE ALSO +=item DESCRIPTION =back -=head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix +=head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file =over 4 @@ -16728,226 +18294,236 @@ os_flavor =over 4 -=item Overridden methods +=item Functions -os_flavor +mkmanifest =back =back -B +manifind -=over 4 +manicheck -=item AUTHOR +filecheck -=item SEE ALSO +fullcheck -=back +skipcheck -=head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker +maniread + +manicopy + +maniadd =over 4 -=item SYNOPSIS +=item MANIFEST -=item DESCRIPTION +=item MANIFEST.SKIP -=item METHODS +=item EXPORT_OK + +=item GLOBAL VARIABLES =back =over 4 -=item Methods +=item DIAGNOSTICS -os_flavor +C I, C I, C I, +C I<$!>, C I -=back +=item ENVIRONMENT -c_o (o) +B -cflags (o) +=item SEE ALSO -const_cccmd (o) +=item AUTHOR -const_config (o) +=back -const_loadlibs (o) +=head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c -constants (o) +=over 4 -depend (o) +=item SYNOPSIS -init_DEST +=item DESCRIPTION -init_dist +=item SEE ALSO -dist (o) +=back -dist_basics (o) +=head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader -dist_ci (o) +=over 4 -dist_core (o) +=item SYNOPSIS -B +=item DESCRIPTION -B +=back -B +=head2 ExtUtils::Mksymlists - write linker options files for dynamic +extension -B +=over 4 -zipfile_target +=item SYNOPSIS -uutardist_target +=item DESCRIPTION -shdist_target +DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME -dlsyms (o) +=item AUTHOR -dynamic_bs (o) +=item REVISION -dynamic_lib (o) +mkfh() -exescan +=back -extliblist +__find_relocations -find_perl +=head2 ExtUtils::Packlist - manage .packlist files -fixin +=over 4 -force (o) +=item SYNOPSIS -guess_name +=item DESCRIPTION -has_link_code +=item USAGE -init_dirscan +=item FUNCTIONS -init_DIRFILESEP +new(), read(), write(), validate(), packlist_file() -init_main +=item EXAMPLE -init_others +=item AUTHOR -init_linker +=back -init_lib2arch +=head2 ExtUtils::ParseXS - converts Perl XS code into C code -init_PERL +=over 4 -init_platform, platform_constants +=item SYNOPSIS -init_PERM +=item EXPORT -init_xs +=item FUNCTIONS -install (o) +process_xs(), B, B, B, B, B, +B, B, B, B, B, B, +errors() -installbin (o) +=item AUTHOR -linkext (o) +=item COPYRIGHT -lsdir +=item SEE ALSO -macro (o) +=back -makeaperl (o) +=head2 ExtUtils::testlib - add blib/* directories to @INC -makefile (o) +=over 4 -maybe_command +=item SYNOPSIS -needs_linking (o) +=item DESCRIPTION -nicetext +=back -parse_abstract +=head2 Fatal - replace functions with equivalents which succeed or die -parse_version +=over 4 -pasthru (o) +=item SYNOPSIS -perl_script +=item DESCRIPTION -perldepend (o) +=item BUGS -perm_rw (o) +=item AUTHOR -perm_rwx (o) +=back -pm_to_blib +=head2 Fcntl - load the C Fcntl.h defines -post_constants (o) +=over 4 -post_initialize (o) +=item SYNOPSIS -postamble (o) +=item DESCRIPTION -ppd +=item NOTE -prefixify +=item EXPORTED SYMBOLS -processPL (o) +=back -quote_paren +=head2 File::Basename - Parse file paths into directory, filename and +suffix. -replace_manpage_separator +=over 4 -cd +=item SYNOPSIS -oneliner +=item DESCRIPTION -quote_literal +=back -escape_newlines +C -max_exec_len +C -static (o) +C -static_lib (o) +C -staticmake (o) +=over 4 -subdir_x (o) +=item SEE ALSO -subdirs (o) +=back -test (o) +=head2 File::CheckTree, validate - run many filetest checks on a tree -test_via_harness (override) +=over 4 -test_via_script (override) +=item SYNOPSIS -tools_other (o) +=item DESCRIPTION -tool_xsubpp (o) +=item AUTHOR -all_target +=item HISTORY -top_targets (o) +=back -writedoc +=head2 File::Compare - Compare files or filehandles -xs_c (o) +=over 4 -xs_cpp (o) +=item SYNOPSIS -xs_o (o) +=item DESCRIPTION -=over 4 +=item RETURN -=item SEE ALSO +=item AUTHOR =back -=head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in -ExtUtils::MakeMaker +=head2 File::Copy - Copy files or filehandles =over 4 @@ -16957,113 +18533,115 @@ ExtUtils::MakeMaker =over 4 -=item Methods always loaded - -wraplist +=item Special behaviour if C is defined (OS/2, VMS and Win32) -=back +rmscopy($from,$to[,$date_flag]) =back -=over 4 +=item RETURN -=item Methods +=item NOTES -guess_name (override) +=item AUTHOR =back -find_perl (override) - -maybe_command (override) +=head2 File::DosGlob - DOS like globbing and then some -pasthru (override) +=over 4 -pm_to_blib (override) +=item SYNOPSIS -perl_script (override) +=item DESCRIPTION -replace_manpage_separator +=item NOTES -init_DEST +=item EXPORTS (by request only) -init_DIRFILESEP +=item BUGS -init_main (override) +=item AUTHOR -init_others (override) +=item HISTORY -init_platform (override) +=item SEE ALSO -platform_constants +=back -init_VERSION (override) +=head2 File::Find - Traverse a directory tree. -constants (override) +=over 4 -special_targets +=item SYNOPSIS -cflags (override) +=item DESCRIPTION -const_cccmd (override) +B, B -tools_other (override) +=over 4 -init_dist (override) +=item %options -c_o (override) +C, C, C, C, C, +C, C, C, C, +C, C, C -xs_c (override) +=item The wanted function -xs_o (override) +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 -dlsyms (override) +=back -dynamic_lib (override) +=item WARNINGS -static_lib (override) +=item CAVEAT -extra_clean_files +$dont_use_nlink, symlinks -zipfile_target, tarfile_target, shdist_target +=item NOTES -install (override) +=item BUGS AND CAVEATS -perldepend (override) +=item HISTORY -makeaperl (override) +=back -nicetext (override) +=head2 File::Glob - Perl extension for BSD glob routine -prefixify (override) +=over 4 -cd +=item SYNOPSIS -oneliner +=item DESCRIPTION -B +=over 4 -quote_literal +=item META CHARACTERS -escape_newlines +=item POSIX FLAGS -max_exec_len +C, C, C, C, C, +C, C, C, C, +C, C, C -init_linker +=back -eliminate_macros +=item DIAGNOSTICS -fixpath +C, C -os_flavor +=item NOTES -=over 4 +=item SEE ALSO =item AUTHOR =back -=head2 ExtUtils::MM_VOS - VOS specific subclass of ExtUtils::MM_Unix +=head2 File::GlobMapper - Extend File Glob to Allow Input and Output Files =over 4 @@ -17071,76 +18649,83 @@ os_flavor =item DESCRIPTION +This code is a work in progress, There are known bugs, The interface +defined here is tentative, There are portability issues, Do not use in +production code, Consider yourself warned! + =over 4 -=item Overridden methods +=item Behind The Scenes -=back +=item Limitations -=back +=item Input File Glob -=over 4 +B<~>, B<~user>, B<.>, B<*>, B, B<\>, B<[]>, B<{,}>, B<()> -=item AUTHOR +=item Output File Glob -=item SEE ALSO +"*", #1 + +=item Returned Data =back -=head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in -ExtUtils::MakeMaker +=item EXAMPLES =over 4 -=item SYNOPSIS +=item A Rename script -=item DESCRIPTION +=item A few example globmaps =back -=over 4 +=item SEE ALSO -=item Overridden methods +=item AUTHOR -B +=item COPYRIGHT AND LICENSE =back -replace_manpage_separator +=head2 File::Path - create or remove directory trees -B +=over 4 -B +=item SYNOPSIS -B +=item DESCRIPTION -init_platform, platform_constants +=item DIAGNOSTICS -special_targets +=item AUTHORS -static_lib +=back -dynamic_lib +=head2 File::Spec - portably perform operations on file names -extra_clean_files +=over 4 -init_linker +=item SYNOPSIS -perl_script +=item DESCRIPTION -xs_o +=item METHODS -pasthru +canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir, +no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath, +splitdir, catpath(), abs2rel, rel2abs() -oneliner +=item SEE ALSO -cd +=item AUTHOR -max_exec_len +=item COPYRIGHT -os_flavor +=back -=head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X +=head2 File::Spec::Cygwin - methods for Cygwin file specs =over 4 @@ -17148,41 +18733,43 @@ os_flavor =item DESCRIPTION -=over 4 - -=item Overridden methods +=back -xs_c +canonpath -=back +file_name_is_absolute -=back +tmpdir (override) -xs_cpp +=over 4 -xs_o +=item COPYRIGHT -max_exec_len +=back -os_flavor +=head2 File::Spec::Epoc - methods for Epoc file specs =over 4 -=item AUTHOR +=item SYNOPSIS + +=item DESCRIPTION =back -=head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization +canonpath() =over 4 -=item SYNOPSIS +=item AUTHOR -=item DESCRIPTION +=item COPYRIGHT + +=item SEE ALSO =back -=head2 ExtUtils::MakeMaker - Create a module Makefile +=head2 File::Spec::Functions - portably perform operations on file names =over 4 @@ -17192,90 +18779,69 @@ os_flavor =over 4 -=item How To Write A Makefile.PL - -=item Default Makefile Behaviour +=item Exports -=item make test +=back -=item make testdb +=item COPYRIGHT -=item make install +=item SEE ALSO -=item PREFIX and LIB attribute +=back -=item AFS users +=head2 File::Spec::Mac - File::Spec for Mac OS (Classic) -=item Static Linking of a new Perl Binary +=over 4 -=item Determination of Perl Library and Installation Locations +=item SYNOPSIS -=item Which architecture dependent directory? +=item DESCRIPTION -=item Using Attributes and Parameters +=item METHODS -ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG, -CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS, -EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN, -FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, -INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, -INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB, -INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLSITESCRIPT, -INSTALLVENDORARCH, INSTALLVENDORBIN, INSTALLVENDORLIB, -INSTALLVENDORMAN1DIR, INSTALLVENDORMAN3DIR, INSTALLVENDORSCRIPT, -INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT, -LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS, LINKTYPE, MAKEAPERL, -MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME, -NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT, OPTIMIZE, PERL, -PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERLPREFIX, -PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX, PL_FILES, PM, PMLIBDIRS, -PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT, PREFIX, -PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT, PRINT_PREREQ, SITEPREFIX, SIGN, -SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION, VERSION_FROM, VERSION_SYM, -XS, XSOPT, XSPROTOARG, XS_VERSION +canonpath -=item Additional lowercase attributes +=back -clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean, -test, tool_autosplit +catdir() -=item Overriding MakeMaker Methods +catfile -=item The End Of Cargo Cult Programming +curdir -C<< MAN3PODS => ' ' >> +devnull -=item Hintsfile support +rootdir -=item Distribution Support +tmpdir - make distcheck, make skipcheck, make distclean, make manifest, - make distdir, make disttest, make tardist, make dist, make -uutardist, make shdist, make zipdist, make ci +updir -=item Module Meta-Data +file_name_is_absolute -=item Disabling an extension +path -=item Other Handy Functions +splitpath -prompt +splitdir -=back +catpath -=item ENVIRONMENT +abs2rel -PERL_MM_OPT, PERL_MM_USE_DEFAULT, PERL_CORE +rel2abs -=item SEE ALSO +=over 4 =item AUTHORS -=item LICENSE +=item COPYRIGHT + +=item SEE ALSO =back -=head2 ExtUtils::MakeMaker::Config - Wrapper around Config.pm +=head2 File::Spec::OS2 - methods for OS/2 file specs =over 4 @@ -17283,73 +18849,70 @@ PERL_MM_OPT, PERL_MM_USE_DEFAULT, PERL_CORE =item DESCRIPTION +tmpdir, splitpath + +=item COPYRIGHT + =back -=head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About -MakeMaker +=head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec +modules =over 4 -=item DESCRIPTION +=item SYNOPSIS -=over 4 +=item DESCRIPTION -=item Module Installation +=item METHODS -How do I keep from installing man pages?, How do I use a module without -installing it? +canonpath() -=item Philosophy and History +=back -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 +catdir() -=item Module Writing +catfile -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?! +curdir -=item XS +devnull -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? +rootdir -=back +tmpdir -=item PATCHING +updir -=item AUTHOR +no_upwards -=item SEE ALSO +case_tolerant -=back +file_name_is_absolute -=head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker +path -=over 4 +join -=item SYNOPSIS +splitpath -=item DESCRIPTION +splitdir -=over 4 +catpath() -=item The Mantra +abs2rel -=item The Layout +rel2abs() -Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP, -bin/ +=over 4 -=back +=item COPYRIGHT =item SEE ALSO =back -=head2 ExtUtils::MakeMaker::bytes - Version-agnostic bytes.pm +=head2 File::Spec::VMS - methods for VMS file specs =over 4 @@ -17357,185 +18920,203 @@ bin/ =item DESCRIPTION +canonpath (override) + =back -=head2 ExtUtils::MakeMaker::vmsish - Platform-agnostic vmsish.pm +catdir (override) -=over 4 +catfile (override) -=item SYNOPSIS +curdir (override) -=item DESCRIPTION +devnull (override) -=back +rootdir (override) -=head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file +tmpdir (override) -=over 4 +updir (override) -=item SYNOPSIS +case_tolerant (override) -=item DESCRIPTION +path (override) -=over 4 +file_name_is_absolute (override) -=item Functions +splitpath (override) -mkmanifest +splitdir (override) -=back +catpath (override) -=back +abs2rel (override) -manifind +rel2abs (override) -manicheck +=over 4 -filecheck +=item COPYRIGHT -fullcheck +=item SEE ALSO -skipcheck +=back -maniread +=head2 File::Spec::Win32 - methods for Win32 file specs -manicopy +=over 4 -maniadd +=item SYNOPSIS -=over 4 +=item DESCRIPTION -=item MANIFEST +devnull -=item MANIFEST.SKIP +=back -=item EXPORT_OK +tmpdir -=item GLOBAL VARIABLES +catfile -=back +canonpath + +splitpath + +splitdir + +catpath =over 4 -=item DIAGNOSTICS +=item Note For File::Spec::Win32 Maintainers -C I, C I, C I, -C I<$!>, C I +=back -=item ENVIRONMENT +=over 4 -B +=item COPYRIGHT =item SEE ALSO -=item AUTHOR - =back -=head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c +=head2 File::Temp - return name and handle of a temporary file safely =over 4 +=item PORTABILITY + =item SYNOPSIS =item DESCRIPTION -=item SEE ALSO - =back -=head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader - =over 4 -=item SYNOPSIS +=item OBJECT-ORIENTED INTERFACE -=item DESCRIPTION +B =back -=head2 ExtUtils::Mksymlists - write linker options files for dynamic -extension +B + +B + +B =over 4 -=item SYNOPSIS +=item FUNCTIONS -=item DESCRIPTION +B -DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME +=back -=item AUTHOR +B -=item REVISION +=over 4 + +=item MKTEMP FUNCTIONS + +B =back -=head2 ExtUtils::Packlist - manage .packlist files +B + +B + +B =over 4 -=item SYNOPSIS +=item POSIX FUNCTIONS -=item DESCRIPTION +B -=item USAGE +=back -=item FUNCTIONS +B -new(), read(), write(), validate(), packlist_file() +=over 4 -=item EXAMPLE +=item ADDITIONAL FUNCTIONS -=item AUTHOR +B =back -=head2 ExtUtils::ParseXS - converts Perl XS code into C code - =over 4 -=item SYNOPSIS +=item UTILITY FUNCTIONS -=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 +=over 4 + +=item PACKAGE VARIABLES + +B, STANDARD, MEDIUM, HIGH =back -=head2 ExtUtils::testlib - add blib/* directories to @INC +TopSystemUID + +B<$KEEP_ALL>, B<$DEBUG> =over 4 -=item SYNOPSIS +=item WARNING -=item DESCRIPTION +=over 4 -=back +=item Temporary files and NFS -=head2 Fatal - replace functions with equivalents which succeed or die +=item Forking + +=item BINMODE -=over 4 +=back -=item SYNOPSIS +=item HISTORY -=item DESCRIPTION +=item SEE ALSO =item AUTHOR =back -=head2 Fcntl - load the C Fcntl.h defines +=head2 File::stat - by-name interface to Perl's built-in stat() functions =over 4 @@ -17543,14 +19124,15 @@ errors() =item DESCRIPTION +=item BUGS + =item NOTE -=item EXPORTED SYMBOLS +=item AUTHOR =back -=head2 File::Basename - Parse file paths into directory, filename and -suffix. +=head2 FileCache - keep more files open than the system permits =over 4 @@ -17558,23 +19140,15 @@ suffix. =item DESCRIPTION -=back - -C - -C - -C - -C +cacheout EXPR, cacheout MODE, EXPR -=over 4 +=item CAVEATS -=item SEE ALSO +=item BUGS =back -=head2 File::CheckTree, validate - run many filetest checks on a tree +=head2 FileHandle - supply object methods for filehandles =over 4 @@ -17582,13 +19156,13 @@ C =item DESCRIPTION -=item AUTHOR +$fh->print, $fh->printf, $fh->getline, $fh->getlines -=item HISTORY +=item SEE ALSO =back -=head2 File::Compare - Compare files or filehandles +=head2 Filter::Simple - Simplified source filtering =over 4 @@ -17596,37 +19170,44 @@ C =item DESCRIPTION -=item RETURN +=over 4 -=item AUTHOR +=item The Problem -=back +=item A Solution -=head2 File::Copy - Copy files or filehandles +=item Disabling or changing behaviour -=over 4 +=item All-in-one interface -=item SYNOPSIS +=item Filtering only specific components of source code -=item DESCRIPTION +C<"code">, C<"code_no_comments">, C<"executable">, +C<"executable_no_comments">, C<"quotelike">, C<"string">, C<"regex">, +C<"all"> -=over 4 +=item Filtering only the code parts of source code -=item Special behaviour if C is defined (OS/2, VMS and Win32) +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. -rmscopy($from,$to[,$date_flag]) +=item Using Filter::Simple with an explicit C subroutine -=back +=item Using Filter::Simple and Exporter together -=item RETURN +=item How it works -=item NOTES +=back =item AUTHOR +=item COPYRIGHT + =back -=head2 File::DosGlob - DOS like globbing and then some +=head2 Filter::Util::Call - Perl Source Filter Utility Module =over 4 @@ -17634,61 +19215,61 @@ rmscopy($from,$to[,$date_flag]) =item DESCRIPTION -=item NOTES - -=item EXPORTS (by request only) +=over 4 -=item BUGS +=item B -=item AUTHOR +=item B -=item HISTORY +=item B -=item SEE ALSO +B<$_>, B<$status>, B and B, B =back -=head2 File::Find - Traverse a directory tree. +=item EXAMPLES =over 4 -=item SYNOPSIS +=item Example 1: A simple filter. -=item DESCRIPTION +=item Example 2: Using the context -B, B +=item Example 3: Using the context within the filter -=over 4 +=item Example 4: Using filter_del -=item %options +=back -C, C, C, C, C, -C, C, C, C, -C, C, C +=item Filter::Simple -=item The wanted function +=item AUTHOR -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 DATE =back -=item WARNINGS +=head2 FindBin - Locate directory of original perl script -=item CAVEAT +=over 4 -$dont_use_nlink, symlinks +=item SYNOPSIS -=item NOTES +=item DESCRIPTION -=item BUGS AND CAVEATS +=item EXPORTABLE VARIABLES -=item HISTORY +=item KNOWN ISSUES + +=item KNOWN BUGS + +=item AUTHORS + +=item COPYRIGHT =back -=head2 File::Glob - Perl extension for BSD glob routine +=head2 GDBM_File - Perl5 access to the gdbm library. =over 4 @@ -17696,115 +19277,123 @@ $dont_use_nlink, symlinks =item DESCRIPTION -=over 4 - -=item META CHARACTERS +=item AVAILABILITY -=item POSIX FLAGS +=item BUGS -C, C, C, C, C, -C, C, C, C, -C, C, C +=item SEE ALSO =back -=item DIAGNOSTICS - -C, C +=head2 Getopt::Long - Extended processing of command line options -=item NOTES +=over 4 -=item SEE ALSO +=item SYNOPSIS -=item AUTHOR +=item DESCRIPTION -=back +=item Command Line Options, an Introduction -=head2 File::GlobMapper - Extend File Glob to Allow Input and Output Files +=item Getting Started with Getopt::Long =over 4 -=item SYNOPSIS +=item Simple options -=item DESCRIPTION +=item A little bit less simple options -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 Mixing command line option with other arguments -=over 4 +=item Options with values -=item Behind The Scenes +=item Options with multiple values -=item Limitations +=item Options with hash values -=item Input File Glob +=item User-defined subroutines to handle options -B<~>, B<~user>, B<.>, B<*>, B, B<\>, B<[]>, B<{,}>, B<()> +=item Options with multiple names -=item Output File Glob +=item Case and abbreviations -"*", #1 +=item Summary of Option Specifications -=item Returned Data +!, +, s, i, o, f, : I [ I ], : I [ I ], : ++ [ I ] =back -=item EXAMPLES +=item Advanced Possibilities =over 4 -=item A Rename script +=item Object oriented interface -=item A few example globmaps +=item Thread Safety -=back +=item Documentation and help texts -=item SEE ALSO +=item Storing option values in a hash -=item AUTHOR +=item Bundling -=item COPYRIGHT AND LICENSE +=item The lonesome dash + +=item Argument callback =back -=head2 File::Path - create or remove directory trees +=item Configuring Getopt::Long -=over 4 +default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt, +require_order, permute, bundling (default: disabled), bundling_override +(default: disabled), ignore_case (default: enabled), ignore_case_always +(default: disabled), auto_version (default:disabled), auto_help +(default:disabled), pass_through (default: disabled), prefix, +prefix_pattern, long_prefix_pattern, debug (default: disabled) -=item SYNOPSIS +=item Exportable Methods -=item DESCRIPTION +VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage -=item DIAGNOSTICS +=item Return values and Errors -=item AUTHORS +=item Legacy + +=over 4 + +=item Default destinations + +=item Alternative option starters + +=item Configuration variables =back -=head2 File::Spec - portably perform operations on file names +=item Trouble Shooting =over 4 -=item SYNOPSIS +=item GetOptions does not return a false result when an option is not +supplied -=item DESCRIPTION +=item GetOptions does not split the command line correctly -=item METHODS +=item Undefined subroutine &main::GetOptions called -canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir, -no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath, -splitdir, catpath(), abs2rel, rel2abs() +=item How do I put a "-?" option into a Getopt::Long? -=item SEE ALSO +=back =item AUTHOR -=item COPYRIGHT +=item COPYRIGHT AND DISCLAIMER =back -=head2 File::Spec::Cygwin - methods for Cygwin file specs +=head2 Getopt::Std, getopt, getopts - Process single-character switches +with switch clustering =over 4 @@ -17812,63 +19401,66 @@ splitdir, catpath(), abs2rel, rel2abs() =item DESCRIPTION -=back - -canonpath +=item C<--help> and C<--version> -file_name_is_absolute +=back -tmpdir (override) +=head2 Hash::Util - A selection of general-utility hash subroutines =over 4 -=item COPYRIGHT - -=back +=item SYNOPSIS -=head2 File::Spec::Epoc - methods for Epoc file specs +=item DESCRIPTION =over 4 -=item SYNOPSIS +=item Restricted hashes -=item DESCRIPTION +B, B + +=back =back -canonpath() +B -=over 4 +B, B -=item AUTHOR +B, B -=item COPYRIGHT +B, B -=item SEE ALSO +B -=back +b, B, B, B -=head2 File::Spec::Functions - portably perform operations on file names +B =over 4 -=item SYNOPSIS +=item Operating on references to hashes. -=item DESCRIPTION +lock_ref_keys, unlock_ref_keys, lock_ref_keys_plus, lock_ref_value, +unlock_ref_value, lock_hashref, unlock_hashref, lock_hashref_recurse, +unlock_hashref_recurse, hash_ref_unlocked, legal_ref_keys, hidden_ref_keys + +=back =over 4 -=item Exports +=item CAVEATS -=back +=item BUGS -=item COPYRIGHT +=item AUTHOR =item SEE ALSO =back -=head2 File::Spec::Mac - File::Spec for Mac OS (Classic) +=head2 Hash::Utilib::Hash::Util, Hash::Util - A selection of +general-utility hash subroutines =over 4 @@ -17876,51 +19468,54 @@ canonpath() =item DESCRIPTION -=item METHODS - -canonpath +=over 4 -=back +=item Restricted hashes -catdir() +B, B -catfile +=back -curdir +=back -devnull +B -rootdir +B, B -tmpdir +B, B -updir +B, B -file_name_is_absolute +B -path +b, B, B, B -splitpath +B -splitdir +=over 4 -catpath +=item Operating on references to hashes. -abs2rel +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 -rel2abs +=back =over 4 -=item AUTHORS +=item CAVEATS -=item COPYRIGHT +=item BUGS + +=item AUTHOR =item SEE ALSO =back -=head2 File::Spec::OS2 - methods for OS/2 file specs +=head2 I18N::Collate - compare 8-bit scalar data according to the current +locale =over 4 @@ -17928,14 +19523,10 @@ rel2abs =item DESCRIPTION -tmpdir, splitpath - -=item COPYRIGHT - =back -=head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec -modules +=head2 I18N::LangTags - functions for dealing with RFC3066-style language +tags =over 4 @@ -17943,55 +19534,214 @@ modules =item DESCRIPTION -=item METHODS +=back -canonpath() +the function is_language_tag($lang1) -=back +the function extract_language_tags($whatever) -catdir() +the function same_language_tag($lang1, $lang2) -catfile +the function similarity_language_tag($lang1, $lang2) -curdir +the function is_dialect_of($lang1, $lang2) -devnull +the function super_languages($lang1) -rootdir +the function locale2language_tag($locale_identifier) -tmpdir +the function encode_language_tag($lang1) -updir +the function alternate_language_tags($lang1) -no_upwards +the function @langs = panic_languages(@accept_languages) -case_tolerant +the function implicate_supers( ...languages... ), the function +implicate_supers_strictly( ...languages... ) -file_name_is_absolute +=over 4 -path +=item ABOUT LOWERCASING -join +=item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS -splitpath +=item SEE ALSO -splitdir +=item COPYRIGHT -catpath() +=item AUTHOR -abs2rel +=back -rel2abs() +=head2 I18N::LangTags::Detect - detect the user's language preferences =over 4 +=item SYNOPSIS + +=item DESCRIPTION + +=item FUNCTIONS + +=item ENVIRONMENT + +=item SEE ALSO + =item COPYRIGHT +=item AUTHOR + +=back + +=head2 I18N::LangTags::List -- tags and names for human languages + +=over 4 + +=item SYNOPSIS + +=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 File::Spec::VMS - methods for VMS file specs +=head2 I18N::Langinfo - query locale information =over 4 @@ -17999,49 +19749,51 @@ rel2abs() =item DESCRIPTION -canonpath (override) +=over 4 + +=item EXPORT =back -catdir (override) +=item SEE ALSO -catfile (override) +=item AUTHOR -curdir (override) +=item COPYRIGHT AND LICENSE -devnull (override) +=back -rootdir (override) +=head2 IO - load various IO modules -tmpdir (override) +=over 4 -updir (override) +=item SYNOPSIS -case_tolerant (override) +=item DESCRIPTION -path (override) +=item DEPRECATED -file_name_is_absolute (override) +=back -splitpath (override) +=head2 IO::Compress::Base - Base Class for IO::Compress modules -splitdir (override) +=over 4 -catpath (override) +=item SYNOPSIS -abs2rel (override) +=item DESCRIPTION -rel2abs (override) +=item SEE ALSO -=over 4 +=item AUTHOR -=item COPYRIGHT +=item MODIFICATION HISTORY -=item SEE ALSO +=item COPYRIGHT AND LICENSE =back -=head2 File::Spec::Win32 - methods for Win32 file specs +=head2 IO::Compress::Deflate - Write RFC 1950 files/buffers =over 4 @@ -18049,199 +19801,212 @@ rel2abs (override) =item DESCRIPTION -devnull - -=back +DO NOT use in production code, The documentation is incomplete in places, +Parts of the interface defined here are tentative, Please report any +problems you find -tmpdir +=item Functional Interface -catfile +=over 4 -canonpath +=item deflate $input => $output [, OPTS] -splitpath +A filename, A filehandle, A scalar reference, An array reference, An Input +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob -splitdir +=item Notes -catpath +=item Optional Parameters -=over 4 +AutoClose =E 0|1, BinModeIn =E 0|1, -Append =E 0|1 -=item Note For File::Spec::Win32 Maintainers +=item Examples =back +=item OO Interface + =over 4 -=item COPYRIGHT +=item Constructor -=item SEE ALSO +A filename, A filehandle, A scalar reference -=back +=item Constructor Options -=head2 File::Temp - return name and handle of a temporary file safely +AutoClose =E 0|1, Append =E 0|1, A Buffer, A Filename, A +Filehandle, Merge =E 0|1, -Level, -Strategy, -Strict =E 0|1 -=over 4 +=item Examples -=item PORTABILITY +=back -=item SYNOPSIS +=item Methods -=item DESCRIPTION +=over 4 -=back +=item print -=over 4 +=item printf -=item OBJECT-ORIENTED INTERFACE +=item syswrite -B +=item write -=back +=item flush -B +=item tell -B +=item eof -B +=item seek -=over 4 +=item binmode -=item FUNCTIONS +=item opened -B +=item autoflush -=back +=item input_line_number -B +=item fileno -=over 4 +=item close -=item MKTEMP FUNCTIONS +=item newStream([OPTS]) -B +Level + +=item deflateParams =back -B +=item Importing -B +:all, :constants, :flush, :level, :strategy -B +=item EXAMPLES -=over 4 +=item SEE ALSO -=item POSIX FUNCTIONS +=item AUTHOR -B +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE =back -B +=head2 IO::Compress::Gzip - Write RFC 1952 files/buffers =over 4 -=item ADDITIONAL FUNCTIONS - -B - -=back +=item SYNOPSIS -=over 4 +=item DESCRIPTION -=item UTILITY FUNCTIONS +DO NOT use in production code, The documentation is incomplete in places, +Parts of the interface defined here are tentative, Please report any +problems you find -B +=item Functional Interface -=back +=over 4 -B +=item gzip $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 +=item Notes -=over 4 +=item Optional Parameters -=item PACKAGE VARIABLES +AutoClose =E 0|1, BinModeIn =E 0|1, -Append =E 0|1 -B, STANDARD, MEDIUM, HIGH +=item Examples =back -TopSystemUID - -B<$KEEP_ALL>, B<$DEBUG> +=item OO Interface =over 4 -=item WARNING +=item Constructor -=over 4 +A filename, A filehandle, A scalar reference -=item Temporary files and NFS +=item Constructor Options -=item Forking +AutoClose =E 0|1, Append =E 0|1, A Buffer, A Filename, A +Filehandle, Merge =E 0|1, -Level, -Strategy, -Minimal =E 0|1, +-Comment =E $comment, -Name =E $string, -Time =E $number, +-TextFlag =E 0|1, -HeaderCRC =E 0|1, -OS_Code =E $value, +-ExtraField =E $data, -ExtraFlags =E $value, -Strict =E 0|1 -=item BINMODE +=item Examples =back -=item HISTORY +=item Methods -=item SEE ALSO +=over 4 -=item AUTHOR +=item print -=back +=item printf -=head2 File::stat - by-name interface to Perl's built-in stat() functions +=item syswrite -=over 4 +=item write -=item SYNOPSIS +=item flush -=item DESCRIPTION +=item tell -=item BUGS +=item eof -=item NOTE +=item seek -=item AUTHOR +=item binmode -=back +=item opened -=head2 FileCache - keep more files open than the system permits +=item autoflush -=over 4 +=item input_line_number -=item SYNOPSIS +=item fileno -=item DESCRIPTION +=item close -cacheout EXPR, cacheout MODE, EXPR +=item newStream([OPTS]) -=item CAVEATS +Level -=item BUGS +=item deflateParams =back -=head2 FileHandle - supply object methods for filehandles +=item Importing -=over 4 +:all, :constants, :flush, :level, :strategy -=item SYNOPSIS +=item EXAMPLES -=item DESCRIPTION +=item SEE ALSO -$fh->print, $fh->printf, $fh->getline, $fh->getlines +=item AUTHOR -=item SEE ALSO +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE =back -=head2 Filter::Simple - Simplified source filtering +=head2 IO::Compress::RawDeflate - Write RFC 1951 files/buffers =over 4 @@ -18249,122 +20014,104 @@ $fh->print, $fh->printf, $fh->getline, $fh->getlines =item DESCRIPTION -=over 4 - -=item The Problem - -=item A Solution - -=item Disabling or changing behaviour - -=item All-in-one interface - -=item Filtering only specific components of source code - -C<"code">, C<"code_no_comments">, C<"executable">, -C<"executable_no_comments">, C<"quotelike">, C<"string">, C<"regex">, -C<"all"> +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 Filtering only the code parts of source code +=item Functional Interface -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. +=over 4 -=item Using Filter::Simple with an explicit C subroutine +=item rawdeflate $input => $output [, OPTS] -=item Using Filter::Simple and Exporter together +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 How it works +=item Notes -=back +=item Optional Parameters -=item AUTHOR +AutoClose =E 0|1, BinModeIn =E 0|1, -Append =E 0|1 -=item COPYRIGHT +=item Examples =back -=head2 Filter::Util::Call - Perl Source Filter Utility Module +=item OO Interface =over 4 -=item SYNOPSIS - -=item DESCRIPTION - -=over 4 +=item Constructor -=item B +A filename, A filehandle, A scalar reference -=item B +=item Constructor Options -=item B +AutoClose =E 0|1, Append =E 0|1, A Buffer, A Filename, A +Filehandle, Merge =E 0|1, -Level, -Strategy, -Strict =E 0|1 -B<$_>, B<$status>, B and B, B +=item Examples =back -=item EXAMPLES +=item Methods =over 4 -=item Example 1: A simple filter. - -=item Example 2: Using the context +=item print -=item Example 3: Using the context within the filter +=item printf -=item Example 4: Using filter_del +=item syswrite -=back +=item write -=item Filter::Simple +=item flush -=item AUTHOR +=item tell -=item DATE +=item eof -=back +=item seek -=head2 FindBin - Locate directory of original perl script +=item binmode -=over 4 +=item opened -=item SYNOPSIS +=item autoflush -=item DESCRIPTION +=item input_line_number -=item EXPORTABLE VARIABLES +=item fileno -=item KNOWN ISSUES +=item close -=item KNOWN BUGS +=item newStream([OPTS]) -=item AUTHORS +Level -=item COPYRIGHT +=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::Zip - Write zip files/buffers =over 4 @@ -18372,107 +20119,109 @@ B<$_>, B<$status>, B and B, B =item DESCRIPTION -=item Command Line Options, an Introduction +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 Getting Started with Getopt::Long +=item Functional Interface =over 4 -=item Simple options - -=item A little bit less simple options +=item zip $input => $output [, OPTS] -=item Mixing command line option with other arguments +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 values +=item Notes -=item Options with multiple values +=item Optional Parameters -=item Options with hash values +AutoClose =E 0|1, BinModeIn =E 0|1, -Append =E 0|1 -=item User-defined subroutines to handle options +=item Examples -=item Options with multiple names +=back -=item Case and abbreviations +=item OO Interface -=item Summary of Option Specifications +=over 4 -!, +, s, i, o, f, : I [ I ], : I [ I ], : -+ [ I ] +=item Constructor -=back +A filename, A filehandle, A scalar reference -=item Advanced Possibilities +=item Constructor Options -=over 4 +AutoClose =E 0|1, Append =E 0|1, A Buffer, A Filename, A +Filehandle, -Name =E $string, -Time =E $number, -exTime =E +[$atime, $mtime, $ctime], -Comment =E $comment, -ZipComment =E +$comment, Method =E $method, Stream =E 0|1, -TextFlag =E 0|1, +ExtraFieldLocal =E $data =item ExtraFieldCentral =E $data, Minimal +=E 1|0, BlockSize100K =E number, WorkFactor =E number, -Level, +-Strategy, -Strict =E 0|1 -=item Object oriented interface +=item Examples -=item Thread Safety +=back -=item Documentation and help texts +=item Methods -=item Storing option values in a hash +=over 4 -=item Bundling +=item print -=item The lonesome dash +=item printf -=item Argument callback +=item syswrite -=back +=item write -=item Configuring Getopt::Long +=item flush -default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt, -require_order, permute, bundling (default: disabled), bundling_override -(default: disabled), ignore_case (default: enabled), ignore_case_always -(default: disabled), auto_version (default:disabled), auto_help -(default:disabled), pass_through (default: disabled), prefix, -prefix_pattern, long_prefix_pattern, debug (default: disabled) +=item tell -=item Exportable Methods +=item eof -VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage +=item seek -=item Return values and Errors +=item binmode -=item Legacy +=item opened -=over 4 +=item autoflush -=item Default destinations +=item input_line_number -=item Alternative option starters +=item fileno -=item Configuration variables +=item close -=back +=item newStream([OPTS]) -=item Trouble Shooting +Level -=over 4 +=item deflateParams -=item GetOptions does not return a false result when an option is not -supplied +=back -=item GetOptions does not split the command line correctly +=item Importing -=item Undefined subroutine &main::GetOptions called +:all, :constants, :flush, :level, :strategy, :zip_method -=item How do I put a "-?" option into a Getopt::Long? +=item EXAMPLES -=back +=item SEE ALSO =item AUTHOR -=item COPYRIGHT AND DISCLAIMER +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE =back -=head2 Getopt::Std, getopt, getopts - Process single-character switches -with switch clustering +=head2 IO::Dir - supply object methods for directory handles =over 4 @@ -18480,11 +20229,18 @@ with switch clustering =item DESCRIPTION -=item C<--help> and C<--version> +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 Hash::Util - A selection of general-utility hash subroutines +=head2 IO::File - supply object methods for filehandles =over 4 @@ -18492,34 +20248,53 @@ with switch clustering =item DESCRIPTION -=over 4 +=item CONSTRUCTOR -=item Restricted hashes +new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile -lock_keys, unlock_keys +=item METHODS -=back +open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( +[LAYER] ) -=back +=item NOTE -lock_value, unlock_value +=item SEE ALSO -B, B +=item HISTORY + +=back -B +=head2 IO::Handle - supply object methods for I/O handles =over 4 -=item CAVEATS +=item SYNOPSIS -=item AUTHOR +=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 I18N::Collate - compare 8-bit scalar data according to the current -locale +=head2 IO::Pipe - supply object methods for pipes =over 4 @@ -18527,57 +20302,62 @@ locale =item DESCRIPTION -=back +=item CONSTRUCTOR -=head2 I18N::LangTags - functions for dealing with RFC3066-style language -tags +new ( [READER, WRITER] ) -=over 4 +=item METHODS -=item SYNOPSIS +reader ([ARGS]), writer ([ARGS]), handles () -=item DESCRIPTION +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT =back -the function is_language_tag($lang1) +=head2 IO::Poll - Object interface to system poll call -the function extract_language_tags($whatever) +=over 4 -the function same_language_tag($lang1, $lang2) +=item SYNOPSIS -the function similarity_language_tag($lang1, $lang2) +=item DESCRIPTION -the function is_dialect_of($lang1, $lang2) +=item METHODS -the function super_languages($lang1) +mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( +IO ), handles( [ EVENT_MASK ] ) -the function locale2language_tag($locale_identifier) +=item SEE ALSO -the function encode_language_tag($lang1) +=item AUTHOR -the function alternate_language_tags($lang1) +=item COPYRIGHT -the function @langs = panic_languages(@accept_languages) +=back -the function implicate_supers( ...languages... ), the function -implicate_supers_strictly( ...languages... ) +=head2 IO::Seekable - supply seek based methods for I/O objects =over 4 -=item ABOUT LOWERCASING +=item SYNOPSIS -=item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS +=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 COPYRIGHT +=item SEE ALSO -=item AUTHOR +=item HISTORY =back -=head2 I18N::LangTags::Detect - detect the user's language preferences +=head2 IO::Select - OO interface to the select system call =over 4 @@ -18585,19 +20365,25 @@ implicate_supers_strictly( ...languages... ) =item DESCRIPTION -=item FUNCTIONS +=item CONSTRUCTOR -=item ENVIRONMENT +new ( [ HANDLES ] ) -=item SEE ALSO +=item METHODS -=item COPYRIGHT +add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( +[ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), +count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) + +=item EXAMPLE =item AUTHOR +=item COPYRIGHT + =back -=head2 I18N::LangTags::List -- tags and names for human languages +=head2 IO::Socket - Object interface to socket communications =over 4 @@ -18605,147 +20391,24 @@ implicate_supers_strictly( ...languages... ) =item DESCRIPTION -=item ABOUT LANGUAGE TAGS +=item CONSTRUCTOR -=item LIST OF LANGUAGES +new ( [ARGS] ) -{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 METHODS -=item SEE ALSO +accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, +protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) -=item COPYRIGHT AND DISCLAIMER +=item SEE ALSO =item AUTHOR +=item COPYRIGHT + =back -=head2 I18N::Langinfo - query locale information +=head2 IO::Socket::INET - Object interface for AF_INET domain sockets =over 4 @@ -18753,9 +20416,16 @@ Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd} =item DESCRIPTION +=item CONSTRUCTOR + +new ( [ARGS] ) + =over 4 -=item EXPORT +=item METHODS + +sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost +() =back @@ -18763,11 +20433,11 @@ Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd} =item AUTHOR -=item COPYRIGHT AND LICENSE +=item COPYRIGHT =back -=head2 IO - load various IO modules +=head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets =over 4 @@ -18775,12 +20445,24 @@ Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd} =item DESCRIPTION -=item DEPRECATED +=item CONSTRUCTOR + +new ( [ARGS] ) + +=item METHODS + +hostpath(), peerpath() + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT =back -=head2 IO::Compress::Deflate - Perl interface to write RFC 1950 -files/buffers +=head2 IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip) +file/buffer =over 4 @@ -18790,13 +20472,13 @@ files/buffers DO NOT use in production code, The documentation is incomplete in places, Parts of the interface defined here are tentative, Please report any -problems you find +problems you find, RFC 1950, RFC 1951, gzip (RFC 1952), zip =item Functional Interface =over 4 -=item deflate $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 @@ -18806,7 +20488,8 @@ Reference, An Output FileGlob =item Optional Parameters -AutoClose =E 0|1, BinModeIn =E 0|1, -Append =E 0|1 +AutoClose =E 0|1, BinModeOut =E 0|1, -Append =E 0|1, +-MultiStream =E 0|1 =item Examples @@ -18822,8 +20505,9 @@ A filename, A filehandle, A scalar reference =item Constructor Options --AutoClose =E 0|1, -Append =E 0|1, A Buffer, A Filename, A -Filehandle, -Merge =E 0|1, -Level, -Strategy, -Strict =E 0|1 +-AutoClose =E 0|1, -MultiStream =E 0|1, -Prime =E $string, +-Transparent =E 0|1, -BlockSize =E $num, -InputLength =E $size, +-Append =E 0|1, -Strict =E 0|1, -ParseExtra =E 0|1 =item Examples @@ -18833,15 +20517,19 @@ Filehandle, -Merge =E 0|1, -Level, -Strategy, -Strict =E 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 @@ -18851,21 +20539,21 @@ Filehandle, -Merge =E 0|1, -Level, -Strategy, -Strict =E 0|1 =item binmode -=item fileno +=item opened -=item close +=item autoflush -=item newStream([OPTS]) +=item input_line_number -Level, TODO +=item fileno -=item deflateParams +=item close =back =item Importing -:all, :constants, :flush, :level, :strategy +:all =item EXAMPLES @@ -18879,8 +20567,8 @@ Level, TODO =back -=head2 IO::Compress::Gzip - Perl interface to write RFC 1952 -files/buffers +=head2 IO::Uncompress::AnyUncompress - Uncompress gzip, zip, bzip2 or lzop +file/buffer =over 4 @@ -18890,13 +20578,13 @@ files/buffers DO NOT use in production code, The documentation is incomplete in places, Parts of the interface defined here are tentative, Please report any -problems you find +problems you find, RFC 1950, RFC 1951, gzip (RFC 1952), zip, bzip2, lzop =item Functional Interface =over 4 -=item gzip $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 @@ -18906,7 +20594,8 @@ Reference, An Output FileGlob =item Optional Parameters -AutoClose =E 0|1, BinModeIn =E 0|1, -Append =E 0|1 +AutoClose =E 0|1, BinModeOut =E 0|1, -Append =E 0|1, +-MultiStream =E 0|1 =item Examples @@ -18922,11 +20611,9 @@ A filename, A filehandle, A scalar reference =item Constructor Options --AutoClose =E 0|1, -Append =E 0|1, A Buffer, A Filename, A -Filehandle, -Merge =E 0|1, -Level, -Strategy, -Minimal =E 0|1, --Comment =E $comment, -Name =E $string, -Time =E $number, --TextFlag =E 0|1, -HeaderCRC =E 0|1, -OS_Code =E $value, --ExtraField =E $data, -ExtraFlags =E $value, -Strict =E 0|1 +-AutoClose =E 0|1, -MultiStream =E 0|1, -Prime =E $string, +-Transparent =E 0|1, -BlockSize =E $num, -InputLength =E $size, +-Append =E 0|1, -Strict =E 0|1 =item Examples @@ -18936,15 +20623,17 @@ Filehandle, -Merge =E 0|1, -Level, -Strategy, -Minimal =E 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 @@ -18954,21 +20643,21 @@ Filehandle, -Merge =E 0|1, -Level, -Strategy, -Minimal =E 0|1, =item binmode -=item fileno +=item opened -=item close +=item autoflush -=item newStream([OPTS]) +=item input_line_number -Level, TODO +=item fileno -=item deflateParams +=item close =back =item Importing -:all, :constants, :flush, :level, :strategy +:all =item EXAMPLES @@ -18982,8 +20671,25 @@ Level, TODO =back -=head2 IO::Compress::RawDeflate - Perl interface to write RFC 1951 -files/buffers +=head2 IO::Uncompress::Base - Base Class for IO::Uncompress modules + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=item AUTHOR + +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE + +=back + +=head2 IO::Uncompress::Gunzip - Read RFC 1952 files/buffers =over 4 @@ -18999,7 +20705,7 @@ problems you find =over 4 -=item rawdeflate $input => $output [, OPTS] +=item gunzip $input => $output [, OPTS] A filename, A filehandle, A scalar reference, An array reference, An Input FileGlob string, A filename, A filehandle, A scalar reference, An Array @@ -19009,7 +20715,8 @@ Reference, An Output FileGlob =item Optional Parameters -AutoClose =E 0|1, BinModeIn =E 0|1, -Append =E 0|1 +AutoClose =E 0|1, BinModeOut =E 0|1, -Append =E 0|1, +-MultiStream =E 0|1 =item Examples @@ -19025,8 +20732,9 @@ A filename, A filehandle, A scalar reference =item Constructor Options --AutoClose =E 0|1, -Append =E 0|1, A Buffer, A Filename, A -Filehandle, -Merge =E 0|1, -Level, -Strategy, -Strict =E 0|1 +-AutoClose =E 0|1, -MultiStream =E 0|1, -Prime =E $string, +-Transparent =E 0|1, -BlockSize =E $num, -InputLength =E $size, +-Append =E 0|1, -Strict =E 0|1, -ParseExtra =E 0|1 =item Examples @@ -19036,15 +20744,21 @@ Filehandle, -Merge =E 0|1, -Level, -Strategy, -Strict =E 0|1 =over 4 -=item print +=item read -=item printf +=item read -=item syswrite +=item getline -=item write +=item getc -=item flush +=item ungetc + +=item inflateSync + +=item getHeaderInfo + +Name, Comment =item tell @@ -19054,21 +20768,21 @@ Filehandle, -Merge =E 0|1, -Level, -Strategy, -Strict =E 0|1 =item binmode -=item fileno +=item opened -=item close +=item autoflush -=item newStream([OPTS]) +=item input_line_number -Level, TODO +=item fileno -=item deflateParams +=item close =back =item Importing -:all, :constants, :flush, :level, :strategy +:all =item EXAMPLES @@ -19082,7 +20796,7 @@ Level, TODO =back -=head2 IO::Dir - supply object methods for directory handles +=head2 IO::Uncompress::Inflate - Read RFC 1950 files/buffers =over 4 @@ -19090,117 +20804,104 @@ Level, TODO =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 +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 -=head2 IO::File - supply object methods for filehandles +=item Functional Interface =over 4 -=item SYNOPSIS - -=item DESCRIPTION - -=item CONSTRUCTOR - -new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile +=item inflate $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 -open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( -[LAYER] ) +=item Notes -=item NOTE +=item Optional Parameters -=item SEE ALSO +AutoClose =E 0|1, BinModeOut =E 0|1, -Append =E 0|1, +-MultiStream =E 0|1 -=item HISTORY +=item Examples =back -=head2 IO::Handle - supply object methods for I/O handles +=item OO Interface =over 4 -=item SYNOPSIS - -=item DESCRIPTION +=item Constructor -=item CONSTRUCTOR +A filename, A filehandle, A scalar reference -new (), new_from_fd ( FD, MODE ) +=item Constructor Options -=item METHODS +-AutoClose =E 0|1, -MultiStream =E 0|1, -Prime =E $string, +-Transparent =E 0|1, -BlockSize =E $num, -InputLength =E $size, +-Append =E 0|1, -Strict =E 0|1 -$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 Examples -=item NOTE +=back -=item SEE ALSO +=item Methods -=item BUGS +=over 4 -=item HISTORY +=item read -=back +=item read -=head2 IO::Pipe - supply object methods for pipes +=item getline -=over 4 +=item getc -=item SYNOPSIS +=item ungetc -=item DESCRIPTION +=item inflateSync -=item CONSTRUCTOR +=item getHeaderInfo -new ( [READER, WRITER] ) +=item tell -=item METHODS +=item eof -reader ([ARGS]), writer ([ARGS]), handles () +=item seek -=item SEE ALSO +=item binmode -=item AUTHOR +=item opened -=item COPYRIGHT +=item autoflush -=back +=item input_line_number -=head2 IO::Poll - Object interface to system poll call +=item fileno -=over 4 +=item close -=item SYNOPSIS +=back -=item DESCRIPTION +=item Importing -=item METHODS +:all -mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( -IO ), handles( [ EVENT_MASK ] ) +=item EXAMPLES =item SEE ALSO =item AUTHOR -=item COPYRIGHT +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE =back -=head2 IO::Seekable - supply seek based methods for I/O objects +=head2 IO::Uncompress::RawInflate - Read RFC 1951 files/buffers =over 4 @@ -19208,122 +20909,104 @@ IO ), handles( [ EVENT_MASK ] ) =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 - -=item SEE ALSO - -=item HISTORY - -=back +DO NOT use in production code, The documentation is incomplete in places, +Parts of the interface defined here are tentative, Please report any +problems you find -=head2 IO::Select - OO interface to the select system call +=item Functional Interface =over 4 -=item SYNOPSIS - -=item DESCRIPTION - -=item CONSTRUCTOR - -new ( [ HANDLES ] ) +=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 -add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( -[ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), -count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) +=item Notes -=item EXAMPLE +=item Optional Parameters -=item AUTHOR +AutoClose =E 0|1, BinModeOut =E 0|1, -Append =E 0|1, +-MultiStream =E 0|1 -=item COPYRIGHT +=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 +-AutoClose =E 0|1, -MultiStream =E 0|1, -Prime =E $string, +-Transparent =E 0|1, -BlockSize =E $num, -InputLength =E $size, +-Append =E 0|1, -Strict =E 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 +=back -new ( [ARGS] ) +=item Importing -=item METHODS +:all -hostpath(), peerpath() +=item EXAMPLES =item SEE ALSO =item AUTHOR -=item COPYRIGHT +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE =back -=head2 IO::Uncompress::AnyInflate - Perl interface to read RFC 1950, 1951 & -1952 files/buffers +=head2 IO::Uncompress::Unzip - Read zip files/buffers =over 4 @@ -19339,7 +21022,7 @@ problems you find =over 4 -=item anyinflate $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 @@ -19368,7 +21051,7 @@ A filename, A filehandle, A scalar reference -AutoClose =E 0|1, -MultiStream =E 0|1, -Prime =E $string, -Transparent =E 0|1, -BlockSize =E $num, -InputLength =E $size, --Append =E 0|1, -Strict =E 0|1, -ParseExtra =E 0|1 +-Append =E 0|1, -Strict =E 0|1 =item Examples @@ -19400,6 +21083,12 @@ A filename, A filehandle, A scalar reference =item binmode +=item opened + +=item autoflush + +=item input_line_number + =item fileno =item close @@ -19422,8 +21111,7 @@ A filename, A filehandle, A scalar reference =back -=head2 IO::Uncompress::Gunzip - Perl interface to read RFC 1952 -files/buffers +=head2 IO::Zlib - IO:: style interface to L =over 4 @@ -19431,101 +21119,185 @@ 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 CONSTRUCTOR -=item Functional Interface +new ( [ARGS] ) + +=item OBJECT METHODS + +open ( FILENAME, MODE ), opened, close, getc, getline, getlines, print ( +ARGS... ), read ( BUF, NBYTES, [OFFSET] ), eof, seek ( OFFSET, WHENCE ), +tell, setpos ( POS ), getpos ( POS ) + +=item USING THE EXTERNAL GZIP + +=item CLASS METHODS + +has_Compress_Zlib, gzip_external, gzip_used, gzip_read_open, +gzip_write_open + +=item DIAGNOSTICS + +IO::Zlib::getlines: must be called in list context, +IO::Zlib::gzopen_external: mode '...' is illegal, IO::Zlib::import: '...' +is illegal, IO::Zlib::import: ':gzip_external' requires an argument, +IO::Zlib::import: 'gzip_read_open' requires an argument, IO::Zlib::import: +'gzip_read' '...' is illegal, IO::Zlib::import: 'gzip_write_open' requires +an argument, IO::Zlib::import: 'gzip_write_open' '...' is illegal, +IO::Zlib::import: no Compress::Zlib and no external gzip, IO::Zlib::open: +needs a filename, IO::Zlib::READ: NBYTES must be specified, IO::Zlib::READ: +OFFSET is not supported, IO::Zlib::WRITE: too long LENGTH, IO::Zlib::WRITE: +OFFSET is not supported + +=item SEE ALSO + +=item HISTORY + +=item COPYRIGHT + +=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 -AutoClose =E 0|1, BinModeOut =E 0|1, -Append =E 0|1, --MultiStream =E 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 --AutoClose =E 0|1, -MultiStream =E 0|1, -Prime =E $string, --Transparent =E 0|1, -BlockSize =E $num, -InputLength =E $size, --Append =E 0|1, -Strict =E 0|1, -ParseExtra =E 0|1 +new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile -=item Examples +=item METHODS + +open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( +[LAYER] ) + +=item NOTE + +=item SEE ALSO + +=item HISTORY =back -=item Methods +=head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O +handles =over 4 -=item read +=item SYNOPSIS -=item read +=item DESCRIPTION -=item getline +=item CONSTRUCTOR -=item getc +new (), new_from_fd ( FD, MODE ) -=item ungetc +=item METHODS -=item inflateSync +$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 getHeaderInfo +=item NOTE -Name, Comment +=item SEE ALSO -=item tell +=item BUGS -=item eof +=item HISTORY -=item seek +=back -=item binmode +=head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes -=item fileno +=over 4 -=item close +=item SYNOPSIS + +=item DESCRIPTION + +=item CONSTRUCTOR + +new ( [READER, WRITER] ) + +=item METHODS + +reader ([ARGS]), writer ([ARGS]), handles () + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT =back -=item Importing +=head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call -:all +=over 4 -=item EXAMPLES +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS + +mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( +IO ), handles( [ EVENT_MASK ] ) =item SEE ALSO =item AUTHOR -=item MODIFICATION HISTORY +=item COPYRIGHT -=item COPYRIGHT AND LICENSE +=back + +=head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for +I/O objects + +=over 4 + +=item SYNOPSIS + +=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 + +=item SEE ALSO + +=item HISTORY =back -=head2 IO::Uncompress::Inflate - Perl interface to read RFC 1950 -files/buffers +=head2 IO::lib::IO::Select, IO::Select - OO interface to the select system +call =over 4 @@ -19533,99 +21305,143 @@ 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 CONSTRUCTOR -=item Functional Interface +new ( [ HANDLES ] ) + +=item METHODS + +add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( +[ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), +count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) + +=item EXAMPLE + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket +communications =over 4 -=item inflate $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 CONSTRUCTOR + +new ( [ARGS] ) + +=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 + +=head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for +AF_INET domain sockets + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CONSTRUCTOR + +new ( [ARGS] ) + +=over 4 + +=item METHODS + +sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost +() -=item Notes +=back -=item Optional Parameters +=item SEE ALSO -AutoClose =E 0|1, BinModeOut =E 0|1, -Append =E 0|1, --MultiStream =E 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 - -A filename, A filehandle, A scalar reference - -=item Constructor Options +=item SYNOPSIS --AutoClose =E 0|1, -MultiStream =E 0|1, -Prime =E $string, --Transparent =E 0|1, -BlockSize =E $num, -InputLength =E $size, --Append =E 0|1, -Strict =E 0|1 +=item DESCRIPTION -=item Examples +=item CONSTRUCTOR -=back +new ( [ARGS] ) -=item Methods +=item METHODS -=over 4 +hostpath(), peerpath() -=item read +=item SEE ALSO -=item read +=item AUTHOR -=item getline +=item COPYRIGHT -=item getc +=back -=item ungetc +=head2 IPC::Msg - SysV Msg IPC object class -=item inflateSync +=over 4 -=item getHeaderInfo +=item SYNOPSIS -=item tell +=item DESCRIPTION -=item eof +=item METHODS -=item seek +new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set +( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, +FLAGS ] ), stat -=item binmode +=item SEE ALSO -=item fileno +=item AUTHOR -=item close +=item COPYRIGHT =back -=item Importing - -:all +=head2 IPC::Open2, open2 - open a process for both reading and writing -=item EXAMPLES +=over 4 -=item SEE ALSO +=item SYNOPSIS -=item AUTHOR +=item DESCRIPTION -=item MODIFICATION HISTORY +=item WARNING -=item COPYRIGHT AND LICENSE +=item SEE ALSO =back -=head2 IO::Uncompress::RawInflate - Perl interface to read RFC 1951 -files/buffers +=head2 IPC::Open3, open3 - open a process for reading, writing, and error +handling =over 4 @@ -19633,98 +21449,118 @@ 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 WARNING -=item Functional Interface +=back + +=head2 IPC::Semaphore - SysV Semaphore IPC object class =over 4 -=item rawinflate $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 +=item METHODS -=item Optional Parameters +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 -AutoClose =E 0|1, BinModeOut =E 0|1, -Append =E 0|1, --MultiStream =E 0|1 +=item SEE ALSO -=item Examples +=item AUTHOR + +=item COPYRIGHT =back -=item OO Interface +=head2 IPC::SysV - SysV IPC constants =over 4 -=item Constructor +=item SYNOPSIS -A filename, A filehandle, A scalar reference +=item DESCRIPTION -=item Constructor Options +ftok( PATH, ID ) --AutoClose =E 0|1, -MultiStream =E 0|1, -Prime =E $string, --Transparent =E 0|1, -BlockSize =E $num, -InputLength =E $size, --Append =E 0|1, -Strict =E 0|1 +=item SEE ALSO -=item Examples +=item AUTHORS + +=item COPYRIGHT =back -=item Methods +=head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class =over 4 -=item read +=item SYNOPSIS -=item read +=item DESCRIPTION -=item getline +=item METHODS -=item getc +new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set +( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, +FLAGS ] ), stat -=item ungetc +=item SEE ALSO -=item inflateSync +=item AUTHOR -=item getHeaderInfo +=item COPYRIGHT -=item tell +=back -=item eof +=head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object +class -=item seek +=over 4 -=item binmode +=item SYNOPSIS -=item fileno +=item DESCRIPTION -=item close +=item METHODS + +new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), +getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), +set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N +, VALUE ), stat + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT =back -=item Importing +=head2 List::Util - A selection of general-utility list subroutines -:all +=over 4 -=item EXAMPLES +=item SYNOPSIS -=item SEE ALSO +=item DESCRIPTION -=item AUTHOR +first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce +BLOCK LIST, shuffle LIST, sum LIST -=item MODIFICATION HISTORY +=item KNOWN BUGS -=item COPYRIGHT AND LICENSE +=item SUGGESTED ADDITIONS + +=item COPYRIGHT =back -=head2 IO::Zlib - IO:: style interface to L +=head2 List::Utilib::List::Util, List::Util - A selection of +general-utility list subroutines =over 4 @@ -19732,46 +21568,39 @@ A filename, A filehandle, A scalar reference =item DESCRIPTION -=item CONSTRUCTOR +first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce +BLOCK LIST, shuffle LIST, sum LIST -new ( [ARGS] ) +=item KNOWN BUGS -=item OBJECT METHODS +=item SUGGESTED ADDITIONS -open ( FILENAME, MODE ), opened, close, getc, getline, getlines, print ( -ARGS... ), read ( BUF, NBYTES, [OFFSET] ), eof, seek ( OFFSET, WHENCE ), -tell, setpos ( POS ), getpos ( POS ) +=item COPYRIGHT -=item USING THE EXTERNAL GZIP +=back -=item CLASS METHODS +=head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of +general-utility scalar subroutines -has_Compress_Zlib, gzip_external, gzip_used, gzip_read_open, -gzip_write_open +=over 4 -=item DIAGNOSTICS +=item SYNOPSIS -IO::Zlib::getlines: must be called in list context, -IO::Zlib::gzopen_external: mode '...' is illegal, IO::Zlib::import: '...' -is illegal, IO::Zlib::import: ':gzip_external' requires an argument, -IO::Zlib::import: 'gzip_read_open' requires an argument, IO::Zlib::import: -'gzip_read' '...' is illegal, IO::Zlib::import: 'gzip_write_open' requires -an argument, IO::Zlib::import: 'gzip_write_open' '...' is illegal, -IO::Zlib::import: no Compress::Zlib and no external gzip, IO::Zlib::open: -needs a filename, IO::Zlib::READ: NBYTES must be specified, IO::Zlib::READ: -OFFSET is not supported, IO::Zlib::WRITE: too long LENGTH, IO::Zlib::WRITE: -OFFSET is not supported +=item DESCRIPTION -=item SEE ALSO +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 HISTORY +=item KNOWN BUGS =item COPYRIGHT +=item BLATANT PLUG + =back -=head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory -handles +=head2 Locale::Constants - constants for Locale codes =over 4 @@ -19779,18 +21608,19 @@ handles =item DESCRIPTION -new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), -rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] +=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::File, IO::File - supply object methods for filehandles +=head2 Locale::Country - ISO codes for country identification (ISO 3166) =over 4 @@ -19798,25 +21628,48 @@ rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] =item DESCRIPTION -=item CONSTRUCTOR +B, B, B -new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile +=item CONVERSION ROUTINES -=item METHODS +code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ), +country_code2code( CODE, CODESET, CODESET ) -open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( -[LAYER] ) +=item QUERY ROUTINES + +C, C + +=item SEMI-PRIVATE ROUTINES + +=over 4 + +=item alias_code + +=item rename_country + +=back + +=item EXAMPLES + +=item DOMAIN NAMES -=item NOTE +=item KNOWN BUGS AND LIMITATIONS =item SEE ALSO -=item HISTORY +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 + +=item COPYRIGHT =back -=head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O -handles +=head2 Locale::Currency - ISO three letter codes for currency +identification (ISO 4217) =over 4 @@ -19824,28 +21677,33 @@ handles =item DESCRIPTION -=item CONSTRUCTOR +XTS, XXX -new (), new_from_fd ( FD, MODE ) +=item CONVERSION ROUTINES -=item METHODS +code2currency(), currency2code() -$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 QUERY ROUTINES -=item NOTE +C, C + +=item EXAMPLES + +=item KNOWN BUGS AND LIMITATIONS =item SEE ALSO -=item BUGS +Locale::Country, Locale::Script, ISO 4217:1995, +http://www.bsi-global.com/iso4217currency -=item HISTORY +=item AUTHOR + +=item COPYRIGHT =back -=head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes +=head2 Locale::Language - ISO two letter codes for language identification +(ISO 639) =over 4 @@ -19853,23 +21711,30 @@ $io->blocking ( [ BOOL ] ), $io->untaint =item DESCRIPTION -=item CONSTRUCTOR +=item CONVERSION ROUTINES -new ( [READER, WRITER] ) +code2language(), language2code() -=item METHODS +=item QUERY ROUTINES -reader ([ARGS]), writer ([ARGS]), handles () +C, C + +=item EXAMPLES + +=item KNOWN BUGS AND LIMITATIONS =item SEE ALSO +Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F), +http://lcweb.loc.gov/standards/iso639-2/langhome.html + =item AUTHOR =item COPYRIGHT =back -=head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call +=head2 Locale::Maketext - framework for localization =over 4 @@ -19877,40 +21742,50 @@ reader ([ARGS]), writer ([ARGS]), handles () =item DESCRIPTION +=item QUICK OVERVIEW + =item METHODS -mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( -IO ), handles( [ EVENT_MASK ] ) +=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 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for -I/O objects +=item LANGUAGE CLASS HIERARCHIES -=over 4 +=item ENTRIES IN EACH LEXICON -=item SYNOPSIS +=item BRACKET NOTATION -=item DESCRIPTION +=item AUTO LEXICONS -$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 CONTROLLING LOOKUP FAILURE + +=item HOW TO USE MAKETEXT =item SEE ALSO -=item HISTORY +=item COPYRIGHT AND DISCLAIMER + +=item AUTHOR =back -=head2 IO::lib::IO::Select, IO::Select - OO interface to the select system -call +=head2 Locale::Maketext::TPJ13 -- article about software localization =over 4 @@ -19918,82 +21793,77 @@ call =item DESCRIPTION -=item CONSTRUCTOR - -new ( [ HANDLES ] ) +=item Localization and Perl: gettext breaks, Maketext fixes -=item METHODS +=over 4 -add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( -[ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), -count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) +=item A Localization Horror Story: It Could Happen To You -=item EXAMPLE +=item The Linguistic View -=item AUTHOR +=item Breaking gettext -=item COPYRIGHT +=item Replacing gettext -=back +=item Buzzwords: Abstraction and Encapsulation -=head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket -communications +=item Buzzword: Isomorphism -=over 4 +=item Buzzword: Inheritance -=item SYNOPSIS +=item Buzzword: Concision -=item DESCRIPTION +=item The Devil in the Details -=item CONSTRUCTOR +=item The Proof in the Pudding: Localizing Web Sites -new ( [ARGS] ) +=item References -=item METHODS +=back -accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, -protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) +=back -=item SEE ALSO +=head2 Locale::Script - ISO codes for script identification (ISO 15924) -=item AUTHOR +=over 4 -=item COPYRIGHT +=item SYNOPSIS -=back +=item DESCRIPTION -=head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for -AF_INET domain sockets +B, B, B =over 4 -=item SYNOPSIS +=item SPECIAL CODES -=item DESCRIPTION +=back -=item CONSTRUCTOR +=item CONVERSION ROUTINES -new ( [ARGS] ) +code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ), +script_code2code( CODE, CODESET, CODESET ) -=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::Language, Locale::Currency, Locale::Country, ISO 15924, +http://www.evertype.com/standards/iso15924/ + =item AUTHOR =item COPYRIGHT =back -=head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for -AF_UNIX domain sockets +=head2 MIME::Base64 - Encoding and decoding of base64 strings =over 4 @@ -20001,23 +21871,23 @@ AF_UNIX domain sockets =item DESCRIPTION -=item CONSTRUCTOR - -new ( [ARGS] ) - -=item METHODS +encode_base64($str), encode_base64($str, $eol);, decode_base64($str) -hostpath(), peerpath() +=item DIAGNOSTICS -=item SEE ALSO +Premature end of base64 data, Premature padding of base64 data, Wide +character in subroutine entry -=item AUTHOR +=item EXAMPLES =item COPYRIGHT +=item SEE ALSO + =back -=head2 IPC::Msg - SysV Msg IPC object class +=head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding +of quoted-printable strings =over 4 @@ -20025,21 +21895,17 @@ hostpath(), peerpath() =item DESCRIPTION -=item METHODS +encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode), +decode_qp($str); -new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set -( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, -FLAGS ] ), stat +=item COPYRIGHT =item SEE ALSO -=item AUTHOR - -=item COPYRIGHT - =back -=head2 IPC::Open2, open2 - open a process for both reading and writing +=head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable +strings =over 4 @@ -20047,14 +21913,16 @@ FLAGS ] ), stat =item DESCRIPTION -=item WARNING +encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode), +decode_qp($str); + +=item COPYRIGHT =item SEE ALSO =back -=head2 IPC::Open3, open3 - open a process for reading, writing, and error -handling +=head2 Math::BigFloat - Arbitrary size floating point math package =over 4 @@ -20062,75 +21930,58 @@ handling =item DESCRIPTION -=item WARNING - -=back - -=head2 IPC::Semaphore - SysV Semaphore IPC object class - =over 4 -=item SYNOPSIS - -=item DESCRIPTION +=item Canonical notation -=item METHODS +=item Output -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 C, C and C -=item SEE ALSO +=item Accuracy vs. Precision -=item AUTHOR +=item Rounding -=item COPYRIGHT +ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround ( +$scale +), fround ( -$scale ) and fround ( 0 ) =back -=head2 IPC::SysV - SysV IPC constants +=item METHODS =over 4 -=item SYNOPSIS - -=item DESCRIPTION - -ftok( PATH, ID ) - -=item SEE ALSO - -=item AUTHORS +=item accuracy -=item COPYRIGHT +=item precision() =back -=head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class +=item Autocreating constants =over 4 -=item SYNOPSIS +=item Math library + +=item Using Math::BigInt::Lite + +=back -=item DESCRIPTION +=item BUGS -=item METHODS +=item CAVEATS -new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set -( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, -FLAGS ] ), stat +stringify, bstr(), bdiv, Modifying and =, bpow, precision() vs. accuracy() =item SEE ALSO -=item AUTHOR +=item LICENSE -=item COPYRIGHT +=item AUTHORS =back -=head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object -class +=head2 Math::BigInt - Arbitrary size integer/float math package =over 4 @@ -20138,216 +21989,206 @@ class =item DESCRIPTION +Input, Output + =item METHODS -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 config -=item AUTHOR +=item accuracy -=item COPYRIGHT +=item precision -=back +=item brsft -=head2 List::Util - A selection of general-utility list subroutines +=item new -=over 4 +=item bnan -=item SYNOPSIS +=item bzero -=item DESCRIPTION +=item binf -first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce -BLOCK LIST, shuffle LIST, sum LIST +=item bone -=item KNOWN BUGS +=item is_one()/is_zero()/is_nan()/is_inf() -=item SUGGESTED ADDITIONS +=item is_pos()/is_neg() -=item COPYRIGHT + $x->is_pos(); # true if > 0 + $x->is_neg(); # true if < 0 -=back +=item is_odd()/is_even()/is_int() -=head2 List::Utilib::List::Util, List::Util - A selection of -general-utility list subroutines +=item bcmp -=over 4 +=item bacmp -=item SYNOPSIS +=item sign -=item DESCRIPTION +=item digit -first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce -BLOCK LIST, shuffle LIST, sum LIST +=item bneg -=item KNOWN BUGS +=item babs -=item SUGGESTED ADDITIONS +=item bnorm -=item COPYRIGHT +=item bnot -=back +=item binc -=head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of -general-utility scalar subroutines +=item bdec -=over 4 +=item badd -=item SYNOPSIS +=item bsub -=item DESCRIPTION +=item bmul -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 bdiv -=item KNOWN BUGS +=item bmod -=item COPYRIGHT +=item bmodinv -=item BLATANT PLUG +=item bmodpow -=back +=item bpow -=head2 Locale::Constants - constants for Locale codes +=item blsft -=over 4 +=item brsft -=item SYNOPSIS +=item band -=item DESCRIPTION +=item bior -=item KNOWN BUGS AND LIMITATIONS +=item bxor -=item SEE ALSO +=item bnot -Locale::Language, Locale::Country, Locale::Script, Locale::Currency +=item bsqrt -=item AUTHOR +=item bfac -=item COPYRIGHT +=item round -=back +=item bround -=head2 Locale::Country - ISO codes for country identification (ISO 3166) +=item bfround -=over 4 +=item bfloor -=item SYNOPSIS +=item bceil -=item DESCRIPTION +=item bgcd -B, B, B +=item blcm -=item CONVERSION ROUTINES +=item exponent -code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ), -country_code2code( CODE, CODESET, CODESET ) +=item mantissa -=item QUERY ROUTINES +=item parts -C, C +=item copy -=item SEMI-PRIVATE ROUTINES +=item as_int -=over 4 +=item bsstr -=item alias_code +=item as_hex -=item rename_country +=item as_bin =back -=item EXAMPLES +=item ACCURACY and PRECISION -=item DOMAIN NAMES +=over 4 -=item KNOWN BUGS AND LIMITATIONS +=item Precision P -=item SEE ALSO +=item Accuracy A -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 Fallback F -=item AUTHOR +=item Rounding mode R -=item COPYRIGHT +'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy +(significant digits), Setting/Accessing, Creating numbers, Usage, +Precedence, Overriding globals, Local settings, Rounding, Default values, +Remarks =back -=head2 Locale::Currency - ISO three letter codes for currency -identification (ISO 4217) - -=over 4 +=item Infinity and Not a Number -=item SYNOPSIS +oct()/hex(), log(-inf), exp(), cos(), sin(), atan2() -=item DESCRIPTION +=item INTERNALS -XTS, XXX +=over 4 -=item CONVERSION ROUTINES +=item MATH LIBRARY -code2currency(), currency2code() +=item SIGN -=item QUERY ROUTINES +=item mantissa(), exponent() and parts() -C, C +=back =item EXAMPLES -=item KNOWN BUGS AND LIMITATIONS + use Math::BigInt; -=item SEE ALSO +=item Autocreating constants -Locale::Country, Locale::Script, ISO 4217:1995, -http://www.bsi-global.com/iso4217currency +=item PERFORMANCE -=item AUTHOR +=over 4 -=item COPYRIGHT +=item Alternative math libraries + +=item SUBCLASSING =back -=head2 Locale::Language - ISO two letter codes for language identification -(ISO 639) +=item Subclassing Math::BigInt + +=item UPGRADING =over 4 -=item SYNOPSIS +=item Auto-upgrade -=item DESCRIPTION +bsqrt(), div(), blog() -=item CONVERSION ROUTINES +=back -code2language(), language2code() +=item BUGS -=item QUERY ROUTINES +broot() does not work, Out of Memory!, Fails to load Calc on Perl prior +5.6.0 -C, C +=item CAVEATS -=item EXAMPLES +bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity handling, +Modifying and =, bpow, Overloading -$x, Mixing different object types, +bsqrt(), brsft() -=item KNOWN BUGS AND LIMITATIONS +=item LICENSE =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 +=item AUTHORS =back -=head2 Locale::Maketext - framework for localization +=head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt =over 4 @@ -20355,50 +22196,58 @@ http://lcweb.loc.gov/standards/iso639-2/langhome.html =item DESCRIPTION -=item QUICK OVERVIEW +=item STORAGE =item METHODS -=over 4 +=item WRAP YOUR OWN -=item Construction Methods +=item LICENSE -=item The "maketext" Method +This program is free software; you may redistribute it and/or modify it +under +the same terms as Perl itself. -$lh->fail_with I $lh->fail_with(I), $lh->failure_handler_auto +=item AUTHORS -=item Utility Methods +=item SEE ALSO -$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() +=back -=item Language Handle Attributes and Internals +=head2 Math::BigInt::CalcEmu - Emulate low-level math with BigInt code -=back +=over 4 -=item LANGUAGE CLASS HIERARCHIES +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS + +=over 4 -=item ENTRIES IN EACH LEXICON +=item __emu_bxor -=item BRACKET NOTATION +=item __emu_band -=item AUTO LEXICONS +=item __emu_bior -=item CONTROLLING LOOKUP FAILURE +=back -=item HOW TO USE MAKETEXT +=item LICENSE -=item SEE ALSO +This program is free software; you may redistribute it and/or modify it +under +the same terms as Perl itself. -=item COPYRIGHT AND DISCLAIMER +=item AUTHORS -=item AUTHOR +=item SEE ALSO =back -=head2 Locale::Maketext::TPJ13 -- article about software localization +=head2 Math::BigInt::FastCalc - Math::BigInt::Calc with some XS for more +speed =over 4 @@ -20406,101 +22255,108 @@ $language->language_tag(), $language->encoding() =item DESCRIPTION -=item Localization and Perl: gettext breaks, Maketext fixes - -=over 4 +=item STORAGE -=item A Localization Horror Story: It Could Happen To You +=item METHODS -=item The Linguistic View +=item LICENSE -=item Breaking gettext +This program is free software; you may redistribute it and/or modify it +under +the same terms as Perl itself. -=item Replacing gettext +=item AUTHORS -=item Buzzwords: Abstraction and Encapsulation +=item SEE ALSO -=item Buzzword: Isomorphism +=back -=item Buzzword: Inheritance +=head2 Math::BigRat - Arbitrary big rational numbers -=item Buzzword: Concision +=over 4 -=item The Devil in the Details +=item SYNOPSIS -=item The Proof in the Pudding: Localizing Web Sites +=item DESCRIPTION -=item References +=over 4 -=back +=item MATH LIBRARY =back -=head2 Locale::Script - ISO codes for script identification (ISO 15924) +=item METHODS =over 4 -=item SYNOPSIS +=item new() -=item DESCRIPTION +=item numerator() -B, B, B +=item denominator() -=over 4 + $d = $x->denominator(); -=item SPECIAL CODES +=item parts() -=back +=item as_int() -=item CONVERSION ROUTINES +=item as_hex() -code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ), -script_code2code( CODE, CODESET, CODESET ) +=item as_bin() -=item QUERY ROUTINES +=item bfac() -C, C +=item blog() -=item EXAMPLES +=item bround()/round()/bfround() -=item KNOWN BUGS AND LIMITATIONS +=item bmod() -=item SEE ALSO +=item is_one() -Locale::Language, Locale::Currency, Locale::Country, ISO 15924, -http://www.evertype.com/standards/iso15924/ +=item is_zero() -=item AUTHOR +=item is_pos() -=item COPYRIGHT +=item is_neg() -=back +=item is_int() -=head2 MIME::Base64 - Encoding and decoding of base64 strings +=item is_odd() -=over 4 +=item is_even() -=item SYNOPSIS +=item bceil() -=item DESCRIPTION +=item bfloor() -encode_base64($str), encode_base64($str, $eol);, decode_base64($str) + $x->bfloor(); -=item DIAGNOSTICS +=item bsqrt() -Premature end of base64 data, Premature padding of base64 data, Wide -character in subroutine entry + $x->bsqrt(); -=item EXAMPLES +=item config -=item COPYRIGHT +=back + +=item BUGS + +inf handling (partial), NaN handling (partial), rounding (not implemented +except for bceil/bfloor), $x ** $y where $y is not an integer, bmod(), +blog(), bmodinv() and bmodpow() (partial) + +=item LICENSE =item SEE ALSO +=item AUTHORS + =back -=head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding -of quoted-printable strings +=head2 Math::Complex - complex numbers and associated mathematical +functions =over 4 @@ -20508,34 +22364,31 @@ of quoted-printable strings =item DESCRIPTION -encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode), -decode_qp($str); +=item OPERATIONS -=item COPYRIGHT +=item CREATION -=item SEE ALSO +=item DISPLAYING -=back +=over 4 -=head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable -strings +=item CHANGED IN PERL 5.6 -=over 4 +=back -=item SYNOPSIS +=item USAGE -=item DESCRIPTION +=item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO -encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode), -decode_qp($str); +=item ERRORS DUE TO INDIGESTIBLE ARGUMENTS -=item COPYRIGHT +=item BUGS -=item SEE ALSO +=item AUTHORS =back -=head2 Math::BigFloat - Arbitrary size floating point math package +=head2 Math::Trig - trigonometric functions =over 4 @@ -20543,58 +22396,50 @@ decode_qp($str); =item DESCRIPTION -=over 4 - -=item Canonical notation - -=item Output +=item TRIGONOMETRIC FUNCTIONS -=item C, C and C +B -=item Accuracy vs. Precision +=over 4 -=item Rounding +=item ERRORS DUE TO DIVISION BY ZERO -ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround ( +$scale -), fround ( -$scale ) and fround ( 0 ) +=item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS =back -=item METHODS +=item PLANE ANGLE CONVERSIONS + +=item RADIAL COORDINATE CONVERSIONS =over 4 -=item accuracy +=item COORDINATE SYSTEMS -=item precision() +=item 3-D ANGLE CONVERSIONS + +cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian, +cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical =back -=item Autocreating constants +=item GREAT CIRCLE DISTANCES AND DIRECTIONS -=over 4 +=item EXAMPLES -=item Math library +=over 4 -=item Using Math::BigInt::Lite +=item CAVEAT FOR GREAT CIRCLE FORMULAS =back =item BUGS -=item CAVEATS - -stringify, bstr(), bdiv, Modifying and =, bpow, precision() vs. accuracy() - -=item SEE ALSO - -=item LICENSE - =item AUTHORS =back -=head2 Math::BigInt - Arbitrary size integer/float math package +=head2 Memoize - Make functions faster by trading space for time =over 4 @@ -20602,265 +22447,287 @@ stringify, bstr(), bdiv, Modifying and =, bpow, precision() vs. accuracy() =item DESCRIPTION -Input, Output +=item DETAILS -=item METHODS +=item OPTIONS =over 4 -=item config - -=item accuracy - -=item precision - -=item brsft - -=item new - -=item bnan - -=item bzero - -=item binf - -=item bone - -=item is_one()/is_zero()/is_nan()/is_inf() - -=item is_pos()/is_neg() - - $x->is_pos(); # true if > 0 - $x->is_neg(); # true if < 0 - -=item is_odd()/is_even()/is_int() - -=item bcmp +=item INSTALL -=item bacmp +=item NORMALIZER -=item sign +=item C, C -=item digit +C, C, C, C, C -=item bneg +=back -=item babs +=item OTHER FACILITIES -=item bnorm +=over 4 -=item bnot +=item C -=item binc +=item C -=item bdec +=back -=item badd +=item CAVEATS -=item bsub +=item PERSISTENT CACHE SUPPORT -=item bmul +=item EXPIRATION SUPPORT -=item bdiv +=item BUGS -=item bmod +=item MAILING LIST -=item bmodinv +=item AUTHOR -=item bmodpow +=item COPYRIGHT AND LICENSE -=item bpow +=item THANK YOU -=item blsft +=back -=item brsft +=head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for +Storable use -=item band +=over 4 -=item bior +=item DESCRIPTION -=item bxor +=back -=item bnot +=head2 Memoize::Expire - Plug-in module for automatic expiration of +memoized values -=item bsqrt +=over 4 -=item bfac +=item SYNOPSIS -=item round +=item DESCRIPTION -=item bround +=item INTERFACE -=item bfround + TIEHASH, EXISTS, STORE -=item bfloor +=item ALTERNATIVES -=item bceil +=item CAVEATS -=item bgcd +=item AUTHOR -=item blcm +=item SEE ALSO -=item exponent +=back -=item mantissa +=head2 Memoize::ExpireFile - test for Memoize expiration semantics -=item parts +=over 4 -=item copy +=item DESCRIPTION -=item as_int +=back -=item bsstr +=head2 Memoize::ExpireTest - test for Memoize expiration semantics -=item as_hex +=over 4 -=item as_bin +=item DESCRIPTION =back -=item ACCURACY and PRECISION +=head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for +Storable use =over 4 -=item Precision P +=item DESCRIPTION -=item Accuracy A +=back -=item Fallback F +=head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for +Storable use -=item Rounding mode R +=over 4 -'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy -(significant digits), Setting/Accessing, Creating numbers, Usage, -Precedence, Overriding globals, Local settings, Rounding, Default values, -Remarks +=item DESCRIPTION =back -=item Infinity and Not a Number +=head2 Memoize::Storable - store Memoized data in Storable database -oct()/hex(), log(-inf), exp(), cos(), sin(), atan2() +=over 4 -=item INTERNALS +=item DESCRIPTION -=over 4 +=back -=item MATH LIBRARY +=head2 Module::Build - Build and install Perl modules -=item SIGN +=over 4 -=item mantissa(), exponent() and parts() +=item SYNOPSIS -=back +=item DESCRIPTION -=item EXAMPLES +=item GUIDE TO DOCUMENTATION - use Math::BigInt; +General Usage (L), Authoring Reference +(L), API Reference (L), +Cookbook (L) -=item Autocreating constants +=item ACTIONS -=item PERFORMANCE +build, clean, code, config_data, diff, dist, distcheck, distclean, distdir, +distmeta, distsign, disttest, docs, fakeinstall, help, html, install, +manifest, manpages, ppd, ppmdist, prereq_report, pure_install, realclean, +skipcheck, test, testcover, testdb, testpod, testpodcoverage, +versioninstall + +=item OPTIONS =over 4 -=item Alternative math libraries +=item Command Line Options -=item SUBCLASSING +quiet, use_rcfile, verbose + +=item Default Options File (F<.modulebuildrc>) =back -=item Subclassing Math::BigInt +=item INSTALL PATHS -=item UPGRADING +lib, arch, script, bin, bindoc, libdoc, binhtml, libhtml, installdirs, +install_path, install_base, destdir =over 4 -=item Auto-upgrade +=item About PREFIX Support -bsqrt(), div(), blog() +Why PREFIX is not recommended, Alternatives to PREFIX =back -=item BUGS +=item MOTIVATIONS -broot() does not work, Out of Memory!, Fails to load Calc on Perl prior -5.6.0 ++, + -=item CAVEATS +=item TO DO -bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity handling, -Modifying and =, bpow, Overloading -$x, Mixing different object types, -bsqrt(), brsft() +=item AUTHOR -=item LICENSE +=item COPYRIGHT =item SEE ALSO -=item AUTHORS - =back -=head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt +=head2 Module::Build::API - API Reference for Module Authors =over 4 -=item SYNOPSIS - =item DESCRIPTION -=item STORAGE +=over 4 + +=item CONSTRUCTORS + +current(), new(), add_to_cleanup, auto_features, autosplit, build_class, +build_requires, create_packlist, c_source, conflicts, create_makefile_pl, +create_readme, dist_abstract, dist_author, dist_name, dist_version, +dist_version_from, dynamic_config, extra_compiler_flags, +extra_linker_flags, get_options, type, store, default, include_dirs, +install_path, installdirs, license, apache, artistic, bsd, gpl, lgpl, mit, +mozilla, open_source, perl, restrictive, unrestricted, meta_add, +meta_merge, module_name, PL_files, pm_files, pod_files, recommends, +recursive_test_files, requires, script_files, sign, test_files, xs_files, +new_from_context(%args), resume(), subclass() =item METHODS -=item WRAP YOUR OWN +add_build_element($type), add_to_cleanup(@files), args(), +autosplit_file($from, $to), base_dir(), build_requires(), +check_installed_status($module, $version), check_installed_version($module, +$version), compare_versions($v1, $op, $v2), config(), config_data($name), +config_data($name => $value), conflicts(), contains_pod($file), +copy_if_modified(%parameters), create_build_script(), current_action(), +depends_on(@actions), dir_contains($first_dir, $second_dir), +dispatch($action, %args), dist_dir(), dist_name(), dist_version(), +do_system($cmd, @args), feature($name), feature($name => $value), +have_c_compiler(), install_base_relpaths(), install_base_relpaths($type), +install_base_relpaths($type => $path), install_destination($type), +install_path(), install_path($type), install_path($type => $path), +install_types(), invoked_action(), notes(), notes($key), notes($key => +$value), orig_dir(), os_type(), prefix_relpaths(), +prefix_relpaths($installdirs), prefix_relpaths($installdirs, $type), +prefix_relpaths($installdirs, $type => $path), prepare_metadata(), +prereq_failures(), prereq_report(), prompt($message, $default), +recommends(), requires(), rscan_dir($dir, $pattern), runtime_params(), +runtime_params($key), script_files(), up_to_date($source_file, +$derived_file), up_to_date(\@source_files, \@derived_files), y_n($message, +$default) + +=item Autogenerated Accessors + +PL_files(), autosplit(), base_dir(), bindoc_dirs(), blib(), build_bat(), +build_class(), build_elements(), build_requires(), build_script(), +c_source(), config(), config_dir(), conflicts(), create_makefile_pl(), +create_packlist(), create_readme(), debugger(), destdir(), get_options(), +html_css(), include_dirs(), install_base(), install_sets(), installdirs(), +libdoc_dirs(), license(), magic_number(), mb_version(), meta_add(), +meta_merge(), metafile(), module_name(), orig_dir(), original_prefix(), +perl(), pm_files(), pod_files(), pollute(), prefix(), +prereq_action_types(), quiet(), recommends(), recurse_into(), +recursive_test_files(), requires(), scripts(), use_rcfile(), verbose(), +xs_files() -=item LICENSE +=back -This program is free software; you may redistribute it and/or modify it -under -the same terms as Perl itself. +=item AUTHOR -=item AUTHORS +=item COPYRIGHT =item SEE ALSO =back -=head2 Math::BigInt::CalcEmu - Emulate low-level math with BigInt code +=head2 Module::Build::Authoring - Authoring Module::Build modules =over 4 -=item SYNOPSIS - =item DESCRIPTION -=item METHODS +=item STRUCTURE -=over 4 +=item SUBCLASSING -=item __emu_bxor +=item PREREQUISITES -=item __emu_band +=over 4 -=item __emu_bior +=item Format of prerequisites =back -=item LICENSE +=item SAVING CONFIGURATION INFORMATION -This program is free software; you may redistribute it and/or modify it -under -the same terms as Perl itself. +=item STARTING MODULE DEVELOPMENT -=item AUTHORS +=item AUTOMATION + +=item MIGRATION + +=item AUTHOR =item SEE ALSO =back -=head2 Math::BigInt::FastCalc - Math::BigInt::Calc with some XS for more -speed +=head2 Module::Build::Base - Default methods for Module::Build =over 4 @@ -20868,23 +22735,38 @@ speed =item DESCRIPTION -=item STORAGE +=item AUTHOR + +=item COPYRIGHT + +=item SEE ALSO + +=back + +=head2 Module::Build::Compat - Compatibility with ExtUtils::MakeMaker + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION =item METHODS -=item LICENSE +create_makefile_pl($style, $build), small, passthrough, traditional, +run_build_pl(args => \@ARGV), args, script, write_makefile(), makefile -This program is free software; you may redistribute it and/or modify it -under -the same terms as Perl itself. +=item SCENARIOS -=item AUTHORS +=item AUTHOR + +=item COPYRIGHT =item SEE ALSO =back -=head2 Math::BigRat - Arbitrary big rational numbers +=head2 Module::Build::ConfigData - Configuration for Module::Build =over 4 @@ -20892,84 +22774,100 @@ the same terms as Perl itself. =item DESCRIPTION -=over 4 +=item METHODS -=item MATH LIBRARY +config($name), feature($name), set_config($name, $value), +set_feature($name, $value), config_names(), feature_names(), +auto_feature_names(), write() + +=item AUTHOR =back -=item METHODS +=head2 Module::Build::Cookbook - Examples of Module::Build Usage =over 4 -=item new() +=item DESCRIPTION -=item numerator() +=item BASIC RECIPES -=item denominator() +=over 4 - $d = $x->denominator(); +=item The basic installation recipe for modules that use Module::Build -=item parts() +=item Making a CPAN.pm-compatible distribution -=item as_int() +=item Installing modules using the programmatic interface -=item as_hex() +=item Installing to a temporary directory -=item as_bin() +=item Installing to a non-standard directory -=item bfac() +=item Running a single test file -=item blog() +=back -=item bround()/round()/bfround() +=item ADVANCED RECIPES -=item bmod() +=over 4 -=item is_one() +=item Changing the order of the build process -=item is_zero() +=item Adding new file types to the build process -=item is_pos() +=item Adding new elements to the install process -=item is_neg() +=back -=item is_int() +=item EXAMPLES ON CPAN -=item is_odd() +=over 4 -=item is_even() +=item SVN-Notify-Mirror -=item bceil() +1. Using C, I check to see whether two optional modules are +available - SVN::Notify::Config and Net::SSH;, 2. If the S::N::Config +module is loaded, I automatically generate testfiles for it during Build +(using the C property), 3. If the C is available, I +ask if the user wishes to perform the ssh tests (since it requires a little +preliminary setup);, 4. Only if the user has C and answers yes +to the testing, do I generate a test file -=item bfloor() +=item Modifying an action - $x->bfloor(); +=back -=item bsqrt() +=item AUTHOR - $x->bsqrt(); +=item COPYRIGHT -=item config +=item SEE ALSO =back -=item BUGS +=head2 Module::Build::ModuleInfo, ModuleInfo - Gather package and POD +information from a perl module files -inf handling (partial), NaN handling (partial), rounding (not implemented -except for bceil/bfloor), $x ** $y where $y is not an integer, bmod(), -blog(), bmodinv() and bmodpow() (partial) +=over 4 -=item LICENSE +=item DESCRIPTION -=item SEE ALSO +new_from_file($filename, collect_pod => 1), new_from_module($module, +collect_pod => 1, inc => \@dirs), name(), version($package), filename(), +packages_inside(), pod_inside(), contains_pod(), pod($section), +find_module_by_name($module, \@dirs), find_module_dir_by_name($module, +\@dirs) -=item AUTHORS +=item AUTHOR + +=item COPYRIGHT + +=item SEE ALSO =back -=head2 Math::Complex - complex numbers and associated mathematical -functions +=head2 Module::Build::Notes, $notes_name - Configuration for $module_name =over 4 @@ -20977,205 +22875,241 @@ functions =item DESCRIPTION -=item OPERATIONS +=item METHODS -=item CREATION +config(\$name), feature(\$name), set_config(\$name, \$value), +set_feature(\$name, \$value), config_names(), feature_names(), +auto_feature_names(), write() -=item DISPLAYING +=item AUTHOR + +=back + +=head2 Module::Build::PPMMaker - Perl Package Manager file creation =over 4 -=item CHANGED IN PERL 5.6 +=item SYNOPSIS + +=item DESCRIPTION + +=item AUTHOR + +=item COPYRIGHT + +=item SEE ALSO =back -=item USAGE +=head2 Module::Build::Platform::Amiga - Builder class for Amiga platforms -=item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO +=over 4 -=item ERRORS DUE TO INDIGESTIBLE ARGUMENTS +=item DESCRIPTION -=item BUGS +=item AUTHOR -=item AUTHORS +=item SEE ALSO =back -=head2 Math::Trig - trigonometric functions +=head2 Module::Build::Platform::Default - Stub class for unknown platforms =over 4 -=item SYNOPSIS - =item DESCRIPTION -=item TRIGONOMETRIC FUNCTIONS +=item AUTHOR -B +=item SEE ALSO + +=back + +=head2 Module::Build::Platform::EBCDIC - Builder class for EBCDIC platforms =over 4 -=item ERRORS DUE TO DIVISION BY ZERO +=item DESCRIPTION -=item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS +=item AUTHOR -=back +=item SEE ALSO -=item PLANE ANGLE CONVERSIONS +=back -=item RADIAL COORDINATE CONVERSIONS +=head2 Module::Build::Platform::MPEiX - Builder class for MPEiX platforms =over 4 -=item COORDINATE SYSTEMS +=item DESCRIPTION -=item 3-D ANGLE CONVERSIONS +=item AUTHOR -cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian, -cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical +=item SEE ALSO =back -=item GREAT CIRCLE DISTANCES AND DIRECTIONS +=head2 Module::Build::Platform::MacOS - Builder class for MacOS platforms -=item EXAMPLES +=over 4 + +=item DESCRIPTION =over 4 -=item CAVEAT FOR GREAT CIRCLE FORMULAS +=item Overriden Methods + +new(), make_executable(), dispatch(), ACTION_realclean() =back -=item BUGS +=item AUTHOR -=item AUTHORS +=item SEE ALSO =back -=head2 Memoize - Make functions faster by trading space for time +=head2 Module::Build::Platform::RiscOS - Builder class for RiscOS platforms =over 4 -=item SYNOPSIS - =item DESCRIPTION -=item DETAILS +=item AUTHOR -=item OPTIONS +=item SEE ALSO -=over 4 +=back -=item INSTALL +=head2 Module::Build::Platform::Unix - Builder class for Unix platforms -=item NORMALIZER +=over 4 -=item C, C +=item DESCRIPTION -C, C, C, C, C +=item AUTHOR + +=item SEE ALSO =back -=item OTHER FACILITIES +=head2 Module::Build::Platform::VMS - Builder class for VMS platforms =over 4 -=item C +=item DESCRIPTION -=item C +=over 4 + +=item Overridden Methods + +new =back -=item CAVEATS +=back -=item PERSISTENT CACHE SUPPORT +cull_args -=item EXPIRATION SUPPORT +manpage_separator -=item BUGS +prefixify -=item MAILING LIST +=over 4 =item AUTHOR -=item COPYRIGHT AND LICENSE - -=item THANK YOU +=item SEE ALSO =back -=head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for -Storable use +=head2 Module::Build::Platform::VOS - Builder class for VOS platforms =over 4 =item DESCRIPTION +=item AUTHOR + +=item SEE ALSO + =back -=head2 Memoize::Expire - Plug-in module for automatic expiration of -memoized values +=head2 Module::Build::Platform::Windows - Builder class for Windows +platforms =over 4 -=item SYNOPSIS - =item DESCRIPTION -=item INTERFACE - - TIEHASH, EXISTS, STORE - -=item ALTERNATIVES - -=item CAVEATS - =item AUTHOR =item SEE ALSO =back -=head2 Memoize::ExpireFile - test for Memoize expiration semantics +=head2 Module::Build::Platform::aix - Builder class for AIX platform =over 4 =item DESCRIPTION +=item AUTHOR + +=item SEE ALSO + =back -=head2 Memoize::ExpireTest - test for Memoize expiration semantics +=head2 Module::Build::Platform::cygwin - Builder class for Cygwin platform =over 4 =item DESCRIPTION +=item AUTHOR + +=item SEE ALSO + =back -=head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for -Storable use +=head2 Module::Build::Platform::darwin - Builder class for Mac OS X +platform =over 4 =item DESCRIPTION +=item AUTHOR + +=item SEE ALSO + =back -=head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for -Storable use +=head2 Module::Build::Platform::os2 - Builder class for OS/2 platform =over 4 =item DESCRIPTION +=item AUTHOR + +=item SEE ALSO + =back -=head2 Memoize::Storable - store Memoized data in Storable database +=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 @@ -22264,13 +24198,21 @@ C<-inc =E 1>, C<-dirs =E [ $dir1, $dir2, ... ]>, C<-verbose =E =item DESCRIPTION -=item ARGUMENTS +=item FUNCTIONS + +=over 4 + +=item pod2html backlink, cachedir, css, flush, header, help, hiddendirs, htmldir, htmlroot, index, infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse, title, verbose -=item EXAMPLE +=item htmlify + +=item anchorify + +=back =item ENVIRONMENT @@ -24750,26 +26692,25 @@ C<$Test::Harness::Timer> =item Failure -B, B, B, B, B, B, B +B, B, B, B, B, B -=item Functions +=back -B +=item FUNCTIONS -=back +=over 4 -=back +=item runtests( @test_files ) -B<_all_ok> +=back -B<_globdir> +=back -B<_run_all_tests> +=over 4 -B<_mk_leader> +=item execute_tests( tests => \@test_files, out => \*FH ) -B<_leader_width> +=back =over 4 @@ -24789,8 +26730,8 @@ C, C =item ENVIRONMENT VARIABLES THAT AFFECT TEST::HARNESS C, C, C, -C, C, C, -C, C, C +C, C, C, +C, C, C =item EXAMPLE @@ -24800,6 +26741,13 @@ C, C, C =item BUGS +=item SUPPORT + +AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request +tracker, Search CPAN + +=item SOURCE CODE + =item AUTHORS =item COPYRIGHT @@ -24900,12 +26848,6 @@ ok, number =over 4 -=item $strap->_init - -=back - -=over 4 - =item ANALYSIS =over 4 @@ -24918,86 +26860,14 @@ ok, number =over 4 -=item $strap->analyze_fh( $name, $test_filehandle ) - -=back - -=over 4 - =item $strap->analyze_file( $test_file ) =back =over 4 -=item $strap->_command_line( $file ) - -=back - -=over 4 - -=item $strap->_command() - -=back - -=over 4 - -=item $strap->_switches( $file ) - -=back - -=over 4 - -=item $strap->_cleaned_switches( @switches_from_user ) - -=back - -=over 4 - -=item $strap->_INC2PERL5LIB - -=back - -=over 4 - -=item $strap->_filtered_INC() - -=back - -=over 4 - -=item $strap->_restore_PERL5LIB() - -=back - -=over 4 - =item Parsing -=over 4 - -=item C<_is_diagnostic> - -=back - -=back - -=over 4 - -=item C<_is_header> - -=back - -=over 4 - -=item C<_is_bail_out> - -=back - -=over 4 - -=item C<_reset_file_state> - =back =over 4 @@ -25080,6 +26950,25 @@ C or C, Test number, Description, Directive, ok/not ok =back +=item Non-Perl TAP + +=over 4 + +=item C/C++ + +Specify a test plan, Run tests, Skip tests in certain situations, Have TODO +tests, Produce TAP compatible diagnostics + +=item Python + +=item JavaScript + +=item PHP + +phpt, PHPUnit, SimpleTest, Apache-Test + +=back + =item AUTHORS =item ACKNOWLEDGEMENTS @@ -25088,6 +26977,36 @@ C or C, Test number, Description, Directive, ok/not ok =back +=head2 Test::Harness::Util - Utility functions for Test::Harness::* + +=over 4 + +=item SYNOPSIS + +=item PUBLIC FUNCTIONS + +=over 4 + +=item all_in( {parm => value, parm => value} ) + +start, recurse + +=back + +=back + +=over 4 + +=item shuffle( @list ) + +=back + +=over 4 + +=item blibdir() + +=back + =head2 Test::More - yet another framework for writing test scripts =over 4 @@ -25344,6 +27263,8 @@ C $listref>, C $listref>, C $str>, =item C +=item C + =back =item DIAGNOSTICS @@ -25672,9 +27593,15 @@ this, SCALAR this =item EXAMPLE -=item AUTHOR +=item THREAD SUPPORT -=item VERSION +=item STORABLE SUPPORT + +=item RELIC SUPPORT + +=item MAINTAINER + +=item AUTHOR =item SEE ALSO