This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta for File::Copy and newlines
[perl5.git] / pod / perldelta.pod
CommitLineData
44691e6f
AB
1=encoding utf8
2
249950d7 3=for comment
a3cc0403 4This has been completed up to 92c88ef1fd, except for:
10c62b23 5803e389 rurban CYG17 utf8 paths
ff4ff6f3 6d9298c1 rurban mymalloc isn't thread safe
249950d7 7
44691e6f
AB
8=head1 NAME
9
c1e74734
CBW
10[ this is a template for a new perldelta file. Any text flagged as
11XXX needs to be processed before release. ]
ad32999b 12
c1e74734 13perldelta - what is new for perl v5.15.8
88c5c971 14
c1e74734 15=head1 DESCRIPTION
8f12b018 16
c1e74734
CBW
17This document describes differences between the 5.15.7 release and
18the 5.15.8 release.
8f12b018 19
c1e74734
CBW
20If you are upgrading from an earlier release such as 5.15.6, first read
21L<perl5157delta>, which describes differences between 5.15.6 and
225.15.7.
26afcec5 23
c1e74734 24=head1 Notice
8f12b018 25
c1e74734 26XXX Any important notices here
d7fbd56d 27
c1e74734 28=head1 Core Enhancements
d7fbd56d 29
c1e74734
CBW
30XXX New core language features go here. Summarise user-visible core language
31enhancements. Particularly prominent performance optimisations could go
32here, but most should go in the L</Performance Enhancements> section.
d7fbd56d 33
c1e74734 34[ List each enhancement as a =head2 entry ]
711a3903 35
66cbab2c
KW
36=head2 Improved ability to mix locales and Unicode, including UTF-8 locales
37
38An optional parameter has been added to C<use locale>
39
40 use locale ':not_characters';
41
42which tells Perl to use all but the C<LC_CTYPE> and C<LC_COLLATE>
43portions of the current locale. Instead, the character set is assumed
44to be Unicode. This allows locales and Unicode to be seamlessly mixed,
45including the increasingly frequent UTF-8 locales. When using this
46hybrid form of locales, the C<:locale> layer to the L<open> pragma can
47be used to interface with the file system, and there are CPAN modules
48available for ARGV and environment variable conversions.
49
50Full details are in L<perllocale>.
51
628253b8
BF
52=head2 New function C<fc> and corresponding escape sequence C<\F> for Unicode foldcase
53
54Unicode foldcase is an extension to lowercase that gives better results
55when comparing two strings case-insensitively. It has long been used
56internally in regular expression C</i> matching. Now it is available
57explicitly through the new C<fc> function call (enabled by
58S<C<"use feature 'fc'">>, or C<use v5.16>, or explicitly callable via
249950d7 59C<CORE::fc>) or through the new C<\F> sequence in double-quotish
628253b8
BF
60strings.
61
62Full details are in L<perlfunc/fc>.
63
10c62b23
FC
64=head2 C<_> in subroutine prototypes
65
66The C<_> character in subroutine prototypes is now allowed before C<@> or
67C<%>.
68
c1e74734 69=head1 Security
711a3903 70
c1e74734
CBW
71XXX Any security-related notices go here. In particular, any security
72vulnerabilities closed should be noted here rather than in the
73L</Selected Bug Fixes> section.
711a3903 74
c1e74734 75[ List each security issue as a =head2 entry ]
6ba817f3 76
c1e74734 77=head1 Incompatible Changes
6ba817f3 78
c1e74734 79XXX For a release on a stable branch, this section aspires to be:
6b339779 80
c1e74734
CBW
81 There are no changes intentionally incompatible with 5.XXX.XXX
82 If any exist, they are bugs, and we request that you submit a
83 report. See L</Reporting Bugs> below.
6b339779 84
c1e74734 85[ List each incompatible change as a =head2 entry ]
b240fc0f 86
249950d7
FC
87=head2 Special blocks called in void context
88
89Special blocks (C<BEGIN>, C<CHECK>, C<INIT>, C<UNITCHECK>, C<END>) are now
90called in void context. This avoids wasteful copying of the result of the
91last statement [perl #108794].
92
eff8c8ec
FC
93=head2 The C<overloading> pragma and regexp objects
94
95With C<no overloading>, regular expression objects returned by C<qr//> are
96now stringified as "Regexp=REGEXP(0xbe600d)" instead of the regular
97expression itself [perl #108780].
98
84ecb73f
SM
99=head2 Two XS typemap Entries removed
100
101Two presumably unused XS typemap entries have been removed from the
102core typemap: T_DATAUNIT and T_CALLBACK. If you are, against all odds,
103a user of these, please see the instructions on how to regain them
104in L<perlxstypemap>.
105
c1e74734 106=head1 Deprecations
b240fc0f 107
c1e74734
CBW
108XXX Any deprecated features, syntax, modules etc. should be listed here.
109In particular, deprecated modules should be listed here even if they are
110listed as an updated module in the L</Modules and Pragmata> section.
4e6ab4ad 111
c1e74734 112[ List each deprecation as a =head2 entry ]
4e6ab4ad 113
c1e74734 114=head1 Performance Enhancements
79e10968 115
c1e74734
CBW
116XXX Changes which enhance performance without changing behaviour go here. There
117may well be none in a stable release.
79e10968 118
c1e74734 119[ List each enhancement as a =item entry ]
ea88c40c 120
c1e74734 121=over 4
9d055b1a
CBW
122
123=item *
124
c1e74734 125XXX
cadced9f 126
c1e74734 127=back
cadced9f 128
c1e74734 129=head1 Modules and Pragmata
cadced9f 130
c1e74734
CBW
131XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
132go here. If Module::CoreList is updated, generate an initial draft of the
133following sections using F<Porting/corelist-perldelta.pl>, which prints stub
134entries to STDOUT. Results can be pasted in place of the '=head2' entries
135below. A paragraph summary for important changes should then be added by hand.
136In an ideal world, dual-life modules would have a F<Changes> file that could be
137cribbed.
cadced9f 138
c1e74734 139[ Within each section, list entries as a =item entry ]
07feb684 140
c1e74734 141=head2 New Modules and Pragmata
cadced9f 142
c1e74734 143=over 4
632c5d30
NC
144
145=item *
146
2f987927
FC
147The C<mmap> PerlIO layer is no longer implemented by perl itself, but has
148been moved out into the new L<PerlIO::mmap> module.
4e6e9b23 149
c1e74734 150=back
4e6e9b23 151
c1e74734 152=head2 Updated Modules and Pragmata
4e6e9b23 153
c1e74734 154=over 4
1887da8c
RS
155
156=item *
157
197aacaf
FC
158L<B> has been upgraded from version 1.33 to version 1.34.
159
160C<B::COP> now has a C<stashflags> method, corresponding to a new internal
161field added in 5.15.4 [perl #108860].
162
163=item *
164
df697508 165L<Compress::Raw::Bzip2> has been upgraded from version 2.045 to version 2.048.
76f546a2
CBW
166
167=item *
168
ecea5ab2 169L<Compress::Raw::Zlib> has been upgraded from version 2.045 to version 2.048.
589c1691
CBW
170
171=item *
172
8dcc3739 173L<Compress::Zlib> has been upgraded from version 2.046 to version 2.048.
422d6414
CBW
174
175=item *
176
b34385a6 177L<DB_File> has been upgraded from version 1.824 to version 1.826.
acb29889
CBW
178
179=item *
180
ce2c4022
NC
181L<diagnostics> has been upgraded from version 1.27 to version 1.28.
182
183When searching for F<perldiag.pod>, it no longer uses paths that were only
184relevant on Perl 5.004 and earlier.
185
186=item *
187
84ecb73f
SM
188L<ExtUtils::ParseXS> has been upgraded from version 3.12 to version 3.15.
189
190The new version comes with important tools for sharing typemaps between
191different CPAN distributions.
192
193=item *
194
a3cc0403
FC
195L<File::Copy> has been upgraded from version 2.21 to version 2.23.
196
197It no longer emits warnings when copying files with newlines in their names
198[perl #109104].
199
200=item *
201
eb96f3fa
CBW
202L<IPC::Cmd> has been upgraded from version 0.72 to version 0.76.
203
204=item *
205
04ae1553
Z
206L<Math::Complex> has been upgraded from version 1.58 to version 1.59.
207
208This avoids a new core warning.
209
210=item *
211
1051d5b5 212L<Pod::Parser> has been upgraded from version 1.37 to version 1.51.
88c5c971 213
2a7afa74
NC
214=item *
215
ecd144ea
FC
216L<Term::ReadLine> has been upgraded from version 1.07 to version 1.08.
217
218Its C<tkRunning> method now supports L<AnyEvent> event loops, and not just
219L<Tk>. A more general mechanism has been proposed, so this may be reverted
220before Perl 5.16 [perl #108470].
221
222=item *
223
858dcda5
Z
224L<Time::HiRes> has been upgraded from version 1.9724 to version 1.9725.
225
694644e0 226C<Time::HiRes::stat()> no longer corrupts the Perl stack.
858dcda5
Z
227
228=item *
229
2a7afa74
NC
230L<Unicode::UCD> has been upgraded from version 0.39 to 0.40.
231
232The only change is to fix a formatting error in the Pod.
233
c1e74734 234=back
c0504019 235
c1e74734 236=head2 Removed Modules and Pragmata
937a45d0 237
c1e74734 238=over 4
937a45d0 239
ef337e16
CBW
240=item *
241
c1e74734 242XXX
ef337e16 243
7f28d7ed 244=back
679b54e7 245
52deee2e 246=head1 Documentation
3c7c5233 247
c1e74734
CBW
248XXX Changes to files in F<pod/> go here. Consider grouping entries by
249file and be sure to link to the appropriate page, e.g. L<perlfunc>.
a71d67b1 250
c1e74734 251=head2 New Documentation
cadced9f 252
c1e74734 253XXX Changes which create B<new> files in F<pod/> go here.
cadced9f 254
84ecb73f
SM
255=head3 L<perlxstypemap>
256
257The new manual describes the XS typemapping mechanism in unprecedented
258detail and combines new documentation with information extracted from
259L<perlxs> and the previously unofficial list of all core typemaps.
260
c1e74734 261=head3 L<XXX>
cadced9f 262
c1e74734 263XXX Description of the purpose of the new file here
cadced9f 264
c1e74734 265=head2 Changes to Existing Documentation
cadced9f 266
c1e74734
CBW
267XXX Changes which significantly change existing files in F<pod/> go here.
268However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
269section.
cadced9f 270
c1e74734 271=head3 L<XXX>
7e7629fa 272
52deee2e 273=over 4
7e7629fa
FC
274
275=item *
276
c1e74734 277XXX Description of the change here
c2654555 278
52deee2e 279=back
85ca3be7 280
52deee2e 281=head1 Diagnostics
85ca3be7 282
52deee2e
DR
283The following additions or changes have been made to diagnostic output,
284including warnings and fatal error messages. For the complete list of
285diagnostic messages, see L<perldiag>.
7788a270 286
c1e74734
CBW
287XXX New or changed warnings emitted by the core's C<C> code go here. Also
288include any changes in L<perldiag> that reconcile it to the C<C> code.
6138a722 289
c1e74734
CBW
290[ Within each section, list entries as a =item entry that links to perldiag,
291 e.g.
a47fb3fe 292
c1e74734 293 =item *
4888c563 294
c1e74734
CBW
295 L<Invalid version object|perldiag/"Invalid version object">
296]
a3f52e2e 297
c1e74734 298=head2 New Diagnostics
52272450 299
c1e74734 300XXX Newly added diagnostic messages go here
52272450 301
c1e74734 302=head3 New Errors
a47fb3fe 303
0aaeb177 304=over 4
7ef25837 305
6d110ad0
FC
306=item *
307
c1e74734 308XXX L<message|perldiag/"message">
604a99bd 309
c1e74734 310=back
ea88c40c 311
c1e74734 312=head3 New Warnings
ea88c40c 313
c1e74734 314=over 4
ea88c40c
FC
315
316=item *
317
c1e74734 318XXX L<message|perldiag/"message">
ea88c40c 319
6d110ad0
FC
320=back
321
c1e74734
CBW
322=head2 Changes to Existing Diagnostics
323
324XXX Changes (i.e. rewording) of diagnostic messages go here
cadced9f
FC
325
326=over 4
327
328=item *
329
c1e74734 330XXX Describe change here
cadced9f
FC
331
332=back
333
0aaeb177 334=head1 Utility Changes
9cfd094e 335
c1e74734
CBW
336XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
337here. Most of these are built within the directories F<utils> and F<x2p>.
d7fbd56d 338
c1e74734
CBW
339[ List utility changes as a =head3 entry for each utility and =item
340entries for each change
341Use L<XXX> with program names to get proper documentation linking. ]
d7fbd56d 342
c1e74734 343=head3 L<XXX>
d7fbd56d 344
c1e74734 345=over 4
ba91b4f3 346
b18aa002
FC
347=item *
348
c1e74734 349XXX
b18aa002 350
52deee2e 351=back
ba91b4f3 352
52deee2e 353=head1 Configuration and Compilation
f4912a50 354
c1e74734
CBW
355XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
356go here. Any other changes to the Perl build process should be listed here.
357However, any platform-specific changes should be listed in the
358L</Platform Support> section, instead.
a3f52e2e 359
c1e74734 360[ List changes as a =item entry ].
a3f52e2e 361
0aaeb177 362=over 4
ad32999b 363
f4912a50 364=item *
ad32999b 365
c1e74734 366XXX
c15f899f 367
7f28d7ed 368=back
ad32999b 369
c1e74734 370=head1 Testing
39de7394 371
c1e74734
CBW
372XXX Any significant changes to the testing of a freshly built perl should be
373listed here. Changes which create B<new> files in F<t/> go here as do any
374large changes to the testing harness (e.g. when parallel testing was added).
375Changes to existing files in F<t/> aren't worth summarising, although the bugs
376that they represent may be covered elsewhere.
39de7394 377
c1e74734 378[ List each test improvement as a =item entry ]
39de7394 379
c1e74734 380=over 4
5dd80d85 381
52272450
FC
382=item *
383
c1e74734 384XXX
52272450 385
84ecb73f
SM
386=item *
387
388The test suite for typemaps has been extended to cover a larger fraction of
389the core typemaps.
390
52deee2e 391=back
5dd80d85 392
c1e74734 393=head1 Platform Support
52272450 394
c1e74734 395XXX Any changes to platform support should be listed in the sections below.
52272450 396
c1e74734
CBW
397[ Within the sections, list each platform as a =item entry with specific
398changes as paragraphs below it. ]
ad266194 399
c1e74734 400=head2 New Platforms
ad266194 401
c1e74734
CBW
402XXX List any platforms that this version of perl compiles on, that previous
403versions did not. These will either be enabled by new files in the F<hints/>
404directories, or new subdirectories and F<README> files at the top level of the
405source tree.
ad266194 406
c1e74734 407=over 4
838cf719 408
c1e74734 409=item XXX-some-platform
838cf719 410
c1e74734 411XXX
b00f6edb 412
c1e74734 413=back
b00f6edb 414
c1e74734 415=head2 Discontinued Platforms
7a3fd9ed 416
c1e74734 417XXX List any platforms that this version of perl no longer compiles on.
7a3fd9ed 418
c1e74734 419=over 4
1a50d74b 420
c1e74734 421=item XXX-some-platform
1a50d74b 422
c1e74734 423XXX
ea88c40c 424
c1e74734 425=back
ea88c40c 426
c1e74734 427=head2 Platform-Specific Notes
ea88c40c 428
c1e74734
CBW
429XXX List any changes for specific platforms. This could include configuration
430and compilation changes or changes in portability/compatibility. However,
431changes within modules for platforms should generally be listed in the
432L</Modules and Pragmata> section.
ea88c40c 433
c1e74734 434=over 4
ea88c40c 435
c1e74734 436=item XXX-some-platform
ea88c40c 437
c1e74734 438XXX
ea88c40c 439
c1e74734 440=back
ea88c40c 441
c1e74734 442=head1 Internal Changes
ea88c40c 443
c1e74734
CBW
444XXX Changes which affect the interface available to C<XS> code go here.
445Other significant internal changes for future core maintainers should
446be noted as well.
ea88c40c 447
c1e74734 448[ List each change as a =item entry ]
ea88c40c 449
c1e74734 450=over 4
ea88c40c
FC
451
452=item *
453
c1e74734 454XXX
ea88c40c 455
c1e74734 456=back
ea88c40c 457
c1e74734 458=head1 Selected Bug Fixes
ea88c40c 459
c1e74734
CBW
460XXX Important bug fixes in the core language are summarised here.
461Bug fixes in files in F<ext/> and F<lib/> are best summarised in
462L</Modules and Pragmata>.
ea88c40c 463
c1e74734 464[ List each fix as a =item entry ]
ea88c40c 465
c1e74734 466=over 4
ea88c40c
FC
467
468=item *
469
6025c6dd
RS
470C<~~> now correctly handles the precedence of Any~~Object, and is not tricked
471by an overloaded object on the left-hand side.
ea88c40c 472
249950d7
FC
473=item *
474
475C<stat _> no longer warns about unopened filehandles [perl #71002].
476
477=item *
478
479C<stat> on an unopened filehandle now warns consistently, instead of
480skipping the warning at times.
481
482=item *
483
484A change in an earlier 5.15 release caused warning hints to propagate into
485C<do $file>. This has been fixed [rt.cpan.org #72767].
486
487=item *
488
489Starting with 5.12.0, Perl used to get its internal bookkeeping muddled up
490after assigning C<${ qr// }> to a hash element and locking it with
491L<Hash::Util>. This could result in double frees, crashes or erratic
492behaviour.
493
92c88ef1
FC
494=item *
495
496In 5.15.7, some typeglobs in the CORE namespace were made read-only by
497mistake. This has been fixed [rt.cpan.org #74289].
498
b1ea7742
FC
499=item *
500
501C<-t> now works when stacked with other filetest operators [perl #77388].
502
a1d95121
FC
503=item *
504
505Stacked filetest operators now only call FETCH once on a tied argument.
506
ff4ff6f3
FC
507=item *
508
509C</.*/g> would sometimes refuse to match at the end of a string that ends
510with "\n". This has been fixed [perl #109206].
511
a7bff800
FC
512=item *
513
514Method calls whose arguments were all surrounded with C<my()> or C<our()>
515(as in C<<$object->method(my($a,$b)) >>) used to force lvalue context on
516the subroutine. This would prevent lvalue methods from returning certain
517values. Due to lvalue fixes earlier in the 5.15.x series, it would also
518prevent non-lvalue methods from being called [perl #109264].
519
520=for comment
521This bug I<did> affect earlier stable releases. It is just the last
522sentence that does not apply to 5.14.
523
ea88c40c
FC
524=back
525
c1e74734 526=head1 Known Problems
ea88c40c 527
c1e74734
CBW
528XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
529tests that had to be C<TODO>ed for the release would be noted here, unless
530they were specific to a particular platform (see below).
ea88c40c 531
c1e74734
CBW
532This is a list of some significant unfixed bugs, which are regressions
533from either 5.XXX.XXX or 5.XXX.XXX.
ea88c40c 534
c1e74734 535[ List each fix as a =item entry ]
ea88c40c 536
c1e74734 537=over 4
18af289e 538
c1e74734 539=item *
18af289e 540
c1e74734 541XXX
1ac442bc 542
c1e74734 543=back
c0154fe2 544
c1e74734 545=head1 Obituary
1ac442bc 546
c1e74734
CBW
547XXX If any significant core contributor has died, we've added a short obituary
548here.
84b2a83e 549
52deee2e 550=head1 Acknowledgements
8fe05716 551
c1e74734
CBW
552XXX Generate this with:
553
554 perl Porting/acknowledgements.pl v5.15.7..HEAD
29cf780c 555
44691e6f
AB
556=head1 Reporting Bugs
557
558If you find what you think is a bug, you might check the articles
52deee2e
DR
559recently posted to the comp.lang.perl.misc newsgroup and the perl
560bug database at http://rt.perl.org/perlbug/ . There may also be
44691e6f
AB
561information at http://www.perl.org/ , the Perl Home Page.
562
563If you believe you have an unreported bug, please run the L<perlbug>
52deee2e
DR
564program included with your release. Be sure to trim your bug down
565to a tiny but sufficient test case. Your bug report, along with the
566output of C<perl -V>, will be sent off to perlbug@perl.org to be
567analysed by the Perl porting team.
44691e6f
AB
568
569If the bug you are reporting has security implications, which make it
52deee2e
DR
570inappropriate to send to a publicly archived mailing list, then please send
571it to perl5-security-report@perl.org. This points to a closed subscription
572unarchived mailing list, which includes
573all the core committers, who will be able
574to help assess the impact of issues, figure out a resolution, and help
575co-ordinate the release of patches to mitigate or fix the problem across all
576platforms on which Perl is supported. Please only use this address for
577security issues in the Perl core, not for modules independently
578distributed on CPAN.
44691e6f
AB
579
580=head1 SEE ALSO
581
52deee2e
DR
582The F<Changes> file for an explanation of how to view exhaustive details
583on what changed.
44691e6f
AB
584
585The F<INSTALL> file for how to build Perl.
586
587The F<README> file for general stuff.
588
589The F<Artistic> and F<Copying> files for copyright information.
590
591=cut