Documentation updates to prepare for release

p4raw-id: //depot/maint-5.005/perl@22269

5 files changed, 142 insertions, 131 deletions

diff --git a/INSTALL b/INSTALL
index 43d00d9ae2..7f8609f885 100644
--- a/INSTALL
+++ b/INSTALL
@@ -6,7 +6,7 @@ Install - Build and Installation guide for perl5.
 
 First, make sure you are installing an up-to-date version of Perl.   If
 you didn't get your Perl source from CPAN, check the latest version at
-<URL:http://www.perl.com/CPAN/src/>.
+<URL:http://www.cpan.org/src/>.
 
 The basic steps to build and install perl5 on a Unix system are:
 
@@ -82,7 +82,7 @@ run, you may have to run it on a platform where GCC is available, and move
 the sources back to the platform without GCC.
 
 If you succeed in automatically converting the sources to a K&R compatible
-form, be sure to email perlbug@perl.com to let us know the steps you
+form, be sure to email perlbug@perl.org to let us know the steps you
 followed.  This will enable us to officially support this option.
 
 =head1 Space Requirements
@@ -996,7 +996,7 @@ including a glossary of all those config.sh variables, is in the Porting
 subdirectory.
 
 Ports for other systems may also be available.  You should check out
-http://www.perl.com/CPAN/ports for current information on ports to
+http://www.cpan.org/ports for current information on ports to
 various other operating systems.
 
 =back
diff --git a/README b/README
index e3ccad49bc..18f1104be1 100644
--- a/README
+++ b/README
@@ -1,7 +1,7 @@
 
 			   Perl Kit, Version 5.0
 
-		       Copyright 1989-1999, Larry Wall
+            Copyright 1989-1999, 2003, 2004, by Larry Wall and others
 			    All rights reserved.
 
     This program is free software; you can redistribute it and/or modify
diff --git a/pod/perl.pod b/pod/perl.pod
index 6e218cd1f3..9aa753d55d 100644
--- a/pod/perl.pod
+++ b/pod/perl.pod
@@ -231,7 +231,7 @@ all old regular expressions.
 
 The Comprehensive Perl Archive Network described in L<perlmodlib>
 contains hundreds of plug-and-play modules full of reusable code.
-See F<http://www.perl.com/CPAN> for a site near you.
+See F<http://www.cpan.org/> for a site near you.
 
 =item * Compilability
 
@@ -245,76 +245,8 @@ Okay, that's I<definitely> enough hype.
 
 =head1 AVAILABILITY
 
-Perl is available for the vast majority of operating system platforms,
-including most Unix-like platforms. The following situation is as of
-February 1999 and Perl 5.005_03.
-
-The following platforms are able to build Perl from the standard
-source code distribution available at
-F<http://www.perl.com/CPAN/src/index.html>
-
-        AIX             Linux           SCO ODT/OSR
-        A/UX            MachTen         Solaris
-        BeOS            MPE/iX          SunOS
-        BSD/OS          NetBSD          SVR4
-        DG/UX           NextSTEP        Tru64 UNIX      3)
-        DomainOS        OpenBSD         Ultrix
-        DOS DJGPP 1)    OpenSTEP        UNICOS
-        DYNIX/ptx       OS/2            VMS
-        FreeBSD         OS390     2)    VOS
-        HP-UX           PowerMAX        Windows 3.1     1)
-        Hurd            QNX             Windows 95      1) 4)
-        IRIX                            Windows 98      1) 4)
-                                        Windows NT      1) 4)
-
-        1) in DOS mode either the DOS or OS/2 ports can be used
-        2) formerly known as MVS
-        3) formerly known as Digital UNIX and before that DEC OSF/1
-        4) compilers: Borland, Cygwin32, Mingw32 EGCS/GCC, VC++
-
-The following platforms have been known to build Perl from the source
-but for the Perl release 5.005_03 we haven't been able to verify them,
-either because the hardware/software platforms are rather rare or
-because we don't have an active champion on these platforms, or both.
-					
-        3b1             FPS             Plan 9
-        AmigaOS         GENIX           PowerUX
-        ConvexOS        Greenhills      RISC/os
-        CX/UX           ISC             Stellar
-        DC/OSx          MachTen 68k     SVR2
-        DDE SMES        MiNT            TI1500
-        DOS EMX         MPC             TitanOS
-        Dynix           NEWS-OS         UNICOS/mk
-        EP/IX           Opus            Unisys Dynix
-        ESIX    			Unixware
-
-The following platforms are planned to be supported in the standard
-source code distribution of the Perl release 5.006 but are not
-supported in the Perl release 5.005_03:
-
-        BS2000
-	Netware
-	Rhapsody
-        VM/ESA
-
-The following platforms have their own source code distributions and
-binaries available via F<http://www.perl.com/CPAN/ports/index.html>.
-
-				Perl release
-
-	AS/400			5.003
-	MacOS			5.004
-	Netware			5.003_07
-	Tandem Guardian		5.004
-
-The following platforms have only binaries available via
-F<http://www.perl.com/CPAN/ports/index.html>.
-
-				Perl release
-
-	Acorn RISCOS		5.005_02
-	AOS			5.002
-	LynxOS			5.004_02
+Perl is available for most operating systems, including virtually
+all Unix-like platforms.
 
 =head1 ENVIRONMENT
 
