Tweak docs for C<open> (boy does that need wholesale revision...)
[p5sagit/p5-mst-13.2.git] / pod / perltoc.pod
index 316cc93..311e90b 100644 (file)
@@ -236,8 +236,8 @@ unary &, unary *, (TYPE)
 =item Regexp Quote-Like Operators
 
 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
-qq/STRING/, "STRING", qr/STRING/imosx, qw/STRING/, qu/STRING/, qx/STRING/,
-`STRING`, s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
+qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
+s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
 y/SEARCHLIST/REPLACEMENTLIST/cds
 
 =item Gory details of parsing quoted constructs
@@ -366,17 +366,16 @@ DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, pack TEMPLATE,LIST, package
 NAMESPACE, package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos
 SCALAR, pos, print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE
 FORMAT, LIST, printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST,
-q/STRING/, qq/STRING/, qr/STRING/, qu/STRING/, qw/STRING/, qx/STRING/,
-quotemeta EXPR, quotemeta, rand EXPR, rand, read
-FILEHANDLE,SCALAR,LENGTH,OFFSET, read FILEHANDLE,SCALAR,LENGTH, readdir
-DIRHANDLE, readline EXPR, readlink EXPR, readlink, readpipe EXPR, recv
-SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo, ref EXPR, ref, rename
-OLDNAME,NEWNAME, require VERSION, require EXPR, require, reset EXPR, reset,
-return EXPR, return, reverse LIST, rewinddir DIRHANDLE, rindex
-STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, rmdir, s///, scalar
-EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir DIRHANDLE,POS, select
-FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, semctl
-ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
+q/STRING/, qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR,
+quotemeta, rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
+FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
+readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo,
+ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR,
+require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir
+DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME,
+rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir
+DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT,
+semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
 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,
@@ -927,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
@@ -935,6 +936,8 @@ ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, $ARGV, @ARGV, @INC, @_, %INC,
 
 =item Slices
 
+=back
+
 =item SEE ALSO
 
 =item AUTHOR
@@ -1816,8 +1819,6 @@ http://testers.cpan.org/
 
 =item DOS and Derivatives
 
-Build instructions for OS/2, L<perlos2>
-
 =item S<Mac OS>
 
 =item VMS
@@ -3126,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?
@@ -3481,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<t>, C<p>, C<n>, C<s>
+
+=item File Operations
+
+=item File Input and Output
+
+=item File Positioning
+
+=item Memory Management and String Handling
+
+=item Character Class Tests
+
+=item F<stdlib.h> functions
+
+=item Miscellaneous functions
+
+=back
+
+=item SEE ALSO
+
+=back
+
 =head2 perlguts - Introduction to the Perl API
 
 =over 4
@@ -3834,19 +3869,19 @@ 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, 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,
+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,
@@ -3855,15 +3890,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
 
@@ -5019,7 +5055,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
 
@@ -5359,8 +5395,7 @@ sh Configure -Dprefix=/ade -Dloclibpth=/ade/lib
 
 =back
 
-=head2 perlbs2000, README.posix-bc - building and installing Perl for
-BS2000 POSIX.
+=head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
 
 =over 4
 
@@ -5382,7 +5417,9 @@ BS2000 POSIX.
 
 =item Install
 
-=item Using Perl
+=item Using Perl in the Posix-Shell
+
+=item Using Perl in "native" BS2000
 
 =item Floating point anomalies
 
@@ -5487,50 +5524,6 @@ 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
@@ -5541,11 +5534,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
 
@@ -5693,6 +5690,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<perl.dll> from my
@@ -5751,6 +5750,8 @@ Perl manual in F<.INF> format, Pdksh
 
 =over 4
 
+=item The short story
+
 =item Prerequisites
 
 =item Getting perl source
@@ -5764,7 +5765,7 @@ Perl manual in F<.INF> format, Pdksh
 =item Testing
 
 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
-F<lib/io_pipe.t>, F<lib/io_sock.t>, F<op/stat.t>, F<lib/io_udp.t>
+F<op/stat.t>
 
 =item Installing the built perl
 
