This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
6e91badd41663d09060727d9769f8f946d0a27be
[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.19.4
9
10 =head1 DESCRIPTION
11
12 This document describes differences between the 5.19.3 release and the 5.19.4
13 release.
14
15 If you are upgrading from an earlier release such as 5.19.2, first read
16 L<perl5193delta>, which describes differences between 5.19.2 and 5.19.3.
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 rand() now uses a consistent random number generator
31
32 Previously perl would use a platform specific random number generator,
33 varying between the libc C<rand()>, C<random()> or C<drand48()>.
34
35 This meant that the quality of perl's random numbers would vary from
36 platform to platform, from the 15 bits of C<rand()> on Win32 to
37 48-bits on POSIX platforms such as Linux with C<drand48()>.
38
39 Perl now uses its own internal C<drand48()> implementation on all
40 platforms.  [perl #115928]
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 =head2 Locale decimal point character no longer leaks outside of
53 S<C<use locale>> scope (with the exception of C<$!>)
54
55 This is actually a bug fix, but some code has come to rely on the bug being
56 present, so this change is listed here.  The current locale that the program is
57 running under is not supposed to be visible to Perl code except within the
58 scope of a S<C<use locale>>.  However, until now under certain circumstances,
59 the character used for a decimal point (often a comma) leaked outside the
60 scope.
61
62 This continues the work released in Perl 5.19.1.  It turns out that that did
63 not catch all the leaks, including C<printf> and C<sprintf> not respecting
64 S<C<use locale>>.  If your code is affected by this change, simply add a
65 S<C<use locale>>.
66
67 Now, the only known place where C<'use locale'> is not respected is in the
68 stringification of L<$!|perlvar/$!>.
69
70 =head1 Deprecations
71
72 XXX Any deprecated features, syntax, modules etc. should be listed here.
73
74 =head2 Module removals
75
76 XXX Remove this section if inapplicable.
77
78 The following modules will be removed from the core distribution in a
79 future release, and will at that time need to be installed from CPAN.
80 Distributions on CPAN which require these modules will need to list them as
81 prerequisites.
82
83 The core versions of these modules will now issue C<"deprecated">-category
84 warnings to alert you to this fact.  To silence these deprecation warnings,
85 install the modules in question from CPAN.
86
87 Note that these are (with rare exceptions) fine modules that you are encouraged
88 to continue to use.  Their disinclusion from core primarily hinges on their
89 necessity to bootstrapping a fully functional, CPAN-capable Perl installation,
90 not usually on concerns over their design.
91
92 =over
93
94 XXX Note that deprecated modules should be listed here even if they are listed
95 as an updated module in the L</Modules and Pragmata> section.
96
97 =back
98
99 [ List each other deprecation as a =head2 entry ]
100
101 =head1 Performance Enhancements
102
103 =over 4
104
105 =item *
106
107 The trie performance enhancement for regular expressions has now been extended
108 to those compiled under C</iaa>.
109
110 =back
111
112 =head1 Modules and Pragmata
113
114 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
115 go here.  If Module::CoreList is updated, generate an initial draft of the
116 following sections using F<Porting/corelist-perldelta.pl>, which prints stub
117 entries to STDOUT.  Results can be pasted in place of the '=head2' entries
118 below.  A paragraph summary for important changes should then be added by hand.
119 In an ideal world, dual-life modules would have a F<Changes> file that could be
120 cribbed.
121
122 [ Within each section, list entries as a =item entry ]
123
124 =head2 New Modules and Pragmata
125
126 =over 4
127
128 =item *
129
130 XXX
131
132 =back
133
134 =head2 Updated Modules and Pragmata
135
136 =over 4
137
138 =item *
139
140 L<autodie> has been upgraded from version 2.20 to 2.21.
141
142 Numerous improvements have been made, many speed-related.  See the F<Changes>
143 file in the CPAN distribution for full details.
144
145 =item *
146
147 L<B> has been upgraded from version 1.45 to 1.46.
148
149 The fix for [perl #118525] introduced a regression in the behaviour of
150 C<B::CV::GV>, changing the return value from a C<B::SPECIAL> object on a
151 C<NULL> C<CvGV> to C<undef>.  C<B::CV::GV> again returns a C<B::SPECIAL>
152 object in this case. [perl #119351]
153
154 =item *
155
156 L<B::Concise> has been upgraded from version 0.98 to 0.99.
157
158 The handling of the C<glob> operator, broken since Perl 5.17.6, has been fixed.
159
160 =item *
161
162 L<Carp> has been upgraded from version 1.31 to 1.32.
163
164 =over 4
165
166 =item *
167
168 In stack traces, subroutine arguments that are strings are now quoted in a
169 consistent manner, regardless of what characters they contain and how they're
170 internally represented.
171
172 =item *
173
174 C<Carp> now won't vivify the C<overload::StrVal> glob or subroutine or the
175 C<overload> stash.
176
177 =item *
178
179 C<Carp> now avoids some unwanted Unicode warnings on older Perls.  This doesn't
180 affect behaviour with current Perl.
181
182 =item *
183
184 C<Carp::Heavy> detects version mismatch with C<Carp>, to give a good error
185 message if a current (stub) C<Carp::Heavy> gets loaded by an old C<Carp> that
186 expects C<Carp::Heavy> to provide subroutines.
187
188 =back
189
190 =item *
191
192 L<charnames> has been upgraded from version 1.38 to 1.39.
193
194 This module now works on EBCDIC platforms.
195
196 =item *
197
198 L<CPAN::Meta> has been upgraded from version 2.132140 to 2.132510.
199
200 No changes have been made to the installed code other than the version bump to
201 keep in sync with the latest CPAN release.
202
203 =item *
204
205 L<CPAN::Meta::Requirements> has been upgraded from version 2.122 to 2.123.
206
207 No changes have been made to the installed code other than the version bump to
208 keep in sync with the latest CPAN release.
209
210 =item *
211
212 L<Data::Dumper> has been upgraded from version 2.148 to 2.149.
213
214 This upgrade is part of a larger change to make the array interface 64-bit safe
215 by using SSize_t instead of I32 for array indices.
216
217 In addition, an EBCDIC fix has been applied.
218
219 =item *
220
221 L<Devel::Peek> has been upgraded from version 1.13 to 1.14.
222
223 This upgrade is part of a larger change to preserve referential identity when
224 passing C<undef> to a subroutine by using NULL rather than &PL_sv_undef for
225 nonexistent array elements.
226
227 In addition, C<Dump> with no args was broken in Perl 5.19.3, but has now been
228 fixed.
229
230 =item *
231
232 L<DynaLoader> has been upgraded from version 1.19 to 1.20.
233
234 The documentation now makes it clear, as has always been the case, that
235 C<dl_unload_file> is only called automatically to unload all loaded shared
236 objects if the perl interpreter was built with the C macro
237 DL_UNLOAD_ALL_AT_EXIT defined.  Support for GNU DLD has also been removed.
238
239 =item *
240
241 L<Encode> has been upgraded from version 2.52 to 2.55.
242
243 An erroneous early return in C<decode_utf8> has been removed, and a bug in
244 C<_utf8_on> under COW has been fixed.  Encode also now uses L<parent> rather
245 than L<base> throughout.
246
247 =item *
248
249 L<Exporter> has been upgraded from version 5.69 to 5.70.
250
251 A number of typos have been corrected in the documentation.
252
253 =item *
254
255 L<ExtUtils::CBuilder> has been upgraded from version 0.280205 to 0.280212.
256
257 No changes have been made to the installed code other than the version bump to
258 keep in sync with the latest CPAN release.
259
260 =item *
261
262 L<ExtUtils::Command> has been upgraded from version 1.17 to 1.18.
263
264 No changes have been made to the installed code other than the version bump to
265 keep in sync with the latest CPAN release.
266
267 =item *
268
269 L<ExtUtils::MakeMaker> has been upgraded from version 6.72 to 6.76.
270
271 Numerous updates and bug fixes are incorporated.  See the F<Changes> file for
272 full details.
273
274 =item *
275
276 L<ExtUtils::ParseXS> has been upgraded from version 3.21 to 3.22.
277
278 No changes have been made to the installed code other than the version bump to
279 keep in sync with the latest CPAN release.
280
281 =item *
282
283 L<File::Find> has been upgraded from version 1.24 to 1.25.
284
285 Better diagnostics are now provided in the case of a failed C<chdir>.
286
287 =item *
288
289 L<File::Glob> has been upgraded from version 1.20 to 1.21.
290
291 C<glob()> now warns in the context of C<use warnings "syscalls";> if the
292 supplied pattern has an internal NUL (C<"\0">) character.
293
294 =item *
295
296 L<HTTP::Tiny> has been upgraded from version 0.034 to 0.035.
297
298 Encoded data from C<post_form> now preserves term order if data is provided as
299 an array reference.  (They are still sorted for consistency if provided as a
300 hash reference.)
301
302 =item *
303
304 L<I18N::LangTags> has been upgraded from version 0.39 to 0.40.
305
306 Bosnian has now joined Croatian and Serbian in the lists of mutually
307 intelligible Slavic languages. [perl #72594]
308
309 =item *
310
311 L<IO> has been upgraded from version 1.28 to 1.29.
312
313 A minor internals-only change has been made to the XS code.
314
315 =item *
316
317 L<IPC::Open3> has been upgraded from version 1.15 to 1.16.
318
319 This upgrade is part of a larger change to preserve referential identity when
320 passing C<undef> to a subroutine by using NULL rather than &PL_sv_undef for
321 nonexistent array elements.
322
323 =item *
324
325 L<Locale::Codes> has been upgraded from version 3.26 to 3.27.
326
327 New codes have been added and the (deprecated) set of FIPS-10 country codes has
328 been removed.
329
330 =item *
331
332 L<Math::BigInt> has been upgraded from version 1.9992 to 1.9993.
333
334 Cleaned up the L<Math::BigInt> and L<Math::BigFloat> documentation to be more
335 consistent with other perl documentation. [perl #86686]
336
337 Added a bint() method for rounding towards zero. [perl #85296]
338
339 =item *
340
341 L<Math::BigInt::FastCalc> has been upgraded from version 0.30 to 0.31.
342
343 This upgrade is part of a larger change to make the array interface 64-bit safe
344 by using SSize_t instead of I32 for array indices.
345
346 =item *
347
348 L<Module::CoreList> has been upgraded from version 2.97 to 2.98.
349
350 The list of Perl versions covered has been updated.
351
352 =item *
353
354 L<Module::Load::Conditional> has been upgraded from version 0.54 to 0.58.
355
356 C<requires> has been made more robust. [cpan #83728]
357
358 =item *
359
360 L<Module::Metadata> has been upgraded from version 1.000014 to 1.000018.
361
362 The module's DESCRIPTION has been re-worded regarding safety/security to
363 satisfy CVE-2013-1437.  Also, versions are now detainted if needed. [cpan
364 #88576]
365
366 =item *
367
368 L<mro> has been upgraded from version 1.13 to 1.14.
369
370 This upgrade is part of a larger change to make the array interface 64-bit safe
371 by using SSize_t instead of I32 for array indices.
372
373 =item *
374
375 L<parent> has been upgraded from version 0.226 to 0.227.
376
377 No changes have been made to the installed code other than the version bump to
378 keep in sync with the latest CPAN release.
379
380 =item *
381
382 L<Parse::CPAN::Meta> has been upgraded from version 1.4405 to 1.4407.
383
384 No changes have been made to the installed code other than the version bump to
385 keep in sync with the latest CPAN release.
386
387 =item *
388
389 L<Perl::OSType> has been upgraded from version 1.003 to 1.005.
390
391 The Unix OSType 'bitrig' has been added.
392
393 =item *
394
395 L<perlfaq> has been upgraded from version 5.0150043 to 5.0150044.
396
397 The use of C<gensym> in a number of examples has been removed, the use of C<&>
398 in subroutine calls is now clarified and several new questions have been
399 answered.
400
401 =item *
402
403 L<re> has been upgraded from version 0.25 to 0.26.
404
405 A function signature has been corrected in the XS implementation.
406
407 =item *
408
409 L<Scalar::Util> has been upgraded from version 1.31 to 1.32.
410
411 The documentation of C<blessed> has been improved to mention the fact that
412 package "0" is defined but false.
413
414 =item *
415
416 L<Socket> has been upgraded from version 2.011 to 2.012.
417
418 Syntax errors when building on the WinCE platform have been fixed. [cpan #87389]
419
420 =item *
421
422 L<Storable> has been upgraded from version 2.46 to 2.47.
423
424 This upgrade is part of a larger change to preserve referential identity when
425 passing C<undef> to a subroutine by using NULL rather than &PL_sv_undef for
426 nonexistent array elements.
427
428 =item *
429
430 L<Term::ReadLine> has been upgraded from version 1.10 to 1.14.
431
432 Term::ReadLine::EditLine support has been added.
433
434 =item *
435
436 L<Time::Piece> has been upgraded from version 1.22 to 1.23.
437
438 Day of year parsing (like "%y%j") has been fixed.
439
440 =item *
441
442 L<Unicode::Collate> has been upgraded from version 0.98 to 0.99.
443
444 By default, out-of-range values are replaced with C<U+FFFD> (REPLACEMENT
445 CHARACTER) when C<UCA_Version> E<gt>= 22, or ignored when C<UCA_Version> E<lt>=
446 20.  When C<UCA_Version> E<gt>= 22, the weights of out-of-range values can be
447 overridden.
448
449 =item *
450
451 L<Unicode::UCD> has been upgraded from version 0.53 to 0.54.
452
453 This module now works on EBCDIC platforms.
454
455 =item *
456
457 L<version> has been upgraded from version 0.9903 to 0.9904.
458
459 No changes have been made to the installed code other than the version bump to
460 keep in sync with the latest CPAN release.
461
462 =item *
463
464 L<warnings> has been upgraded from version 1.18 to 1.19.
465
466 The C<syscalls> warnings category has been added to check for embedded NUL
467 (C<"\0">) characters in pathnames and string arguments to other system calls.
468
469 =item *
470
471 L<XS::Typemap> has been upgraded from version 0.10 to 0.11.
472
473 =back
474
475 =head2 Removed Modules and Pragmata
476
477 =over 4
478
479 =item *
480
481 XXX
482
483 =back
484
485 =head1 Documentation
486
487 XXX Changes to files in F<pod/> go here.  Consider grouping entries by
488 file and be sure to link to the appropriate page, e.g. L<perlfunc>.
489
490 =head2 New Documentation
491
492 XXX Changes which create B<new> files in F<pod/> go here.
493
494 =head3 L<XXX>
495
496 XXX Description of the purpose of the new file here
497
498 =head2 Changes to Existing Documentation
499
500 XXX Changes which significantly change existing files in F<pod/> go here.
501 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
502 section.
503
504 =head3 L<XXX>
505
506 =over 4
507
508 =item *
509
510 XXX Description of the change here
511
512 =back
513
514 =head1 Diagnostics
515
516 The following additions or changes have been made to diagnostic output,
517 including warnings and fatal error messages.  For the complete list of
518 diagnostic messages, see L<perldiag>.
519
520 XXX New or changed warnings emitted by the core's C<C> code go here.  Also
521 include any changes in L<perldiag> that reconcile it to the C<C> code.
522
523 =head2 New Diagnostics
524
525 XXX Newly added diagnostic messages go under here, separated into New Errors
526 and New Warnings
527
528 =head3 New Errors
529
530 =over 4
531
532 =item *
533
534 XXX L<message|perldiag/"message">
535
536 =back
537
538 =head3 New Warnings
539
540 =over 4
541
542 =item *
543
544 L<Invalid \0 character in %s for %s: %s\0%s|perldiag/"Invalid \0 character in %s for %s: %s\0%s">
545
546 (W syscalls) Embedded \0 characters in pathnames or other system call arguments
547 produce a warning as of 5.20. The parts after the \0 were formerly ignored by
548 system calls.
549
550 =back
551
552 =head2 Changes to Existing Diagnostics
553
554 XXX Changes (i.e. rewording) of diagnostic messages go here
555
556 =over 4
557
558 =item *
559
560 Warnings and errors from the regexp engine are now UTF-8 clean
561
562 =item *
563
564 The "Unknown switch condition" error message has some slight changes.
565 This error triggers when there is an unknown condition in a (?(foo))
566 conditional; The error message used to read:
567
568     Unknown switch condition (?(%s in regex;
569
570 But what %s could be was mostly up to luck; For (?(foobar)), you
571 might've seen "fo" or "f".  For Unicode characters, you'd generally
572 get a corrupted string.
573 The message was changed to read:
574
575     Unknown switch condition (?(...)) in regex;
576
577 And additionally, the '<-- HERE' marker in the error will now point
578 to the correct spot in the regex.
579
580 =back
581
582 =head1 Utility Changes
583
584 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go here.
585 Most of these are built within the directories F<utils> and F<x2p>.
586
587 [ List utility changes as a =head3 entry for each utility and =item
588 entries for each change
589 Use L<XXX> with program names to get proper documentation linking. ]
590
591 =head3 L<find2perl>
592
593 =over 4
594
595 =item *
596
597 L<find2perl> now handles C<?> wildcards correctly. [perl #113054]
598
599 =back
600
601 =head1 Configuration and Compilation
602
603 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
604 go here.  Any other changes to the Perl build process should be listed here.
605 However, any platform-specific changes should be listed in the
606 L</Platform Support> section, instead.
607
608 [ List changes as a =item entry ].
609
610 =over 4
611
612 =item *
613
614 The F<Makefile.PL> for C<SDBM_File> now generates a better F<Makefile>, which
615 avoids a race condition during parallel makes, which could cause the build to
616 fail.  This is the last known parallel make problem (on *nix platforms), and
617 therefore we believe that a parallel make should now always be error free.
618
619 =for comment
620
621 Strictly only for a build where build files such as F<Makefile.SH> have not
622 been updated by C<git> in an already configured and built tree.
623
624 =back
625
626 =head1 Testing
627
628 XXX Any significant changes to the testing of a freshly built perl should be
629 listed here.  Changes which create B<new> files in F<t/> go here as do any
630 large changes to the testing harness (e.g. when parallel testing was added).
631 Changes to existing files in F<t/> aren't worth summarizing, although the bugs
632 that they represent may be covered elsewhere.
633
634 [ List each test improvement as a =item entry ]
635
636 =over 4
637
638 =item *
639
640 The test script F<t/bigmem/regexp.t> has been added to test that regular
641 expression matches on very large strings now succeed as expected.
642
643 =item *
644
645 Various cases of C<die>, C<last>, C<goto> and C<exit> triggering C<DESTROY> are
646 now tested by the new test script F<t/op/rt119311.t>.
647
648 =item *
649
650 The new test script F<t/win32/signal.t> tests that C<$!> and C<$^E> are now
651 preserved across signal handlers by the Win32 signal emulation code.
652
653 =item *
654
655 The test script F<t/x2p/find2perl.t> has been added to test the F<find2perl>
656 program on platforms where it is practical to do so.
657
658 =back
659
660 =head1 Platform Support
661
662 XXX Any changes to platform support should be listed in the sections below.
663
664 [ Within the sections, list each platform as a =item entry with specific
665 changes as paragraphs below it. ]
666
667 =head2 New Platforms
668
669 XXX List any platforms that this version of perl compiles on, that previous
670 versions did not.  These will either be enabled by new files in the F<hints/>
671 directories, or new subdirectories and F<README> files at the top level of the
672 source tree.
673
674 =over 4
675
676 =item Bitrig
677
678 Compile support has been added for Bitrig, a fork of OpenBSD.
679
680 =back
681
682 =head2 Discontinued Platforms
683
684 XXX List any platforms that this version of perl no longer compiles on.
685
686 Configure hints and conditional code for several very old platforms
687 has been removed.  We have not received reports for these in many years,
688 typically not since perl-5.6.0.
689
690 =over 4
691
692 =item AT&T 3b1
693
694 Configure support for the 3b1, also known as the AT&T Unix PC (and the
695 similar AT&T 7300), has been removed.
696
697 =back
698
699 =head2 Platform-Specific Notes
700
701 XXX List any changes for specific platforms.  This could include configuration
702 and compilation changes or changes in portability/compatibility.  However,
703 changes within modules for platforms should generally be listed in the
704 L</Modules and Pragmata> section.
705
706 =over 4
707
708 =item WinCE
709
710 The building of XS modules has largely been restored. Several still cannot
711 (yet) be built but it is now possible to build Perl on WinCE with only a couple
712 of further patches (to L<Socket> and L<ExtUtils::MakeMaker>), hopefully to be
713 incorporated soon.
714
715 =back
716
717 =head1 Internal Changes
718
719 XXX Changes which affect the interface available to C<XS> code go here.  Other
720 significant internal changes for future core maintainers should be noted as
721 well.
722
723 [ List each change as a =item entry ]
724
725 =over 4
726
727 =item *
728
729 The internal representation has changed for the match variables C<$1>, C<$2>
730 I<etc.>, C<$`>, C<$&>, C<$'>, C<${^PREMATCH}>, C<${^MATCH}> and
731 C<${^POSTMATCH>.  It uses slightly less memory, avoids string comparisons
732 and numeric conversions during lookup, and uses 23 fewer lines of C.  This
733 change should not affect any external code.
734
735 =item *
736
737 Arrays now use NULL internally to represent unused slots, instead of
738 C<&PL_sv_undef>.  C<&PL_sv_undef> is no longer treated as a special value,
739 so C<av_store(av, 0, &PL_sv_undef)> will cause element 0 of that array to
740 hold a read-only undefined scalar.  C<$array[0] = anything> will croak and
741 C<\$array[0]> will compare equal to C<\undef>.
742
743 =back
744
745 =head1 Selected Bug Fixes
746
747 XXX Important bug fixes in the core language are summarized here.  Bug fixes in
748 files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
749
750 [ List each fix as a =item entry ]
751
752 =over 4
753
754 =item *
755
756 The value of C<$^E> is now saved across signal handlers on Win32. [perl #85104]
757
758 =item *
759
760 A lexical filehandle (as in C<open my $fh...>) is usually given a name
761 based on the current package and the name of the variable; e.g.,
762 "main::$fh".  Under recursion, the filehandle was losing the "$fh" part of
763 the name.  This has been fixed.
764
765 =item *
766
767 Perl 5.19.3 accidentally extended the previous bug to all closures, even
768 when not called recursively; i.e., lexical handles in closure would always
769 be called "main::" or "MyPackage::" etc.  This has been fixed.
770
771 =item *
772
773 Uninitialized values returned by XSUBs are no longer exempt from
774 uninitialized warnings.  [perl #118693]
775
776 =item *
777
778 C<elsif ("")> no longer erroneous produces a warning about void context.
779 [perl #118753]
780
781 =item *
782
783 Passing C<undef> to a subroutine now causes @_ to contain the same read-only undefined scalar that C<undef> returns.  Furthermore, C<exists $_[0]> will now return true if C<undef> was the first argument.
784 [perl #7508, #109726].
785
786 =item *
787
788 Passing a nonexistent array element to a subroutine does not usually
789 autovivify it unless the subroutine modifies its argument.  This did not
790 work correctly with negative indices and with nonexistent elements within
791 the array.  The element would be vivified immediately.  The delayed
792 vivification has been extended to work with those.  [perl #118691]
793
794 =item *
795
796 Assigning references or globs to the scalar returned by C<$#foo> after the
797 @foo array has been freed no longer causes assertion failures on debugging
798 builds and memory leaks on regular builds.
799
800 =item *
801
802 Perl 5.19.2 threw line numbers off after some cases of line breaks
803 following keywords, such as
804
805    1 unless
806    1;
807
808 This has been fixed.  [perl #118931]
809
810 =back
811
812 =head1 Known Problems
813
814 XXX Descriptions of platform agnostic bugs we know we can't fix go here.  Any
815 tests that had to be C<TODO>ed for the release would be noted here.  Unfixed
816 platform specific bugs also go here.
817
818 [ List each fix as a =item entry ]
819
820 =over 4
821
822 =item *
823
824 XXX
825
826 =back
827
828 =head1 Obituary
829
830 XXX If any significant core contributor has died, we've added a short obituary
831 here.
832
833 =head1 Acknowledgements
834
835 XXX Generate this with:
836
837   perl Porting/acknowledgements.pl v5.19.3..HEAD
838
839 =head1 Reporting Bugs
840
841 If you find what you think is a bug, you might check the articles recently
842 posted to the comp.lang.perl.misc newsgroup and the perl bug database at
843 http://rt.perl.org/perlbug/ .  There may also be information at
844 http://www.perl.org/ , the Perl Home Page.
845
846 If you believe you have an unreported bug, please run the L<perlbug> program
847 included with your release.  Be sure to trim your bug down to a tiny but
848 sufficient test case.  Your bug report, along with the output of C<perl -V>,
849 will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
850
851 If the bug you are reporting has security implications, which make it
852 inappropriate to send to a publicly archived mailing list, then please send it
853 to perl5-security-report@perl.org.  This points to a closed subscription
854 unarchived mailing list, which includes all the core committers, who will be
855 able to help assess the impact of issues, figure out a resolution, and help
856 co-ordinate the release of patches to mitigate or fix the problem across all
857 platforms on which Perl is supported.  Please only use this address for
858 security issues in the Perl core, not for modules independently distributed on
859 CPAN.
860
861 =head1 SEE ALSO
862
863 The F<Changes> file for an explanation of how to view exhaustive details on
864 what changed.
865
866 The F<INSTALL> file for how to build Perl.
867
868 The F<README> file for general stuff.
869
870 The F<Artistic> and F<Copying> files for copyright information.
871
872 =cut