X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperldiag.pod;h=10b77c9c532af76b9633b0a3e02b5ba528852d43;hb=0111df86b68202837d8ca044a27bbc00d7895fb1;hp=7ea6e857094a62a7d1c3a1e9f1772354869908be;hpb=3d1a39c8be0d615d52d784b13d1b1dd635567f2a;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perldiag.pod b/pod/perldiag.pod index 7ea6e85..10b77c9 100644 --- a/pod/perldiag.pod +++ b/pod/perldiag.pod @@ -44,6 +44,14 @@ letter. =over 4 +=item A thread exited while %d other threads were still running + +(W) 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 then main +thread. See L. + =item accept() on closed socket %s (W closed) You tried to do an accept on a closed socket. Did you forget @@ -182,17 +190,26 @@ spots. This is now heavily deprecated. must either both be scalars or both be lists. Otherwise Perl won't know which context to supply to the right side. -=item Negative offset to vec in lvalue context +=item Attempt to access disallowed key '%s' in a restricted hash -(F) When C is called in an lvalue context, the second argument must be -greater than or equal to zero. +(F) The failing code has attempted to get or set a key which is not in +the current set of allowed keys of a restricted hash. + +=item Attempt to clear a restricted hash + +(F) It is currently not allowed to clear a restricted hash, even if the +new hash would contain the same keys as before. This may change in +the future. + +=item Attempt to delete readonly key '%s' from a restricted hash + +(F) The failing code attempted to delete a key whose value has been +declared readonly from a restricted hash. -=item Attempt to access to key '%_' in fixed hash +=item Attempt to delete disallowed key '%s' from a restricted hash -(F) A hash has been marked as READONLY at the C level to turn it -into a "record" with a fixed set of keys. The failing code -has attempted to get or set the value of a key which does not -exist or to delete a key. +(F) The failing code attempted to delete from a restricted hash a key +which is not in its key set. =item Attempt to bless into a reference @@ -673,7 +690,9 @@ editor will have a way to help you find these characters. =item Can't find %s property definition %s (F) You may have tried to use C<\p> which means a Unicode property for -example \p{Lu} is all uppercase letters. Escape the C<\p>, either +example \p{Lu} is all uppercase letters. if you did mean to use a +Unicode property, see L for the list of known properties. +If you didn't mean to use a Unicode property, escape the C<\p>, either C<\\p> (just the C<\p>) or by C<\Q\p> (the rest of the string, until possible C<\E>). @@ -798,6 +817,11 @@ the file, say, by doing C. functioning as a class, but that package doesn't define that particular method, nor does any of its base classes. See L. +=item Can't locate PerlIO%s + +(F) You tried to use in open() a PerlIO layer that does not exist, +e.g. open(FH, ">:nosuchlayer", "somefile"). + =item (perhaps you forgot to load "%s"?) (F) This is an educated guess made in conjunction with the message @@ -851,6 +875,16 @@ switches, or explicitly, failed for the indicated reason. Usually this is because you don't have read permission for a file which you named on the command line. +=item Can't open a reference + +(W io) You tried to open a scalar reference for reading or writing, +using the 3-arg open() syntax : + + open FH, '>', $ref; + +but your version of perl is compiled without perlio, and this form of +open is not supported. + =item Can't open bidirectional pipe (W pipe) You tried to say C, which is not supported. @@ -1140,6 +1174,29 @@ in the regular expression engine; or rewriting the regular expression so that it is simpler or backtracks less. (See L for information on I.) +=item cond_broadcast() called on unlocked variable + +(W threads) Within a thread-enabled program, you tried to call +cond_broadcast() on a variable which wasn't locked. The cond_broadcast() +function is used to wake up another thread that is waiting in a +cond_wait(). To ensure that the signal isn't sent before the other thread +has a chance to enter the wait, it is usual for the signaling thread to +first wait for a lock on variable. This lock attempt will only succeed +after the other thread has entered cond_wait() and thus relinquished the +lock. + + +=item cond_signal() called on unlocked variable + +(W threads) Within a thread-enabled program, you tried to call +cond_signal() on a variable which wasn't locked. The cond_signal() +function is used to wake up another thread that is waiting in a +cond_wait(). To ensure that the signal isn't sent before the other thread +has a chance to enter the wait, it is usual for the signaling thread to +first wait for a lock on variable. This lock attempt will only succeed +after the other thread has entered cond_wait() and thus relinquished the +lock. + =item connect() on closed socket %s (W closed) You tried to do a connect on a closed socket. Did you forget @@ -1164,7 +1221,7 @@ See L and L. =item Constant subroutine %s redefined -(S|W redefine) You redefined a subroutine which had previously been +(S) You redefined a subroutine which had previously been eligible for inlining. See L for commentary and workarounds. @@ -1227,6 +1284,11 @@ array is empty, just use C for example. checks for an undefined I value. If you want to see if the hash is empty, just use C for example. +=item %s defines neither package nor VERSION--version check failed + +(F) You said something like "use Module 42" but in the Module file +there are neither package declarations nor a C<$VERSION>. + =item Delimiter for here document is too long (F) In a here document construct like C<<, the label C is too @@ -1270,6 +1332,11 @@ you called it with no args and both C<$@> and C<$_> were empty. See Server error. +=item %s does not define %s::VERSION--version check failed + +(F) You said something like "use Module 42" but the Module did not +define a C<$VERSION.> + =item Don't know how to handle magic of type '%s' (P) The internal handling of magical variables has been cursed. @@ -1308,7 +1375,9 @@ unlikely to be what you want. =item Empty %s -(F) Empty C<\p{}> or C<\P{}>. +(F) C<\p> and C<\P> are used to introduce a named Unicode property, as +described in L and L. You used C<\p> or C<\P> in +a regular expression without specifying the property name. =item entering effective %s failed @@ -1351,6 +1420,10 @@ Perl identifier. If you're just trying to glob a long list of filenames, try using the glob() operator, or put the filenames into a variable and glob that. +=item exec? I'm not *that* kind of operating system + +(F) The C function is not implemented in MacPerl. See L. + =item Execution of %s aborted due to compilation errors (F) The final summary message when a Perl compilation fails. @@ -1362,7 +1435,7 @@ goto, or a loop control statement. =item Exiting format via %s -(W exiting) You are exiting an eval by unconventional means, such as a +(W exiting) You are exiting a format by unconventional means, such as a goto, or a loop control statement. =item Exiting pseudo-block via %s @@ -1559,6 +1632,11 @@ version of Perl, and this should not happen anyway. (F) Unlike with "next" or "last", you're not allowed to goto an unspecified destination. See L. +=item %s-group starts with a count + +(F) In pack/unpack a ()-group started with a count. A count is +supposed to follow something: a template character or a ()-group. + =item %s had compilation errors (F) The final summary message when a C fails. @@ -1675,6 +1753,12 @@ would otherwise result in the same message being repeated. Failure of user callbacks dispatched using the C flag could also result in this warning. See L. +=item In EBCDIC the v-string components cannot exceed 2147483647 + +(F) An error peculiar to EBCDIC. Internally, v-strings are stored as +Unicode code points, and encoded in EBCDIC as UTF-EBCDIC. The UTF-EBCDIC +encoding is limited to code points no larger than 2147483647 (0x7FFFFFFF). + =item Insecure dependency in %s (F) You tried to do something that the tainting mechanism didn't like. @@ -1891,6 +1975,10 @@ when the function is called. Perl detected something that didn't comply with UTF-8 encoding rules. +One possible cause is that you read in data that you thought to be in +UTF-8 but it wasn't (it was for example legacy 8-bit data). Another +possibility is careless use of utf8::upgrade(). + =item Malformed UTF-16 surrogate Perl thought it was reading UTF-16 encoded character data but while @@ -2025,6 +2113,13 @@ couldn't be created for some peculiar reason. you omitted the name of the module. Consult L for full details about C<-M> and C<-m>. +=item More than one argument to open + +(F) The C function has been asked to open multiple files. This +can happen if you are trying to open a pipe to a command that takes a +list of arguments, but have forgotten to specify a piped open mode. +See L for details. + =item msg%s not implemented (F) You don't have System V message IPC on your system. @@ -2074,6 +2169,11 @@ provided for this purpose. (F) You tried to do a read/write/send/recv operation with a buffer length that is less than 0. This is difficult to imagine. +=item Negative offset to vec in lvalue context + +(F) When C is called in an lvalue context, the second argument must be +greater than or equal to zero. + =item Nested quantifiers in regex; marked by <-- HERE in m/%s/ (F) You can't quantify a quantifier without intervening parentheses. So @@ -2308,6 +2408,12 @@ supplied. See L. of Perl. Check the #! line, or manually feed your script into Perl yourself. +=item %s not allowed in length fields + +(F) The count in the (un)pack template may be replaced by C<[TEMPLATE]> only if +C