This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Backed out mismerge.
authorAlan Burlison <Alan.Burlison@uk.sun.com>
Sat, 10 Feb 2001 21:24:27 +0000 (21:24 +0000)
committerAlan Burlison <Alan.Burlison@uk.sun.com>
Sat, 10 Feb 2001 21:24:27 +0000 (21:24 +0000)
p4raw-id: //depot/maint-5.6/pureperl@8759

25 files changed:
MANIFEST
README.hpux
README.vmesa
installhtml
lib/Math/Complex.pm
lib/Pod/Find.pm
perl.c
pod/buildtoc.PL
pod/perl.pod
pod/perlapi.pod
pod/perlboot.pod
pod/perlcall.pod
pod/perlfaq2.pod
pod/perlfaq3.pod
pod/perlfaq9.pod
pod/perlmodlib.PL
pod/perlobj.pod
pod/perlport.pod
pod/perlre.pod
pod/perltoc.pod
pod/perltoot.pod
pod/perltootc.pod
sv.c
win32/Makefile
win32/makefile.mk

index 1634a98..5816c75 100644 (file)
--- a/MANIFEST
+++ b/MANIFEST
@@ -36,7 +36,6 @@ README.aix            Notes about AIX port
 README.amiga           Notes about AmigaOS port
 README.apollo          Notes about Apollo DomainOS port
 README.beos            Notes about BeOS port
-README.bs2000          Notes about BS2000 POSIX port
 README.cygwin          Notes about Cygwin port
 README.dos             Notes about dos/djgpp port
 README.epoc            Notes about EPOC port
@@ -48,6 +47,7 @@ README.mpeix          Notes about MPE/iX port
 README.os2             Notes about OS/2 port
 README.os390           Notes about OS/390 (nee MVS) port
 README.plan9           Notes about Plan9 port
+README.posix-bc                Notes about BS2000 POSIX port
 README.qnx             Notes about QNX port
 README.solaris         Notes about Solaris port
 README.threads         Notes about multithreading
index 7d01983..58899be 100644 (file)
@@ -202,7 +202,7 @@ threads library package. Two examples are the HP DCE package, available
 on "HP-UX Hardware Extensions 3.0, Install and Core OS, Release 10.20,
 April 1999 (B3920-13941)" or the Freely available PTH package, available
 though worldwide HP-UX mirrors of precompiled packages
-(e.g. http://hpux.tn.tudelft.nl/hppd/hpux/alpha.html)
+(i.e. http://hpux.tn.tudelft.nl/hppd/hpux/alpha.html)
 
 =head2 64-bit Perl
 
index 43c5219..d3f8516 100644 (file)
@@ -1,20 +1,4 @@
-
-This document is written in pod format hence there are punctuation
-characters in odd places.  Do not worry, you've apparently got
-the ASCII->EBCDIC translation worked out correctly.  You can read
-more about pod in pod/perlpod.pod or the short summary in the
-INSTALL file.
-
-=head1 NAME
-
-README.vmesa - building and installing Perl for VM/ESA.
-
-=head1 SYNOPSIS
-
-This document will help you Configure, build, test and install Perl
-on VM/ESA.
-
-=head1 DESCRIPTION
+README.vmesa
 
 This is a fully ported perl for VM/ESA 2.3.0.  It may work on
 other versions, but that's the one we've tested it on.
@@ -26,75 +10,48 @@ the source code below /usr/local (though that is where it will be
 installed by default).  You may need to worry about the networking
 configuration files discussed in the last bullet below.
 
-=head2 Unpacking
-
 To extract an ASCII tar archive on VM/ESA, try this:
 
    pax -o to=IBM-1047,from=ISO8859-1 -r < latest.tar
 
-=head2 Setup and utilities
-
 GNU make for VM/ESA, which may be required for the build of perl,
 is available from:
 
   http://pucc.princeton.edu/~neale/vmoe.html
 
-=head2 Configure
-
 Once you've unpacked the distribution, run Configure (see INSTALL for
 full discussion of the Configure options), and then run make, then
 "make test" then "make install" (this last step may require UID=0
-privileges).
+privileges)
 
 There is a "hints" file for vmesa that specifies the correct values
-for most things.  Some things to watch out for are:
+for most things.  Some things to watch out for are
 
-=over 4
+       - this port does support dynamic loading but it's not had much testing
 
-=item *
-
-this port does support dynamic loading but it's not had much testing
-
-=item *
        - Don't turn on the compiler optimization flag "-O".  There's
          a bug in the compiler (APAR PQ18812) that generates some bad code
          the optimizer is on.
 
-=item *
        - As VM/ESA doesn't fully support the fork() API programs relying on
          this call will not work. I've replaced fork()/exec() with spawn()
          and the standalone exec() with spawn(). This has a side effect when
          opening unnamed pipes in a shell script: there is no child process
          generated under.
 
