various documentation tweaks suggested by M. J. T. Guy
authorChip Salzenberg <chip@pobox.com>
Mon, 10 Jan 2000 09:04:34 +0000 (09:04 +0000)
committerchip <chip@pobox.com>
Mon, 10 Jan 2000 09:04:34 +0000 (09:04 +0000)
p4raw-id: //depot/maint-5.005/perl@4784

INSTALL
lib/strict.pm
pod/perlfunc.pod
pod/perlsyn.pod

index c5e04cb..43d00d9 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -4,6 +4,10 @@ Install - Build and Installation guide for perl5.
 
 =head1 SYNOPSIS
 
+First, make sure you are installing an up-to-date version of Perl.   If
+you didn't get your Perl source from CPAN, check the latest version at
+<URL:http://www.perl.com/CPAN/src/>.
+
 The basic steps to build and install perl5 on a Unix system are:
 
        rm -f config.sh Policy.sh
index 940e8bf..99ed01d 100644 (file)
@@ -56,6 +56,9 @@ L<perlfunc/local>.
 The local() generated a compile-time error because you just touched a global
 name without fully qualifying it.
 
+Because of their special use by sort(), the variables $a and $b are
+exempted from this check.
+
 =item C<strict subs>
 
 This disables the poetry optimization, generating a compile-time error if
index 5fb7863..a815f0a 100644 (file)
@@ -1159,8 +1159,8 @@ parentheses to test I<EACH> file in a while (E<lt>E<gt>) loop.  Examples:
     }
 
 Practical hint: you almost never need to use C<eof> in Perl, because the
-input operators return false values when they run out of data, or if there
-was an error.
+input operators typically return C<undef> when they run out of data, or if
+there was an error.
 
 =item eval EXPR
 
index a3bc5ab..9bfb39e 100644 (file)
@@ -161,6 +161,8 @@ C<last>, and C<redo>.  If the LABEL is omitted, the loop control statement
 refers to the innermost enclosing loop.  This may include dynamically
 looking back your call-stack at run time to find the LABEL.  Such
 desperate behavior triggers a warning if you use the B<-w> flag.
+Unlike a C<foreach> statement, a C<while> statement never implicitly
+localises any variables.
 
 If there is a C<continue> BLOCK, it is always executed just before the
 conditional is about to be evaluated again, just like the third part of a