This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Add perldelta for /aa and \b commit
[perl5.git] / pod / perldelta.pod
1 =encoding utf8
2
3 =head1 NAME
4
5 [ this is a template for a new perldelta file. Any text flagged as
6 XXX needs to be processed before release. ]
7
8 perldelta - what is new for perl v5.15.2
9
10 =head1 DESCRIPTION
11
12 This document describes differences between the 5.15.1 release and
13 the 5.15.2 release.
14
15 If you are upgrading from an earlier release such as 5.15.0, first read
16 L<perl5151delta>, which describes differences between 5.15.0 and
17 5.15.1.
18
19 =head1 Notice
20
21 XXX Any important notices here
22
23 =head1 Core Enhancements
24
25 XXX New core language features go here. Summarise user-visible core language
26 enhancements. Particularly prominent performance optimisations could go
27 here, but most should go in the L</Performance Enhancements> section.
28
29 [ List each enhancement as a =head2 entry ]
30
31 =head1 Security
32
33 XXX Any security-related notices go here.  In particular, any security
34 vulnerabilities closed should be noted here rather than in the
35 L</Selected Bug Fixes> section.
36
37 [ List each security issue as a =head2 entry ]
38
39 =head1 Incompatible Changes
40
41 XXX For a release on a stable branch, this section aspires to be:
42
43     There are no changes intentionally incompatible with 5.XXX.XXX
44     If any exist, they are bugs and reports are welcome.
45
46 [ List each incompatible change as a =head2 entry ]
47
48 =head2 C<UNIVERSAL::VERSION> now returns $VERSION
49
50 C<UNIVERSAL::VERSION> now return whatever is in $VERSION, instead of
51 returning $VERSION converted to a version object and then to a string.
52 As a result, it no longer parses the version when called without arguments,
53 so it no longer dies in that case for malformed versions.  This allows
54 custom version number parsers to use C<< ->VERSION >> to retrieve the
55 version number, as was the case in Perl 5.8 [perl #95544].
56
57 =head1 Deprecations
58
59 XXX Any deprecated features, syntax, modules etc. should be listed here.
60 In particular, deprecated modules should be listed here even if they are
61 listed as an updated module in the L</Modules and Pragmata> section.
62
63 [ List each deprecation as a =head2 entry ]
64
65 =head1 Performance Enhancements
66
67 XXX Changes which enhance performance without changing behaviour go here. There
68 may well be none in a stable release.
69
70 [ List each enhancement as a =item entry ]
71
72 =over 4
73
74 =item *
75
76 XXX
77
78 =back
79
80 =head1 Modules and Pragmata
81
82 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
83 go here.  If Module::CoreList is updated, generate an initial draft of the
84 following sections using F<Porting/corelist-perldelta.pl>, which prints stub
85 entries to STDOUT.  Results can be pasted in place of the '=head2' entries
86 below.  A paragraph summary for important changes should then be added by hand.
87 In an ideal world, dual-life modules would have a F<Changes> file that could be
88 cribbed.
89
90 [ Within each section, list entries as a =item entry ]
91
92 =head2 New Modules and Pragmata
93
94 =over 4
95
96 =item *
97
98 XXX
99
100 =back
101
102 =head2 Updated Modules and Pragmata
103
104 =over 4
105
106 =item *
107
108 L<CPAN> has been upgraded from version 1.9600 to version 1.9800
109
110 =item *
111
112 L<CPANPLUS> has been upgraded from version 0.9108 to version 0.9109
113
114 Fixed support for v-strings and x.y.z versions with v5.8.4
115
116 =item *
117
118 L<CPAN::Meta> has been upgraded from version 2.110930_001 to version 2.112150
119
120 Stringify any objects encountered during conversion.
121
122 Clarified that file paths in the 'provides' section must be in
123 Unix-style (i.e. forward slashes)
124
125 =item *
126
127 L<DB_File> has been upgraded from version 1.822 to version 1.824
128
129 Will now croak if attempt to freeze/thaw DB_File object [RT #69985]
130
131 =item *
132
133 L<Encode> has been upgraded from version 2.43 to version 2.44
134
135 Addressed 'decode_xs n-byte heap-overflow' security bug in Unicode.xs
136
137 =item *
138
139 L<ExtUtils::Install> has been upgraded from version 1.56 to version 1.57.
140
141 There is no change to ExtUtils::Install other than the version number
142 increase, but L<ExtUtils::Installed> has been upgraded from version 1.999_001
143 to version 1.999002 and a new C<skip_cwd> attribute has been added.
144
145 =item *
146
147 L<ExtUtils::MakeMaker> has been upgraded from version 6.58 to version 6.59
148
149 =item *
150
151 L<IPC::Open3> has been upgraded from version 1.11 to 1.12.
152
153 C<open3> with "-" for the program name works once more.  This was broken in
154 version 1.06 (and hence in Perl 5.14.0) [perl #95748].
155
156 =item *
157
158 L<Module::Build> has been upgraded from version 0.3800 to version 0.39_01.
159
160 Pod to HTML internals changed to support revisions to Pod::Html in core.
161 Also fixes some minor bugs. [rt.cpan.org #68585] [rt.cpan.org #67893]
162 [rt.cpan.org #67008]
163
164 =item *
165
166 L<Module::Load> has been upgraded from version 0.18 to version 0.20
167
168 =item *
169
170 L<Module::Metadata> has been upgraded from version 1.000004 to version 1.000005
171
172 Added C<new_from_handle()> method.
173
174 =item *
175
176 L<Params::Check> has been upgraded from version 0.28 to version 0.32
177
178 =item *
179
180 L<PerlIO::via> has been upgraded from version 0.11 to version 0.12.
181
182 The only change is a correction in the documentation.
183
184 =item *
185
186 L<Term::ANSIColor> has been upgraded from version 3.00 to version 3.01
187
188 Only interpret an initial array reference as a list of colors, not any initial
189 reference, allowing the colored function to work properly on objects with
190 stringification defined.
191
192 =item *
193
194 L<Unicode::Collate> has been upgraded from version 0.77 to version 0.78
195
196 =item *
197
198 L<Unicode::Normalize> has been upgraded from version 1.12 to version 1.13
199
200 =back
201
202 =head2 Removed Modules and Pragmata
203
204 =over 4
205
206 =item *
207
208 XXX
209
210 =back
211
212 =head1 Documentation
213
214 XXX Changes to files in F<pod/> go here.  Consider grouping entries by
215 file and be sure to link to the appropriate page, e.g. L<perlfunc>.
216
217 =head2 New Documentation
218
219 XXX Changes which create B<new> files in F<pod/> go here.
220
221 =head3 L<XXX>
222
223 XXX Description of the purpose of the new file here
224
225 =head2 Changes to Existing Documentation
226
227 XXX Changes which significantly change existing files in F<pod/> go here.
228 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
229 section.
230
231 =head3 L<XXX>
232
233 =over 4
234
235 =item *
236
237 XXX Description of the change here
238
239 =back
240
241 =head1 Diagnostics
242
243 The following additions or changes have been made to diagnostic output,
244 including warnings and fatal error messages.  For the complete list of
245 diagnostic messages, see L<perldiag>.
246
247 XXX New or changed warnings emitted by the core's C<C> code go here. Also
248 include any changes in L<perldiag> that reconcile it to the C<C> code.
249
250 [ Within each section, list entries as a =item entry that links to perldiag,
251   e.g.
252
253   =item *
254
255   L<Invalid version object|perldiag/"Invalid version object">
256 ]
257
258 =head2 New Diagnostics
259
260 XXX Newly added diagnostic messages go here
261
262 =head3 New Errors
263
264 =over 4
265
266 =item *
267
268 XXX L<message|perldiag/"message">
269
270 =back
271
272 =head3 New Warnings
273
274 =over 4
275
276 =item *
277
278 XXX L<message|perldiag/"message">
279
280 =back
281
282 =head2 Changes to Existing Diagnostics
283
284 XXX Changes (i.e. rewording) of diagnostic messages go here
285
286 =over 4
287
288 =item *
289
290 XXX Describe change here
291
292 =back
293
294 =head1 Utility Changes
295
296 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
297 here. Most of these are built within the directories F<utils> and F<x2p>.
298
299 [ List utility changes as a =head3 entry for each utility and =item
300 entries for each change
301 Use L<XXX> with program names to get proper documentation linking. ]
302
303 =head3 L<perlivp>
304
305 =over 4
306
307 =item *
308
309 Fixed a bug whereby other perls under the current directory could cause
310 false positive failures.
311
312 =item *
313
314 Tests for .ph files have been removed, as these test have been optional since
315 2005 and .ph files are no longer generated during installation.
316
317 =back
318
319 =head1 Configuration and Compilation
320
321 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
322 go here.  Any other changes to the Perl build process should be listed here.
323 However, any platform-specific changes should be listed in the
324 L</Platform Support> section, instead.
325
326 [ List changes as a =item entry ].
327
328 =over 4
329
330 =item *
331
332 F<makedef.pl> has been refactored. This should have no noticeable affect on
333 any of the platforms that use it as part of their build (AIX, VMS, Win32).
334
335 =back
336
337 =head1 Testing
338
339 XXX Any significant changes to the testing of a freshly built perl should be
340 listed here.  Changes which create B<new> files in F<t/> go here as do any
341 large changes to the testing harness (e.g. when parallel testing was added).
342 Changes to existing files in F<t/> aren't worth summarising, although the bugs
343 that they represent may be covered elsewhere.
344
345 [ List each test improvement as a =item entry ]
346
347 =over 4
348
349 =item *
350
351 XXX
352
353 =back
354
355 =head1 Platform Support
356
357 XXX Any changes to platform support should be listed in the sections below.
358
359 [ Within the sections, list each platform as a =item entry with specific
360 changes as paragraphs below it. ]
361
362 =over 4
363
364 =item HP-UX PA-RISC/64 now supports gcc-4.x
365
366 A fix to correct the socketsize now makes the test suite pass on HP-UX
367 PA-RISC for 64bitall builds.
368
369 =back
370
371 =head2 New Platforms
372
373 XXX List any platforms that this version of perl compiles on, that previous
374 versions did not. These will either be enabled by new files in the F<hints/>
375 directories, or new subdirectories and F<README> files at the top level of the
376 source tree.
377
378 =over 4
379
380 =item XXX-some-platform
381
382 XXX
383
384 =back
385
386 =head2 Discontinued Platforms
387
388 XXX List any platforms that this version of perl no longer compiles on.
389
390 =over 4
391
392 =item XXX-some-platform
393
394 XXX
395
396 =back
397
398 =head2 Platform-Specific Notes
399
400 XXX List any changes for specific platforms. This could include configuration
401 and compilation changes or changes in portability/compatibility.  However,
402 changes within modules for platforms should generally be listed in the
403 L</Modules and Pragmata> section.
404
405 =over 4
406
407 =item XXX-some-platform
408
409 XXX
410
411 =back
412
413 =head1 Internal Changes
414
415 XXX Changes which affect the interface available to C<XS> code go here.
416 Other significant internal changes for future core maintainers should
417 be noted as well.
418
419 [ List each change as a =item entry ]
420
421 =over 4
422
423 =item *
424
425 XXX
426
427 =back
428
429 =head1 Selected Bug Fixes
430
431 XXX Important bug fixes in the core language are summarised here.
432 Bug fixes in files in F<ext/> and F<lib/> are best summarised in
433 L</Modules and Pragmata>.
434
435 [ List each fix as a =item entry ]
436
437 =over 4
438
439 =item *
440
441 Locking an lvalue subroutine (via C<lock &lvsub>) now locks the return
442 value, instead of trying to lock the sub (which has no effect).  It also no
443 longer tries to return the sub as a scalar, resulting in strange side
444 effects like C<ref \$_> returning "CODE" in some instances.
445
446 =item *
447
448 C<lock>'s prototype has been corrected to C<(\[$@%*])> from C<(\$)>, which
449 was just wrong.
450
451 =item *
452
453 The prototypes for the core functions C<stat> and C<lstat> have been
454 removed, as they were incorrect, because their syntax cannot be replicated
455 by Perl subroutines.
456
457 =item *
458
459 Most dereferencing operators (C<${}>, etc.) used to call C<FETCH> twice on
460 a tied operand when doing a symbolic dereference (looking up a variable by
461 name, which is not permitted under C<use strict 'refs'>).  Only C<&{}> did
462 not have this problem.  This has been fixed.
463
464 =item *
465
466 A minor regression introduced in 5.15.0 has been fixed.  Dereferencing a
467 magical mortal (e.g., the return value of C<delete> on a tied hash element)
468 explicitly returned from a subroutine called recursively was not calling
469 C<FETCH>.  This would affect code like C<@{ foo() }> where the C<foo> sub
470 contains C<return delete $hash{elem}> and is calling itself.
471
472 =item *
473
474 A panic involving the combination of the regular expression modifiers
475 C</aa> and the C<\b> escape sequence introduced in 5.14.0 has been
476 fixed [perl #95964].
477
478 =item *
479
480 stat() would always return the inode number as an IV, even when the
481 original was unsigned, or too large to fit in an IV.  stat() now
482 returns the inode number as the type that would best preserve the
483 original value. [perl #84590]
484
485 =item *
486
487 The combination of the regular expression modifiers C</aa> and the C<\b>
488 and C<\B> escape sequences did not work properly on UTF-8 encoded
489 strings.  All non-ASCII characters under C</aa> should be treated as
490 non-word characters, but what was happening was that Unicode rules were
491 used to determine wordness/non-wordness for non-ASCII characters.  This
492 is now fixed [perl #95968].
493
494 =back
495
496 =head1 Known Problems
497
498 XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
499 tests that had to be C<TODO>ed for the release would be noted here, unless
500 they were specific to a particular platform (see below).
501
502 This is a list of some significant unfixed bugs, which are regressions
503 from either 5.XXX.XXX or 5.XXX.XXX.
504
505 [ List each fix as a =item entry ]
506
507 =over 4
508
509 =item *
510
511 XXX
512
513 =back
514
515 =head1 Obituary
516
517 XXX If any significant core contributor has died, we've added a short obituary
518 here.
519
520 =head1 Acknowledgements
521
522 XXX Generate this with:
523
524   perl Porting/acknowledgements.pl v5.15.1..HEAD
525
526 =head1 Reporting Bugs
527
528 If you find what you think is a bug, you might check the articles
529 recently posted to the comp.lang.perl.misc newsgroup and the perl
530 bug database at http://rt.perl.org/perlbug/ .  There may also be
531 information at http://www.perl.org/ , the Perl Home Page.
532
533 If you believe you have an unreported bug, please run the L<perlbug>
534 program included with your release.  Be sure to trim your bug down
535 to a tiny but sufficient test case.  Your bug report, along with the
536 output of C<perl -V>, will be sent off to perlbug@perl.org to be
537 analysed by the Perl porting team.
538
539 If the bug you are reporting has security implications, which make it
540 inappropriate to send to a publicly archived mailing list, then please send
541 it to perl5-security-report@perl.org. This points to a closed subscription
542 unarchived mailing list, which includes
543 all the core committers, who will be able
544 to help assess the impact of issues, figure out a resolution, and help
545 co-ordinate the release of patches to mitigate or fix the problem across all
546 platforms on which Perl is supported. Please only use this address for
547 security issues in the Perl core, not for modules independently
548 distributed on CPAN.
549
550 =head1 SEE ALSO
551
552 The F<Changes> file for an explanation of how to view exhaustive details
553 on what changed.
554
555 The F<INSTALL> file for how to build Perl.
556
557 The F<README> file for general stuff.
558
559 The F<Artistic> and F<Copying> files for copyright information.
560
561 =cut