Commit | Line | Data |
01358b4a |
1 | =head1 NAME |
2 | |
3 | perl5120delta - what is new for perl v5.12.0 |
4 | |
3ab3a109 |
5 | =head1 XXX - THIS DOCUMENT IS ONLY CURRENT THROUGH PERL5114 |
6 | |
dac9950b |
7 | FIX ME BEFORE RELEASE |
3ab3a109 |
8 | |
9 | OTHER ISSUES: |
10 | |
11 | UPDATED MODULE LIST NEEDS TO BE GENERATED |
12 | ORDERING NEEDS CHECKING |
13 | HEAVY COPYEDITING IS NEEDED |
14 | |
15 | |
01358b4a |
16 | =head1 DESCRIPTION |
17 | |
18 | This document describes differences between the 5.10.0 release and |
19 | the 5.12.0 release. |
20 | |
21 | Many of the bug fixes in 5.12.0 were already seen in the 5.10.1 |
22 | maintenance release since the two releases were kept closely |
23 | coordinated (while 5.12.0 was still called 5.11.something). |
24 | |
25 | You can see the list of changes in the 5.10.1 release |
26 | by reading L<perl5101delta>. |
27 | |
3ab3a109 |
28 | =head1 Core Enhancements |
29 | |
30 | =head2 qr overloading |
31 | |
32 | It is now possible to overload the C<qr//> operator, that is, |
33 | conversion to regexp, like it was already possible to overload |
34 | conversion to boolean, string or number of objects. It is invoked when |
c66407fa |
35 | an object appears on the right hand side of the C<=~> operator or when |
3ab3a109 |
36 | it is interpolated into a regexp. See L<overload>. |
37 | |
38 | =head2 Pluggable keywords |
39 | |
40 | Extension modules can now cleanly hook into the Perl parser to define |
41 | new kinds of keyword-headed expression and compound statement. The |
42 | syntax following the keyword is defined entirely by the extension. This |
43 | allow a completely non-Perl sublanguage to be parsed inline, with the |
c66407fa |
44 | correct ops cleanly generated. This feature is currently considered |
3ab3a109 |
45 | experimental. |
46 | |
47 | See L<perlapi/PL_keyword_plugin> for the mechanism. The Perl core |
48 | source distribution also includes a new module |
49 | L<XS::APItest::KeywordRPN>, which implements reverse Polish notation |
50 | arithmetic via pluggable keywords. This module is mainly used for test |
51 | purposes, and is not normally installed, but also serves as an example |
52 | of how to use the new mechanism. |
53 | |
54 | =head2 APIs for more internals |
55 | |
56 | The lowest layers of the lexer and parts of the pad system now have C |
57 | APIs available to XS extensions. These are necessary to support proper |
58 | use of pluggable keywords, but have other uses too. The new APIs are |
59 | experimental, and only cover a small proportion of what would be |
60 | necessary to take full advantage of the core's facilities in these |
61 | areas. It is intended that the Perl 5.13 development cycle will see the |
62 | addition of a full range of clean, supported interfaces. |
63 | |
64 | =head2 Overridable function lookup |
65 | |
66 | Where an extension module hooks the creation of rv2cv ops to modify the |
67 | subroutine lookup process, this now works correctly for bareword |
68 | subroutine calls. This means that prototypes on subroutines referenced |
69 | this way will be processed correctly. (Previously bareword subroutine |
70 | names were initially looked up, for parsing purposes, by an unhookable |
71 | mechanism, so extensions could only properly influence subroutine names |
72 | that appeared with an C<&> sigil.) |
73 | |
74 | =head2 Unicode version |
75 | |
76 | Perl is shipped with the latest Unicode version, 5.2, dated October 2009. See |
77 | L<http://www.unicode.org/versions/Unicode5.2.0> for details about this release |
78 | of Unicode. See L<perlunicode> for instructions on installing and using |
79 | older versions of Unicode. |
80 | |
81 | =head2 Unicode properties |
82 | |
b21d8e53 |
83 | A concerted effort has been made to update Perl to be in sync with the latest |
84 | Unicode standard. Changes for this include: |
85 | |
3ab3a109 |
86 | Perl can now handle every Unicode character property. A new pod, |
87 | L<perluniprops>, lists all available non-Unihan character properties. By |
88 | default the Unihan properties and certain others (deprecated and Unicode |
89 | internal-only ones) are not exposed. See below for more details on |
c66407fa |
90 | these; there is also a section in the pod listing them, and explaining |
91 | why they are not exposed. |
3ab3a109 |
92 | |
93 | Perl now fully supports the Unicode compound-style of using C<=> and C<:> |
94 | in writing regular expressions: C<\p{property=value}> and |
95 | C<\p{property:value}> (both of which mean the same thing). |
96 | |
97 | Perl now fully supports the Unicode loose matching rules for text |
c66407fa |
98 | between the braces in C<\p{...}> constructs. In addition, Perl allows |
3ab3a109 |
99 | underscores between digits of numbers. |
100 | |
101 | All the Unicode-defined synonyms for properties and property values are |
102 | now accepted. |
103 | |
104 | C<qr/\X/>, which matches a Unicode logical character, has been expanded to work |
b21d8e53 |
105 | better with various Asian languages. It now is defined as an I<extended |
3ab3a109 |
106 | grapheme cluster>. (See L<http://www.unicode.org/reports/tr29/>). |
c66407fa |
107 | Anything matched previously and that made sense will continue to be |
108 | matched, but in addition: |
3ab3a109 |
109 | |
110 | =over |
111 | |
112 | =item * |
113 | |
b21d8e53 |
114 | C<\X> will not break apart a C<S<CR LF>> sequence. |
3ab3a109 |
115 | |
116 | =item * |
117 | |
b21d8e53 |
118 | C<\X> will now match a sequence which includes the C<ZWJ> and C<ZWNJ> characters. |
3ab3a109 |
119 | |
120 | =item * |
121 | |
122 | C<\X> will now always match at least one character, including an initial mark. |
123 | Marks generally come after a base character, but it is possible in Unicode to |
124 | have them in isolation, and C<\X> will now handle that case, for example at the |
b21d8e53 |
125 | beginning of a line, or after a C<ZWSP>. And this is the part where C<\X> |
3ab3a109 |
126 | doesn't match the things that it used to that don't make sense. Formerly, for |
127 | example, you could have the nonsensical case of an accented LF. |
128 | |
129 | =item * |
130 | |
131 | C<\X> will now match a (Korean) Hangul syllable sequence, and the Thai and Lao |
132 | exception cases. |
133 | |
134 | =back |
135 | |
136 | Otherwise, this change should be transparent for the non-affected languages. |
137 | |
138 | C<\p{...}> matches using the Canonical_Combining_Class property were |
139 | completely broken in previous Perls. This is now fixed. |
140 | |
141 | In previous Perls, the Unicode C<Decomposition_Type=Compat> property and a |
142 | Perl extension had the same name, which led to neither matching all the |
143 | correct values (with more than 100 mistakes in one, and several thousand |
144 | in the other). The Perl extension has now been renamed to be |
145 | C<Decomposition_Type=Noncanonical> (short: C<dt=noncanon>). It has the same |
146 | meaning as was previously intended, namely the union of all the |
147 | non-canonical Decomposition types, with Unicode C<Compat> being just one of |
148 | those. |
149 | |
150 | C<\p{Uppercase}> and C<\p{Lowercase}> have been brought into line with the |
151 | Unicode definitions. This means they each match a few more characters |
152 | than previously. |
153 | |
154 | C<\p{Cntrl}> now matches the same characters as C<\p{Control}>. This means it |
155 | no longer will match Private Use (gc=co), Surrogates (gc=cs), nor Format |
156 | (gc=cf) code points. The Format code points represent the biggest |
157 | possible problem. All but 36 of them are either officially deprecated |
158 | or strongly discouraged from being used. Of those 36, likely the most |
159 | widely used are the soft hyphen (U+00AD), and BOM, ZWSP, ZWNJ, WJ, and |
b21d8e53 |
160 | similar characters, plus bidirectional controls. |
3ab3a109 |
161 | |
162 | C<\p{Alpha}> now matches the same characters as C<\p{Alphabetic}>. The Perl |
163 | definition included a number of things that aren't really alpha (all |
164 | marks), while omitting many that were. As a direct consequence, the |
b21d8e53 |
165 | definitions of C<\p{Alnum}> and C<\p{Word}> which depend on Alpha also change |
166 | correspondingly. |
3ab3a109 |
167 | |
168 | C<\p{Word}> also now doesn't match certain characters it wasn't supposed |
169 | to, such as fractions. |
170 | |
171 | C<\p{Print}> no longer matches the line control characters: Tab, LF, CR, |
b21d8e53 |
172 | FF, VT, and NEL. This brings it in line with standards and the documentation. |
3ab3a109 |
173 | |
174 | C<\p{Decomposition_Type=Canonical}> now includes the Hangul syllables. |
175 | |
b21d8e53 |
176 | C<\p{XDigit}> now matches the same characters as C<\p{Hex_Digit}>. This |
177 | means that in addition to the characters it currently matches, |
178 | C<[A-Fa-f0-9]>, it will also match the 22 fullwidth equivalents, for |
179 | example U+FF10: FULLWIDTH DIGIT ZERO. |
180 | |
3ab3a109 |
181 | The Numeric type property has been extended to include the Unihan |
182 | characters. |
183 | |
184 | There is a new Perl extension, the 'Present_In', or simply 'In', |
185 | property. This is an extension of the Unicode Age property, but |
186 | C<\p{In=5.0}> matches any code point whose usage has been determined |
187 | I<as of> Unicode version 5.0. The C<\p{Age=5.0}> only matches code points |
188 | added in I<precisely> version 5.0. |
189 | |
190 | A number of properties did not have the correct values for unassigned |
191 | code points. This is now fixed. The affected properties are |
192 | Bidi_Class, East_Asian_Width, Joining_Type, Decomposition_Type, |
193 | Hangul_Syllable_Type, Numeric_Type, and Line_Break. |
194 | |
195 | The Default_Ignorable_Code_Point, ID_Continue, and ID_Start properties |
196 | have been updated to their current Unicode definitions. |
197 | |
198 | Certain properties that are supposed to be Unicode internal-only were |
199 | erroneously exposed by previous Perls. Use of these in regular |
200 | expressions will now generate, if enabled, a deprecated warning message. |
201 | The properties are: Other_Alphabetic, Other_Default_Ignorable_Code_Point, |
202 | Other_Grapheme_Extend, Other_ID_Continue, Other_ID_Start, Other_Lowercase, |
203 | Other_Math, and Other_Uppercase. |
204 | |
205 | An installation can now fairly easily change which Unicode properties |
206 | Perl understands. As mentioned above, certain properties are by default |
207 | turned off. These include all the Unihan properties (which should be |
208 | accessible via the CPAN module Unicode::Unihan) and any deprecated or |
209 | Unicode internal-only property that Perl has never exposed. |
210 | |
211 | The generated files in the C<lib/unicore/To> directory are now more |
212 | clearly marked as being stable, directly usable by applications. |
213 | New hash entries in them give the format of the normal entries, |
214 | which allows for easier machine parsing. Perl can generate files |
215 | in this directory for any property, though most are suppressed. An |
216 | installation can choose to change which get written. Instructions |
217 | are in L<perluniprops>. |
218 | |
219 | =head2 Regular Expressions |
220 | |
221 | U+0FFFF is now a legal character in regular expressions. |
222 | |
3ab3a109 |
223 | =head2 A proper interface for pluggable Method Resolution Orders |
224 | |
225 | As of Perl 5.11.0 there is a new interface for plugging and using method |
226 | resolution orders other than the default (linear depth first search). |
227 | The C3 method resolution order added in 5.10.0 has been re-implemented as |
228 | a plugin, without changing its Perl-space interface. See L<perlmroapi> for |
229 | more information. |
230 | |
231 | =head2 The C<overloading> pragma |
232 | |
233 | This pragma allows you to lexically disable or enable overloading |
234 | for some or all operations. (Yuval Kogman) |
235 | |
b3b85878 |
236 | =head2 C<\N> experimental regex escape |
3ab3a109 |
237 | |
238 | A new regex escape has been added, C<\N>. It will match any character that |
239 | is not a newline, independently from the presence or absence of the single |
ff3f963a |
240 | line match modifier C</s>. It is not usable within a character class. |
df225385 |
241 | C<\N{3}> means to match 3 non-newlines; C<\N{5,}> means to match at least 5. |
242 | C<\N{NAME}> still means the character or sequence named C<NAME>, but C<NAME> no |
243 | longer can be things like C<3>, or C<5,>. |
244 | Compatibility with Unicode names is preserved, as none look like these, but it |
245 | has been possible to create custom names that do look like them, and those will |
246 | no longer work. (Rafael Garcia-Suarez) |
3ab3a109 |
247 | |
b21d8e53 |
248 | This will break a L<custom charnames translator|charnames/CUSTOM TRANSLATORS> |
249 | which allows numbers for character names, as C<\N{3}> will now mean to match 3 |
250 | non-newline characters, and not the character whose name is C<3>. (No standard |
251 | name is a number, so only a custom translator would be affected.) |
252 | |
b3b85878 |
253 | This escape is experimental, subject to change, because there is some concern |
254 | about possible confusion with the previous meaning of C<\N{...}> |
255 | |
5e75e599 |
256 | =head2 \N{...} now compiles better, always forces UTF-8 internal representation. |
257 | |
258 | There were several problems that have been fixed with recognizing C<\N{...}> |
259 | constructs. As part of this, any scalar or regex that has either a |
260 | C<\N{I<name>}> or C<\N{U+I<wide hex char>}> in its definition will be stored in |
261 | UTF-8 format. (This was true previously for all occurences of C<\N{I<name>}> |
262 | that did not use a custom translator, but now it's always true.) |
263 | |
3ab3a109 |
264 | =head2 Implicit strictures |
265 | |
266 | Using the C<use VERSION> syntax with a version number greater or equal |
267 | to 5.11.0 will also lexically enable strictures just like C<use strict> |
268 | would do (in addition to enabling features.) So, the following: |
269 | |
270 | use 5.11.0; |
271 | |
272 | will now imply: |
273 | |
274 | use strict; |
275 | use feature ':5.11'; |
276 | |
277 | =head2 Parallel tests |
278 | |
279 | The core distribution can now run its regression tests in parallel on |
280 | Unix-like platforms. Instead of running C<make test>, set C<TEST_JOBS> in |
281 | your environment to the number of tests to run in parallel, and run |
282 | C<make test_harness>. On a Bourne-like shell, this can be done as |
283 | |
284 | TEST_JOBS=3 make test_harness # Run 3 tests in parallel |
285 | |
286 | An environment variable is used, rather than parallel make itself, because |
287 | L<TAP::Harness> needs to be able to schedule individual non-conflicting test |
288 | scripts itself, and there is no standard interface to C<make> utilities to |
289 | interact with their job schedulers. |
290 | |
291 | Note that currently some test scripts may fail when run in parallel (most |
292 | notably C<ext/IO/t/io_dir.t>). If necessary run just the failing scripts |
293 | again sequentially and see if the failures go away. |
294 | |
295 | =head2 The C<...> operator |
296 | |
297 | A new operator, C<...>, nicknamed the Yada Yada operator, has been added. |
c66407fa |
298 | It is intended to mark placeholder code that is not yet implemented. |
3ab3a109 |
299 | See L<perlop/"Yada Yada Operator">. (chromatic) |
300 | |
301 | =head2 DTrace support |
302 | |
303 | Some support for DTrace has been added. See "DTrace support" in F<INSTALL>. |
304 | |
305 | =head2 Support for C<configure_requires> in CPAN module metadata |
306 | |
307 | Both C<CPAN> and C<CPANPLUS> now support the C<configure_requires> keyword |
308 | in the F<META.yml> metadata file included in most recent CPAN distributions. |
309 | This allows distribution authors to specify configuration prerequisites that |
310 | must be installed before running F<Makefile.PL> or F<Build.PL>. |
311 | |
312 | See the documentation for C<ExtUtils::MakeMaker> or C<Module::Build> for more |
313 | on how to specify C<configure_requires> when creating a distribution for CPAN. |
314 | |
315 | =head2 C<each> is now more flexible |
316 | |
317 | The C<each> function can now operate on arrays. |
318 | |
319 | =head2 Y2038 compliance |
320 | |
321 | Perl's core time-related functions are now Y2038 compliant. (With 29 |
322 | years to spare!) |
323 | |
324 | =head2 C<$,> flexibility |
325 | |
326 | The variable C<$,> may now be tied. |
327 | |
328 | =head2 // in where clauses |
329 | |
330 | // now behaves like || in when clauses |
331 | |
332 | =head2 Enabling warnings from your shell environment |
333 | |
334 | You can now set C<-W> from the C<PERL5OPT> environment variable |
335 | |
336 | =head2 C<delete local> |
337 | |
338 | C<delete local> now allows you to locally delete a hash entry. |
339 | |
340 | =head2 New support for Abstract namespace sockets |
341 | |
342 | Abstract namespace sockets are Linux-specific socket type that live in |
343 | AF_UNIX family, slightly abusing it to be able to use arbitrary |
344 | character arrays as addresses: They start with nul byte and are not |
345 | terminated by nul byte, but with the length passed to the socket() |
346 | system call. |
347 | |
252eec4f |
348 | =head2 New C<package NAME VERSION> syntax |
3ab3a109 |
349 | |
350 | This new syntax allows a module author to set the $VERSION of a namespace |
351 | when the namespace is declared with 'package'. It eliminates the need |
352 | for C<our $VERSION = ...> and similar constructs. E.g. |
353 | |
354 | package Foo::Bar 1.23; |
355 | # $Foo::Bar::VERSION == 1.23 |
356 | |
357 | There are several advantages to this: |
358 | |
359 | =over |
360 | |
361 | =item * |
362 | |
252eec4f |
363 | C<$VERSION> is parsed in exactly the same way as C<use NAME VERSION> |
3ab3a109 |
364 | |
365 | =item * |
366 | |
367 | C<$VERSION> is set at compile time |
368 | |
369 | =item * |
370 | |
252eec4f |
371 | C<$VERSION> is a version object that provides proper overloading of |
372 | comparision operators so comparing C<$VERSION> to decimal (1.23) or |
373 | dotted-decimal (v1.2.3) version numbers works correctly. |
374 | |
375 | =item * |
376 | |
3ab3a109 |
377 | Eliminates C<$VERSION = ...> and C<eval $VERSION> clutter |
378 | |
379 | =item * |
380 | |
381 | As it requires VERSION to be a numeric literal or v-string |
382 | literal, it can be statically parsed by toolchain modules |
383 | without C<eval> the way MM-E<gt>parse_version does for C<$VERSION = ...> |
384 | |
385 | =item * |
386 | |
3ab3a109 |
387 | It does not break old code with only C<package NAME>, but code that uses |
252eec4f |
388 | C<package NAME VERSION> will need to be restricted to perl 5.12.0 or newer |
3ab3a109 |
389 | This is analogous to the change to C<open> from two-args to three-args. |
252eec4f |
390 | Users requiring the latest Perl will benefit, and perhaps after several |
391 | years, it will become a standard practice. |
3ab3a109 |
392 | |
393 | =back |
394 | |
252eec4f |
395 | However, C<package NAME VERSION> requires a new, 'strict' version |
396 | number format. See L<"Version number formats"> for details. |
397 | |
3ab3a109 |
398 | =head1 Incompatible Changes |
399 | |
400 | =head2 Version number formats |
401 | |
402 | Acceptable version number formats have been formalized into "strict" and |
fab55263 |
403 | "lax" rules. C<package NAME VERSION> takes a strict version number. |
404 | C<UNIVERSAL::VERSION> and the L<version> object constructors take lax |
405 | version numbers. Providing an invalid version will result in a fatal |
406 | error. The version argument in C<use NAME VERSION> is first parsed as a |
407 | numeric literal or v-string and then passed to C<UNIVERSAL::VERSION> |
408 | (and must then pass the "lax" format test). |
409 | |
410 | These formats are documented fully in the L<version> module. To a first |
411 | approximation, a "strict" version number is a positive decimal number |
412 | (integer or decimal-fraction) without exponentiation or else a |
413 | dotted-decimal v-string with a leading 'v' character and at least three |
414 | components. A "lax" version number allows v-strings with fewer than |
415 | three components or without a leading 'v'. Under "lax" rules, both |
416 | decimal and dotted-decimal versions may have a trailing "alpha" |
417 | component separated by an underscore character after a fractional or |
418 | dotted-decimal component. |
3ab3a109 |
419 | |
420 | The L<version> module adds C<version::is_strict> and C<version::is_lax> |
421 | functions to check a scalar against these rules. |
422 | |
c66407fa |
423 | =head2 @INC reorganization |
3ab3a109 |
424 | |
425 | In @INC, ARCHLIB and PRIVLIB now occur after after the current version's |
426 | site_perl and vendor_perl. |
427 | |
428 | =head2 Switch statement changes |
429 | |
430 | The handling of complex expressions by the C<given>/C<when> switch |
431 | statement has been enhanced. These enhancements are also available in |
c66407fa |
432 | 5.10.1 and subsequent 5.10 releases. There are two new cases where |
433 | C<when> now interprets its argument as a boolean, instead of an |
434 | expression to be used in a smart match: |
3ab3a109 |
435 | |
436 | =head2 flip-flop operators |
437 | |
438 | The C<..> and C<...> flip-flop operators are now evaluated in boolean |
439 | context, following their usual semantics; see L<perlop/"Range Operators">. |
440 | |
441 | Note that, as in perl 5.10.0, C<when (1..10)> will not work to test |
442 | whether a given value is an integer between 1 and 10; you should use |
443 | C<when ([1..10])> instead (note the array reference). |
444 | |
445 | However, contrary to 5.10.0, evaluating the flip-flop operators in boolean |
446 | context ensures it can now be useful in a C<when()>, notably for |
447 | implementing bistable conditions, like in: |
448 | |
449 | when (/^=begin/ .. /^=end/) { |
450 | # do something |
451 | } |
452 | |
453 | =head2 defined-or operator |
454 | |
455 | A compound expression involving the defined-or operator, as in |
456 | C<when (expr1 // expr2)>, will be treated as boolean if the first |
457 | expression is boolean. (This just extends the existing rule that applies |
458 | to the regular or operator, as in C<when (expr1 || expr2)>.) |
459 | |
460 | =head2 Smart match changes |
461 | |
462 | This section details more changes brought to the semantics to |
463 | the smart match operator, that naturally also modify the behaviour |
464 | of the switch statements where smart matching is implicitly used. |
c66407fa |
465 | These changes were also made for the 5.10.1 release, and will remain in |
3ab3a109 |
466 | subsequent 5.10 releases. |
467 | |
3ab3a109 |
468 | =head3 Changes to type-based dispatch |
469 | |
470 | The smart match operator C<~~> is no longer commutative. The behaviour of |
471 | a smart match now depends primarily on the type of its right hand |
472 | argument. Moreover, its semantics have been adjusted for greater |
473 | consistency or usefulness in several cases. While the general backwards |
474 | compatibility is maintained, several changes must be noted: |
475 | |
476 | =over 4 |
477 | |
478 | =item * |
479 | |
480 | Code references with an empty prototype are no longer treated specially. |
481 | They are passed an argument like the other code references (even if they |
482 | choose to ignore it). |
483 | |
484 | =item * |
485 | |
486 | C<%hash ~~ sub {}> and C<@array ~~ sub {}> now test that the subroutine |
487 | returns a true value for each key of the hash (or element of the |
488 | array), instead of passing the whole hash or array as a reference to |
489 | the subroutine. |
490 | |
491 | =item * |
492 | |
493 | Due to the commutativity breakage, code references are no longer |
494 | treated specially when appearing on the left of the C<~~> operator, |
495 | but like any vulgar scalar. |
496 | |
497 | =item * |
498 | |
499 | C<undef ~~ %hash> is always false (since C<undef> can't be a key in a |
500 | hash). No implicit conversion to C<""> is done (as was the case in perl |
501 | 5.10.0). |
502 | |
503 | =item * |
504 | |
505 | C<$scalar ~~ @array> now always distributes the smart match across the |
506 | elements of the array. It's true if one element in @array verifies |
507 | C<$scalar ~~ $element>. This is a generalization of the old behaviour |
508 | that tested whether the array contained the scalar. |
509 | |
510 | =back |
511 | |
512 | The full dispatch table for the smart match operator is given in |
513 | L<perlsyn/"Smart matching in detail">. |
514 | |
515 | =head3 Smart match and overloading |
516 | |
517 | According to the rule of dispatch based on the rightmost argument type, |
518 | when an object overloading C<~~> appears on the right side of the |
519 | operator, the overload routine will always be called (with a 3rd argument |
520 | set to a true value, see L<overload>.) However, when the object will |
521 | appear on the left, the overload routine will be called only when the |
c66407fa |
522 | rightmost argument is a simple scalar. This way, distributivity of smart |
523 | match across arrays is not broken, as well as the other behaviours with |
524 | complex types (coderefs, hashes, regexes). Thus, writers of overloading |
525 | routines for smart match mostly need to worry only with comparing |
526 | against a scalar, and possibly with stringification overloading; the |
527 | other common cases will be automatically handled consistently. |
3ab3a109 |
528 | |
529 | C<~~> will now refuse to work on objects that do not overload it (in order |
530 | to avoid relying on the object's underlying structure). (However, if the |
531 | object overloads the stringification or the numification operators, and |
532 | if overload fallback is active, it will be used instead, as usual.) |
533 | |
534 | =head2 Labels can't be keywords |
535 | |
536 | Labels used as targets for the C<goto>, C<last>, C<next> or C<redo> |
537 | statements cannot be keywords anymore. This restriction will prevent |
538 | potential confusion between the C<goto LABEL> and C<goto EXPR> syntaxes: |
539 | for example, a statement like C<goto print> would jump to a label whose |
540 | name would be the return value of C<print()>, (usually 1), instead of a |
541 | label named C<print>. Moreover, the other control flow statements |
542 | would just ignore any keyword passed to them as a label name. Since |
543 | such labels cannot be defined anymore, this kind of error will be |
544 | avoided. |
545 | |
546 | =head2 Other incompatible changes |
547 | |
548 | =over 4 |
549 | |
550 | =item * |
551 | |
b21d8e53 |
552 | The definitions of a number of Unicode properties have changed to match those |
553 | of the current Unicode standard. These are listed above under L</Unicode |
adbcfde0 |
554 | properties>. This could break code that is expecting the old definitions. |
3ab3a109 |
555 | |
556 | =item * |
557 | |
b21d8e53 |
558 | The boolkeys op moved to the group of hash ops. This breaks binary |
559 | compatibility. |
c66407fa |
560 | |
561 | =item * |
562 | |
563 | Filehandles are blessed directly into C<IO::Handle>, as C<FileHandle> is |
564 | merely a wrapper around C<IO::Handle>. |
565 | |
566 | The previous behaviour was to bless Filehandles into L<FileHandle> |
567 | (an empty proxy class) if it was loaded into memory and otherwise |
568 | to bless them into C<IO::Handle>. |
569 | |
570 | =item * |
571 | |
572 | The semantics of C<use feature :5.10*> have changed slightly. |
573 | See L<"Modules and Pragmata"> for more information. |
3ab3a109 |
574 | |
575 | =item * |
576 | |
577 | The version control system used for the development of the perl |
578 | interpreter has been switched from Perforce to git. This is mainly an |
579 | internal issue that only affects people actively working on the perl core; |
580 | but it may have minor external visibility, for example in some of details |
581 | of the output of C<perl -V>. See L<perlrepository> for more information. |
582 | |
583 | =item * |
584 | |
585 | The internal structure of the C<ext/> directory in the perl source has |
586 | been reorganised. In general, a module C<Foo::Bar> whose source was |
587 | stored under F<ext/Foo/Bar/> is now located under F<ext/Foo-Bar/>. Also, |
588 | nearly all dual-life modules have been moved from F<lib/> to F<ext/>. This |
589 | is purely a source tarball change, and should make no difference to the |
590 | compilation or installation of perl, unless you have a very customised build |
591 | process that explicitly relies on this structure, or which hard-codes the |
592 | C<nonxs_ext> F<Configure> parameter. Specifically, this change does not by |
593 | default alter the location of any files in the final installation. |
594 | |
595 | =item * |
596 | |
597 | As part of the C<Test::Harness> 2.x to 3.x upgrade, the experimental |
598 | C<Test::Harness::Straps> module has been removed. |
599 | See L</"Updated Modules"> for more details. |
600 | |
601 | =item * |
602 | |
603 | As part of the C<ExtUtils::MakeMaker> upgrade, the |
604 | C<ExtUtils::MakeMaker::bytes> and C<ExtUtils::MakeMaker::vmsish> modules |
605 | have been removed from this distribution. |
606 | |
607 | =item * |
608 | |
609 | C<Module::CoreList> no longer contains the C<%:patchlevel> hash. |
610 | |
611 | =item * |
612 | |
613 | This one is actually a change introduced in 5.10.0, but it was missed |
614 | from that release's perldelta, so it is mentioned here instead. |
615 | |
616 | A bugfix related to the handling of the C</m> modifier and C<qr> resulted |
617 | in a change of behaviour between 5.8.x and 5.10.0: |
618 | |
619 | # matches in 5.8.x, doesn't match in 5.10.0 |
620 | $re = qr/^bar/; "foo\nbar" =~ /$re/m; |
621 | |
622 | =item * |
623 | |
624 | C<length undef> now returns undef. |
625 | |
626 | =item * |
627 | |
628 | Unsupported private C API functions are now declared "static" to prevent |
629 | leakage to Perl's public API. |
630 | |
631 | =item * |
632 | |
633 | To support the bootstrapping process, F<miniperl> no longer builds with |
634 | UTF-8 support in the regexp engine. |
635 | |
636 | This allows a build to complete with PERL_UNICODE set and a UTF-8 locale. |
637 | Without this there's a bootstrapping problem, as miniperl can't load the UTF-8 |
638 | components of the regexp engine, because they're not yet built. |
639 | |
640 | =item * |
641 | |
c66407fa |
642 | F<miniperl>'s @INC is now restricted to just C<-I...>, the split of |
643 | C<$ENV{PERL5LIB}>, and "C<.>" |
3ab3a109 |
644 | |
645 | =item * |
646 | |
647 | A space or a newline is now required after a C<"#line XXX"> directive. |
648 | |
649 | =item * |
650 | |
651 | Tied filehandles now have an additional method EOF which provides the EOF type |
652 | |
653 | =item * |
654 | |
c66407fa |
655 | To better match all other flow control statements, C<foreach> may no |
656 | longer be used as an attribute. |
3ab3a109 |
657 | |
658 | =back |
659 | |
660 | =head1 Deprecations |
661 | |
662 | From time to time, Perl's developers find it necessary to deprecate |
663 | features or modules we've previously shipped as part of the core |
664 | distribution. We are well aware of the pain and frustration that a |
665 | backwards-incompatible change to Perl can cause for developers building |
666 | or maintaining software in Perl. You can be sure that when we deprecate |
667 | a functionality or syntax, it isn't a choice we make lightly. Sometimes, |
668 | we choose to deprecate functionality or syntax because it was found to |
669 | be poorly designed or implemented. Sometimes, this is because they're |
670 | holding back other features or causing performance problems. Sometimes, |
671 | the reasons are more complex. Wherever possible, we try to keep deprecated |
672 | functionality available to developers in its previous form for at least |
673 | one major release. So long as a deprecated feature isn't actively |
674 | disrupting our ability to maintain and extend Perl, we'll try to leave |
675 | it in place as long as possible. |
676 | |
677 | The following items are now deprecated. |
678 | |
679 | =over 4 |
680 | |
681 | =item Use of C<:=> to mean an empty attribute list is now deprecated. |
682 | |
683 | An accident of Perl's parser meant that these constructions were all |
684 | equivalent: |
685 | |
686 | my $pi := 4; |
687 | my $pi : = 4; |
688 | my $pi : = 4; |
689 | |
690 | with the C<:> being treated as the start of an attribute list, which |
691 | ends before the C<=>. As whitespace is not significant here, all are |
692 | parsed as an empty attribute list, hence all the above are equivalent |
693 | to, and better written as |
694 | |
695 | my $pi = 4; |
696 | |
697 | because no attribute processing is done for an empty list. |
698 | |
699 | As is, this meant that C<:=> cannot be used as a new token, without |
700 | silently changing the meaning of existing code. Hence that particular |
701 | form is now deprecated, and will become a syntax error. If it is |
702 | absolutely necessary to have empty attribute lists (for example, |
703 | because of a code generator) then avoid the warning by adding a space |
704 | before the C<=>. |
705 | |
c66407fa |
706 | =item C<< UNIVERSAL->import() >> |
3ab3a109 |
707 | |
c66407fa |
708 | The method C<< UNIVERSAL->import() >> is now deprecated. Attempting to |
3ab3a109 |
709 | pass import arguments to a C<use UNIVERSAL> statement will result in a |
c66407fa |
710 | deprecation warning. |
3ab3a109 |
711 | |
712 | =item Use of "goto" to jump into a construct is deprecated |
713 | |
c66407fa |
714 | Using C<goto> to jump from an outer scope into an inner scope is now |
715 | deprecated. This rare use case was causing problems in the |
716 | implementation of scopes. |
3ab3a109 |
717 | |
8c66a230 |
718 | =item Custom character names in \N{name} should look like names |
719 | |
720 | In C<\N{I<name>}>, I<name> can be just about anything. The standard Unicode |
721 | names have a very limited domain, but a custom name translator could create |
722 | names that are, for example, made up entirely of punctuation symbols. It is |
723 | now deprecated to make names that don't begin with an alphabetic character, and |
724 | aren't alphanumeric or contain other than a very few other characters, |
725 | namely spaces, dashes, parentheses and colons. Because of the added meaning of |
726 | C<\N> (See L</C<\N> experimental regex escape>), names that look like curly |
727 | brace -enclosed quantifiers won't work. For example, C<\N{3,4}> now means to |
728 | match 3 to 4 non-newlines; before a custom name C<3,4> could have been created. |
729 | |
3ab3a109 |
730 | =item Deprecated Modules |
731 | |
732 | The following modules will be removed from the core distribution in a future |
733 | release, and should be installed from CPAN instead. Distributions on CPAN |
734 | which require these should add them to their prerequisites. The core versions |
735 | of these modules warnings will issue a deprecation warning. |
736 | |
8df7d2a3 |
737 | If you ship a packaged version of Perl, either alone or as part of a larger |
738 | system, then you should carefully consider the reprecussions of core module |
739 | deprecations. You may want to consider shipping your default build of |
740 | Perl with packages for some or all deprecated modules which install into |
741 | C<vendor> or C<site> perl library directories. This will inhibit the |
742 | deprecation warnings. |
743 | |
744 | Alternatively, you may want to consider patching F<lib/deprecate.pm> |
745 | to provide deprecation warnings specific to your packaging system or |
746 | distribution of Perl. |
747 | |
3ab3a109 |
748 | =over |
749 | |
c66407fa |
750 | =item L<Class::ISA> |
751 | |
752 | =item L<Pod::Plainer> |
753 | |
754 | =item L<Shell> |
3ab3a109 |
755 | |
c66407fa |
756 | =item L<Switch> |
3ab3a109 |
757 | |
c66407fa |
758 | Switch is buggy and should be avoided. See L<perlsyn/"Switch |
759 | statements"> for its replacement. |
3ab3a109 |
760 | |
761 | =back |
762 | |
763 | =item suidperl |
764 | |
765 | C<suidperl> has been removed. It used to provide a mechanism to |
766 | emulate setuid permission bits on systems that don't support it properly. |
767 | |
768 | =item Assignment to $[ |
769 | |
770 | =item attrs |
771 | |
772 | Remove attrs, which has been deprecated since 1999-10-02. |
773 | |
774 | =item Use of the attribute :locked on subroutines. |
775 | |
776 | =item Use of "locked" with the attributes pragma. |
777 | |
778 | =item Use of "unique" with the attributes pragma. |
779 | |
780 | =item Numerous Perl 4-era libraries: |
781 | |
782 | F<termcap.pl>, F<tainted.pl>, F<stat.pl>, F<shellwords.pl>, F<pwd.pl>, |
783 | F<open3.pl>, F<open2.pl>, F<newgetopt.pl>, F<look.pl>, F<find.pl>, |
784 | F<finddepth.pl>, F<importenv.pl>, F<hostname.pl>, F<getopts.pl>, |
785 | F<getopt.pl>, F<getcwd.pl>, F<flush.pl>, F<fastcwd.pl>, F<exceptions.pl>, |
786 | F<ctime.pl>, F<complete.pl>, F<cacheout.pl>, F<bigrat.pl>, F<bigint.pl>, |
787 | F<bigfloat.pl>, F<assert.pl>, F<abbrev.pl>, F<dotsh.pl>, and |
788 | F<timelocal.pl> are all now deprecated. Using them will incur a warning. |
789 | |
790 | =back |
791 | |
792 | =head1 Modules and Pragmata |
793 | |
794 | =head2 Dual-lifed modules moved |
795 | |
796 | Dual-lifed modules maintained primarily in the Perl core now live in dist/. |
797 | Dual-lifed modules maintained primarily on CPAN now live in cpan/ |
798 | |
799 | In previous releases of Perl, it was customary to enumerate all module |
c66407fa |
800 | changes in this section of the C<perldelta> file. From 5.11.0 forward |
801 | only notable updates (such as new or deprecated modules ) will be listed |
802 | in this section. For a complete reference to the versions of modules |
803 | shipped in a given release of perl, please see L<Module::CoreList>. |
3ab3a109 |
804 | |
805 | =head2 New Modules and Pragmata |
806 | |
807 | =over 4 |
808 | |
809 | =item * |
810 | |
811 | C<autodie> |
812 | |
813 | This is a new lexically-scoped alternative for the C<Fatal> module. |
814 | The bundled version is 2.06_01. Note that in this release, using a string |
815 | eval when C<autodie> is in effect can cause the autodie behaviour to leak |
816 | into the surrounding scope. See L<autodie/"BUGS"> for more details. |
817 | |
818 | =item * |
819 | |
820 | C<Compress::Raw::Bzip2> |
821 | |
822 | This has been added to the core (version 2.020). |
823 | |
824 | =item * |
825 | |
826 | C<parent> |
827 | |
828 | This pragma establishes an ISA relationship with base classes at compile |
c66407fa |
829 | time. It provides the key feature of C<base> without further unwanted |
830 | behaviors. |
3ab3a109 |
831 | |
832 | =item * |
833 | |
834 | C<Parse::CPAN::Meta> |
835 | |
836 | This has been added to the core (version 1.39). |
837 | |
838 | =back |
839 | |
840 | =head2 Pragmata Changes |
841 | |
842 | =over 4 |
843 | |
844 | =item * |
845 | |
846 | C<overloading> |
847 | |
848 | See L</"The C<overloading> pragma"> above. |
849 | |
850 | =item * |
851 | |
852 | C<attrs> |
853 | |
854 | The C<attrs> pragma has been removed. It had been marked as deprecated since |
855 | 5.6.0. |
856 | |
857 | =item * |
858 | |
859 | C<charnames> |
860 | |
861 | The Unicode F<NameAliases.txt> database file has been added. This has the |
862 | effect of adding some extra C<\N> character names that formerly wouldn't |
863 | have been recognised; for example, C<"\N{LATIN CAPITAL LETTER GHA}">. |
864 | |
865 | =item * |
866 | |
867 | C<feature> |
868 | |
869 | The meaning of the C<:5.10> and C<:5.10.X> feature bundles has |
870 | changed slightly. The last component, if any (i.e. C<X>) is simply ignored. |
871 | This is predicated on the assumption that new features will not, in |
872 | general, be added to maintenance releases. So C<:5.10> and C<:5.10.X> |
873 | have identical effect. This is a change to the behaviour documented for |
874 | 5.10.0. |
875 | |
876 | =item * |
877 | |
878 | C<mro> |
879 | |
880 | Upgraded from version 1.00 to 1.01. Performance for single inheritance is 40% |
881 | faster - see L</"Performance Enhancements"> below. |
882 | |
883 | C<mro> is now implemented as an XS extension. The documented interface has not |
884 | changed. Code relying on the implementation detail that some C<mro::> |
885 | methods happened to be available at all times gets to "keep both pieces". |
886 | |
887 | =item * |
888 | |
889 | C<diagnostics> |
890 | |
891 | Supports %.0f formatting internally. |
892 | |
893 | =item * |
894 | |
895 | C<overload> |
896 | |
897 | Allow overloading of 'qr'. |
898 | |
899 | =item * |
900 | |
901 | C<constant> |
902 | |
903 | Upgraded from version 1.19 to 1.20. |
904 | |
905 | =item * |
906 | |
907 | C<diagnostics> |
908 | |
c66407fa |
909 | This pragma no longer suppresses C<Use of uninitialized value in range |
910 | (or flip)> warnings. [perl #71204] |
3ab3a109 |
911 | |
912 | =item * |
913 | |
914 | C<feature> |
915 | |
916 | Upgraded from 1.13 to 1.14. Added the C<unicode_strings> feature: |
917 | |
918 | use feature "unicode_strings"; |
919 | |
920 | This pragma turns on Unicode semantics for the case-changing operations |
c66407fa |
921 | (C<uc>, C<lc>, C<ucfirst>, C<lcfirst>) on strings that don't have the |
922 | internal UTF-8 flag set, but that contain single-byte characters between |
923 | 128 and 255. |
3ab3a109 |
924 | |
925 | =item * |
926 | |
927 | C<threads> |
928 | |
929 | Upgraded from version 1.74 to 1.75. |
930 | |
931 | =item * |
932 | |
933 | C<less> |
934 | |
c66407fa |
935 | Upgraded from version 0.02 to 0.03. |
3ab3a109 |
936 | |
c66407fa |
937 | This version introduces the C<stash_name> method to allow subclasses of |
938 | C<less> to pick where in %^H to store their stash. |
3ab3a109 |
939 | |
940 | =item * |
941 | |
942 | C<version> |
943 | |
944 | Upgraded from version 0.77 to 0.81. |
945 | |
946 | This version adds support for L</Version number formats> as described earlier |
947 | in this document and in its own documentation. |
948 | |
949 | =item * |
950 | |
951 | C<warnings> |
952 | |
953 | Upgraded from 1.07 to 1.09. |
954 | |
955 | Added new C<warnings::fatal_enabled()> function. |
956 | This version adds the C<illegalproto> warning category. See also L</New or |
957 | Changed Diagnostics> for this change. |
958 | |
959 | =back |
960 | |
961 | |
962 | =head2 Updated Modules |
963 | |
964 | =over 4 |
965 | |
966 | =item XXX TODO RECALCULATE THIS VS 5.10.0 |
967 | |
968 | =back |
969 | |
970 | =head2 Removed Modules and Pragmata |
971 | |
972 | =over 4 |
973 | |
974 | =item * |
975 | |
976 | C<Devel::DProf::V> |
977 | |
978 | Removed from the Perl core. Prior version was 'undef'. |
979 | |
980 | =back |
981 | |
982 | =head1 Documentation |
983 | |
984 | =head2 New Documentation |
985 | |
986 | =over 4 |
987 | |
988 | =item * |
989 | |
990 | L<perlhaiku> |
991 | |
992 | This contains instructions on how to build perl for the Haiku platform. |
993 | |
994 | =item * |
995 | |
996 | L<perlmroapi> |
997 | |
998 | This describes the new interface for pluggable Method Resolution Orders. |
999 | |
1000 | =item * |
1001 | |
1002 | L<perlperf> |
1003 | |
1004 | This document, by Richard Foley, provides an introduction to the use of |
1005 | performance and optimization techniques which can be used with particular |
1006 | reference to perl programs. |
1007 | |
1008 | =item * |
1009 | |
1010 | L<perlrepository> |
1011 | |
1012 | This describes how to access the perl source using the I<git> version |
1013 | control system. |
1014 | |
1015 | =item * |
1016 | |
1017 | L<perlpolicy> extends the "Social contract about contributed modules" into |
1018 | the beginnings of a document on Perl porting policies. |
1019 | |
1020 | =back |
1021 | |
1022 | =head2 Changes to Existing Documentation |
1023 | |
1024 | The various large F<Changes*> files (which listed every change made to perl |
1025 | over the last 18 years) have been removed, and replaced by a small file, |
1026 | also called F<Changes>, which just explains how that same information may |
1027 | be extracted from the git version control system. |
1028 | |
1029 | The file F<Porting/patching.pod> has been deleted, as it mainly described |
1030 | interacting with the old Perforce-based repository, which is now obsolete. |
1031 | Information still relevant has been moved to L<perlrepository>. |
1032 | |
1033 | L<perlapi>, L<perlintern>, L<perlmodlib> and L<perltoc> are now all |
1034 | generated at build time, rather than being shipped as part of the release. |
1035 | |
1036 | =over |
1037 | |
1038 | =item * |
1039 | |
1040 | Documented -X overloading. |
1041 | |
1042 | =item * |
1043 | |
1044 | Documented that C<when()> treats specially most of the filetest operators |
1045 | |
1046 | =item * |
1047 | |
c66407fa |
1048 | Documented C<when> as a syntax modifier |
3ab3a109 |
1049 | |
1050 | =item * |
1051 | |
c66407fa |
1052 | Eliminated "Old Perl threads tutorial", which described 5005 threads. |
3ab3a109 |
1053 | |
1054 | F<pod/perlthrtut.pod> is the same material reworked for ithreads. |
1055 | |
1056 | =item * |
1057 | |
1058 | Correct previous documentation: v-strings are not deprecated |
1059 | |
1060 | With version objects, we need them to use MODULE VERSION syntax. This |
c66407fa |
1061 | patch removes the deprecation notice. |
3ab3a109 |
1062 | |
1063 | =item * |
1064 | |
1065 | Added security contact information to L<perlsec> |
1066 | |
1067 | A significant fraction of the core documentation has been updated to clarify |
1068 | the behavior of Perl's Unicode handling. |
1069 | |
1070 | Much of the remaining core documentation has been reviewed and edited |
1071 | for clarity, consistent use of language, and to fix the spelling of Tom |
1072 | Christiansen's name. |
1073 | |
1074 | The Pod specification (L<perlpodspec>) has been updated to bring the |
c66407fa |
1075 | specification in line with modern usage already supported by most Pod |
1076 | systems. A parameter string may now follow the format name in a |
1077 | "begin/end" region. Links to URIs with a text description are now |
1078 | allowed. The usage of C<LE<lt>"section"E<gt>> has been marked as |
1079 | deprecated. |
3ab3a109 |
1080 | |
1081 | L<if.pm|if> has been documented in L<perlfunc/use> as a means to get |
c66407fa |
1082 | conditional loading of modules despite the implicit BEGIN block around |
1083 | C<use>. |
3ab3a109 |
1084 | |
1085 | =item * |
1086 | |
c66407fa |
1087 | The documentation for C<$1> in perlvar.pod has been clarified. |
3ab3a109 |
1088 | |
1089 | =back |
1090 | |
1091 | =head1 Performance Enhancements |
1092 | |
1093 | =over 4 |
1094 | |
1095 | =item * |
1096 | |
1097 | A new internal cache means that C<isa()> will often be faster. |
1098 | |
1099 | =item * |
1100 | |
1101 | The implementation of C<C3> Method Resolution Order has been optimised - |
1102 | linearisation for classes with single inheritance is 40% faster. Performance |
1103 | for multiple inheritance is unchanged. |
1104 | |
1105 | =item * |
1106 | |
1107 | Under C<use locale>, the locale-relevant information is now cached on |
1108 | read-only values, such as the list returned by C<keys %hash>. This makes |
1109 | operations such as C<sort keys %hash> in the scope of C<use locale> much |
1110 | faster. |
1111 | |
1112 | =item * |
1113 | |
1114 | Empty C<DESTROY> methods are no longer called. |
1115 | |
1116 | =item * |
1117 | |
1118 | Faster C<Perl_sv_utf8_upgrade()> |
1119 | |
1120 | =item * |
1121 | |
1122 | Speed up C<keys> on empty hash |
1123 | |
1124 | =item * |
1125 | |
1126 | C<if (%foo)> has been optimized to be faster than C<if (keys %foo)> |
1127 | |
1128 | =item * |
1129 | |
1130 | Reversing an array to itself (as in C<@a = reverse @a>) in void context |
1131 | now happens in-place and is several orders of magnitude faster than it |
1132 | used to be. It will also preserve non-existent elements whenever |
1133 | possible, i.e. for non magical arrays or tied arrays with C<EXISTS> and |
1134 | C<DELETE> methods. |
1135 | |
1136 | =back |
1137 | |
1138 | =head1 Installation and Configuration Improvements |
1139 | |
1140 | =head2 F<ext/> reorganisation |
1141 | |
1142 | The layout of directories in F<ext> has been revised. Specifically, all |
1143 | extensions are now flat, and at the top level, with C</> in pathnames |
1144 | replaced by C<->, so that F<ext/Data/Dumper/> is now F<ext/Data-Dumper/>, |
1145 | etc. The names of the extensions as specified to F<Configure>, and as |
1146 | reported by C<%Config::Config> under the keys C<dynamic_ext>, |
1147 | C<known_extensions>, C<nonxs_ext> and C<static_ext> have not changed, and |
1148 | still use C</>. Hence this change will not have any affect once perl is |
1149 | installed. C<Safe> has been split out from being part of C<Opcode>, and |
1150 | C<mro> is now an extension in its own right. |
1151 | |
1152 | Nearly all dual-life modules have been moved from F<lib> to F<ext>, and will |
1153 | now appear as known C<nonxs_ext>. This will made no difference to the |
1154 | structure of an installed perl, nor will the modules installed differ, |
1155 | unless you run F<Configure> with options to specify an exact list of |
1156 | extensions to build. In this case, you will rapidly become aware that you |
1157 | need to add to your list, because various modules needed to complete the |
1158 | build, such as C<ExtUtils::ParseXS>, have now become extensions, and |
1159 | without them the build will fail well before it attempts to run the |
1160 | regression tests. |
1161 | |
1162 | =head2 Configuration improvements |
1163 | |
1164 | If C<vendorlib> and C<vendorarch> are the same, then they are only added to |
1165 | C<@INC> once. |
1166 | |
1167 | C<$Config{usedevel}> and the C-level C<PERL_USE_DEVEL> are now defined if |
1168 | perl is built with C<-Dusedevel>. |
1169 | |
1170 | F<Configure> will enable use of C<-fstack-protector>, to provide protection |
1171 | against stack-smashing attacks, if the compiler supports it. |
1172 | |
1173 | F<Configure> will now determine the correct prototypes for re-entrant |
c66407fa |
1174 | functions and for C<gconvert> if you are using a C++ compiler rather |
3ab3a109 |
1175 | than a C compiler. |
1176 | |
1177 | On Unix, if you build from a tree containing a git repository, the |
1178 | configuration process will note the commit hash you have checked out, for |
1179 | display in the output of C<perl -v> and C<perl -V>. Unpushed local commits |
1180 | are automatically added to the list of local patches displayed by |
1181 | C<perl -V>. |
1182 | |
1183 | USE_ATTRIBUTES_FOR_PERLIO is now reported in the compile-time options |
1184 | listed by the C<-V> switch. |
1185 | |
1186 | =head2 Compilation improvements |
1187 | |
1188 | As part of the flattening of F<ext>, all extensions on all platforms are |
1189 | built by F<make_ext.pl>. This replaces the Unix-specific |
1190 | F<ext/util/make_ext>, VMS-specific F<make_ext.com> and Win32-specific |
1191 | F<win32/buildext.pl>. |
1192 | |
3ab3a109 |
1193 | =head1 Changed Internals |
1194 | |
1195 | =over 4 |
1196 | |
1197 | =item * |
1198 | |
1199 | C<Perl_pmflag> has been removed from the public API. Calling it now |
1200 | generates a deprecation warning, and it will be removed in a future |
1201 | release. Although listed as part of the API, it was never documented, |
1202 | and only ever used in F<toke.c>, and prior to 5.10, F<regcomp.c>. In |
1203 | core, it has been replaced by a static function. |
1204 | |
1205 | =item * |
1206 | |
1207 | Perl_magic_setmglob now knows about globs, fixing RT #71254. |
1208 | |
1209 | =item * |
1210 | |
1211 | TODO: C<SVt_RV> is gone. RVs are now stored in IVs |
1212 | |
1213 | =item * |
1214 | |
1215 | TODO: REGEXPs are first class |
1216 | |
1217 | =item * |
1218 | |
1219 | TODO: OOK is reworked, such that an OOKed scalar is PV not PVIV |
1220 | |
1221 | =item * |
1222 | |
1223 | The J.R.R. Tolkien quotes at the head of C source file have been checked and |
1224 | proper citations added, thanks to a patch from Tom Christiansen. |
1225 | |
1226 | =item * |
1227 | |
1228 | C<Perl_vcroak()> now accepts a null first argument. In addition, a full audit |
1229 | was made of the "not NULL" compiler annotations, and those for several |
1230 | other internal functions were corrected. |
1231 | |
1232 | =item * |
1233 | |
1234 | New macros C<dSAVEDERRNO>, C<dSAVE_ERRNO>, C<SAVE_ERRNO>, C<RESTORE_ERRNO> |
1235 | have been added to formalise the temporary saving of the C<errno> |
1236 | variable. |
1237 | |
1238 | =item * |
1239 | |
1240 | The function C<Perl_sv_insert_flags> has been added to augment |
1241 | C<Perl_sv_insert>. |
1242 | |
1243 | =item * |
1244 | |
1245 | The function C<Perl_newSV_type(type)> has been added, equivalent to |
1246 | C<Perl_newSV()> followed by C<Perl_sv_upgrade(type)>. |
1247 | |
1248 | =item * |
1249 | |
1250 | The function C<Perl_newSVpvn_flags()> has been added, equivalent to |
1251 | C<Perl_newSVpvn()> and then performing the action relevant to the flag. |
1252 | |
1253 | Two flag bits are currently supported. |
1254 | |
1255 | =over 4 |
1256 | |
1257 | =item * |
1258 | |
1259 | C<SVf_UTF8> |
1260 | |
1261 | This will call C<SvUTF8_on()> for you. (Note that this does not convert an |
1262 | sequence of ISO 8859-1 characters to UTF-8). A wrapper, C<newSVpvn_utf8()> |
1263 | is available for this. |
1264 | |
1265 | =item * |
1266 | |
1267 | C<SVs_TEMP> |
1268 | |
1269 | Call C<Perl_sv_2mortal()> on the new SV. |
1270 | |
1271 | =back |
1272 | |
1273 | There is also a wrapper that takes constant strings, C<newSVpvs_flags()>. |
1274 | |
1275 | =item * |
1276 | |
1277 | The function C<Perl_croak_xs_usage> has been added as a wrapper to |
1278 | C<Perl_croak>. |
1279 | |
1280 | =item * |
1281 | |
1282 | The functions C<PerlIO_find_layer> and C<PerlIO_list_alloc> are now |
1283 | exported. |
1284 | |
1285 | =item * |
1286 | |
1287 | C<PL_na> has been exterminated from the core code, replaced by local STRLEN |
1288 | temporaries, or C<*_nolen()> calls. Either approach is faster than C<PL_na>, |
17270880 |
1289 | which is a pointer dereference into the interpreter structure under ithreads, |
3ab3a109 |
1290 | and a global variable otherwise. |
1291 | |
1292 | =item * |
1293 | |
1294 | C<Perl_mg_free()> used to leave freed memory accessible via C<SvMAGIC()> on |
1295 | the scalar. It now updates the linked list to remove each piece of magic |
1296 | as it is freed. |
1297 | |
1298 | =item * |
1299 | |
1300 | Under ithreads, the regex in C<PL_reg_curpm> is now reference counted. This |
1301 | eliminates a lot of hackish workarounds to cope with it not being reference |
1302 | counted. |
1303 | |
1304 | =item * |
1305 | |
1306 | C<Perl_mg_magical()> would sometimes incorrectly turn on C<SvRMAGICAL()>. |
1307 | This has been fixed. |
1308 | |
1309 | =item * |
1310 | |
1311 | The I<public> IV and NV flags are now not set if the string value has |
1312 | trailing "garbage". This behaviour is consistent with not setting the |
1313 | public IV or NV flags if the value is out of range for the type. |
1314 | |
1315 | =item * |
1316 | |
1317 | SV allocation tracing has been added to the diagnostics enabled by C<-Dm>. |
1318 | The tracing can alternatively output via the C<PERL_MEM_LOG> mechanism, if |
1319 | that was enabled when the F<perl> binary was compiled. |
1320 | |
1321 | =item * |
1322 | |
1323 | Smartmatch resolution tracing has been added as a new diagnostic. Use C<-DM> to |
1324 | enable it. |
1325 | |
1326 | =item * |
1327 | |
1328 | A new debugging flag C<-DB> now dumps subroutine definitions, leaving |
1329 | C<-Dx> for its original purpose of dumping syntax trees. |
1330 | |
1331 | =item * |
1332 | |
1333 | Uses of C<Nullav>, C<Nullcv>, C<Nullhv>, C<Nullop>, C<Nullsv> etc have been |
1334 | replaced by C<NULL> in the core code, and non-dual-life modules, as C<NULL> |
1335 | is clearer to those unfamiliar with the core code. |
1336 | |
1337 | =item * |
1338 | |
1339 | A macro C<MUTABLE_PTR(p)> has been added, which on (non-pedantic) gcc will |
1340 | not cast away C<const>, returning a C<void *>. Macros C<MUTABLE_SV(av)>, |
1341 | C<MUTABLE_SV(cv)> etc build on this, casting to C<AV *> etc without |
1342 | casting away C<const>. This allows proper compile-time auditing of |
1343 | C<const> correctness in the core, and helped picked up some errors (now |
1344 | fixed). |
1345 | |
1346 | =item * |
1347 | |
1348 | Macros C<mPUSHs()> and C<mXPUSHs()> have been added, for pushing SVs on the |
1349 | stack and mortalizing them. |
1350 | |
1351 | =item * |
1352 | |
1353 | Use of the private structure C<mro_meta> has changed slightly. Nothing |
1354 | outside the core should be accessing this directly anyway. |
1355 | |
1356 | =item * |
1357 | |
1358 | A new tool, F<Porting/expand-macro.pl> has been added, that allows you |
1359 | to view how a C preprocessor macro would be expanded when compiled. |
1360 | This is handy when trying to decode the macro hell that is the perl |
1361 | guts. |
1362 | |
1363 | =back |
1364 | |
1365 | =head1 Testing |
1366 | |
1367 | =head2 New Tests |
1368 | |
1369 | Many modules updated from CPAN incorporate new tests. |
1370 | Several tests that have the potential to hang forever if they fail now |
1371 | incorporate a "watchdog" functionality that will kill them after a timeout, |
1372 | which helps ensure that C<make test> and C<make test_harness> run to |
1373 | completion automatically. (Jerry Hedden). |
1374 | |
1375 | Some core-specific tests have been added: |
1376 | |
1377 | =over 4 |
1378 | |
1379 | =item * |
1380 | |
1381 | Significant cleanups to core tests to ensure that language and |
1382 | interpreter features are not used before they're tested. |
1383 | |
1384 | =item * |
1385 | |
c66407fa |
1386 | C<make test_porting> now runs a number of important pre-commit checks |
1387 | which might be of use to anyone working on the Perl core. |
3ab3a109 |
1388 | |
1389 | =item * |
1390 | |
1391 | F<t/porting/podcheck.t> automatically checks the well-formedness of |
1392 | POD found in all .pl, .pm and .pod files in the F<MANIFEST>, other than in |
1393 | dual-lifed modules which are primarily maintained outside the Perl core. |
1394 | |
1395 | =item * |
1396 | |
1397 | F<t/porting/manifest.t> now tests that all files listed in MANIFEST are present. |
1398 | |
1399 | =item * |
1400 | |
1401 | F<t/op/while_readdir.t> |
1402 | |
1403 | Test that a bare readdir in while loop sets $_. |
1404 | |
1405 | =item * |
1406 | |
c66407fa |
1407 | F<t/comp/retainedlines.t> |
3ab3a109 |
1408 | |
1409 | Check that the debugger can retain source lines from C<eval>. |
1410 | |
1411 | =item * |
1412 | |
c66407fa |
1413 | F<t/io/perlio_fail.t> |
3ab3a109 |
1414 | |
1415 | Check that bad layers fail. |
1416 | |
1417 | =item * |
1418 | |
c66407fa |
1419 | F<t/io/perlio_leaks.t> |
3ab3a109 |
1420 | |
1421 | Check that PerlIO layers are not leaking. |
1422 | |
1423 | =item * |
1424 | |
c66407fa |
1425 | F<t/io/perlio_open.t> |
3ab3a109 |
1426 | |
1427 | Check that certain special forms of open work. |
1428 | |
1429 | =item * |
1430 | |
c66407fa |
1431 | F<t/io/perlio.t> |
3ab3a109 |
1432 | |
1433 | General PerlIO tests. |
1434 | |
1435 | =item * |
1436 | |
c66407fa |
1437 | F<t/io/pvbm.t> |
3ab3a109 |
1438 | |
1439 | Check that there is no unexpected interaction between the internal types |
1440 | C<PVBM> and C<PVGV>. |
1441 | |
1442 | =item * |
1443 | |
c66407fa |
1444 | F<t/mro/package_aliases.t> |
3ab3a109 |
1445 | |
1446 | Check that mro works properly in the presence of aliased packages. |
1447 | |
1448 | =item * |
1449 | |
c66407fa |
1450 | F<t/op/dbm.t> |
3ab3a109 |
1451 | |
1452 | Tests for C<dbmopen> and C<dbmclose>. |
1453 | |
1454 | =item * |
1455 | |
c66407fa |
1456 | F<t/op/index_thr.t> |
3ab3a109 |
1457 | |
1458 | Tests for the interaction of C<index> and threads. |
1459 | |
1460 | =item * |
1461 | |
c66407fa |
1462 | F<t/op/pat_thr.t> |
3ab3a109 |
1463 | |
1464 | Tests for the interaction of esoteric patterns and threads. |
1465 | |
1466 | =item * |
1467 | |
c66407fa |
1468 | F<t/op/qr_gc.t> |
3ab3a109 |
1469 | |
1470 | Test that C<qr> doesn't leak. |
1471 | |
1472 | =item * |
1473 | |
c66407fa |
1474 | F<t/op/reg_email_thr.t> |
3ab3a109 |
1475 | |
1476 | Tests for the interaction of regex recursion and threads. |
1477 | |
1478 | =item * |
1479 | |
c66407fa |
1480 | F<t/op/regexp_qr_embed_thr.t> |
3ab3a109 |
1481 | |
1482 | Tests for the interaction of patterns with embedded C<qr//> and threads. |
1483 | |
1484 | =item * |
1485 | |
c66407fa |
1486 | F<t/op/regexp_unicode_prop.t> |
3ab3a109 |
1487 | |
1488 | Tests for Unicode properties in regular expressions. |
1489 | |
1490 | =item * |
1491 | |
c66407fa |
1492 | F<t/op/regexp_unicode_prop_thr.t> |
3ab3a109 |
1493 | |
1494 | Tests for the interaction of Unicode properties and threads. |
1495 | |
1496 | =item * |
1497 | |
c66407fa |
1498 | F<t/op/reg_nc_tie.t> |
3ab3a109 |
1499 | |
1500 | Test the tied methods of C<Tie::Hash::NamedCapture>. |
1501 | |
1502 | =item * |
1503 | |
c66407fa |
1504 | F<t/op/reg_posixcc.t> |
3ab3a109 |
1505 | |
1506 | Check that POSIX character classes behave consistently. |
1507 | |
1508 | =item * |
1509 | |
c66407fa |
1510 | F<t/op/re.t> |
3ab3a109 |
1511 | |
1512 | Check that exportable C<re> functions in F<universal.c> work. |
1513 | |
1514 | =item * |
1515 | |
c66407fa |
1516 | F<t/op/setpgrpstack.t> |
3ab3a109 |
1517 | |
1518 | Check that C<setpgrp> works. |
1519 | |
1520 | =item * |
1521 | |
c66407fa |
1522 | F<t/op/substr_thr.t> |
3ab3a109 |
1523 | |
1524 | Tests for the interaction of C<substr> and threads. |
1525 | |
1526 | =item * |
1527 | |
c66407fa |
1528 | F<t/op/upgrade.t> |
3ab3a109 |
1529 | |
1530 | Check that upgrading and assigning scalars works. |
1531 | |
1532 | =item * |
1533 | |
c66407fa |
1534 | F<t/uni/lex_utf8.t> |
3ab3a109 |
1535 | |
1536 | Check that Unicode in the lexer works. |
1537 | |
1538 | =item * |
1539 | |
c66407fa |
1540 | F<t/uni/tie.t> |
3ab3a109 |
1541 | |
1542 | Check that Unicode and C<tie> work. |
1543 | |
1544 | =item * |
1545 | |
c66407fa |
1546 | F<t/comp/final_line_num.t> |
3ab3a109 |
1547 | |
1548 | See if line numbers are correct at EOF |
1549 | |
1550 | =item * |
1551 | |
c66407fa |
1552 | F<t/comp/form_scope.t> |
3ab3a109 |
1553 | |
1554 | See if format scoping works |
1555 | |
1556 | =item * |
1557 | |
c66407fa |
1558 | F<t/comp/line_debug.t> |
3ab3a109 |
1559 | |
c66407fa |
1560 | See if C<< @{"_<$file"} >> works |
3ab3a109 |
1561 | |
1562 | =item * |
1563 | |
c66407fa |
1564 | F<t/op/filetest_t.t> |
3ab3a109 |
1565 | |
1566 | See if -t file test works |
1567 | |
1568 | =item * |
1569 | |
c66407fa |
1570 | F<t/op/qr.t> |
3ab3a109 |
1571 | |
1572 | See if qr works |
1573 | |
1574 | =item * |
1575 | |
c66407fa |
1576 | F<t/op/utf8cache.t> |
3ab3a109 |
1577 | |
1578 | Tests malfunctions of utf8 cache |
1579 | |
1580 | =item * |
1581 | |
c66407fa |
1582 | F<t/re/uniprops.t> |
3ab3a109 |
1583 | |
1584 | Test unicode \p{} regex constructs |
1585 | |
1586 | =back |
1587 | |
1588 | =head2 Testing improvements |
1589 | |
1590 | =over 4 |
1591 | |
1592 | =item * |
1593 | |
1594 | It's now possible to override C<PERL5OPT> and friends in F<t/TEST> |
1595 | |
1596 | =back |
1597 | |
1598 | |
1599 | =head1 New or Changed Diagnostics |
1600 | |
1601 | Several new diagnostics, see L<perldiag> for details. |
1602 | |
1603 | =over 4 |
1604 | |
1605 | =item * |
1606 | |
1607 | C<Bad plugin affecting keyword '%s'> |
1608 | |
1609 | =item * |
1610 | |
1611 | C<gmtime(%.0f) too large> |
1612 | |
1613 | =item * |
1614 | |
1615 | C<Lexing code attempted to stuff non-Latin-1 character into Latin-1 input> |
1616 | |
1617 | =item * |
1618 | |
1619 | C<Lexing code internal error (%s)> |
1620 | |
1621 | =item * |
1622 | |
1623 | C<localtime(%.0f) too large> |
1624 | |
1625 | =item * |
1626 | |
1627 | C<Overloaded dereference did not return a reference> |
1628 | |
1629 | =item * |
1630 | |
1631 | C<Overloaded qr did not return a REGEXP> |
1632 | |
1633 | =item * |
1634 | |
1635 | C<Perl_pmflag() is deprecated, and will be removed from the XS API> |
1636 | |
1637 | =item * |
1638 | |
1639 | New warning category C<illegalproto> |
1640 | |
1641 | The two warnings : |
1642 | |
1643 | Illegal character in prototype for %s : %s |
1644 | Prototype after '%c' for %s : %s |
1645 | |
1646 | have been moved from the C<syntax> top-level warnings category into a new |
1647 | first-level category, C<illegalproto>. These two warnings are currently the |
1648 | only ones emitted during parsing of an invalid/illegal prototype, so one |
1649 | can now do |
1650 | |
1651 | no warnings 'illegalproto'; |
1652 | |
1653 | to suppress only those, but not other syntax-related warnings. Warnings where |
1654 | prototypes are changed, ignored, or not met are still in the C<prototype> |
1655 | category as before. (Matt S. Trout) |
1656 | |
1657 | =item * |
1658 | |
1659 | lvalue attribute ignored after the subroutine has been defined |
1660 | |
1661 | This new warning is issued when one attempts to mark a subroutine as |
1662 | lvalue after it has been defined. |
1663 | |
1664 | =item * |
1665 | |
c66407fa |
1666 | warn if C<++> or C<--> are unable to change the value because it's |
1667 | beyond the limit of representation |
3ab3a109 |
1668 | |
1669 | This uses a new warnings category: "imprecision". |
1670 | |
1671 | =item * |
c66407fa |
1672 | |
1673 | C<lc>, C<uc>, C<lcfirst>, and C<ucfirst> warn when passed undef. |
3ab3a109 |
1674 | |
1675 | =item * |
1676 | |
1677 | Show constant in "Useless use of a constant in void context" |
1678 | |
1679 | =item * |
1680 | |
1681 | Make the new warning report undef constants as undef |
1682 | |
1683 | =item * |
1684 | |
1685 | Add a new warning, "Prototype after '%s'" |
1686 | |
1687 | =item * |
1688 | |
c66407fa |
1689 | Tweak the "Illegal character in prototype" warning so it's more precise |
1690 | when reporting illegal characters after _ |
3ab3a109 |
1691 | |
1692 | =item * |
1693 | |
c66407fa |
1694 | Correct the unintended interpolation of C<$\> in regex |
3ab3a109 |
1695 | |
1696 | =item * |
1697 | |
c66407fa |
1698 | Make overflow warnings in C<gmtime> and C<localtime> only occur when |
1699 | warnings are enabled |
3ab3a109 |
1700 | |
1701 | =item * |
1702 | |
1703 | Improve mro merging error messages. |
1704 | |
1705 | They are now very similar to those produced by Algorithm::C3. |
1706 | |
1707 | =item * |
1708 | |
1709 | Amelioration of the error message "Unrecognized character %s in column %d" |
1710 | |
1711 | Changes the error message to "Unrecognized character %s; marked by E<lt>-- |
1712 | HERE after %sE<lt>-- HERE near column %d". This should make it a little |
1713 | simpler to spot and correct the suspicious character. |
1714 | |
1715 | =item * |
1716 | |
c66407fa |
1717 | Explicitely point to C<$.> when it causes an uninitialized warning for |
1718 | ranges in scalar context |
3ab3a109 |
1719 | |
1720 | =item * |
1721 | |
3ab3a109 |
1722 | C<split> now warns when called in void context |
1723 | |
1724 | =item * |
1725 | |
1726 | C<printf>-style functions called with too few arguments will now issue the |
1727 | warning C<"Missing argument in %s"> [perl #71000] |
1728 | |
1729 | =item * |
1730 | |
1731 | C<panic: sv_chop %s> |
1732 | |
1733 | This new fatal error occurs when the C routine C<Perl_sv_chop()> was |
1734 | passed a position that is not within the scalar's string buffer. This |
1735 | could be caused by buggy XS code, and at this point recovery is not |
1736 | possible. |
1737 | |
1738 | =item * |
1739 | |
3ab3a109 |
1740 | C<Deep recursion on subroutine "%s"> |
1741 | |
1742 | It is now possible to change the depth threshold for this warning from the |
1743 | default of 100, by recompiling the F<perl> binary, setting the C |
1744 | pre-processor macro C<PERL_SUB_DEPTH_WARN> to the desired value. |
1745 | |
1746 | =item * |
1747 | |
1748 | Perl now properly returns a syntax error instead of segfaulting |
c66407fa |
1749 | if C<each>, C<keys>, or C<values> is used without an argument. |
3ab3a109 |
1750 | |
1751 | =item * |
1752 | |
c66407fa |
1753 | C<tell()> now fails properly if called without an argument and when no |
1754 | previous file was read. |
3ab3a109 |
1755 | |
c66407fa |
1756 | C<tell()> now returns C<-1>, and sets errno to C<EBADF>, thus restoring |
1757 | the 5.8.x behaviour. |
3ab3a109 |
1758 | |
1759 | =item * |
1760 | |
c66407fa |
1761 | C<overload> no longer implicitly unsets fallback on repeated 'use |
1762 | overload' lines. |
3ab3a109 |
1763 | |
1764 | =item * |
1765 | |
1766 | POSIX::strftime() can now handle Unicode characters in the format string. |
1767 | |
1768 | =item * |
1769 | |
c66407fa |
1770 | The Windows select() implementation now supports all empty C<fd_set>s |
1771 | more correctly. |
3ab3a109 |
1772 | |
1773 | =item * |
1774 | |
c66407fa |
1775 | The "syntax" category was removed from 5 warnings that should only be in |
1776 | "deprecated". |
3ab3a109 |
1777 | |
1778 | =item * |
1779 | |
c66407fa |
1780 | Three fatal C<pack>/C<unpack> error messages have been normalized to |
1781 | "panic: %s" |
3ab3a109 |
1782 | |
1783 | =item * |
1784 | |
1785 | "Unicode character is illegal" has been rephrased to be more accurate |
1786 | |
1787 | It now reads C<Unicode non-character is illegal in interchange> and the |
1788 | perldiag documentation has been expanded a bit. |
1789 | |
1790 | =item * |
1791 | |
c66407fa |
1792 | Perl now defaults to issuing a warning if a deprecated language feature |
1793 | is used. |
3ab3a109 |
1794 | |
1795 | To disable this feature in a given lexical scope, you should use C<no |
1796 | warnings 'deprecated';> For information about which language features |
1797 | are deprecated and explanations of various deprecation warnings, please |
1798 | see L<perldiag.pod> |
1799 | |
1800 | =back |
1801 | |
c66407fa |
1802 | The following diagnostics have been removed: |
1803 | |
1804 | =over 4 |
1805 | |
1806 | =item * |
1807 | |
1808 | C<Runaway format> |
1809 | |
1810 | =item * |
1811 | |
1812 | C<Can't locate package %s for the parents of %s> |
1813 | |
1814 | This warning has been removed. In general, it only got produced in |
1815 | conjunction with other warnings, and removing it allowed an ISA lookup |
1816 | optimisation to be added. |
1817 | |
1818 | =item * |
1819 | |
1820 | C<v-string in use/require is non-portable> |
1821 | |
1822 | =back |
1823 | |
3ab3a109 |
1824 | =head1 Utility Changes |
1825 | |
1826 | =over 4 |
1827 | |
1828 | =item * |
1829 | |
1830 | F<h2ph> |
1831 | |
1832 | Now looks in C<include-fixed> too, which is a recent addition to gcc's |
1833 | search path. |
1834 | |
1835 | =item * |
1836 | |
1837 | F<h2xs> |
1838 | |
1839 | No longer incorrectly treats enum values like macros (Daniel Burr). |
1840 | |
1841 | Now handles C++ style constants (C<//>) properly in enums. (A patch from |
1842 | Rainer Weikusat was used; Daniel Burr also proposed a similar fix). |
1843 | |
1844 | =item * |
1845 | |
1846 | F<perl5db.pl> |
1847 | |
1848 | C<LVALUE> subroutines now work under the debugger. |
1849 | |
1850 | The debugger now correctly handles proxy constant subroutines, and |
1851 | subroutine stubs. |
1852 | |
1853 | =item * |
1854 | |
1855 | F<perlbug> |
1856 | |
1857 | F<perlbug> now uses C<%Module::CoreList::bug_tracker> to print out upstream bug |
1858 | tracker URLs. |
1859 | |
1860 | Where the user names a module that their bug report is about, and we know the |
1861 | URL for its upstream bug tracker, provide a message to the user explaining |
1862 | that the core copies the CPAN version directly, and provide the URL for |
1863 | reporting the bug directly to upstream. |
1864 | |
1865 | =item * |
1866 | |
1867 | F<perlthanks> |
1868 | |
1869 | Perl 5.11.0 added a new utility F<perlthanks>, which is a variant of |
1870 | F<perlbug>, but for sending non-bug-reports to the authors and maintainers |
1871 | of Perl. Getting nothing but bug reports can become a bit demoralising: |
1872 | we'll see if this changes things. |
1873 | |
1874 | =item * |
1875 | |
1876 | F<perlbug> |
1877 | |
1878 | No longer reports "Message sent" when it hasn't actually sent the message |
1879 | |
1880 | =item * |
1881 | |
1882 | F<a2p> |
1883 | |
1884 | Fixed bugs with the match() operator in list context, remove mention of |
c66407fa |
1885 | C<$[>. |
3ab3a109 |
1886 | |
1887 | =back |
1888 | |
1889 | =head1 Selected Bug Fixes |
1890 | |
1891 | =over 4 |
1892 | |
1893 | =item * |
1894 | |
1895 | Ensure that pp_qr returns a new regexp SV each time. Resolves RT #69852. |
1896 | |
1897 | Instead of returning a(nother) reference to the (pre-compiled) regexp in the |
1898 | optree, use reg_temp_copy() to create a copy of it, and return a reference to |
1899 | that. This resolves issues about Regexp::DESTROY not being called in a timely |
1900 | fashion (the original bug tracked by RT #69852), as well as bugs related to |
1901 | blessing regexps, and of assigning to regexps, as described in correspondence |
1902 | added to the ticket. |
1903 | |
1904 | It transpires that we also need to undo the SvPVX() sharing when ithreads |
1905 | cloning a Regexp SV, because mother_re is set to NULL, instead of a cloned |
1906 | copy of the mother_re. This change might fix bugs with regexps and threads in |
1907 | certain other situations, but as yet neither tests nor bug reports have |
1908 | indicated any problems, so it might not actually be an edge case that it's |
1909 | possible to reach. |
1910 | |
1911 | =item * |
1912 | |
3ab3a109 |
1913 | Several compilation errors and segfaults when perl was built with C<-Dmad> were fixed. |
1914 | |
1915 | =item * |
1916 | |
1917 | Fixes for lexer API changes in 5.11.2 which broke NYTProf's savesrc option. |
1918 | |
1919 | =item * |
1920 | |
c66407fa |
1921 | C<-t> should only return TRUE for file handles connected to a TTY |
3ab3a109 |
1922 | |
c66407fa |
1923 | The Microsoft C version of C<isatty()> returns TRUE for all |
1924 | character mode devices, including the F</dev/null>-style "nul" |
3ab3a109 |
1925 | device and printers like "lpt1". |
1926 | |
1927 | =item * |
1928 | |
1929 | Fixed a regression caused by commit fafafbaf which caused a panic during |
1930 | parameter passing [perl #70171] |
1931 | |
1932 | =item * |
1933 | |
1934 | On systems which in-place edits without backup files, -i'*' now works as |
1935 | the documentation says it does [perl #70802] |
1936 | |
1937 | =item * |
1938 | |
1939 | Saving and restoring magic flags no longer loses readonly flag. |
1940 | |
1941 | =item * |
1942 | |
1943 | The malformed syntax C<grep EXPR LIST> (note the missing comma) no longer |
1944 | causes abrupt and total failure. |
1945 | |
1946 | =item * |
1947 | |
1948 | Regular expressions compiled with C<qr{}> literals properly set C<$'> when |
1949 | matching again. |
1950 | |
1951 | =item * |
1952 | |
1953 | Using named subroutines with C<sort> should no longer lead to bus errors [perl |
1954 | #71076] |
1955 | |
1956 | =item * |
1957 | |
1958 | Numerous bugfixes catch small issues caused by the recently-added Lexer API. |
1959 | |
1960 | =item * |
1961 | |
1962 | Smart match against C<@_> sometimes gave false negatives. [perl #71078] |
1963 | |
1964 | =item * |
1965 | |
c66407fa |
1966 | C<$@> may now be assigned a read-only value (without error or busting |
1967 | the stack). |
3ab3a109 |
1968 | |
1969 | =item * |
1970 | |
1971 | C<sort> called recursively from within an active comparison subroutine no |
1972 | longer causes a bus error if run multiple times. [perl #71076] |
1973 | |
1974 | =item * |
1975 | |
c66407fa |
1976 | Tie::Hash::NamedCapture::* will not abort if passed bad input (RT #71828) |
3ab3a109 |
1977 | |
1978 | =item * |
1979 | |
1980 | @_ and $_ no longer leak under threads (RT #34342 and #41138, also |
1981 | #70602, #70974) |
1982 | |
1983 | =item * |
1984 | |
1985 | C<-I> on shebang line now adds directories in front of @INC |
1986 | as documented, and as does C<-I> when specified on the command-line. |
1987 | |
1988 | =item * |
1989 | |
1990 | C<kill> is now fatal when called on non-numeric process identifiers. |
c66407fa |
1991 | Previously, an C<undef> process identifier would be interpreted as a |
1992 | request to kill process 0, which would terminate the current process |
1993 | group on POSIX systems. Since process identifiers are always integers, |
1994 | killing a non-numeric process is now fatal. |
3ab3a109 |
1995 | |
1996 | =item * |
1997 | |
1998 | 5.10.0 inadvertently disabled an optimisation, which caused a measurable |
1999 | performance drop in list assignment, such as is often used to assign |
2000 | function parameters from C<@_>. The optimisation has been re-instated, and |
c66407fa |
2001 | the performance regression fixed. (This fix is also present in 5.10.1) |
3ab3a109 |
2002 | |
2003 | =item * |
2004 | |
2005 | Fixed memory leak on C<while (1) { map 1, 1 }> [RT #53038]. |
2006 | |
2007 | =item * |
2008 | |
2009 | Some potential coredumps in PerlIO fixed [RT #57322,54828]. |
2010 | |
2011 | =item * |
2012 | |
2013 | The debugger now works with lvalue subroutines. |
2014 | |
2015 | =item * |
2016 | |
2017 | The debugger's C<m> command was broken on modules that defined constants |
2018 | [RT #61222]. |
2019 | |
2020 | =item * |
2021 | |
2022 | C<crypt> and string complement could return tainted values for untainted |
2023 | arguments [RT #59998]. |
2024 | |
2025 | =item * |
2026 | |
2027 | The C<-i>I<.suffix> command-line switch now recreates the file using |
2028 | restricted permissions, before changing its mode to match the original |
2029 | file. This eliminates a potential race condition [RT #60904]. |
2030 | |
2031 | =item * |
2032 | |
2033 | On some Unix systems, the value in C<$?> would not have the top bit set |
2034 | (C<$? & 128>) even if the child core dumped. |
2035 | |
2036 | =item * |
2037 | |
2038 | Under some circumstances, C<$^R> could incorrectly become undefined |
2039 | [RT #57042]. |
2040 | |
2041 | =item * |
2042 | |
2043 | In the XS API, various hash functions, when passed a pre-computed hash where |
2044 | the key is UTF-8, might result in an incorrect lookup. |
2045 | |
2046 | =item * |
2047 | |
2048 | XS code including F<XSUB.h> before F<perl.h> gave a compile-time error |
2049 | [RT #57176]. |
2050 | |
2051 | =item * |
2052 | |
2053 | C<< $object-E<gt>isa('Foo') >> would report false if the package C<Foo> didn't |
2054 | exist, even if the object's C<@ISA> contained C<Foo>. |
2055 | |
2056 | =item * |
2057 | |
2058 | Various bugs in the new-to 5.10.0 mro code, triggered by manipulating |
2059 | C<@ISA>, have been found and fixed. |
2060 | |
2061 | =item * |
2062 | |
2063 | Bitwise operations on references could crash the interpreter, e.g. |
2064 | C<$x=\$y; $x |= "foo"> [RT #54956]. |
2065 | |
2066 | =item * |
2067 | |
2068 | Patterns including alternation might be sensitive to the internal UTF-8 |
2069 | representation, e.g. |
2070 | |
2071 | my $byte = chr(192); |
2072 | my $utf8 = chr(192); utf8::upgrade($utf8); |
2073 | $utf8 =~ /$byte|X}/i; # failed in 5.10.0 |
2074 | |
2075 | =item * |
2076 | |
2077 | Within UTF8-encoded Perl source files (i.e. where C<use utf8> is in |
2078 | effect), double-quoted literal strings could be corrupted where a C<\xNN>, |
2079 | C<\0NNN> or C<\N{}> is followed by a literal character with ordinal value |
2080 | greater than 255 [RT #59908]. |
2081 | |
2082 | =item * |
2083 | |
2084 | C<B::Deparse> failed to correctly deparse various constructs: |
2085 | C<readpipe STRING> [RT #62428], C<CORE::require(STRING)> [RT #62488], |
2086 | C<sub foo(_)> [RT #62484]. |
2087 | |
2088 | =item * |
2089 | |
2090 | Using C<setpgrp> with no arguments could corrupt the perl stack. |
2091 | |
2092 | =item * |
2093 | |
2094 | The block form of C<eval> is now specifically trappable by C<Safe> and |
2095 | C<ops>. Previously it was erroneously treated like string C<eval>. |
2096 | |
2097 | =item * |
2098 | |
2099 | In 5.10.0, the two characters C<[~> were sometimes parsed as the smart |
2100 | match operator (C<~~>) [RT #63854]. |
2101 | |
2102 | =item * |
2103 | |
2104 | In 5.10.0, the C<*> quantifier in patterns was sometimes treated as |
2105 | C<{0,32767}> [RT #60034, #60464]. For example, this match would fail: |
2106 | |
2107 | ("ab" x 32768) =~ /^(ab)*$/ |
2108 | |
2109 | =item * |
2110 | |
2111 | C<shmget> was limited to a 32 bit segment size on a 64 bit OS [RT #63924]. |
2112 | |
2113 | =item * |
2114 | |
2115 | Using C<next> or C<last> to exit a C<given> block no longer produces a |
2116 | spurious warning like the following: |
2117 | |
2118 | Exiting given via last at foo.pl line 123 |
2119 | |
2120 | =item * |
2121 | |
2122 | On Windows, C<'.\foo'> and C<'..\foo'> were treated differently than |
2123 | C<'./foo'> and C<'../foo'> by C<do> and C<require> [RT #63492]. |
2124 | |
2125 | =item * |
2126 | |
2127 | Assigning a format to a glob could corrupt the format; e.g.: |
2128 | |
2129 | *bar=*foo{FORMAT}; # foo format now bad |
2130 | |
2131 | =item * |
2132 | |
2133 | Attempting to coerce a typeglob to a string or number could cause an |
2134 | assertion failure. The correct error message is now generated, |
2135 | C<Can't coerce GLOB to I<$type>>. |
2136 | |
2137 | =item * |
2138 | |
2139 | Under C<use filetest 'access'>, C<-x> was using the wrong access mode. This |
2140 | has been fixed [RT #49003]. |
2141 | |
2142 | =item * |
2143 | |
2144 | C<length> on a tied scalar that returned a Unicode value would not be |
2145 | correct the first time. This has been fixed. |
2146 | |
2147 | =item * |
2148 | |
2149 | Using an array C<tie> inside in array C<tie> could SEGV. This has been |
2150 | fixed. [RT #51636] |
2151 | |
2152 | =item * |
2153 | |
2154 | A race condition inside C<PerlIOStdio_close()> has been identified and |
2155 | fixed. This used to cause various threading issues, including SEGVs. |
2156 | |
2157 | =item * |
2158 | |
2159 | In C<unpack>, the use of C<()> groups in scalar context was internally |
2160 | placing a list on the interpreter's stack, which manifested in various |
2161 | ways, including SEGVs. This is now fixed [RT #50256]. |
2162 | |
2163 | =item * |
2164 | |
2165 | Magic was called twice in C<substr>, C<\&$x>, C<tie $x, $m> and C<chop>. |
2166 | These have all been fixed. |
2167 | |
2168 | =item * |
2169 | |
2170 | A 5.10.0 optimisation to clear the temporary stack within the implicit |
2171 | loop of C<s///ge> has been reverted, as it turned out to be the cause of |
2172 | obscure bugs in seemingly unrelated parts of the interpreter [commit |
2173 | ef0d4e17921ee3de]. |
2174 | |
2175 | =item * |
2176 | |
2177 | The line numbers for warnings inside C<elsif> are now correct. |
2178 | |
2179 | =item * |
2180 | |
2181 | The C<..> operator now works correctly with ranges whose ends are at or |
2182 | close to the values of the smallest and largest integers. |
2183 | |
2184 | =item * |
2185 | |
2186 | C<binmode STDIN, ':raw'> could lead to segmentation faults on some platforms. |
2187 | This has been fixed [RT #54828]. |
2188 | |
2189 | =item * |
2190 | |
2191 | An off-by-one error meant that C<index $str, ...> was effectively being |
2192 | executed as C<index "$str\0", ...>. This has been fixed [RT #53746]. |
2193 | |
2194 | =item * |
2195 | |
2196 | Various leaks associated with named captures in regexes have been fixed |
2197 | [RT #57024]. |
2198 | |
2199 | =item * |
2200 | |
2201 | A weak reference to a hash would leak. This was affecting C<DBI> |
2202 | [RT #56908]. |
2203 | |
2204 | =item * |
2205 | |
2206 | Using (?|) in a regex could cause a segfault [RT #59734]. |
2207 | |
2208 | =item * |
2209 | |
2210 | Use of a UTF-8 C<tr//> within a closure could cause a segfault [RT #61520]. |
2211 | |
2212 | =item * |
2213 | |
2214 | Calling C<Perl_sv_chop()> or otherwise upgrading an SV could result in an |
2215 | unaligned 64-bit access on the SPARC architecture [RT #60574]. |
2216 | |
2217 | =item * |
2218 | |
2219 | In the 5.10.0 release, C<inc_version_list> would incorrectly list |
2220 | C<5.10.*> after C<5.8.*>; this affected the C<@INC> search order |
2221 | [RT #67628]. |
2222 | |
2223 | =item * |
2224 | |
2225 | In 5.10.0, C<pack "a*", $tainted_value> returned a non-tainted value |
2226 | [RT #52552]. |
2227 | |
2228 | =item * |
2229 | |
2230 | In 5.10.0, C<printf> and C<sprintf> could produce the fatal error |
2231 | C<panic: utf8_mg_pos_cache_update> when printing UTF-8 strings |
2232 | [RT #62666]. |
2233 | |
2234 | =item * |
2235 | |
2236 | In the 5.10.0 release, a dynamically created C<AUTOLOAD> method might be |
2237 | missed (method cache issue) [RT #60220,60232]. |
2238 | |
2239 | =item * |
2240 | |
2241 | In the 5.10.0 release, a combination of C<use feature> and C<//ee> could |
2242 | cause a memory leak [RT #63110]. |
2243 | |
2244 | =item * |
2245 | |
2246 | C<-C> on the shebang (C<#!>) line is once more permitted if it is also |
2247 | specified on the command line. C<-C> on the shebang line used to be a |
2248 | silent no-op I<if> it was not also on the command line, so perl 5.10.0 |
2249 | disallowed it, which broke some scripts. Now perl checks whether it is |
2250 | also on the command line and only dies if it is not [RT #67880]. |
2251 | |
2252 | =item * |
2253 | |
2254 | In 5.10.0, certain types of re-entrant regular expression could crash, |
2255 | or cause the following assertion failure [RT #60508]: |
2256 | |
2257 | Assertion rx->sublen >= (s - rx->subbeg) + i failed |
2258 | |
2259 | =item * |
2260 | |
2261 | Previously missing files from Unicode 5.1 Character Database are now included. |
2262 | |
2263 | =item * |
2264 | |
2265 | C<TMPDIR> is now honored when opening an anonymous temporary file |
2266 | |
2267 | =back |
2268 | |
2269 | =head1 Platform Specific Changes |
2270 | |
2271 | =head2 New Platforms |
2272 | |
2273 | =over |
2274 | |
2275 | =item Haiku |
2276 | |
2277 | Patches from the Haiku maintainers have been merged in. Perl should now |
2278 | build on Haiku. |
2279 | |
2280 | =item MirOS BSD |
2281 | |
2282 | Perl should now build on MirOS BSD. |
2283 | |
2284 | |
2285 | =back |
2286 | |
2287 | =head2 Discontinued Platforms |
2288 | |
2289 | =over |
2290 | |
2291 | =item DomainOS |
2292 | |
2293 | Support for Apollo DomainOS was removed in Perl 5.11.0 |
2294 | |
2295 | =item MachTen |
2296 | |
2297 | Support for Tenon Intersystems MachTen Unix layer for MacOS Classic was |
2298 | removed in Perl 5.11.0 |
2299 | |
2300 | =item MiNT |
2301 | |
2302 | Support for Atari MiNT was removed in Perl 5.11.0. |
2303 | |
2304 | =back |
2305 | |
2306 | =head2 Updated Platforms |
2307 | |
2308 | =over 4 |
2309 | |
2310 | =item Darwin (Mac OS X) |
2311 | |
2312 | =over 4 |
2313 | |
2314 | =item * |
2315 | |
2316 | Skip testing the be_BY.CP1131 locale on Darwin 10 (Mac OS X 10.6), |
2317 | as it's still buggy. |
2318 | |
2319 | =item * |
2320 | |
2321 | Correct infelicities in the regexp used to identify buggy locales |
2322 | on Darwin 8 and 9 (Mac OS X 10.4 and 10.5, respectively). |
2323 | |
2324 | =back |
2325 | |
2326 | =item DragonFly BSD |
2327 | |
2328 | =over 4 |
2329 | |
2330 | =item * |
2331 | |
2332 | Fix thread library selection [perl #69686] |
2333 | |
2334 | =back |
2335 | |
2336 | =item Win32 |
2337 | |
2338 | =over 4 |
2339 | |
2340 | =item * |
2341 | |
2342 | Initial support for mingw64 is now available |
2343 | |
2344 | =item * |
2345 | |
c66407fa |
2346 | Various bits of Perl's build infrastructure are no longer converted to |
2347 | win32 line endings at release time. If this hurts you, please report the |
2348 | problem with the L<perlbug> program included with perl. |
3ab3a109 |
2349 | |
2350 | =item * |
2351 | |
2352 | Always add a manifest resource to C<perl.exe> to specify the C<trustInfo> |
2353 | settings for Windows Vista and later. Without this setting Windows |
2354 | will treat C<perl.exe> as a legacy application and apply various |
2355 | heuristics like redirecting access to protected file system areas |
2356 | (like the "Program Files" folder) to the users "VirtualStore" |
2357 | instead of generating a proper "permission denied" error. |
2358 | |
2359 | For VC8 and VC9 this manifest setting is automatically generated by |
2360 | the compiler/linker (together with the binding information for their |
2361 | respective runtime libraries); for all other compilers we need to |
2362 | embed the manifest resource explicitly in the external resource file. |
2363 | |
2364 | This change also requests the Microsoft Common-Controls version 6.0 |
2365 | (themed controls introduced in Windows XP) via the dependency list |
2366 | in the assembly manifest. For VC8 and VC9 this is specified using the |
2367 | C</manifestdependency> linker commandline option instead. |
2368 | |
2369 | =item * |
2370 | |
2371 | Improved message window handling means that C<alarm> and C<kill> messages |
2372 | will no longer be dropped under race conditions. |
2373 | |
2374 | =back |
2375 | |
2376 | =item cygwin |
2377 | |
2378 | =over 4 |
2379 | |
2380 | =item * |
2381 | |
2382 | Enable IPv6 support on cygwin 1.7 and newer |
2383 | |
2384 | =back |
2385 | |
2386 | =item OpenVMS |
2387 | |
2388 | =over 4 |
2389 | |
2390 | =item * |
2391 | |
2392 | Make -UDEBUGGING the default on VMS for 5.12.0. |
2393 | |
2394 | Like it has been everywhere else for ages and ages. Also make |
2395 | command-line selection of -UDEBUGGING and -DDEBUGGING work in |
2396 | configure.com; before the only way to turn it off was by saying |
2397 | no in answer to the interactive question. |
2398 | |
2399 | =item * |
2400 | |
2401 | The default pipe buffer size on VMS has been updated to 8192 on 64-bit |
2402 | systems. |
2403 | |
2404 | =item * |
2405 | |
2406 | Reads from the in-memory temporary files of C<PerlIO::scalar> used to fail |
2407 | if C<$/> was set to a numeric reference (to indicate record-style reads). |
2408 | This is now fixed. |
2409 | |
2410 | =item * |
2411 | |
2412 | VMS now supports C<getgrgid>. |
2413 | |
2414 | =item * |
2415 | |
2416 | Many improvements and cleanups have been made to the VMS file name handling |
2417 | and conversion code. |
2418 | |
2419 | =item * |
2420 | |
2421 | Enabling the C<PERL_VMS_POSIX_EXIT> logical name now encodes a POSIX exit |
2422 | status in a VMS condition value for better interaction with GNV's bash |
2423 | shell and other utilities that depend on POSIX exit values. See |
2424 | L<perlvms/"$?"> for details. |
2425 | |
2426 | =item * |
2427 | |
2428 | C<File::Copy> now detects Unix compatibility mode on VMS. |
2429 | |
2430 | =back |
2431 | |
2432 | =item AIX |
2433 | |
2434 | Removed F<libbsd> for AIX 5L and 6.1. Only C<flock()> was used from F<libbsd>. |
2435 | |
2436 | Removed F<libgdbm> for AIX 5L and 6.1. The F<libgdbm> is delivered as an |
2437 | optional package with the AIX Toolbox. Unfortunately the 64 bit version |
2438 | is broken. |
2439 | |
2440 | Hints changes mean that AIX 4.2 should work again. |
2441 | |
2442 | =item Cygwin |
2443 | |
2444 | On Cygwin we now strip the last number from the DLL. This has been the |
2445 | behaviour in the cygwin.com build for years. The hints files have been |
2446 | updated. |
2447 | |
2448 | |
2449 | =item FreeBSD |
2450 | |
2451 | The hints files now identify the correct threading libraries on FreeBSD 7 |
2452 | and later. |
2453 | |
2454 | =item Irix |
2455 | |
2456 | We now work around a bizarre preprocessor bug in the Irix 6.5 compiler: |
2457 | C<cc -E -> unfortunately goes into K&R mode, but C<cc -E file.c> doesn't. |
2458 | |
2459 | =item NetBSD |
2460 | |
2461 | Hints now supports versions 5.*. |
2462 | |
2463 | =item Stratus VOS |
2464 | |
2465 | Various changes from Stratus have been merged in. |
2466 | |
2467 | =item Symbian |
2468 | |
2469 | There is now support for Symbian S60 3.2 SDK and S60 5.0 SDK. |
2470 | |
2471 | =back |
2472 | |
2473 | =head1 Known Problems |
2474 | |
2475 | This is a list of some significant unfixed bugs, which are regressions |
2476 | from either 5.10.0 or 5.8.x. |
2477 | |
2478 | =over 4 |
2479 | |
2480 | =item * |
2481 | |
2482 | C<List::Util::first> misbehaves in the presence of a lexical C<$_> |
2483 | (typically introduced by C<my $_> or implicitly by C<given>). The variable |
2484 | which gets set for each iteration is the package variable C<$_>, not the |
2485 | lexical C<$_> [RT #67694]. |
2486 | |
2487 | A similar issue may occur in other modules that provide functions which |
2488 | take a block as their first argument, like |
2489 | |
2490 | foo { ... $_ ...} list |
2491 | |
2492 | =item * |
2493 | |
3ab3a109 |
2494 | Some regexes may run much more slowly when run in a child thread compared |
2495 | with the thread the pattern was compiled into [RT #55600]. |
2496 | |
2497 | =item * |
2498 | |
3ab3a109 |
2499 | Untriaged test crashes on Windows 2000 |
2500 | |
2501 | Several porters have reported mysterious crashes when Perl's entire test suite is run after a build on certain Windows 2000 systems. When run by hand, the individual tests reportedly work fine. |
2502 | |
2503 | =item * |
2504 | |
2505 | Known test failures on VMS |
2506 | |
2507 | Perl 5.11.1 fails a small set of core and CPAN tests as of this release. |
2508 | With luck, that'll be sorted out for 5.11.2 |
2509 | |
2510 | =item * |
2511 | |
2512 | Known test failures on VMS |
2513 | |
2514 | Perl 5.11.2 fails a small set of core and CPAN tests as of this |
2515 | release. With luck, that'll be sorted out for 5.11.3. |
2516 | |
2517 | =back |
2518 | |
2519 | =head1 Acknowledgements |
2520 | |
2521 | Perl 5.12.0 represents approximately two years of development since |
2522 | Perl 5.10.0 and contains __ lines of changes across ___ files |
2523 | from __ authors and committers: |
2524 | |
2525 | XXX TODO LIST |
2526 | |
2527 | Many of the changes included in this version originated in the CPAN |
2528 | modules included in Perl's core. We're grateful to the entire CPAN |
2529 | community for helping Perl to flourish. |
2530 | |
2531 | =head1 Reporting Bugs |
2532 | |
2533 | If you find what you think is a bug, you might check the articles |
2534 | recently posted to the comp.lang.perl.misc newsgroup and the perl |
2535 | bug database at L<http://rt.perl.org/perlbug/>. There may also be |
2536 | information at L<http://www.perl.org/>, the Perl Home Page. |
2537 | |
2538 | If you believe you have an unreported bug, please run the B<perlbug> |
2539 | program included with your release. Be sure to trim your bug down |
2540 | to a tiny but sufficient test case. Your bug report, along with the |
2541 | output of C<perl -V>, will be sent off to perlbug@perl.org to be |
2542 | analyzed by the Perl porting team. |
2543 | |
2544 | If the bug you are reporting has security implications, which make it |
2545 | inappropriate to send to a publicly archived mailing list, then please send |
2546 | it to perl5-security-report@perl.org. This points to a closed subscription |
2547 | unarchived mailing list, which includes all the core committers, who be able |
2548 | to help assess the impact of issues, figure out a resolution, and help |
2549 | co-ordinate the release of patches to mitigate or fix the problem across all |
2550 | platforms on which Perl is supported. Please only use this address for |
2551 | security issues in the Perl core, not for modules independently |
2552 | distributed on CPAN. |
2553 | |
2554 | =head1 SEE ALSO |
2555 | |
2556 | The F<Changes> file for an explanation of how to view exhaustive details |
2557 | on what changed. |
2558 | |
2559 | The F<INSTALL> file for how to build Perl. |
2560 | |
2561 | The F<README> file for general stuff. |
2562 | |
2563 | The F<Artistic> and F<Copying> files for copyright information. |
2564 | |
2565 | =cut |