@@ -5811,13 +5812,29 @@ C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
 C<Cwd::sys_is_absolute(name)>, C<Cwd::sys_is_rooted(name)>, 
 C<Cwd::sys_is_relative(name)>, C<Cwd::sys_cwd(name)>, 
 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>, 
-C<Cwd::extLibpath_set( path [, type ] )>
+C<Cwd::extLibpath_set( path [, type ] )>,
+C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
+OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
+C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
+C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
+OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>
+
+=item Prebuilt variables:
+
+$OS2::emx_rev, $OS2::emx_env, $OS2::os_ver
 
 =item Misfeatures
 
 =item Modifications
 
-C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<flock>
+C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
+C<flock>
+
+=item Identifying DLLs
+
+=item Centralized management of resources
+
+C<HAB>, C<HMQ>
 
 =back
 
@@ -5839,8 +5856,6 @@ C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<flock>
 
 =item Why chimera build?
 
-explicit fork(), open FH, "|-", open FH, "-|"
-
 =back
 
 =item ENVIRONMENT
@@ -6180,48 +6195,6 @@ 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 E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
-E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
-E<lt>nick@ing-simmons.netE<gt>
-
-=item SEE ALSO
-
-=item HISTORY
-
-=back
-
 =head1 PRAGMA DOCUMENTATION
 
 =head2 attrs - set/get attributes of a subroutine (deprecated)
@@ -6451,8 +6424,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
 
@@ -6735,6 +6708,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
@@ -7020,8 +7002,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
 
@@ -7361,8 +7342,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
 
@@ -7576,7 +7556,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
 
@@ -7751,7 +7731,7 @@ B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
 
 =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
 
@@ -7789,6 +7769,20 @@ B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
 
 =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
@@ -7803,7 +7797,7 @@ B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
 
 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
 
@@ -7901,6 +7895,8 @@ http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
 
 =item AUTHOR
 
+=item TRANSLATIONS
+
 =item SEE ALSO
 
 =back
@@ -8244,6 +8240,10 @@ C<vendorprefixexp>, C<version>, C<versiononly>, C<vi>, C<voidflags>
 
 C<xlibpth>, C<xs_apiversion>
 
+=item y
+
+C<yacc>, C<yaccflags>
+
 =item z
 
 C<zcat>, C<zip>
@@ -8640,22 +8640,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 chars
+=item Types of Encodings
 
-=item chars With Encoding
+Fixed length 8-bit (or less) encodings, Fixed length 16-bit encodings,
+Fixed length 32-bit encodings, Multi-byte encodings, "Escape" encodings
 
-=item Testing For UTF-8
+=item Specifying Encodings
 
-=item Toggling UTF-8-ness
+1. By name, 2. As an object
 
-=item UTF-16 and UTF-32 Encodings
+=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
+
+-E<gt>name, -E<gt>new_sequence, -E<gt>encode($string,$check),
+-E<gt>decode($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
@@ -8673,6 +8741,8 @@ of the Encode extension
 
 =back
 
+=head2 Encode::Tcl - Tcl encodings
+
 =head2 EncodeFormat - the format of encoding tables of the Encode extension
 
 =over 4
@@ -8920,8 +8990,12 @@ ExtUtils::MakeMaker
 
 =item DESCRIPTION
 
+=item METHODS
+
 =back
 
+perl_archive_after
+
 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
 
 =over 4
@@ -9120,6 +9194,8 @@ xs_o (o)
 
 perl_archive
 
+perl_archive_after
+
 export_list
 
 =over 4
@@ -10048,8 +10124,6 @@ $fh->print, $fh->printf, $fh->getline, $fh->getlines
 
 =item SYNOPSIS
 
-    use Filter::Util::Call ;
-
 =item DESCRIPTION
 
 =over 4
@@ -10078,6 +10152,8 @@ B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
 
 =back
 
+=item Filter::Simple
+
 =item AUTHOR
 
 =item DATE
@@ -10372,6 +10448,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
@@ -10610,6 +10688,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
@@ -10858,6 +10938,183 @@ 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<alpha-2>, B<alpha-3>, B<numeric>
+
+=back
+
+=over 4
+
+=item CONVERSION ROUTINES
+
+code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
+country_code2code( CODE, CODESET, CODESET )
+
+=back
+
+=over 4
+
+=item QUERY ROUTINES
+
+C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
+
+=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<all_currency_codes()>, C<all_currency_names()>
+
+=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<all_language_codes()>, C<all_language_names()>
+
+=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 Math::BigFloat - Arbitrary length float math package
 
 =over 4
@@ -10979,6 +11236,8 @@ cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
 
 =item SYNOPSIS
 
+=item DESCRIPTION
+
 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
 
 =item DIAGNOSTICS
@@ -11104,6 +11363,8 @@ functions
 
 =item SYNOPSIS
 
+=item DESCRIPTION
+
 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
 
 =item DIAGNOSTICS
@@ -11376,18 +11637,16 @@ after =back
 =item Warnings
 
 multiple occurence of link target I<name>, 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<one> vs. I<two>), I<N> unescaped
