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