From 437784d6df8beda03e9adf366675664db8fee3e8 Mon Sep 17 00:00:00 2001 From: Gurusamy Sarathy Date: Wed, 13 Oct 1999 08:11:11 +0000 Subject: [PATCH] typos and language goofs pointed out by Hugo van der Sanden p4raw-id: //depot/perl@4366 --- pod/perldelta.pod | 44 +++++++++++++++++++++++--------------------- pod/perldiag.pod | 26 ++++++++++++++------------ 2 files changed, 37 insertions(+), 33 deletions(-) diff --git a/pod/perldelta.pod b/pod/perldelta.pod index 618ee01..1c93ed1 100644 --- a/pod/perldelta.pod +++ b/pod/perldelta.pod @@ -250,7 +250,7 @@ See also L<"64-bit support">. =head2 Long Doubles Some platforms have "long doubles", floating point numbers of even -larger range than ordinary "doubles". To enable using ng doubles for +larger range than ordinary "doubles". To enable using long doubles for Perl's scalars, use -Duselongdouble. =head2 -Dusemorebits @@ -701,7 +701,7 @@ exec() fails, earlier versions did not report the error properly, since the exec() happened to be in a different process. The child process now communicates with the parent about the -error in launching the external command, which allow these +error in launching the external command, which allows these constructs to return with their usual error value and set $!. =head2 Implicitly closed filehandles are safer @@ -754,7 +754,7 @@ enabled. =head2 Locale bugs fixed -printf() and sprintf() previously did reset the numeric locale +printf() and sprintf() previously reset the numeric locale back to the default "C" locale. This has been fixed. Numbers formatted according to the local numeric locale @@ -818,7 +818,7 @@ library's C. =head2 Other fixes for better diagnostics -Line numbers are suppressed no more (under most likely circumstances) +Line numbers are no longer suppressed (under most likely circumstances) during the global destruction phase. Diagnostics emitted from code running in threads other than the main @@ -1042,7 +1042,7 @@ Devel::DProf, a Perl source code profiler has been added. See L. =item Dumpvalue -Added Dumpvalue module provides screen dumps of Perl data. +The Dumpvalue module provides screen dumps of Perl data. =item Benchmark @@ -1152,7 +1152,7 @@ C removes all named entries. =item Math::BigInt -The logical operations CE>, CE>, C<&>, C<|>, +The bitwise operations CE>, CE>, C<&>, C<|>, and C<~> are now supported on bigints. =item Math::Complex @@ -1187,7 +1187,7 @@ fixed. =item Time::Local The timelocal() and timegm() functions used to silently return bogus -results when the date exceeded the machine's integer range. They +results when the date fell outside the machine's integer range. They now consistently croak() if the date falls in an unsupported range. =item Win32 @@ -1231,7 +1231,7 @@ See L for further information. =head2 Pragmata -C is now obsolescent, and is only provided for +C is now obsolete, and is only provided for backward-compatibility. It's been replaced by the C syntax. See L and L. @@ -1325,7 +1325,7 @@ See L. =item / must be followed by a*, A* or Z* -(F) You had an pack template indicating a counted-length string, +(F) You had a pack template indicating a counted-length string, Currently the only things that can have their length counted are a*, A* or Z*. See L. @@ -1354,7 +1354,7 @@ C<'>-delimited regular expression. =item /%s/ should probably be written as "%s" (W) You have used a pattern where Perl expected to find a string, -like in the first argument to C. Perl will treat the true +as in the first argument to C. Perl will treat the true or false result of matching the pattern against $_ as the string, which is probably not what you had in mind. @@ -1432,8 +1432,8 @@ so it was truncated to the string shown. =item Can't modify non-lvalue subroutine call -(F) Subroutines used in lvalue context should be marked as such, see -L. +(F) Subroutines meant to be used in lvalue context should be declared as +such, see L. =item Can't read CRTL environ @@ -1462,13 +1462,15 @@ references can be weakened. =item Character class [:%s:] unknown (F) The class in the character class [: :] syntax is unknown. +See L. =item Character class syntax [%s] belongs inside character classes (W) The character class constructs [: :], [= =], and [. .] go I character classes, the [] are part of the construct, -for example: /[012[:alpha:]345]/. Note that the last two constructs -are not currently implemented, they are placeholders for future extensions. +for example: /[012[:alpha:]345]/. Note that [= =] and [. .] +are not currently implemented; they are simply placeholders for +future extensions. =item Constant is not %s reference @@ -1516,7 +1518,7 @@ effective uids or gids failed. =item Filehandle %s opened only for output (W) You tried to read from a filehandle opened only for writing. If you -intended it to be a read-write filehandle, you needed to open it with +intended it to be a read/write filehandle, you needed to open it with "+E" or "+E" or "+EE" instead of with "E" or nothing. If you intended only to read from the file, use "E". See L. @@ -1542,7 +1544,7 @@ line was ignored. =item Illegal binary digit %s -(F) You used a digit other than 0 and 1 in a binary number. +(F) You used a digit other than 0 or 1 in a binary number. =item Illegal binary digit %s ignored @@ -1687,7 +1689,7 @@ repetitions of "xyz" is C, not C. (F) While under the C pragma, we cannot switch the real and effective uids or gids. -=item This Perl can't reset CRTL eviron elements (%s) +=item This Perl can't reset CRTL environ elements (%s) =item This Perl can't set CRTL environ elements (%s=%s) @@ -1700,9 +1702,9 @@ L) so that the environ array isn't the target of the change to =item Unknown open() mode '%s' -(F) The second argument of 3-arguments open is not one from the list -of C>, C>, CE>, C<+L>, C<+L>, -C<+EE>, C<-|>, C<|-> of possible open() modes. +(F) The second argument of 3-argument open() is not among the list +of valid modes: C>, C>, CE>, C<+L>, +C<+L>, C<+EE>, C<-|>, C<|->. =item Unknown process %x sent message to prime_env_iter: %s @@ -1804,7 +1806,7 @@ warning. And in Perl 5.005, this special treatment will cease. =head1 BUGS -If you find what you think is a bug, you might check the headers of +If you find what you think is a bug, you might check the articles recently posted to the comp.lang.perl.misc newsgroup. There may also be information at http://www.perl.com/perl/, the Perl Home Page. diff --git a/pod/perldiag.pod b/pod/perldiag.pod index d0f1be8..ba1e374 100644 --- a/pod/perldiag.pod +++ b/pod/perldiag.pod @@ -80,7 +80,7 @@ See L. =item / must be followed by a*, A* or Z* -(F) You had an pack template indicating a counted-length string, +(F) You had a pack template indicating a counted-length string, Currently the only things that can have their length counted are a*, A* or Z*. See L. @@ -115,7 +115,7 @@ C<'>-delimited regular expression. =item /%s/ should probably be written as "%s" (W) You have used a pattern where Perl expected to find a string, -like in the first argument to C. Perl will treat the true +as in the first argument to C. Perl will treat the true or false result of matching the pattern against $_ as the string, which is probably not what you had in mind. @@ -881,8 +881,8 @@ change it, such as with an auto-increment. =item Can't modify non-lvalue subroutine call -(F) Subroutines used in lvalue context should be marked as such, see -L. +(F) Subroutines meant to be used in lvalue context should be declared as +such, see L. =item Can't modify nonexistent substring @@ -1113,13 +1113,15 @@ package. If method name is C, this is an internal error. =item Character class [:%s:] unknown (F) The class in the character class [: :] syntax is unknown. +See L. =item Character class syntax [%s] belongs inside character classes (W) The character class constructs [: :], [= =], and [. .] go I character classes, the [] are part of the construct, -for example: /[012[:alpha:]345]/. Note that the last two constructs -are not currently implemented, they are placeholders for future extensions. +for example: /[012[:alpha:]345]/. Note that [= =] and [. .] +are not currently implemented; they are simply placeholders for +future extensions. =item Character class syntax [. .] is reserved for future extensions @@ -1407,7 +1409,7 @@ L. =item Filehandle %s opened only for output (W) You tried to read from a filehandle opened only for writing. If you -intended it to be a read-write filehandle, you needed to open it with +intended it to be a read/write filehandle, you needed to open it with "+E" or "+E" or "+EE" instead of with "E" or nothing. If you intended only to read from the file, use "E". See L. @@ -1558,7 +1560,7 @@ don't take to this kindly. =item Illegal binary digit %s -(F) You used a digit other than 0 and 1 in a binary number. +(F) You used a digit other than 0 or 1 in a binary number. =item Illegal octal digit %s @@ -2900,7 +2902,7 @@ will deny it. if the last stat that wrote to the stat buffer already went past the symlink to get to the real file. Use an actual filename instead. -=item This Perl can't reset CRTL eviron elements (%s) +=item This Perl can't reset CRTL environ elements (%s) =item This Perl can't set CRTL environ elements (%s=%s) @@ -3067,9 +3069,9 @@ representative, who probably put it there in the first place. =item Unknown open() mode '%s' -(F) The second argument of 3-arguments open is not one from the list -of C>, C>, CE>, C<+L>, C<+L>, -C<+EE>, C<-|>, C<|-> of possible open() modes. +(F) The second argument of 3-argument open() is not among the list +of valid modes: C>, C>, CE>, C<+L>, +C<+L>, C<+EE>, C<-|>, C<|->. =item Unknown process %x sent message to prime_env_iter: %s -- 1.8.3.1