From: Nicholas Clark Date: Sun, 12 Apr 2009 09:47:47 +0000 (+0100) Subject: Rebuild pod/perltoc.pod. X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=718f7b5acf0cecec8f4d4ff2a7f3943219fe44f4;p=p5sagit%2Fp5-mst-13.2.git Rebuild pod/perltoc.pod. --- diff --git a/pod/perltoc.pod b/pod/perltoc.pod index 1d57ee1..a220f8e 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -216,7 +216,7 @@ X X =back =item HASHES OF HASHES -X X +X X =over 4 @@ -431,7 +431,7 @@ X X X =item The SUPER way of doing things -=item Where we're at so far... +=item Let's review... =item A horse is a horse, of course of course -- or is it? @@ -1217,6 +1217,8 @@ from decimal to binary =item Does Perl have a Year 2000 problem? Is Perl Y2K compliant? +=item Does Perl have a Year 2038 problem? + =back =item Data: Strings @@ -1930,7 +1932,7 @@ X X X X X X X X<0> =item Statement Modifiers X X X X X -X X X +X X X X =item Compound Statements X X X X X @@ -2891,10 +2893,11 @@ $MATCH, $& X<$&> X<$MATCH>, ${^MATCH} X<${^MATCH}>, $PREMATCH, $` X<$`> X<$PREMATCH>, ${^PREMATCH} X<${^PREMATCH}>, $POSTMATCH, $' X<$'> X<$POSTMATCH>, ${^POSTMATCH} X<${^POSTMATCH}>, $LAST_PAREN_MATCH, $+ X<$+> X<$LAST_PAREN_MATCH>, $LAST_SUBMATCH_RESULT, $^N X<$^N>, @LAST_MATCH_END, -@+ X<@+> X<@LAST_MATCH_END>, %+ X<%+>, HANDLE->input_line_number(EXPR), -$INPUT_LINE_NUMBER, $NR, $. X<$.> X<$NR> X<$INPUT_LINE_NUMBER> X, IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, -$RS, $/ X<$/> X<$RS> X<$INPUT_RECORD_SEPARATOR>, HANDLE->autoflush(EXPR), +@+ X<@+> X<@LAST_MATCH_END>, %LAST_PAREN_MATCH, %+ X<%+>, +HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $. X<$.> X<$NR> +X<$INPUT_LINE_NUMBER> X, +IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/ +X<$/> X<$RS> X<$INPUT_RECORD_SEPARATOR>, HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $| X<$|> X X X<$OUTPUT_AUTOFLUSH>, IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $, X<$,> X<$OFS> X<$OUTPUT_FIELD_SEPARATOR>, @@ -3265,8 +3268,8 @@ X X X =item Default UNIVERSAL methods X -isa(CLASS) X, DOES(ROLE), can(METHOD) X, VERSION( [NEED] ) -X +isa(CLASS) X, DOES(ROLE) X, can(METHOD) X, VERSION( [NEED] +) X =item Destructors X X @@ -4070,6 +4073,8 @@ classes, Use of "Is" Prefix, Blocks =item Speed +=item Possible problems on EBCDIC platforms + =item Porting code from perl-5.6.X =back @@ -4193,7 +4198,7 @@ range? =item EBCDIC -=item 13 variant characters +=item The 13 variant characters =item 0037 @@ -5861,6 +5866,11 @@ 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 perl.h + +PERL_SYS_INIT X, PERL_SYS_INIT3 X, +PERL_SYS_TERM X + =item Functions in file pp_ctl.c find_runcv X @@ -6081,9 +6091,10 @@ 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 +sv_utf8_upgrade_flags X, sv_utf8_upgrade_nomg +X, sv_vcatpvf X, sv_vcatpvfn +X, sv_vcatpvf_mg X, sv_vsetpvf X, +sv_vsetpvfn X, sv_vsetpvf_mg X =item Unicode Support @@ -6165,8 +6176,8 @@ mg_localize X =item MRO Functions -mro_get_linear_isa_c3 X, mro_get_linear_isa_dfs -X, mro_isa_changed_in X +mro_get_linear_isa_dfs X, mro_isa_changed_in +X =item Pad Data Structures @@ -6329,20 +6340,6 @@ Does it create too much work?, Patches speak louder than words =item Keeping in sync -rsync'ing the source tree, Using rsync over the LAN, Using pushing over the -NFS, rsync'ing the patches - -=item Why rsync the source tree - -It's easier to rsync the source tree, It's more reliable - -=item Why rsync the patches - -It's easier to rsync the patches, It's a good reference, Finding a start -point, Finding how to fix a bug, Finding the source of misbehaviour - -=item Working with the source - =item Perlbug administration =item Submitting patches @@ -6487,6 +6484,8 @@ I =item AUTHOR +=item SEE ALSO + =back =head2 perlrepository - Using the Perl source repository @@ -6517,8 +6516,32 @@ I =item SUBMITTING A PATCH +=over 4 + +=item A note on derived files + +=item A note on binary files + +=item Getting your patch accepted + +Comments, Comments, Comments, Style, Testsuite + +=back + =item ACCEPTING A PATCH +=item CLEANING A WORKING DIRECTORY + +=item BISECTING + +=item SUBMITTING A PATCH VIA GITHUB + +=item MERGING FROM A BRANCH VIA GITHUB + +=item COMMITTING TO MAINTENANCE VERSIONS + +=item SEE ALSO + =back =head2 perlbook - Perl book information @@ -6579,8 +6602,6 @@ L, L, L =item POD -E HTML conversion in the core still sucks -=item merge checkpods and podchecker - =item Parallel testing =item Make Schwern poorer @@ -6641,8 +6662,6 @@ C (in F), C (in F) =item -Duse32bit* -=item Make it clear from -v if this is the exact official release - =item Profile Perl - am I hot or not? =item Allocate OPs from arenas @@ -6719,8 +6738,6 @@ C (in F), C (in F) =item Attach/detach debugger from running program -=item Optimize away empty destructors - =item LVALUE functions for lists =item regexp optimiser optional @@ -6796,6 +6813,8 @@ B<-V> =item CHANGES +=item SEE ALSO + =item AUTHOR =back @@ -6840,8 +6859,18 @@ B<-V> =item Core Enhancements +=item The C pragma + =item Modules and Pragmata +=over 4 + +=item Pragmata Changes + +C + +=back + =item Utility Changes =item Documentation @@ -6852,6 +6881,8 @@ B<-V> =item Selected Bug Fixes +C<-I> on shebang line now adds directories in front of @INC + =item New or Changed Diagnostics =item Changed Internals @@ -6880,8 +6911,18 @@ B<-V> =item Core Enhancements +=item The C pragma + =item Modules and Pragmata +=over 4 + +=item Pragmata Changes + +C + +=back + =item Utility Changes =item Documentation @@ -6892,6 +6933,8 @@ B<-V> =item Selected Bug Fixes +C<-I> on shebang line now adds directories in front of @INC + =item New or Changed Diagnostics =item Changed Internals @@ -7279,8 +7322,6 @@ C, C, C, C =back -=item Performance Enhancements - =item Installation and Configuration Improvements =over 4 @@ -7315,14 +7356,6 @@ C, C, C, C =item Changed Internals -=item Known Problems - -=over 4 - -=item Platform Specific Problems - -=back - =item Reporting Bugs =item SEE ALSO @@ -7859,8 +7892,6 @@ Win32::GetOSVersion =item New Documentation -=item Performance Enhancements - =item Installation and Configuration Improvements =over 4 @@ -11849,7 +11880,7 @@ Steve Hay Esteve.hay@uk.radan.comE =head1 PRAGMA DOCUMENTATION -=head2 attrs - set/get attributes of a subroutine (deprecated) +=head2 mro - Method Resolution Order =over 4 @@ -11857,7 +11888,79 @@ Steve Hay Esteve.hay@uk.radan.comE =item DESCRIPTION -method, locked +=item OVERVIEW + +=item The C3 MRO + +=over 4 + +=item What is C3? + +=item How does C3 work + +=back + +=item Functions + +=over 4 + +=item mro::get_linear_isa($classname[, $type]) + +=item mro::set_mro($classname, $type) + +=item mro::get_mro($classname) + +=item mro::get_isarev($classname) + +=item mro::is_universal($classname) + +=item mro::invalidate_all_method_caches() + +=item mro::method_changed_in($classname) + +=item mro::get_pkg_gen($classname) + +=item next::method + +=item next::can + +=item maybe::next::method + +=back + +=item SEE ALSO + +=over 4 + +=item The original Dylan paper + +L + +=item The prototype Perl 6 Object Model uses C3 + +L + +=item Parrot now uses C3 + +L, +L + +=item Python 2.3 MRO related links + +L, +L + +=item C3 for TinyCLOS + +L + +=item Class::C3 + +L + +=back + +=item AUTHOR =back @@ -11895,8 +11998,8 @@ regnames($all), regnames_count() =back -=head2 threadshared::shared, threads::shared - Perl extension for sharing -data structures between threads +=head2 threads-shared, threads::shared - Perl extension for sharing data +structures between threads =over 4 @@ -12032,7 +12135,7 @@ CPAN Version of L =item Built-in Attributes -locked, method, lvalue +lvalue, method, locked =item Available Subroutines @@ -12452,6 +12555,28 @@ escapes =back +=head2 deprecate - Perl pragma for deprecating the core version of a module + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item EXPORT + +=back + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT AND LICENSE + +=back + =head2 diagnostics, splain - produce verbose warning diagnostics =over 4 @@ -12739,90 +12864,6 @@ operations =back -=head2 mro - Method Resolution Order - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=item OVERVIEW - -=item The C3 MRO - -=over 4 - -=item What is C3? - -=item How does C3 work - -=back - -=item Functions - -=over 4 - -=item mro::get_linear_isa($classname[, $type]) - -=item mro::set_mro($classname, $type) - -=item mro::get_mro($classname) - -=item mro::get_isarev($classname) - -=item mro::is_universal($classname) - -=item mro::invalidate_all_method_caches() - -=item mro::method_changed_in($classname) - -=item mro::get_pkg_gen($classname) - -=item next::method - -=item next::can - -=item maybe::next::method - -=back - -=item SEE ALSO - -=over 4 - -=item The original Dylan paper - -L - -=item The prototype Perl 6 Object Model uses C3 - -L - -=item Parrot now uses C3 - -L, -L - -=item Python 2.3 MRO related links - -L, -L - -=item C3 for TinyCLOS - -L - -=item Class::C3 - -L - -=back - -=item AUTHOR - -=back - =head2 open - perl pragma to set default PerlIO layers for input and output =over 4 @@ -12877,7 +12918,8 @@ C<++> and C<-->, C and other assignment versions I, I, I, I, I, I, I, I, I +and numeric conversion>, I, I, I, +I =item Inheritance and overloading @@ -12945,6 +12987,8 @@ integer, float, binary, q, qr =item AUTHOR +=item SEE ALSO + =item DIAGNOSTICS Odd number of arguments for overload::constant, `%s' is not an overloadable @@ -12954,6 +12998,19 @@ type, `%s' is not a code reference =back +=head2 overloading - perl pragma to lexically control overloading + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +C, C, C, C + +=back + =head2 parent - Establish an ISA relationship with base classes at compile time @@ -13268,8 +13325,22 @@ C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C, C, -C, C, C +C, C, C, C, C, +C, C, C, C, C + +=back + +=over 4 + +=item PLUGINS + +=over 4 + +=item Sample Plugin + +=back + +=item SEE ALSO =back @@ -13297,6 +13368,8 @@ C, C, C =item Class Methods +C, C (optional), C (optional) + =back =back @@ -13865,6 +13938,51 @@ $file->is_longlink, $file->is_label, $file->is_unknown =back +=head2 Attribute-Handlers::lib::Attribute::Handlers, Attribute::Handlers - +Simpler definition of attribute handlers + +=over 4 + +=item VERSION + +=item SYNOPSIS + +=item DESCRIPTION + +[0], [1], [2], [3], [4], [5], [6], [7] + +=over 4 + +=item Typed lexicals + +=item Type-specific attribute handlers + +=item Non-interpretive attribute handlers + +=item Phase-specific attribute handlers + +=item Attributes as C interfaces + +=back + +=item EXAMPLES + +=item DIAGNOSTICS + +C, C, C, C, +C, C, C + +=item AUTHOR + +=item BUGS + +=item COPYRIGHT AND LICENSE + +=back + =head2 Attribute::Handlers - Simpler definition of attribute handlers =over 4 @@ -15103,7 +15221,7 @@ has_inst($module), has_usable($module), instance($module) =item Three basic types of firewalls -http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade +http firewall, ftp firewall, One-way visibility, SOCKS, IP Masquerade =item Configuring lynx or ncftp for going through a firewall @@ -15426,6 +15544,12 @@ path, index_files, force, verbose =over 4 +=item $bool = $cb->save_state + +=back + +=over 4 + =item CUSTOM MODULE SOURCES =over 4 @@ -15510,6 +15634,8 @@ ok, args, rv, function =over 4 +=item SYNOPSIS + =item DESCRIPTION =item CONFIGURATION @@ -15580,6 +15706,10 @@ verbose write_install_log +source_engine + +cpantest_reporter_args + editor make @@ -15618,6 +15748,8 @@ perlwrapper =item $Configure = CPANPLUS::Configure->new( load_configs => BOOL ) +load_configs + =back =back @@ -15697,8 +15829,7 @@ created(), installed(), uninstalled(), dist() =over 4 -=item $dist = CPANPLUS::Dist->new( module => MODOBJ, [format => DIST_TYPE] -); +=item $dist = CPANPLUS::Dist::YOUR_DIST_TYPE_HERE->new( module => MODOBJ ); =back @@ -15710,13 +15841,41 @@ created(), installed(), uninstalled(), dist() =over 4 -=item prereq_satisfied( modobj => $modobj, version => $version_spec ) +=item $bool = CPANPLUS::Dist->rescan_dist_types; =back =over 4 -=item _resolve_prereqs +=item $bool = CPANPLUS::Dist->has_dist_type( $type ) + +=back + +=over 4 + +=item $bool = $dist->prereq_satisfied( modobj => $modobj, version => +$version_spec ) + +=back + +=over 4 + +=item $configure_requires = $dist->find_configure_requires( [file => +/path/to/META.yml] ) + +=back + +=over 4 + +=item $bool = $dist->_resolve_prereqs( ... ) + +=back + +=head2 CPANPLUS::Dist::Autobundle + +=over 4 + +=item SYNOPSIS =back @@ -15736,6 +15895,12 @@ created(), installed(), uninstalled(), dist() =over 4 +=item @subs = $Class->methods + +=back + +=over 4 + =item $bool = $Class->format_available =back @@ -15770,7 +15935,8 @@ created(), installed(), uninstalled(), dist() =back -=head2 CPANPLUS::Dist::Build +=head2 CPANPLUS::Dist::Build - CPANPLUS plugin to install packages that use +Build.PL =over 4 @@ -15780,13 +15946,13 @@ created(), installed(), uninstalled(), dist() =item ACCESSORS -parent(), status() +C, C =item STATUS ACCESSORS -build_pl (), build (), test (), prepared (), distdir (), created (), -installed (), uninstalled (), _create_args (), _install_args (), _mb_object -() +C, C, C, C, C, +C, C, uninstalled (), C<_create_args ()>, +C<_install_args ()> =back @@ -15830,14 +15996,24 @@ prereq_target => TARGET, force => BOOL, verbose => BOOL, skiptest => BOOL]) =over 4 -=item KNOWN ISSUES +=item AUTHOR + +=item LICENSE + +=back -Module::Build can not be upgraded using its own API (#13169), Module::Build -does not provide access to install history (#9793) +=head2 CPANPLUS::Dist::Build::Constants - Constants for +CPANPLUS::Dist::Build + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION =item AUTHOR -=item COPYRIGHT +=item LICENSE =back @@ -16006,7 +16182,7 @@ description of the patch =item ACCESSORS -_conf, _id, _lib, _perl5lib +_conf, _id =back @@ -16094,7 +16270,7 @@ module, extractdir, prefer_bin, perl, verbose, force =item $path = _fetch( module => $modobj, [fetchdir => '/path/to/save/to', fetch_from => 'scheme://path/to/fetch/from', verbose => BOOL, force => -BOOL, prefer_bin => BOOL] ) +BOOL, prefer_bin => BOOL, ttl => $seconds] ) =back @@ -16136,10 +16312,10 @@ verbose => BOOL] ) =over 4 =item $bool = $cb->_send_report( module => $modobj, buffer => $make_output, -failed => BOOL, [save => BOOL, address => $email_to, dontcc => BOOL, -verbose => BOOL, force => BOOL]); +failed => BOOL, [save => BOOL, address => $email_to, verbose => BOOL, force +=> BOOL]); -module, buffer, failed, save, address, dontcc, verbose, force +module, buffer, failed, save, address, verbose, force =back @@ -16155,7 +16331,7 @@ module, buffer, failed, save, address, dontcc, verbose, force =over 4 -=item _search_module_tree( type => TYPE, allow => \@regexex, [data => +=item _search_module_tree( type => TYPE, allow => \@regexes, [data => \@previous_results ] ) type, allow, data @@ -16193,6 +16369,15 @@ type, allow, data =over 4 +=item $cb->_build_trees( uptodate => BOOL, [use_stored => BOOL, path => +$path, verbose => BOOL] ) + +uptodate, path, verbose, use_stored + +=back + +=over 4 + =item $cb->_check_trees( [update_source => BOOL, path => PATH, verbose => BOOL] ) @@ -16220,32 +16405,6 @@ name, path, verbose =over 4 -=item $cb->_build_trees( uptodate => BOOL, [use_stored => BOOL, path => -$path, verbose => BOOL] ) - -uptodate, path, verbose, use_stored - -=back - -=over 4 - -=item $cb->__retrieve_source(name => $name, [path => $path, uptodate => -BOOL, verbose => BOOL]) - -name, uptodate, path, verbose - -=back - -=over 4 - -=item $cb->_save_source([verbose => BOOL, path => $path]) - -path, verbose - -=back - -=over 4 - =item $cb->__create_author_tree([path => $path, uptodate => BOOL, verbose => BOOL]) @@ -16328,6 +16487,27 @@ BOOL] ); =back +=head2 CPANPLUS::Internals::Source::Memory - In memory implementation + +=over 4 + +=item $cb->__memory_retrieve_source(name => $name, [path => $path, uptodate +=> BOOL, verbose => BOOL]) + +name, uptodate, path, verbose + +=back + +=over 4 + +=item $cb->__memory_save_source([verbose => BOOL, path => $path]) + +path, verbose + +=back + +=head2 CPANPLUS::Internals::Source::SQLite - SQLite implementation + =head2 CPANPLUS::Internals::Utils =over 4 @@ -16456,15 +16636,15 @@ status, author, parent =item STATUS ACCESSORS -installer_type, dist_cpan, dist, prereqs, signature, extract, fetch, -readme, uninstall, created, installed, checksums, checksum_ok, -checksum_value +installer_type, dist_cpan, dist, prereqs | requires, configure_requires, +signature, extract, fetch, readme, uninstall, created, installed, +checksums, checksum_ok, checksum_value =item METHODS =over 4 -=item $self = CPANPLUS::Module::new( OPTIONS ) +=item $self = CPANPLUS::Module->new( OPTIONS ) =back @@ -16472,11 +16652,11 @@ checksum_value =over 4 -=item $mod->package_name +=item $mod->package_name( [$package_string] ) -=item $mod->package_version +=item $mod->package_version( [$package_string] ) -=item $mod->package_extension +=item $mod->package_extension( [$package_string] ) =item $mod->package_is_perl_core @@ -16484,6 +16664,8 @@ checksum_value =item $mod->is_bundle +=item $mod->is_autobundle; + =item $mod->is_third_party =item $mod->third_party_information @@ -16563,6 +16745,8 @@ with C set to C =item $where = $self->installed_file() +=item $dir = $self->installed_dir() + =item $bool = $self->is_uptodate([version => VERSION_NUMBER]) =back @@ -17176,8 +17360,8 @@ Example 1, Example 2, Example 3 =back -=head2 Compress::Raw::Zlib - Low-Level Interface to zlib compression -library +=head2 Compress-Raw-Bzip2::lib::Compress::Raw::Bzip2, Compress::Raw::Bzip2 +- Low-Level Interface to bzip2 compression library =over 4 @@ -17185,182 +17369,47 @@ library =item DESCRIPTION -=item Compress::Raw::Zlib::Deflate +=item Compression =over 4 -=item B<($d, $status) = new Compress::Raw::Zlib::Deflate( [OPT] ) > - -B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>, -B<-Dictionary>, B<-Bufsize>, B<-AppendOutput>, B<-CRC32>, B<-ADLER32> - -=item B<$status = $d-Edeflate($input, $output)> - -=item B<$status = $d-Eflush($output [, $flush_type]) > - -=item B<$status = $d-EdeflateParams([OPT])> - -B<-Level>, B<-Strategy>, B<-BufSize> - -=item B<$status = $d-EdeflateTune($good_length, $max_lazy, -$nice_length, $max_chain)> - -=item B<$d-Edict_adler()> - -=item B<$d-Ecrc32()> - -=item B<$d-Eadler32()> - -=item B<$d-Emsg()> +=item ($z, $status) = new Compress::Raw::Bzip2 $appendOutput, +$blockSize100k, $workfactor; -=item B<$d-Etotal_in()> +B<$appendOutput>, B<$blockSize100k>, B<$workfactor> -=item B<$d-Etotal_out()> +=item $status = $bz->bzdeflate($input, $output); -=item B<$d-Eget_Strategy()> +=item $status = $bz->bzflush($output); -=item B<$d-Eget_Level()> - -=item B<$d-Eget_BufSize()> +=item $status = $bz->bzclose($output); =item Example =back -=item Compress::Raw::Zlib::Inflate +=item Uncompression =over 4 -=item B< ($i, $status) = new Compress::Raw::Zlib::Inflate( [OPT] ) > +=item ($z, $status) = new Compress::Raw::Bunzip2 $appendOutput, +$consumeInput, $small; -B<-WindowBits>, B<-Bufsize>, B<-Dictionary>, B<-AppendOutput>, B<-CRC32>, -B<-ADLER32>, B<-ConsumeInput> +B<$appendOutput>, B<$consumeInput>, B<$small> -=item B< $status = $i-Einflate($input, $output [,$eof]) > - -=item B<$status = $i-EinflateSync($input)> - -=item B<$i-Edict_adler()> - -=item B<$i-Ecrc32()> - -=item B<$i-Eadler32()> - -=item B<$i-Emsg()> - -=item B<$i-Etotal_in()> - -=item B<$i-Etotal_out()> - -=item B<$d-Eget_BufSize()> - -=item Example +=item $status = $z->bzinflate($input, $output); =back -=item CHECKSUM FUNCTIONS - -=item ACCESSING ZIP FILES - -=item CONSTANTS - -=item SEE ALSO - -=item AUTHOR - -=item MODIFICATION HISTORY - -=item COPYRIGHT AND LICENSE - -=back - -=head2 Compress::Raw::Zlib::Compress::Raw::Zlib, Compress::Raw::Zlib - -Low-Level Interface to zlib compression library - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=item Compress::Raw::Zlib::Deflate - -=over 4 - -=item B<($d, $status) = new Compress::Raw::Zlib::Deflate( [OPT] ) > - -B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>, -B<-Dictionary>, B<-Bufsize>, B<-AppendOutput>, B<-CRC32>, B<-ADLER32> - -=item B<$status = $d-Edeflate($input, $output)> - -=item B<$status = $d-Eflush($output [, $flush_type]) > - -=item B<$status = $d-EdeflateParams([OPT])> - -B<-Level>, B<-Strategy>, B<-BufSize> - -=item B<$status = $d-EdeflateTune($good_length, $max_lazy, -$nice_length, $max_chain)> - -=item B<$d-Edict_adler()> - -=item B<$d-Ecrc32()> - -=item B<$d-Eadler32()> - -=item B<$d-Emsg()> - -=item B<$d-Etotal_in()> - -=item B<$d-Etotal_out()> - -=item B<$d-Eget_Strategy()> - -=item B<$d-Eget_Level()> - -=item B<$d-Eget_BufSize()> - -=item Example - -=back - -=item Compress::Raw::Zlib::Inflate +=item Misc =over 4 -=item B< ($i, $status) = new Compress::Raw::Zlib::Inflate( [OPT] ) > - -B<-WindowBits>, B<-Bufsize>, B<-Dictionary>, B<-AppendOutput>, B<-CRC32>, -B<-ADLER32>, B<-ConsumeInput> - -=item B< $status = $i-Einflate($input, $output [,$eof]) > - -=item B<$status = $i-EinflateSync($input)> - -=item B<$i-Edict_adler()> - -=item B<$i-Ecrc32()> - -=item B<$i-Eadler32()> - -=item B<$i-Emsg()> - -=item B<$i-Etotal_in()> - -=item B<$i-Etotal_out()> - -=item B<$d-Eget_BufSize()> - -=item Example +=item my $version = Compress::Raw::Bzip2::bzlibversion(); =back -=item CHECKSUM FUNCTIONS - -=item ACCESSING ZIP FILES - -=item CONSTANTS +=item Constants =item SEE ALSO @@ -17372,8 +17421,145 @@ B<-ADLER32>, B<-ConsumeInput> =back -=head2 Compress::Raw::Zlib::pod::FAQ, Compress::Raw::Zlib::FAQ -- -Frequently Asked Questions about Compress::Raw::Zlib +=head2 Compress-Raw-Bzip2::pod::FAQ, Compress::Raw::Bzip2::FAQ -- +Frequently Asked Questions about Compress::Raw::Bzip2 + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Compatibility with Unix compress/uncompress. + +=item Accessing .tar.Z files + +=item Accessing Zip Files + +=back + +=item SEE ALSO + +=item AUTHOR + +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE + +=back + +=head2 Compress-Raw-Zlib::Compress::Raw::Zlib, Compress::Raw::Zlib - +Low-Level Interface to zlib compression library + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item Compress::Raw::Zlib::Deflate + +=over 4 + +=item B<($d, $status) = new Compress::Raw::Zlib::Deflate( [OPT] ) > + +B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>, +B<-Dictionary>, B<-Bufsize>, B<-AppendOutput>, B<-CRC32>, B<-ADLER32> + +=item B<$status = $d-Edeflate($input, $output)> + +=item B<$status = $d-Eflush($output [, $flush_type]) > + +=item B<$status = $d-EdeflateReset() > + +=item B<$status = $d-EdeflateParams([OPT])> + +B<-Level>, B<-Strategy>, B<-BufSize> + +=item B<$status = $d-EdeflateTune($good_length, $max_lazy, +$nice_length, $max_chain)> + +=item B<$d-Edict_adler()> + +=item B<$d-Ecrc32()> + +=item B<$d-Eadler32()> + +=item B<$d-Emsg()> + +=item B<$d-Etotal_in()> + +=item B<$d-Etotal_out()> + +=item B<$d-Eget_Strategy()> + +=item B<$d-Eget_Level()> + +=item B<$d-Eget_BufSize()> + +=item Example + +=back + +=item Compress::Raw::Zlib::Inflate + +=over 4 + +=item B< ($i, $status) = new Compress::Raw::Zlib::Inflate( [OPT] ) > + +B<-WindowBits>, B<-Bufsize>, B<-Dictionary>, B<-AppendOutput>, B<-CRC32>, +B<-ADLER32>, B<-ConsumeInput>, B<-LimitOutput> + +=item B< $status = $i-Einflate($input, $output [,$eof]) > + +=item B<$status = $i-EinflateSync($input)> + +=item B<$i-Edict_adler()> + +=item B<$i-Ecrc32()> + +=item B<$i-Eadler32()> + +=item B<$i-Emsg()> + +=item B<$i-Etotal_in()> + +=item B<$i-Etotal_out()> + +=item B<$d-Eget_BufSize()> + +=item Examples + +=back + +=item CHECKSUM FUNCTIONS + +=item Misc + +=over 4 + +=item my $version = Compress::Raw::Zlib::zlib_version(); + +=back + +=item The LimitOutput option. + +=item ACCESSING ZIP FILES + +=item CONSTANTS + +=item SEE ALSO + +=item AUTHOR + +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE + +=back + +=head2 Compress-Raw-Zlib::pod::FAQ, Compress::Raw::Zlib::FAQ -- Frequently +Asked Questions about Compress::Raw::Zlib =over 4 @@ -17401,7 +17587,8 @@ Frequently Asked Questions about Compress::Raw::Zlib =back -=head2 Compress::Zlib - Interface to zlib compression library +=head2 Compress::Raw::Bzip2 - Low-Level Interface to bzip2 compression +library =over 4 @@ -17409,93 +17596,156 @@ Frequently Asked Questions about Compress::Raw::Zlib =item DESCRIPTION +=item Compression + =over 4 -=item Notes for users of Compress::Zlib version 1 +=item ($z, $status) = new Compress::Raw::Bzip2 $appendOutput, +$blockSize100k, $workfactor; + +B<$appendOutput>, B<$blockSize100k>, B<$workfactor> + +=item $status = $bz->bzdeflate($input, $output); + +=item $status = $bz->bzflush($output); + +=item $status = $bz->bzclose($output); + +=item Example =back -=item GZIP INTERFACE +=item Uncompression -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 ($z, $status) = new Compress::Raw::Bunzip2 $appendOutput, +$consumeInput, $small; + +B<$appendOutput>, B<$consumeInput>, B<$small> + +=item $status = $z->bzinflate($input, $output); + +=back + +=item Misc =over 4 -=item Examples +=item my $version = Compress::Raw::Bzip2::bzlibversion(); -=item Compress::Zlib::memGzip +=back -=item Compress::Zlib::memGunzip +=item Constants + +=item SEE ALSO + +=item AUTHOR + +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE =back -=item COMPRESS/UNCOMPRESS +=head2 Compress::Raw::Zlib - Low-Level Interface to zlib compression +library -B<$dest = compress($source [, $level] ) ;>, B<$dest = uncompress($source) -;> +=over 4 -=item Deflate Interface +=item SYNOPSIS + +=item DESCRIPTION + +=item Compress::Raw::Zlib::Deflate =over 4 -=item B<($d, $status) = deflateInit( [OPT] )> +=item B<($d, $status) = new Compress::Raw::Zlib::Deflate( [OPT] ) > B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>, -B<-Dictionary>, B<-Bufsize> +B<-Dictionary>, B<-Bufsize>, B<-AppendOutput>, B<-CRC32>, B<-ADLER32> -=item B<($out, $status) = $d-Edeflate($buffer)> +=item B<$status = $d-Edeflate($input, $output)> -=item B<($out, $status) = $d-Eflush()> -=head2 B<($out, $status) = $d-Eflush($flush_type)> +=item B<$status = $d-Eflush($output [, $flush_type]) > + +=item B<$status = $d-EdeflateReset() > =item B<$status = $d-EdeflateParams([OPT])> -B<-Level>, B<-Strategy> +B<-Level>, B<-Strategy>, B<-BufSize> + +=item B<$status = $d-EdeflateTune($good_length, $max_lazy, +$nice_length, $max_chain)> =item B<$d-Edict_adler()> +=item B<$d-Ecrc32()> + +=item B<$d-Eadler32()> + =item B<$d-Emsg()> =item B<$d-Etotal_in()> =item B<$d-Etotal_out()> +=item B<$d-Eget_Strategy()> + +=item B<$d-Eget_Level()> + +=item B<$d-Eget_BufSize()> + =item Example =back -=item Inflate Interface +=item Compress::Raw::Zlib::Inflate =over 4 -=item B<($i, $status) = inflateInit()> +=item B< ($i, $status) = new Compress::Raw::Zlib::Inflate( [OPT] ) > -B<-WindowBits>, B<-Bufsize>, B<-Dictionary> +B<-WindowBits>, B<-Bufsize>, B<-Dictionary>, B<-AppendOutput>, B<-CRC32>, +B<-ADLER32>, B<-ConsumeInput>, B<-LimitOutput> -=item B<($out, $status) = $i-Einflate($buffer)> +=item B< $status = $i-Einflate($input, $output [,$eof]) > -=item B<$status = $i-EinflateSync($buffer)> +=item B<$status = $i-EinflateSync($input)> =item B<$i-Edict_adler()> +=item B<$i-Ecrc32()> + +=item B<$i-Eadler32()> + =item B<$i-Emsg()> =item B<$i-Etotal_in()> =item B<$i-Etotal_out()> -=item Example +=item B<$d-Eget_BufSize()> + +=item Examples =back =item CHECKSUM FUNCTIONS +=item Misc + +=over 4 + +=item my $version = Compress::Raw::Zlib::zlib_version(); + +=back + +=item The LimitOutput option. + +=item ACCESSING ZIP FILES + =item CONSTANTS =item SEE ALSO @@ -17508,8 +17758,7 @@ B<-WindowBits>, B<-Bufsize>, B<-Dictionary> =back -=head2 Compress::Zlib::Compress::Zlib, Compress::Zlib - Interface to zlib -compression library +=head2 Compress::Zlib - Interface to zlib compression library =over 4 @@ -17604,35 +17853,16 @@ B<-WindowBits>, B<-Bufsize>, B<-Dictionary> =item CHECKSUM FUNCTIONS -=item CONSTANTS - -=item SEE ALSO - -=item AUTHOR - -=item MODIFICATION HISTORY - -=item COPYRIGHT AND LICENSE - -=back - -=head2 Compress::Zlib::pod::FAQ, Compress::Zlib::FAQ -- Frequently Asked -Questions about Compress::Zlib - -=over 4 - -=item DESCRIPTION +=item Misc =over 4 -=item Compatibility with Unix compress/uncompress. - -=item Accessing .tar.Z files - -=item Accessing Zip Files +=item my $version = Compress::Zlib::zlib_version(); =back +=item CONSTANTS + =item SEE ALSO =item AUTHOR @@ -17733,37 +17963,37 @@ C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, -C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, C, C, C, C, C, C, C, C, C, @@ -18447,6 +18677,54 @@ B, B, B =back +=head2 Data-Dumper, 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 Data::Dumper - stringified perl data structures, suitable for both printing and C @@ -18495,6 +18773,128 @@ Dumper =back +=head2 Devel-DProf, 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, 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.11.0, perl 5.10.0, perl 5.9.5, perl 5.9.4, perl 5.9.3, perl 5.9.2, +perl 5.9.1, perl 5.9.0, perl 5.8.3, perl 5.8.1, perl 5.8.0, perl 5.7.3, +perl 5.7.2, perl 5.7.1, perl 5.6.1, perl 5.6.0, perl 5.005_03, perl 5.005, +perl 5.004_05, perl 5.004 + +=back + +=item BUGS + +=item AUTHORS + +=item COPYRIGHT + +=item SEE ALSO + +=back + +=head2 Devel-Peek, 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::DProf - a Perl code profiler =over 4 @@ -18680,7 +19080,7 @@ $io_handle ), $ctx->add_bits( $data, $nbits ), $ctx->add_bits( $bitstring =back -=head2 Digest::MD5 - Perl interface to the MD5 Algorithm +=head2 Digest-MD5, Digest::MD5 - Perl interface to the MD5 Algorithm =over 4 @@ -18708,7 +19108,8 @@ $md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest =back -=head2 Digest::SHA - Perl extension for SHA-1/224/256/384/512 +=head2 Digest-SHA::lib::Digest::SHA, Digest::SHA - Perl extension for +SHA-1/224/256/384/512 =over 4 @@ -18756,8 +19157,35 @@ B, B =back -=head2 Digest::SHA::lib::Digest::SHA, Digest::SHA - Perl extension for -SHA-1/224/256/384/512 +=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 @@ -21361,6 +21789,25 @@ errors() =back +=head2 ExtUtils::XSSymSet - keep sets of symbol names palatable to the VMS +linker + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +new([$maxlen[,$silent]]), addsym($name[,$maxlen[,$silent]]), +trimsym($name[,$maxlen[,$silent]]), delsym($name), get_orig($trimmed), +get_trimmed($name), all_orig(), all_trimmed() + +=item AUTHOR + +=item REVISION + +=back + =head2 ExtUtils::testlib - add blib/* directories to @INC =over 4 @@ -21411,6 +21858,38 @@ neither a builtin, nor a Perl subroutine, Cannot make the non-overridable =back +=head2 File-Glob, File::Glob - Perl extension for BSD glob routine + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item META CHARACTERS + +=item POSIX FLAGS + +C, C, C, C, C, +C, C, C, C, +C, C, C + +=back + +=item DIAGNOSTICS + +C, C + +=item NOTES + +=item SEE ALSO + +=item AUTHOR + +=back + =head2 File::Basename - Parse file paths into directory, filename and suffix. @@ -21638,6 +22117,8 @@ $dont_use_nlink, symlinks =item HISTORY +=item SEE ALSO + =back =head2 File::Glob - Perl extension for BSD glob routine @@ -21999,10 +22480,10 @@ rel2abs() =item DESCRIPTION -canonpath (override) - =back +canonpath (override) + catdir (override) catfile (override) @@ -22213,6 +22694,14 @@ B<$KEEP_ALL>, B<$DEBUG> =item BUGS +=item ERRORS + +-%s is not implemented on a File::stat object + +=item WARNINGS + +File::stat ignores use filetest 'access', File::stat ignores VMS ACLs + =item NOTE =item AUTHOR @@ -22249,6 +22738,49 @@ $fh->print, $fh->printf, $fh->getline, $fh->getlines =back +=head2 Filter-Util-Call, Filter::Util::Call - Perl Source Filter Utility +Module + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item B + +=item B + +=item B + +B<$_>, B<$status>, B and B, B + +=back + +=item EXAMPLES + +=over 4 + +=item Example 1: A simple filter. + +=item Example 2: Using the context + +=item Example 3: Using the context within the filter + +=item Example 4: Using filter_del + +=back + +=item Filter::Simple + +=item AUTHOR + +=item DATE + +=back + =head2 Filter::Simple - Simplified source filtering =over 4 @@ -22472,7 +23004,7 @@ VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage =back -=item Trouble Shooting +=item Troubleshooting =over 4 @@ -22506,7 +23038,72 @@ with switch clustering =back -=head2 Hash::Util - A selection of general-utility hash subroutines +=head2 Hash-Util-FieldHash::lib::Hash::Util::FieldHash, +Hash::Util::FieldHash - Support for Inside-Out Classes + +=over 4 + +=item SYNOPSIS + +=item FUNCTIONS + +id, id_2obj, register, idhash, idhashes, fieldhash, fieldhashes + +=item DESCRIPTION + +=over 4 + +=item The Inside-out Technique + +=item Problems of Inside-out + +=item Solutions + +=item More Problems + +=item The Generic Object + +=item How to use Field Hashes + +=item Garbage-Collected Hashes + +=back + +=item EXAMPLES + +C, C, C, C, C, C, +C, C, C, C + +=over 4 + +=item Example 1 + +=item Example 2 + +=back + +=item GUTS + +=over 4 + +=item The C interface for hashes + +=item Weakrefs call uvar magic + +=item How field hashes work + +=item Internal function Hash::Util::FieldHash::_fieldhash + +=back + +=item AUTHOR + +=item COPYRIGHT AND LICENSE + +=back + +=head2 Hash-Utilib::Hash::Util, Hash::Util - A selection of general-utility +hash subroutines =over 4 @@ -22560,71 +23157,61 @@ unlock_hashref_recurse, hash_ref_unlocked, legal_ref_keys, hidden_ref_keys =back -=head2 Hash::Util::FieldHash - Support for Inside-Out Classes +=head2 Hash::Util - A selection of general-utility hash subroutines =over 4 =item SYNOPSIS -=item FUNCTIONS - -id, id_2obj, register, idhash, idhashes, fieldhash, fieldhashes - =item DESCRIPTION =over 4 -=item The Inside-out Technique +=item Restricted hashes -=item Problems of Inside-out +B, B -=item Solutions +=back -=item More Problems +=back -=item The Generic Object +B -=item How to use Field Hashes +B, B -=item Garbage-Collected Hashes +B, B -=back +B, B -=item EXAMPLES +B -C, C, C, C, C, C, -C, C, C, C +B, B, B, B + +B =over 4 -=item Example 1 +=item Operating on references to hashes. -=item Example 2 +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 -=item GUTS - =over 4 -=item The C interface for hashes - -=item Weakrefs call uvar magic - -=item How field hashes work - -=item Internal function Hash::Util::FieldHash::_fieldhash +=item CAVEATS -=back +=item BUGS =item AUTHOR -=item COPYRIGHT AND LICENSE +=item SEE ALSO =back -=head2 Hash::Util::FieldHash::lib::Hash::Util::FieldHash, -Hash::Util::FieldHash - Support for Inside-Out Classes +=head2 Hash::Util::FieldHash - Support for Inside-Out Classes =over 4 @@ -22687,8 +23274,7 @@ C, C, C, C =back -=head2 Hash::Utilib::Hash::Util, Hash::Util - A selection of -general-utility hash subroutines +=head2 I18N-Langinfo, I18N::Langinfo - query locale information =over 4 @@ -22698,47 +23284,15 @@ general-utility hash subroutines =over 4 -=item Restricted hashes - -B, B - -=back - -=back - -B - -B, B - -B, B - -B, B - -B - -B, B, B, B - -B - -=over 4 - -=item Operating on references to hashes. - -lock_ref_keys, unlock_ref_keys, lock_ref_keys_plus, lock_ref_value, -unlock_ref_value, lock_hashref, unlock_hashref, lock_hashref_recurse, -unlock_hashref_recurse, hash_ref_unlocked, legal_ref_keys, hidden_ref_keys +=item EXPORT =back -=over 4 - -=item CAVEATS - -=item BUGS +=item SEE ALSO =item AUTHOR -=item SEE ALSO +=item COPYRIGHT AND LICENSE =back @@ -23003,7 +23557,8 @@ Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd} =back -=head2 IO::Compress::Base - Base Class for IO::Compress modules +=head2 IO-Compress::lib::Compress::Zlib, Compress::Zlib - Interface to zlib +compression library =over 4 @@ -23011,110 +23566,147 @@ Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd} =item DESCRIPTION -=item SEE ALSO +=over 4 -=item AUTHOR +=item Notes for users of Compress::Zlib version 1 -=item MODIFICATION HISTORY +=back -=item COPYRIGHT AND LICENSE +=item GZIP INTERFACE + +B<$gz = gzopen($filename, $mode)>, B<$gz = gzopen($filehandle, $mode)>, +B<$bytesread = $gz-Egzread($buffer [, $size]) ;>, B<$bytesread = +$gz-Egzreadline($line) ;>, B<$byteswritten = $gz-Egzwrite($buffer) +;>, B<$status = $gz-Egzflush($flush_type) ;>, B<$offset = +$gz-Egztell() ;>, B<$status = $gz-Egzseek($offset, $whence) ;>, +B<$gz-Egzclose>, B<$gz-Egzsetparams($level, $strategy>, B<$level>, +B<$strategy>, B<$gz-Egzerror>, B<$gzerrno> + +=over 4 + +=item Examples + +=item Compress::Zlib::memGzip + +=item Compress::Zlib::memGunzip =back -=head2 IO::Compress::Deflate - Write RFC 1950 files/buffers +=item COMPRESS/UNCOMPRESS + +B<$dest = compress($source [, $level] ) ;>, B<$dest = uncompress($source) +;> + +=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 Functional Interface +=item B<($out, $status) = $d-Edeflate($buffer)> -=over 4 +=item B<($out, $status) = $d-Eflush()> +=head2 B<($out, $status) = $d-Eflush($flush_type)> -=item deflate $input => $output [, OPTS] +=item B<$status = $d-EdeflateParams([OPT])> -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<-Level>, B<-Strategy> -=item Notes +=item B<$d-Edict_adler()> -=item Optional Parameters +=item B<$d-Emsg()> -C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> +=item B<$d-Etotal_in()> -=item Examples +=item B<$d-Etotal_out()> + +=item Example =back -=item OO Interface +=item Inflate Interface =over 4 -=item Constructor +=item B<($i, $status) = inflateInit()> -A filename, A filehandle, A scalar reference +B<-WindowBits>, B<-Bufsize>, B<-Dictionary> -=item Constructor Options +=item B<($out, $status) = $i-Einflate($buffer)> -C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A -Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> +=item B<$status = $i-EinflateSync($buffer)> -=item Examples +=item B<$i-Edict_adler()> + +=item B<$i-Emsg()> + +=item B<$i-Etotal_in()> + +=item B<$i-Etotal_out()> + +=item Example =back -=item Methods +=item CHECKSUM FUNCTIONS + +=item Misc =over 4 -=item print +=item my $version = Compress::Zlib::zlib_version(); -=item printf +=back -=item syswrite +=item CONSTANTS -=item write +=item SEE ALSO -=item flush +=item AUTHOR -=item tell +=item MODIFICATION HISTORY -=item eof +=item COPYRIGHT AND LICENSE -=item seek +=back -=item binmode +=head2 IO-Compress::lib::File::GlobMapper, File::GlobMapper - Extend File +Glob to Allow Input and Output Files -=item opened +=over 4 -=item autoflush +=item SYNOPSIS -=item input_line_number +=item DESCRIPTION -=item fileno +=over 4 -=item close +=item Behind The Scenes -=item newStream([OPTS]) +=item Limitations -=item deflateParams +=item Input File Glob -=back +B<~>, B<~user>, B<.>, B<*>, B, B<\>, B<[]>, B<{,}>, B<()> -=item Importing +=item Output File Glob -:all, :constants, :flush, :level, :strategy +"*", #1 + +=item Returned Data + +=back =item EXAMPLES =over 4 -=item Apache::GZip Revisited +=item A Rename script -=item Working with Net::FTP +=item A few example globmaps =back @@ -23122,13 +23714,31 @@ Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> =item AUTHOR +=item COPYRIGHT AND LICENSE + +=back + +=head2 IO-Compress::lib::IO::Compress::Base, IO::Compress::Base - Base +Class for IO::Compress modules + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=item AUTHOR + =item MODIFICATION HISTORY =item COPYRIGHT AND LICENSE =back -=head2 IO::Compress::Gzip - Write RFC 1952 files/buffers +=head2 IO-Compress::lib::IO::Compress::Bzip2, IO::Compress::Bzip2 - Write +bzip2 files/buffers =over 4 @@ -23140,7 +23750,7 @@ Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> =over 4 -=item gzip $input => $output [, OPTS] +=item bzip2 $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 @@ -23167,11 +23777,8 @@ A filename, A filehandle, A scalar reference =item Constructor Options C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A -Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Minimal => 0|1 >>, -C<< Comment => $comment >>, C<< Name => $string >>, C<< Time => $number >>, -C<< TextFlag => 0|1 >>, C<< HeaderCRC => 0|1 >>, C<< OS_Code => $value >>, -C<< ExtraField => $data >>, C<< ExtraFlags => $value >>, C<< Strict => 0|1 ->> +Filehandle, C<< BlockSize100K => number >>, C<< WorkFactor => number >>, +C<< Strict => 0|1 >> =item Examples @@ -23211,13 +23818,11 @@ C<< ExtraField => $data >>, C<< ExtraFlags => $value >>, C<< Strict => 0|1 =item newStream([OPTS]) -=item deflateParams - =back =item Importing -:all, :constants, :flush, :level, :strategy +:all =item EXAMPLES @@ -23239,7 +23844,8 @@ C<< ExtraField => $data >>, C<< ExtraFlags => $value >>, C<< Strict => 0|1 =back -=head2 IO::Compress::RawDeflate - Write RFC 1951 files/buffers +=head2 IO-Compress::lib::IO::Compress::Deflate, IO::Compress::Deflate - +Write RFC 1950 files/buffers =over 4 @@ -23251,7 +23857,7 @@ C<< ExtraField => $data >>, C<< ExtraFlags => $value >>, C<< Strict => 0|1 =over 4 -=item rawdeflate $input => $output [, OPTS] +=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 @@ -23346,7 +23952,8 @@ Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> =back -=head2 IO::Compress::Zip - Write zip files/buffers +=head2 IO-Compress::lib::IO::Compress::Gzip, IO::Compress::Gzip - Write RFC +1952 files/buffers =over 4 @@ -23358,7 +23965,7 @@ Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> =over 4 -=item zip $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 @@ -23385,14 +23992,11 @@ A filename, A filehandle, A scalar reference =item Constructor Options C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A -Filehandle, C<< Name => $string >>, C<< Time => $number >>, C<< ExtAttr => -$attr >>, C<< exTime => [$atime, $mtime, $ctime] >>, C<< exUnix2 => [$uid, -$gid] >>, C<< Comment => $comment >>, C<< ZipComment => $comment >>, C<< -Method => $method >>, C<< Stream => 0|1 >>, C<< Zip64 => 0|1 >>, C<< -TextFlag => 0|1 >>, C<< ExtraFieldLocal => $data >> =item C<< -ExtraFieldCentral => $data >>, C<< Minimal => 1|0 >>, C<< BlockSize100K => -number >>, C<< WorkFactor => number >>, -Level, -Strategy, C<< Strict => -0|1 >> +Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Minimal => 0|1 >>, +C<< Comment => $comment >>, C<< Name => $string >>, C<< Time => $number >>, +C<< TextFlag => 0|1 >>, C<< HeaderCRC => 0|1 >>, C<< OS_Code => $value >>, +C<< ExtraField => $data >>, C<< ExtraFlags => $value >>, C<< Strict => 0|1 +>> =item Examples @@ -23438,7 +24042,7 @@ number >>, C<< WorkFactor => number >>, -Level, -Strategy, C<< Strict => =item Importing -:all, :constants, :flush, :level, :strategy, :zip_method +:all, :constants, :flush, :level, :strategy =item EXAMPLES @@ -23460,7 +24064,8 @@ number >>, C<< WorkFactor => number >>, -Level, -Strategy, C<< Strict => =back -=head2 IO::Dir - supply object methods for directory handles +=head2 IO-Compress::lib::IO::Compress::RawDeflate, IO::Compress::RawDeflate +- Write RFC 1951 files/buffers =over 4 @@ -23468,117 +24073,107 @@ number >>, C<< WorkFactor => number >>, -Level, -Strategy, C<< Strict => =item DESCRIPTION -new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), -rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] +=item Functional Interface -=item SEE ALSO +=over 4 -=item AUTHOR +=item rawdeflate $input => $output [, OPTS] -=item COPYRIGHT +A filename, A filehandle, A scalar reference, An array reference, An Input +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob -=back +=item Notes -=head2 IO::File - supply object methods for filehandles +=item Optional Parameters -=over 4 +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> -=item SYNOPSIS +=item Examples -=item DESCRIPTION +=back -=item CONSTRUCTOR +=item OO Interface -new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile +=over 4 -=item METHODS +=item Constructor -open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( -[LAYER] ) +A filename, A filehandle, A scalar reference -=item NOTE +=item Constructor Options -=item SEE ALSO +C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A +Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> -=item HISTORY +=item Examples =back -=head2 IO::Handle - supply object methods for I/O handles +=item Methods =over 4 -=item SYNOPSIS - -=item DESCRIPTION - -=item CONSTRUCTOR - -new (), new_from_fd ( FD, MODE ) - -=item METHODS +=item print -$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 printf -=item NOTE +=item syswrite -=item SEE ALSO +=item write -=item BUGS +=item flush -=item HISTORY +=item tell -=back +=item eof -=head2 IO::Pipe - supply object methods for pipes +=item seek -=over 4 +=item binmode -=item SYNOPSIS +=item opened -=item DESCRIPTION +=item autoflush -=item CONSTRUCTOR +=item input_line_number -new ( [READER, WRITER] ) +=item fileno -=item METHODS +=item close -reader ([ARGS]), writer ([ARGS]), handles () +=item newStream([OPTS]) -=item SEE ALSO +=item deflateParams -=item AUTHOR +=back -=item COPYRIGHT +=item Importing -=back +:all, :constants, :flush, :level, :strategy -=head2 IO::Poll - Object interface to system poll call +=item EXAMPLES =over 4 -=item SYNOPSIS - -=item DESCRIPTION +=item Apache::GZip Revisited -=item METHODS +=item Working with Net::FTP -mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( -IO ), handles( [ EVENT_MASK ] ) +=back =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-Compress::lib::IO::Compress::Zip, IO::Compress::Zip - Write zip +files/buffers =over 4 @@ -23586,122 +24181,114 @@ 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 - -=head2 IO::Select - OO interface to the select system call +=item Functional Interface =over 4 -=item SYNOPSIS - -=item DESCRIPTION - -=item CONSTRUCTOR - -new ( [ HANDLES ] ) +=item zip $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 +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> -=item COPYRIGHT +=item Examples =back -=head2 IO::Socket - Object interface to socket communications +=item OO Interface =over 4 -=item SYNOPSIS +=item Constructor -=item DESCRIPTION +A filename, A filehandle, A scalar reference -=item CONSTRUCTOR +=item Constructor Options -new ( [ARGS] ) +C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A +Filehandle, C<< Name => $string >>, C<< Time => $number >>, C<< ExtAttr => +$attr >>, C<< exTime => [$atime, $mtime, $ctime] >>, C<< exUnix2 => [$uid, +$gid] >>, C<< Comment => $comment >>, C<< ZipComment => $comment >>, C<< +Method => $method >>, C<< Stream => 0|1 >>, C<< Zip64 => 0|1 >>, C<< +TextFlag => 0|1 >>, C<< ExtraFieldLocal => $data >> =item C<< +ExtraFieldCentral => $data >>, C<< Minimal => 1|0 >>, C<< BlockSize100K => +number >>, C<< WorkFactor => number >>, -Level, -Strategy, C<< Strict => +0|1 >> -=item METHODS +=item Examples -accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, -protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) +=back -=item SEE ALSO +=item Methods -=item AUTHOR +=over 4 -=item COPYRIGHT +=item print -=back +=item printf -=head2 IO::Socket::INET - Object interface for AF_INET domain sockets +=item syswrite -=over 4 +=item write -=item SYNOPSIS +=item flush -=item DESCRIPTION +=item tell -=item CONSTRUCTOR +=item eof -new ( [ARGS] ) +=item seek -=over 4 +=item binmode -=item METHODS +=item opened -sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost -() +=item autoflush -=back +=item input_line_number -=item SEE ALSO +=item fileno -=item AUTHOR +=item close -=item COPYRIGHT +=item newStream([OPTS]) -=back +=item deflateParams -=head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets +=back -=over 4 +=item Importing -=item SYNOPSIS +:all, :constants, :flush, :level, :strategy, :zip_method -=item DESCRIPTION +=item EXAMPLES -=item CONSTRUCTOR +=over 4 -new ( [ARGS] ) +=item Apache::GZip Revisited -=item METHODS +=item Working with Net::FTP -hostpath(), peerpath() +=back =item SEE ALSO =item AUTHOR -=item COPYRIGHT +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE =back -=head2 IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip) -file/buffer +=head2 IO-Compress::lib::IO::Uncompress::AnyInflate, +IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip) file/buffer =over 4 @@ -23817,7 +24404,8 @@ the sub-field structure as defined in RFC 1952 =back -=head2 IO::Uncompress::AnyUncompress - Uncompress gzip, zip, bzip2 or lzop +=head2 IO-Compress::lib::IO::Uncompress::AnyUncompress, +IO::Uncompress::AnyUncompress - Uncompress gzip, zip, bzip2 or lzop file/buffer =over 4 @@ -23924,7 +24512,8 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< RawInflate => 0|1 =back -=head2 IO::Uncompress::Base - Base Class for IO::Uncompress modules +=head2 IO-Compress::lib::IO::Uncompress::Base, IO::Uncompress::Base - Base +Class for IO::Uncompress modules =over 4 @@ -23942,7 +24531,8 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< RawInflate => 0|1 =back -=head2 IO::Uncompress::Gunzip - Read RFC 1952 files/buffers +=head2 IO-Compress::lib::IO::Uncompress::Bunzip2, IO::Uncompress::Bunzip2 - +Read bzip2 files/buffers =over 4 @@ -23954,7 +24544,7 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< RawInflate => 0|1 =over 4 -=item gunzip $input => $output [, OPTS] +=item bunzip2 $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 @@ -23983,10 +24573,7 @@ A filename, A filehandle, A scalar reference C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength => -$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< ParseExtra => 0|1 ->> If the gzip FEXTRA header field is present and this option is set, it -will force the module to check that it conforms to the sub-field structure -as defined in RFC 1952 +$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< Small => 0|1 >> =item Examples @@ -24006,12 +24593,8 @@ as defined in RFC 1952 =item ungetc -=item inflateSync - =item getHeaderInfo -Name, Comment - =item tell =item eof @@ -24058,7 +24641,8 @@ Name, Comment =back -=head2 IO::Uncompress::Inflate - Read RFC 1950 files/buffers +=head2 IO-Compress::lib::IO::Uncompress::Gunzip, IO::Uncompress::Gunzip - +Read RFC 1952 files/buffers =over 4 @@ -24070,7 +24654,7 @@ Name, Comment =over 4 -=item inflate $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 @@ -24099,7 +24683,10 @@ A filename, A filehandle, A scalar reference C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength => -$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> +$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< ParseExtra => 0|1 +>> If the gzip FEXTRA header field is present and this option is set, it +will force the module to check that it conforms to the sub-field structure +as defined in RFC 1952 =item Examples @@ -24123,6 +24710,8 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =item getHeaderInfo +Name, Comment + =item tell =item eof @@ -24169,7 +24758,8 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =back -=head2 IO::Uncompress::RawInflate - Read RFC 1951 files/buffers +=head2 IO-Compress::lib::IO::Uncompress::Inflate, IO::Uncompress::Inflate - +Read RFC 1950 files/buffers =over 4 @@ -24181,7 +24771,7 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =over 4 -=item rawinflate $input => $output [, OPTS] +=item inflate $input => $output [, OPTS] A filename, A filehandle, A scalar reference, An array reference, An Input FileGlob string, A filename, A filehandle, A scalar reference, An Array @@ -24280,7 +24870,8 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =back -=head2 IO::Uncompress::Unzip - Read zip files/buffers +=head2 IO-Compress::lib::IO::Uncompress::RawInflate, +IO::Uncompress::RawInflate - Read RFC 1951 files/buffers =over 4 @@ -24292,7 +24883,7 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =over 4 -=item unzip $input => $output [, OPTS] +=item rawinflate $input => $output [, OPTS] A filename, A filehandle, A scalar reference, An array reference, An Input FileGlob string, A filename, A filehandle, A scalar reference, An Array @@ -24379,8 +24970,6 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =item Working with Net::FTP -=item Walking through a zip file - =back =item SEE ALSO @@ -24393,7 +24982,8 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =back -=head2 IO::Zlib - IO:: style interface to L +=head2 IO-Compress::lib::IO::Uncompress::Unzip, IO::Uncompress::Unzip - +Read zip files/buffers =over 4 @@ -24401,211 +24991,146 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =item DESCRIPTION -=item CONSTRUCTOR - -new ( [ARGS] ) - -=item OBJECT METHODS - -open ( FILENAME, MODE ), opened, close, getc, getline, getlines, print ( -ARGS... ), read ( BUF, NBYTES, [OFFSET] ), eof, seek ( OFFSET, WHENCE ), -tell, setpos ( POS ), getpos ( POS ) - -=item USING THE EXTERNAL GZIP - -=item CLASS METHODS - -has_Compress_Zlib, gzip_external, gzip_used, gzip_read_open, -gzip_write_open - -=item DIAGNOSTICS - -IO::Zlib::getlines: must be called in list context, -IO::Zlib::gzopen_external: mode '...' is illegal, IO::Zlib::import: '...' -is illegal, IO::Zlib::import: ':gzip_external' requires an argument, -IO::Zlib::import: 'gzip_read_open' requires an argument, IO::Zlib::import: -'gzip_read' '...' is illegal, IO::Zlib::import: 'gzip_write_open' requires -an argument, IO::Zlib::import: 'gzip_write_open' '...' is illegal, -IO::Zlib::import: no Compress::Zlib and no external gzip, IO::Zlib::open: -needs a filename, IO::Zlib::READ: NBYTES must be specified, -IO::Zlib::WRITE: too long LENGTH - -=item SEE ALSO - -=item HISTORY - -=item COPYRIGHT - -=back - -=head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory -handles +=item Functional Interface =over 4 -=item SYNOPSIS +=item unzip $input => $output [, OPTS] -=item DESCRIPTION +A filename, A filehandle, A scalar reference, An array reference, An Input +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob -new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), -rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] +=item Notes -=item SEE ALSO +=item Optional Parameters -=item AUTHOR +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >> -=item COPYRIGHT +=item Examples =back -=head2 IO::lib::IO::File, IO::File - supply object methods for filehandles +=item OO Interface =over 4 -=item SYNOPSIS - -=item DESCRIPTION - -=item CONSTRUCTOR - -new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile - -=item METHODS +=item Constructor -open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( -[LAYER] ) +A filename, A filehandle, A scalar reference -=item NOTE +=item Constructor Options -=item SEE ALSO +C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string +>>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength => +$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> -=item HISTORY +=item Examples =back -=head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O -handles +=item Methods =over 4 -=item SYNOPSIS - -=item DESCRIPTION - -=item CONSTRUCTOR - -new (), new_from_fd ( FD, MODE ) - -=item METHODS +=item read -$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 read -=item NOTE +=item getline -=item SEE ALSO +=item getc -=item BUGS +=item ungetc -=item HISTORY +=item inflateSync -=back +=item getHeaderInfo -=head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes +=item tell -=over 4 +=item eof -=item SYNOPSIS +=item seek -=item DESCRIPTION +=item binmode -=item CONSTRUCTOR +=item opened -new ( [READER, WRITER] ) +=item autoflush -=item METHODS +=item input_line_number -reader ([ARGS]), writer ([ARGS]), handles () +=item fileno -=item SEE ALSO +=item close -=item AUTHOR +=item nextStream -=item COPYRIGHT +=item trailingData =back -=head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call +=item Importing -=over 4 +:all -=item SYNOPSIS +=item EXAMPLES -=item DESCRIPTION +=over 4 -=item METHODS +=item Working with Net::FTP -mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( -IO ), handles( [ EVENT_MASK ] ) +=back =item SEE ALSO =item AUTHOR -=item COPYRIGHT +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE =back -=head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for -I/O objects +=head2 IO-Compress::pod::FAQ, IO::Compress::FAQ -- Frequently Asked +Questions about IO::Compress =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 +=over 4 -=head2 IO::lib::IO::Select, IO::Select - OO interface to the select system -call +=item Compatibility with Unix compress/uncompress. -=over 4 +=item Accessing .tar.Z files -=item SYNOPSIS +=item Accessing Zip Files -=item DESCRIPTION +=item Compressed files and Net::FTP -=item CONSTRUCTOR +=item How do I recompress using a different compression? -new ( [ HANDLES ] ) +=item Apache::GZip Revisited -=item METHODS +=item Using C to uncompress data embedded in a larger +file/buffer. -add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( -[ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), -count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) +=back -=item EXAMPLE +=item SEE ALSO =item AUTHOR -=item COPYRIGHT +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE =back -=head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket -communications +=head2 IO::Compress::Base - Base Class for IO::Compress modules =over 4 @@ -24613,25 +25138,17 @@ communications =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 +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE =back -=head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for -AF_INET domain sockets +=head2 IO::Compress::Bzip2 - Write bzip2 files/buffers =over 4 @@ -24639,105 +25156,93 @@ AF_INET domain sockets =item DESCRIPTION -=item CONSTRUCTOR - -new ( [ARGS] ) +=item Functional Interface =over 4 -=item METHODS +=item bzip2 $input => $output [, OPTS] -sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost -() +A filename, A filehandle, A scalar reference, An array reference, An Input +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob -=back +=item Notes -=item SEE ALSO +=item Optional Parameters -=item AUTHOR +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> -=item COPYRIGHT +=item Examples =back -=head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for -AF_UNIX domain sockets +=item OO Interface =over 4 -=item SYNOPSIS - -=item DESCRIPTION - -=item CONSTRUCTOR - -new ( [ARGS] ) - -=item METHODS +=item Constructor -hostpath(), peerpath() +A filename, A filehandle, A scalar reference -=item SEE ALSO +=item Constructor Options -=item AUTHOR +C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A +Filehandle, C<< BlockSize100K => number >>, C<< WorkFactor => number >>, +C<< Strict => 0|1 >> -=item COPYRIGHT +=item Examples =back -=head2 IO_Compress_Base::lib::File::GlobMapper, File::GlobMapper - Extend -File Glob to Allow Input and Output Files +=item Methods =over 4 -=item SYNOPSIS +=item print -=item DESCRIPTION +=item printf -=over 4 +=item syswrite -=item Behind The Scenes +=item write -=item Limitations +=item flush -=item Input File Glob +=item tell -B<~>, B<~user>, B<.>, B<*>, B, B<\>, B<[]>, B<{,}>, B<()> +=item eof -=item Output File Glob +=item seek -"*", #1 +=item binmode -=item Returned Data +=item opened -=back +=item autoflush -=item EXAMPLES +=item input_line_number -=over 4 +=item fileno -=item A Rename script +=item close -=item A few example globmaps +=item newStream([OPTS]) =back -=item SEE ALSO - -=item AUTHOR - -=item COPYRIGHT AND LICENSE +=item Importing -=back +:all -=head2 IO_Compress_Base::lib::IO::Compress::Base, IO::Compress::Base - Base -Class for IO::Compress modules +=item EXAMPLES =over 4 -=item SYNOPSIS +=item Apache::GZip Revisited -=item DESCRIPTION +=item Working with Net::FTP + +=back =item SEE ALSO @@ -24749,9 +25254,7 @@ Class for IO::Compress modules =back -=head2 IO_Compress_Base::lib::IO::Uncompress::AnyUncompress, -IO::Uncompress::AnyUncompress - Uncompress gzip, zip, bzip2 or lzop -file/buffer +=head2 IO::Compress::Deflate - Write RFC 1950 files/buffers =over 4 @@ -24759,13 +25262,11 @@ file/buffer =item DESCRIPTION -RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip, bzip2, lzop, lzf - =item Functional Interface =over 4 -=item anyuncompress $input => $output [, OPTS] +=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 @@ -24775,8 +25276,7 @@ Reference, An Output FileGlob =item Optional Parameters -C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, -C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >> +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> =item Examples @@ -24792,10 +25292,8 @@ A filename, A filehandle, A scalar reference =item Constructor Options -C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string ->>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength => -$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< RawInflate => 0|1 ->> +C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A +Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> =item Examples @@ -24805,17 +25303,15 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< RawInflate => 0|1 =over 4 -=item read - -=item read +=item print -=item getline +=item printf -=item getc +=item syswrite -=item ungetc +=item write -=item getHeaderInfo +=item flush =item tell @@ -24835,68 +25331,23 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< RawInflate => 0|1 =item close -=item nextStream +=item newStream([OPTS]) -=item trailingData +=item deflateParams =back =item Importing -:all +:all, :constants, :flush, :level, :strategy =item EXAMPLES -=item SEE ALSO - -=item AUTHOR - -=item MODIFICATION HISTORY - -=item COPYRIGHT AND LICENSE - -=back - -=head2 IO_Compress_Base::lib::IO::Uncompress::Base, 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_Compress_Base::pod::FAQ, IO::Compress::Base::FAQ -- Frequently -Asked Questions about IO::Compress::Base - =over 4 -=item DESCRIPTION - -=over 4 - -=item Compatibility with Unix compress/uncompress. - -=item Accessing .tar.Z files - -=item Accessing Zip Files - -=item Compressed files and Net::FTP - -=item How do I recompress using a different compression? +=item Apache::GZip Revisited -=item Using C to uncompress data embedded in a larger -file/buffer. +=item Working with Net::FTP =back @@ -24910,8 +25361,7 @@ file/buffer. =back -=head2 IO_Compress_Zlib::IO::Compress::Deflate, IO::Compress::Deflate - -Write RFC 1950 files/buffers +=head2 IO::Compress::Gzip - Write RFC 1952 files/buffers =over 4 @@ -24923,7 +25373,7 @@ Write RFC 1950 files/buffers =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 @@ -24950,7 +25400,11 @@ A filename, A filehandle, A scalar reference =item Constructor Options C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A -Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> +Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Minimal => 0|1 >>, +C<< Comment => $comment >>, C<< Name => $string >>, C<< Time => $number >>, +C<< TextFlag => 0|1 >>, C<< HeaderCRC => 0|1 >>, C<< OS_Code => $value >>, +C<< ExtraField => $data >>, C<< ExtraFlags => $value >>, C<< Strict => 0|1 +>> =item Examples @@ -25018,8 +25472,7 @@ Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> =back -=head2 IO_Compress_Zlib::IO::Compress::Gzip, IO::Compress::Gzip - Write RFC -1952 files/buffers +=head2 IO::Compress::RawDeflate - Write RFC 1951 files/buffers =over 4 @@ -25031,7 +25484,7 @@ Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> =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 @@ -25058,11 +25511,7 @@ A filename, A filehandle, A scalar reference =item Constructor Options C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A -Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Minimal => 0|1 >>, -C<< Comment => $comment >>, C<< Name => $string >>, C<< Time => $number >>, -C<< TextFlag => 0|1 >>, C<< HeaderCRC => 0|1 >>, C<< OS_Code => $value >>, -C<< ExtraField => $data >>, C<< ExtraFlags => $value >>, C<< Strict => 0|1 ->> +Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> =item Examples @@ -25130,8 +25579,7 @@ C<< ExtraField => $data >>, C<< ExtraFlags => $value >>, C<< Strict => 0|1 =back -=head2 IO_Compress_Zlib::IO::Compress::RawDeflate, IO::Compress::RawDeflate -- Write RFC 1951 files/buffers +=head2 IO::Compress::Zip - Write zip files/buffers =over 4 @@ -25143,7 +25591,7 @@ C<< ExtraField => $data >>, C<< ExtraFlags => $value >>, C<< Strict => 0|1 =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 @@ -25170,7 +25618,14 @@ A filename, A filehandle, A scalar reference =item Constructor Options C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A -Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> +Filehandle, C<< Name => $string >>, C<< Time => $number >>, C<< ExtAttr => +$attr >>, C<< exTime => [$atime, $mtime, $ctime] >>, C<< exUnix2 => [$uid, +$gid] >>, C<< Comment => $comment >>, C<< ZipComment => $comment >>, C<< +Method => $method >>, C<< Stream => 0|1 >>, C<< Zip64 => 0|1 >>, C<< +TextFlag => 0|1 >>, C<< ExtraFieldLocal => $data >> =item C<< +ExtraFieldCentral => $data >>, C<< Minimal => 1|0 >>, C<< BlockSize100K => +number >>, C<< WorkFactor => number >>, -Level, -Strategy, C<< Strict => +0|1 >> =item Examples @@ -25216,7 +25671,7 @@ Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> =item Importing -:all, :constants, :flush, :level, :strategy +:all, :constants, :flush, :level, :strategy, :zip_method =item EXAMPLES @@ -25238,8 +25693,7 @@ Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> =back -=head2 IO_Compress_Zlib::IO::Compress::Zip, IO::Compress::Zip - Write zip -files/buffers +=head2 IO::Dir - supply object methods for directory handles =over 4 @@ -25247,114 +25701,240 @@ files/buffers =item DESCRIPTION -=item Functional Interface +new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), +rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 IO::File - supply object methods for filehandles =over 4 -=item zip $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 CONSTRUCTOR -=item Optional Parameters +new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile -C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> +=item METHODS -=item Examples +open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( +[LAYER] ) + +=item NOTE + +=item SEE ALSO + +=item HISTORY =back -=item OO Interface +=head2 IO::Handle - supply object methods for I/O handles =over 4 -=item Constructor +=item SYNOPSIS -A filename, A filehandle, A scalar reference +=item DESCRIPTION -=item Constructor Options +=item CONSTRUCTOR -C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A -Filehandle, C<< Name => $string >>, C<< Time => $number >>, C<< ExtAttr => -$attr >>, C<< exTime => [$atime, $mtime, $ctime] >>, C<< exUnix2 => [$uid, -$gid] >>, C<< Comment => $comment >>, C<< ZipComment => $comment >>, C<< -Method => $method >>, C<< Stream => 0|1 >>, C<< Zip64 => 0|1 >>, C<< -TextFlag => 0|1 >>, C<< ExtraFieldLocal => $data >> =item C<< -ExtraFieldCentral => $data >>, C<< Minimal => 1|0 >>, C<< BlockSize100K => -number >>, C<< WorkFactor => number >>, -Level, -Strategy, C<< Strict => -0|1 >> +new (), new_from_fd ( FD, MODE ) -=item Examples +=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 -=item Methods +=head2 IO::Pipe - supply object methods for pipes =over 4 -=item print +=item SYNOPSIS -=item printf +=item DESCRIPTION -=item syswrite +=item CONSTRUCTOR -=item write +new ( [READER, WRITER] ) -=item flush +=item METHODS -=item tell +reader ([ARGS]), writer ([ARGS]), handles () -=item eof +=item SEE ALSO -=item seek +=item AUTHOR -=item binmode +=item COPYRIGHT -=item opened +=back -=item autoflush +=head2 IO::Poll - Object interface to system poll call -=item input_line_number +=over 4 -=item fileno +=item SYNOPSIS -=item close +=item DESCRIPTION -=item newStream([OPTS]) +=item METHODS -=item deflateParams +mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( +IO ), handles( [ EVENT_MASK ] ) + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT =back -=item Importing +=head2 IO::Seekable - supply seek based methods for I/O objects -:all, :constants, :flush, :level, :strategy, :zip_method +=over 4 -=item EXAMPLES +=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::Select - OO interface to the select system call =over 4 -=item Apache::GZip Revisited +=item SYNOPSIS -=item Working with Net::FTP +=item DESCRIPTION + +=item CONSTRUCTOR + +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::Socket - Object interface to socket communications + +=over 4 + +=item SYNOPSIS + +=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 MODIFICATION HISTORY +=item COPYRIGHT -=item COPYRIGHT AND LICENSE +=back + +=head2 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 +() =back -=head2 IO_Compress_Zlib::IO::Uncompress::AnyInflate, -IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip) file/buffer +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CONSTRUCTOR + +new ( [ARGS] ) + +=item METHODS + +hostpath(), peerpath() + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip) +file/buffer =over 4 @@ -25470,8 +26050,8 @@ the sub-field structure as defined in RFC 1952 =back -=head2 IO_Compress_Zlib::IO::Uncompress::Gunzip, IO::Uncompress::Gunzip - -Read RFC 1952 files/buffers +=head2 IO::Uncompress::AnyUncompress - Uncompress gzip, zip, bzip2 or lzop +file/buffer =over 4 @@ -25479,11 +26059,244 @@ Read RFC 1952 files/buffers =item DESCRIPTION +RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip, bzip2, lzop, lzf + =item Functional Interface =over 4 -=item gunzip $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 +Reference, An Output FileGlob + +=item Notes + +=item Optional Parameters + +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >> + +=item Examples + +=back + +=item OO Interface + +=over 4 + +=item Constructor + +A filename, A filehandle, A scalar reference + +=item Constructor Options + +C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string +>>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength => +$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< RawInflate => 0|1 +>> + +=item Examples + +=back + +=item Methods + +=over 4 + +=item read + +=item read + +=item getline + +=item getc + +=item ungetc + +=item getHeaderInfo + +=item tell + +=item eof + +=item seek + +=item binmode + +=item opened + +=item autoflush + +=item input_line_number + +=item fileno + +=item close + +=item nextStream + +=item trailingData + +=back + +=item Importing + +:all + +=item EXAMPLES + +=item SEE ALSO + +=item AUTHOR + +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE + +=back + +=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::Bunzip2 - Read bzip2 files/buffers + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item Functional Interface + +=over 4 + +=item bunzip2 $input => $output [, OPTS] + +A filename, A filehandle, A scalar reference, An array reference, An Input +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob + +=item Notes + +=item Optional Parameters + +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >> + +=item Examples + +=back + +=item OO Interface + +=over 4 + +=item Constructor + +A filename, A filehandle, A scalar reference + +=item Constructor Options + +C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string +>>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength => +$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< Small => 0|1 >> + +=item Examples + +=back + +=item Methods + +=over 4 + +=item read + +=item read + +=item getline + +=item getc + +=item ungetc + +=item getHeaderInfo + +=item tell + +=item eof + +=item seek + +=item binmode + +=item opened + +=item autoflush + +=item input_line_number + +=item fileno + +=item close + +=item nextStream + +=item trailingData + +=back + +=item Importing + +:all + +=item EXAMPLES + +=over 4 + +=item Working with Net::FTP + +=back + +=item SEE ALSO + +=item AUTHOR + +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE + +=back + +=head2 IO::Uncompress::Gunzip - Read RFC 1952 files/buffers + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item Functional Interface + +=over 4 + +=item gunzip $input => $output [, OPTS] A filename, A filehandle, A scalar reference, An array reference, An Input FileGlob string, A filename, A filehandle, A scalar reference, An Array @@ -25587,8 +26400,7 @@ Name, Comment =back -=head2 IO_Compress_Zlib::IO::Uncompress::Inflate, IO::Uncompress::Inflate - -Read RFC 1950 files/buffers +=head2 IO::Uncompress::Inflate - Read RFC 1950 files/buffers =over 4 @@ -25699,8 +26511,7 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =back -=head2 IO_Compress_Zlib::IO::Uncompress::RawInflate, -IO::Uncompress::RawInflate - Read RFC 1951 files/buffers +=head2 IO::Uncompress::RawInflate - Read RFC 1951 files/buffers =over 4 @@ -25811,8 +26622,7 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =back -=head2 IO_Compress_Zlib::IO::Uncompress::Unzip, IO::Uncompress::Unzip - -Read zip files/buffers +=head2 IO::Uncompress::Unzip - Read zip files/buffers =over 4 @@ -25911,8 +26721,6 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =item Working with Net::FTP -=item Walking through a zip file - =back =item SEE ALSO @@ -25925,39 +26733,383 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =back -=head2 IO_Compress_Zlib::pod::FAQ, IO::Compress::Zlib::FAQ -- Frequently -Asked Questions about IO::Compress::Zlib +=head2 IO::Zlib - IO:: style interface to L =over 4 +=item SYNOPSIS + =item DESCRIPTION +=item CONSTRUCTOR + +new ( [ARGS] ) + +=item OBJECT METHODS + +open ( FILENAME, MODE ), opened, close, getc, getline, getlines, print ( +ARGS... ), read ( BUF, NBYTES, [OFFSET] ), eof, seek ( OFFSET, WHENCE ), +tell, setpos ( POS ), getpos ( POS ) + +=item USING THE EXTERNAL GZIP + +=item CLASS METHODS + +has_Compress_Zlib, gzip_external, gzip_used, gzip_read_open, +gzip_write_open + +=item DIAGNOSTICS + +IO::Zlib::getlines: must be called in list context, +IO::Zlib::gzopen_external: mode '...' is illegal, IO::Zlib::import: '...' +is illegal, IO::Zlib::import: ':gzip_external' requires an argument, +IO::Zlib::import: 'gzip_read_open' requires an argument, IO::Zlib::import: +'gzip_read' '...' is illegal, IO::Zlib::import: 'gzip_write_open' requires +an argument, IO::Zlib::import: 'gzip_write_open' '...' is illegal, +IO::Zlib::import: no Compress::Zlib and no external gzip, IO::Zlib::open: +needs a filename, IO::Zlib::READ: NBYTES must be specified, +IO::Zlib::WRITE: too long LENGTH + +=item SEE ALSO + +=item HISTORY + +=item COPYRIGHT + +=back + +=head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory +handles + =over 4 -=item Compatibility with Unix compress/uncompress. +=item SYNOPSIS -=item Accessing .tar.Z files +=item DESCRIPTION -=item Accessing Zip Files +new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), +rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] -=item Compressed files and Net::FTP +=item SEE ALSO -=item How do I recompress using a different compression? +=item AUTHOR -=item Apache::GZip Revisited +=item COPYRIGHT -=item Using C to uncompress data embedded in a larger -file/buffer. +=back + +=head2 IO::lib::IO::File, IO::File - supply object methods for filehandles + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CONSTRUCTOR + +new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile + +=item METHODS + +open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( +[LAYER] ) + +=item NOTE + +=item SEE ALSO + +=item HISTORY =back +=head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O +handles + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CONSTRUCTOR + +new (), new_from_fd ( FD, MODE ) + +=item METHODS + +$io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines, +$io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error, +$io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ), +$io->blocking ( [ BOOL ] ), $io->untaint + +=item NOTE + +=item SEE ALSO + +=item BUGS + +=item HISTORY + +=back + +=head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CONSTRUCTOR + +new ( [READER, WRITER] ) + +=item METHODS + +reader ([ARGS]), writer ([ARGS]), handles () + =item SEE ALSO =item AUTHOR -=item MODIFICATION HISTORY +=item COPYRIGHT -=item COPYRIGHT AND LICENSE +=back + +=head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call + +=over 4 + +=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 COPYRIGHT + +=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::lib::IO::Select, IO::Select - OO interface to the select system +call + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CONSTRUCTOR + +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 SYNOPSIS + +=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 +() + +=back + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for +AF_UNIX domain sockets + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CONSTRUCTOR + +new ( [ARGS] ) + +=item METHODS + +hostpath(), peerpath() + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 IPC-SysV::lib::IPC::Msg, IPC::Msg - SysV Msg IPC object class + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS + +new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set +( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, +FLAGS ] ), stat + +=item SEE ALSO + +=item AUTHORS + +=item COPYRIGHT + +=back + +=head2 IPC-SysV::lib::IPC::Semaphore, IPC::Semaphore - SysV Semaphore IPC +object class + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=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 AUTHORS + +=item COPYRIGHT + +=back + +=head2 IPC-SysV::lib::IPC::SharedMem, IPC::SharedMem - SysV Shared Memory +IPC object class + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS + +new ( KEY , SIZE , FLAGS ), id, read ( POS, SIZE ), write ( STRING, POS, +SIZE ), remove, is_removed, stat, attach ( [FLAG] ), detach, addr + +=item SEE ALSO + +=item AUTHORS + +=item COPYRIGHT + +=back + +=head2 IPC-SysV::lib::IPC::SysV, IPC::SysV - System V IPC constants and +system calls + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +ftok( PATH ), ftok( PATH, ID ), shmat( ID, ADDR, FLAG ), shmdt( ADDR ), +memread( ADDR, VAR, POS, SIZE ), memwrite( ADDR, STRING, POS, SIZE ) + +=item SEE ALSO + +=item AUTHORS + +=item COPYRIGHT =back @@ -26077,94 +27229,6 @@ memread( ADDR, VAR, POS, SIZE ), memwrite( ADDR, STRING, POS, SIZE ) =back -=head2 IPC::SysV::lib::IPC::Msg, IPC::Msg - SysV Msg IPC object class - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=item METHODS - -new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set -( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, -FLAGS ] ), stat - -=item SEE ALSO - -=item AUTHORS - -=item COPYRIGHT - -=back - -=head2 IPC::SysV::lib::IPC::Semaphore, IPC::Semaphore - SysV Semaphore IPC -object class - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=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 AUTHORS - -=item COPYRIGHT - -=back - -=head2 IPC::SysV::lib::IPC::SharedMem, IPC::SharedMem - SysV Shared Memory -IPC object class - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=item METHODS - -new ( KEY , SIZE , FLAGS ), id, read ( POS, SIZE ), write ( STRING, POS, -SIZE ), remove, is_removed, stat, attach ( [FLAG] ), detach, addr - -=item SEE ALSO - -=item AUTHORS - -=item COPYRIGHT - -=back - -=head2 IPC::SysV::lib::IPC::SysV, IPC::SysV - System V IPC constants and -system calls - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -ftok( PATH ), ftok( PATH, ID ), shmat( ID, ADDR, FLAG ), shmdt( ADDR ), -memread( ADDR, VAR, POS, SIZE ), memwrite( ADDR, STRING, POS, SIZE ) - -=item SEE ALSO - -=item AUTHORS - -=item COPYRIGHT - -=back - =head2 IPCmd, IPC::Cmd - finding and running system commands made easy =over 4 @@ -26259,7 +27323,8 @@ Interleaving STDOUT/STDERR =back -=head2 List::Util - A selection of general-utility list subroutines +=head2 List-Utilib::List::Util, List::Util - A selection of general-utility +list subroutines =over 4 @@ -26280,8 +27345,8 @@ BLOCK LIST, shuffle LIST, sum LIST =back -=head2 List::Utilib::List::Util, List::Util - A selection of -general-utility list subroutines +=head2 List-Utilib::Scalar::Util, Scalar::Util - A selection of +general-utility scalar subroutines =over 4 @@ -26289,21 +27354,19 @@ general-utility list subroutines =item DESCRIPTION -first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce -BLOCK LIST, shuffle LIST, sum LIST +blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR, +looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR, +set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF =item KNOWN BUGS -=item SUGGESTED ADDITIONS - =item SEE ALSO =item COPYRIGHT =back -=head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of -general-utility scalar subroutines +=head2 List::Util - A selection of general-utility list subroutines =over 4 @@ -26311,12 +27374,13 @@ general-utility scalar subroutines =item DESCRIPTION -blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR, -looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR, -set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF +first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce +BLOCK LIST, shuffle LIST, sum LIST =item KNOWN BUGS +=item SUGGESTED ADDITIONS + =item SEE ALSO =item COPYRIGHT @@ -26906,7 +27970,7 @@ $ERROR_FH, $MSG_FH, $DEBUG_FH, $STACKTRACE_ON_ERROR =back -=head2 MIME::Base64 - Encoding and decoding of base64 strings +=head2 MIME-Base64, MIME::Base64 - Encoding and decoding of base64 strings =over 4 @@ -26929,7 +27993,7 @@ character in subroutine entry =back -=head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding +=head2 MIME-Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding of quoted-printable strings =over 4 @@ -26947,6 +28011,29 @@ decode_qp($str); =back +=head2 MIME::Base64 - Encoding and decoding of base64 strings + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +encode_base64($str), encode_base64($str, $eol);, decode_base64($str) + +=item DIAGNOSTICS + +Premature end of base64 data, Premature padding of base64 data, Wide +character in subroutine entry + +=item EXAMPLES + +=item COPYRIGHT + +=item SEE ALSO + +=back + =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable strings @@ -26965,6 +28052,31 @@ decode_qp($str); =back +=head2 Math-BigInt-FastCalc, Math::BigInt::FastCalc - Math::BigInt::Calc +with some XS for more speed + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item STORAGE + +=item METHODS + +=item LICENSE + +This program is free software; you may redistribute it and/or modify it +under +the same terms as Perl itself. + +=item AUTHORS + +=item SEE ALSO + +=back + =head2 Math::BigFloat - Arbitrary size floating point math package =over 4 @@ -27737,6 +28849,120 @@ Storable use =back +=head2 Module-Pluggable::lib::Devel::InnerPackage, Devel::InnerPackage - +find all the inner packages of a package + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS + +=over 4 + +=item list_packages + +=back + +=back + +=over 4 + +=item AUTHOR + +=item COPYING + +=item BUGS + +=back + +=head2 Module-Pluggable::lib::Module::Pluggable, Module::Pluggable - +automatically give your module the ability to have plugins + +=over 4 + +=item SYNOPSIS + +=item EXAMPLE + +=item DESCRIPTION + +=item ADVANCED USAGE + +=item INNER PACKAGES + +=item OPTIONS + +=over 4 + +=item sub_name + +=item search_path + +=item search_dirs + +=item instantiate + +=item require + +=item inner + +=item only + +=item except + +=item package + +=item file_regex + +=item include_editor_junk + +=back + +=item METHODs + +=over 4 + +=item search_path + +=back + +=item FUTURE PLANS + +=item AUTHOR + +=item COPYING + +=item BUGS + +=item SEE ALSO + +=back + +=head2 Module-Pluggable::lib::Module::Pluggable::Object, +Module::Pluggable::Object - automatically give your module the ability to +have plugins + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item OPTIONS + +=item AUTHOR + +=item COPYING + +=item BUGS + +=item SEE ALSO + +=back + =head2 Module::Build - Build and install Perl modules =over 4 @@ -27755,9 +28981,9 @@ Cookbook (L) build, clean, code, config_data, diff, dist, distcheck, distclean, distdir, distmeta, distsign, disttest, docs, fakeinstall, help, html, install, -manifest, manpages, pardist, ppd, ppmdist, prereq_report, pure_install, -realclean, retest, skipcheck, test, testall, testcover, testdb, testpod, -testpodcoverage, versioninstall +manifest, manpages, pardist, ppd, ppmdist, prereq_data, prereq_report, +pure_install, realclean, retest, skipcheck, test, testall, testcover, +testdb, testpod, testpodcoverage, versioninstall =item OPTIONS @@ -27810,7 +29036,7 @@ 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, use_tap_harness, tap_harness_args, xs_files, new_from_context(%args), -resume(), subclass() +resume(), subclass(), add_property, C, C, property_error =item METHODS @@ -27831,26 +29057,27 @@ install_types(), invoked_action(), notes(), notes($key), notes($key => $value), orig_dir(), os_type(), is_vmsish(), is_windowsish(), is_unixish(), 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) +=> $path), prepare_metadata(), prereq_failures(), prereq_data(), +prereq_report(), prompt($message, $default), recommends(), requires(), +rscan_dir($dir, $pattern), runtime_params(), runtime_params($key), +script_files(), up_to_date($source_file, $derived_file), +up_to_date(\@source_files, \@derived_files), y_n($message, $default) =item Autogenerated Accessors PL_files(), allow_mb_mismatch(), autosplit(), base_dir(), bindoc_dirs(), blib(), build_bat(), build_class(), build_elements(), build_requires(), build_script(), c_source(), config_dir(), configure_requires(), -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(), program_name(), -quiet(), recommends(), recurse_into(), recursive_test_files(), requires(), -scripts(), sign(), tap_harness_args(), test_file_exts(), use_rcfile(), -use_tap_harness(), verbose(), xs_files() +conflicts(), create_license(), 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(), program_name(), quiet(), recommends(), +recurse_into(), recursive_test_files(), requires(), scripts(), sign(), +tap_harness_args(), test_file_exts(), use_rcfile(), use_tap_harness(), +verbose(), xs_files() =back @@ -28017,6 +29244,10 @@ to the testing, do I generate a test file =item Modifying an action +=item Adding an action + +=item Bundling Module::Build + =back =item AUTHOR @@ -28204,6 +29435,8 @@ _backticks do_system +oneliner + _infer_xs_spec rscan_dir @@ -28222,6 +29455,8 @@ localize_file_path localize_dir_path +ACTION_clean + =over 4 =item AUTHOR @@ -28546,120 +29781,6 @@ ability to have plugins =back -=head2 Module::Pluggable::lib::Devel::InnerPackage, Devel::InnerPackage - -find all the inner packages of a package - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=item METHODS - -=over 4 - -=item list_packages - -=back - -=back - -=over 4 - -=item AUTHOR - -=item COPYING - -=item BUGS - -=back - -=head2 Module::Pluggable::lib::Module::Pluggable, Module::Pluggable - -automatically give your module the ability to have plugins - -=over 4 - -=item SYNOPSIS - -=item EXAMPLE - -=item DESCRIPTION - -=item ADVANCED USAGE - -=item INNER PACKAGES - -=item OPTIONS - -=over 4 - -=item sub_name - -=item search_path - -=item search_dirs - -=item instantiate - -=item require - -=item inner - -=item only - -=item except - -=item package - -=item file_regex - -=item include_editor_junk - -=back - -=item METHODs - -=over 4 - -=item search_path - -=back - -=item FUTURE PLANS - -=item AUTHOR - -=item COPYING - -=item BUGS - -=item SEE ALSO - -=back - -=head2 Module::Pluggable::lib::Module::Pluggable::Object, -Module::Pluggable::Object - automatically give your module the ability to -have plugins - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=item OPTIONS - -=item AUTHOR - -=item COPYING - -=item BUGS - -=item SEE ALSO - -=back - =head2 NDBM_File - Tied access to ndbm files =over 4 @@ -29416,40 +30537,6 @@ opdump (PAT) =back -=head2 Opcode::Safe, Safe - Compile and execute code in restricted -compartments - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -a new namespace, an operator mask - -=item WARNING - -=over 4 - -=item RECENT CHANGES - -=item Methods in class Safe - -permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP, -...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from -(PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING, STRICT), rdo -(FILENAME), root (NAMESPACE), mask (MASK) - -=item Some Safety Issues - -Memory, CPU, Snooping, Signals, State Changes - -=item AUTHOR - -=back - -=back - =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when compiling @@ -29711,6 +30798,35 @@ string, regexp, subroutine, array ref =back +=head2 Parse::CPAN::Meta - Parse META.yml and other similar CPAN metadata +files + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item FUNCTIONS + +=over 4 + +=item Load( $string ) + +=item LoadFile( $file_name ) + +=back + +=item SUPPORT + +=item AUTHOR + +=item SEE ALSO + +=item COPYRIGHT + +=back + =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::* name space @@ -29742,6 +30858,60 @@ name space =back +=head2 PerlIO-encoding, PerlIO::encoding - encoding layer + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=back + +=head2 PerlIO-scalar, PerlIO::scalar - in-memory IO, scalar IO + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item IMPLEMENTATION NOTE + +=back + +=head2 PerlIO-via, PerlIO::via - Helper class for PerlIO layers implemented +in perl + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item EXPECTED METHODS + +$class->PUSHED([$mode,[$fh]]), $obj->POPPED([$fh]), +$obj->UTF8($bellowFlag,[$fh]), $obj->OPEN($path,$mode,[$fh]), +$obj->BINMODE([$fh]), $obj->FDOPEN($fd,[$fh]), +$obj->SYSOPEN($path,$imode,$perm,[$fh]), $obj->FILENO($fh), +$obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh), +$obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh), +$obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh), +$obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh) + +=item EXAMPLES + +=over 4 + +=item Example - a Hexadecimal Handle + +=back + +=back + =head2 PerlIO::encoding - encoding layer =over 4 @@ -29776,10 +30946,10 @@ name space =item EXPECTED METHODS -$class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]), -$obj->UTF8($bellowFlag,[$fh]), $obj->OPEN($path,$mode[,$fh]), -$obj->BINMODE([,$fh]), $obj->FDOPEN($fd[,$fh]), -$obj->SYSOPEN($path,$imode,$perm,[,$fh]), $obj->FILENO($fh), +$class->PUSHED([$mode,[$fh]]), $obj->POPPED([$fh]), +$obj->UTF8($bellowFlag,[$fh]), $obj->OPEN($path,$mode,[$fh]), +$obj->BINMODE([$fh]), $obj->FDOPEN($fd,[$fh]), +$obj->SYSOPEN($path,$imode,$perm,[$fh]), $obj->FILENO($fh), $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh), $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh), $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh), @@ -30740,6 +31910,8 @@ I|I =item AUTHOR +=item LICENSE + =back =head2 Pod::Perldoc - Look up Perl documentation in Pod format. @@ -31777,6 +32949,8 @@ C<-input>, C<-pathlist>, C<-noperldoc> =item ACKNOWLEDGMENTS +=item SEE ALSO + =back =head2 SDBM_File - Tied access to sdbm files @@ -31932,8 +33106,8 @@ B<_make_cmd> =back -=head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C -socket.h defines and structure manipulators +=head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa, inet_pton, +inet_ntop - load the C socket.h defines and structure manipulators =over 4 @@ -31945,7 +33119,8 @@ inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST, INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT, ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS, unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un -SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN +SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN, +inet_pton ADDRESS_FAMILY, HOSTNAME, inet_ntop ADDRESS_FAMILY, IP_ADDRESS =back @@ -32068,7 +33243,8 @@ $buffer ), $info = Storable::read_magic( $buffer, $must_be_file ) =back -=head2 Sys::Hostname - Try every conceivable way to get hostname +=head2 Sys-Hostname, Sys::Hostname - Try every conceivable way to get +hostname =over 4 @@ -32080,7 +33256,7 @@ $buffer ), $info = Storable::read_magic( $buffer, $must_be_file ) =back -=head2 Syslog, Sys::Syslog - Perl interface to the UNIX syslog(3) calls +=head2 Sys-Syslog, Sys::Syslog - Perl interface to the UNIX syslog(3) calls =over 4 @@ -32156,8 +33332,34 @@ tracker, Search CPAN, Kobes' CPAN Search, Perl Documentation =back -=head2 Syslog::Syslog, Sys::Syslog - Perl interface to the UNIX syslog(3) -calls +=head2 Sys-Syslog::win32::Win32, Sys::Syslog::Win32 - Win32 support for +Sys::Syslog + +=over 4 + +=item DESCRIPTION + +=item SEE ALSO + +=item AUTHORS + +=item LICENSE + +=back + +=head2 Sys::Hostname - Try every conceivable way to get hostname + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item AUTHOR + +=back + +=head2 Syslog, Sys::Syslog - Perl interface to the UNIX syslog(3) calls =over 4 @@ -32233,23 +33435,34 @@ tracker, Search CPAN, Kobes' CPAN Search, Perl Documentation =back -=head2 Syslog::win32::Win32, Sys::Syslog::Win32 - Win32 support for -Sys::Syslog +=head2 TAP::Base - Base class that provides common functionality to +L +and L + +=over 4 + +=item VERSION + +=back =over 4 +=item SYNOPSIS + =item DESCRIPTION -=item SEE ALSO +=item METHODS -=item AUTHORS +=over 4 -=item LICENSE +=item Class Methods =back -=head2 TAP::Base - Base class that provides common functionality to -L and L +=back + +=head2 TAP::Formatter::Base, TAP::Formatter::Console - Harness output +delegate for default console output =over 4 @@ -32259,9 +33472,13 @@ L and L =over 4 +=item DESCRIPTION + =item SYNOPSIS -=item DESCRIPTION +=back + +=over 4 =item METHODS @@ -32269,6 +33486,10 @@ L and L =item Class Methods +C, C, C, C, C, C, +C, C, C, C, C, C, +C + =back =back @@ -32312,19 +33533,9 @@ console output =item SYNOPSIS -=back - =over 4 -=item METHODS - -=over 4 - -=item Class Methods - -C, C, C, C, C, C, -C, C, C, C, C, C, -C +=item C<< open_test >> =back @@ -32372,8 +33583,82 @@ default console output =item DESCRIPTION +=back + +=over 4 + +=item C<< clear_for_close >> + +=item C<< close_test >> + +=item C<< header >> + +=item C<< result >> + +=back + +=head2 TAP::Formatter::File - Harness output delegate for file output + +=over 4 + +=item VERSION + +=back + +=over 4 + +=item DESCRIPTION + =item SYNOPSIS +=over 4 + +=item C<< open_test >> + +=back + +=back + +=head2 TAP::Formatter::File::Session - Harness output delegate for file +output + +=over 4 + +=item VERSION + +=back + +=over 4 + +=item DESCRIPTION + +=back + +=over 4 + +=item METHODS + +=over 4 + +=item result + +=back + +=back + +=over 4 + +=item close_test + +=back + +=head2 TAP::Formatter::Session - Abstract base class for harness output +delegate + +=over 4 + +=item VERSION + =back =over 4 @@ -32653,11 +33938,12 @@ TAP::Parser results =item Summary methods -failed, parse_errors, passed, skipped, todo, todo_passed, wait, exit +failed, parse_errors, passed, planned, skipped, todo, todo_passed, wait, +exit =back -Failed tests, Parse erros, Bad exit or wait status +Failed tests, Parse errors, Bad exit or wait status =over 4 @@ -33727,307 +35013,129 @@ NORMAL TESTS, SKIPPED TESTS, TODO TESTS =back -=head2 Test::Builder - Backend for building test libraries - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION +=head2 Test-Harness::lib::App::Prove, App::Prove - Implements the C +command. =over 4 -=item Construction - -B - -=back +=item VERSION =back -B - -B - =over 4 -=item Setting up tests +=item DESCRIPTION -B +=item SYNOPSIS =back -B - -B - -B - -B - -B - =over 4 -=item Running tests - -B - -=back - -B, B - -B, B - -B, B - -B +=item METHODS =over 4 -=item Other Testing Methods - -B +=item Class Methods =back -B - -B - -B - -=over 4 - -=item Test building utility methods - -B - =back -B<_try> - -B - =over 4 -=item Test style +=item Attributes -B +C, C, C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C =back -B - -B, B, B - =over 4 -=item Output - -B - -=back - -B - -B - -B<_print> - -B, B, B - -reset_outputs - -carp, croak +=item PLUGINS =over 4 -=item Test Status and Info - -B +=item Sample Plugin =back -B - -B
- -B - -B - -B - -B - -C - -B - -B<_sanity_check> - -B<_whoa> - -B<_my_exit> - -=over 4 - -=item EXIT CODES - -=item THREADS - -=item EXAMPLES - =item SEE ALSO -=item AUTHORS - -=item COPYRIGHT - =back -=head2 Test::Builder::Module - Base class for test modules - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION +=head2 Test-Harness::lib::App::Prove::State, App::Prove::State - State +storage for the C command. =over 4 -=item Importing - -=back +=item VERSION =back =over 4 -=item Builder - -=back - -=head2 Test::Builder::Tester - test testsuites that have been built with -Test::Builder - -=over 4 +=item DESCRIPTION =item SYNOPSIS -=item DESCRIPTION - =back =over 4 -=item Functions - -test_out, test_err - -=back - -test_fail - -test_diag - -test_test, title (synonym 'name', 'label'), skip_out, skip_err - -line_num - -color +=item METHODS =over 4 -=item BUGS - -=item AUTHOR - -=item NOTES +=item Class Methods -=item SEE ALSO +C, C (optional), C (optional) =back -=head2 Test::Builder::Tester::Color - turn on colour in -Test::Builder::Tester - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - =back =over 4 -=item AUTHOR - -=item BUGS - -=item SEE ALSO +=item C =back -=head2 Test::Harness - Run Perl standard test scripts with statistics - =over 4 -=item VERSION +=item C =back =over 4 -=item SYNOPSIS - -=item DESCRIPTION - -=item FUNCTIONS - -=over 4 - -=item runtests( @test_files ) - -=back +=item C =back =over 4 -=item execute_tests( tests => \@test_files, out => \*FH ) +=item C =back =over 4 -=item EXPORT - -=item ENVIRONMENT VARIABLES THAT TAP::HARNESS::COMPATIBLE SETS - -C, C - -=item ENVIRONMENT VARIABLES THAT AFFECT TEST::HARNESS - -C, C, C, C<< j >>, C<< -f >> - -=item Taint Mode - -=item SEE ALSO - -=item BUGS - -=item AUTHORS +=item Instance Methods -=item LICENCE AND COPYRIGHT +C, C, C, C, C, C, C, C, +C, C, C =back -=head2 Test::Harness::lib::App::Prove, App::Prove - Implements the C -command. +=head2 Test-Harness::lib::App::Prove::State::Result, +App::Prove::State::Result - Individual test suite results. =over 4 @@ -34057,20 +35165,18 @@ command. =over 4 -=item Attributes +=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 +=back + +=over 4 + +=item C =back -=head2 Test::Harness::lib::App::Prove::State, App::Prove::State - State -storage for the C command. +=head2 Test-Harness::lib::App::Prove::State::Result::Test, +App::Prove::State::Result::Test - Individual test results. =over 4 @@ -34100,39 +35206,13 @@ storage for the C command. =over 4 -=item C - -=back - -=over 4 - -=item C - -=back - -=over 4 - -=item C - -=back - -=over 4 - -=item C - -=back - -=over 4 - =item Instance Methods -C, C, C, C, C, C, C, C, -C, C, C - =back -=head2 Test::Harness::lib::App::Prove::State::Result, -App::Prove::State::Result - Individual test suite results. +=head2 Test-Harness::lib::TAP::Base, TAP::Base - Base class that provides +common functionality to L +and L =over 4 @@ -34142,13 +35222,9 @@ App::Prove::State::Result - Individual test suite results. =over 4 -=item DESCRIPTION - =item SYNOPSIS -=back - -=over 4 +=item DESCRIPTION =item METHODS @@ -34160,20 +35236,8 @@ App::Prove::State::Result - Individual test suite results. =back -=over 4 - -=item C - -=back - -=over 4 - -=item C - -=back - -=head2 Test::Harness::lib::App::Prove::State::Result::Test, -App::Prove::State::Result::Test - Individual test results. +=head2 Test-Harness::lib::TAP::Formatter::Base, TAP::Formatter::Console - +Harness output delegate for default console output =over 4 @@ -34197,18 +35261,16 @@ App::Prove::State::Result::Test - Individual test results. =item Class Methods -=back +C, C, C, C, C, C, +C, C, C, C, C, C, +C =back -=over 4 - -=item Instance Methods - =back -=head2 Test::Harness::lib::TAP::Base, TAP::Base - Base class that provides -common functionality to L and L +=head2 Test-Harness::lib::TAP::Formatter::Color, TAP::Formatter::Color - +Run Perl test scripts with color =over 4 @@ -34218,10 +35280,10 @@ common functionality to L and L =over 4 -=item SYNOPSIS - =item DESCRIPTION +=item SYNOPSIS + =item METHODS =over 4 @@ -34232,8 +35294,8 @@ common functionality to L and L =back -=head2 Test::Harness::lib::TAP::Formatter::Color, TAP::Formatter::Color - -Run Perl test scripts with color +=head2 Test-Harness::lib::TAP::Formatter::Console, TAP::Formatter::Console +- Harness output delegate for default console output =over 4 @@ -34247,18 +35309,17 @@ Run Perl test scripts with color =item SYNOPSIS -=item METHODS - =over 4 -=item Class Methods +=item C<< open_test >> =back =back -=head2 Test::Harness::lib::TAP::Formatter::Console, TAP::Formatter::Console -- Harness output delegate for default console output +=head2 Test-Harness::lib::TAP::Formatter::Console::ParallelSession, +TAP::Formatter::Console::ParallelSession - Harness output delegate for +parallel console output =over 4 @@ -34282,17 +35343,13 @@ Run Perl test scripts with color =item Class Methods -C, C, C, C, C, C, -C, C, C, C, C, C, -C - =back =back -=head2 Test::Harness::lib::TAP::Formatter::Console::ParallelSession, -TAP::Formatter::Console::ParallelSession - Harness output delegate for -parallel console output +=head2 Test-Harness::lib::TAP::Formatter::Console::Session, +TAP::Formatter::Console::Session - Harness output delegate for default +console output =over 4 @@ -34304,25 +35361,45 @@ parallel console output =item DESCRIPTION -=item SYNOPSIS +=back + +=over 4 + +=item C<< clear_for_close >> + +=item C<< close_test >> + +=item C<< header >> + +=item C<< result >> =back +=head2 Test-Harness::lib::TAP::Formatter::File, TAP::Formatter::File - +Harness output delegate for file output + =over 4 -=item METHODS +=item VERSION + +=back =over 4 -=item Class Methods +=item DESCRIPTION + +=item SYNOPSIS + +=over 4 + +=item C<< open_test >> =back =back -=head2 Test::Harness::lib::TAP::Formatter::Console::Session, -TAP::Formatter::Console::Session - Harness output delegate for default -console output +=head2 Test-Harness::lib::TAP::Formatter::File::Session, +TAP::Formatter::File::Session - Harness output delegate for file output =over 4 @@ -34334,7 +35411,32 @@ console output =item DESCRIPTION -=item SYNOPSIS +=back + +=over 4 + +=item METHODS + +=over 4 + +=item result + +=back + +=back + +=over 4 + +=item close_test + +=back + +=head2 Test-Harness::lib::TAP::Formatter::Session, TAP::Formatter::Session +- Abstract base class for harness output delegate + +=over 4 + +=item VERSION =back @@ -34352,7 +35454,7 @@ C, C, C, C =back -=head2 Test::Harness::lib::TAP::Harness, TAP::Harness - Run test scripts +=head2 Test-Harness::lib::TAP::Harness, TAP::Harness - Run test scripts with statistics =over 4 @@ -34418,7 +35520,7 @@ C, C =back -=head2 Test::Harness::lib::TAP::Object, TAP::Object - Base class that +=head2 Test-Harness::lib::TAP::Object, TAP::Object - Base class that provides common functionality to all C modules =over 4 @@ -34449,7 +35551,7 @@ provides common functionality to all C modules =back -=head2 Test::Harness::lib::TAParser, TAP::Parser - Parse +=head2 Test-Harness::lib::TAParser, TAP::Parser - Parse L output =over 4 @@ -34582,7 +35684,7 @@ Kraai, David Wheeler, Alex Vandiver =back -=head2 Test::Harness::lib::TAParser::Aggregator, TAP::Parser::Aggregator - +=head2 Test-Harness::lib::TAParser::Aggregator, TAP::Parser::Aggregator - Aggregate TAP::Parser results =over 4 @@ -34617,11 +35719,12 @@ Aggregate TAP::Parser results =item Summary methods -failed, parse_errors, passed, skipped, todo, todo_passed, wait, exit +failed, parse_errors, passed, planned, skipped, todo, todo_passed, wait, +exit =back -Failed tests, Parse erros, Bad exit or wait status +Failed tests, Parse errors, Bad exit or wait status =over 4 @@ -34629,7 +35732,7 @@ Failed tests, Parse erros, Bad exit or wait status =back -=head2 Test::Harness::lib::TAParser::Grammar, TAP::Parser::Grammar - A +=head2 Test-Harness::lib::TAParser::Grammar, TAP::Parser::Grammar - A grammar for the Test Anything Protocol. =over 4 @@ -34670,7 +35773,7 @@ grammar for the Test Anything Protocol. =back -=head2 Test::Harness::lib::TAParser::Iterator, TAP::Parser::Iterator - +=head2 Test-Harness::lib::TAParser::Iterator, TAP::Parser::Iterator - Internal base class for TAP::Parser Iterators =over 4 @@ -34711,7 +35814,7 @@ Internal base class for TAP::Parser Iterators =back -=head2 Test::Harness::lib::TAParser::Iterator::Array, +=head2 Test-Harness::lib::TAParser::Iterator::Array, TAP::Parser::Iterator::Array - Internal TAP::Parser array Iterator =over 4 @@ -34746,7 +35849,7 @@ TAP::Parser::Iterator::Array - Internal TAP::Parser array Iterator =back -=head2 Test::Harness::lib::TAParser::Iterator::Process, +=head2 Test-Harness::lib::TAParser::Iterator::Process, TAP::Parser::Iterator::Process - Internal TAP::Parser Iterator =over 4 @@ -34781,7 +35884,7 @@ TAP::Parser::Iterator::Process - Internal TAP::Parser Iterator =back -=head2 Test::Harness::lib::TAParser::Iterator::Stream, +=head2 Test-Harness::lib::TAParser::Iterator::Stream, TAP::Parser::Iterator::Stream - Internal TAP::Parser Iterator =over 4 @@ -34820,7 +35923,7 @@ TAP::Parser::Iterator::Stream - Internal TAP::Parser Iterator =back -=head2 Test::Harness::lib::TAParser::IteratorFactory, +=head2 Test-Harness::lib::TAParser::IteratorFactory, TAP::Parser::IteratorFactory - Internal TAP::Parser Iterator =over 4 @@ -34861,8 +35964,8 @@ TAP::Parser::IteratorFactory - Internal TAP::Parser Iterator =back -=head2 Test::Harness::lib::TAParser::Multiplexer, TAP::Parser::Multiplexer -- Multiplex multiple TAP::Parsers +=head2 Test-Harness::lib::TAParser::Multiplexer, TAP::Parser::Multiplexer - +Multiplex multiple TAP::Parsers =over 4 @@ -34898,7 +36001,7 @@ TAP::Parser::IteratorFactory - Internal TAP::Parser Iterator =back -=head2 Test::Harness::lib::TAParser::Result, TAP::Parser::Result - Base +=head2 Test-Harness::lib::TAParser::Result, TAP::Parser::Result - Base class for TAP::Parser output objects =over 4 @@ -34944,7 +36047,7 @@ C, C, C =back -=head2 Test::Harness::lib::TAParser::Result::Bailout, +=head2 Test-Harness::lib::TAParser::Result::Bailout, TAP::Parser::Result::Bailout - Bailout result token. =over 4 @@ -34969,7 +36072,7 @@ C =back -=head2 Test::Harness::lib::TAParser::Result::Comment, +=head2 Test-Harness::lib::TAParser::Result::Comment, TAP::Parser::Result::Comment - Comment result token. =over 4 @@ -34994,8 +36097,8 @@ C =back -=head2 Test::Harness::lib::TAParser::Result::Plan, -TAP::Parser::Result::Plan - Plan result token. +=head2 Test-Harness::lib::TAParser::Result::Plan, TAP::Parser::Result::Plan +- Plan result token. =over 4 @@ -35019,7 +36122,7 @@ C, C =back -=head2 Test::Harness::lib::TAParser::Result::Pragma, +=head2 Test-Harness::lib::TAParser::Result::Pragma, TAP::Parser::Result::Pragma - TAP pragma token. =over 4 @@ -35044,8 +36147,8 @@ C, C =back -=head2 Test::Harness::lib::TAParser::Result::Test, -TAP::Parser::Result::Test - Test result token. +=head2 Test-Harness::lib::TAParser::Result::Test, TAP::Parser::Result::Test +- Test result token. =over 4 @@ -35067,7 +36170,7 @@ TAP::Parser::Result::Test - Test result token. =back -=head2 Test::Harness::lib::TAParser::Result::Unknown, +=head2 Test-Harness::lib::TAParser::Result::Unknown, TAP::Parser::Result::Unknown - Unknown result token. =over 4 @@ -35082,12 +36185,259 @@ TAP::Parser::Result::Unknown - Unknown result token. =item OVERRIDDEN METHODS -C, C +C, C + +=back + +=head2 Test-Harness::lib::TAParser::Result::Version, +TAP::Parser::Result::Version - TAP syntax version token. + +=over 4 + +=item VERSION + +=back + +=over 4 + +=item DESCRIPTION + +=item OVERRIDDEN METHODS + +C, C + +=back + +=over 4 + +=item Instance Methods + +=back + +=head2 Test-Harness::lib::TAParser::Result::YAML, TAP::Parser::Result::YAML +- YAML result token. + +=over 4 + +=item VERSION + +=back + +=over 4 + +=item DESCRIPTION + +=item OVERRIDDEN METHODS + +C, C + +=back + +=over 4 + +=item Instance Methods + +=back + +=head2 Test-Harness::lib::TAParser::ResultFactory, +TAP::Parser::ResultFactory - Factory for creating TAP::Parser output +objects + +=over 4 + +=item SYNOPSIS + +=item VERSION + +=back + +=over 4 + +=item DESCRIPTION + +=item METHODS + +=item Class Methods + +=back + +=over 4 + +=item SUBCLASSING + +=over 4 + +=item Example + +=back + +=item SEE ALSO + +=back + +=head2 Test-Harness::lib::TAParser::Scheduler, TAP::Parser::Scheduler - +Schedule tests during parallel testing + +=over 4 + +=item VERSION + +=back + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS + +=over 4 + +=item Class Methods + +=back + +=back + +=head2 Test-Harness::lib::TAParser::Scheduler::Job, +TAP::Parser::Scheduler::Job - A single testing job. + +=over 4 + +=item VERSION + +=back + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS + +=over 4 + +=item Class Methods + +=back + +=back + +=head2 Test-Harness::lib::TAParser::Scheduler::Spinner, +TAP::Parser::Scheduler::Spinner - A no-op job. + +=over 4 + +=item VERSION + +=back + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS + +=over 4 + +=item Class Methods + +=back + +=back + +=head2 Test-Harness::lib::TAParser::Source, TAP::Parser::Source - Stream +output from some source + +=over 4 + +=item VERSION + +=back + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS + +=over 4 + +=item Class Methods + +=back + +=back + +=over 4 + +=item Instance Methods + +=back + +=over 4 + +=item SUBCLASSING + +=over 4 + +=item Example + +=back + +=item SEE ALSO + +=back + +=head2 Test-Harness::lib::TAParser::Source::Perl, TAP::Parser::Source::Perl +- Stream Perl output + +=over 4 + +=item VERSION + +=back + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS + +=over 4 + +=item Class Methods + +=item Instance Methods + +=back + +=back + +=over 4 + +=item SUBCLASSING + +=over 4 + +=item Example + +=back + +=item SEE ALSO =back -=head2 Test::Harness::lib::TAParser::Result::Version, -TAP::Parser::Result::Version - TAP syntax version token. +=head2 Test-Harness::lib::TAParser::Utils, TAP::Parser::Utils - Internal +TAP::Parser utilities =over 4 @@ -35097,83 +36447,81 @@ TAP::Parser::Result::Version - TAP syntax version token. =over 4 +=item SYNOPSIS + =item DESCRIPTION -=item OVERRIDDEN METHODS +=over 4 -C, C +=item INTERFACE =back -=over 4 - -=item Instance Methods - =back -=head2 Test::Harness::lib::TAParser::Result::YAML, -TAP::Parser::Result::YAML - YAML result token. +=head2 Test-Harness::lib::TAParser::YAMLish::Reader, +TAP::Parser::YAMLish::Reader - Read YAMLish data from iterator =over 4 =item VERSION -=back - -=over 4 +=item SYNOPSIS =item DESCRIPTION -=item OVERRIDDEN METHODS - -C, C - -=back +=item METHODS =over 4 +=item Class Methods + =item Instance Methods =back -=head2 Test::Harness::lib::TAParser::ResultFactory, -TAP::Parser::ResultFactory - Factory for creating TAP::Parser output -objects - -=over 4 +=item AUTHOR -=item SYNOPSIS +=item SEE ALSO -=item VERSION +=item COPYRIGHT =back +=head2 Test-Harness::lib::TAParser::YAMLish::Writer, +TAP::Parser::YAMLish::Writer - Write YAMLish data + =over 4 -=item DESCRIPTION +=item VERSION -=item METHODS +=item SYNOPSIS -=item Class Methods +=item DESCRIPTION -=back +=item METHODS =over 4 -=item SUBCLASSING +=item Class Methods -=over 4 +=item Instance Methods -=item Example +a reference to a scalar to append YAML to, the handle of an open file, a +reference to an array into which YAML will be pushed, a code reference =back +=item AUTHOR + =item SEE ALSO +=item COPYRIGHT + =back -=head2 Test::Harness::lib::TAParser::Scheduler, TAP::Parser::Scheduler - -Schedule tests during parallel testing +=head2 Test-Harness::lib::Test::Harness, Test::Harness - Run Perl standard +test scripts with statistics =over 4 @@ -35187,161 +36535,209 @@ Schedule tests during parallel testing =item DESCRIPTION -=item METHODS +=item FUNCTIONS =over 4 -=item Class Methods +=item runtests( @test_files ) =back =back -=head2 Test::Harness::lib::TAParser::Scheduler::Job, -TAP::Parser::Scheduler::Job - A single testing job. - =over 4 -=item VERSION +=item execute_tests( tests => \@test_files, out => \*FH ) =back =over 4 -=item SYNOPSIS +=item EXPORT -=item DESCRIPTION +=item ENVIRONMENT VARIABLES THAT TAP::HARNESS::COMPATIBLE SETS -=item METHODS +C, C -=over 4 +=item ENVIRONMENT VARIABLES THAT AFFECT TEST::HARNESS -=item Class Methods +C, C, C, C<< j >>, C<< +f >> -=back +=item Taint Mode -=back +=item SEE ALSO -=head2 Test::Harness::lib::TAParser::Scheduler::Spinner, -TAP::Parser::Scheduler::Spinner - A no-op job. +=item BUGS -=over 4 +=item AUTHORS -=item VERSION +=item LICENCE AND COPYRIGHT =back +=head2 Test::Builder - Backend for building test libraries + =over 4 =item SYNOPSIS =item DESCRIPTION -=item METHODS - =over 4 -=item Class Methods +=item Construction + +B =back =back -=head2 Test::Harness::lib::TAParser::Source, TAP::Parser::Source - Stream -output from some source +B + +B =over 4 -=item VERSION +=item Setting up tests + +B =back -=over 4 +B -=item SYNOPSIS +B -=item DESCRIPTION +B -=item METHODS +B + +B =over 4 -=item Class Methods +=item Running tests -=back +B =back +B, B + +B, B + +B, B + +B + =over 4 -=item Instance Methods +=item Other Testing Methods + +B =back -=over 4 +B -=item SUBCLASSING +B + +B =over 4 -=item Example +=item Test building utility methods + +B =back -=item SEE ALSO +B<_try> + +B + +=over 4 + +=item Test style + +B =back -=head2 Test::Harness::lib::TAParser::Source::Perl, -TAP::Parser::Source::Perl - Stream Perl output +B + +B, B, B =over 4 -=item VERSION +=item Output + +B =back -=over 4 +B -=item SYNOPSIS +B -=item DESCRIPTION +B<_print> -=item METHODS +B, B, B + +reset_outputs + +carp, croak =over 4 -=item Class Methods +=item Test Status and Info -=item Instance Methods +B =back -=back +B -=over 4 +B
-=item SUBCLASSING +B -=over 4 +B -=item Example +B -=back +B -=item SEE ALSO +C -=back +B -=head2 Test::Harness::lib::TAParser::Utils, TAP::Parser::Utils - Internal -TAP::Parser utilities +B<_sanity_check> + +B<_whoa> + +B<_my_exit> =over 4 -=item VERSION +=item EXIT CODES + +=item THREADS + +=item EXAMPLES + +=item SEE ALSO + +=item AUTHORS + +=item COPYRIGHT =back +=head2 Test::Builder::Module - Base class for test modules + =over 4 =item SYNOPSIS @@ -35350,75 +36746,81 @@ TAP::Parser utilities =over 4 -=item INTERFACE +=item Importing =back =back -=head2 Test::Harness::lib::TAParser::YAMLish::Reader, -TAP::Parser::YAMLish::Reader - Read YAMLish data from iterator - =over 4 -=item VERSION +=item Builder + +=back + +=head2 Test::Builder::Tester - test testsuites that have been built with +Test::Builder + +=over 4 =item SYNOPSIS =item DESCRIPTION -=item METHODS +=back =over 4 -=item Class Methods +=item Functions -=item Instance Methods +test_out, test_err =back -=item AUTHOR +test_fail -=item SEE ALSO +test_diag -=item COPYRIGHT +test_test, title (synonym 'name', 'label'), skip_out, skip_err -=back +line_num -=head2 Test::Harness::lib::TAParser::YAMLish::Writer, -TAP::Parser::YAMLish::Writer - Write YAMLish data +color =over 4 -=item VERSION +=item BUGS -=item SYNOPSIS +=item AUTHOR -=item DESCRIPTION +=item NOTES -=item METHODS +=item SEE ALSO -=over 4 +=back -=item Class Methods +=head2 Test::Builder::Tester::Color - turn on colour in +Test::Builder::Tester -=item Instance Methods +=over 4 -a reference to a scalar to append YAML to, the handle of an open file, a -reference to an array into which YAML will be pushed, a code reference +=item SYNOPSIS + +=item DESCRIPTION =back +=over 4 + =item AUTHOR -=item SEE ALSO +=item BUGS -=item COPYRIGHT +=item SEE ALSO =back -=head2 Test::Harness::lib::Test::Harness, Test::Harness - Run Perl standard -test scripts with statistics +=head2 Test::Harness - Run Perl standard test scripts with statistics =over 4 @@ -35671,6 +37073,25 @@ L =back +=head2 Text-Soundex, Text::Soundex - Implementation of the soundex +algorithm. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item EXAMPLES + +=item LIMITATIONS + +=item MAINTAINER + +=item HISTORY + +=back + =head2 Text::Abbrev, abbrev - create an abbreviation table from a list =over 4 @@ -35818,6 +37239,8 @@ unexpand(1) =item EXAMPLES +=item SEE ALSO + =item LICENSE =back @@ -36135,6 +37558,110 @@ TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this =back +=head2 Time-HiRes, Time::HiRes - High resolution alarm, sleep, +gettimeofday, interval timers + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +gettimeofday (), usleep ( $useconds ), nanosleep ( $nanoseconds ), ualarm ( +$useconds [, $interval_useconds ] ), tv_interval, time (), sleep ( +$floating_seconds ), alarm ( $floating_seconds [, +$interval_floating_seconds ] ), setitimer ( $which, $floating_seconds [, +$interval_floating_seconds ] ), getitimer ( $which ), clock_gettime ( +$which ), clock_getres ( $which ), clock_nanosleep ( $which, $nanoseconds, +$flags = 0), clock(), stat, stat FH, stat EXPR + +=item EXAMPLES + +=item C API + +=item DIAGNOSTICS + +=over 4 + +=item useconds or interval more than ... + +=item negative time not invented yet + +=item internal error: useconds < 0 (unsigned ... signed ...) + +=item useconds or uinterval equal to or more than 1000000 + +=item unimplemented in this platform + +=back + +=item CAVEATS + +=item SEE ALSO + +=item AUTHORS + +=item COPYRIGHT AND LICENSE + +=back + +=head2 Time-Piece, Time::Piece - Object Oriented time objects + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item USAGE + +=over 4 + +=item Local Locales + +=item Date Calculations + +=item Date Comparisons + +=item Date Parsing + +=item YYYY-MM-DDThh:mm:ss + +=item Week Number + +=item Global Overriding + +=back + +=item AUTHOR + +=item License + +=item SEE ALSO + +=item BUGS + +=back + +=head2 Time-Piece::Seconds, Time::Seconds - a simple API to convert seconds +to other date values + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS + +=item AUTHOR + +=item LICENSE + +=item Bugs + +=back + =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval timers @@ -36200,14 +37727,10 @@ $flags = 0), clock(), stat, stat FH, stat EXPR =item Year Value Interpretation -=item Limits of time_t - =item Ambiguous Local Times (DST) =item Non-Existent Local Times (DST) -=item Negative Epoch Values - =back =item IMPLEMENTATION @@ -36260,25 +37783,6 @@ $flags = 0), clock(), stat, stat FH, stat EXPR =back -=head2 Time::Piece::Seconds, Time::Seconds - a simple API to convert -seconds to other date values - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=item METHODS - -=item AUTHOR - -=item LICENSE - -=item Bugs - -=back - =head2 Time::Seconds - a simple API to convert seconds to other date values =over 4 @@ -36352,10 +37856,79 @@ TYPE ) } >>, C, C<$obj>, C, C, C<< $obj->DOES( ROLE ) >>, C<< CLASS->DOES( ROLE ) >>, C<< $obj->can( METHOD ) >>, C<< CLASS->can( METHOD ) >>, C<< eval { VAL->can( METHOD ) } >>, C +=item WARNINGS + =item EXPORTS =back +=head2 Unicode-Normalize, Unicode::Normalize - Unicode Normalization Forms + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Normalization Forms + +C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>, +C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>, +C<$FCD_string = FCD($string)>, C<$FCC_string = FCC($string)>, +C<$normalized_string = normalize($form_name, $string)> + +=item Decomposition and Composition + +C<$decomposed_string = decompose($string [, $useCompatMapping])>, +C<$reordered_string = reorder($string)>, C<$composed_string = +compose($string)> + +=item Quick Check + +C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result = +checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result = +checkFCD($string)>, C<$result = checkFCC($string)>, C<$result = +check($form_name, $string)> + +=item Character Data + +C<$canonical_decomposition = getCanon($code_point)>, +C<$compatibility_decomposition = getCompat($code_point)>, +C<$code_point_composite = getComposite($code_point_here, +$code_point_next)>, C<$combining_class = getCombinClass($code_point)>, +C<$may_be_composed_with_prev_char = isComp2nd($code_point)>, +C<$is_exclusion = isExclusion($code_point)>, C<$is_singleton = +isSingleton($code_point)>, C<$is_non_starter_decomposition = +isNonStDecomp($code_point)>, C<$is_Full_Composition_Exclusion = +isComp_Ex($code_point)>, C<$NFD_is_NO = isNFD_NO($code_point)>, +C<$NFC_is_NO = isNFC_NO($code_point)>, C<$NFC_is_MAYBE = +isNFC_MAYBE($code_point)>, C<$NFKD_is_NO = isNFKD_NO($code_point)>, +C<$NFKC_is_NO = isNFKC_NO($code_point)>, C<$NFKC_is_MAYBE = +isNFKC_MAYBE($code_point)> + +=back + +=item EXPORT + +=item CAVEATS + +Perl's version vs. Unicode version, Correction of decomposition mapping, +Revised definition of canonical composition + +=item AUTHOR + +=item SEE ALSO + +http://www.unicode.org/reports/tr15/, +http://www.unicode.org/Public/UNIDATA/CompositionExclusions.txt, +http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt, +http://www.unicode.org/Public/UNIDATA/NormalizationCorrections.txt, +http://www.unicode.org/review/pr-29.html, http://www.unicode.org/notes/tn5/ + +=back + =head2 Unicode::Collate - Unicode Collation Algorithm =over 4 @@ -36677,8 +38250,8 @@ PID), Win32::UnregisterServer(LIBRARYNAME) =back -=head2 Win32API::File - Low-level access to Win32 system API calls for -files/dirs. +=head2 Win32API-File, Win32API::File - Low-level access to Win32 system API +calls for files/dirs. =over 4 @@ -36823,6 +38396,54 @@ C<":SEM_">, C<":PARTITION_">, C<":ALL"> =back +=head2 XS-APItest, XS::APItest - Test the perl C API + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +=item DESCRIPTION + +=over 4 + +=item EXPORT + +B, B, B, B, +B, B, B, B, B, +B, B, B, B, B, +B + +=back + +=item SEE ALSO + +=item AUTHORS + +=item COPYRIGHT AND LICENSE + +=back + +=head2 XS-Typemap, XS::Typemap - module to test the XS typemaps distributed +with perl + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=back + +=over 4 + +=item NOTES + +=item AUTHOR + +=back + =head2 XSLoader - Dynamically load C libraries into Perl code =over 4