diff options
author | Rafael Garcia-Suarez <rgarciasuarez@gmail.com> | 2007-06-18 11:39:04 +0000 |
---|---|---|
committer | Rafael Garcia-Suarez <rgarciasuarez@gmail.com> | 2007-06-18 11:39:04 +0000 |
commit | a725d285563f16934c9ebbaf6384b573698d46a6 (patch) | |
tree | be026ea3526efbc14e847a7cffee96208a0d4c23 /pod/perltoc.pod | |
parent | 4e99e077dd977ad0b17c51278e97c808991a1de0 (diff) | |
download | perl-a725d285563f16934c9ebbaf6384b573698d46a6.tar.gz |
Regen pods
p4raw-id: //depot/perl@31414
Diffstat (limited to 'pod/perltoc.pod')
-rw-r--r-- | pod/perltoc.pod | 2348 |
1 files changed, 1428 insertions, 920 deletions
diff --git a/pod/perltoc.pod b/pod/perltoc.pod index 7e0a83454e..fcd20473ef 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -511,6 +511,8 @@ X<record> X<structure> X<struct> =item UNIVERSAL: The Root of All Objects +=item Deeper UNIVERSAL details + =back =item Alternate Object Representations @@ -2588,14 +2590,14 @@ X<perl, location of interpreter> =item Command Switches X<perl, command switches> X<command switches> -B<-0>[I<octal/hexadecimal>] X<-0> X<$/>, B<-A[I<module>][=I<assertions>]> -X<-A>, B<-a> X<-a> X<autosplit>, B<-C [I<number/list>]> X<-C>, B<-c> X<-c>, -B<-d> X<-d> X<-dt>, B<-dt>, B<-d:>I<foo[=bar,baz]> X<-d> X<-dt>, -B<-dt:>I<foo[=bar,baz]>, B<-D>I<letters> X<-D> X<DEBUGGING> X<-DDEBUGGING>, -B<-D>I<number>, B<-e> I<commandline> X<-e>, B<-E> I<commandline> X<-E>, -B<-f> X<-f>, B<-F>I<pattern> X<-F>, B<-h> X<-h>, B<-i>[I<extension>] X<-i> -X<in-place>, B<-I>I<directory> X<-I> X<@INC>, B<-l>[I<octnum>] X<-l> X<$/> -X<$\>, B<-m>[B<->]I<module> X<-m> X<-M>, B<-M>[B<->]I<module>, +B<-0>[I<octal/hexadecimal>] X<-0> X<$/>, B<-a> X<-a> X<autosplit>, B<-C +[I<number/list>]> X<-C>, B<-c> X<-c>, B<-d> X<-d> X<-dt>, B<-dt>, +B<-d:>I<foo[=bar,baz]> X<-d> X<-dt>, B<-dt:>I<foo[=bar,baz]>, +B<-D>I<letters> X<-D> X<DEBUGGING> X<-DDEBUGGING>, B<-D>I<number>, B<-e> +I<commandline> X<-e>, B<-E> I<commandline> X<-E>, B<-f> X<-f>, +B<-F>I<pattern> X<-F>, B<-h> X<-h>, B<-i>[I<extension>] X<-i> X<in-place>, +B<-I>I<directory> X<-I> X<@INC>, B<-l>[I<octnum>] X<-l> X<$/> X<$\>, +B<-m>[B<->]I<module> X<-m> X<-M>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>, B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n> X<-n>, B<-p> X<-p>, B<-P> X<-P>, B<-s> X<-s>, B<-S> X<-S>, B<-t> X<-t>, B<-T> X<-T>, B<-u> X<-u>, B<-U> X<-U>, B<-v> X<-v>, B<-V> X<-V>, @@ -2929,6 +2931,67 @@ C<< (?PE<lt>NAMEE<gt>pattern) >>, C<< (?P=NAME) >>, C<< (?P>NAME) >> =back +=head2 perlrebackslash - Perl Regular Expression Backslash Sequences and +Escapes + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item The backslash + +[1] + +=item All the sequences and escapes + +=item Character Escapes + +[1], [2] + +=item Modifiers + +=item Character classes + +=item Referencing + +=item Assertions + +\A, \z, \Z, \G, \b, \B + +=item Misc + +\C, \K, \R, \X + +=back + +=back + +=head2 perlrecharclass - Perl Regular Expression Character Classes + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item The dot + +=item Backslashed sequences + +[1] + +=item Bracketed Character Classes + +cntrl, graph, print, punct + +=item Locale, Unicode and UTF-8 + +=back + +=back + =head2 perlreref - Perl Regular Expressions Reference =over 4 @@ -4187,49 +4250,49 @@ X<CLONE> X<CLONE_SKIP> X<thread> X<threads> X<ithread> =item Pragmatic Modules -assertions, assertions::activate, assertions::compat, attributes, attrs, -autouse, base, bigint, bignum, bigrat, blib, bytes, charnames, constant, -diagnostics, encoding, encoding::warnings, feature, fields, filetest, if, -integer, less, lib, locale, open, ops, overload, re, sigtrap, sort, strict, -subs, threads, threads::shared, utf8, vars, version, vmsish, warnings, -warnings::register +attributes, attrs, autouse, base, bigint, bignum, bigrat, blib, bytes, +charnames, constant, diagnostics, encoding, encoding::warnings, feature, +fields, filetest, if, integer, less, lib, locale, mro, open, ops, overload, +re, sigtrap, sort, strict, subs, threads, threads::shared, utf8, vars, +version, vmsish, warnings, warnings::register =item Standard Modules -AnyDBM_File, Archive::Tar, Archive::Tar::File, Attribute::Handlers, -AutoLoader, AutoSplit, B, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, -B::C, B::CC, B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, -B::Showlex, B::Stackobj, B::Stash, B::Terse, B::Xref, Benchmark, -ByteLoader, CGI, CGI::Apache, CGI::Carp, CGI::Cookie, CGI::Fast, -CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util, CPAN, CPAN::FirstTime, -CPAN::Nox, CPAN::Version, Carp, Carp::Heavy, Class::ISA, Class::Struct, -Compress::Raw::Zlib, Compress::Zlib, Config, Cwd, DB, DBM_Filter, -DBM_Filter::compress, DBM_Filter::encode, DBM_Filter::int32, -DBM_Filter::null, DBM_Filter::utf8, DB_File, Data::Dumper, Devel::DProf, -Devel::Peek, Devel::SelfStubber, Digest, Digest::MD5, Digest::SHA, -Digest::base, Digest::file, DirHandle, Dumpvalue, DynaLoader, Encode, -Encode::Alias, Encode::Byte, Encode::CJKConstants, Encode::CN, -Encode::CN::HZ, Encode::Config, Encode::EBCDIC, Encode::Encoder, -Encode::Encoding, Encode::Guess, Encode::JP, Encode::JP::H2Z, +AnyDBM_File, Archive::Extract, Archive::Tar, Archive::Tar::File, +Attribute::Handlers, AutoLoader, AutoSplit, B, B::Concise, B::Debug, +B::Deparse, B::Lint, B::Showlex, B::Terse, B::Xref, Benchmark, CGI, +CGI::Apache, CGI::Carp, CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, +CGI::Switch, CGI::Util, CPAN, CPAN::FirstTime, CPAN::Kwalify, CPAN::Nox, +CPAN::Version, CPANPLUS, CPANPLUS::Dist::Base, CPANPLUS::Dist::Sample, +CPANPLUS::Shell::Classic, CPANPLUS::Shell::Default::Plugins::HOWTO, Carp, +Carp::Heavy, Class::ISA, Class::Struct, Compress::Raw::Zlib, +Compress::Zlib, Config, Cwd, DB, DBM_Filter, DBM_Filter::compress, +DBM_Filter::encode, DBM_Filter::int32, DBM_Filter::null, DBM_Filter::utf8, +DB_File, Data::Dumper, Devel::DProf, Devel::InnerPackage, Devel::Peek, +Devel::SelfStubber, Digest, Digest::MD5, Digest::SHA, Digest::base, +Digest::file, DirHandle, Dumpvalue, DynaLoader, Encode, Encode::Alias, +Encode::Byte, Encode::CJKConstants, Encode::CN, Encode::CN::HZ, +Encode::Config, Encode::EBCDIC, Encode::Encoder, Encode::Encoding, +Encode::GSM0338, Encode::Guess, Encode::JP, Encode::JP::H2Z, Encode::JP::JIS7, Encode::KR, Encode::KR::2022_KR, Encode::MIME::Header, -Encode::PerlIO, Encode::Supported, Encode::Symbol, Encode::TW, -Encode::Unicode, Encode::Unicode::UTF7, English, Env, Errno, Exporter, -Exporter::Heavy, ExtUtils::CBuilder, ExtUtils::CBuilder::Platform::Windows, -ExtUtils::Command, ExtUtils::Command::MM, ExtUtils::Constant, -ExtUtils::Constant::Base, ExtUtils::Constant::Utils, -ExtUtils::Constant::XS, ExtUtils::Embed, ExtUtils::Install, -ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_AIX, -ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS, -ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_QNX, -ExtUtils::MM_UWIN, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_VOS, -ExtUtils::MM_Win32, ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker, -ExtUtils::MakeMaker::Config, ExtUtils::MakeMaker::FAQ, +Encode::MIME::Name, Encode::PerlIO, Encode::Supported, Encode::Symbol, +Encode::TW, Encode::Unicode, Encode::Unicode::UTF7, English, Env, Errno, +Exporter, Exporter::Heavy, ExtUtils::CBuilder, +ExtUtils::CBuilder::Platform::Windows, ExtUtils::Command, +ExtUtils::Command::MM, ExtUtils::Constant, ExtUtils::Constant::Base, +ExtUtils::Constant::Utils, ExtUtils::Constant::XS, ExtUtils::Embed, +ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, +ExtUtils::MM_AIX, ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, +ExtUtils::MM_DOS, ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, +ExtUtils::MM_QNX, ExtUtils::MM_UWIN, ExtUtils::MM_Unix, ExtUtils::MM_VMS, +ExtUtils::MM_VOS, ExtUtils::MM_Win32, ExtUtils::MM_Win95, ExtUtils::MY, +ExtUtils::MakeMaker, ExtUtils::MakeMaker::Config, ExtUtils::MakeMaker::FAQ, ExtUtils::MakeMaker::Tutorial, ExtUtils::MakeMaker::bytes, ExtUtils::MakeMaker::vmsish, ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::Packlist, ExtUtils::ParseXS, ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree, -File::Compare, File::Copy, File::DosGlob, File::Find, File::Glob, -File::GlobMapper, File::Path, File::Spec, File::Spec::Cygwin, +File::Compare, File::Copy, File::DosGlob, File::Fetch, File::Find, +File::Glob, File::GlobMapper, File::Path, File::Spec, File::Spec::Cygwin, File::Spec::Epoc, File::Spec::Functions, File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache, FileHandle, Filter::Simple, Filter::Util::Call, @@ -4242,11 +4305,13 @@ IO::Pipe, IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET, IO::Socket::UNIX, IO::Uncompress::AnyInflate, IO::Uncompress::AnyUncompress, IO::Uncompress::Base, IO::Uncompress::Gunzip, IO::Uncompress::Inflate, -IO::Uncompress::RawInflate, IO::Uncompress::Unzip, IO::Zlib, IPC::Open2, -IPC::Open3, IPC::SysV, IPC::SysV::Msg, IPC::SysV::Semaphore, List::Util, -Locale::Constants, Locale::Country, Locale::Currency, Locale::Language, -Locale::Maketext, Locale::Maketext::TPJ13, Locale::Script, MIME::Base64, -MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt, +IO::Uncompress::RawInflate, IO::Uncompress::Unzip, IO::Zlib, IPC::Cmd, +IPC::Open2, IPC::Open3, IPC::SysV, IPC::SysV::Msg, IPC::SysV::Semaphore, +List::Util, Locale::Constants, Locale::Country, Locale::Currency, +Locale::Language, Locale::Maketext, Locale::Maketext::Simple, +Locale::Maketext::TPJ13, Locale::Script, Log::Message, +Log::Message::Config, Log::Message::Handlers, Log::Message::Item, +MIME::Base64, MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt, Math::BigInt::Calc, Math::BigInt::CalcEmu, Math::BigInt::FastCalc, Math::BigRat, Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire, Memoize::ExpireFile, Memoize::ExpireTest, @@ -4261,11 +4326,13 @@ Module::Build::Platform::Unix, Module::Build::Platform::VMS, Module::Build::Platform::VOS, Module::Build::Platform::Windows, Module::Build::Platform::aix, Module::Build::Platform::cygwin, Module::Build::Platform::darwin, Module::Build::Platform::os2, -Module::Build::YAML, Module::CoreList, Module::Load, Module::Loaded, -NDBM_File, NEXT, Net::Cmd, Net::Config, Net::Domain, Net::FTP, Net::NNTP, -Net::Netrc, Net::POP3, Net::Ping, Net::SMTP, Net::Time, Net::hostent, -Net::libnetFAQ, Net::netent, Net::protoent, Net::servent, O, ODBM_File, -Opcode, POSIX, Package::Constants, PerlIO, PerlIO::encoding, +Module::Build::YAML, Module::CoreList, Module::Load, +Module::Load::Conditional, Module::Loaded, Module::Pluggable, +Module::Pluggable::Object, NDBM_File, NEXT, Net::Cmd, Net::Config, +Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, Net::POP3, Net::Ping, +Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, Net::netent, +Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX, +Package::Constants, Params::Check, PerlIO, PerlIO::encoding, PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint, Pod::Checker, Pod::Escapes, Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects, Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser, @@ -4283,18 +4350,19 @@ Pod::Simple::TextContent, Pod::Simple::XMLOutStream, Pod::Text, Pod::Text::Color, Pod::Text::Overstrike, Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe, Scalar::Util, Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Storable, Switch, Symbol, Sys::Hostname, Sys::Syslog, -Term::ANSIColor, Term::Cap, Term::Complete, Term::ReadLine, Test, +Term::ANSIColor, Term::Cap, Term::Complete, Term::ReadLine, Term::UI, Test, Test::Builder, Test::Builder::Module, Test::Builder::Tester, Test::Builder::Tester::Color, Test::Harness, Test::Harness::Assert, -Test::Harness::Iterator, Test::Harness::Point, Test::Harness::Straps, -Test::Harness::TAP, Test::Harness::Util, Test::More, Test::Simple, -Test::Tutorial, Text::Abbrev, Text::Balanced, Text::ParseWords, -Text::Soundex, Text::Tabs, Text::Wrap, Thread, Thread::Queue, -Thread::Semaphore, Thread::Signal, Thread::Specific, Tie::Array, Tie::File, -Tie::Handle, Tie::Hash, Tie::Memoize, Tie::RefHash, Tie::Scalar, -Tie::SubstrHash, Time::HiRes, Time::Local, Time::gmtime, Time::localtime, -Time::tm, UNIVERSAL, Unicode::Collate, Unicode::Normalize, Unicode::UCD, -User::grent, User::pwent, XS::APItest, XS::Typemap, XSLoader +Test::Harness::Iterator, Test::Harness::Point, Test::Harness::Results, +Test::Harness::Straps, Test::Harness::TAP, Test::Harness::Util, Test::More, +Test::Simple, Test::Tutorial, Text::Abbrev, Text::Balanced, +Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Thread, +Thread::Queue, Thread::Semaphore, Tie::Array, Tie::File, Tie::Handle, +Tie::Hash, Tie::Hash::NamedCapture, Tie::Memoize, Tie::RefHash, +Tie::Scalar, Tie::SubstrHash, Time::HiRes, Time::Local, Time::Piece, +Time::Piece::Seconds, Time::gmtime, Time::localtime, Time::tm, UNIVERSAL, +Unicode::Collate, Unicode::Normalize, Unicode::UCD, User::grent, +User::pwent, Win32, Win32API::File, XS::APItest, XS::Typemap, XSLoader =item Extension Modules @@ -4575,7 +4643,7 @@ L<piconv>, L<ptar>, L<ptardiff>, L<shasum> =item Installation -L<cpan>, L<instmodsh> +L<cpan>, L<cpanp>, L<cpan2dist>, L<instmodsh> =back @@ -5445,13 +5513,15 @@ callback =item DESCRIPTION +=item Callbacks + =over 4 =item comp -RXf_SKIPWHITE, RXf_START_ONLY, RXf_WHITE, RXf_PMf_LOCALE, -RXf_PMf_MULTILINE, RXf_PMf_SINGLELINE, RXf_PMf_FOLD, RXf_PMf_EXTENDED, -RXf_PMf_KEEPCOPY, RXf_UTF8 +C</m> - RXf_PMf_MULTILINE, C</s> - RXf_PMf_SINGLELINE, C</i> - +RXf_PMf_FOLD, C</x> - RXf_PMf_EXTENDED, C</p> - RXf_PMf_KEEPCOPY, +RXf_SKIPWHITE, RXf_PMf_LOCALE, RXf_UTF8, RXf_START_ONLY, RXf_WHITE =item exec @@ -5461,11 +5531,11 @@ RXf_PMf_KEEPCOPY, RXf_UTF8 =item free -=item numbered_buff_get +=item Numbered capture callbacks -=item named_buff_get +=item Named capture callbacks -=item qr_pkg +=item qr_package =item dupe @@ -5473,15 +5543,43 @@ RXf_PMf_KEEPCOPY, RXf_UTF8 =item The REGEXP structure -C<engine>, C<mother_re>, C<extflags>, C<minlen> C<minlenret>, C<gofs>, -C<substrs>, C<nparens>, C<lasparen>, and C<lastcloseparen>, C<intflags>, -C<pprivate>, C<swap>, C<offs>, C<precomp> C<prelen>, C<paren_names>, -C<reg_substr_data>, C<startp>, C<endp>, C<subbeg> C<sublen> C<saved_copy>, -C<wrapped> C<wraplen>, C<seen_evals>, C<refcnt> - =over 4 -=item De-allocation and Cloning +=item C<engine> + +=item C<mother_re> + +=item C<extflags> + +=item C<minlen> C<minlenret> + +=item C<gofs> + +=item C<substrs> + +=item C<nparens>, C<lasparen>, and C<lastcloseparen> + +=item C<intflags> + +=item C<pprivate> + +=item C<swap> + +=item C<offs> + +=item C<precomp> C<prelen> + +=item C<paren_names> + +=item C<substrs> + +=item C<subbeg> C<sublen> C<saved_copy> + +=item C<wrapped> C<wraplen> + +=item C<seen_evals> + +=item C<refcnt> =back @@ -5624,11 +5722,6 @@ X<sv_usepvn_mg>, sv_uv X<sv_uv>, unpack_str X<unpack_str> packlist X<packlist>, unpackstring X<unpackstring> -=item Global Variables - -PL_modglobal X<PL_modglobal>, PL_na X<PL_na>, PL_sv_no X<PL_sv_no>, -PL_sv_undef X<PL_sv_undef>, PL_sv_yes X<PL_sv_yes> - =item GV Functions GvSV X<GvSV>, gv_const_sv X<gv_const_sv>, gv_fetchmeth X<gv_fetchmeth>, @@ -5688,6 +5781,12 @@ X<strnNE>, sv_nosharing X<sv_nosharing>, upg_version X<upg_version>, vcmp X<vcmp>, vnormal X<vnormal>, vnumify X<vnumify>, vstringify X<vstringify>, vverify X<vverify> +=item MRO Functions + +mro_get_linear_isa X<mro_get_linear_isa>, mro_get_linear_isa_c3 +X<mro_get_linear_isa_c3>, mro_get_linear_isa_dfs X<mro_get_linear_isa_dfs>, +mro_method_changed_in X<mro_method_changed_in> + =item Multicall Functions dMULTICALL X<dMULTICALL>, MULTICALL X<MULTICALL>, POP_MULTICALL @@ -5708,6 +5807,15 @@ cv_const_sv X<cv_const_sv>, newCONSTSUB X<newCONSTSUB>, newXS X<newXS> pad_sv X<pad_sv> +=item Per-Interpreter Variables + +PL_modglobal X<PL_modglobal>, PL_na X<PL_na>, PL_sv_no X<PL_sv_no>, +PL_sv_undef X<PL_sv_undef>, PL_sv_yes X<PL_sv_yes> + +=item REGEXP Functions + +SvRX X<SvRX>, SvRXOK X<SvRXOK> + =item Simple Exception Handling Macros dXCPT X<dXCPT>, XCPT_CATCH X<XCPT_CATCH>, XCPT_RETHROW X<XCPT_RETHROW>, @@ -5889,12 +5997,6 @@ SAVECOMPPAD X<SAVECOMPPAD>, SAVEPADSV X<SAVEPADSV> find_runcv X<find_runcv> -=item Global Variables - -PL_DBsingle X<PL_DBsingle>, PL_DBsub X<PL_DBsub>, PL_DBtrace X<PL_DBtrace>, -PL_dowarn X<PL_dowarn>, PL_last_in_gv X<PL_last_in_gv>, PL_ofs_sv -X<PL_ofs_sv>, PL_rs X<PL_rs> - =item GV Functions is_gv_magical X<is_gv_magical>, is_gv_magical_sv X<is_gv_magical_sv> @@ -5912,6 +6014,10 @@ start_glob X<start_glob> magic_sethint X<magic_sethint>, mg_localize X<mg_localize> +=item MRO Functions + +mro_isa_changed_in X<mro_isa_changed_in> + =item Pad Data Structures CvPADLIST X<CvPADLIST>, cv_clone X<cv_clone>, cv_dump X<cv_dump>, @@ -5924,6 +6030,12 @@ pad_new X<pad_new>, pad_push X<pad_push>, pad_reset X<pad_reset>, pad_setsv X<pad_setsv>, pad_swipe X<pad_swipe>, pad_tidy X<pad_tidy>, pad_undef X<pad_undef> +=item Per-Interpreter Variables + +PL_DBsingle X<PL_DBsingle>, PL_DBsub X<PL_DBsub>, PL_DBtrace X<PL_DBtrace>, +PL_dowarn X<PL_dowarn>, PL_last_in_gv X<PL_last_in_gv>, PL_ofs_sv +X<PL_ofs_sv>, PL_rs X<PL_rs> + =item Stack Manipulation Macros djSP X<djSP>, LVRET X<LVRET> @@ -6244,7 +6356,7 @@ I<The Road goes ever on and on, down from the door where it began.> =item common test code for timed bail out -=item POD -> HTML conversion in the core still sucks +=item POD -E<gt> HTML conversion in the core still sucks =item Parallel testing @@ -6294,8 +6406,6 @@ I<The Road goes ever on and on, down from the door where it began.> =item Make it clear from -v if this is the exact official release -=item Ordering of "global" variables. - =item Profile Perl - am I hot or not? =item Allocate OPs from arenas @@ -6366,12 +6476,12 @@ I<The Road goes ever on and on, down from the door where it began.> =item Optimize away @_ -=item What hooks would assertions need? - =item Properly Unicode safe tokeniser and pads. =item The yada yada yada operators +=item Virtualize operating system access + =back =item Big projects @@ -6463,10 +6573,14 @@ B<-V> =item strictures and array/hash dereferencing in defined() +=item C<(?p{})> has been removed + =item Removal of the bytecode compiler and of perlcc =item Removal of the JPL +=item Recursive inheritance detected earlier + =back =item Core Enhancements @@ -6476,7 +6590,8 @@ B<-V> =item Regular expressions Recursive Patterns, Named Capture Buffers, Possessive Quantifiers, -Backtracking control verbs, Relative backreferences, C<\K> escape +Backtracking control verbs, Relative backreferences, C<\K> escape, Vertical +and horizontal whitespace, and linebreak =item The C<_> prototype @@ -6484,28 +6599,53 @@ Backtracking control verbs, Relative backreferences, C<\K> escape =item readpipe() is now overridable +=item default argument for readline() + =item UCD 5.0.0 =item Smart match +=item Implicit loading of C<feature> + =back =item Modules and Pragmas =over 4 +=item New Pragma, C<mro> + +=item bignum, bigint, bigrat + =item New Core Modules =item Module changes -C<base>, C<warnings>, C<less>, C<Attribute::Handlers>, C<B::Lint>, C<B> +C<assertions>, C<base>, C<strict> and C<warnings>, C<warnings>, C<less>, +C<Attribute::Handlers>, C<B::Lint>, C<B>, C<Thread> =back =item Utility Changes +=over 4 + +=item C<cpanp> + +=item C<cpan2dist> + +=item C<pod2html> + +=back + =item Documentation +=over 4 + +=item New manpage, perlunifaq + +=back + =item Performance Enhancements =item Installation and Configuration Improvements @@ -6514,8 +6654,12 @@ C<base>, C<warnings>, C<less>, C<Attribute::Handlers>, C<B::Lint>, C<B> =item C++ compatibility +=item Visual C++ + =item Static build on Win32 +=item C<d_pseudofork> + =item Ports =back @@ -6524,6 +6668,12 @@ C<base>, C<warnings>, C<less>, C<Attribute::Handlers>, C<B::Lint>, C<B> =item New or Changed Diagnostics +=over 4 + +=item Deprecations + +=back + =item Changed Internals =item Known Problems @@ -6556,10 +6706,14 @@ C<base>, C<warnings>, C<less>, C<Attribute::Handlers>, C<B::Lint>, C<B> =item strictures and array/hash dereferencing in defined() +=item C<(?p{})> has been removed + =item Removal of the bytecode compiler and of perlcc =item Removal of the JPL +=item Recursive inheritance detected earlier + =back =item Core Enhancements @@ -6569,7 +6723,8 @@ C<base>, C<warnings>, C<less>, C<Attribute::Handlers>, C<B::Lint>, C<B> =item Regular expressions Recursive Patterns, Named Capture Buffers, Possessive Quantifiers, -Backtracking control verbs, Relative backreferences, C<\K> escape +Backtracking control verbs, Relative backreferences, C<\K> escape, Vertical +and horizontal whitespace, and linebreak =item The C<_> prototype @@ -6577,28 +6732,53 @@ Backtracking control verbs, Relative backreferences, C<\K> escape =item readpipe() is now overridable +=item default argument for readline() + =item UCD 5.0.0 =item Smart match +=item Implicit loading of C<feature> + =back =item Modules and Pragmas =over 4 +=item New Pragma, C<mro> + +=item bignum, bigint, bigrat + =item New Core Modules =item Module changes -C<base>, C<warnings>, C<less>, C<Attribute::Handlers>, C<B::Lint>, C<B> +C<assertions>, C<base>, C<strict> and C<warnings>, C<warnings>, C<less>, +C<Attribute::Handlers>, C<B::Lint>, C<B>, C<Thread> =back =item Utility Changes +=over 4 + +=item C<cpanp> + +=item C<cpan2dist> + +=item C<pod2html> + +=back + =item Documentation +=over 4 + +=item New manpage, perlunifaq + +=back + =item Performance Enhancements =item Installation and Configuration Improvements @@ -6607,8 +6787,12 @@ C<base>, C<warnings>, C<less>, C<Attribute::Handlers>, C<B::Lint>, C<B> =item C++ compatibility +=item Visual C++ + =item Static build on Win32 +=item C<d_pseudofork> + =item Ports =back @@ -6617,6 +6801,12 @@ C<base>, C<warnings>, C<less>, C<Attribute::Handlers>, C<B::Lint>, C<B> =item New or Changed Diagnostics +=over 4 + +=item Deprecations + +=back + =item Changed Internals =item Known Problems @@ -11137,8 +11327,7 @@ useful flags, ALL, All, MORE, More =item Exportable Functions is_regexp($ref), regexp_pattern($ref), regmust($ref), regname($name,$all), -regnames($all), regnames_iterinit(), regnames_iternext($all), -regnames_count() +regnames($all), regnames_count() =back @@ -11264,74 +11453,6 @@ L<threads> =back -=head2 assertions - select assertions in blocks of code - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=over 4 - -=item Selecting assertions - -=item Handling assertions your own way - -enabled($on), enabled(), seen($on), seen() - -=back - -=item COMPATIBILITY - -=item SEE ALSO - -=item AUTHOR - -=item COPYRIGHT AND LICENSE - -=back - -=head2 assertions::activate - activate assertions - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=item SEE ALSO - -=item AUTHOR - -=item COPYRIGHT AND LICENSE - -=back - -=head2 assertions::compat - assertions for pre-5.9 versions of perl - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=over 4 - -=item The C<assertion> attribute handler - -=item Assertion execution status as a constant - -=back - -=item SEE ALSO - -=item AUTHOR - -=item COPYRIGHT AND LICENSE - -=back - =head2 attributes - get/set subroutine or variable attributes =over 4 @@ -11422,9 +11543,12 @@ Base class package "%s" is empty =over 4 +=item use integer vs. use bigint + =item Options -a or accuracy, p or precision, t or trace, l or lib, v or version +a or accuracy, p or precision, t or trace, hex, oct, l, lib, try or only, v +or version =item Math Library @@ -11434,7 +11558,7 @@ a or accuracy, p or precision, t or trace, l or lib, v or version =item Methods -inf(), NaN(), upgrade() +inf(), NaN(), upgrade(), in_effect() =item MATH LIBRARY @@ -11442,6 +11566,10 @@ inf(), NaN(), upgrade() =back +=item CAVAETS + +in_effect(), hex()/oct() + =item MODULES USED =item EXAMPLES @@ -11466,15 +11594,15 @@ inf(), NaN(), upgrade() =item Options -a or accuracy, p or precision, t or trace, l or lib, v or version +a or accuracy, p or precision, t or trace, l or lib, hex, oct, v or version =item Methods -=item Caveat +=item Caveats -inf(), NaN(), upgrade() +inf(), NaN(), upgrade(), in_effect() -=item MATH LIBRARY +=item Math Library =item INTERNAL FORMAT @@ -11482,6 +11610,10 @@ inf(), NaN(), upgrade() =back +=item CAVAETS + +in_effect(), hex()/oct() + =item MODULES USED =item EXAMPLES @@ -11512,7 +11644,7 @@ inf(), NaN(), upgrade() =item Methods -inf(), NaN(), upgrade() +inf(), NaN(), upgrade(), in_effect() =item MATH LIBRARY @@ -11520,10 +11652,14 @@ inf(), NaN(), upgrade() =item Options -a or accuracy, p or precision, t or trace, l or lib, v or version +a or accuracy, p or precision, t or trace, l or lib, hex, oct, v or version =back +=item CAVAETS + +in_effect(), hex()/oct() + =item EXAMPLES perl -Mbigrat -le 'print sqrt(33)' @@ -11681,6 +11817,8 @@ escapes =item Side effects +=item Side effects + =back =item FEATURES THAT REQUIRE 5.8.1 @@ -11919,6 +12057,92 @@ 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 PERFORMANCE CONSIDERATIONS + +=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 @@ -12317,7 +12541,7 @@ warnings::warnif($object, $message) =item $ae = Archive::Extract->new(archive => '/path/to/archive',[type => TYPE]) -tar, tgz, gz, zip, bz2, tbz +tar, tgz, gz, Z, zip, bz2, tbz =back @@ -12361,6 +12585,8 @@ $ae->extract_path, $ae->files =item $ae->is_gz +=item $ae->is_Z + =item $ae->is_zip =back @@ -12841,6 +13067,10 @@ main_root, main_start, walkoptree(OP, METHOD), walkoptree_debug(DEBUG) ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR), perlstring(STR), class(OBJ), threadsv_names +=item Exported utility variabiles + +@optype, @specialsv_name + =back =item OVERVIEW OF CLASSES @@ -12962,20 +13192,6 @@ label, stash, stashpv, file, cop_seq, arybase, line, warnings, io, hints =back -=head2 B::Asmdata - Autogenerated data about Perl ops - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -%insn_data, @insn_name, @optype, @specialsv_name - -=item AUTHOR - -=back - =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops =over 4 @@ -13849,21 +14065,21 @@ CPAN::Distribution::install_tested(), CPAN::Distribution::isa_perl(), CPAN::Distribution::is_tested(), CPAN::Distribution::look(), CPAN::Distribution::make(), CPAN::Distribution::perldoc(), CPAN::Distribution::prefs(), CPAN::Distribution::prereq_pm(), -CPAN::Distribution::readme(), CPAN::Distribution::read_yaml(), -CPAN::Distribution::test(), CPAN::Distribution::uptodate(), -CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(), -CPAN::Module::as_glimpse(), CPAN::Module::as_string(), -CPAN::Module::clean(), CPAN::Module::cpan_file(), -CPAN::Module::cpan_version(), CPAN::Module::cvs_import(), -CPAN::Module::description(), CPAN::Module::distribution(), -CPAN::Module::dslip_status(), CPAN::Module::force($method,@args), -CPAN::Module::get(), CPAN::Module::inst_file(), -CPAN::Module::available_file(), CPAN::Module::inst_version(), -CPAN::Module::available_version(), CPAN::Module::install(), -CPAN::Module::look(), CPAN::Module::make(), +CPAN::Distribution::readme(), CPAN::Distribution::reports(), +CPAN::Distribution::read_yaml(), CPAN::Distribution::test(), +CPAN::Distribution::uptodate(), CPAN::Index::force_reload(), +CPAN::Index::reload(), CPAN::InfoObj::dump(), CPAN::Module::as_glimpse(), +CPAN::Module::as_string(), CPAN::Module::clean(), +CPAN::Module::cpan_file(), CPAN::Module::cpan_version(), +CPAN::Module::cvs_import(), CPAN::Module::description(), +CPAN::Module::distribution(), CPAN::Module::dslip_status(), +CPAN::Module::force($method,@args), CPAN::Module::get(), +CPAN::Module::inst_file(), CPAN::Module::available_file(), +CPAN::Module::inst_version(), CPAN::Module::available_version(), +CPAN::Module::install(), CPAN::Module::look(), CPAN::Module::make(), CPAN::Module::manpage_headline(), CPAN::Module::perldoc(), -CPAN::Module::readme(), CPAN::Module::test(), CPAN::Module::uptodate(), -CPAN::Module::userid() +CPAN::Module::readme(), CPAN::Module::reports(), CPAN::Module::test(), +CPAN::Module::uptodate(), CPAN::Module::userid() =item Cache Manager @@ -14201,6 +14417,104 @@ ok, args, rv, function =back +=head2 CPANPLUS::Config + +=over 4 + +=item DESCRIPTION + +=item CONFIGURATION + +=back + +=over 4 + +=item Section 'conf' + +hosts + +=back + +base + +buildflags + +cpantest + +cpantest_mx + +debug + +dist_type + +email + +extractdir + +fetchdir + +flush + +force + +lib + +makeflags + +makemakerflags + +md5 + +no_update + +passive + +prefer_bin + +prefer_makefile + +prereqs + +shell + +show_startup_tip + +signature + +skiptest + +storable + +timeout + +verbose + +write_install_log + +editor + +make + +pager + +shell + +sudo + +perlwrapper + +=over 4 + +=item BUG REPORTS + +=item AUTHOR + +=item COPYRIGHT + +=item SEE ALSO + +=back + =head2 CPANPLUS::Configure =over 4 @@ -14367,6 +14681,77 @@ created(), installed(), uninstalled(), dist() =back +=head2 CPANPLUS::Dist::Build + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item ACCESSORS + +parent(), status() + +=item STATUS ACCESSORS + +build_pl (), build (), test (), prepared (), distdir (), created (), +installed (), uninstalled (), _create_args (), _install_args (), _mb_object +() + +=back + +=over 4 + +=item METHODS + +=over 4 + +=item $bool = CPANPLUS::Dist::Build->format_available(); + +=back + +=back + +=over 4 + +=item $bool = $dist->init(); + +=back + +=over 4 + +=item $bool = $dist->prepare([perl => '/path/to/perl', buildflags => +'EXTRA=FLAGS', force => BOOL, verbose => BOOL]) + +=back + +=over 4 + +=item $dist->create([perl => '/path/to/perl', buildflags => 'EXTRA=FLAGS', +prereq_target => TARGET, force => BOOL, verbose => BOOL, skiptest => BOOL]) + +=back + +=over 4 + +=item $dist->install([verbose => BOOL, perl => /path/to/perl]) + +=back + +=over 4 + +=item KNOWN ISSUES + +Module::Build can not be upgraded using its own API (#13169), Module::Build +does not provide access to install history (#9793) + +=item AUTHOR + +=item COPYRIGHT + +=back + =head2 CPANPLUS::Dist::MM =over 4 @@ -14559,7 +14944,8 @@ _conf, _id, _lib, _perl5lib =item $bool = $internals->_register_callback( name => CALLBACK_NAME, code => CODEREF ); -install_prerequisite, send_test_report, munge_test_report, edit_test_report +install_prerequisite, send_test_report, munge_test_report, +edit_test_report, proceed_on_test_failure =back @@ -15310,8 +15696,12 @@ Non-directories in @INC =over 4 -=item $bool = $self->selfupdate( update => -"core|dependencies|enabled_features|features|all", latest => BOOL ) +=item %list = $self->list_modules_to_update( update => +"core|dependencies|enabled_features|features|all", [latest => BOOL] ) + +List which modules C<selfupdate> would upgrade. You can update either +the core (CPANPLUS itself), the core dependencies, all features you have +currently turned on, or all features available, or everything. =back @@ -17201,9 +17591,9 @@ C<XSLoader::load('Your::Module', $Your::Module::VERSION)> =item PERL ENCODING API $octets = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING, -$octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [, -CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [, -CHECK]); +$octets [, CHECK]), [$obj =] find_encoding(ENCODING), [$length =] +from_to($octets, FROM_ENC, TO_ENC [, CHECK]), $octets = +encode_utf8($string);, $string = decode_utf8($octets [, CHECK]); =over 4 @@ -17211,6 +17601,8 @@ CHECK]); =item Defining Aliases +=item Finding IANA Character Set Registry names + =back =item Encoding via PerlIO @@ -17224,12 +17616,6 @@ Encode::FB_PERLQQ), HTML charref mode (I<CHECK> = Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The bitmask, Encode::LEAVE_SRC -=over 4 - -=item coderef for CHECK - -=back - =item Defining Encodings =item The UTF8 flag @@ -17342,7 +17728,7 @@ reference, e.g.: =item Other methods defined in Encode::Encodings --E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(), +-E<gt>name, -E<gt>mime_name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(), -E<gt>needs_lines() =item Example: Encode::ROT13 @@ -17363,6 +17749,22 @@ Scheme 1, Scheme 2, Other Schemes =back +=head2 Encode::GSM0338 -- ESTI GSM 03.38 Encoding + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item NOTES + +=item BUGS + +=item SEE ALSO + +=back + =head2 Encode::Guess -- Guesses encoding from data =over 4 @@ -17439,6 +17841,14 @@ guess_encoding($data, [, I<list of suspects>]) =back +=head2 Encode::MIME::Name, Encode::MIME::NAME -- internally used by Encode + +=over 4 + +=item SEE ALSO + +=back + =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO =over 4 @@ -17482,7 +17892,11 @@ guess_encoding($data, [, I<list of suspects>]) =item Encode::Byte -- Extended ASCII ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for -the Cyrillic world, gsm0338 - Hentai Latin 1 +the Cyrillic world + +=item gsm0338 - Hentai Latin 1 + +gsm0338 support before 2.19 =item CJK: Chinese, Japanese, Korean (Multibyte) @@ -17666,7 +18080,7 @@ Implementation Base Class =item Other methods defined in Encode::Encodings --E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(), +-E<gt>name, -E<gt>mime_name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(), -E<gt>needs_lines() =item Example: Encode::ROT13 @@ -17687,6 +18101,23 @@ Scheme 1, Scheme 2, Other Schemes =back +=head2 Encode::lib::Encode::GSM0338, Encode::GSM0338 -- ESTI GSM 03.38 +Encoding + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item NOTES + +=item BUGS + +=item SEE ALSO + +=back + =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from data @@ -17736,6 +18167,15 @@ and 'Q' header encoding =back +=head2 Encode::lib::Encode::MIME::Name, Encode::MIME::NAME -- internally +used by Encode + +=over 4 + +=item SEE ALSO + +=back + =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document on Encode and PerlIO @@ -17781,7 +18221,11 @@ supported by Encode =item Encode::Byte -- Extended ASCII ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for -the Cyrillic world, gsm0338 - Hentai Latin 1 +the Cyrillic world + +=item gsm0338 - Hentai Latin 1 + +gsm0338 support before 2.19 =item CJK: Chinese, Japanese, Korean (Multibyte) @@ -17906,6 +18350,8 @@ non-ascii or non-utf8 =item Side effects +=item Side effects + =back =item FEATURES THAT REQUIRE 5.8.1 @@ -19107,6 +19553,8 @@ max_exec_len os_flavor +cflags + =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X =over 4 @@ -19834,18 +20282,42 @@ B<~>, B<~user>, B<.>, B<*>, B<?>, B<\>, B<[]>, B<{,}>, B<()> =back -=head2 File::Path - create or remove directory trees +=head2 File::Path - Create or remove directory trees =over 4 +=item VERSION + =item SYNOPSIS =item DESCRIPTION +=over 4 + +=item FUNCTIONS + +mode, verbose, error, verbose, skip_others, keep_root, result, error + +=item TRADITIONAL INTERFACE + +=item ERROR HANDLING + +=item NOTES + +=back + =item DIAGNOSTICS +=item SEE ALSO + +=item BUGS + =item AUTHORS +=item COPYRIGHT + +=item LICENSE + =back =head2 File::Spec - portably perform operations on file names @@ -20575,8 +21047,6 @@ with switch clustering =over 4 -=item Field hashes - =item Restricted hashes B<lock_keys>, B<unlock_keys> @@ -20621,37 +21091,50 @@ unlock_hashref_recurse, hash_ref_unlocked, legal_ref_keys, hidden_ref_keys =back -=head2 Hash::Util::FieldHash - Associate references with data +=head2 Hash::Util::FieldHash - Support for Inside-Out Classes =over 4 =item SYNOPSIS -=item Functions +=item FUNCTIONS -fieldhash, fieldhashes +id, id_2obj, register, idhash, idhashes, fieldhash, fieldhashes -=item Description +=item DESCRIPTION =over 4 -=item Features +=item The Inside-out Technique -Key exchange, Thread support, Garbage collection +=item Problems of Inside-out -=item Rationale +=item Solutions -Stringification, Thread Dependency, Garbage Collection +=item More Problems -=item How to use +=item The Generic Object -=item Examples +=item How to use Field Hashes =item Garbage-Collected Hashes =back -=item Guts +=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 @@ -20672,37 +21155,50 @@ Stringification, Thread Dependency, Garbage Collection =back =head2 Hash::Util::FieldHash::lib::Hash::Util::FieldHash, -Hash::Util::FieldHash - Associate references with data +Hash::Util::FieldHash - Support for Inside-Out Classes =over 4 =item SYNOPSIS -=item Functions +=item FUNCTIONS -fieldhash, fieldhashes +id, id_2obj, register, idhash, idhashes, fieldhash, fieldhashes -=item Description +=item DESCRIPTION =over 4 -=item Features +=item The Inside-out Technique -Key exchange, Thread support, Garbage collection +=item Problems of Inside-out -=item Rationale +=item Solutions -Stringification, Thread Dependency, Garbage Collection +=item More Problems -=item How to use +=item The Generic Object -=item Examples +=item How to use Field Hashes =item Garbage-Collected Hashes =back -=item Guts +=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 @@ -20733,8 +21229,6 @@ general-utility hash subroutines =over 4 -=item Field hashes - =item Restricted hashes B<lock_keys>, B<unlock_keys> @@ -21058,201 +21552,6 @@ Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd} =back -=head2 IO::Compress::Base::lib::File::GlobMapper, File::GlobMapper - Extend -File Glob to Allow Input and Output Files - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -This code is a work in progress, There are known bugs, The interface -defined here is tentative, There are portability issues, Do not use in -production code, Consider yourself warned! - -=over 4 - -=item Behind The Scenes - -=item Limitations - -=item Input File Glob - -B<~>, B<~user>, B<.>, B<*>, B<?>, B<\>, B<[]>, B<{,}>, B<()> - -=item Output File Glob - -"*", #1 - -=item Returned Data - -=back - -=item EXAMPLES - -=over 4 - -=item A Rename script - -=item A few example globmaps - -=back - -=item SEE ALSO - -=item AUTHOR - -=item COPYRIGHT AND LICENSE - -=back - -=head2 IO::Compress::Base::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::Base::lib::IO::Uncompress::AnyUncompress, -IO::Uncompress::AnyUncompress - Uncompress gzip, zip, bzip2 or lzop -file/buffer - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip, bzip2, lzop, lzf - -=item Functional Interface - -=over 4 - -=item anyuncompress $input => $output [, OPTS] - -A filename, A filehandle, A scalar reference, An array reference, An Input -FileGlob string, A filename, A filehandle, A scalar reference, An Array -Reference, An Output FileGlob - -=item Notes - -=item Optional Parameters - -C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, -C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >> - -=item Examples - -=back - -=item OO Interface - -=over 4 - -=item Constructor - -A filename, A filehandle, A scalar reference - -=item Constructor Options - -C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string ->>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength => -$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< RawInflate => 0|1 ->> - -=item Examples - -=back - -=item Methods - -=over 4 - -=item read - -=item read - -=item getline - -=item getc - -=item ungetc - -=item getHeaderInfo - -=item tell - -=item eof - -=item seek - -=item binmode - -=item opened - -=item autoflush - -=item input_line_number - -=item fileno - -=item close - -=item nextStream - -=item trailingData - -=back - -=item Importing - -:all - -=item EXAMPLES - -=item SEE ALSO - -=item AUTHOR - -=item MODIFICATION HISTORY - -=item COPYRIGHT AND LICENSE - -=back - -=head2 IO::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::Deflate - Write RFC 1950 files/buffers =over 4 @@ -21659,8 +21958,7 @@ Minimal => 1|0 >>, C<< BlockSize100K => number >>, C<< WorkFactor => number =back -=head2 IO::Compress::Zlib::IO::Compress::Deflate, IO::Compress::Deflate - -Write RFC 1950 files/buffers +=head2 IO::Dir - supply object methods for directory handles =over 4 @@ -21668,99 +21966,96 @@ Write RFC 1950 files/buffers =item DESCRIPTION -=item Functional Interface +new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), +rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] -=over 4 +=item SEE ALSO -=item deflate $input => $output [, OPTS] +=item AUTHOR -A filename, A filehandle, A scalar reference, An array reference, An Input -FileGlob string, A filename, A filehandle, A scalar reference, An Array -Reference, An Output FileGlob +=item COPYRIGHT -=item Notes +=back -=item Optional Parameters +=head2 IO::File - supply object methods for filehandles -C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> +=over 4 -=item Examples +=item SYNOPSIS -=back +=item DESCRIPTION -=item OO Interface +=item CONSTRUCTOR -=over 4 +new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile -=item Constructor +=item METHODS -A filename, A filehandle, A scalar reference +open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( +[LAYER] ) -=item Constructor Options +=item NOTE -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 SEE ALSO -=item Examples +=item HISTORY =back -=item Methods +=head2 IO::Handle - supply object methods for I/O handles =over 4 -=item print - -=item printf +=item SYNOPSIS -=item syswrite +=item DESCRIPTION -=item write +=item CONSTRUCTOR -=item flush +new (), new_from_fd ( FD, MODE ) -=item tell +=item METHODS -=item eof +$io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines, +$io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error, +$io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ), +$io->blocking ( [ BOOL ] ), $io->untaint -=item seek +=item NOTE -=item binmode +=item SEE ALSO -=item opened +=item BUGS -=item autoflush +=item HISTORY -=item input_line_number +=back -=item fileno +=head2 IO::Pipe - supply object methods for pipes -=item close +=over 4 -=item newStream([OPTS]) +=item SYNOPSIS -=item deflateParams +=item DESCRIPTION -=back +=item CONSTRUCTOR -=item Importing +new ( [READER, WRITER] ) -:all, :constants, :flush, :level, :strategy +=item METHODS -=item EXAMPLES +reader ([ARGS]), writer ([ARGS]), handles () =item SEE ALSO =item AUTHOR -=item MODIFICATION HISTORY - -=item COPYRIGHT AND LICENSE +=item COPYRIGHT =back -=head2 IO::Compress::Zlib::IO::Compress::Gzip, IO::Compress::Gzip - Write -RFC 1952 files/buffers +=head2 IO::Poll - Object interface to system poll call =over 4 @@ -21768,103 +22063,89 @@ RFC 1952 files/buffers =item DESCRIPTION -=item Functional Interface - -=over 4 - -=item gzip $input => $output [, OPTS] - -A filename, A filehandle, A scalar reference, An array reference, An Input -FileGlob string, A filename, A filehandle, A scalar reference, An Array -Reference, An Output FileGlob +=item METHODS -=item Notes +mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( +IO ), handles( [ EVENT_MASK ] ) -=item Optional Parameters +=item SEE ALSO -C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> +=item AUTHOR -=item Examples +=item COPYRIGHT =back -=item OO Interface +=head2 IO::Seekable - supply seek based methods for I/O objects =over 4 -=item Constructor +=item SYNOPSIS -A filename, A filehandle, A scalar reference +=item DESCRIPTION -=item Constructor Options +$io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET), +WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ), +$io->tell -C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A -Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Minimal => 0|1 >>, -C<< Comment => $comment >>, C<< Name => $string >>, C<< Time => $number >>, -C<< TextFlag => 0|1 >>, C<< HeaderCRC => 0|1 >>, C<< OS_Code => $value >>, -C<< ExtraField => $data >>, C<< ExtraFlags => $value >>, C<< Strict => 0|1 ->> +=item SEE ALSO -=item Examples +=item HISTORY =back -=item Methods +=head2 IO::Select - OO interface to the select system call =over 4 -=item print - -=item printf - -=item syswrite +=item SYNOPSIS -=item write +=item DESCRIPTION -=item flush +=item CONSTRUCTOR -=item tell +new ( [ HANDLES ] ) -=item eof +=item METHODS -=item seek +add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( +[ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), +count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) -=item binmode +=item EXAMPLE -=item opened +=item AUTHOR -=item autoflush +=item COPYRIGHT -=item input_line_number +=back -=item fileno +=head2 IO::Socket - Object interface to socket communications -=item close +=over 4 -=item newStream([OPTS]) +=item SYNOPSIS -=item deflateParams +=item DESCRIPTION -=back +=item CONSTRUCTOR -=item Importing +new ( [ARGS] ) -:all, :constants, :flush, :level, :strategy +=item METHODS -=item EXAMPLES +accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, +protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) =item SEE ALSO =item AUTHOR -=item MODIFICATION HISTORY - -=item COPYRIGHT AND LICENSE +=item COPYRIGHT =back -=head2 IO::Compress::Zlib::IO::Compress::RawDeflate, -IO::Compress::RawDeflate - Write RFC 1951 files/buffers +=head2 IO::Socket::INET - Object interface for AF_INET domain sockets =over 4 @@ -21872,99 +22153,53 @@ IO::Compress::RawDeflate - Write RFC 1951 files/buffers =item DESCRIPTION -=item Functional Interface - -=over 4 - -=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 -Reference, An Output FileGlob +=item CONSTRUCTOR -=item Notes +new ( [ARGS] ) -=item Optional Parameters +=over 4 -C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> +=item METHODS -=item Examples +sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost +() =back -=item OO Interface - -=over 4 - -=item Constructor - -A filename, A filehandle, A scalar reference - -=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 AUTHOR -=item Examples +=item COPYRIGHT =back -=item Methods +=head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets =over 4 -=item print - -=item printf - -=item syswrite - -=item write - -=item flush - -=item tell - -=item eof - -=item seek - -=item binmode - -=item opened - -=item autoflush - -=item input_line_number - -=item fileno - -=item close - -=item newStream([OPTS]) +=item SYNOPSIS -=item deflateParams +=item DESCRIPTION -=back +=item CONSTRUCTOR -=item Importing +new ( [ARGS] ) -:all, :constants, :flush, :level, :strategy +=item METHODS -=item EXAMPLES +hostpath(), peerpath() =item SEE ALSO =item AUTHOR -=item MODIFICATION HISTORY - -=item COPYRIGHT AND LICENSE +=item COPYRIGHT =back -=head2 IO::Compress::Zlib::IO::Compress::Zip, IO::Compress::Zip - Write zip -files/buffers +=head2 IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip) +file/buffer =over 4 @@ -21972,11 +22207,13 @@ files/buffers =item DESCRIPTION +RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip + =item Functional Interface =over 4 -=item zip $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 @@ -21986,7 +22223,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 @@ -22002,14 +22240,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<< Name => $string >>, C<< Time => $number >>, C<< ExtAttr => -$attr >>, C<< exTime => [$atime, $mtime, $ctime] >>, C<< Comment => -$comment >>, C<< ZipComment => $comment >>, C<< Method => $method >>, C<< -Stream => 0|1 >>, C<< Zip64 => 0|1 >>, C<< TextFlag => 0|1 >>, C<< -ExtraFieldLocal => $data >> =item C<< ExtraFieldCentral => $data >>, C<< -Minimal => 1|0 >>, C<< BlockSize100K => number >>, C<< WorkFactor => number ->>, -Level, -Strategy, C<< Strict => 0|1 >> +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 @@ -22019,15 +22255,19 @@ Minimal => 1|0 >>, C<< BlockSize100K => number >>, C<< WorkFactor => number =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 @@ -22047,15 +22287,15 @@ Minimal => 1|0 >>, C<< BlockSize100K => number >>, C<< WorkFactor => number =item close -=item newStream([OPTS]) +=item nextStream -=item deflateParams +=item trailingData =back =item Importing -:all, :constants, :flush, :level, :strategy, :zip_method +:all =item EXAMPLES @@ -22069,8 +22309,8 @@ Minimal => 1|0 >>, C<< BlockSize100K => number >>, C<< WorkFactor => number =back -=head2 IO::Compress::Zlib::IO::Uncompress::AnyInflate, -IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip) file/buffer +=head2 IO::Uncompress::AnyUncompress - Uncompress gzip, zip, bzip2 or lzop +file/buffer =over 4 @@ -22078,13 +22318,13 @@ IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip) file/buffer =item DESCRIPTION -RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip +RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip, bzip2, lzop, lzf =item Functional Interface =over 4 -=item anyinflate $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 @@ -22114,9 +22354,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 +>> =item Examples @@ -22136,8 +22374,6 @@ the sub-field structure as defined in RFC 1952 =item ungetc -=item inflateSync - =item getHeaderInfo =item tell @@ -22180,8 +22416,25 @@ 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::Base - Base Class for IO::Uncompress modules + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=item AUTHOR + +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE + +=back + +=head2 IO::Uncompress::Gunzip - Read RFC 1952 files/buffers =over 4 @@ -22291,8 +22544,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 @@ -22397,8 +22649,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 @@ -22503,8 +22754,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 @@ -22609,7 +22859,53 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =back -=head2 IO::Dir - supply object methods for directory handles +=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, IO::Zlib::WRITE: OFFSET is not supported + +=item SEE ALSO + +=item HISTORY + +=item COPYRIGHT + +=back + +=head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory +handles =over 4 @@ -22628,7 +22924,7 @@ rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] =back -=head2 IO::File - supply object methods for filehandles +=head2 IO::lib::IO::File, IO::File - supply object methods for filehandles =over 4 @@ -22653,7 +22949,8 @@ open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( =back -=head2 IO::Handle - supply object methods for I/O handles +=head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O +handles =over 4 @@ -22682,7 +22979,7 @@ $io->blocking ( [ BOOL ] ), $io->untaint =back -=head2 IO::Pipe - supply object methods for pipes +=head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes =over 4 @@ -22706,7 +23003,7 @@ reader ([ARGS]), writer ([ARGS]), handles () =back -=head2 IO::Poll - Object interface to system poll call +=head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call =over 4 @@ -22727,7 +23024,8 @@ IO ), handles( [ EVENT_MASK ] ) =back -=head2 IO::Seekable - supply seek based methods for I/O objects +=head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for +I/O objects =over 4 @@ -22745,7 +23043,8 @@ $io->tell =back -=head2 IO::Select - OO interface to the select system call +=head2 IO::lib::IO::Select, IO::Select - OO interface to the select system +call =over 4 @@ -22771,7 +23070,8 @@ count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) =back -=head2 IO::Socket - Object interface to socket communications +=head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket +communications =over 4 @@ -22796,7 +23096,8 @@ protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) =back -=head2 IO::Socket::INET - Object interface for AF_INET domain sockets +=head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for +AF_INET domain sockets =over 4 @@ -22825,7 +23126,8 @@ sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost =back -=head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets +=head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for +AF_UNIX domain sockets =over 4 @@ -22849,7 +23151,76 @@ hostpath(), peerpath() =back -=head2 IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip) +=head2 IO_Compress_Base::lib::File::GlobMapper, File::GlobMapper - Extend +File Glob to Allow Input and Output Files + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +This code is a work in progress, There are known bugs, The interface +defined here is tentative, There are portability issues, Do not use in +production code, Consider yourself warned! + +=over 4 + +=item Behind The Scenes + +=item Limitations + +=item Input File Glob + +B<~>, B<~user>, B<.>, B<*>, B<?>, B<\>, B<[]>, B<{,}>, B<()> + +=item Output File Glob + +"*", #1 + +=item Returned Data + +=back + +=item EXAMPLES + +=over 4 + +=item A Rename script + +=item A few example globmaps + +=back + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT AND LICENSE + +=back + +=head2 IO_Compress_Base::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_Base::lib::IO::Uncompress::AnyUncompress, +IO::Uncompress::AnyUncompress - Uncompress gzip, zip, bzip2 or lzop file/buffer =over 4 @@ -22858,13 +23229,13 @@ file/buffer =item DESCRIPTION -RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip +RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip, bzip2, lzop, lzf =item Functional Interface =over 4 -=item anyinflate $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 @@ -22894,9 +23265,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 +>> =item Examples @@ -22916,8 +23285,6 @@ the sub-field structure as defined in RFC 1952 =item ungetc -=item inflateSync - =item getHeaderInfo =item tell @@ -22960,8 +23327,8 @@ the sub-field structure as defined in RFC 1952 =back -=head2 IO::Uncompress::AnyUncompress - Uncompress gzip, zip, bzip2 or lzop -file/buffer +=head2 IO_Compress_Base::lib::IO::Uncompress::Base, IO::Uncompress::Base - +Base Class for IO::Uncompress modules =over 4 @@ -22969,13 +23336,30 @@ file/buffer =item DESCRIPTION -RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip, bzip2, lzop, lzf +=item SEE ALSO + +=item AUTHOR + +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE + +=back + +=head2 IO_Compress_Zlib::IO::Compress::Deflate, IO::Compress::Deflate - +Write RFC 1950 files/buffers + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION =item Functional Interface =over 4 -=item anyuncompress $input => $output [, OPTS] +=item deflate $input => $output [, OPTS] A filename, A filehandle, A scalar reference, An array reference, An Input FileGlob string, A filename, A filehandle, A scalar reference, An Array @@ -22985,8 +23369,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 @@ -23002,10 +23385,8 @@ A filename, A filehandle, A scalar reference =item Constructor Options -C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string ->>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength => -$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< RawInflate => 0|1 ->> +C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A +Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >> =item Examples @@ -23015,17 +23396,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 @@ -23045,15 +23424,15 @@ $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 @@ -23067,7 +23446,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_Zlib::IO::Compress::Gzip, IO::Compress::Gzip - Write RFC +1952 files/buffers =over 4 @@ -23075,6 +23455,91 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< RawInflate => 0|1 =item DESCRIPTION +=item Functional Interface + +=over 4 + +=item gzip $input => $output [, OPTS] + +A filename, A filehandle, A scalar reference, An array reference, An Input +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob + +=item Notes + +=item Optional Parameters + +C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >> + +=item Examples + +=back + +=item OO Interface + +=over 4 + +=item Constructor + +A filename, A filehandle, A scalar reference + +=item Constructor Options + +C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A +Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< 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 + +=back + +=item Methods + +=over 4 + +=item print + +=item printf + +=item syswrite + +=item write + +=item flush + +=item tell + +=item eof + +=item seek + +=item binmode + +=item opened + +=item autoflush + +=item input_line_number + +=item fileno + +=item close + +=item newStream([OPTS]) + +=item deflateParams + +=back + +=item Importing + +:all, :constants, :flush, :level, :strategy + +=item EXAMPLES + =item SEE ALSO =item AUTHOR @@ -23085,7 +23550,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_Zlib::IO::Compress::RawDeflate, IO::Compress::RawDeflate +- Write RFC 1951 files/buffers =over 4 @@ -23097,7 +23563,7 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< RawInflate => 0|1 =over 4 -=item gunzip $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 @@ -23107,8 +23573,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 @@ -23124,12 +23589,8 @@ A filename, A filehandle, A scalar reference =item Constructor Options -C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string ->>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength => -$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< 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 +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 @@ -23139,21 +23600,15 @@ as defined in RFC 1952 =over 4 -=item read - -=item read - -=item getline - -=item getc +=item print -=item ungetc +=item printf -=item inflateSync +=item syswrite -=item getHeaderInfo +=item write -Name, Comment +=item flush =item tell @@ -23173,15 +23628,15 @@ Name, Comment =item close -=item nextStream +=item newStream([OPTS]) -=item trailingData +=item deflateParams =back =item Importing -:all +:all, :constants, :flush, :level, :strategy =item EXAMPLES @@ -23195,7 +23650,8 @@ Name, Comment =back -=head2 IO::Uncompress::Inflate - Read RFC 1950 files/buffers +=head2 IO_Compress_Zlib::IO::Compress::Zip, IO::Compress::Zip - Write zip +files/buffers =over 4 @@ -23207,7 +23663,7 @@ Name, Comment =over 4 -=item inflate $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 @@ -23217,8 +23673,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 @@ -23234,9 +23689,14 @@ 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<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A +Filehandle, C<< Name => $string >>, C<< Time => $number >>, C<< ExtAttr => +$attr >>, C<< exTime => [$atime, $mtime, $ctime] >>, C<< Comment => +$comment >>, C<< ZipComment => $comment >>, C<< Method => $method >>, C<< +Stream => 0|1 >>, C<< Zip64 => 0|1 >>, C<< TextFlag => 0|1 >>, C<< +ExtraFieldLocal => $data >> =item C<< ExtraFieldCentral => $data >>, C<< +Minimal => 1|0 >>, C<< BlockSize100K => number >>, C<< WorkFactor => number +>>, -Level, -Strategy, C<< Strict => 0|1 >> =item Examples @@ -23246,19 +23706,15 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =over 4 -=item read - -=item read - -=item getline +=item print -=item getc +=item printf -=item ungetc +=item syswrite -=item inflateSync +=item write -=item getHeaderInfo +=item flush =item tell @@ -23278,15 +23734,15 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =item close -=item nextStream +=item newStream([OPTS]) -=item trailingData +=item deflateParams =back =item Importing -:all +:all, :constants, :flush, :level, :strategy, :zip_method =item EXAMPLES @@ -23300,7 +23756,8 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =back -=head2 IO::Uncompress::RawInflate - Read RFC 1951 files/buffers +=head2 IO_Compress_Zlib::IO::Uncompress::AnyInflate, +IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip) file/buffer =over 4 @@ -23308,11 +23765,13 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =item DESCRIPTION +RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip + =item Functional Interface =over 4 -=item rawinflate $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 @@ -23341,7 +23800,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<< 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 @@ -23405,7 +23867,8 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =back -=head2 IO::Uncompress::Unzip - Read zip files/buffers +=head2 IO_Compress_Zlib::IO::Uncompress::Gunzip, IO::Uncompress::Gunzip - +Read RFC 1952 files/buffers =over 4 @@ -23417,7 +23880,7 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =over 4 -=item unzip $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 @@ -23446,7 +23909,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 @@ -23470,6 +23936,8 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =item getHeaderInfo +Name, Comment + =item tell =item eof @@ -23510,7 +23978,8 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =back -=head2 IO::Zlib - IO:: style interface to L<Compress::Zlib> +=head2 IO_Compress_Zlib::IO::Uncompress::Inflate, IO::Uncompress::Inflate - +Read RFC 1950 files/buffers =over 4 @@ -23518,119 +23987,105 @@ $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> =item DESCRIPTION -=item CONSTRUCTOR - -new ( [ARGS] ) - -=item OBJECT METHODS - -open ( FILENAME, MODE ), opened, close, getc, getline, getlines, print ( -ARGS... ), read ( BUF, NBYTES, [OFFSET] ), eof, seek ( OFFSET, WHENCE ), -tell, setpos ( POS ), getpos ( POS ) - -=item USING THE EXTERNAL GZIP +=item Functional Interface -=item CLASS METHODS +=over 4 -has_Compress_Zlib, gzip_external, gzip_used, gzip_read_open, -gzip_write_open +=item inflate $input => $output [, OPTS] -=item DIAGNOSTICS +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 -IO::Zlib::getlines: must be called in list context, -IO::Zlib::gzopen_external: mode '...' is illegal, IO::Zlib::import: '...' -is illegal, IO::Zlib::import: ':gzip_external' requires an argument, -IO::Zlib::import: 'gzip_read_open' requires an argument, IO::Zlib::import: -'gzip_read' '...' is illegal, IO::Zlib::import: 'gzip_write_open' requires -an argument, IO::Zlib::import: 'gzip_write_open' '...' is illegal, -IO::Zlib::import: no Compress::Zlib and no external gzip, IO::Zlib::open: -needs a filename, IO::Zlib::READ: NBYTES must be specified, -IO::Zlib::WRITE: too long LENGTH, IO::Zlib::WRITE: OFFSET is not supported +=item Notes -=item SEE ALSO +=item Optional Parameters -=item HISTORY +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >> -=item COPYRIGHT +=item Examples =back -=head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory -handles +=item OO Interface =over 4 -=item SYNOPSIS - -=item DESCRIPTION +=item Constructor -new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), -rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] +A filename, A filehandle, A scalar reference -=item SEE ALSO +=item Constructor Options -=item AUTHOR +C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string +>>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength => +$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> -=item COPYRIGHT +=item Examples =back -=head2 IO::lib::IO::File, IO::File - supply object methods for filehandles +=item Methods =over 4 -=item SYNOPSIS +=item read -=item DESCRIPTION +=item read -=item CONSTRUCTOR +=item getline -new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile +=item getc -=item METHODS +=item ungetc -open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( -[LAYER] ) +=item inflateSync -=item NOTE +=item getHeaderInfo -=item SEE ALSO +=item tell -=item HISTORY +=item eof -=back +=item seek -=head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O -handles +=item binmode -=over 4 +=item opened -=item SYNOPSIS +=item autoflush -=item DESCRIPTION +=item input_line_number -=item CONSTRUCTOR +=item fileno -new (), new_from_fd ( FD, MODE ) +=item close -=item METHODS +=item nextStream -$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 trailingData -=item NOTE +=back + +=item Importing + +:all + +=item EXAMPLES =item SEE ALSO -=item BUGS +=item AUTHOR -=item HISTORY +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE =back -=head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes +=head2 IO_Compress_Zlib::IO::Uncompress::RawInflate, +IO::Uncompress::RawInflate - Read RFC 1951 files/buffers =over 4 @@ -23638,91 +24093,105 @@ $io->blocking ( [ BOOL ] ), $io->untaint =item DESCRIPTION -=item CONSTRUCTOR +=item Functional Interface -new ( [READER, WRITER] ) +=over 4 -=item METHODS +=item rawinflate $input => $output [, OPTS] -reader ([ARGS]), writer ([ARGS]), handles () +A filename, A filehandle, A scalar reference, An array reference, An Input +FileGlob string, A filename, A filehandle, A scalar reference, An Array +Reference, An Output FileGlob -=item SEE ALSO +=item Notes -=item AUTHOR +=item Optional Parameters -=item COPYRIGHT +C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >> + +=item Examples =back -=head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call +=item OO Interface =over 4 -=item SYNOPSIS - -=item DESCRIPTION - -=item METHODS +=item Constructor -mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( -IO ), handles( [ EVENT_MASK ] ) +A filename, A filehandle, A scalar reference -=item SEE ALSO +=item Constructor Options -=item AUTHOR +C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string +>>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength => +$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> -=item COPYRIGHT +=item Examples =back -=head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for -I/O objects +=item Methods =over 4 -=item SYNOPSIS +=item read -=item DESCRIPTION +=item read -$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 getline -=item SEE ALSO +=item getc -=item HISTORY +=item ungetc -=back +=item inflateSync -=head2 IO::lib::IO::Select, IO::Select - OO interface to the select system -call +=item getHeaderInfo -=over 4 +=item tell -=item SYNOPSIS +=item eof -=item DESCRIPTION +=item seek -=item CONSTRUCTOR +=item binmode -new ( [ HANDLES ] ) +=item opened -=item METHODS +=item autoflush -add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( -[ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), -count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) +=item input_line_number -=item EXAMPLE +=item fileno + +=item close + +=item nextStream + +=item trailingData + +=back + +=item Importing + +:all + +=item EXAMPLES + +=item SEE ALSO =item AUTHOR -=item COPYRIGHT +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE =back -=head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket -communications +=head2 IO_Compress_Zlib::IO::Uncompress::Unzip, IO::Uncompress::Unzip - +Read zip files/buffers =over 4 @@ -23730,75 +24199,100 @@ communications =item DESCRIPTION -=item CONSTRUCTOR +=item Functional Interface -new ( [ARGS] ) +=over 4 -=item METHODS +=item unzip $input => $output [, OPTS] -accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, -protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) +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<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>, +C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >> + +=item Examples =back -=head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for -AF_INET domain sockets +=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<< MultiStream => 0|1 >>, C<< Prime => $string +>>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength => +$size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >> + +=item Examples + +=back + +=item Methods =over 4 -=item METHODS +=item read -sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost -() +=item read -=back +=item getline -=item SEE ALSO +=item getc -=item AUTHOR +=item ungetc -=item COPYRIGHT +=item inflateSync -=back +=item getHeaderInfo -=head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for -AF_UNIX domain sockets +=item tell -=over 4 +=item eof -=item SYNOPSIS +=item seek -=item DESCRIPTION +=item binmode -=item CONSTRUCTOR +=item opened -new ( [ARGS] ) +=item autoflush -=item METHODS +=item input_line_number -hostpath(), peerpath() +=item fileno + +=item close + +=item nextStream + +=item trailingData + +=back + +=item Importing + +:all + +=item EXAMPLES =item SEE ALSO =item AUTHOR -=item COPYRIGHT +=item MODIFICATION HISTORY + +=item COPYRIGHT AND LICENSE =back @@ -24767,6 +25261,14 @@ ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround ( +$scale =item precision() +=item bexp() + +=item bnok() + +=item bpi() + +=item bmuladd() + =back =item Autocreating constants @@ -24779,6 +25281,8 @@ ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround ( +$scale =back +=item EXPORTS + =item BUGS =item CAVEATS @@ -24867,6 +25371,8 @@ Input, Output =item bmul() +=item bmuladd() + =item bdiv() =item bmod() @@ -24881,6 +25387,10 @@ Input, Output =item bexp() +=item bnok() + +=item bpi() + =item blsft() =item brsft() @@ -25004,6 +25514,8 @@ bsqrt(), div(), blog(), bexp() =back +=item EXPORTS + =item BUGS broot() does not work, Out of Memory!, Fails to load Calc on Perl prior @@ -25545,14 +26057,14 @@ install_base_relpaths(), install_base_relpaths($type), install_base_relpaths($type => $path), install_destination($type), install_path(), install_path($type), install_path($type => $path), install_types(), invoked_action(), notes(), notes($key), notes($key => -$value), orig_dir(), os_type(), prefix_relpaths(), -prefix_relpaths($installdirs), prefix_relpaths($installdirs, $type), -prefix_relpaths($installdirs, $type => $path), prepare_metadata(), -prereq_failures(), prereq_report(), prompt($message, $default), -recommends(), requires(), rscan_dir($dir, $pattern), runtime_params(), -runtime_params($key), script_files(), up_to_date($source_file, -$derived_file), up_to_date(\@source_files, \@derived_files), y_n($message, -$default) +$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) =item Autogenerated Accessors @@ -25910,6 +26422,8 @@ do_system _infer_xs_spec +rscan_dir + =over 4 =item AUTHOR @@ -30841,11 +31355,13 @@ unexpand(1) =back -=head2 Thread - manipulate threads in Perl (for old code only) +=head2 Thread - Manipulate threads in Perl (for old code only) =over 4 -=item CAVEAT +=item DEPRECATED + +=item HISTORY =item SYNOPSIS @@ -30854,14 +31370,16 @@ unexpand(1) =item FUNCTIONS $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub, -LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE, -cond_signal VARIABLE, cond_broadcast VARIABLE, yield +LIST), lock VARIABLE, async BLOCK;, Thread->self, Thread->list, cond_wait +VARIABLE, cond_signal VARIABLE, cond_broadcast VARIABLE, yield =item METHODS -join, eval, detach, equal, tid, flags, done +join, detach, equal, tid, done -=item LIMITATIONS +=item DEFUNCT + +lock(\&sub), eval, flags =item SEE ALSO @@ -30897,31 +31415,6 @@ new, new NUMBER, down, down NUMBER, up, up NUMBER =back -=head2 Thread::Signal - Start a thread which runs signal handlers reliably -(for old code) - -=over 4 - -=item CAVEAT - -=item SYNOPSIS - -=item DESCRIPTION - -=item BUGS - -=back - -=head2 Thread::Specific - thread-specific keys - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=back - =head2 Tie::Array - base class for tied arrays =over 4 @@ -31527,6 +32020,18 @@ http://www.unicode.org/review/pr-29.html, http://www.unicode.org/notes/tn5/ =over 4 +=item general_categories + +=back + +=over 4 + +=item bidi_types + +=back + +=over 4 + =item compexcl =back @@ -31620,23 +32125,26 @@ March 18th, 2000 =item Alphabetical Listing of Win32 Functions Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(), -Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(), +Win32::CopyFile(FROM, TO, OVERWRITE), Win32::CreateDirectory(DIRECTORY), +Win32::CreateFile(FILE), Win32::DomainName(), Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE), -Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(), -Win32::GetChipName(), Win32::GetCwd(), Win32::GetFileVersion(FILENAME), -Win32::GetFolderPath(FOLDER [, CREATE]), Win32::GetFullPathName(FILENAME), -Win32::GetLastError(), Win32::GetLongPathName(PATHNAME), -Win32::GetNextAvailDrive(), Win32::GetOSVersion(), Win32::GetOSName(), +Win32::FsType(), Win32::FreeLibrary(HANDLE), +Win32::GetANSIPathName(FILENAME), Win32::GetArchName(), +Win32::GetChipName(), Win32::GetCwd(), Win32::GetCurrentThreadId(), +Win32::GetFileVersion(FILENAME), Win32::GetFolderPath(FOLDER [, CREATE]), +Win32::GetFullPathName(FILENAME), Win32::GetLastError(), +Win32::GetLongPathName(PATHNAME), Win32::GetNextAvailDrive(), +Win32::GetOSVersion(), Win32::GetOSName(), Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE, PROCNAME), Win32::GetTickCount(), Win32::GuidGen(), Win32::IsAdminUser(), Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME), Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID, SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE), Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(), -Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW), -Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR), -Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID), -Win32::UnregisterServer(LIBRARYNAME) +Win32::OutputDebugString(STRING), Win32::RegisterServer(LIBRARYNAME), +Win32::SetChildShowWindow(SHOWWINDOW), Win32::SetCwd(NEWDIRECTORY), +Win32::SetLastError(ERROR), Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, +PID), Win32::UnregisterServer(LIBRARYNAME) =back |