diff --git a/pod/perldelta.pod b/pod/perldelta.pod
index a0af1e16dd..4d3ed1163d 100644
--- a/pod/perldelta.pod
+++ b/pod/perldelta.pod
@@ -6,6 +6,16 @@ perldelta - what's new for perl5.005
 
 This document describes differences between the 5.004 release and this one.
 
+=head1 5.005_04
+
+This section describes the differences between the 5.005_03 and
+5.005_04 releases. 5.005_04 is mainly an operating system
+compatibility release.
+
+Perl now compiles and runs under modern Unix systems, including those
+with recent Berkeley DB libraries or GCC 3. Additionally, it now runs
+under Mac OS X (10.3).
+
 =head1 About the new versioning system
 
 Perl is now developed on two tracks: a maintenance track that makes
@@ -1006,7 +1016,7 @@ Home Page.
 If you believe you have an unreported bug, please run the B<perlbug>
 program included with your release.  Make sure you trim your bug down
 to a tiny but sufficient test case.  Your bug report, along with the
-output of C<perl -V>, will be sent off to <F<perlbug@perl.com>> to be
+output of C<perl -V>, will be sent off to <F<perlbug@perl.org>> to be
 analysed by the Perl porting team.
 
 =head1 SEE ALSO
@@ -1024,6 +1034,6 @@ The F<Artistic> and F<Copying> files for copyright information.
 Written by Gurusamy Sarathy <F<gsar@umich.edu>>, with many contributions
 from The Perl Porters.
 
-Send omissions or corrections to <F<perlbug@perl.com>>.
+Send omissions or corrections to <F<perlbug@perl.org>>.
 
 =cut
diff --git a/pod/perlhist.pod b/pod/perlhist.pod
index 5828ea4fcd..0d2df834f3 100644
--- a/pod/perlhist.pod
+++ b/pod/perlhist.pod
@@ -1,17 +1,7 @@
-=pod
-
 =head1 NAME
 
 perlhist - the Perl history records
 
-=begin RCS
-
-#
-# $Id: perlhist.pod,v 1.57 1999/01/26 17:38:07 jhi Exp $
-#
-
-=end RCS
-
 =head1 DESCRIPTION
 
 This document aims to record the Perl source code releases.
@@ -34,7 +24,9 @@ Perl history in brief, by Larry Wall:
 
 Larry Wall, Andy Dougherty, Tom Christiansen, Charles Bailey, Nick
 Ing-Simmons, Chip Salzenberg, Tim Bunce, Malcolm Beattie, Gurusamy
-Sarathy, Graham Barr.
+Sarathy, Graham Barr, Jarkko Hietaniemi, Hugo van der Sanden,
+Michael Schwern, Rafael Garcia-Suarez, Nicholas Clark, Richard Clamp,
+Leon Brocard.
 
 =head2 PUMPKIN?
 
@@ -75,6 +67,8 @@ the strings?).
 
           1.001..10     1988-Jan-30
           1.011..14     1988-Feb-02
+ Schwern  1.0.15        2002-Dec-18     Modernization
+ Richard  1.0.16        2003-Dec-18
 
  Larry   2.000          1988-Jun-05
 
@@ -96,7 +90,7 @@ the strings?).
           3.037         1990-Oct-20
           3.040         1990-Nov-10
           3.041         1990-Nov-13
-          3.042..43     1990-Jan-??
+          3.042..43     1991-Jan-??
           3.044         1991-Jan-12
 
  Larry   4.000          1991-Mar-21
