From: Jarkko Hietaniemi Date: Thu, 19 Feb 1998 17:54:52 +0000 (+0200) Subject: retry [PATCH] 5.004_59: the perlhist.pod etc X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=d516a115cc96334486070e15a6babcd1278d8de9;p=p5sagit%2Fp5-mst-13.2.git retry [PATCH] 5.004_59: the perlhist.pod etc p4raw-id: //depot/perl@557 --- diff --git a/ext/Thread/Thread.pm b/ext/Thread/Thread.pm index 48ca304..cf7069c 100644 --- a/ext/Thread/Thread.pm +++ b/ext/Thread/Thread.pm @@ -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 module provides multithreading. + +=head1 SEE ALSO + +L, L, L, L. + +=cut + # # Methods # diff --git a/ext/Thread/Thread/Queue.pm b/ext/Thread/Thread/Queue.pm index 4eef978..9821773 100644 --- a/ext/Thread/Thread/Queue.pm +++ b/ext/Thread/Thread/Queue.pm @@ -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; diff --git a/ext/Thread/Thread/Semaphore.pm b/ext/Thread/Thread/Semaphore.pm index 9e5852f..4e1bb7d 100644 --- a/ext/Thread/Thread/Semaphore.pm +++ b/ext/Thread/Thread/Semaphore.pm @@ -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; diff --git a/ext/Thread/Thread/Specific.pm b/ext/Thread/Thread/Specific.pm index ec56539..c3591f4 100644 --- a/ext/Thread/Thread/Specific.pm +++ b/ext/Thread/Thread/Specific.pm @@ -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; diff --git a/lib/fields.pm b/lib/fields.pm index 8e2d639..c2cf1d6 100644 --- a/lib/fields.pm +++ b/lib/fields.pm @@ -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 pragma enables compile-time verified class fields. + +=cut + sub import { my $class = shift; my ($package) = caller; diff --git a/pod/buildtoc b/pod/buildtoc index d657d68..bd880c3 100644 --- a/pod/buildtoc +++ b/pod/buildtoc @@ -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*//; diff --git a/pod/perl.pod b/pod/perl.pod index e989eba..41481a3 100644 --- a/pod/perl.pod +++ b/pod/perl.pod @@ -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.) diff --git a/pod/perlhist.pod b/pod/perlhist.pod index 9113ed9..163fe03 100644 --- a/pod/perlhist.pod +++ b/pod/perlhist.pod @@ -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 diff --git a/pod/perltoc.pod b/pod/perltoc.pod index d3f3a81..4def4c7 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -863,10 +863,14 @@ CGI script to do bad things? =item Fixed parsing of $$, &$, etc. +=item Fixed localization of $, $&, etc. + =item No resetting of $. on implicit close =item C may return undef +=item C 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<(?, C<(?{ code })>, C<(?Eregexp)>, +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], B<-a>, B<-c>, B<-d>, B<-d:>I, B<-D>I, -B<-D>I, B<-e> I, B<-F>I, B<-h>, +B<-0>[I], B<-a>, B<-c>, B<-d>, B<-d:>I, B<-D>I, +B<-D>I, B<-e> I, B<-F>I, B<-h>, B<-i>[I], B<-I>I, B<-l>[I], B<-m>[B<->]I, B<-M>[B<->]I, B<-M>[B<->]I<'module ...'>, B<-[mM]>[B<->]I, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>, @@ -1221,7 +1228,7 @@ in perl5 =item Alphabetical Listing of Perl Functions --I FILEHANDLE, -I EXPR, -I, 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, C, C, C, C, C, C, C, C, C, C, C, C, E [ command ], EE command, E command, EE 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/C trap using returned value, C 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, B, B, B, B, B, B, B, B, B, -B, B, B, -B, B, B, +B, B, B, +B, B, B, B, B, B, B, B, B, B, B, B, @@ -2365,6 +2386,17 @@ B, B =item Understanding the Magic of Tied Hashes and Arrays +=item Localizing changes + +C, C, C, C, +C, C, C, C, C, C, C, C, C, C, C, C, +C, C, +C, C, C + =back =item Subroutines @@ -2410,8 +2442,8 @@ B, B 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 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 @@ EvalueE, o conf Elist optionE, o conf Elist optionE [shift|pop], o conf Elist optionE [unshift|push|splice] ElistE +=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, B, B =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-Esync([$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 I =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 -EnoneE, !, =s, :s, =i, :i, =f, :f +!, :s, :i, :f =over @@ -3853,7 +3939,7 @@ EnoneE, !, =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 or C. + +A value of 'unix' will connect to the UNIX domain socket returned by +C<_PATH_LOG> in F. If F fails to define +C<_PATH_LOG>, C returns C; 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, C, Attribs, C =item Additional supported functions +C, C, C + =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 diff --git a/pod/perlvar.pod b/pod/perlvar.pod index 6a1ed81..3ab11ef 100644 --- a/pod/perlvar.pod +++ b/pod/perlvar.pod @@ -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. +important when C<$!> is set to B. 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