This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
[perl #80548] perldelta for DTrace package name change
[perl5.git] / pod / perldelta.pod
1 =encoding utf8
2
3 =for comment
4 This has been completed up to 26de4ac8, except for:
5 d9a4b459f94297889956ac3adc42707365f274c2
6 bf5522a13a381257966e7ed6b731195a873b153e
7 9cef83062267e94311e1fd8744396e440642738e
8 8e88cfee26d866223a6b3bfffce6270271de00db
9
10 =head1 NAME
11
12 [ this is a template for a new perldelta file. Any text flagged as
13 XXX needs to be processed before release. ]
14
15 perldelta - what is new for perl v5.13.8
16
17 =head1 DESCRIPTION
18
19 This document describes differences between the 5.13.8 release and
20 the 5.13.7 release.
21
22 If you are upgrading from an earlier release such as 5.13.6, first read
23 L<perl5137delta>, which describes differences between 5.13.6 and
24 5.13.7.
25
26 =head1 Notice
27
28 XXX Any important notices here
29
30 =head1 Core Enhancements
31
32 XXX New core language features go here. Summarise user-visible core language
33 enhancements. Particularly prominent performance optimisations could go
34 here, but most should go in the L</Performance Enhancements> section.
35
36 [ List each enhancement as a =head2 entry ]
37
38 =head2 C<-d:-foo> calls C<Devel::foo::unimport>
39
40 The syntax C<-dI<B<:>foo>> was extended in 5.6.1 to make C<-dI<:fooB<=bar>>>
41 equivalent to C<-MDevel::foo=bar>, which expands
42 internally to C<use Devel::foo 'bar';>.
43 F<perl> now allows prefixing the module name with C<->, with the same
44 semantics as C<-M>, I<i.e.>
45
46 =over 4
47
48 =item C<-d:-foo>
49
50 Equivalent to C<-M-Devel::foo>, expands to
51 C<no Devel::foo;>, calls C<< Devel::foo->unimport() >>
52 if the method exists.
53
54 =item C<-d:-foo=bar>
55
56 Equivalent to C<-M-Devel::foo=bar>, expands to C<no Devel::foo 'bar';>,
57 calls C<< Devel::foo->unimport('bar') >> if the method exists.
58
59 =back
60
61 This is particularly useful to suppresses the default actions of a
62 C<Devel::*> module's C<import> method whilst still loading it for debugging.
63
64 =head2 Filehandle method calls load IO::File on demand
65
66 When a method call on a filehandle would die because the method can not
67 be resolved and L<IO::File> has not been loaded, Perl now loads IO::File
68 via C<require> and attempts method resolution again:
69
70   open my $fh, ">", $file;
71   $fh->binmode(":raw");     # loads IO::File and succeeds
72
73 This also works for globs like STDOUT, STDERR and STDIN:
74
75   STDOUT->autoflush(1);
76
77 Because this on-demand load only happens if method resolution fails, the
78 legacy approach of manually loading an IO::File parent class for partial
79 method support still works as expected:
80
81   use IO::Handle;
82   open my $fh, ">", $file;
83   $fh->autoflush(1);        # IO::File not loaded
84
85 =head2 Full functionality for C<use feature 'unicode_strings'>
86
87 This release provides full functionality for C<use feature
88 'unicode_strings'>.  Under its scope, all string operations executed and
89 regular expressions compiled (even if executed outside its scope) have
90 Unicode semantics.   See L<feature>.
91
92 This feature avoids the "Unicode Bug" (See
93 L<perlunicode/The "Unicode Bug"> for details.)  If their is a
94 possibility that your code will process Unicode strings, you are
95 B<strongly> encouraged to use this subpragma to avoid nasty surprises.
96
97 This availability of this should strongly affect the whole tone of
98 various documents, such as L<perlunicode> and L<perluniintro>, but this
99 work has not been done yet.
100
101 =head2 Exception Handling Backcompat Hack
102
103 When an exception is thrown in an C<eval BLOCK>, C<$@> is now set before
104 unwinding, as well as being set after unwinding as the eval block exits.  This
105 early setting supports code that has historically treated C<$@> during unwinding
106 as an indicator of whether the unwinding was due to an exception.  These modules
107 had been broken by 5.13.1's change from setting C<$@> early to setting it late.
108 This double setting arrangement is a stopgap until the reason for unwinding can
109 be made properly introspectable.  C<$@> has never been a reliable indicator of
110 this.
111
112 =head2 DTrace probes now include package name
113
114 The DTrace probes now include an additional argument (C<arg3>) which contains
115 the package the subroutine being entered or left was compiled in.
116
117 For example using the following DTrace script:
118
119   perl$target:::sub-entry
120   {
121       printf("%s::%s\n", copyinstr(arg0), copyinstr(arg3));
122   }
123
124 and then running:
125
126   perl -e'sub test { }; test'
127
128 DTrace will print:
129
130   main::test
131
132 =head1 Security
133
134 XXX Any security-related notices go here.  In particular, any security
135 vulnerabilities closed should be noted here rather than in the
136 L</Selected Bug Fixes> section.
137
138 [ List each security issue as a =head2 entry ]
139
140 =head1 Incompatible Changes
141
142 =head2 Attempting to use C<:=> as an empty attribute list is now a syntax error
143
144 Previously C<my $pi := 4;> was exactly equivalent to C<my $pi : = 4;>,
145 with the C<:> being treated as the start of an attribute list, ending before
146 the C<=>. The use of C<:=> to mean C<: => was deprecated in 5.12.0, and is now
147 a syntax error. This will allow the future use of C<:=> as a new token.
148
149 We find no Perl 5 code on CPAN using this construction, outside the core's
150 tests for it, so we believe that this change will have very little impact on
151 real-world codebases.
152
153 If it is absolutely necessary to have empty attribute lists (for example,
154 because of a code generator) then avoid the error by adding a space before
155 the C<=>.
156
157 =head2 Run-time code block in regular expressions
158
159 Code blocks in regular expressions (C<(?{...})> and C<(??{...})>) used not
160 to inherit any pragmata (strict, warnings, etc.) if the regular expression
161 was compiled at run time as happens in cases like these two:
162
163   use re 'eval';
164   $foo =~ $bar; # when $bar contains (?{...})
165   $foo =~ /$bar(?{ $finished = 1 })/;
166
167 This was a bug, which has now been fixed. But it has the potential to break
168 any code that was relying on this bug.
169
170 =head1 Deprecations
171
172 XXX Any deprecated features, syntax, modules etc. should be listed here.
173 In particular, deprecated modules should be listed here even if they are
174 listed as an updated module in the L</Modules and Pragmata> section.
175
176 [ List each deprecation as a =head2 entry ]
177
178 =head2 C<?PATTERN?> is deprecated
179
180 C<?PATTERN?> (without the initial m) has been deprecated and now produces
181 a warning.
182
183 =head2 C<sv_compile_2op> is now deprecated
184
185 The C<sv_compile_2op> is now deprecated, and will be removed. Searches suggest
186 that nothing on CPAN is using it, so this should have zero impact.
187
188 It attempted to provide an API to compile code down to an optree, but failed
189 to bind correctly to lexicals in the enclosing scope. It's not possible to
190 fix this problem within the constraints of its parameters and return value.
191
192 =head2 Tie functions on scalars holding typeglobs
193
194 Calling a tie function (C<tie>, C<tied>, C<untie>) with a scalar argument
195 acts on a file handle if the scalar happens to hold a typeglob.
196
197 This is a long-standing bug that will be removed in Perl 5.16, as
198 there is currently no way to tie the scalar itself when it holds
199 a typeglob, and no way to untie a scalar that has had a typeglob
200 assigned to it.
201
202 This bug was fixed in 5.13.7 but, because of the breakage it caused, the
203 fix has been reverted. Now there is a deprecation warning whenever a tie
204 function is used on a handle without an explicit C<*>.
205
206 =head1 Performance Enhancements
207
208 XXX Changes which enhance performance without changing behaviour go here. There
209 may well be none in a stable release.
210
211 [ List each enhancement as a =item entry ]
212
213 =over 4
214
215 =item *
216
217 XXX
218
219 =back
220
221 =head1 Modules and Pragmata
222
223 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
224 go here.  If Module::CoreList is updated, generate an initial draft of the
225 following sections using F<Porting/corelist-perldelta.pl>, which prints stub
226 entries to STDOUT.  Results can be pasted in place of the '=head2' entries
227 below.  A paragraph summary for important changes should then be added by hand.
228 In an ideal world, dual-life modules would have a F<Changes> file that could be
229 cribbed.
230
231 [ Within each section, list entries as a =item entry ]
232
233 =head2 New Modules and Pragmata
234
235 =over 4
236
237 =item *
238
239 XXX
240
241 =back
242
243 =head2 Updated Modules and Pragmata
244
245 =over 4
246
247 =item *
248
249 C<Devel::SelfStubber> has been upgraded from version 1.04 to 1.05.
250
251 =item *
252
253 C<Digest::SHA> has been upgraded from 5.48 to 5.50
254
255 shasum now more closely mimics sha1sum/md5sum and Addfile
256 accepts all POSIX filenames.
257
258 =item *
259
260 C<Dumpvalue> has been upgraded from version 1.14 to 1.15.
261
262 =item *
263
264 C<Env> has been upgraded from version 1.01 to 1.02.
265
266 =item *
267
268 C<ExtUtils::CBuilder> has been upgraded from 0.2703 to 0.2802
269
270 =item *
271
272 C<if> has been upgraded from 0.06 to 0.0601.
273
274 =item *
275
276 C<Devel::SelfStubber> has been upgraded from version 1.03 to 1.04.
277
278 =item *
279
280 C<IPC::Cmd> has been upgraded from 0.64 to 0.66
281
282 Resolves an issue with splitting Win32 command lines
283 and documentation enhancements.
284
285 =item *
286
287 C<Locale::Codes> has been upgraded from version 3.14 to 3.15
288
289 =item *
290
291 C<Memoize> has been upgraded from version 1.01_03 to 1.02.
292
293 =item *
294
295 C<MIME::Base64> has been upgraded from 3.10 to 3.13
296
297 Now provides encode_base64url and decode_base64url functions to process
298 the base64 scheme for "URL applications".
299
300 =item *
301
302 C<mro> has been upgraded from version 1.05 to 1.06.
303
304 C<next::method> I<et al.> now take into account that every class inherits
305 from UNIVERSAL
306 L<[perl #68654]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=68654>.
307
308 =item *
309
310 C<overload> has been upgraded from 1.11 to 1.12.
311
312 =item *
313
314 C<PerlIO::scalar> has been upgraded from 0.10 to 0.11.
315
316 A C<read> after a C<seek> beyond the end of the string no longer thinks it
317 has data to read
318 L<[perl #78716]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78716>.
319
320 =item *
321
322 C<re> has been upgraded from 0.14 to 0.15.
323
324 =item *
325
326 C<Socket> has been upgraded from 1.91 to 1.92.
327
328 It has several new functions for handling IPv6 addresses.
329
330 =item *
331
332 C<Storable> has been upgraded from 2.24 to 2.25.
333
334 This adds support for serialising code references that contain UTF-8 strings
335 correctly. The Storable minor version number changed as a result -- this means
336 Storable users that set C<$Storable::accept_future_minor> to a C<FALSE> value
337 will see errors (see L<Storable/FORWARD COMPATIBILITY> for more details).
338
339 =item *
340
341 C<Time::HiRes> has been upgraded from 1.9721 to 1.9721_01.
342
343 =item *
344
345 C<Unicode::Collate> has been upgraded from 0.67 to 0.68
346
347 =item *
348
349 C<Unicode::UCD> has been upgraded from 0.29 to 0.30.
350
351 =item *
352
353 C<version> has been upgraded from 0.82 to 0.86.
354
355 =item *
356
357 C<Win32> has been upgraded from 0.039 to 0.040.
358
359 =back
360
361 =head2 Removed Modules and Pragmata
362
363 =over 4
364
365 =item *
366
367 XXX
368
369 =back
370
371 =head1 Documentation
372
373 XXX Changes to files in F<pod/> go here.  Consider grouping entries by
374 file and be sure to link to the appropriate page, e.g. L<perlfunc>.
375
376 =head2 New Documentation
377
378 XXX Changes which create B<new> files in F<pod/> go here.
379
380 =head3 L<XXX>
381
382 XXX Description of the purpose of the new file here
383
384 =head2 Changes to Existing Documentation
385
386 XXX Changes which significantly change existing files in F<pod/> go here.
387 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
388 section.
389
390 =head3 L<XXX>
391
392 =over 4
393
394 =item *
395
396 XXX Description of the change here
397
398 =back
399
400 =head1 Diagnostics
401
402 The following additions or changes have been made to diagnostic output,
403 including warnings and fatal error messages.  For the complete list of
404 diagnostic messages, see L<perldiag>.
405
406 XXX New or changed warnings emitted by the core's C<C> code go here. Also
407 include any changes in L<perldiag> that reconcile it to the C<C> code.
408
409 [ Within each section, list entries as a =item entry ]
410
411 =head2 New Diagnostics
412
413 XXX Newly added diagnostic messages go here
414
415 =over 4
416
417 =item *
418
419 There is a new "Closure prototype called" error.
420
421 =back
422
423 =head2 Changes to Existing Diagnostics
424
425 XXX Changes (i.e. rewording) of diagnostic messages go here
426
427 =over 4
428
429 =item *
430
431 The "Found = in conditional" warning that is emitted when a constant is
432 assigned to a variable in a condition is now withheld if the constant is
433 actually a subroutine or one generated by C<use constant>, since the value
434 of the constant may not be known at the time the program is written
435 L<[perl #77762]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=77762>.
436
437 =back
438
439 =head1 Utility Changes
440
441 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
442 here. Most of these are built within the directories F<utils> and F<x2p>.
443
444 [ List utility changes as a =head3 entry for each utility and =item
445 entries for each change
446 Use L<XXX> with program names to get proper documentation linking. ]
447
448 =head3 L<XXX>
449
450 =over 4
451
452 =item *
453
454 XXX
455
456 =back
457
458 =head1 Configuration and Compilation
459
460 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
461 go here.  Any other changes to the Perl build process should be listed here.
462 However, any platform-specific changes should be listed in the
463 L</Platform Support> section, instead.
464
465 [ List changes as a =item entry ].
466
467 =over 4
468
469 =item *
470
471 XXX
472
473 =back
474
475 =head1 Testing
476
477 XXX Any significant changes to the testing of a freshly built perl should be
478 listed here.  Changes which create B<new> files in F<t/> go here as do any
479 large changes to the testing harness (e.g. when parallel testing was added).
480 Changes to existing files in F<t/> aren't worth summarising, although the bugs
481 that they represent may be covered elsewhere.
482
483 [ List each test improvement as a =item entry ]
484
485 =over 4
486
487 =item *
488
489 XXX
490
491 =back
492
493 =head1 Platform Support
494
495 XXX Any changes to platform support should be listed in the sections below.
496
497 [ Within the sections, list each platform as a =item entry with specific
498 changes as paragraphs below it. ]
499
500 =head2 New Platforms
501
502 XXX List any platforms that this version of perl compiles on, that previous
503 versions did not. These will either be enabled by new files in the F<hints/>
504 directories, or new subdirectories and F<README> files at the top level of the
505 source tree.
506
507 =over 4
508
509 =item XXX-some-platform
510
511 XXX
512
513 =back
514
515 =head2 Discontinued Platforms
516
517 XXX List any platforms that this version of perl no longer compiles on.
518
519 =over 4
520
521 =item XXX-some-platform
522
523 XXX
524
525 =back
526
527 =head2 Platform-Specific Notes
528
529 XXX List any changes for specific platforms. This could include configuration
530 and compilation changes or changes in portability/compatibility.  However,
531 changes within modules for platforms should generally be listed in the
532 L</Modules and Pragmata> section.
533
534 =over 4
535
536 =item NetBSD
537
538 The NetBSD hints file has been changed to make the system's malloc the
539 default.
540
541 =back
542
543 =head1 Internal Changes
544
545 XXX Changes which affect the interface available to C<XS> code go here.
546 Other significant internal changes for future core maintainers should
547 be noted as well.
548
549 [ List each test improvement as a =item entry ]
550
551 =over 4
552
553 =item *
554
555 C<mg_findext> and C<sv_unmagicext> have been added.
556
557 These new functions allow extension authors to find and remove magic attached to
558 scalars based on both the magic type and the magic virtual table, similar to how
559 C<sv_magicext> attaches magic of a certain type and with a given virtual table
560 to a scalar. This eliminates the need for extensions to walk the list of
561 C<MAGIC> pointers of an C<SV> to find the magic that belongs to them.
562
563 =item *
564
565 The C<parse_fullexpr()>, C<parse_listexpr(), C<parse_termexpr()> and
566 C<parse_arithexpr()> functions have been added.
567
568 These are for parsing expressions at various precedence levels.
569
570 =back
571
572 =head1 Selected Bug Fixes
573
574 XXX Important bug fixes in the core language are summarised here.
575 Bug fixes in files in F<ext/> and F<lib/> are best summarised in
576 L</Modules and Pragmata>.
577
578 [ List each fix as a =item entry ]
579
580 =over 4
581
582 =item *
583
584 C<BEGIN {require 5.12.0}> now behaves as documented, rather than behaving
585 identically to C<use 5.12.0;>. Previously, C<require> in a C<BEGIN> block
586 was erroneously executing the C<use feature ':5.12.0'> and
587 C<use strict; use warnings;> behaviour, which only C<use> was documented to
588 provide
589 L<[perl #69050]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=69050>.
590
591 =item *
592
593 C<use 5.42>
594 L<[perl #69050]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=69050>,
595 C<use 6> and C<no 5> no longer leak memory.
596
597 =item *
598
599 C<eval "BEGIN{die}"> no longer leaks memory on non-threaded builds.
600
601 =item *
602
603 PerlIO no longer crashes when called recursively, e.g., from a signal
604 handler. Now it just leaks memory
605 L<[perl #75556]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=75556>.
606
607 =item *
608
609 Defining a constant with the same name as one of perl's special blocks
610 (e.g., INIT) stopped working in 5.12.0, but has now been fixed
611 L<[perl #78634]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78634>.
612
613 =item *
614
615 A reference to a literal value used as a hash key (C<$hash{\"foo"}>) used
616 to be stringified, even if the hash was tied
617 L<[perl #79178]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=79178>.
618
619 =item *
620
621 A closure containing an C<if> statement followed by a constant or variable
622 is no longer treated as a constant
623 L<[perl #63540]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=63540>.
624
625 =item *
626
627 Calling a closure prototype (what is passed to an attribute handler for a
628 closure) now results in a "Closure prototype called" error message instead
629 of a crash
630 L<[perl #68560]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=68560>.
631
632 =item *
633
634 A regular expression optimisation would sometimes cause a match with a
635 C<{n,m}> quantifier to fail when it should match
636 L<[perl #79152]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=79152>.
637
638 =item *
639
640 What has become known as the "Unicode Bug" is resolved in this release.
641 Under C<use feature 'unicode_strings'>, the internal storage format of a
642 string no longer affects the external semantics.  There are two known
643 exceptions.  User-defined case changing functions, which are planned to
644 be deprecated in 5.14, require utf8-encoded strings to function; and the
645 character C<LATIN SMALL LETTER SHARP S> in regular expression
646 case-insensitive matching has a somewhat different set of bugs depending
647 on the internal storage format.  Case-insensitive matching of all
648 characters that have multi-character matches, as this one does, is
649 problematical in Perl.
650 L<[perl #58182]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=58182>.
651
652 =item *
653
654 Mentioning a read-only lexical variable from the enclosing scope in a
655 string C<eval> would cause the variable to become writable
656 L<[perl #19135]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=19135>.
657
658 =item *
659
660 C<state> can now be used with attributes. It used to mean the same thing as
661 C<my> if attributes were present
662 L<[perl #68658]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=68658>.
663
664 =item *
665
666 Expressions like C<< @$a > 3 >> no longer cause C<$a> to be mentioned in
667 the "Use of uninitialized value in numeric gt" warning when C<$a> is
668 undefined (since it is not part of the C<E<gt>> expression, but the operand
669 of the C<@>)
670 L<[perl #72090]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=72090>.
671
672 =item *
673
674 C<require> no longer causes C<caller> to return the wrong file name for
675 the scope that called C<require> and other scopes higher up that had the
676 same file name
677 L<[perl #68712]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=68712>.
678
679 =item *
680
681 The ref types in the typemap for XS bindings now support magical variables
682 L<[perl #72684]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=72684>.
683
684 =item *
685
686 Match variables (e.g., C<$1>) no longer persist between calls to a sort
687 subroutine
688 L<[perl #76026]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=76026>.
689
690 =item *
691
692 The C<B> module was returning B::OPs instead of B::LOGOPs for C<entertry>
693 L<[perl #80622]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=80622>.
694
695 This was due to a bug in the perl core, not in C<B> itself.
696
697 =back
698
699 =head1 Known Problems
700
701 XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
702 tests that had to be C<TODO>ed for the release would be noted here, unless
703 they were specific to a particular platform (see below).
704
705 This is a list of some significant unfixed bugs, which are regressions
706 from either 5.XXX.XXX or 5.XXX.XXX.
707
708 [ List each fix as a =item entry ]
709
710 =over 4
711
712 =item *
713
714 XXX
715
716 =back
717
718 =head1 Obituary
719
720 XXX If any significant core contributor has died, we've added a short obituary
721 here.
722
723 =head1 Acknowledgements
724
725 XXX The list of people to thank goes here.
726
727 =head1 Reporting Bugs
728
729 If you find what you think is a bug, you might check the articles
730 recently posted to the comp.lang.perl.misc newsgroup and the perl
731 bug database at http://rt.perl.org/perlbug/ .  There may also be
732 information at http://www.perl.org/ , the Perl Home Page.
733
734 If you believe you have an unreported bug, please run the L<perlbug>
735 program included with your release.  Be sure to trim your bug down
736 to a tiny but sufficient test case.  Your bug report, along with the
737 output of C<perl -V>, will be sent off to perlbug@perl.org to be
738 analysed by the Perl porting team.
739
740 If the bug you are reporting has security implications, which make it
741 inappropriate to send to a publicly archived mailing list, then please send
742 it to perl5-security-report@perl.org. This points to a closed subscription
743 unarchived mailing list, which includes all the core committers, who be able
744 to help assess the impact of issues, figure out a resolution, and help
745 co-ordinate the release of patches to mitigate or fix the problem across all
746 platforms on which Perl is supported. Please only use this address for
747 security issues in the Perl core, not for modules independently
748 distributed on CPAN.
749
750 =head1 SEE ALSO
751
752 The F<Changes> file for an explanation of how to view exhaustive details
753 on what changed.
754
755 The F<INSTALL> file for how to build Perl.
756
757 The F<README> file for general stuff.
758
759 The F<Artistic> and F<Copying> files for copyright information.
760
761 =cut