This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Update Archive-Tar to CPAN version 1.76
[perl5.git] / pod / perldelta.pod
CommitLineData
3a5c9134
CBW
1=encoding utf8
2
3=head1 NAME
4
9f7a72d0
Z
5[ this is a template for a new perldelta file. Any text flagged as
6XXX needs to be processed before release. ]
3a5c9134 7
9f7a72d0 8perldelta - what is new for perl v5.13.9
15e6cdd9 9
9f7a72d0 10=head1 DESCRIPTION
f6166f76 11
9f7a72d0
Z
12This document describes differences between the 5.13.8 release and
13the 5.13.9 release.
0d157ee2 14
9f7a72d0
Z
15If you are upgrading from an earlier release such as 5.13.7, first read
16L<perl5138delta>, which describes differences between 5.13.7 and
175.13.8.
0d157ee2 18
9f7a72d0 19=head1 Notice
0d157ee2 20
9f7a72d0 21XXX Any important notices here
0d157ee2 22
9f7a72d0 23=head1 Core Enhancements
0d157ee2 24
9f7a72d0
Z
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.
0d157ee2 28
9f7a72d0 29[ List each enhancement as a =head2 entry ]
0d157ee2 30
9f7a72d0 31=head1 Security
0d157ee2 32
9f7a72d0
Z
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.
bd8e866d 36
9f7a72d0 37[ List each security issue as a =head2 entry ]
bd8e866d 38
3a5c9134
CBW
39=head1 Incompatible Changes
40
9f7a72d0 41XXX For a release on a stable branch, this section aspires to be:
3a5c9134 42
9f7a72d0
Z
43 There are no changes intentionally incompatible with 5.XXX.XXX. If any
44 exist, they are bugs and reports are welcome.
3a5c9134 45
9f7a72d0 46[ List each incompatible change as a =head2 entry ]
d66e82e8 47
3a5c9134
CBW
48=head1 Deprecations
49
9f7a72d0
Z
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.
5609d5f9 53
9f7a72d0 54[ List each deprecation as a =head2 entry ]
5609d5f9 55
9f7a72d0 56=head1 Performance Enhancements
5609d5f9 57
9f7a72d0
Z
58XXX Changes which enhance performance without changing behaviour go here. There
59may well be none in a stable release.
5609d5f9 60
9f7a72d0 61[ List each enhancement as a =item entry ]
3a5c9134
CBW
62
63=over 4
64
65=item *
66
9f7a72d0 67XXX
e1165778 68
9f7a72d0 69=back
121e1895 70
9f7a72d0 71=head1 Modules and Pragmata
2638c0ff 72
9f7a72d0
Z
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.
2638c0ff 80
9f7a72d0 81[ Within each section, list entries as a =item entry ]
17096837 82
9f7a72d0 83=head2 New Modules and Pragmata
2638c0ff 84
9f7a72d0 85=over 4
17096837 86
e1165778
Z
87=item *
88
e8a07a12
DG
89L<CPAN::Meta::YAML> 0.002 has been added as a dual-life module. It supports a
90subset of YAML sufficient for reading and writing META.yml and MYMETA.yml files
91included with CPAN distributions or generated by the module installation
92toolchain. It should not be used for any other general YAML parsing or
93generation task.
17096837 94
935c8d19
DG
95=item *
96
6cf6332a 97L<Module::Metadata> 1.000003 has been added as a dual-life module. It gathers
e8b333e6
DG
98package and POD information from Perl module files. It is a standalone module
99based on Module::Build::ModuleInfo for use by other module installation
100toolchain components. Module::Build::ModuleInfo has been deprecated in
101favor of this module instead.
102
103=item *
104
935c8d19
DG
105L<Perl::OSType> 1.002 has been added as a dual-life module. It maps Perl
106operating system names (e.g. 'dragonfly' or 'MSWin32') to more generic types
107with standardized names (e.g. "Unix" or "Windows"). It has been refactored
108out of Module::Build and ExtUtils::CBuilder and consolidates such mappings into
109a single location for easier maintenance.
110
9f7a72d0 111=back
e1165778 112
9f7a72d0 113=head2 Updated Modules and Pragmata
f295f417 114
9f7a72d0 115=over 4
17096837 116
f295f417
FC
117=item *
118
6447e912
CBW
119C<Archive::Extract> has been upgraded from version 0.46 to 0.48
120
121=item *
122
89ae55b4
CBW
123C<Archive::Tar> has been upgraded from version 1.74 to 1.76
124
125=item *
126
2a1594f6
CBW
127C<CGI> has been upgraded from version 3.50 to 3.51
128
129=item *
130
b85802c5 131C<Encode> has been upgraded from version 2.40 to 2.42
50afc8f8
CBW
132
133=item *
134
f5d41534
CBW
135C<threads> has been upgraded from version 1.81_03 to 1.82
136
137=item *
138
139C<threads::shared> has been upgraded from version 1.35 to 1.36
140
141=item *
142
23046b7e 143C<Time::Local> has been upgraded from version 1.1901_01 to 1.2000.
17096837 144
9f7a72d0 145=back
e1165778 146
9f7a72d0 147=head2 Removed Modules and Pragmata
b373eab8 148
9f7a72d0 149=over 4
b373eab8
FC
150
151=item *
152
9f7a72d0 153XXX
b6ae81ab 154
9f7a72d0 155=back
ca88a729 156
9f7a72d0 157=head1 Documentation
17096837 158
9f7a72d0
Z
159XXX Changes to files in F<pod/> go here. Consider grouping entries by
160file and be sure to link to the appropriate page, e.g. L<perlfunc>.
b6ae81ab 161
9f7a72d0 162=head2 New Documentation
e1165778 163
9f7a72d0 164XXX Changes which create B<new> files in F<pod/> go here.
17096837 165
9f7a72d0 166=head3 L<XXX>
e1165778 167
9f7a72d0 168XXX Description of the purpose of the new file here
e1165778 169
9f7a72d0 170=head2 Changes to Existing Documentation
17096837 171
9f7a72d0
Z
172XXX Changes which significantly change existing files in F<pod/> go here.
173However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
174section.
e1165778 175
9f7a72d0 176=head3 L<XXX>
d4238815 177
9f7a72d0 178=over 4
17096837 179
d4238815
FC
180=item *
181
9f7a72d0 182XXX Description of the change here
e1165778 183
9f7a72d0 184=back
17096837 185
9f7a72d0 186=head1 Diagnostics
17096837 187
9f7a72d0
Z
188The following additions or changes have been made to diagnostic output,
189including warnings and fatal error messages. For the complete list of
190diagnostic messages, see L<perldiag>.
e1165778 191
9f7a72d0
Z
192XXX New or changed warnings emitted by the core's C<C> code go here. Also
193include any changes in L<perldiag> that reconcile it to the C<C> code.
68adb2b0 194
9f7a72d0 195[ Within each section, list entries as a =item entry ]
17096837 196
9f7a72d0 197=head2 New Diagnostics
3a5c9134 198
9f7a72d0 199XXX Newly added diagnostic messages go here
17096837 200
9f7a72d0 201=over 4
17096837 202
c2e0289e
FC
203=item *
204
9f7a72d0 205XXX
17096837 206
9f7a72d0 207=back
e6f1cc4d 208
9f7a72d0 209=head2 Changes to Existing Diagnostics
e1165778 210
9f7a72d0 211XXX Changes (i.e. rewording) of diagnostic messages go here
17096837 212
9f7a72d0 213=over 4
17096837 214
e1165778
Z
215=item *
216
9f7a72d0 217XXX
17096837 218
3a5c9134
CBW
219=back
220
9f7a72d0 221=head1 Utility Changes
e1165778 222
9f7a72d0
Z
223XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
224here. Most of these are built within the directories F<utils> and F<x2p>.
e1165778 225
9f7a72d0
Z
226[ List utility changes as a =head3 entry for each utility and =item
227entries for each change
228Use L<XXX> with program names to get proper documentation linking. ]
e1165778 229
9f7a72d0 230=head3 L<XXX>
e1165778 231
9f7a72d0 232=over 4
e1165778
Z
233
234=item *
235
9f7a72d0 236XXX
e1165778 237
9f7a72d0 238=back
e1165778 239
9f7a72d0 240=head1 Configuration and Compilation
e1165778 241
9f7a72d0
Z
242XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
243go here. Any other changes to the Perl build process should be listed here.
244However, any platform-specific changes should be listed in the
245L</Platform Support> section, instead.
e1165778 246
9f7a72d0 247[ List changes as a =item entry ].
e1165778 248
9f7a72d0 249=over 4
3a5c9134
CBW
250
251=item *
252
9f7a72d0 253XXX
3a5c9134
CBW
254
255=back
256
9f7a72d0 257=head1 Testing
3a5c9134 258
9f7a72d0
Z
259XXX Any significant changes to the testing of a freshly built perl should be
260listed here. Changes which create B<new> files in F<t/> go here as do any
261large changes to the testing harness (e.g. when parallel testing was added).
262Changes to existing files in F<t/> aren't worth summarising, although the bugs
263that they represent may be covered elsewhere.
3a5c9134 264
9f7a72d0 265[ List each test improvement as a =item entry ]
3a5c9134 266
3a5c9134
CBW
267=over 4
268
269=item *
270
9f7a72d0 271XXX
3a5c9134
CBW
272
273=back
274
9f7a72d0 275=head1 Platform Support
3a5c9134 276
9f7a72d0 277XXX Any changes to platform support should be listed in the sections below.
3a5c9134 278
9f7a72d0
Z
279[ Within the sections, list each platform as a =item entry with specific
280changes as paragraphs below it. ]
3a5c9134 281
9f7a72d0 282=head2 New Platforms
3a5c9134 283
9f7a72d0
Z
284XXX List any platforms that this version of perl compiles on, that previous
285versions did not. These will either be enabled by new files in the F<hints/>
286directories, or new subdirectories and F<README> files at the top level of the
287source tree.
3a5c9134 288
3a5c9134
CBW
289=over 4
290
9f7a72d0 291=item XXX-some-platform
3a5c9134 292
9f7a72d0 293XXX
51bed910 294
3a5c9134
CBW
295=back
296
9f7a72d0
Z
297=head2 Discontinued Platforms
298
299XXX List any platforms that this version of perl no longer compiles on.
3a5c9134 300
3a5c9134
CBW
301=over 4
302
9f7a72d0 303=item XXX-some-platform
3a5c9134 304
9f7a72d0 305XXX
3a5c9134
CBW
306
307=back
308
3a5c9134
CBW
309=head2 Platform-Specific Notes
310
9f7a72d0
Z
311XXX List any changes for specific platforms. This could include configuration
312and compilation changes or changes in portability/compatibility. However,
313changes within modules for platforms should generally be listed in the
314L</Modules and Pragmata> section.
3a5c9134 315
9f7a72d0 316=over 4
3a5c9134 317
9f7a72d0 318=item XXX-some-platform
fb3a2d89 319
9f7a72d0 320XXX
fb3a2d89 321
3a5c9134
CBW
322=back
323
324=head1 Internal Changes
325
9f7a72d0
Z
326XXX Changes which affect the interface available to C<XS> code go here.
327Other significant internal changes for future core maintainers should
328be noted as well.
3a5c9134 329
9f7a72d0 330[ List each test improvement as a =item entry ]
3a5c9134 331
9f7a72d0 332=over 4
3a5c9134 333
c61b6d0f
FC
334=item *
335
0a0e3cc5
NC
336The opcode bodies for C<chop> and C<chomp> and for C<schop> and C<schomp> have
337been merged. The implementation functions C<Perl_do_chop()> and
338C<Perl_do_chomp()>, never part of the public API, have been merged and moved to
339a static function in F<pp.c>. This shrinks the perl binary slightly, and should
340not affect any code outside the core (unless it is relying on the order of side
341effects when C<chomp> is passed a I<list> of values).
c61b6d0f 342
3a5c9134
CBW
343=back
344
345=head1 Selected Bug Fixes
346
9f7a72d0
Z
347XXX Important bug fixes in the core language are summarised here.
348Bug fixes in files in F<ext/> and F<lib/> are best summarised in
349L</Modules and Pragmata>.
b373eab8 350
9f7a72d0 351[ List each fix as a =item entry ]
b373eab8 352
9f7a72d0 353=over 4
4c9d53d5 354
0c7420e7
FC
355=item *
356
9f7a72d0 357XXX
0c7420e7 358
9f7a72d0 359=back
460c4bfb 360
9f7a72d0 361=head1 Known Problems
460c4bfb 362
9f7a72d0
Z
363XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
364tests that had to be C<TODO>ed for the release would be noted here, unless
365they were specific to a particular platform (see below).
26de4ac8 366
9f7a72d0
Z
367This is a list of some significant unfixed bugs, which are regressions
368from either 5.XXX.XXX or 5.XXX.XXX.
26de4ac8 369
9f7a72d0 370[ List each fix as a =item entry ]
ab7fb400 371
9f7a72d0 372=over 4
ab7fb400 373
836d5805
Z
374=item *
375
9f7a72d0 376XXX
836d5805 377
3a5c9134
CBW
378=back
379
9f7a72d0 380=head1 Obituary
3a5c9134 381
9f7a72d0
Z
382XXX If any significant core contributor has died, we've added a short obituary
383here.
b0c3724f 384
9f7a72d0 385=head1 Acknowledgements
b0c3724f 386
9f7a72d0 387XXX The list of people to thank goes here.
3a5c9134
CBW
388
389=head1 Reporting Bugs
390
391If you find what you think is a bug, you might check the articles
392recently posted to the comp.lang.perl.misc newsgroup and the perl
393bug database at http://rt.perl.org/perlbug/ . There may also be
394information at http://www.perl.org/ , the Perl Home Page.
395
396If you believe you have an unreported bug, please run the L<perlbug>
397program included with your release. Be sure to trim your bug down
398to a tiny but sufficient test case. Your bug report, along with the
399output of C<perl -V>, will be sent off to perlbug@perl.org to be
400analysed by the Perl porting team.
401
402If the bug you are reporting has security implications, which make it
403inappropriate to send to a publicly archived mailing list, then please send
404it to perl5-security-report@perl.org. This points to a closed subscription
405unarchived mailing list, which includes all the core committers, who be able
406to help assess the impact of issues, figure out a resolution, and help
407co-ordinate the release of patches to mitigate or fix the problem across all
408platforms on which Perl is supported. Please only use this address for
409security issues in the Perl core, not for modules independently
410distributed on CPAN.
411
412=head1 SEE ALSO
413
414The F<Changes> file for an explanation of how to view exhaustive details
415on what changed.
416
417The F<INSTALL> file for how to build Perl.
418
419The F<README> file for general stuff.
420
421The F<Artistic> and F<Copying> files for copyright information.
422
423=cut