This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
release_managers_guide.pod: Add Module::CoreList to perldelta
[perl5.git] / pod / perldelta.pod
CommitLineData
44691e6f
AB
1=encoding utf8
2
3=head1 NAME
4
5[ this is a template for a new perldelta file. Any text flagged as
6XXX needs to be processed before release. ]
7
8perldelta - what is new for perl v5.13.11
9
10=head1 DESCRIPTION
11
12This document describes differences between the 5.13.10 release and
13the 5.13.11 release.
14
15If you are upgrading from an earlier release such as 5.13.9, first read
16L<perl5139delta>, which describes differences between 5.13.9 and
175.13.10.
18
19=head1 Notice
20
21XXX Any important notices here
22
23=head1 Core Enhancements
24
25XXX New core language features go here. Summarise user-visible core language
26enhancements. Particularly prominent performance optimisations could go
27here, but most should go in the L</Performance Enhancements> section.
28
29[ List each enhancement as a =head2 entry ]
30
31=head1 Security
32
33XXX Any security-related notices go here. In particular, any security
34vulnerabilities closed should be noted here rather than in the
35L</Selected Bug Fixes> section.
36
37[ List each security issue as a =head2 entry ]
38
39=head1 Incompatible Changes
40
41XXX For a release on a stable branch, this section aspires to be:
42
43 There are no changes intentionally incompatible with 5.XXX.XXX. If any
44 exist, they are bugs and reports are welcome.
45
46[ List each incompatible change as a =head2 entry ]
47
48=head1 Deprecations
49
50XXX Any deprecated features, syntax, modules etc. should be listed here.
51In particular, deprecated modules should be listed here even if they are
52listed as an updated module in the L</Modules and Pragmata> section.
53
54[ List each deprecation as a =head2 entry ]
55
56=head1 Performance Enhancements
57
58XXX Changes which enhance performance without changing behaviour go here. There
59may well be none in a stable release.
60
61[ List each enhancement as a =item entry ]
62
63=over 4
64
65=item *
66
67XXX
68
69=back
70
71=head1 Modules and Pragmata
72
73XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
74go here. If Module::CoreList is updated, generate an initial draft of the
75following sections using F<Porting/corelist-perldelta.pl>, which prints stub
76entries to STDOUT. Results can be pasted in place of the '=head2' entries
77below. A paragraph summary for important changes should then be added by hand.
78In an ideal world, dual-life modules would have a F<Changes> file that could be
79cribbed.
80
81[ Within each section, list entries as a =item entry ]
82
83=head2 New Modules and Pragmata
84
85=over 4
86
87=item *
88
89XXX
90
91=back
92
93=head2 Updated Modules and Pragmata
94
95=over 4
96
97=item *
98
6d96b0fe
FR
99C<base> has been upgraded from version 2.15 to 2.16.
100
101=item *
102
873fac80
CBW
103C<CPANPLUS> has been upgraded from version 0.9101 to 0.9102
104
105=item *
106
fed587f1
CBW
107C<CPANPLUS::Dist::Build> has been upgraded from version 0.52 to 0.54
108
109=item *
110
2dd700c2
FR
111C<Devel::DProf> has been upgraded from version 20110225.01 to 20110228.00.
112
113=item *
114
340a2f44 115C<Digest::SHA> has been upgraded from version 5.50 to 5.61
65484cb9
CBW
116
117New SHA-512/224 and SHA-512/256 transforms ref. NIST Draft FIPS 180-4 (February 2011)
118
119=item *
120
7ad89242
FR
121C<ExtUtils::Command> has been upgraded from version 1.16 to 1.17.
122
123=item *
124
c8c13991
CBW
125C<IO> has been upgraded from version 1.25_03 to 1.25_04.
126
127=item *
128
2ec5653d 129C<JSON::PP> has been upgraded from version 2.27103 to 2.27105
44691e6f 130
f00d3350
BR
131=item *
132
fe3de278
CBW
133C<Locale::Codes> has been upgraded from version 3.15 to 3.16
134
135=item *
136
6d96b0fe 137C<Math::BigInt> has been upgraded from version 1.992 to 1.994
35cdccfc
CBW
138
139=item *
140
cc27c8a1 141C<Math::BigInt::FastCalc> has been upgraded from version 0.24_02 to 0.28
f5c40488
CBW
142
143=item *
144
0bb35765
DG
145C<Module::Build> has been upgraded from version 0.37_05 to 0.3800
146
147=item *
148
6b3df227
CBW
149C<parent> has been upgraded from version 0.224 to 0.225
150
151=item *
152
c8c13991
CBW
153C<Test::Harness> has been upgraded from version 3.22 to 3.23
154
155=item *
156
157C<Test::Simple> has been upgraded from version 0.97_01 to 0.98
f00d3350 158
c34a735e
FR
159=item *
160
161C<Tie::RefHash> has been upgraded from version 1.38 to 1.39.
162
05dbc6f8
KW
163=item *
164
7b98b857
CBW
165C<Unicode::Collate> has been upgraded from version 0.72 to 0.73
166
167DUCET has been updated for Unicode 6.0.0 as Collate/allkeys.txt and
168the default UCA_Version is 22.
169
170=item *
171
172C<Unicode::UCD> has been upgraded from version 0.31 to 0.32.
05dbc6f8
KW
173This includes a number of bug fixes:
174
175=over 4
176
177=item charinfo()
178
179=over 4
180
181=item *
182
183It is now updated to Unicode Version 6 with Corrigendum #8, except,
184as with Perl 5.14, the code point at U+1F514 has no name.
185
186=item *
187
188The Hangul syllable code points have the correct names, and their
189decompositions are always output without requiring L<Lingua::KO::Hangul::Util>
190to be installed.
191
192=item *
193
194The CJK (Chinese-Japanese-Korean) code points U+2A700 - U+2B734
195and U+2B740 - 2B81D are now properly handled.
196
197=item *
198
199The numeric values are now output for those CJK code points that have them.
200
201=item *
202
203The names that are output for code points with multiple aliases are now the
204corrected ones.
205
206=back
207
8079ad82
KW
208=item charscript()
209
210This now correctly returns "Unknown" instead of C<undef> for the script
211of a code point that hasn't been assigned another one.
212
4d56cd4f
KW
213=item charblock()
214
215This now correctly returns "No_Block" instead of C<undef> for the block
216of a code point that hasn't been assigned to another one.
217
05dbc6f8
KW
218=back
219
44691e6f
AB
220=back
221
222=head2 Removed Modules and Pragmata
223
224=over 4
225
226=item *
227
c8c13991 228XXX
44691e6f
AB
229
230=back
231
232=head1 Documentation
233
234XXX Changes to files in F<pod/> go here. Consider grouping entries by
235file and be sure to link to the appropriate page, e.g. L<perlfunc>.
236
237=head2 New Documentation
238
239XXX Changes which create B<new> files in F<pod/> go here.
240
241=head3 L<XXX>
242
243XXX Description of the purpose of the new file here
244
245=head2 Changes to Existing Documentation
246
247XXX Changes which significantly change existing files in F<pod/> go here.
248However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
249section.
250
251=head3 L<XXX>
252
253=over 4
254
255=item *
256
257XXX Description of the change here
258
259=back
260
261=head1 Diagnostics
262
263The following additions or changes have been made to diagnostic output,
264including warnings and fatal error messages. For the complete list of
265diagnostic messages, see L<perldiag>.
266
267XXX New or changed warnings emitted by the core's C<C> code go here. Also
268include any changes in L<perldiag> that reconcile it to the C<C> code.
269
270[ Within each section, list entries as a =item entry ]
271
272=head2 New Diagnostics
273
274XXX Newly added diagnostic messages go here
275
276=over 4
277
278=item *
279
6d96b0fe
FR
280Regexp modifier "/%c" may not appear twice
281
282(F syntax) The regular expression pattern had one of the mutually exclusive
283modifiers repeated. Remove all but one of the occurrences.
284
285=item *
286
287Regexp modifiers "/%c" and "/%c" are mutually exclusive
288
289(F syntax) The regular expression pattern had more than one of the mutually
290exclusive modifiers. Retain only the modifier that is supposed to be there.
44691e6f
AB
291
292=back
293
294=head2 Changes to Existing Diagnostics
295
296XXX Changes (i.e. rewording) of diagnostic messages go here
297
298=over 4
299
300=item *
301
302XXX
303
304=back
305
306=head1 Utility Changes
307
308XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
309here. Most of these are built within the directories F<utils> and F<x2p>.
310
311[ List utility changes as a =head3 entry for each utility and =item
312entries for each change
313Use L<XXX> with program names to get proper documentation linking. ]
314
315=head3 L<XXX>
316
317=over 4
318
319=item *
320
321XXX
322
323=back
324
325=head1 Configuration and Compilation
326
327XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
328go here. Any other changes to the Perl build process should be listed here.
329However, any platform-specific changes should be listed in the
330L</Platform Support> section, instead.
331
332[ List changes as a =item entry ].
333
334=over 4
335
336=item *
337
338XXX
339
340=back
341
342=head1 Testing
343
344XXX Any significant changes to the testing of a freshly built perl should be
345listed here. Changes which create B<new> files in F<t/> go here as do any
346large changes to the testing harness (e.g. when parallel testing was added).
347Changes to existing files in F<t/> aren't worth summarising, although the bugs
348that they represent may be covered elsewhere.
349
350[ List each test improvement as a =item entry ]
351
352=over 4
353
354=item *
355
356XXX
357
358=back
359
360=head1 Platform Support
361
362XXX Any changes to platform support should be listed in the sections below.
363
364[ Within the sections, list each platform as a =item entry with specific
365changes as paragraphs below it. ]
366
367=head2 New Platforms
368
369XXX List any platforms that this version of perl compiles on, that previous
370versions did not. These will either be enabled by new files in the F<hints/>
371directories, or new subdirectories and F<README> files at the top level of the
372source tree.
373
374=over 4
375
376=item XXX-some-platform
377
378XXX
379
380=back
381
382=head2 Discontinued Platforms
383
384XXX List any platforms that this version of perl no longer compiles on.
385
386=over 4
387
388=item XXX-some-platform
389
390XXX
391
392=back
393
394=head2 Platform-Specific Notes
395
396XXX List any changes for specific platforms. This could include configuration
397and compilation changes or changes in portability/compatibility. However,
398changes within modules for platforms should generally be listed in the
399L</Modules and Pragmata> section.
400
401=over 4
402
403=item XXX-some-platform
404
405XXX
406
407=back
408
409=head1 Internal Changes
410
411XXX Changes which affect the interface available to C<XS> code go here.
412Other significant internal changes for future core maintainers should
413be noted as well.
414
415[ List each test improvement as a =item entry ]
416
417=over 4
418
419=item *
420
421XXX
422
423=back
424
425=head1 Selected Bug Fixes
426
427XXX Important bug fixes in the core language are summarised here.
428Bug fixes in files in F<ext/> and F<lib/> are best summarised in
429L</Modules and Pragmata>.
430
44691e6f
AB
431=over 4
432
433=item *
434
7b5a08e9
DL
435A fix for a bug in C<length(undef)> in 5.13.4 introduced a regression that
436meant C<print length undef> did not warn when warnings were enabled. It now
437correctly warns (RT #85508).
44691e6f
AB
438
439=back
440
441=head1 Known Problems
442
443XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
444tests that had to be C<TODO>ed for the release would be noted here, unless
445they were specific to a particular platform (see below).
446
447This is a list of some significant unfixed bugs, which are regressions
448from either 5.XXX.XXX or 5.XXX.XXX.
449
450[ List each fix as a =item entry ]
451
452=over 4
453
454=item *
455
456XXX
457
458=back
459
460=head1 Obituary
461
462XXX If any significant core contributor has died, we've added a short obituary
463here.
464
465=head1 Acknowledgements
466
467XXX The list of people to thank goes here.
468
469=head1 Reporting Bugs
470
471If you find what you think is a bug, you might check the articles
472recently posted to the comp.lang.perl.misc newsgroup and the perl
473bug database at http://rt.perl.org/perlbug/ . There may also be
474information at http://www.perl.org/ , the Perl Home Page.
475
476If you believe you have an unreported bug, please run the L<perlbug>
477program included with your release. Be sure to trim your bug down
478to a tiny but sufficient test case. Your bug report, along with the
479output of C<perl -V>, will be sent off to perlbug@perl.org to be
480analysed by the Perl porting team.
481
482If the bug you are reporting has security implications, which make it
483inappropriate to send to a publicly archived mailing list, then please send
484it to perl5-security-report@perl.org. This points to a closed subscription
485unarchived mailing list, which includes all the core committers, who be able
486to help assess the impact of issues, figure out a resolution, and help
487co-ordinate the release of patches to mitigate or fix the problem across all
488platforms on which Perl is supported. Please only use this address for
489security issues in the Perl core, not for modules independently
490distributed on CPAN.
491
492=head1 SEE ALSO
493
494The F<Changes> file for an explanation of how to view exhaustive details
495on what changed.
496
497The F<INSTALL> file for how to build Perl.
498
499The F<README> file for general stuff.
500
501The F<Artistic> and F<Copying> files for copyright information.
502
503=cut