This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Add perldelta entry for ExtUtils::Manifest upgrade.
[perl5.git] / pod / perldelta.pod
CommitLineData
44691e6f
AB
1=encoding utf8
2
3=head1 NAME
4
39c4a6cf
PM
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.4
c68523cb 9
238894db 10=head1 DESCRIPTION
c68523cb 11
39c4a6cf 12This document describes differences between the 5.21.3 release and the 5.21.4
238894db 13release.
c68523cb 14
39c4a6cf
PM
15If you are upgrading from an earlier release such as 5.21.2, first read
16L<perl5213delta>, which describes differences between 5.21.2 and 5.21.3.
7065301c 17
39c4a6cf 18=head1 Notice
7e957246 19
39c4a6cf 20XXX Any important notices here
7e957246 21
39c4a6cf 22=head1 Core Enhancements
f88f10f5 23
39c4a6cf
PM
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.
21f3b41e 27
39c4a6cf 28[ List each enhancement as a =head2 entry ]
f88f10f5 29
0346c3a9 30=head1 Security
7e957246 31
39c4a6cf
PM
32XXX Any security-related notices go here. In particular, any security
33vulnerabilities closed should be noted here rather than in the
34L</Selected Bug Fixes> section.
13900f93 35
39c4a6cf 36[ List each security issue as a =head2 entry ]
8bdb3f93 37
13900f93 38=head1 Incompatible Changes
8bdb3f93 39
39c4a6cf 40XXX For a release on a stable branch, this section aspires to be:
1178d2cf 41
39c4a6cf
PM
42 There are no changes intentionally incompatible with 5.XXX.XXX
43 If any exist, they are bugs, and we request that you submit a
44 report. See L</Reporting Bugs> below.
1178d2cf 45
39c4a6cf 46[ List each incompatible change as a =head2 entry ]
f6f3144e 47
39c4a6cf 48=head1 Deprecations
7065301c 49
39c4a6cf 50XXX Any deprecated features, syntax, modules etc. should be listed here.
7065301c 51
39c4a6cf 52=head2 Module removals
b3e82ed1 53
39c4a6cf 54XXX Remove this section if inapplicable.
ca58223b 55
39c4a6cf
PM
56The following modules will be removed from the core distribution in a
57future release, and will at that time need to be installed from CPAN.
58Distributions on CPAN which require these modules will need to list them as
59prerequisites.
ca58223b 60
39c4a6cf
PM
61The core versions of these modules will now issue C<"deprecated">-category
62warnings to alert you to this fact. To silence these deprecation warnings,
63install the modules in question from CPAN.
23b03637 64
39c4a6cf
PM
65Note that these are (with rare exceptions) fine modules that you are encouraged
66to continue to use. Their disinclusion from core primarily hinges on their
67necessity to bootstrapping a fully functional, CPAN-capable Perl installation,
68not usually on concerns over their design.
23b03637 69
39c4a6cf 70=over
85e8fb10 71
39c4a6cf 72=item XXX
85e8fb10 73
39c4a6cf
PM
74XXX Note that deprecated modules should be listed here even if they are listed
75as an updated module in the L</Modules and Pragmata> section.
134f90c2 76
39c4a6cf 77=back
134f90c2 78
39c4a6cf 79[ List each other deprecation as a =head2 entry ]
ff433f2d 80
39c4a6cf 81=head1 Performance Enhancements
ff433f2d 82
39c4a6cf
PM
83XXX Changes which enhance performance without changing behaviour go here.
84There may well be none in a stable release.
134f90c2 85
39c4a6cf 86[ List each enhancement as a =item entry ]
134f90c2 87
39c4a6cf 88=over 4
7d19f6a1 89
7d19f6a1
PM
90=item *
91
39c4a6cf 92XXX
55e8b286 93
39c4a6cf 94=back
55e8b286 95
39c4a6cf 96=head1 Modules and Pragmata
d99849ae 97
39c4a6cf
PM
98XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
99go here. If Module::CoreList is updated, generate an initial draft of the
100following sections using F<Porting/corelist-perldelta.pl>. A paragraph summary
101for important changes should then be added by hand. In an ideal world,
102dual-life modules would have a F<Changes> file that could be cribbed.
d99849ae 103
39c4a6cf 104[ Within each section, list entries as a =item entry ]
ff433f2d 105
39c4a6cf 106=head2 New Modules and Pragmata
ff433f2d 107
39c4a6cf 108=over 4
ff433f2d
PM
109
110=item *
111
39c4a6cf 112XXX
0bb39c26 113
39c4a6cf 114=back
0bb39c26 115
39c4a6cf 116=head2 Updated Modules and Pragmata
9c97a342 117
39c4a6cf 118=over 4
d99849ae
PM
119
120=item *
121
39c4a6cf 122L<XXX> has been upgraded from version A.xx to B.yy.
6ab3666b 123
233a4069
JK
124=item *
125
126L<File::Find> has been upgraded from version 1.27 to 1.28.
39091b75 127
233a4069
JK
128C<find()> and C<finddepth()> will now warn if passed inappropriate or
129misspelled options.
130
d0ab07ee
JK
131=item *
132
133L<B::Concise> has been upgraded from version 0.992 to 0.993.
134
135=item *
136
39091b75
JK
137L<ExtUtils::Manifest> has been upgraded from version 1.65 to 1.66.
138[perl #122415].
139
140=item *
141
d0ab07ee
JK
142L<HTTP::Tiny> has been upgraded from version 0.047 to 0.048.
143
144=item *
145
146L<Module::CoreList> has been upgraded from version 5.021003 to 5.021004.
147
148=item *
149
150L<POSIX> has been upgraded from version 1.42 to 1.43.
151
152=item *
153
154L<Pod::Perldoc> has been upgraded from version 3.23 to 3.24.
155
156=item *
157
158L<constant> has been upgraded from version 1.31 to 1.32.
159
bfc60ea2
FC
160It now accepts fully-qualified constant names, allowing constants to be
161defined in packages other than the caller.
162
d0ab07ee
JK
163=item *
164
165L<threads> has been upgraded from version 1.95 to 1.96.
166
39c4a6cf 167=back
9c97a342 168
39c4a6cf 169=head2 Removed Modules and Pragmata
d99849ae 170
39c4a6cf 171=over 4
d99849ae 172
ff433f2d
PM
173=item *
174
39c4a6cf 175XXX
ff433f2d 176
13900f93 177=back
aac7f82f 178
13900f93 179=head1 Documentation
aac7f82f 180
39c4a6cf
PM
181XXX Changes to files in F<pod/> go here. Consider grouping entries by
182file and be sure to link to the appropriate page, e.g. L<perlfunc>.
6d9b7c7c 183
39c4a6cf 184=head2 New Documentation
2a395b86 185
39c4a6cf 186XXX Changes which create B<new> files in F<pod/> go here.
2a395b86 187
39c4a6cf 188=head3 L<XXX>
2a395b86 189
39c4a6cf 190XXX Description of the purpose of the new file here
2a395b86 191
39c4a6cf 192=head2 Changes to Existing Documentation
2a395b86 193
39c4a6cf
PM
194XXX Changes which significantly change existing files in F<pod/> go here.
195However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
196section.
197
198=head3 L<XXX>
2a395b86
PM
199
200=over 4
201
202=item *
203
39c4a6cf 204XXX Description of the change here
2a395b86
PM
205
206=back
207
39c4a6cf 208=head1 Diagnostics
2a395b86 209
39c4a6cf
PM
210The following additions or changes have been made to diagnostic output,
211including warnings and fatal error messages. For the complete list of
212diagnostic messages, see L<perldiag>.
2a395b86 213
39c4a6cf
PM
214XXX New or changed warnings emitted by the core's C<C> code go here. Also
215include any changes in L<perldiag> that reconcile it to the C<C> code.
2a395b86 216
39c4a6cf 217=head2 New Diagnostics
0f4a583b 218
39c4a6cf
PM
219XXX Newly added diagnostic messages go under here, separated into New Errors
220and New Warnings
2a395b86 221
39c4a6cf 222=head3 New Errors
2a395b86
PM
223
224=over 4
225
226=item *
227
39c4a6cf 228XXX L<message|perldiag/"message">
2a395b86
PM
229
230=back
231
39c4a6cf 232=head3 New Warnings
2a395b86
PM
233
234=over 4
235
236=item *
237
39c4a6cf 238XXX L<message|perldiag/"message">
2a395b86
PM
239
240=back
6d9b7c7c 241
39c4a6cf
PM
242=head2 Changes to Existing Diagnostics
243
244XXX Changes (i.e. rewording) of diagnostic messages go here
7f55cec0 245
13900f93 246=over 4
7f55cec0
SH
247
248=item *
249
39c4a6cf 250XXX Describe change here
aac7f82f 251
13900f93 252=back
aac7f82f 253
39c4a6cf 254=head1 Utility Changes
091fed7c 255
39c4a6cf
PM
256XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go here.
257Most of these are built within the directory F<utils>.
902c1f75 258
39c4a6cf
PM
259[ List utility changes as a =head2 entry for each utility and =item
260entries for each change
261Use L<XXX> with program names to get proper documentation linking. ]
2901561d 262
39c4a6cf 263=head2 L<XXX>
4594cf53 264
13900f93 265=over 4
96dcbc37
DD
266
267=item *
268
39c4a6cf 269XXX
a1d26ccd 270
39c4a6cf 271=back
a1d26ccd 272
39c4a6cf 273=head1 Configuration and Compilation
7065301c 274
39c4a6cf
PM
275XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
276go here. Any other changes to the Perl build process should be listed here.
277However, any platform-specific changes should be listed in the
278L</Platform Support> section, instead.
58f25ac1 279
39c4a6cf 280[ List changes as a =item entry ].
13900f93
A
281
282=over 4
58f25ac1
MH
283
284=item *
285
39c4a6cf 286XXX
a5873648 287
39c4a6cf 288=back
a5873648 289
39c4a6cf 290=head1 Testing
a5873648 291
39c4a6cf
PM
292XXX Any significant changes to the testing of a freshly built perl should be
293listed here. Changes which create B<new> files in F<t/> go here as do any
294large changes to the testing harness (e.g. when parallel testing was added).
295Changes to existing files in F<t/> aren't worth summarizing, although the bugs
296that they represent may be covered elsewhere.
a5873648 297
39c4a6cf 298[ List each test improvement as a =item entry ]
a5873648 299
39c4a6cf 300=over 4
a5873648
PM
301
302=item *
303
39c4a6cf 304XXX
a5873648 305
58f25ac1
MH
306=back
307
39c4a6cf 308=head1 Platform Support
b10906fb 309
39c4a6cf 310XXX Any changes to platform support should be listed in the sections below.
b10906fb 311
39c4a6cf
PM
312[ Within the sections, list each platform as a =item entry with specific
313changes as paragraphs below it. ]
b10906fb 314
39c4a6cf 315=head2 New Platforms
b10906fb 316
39c4a6cf
PM
317XXX List any platforms that this version of perl compiles on, that previous
318versions did not. These will either be enabled by new files in the F<hints/>
319directories, or new subdirectories and F<README> files at the top level of the
320source tree.
13900f93 321
7065301c 322=over 4
24a38d90 323
39c4a6cf 324=item XXX-some-platform
24a38d90 325
39c4a6cf 326XXX
bb076206 327
7065301c
RS
328=back
329
39c4a6cf 330=head2 Discontinued Platforms
097675bf 331
39c4a6cf 332XXX List any platforms that this version of perl no longer compiles on.
b3211734 333
6e97d65d 334=over 4
b3211734 335
39c4a6cf 336=item XXX-some-platform
7065301c 337
39c4a6cf 338XXX
13900f93 339
39c4a6cf 340=back
7d0ccdba 341
39c4a6cf 342=head2 Platform-Specific Notes
7d0ccdba 343
39c4a6cf
PM
344XXX List any changes for specific platforms. This could include configuration
345and compilation changes or changes in portability/compatibility. However,
346changes within modules for platforms should generally be listed in the
347L</Modules and Pragmata> section.
6e97d65d 348
39c4a6cf 349=over 4
6e97d65d 350
39c4a6cf 351=item XXX-some-platform
6e97d65d 352
39c4a6cf 353XXX
7d0ccdba 354
7065301c
RS
355=back
356
357=head1 Internal Changes
358
39c4a6cf
PM
359XXX Changes which affect the interface available to C<XS> code go here. Other
360significant internal changes for future core maintainers should be noted as
361well.
c9fcb674 362
39c4a6cf 363[ List each change as a =item entry ]
a835cd47 364
39c4a6cf 365=over 4
c1284011 366
1c43698b
PM
367=item *
368
07ec6dc6
FC
369The parser no longer gets confused by C<\U=> within a double-quoted string.
370It used to roduce a syntax error, but now compile it correctly.
371[perl #80368]
1c43698b 372
6d9b7c7c 373=back
c1284011 374
6d9b7c7c 375=head1 Selected Bug Fixes
375f5f06 376
39c4a6cf
PM
377XXX Important bug fixes in the core language are summarized here. Bug fixes in
378files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
379
380[ List each fix as a =item entry ]
381
0346c3a9 382=over 4
375f5f06 383
2884baee
MH
384=item *
385
39c4a6cf 386XXX
2884baee 387
0aa1826c
FC
388=item *
389
390Compile-time checking of constant dereferencing (e.g.,
391C<< my_constant->() >>) has been removed, since it was not taking
392overloading into account. [perl #69456] [perl #122607]
393
6f1a844b
FC
394=item *
395
396Constant dereferencing now works correctly for typeglob constants.
397Previously the glob was stringified and its name looked up. Now the glob
398itself is used. [perl #69456]
399
549ea8d4
FC
400=item *
401
402When parsing a funny character ($ @ % &) followed by braces, the parser no
403longer tries to guess whether it is a block or a hash constructor (causing
404a syntax error when it guesses the latter), since it can only be a block.
405
be0006e0
FC
406=item *
407
408C<undef $reference> now frees the referent immediately, instead of hanging
409on to it until the next statement. [perl #122556]
410
1699f5c2
FC
411=item *
412
413Various cases where the name of a sub is used (autoload, overloading, error
414messages) used to crash for lexical subs, but have been fixed.
415
7e8b2071
FC
416=item *
417
418Bareword lookup now tries to avoid vivifying packages if it turns out the
419bareword is not going to be a subroutine name.
420
39c4a6cf 421=back
b756670b 422
39c4a6cf 423=head1 Known Problems
b756670b 424
39c4a6cf
PM
425XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
426tests that had to be C<TODO>ed for the release would be noted here. Unfixed
427platform specific bugs also go here.
e917e94e 428
39c4a6cf
PM
429[ List each fix as a =item entry ]
430
431=over 4
e917e94e 432
26dd5fd6
PM
433=item *
434
39c4a6cf 435XXX
26dd5fd6 436
13900f93
A
437=back
438
39c4a6cf 439=head1 Errata From Previous Releases
e831f11a 440
39c4a6cf
PM
441=over 4
442
443=item *
ff433f2d 444
39c4a6cf
PM
445XXX Add anything here that we forgot to add, or were mistaken about, in
446the perldelta of a previous release.
ff433f2d 447
39c4a6cf
PM
448=back
449
450=head1 Obituary
ff433f2d 451
39c4a6cf
PM
452XXX If any significant core contributor has died, we've added a short obituary
453here.
ff433f2d 454
39c4a6cf 455=head1 Acknowledgements
ff433f2d 456
39c4a6cf 457XXX Generate this with:
e831f11a 458
39c4a6cf 459 perl Porting/acknowledgements.pl v5.21.3..HEAD
f5b73711 460
44691e6f
AB
461=head1 Reporting Bugs
462
e08634c5
SH
463If you find what you think is a bug, you might check the articles recently
464posted to the comp.lang.perl.misc newsgroup and the perl bug database at
238894db 465https://rt.perl.org/ . There may also be information at
7ef8b31d 466http://www.perl.org/ , the Perl Home Page.
44691e6f 467
e08634c5
SH
468If you believe you have an unreported bug, please run the L<perlbug> program
469included with your release. Be sure to trim your bug down to a tiny but
470sufficient test case. Your bug report, along with the output of C<perl -V>,
471will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
44691e6f
AB
472
473If the bug you are reporting has security implications, which make it
e08634c5
SH
474inappropriate to send to a publicly archived mailing list, then please send it
475to perl5-security-report@perl.org. This points to a closed subscription
476unarchived mailing list, which includes all the core committers, who will be
477able to help assess the impact of issues, figure out a resolution, and help
f9001595 478co-ordinate the release of patches to mitigate or fix the problem across all
e08634c5
SH
479platforms on which Perl is supported. Please only use this address for
480security issues in the Perl core, not for modules independently distributed on
481CPAN.
44691e6f
AB
482
483=head1 SEE ALSO
484
e08634c5
SH
485The F<Changes> file for an explanation of how to view exhaustive details on
486what changed.
44691e6f
AB
487
488The F<INSTALL> file for how to build Perl.
489
490The F<README> file for general stuff.
491
492The F<Artistic> and F<Copying> files for copyright information.
493
494=cut