Document tests failing when threaded, since we now have more.
[p5sagit/p5-mst-13.2.git] / pod / perl.pod
index ce0d1b4..6138274 100644 (file)
@@ -22,36 +22,30 @@ For ease of access, the Perl manual has been split up into several sections:
     perlsyn            Perl syntax
     perldata           Perl data structures
     perlop             Perl operators and precedence
+    perlsub            Perl subroutines
+    perlfunc           Perl builtin functions
     perlreftut         Perl references short introduction
     perldsc            Perl data structures intro
-    perllol            Perl data structures: arrays of arrays
     perlrequick                Perl regular expressions quick start
-    perlretut          Perl regular expressions tutorial
+    perlpod            Perl plain old documentation
+    perlstyle          Perl style guide
+    perltrap           Perl traps for the unwary
 
+    perlrun            Perl execution and options
+    perldiag           Perl diagnostic messages
     perllexwarn                Perl warnings and their control
+    perldebtut         Perl debugging tutorial
     perldebug          Perl debugging
 
-    perlrun            Perl execution and options
-    perlfunc           Perl builtin functions
-    perlopentut                Perl open() tutorial
     perlvar            Perl predefined variables
-    perlsub            Perl subroutines
-    perlmod            Perl modules: how they work
-    perlpod            Perl plain old documentation
-
-    perlstyle          Perl style guide
-    perlmodlib         Perl modules: how to write and use
-    perlmodinstall     Perl modules: how to install from CPAN
-    perlnewmod         Perl modules: preparing a new module for distribution
-    perltrap           Perl traps for the unwary
-    perlport           Perl portability guide
-    perlsec            Perl security
+    perllol            Perl data structures: arrays of arrays
+    perlopentut                Perl open() tutorial
+    perlretut          Perl regular expressions tutorial
 
-    perlref            Perl references, the rest of the story
     perlre             Perl regular expressions, the rest of the story
+    perlref            Perl references, the rest of the story
+
     perlform           Perl formats
-    perllocale         Perl locale support
-    perlunicode                Perl unicode support
 
     perlboot           Perl OO tutorial for beginners
     perltoot           Perl OO tutorial, part 1
@@ -61,11 +55,22 @@ For ease of access, the Perl manual has been split up into several sections:
     perltie            Perl objects hidden behind simple variables
 
     perlipc            Perl interprocess communication
-    perlnumber         Perl number semantics
     perlfork           Perl fork() information
+    perlnumber         Perl number semantics
     perlthrtut         Perl threads tutorial
 
-    perldiag           Perl diagnostic messages
+    perlport           Perl portability guide
+    perllocale         Perl locale support
+    perlunicode                Perl unicode support
+    perlebcdic         Considerations for running Perl on EBCDIC platforms
+
+    perlsec            Perl security
+
+    perlmod            Perl modules: how they work
+    perlmodlib         Perl modules: how to write and use
+    perlmodinstall     Perl modules: how to install from CPAN
+    perlnewmod         Perl modules: preparing a new module for distribution
+
     perlfaq1           General Questions About Perl
     perlfaq2           Obtaining and Learning about Perl
     perlfaq3           Programming Tools
@@ -82,6 +87,7 @@ For ease of access, the Perl manual has been split up into several sections:
     perldebguts                Perl debugging guts and tips
     perlxstut          Perl XS tutorial
     perlxs             Perl XS application programming interface
+    perlclib           Internal replacements for standard C library functions
     perlguts           Perl internal functions for those doing extensions
     perlcall           Perl calling conventions from C
     perlutil           utilities packaged with the Perl distribution
@@ -89,24 +95,45 @@ For ease of access, the Perl manual has been split up into several sections:
     perldbmfilter      Perl DBM filters
     perlapi            Perl API listing (autogenerated)
     perlintern         Perl internal functions (autogenerated)
+    perliol            C API for Perl's implementation of IO in Layers
     perlapio           Perl internal IO abstraction interface
     perltodo           Perl things to do
     perlhack           Perl hackers guide
 
     perlhist           Perl history records
     perldelta          Perl changes since previous version
+    perl572delta       Perl changes in version 5.7.2
+    perl571delta       Perl changes in version 5.7.1
+    perl570delta       Perl changes in version 5.7.0
     perl56delta                Perl changes in version 5.6
     perl5005delta      Perl changes in version 5.005
     perl5004delta      Perl changes in version 5.004
 
