retry [PATCH] 5.004_59: the perlhist.pod etc
authorJarkko Hietaniemi <jhi@iki.fi>
Thu, 19 Feb 1998 17:54:52 +0000 (19:54 +0200)
committerMalcolm Beattie <mbeattie@sable.ox.ac.uk>
Fri, 20 Feb 1998 12:51:42 +0000 (12:51 +0000)
p4raw-id: //depot/perl@557

ext/Thread/Thread.pm
ext/Thread/Thread/Queue.pm
ext/Thread/Thread/Semaphore.pm
ext/Thread/Thread/Specific.pm
lib/fields.pm
pod/buildtoc
pod/perl.pod
pod/perlhist.pod
pod/perltoc.pod
pod/perlvar.pod

index 48ca304..cf7069c 100644 (file)
@@ -8,6 +8,38 @@ $VERSION = "1.0";
 @ISA = qw(Exporter DynaLoader);
 @EXPORT_OK = qw(yield cond_signal cond_broadcast cond_wait async);
 
+=head1 NAME
+
+Thread - multithreading
+
+=head1 SYNOPSIS
+
+    use Thread;
+
+    my $t = new Thread \&start_sub, @start_args;
+
+    $t->join;
+
+    my $tid = Thread->self->tid; 
+
+    my $tlist = Thread->list;
+
+    lock($scalar);
+
+    use Thread 'async';
+
+    use Thread 'eval';
+
+=head1 DESCRIPTION
+
+The C<Threads> module provides multithreading.
+
+=head1 SEE ALSO
+
+L<attrs>, L<Thread::Queue>, L<Thread::Semaphore>, L<Thread::Specific>.
+
+=cut
+
 #
 # Methods
 #
index 4eef978..9821773 100644 (file)
@@ -1,6 +1,19 @@
 package Thread::Queue;
 use Thread qw(cond_wait cond_broadcast);
 
+=head1 NAME
+
+Thread::Queue - thread-safe queues
+
+=head1 SYNOPSIS
+
+    use Thread::Queue;
+    my $q = new Thread::Queue;
+    $q->enqueue("foo", "bar");
+    my $foo = $q->dequeue;     # The "bar" is still in the queue.
+
+=cut
+
 sub new {
     my $class = shift;
     return bless [@_], $class;
index 9e5852f..4e1bb7d 100644 (file)
@@ -1,6 +1,25 @@
 package Thread::Semaphore;
 use Thread qw(cond_wait cond_broadcast);
 
+=head1 NAME
+
+Thread::Semaphore - thread-safe semaphores
+
+=head1 SYNOPSIS
+
+    use Thread::Semaphore;
+    my $s = new Thread::Semaphore;
+    $s->up;    # Also known as the semaphore V -operation.
+    # The guarded section is here
+    $s->down;  # Also known as the semaphore P -operation.
+
+    # The default semaphore value is 1.
+    my $s = new Thread::Semaphore($initial_value);
+    $s->up($up_value);
+    $s->down($up_value);
+
+=cut
+
 sub new {
     my $class = shift;
     my $val = @_ ? shift : 1;
index ec56539..c3591f4 100644 (file)
@@ -1,5 +1,16 @@
 package Thread::Specific;
 
+=head1 NAME
+
+Thread::Specific - thread-specific keys
+
+=head1 SYNOPSIS
+
+    use Thread::Specific;
+    my $k = key_create Thread::Specific;
+
+=cut
+
 sub import {
     use attrs qw(locked method);
     require fields;
index 8e2d639..c2cf1d6 100644 (file)
@@ -1,5 +1,28 @@
 package fields;
 
+=head1 NAME
+
+fields - compile-time class fields
+
+=head1 SYNOPSIS
+
+    {
+        package Foo;
+        use fields qw(foo bar baz);
+    }
+    ...
+    my Foo $var = new Foo;
+    $var->{foo} = 42;
+
+    # This will generate a compile-time error.
+    $var->{zap} = 42;
+
+=head1 DESCRIPTION
+
+The C<fields> pragma enables compile-time verified class fields.
+
+=cut
+
 sub import {
     my $class = shift;
     my ($package) = caller;
index d657d68..bd880c3 100644 (file)
@@ -12,6 +12,7 @@ sub output ($);
           perllol perltoot perlobj perltie perlbot perlipc perldebug
           perldiag perlsec perltrap perlstyle perlpod perlbook
           perlembed perlapio perlxs perlxstut perlguts perlcall
+          perlhist
          );
 
 for (@pods) { s/$/.pod/ }
@@ -171,7 +172,7 @@ sub podset {
            output $_; nl(); next;
 
        }
-       if (s/^=item (.*)\n/$1/) {
+       if (s/^=item ([^=].*)\n/$1/) {
            next if $pod eq 'perldiag';
            s/^\s*\*\s*$// && next;
            s/^\s*\*\s*//;
index e989eba..41481a3 100644 (file)
@@ -60,6 +60,8 @@ of sections:
     perlguts   Perl internal functions for those doing extensions
     perlcall   Perl calling conventions from C
 
+    perlhist   Perl history records
+
 (If you're intending to read these straight through for the first time,
 the suggested order will tend to reduce the number of forward references.)
 
index 9113ed9..163fe03 100644 (file)
@@ -6,7 +6,7 @@ perlhist - the Perl history records
 
 =for RCS
 #
-# $Id: perlhist.pod,v 1.27 1998/01/16 19:50:20 jhi Exp $
+# $Id: perlhist.pod,v 1.29 1998/02/19 15:49:17 jhi Exp $
 #
 =end RCS
 
@@ -18,15 +18,15 @@ This document aims to record the Perl source code releases.
 
 Perl history in brief, by Larry Wall:
 
-    Perl 0 introduced Perl to my officemates.
-    Perl 1 introduced Perl to the world, and changed /\(...\|...\)/ to
-       /(...|...)/.  \(Dan Faigin still hasn't forgiven me. :-\)
+   Perl 0 introduced Perl to my officemates.
+   Perl 1 introduced Perl to the world, and changed /\(...\|...\)/ to
+        /(...|...)/.  \(Dan Faigin still hasn't forgiven me. :-\)
     Perl 2 introduced Henry Spencer's regular expression package.
     Perl 3 introduced the ability to handle binary data (embedded nulls).
     Perl 4 introduced the first Camel book.  Really.  We mostly just
-       switched version numbers so the book could refer to 4.000.
+        switched version numbers so the book could refer to 4.000.
     Perl 5 introduced everything else, including the ability to
-       introduce everything else.
+        introduce everything else.
 
 =head1 THE KEEPERS OF THE PUMPKIN
 
@@ -65,19 +65,19 @@ the pumpking or the pumpkineer.
                                          for details)
  ===========================================================================
 
- Larry   0              Classified.    Don't ask.
+ Larry   0              Classified.     Don't ask.
 
  Larry   1.000          1987-Dec-18
-                                  
+                                   
           1.001..10     1988-Jan-30
           1.011..14     1988-Feb-02
-                                  
+                                   
  Larry   2.000          1988-Jun-05
-                                  
+                                   
           2.001         1988-Jun-28
-                                  
+                                   
  Larry   3.000          1989-Oct-18
-                                  
+                                   
           3.001         1989-Oct-26
           3.002..4      1989-Nov-11
           3.005         1989-Nov-18
@@ -86,7 +86,7 @@ the pumpking or the pumpkineer.
           3.014         1990-Mar-13
           3.015         1990-Mar-14
           3.016..18     1990-Mar-28
-          3.019..27     1990-Aug-10    User subs.
+          3.019..27     1990-Aug-10     User subs.
           3.028         1990-Aug-14
           3.029..36     1990-Oct-17
           3.037         1990-Oct-20
@@ -94,19 +94,19 @@ the pumpking or the pumpkineer.
           3.041         1990-Nov-13
           3.042..43     1990-Jan-91
           3.044         1991-Jan-12
-                                  
+                                   
  Larry   4.000          1991-Mar-21
-                                  
+                                   
           4.001..3      1991-Apr-12
           4.004..9      1991-Jun-07
           4.010         1991-Jun-10
           4.011..18     1991-Nov-05
-          4.019         1991-Nov-11    Stable.
+          4.019         1991-Nov-11     Stable.
           4.020..33     1992-Jun-08
           4.034         1992-Jun-11
           4.035         1992-Jun-23
- Larry    4.036         1993-Feb-05    Very stable.
-                                  
+ Larry    4.036         1993-Feb-05     Very stable.
+                                   
           5.000alpha1   1993-Jul-31
           5.000alpha2   1993-Aug-16
           5.000alpha3   1993-Oct-10
@@ -115,10 +115,10 @@ the pumpking or the pumpkineer.
           5.000alpha6   1993-Mar-18
           5.003alpha7   1994-Mar-25
  Andy     5.000alpha8   1994-Apr-04
- Larry    5.000alpha9   1994-May-05
+ Larry    5.000alpha9   1994-May-05     ext appears.
           5.000alpha10  1994-???-??
           5.000alpha11  1994-???-??
- Andy     5.000a11a     1994-Jul-07    To fit 14.
+ Andy     5.000a11a     1994-Jul-07     To fit 14.
           5.000a11b     1994-Jul-14
           5.000a11c     1994-Jul-19
           5.000a11d     1994-Jul-22
@@ -133,7 +133,7 @@ the pumpking or the pumpkineer.
           5.000a12h     1994-Aug-24
  Larry    5.000beta1    1994-???-??
  Andy     5.000b1a      1994-???-??
- Larry    5.000beta2    1994-Sep-14    Core slushified.
+ Larry    5.000beta2    1994-Sep-14     Core slushified.
  Andy     5.000b2a      1994-Sep-14
           5.000b2b      1994-Sep-17
           5.000b2c      1994-Sep-17
@@ -146,9 +146,9 @@ the pumpking or the pumpkineer.
           5.000b3f      1994-Sep-30
           5.000b3g      1994-Oct-04
  Andy     5.000b3h      1994-Oct-07
-                                  
+                                   
  Larry   5.000          1994-Oct-18
-                                  
+                                   
  Andy     5.000a        1994-Dec-19
           5.000b        1995-Jan-18
           5.000c        1995-Jan-18
@@ -163,23 +163,23 @@ the pumpking or the pumpkineer.
           5.000l        1995-Feb-21
           5.000m        1995-???-??
           5.000n        1995-Mar-07
-                                  
+                                   
  Larry   5.001          1995-Mar-13
-                                  
+                                   
  Andy     5.001a        1995-Mar-15
           5.001b        1995-Mar-31
           5.001c        1995-Apr-07
           5.001d        1995-Apr-14
-          5.001e        1995-Apr-18    Stable.
+          5.001e        1995-Apr-18     Stable.
           5.001f        1995-May-31
           5.001g        1995-May-25
           5.001h        1995-May-25
           5.001i        1995-May-30
           5.001j        1995-Jun-05
           5.001k        1995-Jun-06
-          5.001l        1995-Jun-06    Stable.
-          5.001m        1995-Jul-02    Very stable.
-          5.001n        1995-Oct-31    Very unstable.
+          5.001l        1995-Jun-06     Stable.
+          5.001m        1995-Jul-02     Very stable.
+          5.001n        1995-Oct-31     Very unstable.
           5.002beta1    1995-Nov-21
           5.002b1a      1995-Nov-??
           5.002b1b      1995-Dec-04
@@ -187,19 +187,19 @@ the pumpking or the pumpkineer.
           5.002b1d      1995-Dec-04
           5.002b1e      1995-Dec-08
           5.002b1f      1995-Dec-08
- Tom      5.002b1g      1995-Dec-21    Doc release.
+ Tom      5.002b1g      1995-Dec-21     Doc release.
  Andy     5.002b1h      1996-Jan-05
-         5.002b2       1996-Jan-14
- Larry   5.002b3       1996-Feb-02
+          5.002b2       1996-Jan-14
+ Larry    5.002b3       1996-Feb-02
  Andy     5.002gamma    1996-Feb-11
  Larry    5.002delta    1996-Feb-27
-                                  
+                                   
  Larry   5.002          1996-Feb-29
-                                  
+                                   
  Charles  5.002_01      1996-Mar-25
-                                  
-         5.003          1996-Jun-25    Security release.
-                                  
+                                   
+         5.003          1996-Jun-25     Security release.
+                                   
           5.003_01      1996-Jul-31
  Nick     5.003_02      1996-Aug-10
  Andy     5.003_03      1996-Aug-28
@@ -228,14 +228,14 @@ the pumpking or the pumpkineer.
           5.003_26      1997-Feb-10
           5.003_27      1997-Feb-18
           5.003_28      1997-Feb-21
-          5.003_90      1997-Feb-25    Ramping up to the 5.004 release.
+          5.003_90      1997-Feb-25     Ramping up to the 5.004 release.
           5.003_91      1997-Mar-01
           5.003_92      1997-Mar-06
           5.003_93      1997-Mar-10
           5.003_94      1997-Mar-22
           5.003_95      1997-Mar-25
           5.003_96      1997-Apr-01
-          5.003_97      1997-Apr-03    Fairly widely used.
+          5.003_97      1997-Apr-03     Fairly widely used.
           5.003_97a     1997-Apr-05
           5.003_97b     1997-Apr-08
           5.003_97c     1997-Apr-10
@@ -249,23 +249,26 @@ the pumpking or the pumpkineer.
           5.003_98      1997-Apr-30
           5.003_99      1997-May-01
           5.003_99a     1997-May-09
-          p54rc1        1997-May-12    Release Candidates.
-          p54rc2        1997-May-14    
-                                  
- Chip    5.004          1997-May-15    A major maintenance release.
-                                  
- Tim      5.004_01      1997-Jun-13    The 5.004 maintenance track.
+          p54rc1        1997-May-12     Release Candidates.
+          p54rc2        1997-May-14     
+                                   
+ Chip    5.004          1997-May-15     A major maintenance release.
+                                   
+ Tim      5.004_01      1997-Jun-13     The 5.004 maintenance track.
           5.004_02      1997-Aug-07
           5.004_03      1997-Sep-05
           5.004_04      1997-Oct-15
-                                  
- Malcolm  5.004_50      1997-Sep-09    The 5.005 development track.
+                                   
+ Malcolm  5.004_50      1997-Sep-09     The 5.005 development track.
           5.004_51      1997-Oct-02
           5.004_52      1997-Oct-15
           5.004_53      1997-Oct-16
           5.004_54      1997-Nov-14
           5.004_55      1997-Nov-25
           5.004_56      1997-Dec-18
+          5.004_57      1998-Feb-03
+          5.004_58      1998-Feb-06
+          5.004_59      1998-Feb-13
 
 =head2 SELECTED RELEASE SIZES
 
@@ -273,44 +276,45 @@ For example the notation "core: 212  29" in the release 1.000 means that
 it had in the core 212 kilobytes, in 29 files.  The "core".."doc" are
 explained below.
 
- release       core       lib         ext        t         doc
+ release        core       lib         ext        t         doc
  ======================================================================
 
- 1.000          212  29      -   -      -   -     38  51     62   3
- 1.014          219  29      -   -      -   -     39  52     68   4
- 2.000          309  31      2   3      -   -     55  57     92   4
- 2.001          312  31      2   3      -   -     55  57     94   4
- 3.000          508  36     24  11      -   -     79  73    156   5
- 3.044          645  37     61  20      -   -     90  74    190   6
- 4.000          635  37     59  20      -   -     91  75    198   4
- 4.019          680  37     85  29      -   -     98  76    199   4
- 4.036          709  37     89  30      -   -     98  76    208   5
- 5.000alpha2    785  50    114  32      -   -    112  86    209   5
- 5.000a3        801  50    117  33      -   -    121  87    209   5
- 5.000a9       1022  56    149  43    116  29    125  90    217   6
+ 1.000           212  29      -   -      -   -     38  51     62   3
+ 1.014           219  29      -   -      -   -     39  52     68   4
+ 2.000           309  31      2   3      -   -     55  57     92   4
+ 2.001           312  31      2   3      -   -     55  57     94   4
+ 3.000           508  36     24  11      -   -     79  73    156   5
+ 3.044           645  37     61  20      -   -     90  74    190   6
+ 4.000           635  37     59  20      -   -     91  75    198   4
+ 4.019           680  37     85  29      -   -     98  76    199   4
+ 4.036           709  37     89  30      -   -     98  76    208   5
+ 5.000alpha2     785  50    114  32      -   -    112  86    209   5
+ 5.000a3         801  50    117  33      -   -    121  87    209   5
+ 5.000a9        1022  56    149  43    116  29    125  90    217   6
  5.000a12h       978  49    140  49    205  46    152  97    228   9
  5.000beta3h    1035  53    232  70    216  38    162  94    218  21
- 5.000         1038  53    250  76    216  38    154  92    536  62
- 5.001m                1071  54    388  82    240  38    159  95    544  29
- 5.002         1121  54    661 101    287  43    155  94    847  35
- 5.003         1129  54    680 102    291  43    166 100    853  35
- 5.003_07      1231  60    748 106    396  53    213 137    976  39
- 5.004         1351  60   1230 136    408  51    355 161   1587  55
- 5.004_01      1356  60   1258 138    410  51    358 161   1587  55 
- 5.004_04      1375  60   1294 139    413  51    394 162   1629  55
- 5.004_51      1401  61   1260 140    413  53    358 162   1594  56
- 5.004_53      1422  62   1295 141    438  70    394 162   1637  56
- 5.004_56      1501  66   1301 140    447  74    408 165   1648  57
+ 5.000          1038  53    250  76    216  38    154  92    536  62
+ 5.001m         1071  54    388  82    240  38    159  95    544  29
+ 5.002          1121  54    661 101    287  43    155  94    847  35
+ 5.003          1129  54    680 102    291  43    166 100    853  35
+ 5.003_07       1231  60    748 106    396  53    213 137    976  39
+ 5.004          1351  60   1230 136    408  51    355 161   1587  55
+ 5.004_01       1356  60   1258 138    410  51    358 161   1587  55 
+ 5.004_04       1375  60   1294 139    413  51    394 162   1629  55
+ 5.004_51       1401  61   1260 140    413  53    358 162   1594  56
+ 5.004_53       1422  62   1295 141    438  70    394 162   1637  56
+ 5.004_56       1501  66   1301 140    447  74    408 165   1648  57
+ 5.004_59       1555  72   1317 142    448  74    424 171   1678  58   
 
 The "core"..."doc" mean the following files from the Perl source code
 distribution.  The glob notation ** means recursively, (.) means
 regular files.
 
- core  *.[hcy]
- lib   lib/**/*.p[ml]
- ext   ext/**/*.{[hcyt],xs,pm}
- t     t/**/*(.)
- doc   {README*,INSTALL,*[_.]man{,.?},pod/**/*.pod}
+ core   *.[hcy]
+ lib    lib/**/*.p[ml]
+ ext    ext/**/*.{[hcyt],xs,pm}
+ t      t/**/*(.)
+ doc    {README*,INSTALL,*[_.]man{,.?},pod/**/*.pod}
 
 Here are some statistics for the other subdirectories and one file in
 the Perl source distribution for somewhat more selected releases.
@@ -318,8 +322,8 @@ the Perl source distribution for somewhat more selected releases.
  ======================================================================
    Legend:  kB   #
 
-           1.014   2.001   3.044   4.000   4.019   4.036   
-                                                             
+            1.014   2.001   3.044   4.000   4.019   4.036   
+                                                              
  atarist      -  -    -  -    -  -    -  -    -  -  113 31  
  Configure   31  1   37  1   62  1   73  1   83  1   86  1  
  eg           -  -   34 28   47 39   47 39   47 39   47 39  
@@ -333,8 +337,8 @@ the Perl source distribution for somewhat more selected releases.
 
  ======================================================================
 
-           5.000a2 5.000a12h 5.000b3h 5.000  5.001m  5.002   5.003   
-                                                                     
+            5.000a2 5.000a12h 5.000b3h 5.000  5.001m  5.002   5.003   
+                                                                      
  atarist    113 31  113 31    -  -      -  -    -  -    -  -    -  -
  bench        -  -    0  1    -  -      -  -    -  -    -  -    -  -
  Bugs         2  5   26  1    -  -      -  -    -  -    -  -    -  -
@@ -356,22 +360,22 @@ the Perl source distribution for somewhat more selected releases.
 
  ======================================================================
 
-           5.003_07 5.004   5.004_04 5.004_56
-                                             
- Configure  217  1   225  1  225  1   232  1  
+            5.003_07 5.004   5.004_04 5.004_59
+                                              
+ Configure  217  1   225  1  225  1   240  1  
  cygwin32     -  -    23  5   23  5    23  5  
  djgpp        -  -     -  -    -  -    15  5
  eg          54 44    81 62   81 62    81 62
  emacs      143  1   194  1  204  1   212  2
  h2pl        12 12    12 12   12 12    12 12
- hints       90 62   129 69  132 71   138 72
+ hints       90 62   129 69  132 71   139 72
  os2        117 42   121 42  127 42   134 44
  plan9       79 15    82 15   82 15    82 15
  Porting     51  1    94  2  109  4   109  4
  qnx          -  -     1  2    1  2     1  2
- utils       97  7   112  8  118  8   118  8
- vms        505 27   518 34  524 34   538 34
- win32        -  -   285 33  378 36   449 38
+ utils       97  7   112  8  118  8   123  8
+ vms        505 27   518 34  524 34   536 34
+ win32        -  -   285 33  378 36   464 39
  x2p        280 19   281 19  281 19   281 19
 
 =head2 SELECTED PATCH SIZES
index d3f3a81..4def4c7 100644 (file)
@@ -863,10 +863,14 @@ CGI script to do bad things?
 
 =item Fixed parsing of $$<digit>, &$<digit>, etc.
 
+=item Fixed localization of $<digit>, $&, etc.
+
 =item No resetting of $. on implicit close
 
 =item C<wantarray> may return undef
 
+=item C<eval EXPR> determines value of EXPR in scalar context
+
 =item Changes to tainting checks
 
 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
@@ -911,7 +915,7 @@ LIST, READLINE this, GETC this, DESTROY this
 
 =item Malloc enhancements
 
--DDEBUGGING_MSTATS, -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
+-DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
 
 =item Miscellaneous efficiency enhancements
 
@@ -1132,7 +1136,7 @@ unary &, unary *, (TYPE)
 
 =item Regexp Quote-Like Operators
 
-?PATTERN?, m/PATTERN/gimosx, /PATTERN/gimosx, q/STRING/, C<'STRING'>,
+?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
 qq/STRING/, "STRING", qx/STRING/, `STRING`, qw/STRING/,
 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
 y/SEARCHLIST/REPLACEMENTLIST/cds
@@ -1157,7 +1161,10 @@ i, m, s, x
 
 =item Regular Expressions
 
-(?#text), (?:regexp), (?=regexp), (?!regexp), (?imsx)
+C<(?#text)>, C<(?:regexp)>, C<(?=regexp)>, C<(?!regexp)>, C<(?<=regexp)>,
+C<(?<!regexp)>, C<(?{ code })>, C<(?E<gt>regexp)>,
+C<(?(condition)yes-regexp|no-regexp)>, C<(?(condition)yes-regexp)>,
+C<(?imsx)>
 
 =item Backtracking
 
@@ -1183,8 +1190,8 @@ OS/2, MS-DOS, Win95/NT, Macintosh
 
 =item Switches
 
-B<-0>[I<digits>], B<-a>, B<-c>, B<-d>, B<-d:>I<foo>, B<-D>I<number>,
-B<-D>I<list>, B<-e> I<commandline>, B<-F>I<pattern>, B<-h>,
+B<-0>[I<digits>], B<-a>, B<-c>, B<-d>, B<-d:>I<foo>, B<-D>I<letters>,
+B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>, B<-h>,
 B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
 B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
@@ -1221,7 +1228,7 @@ in perl5
 
 =item Alphabetical Listing of Perl Functions
 
--I<X> FILEHANDLE, -I<X> EXPR, -I<X>, abs VALUE, abs, accept
+I<-X> FILEHANDLE, I<-X> EXPR, I<-X>, abs VALUE, abs, accept
 NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
 binmode FILEHANDLE, bless REF,CLASSNAME, bless REF, caller EXPR, caller,
 chdir EXPR, chmod LIST, chomp VARIABLE, chomp LIST, chomp, chop VARIABLE,
@@ -1258,18 +1265,19 @@ LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST, printf FORMAT,
 LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/, qq/STRING/,
 qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta, rand EXPR, rand, read
 FILEHANDLE,SCALAR,LENGTH,OFFSET, read FILEHANDLE,SCALAR,LENGTH, readdir
-DIRHANDLE, readlink EXPR, readlink, recv SOCKET,SCALAR,LEN,FLAGS, redo
-LABEL, redo, ref EXPR, ref, rename OLDNAME,NEWNAME, 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,
-shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
-EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
+DIRHANDLE, readline EXPR, readlink EXPR, readlink, readpipe EXPR, recv
+SOCKET,SCALAR,LEN,FLAGS, redo LABEL, redo, ref EXPR, ref, rename
+OLDNAME,NEWNAME, 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, 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, split /PATTERN/,EXPR,LIMIT, split /PATTERN/,EXPR,
@@ -1316,9 +1324,10 @@ $CHILD_ERROR, $?, $OS_ERROR, $ERRNO, $!, $EXTENDED_OS_ERROR, $^E,
 $EVAL_ERROR, $@, $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<,
 $EFFECTIVE_USER_ID, $EUID, $>, $REAL_GROUP_ID, $GID, $(,
 $EFFECTIVE_GROUP_ID, $EGID, $), $PROGRAM_NAME, $0, $[, $PERL_VERSION, $],
-$DEBUGGING, $^D, $SYSTEM_FD_MAX, $^F, $^H, $INPLACE_EDIT, $^I, $OSNAME,
-$^O, $PERLDB, $^P, $BASETIME, $^T, $WARNING, $^W, $EXECUTABLE_NAME, $^X,
-$ARGV, @ARGV, @INC, %INC, $ENV{expr}, $SIG{expr}, $^M
+$DEBUGGING, $^D, $SYSTEM_FD_MAX, $^F, $^H, $INPLACE_EDIT, $^I, $^M,
+$OSNAME, $^O, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, $^S,
+$BASETIME, $^T, $WARNING, $^W, $EXECUTABLE_NAME, $^X, $ARGV, @ARGV, @INC,
+@_, %INC, %ENV $ENV{expr}, %SIG  $SIG{expr}
 
 =back
 
@@ -1390,16 +1399,16 @@ CPAN::Nox, Carp, Class::Struct, Config, Cwd, DB_File, Devel::SelfStubber,
 DirHandle, DynaLoader, English, Env, Exporter, ExtUtils::Embed,
 ExtUtils::Install, ExtUtils::Liblist, ExtUtils::MM_OS2, ExtUtils::MM_Unix,
 ExtUtils::MM_VMS, ExtUtils::MakeMaker, ExtUtils::Manifest,
-ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::testlib, Fcntl,
-File::Basename, File::CheckTree, File::Compare, File::Copy, File::Find,
-File::Path, File::stat, FileCache, FileHandle, FindBin, GDBM_File,
-Getopt::Long, Getopt::Std, I18N::Collate, IO, IO::File, IO::Handle,
-IO::Pipe, IO::Seekable, IO::Select, IO::Socket, IPC::Open2, IPC::Open3,
-Math::BigFloat, Math::BigInt, Math::Complex, Math::Trig, NDBM_File,
-Net::Ping, Net::hostent, Net::netent, Net::protoent, Net::servent, Opcode,
-Pod::Text, POSIX, SDBM_File, Safe, Search::Dict, SelectSaver, SelfLoader,
-Shell, Socket, Symbol, Sys::Hostname, Sys::Syslog, Term::Cap,
-Term::Complete, Term::ReadLine, Test::Harness, Text::Abbrev,
+ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::testlib, Fatal,
+Fcntl, File::Basename, File::CheckTree, File::Compare, File::Copy,
+File::Find, File::Path, File::stat, FileCache, FileHandle, FindBin,
+GDBM_File, Getopt::Long, Getopt::Std, I18N::Collate, IO, IO::File,
+IO::Handle, IO::Pipe, IO::Seekable, IO::Select, IO::Socket, IPC::Open2,
+IPC::Open3, Math::BigFloat, Math::BigInt, Math::Complex, Math::Trig,
+NDBM_File, Net::Ping, Net::hostent, Net::netent, Net::protoent,
+Net::servent, Opcode, Pod::Text, POSIX, SDBM_File, Safe, Search::Dict,
+SelectSaver, SelfLoader, Shell, Socket, Symbol, Sys::Hostname, Sys::Syslog,
+Term::Cap, Term::Complete, Term::ReadLine, Test::Harness, Text::Abbrev,
 Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Tie::Hash,
 Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::Local, Time::gmtime,
 Time::localtime, Time::tm, UNIVERSAL, User::grent, User::pwent
@@ -1964,8 +1973,8 @@ C<compactDump>, C<veryCompact>, C<globPrint>, C<DumpDBFiles>,
 C<DumpPackages>, C<quote>, C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>,
 C<noTTY>, C<ReadLine>, C<NonStop>, E<lt> [ command ], E<lt>E<lt> command,
 E<gt> command, E<gt>E<gt> command, { [ command ], {{ command, ! number, !
--number, ! pattern, !! cmd, H -number, q or ^D, R, |dbcmd, ||dbcmd, =
-[alias value], command, m expr, m package
+-number, ! pattern, !! cmd, H -number, q or ^D, R, |dbcmd, ||dbcmd,
+command, m expr, m package
 
 =item Debugger input/output
 
@@ -2061,8 +2070,7 @@ Numerical, Numerical, Numerical
 
 =item Precedence Traps
 
-Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
-Precedence
+Precedence, Precedence, Precedence, Precedence, Precedence, Precedence
 
 =item General Regular Expression Traps using s///, etc.
 
@@ -2089,7 +2097,8 @@ DBM, DBM
 
 =item Unclassified Traps
 
-Unclassified
+C<require>/C<do> trap using returned value, C<split> on empty string with
+LIMIT specified
 
 =back
 
@@ -2101,10 +2110,22 @@ Unclassified
 
 =item DESCRIPTION
 
+=over
+
+=item Verbatim Paragraph
+
+=item Command Paragraph
+
+=item Ordinary Block of Text
+
+=item The Intent
+
 =item Embedding Pods in Perl Modules
 
 =item Common Pod Pitfalls
 
+=back
+
 =item SEE ALSO
 
 =item AUTHOR
@@ -2165,8 +2186,8 @@ B<PerlIO *>, B<PerlIO_stdin()>, B<PerlIO_stdout()>, B<PerlIO_stderr()>,
 B<PerlIO_open(path, mode)>, B<PerlIO_fdopen(fd,mode)>,
 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
-B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(s,f)>,
-B<PerlIO_putc(c,f)>, B<PerlIO_ungetc(c,f)>, B<PerlIO_getc(f)>,
+B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
+B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_tell(f)>,
 B<PerlIO_seek(f,o,w)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
@@ -2365,6 +2386,17 @@ B<PerlIO_get_base(f)>, B<PerlIO_get_bufsiz(f)>
 
 =item Understanding the Magic of Tied Hashes and Arrays
 
+=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(f,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
 
 =item Subroutines
@@ -2410,8 +2442,8 @@ B<PerlIO_get_base(f)>, B<PerlIO_get_bufsiz(f)>
 AvFILL, av_clear, av_extend, av_fetch, av_len, av_make, av_pop, av_push,
 av_shift, av_store, av_undef, av_unshift, CLASS, Copy, croak, CvSTASH,
 DBsingle, DBsub, DBtrace, dMARK, dORIGMARK, dowarn, dSP, dXSARGS, dXSI32,
-dXSI32, ENTER, EXTEND, FREETMPS, G_ARRAY, G_DISCARD, G_EVAL, GIMME,
-GIMME_V, G_NOARGS, G_SCALAR, G_VOID, gv_fetchmeth, gv_fetchmethod,
+ENTER, EXTEND, FREETMPS, G_ARRAY, G_DISCARD, G_EVAL, GIMME, GIMME_V,
+G_NOARGS, G_SCALAR, G_VOID, gv_fetchmeth, gv_fetchmethod,
 gv_fetchmethod_autoload, gv_stashpv, gv_stashsv, GvSV, HEf_SVKEY, HeHASH,
 HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set, HeVAL, hv_clear,
 hv_delayfree_ent, hv_delete, hv_delete_ent, hv_exists, hv_exists_ent,
@@ -2421,26 +2453,30 @@ hv_store_ent, hv_undef, isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE,
 isUPPER, items, ix, LEAVE, MARK, mg_clear, mg_copy, mg_find, mg_free,
 mg_get, mg_len, mg_magical, mg_set, Move, na, New, Newc, Newz, newAV,
 newHV, newRV_inc, newRV_noinc, NEWSV, newSViv, newSVnv, newSVpv, newSVpvn,
-newSVpvf, newSVrv, newSVsv, newXS, newXSproto, Nullav, Nullch, Nullcv, Nullhv,
-Nullsv, ORIGMARK, perl_alloc, perl_call_argv, perl_call_method, perl_call_pv,
-perl_call_sv, perl_construct, perl_destruct, perl_eval_sv, perl_eval_pv,
-perl_free, perl_get_av, perl_get_cv, perl_get_hv, perl_get_sv, perl_parse,
-perl_require_pv, perl_run, POPi, POPl, POPp, POPn, POPs, PUSHMARK, PUSHi,
-PUSHn, PUSHp, PUSHs, PUTBACK, Renew, Renewc, RETVAL, safefree, safemalloc,
-saferealloc, savepv, savepvn, SAVETMPS, SP, SPAGAIN, ST, strEQ, strGE,
-strGT, strLE, strLT, strNE, strnEQ, strnNE, sv_2mortal, sv_bless, sv_catpv,
-sv_catpvn, sv_catpvf, sv_catsv, sv_cmp, sv_cmp, SvCUR, SvCUR_set, sv_dec,
-sv_dec, SvEND, sv_eq, SvGROW, sv_grow, sv_inc, SvIOK, SvIOK_off, SvIOK_on,
-SvIOK_only, SvIOK_only, SvIOKp, sv_isa, SvIV, sv_isobject, SvIVX, SvLEN,
-sv_len, sv_len, sv_magic, sv_mortalcopy, SvOK, sv_newmortal, sv_no, SvNIOK,
-SvNIOK_off, SvNIOKp, SvNOK, SvNOK_off, SvNOK_on, SvNOK_only, SvNOK_only,
-SvNOKp, SvNV, SvNVX, SvPOK, SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only,
-SvPOKp, SvPV, SvPVX, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK,
-SvROK_off, SvROK_on, SvRV, sv_setiv, sv_setnv, sv_setpv, sv_setpvn,
-sv_setpvf, sv_setref_iv, sv_setref_nv, sv_setref_pv, sv_setref_pvn,
-sv_setsv, SvSTASH, SVt_IV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG,
-SVt_NV, SvTRUE, SvTYPE, svtype, SvUPGRADE, sv_upgrade, sv_undef, sv_unref,
-sv_usepvn, sv_yes, THIS, toLOWER, toUPPER, warn, XPUSHi, XPUSHn, XPUSHp,
+newSVrv, newSVsv, newXS, newXSproto, Nullav, Nullch, Nullcv, Nullhv,
+Nullsv, ORIGMARK, perl_alloc, perl_call_argv, perl_call_method,
+perl_call_pv, perl_call_sv, perl_construct, perl_destruct, perl_eval_sv,
+perl_eval_pv, perl_free, perl_get_av, perl_get_cv, perl_get_hv,
+perl_get_sv, perl_parse, perl_require_pv, perl_run, POPi, POPl, POPp, POPn,
+POPs, PUSHMARK, PUSHi, PUSHn, PUSHp, PUSHs, PUTBACK, Renew, Renewc, RETVAL,
+safefree, safemalloc, saferealloc, savepv, savepvn, SAVETMPS, SP, SPAGAIN,
+ST, strEQ, strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, sv_2mortal,
+sv_bless, sv_catpv, sv_catpv_mg, sv_catpvn, sv_catpvn_mg, sv_catpvf,
+sv_catpvf_mg, sv_catsv, sv_catsv_mg, sv_cmp, SvCUR, SvCUR_set, sv_dec,
+SvEND, sv_eq, SvGETMAGIC, SvGROW, sv_grow, sv_inc, SvIOK, SvIOK_off,
+SvIOK_on, SvIOK_only, SvIOKp, sv_isa, SvIV, sv_isobject, SvIVX, SvLEN,
+sv_len, sv_magic, sv_mortalcopy, SvOK, sv_newmortal, sv_no, SvNIOK,
+SvNIOK_off, SvNIOKp, SvNOK, SvNOK_off, SvNOK_on, SvNOK_only, SvNOKp, SvNV,
+SvNVX, SvPOK, SvPOK_off, SvPOK_on, SvPOK_only, SvPOKp, SvPV, SvPVX,
+SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV,
+SvSETMAGIC, SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on, sv_setiv,
+sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv, sv_setpv_mg, sv_setpviv,
+sv_setpviv_mg, sv_setpvn, sv_setpvn_mg, sv_setpvf, sv_setpvf_mg,
+sv_setref_iv, sv_setref_nv, sv_setref_pv, sv_setref_pvn, SvSetSV,
+SvSetSV_nosteal, sv_setsv, sv_setsv_mg, sv_setuv, sv_setuv_mg, SvSTASH,
+SVt_IV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, SVt_NV, SvTRUE,
+SvTYPE, svtype, SvUPGRADE, sv_upgrade, sv_undef, sv_unref, sv_usepvn,
+sv_usepvn_mg, sv_yes, THIS, toLOWER, toUPPER, warn, XPUSHi, XPUSHn, XPUSHp,
 XPUSHs, XS, XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO,
 XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_YES, XST_mIV, XST_mNV,
 XST_mNO, XST_mPV, XST_mUNDEF, XST_mYES, XS_VERSION, XS_VERSION_BOOTCHECK,
@@ -2532,8 +2568,42 @@ callback
 
 =item DATE
 
+=head2 perlhist - the Perl history records
+
+=item DESCRIPTION
+
+=item INTRODUCTION
+
+=item THE KEEPERS OF THE PUMPKIN
+
+=over
+
+=item PUMPKIN?
+
+=back
+
+=item THE RECORDS
+
+=over
+
+=item SELECTED RELEASE SIZES
+
+=item SELECTED PATCH SIZES
+
+=back
+
+=item THE KEEPERS OF THE RECORDS
+
 =head1 PRAGMA DOCUMENTATION
 
+=head2 attrs - set/get attributes of a subroutine
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+method, locked
+
 =head2 autouse - postpone load of modules until a function is used
 
 =item SYNOPSIS
@@ -2548,6 +2618,14 @@ callback
 
 =item SEE ALSO
 
+=head2 base - Establish IS-A relationship with base class at compile time
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item BUGS
+
 =head2 blib - Use MakeMaker's uninstalled version of a package
 
 =item SYNOPSIS
@@ -2597,6 +2675,12 @@ diagnostics
 
 =item AUTHOR
 
+=head2 fields - compile-time class fields
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
 =head2 integer - Perl pragma to compute arithmetic in integer instead of
 double
 
@@ -2637,14 +2721,6 @@ operations
 
 =item DESCRIPTION
 
-=head2 ops - Perl pragma to restrict unsafe operations when compiling
-
-=item SYNOPSIS 
-
-=item DESCRIPTION
-
-=item SEE ALSO
-
 =head2 overload - Package for overloading perl operations
 
 =item SYNOPSIS
@@ -3104,7 +3180,7 @@ other) error log
 
 =item USING CGI::Push
 
--last_page, -type, -delay, -cookie, -target, -expires
+-next_page, -last_page, -type, -delay, -cookie, -target, -expires
 
 =item INSTALLING CGI::Push SCRIPTS
 
@@ -3147,12 +3223,14 @@ distribution
 
 =item recompile
 
-=item The 4 Classes: Authors, Bundles, Modules, Distributions
+=item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
 
 =item ProgrammerE<39>s interface
 
 expand($type,@things), Programming Examples
 
+=item Methods in the four
+
 =item Cache Manager
 
 =item Bundles
@@ -3172,6 +3250,12 @@ E<lt>valueE<gt>, o conf E<lt>list optionE<gt>, o conf E<lt>list optionE<gt>
 [shift|pop], o conf E<lt>list optionE<gt> [unshift|push|splice]
 E<lt>listE<gt>
 
+=over
+
+=item CD-ROM support
+
+=back
+
 =item SECURITY
 
 =item EXPORT
@@ -3197,12 +3281,18 @@ module
 
 =item  SEE ALSO
 
-=head2 Carp, carp - warn of errors (from perspective of caller)
+=head2 Carp, carp    - warn of errors (from perspective of caller)
 
 =item SYNOPSIS
 
 =item DESCRIPTION
 
+=over
+
+=item Forcing a Stack Trace
+
+=back
+
 =head2 Class::Struct - declare struct-like datatypes as Perl classes
 
 =item SYNOPSIS
@@ -3226,27 +3316,13 @@ Example 1, Example 2
 
 =item Author and Modification History
 
-=head2 Config - access Perl configuration information
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-myconfig(), config_sh(), config_vars(@names)
-
-=item EXAMPLE
-
-=item WARNING
-
-=item NOTE
-
 =head2 Cwd, getcwd - get pathname of current working directory
 
 =item SYNOPSIS
 
 =item DESCRIPTION
 
-=head2 DB_File - Perl5 access to Berkeley DB
+=head2 DB_File - Perl5 access to Berkeley DB version 1.x
 
 =item SYNOPSIS
 
@@ -3256,6 +3332,8 @@ B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
 
 =over
 
+=item Using DB_File with Berkeley DB version 2
+
 =item Interface to Berkeley DB
 
 =item Opening a Berkeley DB Database File
@@ -3344,6 +3422,8 @@ $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
 
 =item AVAILABILITY
 
+=item COPYRIGHT
+
 =item SEE ALSO
 
 =item AUTHOR
@@ -3401,6 +3481,8 @@ variables
 
 =item Specialised Import Lists
 
+=item Exporting without using Export's import method
+
 =item Module Version Checking
 
 =item Managing Unknown Symbols
@@ -3512,9 +3594,9 @@ extliblist, file_name_is_absolute, find_perl
 
 =item Methods to actually produce chunks of text for the Makefile
 
-force (o), guess_name, has_link_code, init_dirscan, init_main, init_others,
-install (o), installbin (o), libscan (o), linkext (o), lsdir, macro (o),
-makeaperl (o), makefile (o), manifypods (o), maybe_command,
+fixin, force (o), guess_name, has_link_code, init_dirscan, init_main,
+init_others, install (o), installbin (o), libscan (o), linkext (o), lsdir,
+macro (o), makeaperl (o), makefile (o), manifypods (o), maybe_command,
 maybe_command_in_dirs, needs_linking (o), nicetext, parse_version, pasthru
 (o), path, perl_script, perldepend (o), pm_to_blib, post_constants (o),
 post_initialize (o), postamble (o), prefixify, processPL (o), realclean
@@ -3603,8 +3685,8 @@ dist_ci (o), dist_core (o), pasthru (o)
 
 =item Using Attributes and Parameters
 
-C, CONFIG, CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS,
-EXCLUDE_EXT, EXE_FILES, NO_VC, FIRST_MAKEFILE, FULLPERL, H, INC,
+C, CCFLAGS, CONFIG, CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS,
+EXCLUDE_EXT, EXE_FILES, NO_VC, FIRST_MAKEFILE, FULLPERL, H, IMPORTS, INC,
 INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR,
 INSTALLMAN3DIR, INSTALLPRIVLIB, INSTALLSCRIPT, INSTALLSITELIB,
 INSTALLSITEARCH, INST_ARCHLIB, INST_BIN, INST_EXE, INST_LIB, INST_MAN1DIR,
@@ -3630,6 +3712,8 @@ tool_autosplit
   make distdir,    make tardist,    make dist,   make uutardist,    make
 shdist,    make zipdist,    make ci
 
+=item Disabling an extension
+
 =back
 
 =item SEE ALSO
@@ -3657,14 +3741,6 @@ C<Added to MANIFEST:> I<file>
 
 =item AUTHOR
 
-=head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=item SEE ALSO
-
 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
 
 =item SYNOPSIS
@@ -3690,6 +3766,14 @@ NAME, DL_FUNCS, DL_VARS, FILE, FUNCLIST, DLBASE
 
 =item DESCRIPTION
 
+=head2 Fatal - replace functions with equivalents which succeed or die
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item AUTHOR
+
 =head2 Fcntl - load the C Fcntl.h defines
 
 =item SYNOPSIS
@@ -3768,6 +3852,8 @@ rmscopy($from,$to[,$date_flag])
 
 =item DESCRIPTION
 
+=item BUGS
+
 =head2 File::Path - create or remove a series of directories
 
 =item SYNOPSIS
@@ -3841,7 +3927,7 @@ options
 
 =item DESCRIPTION
 
-E<lt>noneE<gt>, !, =s, :s, =i, :i, =f, :f
+!, :s, :i, :f
 
 =over
 
@@ -3853,7 +3939,7 @@ E<lt>noneE<gt>, !, =s, :s, =i, :i, =f, :f
 
 =item Option starters
 
-=item Return value
+=item Return values and Errors
 
 =back
 
@@ -3872,6 +3958,10 @@ reset), debug (default: reset)
 
 $Getopt::Long::VERSION, $Getopt::Long::error
 
+=item AUTHOR
+
+=item COPYRIGHT AND DISCLAIMER
+
 =head2 Getopt::Std, getopt - Process single-character switches with switch
 clustering
 
@@ -3892,140 +3982,6 @@ locale
 
 =item DESCRIPTION
 
-=head2 IO::File - supply object methods for filehandles
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=item CONSTRUCTOR
-
-new ([ ARGS ] ), new_tmpfile
-
-=item METHODS
-
-open( FILENAME [,MODE [,PERMS]] )
-
-=item SEE ALSO
-
-=item HISTORY
-
-=head2 IO::Handle - supply object methods for I/O handles
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=item CONSTRUCTOR
-
-new (), new_from_fd ( FD, MODE )
-
-=item METHODS
-
-$fh->fdopen ( FD, MODE ), $fh->opened, $fh->getline, $fh->getlines,
-$fh->ungetc ( ORD ), $fh->write ( BUF, LEN [, OFFSET }\] ), $fh->flush,
-$fh->error, $fh->clearerr, $fh->untaint
-
-=item NOTE
-
-=item SEE ALSO
-
-=item BUGS
-
-=item HISTORY
-
-=head2 IO::Pipe, IO::pipe - supply object methods for pipes
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=item CONSTRCUTOR
-
-new ( [READER, WRITER] )
-
-=item METHODS
-
-reader ([ARGS]), writer ([ARGS]), handles ()
-
-=item SEE ALSO
-
-=item AUTHOR
-
-=item COPYRIGHT
-
-=head2 IO::Seekable - supply seek based methods for I/O objects
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=item SEE ALSO
-
-=item HISTORY
-
-=head2 IO::Select - OO interface to the select system call
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=item CONSTRUCTOR
-
-new ( [ HANDLES ] )
-
-=item METHODS
-
-add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
-[ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_error ( [ TIMEOUT ] ), count
-(), bits(), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
-
-=item EXAMPLE
-
-=item AUTHOR
-
-=item COPYRIGHT
-
-=head2 IO::Socket - Object interface to socket communications
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=item CONSTRUCTOR
-
-new ( [ARGS] )
-
-=item METHODS
-
-accept([PKG]), timeout([VAL]), sockopt(OPT [, VAL]), sockdomain, socktype,
-protocol
-
-=item SUB-CLASSES
-
-=over
-
-=item IO::Socket::INET
-
-=item METHODS
-
-sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
-()
-
-=item IO::Socket::UNIX
-
-=item METHODS
-
-hostpath(), peerpath()
-
-=back
-
-=item SEE ALSO
-
-=item AUTHOR
-
-=item COPYRIGHT
-
 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
 
 =item SYNOPSIS
@@ -4224,7 +4180,9 @@ functions
 
 =item USAGE
 
-=item ERRORS DUE TO DIVISION BY ZERO
+=item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
+
+=item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
 
 =item BUGS
 
@@ -4362,8 +4320,9 @@ opdump (PAT)
 =item Predefined Opcode Tags
 
 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
-:default, :filesys_read, :sys_db, :browse, :filesys_open, :filesys_write,
-:subprocess, :ownprocess, :others, :still_to_be_decided, :dangerous
+:base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
+:filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
+:dangerous
 
 =item SEE ALSO
 
@@ -4572,35 +4531,6 @@ nonetscape, index, noindex, recurse, norecurse, title, verbose
 
 =item DESCRIPTION
 
-=head2 Safe - Compile and execute code in restricted compartments
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-a new namespace, an operator mask
-
-=item WARNING
-
-=over
-
-=item RECENT CHANGES
-
-=item Methods in class Safe
-
-permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
-...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
-(PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
-root (NAMESPACE), mask (MASK)
-
-=item Some Safety Issues
-
-Memory, CPU, Snooping, Signals, State Changes
-
-=item AUTHOR
-
-=back
-
 =head2 Search::Dict, look - search for key in dictionary file
 
 =item SYNOPSIS
@@ -4680,7 +4610,15 @@ interface to the UNIX syslog(3) calls
 =item DESCRIPTION
 
 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
-setlogmask $mask_priority, closelog
+setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_03) 
+Sets the socket type to be used for the next call to
+C<openlog()> or C<syslog()>.
+
+A value of 'unix' will connect to the UNIX domain socket returned by
+C<_PATH_LOG> in F<syslog.ph>. If F<syslog.ph> fails to define
+C<_PATH_LOG>, C<setlogsock> returns C<undef>; otherwise a true value is
+returned. A value of 'inet' will connect to an INET socket returned by
+getservbyname().  Any other value croaks, closelog
 
 =item EXAMPLES
 
@@ -4726,6 +4664,8 @@ C<MinLine>, C<findConsole>, Attribs, C<Features>
 
 =item Additional supported functions
 
+C<tkRunning>, C<ornaments>, C<newTTY>
+
 =item EXPORTS
 
 =item ENVIRONMENT
@@ -4809,6 +4749,41 @@ unexpand(1)
 
 =item AUTHOR
 
+=head2 Thread - multithreading
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=head2 Thread::Queue - thread-safe queues
+
+=item SYNOPSIS
+
+=head2 Thread::Semaphore - thread-safe semaphores
+
+=item SYNOPSIS
+
+=head2 Thread::Specific - thread-specific keys
+
+=item SYNOPSIS
+
+=head2 Tie::Array - base class for tied arrays
+
+=item SYNOPSIS 
+
+=item DESCRIPTION      
+
+TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
+FETCHSIZE this, STORESIZE this, count, EXTEND this, count, CLEAR this,
+DESTROY this, PUSH this, LIST, POP this, SHIFT this, UNSHIFT this, LIST,
+SPLICE this, offset, length, LIST
+
+=item CAVEATS
+
+=item AUTHOR 
+
 =head2 Tie::Hash, Tie::StdHash - base class definitions for tied hashes
 
 =item SYNOPSIS
@@ -4897,8 +4872,8 @@ function
 
 =item DESCRIPTION
 
-isa ( TYPE ), can ( METHOD ), VERSION ( [ REQUIRE ] ), isa ( VAL, TYPE ),
-can ( VAL, METHOD )
+isa ( TYPE ), can ( METHOD ), VERSION ( [ REQUIRE ] ), UNIVERSAL::isa (
+VAL, TYPE ), UNIVERSAL::can ( VAL, METHOD )
 
 =head2 User::grent - by-name interface to Perl's built-in getgr*()
 functions
index 6a1ed81..3ab11ef 100644 (file)
@@ -451,7 +451,7 @@ the same as C<$!>.
 Under VMS, C<$^E> provides the VMS status value from the last
 system error.  This is more specific information about the last
 system error than that provided by C<$!>.  This is particularly
-important when C<$!> is set to E<EVMSERR>.
+important when C<$!> is set to B<EVMSERR>.
 
 Under OS/2, C<$^E> is set based on the value returned by the OS/2
 call C<_syserrno()> only when a call into the OS/2 API generates