X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperltoc.pod;h=9b8654edc1192147fa2e7f71800a87193691e98a;hb=231c9faeb17b45588bbde0b49d0d32f25d2a1286;hp=fd5a00f3ac1a9f95ada1117d52e05d185a90448c;hpb=78d8f6e05211de1a60b4bb9b795b8ff72f179ebe;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perltoc.pod b/pod/perltoc.pod index fd5a00f..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 @@ -2181,21 +2185,20 @@ chcp, dataset access, OS/390 iconv, locales attributes, attrs, autouse, base, blib, bytes, charnames, constant, diagnostics, fields, filetest, integer, less, locale, open, ops, overload, -perlio, re, sigtrap, strict, subs, unicode::distinct, utf8, vars, warnings, -warnings::register +perlio, re, sigtrap, strict, subs, utf8, vars, warnings, warnings::register =item Standard Modules AnyDBM_File, AutoLoader, AutoSplit, B, B::Asmdata, B::Assembler, B::Bblock, -B::Bytecode, B::C, B::CC, B::Concise, B::Debug, B::Deparse, -B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash, B::Terse, -B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp, CGI::Cookie, -CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CPAN, CPAN::FirstTime, -CPAN::Nox, Carp, Carp::Heavy, Class::Struct, Cwd, DB, DB_File, -Devel::SelfStubber, DirHandle, Dumpvalue, Encode, English, Env, Exporter, -Exporter::Heavy, ExtUtils::Command, ExtUtils::Embed, ExtUtils::Install, -ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM_Cygwin, -ExtUtils::MM_OS2, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32, +B::Bytecode, B::C, B::CC, B::Debug, B::Deparse, B::Disassembler, B::Lint, +B::Showlex, B::Stackobj, B::Stash, B::Terse, B::Xref, Benchmark, +ByteLoader, CGI, CGI::Apache, CGI::Carp, CGI::Cookie, CGI::Fast, +CGI::Pretty, CGI::Push, CGI::Switch, CPAN, CPAN::FirstTime, CPAN::Nox, +Carp, Class::Struct, Cwd, DB, DB_File, Devel::SelfStubber, DirHandle, +Dumpvalue, Encode, English, Env, Exporter, Exporter::Heavy, +ExtUtils::Command, ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, +ExtUtils::Liblist, ExtUtils::MM_Cygwin, ExtUtils::MM_OS2, +ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32, ExtUtils::MakeMaker, ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::Packlist, ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree, File::Compare, File::Copy, File::DosGlob, @@ -2208,13 +2211,13 @@ Math::Complex, Math::Trig, NDBM_File, Net::Ping, Net::hostent, Net::netent, Net::protoent, Net::servent, O, ODBM_File, Opcode, 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, Socket, Storable, Symbol, -Term::ANSIColor, Term::Cap, Term::Complete, Term::ReadLine, Test, -Test::Harness, Text::Abbrev, Text::ParseWords, Text::Soundex, Text::Wrap, -Tie::Array, Tie::Handle, Tie::Hash, Tie::RefHash, Tie::Scalar, -Tie::SubstrHash, Time::Local, Time::gmtime, Time::localtime, Time::tm, -UNIVERSAL, User::grent, User::pwent +Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe, Search::Dict, SelectSaver, +SelfLoader, Shell, Socket, Storable, Symbol, Term::ANSIColor, Term::Cap, +Term::Complete, Term::ReadLine, Test, Test::Harness, Text::Abbrev, +Text::ParseWords, Text::Soundex, Text::Wrap, Tie::Array, Tie::Handle, +Tie::Hash, Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::Local, +Time::gmtime, Time::localtime, Time::tm, UNIVERSAL, User::grent, +User::pwent =item Extension Modules @@ -2222,20 +2225,8 @@ UNIVERSAL, User::grent, User::pwent =item CPAN -Language Extensions and Documentation Tools, Development Support, Operating -System Interfaces, Networking, Device Control (modems) and InterProcess -Communication, Data Types and Data Type Utilities, Database Interfaces, -User Interfaces, Interfaces to / Emulations of Other Programming Languages, -File Names, File Systems and File Locking (see also File Handles), String -Processing, Language Text Processing, Parsing, and Searching, Option, -Argument, Parameter, and Configuration File Processing, -Internationalization and Locale, Authentication, Security, and Encryption, -World Wide Web, HTML, HTTP, CGI, MIME, Server and Daemon Utilities, -Archiving and Compression, Images, Pixmap and Bitmap Manipulation, Drawing, -and Graphing, Mail and Usenet News, Control Flow Utilities (callbacks and -exceptions etc), File Handle and Input/Output Stream Utilities, -Miscellaneous Modules, Africa, Asia, Australasia, Central America, Europe, -North America, South America +Africa, Asia, Australasia, Central America, Europe, North America, South +America =item Modules: Creation, Use, and Abuse @@ -2264,12 +2255,6 @@ to ::, Converts die(...) to croak(...), Several other minor changes =item Guidelines for Reusing Application Code -Complete applications rarely belong in the Perl Module Library, Many -applications contain some Perl code that could be reused, Break-out the -reusable code into one or more separate module files, Take the opportunity -to reconsider and redesign the interfaces, In some cases the 'application' -can then be reduced to a small - =back =item NOTE @@ -3142,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? @@ -3497,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 @@ -3548,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 @@ -3605,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 @@ -3832,25 +3856,25 @@ 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, 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_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes, POPi, -POPl, POPn, POPp, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, +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, 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, @@ -3860,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, @@ -3871,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, U8 *s, utf8_distance, utf8_hop, -utf8_length, utf8_to_bytes, utf8_to_uv, utf8_to_uv_simple, 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 @@ -3894,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 @@ -3902,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 @@ -3910,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 @@ -4315,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 @@ -4957,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 @@ -5297,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 @@ -5436,11 +5584,15 @@ DJGPP, Pthreads =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 @@ -5532,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 @@ -5588,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 @@ -5646,6 +5814,8 @@ Perl manual in F<.INF> format, Pdksh =over 4 +=item The short story + =item Prerequisites =item Getting perl source @@ -5659,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 @@ -5706,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 @@ -5734,8 +5920,6 @@ C, C, C, C, C, C =item Why chimera build? -explicit fork(), open FH, "|-", open FH, "-|" - =back =item ENVIRONMENT @@ -5808,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 @@ -5953,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 @@ -6337,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 @@ -6401,7 +6593,9 @@ operations =item DESCRIPTION -=item UNIMPLEMENTED FUNCTIONALITY +=item NONPERLIO FUNCTIONALITY + +=item IMPLEMENTATION DETAILS =item SEE ALSO @@ -6518,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 @@ -6621,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 @@ -6745,7 +6928,7 @@ REFCNT, FLAGS =item B::IV METHODS -IV, IVX, needs64bits, packiv +IV, IVX, UVX, int_value, needs64bits, packiv =item B::NV METHODS @@ -6757,7 +6940,7 @@ RV =item B::PV METHODS -PV +PV, PVX =item B::PVMG METHODS @@ -6777,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 @@ -6906,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 @@ -7247,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 @@ -7462,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 @@ -7637,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 @@ -7675,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 @@ -7689,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 @@ -7787,6 +7982,8 @@ http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade =item AUTHOR +=item TRANSLATIONS + =item SEE ALSO =back @@ -7834,7 +8031,7 @@ module =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside -=head2 Class::Struct - declare struct-like datatypes as Perl classes +=head2 Class::ISA -- report the search path for a class's ISA tree =over 4 @@ -7842,16 +8039,38 @@ module =item DESCRIPTION -=over 4 +=item FUNCTIONS -=item The C function +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 Class Creation at Compile Time +=item CAUTIONARY NOTES -=item Element Types and Accessor Methods +=item COPYRIGHT -Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or -C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>) +=item AUTHOR + +=back + +=head2 Class::Struct - declare struct-like datatypes as Perl classes + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item The C function + +=item Class Creation at Compile Time + +=item Element Types and Accessor Methods + +Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or +C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>) =item Initializing with C @@ -7917,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, @@ -7976,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 @@ -8091,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 @@ -8130,6 +8352,10 @@ C, C, C, C, C C, C +=item y + +C, C + =item z C, C @@ -8140,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 @@ -8455,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 @@ -8526,22 +8801,90 @@ Perl code =over 4 +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + =item TERMINOLOGY -=item bytes +=back + +=item ENCODINGS + +=over 4 -=item chars +=item Characteristics of an Encoding -=item chars With Encoding +=item Types of Encodings -=item Testing For UTF-8 +Fixed length 8-bit (or less) encodings, Fixed length 16-bit encodings, +Fixed length 32-bit encodings, Multi-byte encodings, "Escape" encodings -=item Toggling UTF-8-ness +=item Specifying Encodings -=item UTF-16 and UTF-32 Encodings +1. By name, 2. As an object + +=item Encoding Names + +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 + +=back + +=item PERL ENCODING API + +=over 4 + +=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 @@ -8559,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 @@ -8806,8 +9151,12 @@ ExtUtils::MakeMaker =item DESCRIPTION +=item METHODS + =back +perl_archive_after + =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker =over 4 @@ -9006,6 +9355,8 @@ xs_o (o) perl_archive +perl_archive_after + export_list =over 4 @@ -9484,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 @@ -9934,8 +10286,6 @@ $fh->print, $fh->printf, $fh->getline, $fh->getlines =item SYNOPSIS - use Filter::Util::Call ; - =item DESCRIPTION =over 4 @@ -9964,6 +10314,8 @@ B<$_>, B<$status>, B and B, B =back +=item Filter::Simple + =item AUTHOR =item DATE @@ -10258,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 @@ -10302,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 @@ -10496,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 @@ -10542,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 @@ -10744,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 @@ -10849,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 @@ -10865,6 +11454,8 @@ cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical =item SYNOPSIS +=item DESCRIPTION + C, C, C =item DIAGNOSTICS @@ -10896,8 +11487,6 @@ $timeout]);, $p->close();, pingecho($host [, $timeout]); =back -=item WARNING - =item NOTES =back @@ -10990,6 +11579,8 @@ functions =item SYNOPSIS +=item DESCRIPTION + C, C, C =item DIAGNOSTICS @@ -11225,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 @@ -11262,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 @@ -12520,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 @@ -12658,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 @@ -12694,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 @@ -12707,6 +13385,10 @@ C, C, C, C, +C, C, C, +C + =item SEE ALSO =item AUTHORS @@ -12727,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 @@ -13106,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