-    perlamiga          Perl notes for Amiga
+    perlaix            Perl notes for AIX
+    perlamiga          Perl notes for AmigaOS
+    perlapollo         Perl notes for Apollo DomainOS
+    perlbeos           Perl notes for BeOS
+    perlbs2000         Perl notes for POSIX-BC BS2000
     perlcygwin         Perl notes for Cygwin
+    perldgux           Perl notes for DG/UX
     perldos            Perl notes for DOS
+    perlepoc           Perl notes for EPOC
     perlhpux           Perl notes for HP-UX
+    perlhurd           Perl notes for Hurd
     perlmachten                Perl notes for Power MachTen
+    perlmacos          Perl notes for Mac OS (Classic)
+    perlmint           Perl notes for MiNT
+    perlmpeix          Perl notes for MPE/iX
+    perlnetware                Perl notes for NetWare
     perlos2            Perl notes for OS/2
     perlos390          Perl notes for OS/390
+    perlplan9          Perl notes for Plan 9
+    perlqnx            Perl notes for QNX
+    perlsolaris        Perl notes for Solaris
+    perltru64          Perl notes for Tru64
+    perlvmesa          Perl notes for VM/ESA
     perlvms            Perl notes for VMS
+    perlvos            Perl notes for Stratus VOS
     perlwin32          Perl notes for Windows
 
 (If you're intending to read these straight through for the first time,
@@ -180,58 +207,85 @@ But wait, there's more...
 Begun in 1993 (see L<perlhist>), Perl version 5 is nearly a complete
 rewrite that provides the following additional benefits:
 
-=over
+=over 4
+
+=item *
 
-=item * modularity and reusability using innumerable modules 
+modularity and reusability using innumerable modules 
 
 Described in L<perlmod>, L<perlmodlib>, and L<perlmodinstall>.
 
-=item * embeddable and extensible 
+=item *
+
+embeddable and extensible 
 
 Described in L<perlembed>, L<perlxstut>, L<perlxs>, L<perlcall>,
 L<perlguts>, and L<xsubpp>.
 
-=item * roll-your-own magic variables (including multiple simultaneous DBM implementations)
+=item *
+
+roll-your-own magic variables (including multiple simultaneous DBM implementations)
 
 Described in L<perltie> and L<AnyDBM_File>.
 
-=item * subroutines can now be overridden, autoloaded, and prototyped
+=item *
+
+subroutines can now be overridden, autoloaded, and prototyped
 
 Described in L<perlsub>.
 
-=item * arbitrarily nested data structures and anonymous functions
+=item *
+
+arbitrarily nested data structures and anonymous functions
 
 Described in L<perlreftut>, L<perlref>, L<perldsc>, and L<perllol>.
 
-=item * object-oriented programming
+=item *
+
+object-oriented programming
 
 Described in L<perlobj>, L<perltoot>, and L<perlbot>.
 
-=item * compilability into C code or Perl bytecode
+=item *
+
+compilability into C code or Perl bytecode
 
 Described in L<B> and L<B::Bytecode>.
 
-=item * support for light-weight processes (threads)
+=item *
+
+support for light-weight processes (threads)
 
 Described in L<perlthrtut> and L<Thread>.
 
-=item * support for internationalization, localization, and Unicode 
+=item *
+
+support for internationalization, localization, and Unicode 
 
 Described in L<perllocale> and L<utf8>.
 
-=item * lexical scoping
+=item *
+
+lexical scoping
 
 Described in L<perlsub>.
 
-=item * regular expression enhancements
+=item *
+
+regular expression enhancements
 
 Described in L<perlre>, with additional examples in L<perlop>.
 
-=item * enhanced debugger and interactive Perl environment, with integrated editor support
+=item *
+
+enhanced debugger and interactive Perl environment,
+with integrated editor support
 
 Described in L<perldebug>.
 
-=item * POSIX 1003.1 compliant library
+=item *
+
+POSIX 1003.1 compliant library
 
 Described in L<POSIX>.
 
@@ -311,7 +365,7 @@ affected by wraparound).
 
 You may mail your bug reports (be sure to include full configuration
 information as output by the myconfig program in the perl source
-tree, or by C<perl -V>) to perlbug@perl.com .  If you've succeeded
+tree, or by C<perl -V>) to perlbug@perl.org .  If you've succeeded
 in compiling perl, the B<perlbug> script in the F<utils/> subdirectory
 can be used to help mail in a bug report.