Integrate mainline
[p5sagit/p5-mst-13.2.git] / pod / perltoc.pod
index 940c3c0..9b8654e 100644 (file)
@@ -380,14 +380,14 @@ SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
-EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
-SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST,
-sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH,
-splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split
-/PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, sqrt EXPR,
-sqrt, srand EXPR, srand, stat FILEHANDLE, stat EXPR, stat, study SCALAR,
-study, sub BLOCK, sub NAME, sub NAME BLOCK, substr
-EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr
+EXPR, sleep, sockatmark SOCKET, socket SOCKET,DOMAIN,TYPE,PROTOCOL,
+socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort
+BLOCK LIST, sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice
+ARRAY,OFFSET,LENGTH, splice ARRAY,OFFSET, splice ARRAY, split
+/PATTERN/,EXPR,LIMIT, split /PATTERN/,EXPR, split /PATTERN/, split, sprintf
+FORMAT, LIST, sqrt EXPR, sqrt, srand EXPR, srand, stat FILEHANDLE, stat
+EXPR, stat, study SCALAR, study, sub BLOCK, sub NAME, sub NAME BLOCK,
+substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr
 EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
 FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread
 FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
@@ -926,6 +926,8 @@ ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, $ARGV, @ARGV, @INC, @_, %INC,
 
 =item DESCRIPTION
 
+=over 4
+
 =item Declaration and Access of Arrays of Arrays
 
 =item Growing Your Own
@@ -934,6 +936,8 @@ ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, $ARGV, @ARGV, @INC, @_, %INC,
 
 =item Slices
 
+=back
+
 =item SEE ALSO
 
 =item AUTHOR
@@ -1815,8 +1819,6 @@ http://testers.cpan.org/
 
 =item DOS and Derivatives
 
-Build instructions for OS/2, L<perlos2>
-
 =item S<Mac OS>
 
 =item VMS
@@ -1856,9 +1858,9 @@ select RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget
 KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
-shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, socketpair
-SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat EXPR, stat,
-symlink OLDFILE,NEWFILE, syscall LIST, sysopen
+shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
+socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
+EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
 wait, waitpid PID,FLAGS
@@ -1984,7 +1986,7 @@ LC_NUMERIC, LC_TIME, LANG
 
 =over 4
 
-=item Important Caveat
+=item Important Caveats
 
 Input and Output Disciplines, Regular Expressions, C<use utf8> still needed
 to enable a few features
@@ -3565,14 +3567,15 @@ C<t>, C<p>, C<n>, C<s>
 =item Localizing changes
 
 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
-C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEFREEOP(OP
-*op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>, C<SAVEDELETE(HV *hv, char
-*key, I32 length)>, C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void
-*p)>, C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>,
-C<SV* save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV
-*gv)>, C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32
-maxsarg)>, C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>,
-C<void save_hptr(HV **hptr)>
+C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
+*sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
+C<SAVEDELETE(HV *hv, char *key, I32 length)>,
+C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
+C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
+save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
+C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
+C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
+save_hptr(HV **hptr)>
 
 =back
 
@@ -3622,15 +3625,19 @@ C<void save_hptr(HV **hptr)>
 
 =item Background and PERL_IMPLICIT_CONTEXT
 
+=item So what happened to dTHR?
+
 =item How do I use all this in extensions?
 
+=item Should I do anything special if I call perl from multiple threads?
+
 =item Future Plans and PERL_IMPLICIT_SYS
 
 =back
 
 =item Internal Functions
 
-A, p, d, s, n, r, f, m, o, j, x
+A, p, d, s, n, r, f, M, o, j, x
 
 =over 4
 
@@ -3860,12 +3867,12 @@ hv_delete, hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent,
 hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext, hv_iternextsv,
 hv_iterval, hv_magic, hv_store, hv_store_ent, hv_undef, isALNUM, isALPHA,
 isDIGIT, isLOWER, isSPACE, isUPPER, is_utf8_char, is_utf8_string, items,
