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