This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta for 8e88cfee26d866223a6b3bfffce6270271de00db
[perl5.git] / pod / perldelta.pod
1 =encoding utf8
2
3 =for comment
4 This has been completed up to 91fad77.
5
6 =head1 NAME
7
8 [ this is a template for a new perldelta file. Any text flagged as
9 XXX needs to be processed before release. ]
10
11 perldelta - what is new for perl v5.13.8
12
13 =head1 DESCRIPTION
14
15 This document describes differences between the 5.13.8 release and
16 the 5.13.7 release.
17
18 If you are upgrading from an earlier release such as 5.13.6, first read
19 L<perl5137delta>, which describes differences between 5.13.6 and
20 5.13.7.
21
22 =head1 Notice
23
24 XXX Any important notices here
25
26 =head1 Core Enhancements
27
28 XXX New core language features go here. Summarise user-visible core language
29 enhancements. Particularly prominent performance optimisations could go
30 here, but most should go in the L</Performance Enhancements> section.
31
32 [ List each enhancement as a =head2 entry ]
33
34 =head2 C<-d:-foo> calls C<Devel::foo::unimport>
35
36 The syntax C<-dI<B<:>foo>> was extended in 5.6.1 to make C<-dI<:fooB<=bar>>>
37 equivalent to C<-MDevel::foo=bar>, which expands
38 internally to C<use Devel::foo 'bar';>.
39 F<perl> now allows prefixing the module name with C<->, with the same
40 semantics as C<-M>, I<i.e.>
41
42 =over 4
43
44 =item C<-d:-foo>
45
46 Equivalent to C<-M-Devel::foo>, expands to
47 C<no Devel::foo;>, calls C<< Devel::foo->unimport() >>
48 if the method exists.
49
50 =item C<-d:-foo=bar>
51
52 Equivalent to C<-M-Devel::foo=bar>, expands to C<no Devel::foo 'bar';>,
53 calls C<< Devel::foo->unimport('bar') >> if the method exists.
54
55 =back
56
57 This is particularly useful to suppresses the default actions of a
58 C<Devel::*> module's C<import> method whilst still loading it for debugging.
59
60 =head2 Filehandle method calls load IO::File on demand
61
62 When a method call on a filehandle would die because the method can not
63 be resolved and L<IO::File> has not been loaded, Perl now loads IO::File
64 via C<require> and attempts method resolution again:
65
66   open my $fh, ">", $file;
67   $fh->binmode(":raw");     # loads IO::File and succeeds
68
69 This also works for globs like STDOUT, STDERR and STDIN:
70
71   STDOUT->autoflush(1);
72
73 Because this on-demand load only happens if method resolution fails, the
74 legacy approach of manually loading an IO::File parent class for partial
75 method support still works as expected:
76
77   use IO::Handle;
78   open my $fh, ">", $file;
79   $fh->autoflush(1);        # IO::File not loaded
80
81 =head2 Full functionality for C<use feature 'unicode_strings'>
82
83 This release provides full functionality for C<use feature
84 'unicode_strings'>.  Under its scope, all string operations executed and
85 regular expressions compiled (even if executed outside its scope) have
86 Unicode semantics.   See L<feature>.
87
88 This feature avoids the "Unicode Bug" (See
89 L<perlunicode/The "Unicode Bug"> for details.)  If their is a
90 possibility that your code will process Unicode strings, you are
91 B<strongly> encouraged to use this subpragma to avoid nasty surprises.
92
93 This availability of this should strongly affect the whole tone of
94 various documents, such as L<perlunicode> and L<perluniintro>, but this
95 work has not been done yet.
96
97 =head2 Exception Handling Backcompat Hack
98
99 When an exception is thrown in an C<eval BLOCK>, C<$@> is now set before
100 unwinding, as well as being set after unwinding as the eval block exits.  This
101 early setting supports code that has historically treated C<$@> during unwinding
102 as an indicator of whether the unwinding was due to an exception.  These modules
103 had been broken by 5.13.1's change from setting C<$@> early to setting it late.
104 This double setting arrangement is a stopgap until the reason for unwinding can
105 be made properly introspectable.  C<$@> has never been a reliable indicator of
106 this.
107
108 =head2 printf-like functions understand size modifiers "hh", "z", "t", and sometimes "j"
109
110 Perl's printf and sprintf operators, and Perl's internal printf replacement
111 function, now understand the C90 size modifiers "hh" (C<char>), "z"
112 (C<size_t>), and "t" (C<ptrdiff_t>).  Also, when compiled with a C99
113 compiler, Perl now understands the size modifier "j" (C<intmax_t>).
114
115 So, for example, on any modern machine, C<sprintf('%hhd', 257)> returns '1'.
116
117 =head2 DTrace probes now include package name
118
119 The DTrace probes now include an additional argument (C<arg3>) which contains
120 the package the subroutine being entered or left was compiled in.
121
122 For example using the following DTrace script:
123
124   perl$target:::sub-entry
125   {
126       printf("%s::%s\n", copyinstr(arg0), copyinstr(arg3));
127   }
128
129 and then running:
130
131   perl -e'sub test { }; test'
132
133 DTrace will print:
134
135   main::test
136
137 =head2 Stacked labels
138
139 Multiple statement labels can now appear before a single statement.
140
141 =head1 Security
142
143 XXX Any security-related notices go here.  In particular, any security
144 vulnerabilities closed should be noted here rather than in the
145 L</Selected Bug Fixes> section.
146
147 [ List each security issue as a =head2 entry ]
148
149 =head1 Incompatible Changes
150
151 =head2 Attempting to use C<:=> as an empty attribute list is now a syntax error
152
153 Previously C<my $pi := 4;> was exactly equivalent to C<my $pi : = 4;>,
154 with the C<:> being treated as the start of an attribute list, ending before
155 the C<=>. The use of C<:=> to mean C<: => was deprecated in 5.12.0, and is now
156 a syntax error. This will allow the future use of C<:=> as a new token.
157
158 We find no Perl 5 code on CPAN using this construction, outside the core's
159 tests for it, so we believe that this change will have very little impact on
160 real-world codebases.
161
162 If it is absolutely necessary to have empty attribute lists (for example,
163 because of a code generator) then avoid the error by adding a space before
164 the C<=>.
165
166 =head2 Run-time code block in regular expressions
167
168 Code blocks in regular expressions (C<(?{...})> and C<(??{...})>) used not
169 to inherit any pragmata (strict, warnings, etc.) if the regular expression
170 was compiled at run time as happens in cases like these two:
171
172   use re 'eval';
173   $foo =~ $bar; # when $bar contains (?{...})
174   $foo =~ /$bar(?{ $finished = 1 })/;
175
176 This was a bug, which has now been fixed. But it has the potential to break
177 any code that was relying on this bug.
178
179 =head1 Deprecations
180
181 XXX Any deprecated features, syntax, modules etc. should be listed here.
182 In particular, deprecated modules should be listed here even if they are
183 listed as an updated module in the L</Modules and Pragmata> section.
184
185 [ List each deprecation as a =head2 entry ]
186
187 =head2 C<?PATTERN?> is deprecated
188
189 C<?PATTERN?> (without the initial m) has been deprecated and now produces
190 a warning.
191
192 =head2 C<sv_compile_2op> is now deprecated
193
194 The C<sv_compile_2op> is now deprecated, and will be removed. Searches suggest
195 that nothing on CPAN is using it, so this should have zero impact.
196
197 It attempted to provide an API to compile code down to an optree, but failed
198 to bind correctly to lexicals in the enclosing scope. It's not possible to
199 fix this problem within the constraints of its parameters and return value.
200
201 =head2 Tie functions on scalars holding typeglobs
202
203 Calling a tie function (C<tie>, C<tied>, C<untie>) with a scalar argument
204 acts on a file handle if the scalar happens to hold a typeglob.
205
206 This is a long-standing bug that will be removed in Perl 5.16, as
207 there is currently no way to tie the scalar itself when it holds
208 a typeglob, and no way to untie a scalar that has had a typeglob
209 assigned to it.
210
211 This bug was fixed in 5.13.7 but, because of the breakage it caused, the
212 fix has been reverted. Now there is a deprecation warning whenever a tie
213 function is used on a handle without an explicit C<*>.
214
215 =head1 Performance Enhancements
216
217 XXX Changes which enhance performance without changing behaviour go here. There
218 may well be none in a stable release.
219
220 [ List each enhancement as a =item entry ]
221
222 =over 4
223
224 =item *
225
226 XXX
227
228 =back
229
230 =head1 Modules and Pragmata
231
232 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
233 go here.  If Module::CoreList is updated, generate an initial draft of the
234 following sections using F<Porting/corelist-perldelta.pl>, which prints stub
235 entries to STDOUT.  Results can be pasted in place of the '=head2' entries
236 below.  A paragraph summary for important changes should then be added by hand.
237 In an ideal world, dual-life modules would have a F<Changes> file that could be
238 cribbed.
239
240 [ Within each section, list entries as a =item entry ]
241
242 =head2 New Modules and Pragmata
243
244 =over 4
245
246 =item *
247
248 XXX
249
250 =back
251
252 =head2 Updated Modules and Pragmata
253
254 =over 4
255
256 =item *
257
258 C<Archive::Tar> has been upgraded from version 1.72 to 1.74
259
260 =item *
261
262 C<B::Concise> has been upgraded from version 0.81 to 0.82.
263
264 It no longer produces mangled output with the C<-tree> option
265 L<[perl #80632]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=80632>.
266
267 =item *
268
269 C<Devel::SelfStubber> has been upgraded from version 1.04 to 1.05.
270
271 =item *
272
273 C<Digest::SHA> has been upgraded from 5.48 to 5.50
274
275 shasum now more closely mimics sha1sum/md5sum and Addfile
276 accepts all POSIX filenames.
277
278 =item *
279
280 C<Dumpvalue> has been upgraded from version 1.14 to 1.15.
281
282 =item *
283
284 C<Env> has been upgraded from version 1.01 to 1.02.
285
286 =item *
287
288 C<ExtUtils::CBuilder> has been upgraded from 0.2703 to 0.2802
289
290 =item *
291
292 C<ExtUtils::Embed> has been upgraded from 1.29 to 1.30.
293
294 =item *
295
296 C<if> has been upgraded from 0.06 to 0.0601.
297
298 =item *
299
300 C<Devel::SelfStubber> has been upgraded from version 1.03 to 1.04.
301
302 =item *
303
304 C<IPC::Cmd> has been upgraded from 0.64 to 0.66
305
306 Resolves an issue with splitting Win32 command lines
307 and documentation enhancements.
308
309 =item *
310
311 C<IPC::Open3> has been upgraded from 1.07 to 1.08.
312
313 =item *
314
315 C<Locale::Codes> has been upgraded from version 3.14 to 3.15
316
317 =item *
318
319 C<Memoize> has been upgraded from version 1.01_03 to 1.02.
320
321 =item *
322
323 C<MIME::Base64> has been upgraded from 3.10 to 3.13
324
325 Now provides encode_base64url and decode_base64url functions to process
326 the base64 scheme for "URL applications".
327
328 =item *
329
330 C<mro> has been upgraded from version 1.05 to 1.06.
331
332 C<next::method> I<et al.> now take into account that every class inherits
333 from UNIVERSAL
334 L<[perl #68654]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=68654>.
335
336 =item *
337
338 C<Net::Ping> has been upgraded from 2.36 to 2.37.
339
340 =item *
341
342 C<overload> has been upgraded from 1.11 to 1.12.
343
344 =item *
345
346 C<PerlIO::encoding> has been upgraded from 0.13 to 0.14.
347
348 =item *
349
350 C<PerlIO::scalar> has been upgraded from 0.10 to 0.11.
351
352 A C<read> after a C<seek> beyond the end of the string no longer thinks it
353 has data to read
354 L<[perl #78716]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78716>.
355
356 =item *
357
358 C<re> has been upgraded from 0.14 to 0.15.
359
360 =item *
361
362 C<Socket> has been upgraded from 1.91 to 1.92.
363
364 It has several new functions for handling IPv6 addresses.
365
366 =item *
367
368 C<Storable> has been upgraded from 2.24 to 2.25.
369
370 This adds support for serialising code references that contain UTF-8 strings
371 correctly. The Storable minor version number changed as a result -- this means
372 Storable users that set C<$Storable::accept_future_minor> to a C<FALSE> value
373 will see errors (see L<Storable/FORWARD COMPATIBILITY> for more details).
374
375 Freezing no longer gets confused if the Perl stack gets reallocated
376 during freezing
377 L<[perl #80074]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=80074>.
378
379 =item *
380
381 C<Time::HiRes> has been upgraded from 1.9721 to 1.9721_01.
382
383 =item *
384
385 C<Unicode::Collate> has been upgraded from 0.67 to 0.68
386
387 =item *
388
389 C<Unicode::UCD> has been upgraded from 0.29 to 0.30.
390
391 =item *
392
393 C<version> has been upgraded from 0.82 to 0.86.
394
395 =item *
396
397 C<Win32> has been upgraded from 0.039 to 0.040.
398
399 =back
400
401 =head2 Removed Modules and Pragmata
402
403 =over 4
404
405 =item *
406
407 XXX
408
409 =back
410
411 =head1 Documentation
412
413 XXX Changes to files in F<pod/> go here.  Consider grouping entries by
414 file and be sure to link to the appropriate page, e.g. L<perlfunc>.
415
416 =head2 New Documentation
417
418 XXX Changes which create B<new> files in F<pod/> go here.
419
420 =head3 L<XXX>
421
422 XXX Description of the purpose of the new file here
423
424 =head2 Changes to Existing Documentation
425
426 XXX Changes which significantly change existing files in F<pod/> go here.
427 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
428 section.
429
430 =head3 L<XXX>
431
432 =over 4
433
434 =item *
435
436 XXX Description of the change here
437
438 =back
439
440 =head1 Diagnostics
441
442 The following additions or changes have been made to diagnostic output,
443 including warnings and fatal error messages.  For the complete list of
444 diagnostic messages, see L<perldiag>.
445
446 XXX New or changed warnings emitted by the core's C<C> code go here. Also
447 include any changes in L<perldiag> that reconcile it to the C<C> code.
448
449 [ Within each section, list entries as a =item entry ]
450
451 =head2 New Diagnostics
452
453 XXX Newly added diagnostic messages go here
454
455 =over 4
456
457 =item *
458
459 There is a new "Closure prototype called" error.
460
461 =back
462
463 =head2 Changes to Existing Diagnostics
464
465 XXX Changes (i.e. rewording) of diagnostic messages go here
466
467 =over 4
468
469 =item *
470
471 The "Found = in conditional" warning that is emitted when a constant is
472 assigned to a variable in a condition is now withheld if the constant is
473 actually a subroutine or one generated by C<use constant>, since the value
474 of the constant may not be known at the time the program is written
475 L<[perl #77762]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=77762>.
476
477 =back
478
479 =head1 Utility Changes
480
481 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
482 here. Most of these are built within the directories F<utils> and F<x2p>.
483
484 [ List utility changes as a =head3 entry for each utility and =item
485 entries for each change
486 Use L<XXX> with program names to get proper documentation linking. ]
487
488 =head3 L<XXX>
489
490 =over 4
491
492 =item *
493
494 XXX
495
496 =back
497
498 =head1 Configuration and Compilation
499
500 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
501 go here.  Any other changes to the Perl build process should be listed here.
502 However, any platform-specific changes should be listed in the
503 L</Platform Support> section, instead.
504
505 [ List changes as a =item entry ].
506
507 =over 4
508
509 =item *
510
511 The C<Encode> module can now (once again) be included in a static Perl
512 build.  The special-case handling for this situation got broken in Perl
513 5.11.0, and has now been repaired.
514
515 =item *
516
517 XXX
518
519 =back
520
521 =head1 Testing
522
523 XXX Any significant changes to the testing of a freshly built perl should be
524 listed here.  Changes which create B<new> files in F<t/> go here as do any
525 large changes to the testing harness (e.g. when parallel testing was added).
526 Changes to existing files in F<t/> aren't worth summarising, although the bugs
527 that they represent may be covered elsewhere.
528
529 [ List each test improvement as a =item entry ]
530
531 =over 4
532
533 =item *
534
535 XXX
536
537 =back
538
539 =head1 Platform Support
540
541 XXX Any changes to platform support should be listed in the sections below.
542
543 [ Within the sections, list each platform as a =item entry with specific
544 changes as paragraphs below it. ]
545
546 =head2 New Platforms
547
548 XXX List any platforms that this version of perl compiles on, that previous
549 versions did not. These will either be enabled by new files in the F<hints/>
550 directories, or new subdirectories and F<README> files at the top level of the
551 source tree.
552
553 =over 4
554
555 =item XXX-some-platform
556
557 XXX
558
559 =back
560
561 =head2 Discontinued Platforms
562
563 XXX List any platforms that this version of perl no longer compiles on.
564
565 =over 4
566
567 =item XXX-some-platform
568
569 XXX
570
571 =back
572
573 =head2 Platform-Specific Notes
574
575 XXX List any changes for specific platforms. This could include configuration
576 and compilation changes or changes in portability/compatibility.  However,
577 changes within modules for platforms should generally be listed in the
578 L</Modules and Pragmata> section.
579
580 =over 4
581
582 =item NetBSD
583
584 The NetBSD hints file has been changed to make the system's malloc the
585 default.
586
587 =item Windows
588
589 The option to use an externally-supplied C<crypt()>, or to build with no
590 C<crypt()> at all, has been removed.  Perl supplies its own C<crypt()>
591 implementation for Windows, and the political situation that required
592 this part of the distribution to sometimes be omitted is long gone.
593
594 =back
595
596 =head1 Internal Changes
597
598 XXX Changes which affect the interface available to C<XS> code go here.
599 Other significant internal changes for future core maintainers should
600 be noted as well.
601
602 [ List each test improvement as a =item entry ]
603
604 =over 4
605
606 =item *
607
608 C<mg_findext> and C<sv_unmagicext> have been added.
609
610 These new functions allow extension authors to find and remove magic attached to
611 scalars based on both the magic type and the magic virtual table, similar to how
612 C<sv_magicext> attaches magic of a certain type and with a given virtual table
613 to a scalar. This eliminates the need for extensions to walk the list of
614 C<MAGIC> pointers of an C<SV> to find the magic that belongs to them.
615
616 =item *
617
618 The C<parse_fullexpr()>, C<parse_listexpr(), C<parse_termexpr()> and
619 C<parse_arithexpr()> functions have been added.
620
621 These are for parsing expressions at various precedence levels.
622
623 =back
624
625 =head1 Selected Bug Fixes
626
627 XXX Important bug fixes in the core language are summarised here.
628 Bug fixes in files in F<ext/> and F<lib/> are best summarised in
629 L</Modules and Pragmata>.
630
631 [ List each fix as a =item entry ]
632
633 =over 4
634
635 =item *
636
637 C<BEGIN {require 5.12.0}> now behaves as documented, rather than behaving
638 identically to C<use 5.12.0;>. Previously, C<require> in a C<BEGIN> block
639 was erroneously executing the C<use feature ':5.12.0'> and
640 C<use strict; use warnings;> behaviour, which only C<use> was documented to
641 provide
642 L<[perl #69050]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=69050>.
643
644 =item *
645
646 C<use 5.42>
647 L<[perl #69050]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=69050>,
648 C<use 6> and C<no 5> no longer leak memory.
649
650 =item *
651
652 C<eval "BEGIN{die}"> no longer leaks memory on non-threaded builds.
653
654 =item *
655
656 PerlIO no longer crashes when called recursively, e.g., from a signal
657 handler. Now it just leaks memory
658 L<[perl #75556]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=75556>.
659
660 =item *
661
662 Defining a constant with the same name as one of perl's special blocks
663 (e.g., INIT) stopped working in 5.12.0, but has now been fixed
664 L<[perl #78634]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78634>.
665
666 =item *
667
668 A reference to a literal value used as a hash key (C<$hash{\"foo"}>) used
669 to be stringified, even if the hash was tied
670 L<[perl #79178]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=79178>.
671
672 =item *
673
674 A closure containing an C<if> statement followed by a constant or variable
675 is no longer treated as a constant
676 L<[perl #63540]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=63540>.
677
678 =item *
679
680 Calling a closure prototype (what is passed to an attribute handler for a
681 closure) now results in a "Closure prototype called" error message instead
682 of a crash
683 L<[perl #68560]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=68560>.
684
685 =item *
686
687 A regular expression optimisation would sometimes cause a match with a
688 C<{n,m}> quantifier to fail when it should match
689 L<[perl #79152]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=79152>.
690
691 =item *
692
693 What has become known as the "Unicode Bug" is resolved in this release.
694 Under C<use feature 'unicode_strings'>, the internal storage format of a
695 string no longer affects the external semantics.  There are two known
696 exceptions.  User-defined case changing functions, which are planned to
697 be deprecated in 5.14, require utf8-encoded strings to function; and the
698 character C<LATIN SMALL LETTER SHARP S> in regular expression
699 case-insensitive matching has a somewhat different set of bugs depending
700 on the internal storage format.  Case-insensitive matching of all
701 characters that have multi-character matches, as this one does, is
702 problematical in Perl.
703 L<[perl #58182]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=58182>.
704
705 =item *
706
707 Mentioning a read-only lexical variable from the enclosing scope in a
708 string C<eval> would cause the variable to become writable
709 L<[perl #19135]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=19135>.
710
711 =item *
712
713 C<state> can now be used with attributes. It used to mean the same thing as
714 C<my> if attributes were present
715 L<[perl #68658]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=68658>.
716
717 =item *
718
719 Expressions like C<< @$a > 3 >> no longer cause C<$a> to be mentioned in
720 the "Use of uninitialized value in numeric gt" warning when C<$a> is
721 undefined (since it is not part of the C<E<gt>> expression, but the operand
722 of the C<@>)
723 L<[perl #72090]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=72090>.
724
725 =item *
726
727 C<require> no longer causes C<caller> to return the wrong file name for
728 the scope that called C<require> and other scopes higher up that had the
729 same file name
730 L<[perl #68712]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=68712>.
731
732 =item *
733
734 The ref types in the typemap for XS bindings now support magical variables
735 L<[perl #72684]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=72684>.
736
737 =item *
738
739 Match variables (e.g., C<$1>) no longer persist between calls to a sort
740 subroutine
741 L<[perl #76026]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=76026>.
742
743 =item *
744
745 The C<B> module was returning B::OPs instead of B::LOGOPs for C<entertry>
746 L<[perl #80622]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=80622>.
747
748 This was due to a bug in the perl core, not in C<B> itself.
749
750 =item *
751
752 Some numeric operators were converting integers to floating point,
753 resulting in loss of precision on 64-bit platforms
754 L<[perl #77456]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=77456>.
755
756 =item *
757
758 The fallback behaviour of overloading on binary operators was asymmetric
759 L<[perl #71286]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=71286>.
760
761 =back
762
763 =head1 Known Problems
764
765 XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
766 tests that had to be C<TODO>ed for the release would be noted here, unless
767 they were specific to a particular platform (see below).
768
769 This is a list of some significant unfixed bugs, which are regressions
770 from either 5.XXX.XXX or 5.XXX.XXX.
771
772 [ List each fix as a =item entry ]
773
774 =over 4
775
776 =item *
777
778 XXX
779
780 =back
781
782 =head1 Obituary
783
784 XXX If any significant core contributor has died, we've added a short obituary
785 here.
786
787 =head1 Acknowledgements
788
789 XXX The list of people to thank goes here.
790
791 =head1 Reporting Bugs
792
793 If you find what you think is a bug, you might check the articles
794 recently posted to the comp.lang.perl.misc newsgroup and the perl
795 bug database at http://rt.perl.org/perlbug/ .  There may also be
796 information at http://www.perl.org/ , the Perl Home Page.
797
798 If you believe you have an unreported bug, please run the L<perlbug>
799 program included with your release.  Be sure to trim your bug down
800 to a tiny but sufficient test case.  Your bug report, along with the
801 output of C<perl -V>, will be sent off to perlbug@perl.org to be
802 analysed by the Perl porting team.
803
804 If the bug you are reporting has security implications, which make it
805 inappropriate to send to a publicly archived mailing list, then please send
806 it to perl5-security-report@perl.org. This points to a closed subscription
807 unarchived mailing list, which includes all the core committers, who be able
808 to help assess the impact of issues, figure out a resolution, and help
809 co-ordinate the release of patches to mitigate or fix the problem across all
810 platforms on which Perl is supported. Please only use this address for
811 security issues in the Perl core, not for modules independently
812 distributed on CPAN.
813
814 =head1 SEE ALSO
815
816 The F<Changes> file for an explanation of how to view exhaustive details
817 on what changed.
818
819 The F<INSTALL> file for how to build Perl.
820
821 The F<README> file for general stuff.
822
823 The F<Artistic> and F<Copying> files for copyright information.
824
825 =cut