-ix, LEAVE, looks_like_number, MARK, mg_clear, mg_copy, mg_find, mg_free,
-mg_get, mg_length, mg_magical, mg_set, Move, New, newAV, Newc, newCONSTSUB,
-newHV, newRV_inc, newRV_noinc, NEWSV, newSViv, newSVnv, newSVpv, newSVpvf,
-newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv, newXS, newXSproto,
-Newz, Nullav, Nullch, Nullcv, Nullhv, Nullsv, ORIGMARK, perl_alloc,
-perl_construct, perl_destruct, perl_free, perl_parse, perl_run,
+ix, LEAVE, load_module, looks_like_number, MARK, mg_clear, mg_copy,
+mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set, Move, New, newAV,
+Newc, newCONSTSUB, newHV, newRV_inc, newRV_noinc, NEWSV, newSViv, newSVnv,
+newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv,
+newXS, newXSproto, Newz, Nullav, Nullch, Nullcv, Nullhv, Nullsv, ORIGMARK,
+perl_alloc, perl_construct, perl_destruct, perl_free, perl_parse, perl_run,
 PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes, POPi, POPl, POPn,
 POPp, POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu,
 PUTBACK, Renew, Renewc, require_pv, RETVAL, Safefree, savepv, savepvn,
@@ -3877,7 +3884,7 @@ SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX, SvOK, SvOOK, SvPOK, SvPOKp,
 SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVX, SvPV_force,
 SvPV_nolen, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off,
 SvROK_on, SvRV, SvSETMAGIC, SvSetSV, SvSetSV_nosteal, SvSTASH, SvTAINT,
-SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, svtype, SvTYPE, SVt_IV,
+SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, svtype, SVt_IV,
 SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, SvUOK, SvUPGRADE,
 SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, sv_2mortal, sv_bless, sv_catpv,
 sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_mg, sv_catpv_mg, sv_catsv,
@@ -3892,12 +3899,12 @@ sv_setref_pvn, sv_setref_uv, sv_setsv, sv_setsv_mg, sv_setuv, sv_setuv_mg,
 sv_true, sv_unmagic, sv_unref, sv_unref_flags, sv_upgrade, sv_usepvn,
 sv_usepvn_mg, sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode,
 sv_utf8_upgrade, sv_vcatpvfn, sv_vsetpvfn, THIS, toLOWER, toUPPER,
-utf8_distance, utf8_hop, utf8_length, utf8_to_bytes, utf8_to_uv,
-utf8_to_uv_simple, uv_to_utf8, warn, XPUSHi, XPUSHn, XPUSHp, XPUSHs,
-XPUSHu, XS, XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO,
-XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_YES, XST_mIV, XST_mNO,
-XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES, XS_VERSION, XS_VERSION_BOOTCHECK,
-Zero
+utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length,
+utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8, uvuni_to_utf8,
+warn, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XS, XSRETURN, XSRETURN_EMPTY,
+XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF,
+XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES,
+XS_VERSION, XS_VERSION_BOOTCHECK, Zero
 
 =item AUTHORS
 
@@ -3942,10 +3949,6 @@ data for a particular handle
 
 =item Functions and Attributes
 
-1. Opening and setup functions, 2. Basic IO operations, 3. Stdio class
-buffering options, 4. Functions to support Perl's traditional "fast" access
-to the buffer
-
 =item Per-instance Data
 
 =item Layers in action.
@@ -3959,23 +3962,20 @@ PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
 
 =item Methods in Detail
 
