X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperltoc.pod;h=9b8654edc1192147fa2e7f71800a87193691e98a;hb=231c9faeb17b45588bbde0b49d0d32f25d2a1286;hp=940c3c0132222da55ecd1183585ef804b59518e3;hpb=fc6a272d740c370b8c0a1a88a6649b9ea7ee4c21;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perltoc.pod b/pod/perltoc.pod index 940c3c0..9b8654e 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -380,14 +380,14 @@ SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY, shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep -EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair -SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST, -sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH, -splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split -/PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, sqrt EXPR, -sqrt, srand EXPR, srand, stat FILEHANDLE, stat EXPR, stat, study SCALAR, -study, sub BLOCK, sub NAME, sub NAME BLOCK, substr -EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr +EXPR, sleep, sockatmark SOCKET, socket SOCKET,DOMAIN,TYPE,PROTOCOL, +socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort +BLOCK LIST, sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice +ARRAY,OFFSET,LENGTH, splice ARRAY,OFFSET, splice ARRAY, split +/PATTERN/,EXPR,LIMIT, split /PATTERN/,EXPR, split /PATTERN/, split, sprintf +FORMAT, LIST, sqrt EXPR, sqrt, srand EXPR, srand, stat FILEHANDLE, stat +EXPR, stat, study SCALAR, study, sub BLOCK, sub NAME, sub NAME BLOCK, +substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek @@ -926,6 +926,8 @@ ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, $ARGV, @ARGV, @INC, @_, %INC, =item DESCRIPTION +=over 4 + =item Declaration and Access of Arrays of Arrays =item Growing Your Own @@ -934,6 +936,8 @@ ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, $ARGV, @ARGV, @INC, @_, %INC, =item Slices +=back + =item SEE ALSO =item AUTHOR @@ -1815,8 +1819,6 @@ http://testers.cpan.org/ =item DOS and Derivatives -Build instructions for OS/2, L - =item S =item VMS @@ -1856,9 +1858,9 @@ select RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP, setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, -shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, socketpair -SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat EXPR, stat, -symlink OLDFILE,NEWFILE, syscall LIST, sysopen +shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET, +socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat +EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST, wait, waitpid PID,FLAGS @@ -1984,7 +1986,7 @@ LC_NUMERIC, LC_TIME, LANG =over 4 -=item Important Caveat +=item Important Caveats Input and Output Disciplines, Regular Expressions, C still needed to enable a few features @@ -3565,14 +3567,15 @@ C, C

