perldiag: Rewrite a mangled sentence

[perl5.git] / pod / perldiag.pod

diff --git a/pod/perldiag.pod b/pod/perldiag.pod
index b949729..fdf79c8 100644 (file)
--- a/pod/perldiag.pod
+++ b/pod/perldiag.pod
@@ -534,10 +534,9 @@ The C<strict> pragma is useful in avoiding such errors.
 
 =item Bareword in require contains "%s"
 
 
 =item Bareword in require contains "%s"
 

-=item Bareword in require maps to empty filename
-

 =item Bareword in require maps to disallowed filename "%s"
 
 =item Bareword in require maps to disallowed filename "%s"
 

+=item Bareword in require maps to empty filename

 
 (F) The bareword form of require has been invoked with a filename which could
 not have been generated by a valid bareword permitted by the parser. You
 
 (F) The bareword form of require has been invoked with a filename which could
 not have been generated by a valid bareword permitted by the parser. You


@@ -2221,14 +2220,6 @@ has been removed.  The C<postderef> feature may meet your needs better.
     use feature "signatures";
     sub foo ($left, $right) { ... }
 
     use feature "signatures";
     sub foo ($left, $right) { ... }
 

-=item Experimental "%s" subs not enabled
-
-(F) To use lexical subs, you must first enable them:
-
-    no warnings 'experimental::lexical_subs';
-    use feature 'lexical_subs';
-    my sub foo { ... }
-

 =item Explicit blessing to '' (assuming package main)
 
 (W misc) You are blessing a reference to a zero length string.  This has
 =item Explicit blessing to '' (assuming package main)
 
 (W misc) You are blessing a reference to a zero length string.  This has


@@ -4002,12 +3993,6 @@ find out what kind of ref it really was.  See L<perlref>.
 a reference to something else instead.  You can use the ref() function
 to find out what kind of ref it really was.  See L<perlref>.
 
 a reference to something else instead.  You can use the ref() function
 to find out what kind of ref it really was.  See L<perlref>.
 

-=item Not an unblessed ARRAY reference
-
-(F) You passed a reference to a blessed array to C<push>, C<shift> or
-another array function.  These only accept unblessed array references
-or arrays beginning explicitly with C<@>.
-

 =item Not a SCALAR reference
 
 (F) Perl was trying to evaluate a reference to a scalar value, but found
 =item Not a SCALAR reference
 
 (F) Perl was trying to evaluate a reference to a scalar value, but found


@@ -4133,6 +4118,14 @@ C<sysread()>ing a file, or when seeking past the end of a scalar opened
 for I/O (in anticipation of future reads and to imitate the behavior
 with real files).
 
 for I/O (in anticipation of future reads and to imitate the behavior
 with real files).
 

+=item Only one /x regex modifier is allowed
+
+=item Only one /x regex modifier is allowed in regex; marked by <-- HERE in m/%s/
+
+(F) You used the C</x> regular expression pattern modifier at least twice in a
+string of modifiers.  This has been made illegal, in order to allow future
+extensions to the Perl language.
+

 =item %s() on unopened %s
 
 (W unopened) An I/O operation was attempted on a filehandle that was
 =item %s() on unopened %s
 
 (W unopened) An I/O operation was attempted on a filehandle that was


@@ -4144,14 +4137,6 @@ call, or call a constructor from the FileHandle package.
 (W unopened) You tried to invoke a file test operator on a filehandle
 that isn't open.  Check your control flow.  See also L<perlfunc/-X>.
 
 (W unopened) You tried to invoke a file test operator on a filehandle
 that isn't open.  Check your control flow.  See also L<perlfunc/-X>.
 

-=item Only one /x regex modifier is allowed
-
-=item Only one /x regex modifier is allowed in regex; marked by <-- HERE in m/%s/
-
-(F) You used the C</x> regular expression pattern modifier at least
-twice in a string of modifiers.  It is illegal to do this with, to allow
-future extensions to the Perl language.
-

 =item oops: oopsAV
 
 (S internal) An internal warning that the grammar is screwed up.
 =item oops: oopsAV
 
 (S internal) An internal warning that the grammar is screwed up.