-C<E<lt>E<gt>> 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<one>
+vs. I<two>), I<N> unescaped C<E<lt>E<gt>> 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
 
@@ -12634,6 +12893,38 @@ C<Storable::is_retrieving>
 
 =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
@@ -12774,7 +13065,7 @@ C<tkRunning>, C<ornaments>, C<newTTY>
 
 =back
 
-=head2  Test - provides a simple framework for writing test scripts
+=head2 Test - provides a simple framework for writing test scripts
 
 =over 4
 
@@ -12808,9 +13099,9 @@ NORMAL TESTS, SKIPPED TESTS, TODO TESTS
 
 =item The test script output
 
-B<1..M>, B<'ok', 'not ok'.  Ok?>, B<test numbers>,
+B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>,
 B<$Test::Harness::verbose>, B<$Test::Harness::switches>, B<Skipping tests>,
-B<Bail out!>, B<Comments>
+B<Todo tests>, B<Bail out!>, B<Comments>
 
 =back
 
@@ -12825,6 +13116,10 @@ C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
 
 =item ENVIRONMENT
 
+C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>, C<HARNESS_COMPILE_TEST>,
+C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_COLUMNS>,
+C<HARNESS_ACTIVE>
+
 =item SEE ALSO
 
 =item AUTHORS
@@ -12845,6 +13140,75 @@ C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
 
 =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<extract_delimited>
+
+=item C<extract_bracketed>
+
+=item C<extract_tagged>
+
+C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
+[0], [1], [2], [3], [4], [5]
+
+=item C<gen_extract_tagged>
+
+=item C<extract_quotelike>
+
+[0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
+
+=item C<extract_quotelike> and "here documents"
+
+[0], [1], [2], [3], [4], [5], [6], [7..10]
+
+=item C<extract_codeblock>
+
+=item C<extract_multiple>
+
+=item C<gen_delimited_pat>
+
+=back
+
+=item DIAGNOSTICS
+
+ C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>, 
+C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
+operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">, 
+C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
+C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
+bracket: expected "%c" but found "%s">,  C<No block delimiter found after
+quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
+after dereferencer>, C<Did not find expected opening bracket at %s>,
+C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
+"%s">, C<No match found for opening bracket>, C<Did not find opening tag:
+/%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
+nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
+tag>
+
+=item AUTHOR
+
+=item BUGS AND IRRITATIONS
+
+=item COPYRIGHT
+
+=back
+
 =head2 Text::ParseWords - parse text into an array of tokens or array of
 arrays
 
@@ -13153,6 +13517,18 @@ VAL, TYPE ), UNIVERSAL::can ( VAL, METHOD )
 
 =back
 
+=head2 Unicode::UCD - Unicode character database versioning
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=back
+
 =head2 User::grent - by-name interface to Perl's built-in getgr*()
 functions