, C, C =item Localizing changes C, C, C, C, -C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C, C, C, -C +C, C, C, C, C, C, C, +C, +C, +C, C, C, C, C, +C, C, +C, C, C =back @@ -3622,15 +3625,19 @@ C =item Background and PERL_IMPLICIT_CONTEXT +=item So what happened to dTHR? + =item How do I use all this in extensions? +=item Should I do anything special if I call perl from multiple threads? + =item Future Plans and PERL_IMPLICIT_SYS =back =item Internal Functions -A, p, d, s, n, r, f, m, o, j, x +A, p, d, s, n, r, f, M, o, j, x =over 4 @@ -3860,12 +3867,12 @@ 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_iterval, hv_magic, hv_store, hv_store_ent, hv_undef, isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, is_utf8_char, is_utf8_string, items, -ix, LEAVE, 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, newSViv, newSVnv, newSVpv, newSVpvf, -newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv, newXS, newXSproto, -Newz, Nullav, Nullch, Nullcv, Nullhv, Nullsv, ORIGMARK, perl_alloc, -perl_construct, perl_destruct, perl_free, perl_parse, perl_run, +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, newSViv, newSVnv, +newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv, +newXS, newXSproto, Newz, Nullav, Nullch, Nullcv, Nullhv, Nullsv, ORIGMARK, +perl_alloc, perl_construct, perl_destruct, perl_free, perl_parse, perl_run, PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes, POPi, POPl, POPn, POPp, POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK, Renew, Renewc, require_pv, RETVAL, Safefree, savepv, savepvn, @@ -3877,7 +3884,7 @@ SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVX, SvPV_force, SvPV_nolen, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSETMAGIC, SvSetSV, SvSetSV_nosteal, SvSTASH, SvTAINT, -SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, svtype, SvTYPE, SVt_IV, +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, sv_2mortal, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_mg, sv_catpv_mg, sv_catsv, @@ -3892,12 +3899,12 @@ sv_setref_pvn, sv_setref_uv, sv_setsv, sv_setsv_mg, sv_setuv, sv_setuv_mg, sv_true, sv_unmagic, sv_unref, sv_unref_flags, sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade, sv_vcatpvfn, sv_vsetpvfn, THIS, toLOWER, toUPPER, -utf8_distance, utf8_hop, utf8_length, utf8_to_bytes, utf8_to_uv, -utf8_to_uv_simple, uv_to_utf8, warn, XPUSHi, XPUSHn, XPUSHp, XPUSHs, -XPUSHu, XS, XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO, -XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_YES, XST_mIV, XST_mNO, -XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES, XS_VERSION, XS_VERSION_BOOTCHECK, -Zero +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, +warn, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XS, XSRETURN, XSRETURN_EMPTY, +XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF, +XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES, +XS_VERSION, XS_VERSION_BOOTCHECK, Zero =item AUTHORS @@ -3942,10 +3949,6 @@ data for a particular handle =item Functions and Attributes -1. Opening and setup functions, 2. Basic IO operations, 3. Stdio class -buffering options, 4. Functions to support Perl's traditional "fast" access -to the buffer - =item Per-instance Data =item Layers in action. @@ -3959,23 +3962,20 @@ PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS =item Methods in Detail -IV (*Fileno)(PerlIO *f);, PerlIO * (*Fdopen)(PerlIO_funcs -*tab, int fd, const char *mode);, PerlIO * (*Open)(PerlIO_funcs *tab, -const char *path, const char *mode);, int (*Reopen)(const char -*path, const char *mode, PerlIO *f);, IV (*Pushed)(PerlIO -*f,const char *mode,const char *arg,STRLEN len);, IV -(*Popped)(PerlIO *f);, SSize_t (*Read)(PerlIO *f, void *vbuf, Size_t -count);, SSize_t (*Unread)(PerlIO *f, const void *vbuf, Size_t count);, -SSize_t (*Write)(PerlIO *f, const void *vbuf, Size_t count);, IV - (*Seek)(PerlIO *f, Off_t offset, int whence);, Off_t -(*Tell)(PerlIO *f);, IV (*Close)(PerlIO *f);, IV - (*Flush)(PerlIO *f);, IV (*Fill)(PerlIO *f);, IV - (*Eof)(PerlIO *f);, IV (*Error)(PerlIO *f);, void - (*Clearerr)(PerlIO *f);, void (*Setlinebuf)(PerlIO *f);, -STDCHAR * (*Get_base)(PerlIO *f);, Size_t -(*Get_bufsiz)(PerlIO *f);, STDCHAR * (*Get_ptr)(PerlIO *f);, SSize_t - (*Get_cnt)(PerlIO *f);, void (*Set_ptrcnt)(PerlIO *f,STDCHAR -*ptr,SSize_t cnt); + IV (*Pushed)(PerlIO *f,const char *mode, SV *arg);, IV + (*Popped)(PerlIO *f);, PerlIO * (*Open)(...);, SV * +(*Getarg)(PerlIO *f);, IV (*Fileno)(PerlIO *f);, SSize_t +(*Read)(PerlIO *f, void *vbuf, Size_t count);, SSize_t (*Unread)(PerlIO +*f, const void *vbuf, Size_t count);, SSize_t (*Write)(PerlIO *f, const +void *vbuf, Size_t count);, IV (*Seek)(PerlIO *f, Off_t +offset, int whence);, Off_t (*Tell)(PerlIO *f);, IV + (*Close)(PerlIO *f);, IV (*Flush)(PerlIO *f);, IV + (*Fill)(PerlIO *f);, IV (*Eof)(PerlIO *f);, IV + (*Error)(PerlIO *f);, void (*Clearerr)(PerlIO *f);, void + (*Setlinebuf)(PerlIO *f);, STDCHAR * (*Get_base)(PerlIO *f);, +Size_t (*Get_bufsiz)(PerlIO *f);, STDCHAR * +(*Get_ptr)(PerlIO *f);, SSize_t (*Get_cnt)(PerlIO *f);, void + (*Set_ptrcnt)(PerlIO *f,STDCHAR *ptr,SSize_t cnt); =item Core Layers @@ -3983,7 +3983,7 @@ STDCHAR * (*Get_base)(PerlIO *f);, Size_t =item Extension Layers -"encoding" +":encoding", ":Scalar", ":Object" or ":Perl" =back @@ -4411,6 +4411,14 @@ finish, 'enter', print DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug +=item Compaq's/Digital's Third Degree + +=item PERL_DESTRUCT_LEVEL + +=item Pixie Profiling + +-h, -l, -p, -h, -i, -l, -testcoverage, -zero + =item CONCLUSION I @@ -5053,7 +5061,7 @@ Thread, attrs, fields, re =item Changes in existing modules Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File, -MakeMaker, CPAN, Cwd, Benchmark +MakeMaker, CPAN, Cwd =back @@ -5522,6 +5530,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 + +DJGPP, Pthreads + +=item Shortcomings of Perl under DOS + +=item Building + +=item Testing + +=item Installation + +=back + +=item BUILDING AND INSTALLING MODULES + +=over 4 + +=item Prerequisites + +=item Unpacking CPAN Modules + +=item Building Non-XS Modules + +=item Building XS Modules + +=back + +=item AUTHOR + +=item SEE ALSO + +=back + =head2 perlepoc, README.epoc - Perl for EPOC =over 4 @@ -5632,6 +5684,20 @@ op/lexassign.t, pragma/warnings.t =back +=head2 perlmacos, README.macos - Perl under Mac OS (Classic) + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item AUTHOR + +=item DATE + +=back + =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE =head1 SYNOPSIS @@ -5688,6 +5754,8 @@ EMX, RSX, HPFS, pdksh =over 4 +=item "It does not work" + =item I cannot run external programs =item I cannot embed perl into my program, or use F from my @@ -5746,6 +5814,8 @@ Perl manual in F<.INF> format, Pdksh =over 4 +=item The short story + =item Prerequisites =item Getting perl source @@ -5759,7 +5829,7 @@ Perl manual in F<.INF> format, Pdksh =item Testing A lot of C, Process terminated by SIGTERM/SIGINT, F, -F, F, F, F +F =item Installing the built perl @@ -5806,13 +5876,29 @@ C, C, C, C, C, C, C, C, C, -C +C, +C, C, +OS2::SysInfo(), OS2::BootDrive(), C, +C, C, +C, C, +OS2::get_control87(), C + +=item Prebuilt variables: + +$OS2::emx_rev, $OS2::emx_env, $OS2::os_ver =item Misfeatures =item Modifications -C, C, C, C, C, C +C, C, C, C, C, C, C, +C + +=item Identifying DLLs + +=item Centralized management of resources + +C, C =back @@ -5834,8 +5920,6 @@ C, C, C, C, C, C =item Why chimera build? -explicit fork(), open FH, "|-", open FH, "-|" - =back =item ENVIRONMENT @@ -6032,13 +6116,12 @@ DATAMODEL_NATIVE specified", sh: ar: not found =item Configure -- Don't turn on the compiler optimization flag "-O". There's a bug in -the compiler (APAR PQ18812) that generates some bad code the -optimizer is on, - As VM/ESA doesn't fully support the fork() API programs -relying on this call will not work. I've replaced fork()/exec() with -spawn() and the standalone exec() with spawn(). This has a side -effect when opening unnamed pipes in a shell script: there is no child -process generated under +Don't turn on the compiler optimization flag "-O". There's a bug in the +compiler (APAR PQ18812) that generates some bad code the optimizer is on, +As VM/ESA doesn't fully support the fork() API programs relying on this +call will not work. I've replaced fork()/exec() with spawn() and the +standalone exec() with spawn(). This has a side effect when opening unnamed +pipes in a shell script: there is no child process generated under =item testing anomalies @@ -6175,6 +6258,48 @@ LIST, waitpid PID,FLAGS =back +=head2 perlwin32 - Perl under Win32 + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Setting Up + +Make, Command Shell, Borland C++, Microsoft Visual C++, Mingw32 with GCC + +=item Building + +=item Testing + +=item Installation + +=item Usage Hints + +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) @@ -6404,8 +6529,8 @@ new, phash =back -=head2 integer - Perl pragma to compute arithmetic in integer instead of -double +=head2 integer - Perl pragma to use integer arithmetic instead of floating +point =over 4 @@ -6468,7 +6593,9 @@ operations =item DESCRIPTION -=item UNIMPLEMENTED FUNCTIONALITY +=item NONPERLIO FUNCTIONALITY + +=item IMPLEMENTATION DETAILS =item SEE ALSO @@ -6585,26 +6712,6 @@ type, `%s' is not a code reference =back -=head2 perlio - perl pragma to configure C level IO - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -unix, stdio, perlio - -=over 4 - -=item Defaults and how to override them - -=back - -=item AUTHOR - -=back - =head2 re - Perl pragma to alter regular expression behaviour =over 4 @@ -6688,6 +6795,15 @@ and non-UTF data. =item DESCRIPTION +=over 4 + +=item Utility functions + +$num_octets = utf8::upgrade($string);, utf8::downgrade($string[, CHECK]), +utf8::encode($string), $flag = utf8::decode($string) + +=back + =item SEE ALSO =back @@ -6812,7 +6928,7 @@ REFCNT, FLAGS =item B::IV METHODS -IV, IVX, needs64bits, packiv +IV, IVX, UVX, int_value, needs64bits, packiv =item B::NV METHODS @@ -6824,7 +6940,7 @@ RV =item B::PV METHODS -PV +PV, PVX =item B::PVMG METHODS @@ -6844,8 +6960,8 @@ USEFUL, PREVIOUS, RARE, TABLE =item B::GV METHODS -is_empty, NAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN, LINE, FILE, -FILEGV, GvREFCNT, FLAGS +is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN, +LINE, FILE, FILEGV, GvREFCNT, FLAGS =item B::IO METHODS @@ -6973,8 +7089,7 @@ bytecode B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>, B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>, -B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage> Stores package in the -output. =back +B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage> =item EXAMPLES @@ -7314,8 +7429,7 @@ STYLE ] ), cmpthese ( RESULTSHASHREF ), countit(TIME, CODE), disablecache ( B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>, B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>, -B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage> Stores package in the -output. =back +B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage> =item EXAMPLES @@ -7917,6 +8031,28 @@ module =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside +=head2 Class::ISA -- report the search path for a class's ISA tree + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item FUNCTIONS + +the function Class::ISA::super_path($CLASS), the function +Class::ISA::self_and_super_path($CLASS), the function +Class::ISA::self_and_super_versions($CLASS) + +=item CAUTIONARY NOTES + +=item COPYRIGHT + +=item AUTHOR + +=back + =head2 Class::Struct - declare struct-like datatypes as Perl classes =over 4 @@ -8000,55 +8136,57 @@ C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, C, C, C, C, C, C, C, C, C, @@ -8059,12 +8197,13 @@ C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C +C, C, C, C, C, +C, C, C, 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 @@ -8227,7 +8366,7 @@ C, C =back -=head2 Cwd, getcwd - get pathname of current working directory +=head2 Cwd - get pathname of current working directory =over 4 @@ -8542,6 +8681,55 @@ Dumper =back +=head2 Digest:: - Modules that calculate message digests + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +I, I, I + +=item OO INTERFACE + +$ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx = +Digest::XXX->new($arg,...), $ctx->reset, $ctx->add($data,...), +$ctx->addfile($io_handle), $ctx->digest, $ctx->hexdigest, $ctx->b64digest + +=item SEE ALSO + +=item AUTHOR + +=back + +=head2 Digest::MD5 - Perl interface to the MD5 Algorithm + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item FUNCTIONS + +md5($data,...), md5_hex($data,...), md5_base64($data,...) + +=item METHODS + +$md5 = Digest::MD5->new, $md5->reset, $md5->add($data,...), +$md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest + +=item EXAMPLES + +=item SEE ALSO + +=item COPYRIGHT + +=item AUTHORS + +=back + =head2 DirHandle - supply object methods for directory handles =over 4 @@ -8679,8 +8867,7 @@ strings in binary data, perl/Encode wrappers on non-Unicode XS modules =item Messing with Perl's Internals -utf8_downgrade($string[, CHECK]), is_utf8(STRING [, CHECK]), -valid_utf8(STRING) +is_utf8(STRING [, CHECK]), valid_utf8(STRING) =item IMPLEMENTATION CLASSES @@ -8955,8 +9142,6 @@ canonpath, cflags, manifypods, perl_archive =back -perl_archive_after - =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in ExtUtils::MakeMaker @@ -8966,8 +9151,12 @@ ExtUtils::MakeMaker =item DESCRIPTION +=item METHODS + =back +perl_archive_after + =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker =over 4 @@ -9646,7 +9835,8 @@ C, C =item DESCRIPTION C, C, C, C, C, -C, C, C, C, C +C, C, C, C, C, +C =item DIAGNOSTICS @@ -10096,8 +10286,6 @@ $fh->print, $fh->printf, $fh->getline, $fh->getlines =item SYNOPSIS - use Filter::Util::Call ; - =item DESCRIPTION =over 4 @@ -10126,6 +10314,8 @@ B<$_>, B<$status>, B and B, B =back +=item Filter::Simple + =item AUTHOR =item DATE @@ -10420,6 +10610,8 @@ $io->getpos, $io->setpos, $io->setpos ( POS, WHENCE ), WHENCE=0 (SEEK_SET), WHENCE=1 (SEEK_CUR), WHENCE=1 (SEEK_END), $io->sysseek( POS, WHENCE ), $io->tell +=item SEE ALSO + =item HISTORY =back @@ -10464,8 +10656,8 @@ new ( [ARGS] ) =item METHODS -accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), timeout([VAL]), -sockopt(OPT [, VAL]), sockdomain, socktype, protocol, connected +accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, +protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) =item SEE ALSO @@ -10658,6 +10850,8 @@ $io->getpos, $io->setpos, $io->setpos ( POS, WHENCE ), WHENCE=0 (SEEK_SET), WHENCE=1 (SEEK_CUR), WHENCE=1 (SEEK_END), $io->sysseek( POS, WHENCE ), $io->tell +=item SEE ALSO + =item HISTORY =back @@ -10704,8 +10898,8 @@ new ( [ARGS] ) =item METHODS -accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), timeout([VAL]), -sockopt(OPT [, VAL]), sockdomain, socktype, protocol, connected +accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, +protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) =item SEE ALSO @@ -10906,6 +11100,233 @@ set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N =back +=head2 Locale::Constants - constants for Locale codes + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item KNOWN BUGS AND LIMITATIONS + +=item SEE ALSO + +Locale::Language, Locale::Country, Locale::Currency + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 Locale::Country - ISO codes for country identification (ISO 3166) + +=over 4 + +=item SYNOPSIS + +=back + +=over 4 + +=item DESCRIPTION + +B, B, B + +=back + +=over 4 + +=item CONVERSION ROUTINES + +code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ), +country_code2code( CODE, CODESET, CODESET ) + +=back + +=over 4 + +=item QUERY ROUTINES + +C, C + +=back + +=over 4 + +=item CODE ALIASING + +=back + +=over 4 + +=item EXAMPLES + +=item DOMAIN NAMES + +=item KNOWN BUGS AND LIMITATIONS + +=item SEE ALSO + +Locale::Language, Locale::Currency, ISO 3166, +http://www.din.de/gremien/nas/nabd/iso3166ma/, +http://www.egt.ie/standards/iso3166/iso3166-1-en.html, +http://www.cia.gov/cia/publications/factbook/docs/app-f.html + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 Locale::Currency - ISO three letter codes for currency +identification (ISO 4217) + +=over 4 + +=item SYNOPSIS + +=back + +=over 4 + +=item DESCRIPTION + +XTS, XXX + +=back + +=over 4 + +=item CONVERSION ROUTINES + +code2currency(), currency2code() + +=back + +=over 4 + +=item QUERY ROUTINES + +C, C + +=back + +=over 4 + +=item EXAMPLES + +=item KNOWN BUGS AND LIMITATIONS + +=item SEE ALSO + +Locale::Country, ISO 4217:1995, http://www.bsi-global.com/iso4217currency + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 Locale::Language - ISO two letter codes for language identification +(ISO 639) + +=over 4 + +=item SYNOPSIS + +=back + +=over 4 + +=item DESCRIPTION + +=back + +=over 4 + +=item CONVERSION ROUTINES + +code2language(), language2code() + +=back + +=over 4 + +=item QUERY ROUTINES + +C, C + +=back + +=over 4 + +=item EXAMPLES + +=item KNOWN BUGS AND LIMITATIONS + +=item SEE ALSO + +Locale::Country, Locale::Currency, ISO 639:1988 (E/F), +http://lcweb.loc.gov/standards/iso639-2/langhome.html + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 MIME::Base64 - Encoding and decoding of base64 strings + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +encode_base64($str, [$eol]), decode_base64($str) + +=item DIAGNOSTICS + +Premature end of base64 data, Premature padding of base64 data + +=item EXAMPLES + +=item COPYRIGHT + +=back + +=head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding +of quoted-printable strings + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +encode_qp($str), decode_qp($str); + +=item COPYRIGHT + +=back + +=head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable +strings + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +encode_qp($str), decode_qp($str); + +=item COPYRIGHT + +=back + =head2 Math::BigFloat - Arbitrary length float math package =over 4 @@ -11011,10 +11432,16 @@ cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical =back -=item GREAT CIRCLE DISTANCES +=item GREAT CIRCLE DISTANCES AND DIRECTIONS =item EXAMPLES +=over 4 + +=item CAVEAT FOR GREAT CIRCLE FORMULAS + +=back + =item BUGS =item AUTHORS @@ -11027,6 +11454,8 @@ cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical =item SYNOPSIS +=item DESCRIPTION + C, C, C =item DIAGNOSTICS @@ -11058,8 +11487,6 @@ $timeout]);, $p->close();, pingecho($host [, $timeout]); =back -=item WARNING - =item NOTES =back @@ -11152,6 +11579,8 @@ functions =item SYNOPSIS +=item DESCRIPTION + C, C, C =item DIAGNOSTICS @@ -11387,6 +11816,57 @@ Constants, Macros =back +=head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::* +name space + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +unix, stdio, perlio, crlf, utf8, raw + +=over 4 + +=item Defaults and how to override them + +=back + +=item AUTHOR + +=item SEE ALSO + +=back + +=head2 PerlIO::Scalar - support module for in-memory IO. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=back + +=head2 PerlIO::Via - Helper class for PerlIO layers implemented in perl + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +$class->PUSHED([$mode][,$fh]), $obj->POPPED([$fh]), +$class->OPEN($path,$mode[,$fh]), $class->FDOPEN($fd), +$class->SYSOPEN($path,$imode,$perm,$fh), $obj->FILENO($fh), +$obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh), +$obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh), +$obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh), +$obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh) + +=back + =head2 Pod::Checker, podchecker() - check pod documents for syntax errors =over 4 @@ -11424,18 +11904,16 @@ after =back =item Warnings multiple occurence of link target I, line containing nothing but -whitespace in paragraph, file does not start with =head, No numeric -argument for =over, previous =item has no contents, preceding non-item -paragraph(s), =item type mismatch (I vs. I), I unescaped -CE> in paragraph, Unknown entity, No items in =over, No argument -for =item, empty section in previous paragraph, Verbatim paragraph in NAME -section +whitespace in paragraph, file does not start with =head, previous =item has +no contents, preceding non-item paragraph(s), =item type mismatch (I +vs. I), I unescaped CE> in paragraph, Unknown entity, No +items in =over, No argument for =item, empty section in previous paragraph, +Verbatim paragraph in NAME section =item Hyperlinks -collapsing newlines to blanks, ignoring leading/trailing whitespace in -link, (section) in '$page' deprecated, alternative text/node '%s' contains -non-escaped | or / +ignoring leading/trailing whitespace in link, (section) in '$page' +deprecated, alternative text/node '%s' contains non-escaped | or / =back @@ -12682,6 +13160,38 @@ C =back +=head2 Switch - A switch statement for Perl + +=over 4 + +=item VERSION + +=item SYNOPSIS + +=item BACKGROUND + +=item DESCRIPTION + +=over 4 + +=item Allowing fall-through + +=item Automating fall-through + +=item Higher-order Operations + +=back + +=item DEPENDENCIES + +=item AUTHOR + +=item BUGS + +=item COPYRIGHT + +=back + =head2 Symbol - manipulate Perl symbols and their names =over 4 @@ -12820,9 +13330,11 @@ C, C, C =item ENVIRONMENT +=item CAVEATS + =back -=head2 Test - provides a simple framework for writing test scripts +=head2 Test - provides a simple framework for writing test scripts =over 4 @@ -12856,7 +13368,7 @@ NORMAL TESTS, SKIPPED TESTS, TODO TESTS =item The test script output -B<1..M>, B<'ok', 'not ok'. Ok?>, B, +B<'1..M'>, B<'ok', 'not ok'. Ok?>, B, B<$Test::Harness::verbose>, B<$Test::Harness::switches>, B, B, B, B @@ -12897,6 +13409,75 @@ C =back +=head2 Text::Balanced - Extract delimited text sequences from strings. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item General behaviour in list contexts + +[0], [1], [2] + +=item General behaviour in scalar and void contexts + +=item A note about prefixes + +=item C + +=item C + +=item C + +C $listref>, C $listref>, C $str>, +[0], [1], [2], [3], [4], [5] + +=item C + +=item C + +[0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10] + +=item C and "here documents" + +[0], [1], [2], [3], [4], [5], [6], [7..10] + +=item C + +=item C + +=item C + +=back + +=item DIAGNOSTICS + + C, C, +C, C, C, +C, C, +C, C, C, C, C, C, +C, C, C, C, C, C, C, C + +=item AUTHOR + +=item BUGS AND IRRITATIONS + +=item COPYRIGHT + +=back + =head2 Text::ParseWords - parse text into an array of tokens or array of arrays @@ -13276,6 +13857,24 @@ PID), Win32::UnregisterServer(LIBRARYNAME) =back +=head2 XS::Typemap - module to test the XS typemaps distributed with perl + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=back + +=over 4 + +=item NOTES + +=item AUTHOR + +=back + =head2 XSLoader - Dynamically load C libraries into Perl code =over 4