@@ -4545,6 +4530,12 @@ was string.
 (P) The compiler is screwed up and attempted to use an op that isn't
 permitted at run time.
 
 (P) The compiler is screwed up and attempted to use an op that isn't
 permitted at run time.
 

+=item panic: unknown OA_*: %x
+
+(P) The internal routine that handles arguments to C<&CORE::foo()>
+subroutine calls was unable to determine what type of arguments
+were expected.
+

 =item panic: utf16_to_utf8: odd bytelen
 
 (P) Something tried to call utf16_to_utf8 with an odd (as opposed
 =item panic: utf16_to_utf8: odd bytelen
 
 (P) Something tried to call utf16_to_utf8 with an odd (as opposed


@@ -5874,18 +5865,6 @@ will deny it.
 (F) The function indicated isn't implemented on this architecture,
 according to the probings of Configure.
 
 (F) The function indicated isn't implemented on this architecture,
 according to the probings of Configure.
 

-=item The lexical_subs feature is experimental
-
-(S experimental::lexical_subs) This warning is emitted if you
-declare a sub with C<my> or C<state>.  Simply suppress the warning
-if you want to use the feature, but know that in doing so you
-are taking the risk of using an experimental feature which may
-change or be removed in a future Perl version:
-
-    no warnings "experimental::lexical_subs";
-    use feature "lexical_subs";
-    my sub foo { ... }
-

 =item The regex_sets feature is experimental
 
 (S experimental::regex_sets) This warning is emitted if you
 =item The regex_sets feature is experimental
 
 (S experimental::regex_sets) This warning is emitted if you


@@ -6249,12 +6228,6 @@ problems when being input or output, which is likely where this message
 came from.  If you really really know what you are doing you can turn
 off this warning by C<no warnings 'surrogate';>.
 
 came from.  If you really really know what you are doing you can turn
 off this warning by C<no warnings 'surrogate';>.
 

-=item Unknown charname '' is deprecated
-
-(D deprecated) You had a C<\N{}> with nothing between the braces.  This
-usage is deprecated, and will be made a syntax error in a future Perl
-version.
-

 =item Unknown charname '%s'
 
 (F) The name you used inside C<\N{}> is unknown to Perl.  Check the
 =item Unknown charname '%s'
 
 (F) The name you used inside C<\N{}> is unknown to Perl.  Check the


@@ -6265,6 +6238,12 @@ exactly, regardless of whether C<:loose> is used or not.)  This error may
 also happen if the C<\N{}> is not in the scope of the corresponding
 C<S<use charnames>>.
 
 also happen if the C<\N{}> is not in the scope of the corresponding
 C<S<use charnames>>.
 

+=item Unknown charname '' is deprecated
+
+(D deprecated) You had a C<\N{}> with nothing between the braces.  This
+usage is deprecated, and will be made a syntax error in a future Perl
+version.
+

 =item Unknown error
 
 (P) Perl was about to print an error message in C<$@>, but the C<$@> variable
 =item Unknown error
 
 (P) Perl was about to print an error message in C<$@>, but the C<$@> variable


@@ -7078,6 +7057,12 @@ S<<-- HERE> in m/%s/
 (F) You used a verb pattern that is not allowed an argument.  Remove the 
 argument or check that you are using the right verb.
 
 (F) You used a verb pattern that is not allowed an argument.  Remove the 
 argument or check that you are using the right verb.
 

+=item Version control conflict marker '%s'
+
+(F) The parser found a line starting with C<E<lt><<<<<<>,
+C<E<gt>E<gt>E<gt>E<gt>E<gt>E<gt>E<gt>>, or C<=======>. These may be left by a
+version control system to mark conflicts after a failed merge operation.
+

 =item Version number must be a constant number
 
 (P) The attempt to translate a C<use Module n.n LIST> statement into
 =item Version number must be a constant number
 
 (P) The attempt to translate a C<use Module n.n LIST> statement into