This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
b0fee0584a3e3d5ea313d61c75c5ccf8f17eb07c
[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
6 XXX needs to be processed before release. ]
7
8 perldelta - what is new for perl v5.13.9
9
10 =head1 DESCRIPTION
11
12 This document describes differences between the 5.13.8 release and
13 the 5.13.9 release.
14
15 If you are upgrading from an earlier release such as 5.13.7, first read
16 L<perl5138delta>, which describes differences between 5.13.7 and
17 5.13.8.
18
19 =head1 Notice
20
21 XXX Any important notices here
22
23 =head1 Core Enhancements
24
25 XXX New core language features go here. Summarise user-visible core language
26 enhancements. Particularly prominent performance optimisations could go
27 here, but most should go in the L</Performance Enhancements> section.
28
29 [ List each enhancement as a =head2 entry ]
30
31 =head2 New regular expression modifier C</a>
32
33 The C</a> regular expression modifier restricts C<\s> to match precisely
34 the five characters C<[ \f\n\r\t]>, C<\d> to match precisely the 10
35 characters C<[0-9]>, C<\w> to match precisely the 63 characters
36 C<[A-Za-z0-9_]>, and the Posix (C<[[:posix:]]>) character classes to
37 match only the appropriate ASCII characters.  The complements, of
38 course, match everything but; and C<\b> and C<\B> are correspondingly
39 affected.  Otherwise, C</a> behaves like the C</u> modifier, in that
40 case-insensitive matching uses Unicode semantics; for example, "k" will
41 match the Unicode C<\N{KELVIN SIGN}> under C</i> matching, and code
42 points in the Latin1 range, above ASCII will have Unicode semantics when
43 it comes to case-insensitive matching.  Like its cousins (C</u>, C</l>,
44 and C</d>), and in spite of the terminology, C</a> in 5.14 will not
45 actually be able to be used as a suffix at the end of a regular
46 expression (this restriction is planned to be lifted in 5.16).  It must
47 occur either as an infix modifier, such as C<(?a:...)> or (C<(?a)...>,
48 or it can be turned on within the lexical scope of C<use re '/a'>.
49 Turning on C</a> turns off the other "character set" modifiers.
50
51 =head2 Any unsigned value can be encoded as a character
52
53 With this release, Perl is adopting a model that any unsigned value can
54 be treated as a code point and encoded internally (as utf8) without
55 warnings -- not just the code points that are legal in Unicode.
56 However, unless utf8 warnings have been
57 explicitly lexically turned off, outputting or performing a
58 Unicode-defined operation (such as upper-casing) on such a code point
59 will generate a warning.  Attempting to input these using strict rules
60 (such as with the C<:encoding('UTF-8')> layer) will continue to fail.
61 Prior to this release the handling was very inconsistent, and incorrect
62 in places.  Also, the Unicode non-characters, some of which previously were
63 erroneously considered illegal in places by Perl, contrary to the Unicode
64 standard, are now always legal internally.  But inputting or outputting
65 them will work the same as for the non-legal Unicode code points, as the
66 Unicode standard says they are illegal for "open interchange".
67
68 =head2 Regular expression debugging output improvement
69
70 Regular expression debugging output (turned on by C<use re 'debug';>) now
71 uses hexadecimal when escaping non-ASCII characters, instead of octal.
72
73 =head1 Security
74
75 XXX Any security-related notices go here.  In particular, any security
76 vulnerabilities closed should be noted here rather than in the
77 L</Selected Bug Fixes> section.
78
79 [ List each security issue as a =head2 entry ]
80
81 =head2 Restrict \p{IsUserDefined} to In\w+ and In\w+
82
83     In L<perlunicode/"User-Defined Character Properties">, it says you can
84     create custom properties by defining subroutines whose names begin with
85     "In" or "Is". However, perl doesn't actually enforce that naming
86     restriction, so \p{foo::bar} will call foo::Bar() if it exists.
87
88     This commit finally enforces this convention. Note that this broke a
89     number of existing tests for properties, since they didn't always use an
90     Is/In prefix.
91
92
93
94
95 =head1 Incompatible Changes
96
97 XXX For a release on a stable branch, this section aspires to be:
98
99     There are no changes intentionally incompatible with 5.XXX.XXX. If any
100     exist, they are bugs and reports are welcome.
101
102 [ List each incompatible change as a =head2 entry ]
103
104 =head2 All objects are destroyed
105
106 It used to be possible to prevent a destructor from being called during
107 global destruction by artificially increasing the reference count of an
108 object.
109
110 Now such objects I<will> will be destroyed, as a result of a bug fix
111 L<[perl #81230]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=81230>.
112
113 This has the potential to break some XS modules. (In fact, it break some.
114 See L</Known Problems>, below.)
115
116 =head1 Deprecations
117
118 XXX Any deprecated features, syntax, modules etc. should be listed here.
119 In particular, deprecated modules should be listed here even if they are
120 listed as an updated module in the L</Modules and Pragmata> section.
121
122 [ List each deprecation as a =head2 entry ]
123
124 =head1 Performance Enhancements
125
126 XXX Changes which enhance performance without changing behaviour go here. There
127 may well be none in a stable release.
128
129 [ List each enhancement as a =item entry ]
130
131 =over 4
132
133 =item *
134
135 XXX
136
137 =back
138
139 =head1 Modules and Pragmata
140
141 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
142 go here.  If Module::CoreList is updated, generate an initial draft of the
143 following sections using F<Porting/corelist-perldelta.pl>, which prints stub
144 entries to STDOUT.  Results can be pasted in place of the '=head2' entries
145 below.  A paragraph summary for important changes should then be added by hand.
146 In an ideal world, dual-life modules would have a F<Changes> file that could be
147 cribbed.
148
149 [ Within each section, list entries as a =item entry ]
150
151 =head2 New Modules and Pragmata
152
153 =over 4
154
155 =item *
156
157 L<CPAN::Meta::YAML> 0.003 has been added as a dual-life module.  It supports a
158 subset of YAML sufficient for reading and writing META.yml and MYMETA.yml files
159 included with CPAN distributions or generated by the module installation
160 toolchain. It should not be used for any other general YAML parsing or
161 generation task.
162
163 =item *
164
165 L<HTTP::Tiny> 0.009 has been added as a dual-life module.  It is a very
166 small, simple HTTP/1.1 client designed for simple GET requests and file
167 mirroring.  It has has been added to enable CPAN.pm and CPANPLUS to
168 "bootstrap" HTTP access to CPAN using pure Perl without relying on external
169 binaries like F<curl> or F<wget>.
170
171 =item *
172
173 L<JSON::PP> 2.27103 has been added as a dual-life module, for the sake of
174 reading F<META.json> files in CPAN distributions.
175
176 =item *
177
178 L<Module::Metadata> 1.000003 has been added as a dual-life module.  It gathers
179 package and POD information from Perl module files.  It is a standalone module
180 based on Module::Build::ModuleInfo for use by other module installation
181 toolchain components.  Module::Build::ModuleInfo has been deprecated in
182 favor of this module instead.
183
184 =item *
185
186 L<Perl::OSType> 1.002 has been added as a dual-life module.  It maps Perl
187 operating system names (e.g. 'dragonfly' or 'MSWin32') to more generic types
188 with standardized names (e.g.  "Unix" or "Windows").  It has been refactored
189 out of Module::Build and ExtUtils::CBuilder and consolidates such mappings into
190 a single location for easier maintenance.
191
192 =back
193
194 =head2 Updated Modules and Pragmata
195
196 =over 4
197
198 =item *
199
200 C<Archive::Extract> has been upgraded from version 0.46 to 0.48
201
202 =item *
203
204 C<Archive::Tar> has been upgraded from version 1.74 to 1.76
205
206 =item *
207
208 C<CGI> has been upgraded from version 3.50 to 3.51
209
210 Further improvements have been made to guard against newline injections
211 in headers.
212
213 =item *
214
215 C<Compress::Raw::Bzip2> has been upgraded from version 2.031 to 2.033
216
217 =item *
218
219 C<Compress::Raw::Zlib> has been upgraded from version 2.030 to 2.033
220
221 =item *
222
223 C<CPAN> has been upgraded from version 1.94_62 to 1.94_63
224
225 =item *
226
227 C<CPANPLUS> has been upgraded from version 0.9010 to 0.9011
228
229 =item *
230
231 C<CPANPLUS::Dist::Build> has been upgraded from version 0.50 to 0.52
232
233 =item *
234
235 C<DB_File> has been upgraded from version 1.820 to 1.821
236
237 =item *
238
239 C<Encode> has been upgraded from version 2.40 to 2.42.
240 Now, all 66 Unicode non-characters are treated the same way U+FFFF has
241 always been treated; if it was disallowed, all 66 are disallowed; if it
242 warned, all 66 warn.
243
244 =item *
245
246 C<File::Fetch> has been upgraded from version 0.28 to 0.32
247
248 =item *
249
250 C<IO::Compress> has been upgraded from version 2.030 to 2.033
251
252 =item *
253
254 C<IPC::Cmd> has been upgraded from version 0.66 to 0.68
255
256 =item *
257
258 C<Log::Message> has been upgraded from version 0.02 to 0.04
259
260 =item *
261
262 C<Log::Message::Simple> has been upgraded from version 0.06 to 0.08
263
264 =item *
265
266 C<Module::Load::Conditional> has been upgraded from version 0.38 to 0.40
267
268 =item *
269
270 C<Object::Accessor> has been upgraded from version 0.36 to 0.38
271
272 =item *
273
274 C<Params::Check> has been upgraded from version 0.26 to 0.28
275
276 =item *
277
278 C<Pod::LaTeX> has been upgraded from version 0.58 to 0.59
279
280 =item *
281
282 C<Socket> has been updated with new affordances for IPv6,
283 including implementations of the C<Socket::getaddrinfo()> and
284 C<Socket::getnameinfo()> functions, along with related constants.
285
286 =item *
287
288 C<Term::UI> has been upgraded from version 0.20 to 0.24
289
290 =item *
291
292 C<Thread::Queue> has been upgraded from version 2.11 to 2.12.
293
294 =item *
295
296 C<Thread::Semaphore> has been upgraded from version 2.11 to 2.12.
297
298 =item *
299
300 C<threads> has been upgraded from version 1.81_03 to 1.82
301
302 =item *
303
304 C<threads::shared> has been upgraded from version 1.35 to 1.36
305
306 =item *
307
308 C<Time::Local> has been upgraded from version 1.1901_01 to 1.2000.
309
310 =item *
311
312 C<Unicode::Normalize> has been upgraded from version 1.07 to 1.10
313
314 =item *
315
316 C<version> has been upgraded from 0.86 to 0.88.
317
318 =item *
319
320 C<Win32> has been upgraded from version 0.41 to 0.44.
321
322 =back
323
324 =head2 Removed Modules and Pragmata
325
326 =over 4
327
328 =item *
329
330 XXX
331
332 =back
333
334 =head1 Documentation
335
336 XXX Changes to files in F<pod/> go here.  Consider grouping entries by
337 file and be sure to link to the appropriate page, e.g. L<perlfunc>.
338
339 =head2 New Documentation
340
341 XXX Changes which create B<new> files in F<pod/> go here.
342
343 =head3 L<XXX>
344
345 XXX Description of the purpose of the new file here
346
347 =head2 Changes to Existing Documentation
348
349 XXX Changes which significantly change existing files in F<pod/> go here.
350 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
351 section.
352
353 =head3 Cleanup
354
355 =over
356
357 =item *
358
359 Numerous POD warnings were fixed.
360
361 =item *
362
363 Many, many spelling errors and typographical mistakes were corrected throughout Perl's core.
364
365 =back
366
367 =head3 L<Porting/epigraphs.pod> and L<pod/perlhist.pod>
368
369     This patch makes multiple changes to Porting/epigraphs.pod and pod/perlhist.pod.
370
371 =head3 L<perlrepository>
372
373 =head3 L<perlhack>
374
375 =over 4
376
377 =item *
378
379 L<perlhack> was extensively reorganized.
380
381 =back
382
383 =head3 L<perlfunc>
384
385 =over 4
386
387 =item *
388
389 It has now been documented that C<ord> returns 0 for an empty string.
390
391 =back
392
393 =head1 Diagnostics
394
395 The following additions or changes have been made to diagnostic output,
396 including warnings and fatal error messages.  For the complete list of
397 diagnostic messages, see L<perldiag>.
398
399 XXX New or changed warnings emitted by the core's C<C> code go here. Also
400 include any changes in L<perldiag> that reconcile it to the C<C> code.
401
402 [ Within each section, list entries as a =item entry ]
403
404 =head2 New Diagnostics
405
406 XXX Newly added diagnostic messages go here
407
408 =over 4
409
410 =item *
411
412 Performing an operation requiring Unicode semantics (such as case-folding)
413 on a Unicode surrogate or a non-Unicode character now triggers a warning:
414 'Operation "%s" returns its argument for ...'.
415
416 =back
417
418 =head2 Changes to Existing Diagnostics
419
420 XXX Changes (i.e. rewording) of diagnostic messages go here
421
422 =over 4
423
424 =item *
425
426 Previously, if none of the C<gethostbyaddr>, C<gethostbyname> and
427 C<gethostent> functions were implemented on a given platform, they would
428 all die with the message 'Unsupported socket function "gethostent" called',
429 with analogous messages for C<getnet*> and C<getserv*>. This has been
430 corrected.
431
432 =back
433
434 =head1 Utility Changes
435
436 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
437 here. Most of these are built within the directories F<utils> and F<x2p>.
438
439 [ List utility changes as a =head3 entry for each utility and =item
440 entries for each change
441 Use L<XXX> with program names to get proper documentation linking. ]
442
443 =head3 L<perlbug>
444
445 =over 4
446
447 =item *
448
449 C<perlbug> did not previously generate a From: header, potentially
450 resulting in dropped mail. Now it does include that header.
451
452 =back
453
454 =head3 L<buildtoc>
455
456 =over 4
457
458 =item *
459
460 F<pod/buildtoc> has been modernized and can now be used to test the
461 well-formedness of F<pod/perltoc.pod> automatically.
462
463 =back
464
465 =head1 Configuration and Compilation
466
467 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
468 go here.  Any other changes to the Perl build process should be listed here.
469 However, any platform-specific changes should be listed in the
470 L</Platform Support> section, instead.
471
472 [ List changes as a =item entry ].
473
474 =over 4
475
476 =item *
477
478 XXX
479
480 =back
481
482 =head1 Testing
483
484 XXX Any significant changes to the testing of a freshly built perl should be
485 listed here.  Changes which create B<new> files in F<t/> go here as do any
486 large changes to the testing harness (e.g. when parallel testing was added).
487 Changes to existing files in F<t/> aren't worth summarising, although the bugs
488 that they represent may be covered elsewhere.
489
490 [ List each test improvement as a =item entry ]
491
492 =over 4
493
494 =item *
495
496 L<lib/File/DosGlob.t> has been modernized and now uses L<Test::More>.
497
498 =item *
499
500 A new test script, C<t/porting/filenames.t>, makes sure that filenames and
501 paths are reasonably portable.
502
503 =item *
504
505 C<t/porting/diag.t> is now several orders of magnitude faster.
506
507 =item *
508
509 C<t/porting/buildtoc.t> now tests that the documentation TOC file is current and well-formed.
510
511 =item *
512
513 C<t/base/while.t> now tests the basics of a while loop with minimal dependencies.
514
515 =item *
516
517 C<t/cmd/while.t> now uses F<test.pl> for better maintainability.
518
519 =item *
520
521 C<t/op/split.t> now tests calls to C<split> without any pattern specified.
522
523 =back
524
525
526
527 =head1 Platform Support
528
529 XXX Any changes to platform support should be listed in the sections below.
530
531 [ Within the sections, list each platform as a =item entry with specific
532 changes as paragraphs below it. ]
533
534 =head2 New Platforms
535
536 XXX List any platforms that this version of perl compiles on, that previous
537 versions did not. These will either be enabled by new files in the F<hints/>
538 directories, or new subdirectories and F<README> files at the top level of the
539 source tree.
540
541 =over 4
542
543 =item XXX-some-platform
544
545 XXX
546
547 =back
548
549 =head2 Discontinued Platforms
550
551 XXX List any platforms that this version of perl no longer compiles on.
552
553 =over 4
554
555 =item Apollo DomainOS
556
557 The last vestiges of support for this platform have been excised from the
558 Perl distribution. It was officially discontinued in version 5.12.0. It had
559 not worked for years before that.
560
561 =item MacOS Classic
562
563 The last vestiges of support for this platform have been excised from the
564 Perl distribution. It was officially discontinued in an earlier version.
565
566 =back
567
568 =head2 Platform-Specific Notes
569
570 XXX List any changes for specific platforms. This could include configuration
571 and compilation changes or changes in portability/compatibility.  However,
572 changes within modules for platforms should generally be listed in the
573 L</Modules and Pragmata> section.
574
575 =over 4
576
577
578 =item Cygwin
579
580 =over
581
582 =item Update MakeMaker to build man pages on cygwin.
583
584 =item Improve rebase behaviour
585
586 If a dll is updated on cygwin reuse the old imagebase address.
587 This solves most rebase errors, esp when updating on core dll's.
588 See L<http://www.tishler.net/jason/software/rebase/rebase-2.4.2.README> for more information.
589
590 =item CYG14 Dynaloader without USEIMPORTLIB, and search cyg prefix
591
592 Support the standard cyg dll prefix, which is e.g. needed for FFI's.
593 Ctypes and C::DynaLib use DynaLoader to find dlls.
594
595 With -DUSEIMPORTLIB DynaLoader symbols link against the prefixed
596 symbol names for the .dll.a importlib, but we need to link against the
597 symbols directly. We don't link Dynaloader against libperl.dll.a.
598
599 =item Updated build hints file
600
601 =back
602
603
604 =item Solaris
605
606 DTrace is now supported on Solaris. There used to be build failures, but
607 these have been fixed
608 L<[perl #73630]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=73630>.
609
610 =back
611
612 =head1 Internal Changes
613
614 XXX Changes which affect the interface available to C<XS> code go here.
615 Other significant internal changes for future core maintainers should
616 be noted as well.
617
618 [ List each test improvement as a =item entry ]
619
620 =over 4
621
622 =item *
623
624 The opcode bodies for C<chop> and C<chomp> and for C<schop> and C<schomp> have
625 been merged. The implementation functions C<Perl_do_chop()> and
626 C<Perl_do_chomp()>, never part of the public API, have been merged and moved to
627 a static function in F<pp.c>. This shrinks the perl binary slightly, and should
628 not affect any code outside the core (unless it is relying on the order of side
629 effects when C<chomp> is passed a I<list> of values).
630
631 =item *
632
633 Some of the flags parameters to the uvuni_to_utf8_flags() and
634 utf8n_to_uvuni() have changed.  This is a result of Perl now allowing
635 internal storage and manipulation of code points that are problematic
636 in some situations.  Hence, the default actions for these functions has
637 been complemented to allow these code points.  The new flags are
638 documented in L<perlapi>.  Code that requires the problematic code
639 points to be rejected needs to change to use these flags.  Some flag
640 names are retained for backward source compatibility, though they do
641 nothing, as they are now the default.  However the flags
642 C<UNICODE_ALLOW_FDD0>, C<UNICODE_ALLOW_FFFF>, C<UNICODE_ILLEGAL>, and
643 C<UNICODE_IS_ILLEGAL> have been removed, as they stem from a
644 fundamentally broken model of how the Unicode non-character code points
645 should be handled, which is now described in
646 L<perlunicode/Non-character code points>.  See also L</Selected Bug Fixes>.
647
648 =item *
649
650 Certain shared flags in the C<pmop.op_pmflags> and C<regexp.extflags>
651 structures have been removed.  These are: C<Rxf_Pmf_LOCALE>,
652 C<Rxf_Pmf_UNICODE>, and C<PMf_LOCALE>.  Instead there are encodes and
653 three static in-line functions for accessing the information:
654 C<get_regex_charset()>, C<set_regex_charset()>, and C<get_regex_charset_name()>,
655 which are defined in the places where the orginal flags were.
656
657 =item *
658
659 A new option has been added to C<pv_escape> to dump all characters above
660 ASCII in hexadecimal. Before, one could get all characters as hexadecimal
661 or the Latin1 non-ASCII as octal
662
663
664 =item Generate pp_* prototypes in pp_proto.h, and remove pp.sym
665
666 Eliminate the #define pp_foo Perl_pp_foo(pTHX) macros, and update the 13
667 locations that relied on them.
668
669 regen/opcode.pl now generates prototypes for the PP functions directly, into
670 pp_proto.h. It no longer writes pp.sym, and regen/embed.pl no longer reads
671 this, removing the only ordering dependency in the regen scripts. opcode.pl
672 is now responsible for prototypes for pp_* functions. (embed.pl remains
673 responsible for ck_* functions, reading from regen/opcodes)
674
675 =back
676
677 =head1 Selected Bug Fixes
678
679 XXX Important bug fixes in the core language are summarised here.
680 Bug fixes in files in F<ext/> and F<lib/> are best summarised in
681 L</Modules and Pragmata>.
682
683 [ List each fix as a =item entry ]
684
685 =over 4
686
687 =item *
688
689 The handling of Unicode non-characters has changed.
690 Previously they were mostly considered illegal, except that only one of
691 the 66 of them was known about in places.  The Unicode standard
692 considers them legal, but forbids the "open interchange" of them.
693 This is part of the change to allow the internal use of any code point
694 (see L</Core Enhancements>).  Together, these changes resolve
695 L<# 38722|https://rt.perl.org/rt3/Ticket/Display.html?id=38722>,
696 L<# 51918|http://rt.perl.org/rt3/Ticket/Display.html?id=51918>,
697 L<# 51936|http://rt.perl.org/rt3/Ticket/Display.html?id=51936>,
698 L<# 63446|http://rt.perl.org/rt3/Ticket/Display.html?id=63446>
699
700 =item *
701
702 Sometimes magic (ties, tainted, etc.) attached to variables could cause an
703 object to last longer than it should, or cause a crash if a tied variable
704 were freed from within a tie method. These have been fixed
705 L<[perl #81230]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=81230>.
706
707 =item *
708
709 Most I/O functions were not warning for unopened handles unless the
710 'closed' and 'unopened' warnings categories were both enabled. Now only
711 C<use warnings 'unopened'> is necessary to trigger these warnings (as was
712 always meant to be the case.
713
714 =item *
715
716 C<< <expr> >> always respects overloading now if the expression is
717 overloaded.
718
719 Due to the way that '<> as glob' was parsed differently from
720 '<> as filehandle' from 5.6 onwards, something like C<< <$foo[0]> >> did
721 not handle overloading, even if C<$foo[0]> was an overloaded object. This
722 was contrary to the documentation for overload, and meant that C<< <> >>
723 could not be used as a general overloaded iterator operator.
724
725 =item *
726
727 Destructors on objects were not called during global destruction on objects
728 that were not referenced by any scalars. This could happen if an array
729 element were blessed (e.g., C<bless \$a[0]>) or if a closure referenced a
730 blessed variable (C<bless \my @a; sub foo { @a }>).
731
732 Now there is an extra pass during global destruction to fire destructors on
733 any objects that might be left after the usual passes that check for
734 objects referenced by scalars
735 L<[perl #36347]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=36347>.
736
737 =item *
738
739 A long standing bug has now been fully fixed (partial fixes came in
740 earlier releases), in which some Latin-1 non-ASCII characters on
741 ASCII-platforms would match both a character class and its complement,
742 such as U+00E2 being both in C<\w> and C<\W>, depending on the
743 UTF-8-ness of the regular expression pattern and target string.
744 Fixing this did expose some bugs in various modules and tests that
745 relied on the previous behavior of C<[[:alpha:]]> not ever matching
746 U+00FF, "LATIN SMALL LETTER Y WITH DIAERESIS", even when it should, in
747 Unicode mode; now it does match when appropriate.
748 L<[perl #60156]|http://rt.perl.org/rt3/Ticket/Display.html?id=60156>.
749
750 =back
751
752 =head1 Known Problems
753
754 XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
755 tests that had to be C<TODO>ed for the release would be noted here, unless
756 they were specific to a particular platform (see below).
757
758 This is a list of some significant unfixed bugs, which are regressions
759 from either 5.XXX.XXX or 5.XXX.XXX.
760
761 [ List each fix as a =item entry ]
762
763 =over 4
764
765 =item *
766
767 The fix for [perl #81230] causes test failures for C<Tk> version 804.029.
768 This is still being investigated.
769
770 =back
771
772 =head1 Obituary
773
774 XXX If any significant core contributor has died, we've added a short obituary
775 here.
776
777 =head1 Acknowledgements
778
779 XXX The list of people to thank goes here.
780
781 =head1 Reporting Bugs
782
783 If you find what you think is a bug, you might check the articles
784 recently posted to the comp.lang.perl.misc newsgroup and the perl
785 bug database at http://rt.perl.org/perlbug/ .  There may also be
786 information at http://www.perl.org/ , the Perl Home Page.
787
788 If you believe you have an unreported bug, please run the L<perlbug>
789 program included with your release.  Be sure to trim your bug down
790 to a tiny but sufficient test case.  Your bug report, along with the
791 output of C<perl -V>, will be sent off to perlbug@perl.org to be
792 analysed by the Perl porting team.
793
794 If the bug you are reporting has security implications, which make it
795 inappropriate to send to a publicly archived mailing list, then please send
796 it to perl5-security-report@perl.org. This points to a closed subscription
797 unarchived mailing list, which includes all the core committers, who be able
798 to help assess the impact of issues, figure out a resolution, and help
799 co-ordinate the release of patches to mitigate or fix the problem across all
800 platforms on which Perl is supported. Please only use this address for
801 security issues in the Perl core, not for modules independently
802 distributed on CPAN.
803
804 =head1 SEE ALSO
805
806 The F<Changes> file for an explanation of how to view exhaustive details
807 on what changed.
808
809 The F<INSTALL> file for how to build Perl.
810
811 The F<README> file for general stuff.
812
813 The F<Artistic> and F<Copying> files for copyright information.
814
815 =cut
816
817 =for later
818
819 Below, you'll find a cut-down version of the git log from 5.13.8 to 1b9043bb.
820
821 =cut