X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperldelta.pod;h=5a054e13b32aade508473d00895668c4477e1140;hb=dfed14d211a4828e9d879513466e41afb47fa3fb;hp=c34897f7f306afc5cd012ce7a9ad9512b3fdc48e;hpb=67d3893f3b475ca335f6043466b3b86e1842b36f;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perldelta.pod b/pod/perldelta.pod index c34897f..5a054e1 100644 --- a/pod/perldelta.pod +++ b/pod/perldelta.pod @@ -24,13 +24,39 @@ responsibility to ensure that warnings are enabled judiciously. =over 4 +=item Treatment of list slices of undef has changed + +When taking a slice of a literal list (as opposed to a slice of +an array or hash), Perl used to return an empty list if the +result happened to be composed of all undef values. + +The new behavior is to produce an empty list if (and only if) +the original list was empty. Consider the following example: + + @a = (1,undef,undef,2)[2,1,2]; + +The old behavior would have resulted in @a having no elements. +The new behavior ensures it has three undefined elements. + +Note in particular that the behavior of slices of the following +cases remains unchanged: + + @a = ()[1,2]; + @a = (getpwent)[7,0]; + @a = (anything_returning_empty_list())[2,1,2]; + @a = @b[2,1,2]; + @a = @c{'a','b','c'}; + +See L. + =item Possibly changed pseudo-random number generator In 5.005_0x and earlier, perl's rand() function used the C library rand(3) function. As of 5.005_52, Configure tests for drand48(), random(), and rand() (in that order) and picks the first one it finds. Perl programs that depend on reproducing a specific set of pseudo-random -numbers will now likely produce different output. +numbers will now likely produce different output. You can use +C to obtain the old behavior. =item Hashing function for hash keys has changed @@ -72,11 +98,11 @@ returned values, but this is can make a significant difference when creating references to the returned values. Keys in the hash are still returned as copies when iterating on -on a hash. +a hash. =item vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS -vec() generates a run-time error if the BITS arguments is not +vec() generates a run-time error if the BITS argument is not a valid power-of-two integer. =item Text of some diagnostic output has changed @@ -224,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 @@ -247,7 +273,8 @@ because many scripts assume to find Perl in /usr/bin/perl. =head2 SOCKS support You can use "Configure -Dusesocks" which causes Perl to probe -for the SOCKS proxy protocol library, http://www.socks.nec.com/ +for the SOCKS (v5, not v4) proxy protocol library, +http://www.socks.nec.com/ =head2 C<-A> flag @@ -256,10 +283,14 @@ flag. The editing happens immediately after the platform specific hints files have been processed but before the actual configuration process starts. Run C to find out the full C<-A> syntax. -=head2 New Installation Scheme +=head2 Enhanced Installation Directories -vendorprefix et al -[TODO - Andy Dougherty ] +The installation structure has been enriched to improve the support for +maintaining multiple versions of perl, to provide locations for +vendor-supplied modules and scripts, and to ease maintenance of +locally-added modules and scripts. See the section on Installation +Directories in the INSTALL file for complete details. For most users +building and installing from source, the defaults should be fine. =head1 Core Changes @@ -299,6 +330,15 @@ change#3385, also need perlguts documentation [TODO - Tuomas Lukka ] +=head2 File globbing implemented internally + +WARNING: This is currently an experimental feature. Interfaces and +implementation are likely to change. + +Perl can be compiled with -DPERL_INTERNAL_GLOB to use the File::Glob +implementation of the glob() operator. This avoids using an external +csh process and the problems associated with it. + =head2 Binary numbers supported Binary numbers are now supported as literals, in s?printf formats, and @@ -550,7 +590,7 @@ change#2150 change#4052 [TODO - Ilya Zakharevich ] -=head2 Experimental support form user-hooks in @INC +=head2 Experimental support for user-hooks in @INC [TODO - Ken Fox ] @@ -565,7 +605,7 @@ See L. =head2 New variable $^C reflects C<-c> switch -C<$^C> contains a boolean that reflects whether perl is being run +C<$^C> has a boolean value that reflects whether perl is being run in compile-only mode (i.e. via the C<-c> switch). Since BEGIN blocks are executed under such conditions, this variable enables perl code to determine whether actions that make sense @@ -625,9 +665,9 @@ that was encountered. The mechanism for reporting such errors has been reimplemented to queue compile-time errors and report them at the end of the compilation as true errors rather than as warnings. This fixes -error messages that used to leak through as warnings when code -was compiled at run time using C, and allows such -errors to be reliably trapped using __DIE__ hooks. +cases where error messages leaked through in the form of warnings +when code was compiled at run time using C, and +also allows such errors to be reliably trapped using __DIE__ hooks. =head2 Automatic flushing of output buffers @@ -661,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 @@ -686,7 +726,7 @@ the specified value exists, not merely if the key is valid. =head2 C and AUTOLOAD -C construct works correctly when C<&sub> happens +The C construct works correctly when C<&sub> happens to be autoloaded. =head2 C<-bareword> allowed under C @@ -702,7 +742,7 @@ Constructs such as C<($a ||= 2) += 1> are now allowed. =head2 C allowed sort() did not accept a subroutine reference as the comparison -function in earlier versions. This has been fixed. +function in earlier versions. This is now permitted. =head2 Failures in DESTROY() @@ -714,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 @@ -754,7 +794,7 @@ cause silent failures. This has been fixed. Prior versions used to run BEGIN B END blocks when Perl was run in compile-only mode. Since this is typically not the expected -behavior, END blocks are not executed when the C<-c> switch +behavior, END blocks are not executed anymore when the C<-c> switch is used. Note that something resembling the previous behavior can still be @@ -778,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 @@ -798,7 +838,7 @@ semantics in later versions of Perl. =head2 Simple sort() using { $a <=> $b } and the like are optimized -Many common sort() opertions using a simple inlined block are now +Many common sort() operations using a simple inlined block are now optimized for faster performance. =head2 Optimized assignments to lexical variables @@ -896,6 +936,9 @@ return values from system(1,...). The C module is supported. +Rudimentary support for building under command.com in Windows 95 +has been added. + [TODO - GSAR] =head1 New tests @@ -999,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 @@ -1051,9 +1094,15 @@ comparison functions. See L. File::Find now works correctly when the wanted() function is either autoloaded or is a symbolic reference. -A bug that cause File::Find to lose track of the working directory +A bug that caused File::Find to lose track of the working directory when pruning top-level directories has been fixed. +=item File::Glob + +This extension implements BSD-style file globbing. It will also be +used for the internal implementation of the glob() operator if +Perl was compiled with -DPERL_INTERNAL_GLOB. See L. + =item File::Spec New methods have been added to the File::Spec module: devnull() returns @@ -1077,7 +1126,64 @@ instead of =item Getopt::Long -[TODO - Johan Vromans ] +Getopt::Long licensing has changed to allow the Perl Artistic License +as well as the GPL. It used to be GPL only, which got in the way of +non-GPL applications that wanted to use Getopt::Long. + +Getopt::Long encourages the use of Pod::Usage to produce help +messages. For example: + + use Getopt::Long; + use Pod::Usage; + my $man = 0; + my $help = 0; + GetOptions('help|?' => \$help, man => \$man) or pod2usage(2); + pod2usage(1) if $help; + pod2usage(-exitstatus => 0, -verbose => 2) if $man; + + __END__ + + =head1 NAME + + sample - Using GetOpt::Long and Pod::Usage + + =head1 SYNOPSIS + + sample [options] [file ...] + + Options: + -help brief help message + -man full documentation + + =head1 OPTIONS + + =over 8 + + =item B<-help> + + Print a brief help message and exits. + + =item B<-man> + + Prints the manual page and exits. + + =back + + =head1 DESCRIPTION + + B will read the given input file(s) and do someting + useful with the contents thereof. + + =cut + +See L for details. + +A bug that prevented the non-option call-back EE from being +specified as the first argument has been fixed. + +To specify the characters E and E as option starters, use +EE. Note, however, that changing option starters is strongly +deprecated. =item IO @@ -1096,9 +1202,14 @@ from ever returning the correct value has been corrected. Java Perl Lingo is now distributed with Perl. See jpl/README for more information. +=item lib + +C now weeds out any trailing duplicate entries. +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 @@ -1133,7 +1244,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 @@ -1177,7 +1288,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. @@ -1220,6 +1331,14 @@ change#4232 =over 4 +=item perlcompile.pod + +An introduction to using the Perl Compiler suite. + +=item perlhack.pod + +Some guidelines for hacking the Perl source code. + =item perlopentut.pod A tutorial on using open() effectively. @@ -1232,19 +1351,80 @@ A tutorial that introduces the essentials of references. A tutorial on managing class data for object modules. -=item perlcompile.pod - -An introduction to using the Perl Compiler suite. - =back =head1 New Diagnostics +=over 4 + =item "my sub" not yet implemented (F) Lexically scoped subroutines are not yet implemented. Don't try that yet. +=item '!' allowed only after types %s + +(F) The '!' is allowed in pack() and unpack() only after certain types. +See L. + +=item / cannot take a count + +(F) You had an unpack template indicating a counted-length string, +but you have also specified an explicit size for the string. +See L. + +=item / must be followed by a, A or Z + +(F) You had an unpack template indicating a counted-length string, +which must be followed by one of the letters a, A or Z +to indicate what sort of string is to be unpacked. +See L. + +=item / must be followed by a*, A* or Z* + +(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. + +=item / must follow a numeric type + +(F) You had an unpack template that contained a '#', +but this did not follow some numeric unpack specification. +See L. + +=item Repeat count in pack overflows + +(F) You can't specify a repeat count so large that it overflows +your signed integers. See L. + +=item Repeat count in unpack overflows + +(F) You can't specify a repeat count so large that it overflows +your signed integers. See L. + +=item /%s/: Unrecognized escape \\%c passed through + +(W) You used a backslash-character combination which is not recognized +by Perl. This combination appears in an interpolated variable or a +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, +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. + +=item %s() called too early to check prototype + +(W) You've called a function that has a prototype before the parser saw a +definition or declaration for it, and Perl could not check that the call +conforms to the prototype. You need to either add an early prototype +declaration for the subroutine in question, or move the subroutine +definition ahead of the call to get proper prototype checking. Alternatively, +if you are certain that you're calling the function correctly, you may put +an ampersand before the name to avoid the warning. See L. + =item %s package attribute may clash with future reserved word: %s (W) A lowercase attribute name was used that had a package-specific handler. @@ -1252,20 +1432,199 @@ That name might have a meaning to Perl itself some day, even though it doesn't yet. Perhaps you should use a mixed-case attribute name, instead. See L. -=item /%s/: Unrecognized escape \\%c passed through +=item (in cleanup) %s -(W) You used a backslash-character combination which is not recognized -by Perl. This combination appears in an interpolated variable or a -C<'>-delimited regular expression. +(W) This prefix usually indicates that a DESTROY() method raised +the indicated exception. Since destructors are usually called by +the system at arbitrary points during execution, and often a vast +number of times, the warning is issued only once for any number +of failures that 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 <> should be quotes + +(F) You wrote CfileE> when you should have written +C. + +=item Attempt to join self + +(F) You tried to join a thread from within itself, which is an +impossible task. You may be joining the wrong thread, or you may +need to move the join() to some other thread. + +=item Bad evalled substitution pattern + +(F) You've used the /e switch to evaluate the replacement for a +substitution, but perl found a syntax error in the code to evaluate, +most likely an unexpected right brace '}'. + +=item Bad realloc() ignored + +(S) An internal routine called realloc() on something that had never been +malloc()ed in the first place. Mandatory, but can be disabled by +setting environment variable C to 1. + +=item Binary number > 0b11111111111111111111111111111111 non-portable + +(W) The binary number you specified is larger than 2**32-1 +(4294967295) and therefore non-portable between systems. See +L for more on portability concerns. + +=item Bit vector size > 32 non-portable + +(W) Using bit vector sizes larger than 32 is non-portable. + +=item Buffer overflow in prime_env_iter: %s + +(W) A warning peculiar to VMS. While Perl was preparing to iterate over +%ENV, it encountered a logical name or symbol definition which was too long, +so it was truncated to the string shown. + +=item Can't check filesystem of script "%s" + +(P) For some reason you can't check the filesystem of the script for nosuid. + +=item Can't modify non-lvalue subroutine call + +(F) Subroutines meant to be used in lvalue context should be declared as +such, see L. + +=item Can't read CRTL environ + +(S) A warning peculiar to VMS. Perl tried to read an element of %ENV +from the CRTL's internal environment array and discovered the array was +missing. You need to figure out where your CRTL misplaced its environ +or define F (see L) so that environ is not searched. + +=item Can't remove %s: %s, skipping file + +(S) You requested an inplace edit without creating a backup file. Perl +was unable to remove the original file to replace it with the modified +file. The file was left unmodified. + +=item Can't return %s from lvalue subroutine + +(F) Perl detected an attempt to return illegal lvalues (such +as temporary or readonly values) from a subroutine used as an lvalue. +This is not allowed. + +=item Can't weaken a nonreference + +(F) You attempted to weaken something that was not a reference. Only +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 [= =] and [. .] +are not currently implemented; they are simply placeholders for +future extensions. + +=item Constant is not %s reference + +(F) A constant value (perhaps declared using the C pragma) +is being dereferenced, but it amounts to the wrong type of reference. The +message indicates the type of reference that was expected. This usually +indicates a syntax error in dereferencing the constant value. +See L and L. + +=item constant(%s): %%^H is not localized + +(F) When setting compile-time-lexicalized hash %^H one should set the +corresponding bit of $^H as well. + +=item constant(%s): %s + +(F) Compile-time-substitutions (such as overloaded constants and +character names) were not correctly set up. + +=item defined(@array) is deprecated + +(D) defined() is not usually useful on arrays because it checks for an +undefined I value. If you want to see if the array is empty, +just use C for example. + +=item defined(%hash) is deprecated + +(D) defined() is not usually useful on hashes because it checks for an +undefined I value. If you want to see if the hash is empty, +just use C for example. + +=item Did not produce a valid header + +See Server error. + +=item Document contains no data + +See Server error. + +=item entering effective %s failed + +(F) While under the C pragma, switching the real and +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. +=item Hexadecimal number > 0xffffffff non-portable + +(W) The hexadecimal number you specified is larger than 2**32-1 +(4294967295) and therefore non-portable between systems. See +L for more on portability concerns. + +=item Ill-formed CRTL environ value "%s" + +(W) A warning peculiar to VMS. Perl tried to read the CRTL's internal +environ array, and encountered an element without the C<=> delimiter +used to spearate keys from values. The element is ignored. + +=item Ill-formed message in prime_env_iter: |%s| + +(W) A warning peculiar to VMS. Perl tried to read a logical name +or CLI symbol definition when preparing to iterate over %ENV, and +didn't see the expected delimiter between key and value, so the +line was ignored. + +=item Illegal binary digit %s + +(F) You used a digit other than 0 or 1 in a binary number. + +=item Illegal binary digit %s ignored + +(W) You may have tried to use a digit other than 0 or 1 in a binary number. +Interpretation of the binary number stopped before the offending digit. + +=item Illegal number of bits in vec + +(F) The number of bits in vec() (the third argument) must be a power of +two from 1 to 32 (or 64, if your platform supports that). + +=item Integer overflow in %s number + +(W) The hexadecimal, octal or binary number you have specified either +as a literal or as an argument to hex() or oct() is too big for your +architecture, and has been converted to a floating point number. On a +32-bit architecture the largest hexadecimal, octal or binary number +representable without overflow is 0xFFFFFFFF, 037777777777, or +0b11111111111111111111111111111111 respectively. Note that Perl +transparently promotes all numbers to a floating point representation +internally--subject to loss of precision errors in subsequent +operations. + =item Invalid %s attribute: %s The indicated attribute for a subroutine or variable was not recognized @@ -1283,6 +1642,33 @@ elements of an attribute list. If the previous attribute had a parenthesised parameter list, perhaps that list was terminated too soon. See L. +=item Invalid separator character %s in subroutine attribute list + +(F) Something other than a comma or whitespace was seen between the +elements of a subroutine attribute list. If the previous attribute +had a parenthesised parameter list, perhaps that list was terminated +too soon. + +=item leaving effective %s failed + +(F) While under the C pragma, switching the real and +effective uids or gids failed. + +=item Lvalue subs returning %s not implemented yet + +(F) Due to limitations in the current implementation, array and hash +values cannot be returned in subroutines used in lvalue context. +See L. + +=item Method %s not permitted + +See Server error. + +=item Missing %sbrace%s on \N{} + +(F) Wrong syntax of character name literal C<\N{charname}> within +double-quotish context. + =item Missing command in piped open (W) You used the C or C @@ -1293,6 +1679,97 @@ construction, but the command was missing or blank. (F) The reserved syntax for lexically scoped subroutines requires that they have a name with which they can be found. +=item no UTC offset information; assuming local time is UTC + +(S) A warning peculiar to VMS. Perl was unable to find the local +timezone offset, so it's assuming that local system time is equivalent +to UTC. If it's not, define the logical name F +to translate to the number of seconds which need to be added to UTC to +get local time. + +=item Octal number > 037777777777 non-portable + +(W) The octal number you specified is larger than 2**32-1 (4294967295) +and therefore non-portable between systems. See L for more +on portability concerns. + +See also L for writing portable code. + +=item panic: del_backref + +(P) Failed an internal consistency check while trying to reset a weak +reference. + +=item panic: kid popen errno read + +(F) forked child returned an incomprehensible message about its errno. + +=item panic: magic_killbackrefs + +(P) Failed an internal consistency check while trying to reset all weak +references to an object. + +=item Possible Y2K bug: %s + +(W) You are concatenating the number 19 with another number, which +could be a potential Year 2000 problem. + +=item Premature end of script headers + +See Server error. + +=item realloc() of freed memory ignored + +(S) An internal routine called realloc() on something that had already +been freed. + +=item Reference is already weak + +(W) You have attempted to weaken a reference that is already weak. +Doing so has no effect. + +=item setpgrp can't take arguments + +(F) Your system has the setpgrp() from BSD 4.2, which takes no arguments, +unlike POSIX setpgid(), which takes a process ID and process group ID. + +=item Strange *+?{} on zero-length expression + +(W) You applied a regular expression quantifier in a place where it +makes no sense, such as on a zero-width assertion. +Try putting the quantifier inside the assertion instead. For example, +the way to match "abc" provided that it is followed by three +repetitions of "xyz" is C, not C. + +=item switching effective %s is not implemented + +(F) While under the C pragma, we cannot switch the +real and effective uids or gids. + +=item This Perl can't reset CRTL environ elements (%s) + +=item This Perl can't set CRTL environ elements (%s=%s) + +(W) Warnings peculiar to VMS. You tried to change or delete an element +of the CRTL's internal environ array, but your copy of Perl wasn't +built with a CRTL that contained the setenv() function. You'll need to +rebuild Perl with a CRTL that does, or redefine F (see +L) so that the environ array isn't the target of the change to +%ENV which produced the warning. + +=item Unknown open() mode '%s' + +(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 + +(P) An error peculiar to VMS. Perl was reading values for %ENV before +iterating over it, and someone else stuck a message in the stream of +data Perl expected. Someone's very confused, or perhaps trying to +subvert Perl's population of %ENV for nefarious purposes. + =item Unrecognized escape \\%c passed through (W) You used a backslash-character combination which is not recognized @@ -1312,30 +1789,6 @@ of an attribute, and it wasn't a semicolon or the start of a block. Perhaps you terminated the parameter list of the previous attribute too soon. See L. -=item defined(@array) is deprecated - -(D) defined() is not usually useful on arrays because it checks for an -undefined I value. If you want to see if the array is empty, -just use C for example. - -=item defined(%hash) is deprecated - -(D) defined() is not usually useful on hashes because it checks for an -undefined I value. If you want to see if the hash is empty, -just use C for example. - -=item Invalid separator character %s in subroutine attribute list - -(F) Something other than a comma or whitespace was seen between the -elements of a subroutine attribute list. If the previous attribute -had a parenthesised parameter list, perhaps that list was terminated -too soon. - -=item Possible Y2K bug: %s - -(W) You are concatenating the number 19 with another number, which -could be a potential Year 2000 problem. - =item Unterminated attribute parameter in subroutine attribute list (F) The lexer saw an opening (left) parenthesis character while parsing a @@ -1350,30 +1803,67 @@ of a subroutine attribute, and it wasn't a semicolon or the start of a block. Perhaps you terminated the parameter list of the previous attribute too soon. -=item /%s/ should probably be written as "%s" +=item Value of CLI symbol "%s" too long -(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 -or false result of matching the pattern against $_ as the string, -which is probably not what you had in mind. +(W) A warning peculiar to VMS. Perl tried to read the value of an %ENV +element from a CLI symbol table, and found a resultant string longer +than 1024 characters. The return value has been truncated to 1024 +characters. -=item %s() called too early to check prototype +=item Version number must be a constant number -(W) You've called a function that has a prototype before the parser saw a -definition or declaration for it, and Perl could not check that the call -conforms to the prototype. You need to either add an early prototype -declaration for the subroutine in question, or move the subroutine -definition ahead of the call to get proper prototype checking. Alternatively, -if you are certain that you're calling the function correctly, you may put -an ampersand before the name to avoid the warning. See L. +(P) The attempt to translate a C statement into +its equivalent C block found an internal inconsistency with +the version number. + +=back =head1 Obsolete Diagnostics -Todo. +=over 4 + +=item Character class syntax [: :] is reserved for future extensions + +(W) Within regular expression character classes ([]) the syntax beginning +with "[:" and ending with ":]" is reserved for future extensions. +If you need to represent those character sequences inside a regular +expression character class, just quote the square brackets with the +backslash: "\[:" and ":\]". + +=item Ill-formed logical name |%s| in prime_env_iter + +(W) A warning peculiar to VMS. A logical name was encountered when preparing +to iterate over %ENV which violates the syntactic rules governing logical +names. Because it cannot be translated normally, it is skipped, and will not +appear in %ENV. This may be a benign occurrence, as some software packages +might directly modify logical name tables and introduce nonstandard names, +or it may indicate that a logical name table has been corrupted. + +=item regexp too big + +(F) The current implementation of regular expressions uses shorts as +address offsets within a string. Unfortunately this means that if +the regular expression compiles to longer than 32767, it'll blow up. +Usually when you want a regular expression this big, there is a better +way to do it with multiple statements. See L. + +=item Use of "$$" to mean "${$}" is deprecated + +(D) Perl versions before 5.004 misinterpreted any type marker followed +by "$" and a digit. For example, "$$0" was incorrectly taken to mean +"${$}0" instead of "${$0}". This bug is (mostly) fixed in Perl 5.004. + +However, the developers of Perl 5.004 could not fix this bug completely, +because at least two widely-used modules depend on the old meaning of +"$$0" in a string. So Perl 5.004 still interprets "$$" in the +old (broken) way inside strings; but it generates this message as a +warning. And in Perl 5.005, this special treatment will cease. + +=back =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.