@@ -117,16 +111,16 @@ the strings?).
           5.000alpha4   1993-???-??
           5.000alpha5   1993-???-??
           5.000alpha6   1994-Mar-18
-          5.003alpha7   1994-Mar-25
+          5.000alpha7   1994-Mar-25
  Andy     5.000alpha8   1994-Apr-04
  Larry    5.000alpha9   1994-May-05     ext appears.
-          5.000alpha10  1994-???-??
-          5.000alpha11  1994-???-??
+          5.000alpha10  1994-Jun-11
+          5.000alpha11  1994-Jul-01
  Andy     5.000a11a     1994-Jul-07     To fit 14.
           5.000a11b     1994-Jul-14
           5.000a11c     1994-Jul-19
           5.000a11d     1994-Jul-22
- Larry    5.000alpha12  1994-???-??
+ Larry    5.000alpha12  1994-Aug-04
  Andy     5.000a12a     1994-Aug-08
           5.000a12b     1994-Aug-15
           5.000a12c     1994-Aug-22
@@ -135,8 +129,8 @@ the strings?).
           5.000a12f     1994-Aug-24
           5.000a12g     1994-Aug-24
           5.000a12h     1994-Aug-24
- Larry    5.000beta1    1994-???-??
- Andy     5.000b1a      1994-???-??
+ Larry    5.000beta1    1994-Aug-30
+ Andy     5.000b1a      1994-Sep-06
  Larry    5.000beta2    1994-Sep-14     Core slushified.
  Andy     5.000b2a      1994-Sep-14
           5.000b2b      1994-Sep-17
@@ -150,8 +144,9 @@ the strings?).
           5.000b3f      1994-Sep-30
           5.000b3g      1994-Oct-04
  Andy     5.000b3h      1994-Oct-07
+ Larry?   5.000gamma    1994-Oct-13?
 
- Larry   5.000          1994-Oct-18
+ Larry   5.000          1994-Oct-17
 
  Andy     5.000a        1994-Dec-19
           5.000b        1995-Jan-18
@@ -165,8 +160,9 @@ the strings?).
           5.000j        1995-Feb-07
           5.000k        1995-Feb-11
           5.000l        1995-Feb-21
-          5.000m        1995-???-??
+          5.000m        1995-Feb-28
           5.000n        1995-Mar-07
+          5.000o        1995-Mar-13?
 
  Larry   5.001          1995-Mar-13
 
@@ -185,7 +181,7 @@ the strings?).
           5.001m        1995-Jul-02     Very stable.
           5.001n        1995-Oct-31     Very unstable.
           5.002beta1    1995-Nov-21
-          5.002b1a      1995-Nov-??
+          5.002b1a      1995-Dec-04
           5.002b1b      1995-Dec-04
           5.002b1c      1995-Dec-04
           5.002b1d      1995-Dec-04
@@ -258,19 +254,31 @@ the strings?).
 
  Chip    5.004          1997-May-15     A major maintenance release.
 
- Tim      5.004_01      1997-Jun-13     The 5.004 maintenance track.
+ Tim      5.004_01-t1   1997-???-??     The 5.004 maintenance track.
+          5.004_01-t2   1997-Jun-11     aka perl5.004m1t2
+          5.004_01      1997-Jun-13
+          5.004_01_01   1997-Jul-29     aka perl5.004m2t1
+          5.004_01_02   1997-Aug-01     aka perl5.004m2t2
+          5.004_01_03   1997-Aug-05     aka perl5.004m2t3
           5.004_02      1997-Aug-07
+          5.004_02_01   1997-Aug-12     aka perl5.004m3t1
+          5.004_03-t2   1997-Aug-13     aka perl5.004m3t2
           5.004_03      1997-Sep-05
+          5.004_04-t1   1997-Sep-19     aka perl5.004m4t1
+          5.004_04-t2   1997-Sep-23     aka perl5.004m4t2
+          5.004_04-t3   1997-Oct-10     aka perl5.004m4t3
+          5.004_04-t4   1997-Oct-14     aka perl5.004m4t4
           5.004_04      1997-Oct-15
-          5.004m5t1     1998-Mar-04     Maintenance Trials (for 5.004_05).
-          5.004_04-m2   1997-May-01
+          5.004_04-m1   1998-Mar-04     (5.004m5t1) Maint. trials for 5.004_05.
+          5.004_04-m2   1998-May-01
           5.004_04-m3   1998-May-15
           5.004_04-m4   1998-May-19