-IV     (*Fileno)(PerlIO *f);,  PerlIO *        (*Fdopen)(PerlIO_funcs
-*tab, int fd, const char *mode);,  PerlIO *     (*Open)(PerlIO_funcs *tab,
-const char *path, const char *mode);,  int          (*Reopen)(const char
-*path, const char *mode, PerlIO *f);,  IV         (*Pushed)(PerlIO
-*f,const char *mode,const char *arg,STRLEN len);,  IV        
-(*Popped)(PerlIO *f);, SSize_t (*Read)(PerlIO *f, void *vbuf, Size_t
-count);,  SSize_t (*Unread)(PerlIO *f, const void *vbuf, Size_t count);, 
-SSize_t (*Write)(PerlIO *f, const void *vbuf, Size_t count);,  IV         
-    (*Seek)(PerlIO *f, Off_t offset, int whence);,  Off_t         
-(*Tell)(PerlIO *f);,  IV               (*Close)(PerlIO *f);,  IV          
-    (*Flush)(PerlIO *f);,  IV              (*Fill)(PerlIO *f);,  IV       
-       (*Eof)(PerlIO *f);,  IV         (*Error)(PerlIO *f);,  void        
-    (*Clearerr)(PerlIO *f);,  void         (*Setlinebuf)(PerlIO *f);, 
-STDCHAR *   (*Get_base)(PerlIO *f);,  Size_t              
-(*Get_bufsiz)(PerlIO *f);,  STDCHAR *  (*Get_ptr)(PerlIO *f);,  SSize_t   
-    (*Get_cnt)(PerlIO *f);,  void          (*Set_ptrcnt)(PerlIO *f,STDCHAR
-*ptr,SSize_t cnt);
+ IV            (*Pushed)(PerlIO *f,const char *mode, SV *arg);,  IV       
+    (*Popped)(PerlIO *f);,  PerlIO *       (*Open)(...);, SV *            
+(*Getarg)(PerlIO *f);, IV      (*Fileno)(PerlIO *f);,  SSize_t
+(*Read)(PerlIO *f, void *vbuf, Size_t count);, SSize_t (*Unread)(PerlIO
+*f, const void *vbuf, Size_t count);,  SSize_t (*Write)(PerlIO *f, const
+void *vbuf, Size_t count);,  IV              (*Seek)(PerlIO *f, Off_t
+offset, int whence);,  Off_t          (*Tell)(PerlIO *f);,  IV            
+   (*Close)(PerlIO *f);,  IV              (*Flush)(PerlIO *f);,  IV       
+       (*Fill)(PerlIO *f);,  IV               (*Eof)(PerlIO *f);,  IV     
+   (*Error)(PerlIO *f);,  void            (*Clearerr)(PerlIO *f);,  void  
+       (*Setlinebuf)(PerlIO *f);,  STDCHAR *   (*Get_base)(PerlIO *f);, 
+Size_t               (*Get_bufsiz)(PerlIO *f);,  STDCHAR *  
+(*Get_ptr)(PerlIO *f);,  SSize_t       (*Get_cnt)(PerlIO *f);,  void      
+    (*Set_ptrcnt)(PerlIO *f,STDCHAR *ptr,SSize_t cnt);
 
 =item Core Layers
 
@@ -3983,7 +3983,7 @@ STDCHAR *   (*Get_base)(PerlIO *f);,  Size_t
 
 =item Extension Layers
 
-"encoding"
+":encoding", ":Scalar", ":Object" or ":Perl"
 
 =back
 
@@ -4411,6 +4411,14 @@ finish, 'enter', print
 
 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
 
+=item Compaq's/Digital's Third Degree
+
+=item PERL_DESTRUCT_LEVEL
+
+=item Pixie Profiling
+
+-h, -l, -p, -h, -i, -l, -testcoverage, -zero
+
 =item CONCLUSION
 
 I<The Road goes ever on and on, down from the door where it began.>
@@ -5053,7 +5061,7 @@ Thread, attrs, fields, re
 =item Changes in existing modules
 
 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
-MakeMaker, CPAN, Cwd, Benchmark
+MakeMaker, CPAN, Cwd
 
 =back
 
@@ -5522,6 +5530,50 @@ Source, Compiled Module Source, Perl Modules/Scripts
 
 =back
 
+=head2 perldos - Perl under DOS, W31, W95.
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Prerequisites
+
+DJGPP, Pthreads
+
+=item Shortcomings of Perl under DOS
+
+=item Building
+
+=item Testing
+
+=item Installation
+
+=back
+
+=item BUILDING AND INSTALLING MODULES
+
+=over 4
+
+=item Prerequisites
+
+=item Unpacking CPAN Modules
+
+=item Building Non-XS Modules
+
+=item Building XS Modules
+
+=back
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
 =head2 perlepoc, README.epoc - Perl for EPOC
 
 =over 4
@@ -5632,6 +5684,20 @@ op/lexassign.t, pragma/warnings.t
 
 =back
 
+=head2 perlmacos, README.macos - Perl under Mac OS (Classic)
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item AUTHOR
+
+=item DATE
+
+=back
+
 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
 
 =head1 SYNOPSIS
@@ -5688,6 +5754,8 @@ EMX, RSX, HPFS, pdksh
 
 =over 4
 
+=item "It does not work"
+
 =item I cannot run external programs
 
 =item I cannot embed perl into my program, or use F<perl.dll> from my
@@ -5746,6 +5814,8 @@ Perl manual in F<.INF> format, Pdksh
 
 =over 4
 
+=item The short story
+
 =item Prerequisites
 
 =item Getting perl source
