X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperldiag.pod;h=817503bfaeca58596feb1cd57c908d0882d206d3;hb=f26f4a2f8b63c72a33468ddeeb9d0337f0892af6;hp=de1d496dd22b7af5500f18dc43f9082bc59f6191;hpb=ccafdc969fe8361303a07e7576d1af4e3e389a76;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perldiag.pod b/pod/perldiag.pod index de1d496..817503b 100644 --- a/pod/perldiag.pod +++ b/pod/perldiag.pod @@ -193,7 +193,7 @@ know which context to supply to the right side. =item A thread exited while %d threads were running -(W) When using threaded Perl, a thread (not necessarily the main +(W threads)(S) When using threaded Perl, a thread (not necessarily the main thread) exited while there were still other threads running. Usually it's a good idea to first collect the return values of the created threads by joining them, and only then exit from the main @@ -282,6 +282,15 @@ invalid anytime, even before the end of the current statement. Use literals or global values as arguments to the "p" pack() template to avoid this warning. +=item Attempt to set length of freed array + +(W) You tried to set the length of an array which has been freed. You +can do this by storing a reference to the scalar representing the last index +of an array and later assigning through that reference. For example + + $r = do {my @a; \$#a}; + $$r = 503 + =item Attempt to use reference as lvalue in substr (W substr) You supplied a reference as the first argument to substr() @@ -752,11 +761,10 @@ a block, except that it isn't a proper block. This usually occurs if you tried to jump out of a sort() block or subroutine, which is a no-no. See L. -=item Can't goto subroutine from an eval-string +=item Can't goto subroutine from an eval-%s (F) The "goto subroutine" call can't be used to jump out of an eval -"string". (You can use it to jump out of an eval {BLOCK}, but you -probably don't want to.) +"string" or block. =item Can't goto subroutine outside a subroutine @@ -1634,13 +1642,13 @@ Another possibility is that you attempted to open filedescriptor 0 =item Filehandle %s reopened as %s only for input (W io) You opened for reading a filehandle that got the same filehandle id -as STDOUT or STDERR. This occured because you closed STDOUT or STDERR +as STDOUT or STDERR. This occurred because you closed STDOUT or STDERR previously. =item Filehandle STDIN reopened as %s only for output (W io) You opened for writing a filehandle that got the same filehandle id -as STDIN. This occured because you closed STDIN previously. +as STDIN. This occurred because you closed STDIN previously. =item Final $ should be \$ or $name @@ -1858,7 +1866,7 @@ Interpretation of the octal number stopped before the 8 or 9. =item Illegal switch in PERL5OPT: %s (X) The PERL5OPT environment variable may only be used to set the -following switches: B<-[DIMUdmtw]>. +following switches: B<-[CDIMUdmtwA]>. =item Ill-formed CRTL environ value "%s" @@ -2056,6 +2064,12 @@ neither as a system call or an ioctl call (SIOCATMARK). been removed as of 5.9.0 and is no longer supported. You should use the C and C regexp modifiers instead. +=item $# is no longer supported + +(D deprecated) The special variable C<$#>, deprecated in older perls, has +been removed as of 5.9.3 and is no longer supported. You should use the +printf/sprintf functions instead. + =item `%s' is not a code reference (W overload) The second (fourth, sixth, ...) argument of overload::constant @@ -2096,7 +2110,7 @@ effective uids or gids failed. =item length/code after end of string in unpack -(F) While unpacking, the string buffer was alread used up when an unpack +(F) While unpacking, the string buffer was already used up when an unpack length/code combination tried to obtain more data. This results in an undefined value for the length. See L. @@ -2705,7 +2719,7 @@ that isn't open. Check your control flow. See also L. (S internal) An internal warning that the grammar is screwed up. -=item Operation `%s': no method found, %s +=item Operation "%s": no method found, %s (F) An attempt was made to perform an overloaded operation for which no handler was defined. While some handlers can be autogenerated in terms @@ -3365,7 +3379,7 @@ earlier. =item Repeated format line will never terminate (~~ and @# incompatible) -(F) Your format containes the ~~ repeat-until-blank sequence and a +(F) Your format contains the ~~ repeat-until-blank sequence and a numeric field that will never go blank so that the repetition never terminates. You might use ^# instead. See L. @@ -3435,6 +3449,16 @@ construct, not just the empty search pattern. Therefore code written in Perl 5.9.0 or later that uses the // as the I can be misparsed by pre-5.9.0 Perls as a non-terminated search pattern. +=item Search pattern not terminated or ternary operator parsed as search pattern + +(F) The lexer couldn't find the final delimiter of a C +construct. + +The question mark is also used as part of the ternary operator (as in +C) leading to some ambiguous constructions being wrongly +parsed. One way to disambiguate the parsing is to put parentheses around +the conditional expression, i.e. C<(foo) ? 0 : 1>. + =item %sseek() on unopened filehandle (W unopened) You tried to use the seek() or sysseek() function on a @@ -3649,7 +3673,7 @@ a block by itself. (W unopened) You tried to use the stat() function on a filehandle that was either never opened or has since been closed. -=item Stub found while resolving method `%s' overloading %s +=item Stub found while resolving method "%s" overloading "%s" (P) Overloading resolution over @ISA tree may be broken by importation stubs. Stubs should never be implicitly created, but explicit calls to @@ -3696,6 +3720,11 @@ assignment or as a subroutine argument for example). (F) Your Perl was compiled with B<-D>SETUID_SCRIPTS_ARE_SECURE_NOW, but a version of the setuid emulator somehow got run anyway. +=item sv_upgrade from type %d down to type %d + +(P) Perl tried to force the upgrade an SV to a type which was actually +inferior to its current type. + =item Switch (?(condition)... contains too many branches in regex; marked by <-- HERE in m/%s/ (F) A (?(condition)if-clause|else-clause) construct can have at most two @@ -3846,7 +3875,7 @@ target of the change to =item thread failed to start: %s -(F) The entry point function of threads->create() failed for some reason. +(W threads)(S) The entry point function of threads->create() failed for some reason. =item times not implemented @@ -4418,11 +4447,6 @@ C. (F) You attempted to use a feature of printf that is accessible from only C. This usually means there's a better way to do it in Perl. -=item Use of $# is deprecated - -(D deprecated) This was an ill-advised attempt to emulate a poorly -defined B feature. Use an explicit printf() or sprintf() instead. - =item Use of %s is deprecated (D deprecated) The construct indicated is no longer recommended for use, @@ -4687,16 +4711,6 @@ the beginning of the string being (un)packed. See L. (F) You had a pack template that specified a relative position after the end of the string being unpacked. See L. -=item Xsub "%s" called in sort - -(F) The use of an external subroutine as a sort comparison is not yet -supported. - -=item Xsub called in sort - -(F) The use of an external subroutine as a sort comparison is not yet -supported. - =item YOU HAVEN'T DISABLED SET-ID SCRIPTS IN THE KERNEL YET! (F) And you probably never will, because you probably don't have the