X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperltoc.pod;h=9b8654edc1192147fa2e7f71800a87193691e98a;hb=231c9faeb17b45588bbde0b49d0d32f25d2a1286;hp=1c7705482005302721761ae88af8235696649dcb;hpb=76d3c696f3f9d8be0bea9b002ddfc255153cfadd;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perltoc.pod b/pod/perltoc.pod index 1c77054..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 @@ -1342,6 +1346,8 @@ C<(?(condition)yes-pattern|no-pattern)> =item DESCRIPTION +=item Class Data in a Can + =item Class Data as Package Variables =over 4 @@ -1813,8 +1819,6 @@ http://testers.cpan.org/ =item DOS and Derivatives -Build instructions for OS/2, L - =item S =item VMS @@ -1854,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 @@ -1982,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 @@ -3123,6 +3127,8 @@ CGI script to do bad things? =item How do I send mail? +=item How do I use MIME to make an attachment to a mail message? + =item How do I read mail? =item How do I find out my hostname/domainname/IP address? @@ -3478,6 +3484,38 @@ C, C, C =back +=head2 perlclib - Internal replacements for standard C library functions + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Conventions + +C, C

, C, C + +=item File Operations + +=item File Input and Output + +=item File Positioning + +=item Memory Management and String Handling + +=item Character Class Tests + +=item F functions + +=item Miscellaneous functions + +=back + +=item SEE ALSO + +=back + =head2 perlguts - Introduction to the Perl API =over 4 @@ -3529,14 +3567,15 @@ 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 @@ -3586,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 @@ -3813,38 +3856,37 @@ B 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, -bytes_to_utf8, call_argv, call_method, call_pv, call_sv, CLASS, Copy, -croak, CvSTASH, cv_const_sv, dMARK, dORIGMARK, dSP, dXSARGS, dXSI32, ENTER, -eval_pv, eval_sv, EXTEND, fbm_compile, fbm_instr, FREETMPS, get_av, get_cv, -get_hv, get_sv, GIMME, GIMME_V, GvSV, gv_fetchmeth, gv_fetchmethod, -gv_fetchmethod_autoload, gv_stashpv, gv_stashsv, G_ARRAY, G_DISCARD, -G_EVAL, G_NOARGS, G_SCALAR, G_VOID, HEf_SVKEY, 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, +bytes_from_utf8, bytes_to_utf8, call_argv, call_method, call_pv, call_sv, +CLASS, Copy, croak, CvSTASH, cv_const_sv, dMARK, dORIGMARK, dSP, dXSARGS, +dXSI32, ENTER, eval_pv, eval_sv, EXTEND, fbm_compile, fbm_instr, FREETMPS, +get_av, get_cv, get_hv, get_sv, GIMME, GIMME_V, GvSV, gv_fetchmeth, +gv_fetchmethod, gv_fetchmethod_autoload, gv_stashpv, gv_stashsv, G_ARRAY, +G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID, HEf_SVKEY, 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_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, -PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_modglobal, -PL_na, PL_ofs_sv, PL_rs, PL_sv_no, PL_sv_undef, PL_sv_yes, POPi, POPl, -POPn, POPp, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, 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, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, 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, 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, +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, +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, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, +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, +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, sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_dec, sv_derived_from, sv_eq, sv_free, sv_gets, sv_grow, sv_inc, sv_insert, @@ -3853,15 +3895,16 @@ sv_newmortal, sv_pvn_force, sv_pvutf8n_force, sv_reftype, sv_replace, 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_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_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 +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, +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 @@ -3876,7 +3919,8 @@ XS_VERSION_BOOTCHECK, Zero =item DESCRIPTION -djSP, is_gv_magical, LVRET, start_glob +djSP, is_gv_magical, LVRET, PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, +PL_last_in_gv, PL_ofs_sv, PL_rs, start_glob =item AUTHORS @@ -3884,6 +3928,67 @@ djSP, is_gv_magical, LVRET, start_glob =back +=head2 perliol - C API for Perl's implementation of IO in Layers. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item History and Background + +=item Layers vs Disciplines + +=item Data Structures + +1. The functions and attributes of the "layer class", 2. The per-instance +data for a particular handle + +=item Functions and Attributes + +=item Per-instance Data + +=item Layers in action. + +=item Per-instance flag bits + +PERLIO_F_EOF, PERLIO_F_CANWRITE, PERLIO_F_CANREAD, PERLIO_F_ERROR, +PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8, +PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF, +PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS + +=item Methods in Detail + + 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 + +"unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8" + +=item Extension Layers + +":encoding", ":Scalar", ":Object" or ":Perl" + +=back + +=back + =head2 perlapio - perl's IO abstraction interface. =over 4 @@ -3892,27 +3997,36 @@ djSP, is_gv_magical, LVRET, start_glob =item DESCRIPTION -B, B, B, B, -B, B, +1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B, +B, B, B, +B, B, B, B, B, B, B, B, B, B, B, B, B, B, B, -B, B, B, -B, B, B, -B, B +B, B, B, +B, B, B, +B, B, B =over 4 =item Co-existence with stdio B, B, -B, B, B, -B, B, B, -B, B, -B, B, B, -B, B +B, B + +=item "Fast gets" Functions + +B, B, B, +B, B, B, +B, B, B, +B + +=item Other Functions + +PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers), +'E' read, 'E' write, '+' read/write, PerlIO_debug(fmt,...) =back @@ -4297,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 @@ -4939,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 @@ -5279,6 +5401,50 @@ sh Configure -Dprefix=/ade -Dloclibpth=/ade/lib =back +=head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item gzip + +=item bison + +=item Unpacking + +=item Compiling + +=item Testing + +=item Install + +=item Using Perl in the Posix-Shell + +=item Using Perl in "native" BS2000 + +=item Floating point anomalies + +=back + +=item AUTHORS + +=item SEE ALSO + +=over 4 + +=item Mailing list + +=back + +=item HISTORY + +=back + =head2 perlcygwin, README.cygwin - Perl for Cygwin =over 4 @@ -5364,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 @@ -5374,11 +5584,15 @@ Source, Compiled Module Source, Perl Modules/Scripts =item INSTALLING PERL ON EPOC +=item STARTING PERL ON EPOC + +=item STOPPING PERL ON EPOC + =item USING PERL ON EPOC =over 4 -=item IO Redirection +=item I/O Redirection =item PATH Names @@ -5470,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 @@ -5526,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 @@ -5584,6 +5814,8 @@ Perl manual in F<.INF> format, Pdksh =over 4 +=item The short story + =item Prerequisites =item Getting perl source @@ -5597,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 @@ -5644,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 @@ -5672,8 +5920,6 @@ C, C, C, C, C, C =item Why chimera build? -explicit fork(), open FH, "|-", open FH, "-|" - =back =item ENVIRONMENT @@ -5746,50 +5992,13 @@ C, F =item testing anomalies -=item Usage Hints - -=item Modules and Extensions - -=back - -=item AUTHORS - -=item SEE ALSO - -=over 4 - -=item Mailing list - -=back - -=item HISTORY - -=back - -=head2 perlposix-bc, README.posix-bc - building and installing Perl for -BS2000 POSIX. - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=over 4 - -=item gzip - -=item bison - -=item Unpacking - -=item Compiling +=item installation anomalies -=item Testing +=item Usage Hints -=item Install +=item Floating point anomalies -=item Using Perl +=item Modules and Extensions =back @@ -5891,6 +6100,51 @@ DATAMODEL_NATIVE specified", sh: ar: not found =back +=head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Unpacking + +=item Setup and utilities + +=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 + +=item testing anomalies + +=item Usage Hints + +When using perl on VM/ESA please keep in mind that the EBCDIC and ASCII +character sets are different. Perl builtin functions that may behave +differently under EBCDIC are mentioned in the perlport.pod document. + +=back + +=item AUTHORS + +=item SEE ALSO + +=over 4 + +=item Mailing list + +=back + +=back + =head2 perlvms - VMS-specific documentation for Perl =over 4 @@ -6004,9 +6258,7 @@ LIST, waitpid PID,FLAGS =back -=head1 PRAGMA DOCUMENTATION - -=head2 attrs - set/get attributes of a subroutine (deprecated) +=head2 perlwin32 - Perl under Win32 =over 4 @@ -6014,21 +6266,65 @@ LIST, waitpid PID,FLAGS =item DESCRIPTION -method, locked +=over 4 -=back +=item Setting Up -=head2 re - Perl pragma to alter regular expression behaviour +Make, Command Shell, Borland C++, Microsoft Visual C++, Mingw32 with GCC -=over 4 +=item Building -=item SYNOPSIS +=item Testing -=item DESCRIPTION +=item Installation -=back +=item Usage Hints -=head2 attributes - get/set subroutine or variable attributes +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) + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +method, locked + +=back + +=head2 re - Perl pragma to alter regular expression behaviour + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=back + +=head2 attributes - get/set subroutine or variable attributes =over 4 @@ -6233,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 @@ -6297,7 +6593,9 @@ operations =item DESCRIPTION -=item UNIMPLEMENTED FUNCTIONALITY +=item NONPERLIO FUNCTIONALITY + +=item IMPLEMENTATION DETAILS =item SEE ALSO @@ -6414,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 @@ -6517,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 @@ -6641,7 +6928,7 @@ REFCNT, FLAGS =item B::IV METHODS -IV, IVX, needs64bits, packiv +IV, IVX, UVX, int_value, needs64bits, packiv =item B::NV METHODS @@ -6653,7 +6940,7 @@ RV =item B::PV METHODS -PV +PV, PVX =item B::PVMG METHODS @@ -6673,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 @@ -6802,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 @@ -7143,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 @@ -7358,7 +7643,7 @@ parameters =item Server Push -multipart_init(), multipart_start(), multipart_end() +multipart_init(), multipart_start(), multipart_end(), multipart_final() =item Avoiding Denial of Service Attacks @@ -7533,7 +7818,7 @@ B, B, B, B, B =item USING CGI::Push --next_page, -last_page, -type, -delay, -cookie, -target, -expires +-next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph =over 4 @@ -7571,6 +7856,20 @@ B, B, B, B, B =back +=head2 CGI::Util - Internal utilities used by CGI module + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item AUTHOR INFORMATION + +=item SEE ALSO + +=back + =head2 CPAN - query, download and build perl modules from CPAN sites =over 4 @@ -7585,7 +7884,7 @@ B, B, B, B, B Searching for authors, bundles, distribution files and modules, make, test, install, clean modules or distributions, get, readme, look module or -distribution, Signals +distribution, ls author, Signals =item CPAN::Shell @@ -7683,6 +7982,8 @@ http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade =item AUTHOR +=item TRANSLATIONS + =item SEE ALSO =back @@ -7730,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 @@ -7813,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, @@ -7872,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 @@ -7987,17 +8313,17 @@ C, C, C, C C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, 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 t @@ -8026,6 +8352,10 @@ C, C, C, C, C C, C +=item y + +C, C + =item z C, C @@ -8036,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 @@ -8351,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 @@ -8422,22 +8801,90 @@ Perl code =over 4 +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + =item TERMINOLOGY -=item bytes +=back + +=item ENCODINGS + +=over 4 + +=item Characteristics of an Encoding + +=item Types of Encodings + +Fixed length 8-bit (or less) encodings, Fixed length 16-bit encodings, +Fixed length 32-bit encodings, Multi-byte encodings, "Escape" encodings + +=item Specifying Encodings + +1. By name, 2. As an object -=item chars +=item Encoding Names -=item chars With Encoding +The MIME name as defined in IETF RFC-XXXX, The name in the IANA registry, +The name used by the the organization that defined it -=item Testing For UTF-8 +=back + +=item PERL ENCODING API -=item Toggling UTF-8-ness +=over 4 -=item UTF-16 and UTF-32 Encodings +=item Generic Encoding Interface =item Handling Malformed Data +Scheme 1, Scheme 2, Other Schemes + +=item UTF-8 / utf8 + +=item Other Encodings of Unicode + +=item Listing available encodings + +=item Defining Aliases + +As a simple string, As a qr// compiled regular expression, e.g.:, As a code +reference, e.g.: + +=item Defining Encodings + +=back + +=item Encoding and IO + +=item Encoding How to ... + +IO with mixed content (faking iso-2020-*), MIME's Content-Length:, UTF-8 +strings in binary data, perl/Encode wrappers on non-Unicode XS modules + +=item Messing with Perl's Internals + +is_utf8(STRING [, CHECK]), valid_utf8(STRING) + +=item IMPLEMENTATION CLASSES + +-Ename, -Enew_sequence, -Eencode($string,$check), +-Edecode($octets,$check) + +=over 4 + +=item Compiled Encodings + +.enc, .ucm, .ucm, .c, .xs, ascii and iso-8859-*, IBM-1047 and two other +variants of EBCDIC, symbol and dingbats as used by Tk on X11 + +=back + +=item SEE ALSO + =back =head2 Encode::EncodeFormat, EncodeFormat - the format of encoding tables @@ -8455,6 +8902,8 @@ of the Encode extension =back +=head2 Encode::Tcl - Tcl encodings + =head2 EncodeFormat - the format of encoding tables of the Encode extension =over 4 @@ -8702,8 +9151,12 @@ ExtUtils::MakeMaker =item DESCRIPTION +=item METHODS + =back +perl_archive_after + =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker =over 4 @@ -8902,6 +9355,8 @@ xs_o (o) perl_archive +perl_archive_after + export_list =over 4 @@ -9380,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 @@ -9830,8 +10286,6 @@ $fh->print, $fh->printf, $fh->getline, $fh->getlines =item SYNOPSIS - use Filter::Util::Call ; - =item DESCRIPTION =over 4 @@ -9860,6 +10314,8 @@ B<$_>, B<$status>, B and B, B =back +=item Filter::Simple + =item AUTHOR =item DATE @@ -10154,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 @@ -10198,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 @@ -10392,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 @@ -10438,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 @@ -10640,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 @@ -10745,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 @@ -10761,6 +11454,8 @@ cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical =item SYNOPSIS +=item DESCRIPTION + C, C, C =item DIAGNOSTICS @@ -10792,8 +11487,6 @@ $timeout]);, $p->close();, pingecho($host [, $timeout]); =back -=item WARNING - =item NOTES =back @@ -10886,6 +11579,8 @@ functions =item SYNOPSIS +=item DESCRIPTION + C, C, C =item DIAGNOSTICS @@ -11121,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 @@ -11158,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 @@ -12416,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 @@ -12554,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 @@ -12590,6 +13368,10 @@ NORMAL TESTS, SKIPPED TESTS, TODO TESTS =item The test script output +B<'1..M'>, B<'ok', 'not ok'. Ok?>, B, +B<$Test::Harness::verbose>, B<$Test::Harness::switches>, B, +B, B, B + =back =item EXPORT @@ -12603,6 +13385,10 @@ C, C, C, C, +C, C, C, +C + =item SEE ALSO =item AUTHORS @@ -12623,6 +13409,75 @@ C, 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 @@ -13002,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