@@ -5759,7 +5829,7 @@ Perl manual in F<.INF> format, Pdksh
 =item Testing
 
 A lot of C<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
 
@@ -5806,13 +5876,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
 
@@ -5834,8 +5920,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
@@ -6032,13 +6116,12 @@ DATAMODEL_NATIVE specified", sh: ar: not found
 
 =item Configure
 
-- Don't turn on the compiler optimization flag "-O".  There's    a bug in
-the compiler (APAR PQ18812) that generates some bad code       the
-optimizer is on, - As VM/ESA doesn't fully support the fork() API programs
-relying on      this call will not work. I've replaced fork()/exec() with
-spawn()       and the standalone exec() with spawn(). This has a side
-effect when    opening unnamed pipes in a shell script: there is no child
-process      generated under
+Don't turn on the compiler optimization flag "-O".  There's a bug in the
+compiler (APAR PQ18812) that generates some bad code the optimizer is on,
+As VM/ESA doesn't fully support the fork() API programs relying on this
+call will not work. I've replaced fork()/exec() with spawn() and the
+standalone exec() with spawn(). This has a side effect when opening unnamed
+pipes in a shell script: there is no child process generated under
 
 =item testing anomalies
 
@@ -6175,6 +6258,48 @@ LIST, waitpid PID,FLAGS
 
 =back
 
+=head2 perlwin32 - Perl under Win32
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Setting Up
+
+Make, Command Shell, Borland C++, Microsoft Visual C++, Mingw32 with GCC
+
+=item Building
+
+=item Testing
+
+=item Installation
+
+=item Usage Hints
+
+Environment Variables, File Globbing, Using perl from the command line,
+Building Extensions, Command-line Wildcard Expansion, Win32 Specific
+Extensions, Running Perl Scripts, Miscellaneous Things
+
+=back
+
+=item BUGS AND CAVEATS
+
+=item AUTHORS
+
+Gary Ng 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)
@@ -6404,8 +6529,8 @@ new, phash
 
 =back
 
-=head2 integer - Perl pragma to compute arithmetic in integer instead of
-double
+=head2 integer - Perl pragma to use integer arithmetic instead of floating
+point
 
 =over 4
 
@@ -6468,7 +6593,9 @@ operations
 
 =item DESCRIPTION
 
-=item UNIMPLEMENTED FUNCTIONALITY
+=item NONPERLIO FUNCTIONALITY
+
+=item IMPLEMENTATION DETAILS
 
 =item SEE ALSO
 
