stock perl 5.6.1

1 files changed, 43 insertions, 13 deletions

diff --git a/gnu/usr.bin/perl/README.macos b/gnu/usr.bin/perl/README.macos
index fdafa90d59a..cc8121be1cf 100644
--- a/gnu/usr.bin/perl/README.macos
+++ b/gnu/usr.bin/perl/README.macos
@@ -4,27 +4,57 @@ designed to be readable as is.
 
 =head1 NAME
 
-perlmacos - Perl under Mac OS (Classic)
+README.macos - Perl under Mac OS (Classic)
+
 
 =head1 SYNOPSIS
 
-For Mac OS X see README.macosx
+This document briefly describes perl under Mac OS (Classic).
+If you are running perl under Mac OS X, you don't want to be
+here (unless you are in the Classic environment under Mac OS X).
 
-Perl under Mac OS Classic has not been supported since before Perl 5.10
-(April 2004).
+When we say "Mac OS" below, we mean pre-Mac OS X, which includes
+Mac OS 7, 8, and 9.
 
-When we say "Mac OS" below, we mean Mac OS 7, 8, and 9, and I<not>
-Mac OS X.
 
 =head1 DESCRIPTION
 
-The port of Perl to Mac OS was officially removed as of Perl 5.12,
-though the last official production release of MacPerl corresponded to 
-Perl 5.6. While Perl 5.10 included the port to Mac OS, ExtUtils::MakeMaker,
-a core part of Perl's module installation infrastructure officially dropped support for Mac OS in April 2004.
+The perl 5.6.1 source itself builds on Mac OS, with some additional
+pieces. Support for Mac OS is now in the perl core, and MacPerl will be
+able to, in the future, keep in closer sync with regular perl releases.
+
+At this time, though, it is very buggy, and is under development.  An
+alpha release is coming very soon.
+
+To build perl for Mac OS (as an MPW tool), you will need the addition
+of the "macos" subdirectory, distributed separately.  It includes extra
+source files, config files, and make files.  It also includes a lot of
+extra Mac-specific modules.
+
+To build the MacPerl application, you will also need the "macperl"
+directory, which includes the source files for creating the
+application itself.
+
+All of this is also available from the SourceForge site, via
+HTTP, FTP, and anonymous CVS.
+
+	http://macperl.sourceforge.net/
+
+You will also need compilers and libraries, all of them freely
+available.  These are linked to from the SourceForge site. Go that site
+for all things having to do with MacPerl development.
+
+MacPerl 5.2.0r4 is available on the CPAN and on SourceForge.  It
+is based on perl 5.004.
+
 
 =head1 AUTHOR
 
-Perl was ported to Mac OS by Matthias Neeracher
-E<lt>neeracher@mac.comE<gt>. Chris Nandor E<lt>pudge@pobox.comE<gt>
-continued development and maintenance for the duration of the port's life.
+perl was ported to Mac OS by Matthias Neeracher
+E<lt>neeracher@mac.comE<gt>.  It is currently maintained by Chris
+Nandor E<lt>pudge@pobox.comE<gt>.
+
+
+=head1 DATE
+
+Last modified 2001.04.05.