-          5.004_04-MT5  1998-Jul-21
-          5.004_04-MT6  1998-Oct-09
-          5.004_04-MT7  1998-Nov-22
-          5.004_04-MT8  1998-Dec-03
-          5.004_04-MT9  1999-***-**
+          5.004_05-MT5  1998-Jul-21
+          5.004_05-MT6  1998-Oct-09
+          5.004_05-MT7  1998-Nov-22
+          5.004_05-MT8  1998-Dec-03
+ Chip     5.004_05-MT9  1999-Apr-26
+          5.004_05      1999-Apr-29
 
  Malcolm  5.004_50      1997-Sep-09     The 5.005 development track.
           5.004_51      1997-Oct-02
@@ -310,16 +318,62 @@ the strings?).
           5.005_03-MT3  1999-Jan-17
           5.005_03-MT4  1999-Jan-26
           5.005_03-MT5  1999-Jan-28
-          5.005_03-MT6  1999-Mar-04
+          5.005_03-MT6  1999-Mar-05
           5.005_03      1999-Mar-28
+ Leon     5.005_04      2004-Feb-05
 
- Sarathy  5.005_50      1998-Jul-26     The 5.006 development track.
+ Sarathy  5.005_50      1998-Jul-26     The 5.6 development track.
           5.005_51      1998-Aug-10
           5.005_52      1998-Sep-25
           5.005_53      1998-Oct-31
           5.005_54      1998-Nov-30
           5.005_55      1999-Feb-16
           5.005_56      1999-Mar-01
+          5.005_57      1999-May-25
+          5.005_58      1999-Jul-27
+          5.005_59      1999-Aug-02
+          5.005_60      1999-Aug-02
+          5.005_61      1999-Aug-20
+          5.005_62      1999-Oct-15
+          5.005_63      1999-Dec-09
+          5.5.640       2000-Feb-02
+          5.5.650       2000-Feb-08     beta1
+          5.5.660       2000-Feb-22     beta2
+          5.5.670       2000-Feb-29     beta3
+          5.6.0-RC1     2000-Mar-09     Release candidate 1.
+          5.6.0-RC2     2000-Mar-14     Release candidate 2.
+          5.6.0-RC3     2000-Mar-21     Release candidate 3.
+          5.6.0         2000-Mar-22
+
+ Sarathy  5.6.1-TRIAL1  2000-Dec-18     The 5.6 maintenance track.
+          5.6.1-TRIAL2  2001-Jan-31
+          5.6.1-TRIAL3  2001-Mar-19
+          5.6.1-foolish 2001-Apr-01     The "fools-gold" release.
+          5.6.1         2001-Apr-08
+ Rafael   5.6.2-RC1     2003-Nov-08
+          5.6.2         2003-Nov-15     Fix new build issues
+
+ Jarkko   5.7.0         2000-Sep-02     The 5.7 track: Development.
+          5.7.1         2001-Apr-09
+          5.7.2         2001-Jul-13     Virtual release candidate 0.
+          5.7.3         2002-Mar-05
+          5.8.0-RC1     2002-Jun-01
+          5.8.0-RC2     2002-Jun-21
+          5.8.0-RC3     2002-Jul-13
+          5.8.0         2002-Jul-18
+          5.8.1-RC1     2003-Jul-10
+          5.8.1-RC2     2003-Jul-11
+          5.8.1-RC3     2003-Jul-30
+          5.8.1-RC4     2003-Aug-01
+          5.8.1-RC5     2003-Sep-22
+          5.8.1         2003-Sep-25
+ Nicholas 5.8.2-RC1     2003-Oct-27
+          5.8.2-RC2     2003-Nov-03
+          5.8.2         2003-Nov-05
+          5.8.3-RC1     2004-Jan-07
+          5.8.3         2004-Jan-14
+
+ Hugo     5.9.0         2003-Oct-27
 
 =head2 SELECTED RELEASE SIZES
 
@@ -352,6 +406,7 @@ explained below.
  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_05       1463  60   1435 150    394  50    445 175   1855  59
  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
@@ -363,6 +418,16 @@ explained below.
  5.004_73       1874  76   1467 152    762 102    506 196   1883  61
  5.004_75       1877  76   1467 152    770 103    508 196   1896  62
  5.005          1896  76   1469 152    795 103    509 197   1945  63
