This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
1951fb15e76ddf639b5823425f977464898a3ee7
[perl5.git] / pod / perldelta.pod
1 =encoding utf8
2
3 =head1 NAME
4
5 [ this is a template for a new perldelta file.  Any text flagged as XXX needs
6 to be processed before release. ]
7
8 perldelta - what is new for perl v5.23.8
9
10 =head1 DESCRIPTION
11
12 This document describes differences between the 5.23.7 release and the 5.23.8
13 release.
14
15 If you are upgrading from an earlier release such as 5.23.6, first read
16 L<perl5237delta>, which describes differences between 5.23.6 and 5.23.7.
17
18 =head1 Notice
19
20 XXX Any important notices here
21
22 =head1 Core Enhancements
23
24 XXX New core language features go here.  Summarize user-visible core language
25 enhancements.  Particularly prominent performance optimisations could go
26 here, but most should go in the L</Performance Enhancements> section.
27
28 [ List each enhancement as a =head2 entry ]
29
30 =head2 More fields provided to C<sigaction> callback with C<SA_SIGINFO>
31
32 When passing the C<SA_SIGINFO> flag to L<sigaction|POSIX/sigaction>, the
33 C<errno>, C<status>, C<uid>, C<pid>, C<addr> and C<band> fields are now
34 included in the hash passed to the handler, if supported by the
35 platform.
36
37 =head1 Security
38
39 XXX Any security-related notices go here.  In particular, any security
40 vulnerabilities closed should be noted here rather than in the
41 L</Selected Bug Fixes> section.
42
43 [ List each security issue as a =head2 entry ]
44
45 =head1 Incompatible Changes
46
47 XXX For a release on a stable branch, this section aspires to be:
48
49     There are no changes intentionally incompatible with 5.XXX.XXX
50     If any exist, they are bugs, and we request that you submit a
51     report.  See L</Reporting Bugs> below.
52
53 [ List each incompatible change as a =head2 entry ]
54
55 =head2 C<qr/\N{}/> now disallowed under C<use re "strict">
56
57 An empty C<\N{}> makes no sense, but for backwards compatibility is
58 silently accepted as doing nothing.  But now this is a fatal error under
59 the experimental feature L<re/'strict' mode>.
60
61 =head1 Deprecations
62
63 XXX Any deprecated features, syntax, modules etc. should be listed here.
64
65 =head2 Module removals
66
67 XXX Remove this section if inapplicable.
68
69 The following modules will be removed from the core distribution in a
70 future release, and will at that time need to be installed from CPAN.
71 Distributions on CPAN which require these modules will need to list them as
72 prerequisites.
73
74 The core versions of these modules will now issue C<"deprecated">-category
75 warnings to alert you to this fact.  To silence these deprecation warnings,
76 install the modules in question from CPAN.
77
78 Note that these are (with rare exceptions) fine modules that you are encouraged
79 to continue to use.  Their disinclusion from core primarily hinges on their
80 necessity to bootstrapping a fully functional, CPAN-capable Perl installation,
81 not usually on concerns over their design.
82
83 =over
84
85 =item XXX
86
87 XXX Note that deprecated modules should be listed here even if they are listed
88 as an updated module in the L</Modules and Pragmata> section.
89
90 =back
91
92 [ List each other deprecation as a =head2 entry ]
93
94 =head1 Performance Enhancements
95
96 XXX Changes which enhance performance without changing behaviour go here.
97 There may well be none in a stable release.
98
99 [ List each enhancement as a =item entry ]
100
101 =over 4
102
103 =item *
104
105 The overhead of scope entry and exit has been considerably reduced, so
106 for example subroutine calls, loops and basic blocks are all faster now.
107 This empty function call now takes about a third less time to execute:
108
109     sub f{} f();
110
111 =item *
112
113 On Win32, C<stat>ing or C<-X>ing a path, if the file or directory does not
114 exist, is now 3.5x faster on a SSD (or any drive) than before.
115
116 =back
117
118 =head1 Modules and Pragmata
119
120 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
121 go here.  If Module::CoreList is updated, generate an initial draft of the
122 following sections using F<Porting/corelist-perldelta.pl>.  A paragraph summary
123 for important changes should then be added by hand.  In an ideal world,
124 dual-life modules would have a F<Changes> file that could be cribbed.
125
126 [ Within each section, list entries as a =item entry ]
127
128 =head2 New Modules and Pragmata
129
130 =over 4
131
132 =item *
133
134 XXX
135
136 =back
137
138 =head2 Updated Modules and Pragmata
139
140 =over 4
141
142 =item *
143
144 F<cpan/podlators/> has been upgraded from version 4.04 to 4.06.
145
146 =item *
147
148 L<POSIX> has been upgraded from version 1.59 to 1.63.
149
150 It can now export constants for the C<code> value in the hash passed to the
151 L<sigaction|POSIX/sigaction> handler when using the C<SA_SIGINFO> flag.
152
153 These previously deprecated functions are now removed: C<isalnum>,
154 C<isalpha>, C<iscntrl>, C<isdigit>, C<isgraph>, C<islower>, C<isprint>,
155 C<ispunct>, C<isspace>, C<isupper>, and C<isxdigit>.
156
157 =item *
158
159 L<Encode> has been upgraded from version 2.78 to 2.80.
160
161 =item *
162
163 L<Storable> has been upgraded from version 2.54 to 2.55.
164
165 =item *
166
167 L<Time::HiRes> has been upgraded from version 1.9728 to 1.9730.
168
169 It can now export Linux-specific and FreeBSD-specific C<clock_gettime()>
170 constants. It also now has emulation for OS X C<clock_nanosleep()>,
171 C<clock_gettime()>, and C<clock_getres()>.
172
173 =item *
174
175 L<DynaLoader> has been upgraded from version 1.37 to 1.38.
176
177 DynaLoader now always looks for bootstrap files having the same base name as
178 the module for which the bootstrap code is being run. Previously, and only on
179 platforms that use C<mod2fname> to produce unique loadable library names,
180 L<DynaLoader> would look for the bootstrap file using a base name that matched
181 the loadable library and not find it.
182
183 =item *
184
185 L<PerlIO::encoding> has been upgraded from version 0.23 to 0.24.
186
187 =item *
188
189 The PathTools module collection has been upgraded from version 3.62
190 to 3.63.
191
192 =back
193
194 =head2 Removed Modules and Pragmata
195
196 =over 4
197
198 =item *
199
200 XXX
201
202 =back
203
204 =head1 Documentation
205
206 XXX Changes to files in F<pod/> go here.  Consider grouping entries by
207 file and be sure to link to the appropriate page, e.g. L<perlfunc>.
208
209 =head2 New Documentation
210
211 XXX Changes which create B<new> files in F<pod/> go here.
212
213 =head3 L<XXX>
214
215 XXX Description of the purpose of the new file here
216
217 =head2 Changes to Existing Documentation
218
219 XXX Changes which significantly change existing files in F<pod/> go here.
220 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
221 section.
222
223 =head3 L<perlguts>
224
225 =over 4
226
227 =item *
228
229 A new section has been added, L<perlguts/"Dynamic Scope and the Context
230 Stack">, which explains how the perl context stack works.
231
232 =back
233
234 =head3 L<perlmodlib>
235
236 =over 4
237
238 =item *
239
240 We now recommend contacting the module-authors list or PAUSE in seeking
241 guidance on the naming of modules.
242
243 =back
244
245 =head1 Diagnostics
246
247 The following additions or changes have been made to diagnostic output,
248 including warnings and fatal error messages.  For the complete list of
249 diagnostic messages, see L<perldiag>.
250
251 XXX New or changed warnings emitted by the core's C<C> code go here.  Also
252 include any changes in L<perldiag> that reconcile it to the C<C> code.
253
254 =head2 New Diagnostics
255
256 XXX Newly added diagnostic messages go under here, separated into New Errors
257 and New Warnings
258
259 =head3 New Errors
260
261 =over 4
262
263 =item *
264
265 L<Sequence (?PE<lt>... not terminated in regex; marked by S<<-- HERE> in mE<sol>%sE<sol>
266 |perldiag/"Sequence (?PE<lt>... not terminated in regex; marked by <-- HERE in mE<sol>%sE<sol>">
267
268 =item *
269
270 L<Sequence (?PE<gt>... not terminated in regex; marked by S<<-- HERE> in mE<sol>%sE<sol>
271 |perldiag/Sequence (?PE<gt>... not terminated in regex; marked by <-- HERE in mE<sol>%sE<sol>>
272
273 =item *
274
275 L<Empty \%c in regex; marked by S<<-- HERE> in mE<sol>%sE<sol>
276 |perldiag/Empty \%c in regex; marked by <-- HERE in mE<sol>%sE<sol>>
277
278 =back
279
280 =head3 New Warnings
281
282 =over 4
283
284 =item *
285
286 L<Assuming NOT a POSIX class since %s in regex; marked by E<lt>-- HERE in mE<sol>%sE<sol>|
287 perldiag/Assuming NOT a POSIX class since %s in regex; marked by <-- HERE in mE<sol>%sE<sol>>
288
289 =back
290
291 =head2 Changes to Existing Diagnostics
292
293 XXX Changes (i.e. rewording) of diagnostic messages go here
294
295 =over 4
296
297 =item *
298
299 XXX Describe change here
300
301 =back
302
303 =head1 Utility Changes
304
305 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go here.
306 Most of these are built within the directory F<utils>.
307
308 [ List utility changes as a =head2 entry for each utility and =item
309 entries for each change
310 Use L<XXX> with program names to get proper documentation linking. ]
311
312 =head2 L<XXX>
313
314 =over 4
315
316 =item *
317
318 XXX
319
320 =back
321
322 =head1 Configuration and Compilation
323
324 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
325 go here.  Any other changes to the Perl build process should be listed here.
326 However, any platform-specific changes should be listed in the
327 L</Platform Support> section, instead.
328
329 [ List changes as a =item entry ].
330
331 =over 4
332
333 =item *
334
335 The GNU Make makefile for Win32 now supports parallel builds.  [perl #126632]
336
337 =item *
338
339 You can now build perl with MSVC++ on Win32 using GNU Make.  [perl #126632]
340
341 =item *
342
343 Bison 3.0 is now supported.
344
345 =back
346
347 =head1 Testing
348
349 XXX Any significant changes to the testing of a freshly built perl should be
350 listed here.  Changes which create B<new> files in F<t/> go here as do any
351 large changes to the testing harness (e.g. when parallel testing was added).
352 Changes to existing files in F<t/> aren't worth summarizing, although the bugs
353 that they represent may be covered elsewhere.
354
355 [ List each test improvement as a =item entry ]
356
357 =over 4
358
359 =item *
360
361 XXX
362
363 =back
364
365 =head1 Platform Support
366
367 =head2 Platform-Specific Notes
368
369 =over 4
370
371 =item VMS
372
373 =over
374
375 =item *
376
377 For those C<%ENV> elements based on the CRTL environ array, we've always
378 preserved case when setting them but did look-ups only after upcasing the
379 key first, which made lower- or mixed-case entries go missing. This problem
380 has been corrected by making C<%ENV> elements derived from the environ array
381 case-sensitive on look-up as well as case-preserving on store.
382
383 =item *
384
385 Environment look-ups for C<PERL5LIB> and C<PERLLIB> previously only
386 considered logical names, but now consider all sources of C<%ENV> as
387 determined by C<PERL_ENV_TABLES> and as documented in L<perlvms/%ENV>.
388
389 =back
390
391 =back
392
393 =head2 New Platforms
394
395 XXX List any platforms that this version of perl compiles on, that previous
396 versions did not.  These will either be enabled by new files in the F<hints/>
397 directories, or new subdirectories and F<README> files at the top level of the
398 source tree.
399
400 =over 4
401
402 =item XXX-some-platform
403
404 XXX
405
406 =back
407
408 =head2 Discontinued Platforms
409
410 XXX List any platforms that this version of perl no longer compiles on.
411
412 =over 4
413
414 =item XXX-some-platform
415
416 XXX
417
418 =back
419
420 =head2 Platform-Specific Notes
421
422 XXX List any changes for specific platforms.  This could include configuration
423 and compilation changes or changes in portability/compatibility.  However,
424 changes within modules for platforms should generally be listed in the
425 L</Modules and Pragmata> section.
426
427 =over 4
428
429 =item Win32
430
431 Builds using Microsoft Visual C++ 2003 and earlier no longer produce
432 an "INTERNAL COMPILER ERROR" message.  [perl #126045]
433
434 =back
435
436 =head1 Internal Changes
437
438 XXX Changes which affect the interface available to C<XS> code go here.  Other
439 significant internal changes for future core maintainers should be noted as
440 well.
441
442 [ List each change as a =item entry ]
443
444 =over 4
445
446 =item *
447
448 The implementation of perl's context stack system, and its internal API,
449 have been heavily reworked. Note that no significant changes have been
450 made to any external APIs, but XS code which relies on such internal
451 details may need to be fixed. The main changes are:
452
453 =over 4
454
455 =item *
456
457 The C<PUSHBLOCK()>, C<POPSUB()> etc. macros have been replaced with static
458 inline functions such as C<cx_pushblock()>, C<cx_popsub()> etc. These use
459 function args rather than implicitly relying on local vars such as
460 C<gimme> and C<newsp> being available. Also their functionality has
461 changed: in particular, C<cx_popblock()> no longer decrements
462 C<cxstack_ix>. The ordering of the steps in the C<pp_leave*> functions
463 involving C<cx_popblock()>, C<cx_popsub()> etc. has changed. See the new
464 documentation, L<perlguts/"Dynamic Scope and the Context Stack">, for
465 details on how to use them.
466
467 =item *
468
469 Various macros, which now consistently have a CX_ prefix, have been added:
470
471   CX_CUR(), CX_LEAVE_SCOPE(), CX_POP()
472
473 or renamed:
474
475   CX_POP_SAVEARRAY(), CX_DEBUG(), CX_PUSHSUBST(), CX_POPSUBST()
476
477 =item *
478
479 C<cx_pushblock()> now saves C<PL_savestack_ix> and C<PL_tmps_floor>, so
480 CMpp_enter*> and C<pp_leave*> no longer do
481
482   ENTER; SAVETMPS; ....; LEAVE
483
484 =item *
485
486 C<cx_popblock()> now also restores C<PL_curpm>.
487
488 =item *
489
490 In C<dounwind()> for every context type, the current savestack frame is
491 now processed before each context is popped; formerly this was only done
492 for sub-like context frames. This action has been removed from
493 C<cx_popsub()> and placed into its own macro, C<CX_LEAVE_SCOPE(cx)>, which
494 must be called before C<cx_popsub()> etc.
495
496 C<dounwind()> now also does a C<cx_popblock()> on the last popped frame
497 (formerly it only did the C<cx_popsub()> etc. actions on each frame).
498
499 =item *
500
501 The temps stack is now freed on scope exit; previously, temps created
502 during the last statement of a block wouldn't be freed until the next
503 C<nextstate> following the block (apart from an existing hack that did
504 this for recursive subs in scalar context); and in something like
505 C<f(g())>, the temps created by the last statement in C<g()> would
506 formerly not be freed until the statement following the return from
507 C<f()>.
508
509 =item *
510
511 Most values that were saved on the savestack on scope entry are now
512 saved in suitable new fields in the context struct, and saved and
513 restored directly by C<cx_pushfoo()> and C<cx_popfoo()>, which is much
514 faster.
515
516 =item *
517
518 Various context struct fields have been added, removed or modified.
519
520 =item *
521
522 The handling of C<@_> in C<cx_pushsub()> and C<cx_popsub()> has been
523 considerably tidied up, including removing the C<argarray> field from the
524 context struct, and extracting out some common (but rarely used) code into
525 a separate function, C<clear_defarray()>. Also, useful subsets of
526 C<cx_popsub()> which had been unrolled in places like C<pp_goto> have been
527 gathered into the new functions C<cx_popsub_args()> and
528 C<cx_popsub_common()>.
529
530 =item *
531
532 C<pp_leavesub> and C<pp_leavesublv> now use the same function as the rest
533 of the C<pp_leave*>'s to process return args.
534
535 =item *
536
537 C<CXp_FOR_PAD> and C<CXp_FOR_GV> flags have been added, and
538 C<CXt_LOOP_FOR> has been split into C<CXt_LOOP_LIST>, C<CXt_LOOP_ARY>.
539
540 =item *
541
542 Some variables formerly declared by C<dMULTICALL> (but not documented) have
543 been removed.
544
545 =back
546
547
548 =back
549
550 =head1 Selected Bug Fixes
551
552 XXX Important bug fixes in the core language are summarized here.  Bug fixes in
553 files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
554
555 [ List each fix as a =item entry ]
556
557 =over 4
558
559 =item *
560
561 Line numbers larger than 2**31-1 but less than 2**32 are no longer
562 returned by caller() as negative numbers.  [perl #126991]
563
564 =item *
565
566 C<< unless ( I<assignment> ) >> now properly warns when syntax
567 warnings are enabled.  [perl #127122]
568
569 =item *
570
571 Setting an C<ISA> glob to an array reference now properly adds
572 C<isaelem> magic to any existing elements.  Previously modifying such
573 an element would not update the ISA cache, so method calls would call
574 the wrong function.  Perl would also crash if the C<ISA> glob was
575 destroyed, since new code added in 5.23.7 would try to release the
576 C<isaelem> magic from the elements.  [perl #127351]
577
578 =item *
579
580 If a here-doc was found while parsing another operator, the parser had
581 already read end of file, and the here-doc was not terminated, perl
582 could produce an assertion or a segmentation fault.  This now reliably
583 complains about the unterminated here-doc.  [perl #125540]
584
585 =item *
586
587 untie() would sometimes return the last value returned by the UNTIE()
588 handler as well as it's normal value, messing up the stack.  [perl
589 #126621]
590
591 =item *
592
593 Fixed an operator precedence problem when C< castflags & 2> is true.
594 [perl #127474]
595
596 =item *
597
598 Caching of DESTROY methods could result in a non-pointer or a
599 non-STASH stored in the SvSTASH() slot of a stash, breaking the B
600 STASH() method.  The DESTROY method is now cached in the MRO metadata
601 for the stash.  [perl #126410]
602
603 =item *
604
605 The AUTOLOAD method is now called when searching for a DESTROY method,
606 and correctly sets C<$AUTOLOAD> too.  [perl #124387]  [perl #127494]
607
608 =item *
609
610 Avoid parsing beyond the end of the buffer when processing a C<#line>
611 directive with no filename.  [perl #127334]
612
613 =item *
614
615 Perl now raises a warning when a regular expression pattern looks like
616 it was supposed to contain a POSIX class, like C<qr/[[:alpha:]]/>, but
617 there was some slight defect in its specification which causes it to
618 instead be treated as a regular bracketed character class.  An example
619 would be missing the second colon in the above like this:
620 C<qr/[[:alpha]]/>.  This compiles to match a sequence of two characters.
621 The second is C<"]">, and the first is any of: C<"[">, C<":">, C<"a">,
622 C<"h">, C<"l">, or C<"p">.   This is unlikely to be the intended
623 meaning, and now a warning is raised.  No warning is raised unless the
624 specification is very close to one of the 14 legal POSIX classes.  (See
625 L<perlrecharclass/POSIX Character Classes>.)
626 [perl #8904]
627
628 =item *
629
630 Certain regex patterns involving a complemented posix class in an
631 inverted bracketed character class, and matching something else
632 optionally would improperly fail to match.  An example of one that could
633 fail is C</qr/_?[^\Wbar]\x{100}/>.  This has been fixed.
634 [perl #127537]
635
636 =back
637
638 =head1 Known Problems
639
640 XXX Descriptions of platform agnostic bugs we know we can't fix go here.  Any
641 tests that had to be C<TODO>ed for the release would be noted here.  Unfixed
642 platform specific bugs also go here.
643
644 [ List each fix as a =item entry ]
645
646 =over 4
647
648 =item *
649
650 XXX
651
652 =back
653
654 =head1 Errata From Previous Releases
655
656 =over 4
657
658 =item *
659
660 XXX Add anything here that we forgot to add, or were mistaken about, in
661 the perldelta of a previous release.
662
663 =back
664
665 =head1 Obituary
666
667 XXX If any significant core contributor has died, we've added a short obituary
668 here.
669
670 =head1 Acknowledgements
671
672 XXX Generate this with:
673
674   perl Porting/acknowledgements.pl v5.23.7..HEAD
675
676 =head1 Reporting Bugs
677
678 If you find what you think is a bug, you might check the articles recently
679 posted to the comp.lang.perl.misc newsgroup and the perl bug database at
680 L<https://rt.perl.org/> .  There may also be information at
681 L<http://www.perl.org/> , the Perl Home Page.
682
683 If you believe you have an unreported bug, please run the L<perlbug> program
684 included with your release.  Be sure to trim your bug down to a tiny but
685 sufficient test case.  Your bug report, along with the output of C<perl -V>,
686 will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
687
688 If the bug you are reporting has security implications, which make it
689 inappropriate to send to a publicly archived mailing list, then please send it
690 to perl5-security-report@perl.org.  This points to a closed subscription
691 unarchived mailing list, which includes all the core committers, who will be
692 able to help assess the impact of issues, figure out a resolution, and help
693 co-ordinate the release of patches to mitigate or fix the problem across all
694 platforms on which Perl is supported.  Please only use this address for
695 security issues in the Perl core, not for modules independently distributed on
696 CPAN.
697
698 =head1 SEE ALSO
699
700 The F<Changes> file for an explanation of how to view exhaustive details on
701 what changed.
702
703 The F<INSTALL> file for how to build Perl.
704
705 The F<README> file for general stuff.
706
707 The F<Artistic> and F<Copying> files for copyright information.
708
709 =cut