This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta for two notable B::Concise changes
[perl5.git] / pod / perldelta.pod
CommitLineData
44691e6f
AB
1=encoding utf8
2
3=head1 NAME
4
8c8d6154
SH
5[ this is a template for a new perldelta file. Any text flagged as XXX needs
6to be processed before release. ]
7
8perldelta - what is new for perl v5.21.5
c68523cb 9
238894db 10=head1 DESCRIPTION
c68523cb 11
8c8d6154 12This document describes differences between the 5.21.4 release and the 5.21.5
238894db 13release.
c68523cb 14
8c8d6154
SH
15If you are upgrading from an earlier release such as 5.21.3, first read
16L<perl5214delta>, which describes differences between 5.21.3 and 5.21.4.
8435afd1 17
8c8d6154 18=head1 Notice
8435afd1 19
8c8d6154 20XXX Any important notices here
5cfa0642 21
8c8d6154 22=head1 Core Enhancements
5cfa0642 23
8c8d6154
SH
24XXX New core language features go here. Summarize user-visible core language
25enhancements. Particularly prominent performance optimisations could go
26here, but most should go in the L</Performance Enhancements> section.
8435afd1 27
8c8d6154 28[ List each enhancement as a =head2 entry ]
8435afd1 29
4cad5dc8
FC
30=head2 New double-diamond operator
31
4a573b25 32C<<< <<>> >>> is like C<< <> >> but uses three-argument C<open> to open
4cad5dc8
FC
33each file in @ARGV. So each element of @ARGV is an actual file name, and
34"|foo" won't be treated as a pipe open.
35
a5591204
FC
36=head2 Aliasing via reference
37
38Variables and subroutines can now be aliased by assigning to a reference:
39
40 \$c = \$d;
41 \&x = \&y;
42
43Or by using a backslash before a C<foreach> iterator variable, which is
44perhaps the most useful idiom this feature provides:
45
46 foreach \%hash (@array_of_hash_refs) { ... }
47
48This feature is experimental and must be enabled via C<use feature
49'refaliasing'>. It will warn unless the C<experimental::refaliasing>
50warnings category is disabled.
51
52See L<perlref/Assigning to References>.
53
b15c1b56
AF
54=head2 Perl now supports POSIX 2008 locale currency additions.
55
56On platforms that are able to handle POSIX.1-2008, the
57hash returned by
58L<C<POSIX::localeconv()>|perllocale/The localeconv function>
59includes the international currency fields added by that version of the
60POSIX standard. These are
61C<int_n_cs_precedes>,
62C<int_n_sep_by_space>,
63C<int_n_sign_posn>,
64C<int_p_cs_precedes>,
65C<int_p_sep_by_space>,
66and
67C<int_p_sign_posn>.
68
bb8c7e27
A
69=head2 Packing infinity or not-a-number into a character is now fatal.
70
71Before, when trying to pack infinity or not-a-number into a
72(signed) character, Perl would warn, and assumed you tried to
73pack C<< 0xFF >>; if you gave it as an argument to C<< chr >>,
74C<< U+FFFD >> was returned.
75
76But now, all such actions (C<< pack >>, C<< chr >>, and C<< print '%c' >>)
77result in a fatal error.
78
8c8d6154 79=head1 Security
5cfa0642 80
ba474e87
JH
81=head2 Perl is now compiled with -fstack-protector-strong if available
82
83Perl has been compiled with the anti-stack-smashing option
84C<-fstack-protector> since 5.10.1. Now Perl uses the newer variant
85called C<-fstack-protector-strong>, if available. (This was added
86already in 5.21.4.)
8435afd1 87
8c8d6154 88[ List each security issue as a =head2 entry ]
8435afd1 89
8c8d6154 90=head1 Incompatible Changes
5cfa0642 91
8c8d6154 92XXX For a release on a stable branch, this section aspires to be:
8435afd1 93
8c8d6154
SH
94 There are no changes intentionally incompatible with 5.XXX.XXX
95 If any exist, they are bugs, and we request that you submit a
96 report. See L</Reporting Bugs> below.
5b319db8 97
8c8d6154 98[ List each incompatible change as a =head2 entry ]
5cfa0642 99
8c8d6154 100=head1 Deprecations
d0ab07ee 101
8c8d6154 102XXX Any deprecated features, syntax, modules etc. should be listed here.
d0ab07ee 103
8c8d6154 104=head2 Module removals
5cfa0642 105
8c8d6154 106XXX Remove this section if inapplicable.
d0ab07ee 107
8c8d6154
SH
108The following modules will be removed from the core distribution in a
109future release, and will at that time need to be installed from CPAN.
110Distributions on CPAN which require these modules will need to list them as
111prerequisites.
8435afd1 112
8c8d6154
SH
113The core versions of these modules will now issue C<"deprecated">-category
114warnings to alert you to this fact. To silence these deprecation warnings,
115install the modules in question from CPAN.
46274848 116
8c8d6154
SH
117Note that these are (with rare exceptions) fine modules that you are encouraged
118to continue to use. Their disinclusion from core primarily hinges on their
119necessity to bootstrapping a fully functional, CPAN-capable Perl installation,
120not usually on concerns over their design.
46274848 121
8c8d6154 122=over
d0ab07ee 123
8c8d6154 124=item XXX
5cfa0642 125
8c8d6154
SH
126XXX Note that deprecated modules should be listed here even if they are listed
127as an updated module in the L</Modules and Pragmata> section.
5cfa0642 128
8c8d6154 129=back
8435afd1 130
cc4d09e1
KW
131=head2 Use of multiple /x regexp modifiers
132
133It is now deprecated to say something like any of the following:
134
135 qr/foo/xx;
136 /(?xax:foo)/;
137 use re qw(/amxx);
138
139That is, now C<x> should only occur once in any string of contiguous
140regular expression pattern modifiers. We do not believe there are any
141occurrences of this in all of CPAN. This is in preparation for a future
142Perl release having C</xx> mean to allow white-space for readability in
143bracketed character classes (those enclosed in square brackets:
144C<[...]>).
8435afd1 145
8c8d6154 146=head1 Performance Enhancements
5cfa0642 147
8c8d6154
SH
148XXX Changes which enhance performance without changing behaviour go here.
149There may well be none in a stable release.
8435afd1 150
8c8d6154 151[ List each enhancement as a =item entry ]
8435afd1 152
8c8d6154 153=over 4
5cfa0642 154
8435afd1
SH
155=item *
156
1dc08634
FC
157C<length> is up to 20% faster for non-magical/non-tied scalars containing a
158string if it is a non-utf8 string or if C<use bytes;> is in scope.
5cfa0642 159
5b306eef
DD
160=item *
161
162Non-magical/non-tied scalars that contain only a floating point value and are
163on most Perl builds with 64 bit integers now use 8-32 less bytes of memory
164depending on OS.
165
357205d5
FC
166=item *
167
168In C<@array = split>, the assigment can be optimised away with C<split>
169writing directly to the array. This optimisation was happening only for
3a9cf875
FC
170package arrays other than @_ and only
171sometimes. Now this optimisation happens
357205d5
FC
172almost all the time.
173
f704f251
FC
174=item *
175
176C<join> is now subject to constant folding. Moreover, C<join> with a
177scalar or constant for the separator and a single-item list to join is
178simplified to a stringification. The separator doesn't even get evaluated.
179
0cb3abac
FC
180=item *
181
182C<qq(@array)> is implemented using two ops: a stringify op and a join op.
183If the qq contains nothing but a single array, the stringification is
184optimised away.
185
deec1830
FC
186=item *
187
188C<our $var> and C<our($s,@a,%h)> in void context are no longer evaluated at
189run time. Even a whole sequence of C<our $foo;> statements will simply be
190skipped over.
191
8c8d6154 192=back
d0ab07ee 193
8c8d6154 194=head1 Modules and Pragmata
d0ab07ee 195
8c8d6154
SH
196XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
197go here. If Module::CoreList is updated, generate an initial draft of the
198following sections using F<Porting/corelist-perldelta.pl>. A paragraph summary
199for important changes should then be added by hand. In an ideal world,
200dual-life modules would have a F<Changes> file that could be cribbed.
5cfa0642 201
8c8d6154 202[ Within each section, list entries as a =item entry ]
8435afd1 203
8c8d6154 204=head2 New Modules and Pragmata
8435afd1 205
8c8d6154 206=over 4
5cfa0642 207
8435afd1
SH
208=item *
209
8c8d6154 210XXX
5cfa0642 211
39c4a6cf 212=back
9c97a342 213
8c8d6154 214=head2 Updated Modules and Pragmata
d99849ae 215
39c4a6cf 216=over 4
d99849ae 217
ff433f2d
PM
218=item *
219
6fa0b0fd
TC
220L<attributes> has been upgraded from version 0.23 to 0.24.
221
222Avoid reading beyond the end of a buffer. [perl #122629]
223
224=item *
225
8883ce71
FC
226L<B::Concise> has been upgraded from version 0.993 to 0.994.
227
228Null ops that are part of the execution chain are now given sequence
229numbers.
230
231Private flags for nulled ops are now dumped with mnemonics as they would be
232for the non-nulled counterparts.
233
432450d2
FC
234L<B::Deparse> has been upgraded from version 1.28 to 1.29.
235
236Parenthesised arrays in lists passed to C<\> are now correctly deparsed
237with parentheses (e.g., C<\(@a, (@b), @c)> now retains the parentheses
238around @b), this preserving the flattening behaviour of referenced
239parenthesised arrays. Formerly, it only worked for one array: C<\(@a)>.
240
4e3e9c07
FC
241C<local our> is now deparsed correctly, with the C<our> included.
242
4a9fafe5
FC
243C<for($foo; !$bar; $baz) {...}> was deparsed without the C<!> (or C<not>).
244This has been fixed.
245
f03d0d50
FC
246Core keywords that conflict with lexical subroutines are now deparsed with
247the C<CORE::> prefix.
248
c3f18a8f
FC
249C<foreach state $x (...) {...}> now deparses correctly with C<state> and
250not C<my>.
251
852ef7e9
FC
252C<our @array = split(...)> now deparses correctly with C<our> in those
253cases where the assignment is optimised away.
254
432450d2
FC
255=item *
256
cbfcbc14
TC
257L<DynaLoader> has been upgraded from version 1.26 to 1.27.
258
259Remove dl_nonlazy global if unused in Dynaloader. [perl #122926]
260
261=item *
262
7635ad4d
TC
263L<Fcntl> has been upgraded from version 1.12 to 1.13.
264
265Add support for the Linux pipe buffer size fcntl() commands.
266
267=item *
268
f4eedc6b
DD
269L<File::Find> has been upgraded from version 1.28 to 1.29.
270
271Slightly faster module loading time.
272
273=item *
274
84d03adf
SH
275L<Module::CoreList> has been upgraded from version 5.20140920 to 5.20141020.
276
277Updated to cover the latest releases of Perl.
ff433f2d 278
4cd408ba
TC
279=item *
280
f4eedc6b
DD
281The PathTools module collection has been upgraded from version 3.50 to 3.51.
282
283Slightly faster module loading time.
284
285=item *
286
0561e60b
TC
287L<POSIX> has been upgraded from version 1.44 to 1.45.
288
289POSIX::tmpnam() now produces a deprecation warning. [perl #122005]
290
291=item *
292
4cd408ba
TC
293L<XSLoader> has been upgraded from version 0.17 to 0.18.
294
295Allow XSLoader to load modules from a different namespace.
296[perl #122455]
297
13900f93 298=back
aac7f82f 299
8c8d6154 300=head2 Removed Modules and Pragmata
aac7f82f 301
5cfa0642 302=over 4
6d9b7c7c 303
5cfa0642 304=item *
2a395b86 305
8c8d6154 306XXX
2a395b86 307
5cfa0642 308=back
2a395b86 309
8c8d6154 310=head1 Documentation
2a395b86 311
8c8d6154
SH
312XXX Changes to files in F<pod/> go here. Consider grouping entries by
313file and be sure to link to the appropriate page, e.g. L<perlfunc>.
5cfa0642 314
8c8d6154 315=head2 New Documentation
39c4a6cf 316
8c8d6154 317XXX Changes which create B<new> files in F<pod/> go here.
2a395b86 318
8c8d6154 319=head3 L<XXX>
2a395b86 320
8c8d6154 321XXX Description of the purpose of the new file here
2a395b86 322
8c8d6154 323=head2 Changes to Existing Documentation
8435afd1 324
8c8d6154
SH
325XXX Changes which significantly change existing files in F<pod/> go here.
326However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
327section.
8435afd1 328
8c8d6154 329=head3 L<XXX>
8435afd1
SH
330
331=over 4
2a395b86 332
12d22d1f
JK
333=item *
334
09e43397
KW
335Clarifications have been added to L<perlrecharclass/Character Ranges>
336to the effect that Perl guarantees that C<[A-Z]>, C<[a-z]>, C<[0-9]> and
337any subranges thereof in regular expression bracketed character classes
338are guaranteed to match exactly what a naive English speaker would
339expect them to match, even on platforms (such as EBCDIC) where special
340handling is required to accomplish this.
12d22d1f 341
2a395b86
PM
342=back
343
39c4a6cf 344=head1 Diagnostics
2a395b86 345
39c4a6cf
PM
346The following additions or changes have been made to diagnostic output,
347including warnings and fatal error messages. For the complete list of
348diagnostic messages, see L<perldiag>.
2a395b86 349
8c8d6154
SH
350XXX New or changed warnings emitted by the core's C<C> code go here. Also
351include any changes in L<perldiag> that reconcile it to the C<C> code.
2a395b86 352
8c8d6154 353=head2 New Diagnostics
2a395b86 354
8c8d6154
SH
355XXX Newly added diagnostic messages go under here, separated into New Errors
356and New Warnings
2a395b86 357
8c8d6154 358=head3 New Errors
5cfa0642 359
8c8d6154 360=over 4
2a395b86
PM
361
362=item *
363
bb8c7e27
A
364L<message|perldiag/"Cannot chr %f">
365
366=item *
367
368L<message|perldiag/"Cannot compress %f in pack">
369
370=item *
371
372L<message|perldiag/"Cannot pack %f with '%c'">
373
374=item *
375
376L<message|perldiag/"Cannot printf %f with '%c'">
2a395b86
PM
377
378=back
6d9b7c7c 379
8c8d6154 380=head3 New Warnings
39c4a6cf 381
13900f93 382=over 4
7f55cec0
SH
383
384=item *
385
8c8d6154 386XXX L<message|perldiag/"message">
623141a1 387
8c8d6154 388=back
aac7f82f 389
8c8d6154 390=head2 Changes to Existing Diagnostics
363d3025 391
8c8d6154 392XXX Changes (i.e. rewording) of diagnostic messages go here
334464b3 393
8c8d6154 394=over 4
334464b3
FC
395
396=item *
397
dbe3c929
FC
398'"my" variable &foo::bar can't be in a package' has been reworded to say
399'subroutine' instead of 'variable'.
ef5a9509 400
363d3025
FC
401=back
402
8c8d6154 403=head1 Utility Changes
4594cf53 404
8c8d6154
SH
405XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go here.
406Most of these are built within the directory F<utils>.
96dcbc37 407
8c8d6154
SH
408[ List utility changes as a =head2 entry for each utility and =item
409entries for each change
410Use L<XXX> with program names to get proper documentation linking. ]
96dcbc37 411
8c8d6154 412=head2 L<XXX>
13900f93 413
8c8d6154 414=over 4
58f25ac1
MH
415
416=item *
417
8c8d6154 418XXX
a5873648 419
39c4a6cf 420=back
a5873648 421
55ba8847
JH
422=head1 Configuration and Compilation
423
8c8d6154
SH
424XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
425go here. Any other changes to the Perl build process should be listed here.
426However, any platform-specific changes should be listed in the
427L</Platform Support> section, instead.
55ba8847 428
8c8d6154 429[ List changes as a =item entry ].
a5873648 430
39c4a6cf 431=over 4
a5873648
PM
432
433=item *
434
8c8d6154 435XXX
7d0ccdba 436
7065301c
RS
437=back
438
8c8d6154 439=head1 Testing
d72cd2eb 440
8c8d6154
SH
441XXX Any significant changes to the testing of a freshly built perl should be
442listed here. Changes which create B<new> files in F<t/> go here as do any
443large changes to the testing harness (e.g. when parallel testing was added).
444Changes to existing files in F<t/> aren't worth summarizing, although the bugs
445that they represent may be covered elsewhere.
c1284011 446
8c8d6154 447[ List each test improvement as a =item entry ]
375f5f06 448
0346c3a9 449=over 4
375f5f06 450
2884baee
MH
451=item *
452
bb8c7e27
A
453Some regular expression tests are written in such a way that they will
454run very slowly if certain optimizations break. These tests have been
455moved into new files, F<< t/re/speed.t >> and F<< t/re/speed_thr.t >>,
456and are run with a C<< watchdog() >>.
6f1a844b 457
8c8d6154 458=back
549ea8d4 459
8c8d6154 460=head1 Platform Support
549ea8d4 461
8c8d6154 462XXX Any changes to platform support should be listed in the sections below.
be0006e0 463
8c8d6154
SH
464[ Within the sections, list each platform as a =item entry with specific
465changes as paragraphs below it. ]
be0006e0 466
8c8d6154 467=head2 New Platforms
1699f5c2 468
8c8d6154
SH
469XXX List any platforms that this version of perl compiles on, that previous
470versions did not. These will either be enabled by new files in the F<hints/>
471directories, or new subdirectories and F<README> files at the top level of the
472source tree.
1699f5c2 473
8c8d6154 474=over 4
7e8b2071 475
8c8d6154 476=item XXX-some-platform
7e8b2071 477
8c8d6154 478XXX
f9acf899 479
8c8d6154 480=back
f9acf899 481
8c8d6154 482=head2 Discontinued Platforms
fd26b6f0 483
8c8d6154 484XXX List any platforms that this version of perl no longer compiles on.
fd26b6f0 485
8c8d6154 486=over 4
499333dc 487
8c8d6154 488=item XXX-some-platform
499333dc 489
8c8d6154 490XXX
8f0cd35a 491
8c8d6154 492=back
8f0cd35a 493
8c8d6154 494=head2 Platform-Specific Notes
aa292ef2 495
8c8d6154
SH
496XXX List any changes for specific platforms. This could include configuration
497and compilation changes or changes in portability/compatibility. However,
498changes within modules for platforms should generally be listed in the
499L</Modules and Pragmata> section.
aa292ef2 500
8c8d6154 501=over 4
739e9bee 502
09e43397 503=item EBCDIC
739e9bee 504
09e43397
KW
505Special handling is required on EBCDIC platforms to get C<qr/[i-j]/> to
506match only C<"i"> and C<"j">, since there are 7 characters between the
507code points for C<"i"> and C<"j">. This special handling had only been
508invoked when both ends of the range are literals. Now it is also
509invoked if any of the C<\N{...}> forms for specifying a character by
510name or Unicode code point is used instead of a literal. See
511L<perlrecharclass/Character Ranges>.
b23b2fdb 512
8c8d6154 513=back
b23b2fdb 514
8c8d6154 515=head1 Internal Changes
7d15b1a8 516
8c8d6154
SH
517XXX Changes which affect the interface available to C<XS> code go here. Other
518significant internal changes for future core maintainers should be noted as
519well.
7d15b1a8 520
8c8d6154 521[ List each change as a =item entry ]
bbca64cf 522
8c8d6154 523=over 4
bbca64cf 524
0064f8cc
KW
525=item *
526
13203cef
FC
527SVs of type SVt_NV are now bodyless when a build configure and platform allow
528it, specifically C<sizeof(NV) <= sizeof(IV)>. The bodyless trick is the same one
529as for IVs since 5.9.2, but for NVs, unlike IVs, is not guarenteed on all
530platforms and build configurations.
6ff8f256 531
1b4c7150
TC
532=item *
533
534The C<$DB::single>, C<$DB::signal> and C<$DB::trace> now have set and
535get magic that stores their values as IVs and those IVs are used when
536testing their values in C<pp_dbstate>. This prevents perl from
537recursing infinity if an overloaded object is assigned to any of those
538variables. [perl #122445]
539
a953aca5
DD
540=item *
541
542C<Perl_tmps_grow> which is marked as public API but undocumented has been
543removed from public API. If you use C<EXTEND_MORTAL> macro in your XS code to
544preextend the mortal stack, you are unaffected by this change.
545
8405c65d
FC
546=item *
547
548C<cv_name>, which was introduced in 5.21.4, has been changed incompatibly.
549It now has a flags field that allows the caller to specify whether the name
550should be fully qualified. See L<perlapi/cv_name>.
551
8e2708f3
FC
552=item *
553
554Internally Perl no longer uses the C<SVs_PADMY> flag. C<SvPADMY()> now
555returns a true value for anything not marked PADTMP. C<SVs_PADMY> is now
556defined as 0.
557
bb8c7e27
A
558=item *
559
560The macros SETsv and SETsvUN have been removed. They were no longer used
561in the core since commit 6f1401dc2a, and have not been found present on
562CPAN.
563
564=item *
565
566The C<< SvFAKE >> bit (unused on HVs) got informally reserved by
567David Mitchell for future work on vtables.
568
d712afe5 569=item *
28482d6c
FC
570The C<sv_catpvn_flags> function accepts C<SV_CATBYTES> and C<SV_CATUTF8>
571flags, which specify whether the appended string is bytes or utf8,
572respectively.
573
8c8d6154 574=back
6ff8f256 575
8c8d6154 576=head1 Selected Bug Fixes
80cc3290 577
8c8d6154
SH
578XXX Important bug fixes in the core language are summarized here. Bug fixes in
579files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
80cc3290 580
8c8d6154 581[ List each fix as a =item entry ]
13dd5671 582
8c8d6154 583=over 4
13dd5671 584
bdab7676
FC
585=item *
586
227d08c8
FC
587Locking and unlocking values via L<Hash::Util> or C<Internals::SvREADONLY>
588no longer has any affect on values that are read-only to begin. Unlocking
589such values could result in crashes, hangs or other erratic behaviour.
bdab7676 590
94959c63
FC
591=item *
592
593The internal C<looks_like_number> function (which L<Scalar::Util> provides
594access to) began erroneously to return true for "-e1" in 5.21.4, affecting
595also C<-'-e1'>. This has been fixed.
596
24d3d8cd
FC
597=item *
598
599The flip-flop operator (C<..> in scalar context) would return the same
b9de5fa2 600scalar each time, unless the containing subroutine was called recursively.
24d3d8cd
FC
601Now it always returns a new scalar. [perl #122829]
602
02dde543
FC
603=item *
604
605Some unterminated C<(?(...)...)> constructs in regular expressions would
606either crash or give erroneous error messages. C</(?(1)/> is one such
607example.
608
5058ae74
FC
609=item *
610
611C<pack "w", $tied> no longer calls FETCH twice.
612
14937635
FC
613=item *
614
615List assignments like C<($x, $z) = (1, $y)> now work correctly if $x and $y
616have been aliased by C<foreach>.
617
325f4225
FC
618=item *
619
620Some patterns including code blocks with syntax errors, such as
621C</ (?{(^{})/>, would hang or fail assertions on debugging builds. Now
622they produce errors.
623
c1662923
FC
624=item *
625
626An assertion failure when parsing C<sort> with debugging enabled has been
627fixed. [perl #122771]
628
7646b3d5
FC
629=item *
630
631C<*a = *b; @a = split //, $b[1]> could do a bad read and produce junk
632results.
633
db98db4e
FC
634=item *
635
636In C<() = @array = split>, the C<() => at the beginning no longer confuses
637the optimiser, making it assume a limit of 1.
638
8818afe8
TC
639=item *
640
641Fatal warnings no longer prevent the output of syntax errors.
642[perl #122966]
643
bb8c7e27
A
644=item *
645
646Fixed a NaN double to long double conversion error on VMS. For quiet NaNs
647(and only on Itanium, not Alpha) negative infinity instead of NaN was
648produced.
649
650=item *
651
652Fixed the issue that caused C<< make distclean >> to leave files behind
653that shouldn't. [perl #122820]
654
655=item *
656
657AIX now sets the length in C<< getsockopt >> correctly. [perl #120835],
658[rt #91183], [rt #85570].
659
8c8d6154 660=back
3a085d00 661
8c8d6154 662=head1 Known Problems
caa66803 663
8c8d6154
SH
664XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
665tests that had to be C<TODO>ed for the release would be noted here. Unfixed
666platform specific bugs also go here.
caa66803 667
8c8d6154 668[ List each fix as a =item entry ]
91766151 669
8c8d6154 670=over 4
91766151 671
dd593f1d
FC
672=item *
673
8c8d6154 674XXX
fb3b7425 675
8c8d6154 676=back
fb3b7425 677
8c8d6154 678=head1 Errata From Previous Releases
b245455d 679
8c8d6154 680=over 4
b245455d 681
26dd5fd6
PM
682=item *
683
8c8d6154
SH
684XXX Add anything here that we forgot to add, or were mistaken about, in
685the perldelta of a previous release.
ff433f2d 686
39c4a6cf
PM
687=back
688
8c8d6154 689=head1 Obituary
c0c55a9b 690
8c8d6154
SH
691XXX If any significant core contributor has died, we've added a short obituary
692here.
c0c55a9b 693
8c8d6154 694=head1 Acknowledgements
c0c55a9b 695
8c8d6154 696XXX Generate this with:
e831f11a 697
8c8d6154 698 perl Porting/acknowledgements.pl v5.21.4..HEAD
f5b73711 699
44691e6f
AB
700=head1 Reporting Bugs
701
e08634c5
SH
702If you find what you think is a bug, you might check the articles recently
703posted to the comp.lang.perl.misc newsgroup and the perl bug database at
238894db 704https://rt.perl.org/ . There may also be information at
7ef8b31d 705http://www.perl.org/ , the Perl Home Page.
44691e6f 706
e08634c5
SH
707If you believe you have an unreported bug, please run the L<perlbug> program
708included with your release. Be sure to trim your bug down to a tiny but
709sufficient test case. Your bug report, along with the output of C<perl -V>,
710will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
44691e6f
AB
711
712If the bug you are reporting has security implications, which make it
e08634c5
SH
713inappropriate to send to a publicly archived mailing list, then please send it
714to perl5-security-report@perl.org. This points to a closed subscription
715unarchived mailing list, which includes all the core committers, who will be
716able to help assess the impact of issues, figure out a resolution, and help
f9001595 717co-ordinate the release of patches to mitigate or fix the problem across all
e08634c5
SH
718platforms on which Perl is supported. Please only use this address for
719security issues in the Perl core, not for modules independently distributed on
720CPAN.
44691e6f
AB
721
722=head1 SEE ALSO
723
e08634c5
SH
724The F<Changes> file for an explanation of how to view exhaustive details on
725what changed.
44691e6f
AB
726
727The F<INSTALL> file for how to build Perl.
728
729The F<README> file for general stuff.
730
731The F<Artistic> and F<Copying> files for copyright information.
732
733=cut