+ 5.005_03       1936  77   1541 153    813 104    551 201   2176  72       
+ 5.005_50       1969  78   1842 301    795 103    514 198   1948  63
+ 5.005_53       1999  79   1885 303    806 104    602 224   2002  67
+ 5.005_56       2086  79   1970 307    866 113    672 238   2221  75
+ 5.6.0          2930  80   2626 364   1096 129    868 281   2841  93
+ 5.7.0          2977  80   2801 425   1250 132    975 307   3206 100
+ 5.6.1          3049  80   3764 484   1924 159   1025 304   3593 119
+ 5.7.1          3351  84   3442 455   1944 167   1334 357   3698 124
+ 5.7.2          3491  87   4858 618   3290 298   1598 449   3910 139
+ 5.7.3          3415  87   5367 630  14448 410   2205 640   4491 148
 
 The "core"..."doc" mean the following files from the Perl source code
 distribution.  The glob notation ** means recursively, (.) means
@@ -371,7 +436,7 @@ regular files.
  core   *.[hcy]
  lib    lib/**/*.p[ml]
  ext    ext/**/*.{[hcyt],xs,pm}
- t      t/**/*(.)
+ t      t/**/*(.) (for 1-5.005_56) or **/*.t (for 5.6.0-5.7.3)
  doc    {README*,INSTALL,*[_.]man{,.?},pod/**/*.pod}
 
 Here are some statistics for the other subdirectories and one file in
@@ -439,25 +504,28 @@ the Perl source distribution for somewhat more selected releases.
 
  ======================================================================
 
-            5.004_70 5.004_73 5.004_75  5.005
-
- beos         1   1    1   1    1   1    1   1
- Configure  256   1  256   1  264   1  264   1
- cygwin32    24   5   24   5   24   5   24   5
- djgpp       14   5   14   5   14   5   14   5
- eg          86  65   86  65   86  65   86  65
- emacs      262   2  262   2  262   2  262   2
- h2pl        12  12   12  12   12  12   12  12
- hints      157  74  157  74  159  74  160  74
- mpeix        -   -    -   -    5   3    5   3
- os2        129  44  139  44  142  44  143  44
- plan9       82  15   82  15   82  15   82  15
- Porting    241   9  253   9  259  10  264  12
- qnx          1   2    1   2    1   2    1   2
- utils      160   9  160   9  160   9  160   9
- vms        570  34  572  34  573  34  575  34
- win32      577  41  585  41  585  41  587  41
- x2p        281  19  281  19  281  19  281  19
+            5.004_70 5.004_73 5.004_75  5.005  5.005_03
+
+ apollo       -   -    -   -    -   -    -   -    0   1
+ beos         1   1    1   1    1   1    1   1    1   1
+ Configure  256   1  256   1  264   1  264   1  270   1
+ cygwin32    24   5   24   5   24   5   24   5   24   5  
+ djgpp       14   5   14   5   14   5   14   5	 15   5
+ eg          86  65   86  65   86  65   86  65	 86  65
+ emacs      262   2  262   2  262   2  262   2	274   2
+ h2pl        12  12   12  12   12  12   12  12	 12  12
+ hints      157  74  157  74  159  74  160  74	179  77
+ mint         -   -    -   -    -   -    -   -	  4   7
+ mpeix        -   -    -   -    5   3    5   3	  5   3
+ os2        129  44  139  44  142  44  143  44	148  44
+ plan9       82  15   82  15   82  15   82  15	 82  15
+ Porting    241   9  253   9  259  10  264  12	272  13
+ qnx          1   2    1   2    1   2    1   2	  1   2
+ utils      160   9  160   9  160   9  160   9	164   9
+ vms        570  34  572  34  573  34  575  34	583  34
+ vos          -   -    -   -    -   -    -   -	156  10
+ win32      577  41  585  41  585  41  587  41	600  42
+ x2p        281  19  281  19  281  19  281  19	281  19
 
 =head2 SELECTED PATCH SIZES
 
@@ -530,8 +598,9 @@ context diff output format.
 Jarkko Hietaniemi <F<jhi@iki.fi>>.
 
 Thanks to the collective memory of the Perlfolk.  In addition to the
-Keepers of the Pumpkin also Alan Champion, Andreas König, John
-Macdonald, Matthias Neeracher, Michael Peppler, Randal Schwartz, and
-Paul D. Smith sent corrections and additions.
+Keepers of the Pumpkin also Alan Champion, Mark Dominus, 
+Andreas König, John Macdonald, Matthias Neeracher, Jeff Okamoto,
+Michael Peppler, Randal Schwartz, and Paul D. Smith sent corrections
+and additions.
 
 =cut