[perl #112776] TODO test for warning

[perl5.git] / README.os390

diff --git a/README.os390 b/README.os390
index 3011ad6..6e2d49e 100644 (file)
--- a/README.os390
+++ b/README.os390
@@ -5,7 +5,7 @@ about pod in pod/perlpod.pod or the short summary in the INSTALL file.
 
 =head1 NAME
 
-README.os390 - building and installing Perl for OS/390 and z/OS
+perlos390 - building and installing Perl for OS/390 and z/OS
 
 =head1 SYNOPSIS
 
@@ -26,19 +26,36 @@ running the Configure script for Perl.
 
 The z/OS Unix Tools and Toys list may prove helpful and contains links
 to ports of much of the software helpful for building Perl.
-http://www-1.ibm.com/servers/eserver/zseries/zos/unix/bpxa1toy.html
+http://www.ibm.com/servers/eserver/zseries/zos/unix/bpxa1toy.html
 
 
 =head2 Unpacking Perl distribution on OS/390
 
+If using ftp remember to transfer the distribution in binary format.
+
 Gunzip/gzip for OS/390 is discussed at:
 
-  http://www-1.ibm.com/servers/eserver/zseries/zos/unix/faq/bpxqp1.html
+  http://www.ibm.com/servers/eserver/zseries/zos/unix/bpxa1ty1.html
 
 to extract an ASCII tar archive on OS/390, try this:
 
    pax -o to=IBM-1047,from=ISO8859-1 -r < latest.tar
 
+or
+
+   zcat latest.tar.Z | pax -o to=IBM-1047,from=ISO8859-1 -r
+
+If you get lots of errors of the form
+
+  tar: FSUM7171 ...: cannot set uid/gid: EDC5139I Operation not permitted.
+
+you didn't read the above and tried to use tar instead of pax, you'll
+first have to remove the (now corrupt) perl directory
+
+   rm -rf perl-...
+
+and then use pax.
+
 =head2 Setup and utilities for Perl on OS/390
 
 Be sure that your yacc installation is in place including any necessary
@@ -73,7 +90,7 @@ and be sure to also set the environment variable _C89_CCMODE=1 (exporting
 _C89_CCMODE=1 is also a good idea for users of GNU make).
 
 You might also want to have GNU groff for OS/390 installed before
-running the `make install` step for Perl.
+running the "make install" step for Perl.
 
 There is a syntax error in the /usr/include/sys/socket.h header file
 that IBM supplies with USS V2R7, V2R8, and possibly V2R9.  The problem with
@@ -203,9 +220,9 @@ header /usr/include/sys/socket.h.
 
 =head2 Testing Anomalies with Perl on OS/390
 
-The `make test` step runs a Perl Verification Procedure, usually before
+The "make test" step runs a Perl Verification Procedure, usually before
 installation.  You might encounter STDERR messages even during a successful
-run of `make test`.  Here is a guide to some of the more commonly seen
+run of "make test".  Here is a guide to some of the more commonly seen
 anomalies:
 
 =over 4
@@ -214,20 +231,6 @@ anomalies:
 
 A message of the form:
 
- comp/cpp.............ERROR CBC3191 ./.301989890.c:1     The character $ is not a
-  valid C source character.
- FSUM3065 The COMPILE step ended with return code 12.
- FSUM3017 Could not compile .301989890.c. Correct the errors and try again.
- ok
-
-indicates that the t/comp/cpp.t test of Perl's -P command line switch has
-passed but that the particular invocation of c89 -E in the cpp script does
-not suppress the C compiler check of source code validity.
-
-=item *
-
-A message of the form:
-
  io/openpid...........CEE5210S The signal SIGHUP was received.
  CEE5210S The signal SIGHUP was received.
  CEE5210S The signal SIGHUP was received.
@@ -257,7 +260,7 @@ from an account with write access to the directory entry for /tmp.
 
 Out of Memory!
 
-Recent perl test suite is quite memory hunrgy. In addition to the comments
+Recent perl test suite is quite memory hungry. In addition to the comments
 above on memory limitations it is also worth checking for _CEE_RUNOPTS
 in your environment. Perl now has (in miniperlmain.c) a C #pragma
 to set CEE run options, but the environment variable wins.
@@ -393,11 +396,11 @@ Thanks to John Goodyear for dynamic loading help.
 
 L<INSTALL>, L<perlport>, L<perlebcdic>, L<ExtUtils::MakeMaker>.
 
-    http://www-1.ibm.com/servers/eserver/zseries/zos/unix/bpxa1toy.html
+    http://www.ibm.com/servers/eserver/zseries/zos/unix/bpxa1toy.html
 
-    http://www.redbooks.ibm.com/abstracts/sg245944.html
+    http://www.redbooks.ibm.com/redbooks/SG245944.html
 
-    http://www-1.ibm.com/servers/eserver/zseries/zos/unix/bpxa1ty1.html#opensrc
+    http://www.ibm.com/servers/eserver/zseries/zos/unix/bpxa1ty1.html#opensrc
 
     http://www.xray.mpe.mpg.de/mailing-lists/perl-mvs/
 
@@ -407,16 +410,13 @@ L<INSTALL>, L<perlport>, L<perlebcdic>, L<ExtUtils::MakeMaker>.
 
 =head2 Mailing list for Perl on OS/390
 
-The Perl Institute (http://www.perl.org/) maintains a perl-mvs
-mailing list of interest to all folks building and/or
-using perl on all EBCDIC platforms (not just OS/390).
-To subscribe, send a message of:
-
-    subscribe perl-mvs
+If you are interested in the VM/ESA, z/OS (formerly known as OS/390)
+and POSIX-BC (BS2000) ports of Perl then see the perl-mvs mailing list.
+To subscribe, send an empty message to perl-mvs-subscribe@perl.org.
 
-to majordomo@perl.org.   See also:
+See also:
 
-    http://lists.perl.org/showlist.cgi?name=perl-mvs
+    http://lists.perl.org/list/perl-mvs.html
 
 There are web archives of the mailing list at: