This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta for ExtUtils::MakeMaker version 6.61_01.
[perl5.git] / pod / perldelta.pod
CommitLineData
44691e6f
AB
1=encoding utf8
2
3=head1 NAME
4
3432e5a1
SL
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.15.4
760696b8 9
5438d4b8 10=head1 DESCRIPTION
5cd408a2 11
3432e5a1
SL
12This document describes differences between the 5.15.3 release and
13the 5.15.4 release.
5cd408a2 14
3432e5a1
SL
15If you are upgrading from an earlier release such as 5.15.3, first read
16L<perl5153delta>, which describes differences between 5.15.3 and
175.15.4.
062678b2 18
63ac71b9 19=head1 Notice
4185c919 20
3432e5a1 21XXX Any important notices here
0afed34d 22
63ac71b9 23=head1 Core Enhancements
0afed34d 24
3f728e2e 25=head2 $^X converted to an absolute path on FreeBSD, OS X and Solaris
d2006265 26
3f728e2e
NC
27C<$^X> is now converted to an absolute path on OS X, FreeBSD (without
28needing F</proc> mounted) and Solaris 10 and 11. This augments the
29previous approach of using F</proc> on Linux, FreeBSD and NetBSD
30(in all cases, where mounted).
31
32This makes relocatable perl installations more useful on these platforms.
33(See "Relocatable @INC" in F<INSTALL>)
d6cf2367 34
63ac71b9 35=head1 Security
0afed34d 36
3432e5a1
SL
37XXX Any security-related notices go here. In particular, any security
38vulnerabilities closed should be noted here rather than in the
39L</Selected Bug Fixes> section.
46661105 40
3432e5a1 41[ List each security issue as a =head2 entry ]
46661105 42
5438d4b8 43=head1 Incompatible Changes
7818c927 44
3432e5a1 45XXX For a release on a stable branch, this section aspires to be:
e1dccc0d 46
3432e5a1
SL
47 There are no changes intentionally incompatible with 5.XXX.XXX
48 If any exist, they are bugs and reports are welcome.
7b2b001e 49
3432e5a1 50[ List each incompatible change as a =head2 entry ]
bdb9ba77 51
3432e5a1 52=head1 Deprecations
7ec04da5 53
3432e5a1
SL
54XXX Any deprecated features, syntax, modules etc. should be listed here.
55In particular, deprecated modules should be listed here even if they are
56listed as an updated module in the L</Modules and Pragmata> section.
7ec04da5 57
3432e5a1 58[ List each deprecation as a =head2 entry ]
d6cf2367 59
3432e5a1 60=head1 Performance Enhancements
d6cf2367 61
3432e5a1
SL
62XXX Changes which enhance performance without changing behaviour go here. There
63may well be none in a stable release.
5d4ff231 64
3432e5a1 65[ List each enhancement as a =item entry ]
e46d9735 66
63ac71b9 67=over 4
e46d9735
CBW
68
69=item *
70
3432e5a1 71XXX
828d6195 72
3432e5a1 73=back
83307084 74
3432e5a1 75=head1 Modules and Pragmata
83307084 76
3432e5a1
SL
77XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
78go here. If Module::CoreList is updated, generate an initial draft of the
79following sections using F<Porting/corelist-perldelta.pl>, which prints stub
80entries to STDOUT. Results can be pasted in place of the '=head2' entries
81below. A paragraph summary for important changes should then be added by hand.
82In an ideal world, dual-life modules would have a F<Changes> file that could be
83cribbed.
83307084 84
3432e5a1 85[ Within each section, list entries as a =item entry ]
83307084 86
3432e5a1 87=head2 New Modules and Pragmata
d93f0209 88
3432e5a1 89=over 4
d93f0209 90
60527824
FR
91=item *
92
3432e5a1 93XXX
d6cf2367 94
3432e5a1 95=back
d39de893 96
3432e5a1 97=head2 Updated Modules and Pragmata
d39de893 98
3432e5a1 99=over 4
39afdc5a
CBW
100
101=item *
102
2480ae1c 103L<perlfaq> has been upgraded from version 5.0150034 to version 5.0150035.
666c7ca6 104
7b8e5ef0
GG
105=item *
106
107L<ExtUtils::MakeMaker> has been upgraded from version 6.59 to version 6.61_01.
108
3432e5a1 109=back
666c7ca6 110
3432e5a1 111=head2 Removed Modules and Pragmata
d6cf2367 112
3432e5a1 113=over 4
d6cf2367
FC
114
115=item *
116
3432e5a1 117XXX
a9feb6cb 118
3432e5a1 119=back
a9feb6cb 120
3432e5a1 121=head1 Documentation
8fe353ef 122
3432e5a1
SL
123XXX Changes to files in F<pod/> go here. Consider grouping entries by
124file and be sure to link to the appropriate page, e.g. L<perlfunc>.
8fe353ef 125
3432e5a1 126=head2 New Documentation
8fe353ef 127
3432e5a1 128XXX Changes which create B<new> files in F<pod/> go here.
60527824 129
3432e5a1 130=head3 L<XXX>
7ac26854 131
3432e5a1 132XXX Description of the purpose of the new file here
7ac26854 133
3432e5a1 134=head2 Changes to Existing Documentation
7ac26854 135
3432e5a1
SL
136XXX Changes which significantly change existing files in F<pod/> go here.
137However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
138section.
518487b2 139
3432e5a1 140=head3 L<XXX>
daef35db 141
3432e5a1 142=over 4
83307084
SL
143
144=item *
145
3432e5a1 146XXX Description of the change here
b420b12a 147
3432e5a1 148=back
b420b12a 149
3432e5a1 150=head1 Diagnostics
83307084 151
3432e5a1
SL
152The following additions or changes have been made to diagnostic output,
153including warnings and fatal error messages. For the complete list of
154diagnostic messages, see L<perldiag>.
83307084 155
3432e5a1
SL
156XXX New or changed warnings emitted by the core's C<C> code go here. Also
157include any changes in L<perldiag> that reconcile it to the C<C> code.
83307084 158
3432e5a1
SL
159[ Within each section, list entries as a =item entry that links to perldiag,
160 e.g.
83307084 161
3432e5a1 162 =item *
d6cf2367 163
3432e5a1
SL
164 L<Invalid version object|perldiag/"Invalid version object">
165]
d6cf2367 166
3432e5a1 167=head2 New Diagnostics
d6cf2367 168
3432e5a1 169XXX Newly added diagnostic messages go here
daef35db 170
3432e5a1 171=head3 New Errors
259925f6 172
3432e5a1 173=over 4
9840cdee
CBW
174
175=item *
176
3432e5a1 177XXX L<message|perldiag/"message">
54e02335 178
63ac71b9 179=back
310913d4 180
3432e5a1 181=head3 New Warnings
dc80b0c6 182
63ac71b9 183=over 4
83b32788
CBW
184
185=item *
186
3432e5a1 187XXX L<message|perldiag/"message">
4eb81ef2 188
63ac71b9 189=back
4eb81ef2 190
3432e5a1
SL
191=head2 Changes to Existing Diagnostics
192
193XXX Changes (i.e. rewording) of diagnostic messages go here
d6cf2367
FC
194
195=over 4
196
197=item *
198
3432e5a1 199XXX Describe change here
d6cf2367
FC
200
201=back
202
3432e5a1 203=head1 Utility Changes
d6cf2367 204
3432e5a1
SL
205XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
206here. Most of these are built within the directories F<utils> and F<x2p>.
b89e9b0d 207
3432e5a1
SL
208[ List utility changes as a =head3 entry for each utility and =item
209entries for each change
210Use L<XXX> with program names to get proper documentation linking. ]
0cb4637e 211
3432e5a1 212=head3 L<XXX>
4abaf918 213
5438d4b8 214=over 4
4abaf918
Z
215
216=item *
217
3432e5a1 218XXX
8b00e523 219
e8e35311
FC
220=back
221
63ac71b9 222=head1 Configuration and Compilation
b908e258 223
3432e5a1
SL
224XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
225go here. Any other changes to the Perl build process should be listed here.
226However, any platform-specific changes should be listed in the
227L</Platform Support> section, instead.
b908e258 228
3432e5a1 229[ List changes as a =item entry ].
bbc28bfc 230
34dc2ec0 231=over 4
42a91c97 232
6693394d 233=item *
42a91c97 234
3432e5a1 235XXX
d2006265 236
3432e5a1 237=back
9cfd094e 238
3432e5a1 239=head1 Testing
9cfd094e 240
3432e5a1
SL
241XXX Any significant changes to the testing of a freshly built perl should be
242listed here. Changes which create B<new> files in F<t/> go here as do any
243large changes to the testing harness (e.g. when parallel testing was added).
244Changes to existing files in F<t/> aren't worth summarising, although the bugs
245that they represent may be covered elsewhere.
9cfd094e 246
3432e5a1 247[ List each test improvement as a =item entry ]
7c4c6e7c 248
3432e5a1 249=over 4
95f7e41f 250
83307084 251=item *
95f7e41f 252
6692294e
NC
253F<t/porting/checkcfgvar.t> now tests that all config.sh-style files are
254complete. These are used by the various non-*nix to generate their
255F<config.h>, and an incomplete input file will generate invalid output.
df5b44bd 256
63ac71b9 257=back
310913d4 258
83307084 259=head1 Platform Support
df5b44bd 260
3432e5a1 261XXX Any changes to platform support should be listed in the sections below.
7818c927 262
3432e5a1
SL
263[ Within the sections, list each platform as a =item entry with specific
264changes as paragraphs below it. ]
83307084 265
3432e5a1 266=head2 New Platforms
7818c927 267
3432e5a1
SL
268XXX List any platforms that this version of perl compiles on, that previous
269versions did not. These will either be enabled by new files in the F<hints/>
270directories, or new subdirectories and F<README> files at the top level of the
271source tree.
3fdd840f 272
63ac71b9 273=over 4
7ffa7e75 274
3432e5a1 275=item XXX-some-platform
862b2c43 276
3432e5a1 277XXX
d6cf2367 278
63ac71b9 279=back
c973bd4f 280
3432e5a1 281=head2 Discontinued Platforms
fdd313f4 282
3432e5a1 283XXX List any platforms that this version of perl no longer compiles on.
c39e29ea 284
3432e5a1 285=over 4
c39e29ea 286
3432e5a1 287=item XXX-some-platform
c39e29ea 288
3432e5a1 289XXX
d6cf2367 290
3432e5a1 291=back
d6cf2367 292
3432e5a1 293=head2 Platform-Specific Notes
d6cf2367 294
3432e5a1
SL
295XXX List any changes for specific platforms. This could include configuration
296and compilation changes or changes in portability/compatibility. However,
297changes within modules for platforms should generally be listed in the
298L</Modules and Pragmata> section.
d6cf2367 299
3432e5a1 300=over 4
d6cf2367 301
3432e5a1 302=item XXX-some-platform
d6cf2367 303
3432e5a1 304XXX
d6cf2367 305
3432e5a1 306=back
d6cf2367 307
3432e5a1 308=head1 Internal Changes
d6cf2367 309
3432e5a1
SL
310XXX Changes which affect the interface available to C<XS> code go here.
311Other significant internal changes for future core maintainers should
312be noted as well.
d6cf2367 313
3432e5a1 314[ List each change as a =item entry ]
5d4ff231 315
3432e5a1 316=over 4
5d4ff231 317
a3342be3
FC
318=item *
319
3432e5a1 320XXX
60092ce4 321
3432e5a1 322=back
60092ce4 323
3432e5a1 324=head1 Selected Bug Fixes
309aab3a 325
3432e5a1
SL
326XXX Important bug fixes in the core language are summarised here.
327Bug fixes in files in F<ext/> and F<lib/> are best summarised in
328L</Modules and Pragmata>.
309aab3a 329
3432e5a1 330[ List each fix as a =item entry ]
1f26655e 331
3432e5a1 332=over 4
1f26655e 333
433644ee
FC
334=item *
335
3432e5a1 336XXX
433644ee 337
63ac71b9 338=back
bbc28bfc 339
7d3f03b7
SL
340=head1 Known Problems
341
3432e5a1
SL
342XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
343tests that had to be C<TODO>ed for the release would be noted here, unless
344they were specific to a particular platform (see below).
7d3f03b7 345
3432e5a1
SL
346This is a list of some significant unfixed bugs, which are regressions
347from either 5.XXX.XXX or 5.XXX.XXX.
348
349[ List each fix as a =item entry ]
7d3f03b7 350
3432e5a1 351=over 4
7d3f03b7
SL
352
353=item *
354
3432e5a1 355XXX
7d3f03b7 356
3432e5a1 357=back
7d3f03b7 358
3432e5a1 359=head1 Obituary
7d3f03b7 360
3432e5a1
SL
361XXX If any significant core contributor has died, we've added a short obituary
362here.
7d3f03b7 363
44691e6f
AB
364=head1 Acknowledgements
365
3432e5a1
SL
366XXX Generate this with:
367
368 perl Porting/acknowledgements.pl v5.15.3..HEAD
29cf780c 369
44691e6f
AB
370=head1 Reporting Bugs
371
372If you find what you think is a bug, you might check the articles
34dc2ec0 373recently posted to the comp.lang.perl.misc newsgroup and the perl
44691e6f
AB
374bug database at http://rt.perl.org/perlbug/ . There may also be
375information at http://www.perl.org/ , the Perl Home Page.
376
377If you believe you have an unreported bug, please run the L<perlbug>
378program included with your release. Be sure to trim your bug down
379to a tiny but sufficient test case. Your bug report, along with the
380output of C<perl -V>, will be sent off to perlbug@perl.org to be
381analysed by the Perl porting team.
382
383If the bug you are reporting has security implications, which make it
384inappropriate to send to a publicly archived mailing list, then please send
34dc2ec0 385it to perl5-security-report@perl.org. This points to a closed subscription
b4707b2a
FC
386unarchived mailing list, which includes
387all the core committers, who will be able
44691e6f
AB
388to help assess the impact of issues, figure out a resolution, and help
389co-ordinate the release of patches to mitigate or fix the problem across all
34dc2ec0
DM
390platforms on which Perl is supported. Please only use this address for
391security issues in the Perl core, not for modules independently
44691e6f
AB
392distributed on CPAN.
393
394=head1 SEE ALSO
395
396The F<Changes> file for an explanation of how to view exhaustive details
397on what changed.
398
399The F<INSTALL> file for how to build Perl.
400
401The F<README> file for general stuff.
402
403The F<Artistic> and F<Copying> files for copyright information.
404
405=cut