X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperltoc.pod;h=5595bda82d068e18e8694f5c5d79d5139091f1a6;hb=56da5a46eac515b5a165aaf05cb06f7bcdfd8e67;hp=bd4d0b0a34d8a4e6bbf11ec4747c5bcf53d4a359;hpb=416302502f485afad83d2cbfb0bf4c336eb95ad7;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perltoc.pod b/pod/perltoc.pod index bd4d0b0..5595bda 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -1,4 +1,8 @@ +# !!!!!!! DO NOT EDIT THIS FILE !!!!!!! +# This file is autogenerated by buildtoc from all the other pods. +# Edit those files and run buildtoc --build-toc to effect changes. + =head1 NAME perltoc - perl documentation table of contents @@ -825,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 @@ -874,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 @@ -930,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 @@ -1017,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 @@ -1031,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 @@ -1063,6 +1069,8 @@ from decimal to binary =item How do I find the day or week of the year? +=item How do I find the current century or millennium? + =item How can I compare two dates and find the difference? =item How can I take a string and turn it into epoch seconds? @@ -1232,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 @@ -1383,7 +1391,7 @@ file? =item Are Perl regexes DFAs or NFAs? Are they POSIX compliant? -=item What's wrong with using grep or map in a void context? +=item What's wrong with using grep in a void context? =item How can I match strings with multibyte characters? @@ -1595,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? @@ -1689,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 @@ -1743,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 @@ -1967,7 +1979,7 @@ width, size, order of arguments, sqrt EXPR, sqrt, srand EXPR, srand, stat FILEHANDLE, stat EXPR, stat, study SCALAR, study, sub NAME BLOCK, sub NAME (PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub NAME (PROTO) : ATTRS BLOCK, substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr -EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen +EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall NUMBER, LIST, sysopen FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite @@ -2152,7 +2164,8 @@ PID,FLAGS, wantarray, warn LIST, write FILEHANDLE, write EXPR, write, y/// C<=head1 I>, C<=head2 I>, C<=head3 I>, C<=head4 I>, C<=over I>, C<=item I>, C<=back>, C<=cut>, C<=pod>, C<=begin I>, C<=end -I>, C<=for I I> +I>, C<=for I I>, C<=encoding +I> =item Formatting Codes @@ -2189,7 +2202,8 @@ notes =item Pod Commands "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item", -"=back", "=begin formatname", "=end formatname", "=for formatname text..." +"=back", "=begin formatname", "=end formatname", "=for formatname text...", +"=encoding encodingname" =item Pod Formatting Codes @@ -2250,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 @@ -2376,7 +2390,7 @@ IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/, HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|, IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,, IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS, -$\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#, +$\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $#, HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%, HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=, HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START, @@ -2612,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 @@ -2680,7 +2694,7 @@ safe subprocesses, sockets, and semaphores) =over 4 -=item Deferred Signals (Safe signals) +=item Deferred Signals (Safe Signals) Long running opcodes, Interrupting IO, Restartable system calls, Signals as "faults", Signals triggered by operating system state @@ -3329,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 @@ -3519,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 @@ -3547,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 @@ -3587,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, @@ -3617,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, @@ -3660,7 +3677,7 @@ South Africa =item Asia China, Indonesia, Israel, Japan, Malaysia, Russian Federation, Saudi -Arabia, Singapore, South Korea, Taiwan +Arabia, Singapore, South Korea, Taiwan, Thailand =item Central America @@ -3668,19 +3685,19 @@ Costa Rica =item Europe -Austria, Belgium, Bulgaria, Croatia, Czech Republic, Denmark, Estonia, -Finland, France, Germany, Greece, Hungary, Iceland, Ireland, Italy, Latvia, -Lithuania, Netherlands, Norway, Poland, Portugal, Romania, Russia, -Slovakia, Slovenia, Spain, Sweden, Switzerland, Turkey, Ukraine, United -Kingdom +Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Czech +Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, +Iceland, Ireland, Italy, Latvia, Lithuania, Netherlands, Norway, Poland, +Portugal, Romania, Russia, Slovakia, Slovenia, Spain, Sweden, Switzerland, +Turkey, Ukraine, United Kingdom =item North America Canada, Alberta, Manitoba, Nova Scotia, Ontario, Mexico, United States, Alabama, California, Colorado, Delaware, District of Columbia, Florida, -Illinois, Indiana, Kentucky, Massachusetts, Michigan, Nevada, New Jersey, -New York, North Carolina, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas, -Utah, Virginia, Washington, Wisconsin +Indiana, Kentucky, Massachusetts, Michigan, Nevada, New Jersey, New York, +North Carolina, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas, Utah, +Virginia, Washington, Wisconsin =item Oceania @@ -4459,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 @@ -4477,13 +4494,13 @@ A, p, d, s, n, r, f, M, o, j, x =item What B Unicode, anyway? -=item How can I recognise a UTF8 string? +=item How can I recognise a UTF-8 string? -=item How does UTF8 represent Unicode characters? +=item How does UTF-8 represent Unicode characters? -=item How does Perl store UTF8 strings? +=item How does Perl store UTF-8 strings? -=item How do I convert a string to UTF8? +=item How do I convert a string to UTF-8? =item Is there anything else I need to know? @@ -4641,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 @@ -4682,7 +4700,8 @@ dMARK, dORIGMARK, dSP, EXTEND, MARK, ORIGMARK, POPi, POPl, POPn, POPp, POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XSRETURN, XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF, -XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES +XSRETURN_UV, XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, +XST_mYES =item SV Flags @@ -4727,10 +4746,10 @@ sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn =item Unicode Support bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string, -pv_uni_display, sv_cat_decode, sv_recode_to_utf8, sv_uni_display, -to_utf8_case, to_utf8_fold, to_utf8_lower, to_utf8_title, to_utf8_upper, -utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length, -utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8, +is_utf8_string_loc, pv_uni_display, sv_cat_decode, sv_recode_to_utf8, +sv_uni_display, to_utf8_case, to_utf8_fold, to_utf8_lower, to_utf8_title, +to_utf8_upper, utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop, +utf8_length, utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8, uvuni_to_utf8_flags =item Variables created by C and C internal functions @@ -4764,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 @@ -4817,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 @@ -4842,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 @@ -4985,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 @@ -5324,7 +5347,7 @@ goto(LABEL) and friends =item Mmap for input -=item Byte to/from UTF8 and UTF8 to/from local conversion +=item Byte to/from UTF-8 and UTF-8 to/from local conversion =item Add sockatmark support @@ -5475,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 @@ -5483,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 @@ -5497,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 @@ -5729,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 @@ -7319,6 +7612,8 @@ a), b), c), d), a), b), c), d) =item The IBM ANSI C Compiler +=item The usenm option + =item Using GNU's gcc for building perl =item Using Large Files with Perl @@ -7463,6 +7758,8 @@ R4 x86, R4 PPC =item Floating point anomalies on BS2000 +=item Using PerlIO and different encodings on ASCII and EBCDIC partitions + =back =item AUTHORS @@ -7479,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 @@ -7501,7 +7798,7 @@ go to ./wince subdirectory, edit file compile.bat, run compile.bat, run =back -=item Acknowledgements +=item ACKNOWLEDGEMENTS =item AUTHORS @@ -7887,6 +8184,8 @@ op/lexassign.t, pragma/warnings.t =back +=item Starting From Scratch + =item AUTHOR =item DATE @@ -7944,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 @@ -7966,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 @@ -8457,6 +8760,8 @@ DATAMODEL_NATIVE specified", sh: ar: not found =back +=item SunOS 4.x + =item AUTHOR =item LAST MODIFIED @@ -8880,6 +9185,8 @@ FETCH_I_ATTRIBUTES, MODIFY_I_ATTRIBUTES =item HISTORY +=item CAVEATS + =item SEE ALSO =back @@ -8962,7 +9269,7 @@ inf(), NaN(), upgrade() =back -=head2 bigrat - Transparent BigNumber/BigRationale support for Perl +=head2 bigrat - Transparent BigNumber/BigRational support for Perl =over 4 @@ -9023,6 +9330,8 @@ semantics =item DESCRIPTION +=item LIMITATIONS + =item SEE ALSO =back @@ -9092,8 +9401,7 @@ escapes =back -=head2 diagnostics - Perl compiler pragma to force verbose warning -diagnostics +=head2 diagnostics, splain - produce verbose warning diagnostics =over 4 @@ -9133,6 +9441,8 @@ diagnostics =item PerlIO layers for C +=item Implicit upgrading for byte strings + =back =item FEATURES THAT REQUIRE 5.8.1 @@ -11668,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 @@ -11692,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 @@ -11704,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 @@ -12504,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 @@ -12649,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 @@ -12704,6 +13032,8 @@ mkpath directory.. test_f file +dos2unix + =over 4 =item BUGS @@ -12915,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 @@ -12931,6 +13261,8 @@ installvars os_flavor_is +blibdirs_target (o) + =over 4 =item File::Spec wrappers @@ -12975,8 +13307,12 @@ all_target metafile_target +signature_target + metafile_addtomanifest_target +signature_addtomanifest_target + =over 4 =item Abstract methods @@ -13214,7 +13550,7 @@ constants (o) depend (o) -dir_target (o) +dir_target B init_DEST @@ -13678,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 @@ -13781,7 +14117,7 @@ bin/ =back -=head2 ExtUtils::MakeMaker::bytes - Version agnostic bytes.pm +=head2 ExtUtils::MakeMaker::bytes - Version-agnostic bytes.pm =over 4 @@ -13791,7 +14127,7 @@ bin/ =back -=head2 ExtUtils::MakeMaker::vmsish - Platform agnostic vmsish.pm +=head2 ExtUtils::MakeMaker::vmsish - Platform-agnostic vmsish.pm =over 4 @@ -14247,16 +14583,6 @@ rel2abs =back -tmpdir - -canonpath - -splitpath - -splitdir - -catpath - =head2 File::Spec::OS2 - methods for OS/2 file specs =over 4 @@ -14265,6 +14591,8 @@ catpath =item DESCRIPTION +tmpdir, splitpath + =back =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec @@ -14783,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 @@ -14802,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 @@ -14837,6 +15163,8 @@ lock_value, unlock_value B, B +B + =over 4 =item CAVEATS @@ -16043,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 @@ -16058,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 @@ -16073,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 @@ -16136,7 +16470,7 @@ stringify, bstr(), bdiv, Modifying and =, bpow =item DESCRIPTION -Canonical notation, Input, Output +Input, Output =item METHODS @@ -16175,7 +16509,7 @@ Canonical notation, Input, Output =item sign -=item bcmp +=item digit =item bneg @@ -16319,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 @@ -16357,28 +16691,7 @@ 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 rationales +=head2 Math::BigRat - arbitrarily big rationals =over 4 @@ -16795,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 @@ -16834,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 @@ -17470,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 @@ -17482,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 @@ -17504,7 +17816,7 @@ unix, stdio, perlio, crlf, utf8, bytes, raw, pop =back -=head2 PerlIO::scalar - support module for in-memory IO. +=head2 PerlIO::scalar - in-memory IO, scalar IO =over 4 @@ -17512,6 +17824,8 @@ unix, stdio, perlio, crlf, utf8, bytes, raw, pop =item DESCRIPTION +=item IMPLEMENTATION NOTE + =back =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl @@ -17699,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 @@ -19123,6 +19437,8 @@ C =item DESCRIPTION +=item BUGS + =back =head2 Sys::Hostname - Try every conceivable way to get hostname @@ -19458,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 @@ -19478,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 @@ -19517,8 +19839,9 @@ C, C, C, C, -C, C, C, -C, C, C +C, C, C, +C, C, C, +C, C =item EXAMPLE @@ -19532,6 +19855,10 @@ C, C, C =item BUGS +=item AUTHORS + +=item COPYRIGHT + =back =head2 Test::Harness::Assert - simple assert @@ -19542,11 +19869,11 @@ C, C, C =item DESCRIPTION -=over 4 +=item FUNCTIONS -=item Functions +=over 4 -B +=item C =back @@ -19620,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 @@ -20228,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 @@ -20428,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 @@ -20454,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 @@ -20469,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 @@ -20491,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 @@ -20503,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 @@ -20523,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