This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta for Term::ReadLine and AE
[perl5.git] / pod / perldelta.pod
CommitLineData
44691e6f
AB
1=encoding utf8
2
249950d7 3=for comment
ecd144ea 4This has been completed up to eb96f3fadee, 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
S
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
c1e74734 147XXX
4e6e9b23 148
c1e74734 149=back
4e6e9b23 150
c1e74734 151=head2 Updated Modules and Pragmata
4e6e9b23 152
c1e74734 153=over 4
1887da8c
RS
154
155=item *
156
197aacaf
FC
157L<B> has been upgraded from version 1.33 to version 1.34.
158
159C<B::COP> now has a C<stashflags> method, corresponding to a new internal
160field added in 5.15.4 [perl #108860].
161
162=item *
163
df697508 164L<Compress::Raw::Bzip2> has been upgraded from version 2.045 to version 2.048.
76f546a2
CBW
165
166=item *
167
ecea5ab2 168L<Compress::Raw::Zlib> has been upgraded from version 2.045 to version 2.048.
589c1691
CBW
169
170=item *
171
8dcc3739 172L<Compress::Zlib> has been upgraded from version 2.046 to version 2.048.
422d6414
CBW
173
174=item *
175
b34385a6 176L<DB_File> has been upgraded from version 1.824 to version 1.826.
acb29889
CBW
177
178=item *
179
ce2c4022
NC
180L<diagnostics> has been upgraded from version 1.27 to version 1.28.
181
182When searching for F<perldiag.pod>, it no longer uses paths that were only
183relevant on Perl 5.004 and earlier.
184
185=item *
186
84ecb73f
S
187L<ExtUtils::ParseXS> has been upgraded from version 3.12 to version 3.15.
188
189The new version comes with important tools for sharing typemaps between
190different CPAN distributions.
191
192=item *
193
eb96f3fa
CBW
194L<IPC::Cmd> has been upgraded from version 0.72 to version 0.76.
195
196=item *
197
04ae1553
Z
198L<Math::Complex> has been upgraded from version 1.58 to version 1.59.
199
200This avoids a new core warning.
201
202=item *
203
1051d5b5 204L<Pod::Parser> has been upgraded from version 1.37 to version 1.51.
88c5c971 205
2a7afa74
NC
206=item *
207
ecd144ea
FC
208L<Term::ReadLine> has been upgraded from version 1.07 to version 1.08.
209
210Its C<tkRunning> method now supports L<AnyEvent> event loops, and not just
211L<Tk>. A more general mechanism has been proposed, so this may be reverted
212before Perl 5.16 [perl #108470].
213
214=item *
215
858dcda5
Z
216L<Time::HiRes> has been upgraded from version 1.9724 to version 1.9725.
217
694644e0 218C<Time::HiRes::stat()> no longer corrupts the Perl stack.
858dcda5
Z
219
220=item *
221
2a7afa74
NC
222L<Unicode::UCD> has been upgraded from version 0.39 to 0.40.
223
224The only change is to fix a formatting error in the Pod.
225
c1e74734 226=back
c0504019 227
c1e74734 228=head2 Removed Modules and Pragmata
937a45d0 229
c1e74734 230=over 4
937a45d0 231
ef337e16
CBW
232=item *
233
c1e74734 234XXX
ef337e16 235
7f28d7ed 236=back
679b54e7 237
52deee2e 238=head1 Documentation
3c7c5233 239
c1e74734
CBW
240XXX Changes to files in F<pod/> go here. Consider grouping entries by
241file and be sure to link to the appropriate page, e.g. L<perlfunc>.
a71d67b1 242
c1e74734 243=head2 New Documentation
cadced9f 244
c1e74734 245XXX Changes which create B<new> files in F<pod/> go here.
cadced9f 246
84ecb73f
S
247=head3 L<perlxstypemap>
248
249The new manual describes the XS typemapping mechanism in unprecedented
250detail and combines new documentation with information extracted from
251L<perlxs> and the previously unofficial list of all core typemaps.
252
c1e74734 253=head3 L<XXX>
cadced9f 254
c1e74734 255XXX Description of the purpose of the new file here
cadced9f 256
c1e74734 257=head2 Changes to Existing Documentation
cadced9f 258
c1e74734
CBW
259XXX Changes which significantly change existing files in F<pod/> go here.
260However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
261section.
cadced9f 262
c1e74734 263=head3 L<XXX>
7e7629fa 264
52deee2e 265=over 4
7e7629fa
FC
266
267=item *
268
c1e74734 269XXX Description of the change here
c2654555 270
52deee2e 271=back
85ca3be7 272
52deee2e 273=head1 Diagnostics
85ca3be7 274
52deee2e
DR
275The following additions or changes have been made to diagnostic output,
276including warnings and fatal error messages. For the complete list of
277diagnostic messages, see L<perldiag>.
7788a270 278
c1e74734
CBW
279XXX New or changed warnings emitted by the core's C<C> code go here. Also
280include any changes in L<perldiag> that reconcile it to the C<C> code.
6138a722 281
c1e74734
CBW
282[ Within each section, list entries as a =item entry that links to perldiag,
283 e.g.
a47fb3fe 284
c1e74734 285 =item *
4888c563 286
c1e74734
CBW
287 L<Invalid version object|perldiag/"Invalid version object">
288]
a3f52e2e 289
c1e74734 290=head2 New Diagnostics
52272450 291
c1e74734 292XXX Newly added diagnostic messages go here
52272450 293
c1e74734 294=head3 New Errors
a47fb3fe 295
0aaeb177 296=over 4
7ef25837 297
6d110ad0
FC
298=item *
299
c1e74734 300XXX L<message|perldiag/"message">
604a99bd 301
c1e74734 302=back
ea88c40c 303
c1e74734 304=head3 New Warnings
ea88c40c 305
c1e74734 306=over 4
ea88c40c
FC
307
308=item *
309
c1e74734 310XXX L<message|perldiag/"message">
ea88c40c 311
6d110ad0
FC
312=back
313
c1e74734
CBW
314=head2 Changes to Existing Diagnostics
315
316XXX Changes (i.e. rewording) of diagnostic messages go here
cadced9f
FC
317
318=over 4
319
320=item *
321
c1e74734 322XXX Describe change here
cadced9f
FC
323
324=back
325
0aaeb177 326=head1 Utility Changes
9cfd094e 327
c1e74734
CBW
328XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
329here. Most of these are built within the directories F<utils> and F<x2p>.
d7fbd56d 330
c1e74734
CBW
331[ List utility changes as a =head3 entry for each utility and =item
332entries for each change
333Use L<XXX> with program names to get proper documentation linking. ]
d7fbd56d 334
c1e74734 335=head3 L<XXX>
d7fbd56d 336
c1e74734 337=over 4
ba91b4f3 338
b18aa002
FC
339=item *
340
c1e74734 341XXX
b18aa002 342
52deee2e 343=back
ba91b4f3 344
52deee2e 345=head1 Configuration and Compilation
f4912a50 346
c1e74734
CBW
347XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
348go here. Any other changes to the Perl build process should be listed here.
349However, any platform-specific changes should be listed in the
350L</Platform Support> section, instead.
a3f52e2e 351
c1e74734 352[ List changes as a =item entry ].
a3f52e2e 353
0aaeb177 354=over 4
ad32999b 355
f4912a50 356=item *
ad32999b 357
c1e74734 358XXX
c15f899f 359
7f28d7ed 360=back
ad32999b 361
c1e74734 362=head1 Testing
39de7394 363
c1e74734
CBW
364XXX Any significant changes to the testing of a freshly built perl should be
365listed here. Changes which create B<new> files in F<t/> go here as do any
366large changes to the testing harness (e.g. when parallel testing was added).
367Changes to existing files in F<t/> aren't worth summarising, although the bugs
368that they represent may be covered elsewhere.
39de7394 369
c1e74734 370[ List each test improvement as a =item entry ]
39de7394 371
c1e74734 372=over 4
5dd80d85 373
52272450
FC
374=item *
375
c1e74734 376XXX
52272450 377
84ecb73f
S
378=item *
379
380The test suite for typemaps has been extended to cover a larger fraction of
381the core typemaps.
382
52deee2e 383=back
5dd80d85 384
c1e74734 385=head1 Platform Support
52272450 386
c1e74734 387XXX Any changes to platform support should be listed in the sections below.
52272450 388
c1e74734
CBW
389[ Within the sections, list each platform as a =item entry with specific
390changes as paragraphs below it. ]
ad266194 391
c1e74734 392=head2 New Platforms
ad266194 393
c1e74734
CBW
394XXX List any platforms that this version of perl compiles on, that previous
395versions did not. These will either be enabled by new files in the F<hints/>
396directories, or new subdirectories and F<README> files at the top level of the
397source tree.
ad266194 398
c1e74734 399=over 4
838cf719 400
c1e74734 401=item XXX-some-platform
838cf719 402
c1e74734 403XXX
b00f6edb 404
c1e74734 405=back
b00f6edb 406
c1e74734 407=head2 Discontinued Platforms
7a3fd9ed 408
c1e74734 409XXX List any platforms that this version of perl no longer compiles on.
7a3fd9ed 410
c1e74734 411=over 4
1a50d74b 412
c1e74734 413=item XXX-some-platform
1a50d74b 414
c1e74734 415XXX
ea88c40c 416
c1e74734 417=back
ea88c40c 418
c1e74734 419=head2 Platform-Specific Notes
ea88c40c 420
c1e74734
CBW
421XXX List any changes for specific platforms. This could include configuration
422and compilation changes or changes in portability/compatibility. However,
423changes within modules for platforms should generally be listed in the
424L</Modules and Pragmata> section.
ea88c40c 425
c1e74734 426=over 4
ea88c40c 427
c1e74734 428=item XXX-some-platform
ea88c40c 429
c1e74734 430XXX
ea88c40c 431
c1e74734 432=back
ea88c40c 433
c1e74734 434=head1 Internal Changes
ea88c40c 435
c1e74734
CBW
436XXX Changes which affect the interface available to C<XS> code go here.
437Other significant internal changes for future core maintainers should
438be noted as well.
ea88c40c 439
c1e74734 440[ List each change as a =item entry ]
ea88c40c 441
c1e74734 442=over 4
ea88c40c
FC
443
444=item *
445
c1e74734 446XXX
ea88c40c 447
c1e74734 448=back
ea88c40c 449
c1e74734 450=head1 Selected Bug Fixes
ea88c40c 451
c1e74734
CBW
452XXX Important bug fixes in the core language are summarised here.
453Bug fixes in files in F<ext/> and F<lib/> are best summarised in
454L</Modules and Pragmata>.
ea88c40c 455
c1e74734 456[ List each fix as a =item entry ]
ea88c40c 457
c1e74734 458=over 4
ea88c40c
FC
459
460=item *
461
6025c6dd
RS
462C<~~> now correctly handles the precedence of Any~~Object, and is not tricked
463by an overloaded object on the left-hand side.
ea88c40c 464
249950d7
FC
465=item *
466
467C<stat _> no longer warns about unopened filehandles [perl #71002].
468
469=item *
470
471C<stat> on an unopened filehandle now warns consistently, instead of
472skipping the warning at times.
473
474=item *
475
476A change in an earlier 5.15 release caused warning hints to propagate into
477C<do $file>. This has been fixed [rt.cpan.org #72767].
478
479=item *
480
481Starting with 5.12.0, Perl used to get its internal bookkeeping muddled up
482after assigning C<${ qr// }> to a hash element and locking it with
483L<Hash::Util>. This could result in double frees, crashes or erratic
484behaviour.
485
92c88ef1
FC
486=item *
487
488In 5.15.7, some typeglobs in the CORE namespace were made read-only by
489mistake. This has been fixed [rt.cpan.org #74289].
490
b1ea7742
FC
491=item *
492
493C<-t> now works when stacked with other filetest operators [perl #77388].
494
a1d95121
FC
495=item *
496
497Stacked filetest operators now only call FETCH once on a tied argument.
498
ff4ff6f3
FC
499=item *
500
501C</.*/g> would sometimes refuse to match at the end of a string that ends
502with "\n". This has been fixed [perl #109206].
503
a7bff800
FC
504=item *
505
506Method calls whose arguments were all surrounded with C<my()> or C<our()>
507(as in C<<$object->method(my($a,$b)) >>) used to force lvalue context on
508the subroutine. This would prevent lvalue methods from returning certain
509values. Due to lvalue fixes earlier in the 5.15.x series, it would also
510prevent non-lvalue methods from being called [perl #109264].
511
512=for comment
513This bug I<did> affect earlier stable releases. It is just the last
514sentence that does not apply to 5.14.
515
ea88c40c
FC
516=back
517
c1e74734 518=head1 Known Problems
ea88c40c 519
c1e74734
CBW
520XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
521tests that had to be C<TODO>ed for the release would be noted here, unless
522they were specific to a particular platform (see below).
ea88c40c 523
c1e74734
CBW
524This is a list of some significant unfixed bugs, which are regressions
525from either 5.XXX.XXX or 5.XXX.XXX.
ea88c40c 526
c1e74734 527[ List each fix as a =item entry ]
ea88c40c 528
c1e74734 529=over 4
18af289e 530
c1e74734 531=item *
18af289e 532
c1e74734 533XXX
1ac442bc 534
c1e74734 535=back
c0154fe2 536
c1e74734 537=head1 Obituary
1ac442bc 538
c1e74734
CBW
539XXX If any significant core contributor has died, we've added a short obituary
540here.
84b2a83e 541
52deee2e 542=head1 Acknowledgements
8fe05716 543
c1e74734
CBW
544XXX Generate this with:
545
546 perl Porting/acknowledgements.pl v5.15.7..HEAD
29cf780c 547
44691e6f
AB
548=head1 Reporting Bugs
549
550If you find what you think is a bug, you might check the articles
52deee2e
DR
551recently posted to the comp.lang.perl.misc newsgroup and the perl
552bug database at http://rt.perl.org/perlbug/ . There may also be
44691e6f
AB
553information at http://www.perl.org/ , the Perl Home Page.
554
555If you believe you have an unreported bug, please run the L<perlbug>
52deee2e
DR
556program included with your release. Be sure to trim your bug down
557to a tiny but sufficient test case. Your bug report, along with the
558output of C<perl -V>, will be sent off to perlbug@perl.org to be
559analysed by the Perl porting team.
44691e6f
AB
560
561If the bug you are reporting has security implications, which make it
52deee2e
DR
562inappropriate to send to a publicly archived mailing list, then please send
563it to perl5-security-report@perl.org. This points to a closed subscription
564unarchived mailing list, which includes
565all the core committers, who will be able
566to help assess the impact of issues, figure out a resolution, and help
567co-ordinate the release of patches to mitigate or fix the problem across all
568platforms on which Perl is supported. Please only use this address for
569security issues in the Perl core, not for modules independently
570distributed on CPAN.
44691e6f
AB
571
572=head1 SEE ALSO
573
52deee2e
DR
574The F<Changes> file for an explanation of how to view exhaustive details
575on what changed.
44691e6f
AB
576
577The F<INSTALL> file for how to build Perl.
578
579The F<README> file for general stuff.
580
581The F<Artistic> and F<Copying> files for copyright information.
582
583=cut