diff options
author | Nicholas Clark <nick@ccl4.org> | 2009-04-12 10:47:47 +0100 |
---|---|---|
committer | Nicholas Clark <nick@ccl4.org> | 2009-04-12 10:47:47 +0100 |
commit | 718f7b5acf0cecec8f4d4ff2a7f3943219fe44f4 (patch) | |
tree | 931f92bd60e38f74b8e65aa4e234ff2a3474532c | |
parent | 674e4532c90e1d5fbb4dbbd7138190952561cceb (diff) | |
download | perl-718f7b5acf0cecec8f4d4ff2a7f3943219fe44f4.tar.gz |
Rebuild pod/perltoc.pod.
-rw-r--r-- | pod/perltoc.pod | 4633 |
1 files changed, 3127 insertions, 1506 deletions
diff --git a/pod/perltoc.pod b/pod/perltoc.pod index 1d57ee1149..a220f8e511 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -216,7 +216,7 @@ X<array of hashes> X<AoH> =back =item HASHES OF HASHES -X<hass of hashes> X<HoH> +X<hash of hashes> X<HoH> =over 4 @@ -431,7 +431,7 @@ X<record> X<structure> X<struct> =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<truth> X<falsehood> X<true> X<false> X<!> X<not> X<negation> X<0> =item Statement Modifiers X<statement modifier> X<modifier> X<if> X<unless> X<while> -X<until> X<foreach> X<for> +X<until> X<when> X<foreach> X<for> =item Compound Statements X<statement, compound> X<block> X<bracket, curly> X<curly bracket> X<brace> @@ -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<line -number>, 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<line number>, +IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/ +X<$/> X<$RS> X<$INPUT_RECORD_SEPARATOR>, HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $| X<$|> X<autoflush> X<flush> X<$OUTPUT_AUTOFLUSH>, IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $, X<$,> X<$OFS> X<$OUTPUT_FIELD_SEPARATOR>, @@ -3265,8 +3268,8 @@ X<indirect object syntax> X<invocation, indirect> X<indirect> =item Default UNIVERSAL methods X<UNIVERSAL> -isa(CLASS) X<isa>, DOES(ROLE), can(METHOD) X<can>, VERSION( [NEED] ) -X<VERSION> +isa(CLASS) X<isa>, DOES(ROLE) X<DOES>, can(METHOD) X<can>, VERSION( [NEED] +) X<VERSION> =item Destructors X<destructor> X<DESTROY> @@ -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_pvn>, sv_pvutf8 X<sv_pvutf8>, sv_pvutf8n X<sv_pvutf8n>, sv_taint X<sv_taint>, sv_unref X<sv_unref>, sv_usepvn X<sv_usepvn>, sv_usepvn_mg X<sv_usepvn_mg>, sv_uv X<sv_uv>, unpack_str X<unpack_str> +=item Functions in file perl.h + +PERL_SYS_INIT X<PERL_SYS_INIT>, PERL_SYS_INIT3 X<PERL_SYS_INIT3>, +PERL_SYS_TERM X<PERL_SYS_TERM> + =item Functions in file pp_ctl.c find_runcv X<find_runcv> @@ -6081,9 +6091,10 @@ X<sv_unmagic>, sv_unref_flags X<sv_unref_flags>, sv_untaint X<sv_untaint>, sv_upgrade X<sv_upgrade>, sv_usepvn_flags X<sv_usepvn_flags>, sv_utf8_decode X<sv_utf8_decode>, sv_utf8_downgrade X<sv_utf8_downgrade>, sv_utf8_encode X<sv_utf8_encode>, sv_utf8_upgrade X<sv_utf8_upgrade>, -sv_utf8_upgrade_flags X<sv_utf8_upgrade_flags>, sv_vcatpvf X<sv_vcatpvf>, -sv_vcatpvfn X<sv_vcatpvfn>, sv_vcatpvf_mg X<sv_vcatpvf_mg>, sv_vsetpvf -X<sv_vsetpvf>, sv_vsetpvfn X<sv_vsetpvfn>, sv_vsetpvf_mg X<sv_vsetpvf_mg> +sv_utf8_upgrade_flags X<sv_utf8_upgrade_flags>, sv_utf8_upgrade_nomg +X<sv_utf8_upgrade_nomg>, sv_vcatpvf X<sv_vcatpvf>, sv_vcatpvfn +X<sv_vcatpvfn>, sv_vcatpvf_mg X<sv_vcatpvf_mg>, sv_vsetpvf X<sv_vsetpvf>, +sv_vsetpvfn X<sv_vsetpvfn>, sv_vsetpvf_mg X<sv_vsetpvf_mg> =item Unicode Support @@ -6165,8 +6176,8 @@ mg_localize X<mg_localize> =item MRO Functions -mro_get_linear_isa_c3 X<mro_get_linear_isa_c3>, mro_get_linear_isa_dfs -X<mro_get_linear_isa_dfs>, mro_isa_changed_in X<mro_isa_changed_in> +mro_get_linear_isa_dfs X<mro_get_linear_isa_dfs>, mro_isa_changed_in +X<mro_isa_changed_in> =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<The Road goes ever on and on, down from the door where it began.> =item AUTHOR +=item SEE ALSO + =back =head2 perlrepository - Using the Perl source repository @@ -6517,8 +6516,32 @@ I<The Road goes ever on and on, down from the door where it began.> =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<http://perl.com/>, L<http://use.perl.org/>, L<http://www.perlmonks.org/> =item POD -E<gt> HTML conversion in the core still sucks -=item merge checkpods and podchecker - =item Parallel testing =item Make Schwern poorer @@ -6641,8 +6662,6 @@ C<cc> (in F<cc.U>), C<ld> (in F<dlsrc.U>) =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<cc> (in F<cc.U>), C<ld> (in F<dlsrc.U>) =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<overloading> pragma + =item Modules and Pragmata +=over 4 + +=item Pragmata Changes + +C<overloading> + +=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<overloading> pragma + =item Modules and Pragmata +=over 4 + +=item Pragmata Changes + +C<overloading> + +=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<Attribute::Handlers>, C<B::Lint>, C<B>, C<Thread> =back -=item Performance Enhancements - =item Installation and Configuration Improvements =over 4 @@ -7315,14 +7356,6 @@ C<Attribute::Handlers>, C<B::Lint>, C<B>, C<Thread> =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 E<lt>steve.hay@uk.radan.comE<gt> =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 E<lt>steve.hay@uk.radan.comE<gt> =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<http://www.webcom.com/haahr/dylan/linearization-oopsla96.html> + +=item The prototype Perl 6 Object Model uses C3 + +L<http://svn.openfoundry.org/pugs/perl5/Perl6-MetaModel/> + +=item Parrot now uses C3 + +L<http://aspn.activestate.com/ASPN/Mail/Message/perl6-internals/2746631>, +L<http://use.perl.org/~autrijus/journal/25768> + +=item Python 2.3 MRO related links + +L<http://www.python.org/2.3/mro.html>, +L<http://www.python.org/2.2.2/descrintro.html#mro> + +=item C3 for TinyCLOS + +L<http://www.call-with-current-continuation.org/eggs/c3.html> + +=item Class::C3 + +L<Class::C3> + +=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<threads> =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<http://www.webcom.com/haahr/dylan/linearization-oopsla96.html> - -=item The prototype Perl 6 Object Model uses C3 - -L<http://svn.openfoundry.org/pugs/perl5/Perl6-MetaModel/> - -=item Parrot now uses C3 - -L<http://aspn.activestate.com/ASPN/Mail/Message/perl6-internals/2746631>, -L<http://use.perl.org/~autrijus/journal/25768> - -=item Python 2.3 MRO related links - -L<http://www.python.org/2.3/mro.html>, -L<http://www.python.org/2.2.2/descrintro.html#mro> - -=item C3 for TinyCLOS - -L<http://www.call-with-current-continuation.org/eggs/c3.html> - -=item Class::C3 - -L<Class::C3> - -=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<x=> and other assignment versions I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>, I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string -and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special> +and numeric conversion>, I<Iteration>, I<File tests>, I<Dereferencing>, +I<Special> =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<no overloading>, C<no overloading @ops>, C<use overloading>, C<use +overloading @ops> + +=back + =head2 parent - Establish an ISA relationship with base classes at compile time @@ -13268,8 +13325,22 @@ C<dry>, C<exec>, C<extension>, C<failures>, C<fork>, C<formatter>, C<harness>, C<ignore_exit>, C<includes>, C<jobs>, C<lib>, C<merge>, C<modules>, C<parse>, C<plugins>, C<quiet>, C<really_quiet>, C<recurse>, C<rules>, C<show_count>, C<show_help>, C<show_man>, C<show_version>, -C<shuffle>, C<state>, C<taint_fail>, C<taint_warn>, C<test_args>, C<timer>, -C<verbose>, C<warnings_fail>, C<warnings_warn> +C<shuffle>, C<state>, C<state_class>, C<taint_fail>, C<taint_warn>, +C<test_args>, C<timer>, C<verbose>, C<warnings_fail>, C<warnings_warn> + +=back + +=over 4 + +=item PLUGINS + +=over 4 + +=item Sample Plugin + +=back + +=item SEE ALSO =back @@ -13297,6 +13368,8 @@ C<verbose>, C<warnings_fail>, C<warnings_warn> =item Class Methods +C<store>, C<extension> (optional), C<result_class> (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<tie> interfaces + +=back + +=item EXAMPLES + +=item DIAGNOSTICS + +C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s +attributes>, C<Declaration of %s attribute in package %s may clash with +future reserved word>, C<Can't have two ATTR specifiers on one subroutine>, +C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't +be able to apply END handler> + +=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 $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 _resolve_prereqs +=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<parent()>, C<status()> =item STATUS ACCESSORS -build_pl (), build (), test (), prepared (), distdir (), created (), -installed (), uninstalled (), _create_args (), _install_args (), _mb_object -() +C<build_pl ()>, C<build ()>, C<test ()>, C<prepared ()>, C<distdir ()>, +C<created ()>, C<installed ()>, 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 -Module::Build can not be upgraded using its own API (#13169), Module::Build -does not provide access to install history (#9793) +=back + +=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<target> set to C<prepare> =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,84 +17369,74 @@ 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 ($z, $status) = new Compress::Raw::Bzip2 $appendOutput, +$blockSize100k, $workfactor; -=item B<$status = $d-E<gt>deflate($input, $output)> +B<$appendOutput>, B<$blockSize100k>, B<$workfactor> -=item B<$status = $d-E<gt>flush($output [, $flush_type]) > +=item $status = $bz->bzdeflate($input, $output); -=item B<$status = $d-E<gt>deflateParams([OPT])> +=item $status = $bz->bzflush($output); -B<-Level>, B<-Strategy>, B<-BufSize> +=item $status = $bz->bzclose($output); -=item B<$status = $d-E<gt>deflateTune($good_length, $max_lazy, -$nice_length, $max_chain)> - -=item B<$d-E<gt>dict_adler()> - -=item B<$d-E<gt>crc32()> - -=item B<$d-E<gt>adler32()> - -=item B<$d-E<gt>msg()> +=item Example -=item B<$d-E<gt>total_in()> +=back -=item B<$d-E<gt>total_out()> +=item Uncompression -=item B<$d-E<gt>get_Strategy()> +=over 4 -=item B<$d-E<gt>get_Level()> +=item ($z, $status) = new Compress::Raw::Bunzip2 $appendOutput, +$consumeInput, $small; -=item B<$d-E<gt>get_BufSize()> +B<$appendOutput>, B<$consumeInput>, B<$small> -=item Example +=item $status = $z->bzinflate($input, $output); =back -=item Compress::Raw::Zlib::Inflate +=item Misc =over 4 -=item B< ($i, $status) = new Compress::Raw::Zlib::Inflate( [OPT] ) > +=item my $version = Compress::Raw::Bzip2::bzlibversion(); -B<-WindowBits>, B<-Bufsize>, B<-Dictionary>, B<-AppendOutput>, B<-CRC32>, -B<-ADLER32>, B<-ConsumeInput> +=back -=item B< $status = $i-E<gt>inflate($input, $output [,$eof]) > +=item Constants -=item B<$status = $i-E<gt>inflateSync($input)> +=item SEE ALSO -=item B<$i-E<gt>dict_adler()> +=item AUTHOR -=item B<$i-E<gt>crc32()> +=item MODIFICATION HISTORY -=item B<$i-E<gt>adler32()> +=item COPYRIGHT AND LICENSE -=item B<$i-E<gt>msg()> +=back -=item B<$i-E<gt>total_in()> +=head2 Compress-Raw-Bzip2::pod::FAQ, Compress::Raw::Bzip2::FAQ -- +Frequently Asked Questions about Compress::Raw::Bzip2 -=item B<$i-E<gt>total_out()> +=over 4 -=item B<$d-E<gt>get_BufSize()> +=item DESCRIPTION -=item Example +=over 4 -=back +=item Compatibility with Unix compress/uncompress. -=item CHECKSUM FUNCTIONS +=item Accessing .tar.Z files -=item ACCESSING ZIP FILES +=item Accessing Zip Files -=item CONSTANTS +=back =item SEE ALSO @@ -17274,7 +17448,7 @@ B<-ADLER32>, B<-ConsumeInput> =back -=head2 Compress::Raw::Zlib::Compress::Raw::Zlib, Compress::Raw::Zlib - +=head2 Compress-Raw-Zlib::Compress::Raw::Zlib, Compress::Raw::Zlib - Low-Level Interface to zlib compression library =over 4 @@ -17296,6 +17470,8 @@ B<-Dictionary>, B<-Bufsize>, B<-AppendOutput>, B<-CRC32>, B<-ADLER32> =item B<$status = $d-E<gt>flush($output [, $flush_type]) > +=item B<$status = $d-E<gt>deflateReset() > + =item B<$status = $d-E<gt>deflateParams([OPT])> B<-Level>, B<-Strategy>, B<-BufSize> @@ -17332,7 +17508,7 @@ $nice_length, $max_chain)> =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<-ADLER32>, B<-ConsumeInput>, B<-LimitOutput> =item B< $status = $i-E<gt>inflate($input, $output [,$eof]) > @@ -17352,12 +17528,22 @@ B<-ADLER32>, B<-ConsumeInput> =item B<$d-E<gt>get_BufSize()> -=item Example +=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 @@ -17372,8 +17558,8 @@ 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-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-E<gt>gzread($buffer [, $size]) ;>, B<$bytesread = -$gz-E<gt>gzreadline($line) ;>, B<$byteswritten = $gz-E<gt>gzwrite($buffer) -;>, B<$status = $gz-E<gt>gzflush($flush_type) ;>, B<$offset = -$gz-E<gt>gztell() ;>, B<$status = $gz-E<gt>gzseek($offset, $whence) ;>, -B<$gz-E<gt>gzclose>, B<$gz-E<gt>gzsetparams($level, $strategy>, B<$level>, -B<$strategy>, B<$gz-E<gt>gzerror>, B<$gzerrno> +=over 4 + +=item ($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-E<gt>deflate($buffer)> +=item B<$status = $d-E<gt>deflate($input, $output)> -=item B<($out, $status) = $d-E<gt>flush()> -=head2 B<($out, $status) = $d-E<gt>flush($flush_type)> +=item B<$status = $d-E<gt>flush($output [, $flush_type]) > + +=item B<$status = $d-E<gt>deflateReset() > =item B<$status = $d-E<gt>deflateParams([OPT])> -B<-Level>, B<-Strategy> +B<-Level>, B<-Strategy>, B<-BufSize> + +=item B<$status = $d-E<gt>deflateTune($good_length, $max_lazy, +$nice_length, $max_chain)> =item B<$d-E<gt>dict_adler()> +=item B<$d-E<gt>crc32()> + +=item B<$d-E<gt>adler32()> + =item B<$d-E<gt>msg()> =item B<$d-E<gt>total_in()> =item B<$d-E<gt>total_out()> +=item B<$d-E<gt>get_Strategy()> + +=item B<$d-E<gt>get_Level()> + +=item B<$d-E<gt>get_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-E<gt>inflate($buffer)> +=item B< $status = $i-E<gt>inflate($input, $output [,$eof]) > -=item B<$status = $i-E<gt>inflateSync($buffer)> +=item B<$status = $i-E<gt>inflateSync($input)> =item B<$i-E<gt>dict_adler()> +=item B<$i-E<gt>crc32()> + +=item B<$i-E<gt>adler32()> + =item B<$i-E<gt>msg()> =item B<$i-E<gt>total_in()> =item B<$i-E<gt>total_out()> -=item Example +=item B<$d-E<gt>get_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<d_fp_class>, C<d_fpathconf>, C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>, C<d_ftello>, C<d_ftime>, C<d_futimes>, C<d_Gconvert>, C<d_gdbm_ndbm_h_uses_prototypes>, -C<d_gdbmndbm_h_uses_prototypes>, C<d_getcwd>, C<d_getespwnam>, -C<d_getfsstat>, C<d_getgrent>, C<d_getgrent_r>, C<d_getgrgid_r>, -C<d_getgrnam_r>, C<d_getgrps>, C<d_gethbyaddr>, C<d_gethbyname>, -C<d_gethent>, C<d_gethname>, C<d_gethostbyaddr_r>, C<d_gethostbyname_r>, -C<d_gethostent_r>, C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, -C<d_getlogin_r>, C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, -C<d_getnbyname>, C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, -C<d_getnetent_r>, C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, -C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>, C<d_getpgrp>, C<d_getpgrp2>, -C<d_getppid>, C<d_getprior>, C<d_getprotobyname_r>, -C<d_getprotobynumber_r>, C<d_getprotoent_r>, C<d_getprotoprotos>, -C<d_getprpwnam>, C<d_getpwent>, C<d_getpwent_r>, C<d_getpwnam_r>, -C<d_getpwuid_r>, C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>, -C<d_getservbyname_r>, C<d_getservbyport_r>, C<d_getservent_r>, -C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>, C<d_gettimeod>, -C<d_gmtime64>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, -C<d_htonl>, C<d_ilogbl>, C<d_inc_version_list>, C<d_index>, C<d_inetaton>, -C<d_int64_t>, C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>, -C<d_isnanl>, C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, -C<d_libm_lib_version>, C<d_link>, C<d_localtime64>, C<d_localtime_r>, -C<d_localtime_r_needs_tzset>, C<d_locconv>, C<d_lockf>, C<d_longdbl>, -C<d_longlong>, C<d_lseekproto>, C<d_lstat>, C<d_madvise>, -C<d_malloc_good_size>, C<d_malloc_size>, C<d_mblen>, C<d_mbstowcs>, -C<d_mbtowc>, C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>, -C<d_memset>, C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>, -C<d_mkstemps>, C<d_mktime>, C<d_mktime64>, C<d_mmap>, C<d_modfl>, -C<d_modfl_pow32_bug>, C<d_modflproto>, C<d_mprotect>, C<d_msg>, -C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, -C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>, -C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_ndbm>, -C<d_ndbm_h_uses_prototypes>, C<d_nice>, C<d_nl_langinfo>, +C<d_gdbmndbm_h_uses_prototypes>, C<d_getaddrinfo>, C<d_getcwd>, +C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>, C<d_getgrent_r>, +C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>, C<d_gethbyaddr>, +C<d_gethbyname>, C<d_gethent>, C<d_gethname>, C<d_gethostbyaddr_r>, +C<d_gethostbyname_r>, C<d_gethostent_r>, C<d_gethostprotos>, +C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>, C<d_getmnt>, +C<d_getmntent>, C<d_getnameinfo>, C<d_getnbyaddr>, C<d_getnbyname>, +C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>, +C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>, +C<d_getpent>, C<d_getpgid>, C<d_getpgrp>, C<d_getpgrp2>, C<d_getppid>, +C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>, +C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>, +C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>, +C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>, +C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>, +C<d_gettimeod>, C<d_gmtime64>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, +C<d_hasmntopt>, C<d_htonl>, C<d_ilogbl>, C<d_inc_version_list>, C<d_index>, +C<d_inetaton>, C<d_inetntop>, C<d_inetpton>, C<d_int64_t>, C<d_isascii>, +C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>, C<d_killpg>, +C<d_lchown>, C<d_ldbl_dig>, C<d_libm_lib_version>, C<d_link>, +C<d_localtime64>, C<d_localtime_r>, C<d_localtime_r_needs_tzset>, +C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, +C<d_lstat>, C<d_madvise>, C<d_malloc_good_size>, C<d_malloc_size>, +C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>, +C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkdtemp>, +C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, C<d_mktime64>, +C<d_mmap>, C<d_modfl>, C<d_modfl_pow32_bug>, C<d_modflproto>, +C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>, +C<d_msg_peek>, C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, +C<d_msgrcv>, C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>, +C<d_ndbm>, C<d_ndbm_h_uses_prototypes>, C<d_nice>, C<d_nl_langinfo>, C<d_nv_preserves_uv>, C<d_nv_zero_is_allbits_zero>, C<d_off64_t>, C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>, @@ -18447,6 +18677,54 @@ B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock> =back +=head2 Data-Dumper, Data::Dumper - stringified perl data structures, +suitable for both printing and C<eval> + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Methods + +I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump I<or> +I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>), +I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>), +I<$OBJ>->Reset + +=item Functions + +Dumper(I<LIST>) + +=item Configuration Variables or Methods + +=item Exports + +Dumper + +=back + +=item EXAMPLES + +=item BUGS + +=over 4 + +=item NOTE + +=back + +=item AUTHOR + +=item VERSION + +=item SEE ALSO + +=back + =head2 Data::Dumper - stringified perl data structures, suitable for both printing and C<eval> @@ -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<hmac_sha384_base64($data, $key)>, B<hmac_sha512_base64($data, $key)> =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<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>, +C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>, +C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT> + +=back + +=item DIAGNOSTICS + +C<GLOB_NOSPACE>, C<GLOB_ABEND> + +=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<use Filter::Util::Call> + +=item B<import()> + +=item B<filter() and anonymous sub> + +B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del> + +=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<init()>, C<first()>, C<last()>, C<name()>, C<Name_hash>, C<Name_id>, +C<Name_idhash>, C<Name_id_reg>, C<Name_idhash_reg>, C<Name_fieldhash> + +=over 4 + +=item Example 1 + +=item Example 2 + +=back + +=item GUTS + +=over 4 + +=item The C<PERL_MAGIC_uvar> interface for hashes + +=item Weakrefs call uvar magic + +=item How field hashes work + +=item Internal function Hash::Util::FieldHash::_fieldhash + +=back + +=item AUTHOR + +=item COPYRIGHT AND LICENSE + +=back + +=head2 Hash-Utilib::Hash::Util, Hash::Util - A selection of general-utility +hash subroutines =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<lock_keys>, B<unlock_keys> -=item Solutions +=back -=item More Problems +=back -=item The Generic Object +B<lock_keys_plus> -=item How to use Field Hashes +B<lock_value>, B<unlock_value> -=item Garbage-Collected Hashes +B<lock_hash>, B<unlock_hash> -=back +B<lock_hash_recurse>, B<unlock_hash_recurse> -=item EXAMPLES +B<hash_unlocked> -C<init()>, C<first()>, C<last()>, C<name()>, C<Name_hash>, C<Name_id>, -C<Name_idhash>, C<Name_id_reg>, C<Name_idhash_reg>, C<Name_fieldhash> +B<legal_keys>, B<hidden_keys>, B<all_keys>, B<hash_seed> + +B<hv_store> =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<PERL_MAGIC_uvar> 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<Name_idhash>, C<Name_id_reg>, C<Name_idhash_reg>, C<Name_fieldhash> =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<lock_keys>, B<unlock_keys> - -=back - -=back - -B<lock_keys_plus> - -B<lock_value>, B<unlock_value> - -B<lock_hash>, B<unlock_hash> - -B<lock_hash_recurse>, B<unlock_hash_recurse> - -B<hash_unlocked> - -B<legal_keys>, B<hidden_keys>, B<all_keys>, B<hash_seed> - -B<hv_store> - -=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-E<gt>gzread($buffer [, $size]) ;>, B<$bytesread = +$gz-E<gt>gzreadline($line) ;>, B<$byteswritten = $gz-E<gt>gzwrite($buffer) +;>, B<$status = $gz-E<gt>gzflush($flush_type) ;>, B<$offset = +$gz-E<gt>gztell() ;>, B<$status = $gz-E<gt>gzseek($offset, $whence) ;>, +B<$gz-E<gt>gzclose>, B<$gz-E<gt>gzsetparams($level, $strategy>, B<$level>, +B<$strategy>, B<$gz-E<gt>gzerror>, B<$gzerrno> + +=over 4 + +=item 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-E<gt>deflate($buffer)> -=over 4 +=item B<($out, $status) = $d-E<gt>flush()> +=head2 B<($out, $status) = $d-E<gt>flush($flush_type)> -=item deflate $input => $output [, OPTS] +=item B<$status = $d-E<gt>deflateParams([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-E<gt>dict_adler()> -=item Optional Parameters +=item B<$d-E<gt>msg()> -C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> +=item B<$d-E<gt>total_in()> -=item Examples +=item B<$d-E<gt>total_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-E<gt>inflate($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-E<gt>inflateSync($buffer)> -=item Examples +=item B<$i-E<gt>dict_adler()> + +=item B<$i-E<gt>msg()> + +=item B<$i-E<gt>total_in()> + +=item B<$i-E<gt>total_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<Compress::Zlib> +=head2 IO-Compress::lib::IO::Uncompress::Unzip, IO::Uncompress::Unzip - +Read zip files/buffers =over 4 @@ -24401,143 +24991,146 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =item DESCRIPTION -=item CONSTRUCTOR +=item Functional Interface -new ( [ARGS] ) +=over 4 -=item OBJECT METHODS +=item unzip $input => $output [, OPTS] -open ( FILENAME, MODE ), opened, close, getc, getline, getlines, print ( -ARGS... ), read ( BUF, NBYTES, [OFFSET] ), eof, seek ( OFFSET, WHENCE ), -tell, setpos ( POS ), getpos ( POS ) +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 USING THE EXTERNAL GZIP +=item Notes -=item CLASS METHODS +=item Optional Parameters -has_Compress_Zlib, gzip_external, gzip_used, gzip_read_open, -gzip_write_open +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >> -=item DIAGNOSTICS +=item Examples -IO::Zlib::getlines: must be called in list context, -IO::Zlib::gzopen_external: mode '...' is illegal, IO::Zlib::import: '...' -is illegal, IO::Zlib::import: ':gzip_external' requires an argument, -IO::Zlib::import: 'gzip_read_open' requires an argument, IO::Zlib::import: -'gzip_read' '...' is illegal, IO::Zlib::import: 'gzip_write_open' requires -an argument, IO::Zlib::import: 'gzip_write_open' '...' is illegal, -IO::Zlib::import: no Compress::Zlib and no external gzip, IO::Zlib::open: -needs a filename, IO::Zlib::READ: NBYTES must be specified, -IO::Zlib::WRITE: too long LENGTH +=back -=item SEE ALSO +=item OO Interface -=item HISTORY +=over 4 -=item COPYRIGHT +=item Constructor + +A filename, A filehandle, A scalar reference + +=item Constructor Options + +C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string +>>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength => +$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> + +=item Examples =back -=head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory -handles +=item Methods =over 4 -=item SYNOPSIS +=item read -=item DESCRIPTION +=item read -new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), -rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] +=item getline -=item SEE ALSO +=item getc -=item AUTHOR +=item ungetc -=item COPYRIGHT +=item inflateSync -=back +=item getHeaderInfo -=head2 IO::lib::IO::File, IO::File - supply object methods for filehandles +=item tell -=over 4 +=item eof -=item SYNOPSIS +=item seek -=item DESCRIPTION +=item binmode -=item CONSTRUCTOR +=item opened -new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile +=item autoflush -=item METHODS +=item input_line_number -open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( -[LAYER] ) +=item fileno -=item NOTE +=item close -=item SEE ALSO +=item nextStream -=item HISTORY +=item trailingData =back -=head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O -handles +=item Importing -=over 4 +:all -=item SYNOPSIS +=item EXAMPLES -=item DESCRIPTION +=over 4 -=item CONSTRUCTOR +=item Working with Net::FTP -new (), new_from_fd ( FD, MODE ) +=back -=item METHODS +=item SEE ALSO -$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 AUTHOR -=item NOTE +=item MODIFICATION HISTORY -=item SEE ALSO +=item COPYRIGHT AND LICENSE -=item BUGS +=back -=item HISTORY +=head2 IO-Compress::pod::FAQ, IO::Compress::FAQ -- Frequently Asked +Questions about IO::Compress -=back +=over 4 -=head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes +=item DESCRIPTION =over 4 -=item SYNOPSIS +=item Compatibility with Unix compress/uncompress. -=item DESCRIPTION +=item Accessing .tar.Z files -=item CONSTRUCTOR +=item Accessing Zip Files -new ( [READER, WRITER] ) +=item Compressed files and Net::FTP -=item METHODS +=item How do I recompress using a different compression? -reader ([ARGS]), writer ([ARGS]), handles () +=item Apache::GZip Revisited + +=item Using C<InputLength> to uncompress data embedded in a larger +file/buffer. + +=back =item SEE ALSO =item AUTHOR -=item COPYRIGHT +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE =back -=head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call +=head2 IO::Compress::Base - Base Class for IO::Compress modules =over 4 @@ -24545,21 +25138,17 @@ reader ([ARGS]), writer ([ARGS]), handles () =item DESCRIPTION -=item METHODS - -mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( -IO ), handles( [ EVENT_MASK ] ) - =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::Bzip2 - Write bzip2 files/buffers =over 4 @@ -24567,88 +25156,91 @@ I/O objects =item DESCRIPTION -$io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET), -WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ), -$io->tell +=item Functional Interface -=item SEE ALSO +=over 4 -=item HISTORY +=item bzip2 $input => $output [, OPTS] -=back +A filename, A filehandle, A scalar reference, An array reference, An Input +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob -=head2 IO::lib::IO::Select, IO::Select - OO interface to the select system -call +=item Notes -=over 4 +=item Optional Parameters -=item SYNOPSIS +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> -=item DESCRIPTION +=item Examples -=item CONSTRUCTOR +=back -new ( [ HANDLES ] ) +=item OO Interface -=item METHODS +=over 4 -add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( -[ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), -count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) +=item Constructor -=item EXAMPLE +A filename, A filehandle, A scalar reference -=item AUTHOR +=item Constructor Options -=item COPYRIGHT +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 Examples =back -=head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket -communications +=item Methods =over 4 -=item SYNOPSIS +=item print -=item DESCRIPTION +=item printf -=item CONSTRUCTOR +=item syswrite -new ( [ARGS] ) +=item write -=item METHODS +=item flush -accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, -protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) +=item tell -=item SEE ALSO +=item eof -=item AUTHOR +=item seek -=item COPYRIGHT +=item binmode -=back +=item opened -=head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for -AF_INET domain sockets +=item autoflush -=over 4 +=item input_line_number -=item SYNOPSIS +=item fileno -=item DESCRIPTION +=item close -=item CONSTRUCTOR +=item newStream([OPTS]) -new ( [ARGS] ) +=back + +=item Importing + +:all + +=item EXAMPLES =over 4 -=item METHODS +=item Apache::GZip Revisited -sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost -() +=item Working with Net::FTP =back @@ -24656,12 +25248,13 @@ sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost =item AUTHOR -=item COPYRIGHT +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE =back -=head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for -AF_UNIX domain sockets +=head2 IO::Compress::Deflate - Write RFC 1950 files/buffers =over 4 @@ -24669,75 +25262,94 @@ AF_UNIX domain sockets =item DESCRIPTION -=item CONSTRUCTOR +=item Functional Interface -new ( [ARGS] ) +=over 4 -=item METHODS +=item deflate $input => $output [, OPTS] -hostpath(), peerpath() +A filename, A filehandle, A scalar reference, An array reference, An Input +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob -=item SEE ALSO +=item Notes -=item AUTHOR +=item Optional Parameters -=item COPYRIGHT +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> + +=item Examples =back -=head2 IO_Compress_Base::lib::File::GlobMapper, File::GlobMapper - Extend -File Glob to Allow Input and Output Files +=item OO Interface =over 4 -=item SYNOPSIS +=item Constructor -=item DESCRIPTION +A filename, A filehandle, A scalar reference + +=item Constructor Options + +C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A +Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> + +=item Examples + +=back + +=item Methods =over 4 -=item Behind The Scenes +=item print -=item Limitations +=item printf -=item Input File Glob +=item syswrite -B<~>, B<~user>, B<.>, B<*>, B<?>, B<\>, B<[]>, B<{,}>, B<()> +=item write -=item Output File Glob +=item flush -"*", #1 +=item tell -=item Returned Data +=item eof -=back +=item seek -=item EXAMPLES +=item binmode -=over 4 +=item opened -=item A Rename script +=item autoflush -=item A few example globmaps +=item input_line_number -=back +=item fileno -=item SEE ALSO +=item close -=item AUTHOR +=item newStream([OPTS]) -=item COPYRIGHT AND LICENSE +=item deflateParams =back -=head2 IO_Compress_Base::lib::IO::Compress::Base, IO::Compress::Base - Base -Class for IO::Compress modules +=item Importing + +:all, :constants, :flush, :level, :strategy + +=item EXAMPLES =over 4 -=item SYNOPSIS +=item Apache::GZip Revisited -=item DESCRIPTION +=item Working with Net::FTP + +=back =item SEE ALSO @@ -24749,9 +25361,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::Gzip - Write RFC 1952 files/buffers =over 4 @@ -24759,13 +25369,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 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 @@ -24775,8 +25383,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,9 +25399,11 @@ 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<< 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 @@ -24805,17 +25414,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 +25442,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<InputLength> to uncompress data embedded in a larger -file/buffer. +=item Working with Net::FTP =back @@ -24910,8 +25472,7 @@ file/buffer. =back -=head2 IO_Compress_Zlib::IO::Compress::Deflate, IO::Compress::Deflate - -Write RFC 1950 files/buffers +=head2 IO::Compress::RawDeflate - Write RFC 1951 files/buffers =over 4 @@ -24923,7 +25484,7 @@ Write RFC 1950 files/buffers =over 4 -=item deflate $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 @@ -25018,8 +25579,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::Zip - Write zip files/buffers =over 4 @@ -25031,7 +25591,7 @@ Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> =over 4 -=item gzip $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 @@ -25058,11 +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<< 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<< 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 @@ -25108,7 +25671,7 @@ C<< ExtraField => $data >>, C<< ExtraFlags => $value >>, C<< Strict => 0|1 =item Importing -:all, :constants, :flush, :level, :strategy +:all, :constants, :flush, :level, :strategy, :zip_method =item EXAMPLES @@ -25130,8 +25693,169 @@ 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::Dir - supply object methods for directory handles + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), +rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 IO::File - supply object methods for filehandles + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CONSTRUCTOR + +new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile + +=item METHODS + +open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( +[LAYER] ) + +=item NOTE + +=item SEE ALSO + +=item HISTORY + +=back + +=head2 IO::Handle - supply object methods for I/O handles + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CONSTRUCTOR + +new (), new_from_fd ( FD, MODE ) + +=item METHODS + +$io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines, +$io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error, +$io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ), +$io->blocking ( [ BOOL ] ), $io->untaint + +=item NOTE + +=item SEE ALSO + +=item BUGS + +=item HISTORY + +=back + +=head2 IO::Pipe - supply object methods for pipes + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CONSTRUCTOR + +new ( [READER, WRITER] ) + +=item METHODS + +reader ([ARGS]), writer ([ARGS]), handles () + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 IO::Poll - Object interface to system poll call + +=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::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::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::Socket - Object interface to socket communications =over 4 @@ -25139,11 +25863,92 @@ C<< ExtraField => $data >>, C<< ExtraFlags => $value >>, C<< Strict => 0|1 =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::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::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 + +=item SYNOPSIS + +=item DESCRIPTION + +RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip + =item Functional Interface =over 4 -=item rawdeflate $input => $output [, OPTS] +=item anyinflate $input => $output [, OPTS] A filename, A filehandle, A scalar reference, An array reference, An Input FileGlob string, A filename, A filehandle, A scalar reference, An Array @@ -25153,7 +25958,8 @@ Reference, An Output FileGlob =item Optional Parameters -C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >> =item Examples @@ -25169,8 +25975,12 @@ A filename, A filehandle, A scalar reference =item Constructor Options -C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A -Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> +C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string +>>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength => +$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< RawInflate => 0|1 +>>, C<< ParseExtra => 0|1 >> If the gzip FEXTRA header field is present and +this option is set, it will force the module to check that it conforms to +the sub-field structure as defined in RFC 1952 =item Examples @@ -25180,15 +25990,19 @@ Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> =over 4 -=item print +=item read -=item printf +=item read -=item syswrite +=item getline -=item write +=item getc -=item flush +=item ungetc + +=item inflateSync + +=item getHeaderInfo =item tell @@ -25208,22 +26022,20 @@ Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> =item close -=item newStream([OPTS]) +=item nextStream -=item deflateParams +=item trailingData =back =item Importing -:all, :constants, :flush, :level, :strategy +:all =item EXAMPLES =over 4 -=item Apache::GZip Revisited - =item Working with Net::FTP =back @@ -25238,8 +26050,8 @@ 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::Uncompress::AnyUncompress - Uncompress gzip, zip, bzip2 or lzop +file/buffer =over 4 @@ -25247,11 +26059,13 @@ files/buffers =item DESCRIPTION +RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip, bzip2, lzop, lzf + =item Functional Interface =over 4 -=item zip $input => $output [, OPTS] +=item anyuncompress $input => $output [, OPTS] A filename, A filehandle, A scalar reference, An array reference, An Input FileGlob string, A filename, A filehandle, A scalar reference, An Array @@ -25261,7 +26075,8 @@ Reference, An Output FileGlob =item Optional Parameters -C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >> =item Examples @@ -25277,15 +26092,10 @@ A filename, A filehandle, A scalar reference =item Constructor Options -C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A -Filehandle, C<< Name => $string >>, C<< Time => $number >>, C<< 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 >> +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 @@ -25295,15 +26105,17 @@ number >>, C<< WorkFactor => number >>, -Level, -Strategy, C<< Strict => =over 4 -=item print +=item read -=item printf +=item read -=item syswrite +=item getline -=item write +=item getc -=item flush +=item ungetc + +=item getHeaderInfo =item tell @@ -25323,26 +26135,36 @@ number >>, C<< WorkFactor => number >>, -Level, -Strategy, C<< Strict => =item close -=item newStream([OPTS]) +=item nextStream -=item deflateParams +=item trailingData =back =item Importing -:all, :constants, :flush, :level, :strategy, :zip_method +:all =item EXAMPLES -=over 4 +=item SEE ALSO -=item Apache::GZip Revisited +=item AUTHOR -=item Working with Net::FTP +=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 @@ -25353,8 +26175,7 @@ number >>, C<< WorkFactor => number >>, -Level, -Strategy, C<< Strict => =back -=head2 IO_Compress_Zlib::IO::Uncompress::AnyInflate, -IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip) file/buffer +=head2 IO::Uncompress::Bunzip2 - Read bzip2 files/buffers =over 4 @@ -25362,13 +26183,11 @@ IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip) file/buffer =item DESCRIPTION -RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip - =item Functional Interface =over 4 -=item anyinflate $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 @@ -25397,10 +26216,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<< RawInflate => 0|1 ->>, C<< ParseExtra => 0|1 >> If the gzip FEXTRA header field is present and -this option is set, it will force the module to check that it conforms to -the sub-field structure as defined in RFC 1952 +$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< Small => 0|1 >> =item Examples @@ -25420,8 +26236,6 @@ the sub-field structure as defined in RFC 1952 =item ungetc -=item inflateSync - =item getHeaderInfo =item tell @@ -25470,8 +26284,7 @@ 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::Gunzip - Read RFC 1952 files/buffers =over 4 @@ -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,43 +26733,173 @@ $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<Compress::Zlib> + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CONSTRUCTOR + +new ( [ARGS] ) + +=item OBJECT METHODS + +open ( FILENAME, MODE ), opened, close, getc, getline, getlines, print ( +ARGS... ), read ( BUF, NBYTES, [OFFSET] ), eof, seek ( OFFSET, WHENCE ), +tell, setpos ( POS ), getpos ( POS ) + +=item USING THE EXTERNAL GZIP + +=item CLASS METHODS + +has_Compress_Zlib, gzip_external, gzip_used, gzip_read_open, +gzip_write_open + +=item DIAGNOSTICS + +IO::Zlib::getlines: must be called in list context, +IO::Zlib::gzopen_external: mode '...' is illegal, IO::Zlib::import: '...' +is illegal, IO::Zlib::import: ':gzip_external' requires an argument, +IO::Zlib::import: 'gzip_read_open' requires an argument, IO::Zlib::import: +'gzip_read' '...' is illegal, IO::Zlib::import: 'gzip_write_open' requires +an argument, IO::Zlib::import: 'gzip_write_open' '...' is illegal, +IO::Zlib::import: no Compress::Zlib and no external gzip, IO::Zlib::open: +needs a filename, IO::Zlib::READ: NBYTES must be specified, +IO::Zlib::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 SYNOPSIS + =item DESCRIPTION +new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), +rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 IO::lib::IO::File, IO::File - supply object methods for filehandles + =over 4 -=item Compatibility with Unix compress/uncompress. +=item SYNOPSIS -=item Accessing .tar.Z files +=item DESCRIPTION -=item Accessing Zip Files +=item CONSTRUCTOR -=item Compressed files and Net::FTP +new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile -=item How do I recompress using a different compression? +=item METHODS -=item Apache::GZip Revisited +open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( +[LAYER] ) -=item Using C<InputLength> to uncompress data embedded in a larger -file/buffer. +=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 IPC::Msg - SysV Msg IPC object class +=head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for +I/O objects =over 4 @@ -25969,21 +26907,71 @@ file/buffer. =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 -new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set -( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, -FLAGS ] ), stat +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 AUTHORS +=item AUTHOR =item COPYRIGHT =back -=head2 IPC::Open2, open2 - open a process for both reading and writing +=head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for +AF_INET domain sockets =over 4 @@ -25991,14 +26979,29 @@ FLAGS ] ), stat =item DESCRIPTION -=item WARNING +=item CONSTRUCTOR + +new ( [ARGS] ) + +=over 4 + +=item METHODS + +sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost +() + +=back =item SEE ALSO +=item AUTHOR + +=item COPYRIGHT + =back -=head2 IPC::Open3, open3 - open a process for reading, writing, and error -handling +=head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for +AF_UNIX domain sockets =over 4 @@ -26006,15 +27009,46 @@ handling =item DESCRIPTION -=item See Also +=item CONSTRUCTOR -L<IPC::Open2>, L<IPC::Run> +new ( [ARGS] ) -=item WARNING +=item METHODS + +hostpath(), peerpath() + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT =back -=head2 IPC::Semaphore - SysV Semaphore IPC object class +=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 @@ -26037,7 +27071,8 @@ set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N =back -=head2 IPC::SharedMem - SysV Shared Memory IPC object class +=head2 IPC-SysV::lib::IPC::SharedMem, IPC::SharedMem - SysV Shared Memory +IPC object class =over 4 @@ -26058,7 +27093,8 @@ SIZE ), remove, is_removed, stat, attach ( [FLAG] ), detach, addr =back -=head2 IPC::SysV - System V IPC constants and system calls +=head2 IPC-SysV::lib::IPC::SysV, IPC::SysV - System V IPC constants and +system calls =over 4 @@ -26077,7 +27113,7 @@ memread( ADDR, VAR, POS, SIZE ), memwrite( ADDR, STRING, POS, SIZE ) =back -=head2 IPC::SysV::lib::IPC::Msg, IPC::Msg - SysV Msg IPC object class +=head2 IPC::Msg - SysV Msg IPC object class =over 4 @@ -26099,8 +27135,38 @@ FLAGS ] ), stat =back -=head2 IPC::SysV::lib::IPC::Semaphore, IPC::Semaphore - SysV Semaphore IPC -object class +=head2 IPC::Open2, open2 - open a process for both reading and writing + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item WARNING + +=item SEE ALSO + +=back + +=head2 IPC::Open3, open3 - open a process for reading, writing, and error +handling + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item See Also + +L<IPC::Open2>, L<IPC::Run> + +=item WARNING + +=back + +=head2 IPC::Semaphore - SysV Semaphore IPC object class =over 4 @@ -26123,8 +27189,7 @@ set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N =back -=head2 IPC::SysV::lib::IPC::SharedMem, IPC::SharedMem - SysV Shared Memory -IPC object class +=head2 IPC::SharedMem - SysV Shared Memory IPC object class =over 4 @@ -26145,8 +27210,7 @@ SIZE ), remove, is_removed, stat, attach ( [FLAG] ), detach, addr =back -=head2 IPC::SysV::lib::IPC::SysV, IPC::SysV - System V IPC constants and -system calls +=head2 IPC::SysV - System V IPC constants and system calls =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 <package name> + +=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<Module::Build::Cookbook>) 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<default>, C<check>, 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 <package name> - -=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<code-ref>|I<method-name> =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<TAP::Parser> +and L<TAP::Harness> + +=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<TAP::Parser> and L<TAP::Harness> +=back + +=head2 TAP::Formatter::Base, TAP::Formatter::Console - Harness output +delegate for default console output =over 4 @@ -32259,9 +33472,13 @@ L<TAP::Parser> and L<TAP::Harness> =over 4 +=item DESCRIPTION + =item SYNOPSIS -=item DESCRIPTION +=back + +=over 4 =item METHODS @@ -32269,6 +33486,10 @@ L<TAP::Parser> and L<TAP::Harness> =item Class Methods +C<verbosity>, C<verbose>, C<timer>, C<failures>, C<quiet>, C<really_quiet>, +C<silent>, C<errors>, C<directives>, C<stdout>, C<color>, C<jobs>, +C<show_count> + =back =back @@ -32312,19 +33533,9 @@ console output =item SYNOPSIS -=back - =over 4 -=item METHODS - -=over 4 - -=item Class Methods - -C<verbosity>, C<verbose>, C<timer>, C<failures>, C<quiet>, C<really_quiet>, -C<silent>, C<errors>, C<directives>, C<stdout>, C<color>, C<jobs>, -C<show_count> +=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,251 +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<prove> +command. =over 4 -=item Construction - -B<new> - -=back +=item VERSION =back -B<create> - -B<reset> - =over 4 -=item Setting up tests +=item DESCRIPTION -B<plan> +=item SYNOPSIS =back -B<expected_tests> - -B<no_plan> - -B<has_plan> - -B<skip_all> - -B<exported_to> - =over 4 -=item Running tests - -B<ok> - -=back - -B<is_eq>, B<is_num> - -B<isnt_eq>, B<isnt_num> - -B<like>, B<unlike> - -B<cmp_ok> +=item METHODS =over 4 -=item Other Testing Methods - -B<BAIL_OUT> +=item Class Methods =back -B<skip> - -B<todo_skip> - -B<skip_rest> - -=over 4 - -=item Test building utility methods - -B<maybe_regex> - =back -B<_try> - -B<is_fh> - =over 4 -=item Test style +=item Attributes -B<level> +C<archive>, C<argv>, C<backwards>, C<blib>, C<color>, C<directives>, +C<dry>, C<exec>, C<extension>, C<failures>, C<fork>, C<formatter>, +C<harness>, C<ignore_exit>, C<includes>, C<jobs>, C<lib>, C<merge>, +C<modules>, C<parse>, C<plugins>, C<quiet>, C<really_quiet>, C<recurse>, +C<rules>, C<show_count>, C<show_help>, C<show_man>, C<show_version>, +C<shuffle>, C<state>, C<state_class>, C<taint_fail>, C<taint_warn>, +C<test_args>, C<timer>, C<verbose>, C<warnings_fail>, C<warnings_warn> =back -B<use_numbers> +=over 4 -B<no_diag>, B<no_ending>, B<no_header> +=item PLUGINS =over 4 -=item Output - -B<diag> +=item Sample Plugin =back -B<note> - -B<explain> - -B<_print> - -B<output>, B<failure_output>, B<todo_output> +=item SEE ALSO -reset_outputs +=back -carp, croak +=head2 Test-Harness::lib::App::Prove::State, App::Prove::State - State +storage for the C<prove> command. =over 4 -=item Test Status and Info - -B<current_test> +=item VERSION =back -B<summary> - -B<details> - -B<todo> - -B<find_TODO> - -B<in_todo> - -B<todo_start> - -C<todo_end> - -B<caller> - -B<_sanity_check> - -B<_whoa> - -B<_my_exit> - =over 4 -=item EXIT CODES - -=item THREADS - -=item EXAMPLES - -=item SEE ALSO - -=item AUTHORS +=item DESCRIPTION -=item COPYRIGHT +=item SYNOPSIS =back -=head2 Test::Builder::Module - Base class for test modules - =over 4 -=item SYNOPSIS - -=item DESCRIPTION +=item METHODS =over 4 -=item Importing +=item Class Methods -=back +C<store>, C<extension> (optional), C<result_class> (optional) =back -=over 4 - -=item Builder - =back -=head2 Test::Builder::Tester - test testsuites that have been built with -Test::Builder - =over 4 -=item SYNOPSIS - -=item DESCRIPTION +=item C<result_class> =back =over 4 -=item Functions - -test_out, test_err +=item C<extension> =back -test_fail - -test_diag - -test_test, title (synonym 'name', 'label'), skip_out, skip_err - -line_num - -color - =over 4 -=item BUGS - -=item AUTHOR - -=item NOTES - -=item SEE ALSO +=item C<results> =back -=head2 Test::Builder::Tester::Color - turn on colour in -Test::Builder::Tester - =over 4 -=item SYNOPSIS - -=item DESCRIPTION +=item C<commit> =back =over 4 -=item AUTHOR - -=item BUGS +=item Instance Methods -=item SEE ALSO +C<last>, C<failed>, C<passed>, C<all>, C<hot>, C<todo>, C<slow>, C<fast>, +C<new>, C<old>, C<save> =back -=head2 Test::Harness - Run Perl standard test scripts with statistics +=head2 Test-Harness::lib::App::Prove::State::Result, +App::Prove::State::Result - Individual test suite results. =over 4 @@ -33981,15 +35145,19 @@ Test::Builder::Tester =over 4 +=item DESCRIPTION + =item SYNOPSIS -=item DESCRIPTION +=back -=item FUNCTIONS +=over 4 + +=item METHODS =over 4 -=item runtests( @test_files ) +=item Class Methods =back @@ -33997,37 +35165,18 @@ Test::Builder::Tester =over 4 -=item execute_tests( tests => \@test_files, out => \*FH ) +=item C<state_version> =back =over 4 -=item EXPORT - -=item ENVIRONMENT VARIABLES THAT TAP::HARNESS::COMPATIBLE SETS - -C<HARNESS_ACTIVE>, C<HARNESS_VERSION> - -=item ENVIRONMENT VARIABLES THAT AFFECT TEST::HARNESS - -C<HARNESS_TIMER>, C<HARNESS_VERBOSE>, C<HARNESS_OPTIONS>, C<< j<n> >>, C<< -f >> - -=item Taint Mode - -=item SEE ALSO - -=item BUGS - -=item AUTHORS - -=item LICENCE AND COPYRIGHT +=item C<test_class> =back -=head2 Test::Harness::lib::App::Prove, App::Prove - Implements the C<prove> -command. +=head2 Test-Harness::lib::App::Prove::State::Result::Test, +App::Prove::State::Result::Test - Individual test results. =over 4 @@ -34057,20 +35206,13 @@ command. =over 4 -=item Attributes - -C<archive>, C<argv>, C<backwards>, C<blib>, C<color>, C<directives>, -C<dry>, C<exec>, C<extension>, C<failures>, C<fork>, C<formatter>, -C<harness>, C<ignore_exit>, C<includes>, C<jobs>, C<lib>, C<merge>, -C<modules>, C<parse>, C<plugins>, C<quiet>, C<really_quiet>, C<recurse>, -C<rules>, C<show_count>, C<show_help>, C<show_man>, C<show_version>, -C<shuffle>, C<state>, C<taint_fail>, C<taint_warn>, C<test_args>, C<timer>, -C<verbose>, C<warnings_fail>, C<warnings_warn> +=item Instance Methods =back -=head2 Test::Harness::lib::App::Prove::State, App::Prove::State - State -storage for the C<prove> command. +=head2 Test-Harness::lib::TAP::Base, TAP::Base - Base class that provides +common functionality to L<TAP::Parser> +and L<TAP::Harness> =over 4 @@ -34080,13 +35222,9 @@ storage for the C<prove> command. =over 4 -=item DESCRIPTION - =item SYNOPSIS -=back - -=over 4 +=item DESCRIPTION =item METHODS @@ -34098,41 +35236,41 @@ storage for the C<prove> command. =back -=over 4 - -=item C<result_class> - -=back +=head2 Test-Harness::lib::TAP::Formatter::Base, TAP::Formatter::Console - +Harness output delegate for default console output =over 4 -=item C<extension> +=item VERSION =back =over 4 -=item C<results> +=item DESCRIPTION + +=item SYNOPSIS =back =over 4 -=item C<commit> - -=back +=item METHODS =over 4 -=item Instance Methods +=item Class Methods -C<last>, C<failed>, C<passed>, C<all>, C<hot>, C<todo>, C<slow>, C<fast>, -C<new>, C<old>, C<save> +C<verbosity>, C<verbose>, C<timer>, C<failures>, C<quiet>, C<really_quiet>, +C<silent>, C<errors>, C<directives>, C<stdout>, C<color>, C<jobs>, +C<show_count> =back -=head2 Test::Harness::lib::App::Prove::State::Result, -App::Prove::State::Result - Individual test suite results. +=back + +=head2 Test-Harness::lib::TAP::Formatter::Color, TAP::Formatter::Color - +Run Perl test scripts with color =over 4 @@ -34146,10 +35284,6 @@ App::Prove::State::Result - Individual test suite results. =item SYNOPSIS -=back - -=over 4 - =item METHODS =over 4 @@ -34160,20 +35294,8 @@ App::Prove::State::Result - Individual test suite results. =back -=over 4 - -=item C<state_version> - -=back - -=over 4 - -=item C<test_class> - -=back - -=head2 Test::Harness::lib::App::Prove::State::Result::Test, -App::Prove::State::Result::Test - Individual test results. +=head2 Test-Harness::lib::TAP::Formatter::Console, TAP::Formatter::Console +- Harness output delegate for default console output =over 4 @@ -34187,28 +35309,17 @@ App::Prove::State::Result::Test - Individual test results. =item SYNOPSIS -=back - -=over 4 - -=item METHODS - =over 4 -=item Class Methods +=item C<< open_test >> =back =back -=over 4 - -=item Instance Methods - -=back - -=head2 Test::Harness::lib::TAP::Base, TAP::Base - Base class that provides -common functionality to L<TAP::Parser> and L<TAP::Harness> +=head2 Test-Harness::lib::TAP::Formatter::Console::ParallelSession, +TAP::Formatter::Console::ParallelSession - Harness output delegate for +parallel console output =over 4 @@ -34218,9 +35329,13 @@ common functionality to L<TAP::Parser> and L<TAP::Harness> =over 4 +=item DESCRIPTION + =item SYNOPSIS -=item DESCRIPTION +=back + +=over 4 =item METHODS @@ -34232,8 +35347,9 @@ common functionality to L<TAP::Parser> and L<TAP::Harness> =back -=head2 Test::Harness::lib::TAP::Formatter::Color, TAP::Formatter::Color - -Run Perl test scripts with color +=head2 Test-Harness::lib::TAP::Formatter::Console::Session, +TAP::Formatter::Console::Session - Harness output delegate for default +console output =over 4 @@ -34245,20 +35361,22 @@ Run Perl test scripts with color =item DESCRIPTION -=item SYNOPSIS - -=item METHODS +=back =over 4 -=item Class Methods +=item C<< clear_for_close >> -=back +=item C<< close_test >> + +=item C<< header >> + +=item C<< result >> =back -=head2 Test::Harness::lib::TAP::Formatter::Console, TAP::Formatter::Console -- Harness output delegate for default console output +=head2 Test-Harness::lib::TAP::Formatter::File, TAP::Formatter::File - +Harness output delegate for file output =over 4 @@ -34272,27 +35390,16 @@ Run Perl test scripts with color =item SYNOPSIS -=back - =over 4 -=item METHODS - -=over 4 - -=item Class Methods - -C<verbosity>, C<verbose>, C<timer>, C<failures>, C<quiet>, C<really_quiet>, -C<silent>, C<errors>, C<directives>, C<stdout>, C<color>, C<jobs>, -C<show_count> +=item C<< open_test >> =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::File::Session, +TAP::Formatter::File::Session - Harness output delegate for file output =over 4 @@ -34304,8 +35411,6 @@ parallel console output =item DESCRIPTION -=item SYNOPSIS - =back =over 4 @@ -34314,27 +35419,24 @@ parallel console output =over 4 -=item Class Methods +=item result =back =back -=head2 Test::Harness::lib::TAP::Formatter::Console::Session, -TAP::Formatter::Console::Session - Harness output delegate for default -console output - =over 4 -=item VERSION +=item close_test =back -=over 4 +=head2 Test-Harness::lib::TAP::Formatter::Session, TAP::Formatter::Session +- Abstract base class for harness output delegate -=item DESCRIPTION +=over 4 -=item SYNOPSIS +=item VERSION =back @@ -34352,7 +35454,7 @@ C<formatter>, C<parser>, C<name>, C<show_count> =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<start>, C<tests> =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<TAP::*> modules =over 4 @@ -34449,7 +35551,7 @@ provides common functionality to all C<TAP::*> modules =back -=head2 Test::Harness::lib::TAParser, TAP::Parser - Parse +=head2 Test-Harness::lib::TAParser, TAP::Parser - Parse L<TAP|Test::Harness::TAP> 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<is_version>, C<is_unknown>, C<is_yaml> =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<as_string> =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<as_string> =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<as_string>, C<raw> =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<as_string>, C<raw> =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 @@ -35086,7 +36189,7 @@ C<as_string>, C<raw> =back -=head2 Test::Harness::lib::TAParser::Result::Version, +=head2 Test-Harness::lib::TAParser::Result::Version, TAP::Parser::Result::Version - TAP syntax version token. =over 4 @@ -35111,8 +36214,8 @@ C<as_string>, C<raw> =back -=head2 Test::Harness::lib::TAParser::Result::YAML, -TAP::Parser::Result::YAML - YAML result token. +=head2 Test-Harness::lib::TAParser::Result::YAML, TAP::Parser::Result::YAML +- YAML result token. =over 4 @@ -35136,7 +36239,7 @@ C<as_string>, C<raw> =back -=head2 Test::Harness::lib::TAParser::ResultFactory, +=head2 Test-Harness::lib::TAParser::ResultFactory, TAP::Parser::ResultFactory - Factory for creating TAP::Parser output objects @@ -35172,7 +36275,7 @@ objects =back -=head2 Test::Harness::lib::TAParser::Scheduler, TAP::Parser::Scheduler - +=head2 Test-Harness::lib::TAParser::Scheduler, TAP::Parser::Scheduler - Schedule tests during parallel testing =over 4 @@ -35197,7 +36300,7 @@ Schedule tests during parallel testing =back -=head2 Test::Harness::lib::TAParser::Scheduler::Job, +=head2 Test-Harness::lib::TAParser::Scheduler::Job, TAP::Parser::Scheduler::Job - A single testing job. =over 4 @@ -35222,7 +36325,7 @@ TAP::Parser::Scheduler::Job - A single testing job. =back -=head2 Test::Harness::lib::TAParser::Scheduler::Spinner, +=head2 Test-Harness::lib::TAParser::Scheduler::Spinner, TAP::Parser::Scheduler::Spinner - A no-op job. =over 4 @@ -35247,7 +36350,7 @@ TAP::Parser::Scheduler::Spinner - A no-op job. =back -=head2 Test::Harness::lib::TAParser::Source, TAP::Parser::Source - Stream +=head2 Test-Harness::lib::TAParser::Source, TAP::Parser::Source - Stream output from some source =over 4 @@ -35292,8 +36395,8 @@ output from some source =back -=head2 Test::Harness::lib::TAParser::Source::Perl, -TAP::Parser::Source::Perl - Stream Perl output +=head2 Test-Harness::lib::TAParser::Source::Perl, TAP::Parser::Source::Perl +- Stream Perl output =over 4 @@ -35333,7 +36436,7 @@ TAP::Parser::Source::Perl - Stream Perl output =back -=head2 Test::Harness::lib::TAParser::Utils, TAP::Parser::Utils - Internal +=head2 Test-Harness::lib::TAParser::Utils, TAP::Parser::Utils - Internal TAP::Parser utilities =over 4 @@ -35356,7 +36459,7 @@ TAP::Parser utilities =back -=head2 Test::Harness::lib::TAParser::YAMLish::Reader, +=head2 Test-Harness::lib::TAParser::YAMLish::Reader, TAP::Parser::YAMLish::Reader - Read YAMLish data from iterator =over 4 @@ -35385,7 +36488,7 @@ TAP::Parser::YAMLish::Reader - Read YAMLish data from iterator =back -=head2 Test::Harness::lib::TAParser::YAMLish::Writer, +=head2 Test-Harness::lib::TAParser::YAMLish::Writer, TAP::Parser::YAMLish::Writer - Write YAMLish data =over 4 @@ -35417,7 +36520,7 @@ reference to an array into which YAML will be pushed, a code reference =back -=head2 Test::Harness::lib::Test::Harness, Test::Harness - Run Perl standard +=head2 Test-Harness::lib::Test::Harness, Test::Harness - Run Perl standard test scripts with statistics =over 4 @@ -35473,6 +36576,305 @@ f >> =back +=head2 Test::Builder - Backend for building test libraries + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Construction + +B<new> + +=back + +=back + +B<create> + +B<reset> + +=over 4 + +=item Setting up tests + +B<plan> + +=back + +B<expected_tests> + +B<no_plan> + +B<has_plan> + +B<skip_all> + +B<exported_to> + +=over 4 + +=item Running tests + +B<ok> + +=back + +B<is_eq>, B<is_num> + +B<isnt_eq>, B<isnt_num> + +B<like>, B<unlike> + +B<cmp_ok> + +=over 4 + +=item Other Testing Methods + +B<BAIL_OUT> + +=back + +B<skip> + +B<todo_skip> + +B<skip_rest> + +=over 4 + +=item Test building utility methods + +B<maybe_regex> + +=back + +B<_try> + +B<is_fh> + +=over 4 + +=item Test style + +B<level> + +=back + +B<use_numbers> + +B<no_diag>, B<no_ending>, B<no_header> + +=over 4 + +=item Output + +B<diag> + +=back + +B<note> + +B<explain> + +B<_print> + +B<output>, B<failure_output>, B<todo_output> + +reset_outputs + +carp, croak + +=over 4 + +=item Test Status and Info + +B<current_test> + +=back + +B<summary> + +B<details> + +B<todo> + +B<find_TODO> + +B<in_todo> + +B<todo_start> + +C<todo_end> + +B<caller> + +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 + +=over 4 + +=item Importing + +=back + +=back + +=over 4 + +=item Builder + +=back + +=head2 Test::Builder::Tester - test testsuites that have been built with +Test::Builder + +=over 4 + +=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 + +=over 4 + +=item BUGS + +=item AUTHOR + +=item NOTES + +=item SEE ALSO + +=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 + +=back + +=head2 Test::Harness - Run Perl standard test scripts with statistics + +=over 4 + +=item VERSION + +=back + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item FUNCTIONS + +=over 4 + +=item runtests( @test_files ) + +=back + +=back + +=over 4 + +=item execute_tests( tests => \@test_files, out => \*FH ) + +=back + +=over 4 + +=item EXPORT + +=item ENVIRONMENT VARIABLES THAT TAP::HARNESS::COMPATIBLE SETS + +C<HARNESS_ACTIVE>, C<HARNESS_VERSION> + +=item ENVIRONMENT VARIABLES THAT AFFECT TEST::HARNESS + +C<HARNESS_TIMER>, C<HARNESS_VERBOSE>, C<HARNESS_OPTIONS>, C<< j<n> >>, C<< +f >> + +=item Taint Mode + +=item SEE ALSO + +=item BUGS + +=item AUTHORS + +=item LICENCE AND COPYRIGHT + +=back + =head2 Test::More - yet another framework for writing test scripts =over 4 @@ -35671,6 +37073,25 @@ L<Test::More> =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<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->DOES( ROLE ) >>, C<< CLASS->DOES( ROLE ) >>, C<< $obj->can( METHOD ) >>, C<< CLASS->can( METHOD ) >>, C<< eval { VAL->can( METHOD ) } >>, C<VERSION ( [ REQUIRE ] )> +=item 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<print_double>, B<print_long_double>, B<have_long_double>, B<print_nv>, +B<print_iv>, B<print_uv>, B<print_int>, B<print_long>, B<print_float>, +B<call_sv>, B<call_pv>, B<call_method>, B<eval_sv>, B<eval_pv>, +B<require_pv> + +=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 |