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.25.7
   9
  10 =head1 DESCRIPTION
  11
  12 This document describes differences between the 5.25.6 release and the 5.25.7
  13 release.
  14
  15 If you are upgrading from an earlier release such as 5.25.5, first read
  16 L<perl5256delta>, which describes differences between 5.25.5 and 5.25.6.
  17
  18 =head1 Core Enhancements
  19
  20 XXX New core language features go here.  Summarize user-visible core language
  21 enhancements.  Particularly prominent performance optimisations could go
  22 here, but most should go in the L</Performance Enhancements> section.
  23
  24 [ List each enhancement as a =head2 entry ]
  25
  26 =head2 Indented Here-documents
  27
  28 This adds a new modifier '~' to here-docs that tells the parser
  29 that it should look for /^\s*$DELIM\n/ as the closing delimiter.
  30
  31 These syntaxes are all supported:
  32
  33     <<~EOF;
  34     <<~\EOF;
  35     <<~'EOF';
  36     <<~"EOF";
  37     <<~`EOF`;
  38     <<~ 'EOF';
  39     <<~ "EOF";
  40     <<~ `EOF`;
  41
  42 The '~' modifier will strip, from each line in the here-doc, the
  43 same whitespace that appears before the delimiter.
  44
  45 Newlines will be copied as is, and lines that don't include the
  46 proper beginning whitespace will cause perl to croak.
  47
  48 For example:
  49
  50     if (1) {
  51       print <<~EOF;
  52         Hello there
  53         EOF
  54     }
  55
  56 prints "Hello there\n" with no leading whitespace.
  57
  58 =head2 '.' and @INC
  59
  60 Perl now provides a way to build perl without C<.> in @INC by default. If you
  61 want this feature, you can build with -Ddefault_inc_excludes_dot
  62
  63 Because the testing / make process for perl modules do not function well with
  64 C<.> missing from @INC, Perl now supports the environment variable
  65 PERL_USE_UNSAFE_INC=1 which makes Perl behave as it previously did, returning
  66 C<.> to @INC in all child processes.
  67
  68 WARNING: PERL_USE_UNSAFE_INC has been provided during the perl 5.25 development
  69 cycle and is not guaranteed to function in perl 5.26.
  70
  71 =head2 create a safer utf8_hop() called utf8_hop_safe()
  72
  73 Unlike utf8_hop(), utf8_hop_safe() won't navigate before the beginning or after
  74 the end of the supplied buffer.
  75
  76 =head2 Fix taint handling in list assignment
  77
  78 commit v5.25.6-79-gb09ed99 reworked list assignment, and
  79 accidentally broke taint handling at the same time.
  80
  81 =head2 @{^CAPTURE}, %{^CAPTURE}, and %{^CAPTURE_ALL}
  82
  83 @{^CAPTURE} exposes the capture buffers of the last match as an array. So $1 is
  84 ${^CAPTURE}[0].
  85
  86 %{^CAPTURE} is the equivalent to %+ (ie named captures)
  87
  88 %{^CAPTURE_ALL} is the equivalent to %- (ie all named captures).
  89
  90 =head2 hv.h: rework HEK_FLAGS to a proper member in struct hek
  91
  92 Move the store of HEK_FLAGS off the end of the allocated hek_key into the hek
  93 struct, simplifying access and providing clarity to the code.
  94
  95 =head2 op.c: silence compiler warning in fold_constants()
  96
  97     op.c: In function ‘S_fold_constants’:
  98     op.c:4374:28: warning: argument ‘o’ might be clobbered by ‘longjmp’ or ‘vfork’ [-Wclobbered]
  99      S_fold_constants(pTHX_ OP *o)
 100                                 ^
 101
 102 This warning has been silenced.
 103
 104 =head2 White space changed to avoid C++ deprecation warning
 105
 106 C++11 requires space between the end of a string literal and a macro, so that a
 107 feature can unambiguously be added to the language.  Starting in g++ 6.2, the
 108 compiler emits a warning when there isn't a space (presumably so that future
 109 versions can support C++11)
 110
 111 =head1 Security
 112
 113 XXX Any security-related notices go here.  In particular, any security
 114 vulnerabilities closed should be noted here rather than in the
 115 L</Selected Bug Fixes> section.
 116
 117 [ List each security issue as a =head2 entry ]
 118
 119 =head1 Incompatible Changes
 120
 121 XXX For a release on a stable branch, this section aspires to be:
 122
 123     There are no changes intentionally incompatible with 5.XXX.XXX
 124     If any exist, they are bugs, and we request that you submit a
 125     report.  See L</Reporting Bugs> below.
 126
 127 [ List each incompatible change as a =head2 entry ]
 128
 129 =head2 Eliminate OPpRUNTIME private PMOP flag
 130
 131 This flag was added in 5.004 and even then it didn't seem to be used for
 132 anything. It gets set and unset in various places, but is never tested.
 133
 134 =head2 Eliminate SVpbm_VALID flag
 135
 136 This flag is set on an SV to indicate that it has PERL_MAGIC_bm (fast
 137 Boyer-Moore) magic attached. Instead just directly check whether it has such
 138 magic.
 139
 140 =head2 Eliminate SVpbm_TAIL/SvTAIL_on()/SvTAIL_off()
 141
 142 This flag is only set on SVs that have Boyer-Moore magic attached. Such SVs
 143 already re-purpose the unused IVX slot of that  SV to store BmUSEFUL. This
 144 commit repurposes the unused NVX slot to store this boolean value instead.
 145
 146 =head2 Eliminate SVrepl_EVAL and SvEVALED()
 147
 148 This flag is only used to indicate that the SV holding the text of the
 149 replacement part of a s/// has seen at least one /e.  Instead, set the IVX
 150 field in the SV to a true value. (We already set the NVX field on that SV to
 151 indicate a multi-src-line substitution).
 152
 153 =head2 metaconfig.h
 154
 155 Document that symbols should be removed from metaconfig.h
 156
 157 Remove almost-all symbols from metaconfig.h
 158
 159 =head2 Change hv_fetch(…, "…", …, …) to hv_fetchs(…, "…", …)
 160
 161 The dual-life dists all use Devel::PPPort, so they can use this function even
 162 though it was only added in 5.10.
 163
 164 =head1 Deprecations
 165
 166 XXX Any deprecated features, syntax, modules etc. should be listed here.
 167
 168 =head2 Module removals
 169
 170 XXX Remove this section if inapplicable.
 171
 172 The following modules will be removed from the core distribution in a
 173 future release, and will at that time need to be installed from CPAN.
 174 Distributions on CPAN which require these modules will need to list them as
 175 prerequisites.
 176
 177 The core versions of these modules will now issue C<"deprecated">-category
 178 warnings to alert you to this fact.  To silence these deprecation warnings,
 179 install the modules in question from CPAN.
 180
 181 Note that these are (with rare exceptions) fine modules that you are encouraged
 182 to continue to use.  Their disinclusion from core primarily hinges on their
 183 necessity to bootstrapping a fully functional, CPAN-capable Perl installation,
 184 not usually on concerns over their design.
 185
 186 =over
 187
 188 =item XXX
 189
 190 XXX Note that deprecated modules should be listed here even if they are listed
 191 as an updated module in the L</Modules and Pragmata> section.
 192
 193 =back
 194
 195 [ List each other deprecation as a =head2 entry ]
 196
 197 =head1 Performance Enhancements
 198
 199 XXX Changes which enhance performance without changing behaviour go here.
 200 There may well be none in a stable release.
 201
 202 [ List each enhancement as a =item entry ]
 203
 204 =over 4
 205
 206 =item *
 207
 208 Reduce cost of SvVALID().
 209
 210 =item *
 211
 212 C<$ref1 = $ref2> has been optimized.
 213
 214 =item *
 215
 216 Array and hash assignment are now faster, e.g.
 217
 218     (..., @a) = (...);
 219     (..., %h) = (...);
 220
 221 especially when the RHS is empty.
 222
 223 =item *
 224
 225 Reduce the number of odd special cases for the SvSCREAM flag.
 226
 227 =item *
 228
 229 Aavoid sv_catpvn() in do_vop() when unneeded.
 230
 231 =item *
 232
 233 Enhancements in Regex concat COW implementation.
 234
 235 =item *
 236
 237 Speed up AV and HV clearing/undeffing.
 238
 239 =item *
 240
 241 Better optimise array and hash assignment
 242
 243 =back
 244
 245 =head1 Modules and Pragmata
 246
 247 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
 248 go here.  If Module::CoreList is updated, generate an initial draft of the
 249 following sections using F<Porting/corelist-perldelta.pl>.  A paragraph summary
 250 for important changes should then be added by hand.  In an ideal world,
 251 dual-life modules would have a F<Changes> file that could be cribbed.
 252
 253 [ Within each section, list entries as a =item entry ]
 254
 255 =head2 New Modules and Pragmata
 256
 257 =over 4
 258
 259 =item *
 260
 261 XXX
 262
 263 =back
 264
 265 =head2 Updated Modules and Pragmata
 266
 267 =over 4
 268
 269 =item *
 270
 271 L<Time::HiRes> has been updated to use clockid_t.
 272
 273 =item *
 274
 275 L<Data::Dumper> the XS implementation now supports Deparse.
 276
 277 =item *
 278
 279 L<Unicode::Normalize> is now maintained by p5p and has been moved to dist/
 280
 281 =item *
 282
 283 L<Errno> Document that using C<%!> loads Errno for you.
 284
 285 =item *
 286
 287 L<Unicode::Collate> has been upgraded from version 1.14 to 1.18.
 288
 289 =item *
 290
 291 L<Math::BigInt> has been upgraded from version 1.999726(_01) to 1.999727.
 292
 293 There have also been some core customizations.
 294
 295 =item *
 296
 297 L<podlators> has been upgraded from version 4.08 to 4.09.
 298
 299 =item *
 300
 301 L<Archive::Tar> has been upgraded from version 2.16 to 2.18.
 302
 303 Capture STDERR when necessary.
 304
 305 Several minor updates.
 306
 307 =item *
 308
 309 L<Net::Ping> remove sudo from 500_ping_icmp.t.
 310
 311 Upgrade from version 2.51 to 2.55.
 312
 313 Avoid stderr noise in tests
 314
 315 Check for echo in new Net::Ping tests.
 316
 317 =item *
 318
 319 L<Test::Simple> has been upgraded from version 1.302059 to 1.302062.
 320
 321 =item *
 322
 323 L<Term::ANSIColor> has been upgraded from version 4.05 to 4.06.
 324
 325 =item *
 326
 327 L<Scalar::Utils> and L<List::Utils> have been customized in core.
 328
 329 =item *
 330
 331 L<Math::Complex> has been customized in core.
 332
 333 =item *
 334
 335 L<JSON::PP> Customized in core.
 336
 337 =item *
 338
 339 L<POSIX> Version Bump
 340
 341 =item *
 342
 343 L<Unicode::UCD> has had its documentation updated to give a recipe for
 344 using it to get the information contained in F<unicore/Name.pl>.  It has
 345 long been deprecated to use any file from F<unicore/>, and their
 346 contents or even existence may change at any time without notice.
 347
 348 =item *
 349
 350 L<XXX> has been upgraded from version A.xx to B.yy.
 351
 352 =back
 353
 354 =head2 Removed Modules and Pragmata
 355
 356 =over 4
 357
 358 =item *
 359
 360 XXX
 361
 362 =back
 363
 364 =head1 Documentation
 365
 366 XXX Changes to files in F<pod/> go here.  Consider grouping entries by
 367 file and be sure to link to the appropriate page, e.g. L<perlfunc>.
 368
 369 =head2 New Documentation
 370
 371 XXX Changes which create B<new> files in F<pod/> go here.
 372
 373 =head3 L<XXX>
 374
 375 XXX Description of the purpose of the new file here
 376
 377 =head2 Changes to Existing Documentation
 378
 379 XXX Changes which significantly change existing files in F<pod/> go here.
 380 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
 381 section.
 382
 383 =head3 L<perlfunc>
 384
 385 =over 4
 386
 387 =item *
 388
 389 Defined on aggregates is no longer allowed. Perlfunc was still reporting it as
 390 deprecated, and that it will be deleted in the future.
 391
 392 =back
 393
 394 =head3 L<perldata>
 395
 396 =over 4
 397
 398 =item *
 399
 400 Use of single character variables, with the variable name a non printable
 401 character in the range \x80-\xFF is no longer allowed. Update the docs to
 402 reflect this.
 403
 404 =back
 405
 406 =head3 L<perlobj>
 407
 408 =over 4
 409
 410 =item *
 411
 412 Added a section on calling methods using their fully qualified names.
 413
 414 =item *
 415
 416 Do not discourage manual @ISA.
 417
 418 =back
 419
 420 =head3 L<perlop>
 421
 422 =over 4
 423
 424 =item *
 425
 426 Clarify behavior single quote regexps.
 427
 428 =back
 429
 430 =head3 L<perllocale>
 431
 432 =over 4
 433
 434 =item *
 435
 436 Some locales aren't compatible with Perl.  Note the potential bad
 437 consequences of using them.
 438
 439 =back
 440
 441 =head3 L<perldiag>
 442
 443 =over 4
 444
 445 =item *
 446
 447 Deprecations are to be marked with a D.
 448 C<"%s() is deprecated on :utf8 handles"> use a deprecation message, and as
 449 such, such be marked C<"(D deprecated)"> and not C<"(W deprecated)">.
 450
 451 =back
 452
 453 =head3 L<perlguts>
 454
 455 =over 4
 456
 457 =item *
 458
 459 add pTHX_ to magic method examples.
 460
 461 =back
 462
 463 =head3 L<perlvar>
 464
 465 =over 4
 466
 467 =item *
 468
 469 Document @ISA. Was documented other places, not not in perlvar.
 470
 471 =back
 472
 473 =head3 L<perlootut>
 474
 475 =over 4
 476
 477 =item *
 478
 479 Tidy the document.
 480
 481 =item *
 482
 483 Mention Moo more.
 484
 485 =back
 486
 487 =head3 L<perlhack>
 488
 489 =over 4
 490
 491 =item *
 492
 493 Document Tab VS Space.
 494
 495 =back
 496
 497 =head3 L<perlre>
 498
 499 =over 4
 500
 501 =item *
 502
 503 Don't impugn the stability of all (?…) constructs.
 504
 505 =item *
 506
 507 Summarise full syntax for (?(cond)then|else) constructs.
 508
 509 =item *
 510
 511 Minor tweaks and formatting changes.
 512
 513 =item *
 514
 515 perlre: regularise list items
 516
 517 =item *
 518
 519 Document the package for C<$REGMARK> and C<$REGERROR>.
 520
 521 =back
 522
 523 =head1 Diagnostics
 524
 525 The following additions or changes have been made to diagnostic output,
 526 including warnings and fatal error messages.  For the complete list of
 527 diagnostic messages, see L<perldiag>.
 528
 529 XXX New or changed warnings emitted by the core's C<C> code go here.  Also
 530 include any changes in L<perldiag> that reconcile it to the C<C> code.
 531
 532 =head2 New Diagnostics
 533
 534 XXX Newly added diagnostic messages go under here, separated into New Errors
 535 and New Warnings
 536
 537 =head3 New Errors
 538
 539 =over 4
 540
 541 =item *
 542
 543 XXX L<message|perldiag/"message">
 544
 545 =back
 546
 547 =head3 New Warnings
 548
 549 =over 4
 550
 551 =item *
 552
 553 XXX L<message|perldiag/"message">
 554
 555 =back
 556
 557 =head2 Changes to Existing Diagnostics
 558
 559 XXX Changes (i.e. rewording) of diagnostic messages go here
 560
 561 =over 4
 562
 563 =item *
 564
 565 Improve error for missing tie() package/method. This brings the error messages
 566 in line with the ones used for normal method calls, despite not using
 567 call_method().
 568
 569 =item *
 570
 571 Make the sysread()/syswrite/() etc :utf8 handle warnings default. These
 572 warnings were under 'deprecated' previously.
 573
 574 =item *
 575
 576 'do' errors now refer to 'do' (not 'require').
 577
 578 =back
 579
 580 =head1 Utility Changes
 581
 582 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go here.
 583 Most of these are built within the directory F<utils>.
 584
 585 [ List utility changes as a =head2 entry for each utility and =item
 586 entries for each change
 587 Use L<XXX> with program names to get proper documentation linking. ]
 588
 589 =head2 L<XXX>
 590
 591 =over 4
 592
 593 =item *
 594
 595 Porting/pod_lib.pl
 596
 597 Removed spurious executable bit.
 598
 599 Account for possibility of DOS file endings.
 600
 601 =item *
 602
 603 perf/benchmarks
 604
 605 Tidy file, rename some symbols.
 606
 607 =item *
 608
 609 Porting/checkAUTHORS.pl
 610
 611 Replace obscure character range with \w.
 612
 613 =item *
 614
 615 t/porting/regen.t
 616
 617 try to be more helpful when tests fail.
 618
 619 =item *
 620
 621 utils/h2xs.PL
 622
 623 Avoid infinite loop for enums.
 624
 625 =back
 626
 627 =head1 Configuration and Compilation
 628
 629 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
 630 go here.  Any other changes to the Perl build process should be listed here.
 631 However, any platform-specific changes should be listed in the
 632 L</Platform Support> section, instead.
 633
 634 [ List changes as a =item entry ].
 635
 636 =over 4
 637
 638 =item *
 639
 640 Remove "Warning: perl appears in your path"
 641
 642 This install warning is more or less obsolete, since most platforms already
 643 *will* have a /usr/bin/perl or similar provided by the OS.
 644
 645 =item *
 646
 647 Reduce verbosity of "make install.man"
 648
 649 Previously, two progress messages were emitted for each manpage: one by
 650 installman itself, and one by the function in install_lib.pl that it calls to
 651 actually install the file. Disabling the second of those in each case saves
 652 over 750 lines of unhelpful output.
 653
 654 =item *
 655
 656 Cleanup for clang -Weverything support. [perl 129961]
 657
 658 =item *
 659
 660 Configure: signbit scan was assuming too much, stop assuming negative 0.
 661
 662 =item *
 663
 664 Various compiler warnings have been silenced.
 665
 666 =back
 667
 668 =head1 Testing
 669
 670 XXX Any significant changes to the testing of a freshly built perl should be
 671 listed here.  Changes which create B<new> files in F<t/> go here as do any
 672 large changes to the testing harness (e.g. when parallel testing was added).
 673 Changes to existing files in F<t/> aren't worth summarizing, although the bugs
 674 that they represent may be covered elsewhere.
 675
 676 [ List each test improvement as a =item entry ]
 677
 678 =over 4
 679
 680 =item *
 681
 682 XS-APItest/t/utf8.t: Several small fixes and enhancements.
 683
 684 =item *
 685
 686 Tests for locales were erroneously using locales incompatible with Perl.
 687
 688 =back
 689
 690 =head1 Platform Support
 691
 692 XXX Any changes to platform support should be listed in the sections below.
 693
 694 [ Within the sections, list each platform as a =item entry with specific
 695 changes as paragraphs below it. ]
 696
 697 =head2 New Platforms
 698
 699 XXX List any platforms that this version of perl compiles on, that previous
 700 versions did not.  These will either be enabled by new files in the F<hints/>
 701 directories, or new subdirectories and F<README> files at the top level of the
 702 source tree.
 703
 704 =over 4
 705
 706 =item XXX-some-platform
 707
 708 XXX
 709
 710 =back
 711
 712 =item Darwin
 713
 714 don't treat -Dprefix=/usr as special, instead require an extra option
 715 -Ddarwin_distribution to produce the same results.
 716
 717 =item POSIX
 718
 719 Finish removing POSIX deprecated functions.
 720
 721 =item OS X
 722
 723 OS X El Capitan doesn't implement the clock_gettime() or clock_getrez() APIs,
 724 emulate them as necessary.
 725
 726 =item macOS
 727
 728 Deprecated syscall(2) on macOS 10.12.
 729
 730 =item EBCDIC
 731
 732 Several tests have been updated to work (or be skipped) on EBCDIC platforms.
 733
 734 =item HP-UX
 735
 736 L<Net::Ping> UDP test is skipped on HP-UX.
 737
 738 =item VMS
 739
 740 Move _pDEPTH and _aDEPTH after config.h otherwise DEBUGGING may not be defined
 741 yet.
 742
 743 =item VMS And Win32
 744
 745 Fix some breakage, add 'undef' value for default_inc_excludes_dot in build
 746 scripts.
 747
 748 =item Linux
 749
 750 Drop support for Linux a.out Linux has used ELF for over twenty years.
 751
 752 =item NetBSD-VAX
 753
 754 Test fixes and minor updates.
 755
 756 Account for lack of C<inf>, C<nan>, and C<-0.0> support.
 757
 758 =item Win32
 759
 760 fp definitions have been updated.
 761
 762 =item OpenBSD 6
 763
 764 OpenBSD 6 still does not support returning pid, gid or uid with SA_SIGINFO.
 765 Make sure this is accounted for.
 766
 767 =item FreeBSD
 768
 769 t/uni/overload.t: Skip hanging test on FreeBSD.
 770
 771 =back
 772
 773 =head2 Discontinued Platforms
 774
 775 XXX List any platforms that this version of perl no longer compiles on.
 776
 777 =over 4
 778
 779 =item VMS
 780
 781 VAXC has not been a possibility for a good long while, and the versions of the
 782 DEC/Compaq/HP/VSI C compiler that report themselves as "DEC" in a listing file
 783 are 15 years or more out-of-date and can be safely desupported.
 784
 785 =item XXX-some-platform
 786
 787 XXX
 788
 789 =back
 790
 791 =head2 Platform-Specific Notes
 792
 793 XXX List any changes for specific platforms.  This could include configuration
 794 and compilation changes or changes in portability/compatibility.  However,
 795 changes within modules for platforms should generally be listed in the
 796 L</Modules and Pragmata> section.
 797
 798 =over 4
 799
 800 =item XXX-some-platform
 801
 802 XXX
 803
 804 =back
 805
 806 =head1 Internal Changes
 807
 808 XXX Changes which affect the interface available to C<XS> code go here.  Other
 809 significant internal changes for future core maintainers should be noted as
 810 well.
 811
 812 [ List each change as a =item entry ]
 813
 814 =over 4
 815
 816 =item *
 817
 818 XXX
 819
 820 =back
 821
 822 =head1 Selected Bug Fixes
 823
 824 XXX Important bug fixes in the core language are summarized here.  Bug fixes in
 825 files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
 826
 827 [ List each fix as a =item entry ]
 828
 829 =over 4
 830
 831 =item *
 832
 833 Handle SvIMMORTALs in LHS of list assign. [perl #129991]
 834
 835 =item *
 836
 837 [perl #130010] a5540cf breaks texinfo
 838
 839 This involved user-defined Unicode properties.
 840
 841 =item *
 842
 843 Fix error message for unclosed C<\N{> in regcomp.
 844
 845 An unclosed C<\N{> could give the wrong error message
 846 C<"\N{NAME} must be resolved by the lexer">.
 847
 848 =item *
 849
 850 List assignment in list context where the LHS contained aggregates and
 851 where there were not enough RHS elements, used to skip scalar lvalues.
 852 Previously, C<(($a,$b,@c,$d) = (1))> in list context returned C<($a)>; now
 853 it returns C<($a,$b,$d)>. C<(($a,$b,$c) = (1))> is unchanged: it still
 854 returns <($a,$b,$c)>. This can be seen in the following:
 855
 856     sub inc { $_++ for @_ }
 857     inc(($a,$b,@c,$d) = (10))
 858
 859 Formerly, the values of C<($a,$b,$d)> would be left as C<(11,undef,undef)>;
 860 now they are C<(11,1,1)>.
 861
 862 =item *
 863
 864 [perl 129903]
 865
 866 The basic problem is that code like this: /(?{ s!!! })/ can trigger infinite
 867 recursion on the C stack (not the normal perl stack) when the last successful
 868 pattern in scope is itself. Since the C stack overflows this manifests as an
 869 untrappable error/segfault, which then kills perl.
 870
 871 We avoid the segfault by simply forbidding the use of the empty pattern when it
 872 would resolve to the currently executing pattern.
 873
 874 =item *
 875
 876 [perl 128997] Avoid reading beyond the end of the line buffer when there's a
 877 short UTF-8 character at the end.
 878
 879 =item *
 880
 881 [perl 129950] fix firstchar bitmap under utf8 with prefix optimisation.
 882
 883 =item *
 884
 885 [perl 129954] Carp/t/arg_string.t: be liberal in f/p formats.
 886
 887 =item *
 888
 889 [perl 129928] make do "a\0b" fail silently instead of throwing.
 890
 891 =item *
 892
 893 [perl 129130] make chdir allocate the stack it needs.
 894
 895 =back
 896
 897 =head1 Known Problems
 898
 899 XXX Descriptions of platform agnostic bugs we know we can't fix go here.  Any
 900 tests that had to be C<TODO>ed for the release would be noted here.  Unfixed
 901 platform specific bugs also go here.
 902
 903 [ List each fix as a =item entry ]
 904
 905 =over 4
 906
 907 =item *
 908
 909 XXX
 910
 911 =back
 912
 913 =head1 Errata From Previous Releases
 914
 915 =over 4
 916
 917 =item *
 918
 919 XXX Add anything here that we forgot to add, or were mistaken about, in
 920 the perldelta of a previous release.
 921
 922 =back
 923
 924 =head1 Obituary
 925
 926 XXX If any significant core contributor has died, we've added a short obituary
 927 here.
 928
 929 =head1 Acknowledgements
 930
 931 XXX Generate this with:
 932
 933   perl Porting/acknowledgements.pl v5.25.5..HEAD
 934
 935 =head1 Reporting Bugs
 936
 937 If you find what you think is a bug, you might check the perl bug database
 938 at L<https://rt.perl.org/> .  There may also be information at
 939 L<http://www.perl.org/> , the Perl Home Page.
 940
 941 If you believe you have an unreported bug, please run the L<perlbug> program
 942 included with your release.  Be sure to trim your bug down to a tiny but
 943 sufficient test case.  Your bug report, along with the output of C<perl -V>,
 944 will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
 945
 946 If the bug you are reporting has security implications which make it
 947 inappropriate to send to a publicly archived mailing list, then see
 948 L<perlsec/SECURITY VULNERABILITY CONTACT INFORMATION>
 949 for details of how to report the issue.
 950
 951 =head1 SEE ALSO
 952
 953 The F<Changes> file for an explanation of how to view exhaustive details on
 954 what changed.
 955
 956 The F<INSTALL> file for how to build Perl.
 957
 958 The F<README> file for general stuff.
 959
 960 The F<Artistic> and F<Copying> files for copyright information.
 961
 962 =cut