@@ -6585,26 +6712,6 @@ type, `%s' is not a code reference
 
 =back
 
-=head2 perlio - perl pragma to configure C level IO
-
-=over 4
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-unix, stdio, perlio
-
-=over 4
-
-=item Defaults and how to override them
-
-=back
-
-=item AUTHOR
-
-=back
-
 =head2 re - Perl pragma to alter regular expression behaviour
 
 =over 4
@@ -6688,6 +6795,15 @@ and non-UTF data.
 
 =item DESCRIPTION
 
+=over 4
+
+=item Utility functions
+
+$num_octets = utf8::upgrade($string);, utf8::downgrade($string[, CHECK]),
+utf8::encode($string), $flag = utf8::decode($string)
+
+=back
+
 =item SEE ALSO
 
 =back
@@ -6812,7 +6928,7 @@ REFCNT, FLAGS
 
 =item B::IV METHODS
 
-IV, IVX, needs64bits, packiv
+IV, IVX, UVX, int_value, needs64bits, packiv
 
 =item B::NV METHODS
 
@@ -6824,7 +6940,7 @@ RV
 
 =item B::PV METHODS
 
-PV
+PV, PVX
 
 =item B::PVMG METHODS
 
@@ -6844,8 +6960,8 @@ USEFUL, PREVIOUS, RARE, TABLE
 
 =item B::GV METHODS
 
-is_empty, NAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN, LINE, FILE,
-FILEGV, GvREFCNT, FLAGS
+is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
+LINE, FILE, FILEGV, GvREFCNT, FLAGS
 
 =item B::IO METHODS
 
@@ -6973,8 +7089,7 @@ bytecode
 
 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
-B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>    Stores package in the
-output.    =back
+B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
 
 =item EXAMPLES
 
@@ -7314,8 +7429,7 @@ STYLE ] ), cmpthese ( RESULTSHASHREF ), countit(TIME, CODE), disablecache (
 
 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
-B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>    Stores package in the
-output.    =back
+B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
 
 =item EXAMPLES
 
@@ -7917,6 +8031,28 @@ module
 
 =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
 
+=head2 Class::ISA -- report the search path for a class's ISA tree
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item FUNCTIONS
+
+the function Class::ISA::super_path($CLASS), the function
+Class::ISA::self_and_super_path($CLASS), the function
+Class::ISA::self_and_super_versions($CLASS)
+
+=item CAUTIONARY NOTES
+
+=item COPYRIGHT
+
+=item AUTHOR
+
+=back
+
 =head2 Class::Struct - declare struct-like datatypes as Perl classes
 
 =over 4
@@ -8000,55 +8136,57 @@ C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>,
 C<d_atolf>, C<d_atoll>, C<d_attribut>, C<d_bcmp>, C<d_bcopy>,
 C<d_bincompat5005>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>,
 C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>,
-C<d_chsize>, C<d_closedir>, C<d_const>, C<d_crypt>, C<d_csh>, C<d_cuserid>,
-C<d_dbl_dig>, C<d_difftime>, C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>,
-C<d_dlsymun>, C<d_dosuid>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>,
-C<d_endgrent>, C<d_endhent>, C<d_endnent>, C<d_endpent>, C<d_endpwent>,
-C<d_endsent>, C<d_eofnblk>, C<d_eunice>, C<d_fchmod>, C<d_fchown>,
-C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>,
-C<d_fds_bits>, C<d_fgetpos>, C<d_flexfnam>, C<d_flock>, C<d_fork>,
-C<d_fpathconf>, C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>, C<d_fseeko>,
-C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>, C<d_ftello>,
-C<d_ftime>, C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>,
-C<d_getgrent>, C<d_getgrps>, C<d_gethbyaddr>, C<d_gethbyname>,
-C<d_gethent>, C<d_gethname>, C<d_gethostprotos>, C<d_getlogin>,
-C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>,
-C<d_getnent>, C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>,
-C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>,
-C<d_getppid>, C<d_getprior>, C<d_getprotoprotos>, C<d_getprpwnam>,
-C<d_getpwent>, C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>,
-C<d_getservprotos>, C<d_getspnam>, C<d_gettimeod>, C<d_gnulibc>,
-C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>, C<d_iconv>, C<d_index>,
-C<d_inetaton>, C<d_int64_t>, C<d_isascii>, C<d_isnan>, C<d_isnanl>,
-C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_locconv>,
-C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, C<d_lstat>,
-C<d_madvise>, C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>,
-C<d_memcmp>, C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>,
-C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>,
-C<d_mmap>, C<d_modfl>, C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>,
-C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, C<d_msg_proxy>,
-C<d_msgctl>, C<d_msgget>, C<d_msgrcv>, C<d_msgsnd>, C<d_msync>,
-C<d_munmap>, C<d_mymalloc>, C<d_nice>, C<d_nv_preserves_uv>,
-C<d_nv_preserves_uv_bits>, C<d_off64_t>, C<d_old_pthread_create_joinable>,
-C<d_oldpthreads>, C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>,
-C<d_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>,
-C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>,
-C<d_PRIFUldbl>, C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>,
-C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_pthread_yield>, C<d_pwage>,
-C<d_pwchange>, C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>,
-C<d_pwpasswd>, C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_readdir>,
-C<d_readlink>, C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>,
-C<d_safemcpy>, C<d_sanemcmp>, C<d_sbrkproto>, C<d_sched_yield>,
-C<d_scm_rights>, C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>,
-C<d_semctl>, C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>,
-C<d_semop>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>, C<d_setgrps>,
-C<d_sethent>, C<d_setlinebuf>, C<d_setlocale>, C<d_setnent>, C<d_setpent>,
-C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>, C<d_setprior>,
-C<d_setproctitle>, C<d_setpwent>, C<d_setregid>, C<d_setresgid>,
-C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>,
-C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>,
-C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>,
-C<d_sigprocmask>, C<d_sigsetjmp>, C<d_socket>, C<d_socklen_t>,
+C<d_chsize>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>, C<d_crypt>,
+C<d_csh>, C<d_cuserid>, C<d_dbl_dig>, C<d_difftime>, C<d_dirnamlen>,
+C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>, C<d_drand48proto>,
+C<d_dup2>, C<d_eaccess>, C<d_endgrent>, C<d_endhent>, C<d_endnent>,
+C<d_endpent>, C<d_endpwent>, C<d_endsent>, C<d_eofnblk>, C<d_eunice>,
+C<d_fchmod>, C<d_fchown>, C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>,
+C<d_fd_set>, C<d_fds_bits>, C<d_fgetpos>, C<d_flexfnam>, C<d_flock>,
+C<d_fork>, C<d_fpathconf>, C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>,
+C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>,
+C<d_ftello>, C<d_ftime>, C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>,
+C<d_getfsstat>, C<d_getgrent>, C<d_getgrps>, C<d_gethbyaddr>,
+C<d_gethbyname>, C<d_gethent>, C<d_gethname>, C<d_gethostprotos>,
+C<d_getitimer>, C<d_getlogin>, C<d_getmnt>, C<d_getmntent>,
+C<d_getnbyaddr>, C<d_getnbyname>, C<d_getnent>, C<d_getnetprotos>,
+C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>, C<d_getpent>,
+C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>, C<d_getprior>,
+C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>, C<d_getsbyname>,
+C<d_getsbyport>, C<d_getsent>, C<d_getservprotos>, C<d_getspnam>,
+C<d_gettimeod>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>,
+C<d_iconv>, C<d_index>, C<d_inetaton>, C<d_int64_t>, C<d_isascii>,
+C<d_isnan>, C<d_isnanl>, C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>,
+C<d_link>, C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>,
+C<d_lseekproto>, C<d_lstat>, C<d_madvise>, C<d_mblen>, C<d_mbstowcs>,
+C<d_mbtowc>, C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>,
+C<d_memset>, C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>,
+C<d_mkstemps>, C<d_mktime>, C<d_mmap>, C<d_modfl>, C<d_mprotect>, C<d_msg>,
+C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>,
+C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>,
+C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>,
+C<d_nv_preserves_uv>, C<d_nv_preserves_uv_bits>, C<d_off64_t>,
+C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
+C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>,
+C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>,
+C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>,
+C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>,
+C<d_PRIx64>, C<d_PRIXU64>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
+C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
+C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_readdir>, C<d_readlink>,
+C<d_readv>, C<d_recvmsg>, C<d_rename>, C<d_rewinddir>, C<d_rmdir>,
+C<d_safebcpy>, C<d_safemcpy>, C<d_sanemcmp>, C<d_sbrkproto>,
+C<d_sched_yield>, C<d_scm_rights>, C<d_SCNfldbl>, C<d_seekdir>,
+C<d_select>, C<d_sem>, C<d_semctl>, C<d_semctl_semid_ds>,
+C<d_semctl_semun>, C<d_semget>, C<d_semop>, C<d_sendmsg>, C<d_setegid>,
+C<d_seteuid>, C<d_setgrent>, C<d_setgrps>, C<d_sethent>, C<d_setitimer>,
+C<d_setlinebuf>, C<d_setlocale>, C<d_setnent>, C<d_setpent>, C<d_setpgid>,
+C<d_setpgrp2>, C<d_setpgrp>, C<d_setprior>, C<d_setproctitle>,
+C<d_setpwent>, C<d_setregid>, C<d_setresgid>, C<d_setresuid>,
+C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, C<d_setsid>,
+C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>, C<d_shmatprototype>,
+C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>, C<d_sigprocmask>,
+C<d_sigsetjmp>, C<d_sockatmark>, C<d_socket>, C<d_socklen_t>,
 C<d_sockpair>, C<d_socks5_init>, C<d_sqrtl>, C<d_statblks>,
 C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>,
 C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>,
@@ -8059,12 +8197,13 @@ C<d_strtoq>, C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>,
 C<d_suidsafe>, C<d_symlink>, C<d_syscall>, C<d_sysconf>, C<d_sysernlst>,
 C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
 C<d_telldirproto>, C<d_time>, C<d_times>, C<d_truncate>, C<d_tzname>,
-C<d_umask>, C<d_uname>, C<d_union_semun>, C<d_ustat>, C<d_vendorarch>,
-C<d_vendorbin>, C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>,
-C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
-C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_xenix>, C<date>,
-C<db_hashtype>, C<db_prefixtype>, C<defvoidused>, C<direntrytype>,
-C<dlext>, C<dlsrc>, C<doublesize>, C<drand01>, C<dynamic_ext>
+C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>,
+C<d_usleep>, C<d_ustat>, C<d_vendorarch>, C<d_vendorbin>, C<d_vendorlib>,
+C<d_vfork>, C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>, C<d_volatile>,
+C<d_vprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>,
+C<d_writev>, C<d_xenix>, C<date>, C<db_hashtype>, C<db_prefixtype>,
+C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>, C<doublesize>,
+C<drand01>, C<dynamic_ext>
 
 =item e
 
@@ -8227,7 +8366,7 @@ C<zcat>, C<zip>
 
 =back
 
-=head2 Cwd, getcwd - get pathname of current working directory
+=head2 Cwd - get pathname of current working directory
 
 =over 4
 
@@ -8542,6 +8681,55 @@ Dumper
 
 =back
 
+=head2 Digest:: - Modules that calculate message digests
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+I<binary>, I<hex>, I<base64>
+
+=item OO INTERFACE
+
+$ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
+Digest::XXX->new($arg,...), $ctx->reset, $ctx->add($data,...),
+$ctx->addfile($io_handle), $ctx->digest, $ctx->hexdigest, $ctx->b64digest
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=back
+
+=head2 Digest::MD5 - Perl interface to the MD5 Algorithm
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item FUNCTIONS
+
+md5($data,...), md5_hex($data,...), md5_base64($data,...)
+
+=item METHODS
+
+$md5 = Digest::MD5->new, $md5->reset, $md5->add($data,...),
+$md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
+
+=item EXAMPLES
+
+=item SEE ALSO
+
+=item COPYRIGHT
+
+=item AUTHORS
+
+=back
+
 =head2 DirHandle - supply object methods for directory handles
 
 =over 4
@@ -8679,8 +8867,7 @@ strings in binary data, perl/Encode wrappers on non-Unicode XS modules
 
 =item Messing with Perl's Internals
 
-utf8_downgrade($string[, CHECK]), is_utf8(STRING [, CHECK]),
-valid_utf8(STRING)
+is_utf8(STRING [, CHECK]), valid_utf8(STRING)
 
 =item IMPLEMENTATION CLASSES
 
@@ -8955,8 +9142,6 @@ canonpath, cflags, manifypods, perl_archive
 
 =back
 
-perl_archive_after
-
 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
 ExtUtils::MakeMaker
 
@@ -8966,8 +9151,12 @@ ExtUtils::MakeMaker
 
 =item DESCRIPTION
 
+=item METHODS
+
 =back
 
+perl_archive_after
+
 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
 
 =over 4
@@ -9646,7 +9835,8 @@ C<untaint_pattern>, C<untaint_skip>
 =item DESCRIPTION
 
 C<GLOB_ERR>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>, C<GLOB_NOSORT>,
-C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>, C<GLOB_TILDE>, C<GLOB_CSH>
+C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>, C<GLOB_TILDE>, C<GLOB_CSH>,
+C<GLOB_ALPHASORT>
 
 =item DIAGNOSTICS
 
@@ -10096,8 +10286,6 @@ $fh->print, $fh->printf, $fh->getline, $fh->getlines
 
 =item SYNOPSIS
 
-    use Filter::Util::Call ;
-
 =item DESCRIPTION
 
 =over 4
@@ -10126,6 +10314,8 @@ B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
 
 =back
 
+=item Filter::Simple
+
 =item AUTHOR
 
 =item DATE
@@ -10420,6 +10610,8 @@ $io->getpos, $io->setpos, $io->setpos ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
 WHENCE=1 (SEEK_CUR), WHENCE=1 (SEEK_END), $io->sysseek( POS, WHENCE ),
 $io->tell
 
+=item SEE ALSO
+
 =item HISTORY
 
 =back
@@ -10464,8 +10656,8 @@ new ( [ARGS] )
 
 =item METHODS
 
-accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), timeout([VAL]),
-sockopt(OPT [, VAL]), sockdomain, socktype, protocol, connected
+accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
+protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
 
 =item SEE ALSO
 
@@ -10658,6 +10850,8 @@ $io->getpos, $io->setpos, $io->setpos ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
 WHENCE=1 (SEEK_CUR), WHENCE=1 (SEEK_END), $io->sysseek( POS, WHENCE ),
 $io->tell
 
+=item SEE ALSO
+
 =item HISTORY
 
 =back
@@ -10704,8 +10898,8 @@ new ( [ARGS] )
 
 =item METHODS
 
-accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), timeout([VAL]),
-sockopt(OPT [, VAL]), sockdomain, socktype, protocol, connected
+accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
+protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
 
 =item SEE ALSO
 
@@ -10906,6 +11100,233 @@ set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
 
 =back
 
+=head2 Locale::Constants - constants for Locale codes
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item KNOWN BUGS AND LIMITATIONS
+
+=item SEE ALSO
+
+Locale::Language, Locale::Country, Locale::Currency
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
+=head2 Locale::Country - ISO codes for country identification (ISO 3166)
+
+=over 4
+
+=item SYNOPSIS
+
+=back
+
+=over 4
+
+=item DESCRIPTION
+
+B<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 MIME::Base64 - Encoding and decoding of base64 strings
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+encode_base64($str, [$eol]), decode_base64($str)
+
+=item DIAGNOSTICS
+
+Premature end of base64 data, Premature padding of base64 data
+
+=item EXAMPLES
+
+=item COPYRIGHT
+
+=back
+
+=head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
+of quoted-printable strings
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+encode_qp($str), decode_qp($str);
+
+=item COPYRIGHT
+
+=back
+
+=head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
+strings
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+encode_qp($str), decode_qp($str);
+
+=item COPYRIGHT
+
+=back
+
 =head2 Math::BigFloat - Arbitrary length float math package
 
 =over 4
@@ -11011,10 +11432,16 @@ cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
 
 =back
 
-=item GREAT CIRCLE DISTANCES
+=item GREAT CIRCLE DISTANCES AND DIRECTIONS
 
 =item EXAMPLES
 
+=over 4
+
+=item CAVEAT FOR GREAT CIRCLE FORMULAS
+
+=back
+
 =item BUGS
 
 =item AUTHORS
@@ -11027,6 +11454,8 @@ cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
 
 =item SYNOPSIS
 
+=item DESCRIPTION
+
 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
 
 =item DIAGNOSTICS
@@ -11058,8 +11487,6 @@ $timeout]);, $p->close();, pingecho($host [, $timeout]);
 
 =back
 
-=item WARNING
-
 =item NOTES
 
 =back
@@ -11152,6 +11579,8 @@ functions
 
 =item SYNOPSIS
 
+=item DESCRIPTION
+
 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
 
 =item DIAGNOSTICS
@@ -11387,6 +11816,57 @@ Constants, Macros
 
 =back
 
+=head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
+name space
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+unix, stdio, perlio, crlf, utf8, raw
+
+=over 4
+
+=item Defaults and how to override them
+
+=back
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
+=head2 PerlIO::Scalar - support module for in-memory IO.
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
+=head2 PerlIO::Via - Helper class for PerlIO layers implemented in perl
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+$class->PUSHED([$mode][,$fh]), $obj->POPPED([$fh]),
+$class->OPEN($path,$mode[,$fh]), $class->FDOPEN($fd),
+$class->SYSOPEN($path,$imode,$perm,$fh), $obj->FILENO($fh),
+$obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
+$obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
+$obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
+$obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
+
+=back
+
 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
 
 =over 4
@@ -11424,18 +11904,16 @@ after =back
 =item Warnings
 
 multiple occurence of link target I<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
 
@@ -12682,6 +13160,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
@@ -12820,9 +13330,11 @@ C<tkRunning>, C<ornaments>, C<newTTY>
 
 =item ENVIRONMENT
 
+=item CAVEATS
+
 =back
 
-=head2  Test - provides a simple framework for writing test scripts
+=head2 Test - provides a simple framework for writing test scripts
 
 =over 4
 
@@ -12856,7 +13368,7 @@ NORMAL TESTS, SKIPPED TESTS, TODO TESTS
 
 =item The test script output
 
-B<1..M>, B<'ok', 'not ok'.  Ok?>, B<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<Todo tests>, B<Bail out!>, B<Comments>
 
@@ -12897,6 +13409,75 @@ C<HARNESS_ACTIVE>
 
 =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
 
@@ -13276,6 +13857,24 @@ PID), Win32::UnregisterServer(LIBRARYNAME)
 
 =back
 
+=head2 XS::Typemap - module to test the XS typemaps distributed with perl
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
+=over 4
+
+=item NOTES
+
+=item AUTHOR
+
+=back
+
 =head2 XSLoader - Dynamically load C libraries into Perl code
 
 =over 4