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