This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
re.pm: correct typo
[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
6d4f9cf2
KW
29With this release, Perl is adopting a model that any unsigned value can
30be encoded internally as utf8 without warnings -- not just the ones that
31are legal in Unicode.
32However, unless UTF8 warnings have been
33explicitly lexically turned off, outputting or performing a
34Unicode-defined operation (such as upper-casing) on such a code point
35will generate a warning. Attempting to input these using strict rules
36(such as with the C<:encoding('UTF-8')> layer) will continue to fail.
37Prior to this release the handling was very inconsistent, and incorrect
38in places. Also, the Unicode non-characters, some of which previously were
39erroneously considered illegal in places by Perl, contrary to the Unicode
40standard, are now always legal internally. But inputting or outputting
41them will work the same as for the non-legal Unicode code points, as the
42Unicode standard says they are illegal for "open interchange".
43
9f7a72d0 44[ List each enhancement as a =head2 entry ]
0d157ee2 45
9f7a72d0 46=head1 Security
0d157ee2 47
9f7a72d0
Z
48XXX Any security-related notices go here. In particular, any security
49vulnerabilities closed should be noted here rather than in the
50L</Selected Bug Fixes> section.
bd8e866d 51
9f7a72d0 52[ List each security issue as a =head2 entry ]
bd8e866d 53
3a5c9134
CBW
54=head1 Incompatible Changes
55
9f7a72d0 56XXX For a release on a stable branch, this section aspires to be:
3a5c9134 57
9f7a72d0
Z
58 There are no changes intentionally incompatible with 5.XXX.XXX. If any
59 exist, they are bugs and reports are welcome.
3a5c9134 60
9f7a72d0 61[ List each incompatible change as a =head2 entry ]
d66e82e8 62
3a5c9134
CBW
63=head1 Deprecations
64
9f7a72d0
Z
65XXX Any deprecated features, syntax, modules etc. should be listed here.
66In particular, deprecated modules should be listed here even if they are
67listed as an updated module in the L</Modules and Pragmata> section.
5609d5f9 68
9f7a72d0 69[ List each deprecation as a =head2 entry ]
5609d5f9 70
9f7a72d0 71=head1 Performance Enhancements
5609d5f9 72
9f7a72d0
Z
73XXX Changes which enhance performance without changing behaviour go here. There
74may well be none in a stable release.
5609d5f9 75
9f7a72d0 76[ List each enhancement as a =item entry ]
3a5c9134
CBW
77
78=over 4
79
80=item *
81
9f7a72d0 82XXX
e1165778 83
9f7a72d0 84=back
121e1895 85
9f7a72d0 86=head1 Modules and Pragmata
2638c0ff 87
9f7a72d0
Z
88XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
89go here. If Module::CoreList is updated, generate an initial draft of the
90following sections using F<Porting/corelist-perldelta.pl>, which prints stub
91entries to STDOUT. Results can be pasted in place of the '=head2' entries
92below. A paragraph summary for important changes should then be added by hand.
93In an ideal world, dual-life modules would have a F<Changes> file that could be
94cribbed.
2638c0ff 95
9f7a72d0 96[ Within each section, list entries as a =item entry ]
17096837 97
9f7a72d0 98=head2 New Modules and Pragmata
2638c0ff 99
9f7a72d0 100=over 4
17096837 101
e1165778
Z
102=item *
103
e8a07a12
DG
104L<CPAN::Meta::YAML> 0.002 has been added as a dual-life module. It supports a
105subset of YAML sufficient for reading and writing META.yml and MYMETA.yml files
106included with CPAN distributions or generated by the module installation
107toolchain. It should not be used for any other general YAML parsing or
108generation task.
17096837 109
935c8d19
DG
110=item *
111
6cf6332a 112L<Module::Metadata> 1.000003 has been added as a dual-life module. It gathers
e8b333e6
DG
113package and POD information from Perl module files. It is a standalone module
114based on Module::Build::ModuleInfo for use by other module installation
115toolchain components. Module::Build::ModuleInfo has been deprecated in
116favor of this module instead.
117
118=item *
119
935c8d19
DG
120L<Perl::OSType> 1.002 has been added as a dual-life module. It maps Perl
121operating system names (e.g. 'dragonfly' or 'MSWin32') to more generic types
122with standardized names (e.g. "Unix" or "Windows"). It has been refactored
123out of Module::Build and ExtUtils::CBuilder and consolidates such mappings into
124a single location for easier maintenance.
125
9f7a72d0 126=back
e1165778 127
9f7a72d0 128=head2 Updated Modules and Pragmata
f295f417 129
9f7a72d0 130=over 4
17096837 131
f295f417
FC
132=item *
133
6447e912
CBW
134C<Archive::Extract> has been upgraded from version 0.46 to 0.48
135
136=item *
137
89ae55b4
CBW
138C<Archive::Tar> has been upgraded from version 1.74 to 1.76
139
140=item *
141
2a1594f6
CBW
142C<CGI> has been upgraded from version 3.50 to 3.51
143
144=item *
5ebf8416
CBW
145
146C<Compress::Raw::Bzip2> has been upgraded from version 2.031 to 2.033
147
148=item *
e2f1db54
CBW
149
150C<Compress::Raw::Zlib> has been upgraded from version 2.030 to 2.033
151
152=item *
2a1594f6 153
f1aaabf8
CBW
154C<CPANPLUS> has been upgraded from version 0.9010 to 0.9011
155
156=item *
157
ae0f8eee
CBW
158C<CPANPLUS::Dist::Build> has been upgraded from version 0.50 to 0.52
159
160=item *
161
162C<DB_File> has been upgraded from version 1.820 to 1.821
deb99cce
CBW
163
164=item *
165
6d4f9cf2
KW
166C<Encode> has been upgraded from version 2.40 to 2.42.
167Now, all 66 Unicode non-characters are treated the same way U+FFFF has
168always been treated; if it was disallowed, all 66 are disallowed; if it
169warned, all 66 warn.
50afc8f8
CBW
170
171=item *
172
ac066c2a 173C<File::Fetch> has been upgraded from version 0.28 to 0.30
f37ee46a
CBW
174
175=item *
176
cd0c0e65
CBW
177C<IO::Compress> has been upgraded from version 2.030 to 2.033
178
179=item *
180
f37ee46a
CBW
181C<IPC::Cmd> has been upgraded from version 0.66 to 0.68
182
ac066c2a
CBW
183=item *
184
b5ce1198
CBW
185C<Log::Message> has been upgraded from version 0.02 to 0.04
186
187=item *
188
ae0f8eee 189C<Module::Load::Conditional> has been upgraded from version 0.38 to 0.40
4fc94532
CBW
190
191=item *
192
ae0f8eee 193C<Object::Accessor> has been upgraded from version 0.36 to 0.38
0019012a
CBW
194
195=item *
196
ae0f8eee 197C<Params::Check> has been upgraded from version 0.26 to 0.28
8cb3aa53
CBW
198
199=item *
200
9c88a88b
CBW
201C<Pod::LaTeX> has been upgraded from version 0.58 to 0.59
202
203=item *
204
6df88f97 205C<Term::UI> has been upgraded from version 0.20 to 0.24
8e1e0801
CBW
206
207=item *
208
f5d41534
CBW
209C<threads> has been upgraded from version 1.81_03 to 1.82
210
211=item *
212
213C<threads::shared> has been upgraded from version 1.35 to 1.36
214
215=item *
216
23046b7e 217C<Time::Local> has been upgraded from version 1.1901_01 to 1.2000.
17096837 218
9f7a72d0 219=back
e1165778 220
9f7a72d0 221=head2 Removed Modules and Pragmata
b373eab8 222
9f7a72d0 223=over 4
b373eab8
FC
224
225=item *
226
9f7a72d0 227XXX
b6ae81ab 228
9f7a72d0 229=back
ca88a729 230
9f7a72d0 231=head1 Documentation
17096837 232
9f7a72d0
Z
233XXX Changes to files in F<pod/> go here. Consider grouping entries by
234file and be sure to link to the appropriate page, e.g. L<perlfunc>.
b6ae81ab 235
9f7a72d0 236=head2 New Documentation
e1165778 237
9f7a72d0 238XXX Changes which create B<new> files in F<pod/> go here.
17096837 239
9f7a72d0 240=head3 L<XXX>
e1165778 241
9f7a72d0 242XXX Description of the purpose of the new file here
e1165778 243
9f7a72d0 244=head2 Changes to Existing Documentation
17096837 245
9f7a72d0
Z
246XXX Changes which significantly change existing files in F<pod/> go here.
247However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
248section.
e1165778 249
9f7a72d0 250=head3 L<XXX>
d4238815 251
9f7a72d0 252=over 4
17096837 253
d4238815
FC
254=item *
255
9f7a72d0 256XXX Description of the change here
e1165778 257
9f7a72d0 258=back
17096837 259
9f7a72d0 260=head1 Diagnostics
17096837 261
9f7a72d0
Z
262The following additions or changes have been made to diagnostic output,
263including warnings and fatal error messages. For the complete list of
264diagnostic messages, see L<perldiag>.
e1165778 265
9f7a72d0
Z
266XXX New or changed warnings emitted by the core's C<C> code go here. Also
267include any changes in L<perldiag> that reconcile it to the C<C> code.
68adb2b0 268
9f7a72d0 269[ Within each section, list entries as a =item entry ]
17096837 270
9f7a72d0 271=head2 New Diagnostics
3a5c9134 272
9f7a72d0 273XXX Newly added diagnostic messages go here
17096837 274
9f7a72d0 275=over 4
17096837 276
c2e0289e
FC
277=item *
278
9f7a72d0 279XXX
17096837 280
9f7a72d0 281=back
e6f1cc4d 282
9f7a72d0 283=head2 Changes to Existing Diagnostics
e1165778 284
9f7a72d0 285XXX Changes (i.e. rewording) of diagnostic messages go here
17096837 286
9f7a72d0 287=over 4
17096837 288
e1165778
Z
289=item *
290
9f7a72d0 291XXX
17096837 292
3a5c9134
CBW
293=back
294
9f7a72d0 295=head1 Utility Changes
e1165778 296
9f7a72d0
Z
297XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
298here. Most of these are built within the directories F<utils> and F<x2p>.
e1165778 299
9f7a72d0
Z
300[ List utility changes as a =head3 entry for each utility and =item
301entries for each change
302Use L<XXX> with program names to get proper documentation linking. ]
e1165778 303
9f7a72d0 304=head3 L<XXX>
e1165778 305
9f7a72d0 306=over 4
e1165778
Z
307
308=item *
309
9f7a72d0 310XXX
e1165778 311
9f7a72d0 312=back
e1165778 313
9f7a72d0 314=head1 Configuration and Compilation
e1165778 315
9f7a72d0
Z
316XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
317go here. Any other changes to the Perl build process should be listed here.
318However, any platform-specific changes should be listed in the
319L</Platform Support> section, instead.
e1165778 320
9f7a72d0 321[ List changes as a =item entry ].
e1165778 322
9f7a72d0 323=over 4
3a5c9134
CBW
324
325=item *
326
9f7a72d0 327XXX
3a5c9134
CBW
328
329=back
330
9f7a72d0 331=head1 Testing
3a5c9134 332
9f7a72d0
Z
333XXX Any significant changes to the testing of a freshly built perl should be
334listed here. Changes which create B<new> files in F<t/> go here as do any
335large changes to the testing harness (e.g. when parallel testing was added).
336Changes to existing files in F<t/> aren't worth summarising, although the bugs
337that they represent may be covered elsewhere.
3a5c9134 338
9f7a72d0 339[ List each test improvement as a =item entry ]
3a5c9134 340
3a5c9134
CBW
341=over 4
342
343=item *
344
9f7a72d0 345XXX
3a5c9134
CBW
346
347=back
348
9f7a72d0 349=head1 Platform Support
3a5c9134 350
9f7a72d0 351XXX Any changes to platform support should be listed in the sections below.
3a5c9134 352
9f7a72d0
Z
353[ Within the sections, list each platform as a =item entry with specific
354changes as paragraphs below it. ]
3a5c9134 355
9f7a72d0 356=head2 New Platforms
3a5c9134 357
9f7a72d0
Z
358XXX List any platforms that this version of perl compiles on, that previous
359versions did not. These will either be enabled by new files in the F<hints/>
360directories, or new subdirectories and F<README> files at the top level of the
361source tree.
3a5c9134 362
3a5c9134
CBW
363=over 4
364
9f7a72d0 365=item XXX-some-platform
3a5c9134 366
9f7a72d0 367XXX
51bed910 368
3a5c9134
CBW
369=back
370
9f7a72d0
Z
371=head2 Discontinued Platforms
372
373XXX List any platforms that this version of perl no longer compiles on.
3a5c9134 374
3a5c9134
CBW
375=over 4
376
9f7a72d0 377=item XXX-some-platform
3a5c9134 378
9f7a72d0 379XXX
3a5c9134
CBW
380
381=back
382
3a5c9134
CBW
383=head2 Platform-Specific Notes
384
9f7a72d0
Z
385XXX List any changes for specific platforms. This could include configuration
386and compilation changes or changes in portability/compatibility. However,
387changes within modules for platforms should generally be listed in the
388L</Modules and Pragmata> section.
3a5c9134 389
9f7a72d0 390=over 4
3a5c9134 391
9f7a72d0 392=item XXX-some-platform
fb3a2d89 393
9f7a72d0 394XXX
fb3a2d89 395
3a5c9134
CBW
396=back
397
398=head1 Internal Changes
399
9f7a72d0
Z
400XXX Changes which affect the interface available to C<XS> code go here.
401Other significant internal changes for future core maintainers should
402be noted as well.
3a5c9134 403
9f7a72d0 404[ List each test improvement as a =item entry ]
3a5c9134 405
9f7a72d0 406=over 4
3a5c9134 407
c61b6d0f
FC
408=item *
409
0a0e3cc5
NC
410The opcode bodies for C<chop> and C<chomp> and for C<schop> and C<schomp> have
411been merged. The implementation functions C<Perl_do_chop()> and
412C<Perl_do_chomp()>, never part of the public API, have been merged and moved to
413a static function in F<pp.c>. This shrinks the perl binary slightly, and should
414not affect any code outside the core (unless it is relying on the order of side
415effects when C<chomp> is passed a I<list> of values).
c61b6d0f 416
6d4f9cf2
KW
417=item *
418
419Some of the flags parameters to the uvuni_to_utf8_flags() and
420utf8n_to_uvuni() have changed. This is a result of Perl now allowing
421internal storage and manipulation of code points that are problematic
422in some situations. Hence, the default actions for these functions has
423been complemented to allow these code points. The new flags are
424documented in L<perlapi>. Code that requires the problematic code
425points to be rejected needs to change to use these flags. Some flag
426names are retained for backward source compatibility, though they do
427nothing, as they are now the default. However the flags
428C<UNICODE_ALLOW_FDD0>, C<UNICODE_ALLOW_FFFF>, C<UNICODE_ILLEGAL>, and
429C<UNICODE_IS_ILLEGAL> have been removed, as they stem from a
430fundamentally broken model of how the Unicode non-character code points
431should be handled, which is now described in
432L<perlunicode/Non-character code points>. See also L</Selected Bug Fixes>.
433
3a5c9134
CBW
434=back
435
436=head1 Selected Bug Fixes
437
9f7a72d0
Z
438XXX Important bug fixes in the core language are summarised here.
439Bug fixes in files in F<ext/> and F<lib/> are best summarised in
440L</Modules and Pragmata>.
b373eab8 441
9f7a72d0 442[ List each fix as a =item entry ]
b373eab8 443
9f7a72d0 444=over 4
4c9d53d5 445
0c7420e7
FC
446=item *
447
6d4f9cf2
KW
448The handling of Unicode non-characters has changed.
449Previously they were mostly considered illegal, except that only one of
450the 66 of them was known about in places. The Unicode standard
451considers them legal, but forbids the "open interchange" of them.
452This is part of the change to allow the internal use of any code point
453(see L</Core Enhancements>). Together, these changes resolve
454L<# 38722|https://rt.perl.org/rt3/Ticket/Display.html?id=38722>,
455L<# 51918|http://rt.perl.org/rt3/Ticket/Display.html?id=51918>,
456L<# 51936|http://rt.perl.org/rt3/Ticket/Display.html?id=51936>,
457L<# 63446|http://rt.perl.org/rt3/Ticket/Display.html?id=63446>
0c7420e7 458
9f7a72d0 459=back
460c4bfb 460
9f7a72d0 461=head1 Known Problems
460c4bfb 462
9f7a72d0
Z
463XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
464tests that had to be C<TODO>ed for the release would be noted here, unless
465they were specific to a particular platform (see below).
26de4ac8 466
9f7a72d0
Z
467This is a list of some significant unfixed bugs, which are regressions
468from either 5.XXX.XXX or 5.XXX.XXX.
26de4ac8 469
9f7a72d0 470[ List each fix as a =item entry ]
ab7fb400 471
9f7a72d0 472=over 4
ab7fb400 473
836d5805
Z
474=item *
475
9f7a72d0 476XXX
836d5805 477
3a5c9134
CBW
478=back
479
9f7a72d0 480=head1 Obituary
3a5c9134 481
9f7a72d0
Z
482XXX If any significant core contributor has died, we've added a short obituary
483here.
b0c3724f 484
9f7a72d0 485=head1 Acknowledgements
b0c3724f 486
9f7a72d0 487XXX The list of people to thank goes here.
3a5c9134
CBW
488
489=head1 Reporting Bugs
490
491If you find what you think is a bug, you might check the articles
492recently posted to the comp.lang.perl.misc newsgroup and the perl
493bug database at http://rt.perl.org/perlbug/ . There may also be
494information at http://www.perl.org/ , the Perl Home Page.
495
496If you believe you have an unreported bug, please run the L<perlbug>
497program included with your release. Be sure to trim your bug down
498to a tiny but sufficient test case. Your bug report, along with the
499output of C<perl -V>, will be sent off to perlbug@perl.org to be
500analysed by the Perl porting team.
501
502If the bug you are reporting has security implications, which make it
503inappropriate to send to a publicly archived mailing list, then please send
504it to perl5-security-report@perl.org. This points to a closed subscription
505unarchived mailing list, which includes all the core committers, who be able
506to help assess the impact of issues, figure out a resolution, and help
507co-ordinate the release of patches to mitigate or fix the problem across all
508platforms on which Perl is supported. Please only use this address for
509security issues in the Perl core, not for modules independently
510distributed on CPAN.
511
512=head1 SEE ALSO
513
514The F<Changes> file for an explanation of how to view exhaustive details
515on what changed.
516
517The F<INSTALL> file for how to build Perl.
518
519The F<README> file for general stuff.
520
521The F<Artistic> and F<Copying> files for copyright information.
522
523=cut