Commit | Line | Data |
---|---|---|
44691e6f AB |
1 | =encoding utf8 |
2 | ||
3 | =head1 NAME | |
4 | ||
8c8d6154 SH |
5 | [ this is a template for a new perldelta file. Any text flagged as XXX needs |
6 | to be processed before release. ] | |
7 | ||
8 | perldelta - what is new for perl v5.21.5 | |
c68523cb | 9 | |
238894db | 10 | =head1 DESCRIPTION |
c68523cb | 11 | |
8c8d6154 | 12 | This document describes differences between the 5.21.4 release and the 5.21.5 |
238894db | 13 | release. |
c68523cb | 14 | |
8c8d6154 SH |
15 | If you are upgrading from an earlier release such as 5.21.3, first read |
16 | L<perl5214delta>, which describes differences between 5.21.3 and 5.21.4. | |
8435afd1 | 17 | |
8c8d6154 | 18 | =head1 Notice |
8435afd1 | 19 | |
8c8d6154 | 20 | XXX Any important notices here |
5cfa0642 | 21 | |
8c8d6154 | 22 | =head1 Core Enhancements |
5cfa0642 | 23 | |
8c8d6154 SH |
24 | XXX New core language features go here. Summarize user-visible core language |
25 | enhancements. Particularly prominent performance optimisations could go | |
26 | here, but most should go in the L</Performance Enhancements> section. | |
8435afd1 | 27 | |
8c8d6154 | 28 | [ List each enhancement as a =head2 entry ] |
8435afd1 | 29 | |
4cad5dc8 FC |
30 | =head2 New double-diamond operator |
31 | ||
4a573b25 | 32 | C<<< <<>> >>> is like C<< <> >> but uses three-argument C<open> to open |
4cad5dc8 FC |
33 | each file in @ARGV. So each element of @ARGV is an actual file name, and |
34 | "|foo" won't be treated as a pipe open. | |
35 | ||
a5591204 FC |
36 | =head2 Aliasing via reference |
37 | ||
38 | Variables and subroutines can now be aliased by assigning to a reference: | |
39 | ||
40 | \$c = \$d; | |
41 | \&x = \&y; | |
42 | ||
43 | Or by using a backslash before a C<foreach> iterator variable, which is | |
44 | perhaps the most useful idiom this feature provides: | |
45 | ||
46 | foreach \%hash (@array_of_hash_refs) { ... } | |
47 | ||
48 | This feature is experimental and must be enabled via C<use feature | |
49 | 'refaliasing'>. It will warn unless the C<experimental::refaliasing> | |
50 | warnings category is disabled. | |
51 | ||
52 | See L<perlref/Assigning to References>. | |
53 | ||
b15c1b56 AF |
54 | =head2 Perl now supports POSIX 2008 locale currency additions. |
55 | ||
56 | On platforms that are able to handle POSIX.1-2008, the | |
57 | hash returned by | |
58 | L<C<POSIX::localeconv()>|perllocale/The localeconv function> | |
59 | includes the international currency fields added by that version of the | |
60 | POSIX standard. These are | |
61 | C<int_n_cs_precedes>, | |
62 | C<int_n_sep_by_space>, | |
63 | C<int_n_sign_posn>, | |
64 | C<int_p_cs_precedes>, | |
65 | C<int_p_sep_by_space>, | |
66 | and | |
67 | C<int_p_sign_posn>. | |
68 | ||
8c8d6154 | 69 | =head1 Security |
5cfa0642 | 70 | |
ba474e87 JH |
71 | =head2 Perl is now compiled with -fstack-protector-strong if available |
72 | ||
73 | Perl has been compiled with the anti-stack-smashing option | |
74 | C<-fstack-protector> since 5.10.1. Now Perl uses the newer variant | |
75 | called C<-fstack-protector-strong>, if available. (This was added | |
76 | already in 5.21.4.) | |
8435afd1 | 77 | |
8c8d6154 | 78 | [ List each security issue as a =head2 entry ] |
8435afd1 | 79 | |
8c8d6154 | 80 | =head1 Incompatible Changes |
5cfa0642 | 81 | |
8c8d6154 | 82 | XXX For a release on a stable branch, this section aspires to be: |
8435afd1 | 83 | |
8c8d6154 SH |
84 | There are no changes intentionally incompatible with 5.XXX.XXX |
85 | If any exist, they are bugs, and we request that you submit a | |
86 | report. See L</Reporting Bugs> below. | |
5b319db8 | 87 | |
8c8d6154 | 88 | [ List each incompatible change as a =head2 entry ] |
5cfa0642 | 89 | |
8c8d6154 | 90 | =head1 Deprecations |
d0ab07ee | 91 | |
8c8d6154 | 92 | XXX Any deprecated features, syntax, modules etc. should be listed here. |
d0ab07ee | 93 | |
8c8d6154 | 94 | =head2 Module removals |
5cfa0642 | 95 | |
8c8d6154 | 96 | XXX Remove this section if inapplicable. |
d0ab07ee | 97 | |
8c8d6154 SH |
98 | The following modules will be removed from the core distribution in a |
99 | future release, and will at that time need to be installed from CPAN. | |
100 | Distributions on CPAN which require these modules will need to list them as | |
101 | prerequisites. | |
8435afd1 | 102 | |
8c8d6154 SH |
103 | The core versions of these modules will now issue C<"deprecated">-category |
104 | warnings to alert you to this fact. To silence these deprecation warnings, | |
105 | install the modules in question from CPAN. | |
46274848 | 106 | |
8c8d6154 SH |
107 | Note that these are (with rare exceptions) fine modules that you are encouraged |
108 | to continue to use. Their disinclusion from core primarily hinges on their | |
109 | necessity to bootstrapping a fully functional, CPAN-capable Perl installation, | |
110 | not usually on concerns over their design. | |
46274848 | 111 | |
8c8d6154 | 112 | =over |
d0ab07ee | 113 | |
8c8d6154 | 114 | =item XXX |
5cfa0642 | 115 | |
8c8d6154 SH |
116 | XXX Note that deprecated modules should be listed here even if they are listed |
117 | as an updated module in the L</Modules and Pragmata> section. | |
5cfa0642 | 118 | |
8c8d6154 | 119 | =back |
8435afd1 | 120 | |
cc4d09e1 KW |
121 | =head2 Use of multiple /x regexp modifiers |
122 | ||
123 | It is now deprecated to say something like any of the following: | |
124 | ||
125 | qr/foo/xx; | |
126 | /(?xax:foo)/; | |
127 | use re qw(/amxx); | |
128 | ||
129 | That is, now C<x> should only occur once in any string of contiguous | |
130 | regular expression pattern modifiers. We do not believe there are any | |
131 | occurrences of this in all of CPAN. This is in preparation for a future | |
132 | Perl release having C</xx> mean to allow white-space for readability in | |
133 | bracketed character classes (those enclosed in square brackets: | |
134 | C<[...]>). | |
8435afd1 | 135 | |
8c8d6154 | 136 | =head1 Performance Enhancements |
5cfa0642 | 137 | |
8c8d6154 SH |
138 | XXX Changes which enhance performance without changing behaviour go here. |
139 | There may well be none in a stable release. | |
8435afd1 | 140 | |
8c8d6154 | 141 | [ List each enhancement as a =item entry ] |
8435afd1 | 142 | |
8c8d6154 | 143 | =over 4 |
5cfa0642 | 144 | |
8435afd1 SH |
145 | =item * |
146 | ||
1dc08634 FC |
147 | C<length> is up to 20% faster for non-magical/non-tied scalars containing a |
148 | string if it is a non-utf8 string or if C<use bytes;> is in scope. | |
5cfa0642 | 149 | |
5b306eef DD |
150 | =item * |
151 | ||
152 | Non-magical/non-tied scalars that contain only a floating point value and are | |
153 | on most Perl builds with 64 bit integers now use 8-32 less bytes of memory | |
154 | depending on OS. | |
155 | ||
357205d5 FC |
156 | =item * |
157 | ||
158 | In C<@array = split>, the assigment can be optimised away with C<split> | |
159 | writing directly to the array. This optimisation was happening only for | |
3a9cf875 FC |
160 | package arrays other than @_ and only |
161 | sometimes. Now this optimisation happens | |
357205d5 FC |
162 | almost all the time. |
163 | ||
f704f251 FC |
164 | =item * |
165 | ||
166 | C<join> is now subject to constant folding. Moreover, C<join> with a | |
167 | scalar or constant for the separator and a single-item list to join is | |
168 | simplified to a stringification. The separator doesn't even get evaluated. | |
169 | ||
0cb3abac FC |
170 | =item * |
171 | ||
172 | C<qq(@array)> is implemented using two ops: a stringify op and a join op. | |
173 | If the qq contains nothing but a single array, the stringification is | |
174 | optimised away. | |
175 | ||
deec1830 FC |
176 | =item * |
177 | ||
178 | C<our $var> and C<our($s,@a,%h)> in void context are no longer evaluated at | |
179 | run time. Even a whole sequence of C<our $foo;> statements will simply be | |
180 | skipped over. | |
181 | ||
8c8d6154 | 182 | =back |
d0ab07ee | 183 | |
8c8d6154 | 184 | =head1 Modules and Pragmata |
d0ab07ee | 185 | |
8c8d6154 SH |
186 | XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/> |
187 | go here. If Module::CoreList is updated, generate an initial draft of the | |
188 | following sections using F<Porting/corelist-perldelta.pl>. A paragraph summary | |
189 | for important changes should then be added by hand. In an ideal world, | |
190 | dual-life modules would have a F<Changes> file that could be cribbed. | |
5cfa0642 | 191 | |
8c8d6154 | 192 | [ Within each section, list entries as a =item entry ] |
8435afd1 | 193 | |
8c8d6154 | 194 | =head2 New Modules and Pragmata |
8435afd1 | 195 | |
8c8d6154 | 196 | =over 4 |
5cfa0642 | 197 | |
8435afd1 SH |
198 | =item * |
199 | ||
8c8d6154 | 200 | XXX |
5cfa0642 | 201 | |
39c4a6cf | 202 | =back |
9c97a342 | 203 | |
8c8d6154 | 204 | =head2 Updated Modules and Pragmata |
d99849ae | 205 | |
39c4a6cf | 206 | =over 4 |
d99849ae | 207 | |
ff433f2d PM |
208 | =item * |
209 | ||
6fa0b0fd TC |
210 | L<attributes> has been upgraded from version 0.23 to 0.24. |
211 | ||
212 | Avoid reading beyond the end of a buffer. [perl #122629] | |
213 | ||
214 | =item * | |
215 | ||
432450d2 FC |
216 | L<B::Deparse> has been upgraded from version 1.28 to 1.29. |
217 | ||
218 | Parenthesised arrays in lists passed to C<\> are now correctly deparsed | |
219 | with parentheses (e.g., C<\(@a, (@b), @c)> now retains the parentheses | |
220 | around @b), this preserving the flattening behaviour of referenced | |
221 | parenthesised arrays. Formerly, it only worked for one array: C<\(@a)>. | |
222 | ||
4e3e9c07 FC |
223 | C<local our> is now deparsed correctly, with the C<our> included. |
224 | ||
4a9fafe5 FC |
225 | C<for($foo; !$bar; $baz) {...}> was deparsed without the C<!> (or C<not>). |
226 | This has been fixed. | |
227 | ||
f03d0d50 FC |
228 | Core keywords that conflict with lexical subroutines are now deparsed with |
229 | the C<CORE::> prefix. | |
230 | ||
c3f18a8f FC |
231 | C<foreach state $x (...) {...}> now deparses correctly with C<state> and |
232 | not C<my>. | |
233 | ||
852ef7e9 FC |
234 | C<our @array = split(...)> now deparses correctly with C<our> in those |
235 | cases where the assignment is optimised away. | |
236 | ||
432450d2 FC |
237 | =item * |
238 | ||
cbfcbc14 TC |
239 | L<DynaLoader> has been upgraded from version 1.26 to 1.27. |
240 | ||
241 | Remove dl_nonlazy global if unused in Dynaloader. [perl #122926] | |
242 | ||
243 | =item * | |
244 | ||
7635ad4d TC |
245 | L<Fcntl> has been upgraded from version 1.12 to 1.13. |
246 | ||
247 | Add support for the Linux pipe buffer size fcntl() commands. | |
248 | ||
249 | =item * | |
250 | ||
f4eedc6b DD |
251 | L<File::Find> has been upgraded from version 1.28 to 1.29. |
252 | ||
253 | Slightly faster module loading time. | |
254 | ||
255 | =item * | |
256 | ||
84d03adf SH |
257 | L<Module::CoreList> has been upgraded from version 5.20140920 to 5.20141020. |
258 | ||
259 | Updated to cover the latest releases of Perl. | |
ff433f2d | 260 | |
4cd408ba TC |
261 | =item * |
262 | ||
f4eedc6b DD |
263 | The PathTools module collection has been upgraded from version 3.50 to 3.51. |
264 | ||
265 | Slightly faster module loading time. | |
266 | ||
267 | =item * | |
268 | ||
0561e60b TC |
269 | L<POSIX> has been upgraded from version 1.44 to 1.45. |
270 | ||
271 | POSIX::tmpnam() now produces a deprecation warning. [perl #122005] | |
272 | ||
273 | =item * | |
274 | ||
4cd408ba TC |
275 | L<XSLoader> has been upgraded from version 0.17 to 0.18. |
276 | ||
277 | Allow XSLoader to load modules from a different namespace. | |
278 | [perl #122455] | |
279 | ||
13900f93 | 280 | =back |
aac7f82f | 281 | |
8c8d6154 | 282 | =head2 Removed Modules and Pragmata |
aac7f82f | 283 | |
5cfa0642 | 284 | =over 4 |
6d9b7c7c | 285 | |
5cfa0642 | 286 | =item * |
2a395b86 | 287 | |
8c8d6154 | 288 | XXX |
2a395b86 | 289 | |
5cfa0642 | 290 | =back |
2a395b86 | 291 | |
8c8d6154 | 292 | =head1 Documentation |
2a395b86 | 293 | |
8c8d6154 SH |
294 | XXX Changes to files in F<pod/> go here. Consider grouping entries by |
295 | file and be sure to link to the appropriate page, e.g. L<perlfunc>. | |
5cfa0642 | 296 | |
8c8d6154 | 297 | =head2 New Documentation |
39c4a6cf | 298 | |
8c8d6154 | 299 | XXX Changes which create B<new> files in F<pod/> go here. |
2a395b86 | 300 | |
8c8d6154 | 301 | =head3 L<XXX> |
2a395b86 | 302 | |
8c8d6154 | 303 | XXX Description of the purpose of the new file here |
2a395b86 | 304 | |
8c8d6154 | 305 | =head2 Changes to Existing Documentation |
8435afd1 | 306 | |
8c8d6154 SH |
307 | XXX Changes which significantly change existing files in F<pod/> go here. |
308 | However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics> | |
309 | section. | |
8435afd1 | 310 | |
8c8d6154 | 311 | =head3 L<XXX> |
8435afd1 SH |
312 | |
313 | =over 4 | |
2a395b86 | 314 | |
12d22d1f JK |
315 | =item * |
316 | ||
09e43397 KW |
317 | Clarifications have been added to L<perlrecharclass/Character Ranges> |
318 | to the effect that Perl guarantees that C<[A-Z]>, C<[a-z]>, C<[0-9]> and | |
319 | any subranges thereof in regular expression bracketed character classes | |
320 | are guaranteed to match exactly what a naive English speaker would | |
321 | expect them to match, even on platforms (such as EBCDIC) where special | |
322 | handling is required to accomplish this. | |
12d22d1f | 323 | |
2a395b86 PM |
324 | =back |
325 | ||
39c4a6cf | 326 | =head1 Diagnostics |
2a395b86 | 327 | |
39c4a6cf PM |
328 | The following additions or changes have been made to diagnostic output, |
329 | including warnings and fatal error messages. For the complete list of | |
330 | diagnostic messages, see L<perldiag>. | |
2a395b86 | 331 | |
8c8d6154 SH |
332 | XXX New or changed warnings emitted by the core's C<C> code go here. Also |
333 | include any changes in L<perldiag> that reconcile it to the C<C> code. | |
2a395b86 | 334 | |
8c8d6154 | 335 | =head2 New Diagnostics |
2a395b86 | 336 | |
8c8d6154 SH |
337 | XXX Newly added diagnostic messages go under here, separated into New Errors |
338 | and New Warnings | |
2a395b86 | 339 | |
8c8d6154 | 340 | =head3 New Errors |
5cfa0642 | 341 | |
8c8d6154 | 342 | =over 4 |
2a395b86 PM |
343 | |
344 | =item * | |
345 | ||
8c8d6154 | 346 | XXX L<message|perldiag/"message"> |
2a395b86 PM |
347 | |
348 | =back | |
6d9b7c7c | 349 | |
8c8d6154 | 350 | =head3 New Warnings |
39c4a6cf | 351 | |
13900f93 | 352 | =over 4 |
7f55cec0 SH |
353 | |
354 | =item * | |
355 | ||
8c8d6154 | 356 | XXX L<message|perldiag/"message"> |
623141a1 | 357 | |
8c8d6154 | 358 | =back |
aac7f82f | 359 | |
8c8d6154 | 360 | =head2 Changes to Existing Diagnostics |
363d3025 | 361 | |
8c8d6154 | 362 | XXX Changes (i.e. rewording) of diagnostic messages go here |
334464b3 | 363 | |
8c8d6154 | 364 | =over 4 |
334464b3 FC |
365 | |
366 | =item * | |
367 | ||
dbe3c929 FC |
368 | '"my" variable &foo::bar can't be in a package' has been reworded to say |
369 | 'subroutine' instead of 'variable'. | |
ef5a9509 | 370 | |
363d3025 FC |
371 | =back |
372 | ||
8c8d6154 | 373 | =head1 Utility Changes |
4594cf53 | 374 | |
8c8d6154 SH |
375 | XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go here. |
376 | Most of these are built within the directory F<utils>. | |
96dcbc37 | 377 | |
8c8d6154 SH |
378 | [ List utility changes as a =head2 entry for each utility and =item |
379 | entries for each change | |
380 | Use L<XXX> with program names to get proper documentation linking. ] | |
96dcbc37 | 381 | |
8c8d6154 | 382 | =head2 L<XXX> |
13900f93 | 383 | |
8c8d6154 | 384 | =over 4 |
58f25ac1 MH |
385 | |
386 | =item * | |
387 | ||
8c8d6154 | 388 | XXX |
a5873648 | 389 | |
39c4a6cf | 390 | =back |
a5873648 | 391 | |
55ba8847 JH |
392 | =head1 Configuration and Compilation |
393 | ||
8c8d6154 SH |
394 | XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools |
395 | go here. Any other changes to the Perl build process should be listed here. | |
396 | However, any platform-specific changes should be listed in the | |
397 | L</Platform Support> section, instead. | |
55ba8847 | 398 | |
8c8d6154 | 399 | [ List changes as a =item entry ]. |
a5873648 | 400 | |
39c4a6cf | 401 | =over 4 |
a5873648 PM |
402 | |
403 | =item * | |
404 | ||
8c8d6154 | 405 | XXX |
7d0ccdba | 406 | |
7065301c RS |
407 | =back |
408 | ||
8c8d6154 | 409 | =head1 Testing |
d72cd2eb | 410 | |
8c8d6154 SH |
411 | XXX Any significant changes to the testing of a freshly built perl should be |
412 | listed here. Changes which create B<new> files in F<t/> go here as do any | |
413 | large changes to the testing harness (e.g. when parallel testing was added). | |
414 | Changes to existing files in F<t/> aren't worth summarizing, although the bugs | |
415 | that they represent may be covered elsewhere. | |
c1284011 | 416 | |
8c8d6154 | 417 | [ List each test improvement as a =item entry ] |
375f5f06 | 418 | |
0346c3a9 | 419 | =over 4 |
375f5f06 | 420 | |
2884baee MH |
421 | =item * |
422 | ||
8c8d6154 | 423 | XXX |
6f1a844b | 424 | |
8c8d6154 | 425 | =back |
549ea8d4 | 426 | |
8c8d6154 | 427 | =head1 Platform Support |
549ea8d4 | 428 | |
8c8d6154 | 429 | XXX Any changes to platform support should be listed in the sections below. |
be0006e0 | 430 | |
8c8d6154 SH |
431 | [ Within the sections, list each platform as a =item entry with specific |
432 | changes as paragraphs below it. ] | |
be0006e0 | 433 | |
8c8d6154 | 434 | =head2 New Platforms |
1699f5c2 | 435 | |
8c8d6154 SH |
436 | XXX List any platforms that this version of perl compiles on, that previous |
437 | versions did not. These will either be enabled by new files in the F<hints/> | |
438 | directories, or new subdirectories and F<README> files at the top level of the | |
439 | source tree. | |
1699f5c2 | 440 | |
8c8d6154 | 441 | =over 4 |
7e8b2071 | 442 | |
8c8d6154 | 443 | =item XXX-some-platform |
7e8b2071 | 444 | |
8c8d6154 | 445 | XXX |
f9acf899 | 446 | |
8c8d6154 | 447 | =back |
f9acf899 | 448 | |
8c8d6154 | 449 | =head2 Discontinued Platforms |
fd26b6f0 | 450 | |
8c8d6154 | 451 | XXX List any platforms that this version of perl no longer compiles on. |
fd26b6f0 | 452 | |
8c8d6154 | 453 | =over 4 |
499333dc | 454 | |
8c8d6154 | 455 | =item XXX-some-platform |
499333dc | 456 | |
8c8d6154 | 457 | XXX |
8f0cd35a | 458 | |
8c8d6154 | 459 | =back |
8f0cd35a | 460 | |
8c8d6154 | 461 | =head2 Platform-Specific Notes |
aa292ef2 | 462 | |
8c8d6154 SH |
463 | XXX List any changes for specific platforms. This could include configuration |
464 | and compilation changes or changes in portability/compatibility. However, | |
465 | changes within modules for platforms should generally be listed in the | |
466 | L</Modules and Pragmata> section. | |
aa292ef2 | 467 | |
8c8d6154 | 468 | =over 4 |
739e9bee | 469 | |
09e43397 | 470 | =item EBCDIC |
739e9bee | 471 | |
09e43397 KW |
472 | Special handling is required on EBCDIC platforms to get C<qr/[i-j]/> to |
473 | match only C<"i"> and C<"j">, since there are 7 characters between the | |
474 | code points for C<"i"> and C<"j">. This special handling had only been | |
475 | invoked when both ends of the range are literals. Now it is also | |
476 | invoked if any of the C<\N{...}> forms for specifying a character by | |
477 | name or Unicode code point is used instead of a literal. See | |
478 | L<perlrecharclass/Character Ranges>. | |
b23b2fdb | 479 | |
8c8d6154 | 480 | =back |
b23b2fdb | 481 | |
8c8d6154 | 482 | =head1 Internal Changes |
7d15b1a8 | 483 | |
8c8d6154 SH |
484 | XXX Changes which affect the interface available to C<XS> code go here. Other |
485 | significant internal changes for future core maintainers should be noted as | |
486 | well. | |
7d15b1a8 | 487 | |
8c8d6154 | 488 | [ List each change as a =item entry ] |
bbca64cf | 489 | |
8c8d6154 | 490 | =over 4 |
bbca64cf | 491 | |
0064f8cc KW |
492 | =item * |
493 | ||
13203cef FC |
494 | SVs of type SVt_NV are now bodyless when a build configure and platform allow |
495 | it, specifically C<sizeof(NV) <= sizeof(IV)>. The bodyless trick is the same one | |
496 | as for IVs since 5.9.2, but for NVs, unlike IVs, is not guarenteed on all | |
497 | platforms and build configurations. | |
6ff8f256 | 498 | |
1b4c7150 TC |
499 | =item * |
500 | ||
501 | The C<$DB::single>, C<$DB::signal> and C<$DB::trace> now have set and | |
502 | get magic that stores their values as IVs and those IVs are used when | |
503 | testing their values in C<pp_dbstate>. This prevents perl from | |
504 | recursing infinity if an overloaded object is assigned to any of those | |
505 | variables. [perl #122445] | |
506 | ||
a953aca5 DD |
507 | =item * |
508 | ||
509 | C<Perl_tmps_grow> which is marked as public API but undocumented has been | |
510 | removed from public API. If you use C<EXTEND_MORTAL> macro in your XS code to | |
511 | preextend the mortal stack, you are unaffected by this change. | |
512 | ||
8405c65d FC |
513 | =item * |
514 | ||
515 | C<cv_name>, which was introduced in 5.21.4, has been changed incompatibly. | |
516 | It now has a flags field that allows the caller to specify whether the name | |
517 | should be fully qualified. See L<perlapi/cv_name>. | |
518 | ||
8e2708f3 FC |
519 | =item * |
520 | ||
521 | Internally Perl no longer uses the C<SVs_PADMY> flag. C<SvPADMY()> now | |
522 | returns a true value for anything not marked PADTMP. C<SVs_PADMY> is now | |
523 | defined as 0. | |
524 | ||
8c8d6154 | 525 | =back |
6ff8f256 | 526 | |
8c8d6154 | 527 | =head1 Selected Bug Fixes |
80cc3290 | 528 | |
8c8d6154 SH |
529 | XXX Important bug fixes in the core language are summarized here. Bug fixes in |
530 | files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>. | |
80cc3290 | 531 | |
8c8d6154 | 532 | [ List each fix as a =item entry ] |
13dd5671 | 533 | |
8c8d6154 | 534 | =over 4 |
13dd5671 | 535 | |
bdab7676 FC |
536 | =item * |
537 | ||
227d08c8 FC |
538 | Locking and unlocking values via L<Hash::Util> or C<Internals::SvREADONLY> |
539 | no longer has any affect on values that are read-only to begin. Unlocking | |
540 | such values could result in crashes, hangs or other erratic behaviour. | |
bdab7676 | 541 | |
94959c63 FC |
542 | =item * |
543 | ||
544 | The internal C<looks_like_number> function (which L<Scalar::Util> provides | |
545 | access to) began erroneously to return true for "-e1" in 5.21.4, affecting | |
546 | also C<-'-e1'>. This has been fixed. | |
547 | ||
24d3d8cd FC |
548 | =item * |
549 | ||
550 | The flip-flop operator (C<..> in scalar context) would return the same | |
b9de5fa2 | 551 | scalar each time, unless the containing subroutine was called recursively. |
24d3d8cd FC |
552 | Now it always returns a new scalar. [perl #122829] |
553 | ||
02dde543 FC |
554 | =item * |
555 | ||
556 | Some unterminated C<(?(...)...)> constructs in regular expressions would | |
557 | either crash or give erroneous error messages. C</(?(1)/> is one such | |
558 | example. | |
559 | ||
5058ae74 FC |
560 | =item * |
561 | ||
562 | C<pack "w", $tied> no longer calls FETCH twice. | |
563 | ||
14937635 FC |
564 | =item * |
565 | ||
566 | List assignments like C<($x, $z) = (1, $y)> now work correctly if $x and $y | |
567 | have been aliased by C<foreach>. | |
568 | ||
325f4225 FC |
569 | =item * |
570 | ||
571 | Some patterns including code blocks with syntax errors, such as | |
572 | C</ (?{(^{})/>, would hang or fail assertions on debugging builds. Now | |
573 | they produce errors. | |
574 | ||
c1662923 FC |
575 | =item * |
576 | ||
577 | An assertion failure when parsing C<sort> with debugging enabled has been | |
578 | fixed. [perl #122771] | |
579 | ||
7646b3d5 FC |
580 | =item * |
581 | ||
582 | C<*a = *b; @a = split //, $b[1]> could do a bad read and produce junk | |
583 | results. | |
584 | ||
db98db4e FC |
585 | =item * |
586 | ||
587 | In C<() = @array = split>, the C<() => at the beginning no longer confuses | |
588 | the optimiser, making it assume a limit of 1. | |
589 | ||
8818afe8 TC |
590 | =item * |
591 | ||
592 | Fatal warnings no longer prevent the output of syntax errors. | |
593 | [perl #122966] | |
594 | ||
8c8d6154 | 595 | =back |
3a085d00 | 596 | |
8c8d6154 | 597 | =head1 Known Problems |
caa66803 | 598 | |
8c8d6154 SH |
599 | XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any |
600 | tests that had to be C<TODO>ed for the release would be noted here. Unfixed | |
601 | platform specific bugs also go here. | |
caa66803 | 602 | |
8c8d6154 | 603 | [ List each fix as a =item entry ] |
91766151 | 604 | |
8c8d6154 | 605 | =over 4 |
91766151 | 606 | |
dd593f1d FC |
607 | =item * |
608 | ||
8c8d6154 | 609 | XXX |
fb3b7425 | 610 | |
8c8d6154 | 611 | =back |
fb3b7425 | 612 | |
8c8d6154 | 613 | =head1 Errata From Previous Releases |
b245455d | 614 | |
8c8d6154 | 615 | =over 4 |
b245455d | 616 | |
26dd5fd6 PM |
617 | =item * |
618 | ||
8c8d6154 SH |
619 | XXX Add anything here that we forgot to add, or were mistaken about, in |
620 | the perldelta of a previous release. | |
ff433f2d | 621 | |
39c4a6cf PM |
622 | =back |
623 | ||
8c8d6154 | 624 | =head1 Obituary |
c0c55a9b | 625 | |
8c8d6154 SH |
626 | XXX If any significant core contributor has died, we've added a short obituary |
627 | here. | |
c0c55a9b | 628 | |
8c8d6154 | 629 | =head1 Acknowledgements |
c0c55a9b | 630 | |
8c8d6154 | 631 | XXX Generate this with: |
e831f11a | 632 | |
8c8d6154 | 633 | perl Porting/acknowledgements.pl v5.21.4..HEAD |
f5b73711 | 634 | |
44691e6f AB |
635 | =head1 Reporting Bugs |
636 | ||
e08634c5 SH |
637 | If you find what you think is a bug, you might check the articles recently |
638 | posted to the comp.lang.perl.misc newsgroup and the perl bug database at | |
238894db | 639 | https://rt.perl.org/ . There may also be information at |
7ef8b31d | 640 | http://www.perl.org/ , the Perl Home Page. |
44691e6f | 641 | |
e08634c5 SH |
642 | If you believe you have an unreported bug, please run the L<perlbug> program |
643 | included with your release. Be sure to trim your bug down to a tiny but | |
644 | sufficient test case. Your bug report, along with the output of C<perl -V>, | |
645 | will be sent off to perlbug@perl.org to be analysed by the Perl porting team. | |
44691e6f AB |
646 | |
647 | If the bug you are reporting has security implications, which make it | |
e08634c5 SH |
648 | inappropriate to send to a publicly archived mailing list, then please send it |
649 | to perl5-security-report@perl.org. This points to a closed subscription | |
650 | unarchived mailing list, which includes all the core committers, who will be | |
651 | able to help assess the impact of issues, figure out a resolution, and help | |
f9001595 | 652 | co-ordinate the release of patches to mitigate or fix the problem across all |
e08634c5 SH |
653 | platforms on which Perl is supported. Please only use this address for |
654 | security issues in the Perl core, not for modules independently distributed on | |
655 | CPAN. | |
44691e6f AB |
656 | |
657 | =head1 SEE ALSO | |
658 | ||
e08634c5 SH |
659 | The F<Changes> file for an explanation of how to view exhaustive details on |
660 | what changed. | |
44691e6f AB |
661 | |
662 | The F<INSTALL> file for how to build Perl. | |
663 | ||
664 | The F<README> file for general stuff. | |
665 | ||
666 | The F<Artistic> and F<Copying> files for copyright information. | |
667 | ||
668 | =cut |