This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
7f9d3e216c1180ceba93a092e0d44b0527de68da
[perl5.git] / pod / perldelta.pod
1 =for todo
2 35e037e846 Commit 1735f6f started to escape all...
3 9b4bdfd44e fix chop formats with non PV vars
4
5 =encoding utf8
6
7 =head1 NAME
8
9 [ this is a template for a new perldelta file.  Any text flagged as XXX needs
10 to be processed before release. ]
11
12 perldelta - what is new for perl v5.19.6
13
14 =head1 DESCRIPTION
15
16 This document describes differences between the 5.19.5 release and the 5.19.6
17 release.
18
19 If you are upgrading from an earlier release such as 5.19.4, first read
20 L<perl5195delta>, which describes differences between 5.19.4 and 5.19.5.
21
22 =head1 Notice
23
24 XXX Any important notices here
25
26 =head1 Core Enhancements
27
28 XXX New core language features go here.  Summarize user-visible core language
29 enhancements.  Particularly prominent performance optimisations could go
30 here, but most should go in the L</Performance Enhancements> section.
31
32 [ List each enhancement as a =head2 entry ]
33
34 =head2 $a and $b warnings exemption
35
36 The special variables $a and $b, used in C<sort>, are now exempt from "used
37 once" warnings, even where C<sort> is not used.  This makes it easier for
38 CPAN modules to provide functions using $a and $b for similar purposes.
39 [perl #120462]
40
41 =head1 Security
42
43 XXX Any security-related notices go here.  In particular, any security
44 vulnerabilities closed should be noted here rather than in the
45 L</Selected Bug Fixes> section.
46
47 [ List each security issue as a =head2 entry ]
48
49 =head1 Incompatible Changes
50
51 XXX For a release on a stable branch, this section aspires to be:
52
53     There are no changes intentionally incompatible with 5.XXX.XXX
54     If any exist, they are bugs, and we request that you submit a
55     report.  See L</Reporting Bugs> below.
56
57 [ List each incompatible change as a =head2 entry ]
58
59 =head1 Deprecations
60
61 XXX Any deprecated features, syntax, modules etc. should be listed here.
62
63 =head2 Module removals
64
65 XXX Remove this section if inapplicable.
66
67 The following modules will be removed from the core distribution in a
68 future release, and will at that time need to be installed from CPAN.
69 Distributions on CPAN which require these modules will need to list them as
70 prerequisites.
71
72 The core versions of these modules will now issue C<"deprecated">-category
73 warnings to alert you to this fact.  To silence these deprecation warnings,
74 install the modules in question from CPAN.
75
76 Note that these are (with rare exceptions) fine modules that you are encouraged
77 to continue to use.  Their disinclusion from core primarily hinges on their
78 necessity to bootstrapping a fully functional, CPAN-capable Perl installation,
79 not usually on concerns over their design.
80
81 =over
82
83 =item L<Package::Constants>
84
85 =back
86
87 [ List each other deprecation as a =head2 entry ]
88
89 =head1 Performance Enhancements
90
91 XXX Changes which enhance performance without changing behaviour go here.
92 There may well be none in a stable release.
93
94 [ List each enhancement as a =item entry ]
95
96 =over 4
97
98 =item *
99
100 Constant hash key lookups (C<$hash{key}> as opposed to C<$hash{$key}>) have
101 long had the internal hash value computed at compile time, to speed up
102 lookup.  This optimisation has only now been applied to hash slices as
103 well.
104
105 =item *
106
107 Combined C<and> and C<or> operators in void context, like those
108 generated for C<< unless ($a && $b) >> and C<< if ($a || b) >> now
109 short circuit directly to the end of the statement. [perl #120128]
110
111 =back
112
113 =head1 Modules and Pragmata
114
115 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
116 go here.  If Module::CoreList is updated, generate an initial draft of the
117 following sections using F<Porting/corelist-perldelta.pl>, which prints stub
118 entries to STDOUT.  Results can be pasted in place of the '=head2' entries
119 below.  A paragraph summary for important changes should then be added by hand.
120 In an ideal world, dual-life modules would have a F<Changes> file that could be
121 cribbed.
122
123 [ Within each section, list entries as a =item entry ]
124
125 =head2 New Modules and Pragmata
126
127 =over 4
128
129 =item *
130
131 XXX
132
133 =back
134
135 =head2 Updated Modules and Pragmata
136
137 =over 4
138
139 =item *
140
141 L<B> has been upgraded from version 1.46 to 1.47.
142
143 C<< B::PMOP->precomp >> now preserves the internal UTF8 flag correctly, so
144 chr 256 remains chr 256, instead of turning into "\xc4\x80".  This allows
145 L<B::Deparse> to deparse Unicode regular expression correctly.
146 [perl #120182]
147
148 C<< B::HV->ARRAY >> now preserves the UTF8 flag on returned hash keys.
149 [perl #120535]
150
151 =item *
152
153 L<B::Concise> has been upgraded from version 0.99 to 0.991.
154
155 B<-debug> output now includes C<op_other> pointers.
156
157 =item *
158
159 L<B::Deparse> has been upgraded from version 1.23 to 1.24.
160
161 C<s//\(3)/e> is now deparsed in a way that does not issue warnings when
162 parsed again.  [perl #119807]
163
164 C<glob(my $x)> is now deparsed correctly, rather than as C<< <my $x> >> or
165 similar.
166
167 C<CORE::glob> is now deparsed correctly with the CORE:: prefix when there
168 is a subroutine named "glob".
169
170 =item *
171
172 L<IO::Select> has been upgraded from version 1.21 to 1.22.
173
174 Removing a closed file handle from an IO::Select object now correctly
175 updates its internal state and returns the correct value.  [perl #75156]
176
177 =item *
178
179 L<Module::CoreList> has been upgraded from version 3.00 to 3.01.
180
181 The list of Perl versions covered has been updated.
182
183 =item *
184
185 L<PerlIO::scalar> has been upgraded from version 0.17 to 0.18.
186
187 A bug fix in 0.17 caused references to be stringified as soon as a handle
188 to it was opened, even if it was opened only for reading.  It also croaked
189 on read-only references.  This has been fixed.  [perl #119529]
190
191 =item *
192
193 L<Tie::StdHandle> has been upgraded from version 4.3 to 4.4.
194
195 It no longer prints C<$\> twice.  [perl #120202]
196
197 It no longer ignores the offset passed to C<syswrite>.
198
199 =back
200
201 =head2 Removed Modules and Pragmata
202
203 =over 4
204
205 =item *
206
207 XXX
208
209 =back
210
211 =head1 Documentation
212
213 XXX Changes to files in F<pod/> go here.  Consider grouping entries by
214 file and be sure to link to the appropriate page, e.g. L<perlfunc>.
215
216 =head2 New Documentation
217
218 XXX Changes which create B<new> files in F<pod/> go here.
219
220 =head3 L<XXX>
221
222 XXX Description of the purpose of the new file here
223
224 =head2 Changes to Existing Documentation
225
226 XXX Changes which significantly change existing files in F<pod/> go here.
227 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
228 section.
229
230 =head3 L<XXX>
231
232 =over 4
233
234 =item *
235
236 XXX Description of the change here
237
238 =back
239
240 =head1 Diagnostics
241
242 The following additions or changes have been made to diagnostic output,
243 including warnings and fatal error messages.  For the complete list of
244 diagnostic messages, see L<perldiag>.
245
246 XXX New or changed warnings emitted by the core's C<C> code go here.  Also
247 include any changes in L<perldiag> that reconcile it to the C<C> code.
248
249 =head2 New Diagnostics
250
251 XXX Newly added diagnostic messages go under here, separated into New Errors
252 and New Warnings
253
254 =head3 New Errors
255
256 =over 4
257
258 =item *
259
260 XXX L<message|perldiag/"message">
261
262 =back
263
264 =head3 New Warnings
265
266 =over 4
267
268 =item *
269
270 XXX L<message|perldiag/"message">
271
272 =back
273
274 =head2 Changes to Existing Diagnostics
275
276 XXX Changes (i.e. rewording) of diagnostic messages go here
277
278 =over 4
279
280 =item *
281
282 L<%%s[%s] in scalar context better written as $%s[%s]|perldiag/"%%s[%s] in scalar context better written as $%s[%s]">:
283
284 This warning now occurs for any C<%array[$index]> or C<%hash{key}> known to
285 be in scalar context at compile time.  Previously it was worded "Scalar
286 value %%s[%s] better written as $%s[%s]".
287
288 =back
289
290 =head1 Utility Changes
291
292 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go here.
293 Most of these are built within the directories F<utils> and F<x2p>.
294
295 [ List utility changes as a =head3 entry for each utility and =item
296 entries for each change
297 Use L<XXX> with program names to get proper documentation linking. ]
298
299 =head3 L<XXX>
300
301 =over 4
302
303 =item *
304
305 XXX
306
307 =back
308
309 =head1 Configuration and Compilation
310
311 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
312 go here.  Any other changes to the Perl build process should be listed here.
313 However, any platform-specific changes should be listed in the
314 L</Platform Support> section, instead.
315
316 [ List changes as a =item entry ].
317
318 =over 4
319
320 =item *
321
322 XXX
323
324 =back
325
326 =head1 Testing
327
328 XXX Any significant changes to the testing of a freshly built perl should be
329 listed here.  Changes which create B<new> files in F<t/> go here as do any
330 large changes to the testing harness (e.g. when parallel testing was added).
331 Changes to existing files in F<t/> aren't worth summarizing, although the bugs
332 that they represent may be covered elsewhere.
333
334 [ List each test improvement as a =item entry ]
335
336 =over 4
337
338 =item *
339
340 F<ext/File-Find/t/find.t> has been converted from manual C<print>
341 statements to Test::More functions.  Each test now has a description.
342 [perl #120503]
343
344 =back
345
346 =head1 Platform Support
347
348 =head2 New Platforms
349
350 =over 4
351
352 =item Synology
353
354 Synology ships its NAS boxes with a lean Linux distribution (DSM) on relative
355 cheap CPU's (like the Marvell Kirkwood mv6282 - ARMv5tel or Freescale QorIQ
356 P1022 ppc - e500v2) not meant for workstations or development. These boxes
357 should build now. The basic problems are the non-standard location for tools.
358
359 =back
360
361 =head2 Discontinued Platforms
362
363 XXX List any platforms that this version of perl no longer compiles on.
364
365 =over 4
366
367 =item XXX-some-platform
368
369 XXX
370
371 =back
372
373 =head2 Platform-Specific Notes
374
375 XXX List any changes for specific platforms.  This could include configuration
376 and compilation changes or changes in portability/compatibility.  However,
377 changes within modules for platforms should generally be listed in the
378 L</Modules and Pragmata> section.
379
380 =over 4
381
382 =item Windows
383
384 Support for building with Visual C++ 2013 has been added.  There are currently
385 two possible test failures (see L<perlwin32/"Testing Perl on Windows">) which
386 will hopefully be resolved soon.
387
388 Experimental support for building with Intel C++ Compiler has been added. Only
389 the nmake makefile (win32/Makefile) can be used. A "nmake test" will not pass
390 at this time due to "cpan/CGI/t/url.t".
391
392 =item WinCE
393
394 Perl can now be built in one shot with no user intervention on WinCE by running
395 C<nmake -f Makefile.ce all>.
396
397 Support for building with EVC (Embedded Visual C++) 4 has been restored.  Perl
398 can also be built using Smart Devices for Visual C++ 2005 or 2008.
399
400 =back
401
402 =head1 Internal Changes
403
404 XXX Changes which affect the interface available to C<XS> code go here.  Other
405 significant internal changes for future core maintainers should be noted as
406 well.
407
408 [ List each change as a =item entry ]
409
410 =over 4
411
412 =item *
413
414 Compiling with C<-Accflags=-PERL_BOOL_AS_CHAR> now allows C99 and C++
415 compilers to emulate the aliasing of C<bool> to C<char> that perl does for
416 C89 compilers.  [perl #120314]
417
418 =back
419
420 =head1 Selected Bug Fixes
421
422 XXX Important bug fixes in the core language are summarized here.  Bug fixes in
423 files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
424
425 [ List each fix as a =item entry ]
426
427 =over 4
428
429 =item *
430
431 Perl 5.18.0 accidentally disallowed C<-bareword> under C<use strict> and
432 C<use integer>.  This has been fixed.  [perl #120288]
433
434 =item *
435
436 C<-a> at the start of a line (or a hyphen with any single letter that is
437 not a filetest operator) no longer produces an erroneous 'Use of "-a"
438 without parentheses is ambiguous' warning.  [perl #120288]
439
440 =item *
441
442 Lvalue context is now properly propagated into bare blocks and C<if> and
443 C<else> blocks in lvalue subroutines.  Previously, arrays and hashes would
444 sometimes incorrectly be flattened when returned in lvalue list context, or
445 "Bizarre copy" errors could occur.  [perl #119797]
446
447 =item *
448
449 Lvalue context is now propagated to the branches of C<||> and C<&&> (and
450 their alphabetic equivalents, C<or> and C<and>).  This means
451 C<foreach (pos $x || pos $y) {...}> now allows C<pos> to be modified
452 through $_.
453
454 =item *
455
456 C<*DB::DB = sub {} if 0> no longer stops Perl's debugging mode from finding
457 C<DB::DB> subs declared thereafter.
458
459 =item *
460
461 C<stat> and C<readline> remember the last handle used; the former
462 for the special C<_> filehandle, the latter for C<${^LAST_FH}>.
463 C<eval "*foo if 0"> where *foo was the last handle passed to C<stat>
464 or C<readline> could cause that handle to be forgotten if the
465 handle were not opened yet.  This has been fixed.
466
467 =item *
468
469 Various cases of C<delete $::{a}>, C<delete $::{ENV}> etc. causing a crash
470 have been fixed.  [perl #54044]
471
472 =item *
473
474 Assigning another typeglob to C<*^R> no longer makes the regular expression
475 engine crash.
476
477 =item *
478
479 C<%{'_<...'}> hashes now set breakpoints on the corresponding C<@{'_<...'}>
480 rather than whichever array C<@DB::dbline> is aliased to.  [perl #119799]
481
482 =item *
483
484 Setting C<$!> to EACCESS before calling C<require> could affect
485 C<require>'s behaviour.  This has been fixed.
486
487 =item *
488
489 The "Can't use \1 to mean $1 in expression" warning message now only occurs
490 on the right-hand (replacement) part of a substitution.  Formerly it could
491 happen in code embedded in the left-hand side, or in any other quote-like
492 operator.
493
494 =item *
495
496 The C<\N> regular expression escape, when used without the curly braces (to
497 mean C<[^\n]>), was ignoring a following C<*> if followed by whitespace
498 under /x.  It had been this way since C<\N> to mean C<[^\n]> was introduced
499 in 5.12.0.
500
501 =item *
502
503 Blessing into a reference (C<bless $thisref, $thatref>) has long been
504 disallowed, but magical scalars for the second like C<$/> and those tied
505 were exempt.  They no longer are.  [perl #119809]
506
507 =item *
508
509 Blessing into a reference was accidentally allowed in 5.18 if the class
510 argument were a blessed reference with stale method caches (i.e., whose
511 class had had subs defined since the last method call).  They are
512 disallowed once more, as in 5.16.
513
514 =item *
515
516 An undefined lexical sub used as an inherited method no longer crashes.
517
518 =item *
519
520 C<< $x->{key} >> where $x was declared as C<my Class $x> no longer crashes
521 if a Class::FIELDS subroutine stub has been declared.
522
523 =item *
524
525 C<@$obj{'key'}> and C<${$obj}{key}> used to be exempt from compile-time
526 field checking ("No such class field"; see L<fields>) but no longer are.
527
528 =item *
529
530 That compile-time field checking also applies now to the C<%$obj{'key'}>
531 syntax, added recently in Perl 5.19.4.
532
533 =item *
534
535 A nonexistent array element with a large index passed to a subroutine that
536 ties the array and then tries to access the element no longer results in a
537 crash.
538
539 =item *
540
541 Declaring a subroutine stub named NEGATIVE_INDICES no longer makes negative
542 array indices crash when the current package is a tied array class.
543
544 =item *
545
546 Declaring a C<require>, C<glob>, or C<do> subroutine stub in the
547 CORE::GLOBAL:: package no longer makes compilation of calls to the
548 corresponding functions crash.
549
550 =item *
551
552 Aliasing CORE::GLOBAL:: functions to constants stopped working in Perl 5.10
553 but has now been fixed.
554
555 =item *
556
557 When C<`...`> or C<qx/.../> calls a C<readpipe> override, double-quotish
558 interpolation now happens, as is the case when there is no override.
559 Previously, the presence of an override would make these quote-like
560 operators act like C<q{}>, suppressing interpolation.  [perl #115330]
561
562 =item *
563
564 C<<<`...`> here-docs (with backticks as the delimiters) now call
565 C<readpipe> overrides.  [perl #119827]
566
567 =item *
568
569 The presence of a lexical sub named "CORE" no longer stops the CORE::
570 prefix from working.
571
572 =item *
573
574 C<&CORE::exit()> and C<&CORE::die()> now respect L<vmsish> hints.
575
576 =item *
577
578 Undefining a glob that triggers a DESTROY method that undefines the same
579 glob is now safe.  It used to produce "Attempt to free unreferenced glob
580 pointer" warnings and leak memory.
581
582 =item *
583
584 If subroutine redefinition (C<eval 'sub foo{}'> or C<newXS> for XS code)
585 triggers a DESTROY method on the sub that is being redefined, and that
586 method assigns a subroutine to the same slot (C<*foo = sub {}>), C<$_[0]>
587 is no longer left pointing to a freed scalar.  Now DESTROY is delayed until
588 the new subroutine has been installed.
589
590 =item *
591
592 C<s///>, C<tr///> and C<y///> now work when a wide character is used as the
593 delimiter.  [perl #120463]
594
595 =item *
596
597 On Windows, perl no longer calls CloseHandle() on a socket handle.  This makes
598 debugging easier on Windows by removing certain irrelevant bad handle
599 exceptions.  It also fixes a race condition that made socket functions randomly
600 fail in a Perl process with multiple OS threads, and possible test failures in
601 F<dist/IO/t/cachepropagate-tcp.t>.  [perl #120091/118059]
602
603 =item *
604
605 Some cases of unterminated (?...) sequences in regular expressions (e.g.,
606 C</(?</>) have been fixed to produce the proper error message instead of
607 "panic: memory wrap".  Other cases (e.g., C</(?(/>) have yet to be fixed.
608
609 =back
610
611 =head1 Known Problems
612
613 XXX Descriptions of platform agnostic bugs we know we can't fix go here.  Any
614 tests that had to be C<TODO>ed for the release would be noted here.  Unfixed
615 platform specific bugs also go here.
616
617 [ List each fix as a =item entry ]
618
619 =over 4
620
621 =item *
622
623 C<do CORE()> used to call a sub named "CORE" and treat its return value as
624 a file name to execute.  A bug fix inadvertently caused it to be
625 interpreted as the deprecated "do-SUB" construct.  (Yes, C<do
626 I<bareword>()> is inconsistent.)  This will likely be changed back.
627
628 =back
629
630 =head1 Obituary
631
632 XXX If any significant core contributor has died, we've added a short obituary
633 here.
634
635 =head1 Acknowledgements
636
637 XXX Generate this with:
638
639   perl Porting/acknowledgements.pl v5.19.5..HEAD
640
641 =head1 Reporting Bugs
642
643 If you find what you think is a bug, you might check the articles recently
644 posted to the comp.lang.perl.misc newsgroup and the perl bug database at
645 http://rt.perl.org/perlbug/ .  There may also be information at
646 http://www.perl.org/ , the Perl Home Page.
647
648 If you believe you have an unreported bug, please run the L<perlbug> program
649 included with your release.  Be sure to trim your bug down to a tiny but
650 sufficient test case.  Your bug report, along with the output of C<perl -V>,
651 will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
652
653 If the bug you are reporting has security implications, which make it
654 inappropriate to send to a publicly archived mailing list, then please send it
655 to perl5-security-report@perl.org.  This points to a closed subscription
656 unarchived mailing list, which includes all the core committers, who will be
657 able to help assess the impact of issues, figure out a resolution, and help
658 co-ordinate the release of patches to mitigate or fix the problem across all
659 platforms on which Perl is supported.  Please only use this address for
660 security issues in the Perl core, not for modules independently distributed on
661 CPAN.
662
663 =head1 SEE ALSO
664
665 The F<Changes> file for an explanation of how to view exhaustive details on
666 what changed.
667
668 The F<INSTALL> file for how to build Perl.
669
670 The F<README> file for general stuff.
671
672 The F<Artistic> and F<Copying> files for copyright information.
673
674 =cut