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