X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperltoc.pod;h=0a7987bb367b41db87912586113b98a4446d329a;hb=9b5c3821be1f2a9a84772171c8bbadbf9cfc4a53;hp=56027b5bd88d2f9c91f4951a043cb27378a94126;hpb=e0eb806da65d9c202cc8d19c8a8cd7a0cbeb7857;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perltoc.pod b/pod/perltoc.pod index 56027b5..0a7987b 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -765,8 +765,8 @@ LIMIT specified =back -=head2 perlfaq - frequently asked questions about Perl ($Date: 2003/01/31 -17:37:17 $) +=head2 perlfaq - frequently asked questions about Perl ($Date: 2004/10/05 +22:15:44 $) =over 4 @@ -829,8 +829,8 @@ Interaction, perlfaq9 - Networking =back -=head2 perlfaq1 - General Questions About Perl ($Revision: 1.14 $, $Date: -2003/11/23 08:02:29 $) +=head2 perlfaq1 - General Questions About Perl ($Revision: 1.15 $, $Date: +2004/10/11 05:06:29 $) =over 4 @@ -878,8 +878,8 @@ Scheme, or Tcl? =back -=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.25 $, -$Date: 2003/10/16 04:57:38 $) +=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.29 $, +$Date: 2004/10/25 18:37:23 $) =over 4 @@ -934,8 +934,8 @@ References, Tutorials, Task-Oriented, Special Topics =back -=head2 perlfaq3 - Programming Tools ($Revision: 1.37 $, $Date: 2003/11/24 -19:55:50 $) +=head2 perlfaq3 - Programming Tools ($Revision: 1.41 $, $Date: 2004/11/03 +22:45:32 $) =over 4 @@ -963,9 +963,10 @@ References, Tutorials, Task-Oriented, Special Topics =item Is there an IDE or Windows Perl Editor? -Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, OptiPerl, -GNU Emacs, MicroEMACS, XEmacs, Jed, Elvis, Vile, Vim, Codewright, -MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha +Eclipse, Komodo, Open Perl IDE, OptiPerl, PerlBuilder, visiPerl+, Visual +Perl, GNU Emacs, MicroEMACS, XEmacs, Jed, Elvis, Vile, Vim, Codewright, +MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, Affrus, Alpha, BBEdit and +BBEdit Lite =item Where can I get Perl macros for vi? @@ -1021,8 +1022,8 @@ my C program; what am I doing wrong? =back -=head2 perlfaq4 - Data Manipulation ($Revision: 1.54 $, $Date: 2003/11/30 -00:50:08 $) +=head2 perlfaq4 - Data Manipulation ($Revision: 1.56 $, $Date: 2004/11/03 +22:47:56 $) =over 4 @@ -1240,8 +1241,8 @@ array of hashes or arrays? =back -=head2 perlfaq5 - Files and Formats ($Revision: 1.30 $, $Date: 2003/11/23 -08:07:46 $) +=head2 perlfaq5 - Files and Formats ($Revision: 1.31 $, $Date: 2004/02/07 +04:29:50 $) =over 4 @@ -1336,8 +1337,8 @@ protected files? Isn't this a bug in Perl? =back -=head2 perlfaq6 - Regular Expressions ($Revision: 1.20 $, $Date: 2003/01/03 -20:05:28 $) +=head2 perlfaq6 - Regular Expressions ($Revision: 1.27 $, $Date: 2004/11/03 +22:52:16 $) =over 4 @@ -1403,8 +1404,8 @@ file? =back -=head2 perlfaq7 - General Perl Language Issues ($Revision: 1.15 $, $Date: -2003/07/24 02:17:21 $) +=head2 perlfaq7 - General Perl Language Issues ($Revision: 1.18 $, $Date: +2004/11/03 22:54:08 $) =over 4 @@ -1485,8 +1486,8 @@ methods? =back -=head2 perlfaq8 - System Interaction ($Revision: 1.17 $, $Date: 2003/01/26 -17:44:04 $) +=head2 perlfaq8 - System Interaction ($Revision: 1.22 $, $Date: 2004/10/05 +22:13:49 $) =over 4 @@ -1594,6 +1595,8 @@ complete? =item How do I open a file without blocking? +=item How do I tell the difference between errors from the shell and perl? + =item How do I install a module from CPAN? =item What's the difference between require and use? @@ -1613,7 +1616,7 @@ search path? =back -=head2 perlfaq9 - Networking ($Revision: 1.15 $, $Date: 2003/01/31 17:36:57 +=head2 perlfaq9 - Networking ($Revision: 1.16 $, $Date: 2004/10/30 12:20:59 $) =over 4 @@ -1836,6 +1839,8 @@ regular expressions =item Constant Folding +=item No-ops + =item Bitwise String Operators =item Integer Arithmetic @@ -2091,6 +2096,8 @@ PID,FLAGS, wantarray, warn LIST, write FILEHANDLE, write EXPR, write, y/// =item How to Eat an Egg on a Net +=item Byte-order modifiers + =item Floating point Numbers =back @@ -2131,6 +2138,8 @@ PID,FLAGS, wantarray, warn LIST, write FILEHANDLE, write EXPR, write, y/// =item The Alignment Pit +=item Dealing with Endian-ness + =item Alignment, Take 2 =item Alignment, Take 3 @@ -2249,13 +2258,14 @@ OS/2, MS-DOS, Win95/NT, Macintosh, VMS =item Command Switches B<-0>[I], B<-A [I]>, B<-a>, B<-C -[I]>, B<-c>, B<-d>, B<-d:>I, B<-D>I, -B<-D>I, B<-e> I, B<-F>I, B<-h>, -B<-i>[I], B<-I>I, B<-l>[I], -B<-m>[B<->]I, B<-M>[B<->]I, B<-M>[B<->]I<'module ...'>, +[I]>, B<-c>, B<-d>, B<-dt>, B<-d:>I, +B<-dt:>I, B<-D>I, B<-D>I, B<-e> +I, B<-F>I, B<-h>, B<-i>[I], +B<-I>I, B<-l>[I], B<-m>[B<->]I, +B<-M>[B<->]I, B<-M>[B<->]I<'module ...'>, B<-[mM]>[B<->]I, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>, -B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I, B<-w>, B<-W>, -B<-X>, B<-x> I +B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I, B<-w>, B<-W>, +B<-X>, B<-x>, B<-x> I =back @@ -2263,7 +2273,8 @@ 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, +PERL5DB, PERL5DB_THREADED, PERL5SHELL (specific to the Win32 port), +PERL_ALLOW_NON_IFS_LSP (specific to the Win32 port), PERL_DEBUG_MSTATS, 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) @@ -3360,8 +3371,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, C needed to upgrade -non-Latin-1 byte strings +enable UTF-8/UTF-EBCDIC in scripts, BOM-marked scripts and UTF-16 scripts +autodetected, C needed to upgrade non-Latin-1 byte strings =item Byte and Character Semantics @@ -3893,9 +3904,9 @@ Look around, Check it's new, Discuss the need, Choose a name, Check again =item Step-by-step: Making the module -Start with F, Use L and L, Use -L, Use L - wisely!, Use L, Write tests, Write the README +Start with F or F, Use L and +L, Use L, Use L - wisely!, +Use L, Write tests, Write the README =item Step-by-step: Distributing your module @@ -4506,6 +4517,8 @@ A, p, d, s, n, r, f, M, o, x, m, X, E, b =item Source Documentation +=item Backwards compatibility + =back =item Unicode Support @@ -4634,7 +4647,7 @@ GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill, av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift, -get_av, newAV, Nullav, sortsv +get_av, newAV, sortsv =item Callback Functions @@ -4651,7 +4664,7 @@ perl_clone =item CV Manipulation Functions -CvSTASH, get_cv, Nullcv +CvSTASH, get_cv =item Embedding Functions @@ -4669,37 +4682,38 @@ PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes =item GV Functions GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload, -gv_fetchmeth_autoload, gv_stashpv, gv_stashsv +gv_fetchmeth_autoload, gv_stashpv, gv_stashpvn, gv_stashsv =item Handy Values -HEf_SVKEY, Nullch, Nullsv +Nullav, Nullch, Nullcv, Nullhv, Nullsv =item Hash Manipulation Functions -get_hv, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set, -HeVAL, HvNAME, hv_assert, hv_clear, hv_clear_placeholders, hv_delete, -hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent, +get_hv, HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, +HeSVKEY_set, 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 +hv_undef, newHV =item Magical Functions mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set, SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal, -SvSetSV, SvSetSV_nosteal, SvSHARE +SvSetSV, SvSetSV_nosteal, SvSHARE, SvUNLOCK =item Memory Management -Copy, Move, New, Newc, NEWSV, Newz, Poison, Renew, Renewc, Safefree, -savepv, savepvn, savesharedpv, StructCopy, Zero +Copy, CopyD, Move, MoveD, New, Newc, Newz, Poison, Renew, Renewc, Safefree, +savepv, savepvn, savesharedpv, savesvpv, StructCopy, Zero, ZeroD =item Miscellaneous Functions fbm_compile, fbm_instr, form, getcwd_sv, new_version, scan_version, strEQ, strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, sv_nolocking, -sv_nosharing, sv_nounlocking, upg_version, vcmp, vnumify, vstringify +sv_nosharing, sv_nounlocking, upg_version, vcmp, vnormal, vnumify, +vstringify =item Numeric functions @@ -4716,12 +4730,13 @@ pad_sv =item Stack Manipulation Macros -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_UV, XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, -XST_mYES +dMARK, dORIGMARK, dSP, EXTEND, MARK, mPUSHi, mPUSHn, mPUSHp, mPUSHu, +mXPUSHi, mXPUSHn, mXPUSHp, mXPUSHu, ORIGMARK, POPi, POPl, POPn, POPp, +POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHmortal, PUSHn, PUSHp, PUSHs, +PUSHu, PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHmortal, XPUSHn, XPUSHp, XPUSHs, +XPUSHu, XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, +XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_UV, XSRETURN_YES, XST_mIV, XST_mNO, +XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES =item SV Flags @@ -4729,25 +4744,25 @@ svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG =item SV Manipulation Functions -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, SvIV_nomg, 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, +get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, 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, SvIV_nomg, 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, SvPV_nomg, 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, SvUV, SvUVX, SvUVx, SvUV_nomg, SvVOK, sv_2bool, -sv_2cv, sv_2io, sv_2iv_flags, sv_2mortal, sv_2nv, sv_2pvbyte, -sv_2pvbyte_nolen, sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, -sv_2uv_flags, sv_backoff, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, -sv_catpvn, sv_catpvn_flags, sv_catpvn_mg, sv_catpv_mg, sv_catsv, -sv_catsv_flags, sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, +SvTAINTED_on, SvTRUE, SvTYPE, SvUOK, SvUPGRADE, SvUTF8, SvUTF8_off, +SvUTF8_on, SvUV, SvUVx, SvUVX, SvUV_nomg, SvVOK, sv_2bool, sv_2cv, sv_2io, +sv_2iv_flags, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen, sv_2pvutf8, +sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv_flags, sv_backoff, +sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_flags, +sv_catpvn_mg, sv_catpvn_nomg, sv_catpv_mg, sv_catsv, sv_catsv_flags, +sv_catsv_mg, sv_catsv_nomg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm, sv_copypv, sv_dec, sv_derived_from, sv_eq, sv_force_normal, sv_force_normal_flags, sv_free, sv_gets, sv_grow, sv_inc, sv_insert, sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8, sv_magic, sv_magicext, @@ -4758,10 +4773,12 @@ sv_replace, sv_report_used, sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn, sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv, sv_setref_pvn, sv_setref_uv, sv_setsv, -sv_setsv_flags, sv_setsv_mg, sv_setuv, sv_setuv_mg, sv_taint, sv_tainted, -sv_true, sv_unmagic, sv_unref, sv_unref_flags, sv_untaint, sv_upgrade, -sv_usepvn, sv_usepvn_mg, sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode, -sv_utf8_upgrade, sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn +sv_setsv_flags, sv_setsv_mg, sv_setsv_nomg, sv_setuv, sv_setuv_mg, +sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref, sv_unref_flags, +sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_utf8_decode, +sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade, sv_utf8_upgrade_flags, +sv_uv, sv_vcatpvf, sv_vcatpvfn, sv_vcatpvf_mg, sv_vsetpvf, sv_vsetpvfn, +sv_vsetpvf_mg =item Unicode Support @@ -4774,8 +4791,8 @@ uvuni_to_utf8_flags =item Variables created by C and C internal functions -ax, CLASS, dAX, dITEMS, dXSARGS, dXSI32, items, ix, newXSproto, RETVAL, ST, -THIS, XS, XSRETURN_EMPTY, XS_VERSION, XS_VERSION_BOOTCHECK +ax, CLASS, dAX, dITEMS, dUNDERBAR, dXSARGS, dXSI32, items, ix, newXSproto, +RETVAL, ST, THIS, UNDERBAR, XS, XS_VERSION, XS_VERSION_BOOTCHECK =item Warning and Dieing @@ -4836,7 +4853,8 @@ djSP, LVRET =item SV Manipulation Functions -report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas +find_uninit_var, report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, +sv_free_arenas =item AUTHORS @@ -4976,6 +4994,8 @@ It's easier to rsync the source tree, It's more reliable It's easier to rsync the patches, It's a good reference, Finding a start point, Finding how to fix a bug, Finding the source of misbehaviour +=item Working with the source + =item Perlbug administration =item Submitting patches @@ -5031,7 +5051,7 @@ t/cmd t/run t/io t/op, t/lib ext lib 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 +check.utf8, minitest.utf16 test.utf16, test_harness =item Running tests by hand @@ -5098,356 +5118,157 @@ I =item DESCRIPTION -=item To do during 5.6.x - -=over 4 - -=item Support for I/O disciplines - -=item Autoload bytes.pm - -=item Make "\u{XXXX}" et al work - -=item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags) - -=item Overloadable regex assertions - -=item Unicode - -=item Work out exit/die semantics for threads - -=item Better support for nonpreemptive threading systems like GNU pth - -=item Typed lexicals for compiler - -=item Compiler workarounds for Win32 - -=item AUTOLOADing in the compiler - -=item Fixing comppadlist when compiling - -=item Cleaning up exported namespace - -=item Complete signal handling - -=item Out-of-source builds - -=item POSIX realtime support - -=item UNIX98 support - -=item IPv6 Support - -=item Long double conversion - -=item Locales - -=item Arithmetic on non-Arabic numerals - -=item POSIX Unicode character classes - -=item Factoring out common suffices/prefices in regexps (trie optimization) - -=item Security audit shipped utilities - -=item Sort out the uid-setting mess - -=item Custom opcodes +=item assertions -=item DLL Versioning +=item iCOW -=item Introduce @( and @) +=item (?{...}) closures in regexps -=item Floating point handling +=item A re-entrant regexp engine -=item IV/UV preservation +=item pragmata -=item Replace pod2html with something using Pod::Parser - -=item Automate module testing on CPAN - -=item sendmsg and recvmsg - -=item Rewrite perlre documentation - -=item Convert example code to IO::Handle filehandles - -=item Document Win32 choices +=over 4 -=item Check new modules +=item lexical pragmas -=item Make roffitall find pods and libs itself +=item use less 'memory' =back -=item To do at some point +=item prototypes and functions =over 4 -=item Remove regular expression recursion - -=item Memory leaks after failed eval - -=item bitfields in pack - -=item Cross compilation - -=item Perl preprocessor / macros - -=item Perl lexer in Perl - -=item Using POSIX calls internally - -=item -i rename file when changed - -=item All ARGV input should act like EE - -=item Support for rerunning debugger - -=item Test Suite for the Debugger - -=item my sub foo { } - -=item One-pass global destruction - -=item Rewrite regexp parser - -=item Cache recently used regexps - -=item Cross-compilation support - -=item Bit-shifting bitvectors - -=item debugger pragma - -=item use less pragma - -=item switch structures - -=item Cache eval tree - -=item rcatmaybe - -=item Shrink opcode tables - -=item Optimize away @_ - -=item Prototypes versus indirect objects - -=item Install HTML - -=item Prototype method calls - -=item Return context prototype declarations - -=item magic_setisa - -=item Garbage collection - -=item IO tutorial +=item _ prototype character -=item Rewrite perldoc - -=item Install .3p manpages - -=item Unicode tutorial - -=item Update POSIX.pm for 1003.1-2 - -=item Retargetable installation - -=item POSIX emulation on non-POSIX systems - -=item Rename Win32 headers +=item inlining autoloaded constants =item Finish off lvalue functions -=item Update sprintf documentation - -=item Use fchown/fchmod internally - -=item Make v-strings overloaded objects - -=item Allow restricted hash assignment - -=item Should overload be inheritable? - -=item Taint rethink - -=item Perform correctly when XSUBs call subroutines that exit via -goto(LABEL) and friends - =back -=item Vague ideas +=item Unicode and UTF8 =over 4 -=item ref() in list context - -=item Make tr/// return histogram of characters in list context - -=item Compile to real threaded code - -=item Structured types - -=item Modifiable $1 et al. - -=item Procedural interfaces for IO::*, etc. +=item Implicit Latin 1 => Unicode translation -=item RPC modules +=item UTF8 caching code -=item Attach/detach debugger from running program - -=item GUI::Native - -=item foreach(reverse ...) - -=item Constant function cache +=item Unicode in Filenames -=item Approximate regular expression matching +=item Unicode in %ENV =back -=item Ongoing +=item Regexps =over 4 -=item Update guts documentation - -=item Add more tests - -=item Update auxiliary tools - -=item Create debugging macros +=item regexp optimiser optional -=item truncate to the people - -=item Unicode in Filenames +=item common suffices/prefices in regexps (trie optimization) =back -=item Unicode in %ENV - -=item Recently done things +=item POD =over 4 -=item Alternative RE syntax module - -=item Safe signal handling - -=item Tie Modules - -=item gettimeofday - -=item setitimer and getimiter +=item POD -> HTML conversion still sucks -=item Testing __DIE__ hook - -=item CPP equivalent in Perl - -=item Explicit switch statements - -=item autocroak - -=item UTF/EBCDIC - -=item UTF Regexes - -=item perlcc to produce executable - -=item END blocks saved in compiled output +=back -=item Secure temporary file module +=item Misc medium sized projects -=item Integrate Time::HiRes +=over 4 -=item Turn Cwd into XS +=item UNITCHECK -=item Mmap for input +=item optional optimizer -=item Byte to/from UTF-8 and UTF-8 to/from local conversion +=item You WANT *how* many -=item Add sockatmark support +=item lexical aliases -=item Mailing list archives +=item no 6 -=item Bug tracking +=item IPv6 -=item Integrate MacPerl +=item entersub XS vs Perl -=item Web "nerve center" for Perl +=item @INC source filter to Filter::Simple -=item Regular expression tutorial +=item bincompat functions -=item Debugging Tutorial +=item Use fchown/fchmod internally -=item Integrate new modules +=item Constant folding -=item Integrate profiler +=back -=item Y2K error detection +=item Tests -=item Regular expression debugger +=over 4 -=item POD checker +=item Make Schwern poorer -=item "Dynamic" lexicals +=item test B -=item Cache precompiled modules +=item common test code for timed bailout =back -=item Deprecated Wishes +=item Installation =over 4 -=item Loop control on do{} +=item compressed man pages -=item Lexically scoped typeglobs +=item Make Config.pm cope with differences between build and installed perl -=item format BOTTOM +=item Relocatable perl -=item report HANDLE +=item make HTML install work -=item Generalised want()/caller()) +=item put patchlevel in -v -=item Named prototypes +=back -=item Built-in globbing +=item Incremental things -=item Regression tests for suidperl +=over 4 -=item Cached hash values +=item autovivification -=item Add compression modules +=item fix tainting bugs -=item Reorganise documentation into tutorials/references +=item Make tainting consistent -=item Remove distinction between functions and operators +=item Dual life everything -=item Make XS easier to use +=back -=item Make embedding easier to use +=item Vague things -=item man for perl +=over 4 -=item my $Package::variable +=item threads -=item "or" tests defined, not truth +=item POSIX memory footprint -=item "class"-based lexicals +=item Optimize away @_ -=item byteperl +=item switch ops -=item Lazy evaluation / tail recursion removal +=item Attach/detach debugger from running program -=item Make "use utf8" the default +=item A decent benchmark -=item Unicode collation and normalization +=item readpipe(LIST) -=item pack/unpack tutorial +=item Self ties =back @@ -5508,7 +5329,7 @@ B<-V> =back -=head2 perldelta - what is new for perl v5.9.1 +=head2 perldelta - what is new for perl v5.9.2 =over 4 @@ -5516,68 +5337,24 @@ B<-V> =item Incompatible Changes -=over 4 - -=item substr() lvalues are no longer fixed-length - -=item The C<:unique> attribute is only meaningful for globals - -=back - =item Core Enhancements -=over 4 - -=item Lexical C<$_> - -=item Tied hashes in scalar context - -=item Formats - -=item Stacked filetest operators - -=back - =item Modules and Pragmata -Benchmark, Carp, Exporter, FindBin, List::Util, threads::shared - =item Utility Changes =item Documentation =item Performance Enhancements -=item Selected Bug Fixes - -=over 4 - -=item UTF-8 bugs - -=item Threading bugs - -=item More bugs +=item Installation and Configuration Improvements -=back +=item Selected Bug Fixes =item New or Changed Diagnostics =item Changed Internals -=over 4 - -=item Reordering of SVt_* constants - -=item Removal of CPP symbols - -=item Less space is used by ops - -=item New parser - -=back - -=item Configuration and Building - =item Known Problems =over 4 @@ -5586,8 +5363,6 @@ Benchmark, Carp, Exporter, FindBin, List::Util, threads::shared =back -=item To-do for perl 5.10.0 - =item Reporting Bugs =item SEE ALSO @@ -5881,6 +5656,134 @@ Win32::GetOSVersion =back +=head2 perl586delta - what is new for perl v5.8.6 + +=over 4 + +=item DESCRIPTION + +=item Incompatible Changes + +=item Core Enhancements + +=item Modules and Pragmata + +=item Utility Changes + +=item Performance Enhancements + +=item Selected Bug Fixes + +=item New or Changed Diagnostics + +=item Changed Internals + +=item New Tests + +=item Reporting Bugs + +=item SEE ALSO + +=back + +=head2 perl585delta - what is new for perl v5.8.5 + +=over 4 + +=item DESCRIPTION + +=item Incompatible Changes + +=item Core Enhancements + +=item Modules and Pragmata + +=item Utility Changes + +=over 4 + +=item Perl's debugger + +=item h2ph + +=back + +=item Installation and Configuration Improvements + +=item Selected Bug Fixes + +=item New or Changed Diagnostics + +=item Changed Internals + +=item Known Problems + +=item Platform Specific Problems + +=item Reporting Bugs + +=item SEE ALSO + +=back + +=head2 perl584delta - what is new for perl v5.8.4 + +=over 4 + +=item DESCRIPTION + +=item Incompatible Changes + +=item Core Enhancements + +=over 4 + +=item Malloc wrapping + +=item Unicode Character Database 4.0.1 + +=item suidperl less insecure + +=item format + +=back + +=item Modules and Pragmata + +=over 4 + +=item Updated modules + +Attribute::Handlers, B, Benchmark, CGI, Carp, Cwd, Exporter, File::Find, +IO, IPC::Open3, Local::Maketext, Math::BigFloat, Math::BigInt, +Math::BigRat, MIME::Base64, ODBM_File, POSIX, Shell, Socket, Storable, +Switch, Sys::Syslog, Term::ANSIColor, Time::HiRes, Unicode::UCD, Win32, +base, open, threads, utf8 + +=back + +=item Performance Enhancements + +=item Utility Changes + +=item Installation and Configuration Improvements + +=item Selected Bug Fixes + +=item New or Changed Diagnostics + +=item Changed Internals + +=item Future Directions + +=item Platform Specific Problems + +=item Reporting Bugs + +=item SEE ALSO + +=back + =head2 perl583delta - what is new for perl v5.8.3 =over 4 @@ -8028,26 +7931,30 @@ B, B =back -=head2 perlbeos, README.beos - Perl version 5 on BeOS +=head2 perlbeos, README.beos - Perl version 5.8+ on BeOS =over 4 =item DESCRIPTION -=over 4 +=item BUILD AND INSTALL -=item General Issues with Perl on BeOS +=over 4 -=item BeOS Release-specific Notes +=item Requirements -R4 x86, R4 PPC +=item Configure -=item Contact Information +=item Build -=item Update 2002-05-30 +=item Install =back +=item KNOWN PROBLEMS + +=item CONTACT + =back =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000. @@ -8351,18 +8258,18 @@ DJGPP, Pthreads =item PA-RISC +=item Portability Between PA-RISC Versions + =item PA-RISC 1.0 =item PA-RISC 1.1 =item PA-RISC 2.0 -=item Itanium - -=item Portability Between PA-RISC Versions - =item Itanium Processor Family and HP-UX +=item Itanium & Itanium 2 + =item Building Dynamic Extensions on HP-UX =item The HP ANSI C Compiler @@ -9303,8 +9210,9 @@ LIST, waitpid PID,FLAGS =item Setting Up Perl on Win32 -Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform -SDK 64-bit Compiler, MinGW32 with gcc, MinGW release 1 +Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Visual +C++ Toolkit 2003, Microsoft Platform SDK 64-bit Compiler, MinGW release 3 +with gcc, MinGW release 1 with gcc =item Building @@ -9320,7 +9228,7 @@ Extensions, Notes on 64-bit Windows =item Running Perl Scripts -Miscellaneous Things +=item Miscellaneous Things =back @@ -9521,6 +9429,10 @@ FETCH_I_ATTRIBUTES, MODIFY_I_ATTRIBUTES =item DESCRIPTION +=item DIAGNOSTICS + +Base class package "%s" is empty + =item HISTORY =item CAVEATS @@ -9539,19 +9451,19 @@ FETCH_I_ATTRIBUTES, MODIFY_I_ATTRIBUTES =over 4 -=item OPTIONS +=item Options a or accuracy, p or precision, t or trace, l or lib, v or version -=item MATH LIBRARY +=item Math Library -=item INTERNAL FORMAT +=item Internal Format -=item SIGN +=item Sign -=item METHODS +=item Methods -=item CAVEAT +=item Caveat =back @@ -9577,13 +9489,13 @@ a or accuracy, p or precision, t or trace, l or lib, v or version =over 4 -=item OPTIONS +=item Options a or accuracy, p or precision, t or trace, l or lib, v or version -=item METHODS +=item Methods -=item CAVEAT +=item Caveat inf(), NaN(), upgrade() @@ -9617,15 +9529,19 @@ inf(), NaN(), upgrade() =over 4 -=item MODULES USED +=item Modules Used -=item MATH LIBRARY +=item Math Library -=item SIGN +=item Sign -=item METHODS +=item Methods -=item CAVEAT +=item Cavaet + +=item Options + +a or accuracy, p or precision, t or trace, l or lib, v or version =back @@ -9820,6 +9736,12 @@ Legend of characters above literals in regex that are longer than 127 bytes, EBCDIC, format +=over 4 + +=item The Logic of :locale + +=back + =item HISTORY =item SEE ALSO @@ -10207,8 +10129,8 @@ Numeric Versions, Quoted Versions =item Object Methods -New Operator, qv(), Stringification, Numification, Comparison operators, -Logical Operators +New Operator, qv(), Normal Form, Numification, Stringification, Comparison +operators, Logical Operators =item Quoting @@ -10486,7 +10408,8 @@ FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY =item B::OP Methods -next, sibling, name, ppaddr, desc, targ, type, seq, flags, private +next, sibling, name, ppaddr, desc, targ, type, opt, static, flags, private, +spare =item B::UNOP METHOD @@ -10675,32 +10598,84 @@ B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On> =item OPTIONS -B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>, -B<-main>, B<-base>I, B<-bigendian>, B<-littleendian>, B<-concise>, -B<-terse>, B<-linenoise>, B<-debug>, B<-env> +=over 4 + +=item Options for Opcode Ordering + +B<-basic>, B<-exec>, B<-tree> + +=item Options for Line-Style + +B<-concise>, B<-terse>, B<-linenoise>, B<-debug>, B<-env> + +=item Options for tree-specific formatting + +B<-compact>, B<-loose>, B<-vt>, B<-ascii> + +=item Options controlling sequence numbering + +B<-base>I, B<-bigendian>, B<-littleendian> + +=item Other options + +B<-main>, B<-nomain>, B<-nobanner>, B<-banner>, B<-banneris> => subref + +=item Option Stickiness + +=back + +=item ABBREVIATIONS + +=over 4 + +=item OP class abbreviations + +=item OP flags abbreviations + +=back =item FORMATTING SPECIFICATIONS +=over 4 + +=item Special Patterns + B<(x(>IB<;>IB<)x)>, B<(*(>IB<)*)>, B<(*(>IB<;>IB<)*)>, B<(?(>IB<#>IIB<)?)>, -B<#>I, B<#>II, B<~>, B<#addr>, B<#arg>, B<#class>, +B<~> + +=item # Variables + +B<#>I, B<#>II, B<#>I, B<#addr>, B<#arg>, B<#class>, B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>, B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>, B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>, -B<#seq>, B<#opt>, B<#static>, B<#sibaddr>, B<#svaddr>, B<#svclass>, -B<#svval>, B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum> +B<#seq>, B<#seqnum>, B<#opt>, B<#static>, B<#sibaddr>, B<#svaddr>, +B<#svclass>, B<#svval>, B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum> -=item ABBREVIATIONS +=back + +=item Using B::Concise outside of the O framework =over 4 -=item OP flags abbreviations +=item Example: Altering Concise Renderings -=item OP class abbreviations +=item set_style() -=back +=item set_style_standard($name) -=item Using B::Concise outside of the O framework +=item add_style() + +=item add_callback() + +=item Running B::Concise::compile() + +=item B::Concise::reset_sequence() + +=item Errors + +=back =item AUTHOR @@ -10817,6 +10792,18 @@ B<-u Package> =item DESCRIPTION +=item EXAMPLES + +=over 4 + +=item OPTIONS + +=back + +=item SEE ALSO + +=item TODO + =item AUTHOR =back @@ -11564,6 +11551,30 @@ module =back +=back + +=over 4 + +=item GLOBAL VARIABLES + +=over 4 + +=item $Carp::CarpLevel + +=item $Carp::MaxEvalLen + +=item $Carp::MaxArgLen + +=item $Carp::MaxArgNums + +=item $Carp::Verbose + +=back + +=back + +=over 4 + =item BUGS =back @@ -11745,21 +11756,22 @@ C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, +C, C, C, C, C, +C, C, C =item e @@ -11919,12 +11931,12 @@ C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, C, +C, C, C =item v @@ -11954,6 +11966,18 @@ C, C =back +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +dynamic, nonxs, static + +=item AUTHOR + +=back + =head2 Cwd - get pathname of current working directory =over 4 @@ -11966,7 +11990,7 @@ C, C =item getcwd and friends -getcwd, cwd, fastcwd, fastgetcwd +getcwd, cwd, fastcwd, fastgetcwd, getdcwd =item abs_path and friends @@ -12303,13 +12327,45 @@ Dumper =over 4 +=item Why use ppport.h? + +You should use F in modern code so that your code will work +with the widest range of Perl interpreters possible, without significant +additional work. + +=item How to use ppport.h + +=item Running ppport.h + +=back + +=item FUNCTIONS + +=over 4 + =item WriteFile =back -=item ppport.h +=item COMPATIBILITY -=item AUTHOR +=over 4 + +=item Provided Perl compatibility API + +=item Perl API not supported by ppport.h + +perl 5.9.2, perl 5.9.1, perl 5.9.0, perl 5.8.3, perl 5.8.1, perl 5.8.0, +perl 5.7.3, perl 5.7.2, perl 5.7.1, perl 5.6.1, perl 5.6.0, perl 5.005_03, +perl 5.005, perl 5.004_05, perl 5.004_04, perl 5.004 + +=back + +=item BUGS + +=item AUTHORS + +=item COPYRIGHT =item SEE ALSO @@ -12567,11 +12623,11 @@ CHECK]); =item Handling Malformed Data -I = Encode::FB_DEFAULT ( == 0), I = Encode::FB_CROAK ( == 1), -I = Encode::FB_QUIET, I = Encode::FB_WARN, perlqq mode -(I = Encode::FB_PERLQQ), HTML charref mode (I = -Encode::FB_HTMLCREF), XML charref mode (I = Encode::FB_XMLCREF), The -bitmask +B Not all encoding suppport this feature, I = +Encode::FB_DEFAULT ( == 0), I = Encode::FB_CROAK ( == 1), I = +Encode::FB_QUIET, I = Encode::FB_WARN, perlqq mode (I = +Encode::FB_PERLQQ), HTML charref mode (I = Encode::FB_HTMLCREF), XML +charref mode (I = Encode::FB_XMLCREF), The bitmask =over 4 @@ -12687,7 +12743,8 @@ reference, e.g.: =item Other methods defined in Encode::Encodings --Ename, -Erenew, -Eperlio_ok(), -Eneeds_lines() +-Ename, -Erenew, -Erenewed, -Eperlio_ok(), +-Eneeds_lines() =item Example: Encode::ROT13 @@ -12941,6 +12998,8 @@ BOM as integer when fetched in network byte order =item Surrogate Pairs +=item Error Checking + =item SEE ALSO =back @@ -13008,7 +13067,8 @@ Implementation Base Class =item Other methods defined in Encode::Encodings --Ename, -Erenew, -Eperlio_ok(), -Eneeds_lines() +-Ename, -Erenew, -Erenewed, -Eperlio_ok(), +-Eneeds_lines() =item Example: Encode::ROT13 @@ -13282,6 +13342,12 @@ Legend of characters above literals in regex that are longer than 127 bytes, EBCDIC, format +=over 4 + +=item The Logic of :locale + +=back + =item HISTORY =item SEE ALSO @@ -13674,6 +13740,8 @@ installvars os_flavor_is +dir_target B + blibdirs_target (o) =over 4 @@ -13806,8 +13874,7 @@ B =back -=head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in -ExtUtils::MakeMaker +=head2 ExtUtils::MM_MacOS - once produced Makefiles for MacOS Classic =over 4 @@ -13817,46 +13884,6 @@ ExtUtils::MakeMaker =back -maybe_command - -guess_name - -macify - -patternify - -init_main - -init_others - -init_platform, platform_constants - -init_dirscan - -init_VERSION (o) - -special_targets (o) - -static (o) - -dlsyms (o) - -dynamic (o) - -clean (o) - -clean_subdirs_target - -realclean (o) - -realclean_subdirs_target - -rulez (o) - -processPL (o) - -os_flavor - =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in ExtUtils::MakeMaker @@ -13963,8 +13990,6 @@ constants (o) depend (o) -dir_target B - init_DEST init_dist @@ -14278,8 +14303,6 @@ fixpath os_flavor -blibdirs_target (override) - =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in ExtUtils::MakeMaker @@ -14899,7 +14922,7 @@ splitdir, catpath(), abs2rel, rel2abs() =item SEE ALSO -=item AUTHORS +=item AUTHOR =back @@ -15304,8 +15327,6 @@ cacheout EXPR, cacheout MODE, EXPR =item BUGS -=item NOTES - =back =head2 FileHandle - supply object methods for filehandles @@ -15641,6 +15662,9 @@ the function alternate_language_tags($lang1) the function @langs = panic_languages(@accept_languages) +the function implicate_supers( ...languages... ), the function +implicate_supers_strictly( ...languages... ) + =over 4 =item ABOUT LOWERCASING @@ -15655,6 +15679,26 @@ the function @langs = panic_languages(@accept_languages) =back +=head2 I18N::LangTags::Detect - detect the user's language preferences + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item FUNCTIONS + +=item ENVIRONMENT + +=item SEE ALSO + +=item COPYRIGHT + +=item AUTHOR + +=back + =head2 I18N::LangTags::List -- tags and names for human languages =over 4 @@ -15870,7 +15914,8 @@ new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile =item METHODS -open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ) +open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( +[LAYER] ) =item SEE ALSO @@ -16108,7 +16153,8 @@ new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile =item METHODS -open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ) +open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( +[LAYER] ) =item SEE ALSO @@ -16808,7 +16854,8 @@ of quoted-printable strings =item DESCRIPTION -encode_qp($str), encode_qp($str, $eol), decode_qp($str); +encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode), +decode_qp($str); =item COPYRIGHT @@ -16825,7 +16872,8 @@ strings =item DESCRIPTION -encode_qp($str), encode_qp($str, $eol), decode_qp($str); +encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode), +decode_qp($str); =item COPYRIGHT @@ -16922,8 +16970,8 @@ Input, Output =item is_pos()/is_neg() - $x->is_pos(); # true if >= 0 - $x->is_neg(); # true if < 0 + $x->is_pos(); # true if > 0 + $x->is_neg(); # true if < 0 =item is_odd()/is_even()/is_int() @@ -17030,6 +17078,10 @@ Remarks =back +=item Infinity and Not a Number + +oct()/hex(), log(-inf), exp(), cos(), sin(), atan2() + =item INTERNALS =over 4 @@ -17125,6 +17177,16 @@ the same terms as Perl itself. =item METHODS +=over 4 + +=item __emu_bxor + +=item __emu_band + +=item __emu_bior + +=back + =item LICENSE This program is free software; you may redistribute it and/or modify it @@ -17137,7 +17199,7 @@ the same terms as Perl itself. =back -=head2 Math::BigRat - arbitrarily big rational numbers +=head2 Math::BigRat - Arbitrary big rational numbers =over 4 @@ -17165,7 +17227,11 @@ the same terms as Perl itself. =item parts() -=item as_number() +=item as_int() + +=item as_hex() + +=item as_bin() =item bfac() @@ -17179,9 +17245,9 @@ the same terms as Perl itself. =item is_zero() -=item is_positive() +=item is_pos() -=item is_negative() +=item is_neg() =item is_int() @@ -17554,23 +17620,23 @@ hostfqdn (), hostname (), hostdomain () =item CONSTRUCTOR -new (HOST [,OPTIONS]) +new ([ HOST ] [, OPTIONS ]) =item METHODS login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]), 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 () +RECURSE ]), mkdir ( DIR [, RECURSE ]), alloc ( SIZE [, RECORD_SIZE] ), ls ( +[ DIR ] ), 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 @@ -17663,14 +17729,15 @@ MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C =item CONSTRUCTOR -new ( [ HOST, ] [ OPTIONS ] ) +new ( [ HOST ] [, OPTIONS ] 0 =item METHODS -user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [, -PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM -[, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [ -MSGNUM ] ), delete ( MSGNUM ), reset (), quit () +auth ( USERNAME, PASSWORD ), user ( USER ), pass ( PASS ), login ( [ USER +[, PASS ]] ), apop ( [ USER [, PASS ]] ), banner (), capa (), capabilities +(), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM [, FH ] +), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [ MSGNUM ] +), delete ( MSGNUM ), reset (), quit () =item NOTES @@ -17727,17 +17794,17 @@ $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack( =item CONSTRUCTOR -new Net::SMTP [ HOST, ] [ OPTIONS ] +new ( [ HOST ] [, OPTIONS ] ) =item METHODS -banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME, -PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail ( -ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [, -ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc ( -ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [ -DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ), -quit () +banner (), domain (), hello ( DOMAIN ), host (), etrn ( DOMAIN ), auth ( +USERNAME, PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), +send_or_mail ( ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( +ADDRESS [, ADDRESS, [...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] +), cc ( ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), +data ( [ DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ +$subject ] ), quit () =item ADDRESSES @@ -19755,10 +19822,16 @@ set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF =over 4 -=item OBJECT ORIENTED SYNTAX +=item Caveats + +=item Escaping Magic Characters + +=item Configuration =back +=item BUGS + =item AUTHOR =back @@ -20097,6 +20170,8 @@ NORMAL TESTS, SKIPPED TESTS, TODO TESTS =item BUGS and CAVEATS +=item ENVIRONMENT + =item NOTE =item SEE ALSO @@ -20123,6 +20198,8 @@ B =back +B + =over 4 =item Setting up tests @@ -20189,6 +20266,8 @@ B B<_print> +B<_print_diag> + B, B, B =over 4 @@ -20215,6 +20294,8 @@ B<_my_exit> =over 4 +=item EXIT CODES + =item THREADS =item EXAMPLES @@ -20600,12 +20681,11 @@ B =over 4 -=item NOTES +=item EXIT CODES -=item BUGS and CAVEATS +=item CAVEATS and NOTES -Making your own ok(), The eq_* family has some caveats, Test::Harness -upgrades +Backwards compatibility, Overloaded objects, Threads, Test::Harness upgrade =item HISTORY @@ -20613,6 +20693,8 @@ upgrades =item AUTHORS +=item BUGS + =item COPYRIGHT =back @@ -21159,6 +21241,8 @@ $which ) =item Ambiguous Local Times (DST) +=item Non-Existent Local Times (DST) + =item Negative Epoch Values =back @@ -21475,39 +21559,6 @@ March 18th, 2000 =back -=head2 Win32 - Interfaces to some Win32 API Functions - -=over 4 - -=item DESCRIPTION - -=over 4 - -=item Alphabetical Listing of Win32 Functions - -Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(), -Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(), -Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE), -Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(), -Win32::GetChipName(), Win32::GetCwd(), 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::InitiateSystemShutdown, -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) - -=back - -=back - =head2 XSLoader - Dynamically load C libraries into Perl code =over 4