lexical warnings update for docs and tests (from Paul Marquess)
[p5sagit/p5-mst-13.2.git] / pod / perl.pod
index 662dccf..f90696e 100644 (file)
@@ -229,11 +229,12 @@ platforms are able to build Perl from the standard source code
 distribution available at http://www.perl.com/CPAN/src/index.html
 
        AIX
-       DOS DJGPP 1)
+       DOS DJGPP       1)
        FreeBSD
        HP-UX
        IRIX
        Linux
+       LynxOS
        MachTen
        MPE/iX
        NetBSD
@@ -252,14 +253,15 @@ distribution available at http://www.perl.com/CPAN/src/index.html
        Windows NT      1) 4)
 
         1) in DOS mode either the DOS or OS/2 ports can be used
-        2) NEW in 5.6.0: the BSD/NeXT-based UNIX of Mac OS X
+        2) new in 5.6.0: the BSD/NeXT-based UNIX of Mac OS X
         3) formerly known as Digital UNIX and before that DEC OSF/1
         4) compilers: Borland, Cygwin, Mingw32 EGCS/GCC, VC++
 
-The following platforms worked for the previous major release,
-5.005_04 being the latest (as of March 2000) maintenance release, but
-we didn't manage to test these in time for the 5.6.0 release of Perl.
-There is a very good chance that these will work just fine with 5.6.0.
+The following platforms worked for the previous major release
+(5.005_03 being the latest maintenance release of that, as of early
+March 2000), but be did not manage to test these in time for the 5.6.0
+release of Perl.  There is a very good chance that these will work
+just fine with 5.6.0.
 
        A/UX
        BeOS
@@ -277,34 +279,35 @@ There is a very good chance that these will work just fine with 5.6.0.
        SVR4
        Ultrix
 
-The following platform worked for the previous major release, 5.005_04
-being the latest (as of early March 2000) maintenance release of that,
-but unfortunately the Unicode changes in 5.6.0 broke the port.  This
-will be fixed in a future Perl release.
+The following platform worked for the previous major release (5.005_03
+being the latest maintenance release of that, as of early March 2000).
+However, standardization on UTF-8 as the internal string representation
+in 5.6.0 has introduced incompatibilities in this EBCDIC platform.
+Support for this platform may be enabled in a future release:
 
        OS390   1)
 
        1) Previously known as MVS, or OpenEdition MVS.
 
 Strongly related to the OS390 platform by also being EBCDIC-based
-mainframe platforms are the
+mainframe platforms are the following platforms:
 
        BS2000
        VM/ESA
 
-platforms.  They are related by not working in 5.6.0, unfortunately.
-Contact the mailing list perl-mvs@perl.org for more details.
+These are also not expected to work under 5.6.0 for the same reasons
+as OS390.  Contact the mailing list perl-mvs@perl.org for more details.
 
-MacOS (Classic, pre-X) is kind of 5.6.0-ready: building from the
-source does work with the 5.6.0, but you need more than just the Perl
-5.6 source code.  Contact the mailing list macperl-porters@macperl.org
+MacOS (Classic, pre-X) is almost 5.6.0-ready; building from the source
+does work with 5.6.0, but additional MacOS specific source code is needed
+for a complete port.  Contact the mailing list macperl-porters@macperl.org
 for more more information.
 
 The following platforms have been known to build Perl from source in
 the past, but we haven't been able to verify their status for the
 current release, either because the hardware/software platforms are
 rare or because we don't have an active champion on these
-platforms--or both.
+platforms--or both:
 
        3b1
        AmigaOS
@@ -335,12 +338,12 @@ platforms--or both.
        Unisys Dynix
        Unixware
 
-Support for the following platform is planned for a future Perl release.
+Support for the following platform is planned for a future Perl release:
 
        Netware
 
 The following platforms have their own source code distributions and
-binaries available via http://www.perl.com/CPAN/ports/index.html.
+binaries available via http://www.perl.com/CPAN/ports/index.html:
 
                                Perl release
 
@@ -349,7 +352,7 @@ binaries available via http://www.perl.com/CPAN/ports/index.html.
        Tandem Guardian         5.004
 
 The following platforms have only binaries available via
-http://www.perl.com/CPAN/ports/index.html.
+http://www.perl.com/CPAN/ports/index.html:
 
                                Perl release
 
@@ -357,6 +360,11 @@ http://www.perl.com/CPAN/ports/index.html.
        AOS                     5.002
        LynxOS                  5.004_02
 
+Although we do suggest that you always build your own Perl from
+the source code, both for maximal configurability and for security,
+in case you are in a hurry you can check
+http://www.perl.com/CPAN/ports/index.html for binary distributions.
+
 =head1 ENVIRONMENT
 
 See L<perlrun>.
@@ -384,7 +392,8 @@ Perl developers, please write to perl-thanks@perl.org .
 
 =head1 DIAGNOSTICS
 
-The B<-w> switch produces some lovely diagnostics.
+The C<use warnings> pragma (and the B<-w> switch) produces some 
+lovely diagnostics.
 
 See L<perldiag> for explanations of all Perl's diagnostics.  The C<use
 diagnostics> pragma automatically turns Perl's normally terse warnings