This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Upgrade Filter-Util-Call from version 1.54 to 1.55
[perl5.git] / pod / perldelta.pod
CommitLineData
44691e6f
AB
1=encoding utf8
2
3=head1 NAME
4
cf73ceda
MH
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.23.2
eabfc7bc 9
2cfe9b50 10=head1 DESCRIPTION
eabfc7bc 11
cf73ceda 12This document describes differences between the 5.23.1 release and the 5.23.2
2cfe9b50 13release.
eabfc7bc 14
cf73ceda
MH
15If you are upgrading from an earlier release such as 5.23.0, first read
16L<perl5231delta>, which describes differences between 5.23.0 and 5.23.1.
17
18=head1 Notice
19
20XXX Any important notices here
fc4c3cec 21
2cfe9b50 22=head1 Core Enhancements
eabfc7bc 23
cf73ceda
MH
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.
deaaea8c 27
cf73ceda 28[ List each enhancement as a =head2 entry ]
deaaea8c 29
cf73ceda 30=head1 Security
deaaea8c 31
cf73ceda
MH
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.
deaaea8c 35
cf73ceda 36[ List each security issue as a =head2 entry ]
deaaea8c 37
cf73ceda 38=head1 Incompatible Changes
deaaea8c 39
cf73ceda 40XXX For a release on a stable branch, this section aspires to be:
fb7e9cdd 41
cf73ceda
MH
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.
fb7e9cdd 45
cf73ceda 46[ List each incompatible change as a =head2 entry ]
deaaea8c 47
cf73ceda 48=head1 Deprecations
7d380357 49
cf73ceda 50XXX Any deprecated features, syntax, modules etc. should be listed here.
7d380357 51
cf73ceda 52=head2 Module removals
0d610ac1 53
cf73ceda 54XXX Remove this section if inapplicable.
0d610ac1 55
cf73ceda
MH
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.
eabfc7bc 60
cf73ceda
MH
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.
26230909 64
cf73ceda
MH
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.
fc4c3cec 69
cf73ceda
MH
70=over
71
72=item XXX
73
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.
76
77=back
78
79[ List each other deprecation as a =head2 entry ]
80
81=head1 Performance Enhancements
82
83XXX Changes which enhance performance without changing behaviour go here.
84There may well be none in a stable release.
85
86[ List each enhancement as a =item entry ]
fc4c3cec 87
f282dc56 88=over 4
fc4c3cec 89
f282dc56 90=item *
fc4c3cec 91
cf73ceda 92XXX
fc4c3cec 93
cf73ceda 94=back
fc4c3cec 95
cf73ceda 96=head1 Modules and Pragmata
fc4c3cec 97
cf73ceda
MH
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.
fc4c3cec 103
cf73ceda 104[ Within each section, list entries as a =item entry ]
fc4c3cec 105
cf73ceda 106=head2 New Modules and Pragmata
fc4c3cec 107
cf73ceda 108=over 4
eabfc7bc 109
f282dc56 110=item *
eabfc7bc 111
cf73ceda 112XXX
eabfc7bc 113
cf73ceda 114=back
eabfc7bc 115
cf73ceda
MH
116=head2 Updated Modules and Pragmata
117
118=over 4
eabfc7bc 119
73d6481e 120=item *
eabfc7bc 121
0dd5b0dc
SH
122L<Encode> has been upgraded from version 2.75 to 2.76.
123
124=item *
125
356231b0
SH
126L<Filter::Util::Call> has been upgraded from version 1.54 to 1.55.
127
128=item *
129
a2373b32
TC
130The PathTools module collection has been upgraded from version 3.55 to
1313.56.
132
133Minor optimizations. [perl #125712]
eabfc7bc 134
cf73ceda
MH
135=back
136
137=head2 Removed Modules and Pragmata
eabfc7bc 138
cf73ceda 139=over 4
eabfc7bc
RS
140
141=item *
142
cf73ceda 143XXX
dc013420 144
cf73ceda 145=back
dc013420 146
cf73ceda 147=head1 Documentation
c85f23b2 148
cf73ceda
MH
149XXX Changes to files in F<pod/> go here. Consider grouping entries by
150file and be sure to link to the appropriate page, e.g. L<perlfunc>.
eabfc7bc 151
cf73ceda 152=head2 New Documentation
6962a25d 153
cf73ceda 154XXX Changes which create B<new> files in F<pod/> go here.
f282dc56 155
cf73ceda 156=head3 L<XXX>
f282dc56 157
cf73ceda 158XXX Description of the purpose of the new file here
f282dc56 159
cf73ceda 160=head2 Changes to Existing Documentation
f282dc56 161
cf73ceda
MH
162XXX Changes which significantly change existing files in F<pod/> go here.
163However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
164section.
f282dc56 165
cf73ceda 166=head3 L<XXX>
f282dc56 167
cf73ceda 168=over 4
f282dc56
MH
169
170=item *
171
cf73ceda
MH
172XXX Description of the change here
173
174=back
175
176=head1 Diagnostics
177
178The following additions or changes have been made to diagnostic output,
179including warnings and fatal error messages. For the complete list of
180diagnostic messages, see L<perldiag>.
181
182XXX New or changed warnings emitted by the core's C<C> code go here. Also
183include any changes in L<perldiag> that reconcile it to the C<C> code.
184
185=head2 New Diagnostics
186
187XXX Newly added diagnostic messages go under here, separated into New Errors
188and New Warnings
189
190=head3 New Errors
191
192=over 4
f282dc56
MH
193
194=item *
195
cf73ceda
MH
196XXX L<message|perldiag/"message">
197
198=back
199
200=head3 New Warnings
201
202=over 4
f282dc56
MH
203
204=item *
205
cf73ceda
MH
206XXX L<message|perldiag/"message">
207
208=back
209
210=head2 Changes to Existing Diagnostics
211
212XXX Changes (i.e. rewording) of diagnostic messages go here
213
214=over 4
6962a25d 215
0b8e4842
SH
216=item *
217
cf73ceda
MH
218XXX Describe change here
219
220=back
221
222=head1 Utility Changes
223
224XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go here.
225Most of these are built within the directory F<utils>.
226
227[ List utility changes as a =head2 entry for each utility and =item
228entries for each change
229Use L<XXX> with program names to get proper documentation linking. ]
230
231=head2 L<XXX>
232
233=over 4
0b8e4842 234
f282dc56 235=item *
eabfc7bc 236
cf73ceda
MH
237XXX
238
239=back
240
241=head1 Configuration and Compilation
242
243XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
244go here. Any other changes to the Perl build process should be listed here.
245However, any platform-specific changes should be listed in the
246L</Platform Support> section, instead.
247
248[ List changes as a =item entry ].
249
250=over 4
374c951f
SH
251
252=item *
253
cf73ceda 254XXX
e586de20 255
fc4c3cec 256=back
e586de20 257
cf73ceda 258=head1 Testing
b7b593d8 259
cf73ceda
MH
260XXX Any significant changes to the testing of a freshly built perl should be
261listed here. Changes which create B<new> files in F<t/> go here as do any
262large changes to the testing harness (e.g. when parallel testing was added).
263Changes to existing files in F<t/> aren't worth summarizing, although the bugs
264that they represent may be covered elsewhere.
b7b593d8 265
cf73ceda 266[ List each test improvement as a =item entry ]
fc4c3cec 267
fc4c3cec 268=over 4
4b951711
TC
269
270=item *
271
cf73ceda 272XXX
eabfc7bc 273
fc4c3cec 274=back
eabfc7bc 275
73d6481e 276=head1 Platform Support
eabfc7bc 277
cf73ceda
MH
278XXX Any changes to platform support should be listed in the sections below.
279
280[ Within the sections, list each platform as a =item entry with specific
281changes as paragraphs below it. ]
282
283=head2 New Platforms
284
285XXX List any platforms that this version of perl compiles on, that previous
286versions did not. These will either be enabled by new files in the F<hints/>
287directories, or new subdirectories and F<README> files at the top level of the
288source tree.
9c0328ac 289
fc4c3cec
RS
290=over 4
291
cf73ceda 292=item XXX-some-platform
fc4c3cec 293
cf73ceda 294XXX
7d380357 295
cf73ceda 296=back
7d380357 297
cf73ceda
MH
298=head2 Discontinued Platforms
299
300XXX List any platforms that this version of perl no longer compiles on.
301
302=over 4
303
304=item XXX-some-platform
305
306XXX
7d380357
RS
307
308=back
eabfc7bc 309
cf73ceda
MH
310=head2 Platform-Specific Notes
311
312XXX List any changes for specific platforms. This could include configuration
313and compilation changes or changes in portability/compatibility. However,
314changes within modules for platforms should generally be listed in the
315L</Modules and Pragmata> section.
316
317=over 4
318
319=item XXX-some-platform
320
321XXX
322
2cfe9b50 323=back
eabfc7bc 324
fc4c3cec
RS
325=head1 Internal Changes
326
cf73ceda
MH
327XXX Changes which affect the interface available to C<XS> code go here. Other
328significant internal changes for future core maintainers should be noted as
329well.
330
331[ List each change as a =item entry ]
332
2cfe9b50 333=over 4
eabfc7bc
RS
334
335=item *
336
cf73ceda 337XXX
eabfc7bc 338
fc4c3cec 339=back
302ef3d4 340
fc4c3cec 341=head1 Selected Bug Fixes
302ef3d4 342
cf73ceda
MH
343XXX Important bug fixes in the core language are summarized here. Bug fixes in
344files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
345
346[ List each fix as a =item entry ]
347
fc4c3cec 348=over 4
eabfc7bc 349
73d6481e 350=item *
eabfc7bc 351
912fd711
KW
352Perl can again be compiled with any Unicode version. This used to
353(mostly) work, but was lost in v5.18 through v5.20. The property
354C<Name_Alias> did not exist prior to Unicode 5.0. L<Unicode::UCD>
355incorrectly said it did. This has been fixed.
cf73ceda
MH
356
357=back
358
359=head1 Known Problems
360
361XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
362tests that had to be C<TODO>ed for the release would be noted here. Unfixed
363platform specific bugs also go here.
364
365[ List each fix as a =item entry ]
366
367=over 4
eabfc7bc 368
fc4c3cec 369=item *
2a7a05b4 370
cf73ceda 371XXX
30aa8e3f 372
fc4c3cec 373=back
30aa8e3f 374
cf73ceda 375=head1 Errata From Previous Releases
2a7a05b4 376
cf73ceda 377=over 4
f282dc56 378
cf73ceda 379=item *
f282dc56 380
cf73ceda
MH
381XXX Add anything here that we forgot to add, or were mistaken about, in
382the perldelta of a previous release.
f282dc56 383
cf73ceda 384=back
f282dc56 385
cf73ceda
MH
386=head1 Obituary
387
388XXX If any significant core contributor has died, we've added a short obituary
389here.
390
391=head1 Acknowledgements
f282dc56 392
cf73ceda 393XXX Generate this with:
2cfe9b50 394
cf73ceda 395 perl Porting/acknowledgements.pl v5.23.1..HEAD
f5b73711 396
44691e6f
AB
397=head1 Reporting Bugs
398
e08634c5
SH
399If you find what you think is a bug, you might check the articles recently
400posted to the comp.lang.perl.misc newsgroup and the perl bug database at
fc4c3cec
RS
401L<https://rt.perl.org/> . There may also be information at
402L<http://www.perl.org/> , the Perl Home Page.
44691e6f 403
e08634c5
SH
404If you believe you have an unreported bug, please run the L<perlbug> program
405included with your release. Be sure to trim your bug down to a tiny but
406sufficient test case. Your bug report, along with the output of C<perl -V>,
407will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
44691e6f
AB
408
409If the bug you are reporting has security implications, which make it
e08634c5
SH
410inappropriate to send to a publicly archived mailing list, then please send it
411to perl5-security-report@perl.org. This points to a closed subscription
412unarchived mailing list, which includes all the core committers, who will be
413able to help assess the impact of issues, figure out a resolution, and help
f9001595 414co-ordinate the release of patches to mitigate or fix the problem across all
e08634c5
SH
415platforms on which Perl is supported. Please only use this address for
416security issues in the Perl core, not for modules independently distributed on
417CPAN.
44691e6f
AB
418
419=head1 SEE ALSO
420
e08634c5
SH
421The F<Changes> file for an explanation of how to view exhaustive details on
422what changed.
44691e6f
AB
423
424The F<INSTALL> file for how to build Perl.
425
426The F<README> file for general stuff.
427
428The F<Artistic> and F<Copying> files for copyright information.
429
430=cut