This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Update Unicode-Collate to CPAN version 0.86
[perl5.git] / pod / perldelta.pod
CommitLineData
44691e6f
AB
1=encoding utf8
2
3=head1 NAME
4
0aaeb177
SH
5[ this is a template for a new perldelta file. Any text flagged as
6XXX needs to be processed before release. ]
760696b8 7
0aaeb177 8perldelta - what is new for perl v5.15.6
062678b2 9
0aaeb177 10=head1 DESCRIPTION
ad32999b 11
0aaeb177
SH
12This document describes differences between the 5.15.5 release and
13the 5.15.6 release.
ad32999b 14
0aaeb177
SH
15If you are upgrading from an earlier release such as 5.15.4, first read
16L<perl5155delta>, which describes differences between 5.15.4 and
175.15.5.
ad32999b 18
0aaeb177 19=head1 Notice
ad32999b 20
0aaeb177 21XXX Any important notices here
ad32999b 22
0aaeb177 23=head1 Core Enhancements
a3f52e2e 24
0aaeb177
SH
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.
a3f52e2e 28
0aaeb177 29[ List each enhancement as a =head2 entry ]
6d110ad0 30
e3c71926 31=head1 Security
6d110ad0 32
0aaeb177
SH
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.
6d110ad0 36
0aaeb177 37[ List each security issue as a =head2 entry ]
6d110ad0 38
e3c71926 39=head1 Incompatible Changes
6d110ad0 40
0aaeb177 41XXX For a release on a stable branch, this section aspires to be:
ad32999b 42
0aaeb177
SH
43 There are no changes intentionally incompatible with 5.XXX.XXX
44 If any exist, they are bugs and reports are welcome.
ad32999b 45
0aaeb177 46[ List each incompatible change as a =head2 entry ]
ad32999b 47
e3c71926 48=head1 Deprecations
6d110ad0 49
0aaeb177
SH
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.
ae92a9ae 53
0aaeb177 54[ List each deprecation as a =head2 entry ]
ae92a9ae 55
e3c71926 56=head1 Performance Enhancements
6d110ad0 57
0aaeb177
SH
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
e3c71926 63=over 4
6d110ad0
FC
64
65=item *
66
0aaeb177 67XXX
6d110ad0 68
e3c71926 69=back
6d110ad0 70
e3c71926 71=head1 Modules and Pragmata
6d110ad0 72
0aaeb177
SH
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
e3c71926 83=head2 New Modules and Pragmata
6d110ad0 84
e3c71926 85=over 4
6d110ad0
FC
86
87=item *
88
0aaeb177 89XXX
6d110ad0
FC
90
91=back
92
e3c71926 93=head2 Updated Modules and Pragmata
6d110ad0 94
e3c71926 95=over 4
6d110ad0
FC
96
97=item *
98
f8c9502f
CBW
99L<Archive::Tar> has been upgraded from version 1.80 to version 1.82.
100
101Adjustments to handle files >8gb (>0777777777777 octal) and a feature to
102return the MD5SUM of files in the archive.
a3f52e2e 103
87b9431e
CBW
104=item *
105
106L<Compress::Raw::Zlib> has been upgraded from version 2.042 to version 2.043.
107
7e700369
CBW
108=item *
109
110L<Compress::Raw::Bzip2> has been upgraded from version 2.042 to version 2.043.
111
dc7edc5c
CBW
112=item *
113
114L<IO::Compress::Base> has been upgraded from version 2.042 to version 2.043.
115
7788a270
CBW
116=item *
117
118L<Unicode::Collate> has been upgraded from version 0.85 to version 0.86.
119
120Tailored compatibility ideographs as well as unified ideographs for
121the locales: ja, ko, zh__big5han, zh__gb2312han, zh__pinyin, zh__stroke.
122
0aaeb177 123=back
6138a722 124
0aaeb177 125=head2 Removed Modules and Pragmata
6138a722 126
0aaeb177 127=over 4
be539103 128
a47fb3fe
CBW
129=item *
130
0aaeb177 131XXX
a3f52e2e 132
0aaeb177 133=back
a3f52e2e 134
0aaeb177 135=head1 Documentation
a3f52e2e 136
0aaeb177
SH
137XXX Changes to files in F<pod/> go here. Consider grouping entries by
138file and be sure to link to the appropriate page, e.g. L<perlfunc>.
a3f52e2e 139
0aaeb177 140=head2 New Documentation
ad32999b 141
0aaeb177 142XXX Changes which create B<new> files in F<pod/> go here.
ad32999b 143
0aaeb177 144=head3 L<XXX>
ad32999b 145
0aaeb177 146XXX Description of the purpose of the new file here
6138a722 147
0aaeb177 148=head2 Changes to Existing Documentation
6138a722 149
0aaeb177
SH
150XXX Changes which significantly change existing files in F<pod/> go here.
151However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
152section.
a47fb3fe 153
0aaeb177 154=head3 L<XXX>
a47fb3fe 155
0aaeb177 156=over 4
7ef25837 157
6d110ad0
FC
158=item *
159
0aaeb177 160XXX Description of the change here
6d110ad0
FC
161
162=back
163
e3c71926
FR
164=head1 Diagnostics
165
166The following additions or changes have been made to diagnostic output,
167including warnings and fatal error messages. For the complete list of
168diagnostic messages, see L<perldiag>.
6d110ad0 169
0aaeb177
SH
170XXX New or changed warnings emitted by the core's C<C> code go here. Also
171include any changes in L<perldiag> that reconcile it to the C<C> code.
6138a722 172
0aaeb177
SH
173[ Within each section, list entries as a =item entry that links to perldiag,
174 e.g.
6138a722 175
0aaeb177 176 =item *
6138a722 177
0aaeb177
SH
178 L<Invalid version object|perldiag/"Invalid version object">
179]
6138a722 180
0aaeb177 181=head2 New Diagnostics
828d6195 182
0aaeb177 183XXX Newly added diagnostic messages go here
83307084 184
0aaeb177 185=head3 New Errors
d39de893 186
3432e5a1 187=over 4
39afdc5a
CBW
188
189=item *
190
0aaeb177 191XXX L<message|perldiag/"message">
6138a722 192
e3c71926 193=back
7b8e5ef0 194
0aaeb177 195=head3 New Warnings
91710846 196
e3c71926 197=over 4
91710846
DG
198
199=item *
200
0aaeb177 201XXX L<message|perldiag/"message">
f81e39ef 202
e3c71926 203=back
a2fa999d 204
0aaeb177
SH
205=head2 Changes to Existing Diagnostics
206
207XXX Changes (i.e. rewording) of diagnostic messages go here
bd65daab 208
e3c71926 209=over 4
bd65daab 210
3f2cb5bf
SM
211=item *
212
0aaeb177 213XXX Describe change here
b420b12a 214
3432e5a1 215=back
b420b12a 216
0aaeb177 217=head1 Utility Changes
9cfd094e 218
0aaeb177
SH
219XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
220here. Most of these are built within the directories F<utils> and F<x2p>.
95f7e41f 221
0aaeb177
SH
222[ List utility changes as a =head3 entry for each utility and =item
223entries for each change
224Use L<XXX> with program names to get proper documentation linking. ]
95f7e41f 225
0aaeb177 226=head3 L<XXX>
d6cf2367 227
e3c71926 228=over 4
b53e16ae
FC
229
230=item *
231
0aaeb177 232XXX
b53e16ae 233
3432e5a1 234=back
60092ce4 235
0aaeb177
SH
236=head1 Configuration and Compilation
237
238XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
239go here. Any other changes to the Perl build process should be listed here.
240However, any platform-specific changes should be listed in the
241L</Platform Support> section, instead.
242
243[ List changes as a =item entry ].
309aab3a 244
e3c71926 245=over 4
b53e16ae
FC
246
247=item *
248
0aaeb177 249XXX
a3f52e2e 250
0aaeb177 251=back
a3f52e2e 252
0aaeb177 253=head1 Testing
a3f52e2e 254
0aaeb177
SH
255XXX Any significant changes to the testing of a freshly built perl should be
256listed here. Changes which create B<new> files in F<t/> go here as do any
257large changes to the testing harness (e.g. when parallel testing was added).
258Changes to existing files in F<t/> aren't worth summarising, although the bugs
259that they represent may be covered elsewhere.
a3f52e2e 260
0aaeb177 261[ List each test improvement as a =item entry ]
a3f52e2e 262
0aaeb177 263=over 4
a3f52e2e
FC
264
265=item *
266
0aaeb177 267XXX
a3f52e2e 268
0aaeb177 269=back
a3f52e2e 270
0aaeb177 271=head1 Platform Support
a3f52e2e 272
0aaeb177 273XXX Any changes to platform support should be listed in the sections below.
a3f52e2e 274
0aaeb177
SH
275[ Within the sections, list each platform as a =item entry with specific
276changes as paragraphs below it. ]
a3f52e2e 277
0aaeb177 278=head2 New Platforms
a3f52e2e 279
0aaeb177
SH
280XXX List any platforms that this version of perl compiles on, that previous
281versions did not. These will either be enabled by new files in the F<hints/>
282directories, or new subdirectories and F<README> files at the top level of the
283source tree.
a3f52e2e 284
0aaeb177 285=over 4
a3f52e2e 286
0aaeb177 287=item XXX-some-platform
a3f52e2e 288
0aaeb177 289XXX
a3f52e2e 290
0aaeb177 291=back
a3f52e2e 292
0aaeb177 293=head2 Discontinued Platforms
ca955add 294
0aaeb177 295XXX List any platforms that this version of perl no longer compiles on.
bbdd8bad 296
0aaeb177 297=over 4
bbdd8bad 298
0aaeb177 299=item XXX-some-platform
ad32999b 300
0aaeb177 301XXX
ad32999b 302
0aaeb177 303=back
ad32999b 304
0aaeb177 305=head2 Platform-Specific Notes
ad32999b 306
0aaeb177
SH
307XXX List any changes for specific platforms. This could include configuration
308and compilation changes or changes in portability/compatibility. However,
309changes within modules for platforms should generally be listed in the
310L</Modules and Pragmata> section.
ad32999b 311
0aaeb177 312=over 4
ad32999b 313
0aaeb177 314=item XXX-some-platform
ad32999b 315
0aaeb177 316XXX
ad32999b 317
0aaeb177 318=back
ad32999b 319
0aaeb177 320=head1 Internal Changes
ad32999b 321
0aaeb177
SH
322XXX Changes which affect the interface available to C<XS> code go here.
323Other significant internal changes for future core maintainers should
324be noted as well.
ad32999b 325
0aaeb177 326[ List each change as a =item entry ]
ad32999b 327
0aaeb177 328=over 4
ad32999b 329
3973654e
FC
330=item *
331
0aaeb177 332XXX
3973654e 333
0aaeb177 334=back
cca38fda 335
0aaeb177 336=head1 Selected Bug Fixes
9c7c1651 337
0aaeb177
SH
338XXX Important bug fixes in the core language are summarised here.
339Bug fixes in files in F<ext/> and F<lib/> are best summarised in
340L</Modules and Pragmata>.
9c7c1651 341
0aaeb177 342[ List each fix as a =item entry ]
fce59cd4 343
0aaeb177 344=over 4
fce59cd4 345
b9e83cd1
FC
346=item *
347
0aaeb177 348XXX
b9e83cd1 349
0aaeb177 350=back
bf19b80e 351
0aaeb177 352=head1 Known Problems
bf19b80e 353
0aaeb177
SH
354XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
355tests that had to be C<TODO>ed for the release would be noted here, unless
356they were specific to a particular platform (see below).
65b66aa9 357
0aaeb177
SH
358This is a list of some significant unfixed bugs, which are regressions
359from either 5.XXX.XXX or 5.XXX.XXX.
65b66aa9 360
0aaeb177 361[ List each fix as a =item entry ]
b53e16ae 362
0aaeb177 363=over 4
b53e16ae 364
7c864bb3
VP
365=item *
366
0aaeb177 367XXX
7c864bb3 368
63ac71b9 369=back
bbc28bfc 370
0aaeb177 371=head1 Obituary
8fe05716 372
0aaeb177
SH
373XXX If any significant core contributor has died, we've added a short obituary
374here.
8fe05716 375
0aaeb177 376=head1 Acknowledgements
8fe05716 377
0aaeb177 378XXX Generate this with:
8fe05716 379
0aaeb177 380 perl Porting/acknowledgements.pl v5.15.5..HEAD
29cf780c 381
44691e6f
AB
382=head1 Reporting Bugs
383
384If you find what you think is a bug, you might check the articles
34dc2ec0 385recently posted to the comp.lang.perl.misc newsgroup and the perl
44691e6f
AB
386bug database at http://rt.perl.org/perlbug/ . There may also be
387information at http://www.perl.org/ , the Perl Home Page.
388
389If you believe you have an unreported bug, please run the L<perlbug>
390program included with your release. Be sure to trim your bug down
391to a tiny but sufficient test case. Your bug report, along with the
392output of C<perl -V>, will be sent off to perlbug@perl.org to be
393analysed by the Perl porting team.
394
395If the bug you are reporting has security implications, which make it
396inappropriate to send to a publicly archived mailing list, then please send
34dc2ec0 397it to perl5-security-report@perl.org. This points to a closed subscription
b4707b2a
FC
398unarchived mailing list, which includes
399all the core committers, who will be able
44691e6f
AB
400to help assess the impact of issues, figure out a resolution, and help
401co-ordinate the release of patches to mitigate or fix the problem across all
34dc2ec0
DM
402platforms on which Perl is supported. Please only use this address for
403security issues in the Perl core, not for modules independently
44691e6f
AB
404distributed on CPAN.
405
406=head1 SEE ALSO
407
408The F<Changes> file for an explanation of how to view exhaustive details
409on what changed.
410
411The F<INSTALL> file for how to build Perl.
412
413The F<README> file for general stuff.
414
415The F<Artistic> and F<Copying> files for copyright information.
416
417=cut