This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Update IPC-Cmd to CPAN version 0.68
[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
ac066c2a 135C<File::Fetch> has been upgraded from version 0.28 to 0.30
f37ee46a
CBW
136
137=item *
138
139C<IPC::Cmd> has been upgraded from version 0.66 to 0.68
140
ac066c2a
CBW
141=item *
142
f5d41534
CBW
143C<threads> has been upgraded from version 1.81_03 to 1.82
144
145=item *
146
147C<threads::shared> has been upgraded from version 1.35 to 1.36
148
149=item *
150
23046b7e 151C<Time::Local> has been upgraded from version 1.1901_01 to 1.2000.
17096837 152
9f7a72d0 153=back
e1165778 154
9f7a72d0 155=head2 Removed Modules and Pragmata
b373eab8 156
9f7a72d0 157=over 4
b373eab8
FC
158
159=item *
160
9f7a72d0 161XXX
b6ae81ab 162
9f7a72d0 163=back
ca88a729 164
9f7a72d0 165=head1 Documentation
17096837 166
9f7a72d0
Z
167XXX Changes to files in F<pod/> go here. Consider grouping entries by
168file and be sure to link to the appropriate page, e.g. L<perlfunc>.
b6ae81ab 169
9f7a72d0 170=head2 New Documentation
e1165778 171
9f7a72d0 172XXX Changes which create B<new> files in F<pod/> go here.
17096837 173
9f7a72d0 174=head3 L<XXX>
e1165778 175
9f7a72d0 176XXX Description of the purpose of the new file here
e1165778 177
9f7a72d0 178=head2 Changes to Existing Documentation
17096837 179
9f7a72d0
Z
180XXX Changes which significantly change existing files in F<pod/> go here.
181However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
182section.
e1165778 183
9f7a72d0 184=head3 L<XXX>
d4238815 185
9f7a72d0 186=over 4
17096837 187
d4238815
FC
188=item *
189
9f7a72d0 190XXX Description of the change here
e1165778 191
9f7a72d0 192=back
17096837 193
9f7a72d0 194=head1 Diagnostics
17096837 195
9f7a72d0
Z
196The following additions or changes have been made to diagnostic output,
197including warnings and fatal error messages. For the complete list of
198diagnostic messages, see L<perldiag>.
e1165778 199
9f7a72d0
Z
200XXX New or changed warnings emitted by the core's C<C> code go here. Also
201include any changes in L<perldiag> that reconcile it to the C<C> code.
68adb2b0 202
9f7a72d0 203[ Within each section, list entries as a =item entry ]
17096837 204
9f7a72d0 205=head2 New Diagnostics
3a5c9134 206
9f7a72d0 207XXX Newly added diagnostic messages go here
17096837 208
9f7a72d0 209=over 4
17096837 210
c2e0289e
FC
211=item *
212
9f7a72d0 213XXX
17096837 214
9f7a72d0 215=back
e6f1cc4d 216
9f7a72d0 217=head2 Changes to Existing Diagnostics
e1165778 218
9f7a72d0 219XXX Changes (i.e. rewording) of diagnostic messages go here
17096837 220
9f7a72d0 221=over 4
17096837 222
e1165778
Z
223=item *
224
9f7a72d0 225XXX
17096837 226
3a5c9134
CBW
227=back
228
9f7a72d0 229=head1 Utility Changes
e1165778 230
9f7a72d0
Z
231XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
232here. Most of these are built within the directories F<utils> and F<x2p>.
e1165778 233
9f7a72d0
Z
234[ List utility changes as a =head3 entry for each utility and =item
235entries for each change
236Use L<XXX> with program names to get proper documentation linking. ]
e1165778 237
9f7a72d0 238=head3 L<XXX>
e1165778 239
9f7a72d0 240=over 4
e1165778
Z
241
242=item *
243
9f7a72d0 244XXX
e1165778 245
9f7a72d0 246=back
e1165778 247
9f7a72d0 248=head1 Configuration and Compilation
e1165778 249
9f7a72d0
Z
250XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
251go here. Any other changes to the Perl build process should be listed here.
252However, any platform-specific changes should be listed in the
253L</Platform Support> section, instead.
e1165778 254
9f7a72d0 255[ List changes as a =item entry ].
e1165778 256
9f7a72d0 257=over 4
3a5c9134
CBW
258
259=item *
260
9f7a72d0 261XXX
3a5c9134
CBW
262
263=back
264
9f7a72d0 265=head1 Testing
3a5c9134 266
9f7a72d0
Z
267XXX Any significant changes to the testing of a freshly built perl should be
268listed here. Changes which create B<new> files in F<t/> go here as do any
269large changes to the testing harness (e.g. when parallel testing was added).
270Changes to existing files in F<t/> aren't worth summarising, although the bugs
271that they represent may be covered elsewhere.
3a5c9134 272
9f7a72d0 273[ List each test improvement as a =item entry ]
3a5c9134 274
3a5c9134
CBW
275=over 4
276
277=item *
278
9f7a72d0 279XXX
3a5c9134
CBW
280
281=back
282
9f7a72d0 283=head1 Platform Support
3a5c9134 284
9f7a72d0 285XXX Any changes to platform support should be listed in the sections below.
3a5c9134 286
9f7a72d0
Z
287[ Within the sections, list each platform as a =item entry with specific
288changes as paragraphs below it. ]
3a5c9134 289
9f7a72d0 290=head2 New Platforms
3a5c9134 291
9f7a72d0
Z
292XXX List any platforms that this version of perl compiles on, that previous
293versions did not. These will either be enabled by new files in the F<hints/>
294directories, or new subdirectories and F<README> files at the top level of the
295source tree.
3a5c9134 296
3a5c9134
CBW
297=over 4
298
9f7a72d0 299=item XXX-some-platform
3a5c9134 300
9f7a72d0 301XXX
51bed910 302
3a5c9134
CBW
303=back
304
9f7a72d0
Z
305=head2 Discontinued Platforms
306
307XXX List any platforms that this version of perl no longer compiles on.
3a5c9134 308
3a5c9134
CBW
309=over 4
310
9f7a72d0 311=item XXX-some-platform
3a5c9134 312
9f7a72d0 313XXX
3a5c9134
CBW
314
315=back
316
3a5c9134
CBW
317=head2 Platform-Specific Notes
318
9f7a72d0
Z
319XXX List any changes for specific platforms. This could include configuration
320and compilation changes or changes in portability/compatibility. However,
321changes within modules for platforms should generally be listed in the
322L</Modules and Pragmata> section.
3a5c9134 323
9f7a72d0 324=over 4
3a5c9134 325
9f7a72d0 326=item XXX-some-platform
fb3a2d89 327
9f7a72d0 328XXX
fb3a2d89 329
3a5c9134
CBW
330=back
331
332=head1 Internal Changes
333
9f7a72d0
Z
334XXX Changes which affect the interface available to C<XS> code go here.
335Other significant internal changes for future core maintainers should
336be noted as well.
3a5c9134 337
9f7a72d0 338[ List each test improvement as a =item entry ]
3a5c9134 339
9f7a72d0 340=over 4
3a5c9134 341
c61b6d0f
FC
342=item *
343
0a0e3cc5
NC
344The opcode bodies for C<chop> and C<chomp> and for C<schop> and C<schomp> have
345been merged. The implementation functions C<Perl_do_chop()> and
346C<Perl_do_chomp()>, never part of the public API, have been merged and moved to
347a static function in F<pp.c>. This shrinks the perl binary slightly, and should
348not affect any code outside the core (unless it is relying on the order of side
349effects when C<chomp> is passed a I<list> of values).
c61b6d0f 350
3a5c9134
CBW
351=back
352
353=head1 Selected Bug Fixes
354
9f7a72d0
Z
355XXX Important bug fixes in the core language are summarised here.
356Bug fixes in files in F<ext/> and F<lib/> are best summarised in
357L</Modules and Pragmata>.
b373eab8 358
9f7a72d0 359[ List each fix as a =item entry ]
b373eab8 360
9f7a72d0 361=over 4
4c9d53d5 362
0c7420e7
FC
363=item *
364
9f7a72d0 365XXX
0c7420e7 366
9f7a72d0 367=back
460c4bfb 368
9f7a72d0 369=head1 Known Problems
460c4bfb 370
9f7a72d0
Z
371XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
372tests that had to be C<TODO>ed for the release would be noted here, unless
373they were specific to a particular platform (see below).
26de4ac8 374
9f7a72d0
Z
375This is a list of some significant unfixed bugs, which are regressions
376from either 5.XXX.XXX or 5.XXX.XXX.
26de4ac8 377
9f7a72d0 378[ List each fix as a =item entry ]
ab7fb400 379
9f7a72d0 380=over 4
ab7fb400 381
836d5805
Z
382=item *
383
9f7a72d0 384XXX
836d5805 385
3a5c9134
CBW
386=back
387
9f7a72d0 388=head1 Obituary
3a5c9134 389
9f7a72d0
Z
390XXX If any significant core contributor has died, we've added a short obituary
391here.
b0c3724f 392
9f7a72d0 393=head1 Acknowledgements
b0c3724f 394
9f7a72d0 395XXX The list of people to thank goes here.
3a5c9134
CBW
396
397=head1 Reporting Bugs
398
399If you find what you think is a bug, you might check the articles
400recently posted to the comp.lang.perl.misc newsgroup and the perl
401bug database at http://rt.perl.org/perlbug/ . There may also be
402information at http://www.perl.org/ , the Perl Home Page.
403
404If you believe you have an unreported bug, please run the L<perlbug>
405program included with your release. Be sure to trim your bug down
406to a tiny but sufficient test case. Your bug report, along with the
407output of C<perl -V>, will be sent off to perlbug@perl.org to be
408analysed by the Perl porting team.
409
410If the bug you are reporting has security implications, which make it
411inappropriate to send to a publicly archived mailing list, then please send
412it to perl5-security-report@perl.org. This points to a closed subscription
413unarchived mailing list, which includes all the core committers, who be able
414to help assess the impact of issues, figure out a resolution, and help
415co-ordinate the release of patches to mitigate or fix the problem across all
416platforms on which Perl is supported. Please only use this address for
417security issues in the Perl core, not for modules independently
418distributed on CPAN.
419
420=head1 SEE ALSO
421
422The F<Changes> file for an explanation of how to view exhaustive details
423on what changed.
424
425The F<INSTALL> file for how to build Perl.
426
427The F<README> file for general stuff.
428
429The F<Artistic> and F<Copying> files for copyright information.
430
431=cut