various pod niggles
authorGurusamy Sarathy <gsar@cpan.org>
Sun, 28 Mar 1999 08:22:00 +0000 (08:22 +0000)
committerGurusamy Sarathy <gsar@cpan.org>
Sun, 28 Mar 1999 08:22:00 +0000 (08:22 +0000)
p4raw-id: //depot/maint-5.005/perl@3189

pod/perl.pod
pod/perldebug.pod
pod/perldiag.pod
pod/perlfunc.pod
pod/perlhist.pod

index e9ab2bb..6e218cd 100644 (file)
@@ -72,8 +72,8 @@ of sections:
 (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.)
 
-By default, all of the above manpages are installed in the 
-F</usr/local/man/> directory.  
+By default, all of the above manpages are installed in the
+F</usr/local/man/> directory.
 
 Extensive additional documentation for Perl modules is available.  The
 default configuration for perl will place this additional documentation
@@ -258,93 +258,20 @@ F<http://www.perl.com/CPAN/src/index.html>
         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)   
+        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     
+        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
-
-=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
@@ -352,14 +279,14 @@ 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        
+        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
index 7a6e814..760d517 100644 (file)
@@ -1109,7 +1109,7 @@ or B<pop>, the stack backtrace will not show the original values.
 
 Perl is I<very> frivolous with memory.  There is a saying that to
 estimate memory usage of Perl, assume a reasonable algorithm of
-allocation, and multiply your estimages by 10.  This is not absolutely
+allocation, and multiply your estimates by 10.  This is not absolutely
 true, but may give you a good grasp of what happens.
 
 Say, an integer cannot take less than 20 bytes of memory, a float
@@ -1161,7 +1161,7 @@ in the following example:
   Total sbrk(): 215040/47:145. Odd ends: pad+heads+chain+tail: 0+2192+0+6144.
 
 It is possible to ask for such a statistic at arbitrary moment by
-usind Devel::Peek::mstats() (module Devel::Peek is available on CPAN).
+using Devel::Peek::mstats() (module Devel::Peek is available on CPAN).
 
 Here is the explanation of different parts of the format:
 
@@ -1195,7 +1195,7 @@ memory footprints of the buckets are between memory footprints of two
 buckets "above".  
 
 Say, with the above example the memory footprints are (with current
-algorith)
+algorithm)
 
      free:    8     16    32    64    128  256 512 1024 2048 4096 8192
           4     12    24    48    80
@@ -1328,7 +1328,7 @@ though the subroutine itself is not defined yet).
 
 It also creates C arrays to keep data for the stash (this is one HV,
 but it grows, thus there are 4 big allocations: the big chunks are not
-freeed, but are kept as additional arenas for C<SV> allocations).
+freed, but are kept as additional arenas for C<SV> allocations).
 
 =item C<054>
 
index 5a65b24..fe31991 100644 (file)
@@ -143,6 +143,18 @@ Perl yourself.
 instead of Perl.  Check the #! line, or manually feed your script
 into Perl yourself.
 
+=item         (in cleanup) %s
+
+(W) This prefix usually indicates that a DESTROY() method raised
+the indicated exception.  Since destructors are usually called by
+the system at arbitrary points during execution, and often a vast
+number of times, the warning is issued only once for any number
+of failures that would otherwise result in the same message being
+repeated.
+
+Failure of user callbacks dispatched using the C<G_KEEPERR> flag
+could also result in this warning.  See L<perlcall/G_KEEPERR>.
+
 =item         (Missing semicolon on previous line?)
 
 (S) This is an educated guess made in conjunction with the message "%s
@@ -376,7 +388,7 @@ Perl yourself.
 =item Bareword "%s" not allowed while "strict subs" in use
 
 (F) With "strict subs" in use, a bareword is only allowed as a
-subroutine identifier, in curly braces or to the left of the "=>" symbol.
+subroutine identifier, in curly brackets or to the left of the "=>" symbol.
 Perhaps you need to predeclare a subroutine?
 
 =item Bareword "%s" refers to nonexistent package
@@ -1174,7 +1186,7 @@ a return, a goto, or a loop control statement.
 (W) You are blessing a reference to a zero length string.  This has
 the effect of blessing the reference into the package main.  This is
 usually not what you want.  Consider providing a default target
-package, e.g. bless($ref, $p or 'MyPackage');
+package, e.g. bless($ref, $p || 'MyPackage');
 
 =item Fatal VMS error at %s, line %d
 
@@ -1270,7 +1282,6 @@ Did you forget to check the return value of your socket() call?
 (S) A warning peculiar to VMS.  The call to C<sys$getuai> underlying the
 C<getpwnam> operator returned an invalid UIC.
 
-
 =item Glob not terminated
 
 (F) The lexer saw a left angle bracket in a place where it was expecting
@@ -1425,7 +1436,7 @@ and execute the specified command.
 
 (P) Something went badly wrong in the regular expression parser.
 
-=item =item glob failed (%s)
+=item glob failed (%s)
 
 (W) Something went wrong with the external program(s) used for C<glob>
 and C<E<lt>*.cE<gt>>.  Usually, this means that you supplied a C<glob>
@@ -2337,12 +2348,14 @@ from the user it isn't running under, and isn't in a location where the CGI
 server can't find it, basically, more or less.  Please see the following
 for more information:
 
-       http://www.perl.com/perl/faq/idiots-guide.html
-       http://www.perl.com/perl/faq/perl-cgi-faq.html
+       http://www.perl.com/CPAN/doc/FAQs/cgi/idiots-guide.html
+       http://www.perl.com/CPAN/doc/FAQs/cgi/perl-cgi-faq.html
        ftp://rtfm.mit.edu/pub/usenet/news.answers/www/cgi-faq
        http://hoohoo.ncsa.uiuc.edu/cgi/interface.html
        http://www-genome.wi.mit.edu/WWW/faqs/www-security-faq.html
 
+You should also look at L<perlfaq9>.
+
 =item setegid() not implemented
 
 (F) You tried to assign to C<$)>, and your operating system doesn't support
index f40e991..5fb7863 100644 (file)
@@ -3267,7 +3267,7 @@ needed.  If you really wanted to do so, however, you could use
 the construction C<@{[ (some expression) ]}>, but usually a simple
 C<(some expression)> suffices.
 
-Wince C<scalar> is unary operator, if you accidentally use for EXPR a
+Since C<scalar> is a unary operator, if you accidentally use for EXPR a
 parenthesized list, this behaves as a scalar comma expression, evaluating
 all but the last element in void context and returning the final element
 evaluated in scalar context.  This is seldom what you want.
index b89bbca..71fc692 100644 (file)
@@ -5,9 +5,11 @@
 perlhist - the Perl history records
 
 =for RCS
+
 #
 # $Id: perlhist.pod,v 1.57 1999/01/26 17:38:07 jhi Exp $
 #
+
 =end RCS
 
 =head1 DESCRIPTION