This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
No need to list FindExt in perldelta - it isn't an installed module
[perl5.git] / pod / perldelta.pod
CommitLineData
44691e6f
AB
1=encoding utf8
2
3=head1 NAME
4
e5998677
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.11
c68523cb 9
238894db 10=head1 DESCRIPTION
c68523cb 11
e5998677 12This document describes differences between the 5.21.10 release and the 5.21.11
238894db 13release.
c68523cb 14
e5998677
SH
15If you are upgrading from an earlier release such as 5.21.9, first read
16L<perl52110delta>, which describes differences between 5.21.9 and 5.21.10.
2ec11c70 17
e5998677 18=head1 Notice
ef8784b7 19
e5998677 20XXX Any important notices here
6798c95d 21
e5998677 22=head1 Core Enhancements
6798c95d 23
e5998677
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.
cd7bac54 27
e5998677 28[ List each enhancement as a =head2 entry ]
cd7bac54 29
e5998677 30=head1 Security
0939a951 31
e5998677
SH
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.
cd7bac54 35
e5998677 36[ List each security issue as a =head2 entry ]
cd7bac54 37
e5998677 38=head1 Incompatible Changes
cd7bac54 39
e5998677 40XXX For a release on a stable branch, this section aspires to be:
83a5d6b6 41
e5998677
SH
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.
83a5d6b6 45
e5998677 46[ List each incompatible change as a =head2 entry ]
b9c683b3 47
e5998677 48=head1 Deprecations
b9c683b3 49
e5998677 50XXX Any deprecated features, syntax, modules etc. should be listed here.
b9c683b3 51
2e4abf26
DG
52=head2 Making all warnings fatal is discouraged
53
54The documentation for L<fatal warnings|warnings/Fatal Warnings> notes
55that C<< use warnings FATAL => 'all' >> is discouraged
56and provides stronger language about the risks of fatal warnings
57in general.
58
e5998677 59=head2 Module removals
b05565aa 60
e5998677 61XXX Remove this section if inapplicable.
b05565aa 62
e5998677
SH
63The following modules will be removed from the core distribution in a
64future release, and will at that time need to be installed from CPAN.
65Distributions on CPAN which require these modules will need to list them as
66prerequisites.
79116533 67
e5998677
SH
68The core versions of these modules will now issue C<"deprecated">-category
69warnings to alert you to this fact. To silence these deprecation warnings,
70install the modules in question from CPAN.
79116533 71
e5998677
SH
72Note that these are (with rare exceptions) fine modules that you are encouraged
73to continue to use. Their disinclusion from core primarily hinges on their
74necessity to bootstrapping a fully functional, CPAN-capable Perl installation,
75not usually on concerns over their design.
79116533 76
e5998677 77=over
79116533 78
e5998677 79=item XXX
79116533 80
e5998677
SH
81XXX Note that deprecated modules should be listed here even if they are listed
82as an updated module in the L</Modules and Pragmata> section.
79116533 83
e5998677 84=back
79116533 85
e5998677 86[ List each other deprecation as a =head2 entry ]
79116533 87
e5998677 88=head1 Performance Enhancements
79116533 89
e5998677
SH
90XXX Changes which enhance performance without changing behaviour go here.
91There may well be none in a stable release.
79116533 92
e5998677 93[ List each enhancement as a =item entry ]
79116533 94
e5998677 95=over 4
79116533
SH
96
97=item *
98
e5998677 99XXX
79116533
SH
100
101=back
0939a951 102
e5998677 103=head1 Modules and Pragmata
fea59588 104
e5998677
SH
105XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
106go here. If Module::CoreList is updated, generate an initial draft of the
107following sections using F<Porting/corelist-perldelta.pl>. A paragraph summary
108for important changes should then be added by hand. In an ideal world,
109dual-life modules would have a F<Changes> file that could be cribbed.
fea59588 110
e5998677 111[ Within each section, list entries as a =item entry ]
83a5d6b6 112
e5998677 113=head2 New Modules and Pragmata
83a5d6b6 114
e5998677 115=over 4
338906ce
SH
116
117=item *
118
e5998677 119XXX
b05565aa 120
e5998677 121=back
83a5d6b6 122
e5998677 123=head2 Updated Modules and Pragmata
83a5d6b6 124
e5998677 125=over 4
e455391f
SH
126
127=item *
128
79a77127 129L<attributes> has been upgraded from version 0.26 to 0.27.
53902397 130
79a77127
SH
131=item *
132
133L<Cwd> has been upgraded from version 3.55 to 3.56.
83a5d6b6 134
abec5bed
DIM
135=item *
136
137L<ExtUtils::Miniperl> has been upgraded from version 1.04 to 1.05.
138
139=item *
140
60dcce55
SH
141L<IO::Socket::IP> has been upgraded from version 0.36 to 0.37.
142
143=item *
144
79a77127
SH
145L<Module::CoreList> has been upgraded from version 5.20150320 to 5.20150420.
146
147Updated to cover the latest releases of Perl.
abec5bed
DIM
148
149=item *
150
151L<PerlIO::mmap> has been upgraded from version 0.013 to 0.014.
152
153=item *
154
79a77127 155L<utf8> has been upgraded from version 1.15 to 1.16.
abec5bed 156
2e4abf26
DG
157=item *
158
159L<warnings> has been upgraded from version 1.31 to 1.32.
160
e5998677 161=back
83a5d6b6 162
e5998677 163=head2 Removed Modules and Pragmata
83a5d6b6 164
e5998677 165=over 4
83a5d6b6
SH
166
167=item *
168
e5998677 169XXX
83a5d6b6 170
e5998677 171=back
83a5d6b6 172
e5998677 173=head1 Documentation
83a5d6b6 174
e5998677
SH
175XXX Changes to files in F<pod/> go here. Consider grouping entries by
176file and be sure to link to the appropriate page, e.g. L<perlfunc>.
83a5d6b6 177
e5998677 178=head2 New Documentation
b367c45d 179
e5998677 180XXX Changes which create B<new> files in F<pod/> go here.
b367c45d 181
e5998677 182=head3 L<XXX>
b367c45d 183
e5998677 184XXX Description of the purpose of the new file here
338906ce 185
e5998677 186=head2 Changes to Existing Documentation
338906ce 187
e5998677
SH
188XXX Changes which significantly change existing files in F<pod/> go here.
189However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
190section.
83a5d6b6 191
e5998677 192=head3 L<XXX>
83a5d6b6 193
e5998677 194=over 4
83a5d6b6
SH
195
196=item *
197
e5998677 198XXX Description of the change here
83a5d6b6 199
e5998677 200=back
338906ce 201
e5998677 202=head1 Diagnostics
338906ce 203
e5998677
SH
204The following additions or changes have been made to diagnostic output,
205including warnings and fatal error messages. For the complete list of
206diagnostic messages, see L<perldiag>.
338906ce 207
e5998677
SH
208XXX New or changed warnings emitted by the core's C<C> code go here. Also
209include any changes in L<perldiag> that reconcile it to the C<C> code.
338906ce 210
e5998677 211=head2 New Diagnostics
9409f752 212
e5998677
SH
213XXX Newly added diagnostic messages go under here, separated into New Errors
214and New Warnings
9409f752 215
e5998677 216=head3 New Errors
03a97c81 217
e5998677 218=over 4
03a97c81
SH
219
220=item *
221
e5998677 222XXX L<message|perldiag/"message">
a790e348 223
e5998677 224=back
83a5d6b6 225
e5998677 226=head3 New Warnings
83a5d6b6 227
e5998677 228=over 4
126be117
JH
229
230=item *
231
e5998677 232XXX L<message|perldiag/"message">
83a5d6b6 233
a9c3e753 234=back
0939a951 235
e5998677 236=head2 Changes to Existing Diagnostics
d2fff9f6 237
e5998677 238XXX Changes (i.e. rewording) of diagnostic messages go here
e329daf3 239
cd7bac54 240=over 4
e329daf3 241
cd7bac54 242=item *
e329daf3 243
e5998677 244XXX Describe change here
83a5d6b6
SH
245
246=back
247
e5998677 248=head1 Utility Changes
83a5d6b6 249
e5998677
SH
250XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go here.
251Most of these are built within the directory F<utils>.
83a5d6b6 252
e5998677
SH
253[ List utility changes as a =head2 entry for each utility and =item
254entries for each change
255Use L<XXX> with program names to get proper documentation linking. ]
83a5d6b6 256
e5998677 257=head2 L<XXX>
83a5d6b6
SH
258
259=over 4
260
261=item *
262
e5998677 263XXX
ba31029d 264
cd7bac54
S
265=back
266
e5998677 267=head1 Configuration and Compilation
cd7bac54 268
e5998677
SH
269XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
270go here. Any other changes to the Perl build process should be listed here.
271However, any platform-specific changes should be listed in the
272L</Platform Support> section, instead.
cd7bac54 273
e5998677 274[ List changes as a =item entry ].
cd7bac54
S
275
276=over 4
277
278=item *
279
e5998677 280XXX
cd7bac54
S
281
282=back
541e1e0d 283
a9c3e753 284=head1 Testing
cd7bac54 285
e5998677
SH
286XXX Any significant changes to the testing of a freshly built perl should be
287listed here. Changes which create B<new> files in F<t/> go here as do any
288large changes to the testing harness (e.g. when parallel testing was added).
289Changes to existing files in F<t/> aren't worth summarizing, although the bugs
290that they represent may be covered elsewhere.
291
292[ List each test improvement as a =item entry ]
293
b5d4d3b9 294=over 4
83b69bfd
DD
295
296=item *
297
e5998677 298XXX
13adb056 299
b5d4d3b9 300=back
391823f2 301
a9c3e753 302=head1 Platform Support
6c8457e9 303
e5998677 304XXX Any changes to platform support should be listed in the sections below.
fdcaecb7 305
e5998677
SH
306[ Within the sections, list each platform as a =item entry with specific
307changes as paragraphs below it. ]
ce1e892e 308
e5998677 309=head2 New Platforms
2af7c6b6 310
e5998677
SH
311XXX List any platforms that this version of perl compiles on, that previous
312versions did not. These will either be enabled by new files in the F<hints/>
313directories, or new subdirectories and F<README> files at the top level of the
314source tree.
8c847e66 315
2ff1ebfe 316=over 4
d345f487 317
e5998677 318=item XXX-some-platform
d345f487 319
e5998677 320XXX
cd7bac54 321
4dc623f0 322=back
353075a0 323
e5998677 324=head2 Discontinued Platforms
9f122eef 325
e5998677 326XXX List any platforms that this version of perl no longer compiles on.
2ec11c70 327
e5998677 328=over 4
2ec11c70 329
e5998677 330=item XXX-some-platform
2683609f 331
e5998677 332XXX
338906ce 333
4dc623f0 334=back
c7f058f0 335
e5998677 336=head2 Platform-Specific Notes
2bf83140 337
e5998677
SH
338XXX List any changes for specific platforms. This could include configuration
339and compilation changes or changes in portability/compatibility. However,
340changes within modules for platforms should generally be listed in the
341L</Modules and Pragmata> section.
041a5927 342
e5998677 343=over 4
041a5927 344
e5998677 345=item XXX-some-platform
69e954a5 346
e5998677 347XXX
69e954a5 348
e5998677 349=back
20b5e916 350
e5998677 351=head1 Internal Changes
d76c14eb 352
e5998677
SH
353XXX Changes which affect the interface available to C<XS> code go here. Other
354significant internal changes for future core maintainers should be noted as
355well.
d76c14eb 356
e5998677 357[ List each change as a =item entry ]
d547bad0 358
e5998677 359=over 4
d547bad0 360
8a95d307
FC
361=item *
362
e5998677 363XXX
8a95d307 364
e5998677 365=back
338906ce 366
e5998677 367=head1 Selected Bug Fixes
338906ce 368
e5998677
SH
369XXX Important bug fixes in the core language are summarized here. Bug fixes in
370files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
338906ce 371
e5998677 372[ List each fix as a =item entry ]
338906ce 373
e5998677 374=over 4
338906ce
SH
375
376=item *
377
e5998677 378XXX
2f304be9 379
a9c3e753 380=back
ea13b07e 381
a9c3e753 382=head1 Known Problems
b65adbec 383
e5998677
SH
384XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
385tests that had to be C<TODO>ed for the release would be noted here. Unfixed
386platform specific bugs also go here.
b94c7836 387
e5998677 388[ List each fix as a =item entry ]
ce1e892e
KW
389
390=over 4
391
392=item *
393
e5998677 394XXX
ce1e892e 395
e5998677 396=back
ce1e892e 397
e5998677 398=head1 Errata From Previous Releases
ce1e892e 399
e5998677 400=over 4
ce1e892e 401
e5998677 402=item *
ce1e892e 403
e5998677
SH
404XXX Add anything here that we forgot to add, or were mistaken about, in
405the perldelta of a previous release.
ce1e892e 406
a9c3e753 407=back
e3e8f263 408
e5998677 409=head1 Obituary
0d42058e 410
e5998677
SH
411XXX If any significant core contributor has died, we've added a short obituary
412here.
0d42058e 413
e5998677 414=head1 Acknowledgements
0d42058e 415
e5998677 416XXX Generate this with:
0d42058e 417
e5998677 418 perl Porting/acknowledgements.pl v5.21.10..HEAD
f5b73711 419
44691e6f
AB
420=head1 Reporting Bugs
421
e08634c5
SH
422If you find what you think is a bug, you might check the articles recently
423posted to the comp.lang.perl.misc newsgroup and the perl bug database at
e5998677
SH
424https://rt.perl.org/ . There may also be information at
425http://www.perl.org/ , the Perl Home Page.
44691e6f 426
e08634c5
SH
427If you believe you have an unreported bug, please run the L<perlbug> program
428included with your release. Be sure to trim your bug down to a tiny but
429sufficient test case. Your bug report, along with the output of C<perl -V>,
430will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
44691e6f
AB
431
432If the bug you are reporting has security implications, which make it
e08634c5
SH
433inappropriate to send to a publicly archived mailing list, then please send it
434to perl5-security-report@perl.org. This points to a closed subscription
435unarchived mailing list, which includes all the core committers, who will be
436able to help assess the impact of issues, figure out a resolution, and help
f9001595 437co-ordinate the release of patches to mitigate or fix the problem across all
e08634c5
SH
438platforms on which Perl is supported. Please only use this address for
439security issues in the Perl core, not for modules independently distributed on
440CPAN.
44691e6f
AB
441
442=head1 SEE ALSO
443
e08634c5
SH
444The F<Changes> file for an explanation of how to view exhaustive details on
445what changed.
44691e6f
AB
446
447The F<INSTALL> file for how to build Perl.
448
449The F<README> file for general stuff.
450
451The F<Artistic> and F<Copying> files for copyright information.
452
453=cut