-=item *
-
-At the moment the hints file for VM/ESA basically bypasses all of the
-automatic configuration process.  This is because Configure relies on:
-1. The header files living in the Byte File System (you could put the
-there if you want); 2. The C preprocessor including the #include 
-statements in the preprocessor output (.i) file.
-
-=back
-
-=head2 testing anomalies
-
-The `make test` step runs a Perl Verification Procedure, usually before
-installation.  As the 5.6.1 kit was was being assembled
-the following "failures" were known to appear on some machines
-during `make test` (mostly due to ASCII vs. EBCDIC conflicts),
-your results may differ:
-
-[the list of failures being compiled]
-
-=head2 Usage Hints
+       - At the moment the hints file for VM/ESA basically bypasses all of the
+         automatic configuration process. This is because Configure relies on:
+         1. The header files living in the Byte File System (you could put the
+            there if you want;
+         2. The C preprocessor including the #include statements in the
+            preprocessor output (.i) file.
        
 When using perl on VM/ESA please keep in mind that the EBCDIC and ASCII
 character sets are different.  Perl builtin functions that may behave
 differently under EBCDIC are mentioned in the perlport.pod document.
 
 OpenEdition (UNIX System Services) does not (yet) support the #! means
-of script invocation.
+of script invokation.
 See:
 
     head `whence perldoc`
@@ -102,16 +59,6 @@ See:
 for an example of how to use the "eval exec" trick to ask the shell to
 have perl run your scripts for you.
 
-=head1 AUTHORS
-
-Neale Ferguson.
-
-=head1 SEE ALSO
-
-L<INSTALL>, L<perlport>, L<perlebcdic>.
-
-=head2 Mailing list
-
 If you are interested in the VM and OS/390 ports of perl then see the
 perl-mvs mailing list: The Perl Institute (http://www.perl.org/)
 maintains a mailing list of interest to all folks building and/or
@@ -121,14 +68,9 @@ using perl on EBCDIC platforms.  To subscribe, send a message of:
 
 to majordomo@perl.org.
 
-   See also:
-
-    http://lists.perl.org/showlist.cgi?name=perl-mvs
-
-There are web archives of the mailing list at:
-
-    http://www.xray.mpe.mpg.de/mailing-lists/perl-mvs/
-    http://archive.develooper.com/perl-mvs@perl.org/
-
-=cut
+Regression tests: as the 5.005 kit was was being assembled
+the following "failures" were known to appear on some machines
+during `make test` (mostly due to ASCII vs. EBCDIC conflicts),
+your results may differ:
 
+[the list of failures being compiled]
index d437ded..bef35e9 100755 (executable)
@@ -592,7 +592,6 @@ sub runpod2html {
        "--htmlroot=$htmlroot",
        "--podpath=".join(":", @podpath),
        "--podroot=$podroot", "--netscape",
-       "--header",
        ($doindex ? "--index" : "--noindex"),
        "--" . ($recurse ? "" : "no") . "recurse",
        ($#libpods >= 0) ? "--libpods=" . join(":", @libpods) : "",
index fb6af8c..066e366 100644 (file)
@@ -664,7 +664,7 @@ sub Re {
 #
 sub Im {
        my ($z, $Im) = @_;
-       return 0 unless ref $z;
+       return $z unless ref $z;
        if (defined $Im) {
            $z->{'cartesian'} = [ ${$z->cartesian}[0], $Im ];
            $z->{c_dirty} = 0;
index 6d4907c..516a624 100644 (file)
@@ -242,7 +242,7 @@ sub _check_and_extract_name {
 
 The function B<simplify_name> is equivalent to B<basename>, but also
 strips Perl-like extensions (.pm, .pl, .pod) and extensions like
-F<.bat>, F<.cmd> on Win32 and OS/2, or F<.com> on VMS, respectively.
+F<.bat>, F<.cmd> on Win32 and OS/2, respectively.
 
 =cut
 
@@ -262,8 +262,6 @@ sub _simplify {
     $_[0] =~ s/\.(pod|pm|plx?)\z//i;
     # strip meaningless extensions on Win32 and OS/2
     $_[0] =~ s/\.(bat|exe|cmd)\z//i if($^O =~ /win|os2/i);
-    # strip meaningless extensions on VMS
-    $_[0] =~ s/\.(com)\z//i if($^O eq 'VMS');
 }
 
 # contribution from Tim Jenness <t.jenness@jach.hawaii.edu>
diff --git a/perl.c b/perl.c
index 024a706..aed2ec0 100644 (file)
--- a/perl.c
+++ b/perl.c
@@ -614,10 +614,10 @@ perl_destruct(pTHXx)
 #endif
 
     /* Prepare to destruct main symbol table.  */
+
     hv = PL_defstash;
     PL_defstash = 0;
-    SvREFCNT_dec(hv);   /* Totally ineffective due to circular references */
-
+    SvREFCNT_dec(hv);
     SvREFCNT_dec(PL_curstname);
     PL_curstname = Nullsv;
 
index d921e33..876fee7 100644 (file)
@@ -151,7 +151,6 @@ if (-d "pod") {
 
     perlaix
     perlamiga          
-    perlbs2000
     perlcygwin          
     perldos             
     perlepoc             
@@ -160,8 +159,8 @@ if (-d "pod") {
     perlmpeix         
     perlos2             
     perlos390           
+    perlposix-bc
     perlsolaris
-    perlvmesa             
     perlvms             
     perlvos             
     perlwin32           
@@ -170,7 +169,6 @@ if (-d "pod") {
 @ARCHPODS = qw(
     perlaix    
     perlamiga          
-    perlbs2000
     perlcygwin          
     perldos             
     perlepoc             
@@ -179,8 +177,8 @@ if (-d "pod") {
     perlmpeix
     perlos2             
     perlos390           
+    perlposix-bc
     perlsolaris
-    perlvmesa             
     perlvms             
     perlvos             
     perlwin32           
index ac8c94a..e6a7bd2 100644 (file)
@@ -105,7 +105,6 @@ For ease of access, the Perl manual has been split up into several sections:
 
     perlaix            Perl notes for AIX
     perlamiga          Perl notes for Amiga
-    perlbs2000         Perl notes for POSIX-BC BS2000
     perlcygwin         Perl notes for Cygwin
     perldos            Perl notes for DOS
     perlepoc           Perl notes for EPOC
@@ -114,8 +113,8 @@ For ease of access, the Perl manual has been split up into several sections:
     perlmpeix          Perl notes for MPE/iX
     perlos2            Perl notes for OS/2
     perlos390          Perl notes for OS/390
+    perlposix-bc       Perl notes for POSIX-BC
     perlsolaris        Perl notes for Solaris
-    perlvmesa          Perl notes for VM/ESA
     perlvms            Perl notes for VMS
     perlvos            Perl notes for Stratus VOS
     perlwin32          Perl notes for Windows
index fc803c4..67009d0 100644 (file)
@@ -2338,19 +2338,19 @@ false, defined or undefined.  Does not handle 'get' magic.
 =for hackers
 Found in file sv.h
 
-=item SvTYPE
-
-Returns the type of the SV.  See C<svtype>.
+=item svtype
 
-       svtype  SvTYPE(SV* sv)
+An enum of flags for Perl types.  These are found in the file B<sv.h> 
+in the C<svtype> enum.  Test these flags with the C<SvTYPE> macro.
 
 =for hackers
 Found in file sv.h
 
-=item svtype
+=item SvTYPE
 
-An enum of flags for Perl types.  These are found in the file B<sv.h> 
-in the C<svtype> enum.  Test these flags with the C<SvTYPE> macro.
+Returns the type of the SV.  See C<svtype>.
+
+       svtype  SvTYPE(SV* sv)
 
 =for hackers
 Found in file sv.h
index 3c18246..b549f45 100644 (file)
@@ -790,13 +790,9 @@ Hopefully, this gets you started, though.
 
 For more information, see L<perlobj> (for all the gritty details about
 Perl objects, now that you've seen the basics), L<perltoot> (the
-tutorial for those who already know objects), L<perltootc> (dealing
-with class data), L<perlbot> (for some more tricks), and books such as
-Damian Conway's excellent I<Object Oriented Perl>.
-
-Some modules which might prove interesting are Class::Accessor,
-Class::Class, Class::Contract, Class::Data::Inheritable,
-Class::MethodMaker and Tie::SecureHash
+tutorial for those who already know objects), L<perlbot> (for some
+more tricks), and books such as Damian Conway's excellent I<Object
+Oriented Perl>.
 
 =head1 COPYRIGHT
 
index 40f1d65..94edd34 100644 (file)
@@ -589,6 +589,12 @@ local copy, I<not> the global copy.
 
 =item 4.
 
+The only flag specified this time is G_DISCARD. Because we are passing 2
+parameters to the Perl subroutine this time, we have not specified
+G_NOARGS.
+
+=item 5.
+
 Next, we come to XPUSHs. This is where the parameters actually get
 pushed onto the stack. In this case we are pushing a string and an
 integer.
@@ -596,7 +602,7 @@ integer.
 See L<perlguts/"XSUBs and the Argument Stack"> for details
 on how the XPUSH macros work.
 
-=item 5.
+=item 6.
 
 Because we created temporary values (by means of sv_2mortal() calls)
 we will have to tidy up the Perl stack and dispose of mortal SVs.
@@ -626,12 +632,10 @@ to limit the scope of local variables.
 See the section I<Using Perl to dispose of temporaries> for details of
 an alternative to using these macros.
 
-=item 6.
+=item 7.
 
-Finally, I<LeftString> can now be called via the I<call_pv> function.
-The only flag specified this time is G_DISCARD. Because we are passing
-2 parameters to the Perl subroutine this time, we have not specified
-G_NOARGS.
+Finally, I<LeftString> can now be called via the I<call_pv>
+function.
 
 =back
 
index aecc1fc..1b5a5ef 100644 (file)
@@ -494,14 +494,13 @@ O'Reilly and Associates. Other starting points include
     http://conference.perl.com/
     http://reference.perl.com/
 
-Perl Mongers is an advocacy organization for the Perl language which
-maintains the web site http://www.perl.org/ as a general advocacy
-site for the Perl language.
+Perl Mongers is an advocacy organization for the Perl language.  For
+details, see the Perl Mongers web site at http://www.perl.org/.
 
-Perl Mongers uses the pm.org domain for services related to Perl user
-groups, including the hosting of mailing lists and web sites.  See the
-Perl user group web site at http://www.pm.org/ for more information about
-joining, starting, or requesting services for a Perl user group.
+Perl Mongers use the pm.org domain for services related to Perl user
+groups.  See the Perl user group web site at http://www.pm.org/ for more
+information about joining, starting, or requesting services for a Perl
+user group.
 
 Perl Mongers also maintain the perl.org domain to provide general
 support services to the Perl community, including the hosting of mailing
@@ -509,11 +508,10 @@ lists, web sites, and other services.  The web site
 http://www.perl.org/ is a general advocacy site for the Perl language,
 and there are many other sub-domains for special topics, such as
 
-    http://bugs.perl.org/
     http://history.perl.org/
-    http://lists.perl.org/
-    http://news.perl.org/
+    http://bugs.perl.org/
     http://use.perl.org/
+    http://lists.perl.org/
 
 =head1 AUTHOR AND COPYRIGHT
 
index 7b64801..3840a85 100644 (file)
@@ -187,8 +187,8 @@ For Windows editors: you can download GNU Emacs
 (http://www.gnu.org/software/emacs/windows/ntemacs.html) or XEmacs
 (http://www.xemacs.org/Download/index.html), or a vi clone such as
 Elvis (ftp://ftp.cs.pdx.edu/pub/elvis/, http://www.fh-wedel.de/elvis/),
-Vile (http://vile.cx), or Vim (http://www.vim.org/)
-(win32: http://www.cs.vu.nl/%7Etmgil/vi.html).
+Vile (http://www.clark.net/pub/dickey/vile/vile.html), or
+Vim (http://www.vim.org/) (win32: http://www.cs.vu.nl/%7Etmgil/vi.html).
 For vi lovers in general, Windows or elsewhere:
 http://www.thomer.com/thomer/vi/vi.html.
 
@@ -198,7 +198,7 @@ UNIX platforms you might be interested in trying it out, firstly because
 strictly speaking it is not a vi clone, it is the real vi, or the new
 incarnation of it, and secondly because you can embed Perl inside it
 to use Perl as the scripting language.  nvi is not alone in this,
-though: at least also vim and vile offer an embedded Perl.
+though: at least also vim offers an embedded Perl.
 
 The following are Win32 multilanguage editor/IDESs that support Perl: 
 Codewright (http://www.starbase.com/), MultiEdit (http://www.MultiEdit.com/),
index 3c15050..4c701ca 100644 (file)
@@ -343,7 +343,7 @@ deliverable which are compliant.
 
 Many are tempted to try to eliminate many frequently-invalid
 mail addresses with a simple regex, such as
-C</^[\w.-]+\@([\w.-]+\.)+\w+$/>.  It's a very bad idea.  However,
+C</^[\w.-]+\@([\w.-]\.)+\w+$/>.  It's a very bad idea.  However,
 this also throws out many valid ones, and says nothing about
 potential deliverability, so is not suggested.  Instead, see
 http://www.perl.com/CPAN/authors/Tom_Christiansen/scripts/ckaddr.gz ,
index 5546dc8..a2069da 100644 (file)
@@ -43,8 +43,6 @@ while (<MANIFEST>) {
 }
 
 print OUT <<'EOF';
-# Generated by perlmodlib.PL  DO NOT EDIT!
-
 =head1 NAME
 
 perlmodlib - constructing new Perl modules and finding existing ones
@@ -251,230 +249,167 @@ You should try to choose one close to you:
 
 =item Africa
 
- South Africa   ftp://ftp.is.co.za/programming/perl/CPAN/
-                ftp://ftp.saix.net/pub/CPAN/
-                ftp://ftpza.co.za/pub/mirrors/cpan/
-                ftp://ftp.sun.ac.za/CPAN/
+    South Africa   ftp://ftp.is.co.za/programming/perl/CPAN/
+                   ftp://ftp.saix.net/pub/CPAN/
+                   ftp://ftp.sun.ac.za/CPAN/
+                   ftp://ftpza.co.za/pub/mirrors/cpan/
+
 
 =item Asia
 
- China          ftp://freesoft.cei.gov.cn/pub/languages/perl/CPAN/
-                http://www2.linuxforum.net/mirror/CPAN/
- Hong Kong      http://CPAN.pacific.net.hk/
-                ftp://ftp.pacific.net.hk/pub/mirror/CPAN/
- Indonesia      http://piksi.itb.ac.id/CPAN/
-                ftp://mirrors.piksi.itb.ac.id/CPAN/
-                http://CPAN.mweb.co.id/
-                ftp://ftp.mweb.co.id/pub/languages/perl/CPAN/
- Israel         http://www.iglu.org.il:/pub/CPAN/
-                ftp://ftp.iglu.org.il/pub/CPAN/
-                http://bioinfo.weizmann.ac.il/pub/software/perl/CPAN/
-                ftp://bioinfo.weizmann.ac.il/pub/software/perl/CPAN/
- Japan          ftp://ftp.u-aizu.ac.jp/pub/lang/perl/CPAN/
-                ftp://ftp.kddlabs.co.jp/CPAN/
-                http://mirror.nucba.ac.jp/mirror/Perl/
-                ftp://mirror.nucba.ac.jp/mirror/Perl/
-                ftp://ftp.meisei-u.ac.jp/pub/CPAN/
-                ftp://ftp.jaist.ac.jp/pub/lang/perl/CPAN/
-                ftp://ftp.dti.ad.jp/pub/lang/CPAN/
-                ftp://ftp.ring.gr.jp/pub/lang/perl/CPAN/
- Saudi Arabia   ftp://ftp.isu.net.sa/pub/CPAN/
- Singapore      http://ftp.nus.edu.sg/unix/perl/CPAN/
-                ftp://ftp.nus.edu.sg/pub/unix/perl/CPAN/
- South Korea    http://CPAN.bora.net/
-                ftp://ftp.bora.net/pub/CPAN/
-                http://ftp.kornet.net/CPAN/
-                ftp://ftp.kornet.net/pub/CPAN/
-                ftp://ftp.nuri.net/pub/CPAN/
- Taiwan         ftp://coda.nctu.edu.tw/computer-languages/perl/CPAN/
-                ftp://ftp.ee.ncku.edu.tw/pub/perl/CPAN/
-                ftp://ftp1.sinica.edu.tw/pub1/perl/CPAN/
- Thailand       http://download.nectec.or.th/CPAN/
-                ftp://ftp.nectec.or.th/pub/languages/CPAN/
-                ftp://ftp.cs.riubon.ac.th/pub/mirrors/CPAN/
+    China          ftp://freesoft.cei.gov.cn/pub/languages/perl/CPAN/
+    Hong Kong      ftp://ftp.pacific.net.hk/pub/mirror/CPAN/
+    Indonesia      ftp://malone.piksi.itb.ac.id/pub/CPAN/
+    Israel         ftp://bioinfo.weizmann.ac.il/pub/software/perl/CPAN/
+    Japan          ftp://ftp.dti.ad.jp/pub/lang/CPAN/
+                   ftp://ftp.jaist.ac.jp/pub/lang/perl/CPAN/
+                   ftp://ftp.lab.kdd.co.jp/lang/perl/CPAN/
+                   ftp://ftp.meisei-u.ac.jp/pub/CPAN/
+                   ftp://ftp.ring.gr.jp/pub/lang/perl/CPAN/
+                   ftp://mirror.nucba.ac.jp/mirror/Perl/
+    Saudi-Arabia   ftp://ftp.isu.net.sa/pub/CPAN/
+    Singapore      ftp://ftp.nus.edu.sg/pub/unix/perl/CPAN/
+    South Korea    ftp://ftp.bora.net/pub/CPAN/
+                   ftp://ftp.kornet.net/pub/CPAN/
+                   ftp://ftp.nuri.net/pub/CPAN/
+    Taiwan         ftp://coda.nctu.edu.tw/computer-languages/perl/CPAN/
+                   ftp://ftp.ee.ncku.edu.tw/pub3/perl/CPAN/
+                   ftp://ftp1.sinica.edu.tw/pub1/perl/CPAN/
+    Thailand       ftp://ftp.nectec.or.th/pub/mirrors/CPAN/
+
+
+=item Australasia
+
+    Australia      ftp://cpan.topend.com.au/pub/CPAN/
+                   ftp://ftp.labyrinth.net.au/pub/perl-CPAN/
+                   ftp://ftp.sage-au.org.au/pub/compilers/perl/CPAN/
+                   ftp://mirror.aarnet.edu.au/pub/perl/CPAN/
+    New Zealand    ftp://ftp.auckland.ac.nz/pub/perl/CPAN/
+                   ftp://sunsite.net.nz/pub/languages/perl/CPAN/
+
 
 =item Central America
 
- Costa Rica     ftp://ftp.linux.co.cr/mirrors/CPAN/
-                http://ftp.ucr.ac.cr/Unix/CPAN/
-                ftp://ftp.ucr.ac.cr/pub/Unix/CPAN/
+    Costa Rica     ftp://ftp.ucr.ac.cr/pub/Unix/CPAN/
+
 
 =item Europe
 
- Austria        ftp://ftp.tuwien.ac.at/pub/languages/perl/CPAN/
- Belgium        http://ftp.easynet.be/CPAN/
-                ftp://ftp.easynet.be/CPAN/
-                ftp://ftp.kulnet.kuleuven.ac.be/pub/mirror/CPAN/
- Bulgaria       ftp://ftp.ntrl.net/pub/mirrors/CPAN/
- Croatia        ftp://ftp.linux.hr/pub/CPAN/
- Czech Republic http://www.fi.muni.cz/pub/perl/
-                ftp://ftp.fi.muni.cz/pub/perl/
-                ftp://sunsite.mff.cuni.cz/MIRRORS/ftp.funet.fi/pub/languages/perl/CPAN/
- Denmark        ftp://sunsite.auc.dk/pub/languages/perl/CPAN/
-                http://www.cpan.dk/CPAN/
- England        http://www.mirror.ac.uk/sites/ftp.funet.fi/pub/languages/perl/CPAN
-                ftp://ftp.mirror.ac.uk/sites/ftp.funet.fi/pub/languages/perl/CPAN/
-                ftp://ftp.demon.co.uk/pub/mirrors/perl/CPAN/
-                ftp://ftp.flirble.org/pub/languages/perl/CPAN/
-                ftp://ftp.plig.org/pub/CPAN/
-                ftp://sunsite.doc.ic.ac.uk/packages/CPAN/
-                http://mirror.uklinux.net/CPAN/
-                ftp://mirror.uklinux.net/pub/CPAN/
-                ftp://usit.shef.ac.uk/pub/packages/CPAN/
- Estonia        ftp://ftp.ut.ee/pub/languages/perl/CPAN/
- Finland        ftp://ftp.funet.fi/pub/languages/perl/CPAN/
- France         ftp://cpan.ftp.worldonline.fr/pub/CPAN/
-                ftp://ftp.club-internet.fr/pub/perl/CPAN/
-                ftp://ftp.lip6.fr/pub/perl/CPAN/
-                ftp://ftp.oleane.net/pub/mirrors/CPAN/
-                ftp://ftp.pasteur.fr/pub/computing/CPAN/
-                ftp://cpan.cict.fr/pub/CPAN/
-                ftp://ftp.uvsq.fr/pub/perl/CPAN/
- Germany        ftp://ftp.rz.ruhr-uni-bochum.de/pub/CPAN/
-                ftp://ftp.freenet.de/pub/ftp.cpan.org/pub/CPAN/
-                ftp://ftp.uni-erlangen.de/pub/source/CPAN/
-                ftp://ftp-stud.fht-esslingen.de/pub/Mirrors/CPAN
-                ftp://ftp.gigabell.net/pub/CPAN/
-                http://ftp.gwdg.de/pub/languages/perl/CPAN/
-                ftp://ftp.gwdg.de/pub/languages/perl/CPAN/
-                ftp://ftp.uni-hamburg.de/pub/soft/lang/perl/CPAN/
-                ftp://ftp.leo.org/pub/comp/general/programming/languages/script/perl/CPAN/
-                ftp://ftp.mpi-sb.mpg.de/pub/perl/CPAN/
-                ftp://ftp.gmd.de/packages/CPAN/
- Greece         ftp://ftp.ntua.gr/pub/lang/perl/
- Hungary        http://cpan.artifact.hu/
-                ftp://cpan.artifact.hu/CPAN/
-                ftp://ftp.kfki.hu/pub/packages/perl/CPAN/
- Iceland        http://cpan.gm.is/
-                ftp://ftp.gm.is/pub/CPAN/
- Ireland        http://cpan.indigo.ie/
-                ftp://cpan.indigo.ie/pub/CPAN/
-                http://sunsite.compapp.dcu.ie/pub/perl/
-                ftp://sunsite.compapp.dcu.ie/pub/perl/
- Italy          http://cpan.nettuno.it/
-                http://softcity.iol.it/cpan
-                ftp://softcity.iol.it/pub/cpan
-                ftp://ftp.unina.it/pub/Other/CPAN/
-                ftp://ftp.unipi.it/pub/mirror/perl/CPAN/
-                ftp://cis.uniRoma2.it/CPAN/
-                ftp://ftp.edisontel.it/pub/CPAN_Mirror/
-                ftp://ftp.flashnet.it/pub/CPAN/
- Latvia         http://kvin.lv/pub/CPAN/
- Netherlands    ftp://download.xs4all.nl/pub/mirror/CPAN/
-                ftp://ftp.nl.uu.net/pub/CPAN/
-                ftp://ftp.cpan.nl/pub/CPAN/
-                ftp://ftp.nluug.nl/pub/languages/perl/CPAN/
-                http://www.cs.uu.nl/mirror/CPAN/
-                ftp://ftp.cs.uu.nl/mirror/CPAN/
- Norway         ftp://sunsite.uio.no/pub/languages/perl/CPAN/
-                ftp://ftp.uit.no/pub/languages/perl/cpan/
- Poland         ftp://ftp.pk.edu.pl/pub/lang/perl/CPAN/
-                ftp://ftp.mega.net.pl/pub/mirrors/ftp.perl.com/
-                ftp://ftp.man.torun.pl/pub/doc/CPAN/
-                ftp://sunsite.icm.edu.pl/pub/CPAN/
- Portugal       ftp://ftp.ua.pt/pub/CPAN/
-                ftp://perl.di.uminho.pt/pub/CPAN/
-                ftp://ftp.ist.utl.pt/pub/CPAN/
-                ftp://ftp.netc.pt/pub/CPAN/
- Romania        ftp://archive.logicnet.ro/mirrors/ftp.cpan.org/CPAN/
-                ftp://ftp.kappa.ro/pub/mirrors/ftp.perl.org/pub/CPAN/
-                ftp://ftp.dntis.ro/pub/cpan/
-                ftp://ftp.opsynet.com/cpan/
-                ftp://ftp.dnttm.ro/pub/CPAN/
- Russia         ftp://ftp.chg.ru/pub/lang/perl/CPAN/
-                http://cpan.rinet.ru/
-                ftp://cpan.rinet.ru/pub/mirror/CPAN/
-                ftp://ftp.aha.ru/pub/CPAN/
-                ftp://ftp.sai.msu.su/pub/lang/perl/CPAN/
- Slovakia       ftp://ftp.entry.sk/pub/languages/perl/CPAN/
- Slovenia       ftp://ftp.arnes.si/software/perl/CPAN/
- Spain          ftp://ftp.rediris.es/mirror/CPAN/
-                ftp://ftp.etse.urv.es/pub/perl/
- Sweden         http://ftp.du.se/CPAN/
-                ftp://ftp.du.se/pub/CPAN/
-                ftp://ftp.sunet.se/pub/lang/perl/CPAN/
- Switzerland    ftp://ftp.danyk.ch/CPAN/
-                ftp://sunsite.cnlab-switch.ch/mirror/CPAN/
- Turkey         ftp://sunsite.bilkent.edu.tr/pub/languages/CPAN/
+    Austria        ftp://ftp.tuwien.ac.at/pub/languages/perl/CPAN/
+    Belgium        ftp://ftp.kulnet.kuleuven.ac.be/pub/mirror/CPAN/
+    Bulgaria       ftp://ftp.ntrl.net/pub/mirrors/CPAN/
+    Croatia        ftp://ftp.linux.hr/pub/CPAN/
+    Czech Republic ftp://ftp.fi.muni.cz/pub/perl/
+                   ftp://sunsite.mff.cuni.cz/Languages/Perl/CPAN/
+    Denmark        ftp://sunsite.auc.dk/pub/languages/perl/CPAN/
+    Estonia        ftp://ftp.ut.ee/pub/languages/perl/CPAN/
+    Finland        ftp://ftp.funet.fi/pub/languages/perl/CPAN/
+    France         ftp://ftp.grolier.fr/pub/perl/CPAN/
+                   ftp://ftp.lip6.fr/pub/perl/CPAN/
+                   ftp://ftp.oleane.net/pub/mirrors/CPAN/
+                   ftp://ftp.pasteur.fr/pub/computing/CPAN/
+                   ftp://ftp.uvsq.fr/pub/perl/CPAN/
+    German         ftp://ftp.gigabell.net/pub/CPAN/
+    Germany        ftp://ftp.archive.de.uu.net/pub/CPAN/
+                   ftp://ftp.freenet.de/pub/ftp.cpan.org/pub/
+                   ftp://ftp.gmd.de/packages/CPAN/
+                   ftp://ftp.gwdg.de/pub/languages/perl/CPAN/
+
+ftp://ftp.leo.org/pub/comp/general/programming/languages/script/perl/CPAN/
+                   ftp://ftp.mpi-sb.mpg.de/pub/perl/CPAN/
+                   ftp://ftp.rz.ruhr-uni-bochum.de/pub/CPAN/
+                   ftp://ftp.uni-erlangen.de/pub/source/CPAN/
+                   ftp://ftp.uni-hamburg.de/pub/soft/lang/perl/CPAN/
+    Germany        ftp://ftp.archive.de.uu.net/pub/CPAN/
+                   ftp://ftp.freenet.de/pub/ftp.cpan.org/pub/
+                   ftp://ftp.gmd.de/packages/CPAN/
+                   ftp://ftp.gwdg.de/pub/languages/perl/CPAN/
+
+ftp://ftp.leo.org/pub/comp/general/programming/languages/script/perl/CPAN/
+                   ftp://ftp.mpi-sb.mpg.de/pub/perl/CPAN/
+                   ftp://ftp.rz.ruhr-uni-bochum.de/pub/CPAN/
+                   ftp://ftp.uni-erlangen.de/pub/source/CPAN/
+                   ftp://ftp.uni-hamburg.de/pub/soft/lang/perl/CPAN/
+    Greece         ftp://ftp.ntua.gr/pub/lang/perl/
+    Hungary        ftp://ftp.kfki.hu/pub/packages/perl/CPAN/
+    Iceland        ftp://ftp.gm.is/pub/CPAN/
+    Ireland        ftp://cpan.indigo.ie/pub/CPAN/
+                   ftp://sunsite.compapp.dcu.ie/pub/perl/
+    Italy          ftp://cis.uniRoma2.it/CPAN/
+                   ftp://ftp.flashnet.it/pub/CPAN/
+                   ftp://ftp.unina.it/pub/Other/CPAN/
+                   ftp://ftp.unipi.it/pub/mirror/perl/CPAN/
+    Netherlands    ftp://ftp.cs.uu.nl/mirror/CPAN/
+                   ftp://ftp.nluug.nl/pub/languages/perl/CPAN/
+    Norway         ftp://ftp.uit.no/pub/languages/perl/cpan/
+                   ftp://sunsite.uio.no/pub/languages/perl/CPAN/
+    Poland         ftp://ftp.man.torun.pl/pub/CPAN/
+                   ftp://ftp.pk.edu.pl/pub/lang/perl/CPAN/
+                   ftp://sunsite.icm.edu.pl/pub/CPAN/
+    Portugal       ftp://ftp.ci.uminho.pt/pub/mirrors/cpan/
+                   ftp://ftp.ist.utl.pt/pub/CPAN/
+                   ftp://ftp.ua.pt/pub/CPAN/
+    Romania        ftp://ftp.dnttm.ro/pub/CPAN/
+    Russia         ftp://ftp.chg.ru/pub/lang/perl/CPAN/
+                   ftp://ftp.sai.msu.su/pub/lang/perl/CPAN/
+    Slovakia       ftp://ftp.entry.sk/pub/languages/perl/CPAN/
+    Slovenia       ftp://ftp.arnes.si/software/perl/CPAN/
+    Spain          ftp://ftp.etse.urv.es/pub/perl/
+                   ftp://ftp.rediris.es/mirror/CPAN/
+    Sweden         ftp://ftp.sunet.se/pub/lang/perl/CPAN/
+    Switzerland    ftp://sunsite.cnlab-switch.ch/mirror/CPAN/
+    Turkey         ftp://sunsite.bilkent.edu.tr/pub/languages/CPAN/
+    United Kingdom ftp://ftp.demon.co.uk/pub/mirrors/perl/CPAN/
+                   ftp://ftp.flirble.org/pub/languages/perl/CPAN/
+
+ftp://ftp.mirror.ac.uk/sites/ftp.funet.fi/pub/languages/perl/CPAN/
+                   ftp://ftp.plig.org/pub/CPAN/
+                   ftp://sunsite.doc.ic.ac.uk/packages/CPAN/
+
 
 =item North America
 
-   Alberta        http://sunsite.ualberta.ca/pub/Mirror/CPAN/
-                  ftp://sunsite.ualberta.ca/pub/Mirror/CPAN/
-   Alabama        http://mirror.hiwaay.net/CPAN/
-                  ftp://mirror.hiwaay.net/CPAN/
-   California     http://www.cpan.org/
-                  ftp://ftp.cpan.org/CPAN/
-                  ftp://cpan.nas.nasa.gov/pub/perl/CPAN/
-                  ftp://ftp.digital.com/pub/plan/perl/CPAN/
-                  http://www.kernel.org/pub/mirrors/cpan/
-                  ftp://ftp.kernel.org/pub/mirrors/cpan/
-                  http://www.perl.com/CPAN/
-                  http://download.sourceforge.net/mirrors/CPAN/
-   Colorado       ftp://ftp.cs.colorado.edu/pub/perl/CPAN/
-   Florida        ftp://ftp.cise.ufl.edu/pub/perl/CPAN/
-   Georgia        ftp://ftp.twoguys.org/CPAN/
-   Illinois       http://www.neurogames.com/mirrors/CPAN
-   Indiana        ftp://ftp.uwsg.indiana.edu/pub/perl/CPAN/
-                  http://cpan.nitco.com/
-                  ftp://cpan.nitco.com/pub/CPAN/
-                  ftp://cpan.in-span.net/
-                  http://csociety-ftp.ecn.purdue.edu/pub/CPAN
-                  ftp://csociety-ftp.ecn.purdue.edu/pub/CPAN
-   Manitoba       http://theoryx5.uwinnipeg.ca/pub/CPAN/
-                  ftp://theoryx5.uwinnipeg.ca/pub/CPAN/
-   Massachusetts  ftp://ftp.ccs.neu.edu/net/mirrors/ftp.funet.fi/pub/languages/perl/CPAN/
-                  ftp://ftp.iguide.com/pub/mirrors/packages/perl/CPAN/
-   Mexico         http://www.msg.com.mx/CPAN/
-                  ftp://ftp.msg.com.mx/pub/CPAN/
-   New Jersey     ftp://ftp.cpanel.net/pub/CPAN/
-   New York       ftp://ftp.freesoftware.com/pub/perl/CPAN/
-                  http://www.deao.net/mirrors/CPAN/
-                  ftp://ftp.deao.net/pub/CPAN/
-                  ftp://ftp.stealth.net/pub/mirrors/ftp.cpan.org/pub/CPAN/
-                  http://mirror.nyc.anidea.com/CPAN/
-                  ftp://mirror.nyc.anidea.com/pub/CPAN/
-                  http://www.rge.com/pub/languages/perl/
-                  ftp://ftp.rge.com/pub/languages/perl/
-                  ftp://mirrors.cloud9.net/pub/mirrors/CPAN/
-   North Carolina ftp://ftp.duke.edu/pub/perl/
-   Nova Scotia    ftp://cpan.chebucto.ns.ca/pub/CPAN/
-   Ohio           ftp://ftp.loaded.net/pub/CPAN/
-   Oklahoma       ftp://ftp.ou.edu/mirrors/CPAN/
-   Ontario        ftp://ftp.crc.ca/pub/packages/lang/perl/CPAN/
-   Oregon         ftp://ftp.orst.edu/pub/packages/CPAN/
-   Pennsylvania   http://ftp.epix.net/CPAN/
-                  ftp://ftp.epix.net/pub/languages/perl/
-                  ftp://carroll.cac.psu.edu/pub/CPAN/
-   Tennessee      ftp://ftp.sunsite.utk.edu/pub/CPAN/
-   Texas          http://ftp.sedl.org/pub/mirrors/CPAN/
-                  http://jhcloos.com/pub/mirror/CPAN/
-                  ftp://jhcloos.com/pub/mirror/CPAN/
-   Utah           ftp://mirror.xmission.com/CPAN/
-   Virginia       http://mirrors.rcn.net/pub/lang/CPAN/
-                  ftp://mirrors.rcn.net/pub/lang/CPAN/
-                  ftp://ruff.cs.jmu.edu/pub/CPAN/
-   Washington     http://cpan.llarian.net/
-                  ftp://cpan.llarian.net/pub/CPAN/
-                  ftp://ftp-mirror.internap.com/pub/CPAN/
-                  ftp://ftp.spu.edu/pub/CPAN/
-
-=item Oceania
-
- Australia      http://ftp.planetmirror.com/pub/CPAN/
-                ftp://ftp.planetmirror.com/pub/CPAN/
-                ftp://mirror.aarnet.edu.au/pub/perl/CPAN/
-                ftp://cpan.topend.com.au/pub/CPAN/
- New Zealand    ftp://ftp.auckland.ac.nz/pub/perl/CPAN/
+    Alberta        ftp://sunsite.ualberta.ca/pub/Mirror/CPAN/
+    California     ftp://cpan.nas.nasa.gov/pub/perl/CPAN/
+                   ftp://cpan.valueclick.com/CPAN/
+                   ftp://ftp.cdrom.com/pub/perl/CPAN/
+                   http://download.sourceforge.net/mirrors/CPAN/
+    Colorado       ftp://ftp.cs.colorado.edu/pub/perl/CPAN/
+    Florida        ftp://ftp.cise.ufl.edu/pub/perl/CPAN/
+    Georgia        ftp://ftp.twoguys.org/CPAN/
+    Illinois       ftp://uiarchive.uiuc.edu/pub/lang/perl/CPAN/
+    Indiana        ftp://csociety-ftp.ecn.purdue.edu/pub/CPAN/
+                   ftp://ftp.uwsg.indiana.edu/pub/perl/CPAN/
+    Kentucky       ftp://ftp.uky.edu/CPAN/
+    Manitoba       ftp://theoryx5.uwinnipeg.ca/pub/CPAN/
+    Massachusetts
+ftp://ftp.ccs.neu.edu/net/mirrors/ftp.funet.fi/pub/languages/perl/CPAN/
+                   ftp://ftp.iguide.com/pub/mirrors/packages/perl/CPAN/
+    Mexico         ftp://ftp.msg.com.mx/pub/CPAN/
+    New York       ftp://ftp.deao.net/pub/CPAN/
+                   ftp://ftp.rge.com/pub/languages/perl/
+    North Carolina ftp://ftp.duke.edu/pub/perl/
+    Nova Scotia    ftp://cpan.chebucto.ns.ca/pub/CPAN/
+    Oklahoma       ftp://ftp.ou.edu/mirrors/CPAN/
+    Ontario        ftp://ftp.crc.ca/pub/packages/lang/perl/CPAN/
+    Oregon         ftp://ftp.orst.edu/pub/packages/CPAN/
+    Pennsylvania   ftp://ftp.epix.net/pub/languages/perl/
+    Tennessee      ftp://ftp.sunsite.utk.edu/pub/CPAN/
+    Texas          ftp://ftp.sedl.org/pub/mirrors/CPAN/
+                   ftp://jhcloos.com/pub/mirror/CPAN/
+    Utah           ftp://mirror.xmission.com/CPAN/
+    Virginia       ftp://ftp.perl.org/pub/perl/CPAN/
+                   ftp://ruff.cs.jmu.edu/pub/CPAN/
+    Washington     ftp://ftp-mirror.internap.com/pub/CPAN/
+                   ftp://ftp.llarian.net/pub/CPAN/
+                   ftp://ftp.spu.edu/pub/CPAN/
+
 
 =item South America
 
- Argentina      ftp://mirrors.bannerlandia.com.ar/mirrors/CPAN/
- Brazil         ftp://cpan.pop-mg.com.br/pub/CPAN/
-                ftp://ftp.matrix.com.br/pub/perl/
-                ftp://cpan.if.usp.br/pub/mirror/CPAN/
- Chile          ftp://ftp.psinet.cl/pub/programming/perl/CPAN/
-                ftp://sunsite.dcc.uchile.cl/pub/lang/perl/
+    Brazil         ftp://cpan.if.usp.br/pub/mirror/CPAN/
+                   ftp://ftp.matrix.com.br/pub/perl/
+    Chile          ftp://sunsite.dcc.uchile.cl/pub/Lang/PERL/
 
 =back
 
index 285ed99..9a9bda9 100644 (file)
@@ -559,8 +559,8 @@ breaks the circularities in the self-referential structure.
 
 =head1 SEE ALSO
 
-A kinder, gentler tutorial on object-oriented programming in Perl can
-be found in L<perltoot>, L<perlbootc> and L<perltootc>.  You should
-also check out L<perlbot> for other object tricks, traps, and tips, as
-well as L<perlmodlib> for some style guides on constructing both
-modules and classes.
+A kinder, gentler tutorial on object-oriented programming in Perl
+can be found in L<perltoot> and L<perltootc>.  You should also check
+out L<perlbot> for other object tricks, traps, and tips, as well
+as L<perlmodlib> for some style guides on constructing both modules
+and classes.
index 0e7597e..48fcc56 100644 (file)
@@ -1046,7 +1046,7 @@ Also see:
 
 *
 
-L<perlos390>, F<README.os390>, F<perlbs2000>, F<README.vmesa>,
+L<perlos390>, F<README.os390>, F<perlposix-bc>, F<README.vmesa>,
 L<perlebcdic>.
 
 =item *
@@ -1871,7 +1871,6 @@ distribution available at http://www.perl.com/CPAN/src/index.html
        IRIX
        Linux
        MachTen
-       NonStop-UX
        ReliantUNIX     (SINIX)
        OpenVMS         (VMS)
        OS/2
@@ -1963,6 +1962,7 @@ of any trouble.
        MPC
        NEWS-OS
        NextSTEP
+       NonStop-UX
        OpenSTEP
        Opus
        Plan 9
@@ -2008,7 +2008,7 @@ http://www.perl.com/CPAN/ports/index.html for binary distributions.
 =head1 SEE ALSO
 
 L<perlaix>, L<perlamiga>, L<perlcygwin>, L<perldos>, L<perlepoc>,
-L<perlebcdic>, L<perlhpux>, L<perlos2>, L<perlos390>, L<perlbs2000>,
+L<perlebcdic>, L<perlhpux>, L<perlos2>, L<perlos390>, L<perlposix-bc>,
 L<perlwin32>, L<perlvms>, L<perlvos>, and L<Win32>.
 
 =head1 AUTHORS / CONTRIBUTORS
index ce2b9bd..c935a92 100644 (file)
@@ -40,7 +40,7 @@ is, no matter what C<$*> contains, C</s> without C</m> will force
 "^" to match only at the beginning of the string and "$" to match
 only at the end (or just before a newline at the end) of the string.
 Together, as /ms, they let the "." match any character whatsoever,
-while still allowing "^" and "$" to match, respectively, just after
+while yet allowing "^" and "$" to match, respectively, just after
 and just before newlines within the string.
 
 =item x
@@ -333,14 +333,12 @@ I<backreference>.
 
 There is no limit to the number of captured substrings that you may
 use.  However Perl also uses \10, \11, etc. as aliases for \010,
-\011, etc.  (Recall that 0 means octal, so \011 is the character at
-number 9 in your coded character set; which would be the 10th character,
-a horizontal tab under ASCII.)  Perl resolves this 
-ambiguity by interpreting \10 as a backreference only if at least 10 
-left parentheses have opened before it.  Likewise \11 is a 
-backreference only if at least 11 left parentheses have opened 
-before it.  And so on.  \1 through \9 are always interpreted as 
-backreferences.
+\011, etc.  (Recall that 0 means octal, so \011 is the 9'th ASCII
+character, a tab.)  Perl resolves this ambiguity by interpreting
+\10 as a backreference only if at least 10 left parentheses have
+opened before it.  Likewise \11 is a backreference only if at least
+11 left parentheses have opened before it.  And so on.  \1 through
+\9 are always interpreted as backreferences."
 
 Examples:
 
@@ -956,10 +954,10 @@ escape it with a backslash.  "-" is also taken literally when it is
 at the end of the list, just before the closing "]".  (The
 following all specify the same class of three characters: C<[-az]>,
 C<[az-]>, and C<[a\-z]>.  All are different from C<[a-z]>, which
-specifies a class containing twenty-six characters, even on EBCDIC
-based coded character sets.)  Also, if you try to use the character 
-classes C<\w>, C<\W>, C<\s>, C<\S>, C<\d>, or C<\D> as endpoints of 
-a range, that's not a range, the "-" is understood literally.
+specifies a class containing twenty-six characters.)
+Also, if you try to use the character classes C<\w>, C<\W>, C<\s>,
+C<\S>, C<\d>, or C<\D> as endpoints of a range, that's not a range,
+the "-" is understood literally.
 
 Note also that the whole range idea is rather unportable between
 character sets--and even within character sets they may cause results
@@ -971,11 +969,11 @@ spell out the character sets in full.
 Characters may be specified using a metacharacter syntax much like that
 used in C: "\n" matches a newline, "\t" a tab, "\r" a carriage return,
 "\f" a form feed, etc.  More generally, \I<nnn>, where I<nnn> is a string
-of octal digits, matches the character whose coded character set value 
-is I<nnn>.  Similarly, \xI<nn>, where I<nn> are hexadecimal digits, 
-matches the character whose numeric value is I<nn>. The expression \cI<x> 
-matches the character control-I<x>.  Finally, the "." metacharacter 
-matches any character except "\n" (unless you use C</s>).
+of octal digits, matches the character whose ASCII value is I<nnn>.
+Similarly, \xI<nn>, where I<nn> are hexadecimal digits, matches the
+character whose ASCII value is I<nn>. The expression \cI<x> matches the
+ASCII character control-I<x>.  Finally, the "." metacharacter matches any
+character except "\n" (unless you use C</s>).
 
 You can specify a series of alternatives for a pattern using "|" to
 separate them, so that C<fee|fie|foe> will match any of "fee", "fie",
@@ -1279,7 +1277,5 @@ L<perlfunc/pos>.
 
 L<perllocale>.
 
-L<perlebcdic>.
-
 I<Mastering Regular Expressions> by Jeffrey Friedl, published
 by O'Reilly and Associates.
index b97af5e..0c18e76 100644 (file)
@@ -1866,12 +1866,12 @@ wait, waitpid PID,FLAGS
 
 =item CHANGES
 
-v1.48, 02 February 2001, v1.47, 22 March 2000, v1.46, 12 February 2000,
-v1.45, 20 December 1999, v1.44, 19 July 1999, v1.43, 24 May 1999, v1.42, 22
-May 1999, v1.41, 19 May 1999, v1.40, 11 April 1999, v1.39, 11 February
-1999, v1.38, 31 December 1998, v1.37, 19 December 1998, v1.36, 9 September
-1998, v1.35, 13 August 1998, v1.33, 06 August 1998, v1.32, 05 August 1998,
-v1.30, 03 August 1998, v1.23, 10 July 1998
+v1.47, 22 March 2000, v1.46, 12 February 2000, v1.45, 20 December 1999,
+v1.44, 19 July 1999, v1.43, 24 May 1999, v1.42, 22 May 1999, v1.41, 19 May
+1999, v1.40, 11 April 1999, v1.39, 11 February 1999, v1.38, 31 December
+1998, v1.37, 19 December 1998, v1.36, 9 September 1998, v1.35, 13 August
+1998, v1.33, 06 August 1998, v1.32, 05 August 1998, v1.30, 03 August 1998,
+v1.23, 10 July 1998
 
 =item Supported Platforms
 
@@ -2224,8 +2224,20 @@ UNIVERSAL, User::grent, User::pwent
 
 =item CPAN
 
-Africa, Asia, Australasia, Central America, Europe, North America, South
-America
+Language Extensions and Documentation Tools, Development Support, Operating
+System Interfaces, Networking, Device Control (modems) and InterProcess
+Communication, Data Types and Data Type Utilities, Database Interfaces,
+User Interfaces, Interfaces to / Emulations of Other Programming Languages,
+File Names, File Systems and File Locking (see also File Handles), String
+Processing, Language Text Processing, Parsing, and Searching, Option,
+Argument, Parameter, and Configuration File Processing,
+Internationalization and Locale, Authentication, Security, and Encryption,
+World Wide Web, HTML, HTTP, CGI, MIME, Server and Daemon Utilities,
+Archiving and Compression, Images, Pixmap and Bitmap Manipulation, Drawing,
+and Graphing, Mail and Usenet News, Control Flow Utilities (callbacks and
+exceptions etc), File Handle and Input/Output Stream Utilities,
+Miscellaneous Modules, Africa, Asia, Australasia, Central America, Europe,
+North America, South America
 
 =item Modules: Creation, Use, and Abuse
 
@@ -2254,6 +2266,12 @@ to ::, Converts die(...) to croak(...), Several other minor changes
 
 =item Guidelines for Reusing Application Code
 
+Complete applications rarely belong in the Perl Module Library, Many
+applications contain some Perl code that could be reused, Break-out the
+reusable code into one or more separate module files, Take the opportunity
+to reconsider and redesign the interfaces, In some cases the 'application'
+can then be reduced to a small
+
 =back
 
 =item NOTE
@@ -5207,49 +5225,6 @@ sh Configure -Dprefix=/ade -Dloclibpth=/ade/lib
 
 =back
 
-=head2 perlbs2000, README.posix-bc - building and installing Perl for
-BS2000 POSIX.
-
-=over 4
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=over 4
-
-=item gzip
-
-=item bison
-
-=item Unpacking
-
-=item Compiling
-
-=item Testing
-
-=item Install
-
-=item Using Perl
-
-=item Floating point anomalies
-
-=back
-
-=item AUTHORS
-
-=item SEE ALSO
-
-=over 4
-
-=item Mailing list
-
-=back
-
-=item HISTORY
-
-=back
-
 =head2 perlcygwin, README.cygwin - Perl for Cygwin
 
 =over 4
@@ -5761,12 +5736,8 @@ C<COND_WAIT>, F<os2.c>
 
 =item testing anomalies
 
-=item installation anomalies
-
 =item Usage Hints
 
-=item Floating point anomalies
-
 =item Modules and Extensions
 
 =back
@@ -5785,6 +5756,47 @@ C<COND_WAIT>, F<os2.c>
 
 =back
 
+=head2 perlposix-bc, README.posix-bc - building and installing Perl for
+BS2000 POSIX.
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item gzip
+
+=item bison
+
+=item Unpacking
+
+=item Compiling
+
+=item Testing
+
+=item Install
+
+=item Using Perl
+
+=back
+
+=item AUTHORS
+
+=item SEE ALSO
+
+=over 4
+
+=item Mailing list
+
+=back
+
+=item HISTORY
+
+=back
+
 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
 
 =over 4
@@ -5869,52 +5881,6 @@ DATAMODEL_NATIVE specified", sh: ar: not found
 
 =back
 
-=head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
-
-=over 4
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=over 4
-
-=item Unpacking
-
-=item Setup and utilities
-
-=item Configure
-
-- Don't turn on the compiler optimization flag "-O".  There's    a bug in
-the compiler (APAR PQ18812) that generates some bad code       the
-optimizer is on, - As VM/ESA doesn't fully support the fork() API programs
-relying on      this call will not work. I've replaced fork()/exec() with
-spawn()       and the standalone exec() with spawn(). This has a side
-effect when    opening unnamed pipes in a shell script: there is no child
-process      generated under
-
-=item testing anomalies
-
-=item Usage Hints
-
-When using perl on VM/ESA please keep in mind that the EBCDIC and ASCII
-character sets are different.  Perl builtin functions that may behave
-differently under EBCDIC are mentioned in the perlport.pod document.
-
-=back
-
-=item AUTHORS
-
-=item SEE ALSO
-
-=over 4
-
-=item Mailing list
-
-=back
-
-=back
-
 =head2 perlvms - VMS-specific documentation for Perl
 
 =over 4
@@ -9105,9 +9071,9 @@ INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A, LIBS, LINKTYPE,
 MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME,
 NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE, PERL, PERLMAINCC,
 PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERL_SRC, PERM_RW, PERM_RWX,
-PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
-PPM_INSTALL_SCRIPT, PREFIX, PREREQ_PM, SKIP, TYPEMAPS, VERSION,
-VERSION_FROM, XS, XSOPT, XSPROTOARG, XS_VERSION
+PL_FILES, PM, PMLIBDIRS, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT,
+PREFIX, PREREQ_PM, SKIP, TYPEMAPS, VERSION, VERSION_FROM, XS, XSOPT,
+XSPROTOARG, XS_VERSION
 
 =item Additional lowercase attributes
 
index 38cc1f3..594cb99 100644 (file)
@@ -425,10 +425,6 @@ this could be done:
 Notice how there's no memory to deallocate in the destructor?  That's
 something that Perl takes care of for you all by itself.
 
-Alternatively, you could use the Class::Data::Inheritable module from
-CPAN.
-
-
 =head2 Accessing Class Data
 
 It turns out that this is not really a good way to go about handling
@@ -1754,16 +1750,6 @@ L<perltie>,
 and
 L<overload>.
 
-L<perlboot> is a kinder, gentler introduction to object-oriented
-programming.
-
-L<perltootc> provides more detail on class data.
-
-Some modules which might prove interesting are Class::Accessor,
-Class::Class, Class::Contract, Class::Data::Inheritable,
-Class::MethodMaker and Tie::SecureHash
-
-
 =head1 AUTHOR AND COPYRIGHT
 
 Copyright (c) 1997, 1998 Tom Christiansen 
index d2d881c..ee0bd02 100644 (file)
@@ -74,15 +74,6 @@ you can elect to permit access to them from anywhere in the entire file
 scope, or you can limit direct data access exclusively to the methods
 implementing those attributes.
 
-=head1 Class Data in a Can
-
-One of the easiest ways to solve a hard problem is to let someone else
-do it for you!  In this case, Class::Data::Inheritable (available on a
-CPAN near you) offers a canned solution to the class data problem
-using closures.  So before you wade into this document, consider
-having a look at that module.
-
-
 =head1 Class Data as Package Variables
 
 Because a class in Perl is really just a package, using package variables
@@ -1311,8 +1302,7 @@ would just confuse the examples.
 
 L<perltoot>, L<perlobj>, L<perlmod>, and L<perlbot>.
 
-The Tie::SecureHash and Class::Data::Inheritable modules from CPAN are
-worth checking out.
+The Tie::SecureHash module from CPAN is worth checking out.
 
 =head1 AUTHOR AND COPYRIGHT
 
@@ -1344,4 +1334,4 @@ object-oriented languages enforce.
 
 =head1 HISTORY
 
-Last edit: Sun Feb  4 20:50:28 EST 2001
+Last edit: Fri May 21 15:47:56 MDT 1999
diff --git a/sv.c b/sv.c
index aca5801..0338cc1 100644 (file)
--- a/sv.c
+++ b/sv.c
@@ -808,23 +808,6 @@ S_more_xpvbm(pTHX)
 
 #ifdef PURIFY
 
-#define new_XSV(p) \
-    STMT_START {                               \
-       (p) = my_safemalloc(sizeof(SV));        \
-       ++PL_sv_count;                          \
-       SvANY(p) = 0;                           \
-       SvREFCNT(p) = 1;                        \
-       SvFLAGS(p) = 0;                         \
-    } STMT_END
-
-#define del_XSV(p) \
-    STMT_START {                               \
-       my_safefree(p);                         \
-       --PL_sv_count;                          \
-    } STMT_END
-#define new_XSV(p)     new_SV(p)
-#define del_XSV(p)     del_SV(p)
-
 #define new_XIV()      my_safemalloc(sizeof(XPVIV))
 #define del_XIV(p)     my_safefree(p)
 
@@ -863,9 +846,6 @@ S_more_xpvbm(pTHX)
 
 #else /* !PURIFY */
 
-#define new_XSV(p)     new_SV(p)
-#define del_XSV(p)     del_SV(p)
-
 #define new_XIV()      (void*)new_xiv()
 #define del_XIV(p)     del_xiv((XPVIV*) p)
 
@@ -3297,7 +3277,7 @@ Perl_newSV(pTHX_ STRLEN len)
 {
     register SV *sv;
     
-    new_XSV(sv);
+    new_SV(sv);
     if (len) {
        sv_upgrade(sv, SVt_PV);
        SvGROW(sv, len + 1);
@@ -3701,7 +3681,7 @@ Perl_sv_replace(pTHX_ register SV *sv, register SV *nsv)
     StructCopy(nsv,sv,SV);
     SvREFCNT(sv) = refcnt;
     SvFLAGS(nsv) |= SVTYPEMASK;                /* Mark as freed */
-    del_XSV(nsv);
+    del_SV(nsv);
 }
 
 /*
@@ -3953,7 +3933,7 @@ Perl_sv_free(pTHX_ SV *sv)
     }
     sv_clear(sv);
     if (! SvREFCNT(sv))
-       del_XSV(sv);
+       del_SV(sv);
 }
 
 /*
@@ -4794,7 +4774,7 @@ Perl_sv_mortalcopy(pTHX_ SV *oldstr)
 {
     register SV *sv;
 
-    new_XSV(sv);
+    new_SV(sv);
     sv_setsv(sv,oldstr);
     EXTEND_MORTAL(1);
     PL_tmps_stack[++PL_tmps_ix] = sv;
@@ -4815,7 +4795,7 @@ Perl_sv_newmortal(pTHX)
 {
     register SV *sv;
 
-    new_XSV(sv);
+    new_SV(sv);
     SvFLAGS(sv) = SVs_TEMP;
     EXTEND_MORTAL(1);
     PL_tmps_stack[++PL_tmps_ix] = sv;
@@ -4861,7 +4841,7 @@ Perl_newSVpv(pTHX_ const char *s, STRLEN len)
 {
     register SV *sv;
 
-    new_XSV(sv);
+    new_SV(sv);
     if (!len)
        len = strlen(s);
     sv_setpvn(sv,s,len);
@@ -4884,7 +4864,7 @@ Perl_newSVpvn(pTHX_ const char *s, STRLEN len)
 {
     register SV *sv;
 
-    new_XSV(sv);
+    new_SV(sv);
     sv_setpvn(sv,s,len);
     return sv;
 }
@@ -4927,7 +4907,7 @@ SV *
 Perl_vnewSVpvf(pTHX_ const char* pat, va_list* args)
 {
     register SV *sv;
-    new_XSV(sv);
+    new_SV(sv);
     sv_vsetpvfn(sv, pat, strlen(pat), args, Null(SV**), 0, Null(bool*));
     return sv;
 }
@@ -4946,7 +4926,7 @@ Perl_newSVnv(pTHX_ NV n)
 {
     register SV *sv;
 
-    new_XSV(sv);
+    new_SV(sv);
     sv_setnv(sv,n);
     return sv;
 }
@@ -4965,7 +4945,7 @@ Perl_newSViv(pTHX_ IV i)
 {
     register SV *sv;
 
-    new_XSV(sv);
+    new_SV(sv);
     sv_setiv(sv,i);
     return sv;
 }
@@ -4984,7 +4964,7 @@ Perl_newSVuv(pTHX_ UV u)
 {
     register SV *sv;
 
-    new_XSV(sv);
+    new_SV(sv);
     sv_setuv(sv,u);
     return sv;
 }
@@ -5003,7 +4983,7 @@ Perl_newRV_noinc(pTHX_ SV *tmpRef)
 {
     register SV *sv;
 
-    new_XSV(sv);
+    new_SV(sv);
     sv_upgrade(sv, SVt_RV);
     SvTEMP_off(tmpRef);
     SvRV(sv) = tmpRef;
@@ -5040,7 +5020,7 @@ Perl_newSVsv(pTHX_ register SV *old)
            Perl_warner(aTHX_ WARN_INTERNAL, "semi-panic: attempt to dup freed string");
        return Nullsv;
     }
-    new_XSV(sv);
+    new_SV(sv);
     if (SvTEMP(old)) {
        SvTEMP_off(old);
        sv_setsv(sv,old);
@@ -5516,7 +5496,7 @@ Perl_newSVrv(pTHX_ SV *rv, const char *classname)
 {
     SV *sv;
 
-    new_XSV(sv);
+    new_SV(sv);
 
     SV_CHECK_THINKFIRST(rv);
     SvAMAGIC_off(rv);
@@ -6921,7 +6901,7 @@ Perl_sv_dup(pTHX_ SV *sstr)
        return dstr;
 
     /* create anew and remember what it is */
-    new_XSV(dstr);
+    new_SV(dstr);
     ptr_table_store(PL_ptr_table, sstr, dstr);
 
     /* clone */
index 63db823..3805848 100644 (file)
@@ -345,7 +345,7 @@ INST_LIB    = $(INST_TOP)$(INST_VER)\lib
 INST_ARCHLIB   = $(INST_LIB)$(INST_ARCH)
 INST_COREDIR   = $(INST_ARCHLIB)\CORE
 INST_POD       = $(INST_LIB)\pod
-INST_HTML      = $(INST_TOP)$(INST_VER)\html
+INST_HTML      = $(INST_POD)\html
 
 #
 # Programs to compile, build .lib files and link
@@ -998,20 +998,13 @@ utils: $(PERLEXE) $(X2P)
        cd ..\utils
        $(MAKE) PERL=$(MINIPERL)
        cd ..\pod
-       copy ..\README.aix .\perlaix.pod
        copy ..\README.amiga .\perlamiga.pod
        copy ..\README.cygwin .\perlcygwin.pod
        copy ..\README.dos .\perldos.pod
-       copy ..\README.epoc .\perlepoc.pod
        copy ..\README.hpux .\perlhpux.pod
        copy ..\README.machten .\perlmachten.pod
        copy ..\README.os2 .\perlos2.pod
-       copy ..\README.os390 .\perlos390.pod
-       copy ..\README.vmesa .\perlvmesa.pod
-       copy ..\README.bs2000 .\perlbs2000.pod
-       copy ..\README.solaris .\perlsolaris.pod
        copy ..\vms\perlvms.pod .\perlvms.pod
-       copy ..\README.vos ..\perlvos.pod
        copy ..\README.win32 .\perlwin32.pod
        $(MAKE) -f ..\win32\pod.mak converters
        cd ..\win32
index bcf0721..2e2a02f 100644 (file)
@@ -340,7 +340,7 @@ INST_LIB    = $(INST_TOP)$(INST_VER)\lib
 INST_ARCHLIB   = $(INST_LIB)$(INST_ARCH)
 INST_COREDIR   = $(INST_ARCHLIB)\CORE
 INST_POD       = $(INST_LIB)\pod
-INST_HTML      = $(INST_TOP)$(INST_VER)\html
+INST_HTML      = $(INST_POD)\html
 
 #
 # Programs to compile, build .lib files and link
@@ -1211,20 +1211,14 @@ doc: $(PERLEXE)
 
 utils: $(PERLEXE) $(X2P)
        cd ..\utils && $(MAKE) PERL=$(MINIPERL)
-       copy ..\README.aix .\perlaix.pod
        copy ..\README.amiga ..\pod\perlamiga.pod
        copy ..\README.cygwin ..\pod\perlcygwin.pod
        copy ..\README.dos ..\pod\perldos.pod
-       copy ..\README.epoc .\perlepoc.pod
        copy ..\README.hpux ..\pod\perlhpux.pod
        copy ..\README.machten ..\pod\perlmachten.pod
        copy ..\README.os2 ..\pod\perlos2.pod
-       copy ..\README.os390 ..\pod\perlos390.pod
-       copy ..\README.vmesa ..\pod\perlvmesa.pod
-       copy ..\README.bs2000 ..\pod\perlbs2000.pod
-       copy ..\README.solaris .\perlsolaris.pod
+       copy ..\README.os2 ..\pod\perlos2.pod
        copy ..\vms\perlvms.pod ..\pod\perlvms.pod
-       copy ..\README.vos ..\perlvos.pod
        cd ..\pod && $(MAKE) -f ..\win32\pod.mak converters
        $(PERLEXE) $(PL2BAT) $(UTILS)