X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperltoc.pod;h=5595bda82d068e18e8694f5c5d79d5139091f1a6;hb=56da5a46eac515b5a165aaf05cb06f7bcdfd8e67;hp=0610509af914dc69813a33e9214be661b8b1a0a2;hpb=1e54db1a8aea187ba2e790aca2ab81fab24ff92d;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perltoc.pod b/pod/perltoc.pod index 0610509..5595bda 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -829,8 +829,8 @@ Interaction, perlfaq9 - Networking =back -=head2 perlfaq1 - General Questions About Perl ($Revision: 1.12 $, $Date: -2003/07/09 15:47:28 $) +=head2 perlfaq1 - General Questions About Perl ($Revision: 1.14 $, $Date: +2003/11/23 08:02:29 $) =over 4 @@ -878,8 +878,8 @@ Scheme, or Tcl? =back -=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.20 $, -$Date: 2003/01/26 17:50:56 $) +=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.25 $, +$Date: 2003/10/16 04:57:38 $) =over 4 @@ -934,8 +934,8 @@ References, Tutorials, Task-Oriented, Special Topics =back -=head2 perlfaq3 - Programming Tools ($Revision: 1.33 $, $Date: 2003/01/31 -17:34:56 $) +=head2 perlfaq3 - Programming Tools ($Revision: 1.37 $, $Date: 2003/11/24 +19:55:50 $) =over 4 @@ -1021,8 +1021,8 @@ my C program; what am I doing wrong? =back -=head2 perlfaq4 - Data Manipulation ($Revision: 1.44 $, $Date: 2003/07/28 -17:35:21 $) +=head2 perlfaq4 - Data Manipulation ($Revision: 1.54 $, $Date: 2003/11/30 +00:50:08 $) =over 4 @@ -1035,12 +1035,14 @@ my C program; what am I doing wrong? =item Why am I getting long decimals (eg, 19.9499999999999) instead of the numbers I should be getting (eg, 19.95)? +=item Why is int() broken? + =item Why isn't my octal data interpreted correctly? =item Does Perl have a round() function? What about ceil() and floor()? Trig functions? -=item How do I convert between numeric representations? +=item How do I convert between numeric representations/bases/radixes? How do I convert hexadecimal into decimal, How do I convert from decimal to hexadecimal, How do I convert from octal to decimal, How do I convert from @@ -1238,8 +1240,8 @@ array of hashes or arrays? =back -=head2 perlfaq5 - Files and Formats ($Revision: 1.28 $, $Date: 2003/01/26 -17:45:46 $) +=head2 perlfaq5 - Files and Formats ($Revision: 1.30 $, $Date: 2003/11/23 +08:07:46 $) =over 4 @@ -1601,7 +1603,7 @@ complete? =item How do I add the directory my program lives in to the module/library search path? -=item How do I add a directory to my include path at runtime? +=item How do I add a directory to my include path (@INC) at runtime? =item What is socket.ph and where do I get it? @@ -1695,6 +1697,10 @@ CGI script to do bad things? =item Simple Statements +=item Truth and Falsehood + +=item Statement Modifiers + =item Compound Statements =item Loop Control @@ -1749,12 +1755,12 @@ CGI script to do bad things? =over 4 -=item SYNOPSIS - =item DESCRIPTION =over 4 +=item Operator Precedence and Associativity + =item Terms and List Operators (Leftward) =item The Arrow Operator @@ -2258,9 +2264,9 @@ B<-X>, B<-x> I HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap, :perlio, :pop, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB, PERL5DB, PERL5SHELL (specific to the Win32 port), PERL_DEBUG_MSTATS, -PERL_DESTRUCT_LEVEL, PERL_ENCODING, PERL_HASH_SEED, PERL_HASH_SEED_DEBUG, -PERL_ROOT (specific to the VMS port), PERL_SIGNALS, PERL_UNICODE, SYS$LOGIN -(specific to the VMS port) +PERL_DESTRUCT_LEVEL, PERL_DL_NONLAZY, PERL_ENCODING, PERL_HASH_SEED, +PERL_HASH_SEED_DEBUG, PERL_ROOT (specific to the VMS port), PERL_SIGNALS, +PERL_UNICODE, SYS$LOGIN (specific to the VMS port) =back @@ -2620,7 +2626,7 @@ this USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY -this, NEXTKEY this, lastkey, UNTIE this, DESTROY this +this, NEXTKEY this, lastkey, SCALAR this, UNTIE this, DESTROY this =item Tying FileHandles @@ -3337,7 +3343,8 @@ LC_NUMERIC, LC_TIME, LANG =item Important Caveats Input and Output Layers, Regular Expressions, C still needed to -enable UTF-8/UTF-EBCDIC in scripts +enable UTF-8/UTF-EBCDIC in scripts, C needed to upgrade +non-Latin-1 byte strings =item Byte and Character Semantics @@ -3527,6 +3534,8 @@ chcp, dataset access, OS/390, z/OS iconv, locales =item Switches On the "#!" Line +=item Taint mode and @INC + =item Cleaning Up Your Path =item Security Bugs @@ -3555,7 +3564,7 @@ chcp, dataset access, OS/390, z/OS iconv, locales =item Symbol Tables -=item Package Constructors and Destructors +=item BEGIN, CHECK, INIT and END =item Perl Classes @@ -3595,10 +3604,10 @@ CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util, CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA, Class::Struct, Config, Cwd, DB, DB_File, Data::Dumper, Devel::DProf, Devel::PPPort, Devel::Peek, Devel::SelfStubber, Digest, Digest::MD5, -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, Encode::JP::JIS7, Encode::KR, +Digest::base, 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, 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, @@ -3625,16 +3634,16 @@ 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, -Math::BigInt::Calc, Math::BigInt::Scalar, Math::BigRat, Math::Complex, -Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire, -Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File, -Memoize::SDBM_File, Memoize::Storable, 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, PerlIO, -PerlIO::encoding, PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint, -Pod::Checker, Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects, -Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser, +Math::BigInt::Calc, Math::BigRat, Math::Complex, Math::Trig, Memoize, +Memoize::AnyDBM_File, Memoize::Expire, Memoize::ExpireFile, +Memoize::ExpireTest, Memoize::NDBM_File, Memoize::SDBM_File, +Memoize::Storable, 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, PerlIO, PerlIO::encoding, +PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint, Pod::Checker, +Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects, Pod::LaTeX, +Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser, Pod::Perldoc::ToChecker, Pod::Perldoc::ToMan, Pod::Perldoc::ToNroff, Pod::Perldoc::ToPod, Pod::Perldoc::ToRtf, Pod::Perldoc::ToText, Pod::Perldoc::ToTk, Pod::Perldoc::ToXml, Pod::PlainText, Pod::Plainer, @@ -4467,7 +4476,7 @@ save_hptr(HV **hptr)> =item Internal Functions -A, p, d, s, n, r, f, M, o, j, x +A, p, d, s, n, r, f, M, o, x, m, X, E, b =over 4 @@ -4649,10 +4658,11 @@ HEf_SVKEY, Nullch, Nullsv =item Hash Manipulation Functions get_hv, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set, -HeVAL, HvNAME, hv_clear, hv_delete, hv_delete_ent, hv_exists, -hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey, -hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iternext_flags, hv_iterval, -hv_magic, hv_store, hv_store_ent, hv_undef, newHV, Nullhv +HeVAL, HvNAME, hv_assert, hv_clear, hv_clear_placeholders, hv_delete, +hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent, +hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext, hv_iternextsv, +hv_iternext_flags, hv_iterval, hv_magic, hv_scalar, hv_store, hv_store_ent, +hv_undef, newHV, Nullhv =item Magical Functions @@ -4703,12 +4713,12 @@ get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv, newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv, SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV, SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIsCOW, -SvIsCOW_shared_hash, SvIV, SvIVX, SvIVx, SvLEN, SvNIOK, SvNIOKp, -SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVx, -SvNVX, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only, +SvIsCOW_shared_hash, SvIV, SvIVx, SvIVX, SvLEN, SvNIOK, SvNIOKp, +SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX, +SvNVx, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVbyte, SvPVbytex, SvPVbytex_force, SvPVbyte_force, SvPVbyte_nolen, SvPVutf8, SvPVutf8x, SvPVutf8x_force, -SvPVutf8_force, SvPVutf8_nolen, SvPVX, SvPVx, SvPV_force, SvPV_force_nomg, +SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX, SvPV_force, SvPV_force_nomg, SvPV_nolen, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, SvUNLOCK, SvUOK, SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on, @@ -4773,8 +4783,8 @@ CvWEAKOUTSIDE CX_CURPAD_SAVE, CX_CURPAD_SV, PAD_BASE_SV, PAD_CLONE_VARS, PAD_COMPNAME_FLAGS, PAD_COMPNAME_GEN, PAD_COMPNAME_OURSTASH, PAD_COMPNAME_PV, PAD_COMPNAME_TYPE, PAD_DUP, PAD_RESTORE_LOCAL, -PAD_SAVE_LOCAL, PAD_SAVE_SETNULLPAD, PAD_SETSV, PAD_SET_CUR, PAD_SV, -PAD_SVl, SAVECLEARSV, SAVECOMPPAD, SAVEPADSV +PAD_SAVE_LOCAL, PAD_SAVE_SETNULLPAD, PAD_SETSV, PAD_SET_CUR, +PAD_SET_CUR_NOSAVE, PAD_SV, PAD_SVl, SAVECLEARSV, SAVECOMPPAD, SAVEPADSV =item Functions in file pp_ctl.c @@ -4826,6 +4836,8 @@ report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas =item History and Background +=item Basic Structure + =item Layers vs Disciplines =item Data Structures @@ -4851,6 +4863,8 @@ Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof, Error, Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt, Set_ptrcnt +=item Utilities + =item Implementing PerlIO Layers C implementations, Perl implementations @@ -4994,10 +5008,10 @@ t/cmd t/run t/io t/op, t/lib ext lib =item Special Make Test Targets -coretest, test.deparse, minitest, test.valgrind check.valgrind -utest.valgrind ucheck.valgrind, test.third check.third utest.third -ucheck.third, test.torture torturetest, utest ucheck test.utf8 check.utf8, -test_harness +coretest, test.deparse, test.taintwarn, minitest, test.valgrind +check.valgrind utest.valgrind ucheck.valgrind, test.third check.third +utest.third ucheck.third, test.torture torturetest, utest ucheck test.utf8 +check.utf8, test_harness =item Running tests by hand @@ -5484,6 +5498,16 @@ B<-V> =over 4 +=item Hash Randomisation + +=item UTF-8 On Filehandles No Longer Activated By Locale + +=item Single-number v-strings are no longer v-strings before "=>" + +=item (Win32) The -C Switch Has Been Repurposed + +=item (Win32) The /d Switch Of cmd.exe + =item The C<$*> variable has been removed =back @@ -5492,12 +5516,43 @@ B<-V> =over 4 +=item Assertions + +=item Defined-or operators + +=item UTF-8 no longer default under UTF-8 locales + +=item Unsafe signals again available + =item Tied Arrays with Negative Array Indices +=item Tied hashes in scalar context + +=item local ${$x} + +=item Unicode Character Database 4.0.0 + +=item Miscellaneous Enhancements + =back =item Modules and Pragmata +=over 4 + +=item Updated Modules And Pragmata + +base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes, +CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5, +Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping, +PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc, +Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More, +Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared, +Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath, +Win32::GetOSVersion + +=back + =item Utility Changes =item New Documentation @@ -5506,18 +5561,88 @@ B<-V> =item Installation and Configuration Improvements +=over 4 + +=item Platform-specific enhancements + +=back + =item Selected Bug Fixes +=over 4 + +=item Closures, eval and lexicals + +=item Generic fixes + +=item Platform-specific fixes + +=back + =item New or Changed Diagnostics +=over 4 + +=item Changed "A thread exited while %d threads were running" + +=item Removed "Attempt to clear a restricted hash" + +=item New "Illegal declaration of anonymous subroutine" + +=item Changed "Invalid range "%s" in transliteration operator" + +=item New "Missing control char name in \c" + +=item New "Newline in left-justified string for %s" + +=item New "Possible precedence problem on bitwise %c operator" + +=item New "read() on %s filehandle %s" + +=item New "Tied variable freed while still in use" + +=item New "To%s: illegal mapping '%s'" + +=item New "Use of freed value in iteration" + +=back + =item Changed Internals =item New Tests =item Known Problems +=over 4 + +=item Net::Ping 450_service and 510_ping_udp failures + +=item B::C + +=back + =item Platform Specific Problems +=over 4 + +=item EBCDIC Platforms + +=item Cygwin 1.5 problems + +=item HP-UX: HP cc warnings about sendfile and sendpath + +=item IRIX: t/uni/tr_7jis.t falsely failing + +=item Mac OS X: no usemymalloc + +=item Tru64: No threaded builds with GNU cc (gcc) + +=item Win32: sysopen, sysread, syswrite + +=back + +=item TODO + =item Reporting Bugs =item SEE ALSO @@ -5738,6 +5863,165 @@ B<-V> =back +=head2 perl581delta, perldelta - what is new for perl v5.8.1 + +=over 4 + +=item DESCRIPTION + +=item Incompatible Changes + +=over 4 + +=item Hash Randomisation + +=item UTF-8 On Filehandles No Longer Activated By Locale + +=item Single-number v-strings are no longer v-strings before "=>" + +=item (Win32) The -C Switch Has Been Repurposed + +=item (Win32) The /d Switch Of cmd.exe + +=back + +=item Core Enhancements + +=over 4 + +=item UTF-8 no longer default under UTF-8 locales + +=item Unsafe signals again available + +=item Tied Arrays with Negative Array Indices + +=item local ${$x} + +=item Unicode Character Database 4.0.0 + +=item Deprecation Warnings + +=item Miscellaneous Enhancements + +=back + +=item Modules and Pragmata + +=over 4 + +=item Updated Modules And Pragmata + +base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes, +CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5, +Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping, +PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc, +Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More, +Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared, +Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath, +Win32::GetOSVersion + +=back + +=item Utility Changes + +=item New Documentation + +=item Installation and Configuration Improvements + +=over 4 + +=item Platform-specific enhancements + +=back + +=item Selected Bug Fixes + +=over 4 + +=item Closures, eval and lexicals + +=item Generic fixes + +=item Platform-specific fixes + +=back + +=item New or Changed Diagnostics + +=over 4 + +=item Changed "A thread exited while %d threads were running" + +=item Removed "Attempt to clear a restricted hash" + +=item New "Illegal declaration of anonymous subroutine" + +=item Changed "Invalid range "%s" in transliteration operator" + +=item New "Missing control char name in \c" + +=item New "Newline in left-justified string for %s" + +=item New "Possible precedence problem on bitwise %c operator" + +=item New "Pseudo-hashes are deprecated" + +=item New "read() on %s filehandle %s" + +=item New "5.005 threads are deprecated" + +=item New "Tied variable freed while still in use" + +=item New "To%s: illegal mapping '%s'" + +=item New "Use of freed value in iteration" + +=back + +=item Changed Internals + +=item New Tests + +=item Known Problems + +=over 4 + +=item Tied hashes in scalar context + +=item Net::Ping 450_service and 510_ping_udp failures + +=item B::C + +=back + +=item Platform Specific Problems + +=over 4 + +=item EBCDIC Platforms + +=item Cygwin 1.5 problems + +=item HP-UX: HP cc warnings about sendfile and sendpath + +=item IRIX: t/uni/tr_7jis.t falsely failing + +=item Mac OS X: no usemymalloc + +=item Tru64: No threaded builds with GNU cc (gcc) + +=item Win32: sysopen, sysread, syswrite + +=back + +=item Future Directions + +=item Reporting Bugs + +=item SEE ALSO + +=back + =head2 perl573delta - what's new for perl v5.7.3 =over 4 @@ -7492,13 +7776,13 @@ R4 x86, R4 PPC =back -=over 4 +=head2 perlce - Perl for WinCE -=item Name +=over 4 -=item Description +=item DESCRIPTION -=item Build +=item BUILD =over 4 @@ -7514,7 +7798,7 @@ go to ./wince subdirectory, edit file compile.bat, run compile.bat, run =back -=item Acknowledgements +=item ACKNOWLEDGEMENTS =item AUTHORS @@ -7959,11 +8243,15 @@ public_html/feedback.cgi, src/perl-5.6.0-mpe =item AUTHOR -=item Name +=back -=item Description +=head2 perlnetware - Perl for NetWare -=item Build +=over 4 + +=item DESCRIPTION + +=item BUILD =over 4 @@ -7981,15 +8269,15 @@ SetNWBld.bat, Buildtype.bat =back -=item Install +=item INSTALL -=item Build new extensions +=item BUILD NEW EXTENSIONS -=item Acknowledgements +=item ACKNOWLEDGEMENTS -=item Authors +=item AUTHORS -=item Date +=item DATE =back @@ -9113,8 +9401,7 @@ escapes =back -=head2 diagnostics - Perl compiler pragma to force verbose warning -diagnostics +=head2 diagnostics, splain - produce verbose warning diagnostics =over 4 @@ -9154,6 +9441,8 @@ diagnostics =item PerlIO layers for C +=item Implicit upgrading for byte strings + =back =item FEATURES THAT REQUIRE 5.8.1 @@ -11689,8 +11978,9 @@ I, I, I $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx = Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset, -$ctx->add($data,...), $ctx->addfile($io_handle), $ctx->digest, -$ctx->hexdigest, $ctx->b64digest +$ctx->add($data,...), $ctx->addfile($io_handle), $ctx->add_bits($data, +$nbits), $ctx->add_bits($bitstring), $ctx->digest, $ctx->hexdigest, +$ctx->b64digest =item SEE ALSO @@ -11713,7 +12003,8 @@ 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->digest, $md5->hexdigest, $md5->b64digest +$md5->addfile($io_handle), $md5->add_bits($data, $nbits), +$md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest =item EXAMPLES @@ -11725,6 +12016,18 @@ $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest =back +=head2 Digest::base - Digest base class + +=over 4 + +=item SYNPOSIS + +=item DESCRIPTION + +=item SEE ALSO + +=back + =head2 DirHandle - supply object methods for directory handles =over 4 @@ -12525,6 +12828,8 @@ non-ascii or non-utf8 =item PerlIO layers for C +=item Implicit upgrading for byte strings + =back =item FEATURES THAT REQUIRE 5.8.1 @@ -12670,6 +12975,8 @@ C, C, C =item Exporting without using Exporter's import method +=item Exporting without inheriting from Exporter + =item Module Version Checking =item Managing Unknown Symbols @@ -12725,6 +13032,8 @@ mkpath directory.. test_f file +dos2unix + =over 4 =item BUGS @@ -12936,7 +13245,7 @@ dynamic extensions at load time =back -=head2 ExtUtils::MM_Any - Platform agnostic MM methods +=head2 ExtUtils::MM_Any - Platform-agnostic MM methods =over 4 @@ -12952,6 +13261,8 @@ installvars os_flavor_is +blibdirs_target (o) + =over 4 =item File::Spec wrappers @@ -12996,8 +13307,12 @@ all_target metafile_target +signature_target + metafile_addtomanifest_target +signature_addtomanifest_target + =over 4 =item Abstract methods @@ -13235,7 +13550,7 @@ constants (o) depend (o) -dir_target (o) +dir_target B init_DEST @@ -13699,8 +14014,8 @@ OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERLPREFIX, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT, -PRINT_PREREQ, SITEPREFIX, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION, -VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION +PRINT_PREREQ, SITEPREFIX, SIGN, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, +VERSION, VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION =item Additional lowercase attributes @@ -13802,7 +14117,7 @@ bin/ =back -=head2 ExtUtils::MakeMaker::bytes - Version agnostic bytes.pm +=head2 ExtUtils::MakeMaker::bytes - Version-agnostic bytes.pm =over 4 @@ -13812,7 +14127,7 @@ bin/ =back -=head2 ExtUtils::MakeMaker::vmsish - Platform agnostic vmsish.pm +=head2 ExtUtils::MakeMaker::vmsish - Platform-agnostic vmsish.pm =over 4 @@ -13885,6 +14200,18 @@ B =back +=head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=back + =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader =over 4 @@ -14784,8 +15111,6 @@ VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage =over 4 -=item Warning: Ignoring '!' modifier for short option - =item GetOptions does not return a false result when an option is not supplied @@ -14803,8 +15128,8 @@ supplied =back -=head2 Getopt::Std, getopt - Process single-character switches with switch -clustering +=head2 Getopt::Std, getopt, getopts - Process single-character switches +with switch clustering =over 4 @@ -16046,6 +16371,8 @@ Premature end of base64 data, Premature padding of base64 data =item COPYRIGHT +=item SEE ALSO + =back =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding @@ -16061,6 +16388,8 @@ encode_qp($str), encode_qp($str, $eol), decode_qp($str); =item COPYRIGHT +=item SEE ALSO + =back =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable @@ -16076,6 +16405,8 @@ encode_qp($str), encode_qp($str, $eol), decode_qp($str); =item COPYRIGHT +=item SEE ALSO + =back =head2 Math::BigFloat - Arbitrary size floating point math package @@ -16178,7 +16509,7 @@ Input, Output =item sign -=item bcmp +=item digit =item bneg @@ -16322,9 +16653,9 @@ broot() does not work, Out of Memory!, Fails to load Calc on Perl prior =item CAVEATS -stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity -handling, Modifying and =, bpow, Overloading -$x, Mixing different object -types, bsqrt(), brsft() +bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity handling, +Modifying and =, bpow, Overloading -$x, Mixing different object types, +bsqrt(), brsft() =item LICENSE @@ -16360,27 +16691,6 @@ the same terms as Perl itself. =back -=head2 Math::BigInt::Scalar - Pure Perl module to test Math::BigInt with -scalars - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=item LICENSE - -This program is free software; you may redistribute it and/or modify it -under -the same terms as Perl itself. - -=item AUTHOR - -=item SEE ALSO - -=back - =head2 Math::BigRat - arbitrarily big rationals =over 4 @@ -16798,19 +17108,18 @@ new (HOST [,OPTIONS]) =item METHODS login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]), -site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS]) -ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME -), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ), -mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), alloc ( SIZE [, RECORD_SIZE] ), -dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put ( -LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ), -append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size -( FILE ), supported ( CMD ), hash ( [FILEHANDLE_GLOB_REF],[ -BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [ DIR ] ), retr ( FILE ), -stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( [ PORT ] ), pasv (), -pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_xfer_unique ( -SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait ( NON_PASV_SERVER ), -abort (), quit () +site (ARGS), ascii, binary, rename ( OLDNAME, NEWNAME ), delete ( FILENAME +), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR [, +RECURSE ]), mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), alloc ( SIZE [, +RECORD_SIZE] ), dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] +), put ( LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, +REMOTE_FILE ] ), append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), +mdtm ( FILE ), size ( FILE ), supported ( CMD ), hash ( +[FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [ +DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( +[ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), +pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait ( +NON_PASV_SERVER ), abort (), quit () =over 4 @@ -16837,7 +17146,7 @@ B, B, B, B, B, B, B =item USE EXAMPLES -http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz +http://www.csh.rit.edu/~adam/Progs/ =item CREDITS @@ -17473,7 +17782,7 @@ name space =item DESCRIPTION -unix, stdio, perlio, crlf, utf8, bytes, raw, pop +:unix, :stdio, :perlio, :crlf, :mmap, :utf8, :bytes, :raw, :pop, :win32 =over 4 @@ -17485,7 +17794,7 @@ unix, stdio, perlio, crlf, utf8, bytes, raw, pop =item Defaults and how to override them -=item Querying the layers of filehandle +=item Querying the layers of filehandles =back @@ -17704,9 +18013,9 @@ C<-inc =E 1>, C<-dirs =E [ $dir1, $dir2, ... ]>, C<-verbose =E =item ARGUMENTS -backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index, -infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse, -title, verbose +backlink, cachedir, css, flush, header, help, hiddendirs, htmldir, +htmlroot, index, infile, libpods, netscape, outfile, podpath, podroot, +quiet, recurse, title, verbose =item EXAMPLE @@ -19465,7 +19774,13 @@ B<_my_exit> =back -=head2 Test::Harness - run perl standard test scripts with statistics +=head2 Test::Harness - Run Perl standard test scripts with statistics + +=over 4 + +=item VERSION + +=back =over 4 @@ -19485,7 +19800,7 @@ else> =item Configuration variables. -B<$Test::Harness::verbose>, B<$Test::Harness::switches> +B<$Test::Harness::Verbose>, B<$Test::Harness::switches> =item Failure @@ -19524,8 +19839,9 @@ C, C, C, C, -C, C, C, -C, C, C +C, C, C, +C, C, C, +C, C =item EXAMPLE @@ -19539,6 +19855,10 @@ C, C, C =item BUGS +=item AUTHORS + +=item COPYRIGHT + =back =head2 Test::Harness::Assert - simple assert @@ -19549,11 +19869,11 @@ C, C, C =item DESCRIPTION -=over 4 +=item FUNCTIONS -=item Functions +=over 4 -B +=item C =back @@ -19627,12 +19947,30 @@ B =over 4 +=item C<_command_line( $file )> + +=back + +=over 4 + +=item C<_command> + +=back + +=over 4 + =item C<_switches> =back =over 4 +=item C<_cleaned_switches> + +=back + +=over 4 + =item C<_INC2PERL5LIB> =back @@ -20235,13 +20573,14 @@ tied hashes =item DESCRIPTION TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY -this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this +this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR +this, SCALAR this =item Inheriting from B =item Inheriting from B -=item C and C +=item C, C and C =item MORE INFORMATION @@ -20435,9 +20774,10 @@ CLASS->can( METHOD ) >>, C, C =item Constructor and Tailoring -UCA_Version, alternate, backwards, entry, ignoreName, ignoreChar, level, -normalization, overrideCJK, overrideHangul, preprocess, rearrange, table, -undefName, undefChar, katakana_before_hiragana, upper_before_lower +UCA_Version, backwards, entry, hangul_terminator, ignoreName, ignoreChar, +level, normalization, overrideCJK, overrideHangul, preprocess, rearrange, +table, undefName, undefChar, katakana_before_hiragana, upper_before_lower, +variable, alternate =item Methods for Collation @@ -20461,8 +20801,8 @@ $Collator-Egsubst($string, $substring, $replacement)> =item Other Methods -C<%old_tailoring = $Collator-Echange(%new_tailoring)>, UCA_Version, -Base_Unicode_Version +C<%old_tailoring = $Collator-Echange(%new_tailoring)>, C<$version = +$Collator-Eversion()>, C, C =item EXPORT @@ -20476,11 +20816,9 @@ Base_Unicode_Version =item SEE ALSO -http://www.unicode.org/reports/tr10/, -http://www.unicode.org/reports/tr10/allkeys.txt, -http://www.unicode.org/reports/tr10/CollationTest.html -http://www.unicode.org/reports/tr10/CollationTest.zip, -http://www.unicode.org/reports/tr15/, L +Unicode Collation Algorithm - UTS #10, The Default Unicode Collation +Element Table (DUCET), The conformance test for the UCA, Hangul Syllable +Type, Unicode Normalization Forms - UAX #15, L =back @@ -20498,6 +20836,7 @@ http://www.unicode.org/reports/tr15/, L 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 @@ -20510,6 +20849,7 @@ reorder($string)>, C<$composed_string = compose($string)> 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 @@ -20530,8 +20870,9 @@ C<$may_be_composed_with_prev_char = isComp2nd($codepoint)> =item SEE ALSO -http://www.unicode.org/unicode/reports/tr15/, -http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt +http://www.unicode.org/reports/tr15/, +http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt, +http://www.unicode.org/notes/tn5/ =back