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