lexical warnings update for docs and tests (from Paul Marquess)
[p5sagit/p5-mst-13.2.git] / pod / perl.pod
index abf3a7b..f90696e 100644 (file)
@@ -35,24 +35,30 @@ sections:
     perlmodlib         Perl modules: how to write and use
     perlmodinstall     Perl modules: how to install from CPAN
     perlform           Perl formats
+    perlunicode                Perl unicode support
     perllocale         Perl locale support
 
     perlreftut         Perl references short introduction
     perlref            Perl references, the rest of the story
     perldsc            Perl data structures intro
     perllol            Perl data structures: arrays of arrays
+    perlboot           Perl OO tutorial for beginners
     perltoot           Perl OO tutorial, part 1
     perltootc          Perl OO tutorial, part 2
     perlobj            Perl objects
     perltie            Perl objects hidden behind simple variables
     perlbot            Perl OO tricks and examples
     perlipc            Perl interprocess communication
+    perlfork           Perl fork() information
     perlthrtut         Perl threads tutorial
-    perldbmfilter      Perl DBM Filters
+    perllexwarn                Perl warnings and their control
+    perlfilter         Perl source filters
+    perldbmfilter      Perl DBM filters
 
     perlcompile                Perl compiler suite intro
     perldebug          Perl debugging
     perldiag           Perl diagnostic messages
+    perlnumber         Perl number semantics
     perlsec            Perl security
     perltrap           Perl traps for the unwary
     perlport           Perl portability guide
@@ -67,10 +73,22 @@ sections:
     perlxstut          Perl XS tutorial
     perlguts           Perl internal functions for those doing extensions
     perlcall           Perl calling conventions from C
+    perlapi            Perl API listing (autogenerated)
+    perlintern         Perl internal functions (autogenerated)
 
     perltodo           Perl things to do
+    perlhack           Perl hackers guide
     perlhist           Perl history records
 
+    perlamiga          Perl notes for Amiga
+    perlcygwin         Perl notes for Cygwin
+    perldos            Perl notes for DOS
+    perlhpux           Perl notes for HP-UX
+    perlos2            Perl notes for OS/2
+    perlos390          Perl notes for OS/390
+    perlvms            Perl notes for VMS
+    perlwin32          Perl notes for Windows
+
 (If you're intending to read these straight through for the first time,
 the suggested order will tend to reduce the number of forward references.)
 
@@ -206,65 +224,135 @@ Okay, that's I<definitely> enough hype.
 Perl is available for most operating systems, including virtually
 all Unix-like platforms.
 
-As of May 1999, the following platforms are able to build Perl
-from the standard source code distribution available at
-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)
+As of early March 2000 (the Perl release 5.6.0), the following
+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)
+       FreeBSD
+       HP-UX
+       IRIX
+       Linux
+       LynxOS
+       MachTen
+       MPE/iX
+       NetBSD
+       OpenBSD
+       OS/2
+       Rhapsody/Darwin 2)
+       Solaris
+       Tru64 UNIX      3)
+       UNICOS
+       UNICOS/mk
+       VMS
+       VOS
+       Windows 3.1     1)
+       Windows 95      1) 4)
+       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     
+        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 have been known to build Perl from source,
-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.
-                                       
-        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        
-
-Support for the following platforms is planned for the next major
-Perl release.
-
-        BS2000
+
+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
+       BSD/OS
+       DG/UX
+       DYNIX/ptx
+       DomainOS
+       Hurd
+       NextSTEP
+       OpenSTEP
+       PowerMAX
+       QNX
+       SCO ODT/OSR     
+       SunOS
+       SVR4
+       Ultrix
+
+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 following platforms:
+
+       BS2000
+       VM/ESA
+
+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 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:
+
+       3b1
+       AmigaOS
+       ConvexOS
+       CX/UX
+       DC/OSx
+       DDE SMES
+       DOS EMX
+       Dynix
+       EP/IX
+       ESIX
+       FPS
+       GENIX
+       Greenhills
+       ISC
+       MachTen 68k
+       MiNT
+       MPC
+       NEWS-OS
+       Opus
+       Plan 9
+       PowerUX
+       RISC/os
+       Stellar
+       SVR2
+       TI1500
+       TitanOS
+       Unisys Dynix
+       Unixware
+
+Support for the following platform is planned for a future Perl release:
+
        Netware
-       Rhapsody
-        VM/ESA
 
 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
 
        AS/400                  5.003
-       MacOS                   5.004
        Netware                 5.003_07
        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
 
@@ -272,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>.
@@ -295,11 +388,12 @@ Perl developers, please write to perl-thanks@perl.org .
  s2p   sed to perl translator
 
  http://www.perl.com/      the Perl Home Page
- http://www.perl.com/CPAN   the Comphrehensive Perl Archive
+ http://www.perl.com/CPAN   the Comprehensive Perl Archive
 
 =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