This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
23388d827ad5ef88f5f00bdb7a097e34dbf348fc
[perl5.git] / pod / perl5133delta.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.13.3
9
10 =head1 DESCRIPTION
11
12 This document describes differences between the 5.13.3 release and
13 the 5.13.2 release.
14
15 If you are upgrading from an earlier release such as 5.13.1, first read
16 L<perl5132delta>, which describes differences between 5.13.1 and
17 5.13.2.
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 =head2 C<\N{I<name>}> and C<charnames> enhancements
32
33 C<\N{}> and C<charnames::vianame> now know about the abbreviated character
34 names listed by Unicode, such as NBSP, SHY, LRO, ZWJ, etc., as well as all the
35 customary abbreviations for the C0 and C1 control characters (such as ACK, BEL,
36 CAN, etc.), as well as a few new variants in common usage of some C1 full
37 names.
38
39 In the past, it was ineffective to override one of Perl's abbreviations with
40 your own custom alias.  Now it works.
41
42 And you can create a custom alias directly to the ordinal of a character, known
43 by C<\N{...}>, C<charnames::vianame()>, and C<charnames::viacode()>.
44 Previously, an alias had to be to an official Unicode character name.  This
45 made it impossible to create an alias for a code point that had no name,
46 such as the ones reserved for private use.  So this change allows you to make
47 more effective use of private use characters.  Only if there is no official
48 name will C<charnames::viacode()> return your custom one.
49
50 See L<charnames> for details on all these changes.
51
52 =head2 Other enhancements
53
54 =over
55
56 =item *
57
58 Uppercase X/B allowed in hexadecimal/binary literals (RT#76296) (a674e8d)
59
60 =back
61
62 =head1 Security
63
64 XXX Any security-related notices go here.  In particular, any security
65 vulnerabilities closed should be noted here rather than in the
66 L</Selected Bug Fixes> section.
67
68 [ List each security issue as a =head2 entry ]
69
70 =head1 Incompatible Changes
71
72 XXX For a release on a stable branch, this section aspires to be:
73
74     There are no changes intentionally incompatible with 5.XXX.XXX. If any
75     exist, they are bugs and reports are welcome.
76
77 [ List each incompatible change as a =head2 entry ]
78
79 =head1 Deprecations
80
81 XXX Any deprecated features, syntax, modules etc. should be listed here.
82 In particular, deprecated modules should be listed here even if they are
83 listed as an updated module in the L</Modules and Pragmata> section.
84
85 [ List each deprecation as a =head2 entry ]
86
87 =head2 Omitting a space between regular expression and subsequent word
88
89 Omitting a space between a regex pattern or pattern modifiers and the
90 following word is deprecated. Deprecation for regular expression matches
91 was added in Perl 5.13.2.  In this release, the deprecation is extended
92 to regular expression substitutions. For example, 
93 C<< s/foo/bar/sand $bar >> will still be parsed as
94 C<< s/foo/bar/s and $bar >> but will issue a warning.  
95
96 =head2 Deprecation warning added for deprecated-in-core .pl libs
97
98 This is a mandatory warning, not obeying -X or lexical warning bits.
99 The warning is modelled on that supplied by deprecate.pm for
100 deprecated-in-core .pm libraries.  It points to the specific CPAN
101 distribution that contains the .pl libraries. The CPAN version, of
102 course, does not generate the warning. (0111154)
103
104 =head1 Performance Enhancements
105
106 XXX Changes which enhance performance without changing behaviour go here. There
107 may well be none in a stable release.
108
109 [ List each enhancement as a =item entry ]
110
111 =over 4
112
113 =item *
114
115 There are several small optimizations to improve CPU cache performance
116
117 =back
118
119 =head1 Modules and Pragmata
120
121 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
122 go here.  If Module::CoreList is updated, generate an initial draft of the
123 following sections using F<Porting/corelist-perldelta.pl>, which prints stub
124 entries to STDOUT.  Results can be pasted in place of the '=head2' entries
125 below.  A paragraph summary for important changes should then be added by hand.
126 In an ideal world, dual-life modules would have a F<Changes> file that could be
127 cribbed.
128
129 [ Within each section, list entries as a =item entry ]
130
131 =head2 New Modules and Pragmata
132
133 =over 4
134
135 =item *
136
137 XXX
138
139 =back
140
141 =head2 Updated Modules and Pragmata
142
143 XXX Make sure these get sorted, are phrased similarly and all version
144 numbers are correct
145
146 =over 4
147
148 =item *
149
150 autodie updated to CPAN version 2.10 (a009834)
151
152 =item *
153
154 charnames -- viacode() is now significantly faster (f3227b7)
155
156 =item *
157
158 version now prevents object methods from being called as class methods
159 (d808b68)
160
161 =item *
162
163 warnings updated to 1.10.  Calling C<use warnings> without
164 arguments is now significantly more efficient. (8452af9)
165
166 =item *
167
168 Archive-Extract updated to CPAN version 0.42 (d7f8799)
169
170 Updates since 0.38 include: a safe print method that Michael Schwern
171 contributed, that guards Archive::Extract from changes to $\; a
172 fix to the tests when run in core perl from Robin Barker; and
173 support for TZ files contributed by Paul Marquess, who also supplied a
174 modification for the lzma logic to favour IO::Uncompress::Unlzma
175
176 =item *
177
178 Archive-Tar updated to version 1.64 (afabe0e)
179
180 Important changes since 1.54 include: compatibility with busybox
181 implementations of tar which was added by Mark Swayne; a fix so
182 that write() and create_archive() close only handles
183 they opened by Darrell K.; and a bug was fixed regarding the exit code
184 of extract_archive which was spotted by and upstreamed from RedHat by
185 Martin Cermak.
186
187 =item *
188
189 Attribute-Handlers updated to CPAN version 0.88 (f2ea78b)
190
191 =item *
192
193 Compress-Raw-Bzip2 updated to CPAN version 2.027 (9e09409)
194
195 =item *
196
197 Compress-Raw-Zlib updated  to CPAN version 2.027 (f02c02e)
198
199 =item *
200
201 CPANPLUS updated to version 0.9007 (d4e225a)
202
203 Fix the shell test to skip if test is not being run under a
204 terminal; resolved the issue where a prereq on Config would not be
205 recognised as a core module
206
207 =item *
208
209 Digest-MD5 updated to CPAN version 2.40 (326fafa)
210
211 =item *
212
213 Digest-SHA updated to CPAN version 5.48 (dfe1edc)
214
215 =item *
216
217 Exporter no longer overrides C<$SIG{__WARN__}> (RT #74472) (9b86bb5)
218
219 =item *
220
221 ExtUtils-CBuilder updated to CPAN version 0.2703 (7b0eef9)
222
223 =item *
224
225 ExtUtils-Manifest updated to CPAN version 1.58 (49c6bc4)
226
227 =item *
228
229 ExtUtil-ParseXS updated to version 2.2206 (494e8c4)
230
231 =item *
232
233 File::Copy skips suid tests on a nosuid partition (cae9400)
234
235 =item *
236
237 IO-Compress upated to CPAN version 2.027 (e8796d6)
238
239 =item *
240
241 IPC-Cmd updated to CPAN version 0.60 (e667e1e)
242
243 =item *
244
245 IPC-SysV updated to CPAN version 2.03 (10613b6)
246
247 =item * 
248
249 Locale::Maketext guts have been merged back into the main module (87d86da)
250 and adds external cache support (ace47d6)
251
252 =item *
253
254 Module-Build updated to CPAN version 0.3607 (40c9afb)
255
256 =item *
257
258 Module-Load updated to CPAN version 0.18 (93eaa32)
259
260 =item *
261
262 Time-HiRes updated to CPAN version 1.9721 (68c5b4d)
263
264 =item *
265
266 Time-Piece updated to CPAN version 1.20 (90d55c2)
267
268 =item *
269
270 Unicode-Collate updated to CPAN version 0.53.  Includes Unicode Collation
271 Algorithm 18 (74b94a7)
272
273 =item *
274
275 Unicode-Normalize updated to CPAN release 1.06 (a96160d)
276
277 =back
278
279 =head2 Removed Modules and Pragmata
280
281 =over 4
282
283 =item *
284
285 XXX
286
287 =back
288
289 =head1 Documentation
290
291 XXX Changes to files in F<pod/> go here.  Consider grouping entries by
292 file and be sure to link to the appropriate page, e.g. L<perlfunc>.
293
294 [ Within each section, list entries as a =item entry ]
295
296 =head2 New Documentation
297
298 XXX Changes which create B<new> files in F<pod/> go here.
299
300 =head3 L<perl5121delta>
301
302 The Perl 5.12.1 perldelta file was added from the Perl maintenance branch
303
304 =head2 Changes to Existing Documentation
305
306 XXX Changes which significantly change existing files in F<pod/> go here.
307 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
308 section.
309
310 =head3 General changes
311
312 =over
313
314 =item *
315
316 Octal character escapes in documentation now prefer either the C<\gDIGIT>
317 escape or else a three-digit octal escape as they have less ambiguity than
318 other forms of octal escapes.  (ce7b6f0) (d8b950d)
319
320 =item *
321
322 Documentation now standardizes on the term 'capture group' over 'buffer'
323 in regular expression documentation(c27a5cf)
324
325 =back
326
327 =head3 L<perlfunc>
328
329 =over
330
331 =item *
332
333 Added cautionary note about "no VERSION" (e0de7c2)
334
335 =item *
336
337 Add additional notes regarding srand and forking (d460397)
338
339 =back
340
341 =head3 L<perlop>
342
343 =over 4
344
345 =item *
346
347 Improved documentation of unusual character escapes (bf82ca4)
348
349 =back
350
351 =head3 L<perlrun>
352
353 =over
354
355 =item *
356
357 Clarifies the behavior of the C<-0NNN> switch for C<-0400> or higher (7ba31cb)
358
359 =back
360
361 =head3 L<perlpolicy>
362
363 =over
364
365 =item *
366
367 Added the policy on compatibility and deprecation along with definitions of
368 terms like "deprecation" (70e4a83)
369
370 =back
371
372 =head3 L<perltie>
373
374 =over
375
376 =item *
377
378 Some examples updated for modern Perl style (67d00dd)
379
380 =back
381
382 =head1 Diagnostics
383
384 The following additions or changes have been made to diagnostic output,
385 including warnings and fatal error messages.  For the complete list of
386 diagnostic messages, see L<perldiag>.
387
388 XXX New or changed warnings emitted by the core's C<C> code go here. Also
389 include any changes in L<perldiag> that reconcile it to the C<C> code.
390
391 [ Within each section, list entries as a =item entry ]
392
393 =head2 New Diagnostics
394
395 XXX Newly added diagnostic messages go here
396
397 =over 4
398
399 =item *
400
401 XXX
402
403 =back
404
405 =head2 Changes to Existing Diagnostics
406
407 XXX Changes (i.e. rewording) of diagnostic messages go here
408
409 =over 4
410
411 =item *
412
413 XXX
414
415 =back
416
417 =head1 Utility Changes
418
419 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
420 here. Most of these are built within the directories F<utils> and F<x2p>.
421
422 =head3 L<perldb>
423
424 =over
425
426 =item * 
427
428 Uses the less pager path from Config instead of searching for it (bf320d6)
429
430 =back
431
432
433 =head1 Configuration and Compilation
434
435 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
436 go here.  Any other changes to the Perl build process should be listed here.
437 However, any platform-specific changes should be listed in the
438 L</Platform Support> section, instead.
439
440 [ List changes as a =item entry ].
441
442 =over 4
443
444 =item *
445
446 Adjusts 'make test.valgrind' to account for cpan/dist/ext separation. (e07ce2e)
447
448 =back
449
450 =head1 Testing
451
452 XXX Any significant changes to the testing of a freshly built perl should be
453 listed here.  Changes which create B<new> files in F<t/> go here as do any
454 large changes to the testing harness (e.g. when parallel testing was added).
455 Changes to existing files in F<t/> aren't worth summarising, although the bugs
456 that they represent may be covered elsewhere.
457
458 [ List each test improvement as a =item entry ]
459
460 =over 4
461
462 =item *
463
464 F<t/harness> clears PERL5LIB, PERLLIB, PERL5OPT as t/TEST does (a2d3de1)
465
466 =item *
467
468 Many common testing routines were refactored into t/lib/common.pl
469
470 =item *
471
472 Several test files have been modernized to use Test::More
473
474 =back
475
476 =head1 Platform Support
477
478 XXX Any changes to platform support should be listed in the sections below.
479
480 [ Within the sections, list each platform as a =item entry with specific
481 changes as paragraphs below it. ]
482
483 =head2 New Platforms
484
485 XXX List any platforms that this version of perl compiles on, that previous
486 versions did not. These will either be enabled by new files in the F<hints/>
487 directories, or new subdirectories and F<README> files at the top level of the
488 source tree.
489
490 =over 4
491
492 =item XXX-some-platform
493
494 XXX
495
496 =back
497
498 =head2 Discontinued Platforms
499
500 XXX List any platforms that this version of perl no longer compiles on.
501
502 =over 4
503
504 =item MacOS Classic
505
506 Support for MacOS Classic within ExtUtils::MakeMaker was removed from Perl in
507 December 2004.  Vestigial MacOS Classic specific code has now been removed
508 from other core modules as well.
509
510 =back
511
512 =head2 Platform-Specific Notes
513
514 XXX List any changes for specific platforms. This could include configuration
515 and compilation changes or changes in portability/compatibility.  However,
516 changes within modules for platforms should generally be listed in the
517 L</Modules and Pragmata> section.
518
519 =over 4
520
521 =item Win32
522
523 t/io/openpid.t now uses the alarm() watchdog strategy for more
524 robustness. (5732108)
525
526 =back
527
528 =head1 Internal Changes
529
530 XXX Changes which affect the interface available to C<XS> code go here.
531 Other significant internal changes for future core maintainers should
532 be noted as well.
533
534 [ List each improvement as a =item entry ]
535
536 =over 4
537
538 =item *
539
540 XXX Lots of block hook changes (PL_blockhooks) -- needs an overall summary
541
542 =item *
543
544 Added C<BhkENABLE> and C<BhkDISABLE> macros to en/disable blockhook entries.
545 This allows the individual callbacks to be switched on and off as
546 necessary, without removing the entry from PL_blockhooks. (a3e07c8)
547
548 =item *
549
550 Added C<Perl_croak_no_modify()> to implement 
551 C<Perl_croak("%s", PL_no_modify)>. (6ad8f25)
552
553 =item *
554
555 Added prototypes for C<tie()> and C<untie()> to allow overloading. (RT#75902)
556 (1db4d19)
557
558 =item * 
559
560 Adds C<my_[l]stat_flags()> to replace C<my_[l]stat()>.  C<my_stat()> and
561 C<my_lstat()> call get magic on the stack arg, so create C<_flags()>
562 variants that allow us to control this. (0d7d409)
563
564 =back
565
566 =head1 Selected Bug Fixes
567
568 XXX Important bug fixes in the core language are summarised here.
569 Bug fixes in files in F<ext/> and F<lib/> are best summarised in
570 L</Modules and Pragmata>.
571
572 [ List each fix as a =item entry ]
573
574 =over 4
575
576 =item *
577
578 Fixed a regression of kill() when a match variable is used for the
579 process ID to kill.  (RT#75812) (8af710e)
580
581 =item *
582
583 Fixed several subtle bugs in sort() when @_ is accessed within a subroutine
584 used for sorting. (RT#72334) (8f443ca)
585
586 =item *
587
588 Catch yyparse() exceptions in C<< (?{...}) >> (RT#2353) (634d691)
589
590 =item *
591
592 Avoid UTF-8 cache panics with offsets beyond a string (RT #75898) (3e2d381)
593
594 =item *
595
596 Fixed POSIX::strftime memory leak (RT#73520) (c4bc4aa)
597
598 =item *
599
600 Doesn't set strict with C<no VERSION> if C<VERSION> is greater than 5.12.
601 (da8fb5d)
602
603 =item *
604
605 Avoids multiple FETCH/stringify on filetest ops (40c852d)
606
607 =item *
608
609 Fixed issue with string C<eval> not detecting taint of overloaded/tied
610 arguments (RT #75716) (895b760)
611
612 =item *
613
614 Fix potential crashes of string C<eval> when evaluating a object with
615 overloaded stringification by creating a stringified copy when necessary
616 (3e5c018)
617
618 =item *
619
620 Fixed bug where overloaded stringification could remove tainting
621 (RT #75716) (a02ec77)
622
623 =item *
624
625 Plugs more memory leaks in vms.c. (9e2bec0)
626
627 =item *
628
629 Fix pthread include error for Time::Piece (e9f284c)
630
631 =back
632
633 =head1 Known Problems
634
635 XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
636 tests that had to be C<TODO>ed for the release would be noted here, unless
637 they were specific to a particular platform (see below).
638
639 This is a list of some significant unfixed bugs, which are regressions
640 from either 5.XXX.XXX or 5.XXX.XXX.
641
642 [ List each fix as a =item entry ]
643
644 =over 4
645
646 =item *
647
648 XXX
649
650 =back
651
652 =head1 Errata
653
654 =over 4
655
656 =item *
657
658 Retroactively added the Acknowledgements list to L<perl5132delta>,
659 which was excluded in the original release (d1e2db0)
660
661 =back
662
663 =head1 Obituary
664
665 XXX If any significant core contributor has died, we've added a short obituary
666 here.
667
668 =head1 Acknowledgements
669
670 XXX The list of people to thank goes here.
671
672 =head1 Reporting Bugs
673
674 If you find what you think is a bug, you might check the articles
675 recently posted to the comp.lang.perl.misc newsgroup and the perl
676 bug database at http://rt.perl.org/perlbug/ .  There may also be
677 information at http://www.perl.org/ , the Perl Home Page.
678
679 If you believe you have an unreported bug, please run the B<perlbug>
680 program included with your release.  Be sure to trim your bug down
681 to a tiny but sufficient test case.  Your bug report, along with the
682 output of C<perl -V>, will be sent off to perlbug@perl.org to be
683 analysed by the Perl porting team.
684
685 If the bug you are reporting has security implications, which make it
686 inappropriate to send to a publicly archived mailing list, then please send
687 it to perl5-security-report@perl.org. This points to a closed subscription
688 unarchived mailing list, which includes all the core committers, who be able
689 to help assess the impact of issues, figure out a resolution, and help
690 co-ordinate the release of patches to mitigate or fix the problem across all
691 platforms on which Perl is supported. Please only use this address for
692 security issues in the Perl core, not for modules independently
693 distributed on CPAN.
694
695 =head1 SEE ALSO
696
697 The F<Changes> file for an explanation of how to view exhaustive details
698 on what changed.
699
700 The F<INSTALL> file for how to build Perl.
701
702 The F<README> file for general stuff.
703
704 The F<Artistic> and F<Copying> files for copyright information.
705
706 =cut