X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperltoc.pod;h=2c00af49ee9c8c415140abb7109af70eb722ab1f;hb=574bacfe464e67c186e160f356e339f5a9faa3e8;hp=7d0610843c5263009118361031de58442be1652c;hpb=afd1eb533c8ea286efcac6fd054ae7cebaf0dfe3;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perltoc.pod b/pod/perltoc.pod index 7d06108..2c00af4 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -1918,6 +1918,8 @@ localization) =item The localeconv function +=item I18N::Langinfo + =back =item LOCALE CATEGORIES @@ -2196,8 +2198,7 @@ chcp, dataset access, OS/390, z/OS iconv, locales attributes, attrs, autouse, base, blib, bytes, charnames, constant, diagnostics, fields, filetest, integer, less, locale, open, ops, overload, -re, sigtrap, strict, subs, unicode::distinct, utf8, vars, warnings, -warnings::register +re, sigtrap, strict, subs, utf8, vars, warnings, warnings::register =item Standard Modules @@ -2223,13 +2224,14 @@ Filter::Simple, FindBin, Getopt::Long, Getopt::Std, I18N::Collate, I18N::LangTags, I18N::LangTags::List, IO, IPC::Open2, IPC::Open3, Locale::Constants, Locale::Country, Locale::Currency, Locale::Language, Locale::Maketext, Locale::Maketext::TPJ13, Math::BigFloat, Math::BigInt, -Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire, -Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File, -Memoize::SDBM_File, Memoize::Saves, 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, Pod::Checker, Pod::Find, Pod::Html, Pod::InputObjects, Pod::LaTeX, +Math::BigInt::Calc, Math::Complex, Math::Trig, Memoize, +Memoize::AnyDBM_File, Memoize::Expire, Memoize::ExpireFile, +Memoize::ExpireTest, Memoize::NDBM_File, Memoize::SDBM_File, +Memoize::Saves, 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, +Pod::Checker, Pod::Find, Pod::Html, Pod::InputObjects, Pod::LaTeX, Pod::Man, Pod::ParseUtils, Pod::Parser, Pod::Plainer, Pod::Select, Pod::Text, Pod::Text::Color, Pod::Text::Overstrike, Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe, Search::Dict, SelectSaver, SelfLoader, Shell, @@ -2239,8 +2241,8 @@ Test::Simple, Text::Abbrev, Text::Balanced, Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Thread, Thread::Queue, Thread::Semaphore, Thread::Signal, Thread::Specific, Tie::Array, Tie::Handle, Tie::Hash, Tie::RefHash, Tie::Scalar, Tie::SubstrHash, -Time::Local, Time::gmtime, Time::localtime, Time::tm, UNIVERSAL, -Unicode::UCD, User::grent, User::pwent, Win32 +Time::Local, Time::gmtime, Time::localtime, Time::tm, UNIVERSAL, UnicodeCD, +User::grent, User::pwent, Win32 =item Extension Modules @@ -3646,6 +3648,8 @@ save_hptr(HV **hptr)> =item Compile pass 3: peephole optimization +=item Pluggable runops + =back =item Examining internal data structures with the C functions @@ -3906,7 +3910,7 @@ hv_store_ent, hv_undef, isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, is_utf8_char, is_utf8_string, items, ix, LEAVE, load_module, looks_like_number, MARK, mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set, Move, New, newAV, Newc, newCONSTSUB, newHV, -newRV_inc, newRV_noinc, newSV, NEWSV, newSViv, newSVnv, newSVpv, newSVpvf, +newRV_inc, newRV_noinc, NEWSV, newSV, newSViv, newSVnv, newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv, newXS, newXSproto, Newz, Nullav, Nullch, Nullcv, Nullhv, Nullsv, ORIGMARK, perl_alloc, perl_clone, perl_construct, perl_destruct, perl_free, perl_parse, perl_run, @@ -3916,15 +3920,15 @@ PUTBACK, Renew, Renewc, require_pv, RETVAL, Safefree, savepv, savepvn, SAVETMPS, SP, SPAGAIN, ST, strEQ, strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, StructCopy, SvCUR, SvCUR_set, SvEND, SvGETMAGIC, SvGROW, SvIOK, SvIOKp, SvIOK_notUV, SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, -SvIOK_UV, SvIV, SvIVX, SvIVx, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, +SvIOK_UV, 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, SvPV_nolen, SvREFCNT, +SvPVx, SvPVX, SvPV_force, SvPV_force_nomg, SvPV_nolen, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal, SvSetSV, SvSetSV_nosteal, SvSTASH, -SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, svtype, SvTYPE, +SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, SvUOK, SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, SvUVx, sv_2bool, sv_2cv, sv_2io, sv_2iv, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen, @@ -4453,9 +4457,16 @@ work?, Patches speak louder than words =item Keeping in sync rsync'ing the source tree, Using rsync over the LAN, Using pushing over the -NFS, rsync'ing the patches, It's easier, It's more recent, It's more -reliable, It's easier, It's a good reference, Finding a start point, -Finding how to fix a bug, Finding the source of misbehaviour +NFS, rsync'ing the patches + +=item Why rsync the source tree + +It's easier to rsync the source tree, It's more recent, It's more reliable + +=item Why rsync the patches + +It's easier to rsync the patches, It's a good reference, Finding a start +point, Finding how to fix a bug, Finding the source of misbehaviour =item Submitting patches @@ -4464,7 +4475,7 @@ F, The perl5-porters FAQ =item Finding Your Way Around -Core modules, Documentation, Configure, Interpreter +Core modules, Tests, Documentation, Configure, Interpreter =item Elements of the interpreter @@ -4491,6 +4502,13 @@ finish, 'enter', print =item Patching +=item Patching a core module + +=item Writing a test + +F, F, F, F, F, F, +F, F + =back =item EXTERNAL TOOLS FOR DEBUGGING PERL @@ -4511,10 +4529,14 @@ DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug =item PERL_DESTRUCT_LEVEL +=item Profiling + =item Gprof Profiling -a, -b, -e routine, -f routine, -s, -z +=item GCC gcov Profiling + =item Pixie Profiling -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage, @@ -4574,7 +4596,7 @@ I =back -=head2 perl572delta, perl571delta - what's new for perl v5.7.2 +=head2 perl572delta - what's new for perl v5.7.2 =over 4 @@ -4676,12 +4698,12 @@ I =item UNICOS -=item UNICOS/mk ext/IPC/SysV/t/sem test 8 - =item UTS =item VMS +=item Win32 + =item Localising a Tied Variable Leaks Memory =item Self-tying of Arrays and Hashes Is Forbidden @@ -5696,9 +5718,7 @@ long, Process terminated by SIG%s =item 64-bit Perl -=item GDBM and Threads - -=item NFS filesystems and utime(2) +=item AIX 4.2 and extensions using C++ with statics =back @@ -5844,6 +5864,28 @@ R4 x86, R4 PPC =back +=over 4 + +=item Name + +=item Description + +=item Build + +=over 4 + +=item Tools & SDK + +=item Make + +=back + +=item Acknowledgements + +=item Author + +=back + =head2 perlcygwin, README.cygwin - Perl for Cygwin =over 4 @@ -5961,6 +6003,50 @@ Source, Compiled Module Source, Perl Modules/Scripts =back +=head2 perldos - Perl under DOS, W31, W95. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Prerequisites for Compiling Perl on DOS + +DJGPP, Pthreads + +=item Shortcomings of Perl under DOS + +=item Building Perl on DOS + +=item Testing Perl on DOS + +=item Installation of Perl on DOS + +=back + +=item BUILDING AND INSTALLING MODULES ON DOS + +=over 4 + +=item Building Prerequisites for Perl on DOS + +=item Unpacking CPAN Modules on DOS + +=item Building Non-XS Modules on DOS + +=item Building XS Modules on DOS + +=back + +=item AUTHOR + +=item SEE ALSO + +=back + =head2 perlepoc, README.epoc - Perl for EPOC =over 4 @@ -6184,7 +6270,7 @@ Buildtype.bat, SetNWBld.bat, MPKBuild.bat =item Acknowledgements -=item Author +=item Authors =item Date @@ -6501,16 +6587,18 @@ C, F =over 4 -=item Required Software for Compiling Perl on QNX +=item Required Software for Compiling Perl on QNX4 /bin/sh, ar, nm, cpp, make -=item Outstanding Issues with Perl on QNX +=item Outstanding Issues with Perl on QNX4 =item QNX auxiliary files qnx/ar, qnx/cpp +=item Outstanding issues with perl under QNX6 + =back =item AUTHOR @@ -6666,6 +6754,22 @@ Digital UNIX formerly known as DEC OSF/1) systems =back +=head2 perluts - Perl under UTS + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item BUILDING PERL ON UTS + +=item Installing the built perl on UTS + +=item AUTHOR + +=back + =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA. =over 4 @@ -6813,6 +6917,48 @@ LIST, waitpid PID,FLAGS =back +=head2 perlwin32 - Perl under Win32 + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Setting Up Perl on Win32 + +Make, Command Shell, Borland C++, Microsoft Visual C++, Mingw32 with GCC + +=item Building + +=item Testing Perl on Win32 + +=item Installation of Perl on Win32 + +=item Usage Hints for Perl on Win32 + +Environment Variables, File Globbing, Using perl from the command line, +Building Extensions, Command-line Wildcard Expansion, Win32 Specific +Extensions, Running Perl Scripts, Miscellaneous Things + +=back + +=item BUGS AND CAVEATS + +=item AUTHORS + +Gary Ng E71564.1743@CompuServe.COME, Gurusamy Sarathy +Egsar@activestate.comE, Nick Ing-Simmons +Enick@ing-simmons.netE + +=item SEE ALSO + +=item HISTORY + +=back + =head1 PRAGMA DOCUMENTATION =head2 attrs - set/get attributes of a subroutine (deprecated) @@ -7287,19 +7433,6 @@ C, C, C =back -=head2 unicode::distinct - Perl pragma to strictly distinguish UTF8 data -and non-UTF data. - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=item SEE ALSO - -=back - =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source code @@ -8734,32 +8867,32 @@ 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, 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, @@ -8774,7 +8907,7 @@ C, C =item e C, C, C, C, C, C, -C, C, C +C, C, C, C =item f @@ -8913,7 +9046,8 @@ 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 x @@ -8941,6 +9075,8 @@ C, C =item DESCRIPTION +=item NOTES + =back =head2 DB - programmatic interface to the Perl debugging API (draft, @@ -11333,6 +11469,28 @@ Zhuang, {zu} : Zulu, {zun} : Zuni =back +=head2 I18N::Langinfo - query locale information + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item EXPORT + +=back + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT AND LICENSE + +=back + =head2 IO - load various IO modules =over 4 @@ -12399,22 +12557,64 @@ stringify, bstr(), bdiv, Modifying and =, bpow Canonical notation, Input, Output +=item ACCURACY and PRECISION + =over 4 -=item Rounding +=item Precision P -bfround ( +$scale ), bround ( +$scale ), bround ( -$scale ) +=item Accuracy A -=item Internals +=item Fallback F + +=item Rounding mode R + +'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy +(significant digits), Setting/Accessing, Creating numbers, Usage, +Precedence, Overriding globals, Local settings, Rounding, Default values, +Remarks + +=back + +=item INTERNALS + +=over 4 =item mantissa(), exponent() and parts() =back +=item EXAMPLES + + use Math::BigInt qw(bstr bint); + $x = bstr("1234") # string "1234" + $x = "$x"; # same as bstr() + $x = bneg("1234") # Bigint "-1234" + $x = Math::BigInt->bneg("1234"); # Bigint "-1234" + $x = Math::BigInt->babs("-12345"); # Bigint "12345" + $x = Math::BigInt->bnorm("-0 00"); # BigInt "0" + $x = bint(1) + bint(2); # BigInt "3" + $x = bint(1) + "2"; # ditto (auto-BigIntify of "2") + $x = bint(1); # BigInt "1" + $x = $x + 5 / 2; # BigInt "3" + $x = $x ** 3; # BigInt "27" + $x *= 2; # BigInt "54" + $x = new Math::BigInt; # BigInt "0" + $x--; # BigInt "-1" + $x = Math::BigInt->badd(4,5) # BigInt "9" + $x = Math::BigInt::badd(4,5) # BigInt "9" + print $x->bsstr(); # 9e+0 + =item Autocreating constants =item PERFORMANCE +=over 4 + +=item Replacing the math library + +=back + =item BUGS :constant and eval() @@ -12426,10 +12626,34 @@ Overloading -$x, Mixing different object types, bsqrt() =item LICENSE +=item SEE ALSO + =item AUTHORS =back +=head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item EXPORT + +=item LICENSE + +This program is free software; you may redistribute it and/or modify it +under +the same terms as Perl itself. + +=item AUTHORS + +=item SEE ALSO + +=back + =head2 Math::Complex - complex numbers and associated mathematical functions @@ -13987,9 +14211,8 @@ release, section =item DIAGNOSTICS roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote -specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape -EE%sE, Unknown sequence %s, %s: Unknown command paragraph "%s" on -line %d, Unmatched =back +specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown +escape EE%sE, %s:%d: Unknown sequence %s, %s:%d: Unmatched =back =item BUGS @@ -13997,6 +14220,8 @@ line %d, Unmatched =back =item AUTHOR +=item COPYRIGHT AND LICENSE + =back =head2 Pod::ParseUtils - helpers for POD parsing and conversion @@ -14493,6 +14718,8 @@ specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape: =item AUTHOR +=item COPYRIGHT AND LICENSE + =back =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text @@ -14509,6 +14736,8 @@ specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape: =item AUTHOR +=item COPYRIGHT AND LICENSE + =back =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike @@ -14526,6 +14755,8 @@ text =item AUTHOR +=item COPYRIGHT AND LICENSE + =back =head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII @@ -14541,6 +14772,8 @@ text with format escapes =item AUTHOR +=item COPYRIGHT AND LICENSE + =back =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod @@ -14800,6 +15033,8 @@ C =item Automating fall-through +=item Alternative syntax + =item Higher-order Operations =back @@ -14888,16 +15123,24 @@ closelog =item DIAGNOSTICS -Invalid attribute name %s, Name "%s" used only once: possible typo, No -comma allowed after filehandle, Bareword "%s" not allowed while "strict -subs" in use +Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in +use, Invalid attribute name %s, Name "%s" used only once: possible typo, No +comma allowed after filehandle, No name for escape sequence %s + +=item ENVIRONMENT + +ANSI_COLORS_DISABLED =item RESTRICTIONS =item NOTES +=item SEE ALSO + =item AUTHORS +=item LICENSE + =back =head2 Term::Cap - Perl termcap interface @@ -15667,7 +15910,7 @@ VAL, TYPE ), UNIVERSAL::can ( VAL, METHOD ) =back -=head2 Unicode::UCD - Unicode character database +=head2 UnicodeCD - Unicode character database =over 4 @@ -15713,13 +15956,33 @@ VAL, TYPE ), UNIVERSAL::can ( VAL, METHOD ) =item Matching Scripts and Blocks +=item Code Point Arguments + =item charinrange =back =over 4 -=item Unicode::UCD::UnicodeVersion +=item compexcl + +=back + +=over 4 + +=item casefold + +=back + +=over 4 + +=item casespec + +=back + +=over 4 + +=item UnicodeCD::UnicodeVersion =back