This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Finalise perldelta with updated module information
[perl5.git] / pod / perldelta.pod
CommitLineData
44691e6f
AB
1=encoding utf8
2
3=head1 NAME
4
19718730 5perldelta - what is new for perl v5.17.9
e128ab2c 6
4eabcf70 7=head1 DESCRIPTION
6db9054f 8
19718730 9This document describes differences between the 5.17.8 release and the 5.17.9
e08634c5 10release.
6db9054f 11
19718730
AC
12If you are upgrading from an earlier release such as 5.17.7, first read
13L<perl5178delta>, which describes differences between 5.17.7 and 5.17.8.
14
6253ee75 15=head1 Core Enhancements
dd271d7a 16
b5864679
KW
17=head2 Interpolations now Accepted in Regular Expression Set Operations
18
19Perl v5.17.8 introduced L<regular expression set operations|perlre/(?[ ])>.
20They have now been expanded to allow the interpolation of a
21previously-compiled set into a bigger set, like this:
22
ea5a2f13 23 my $thai_or_lao = qr/\p{Thai} + \p{Lao}/;
b5864679
KW
24 ...
25 qr/(?[ \p{Digit} & $thai_or_lao ])/;
26
19718730
AC
27=head1 Incompatible Changes
28
888a67f6
KF
29=head2 C<$ENV{foo} = undef> no longer deletes value from environ
30
315.17.3 Introduced a change where assiging C<undef> to an C<%ENV> key was equivalent
32to C<delete $ENV{foo}>.
33
34This release reverts that change.
35
0e55f0d7 36=head1 Deprecations
3ef6ec90 37
4055dbce
RS
38The deprecation of lexical C<$_> in 5.17.7 has been commuted. The feature
39is now marked experimental.
d1e59372 40
62c60a36
CBW
41=head2 Deprecated pragma
42
43=over
44
45=item L<encoding>
46
47This module is deprecated under perl 5.18. It uses a mechanism provided by
48perl that is deprecated under 5.18 and higher, and may be removed in a
49future version.
50
51=back
52
3f01b192
CBW
53=head2 Deprecated Modules
54
55The following modules will be removed from the core distribution in a
56future release, and should be installed from CPAN instead. Distributions
57on CPAN which require these should add them to their prerequisites. The
58core versions of these modules C<warnings> will issue a deprecation warning.
59
60You can silence these deprecation warnings by installing the modules
61in question from CPAN.
62
63=over
64
65=item L<Archive::Extract>
66
67=item L<B::Lint>
68
69=item L<B::Lint::Debug>
70
71=item L<CPANPLUS>
72
73=item L<CPANPLUS::Backend>
74
75=item L<CPANPLUS::Backend::RV>
76
77=item L<CPANPLUS::Config>
78
79=item L<CPANPLUS::Config::HomeEnv>
80
81=item L<CPANPLUS::Configure>
82
9150e781 83=item C<CPANPLUS::Configure::Setup>
3f01b192
CBW
84
85=item L<CPANPLUS::Dist>
86
87=item L<CPANPLUS::Dist::Autobundle>
88
89=item L<CPANPLUS::Dist::Base>
90
91=item L<CPANPLUS::Dist::Build>
92
93=item L<CPANPLUS::Dist::Build::Constants>
94
95=item L<CPANPLUS::Dist::MM>
96
97=item L<CPANPLUS::Dist::Sample>
98
99=item L<CPANPLUS::Error>
100
101=item L<CPANPLUS::Internals>
102
9150e781 103=item C<CPANPLUS::Internals::Constants>
3f01b192 104
9150e781 105=item C<CPANPLUS::Internals::Constants::Report>
3f01b192
CBW
106
107=item L<CPANPLUS::Internals::Extract>
108
109=item L<CPANPLUS::Internals::Fetch>
110
111=item L<CPANPLUS::Internals::Report>
112
113=item L<CPANPLUS::Internals::Search>
114
115=item L<CPANPLUS::Internals::Source>
116
117=item L<CPANPLUS::Internals::Source::Memory>
118
119=item L<CPANPLUS::Internals::Source::SQLite>
120
9150e781 121=item C<CPANPLUS::Internals::Source::SQLite::Tie>
3f01b192
CBW
122
123=item L<CPANPLUS::Internals::Utils>
124
9150e781 125=item C<CPANPLUS::Internals::Utils::Autoflush>
3f01b192
CBW
126
127=item L<CPANPLUS::Module>
128
129=item L<CPANPLUS::Module::Author>
130
131=item L<CPANPLUS::Module::Author::Fake>
132
133=item L<CPANPLUS::Module::Checksums>
134
135=item L<CPANPLUS::Module::Fake>
136
9150e781 137=item C<CPANPLUS::Module::Signature>
3f01b192
CBW
138
139=item L<CPANPLUS::Selfupdate>
140
141=item L<CPANPLUS::Shell>
142
143=item L<CPANPLUS::Shell::Classic>
144
145=item L<CPANPLUS::Shell::Default>
146
147=item L<CPANPLUS::Shell::Default::Plugins::CustomSource>
148
149=item L<CPANPLUS::Shell::Default::Plugins::Remote>
150
151=item L<CPANPLUS::Shell::Default::Plugins::Source>
152
153=item L<Devel::InnerPackage>
154
155=item L<Log::Message>
156
157=item L<Log::Message::Config>
158
159=item L<Log::Message::Handlers>
160
161=item L<Log::Message::Item>
162
163=item L<Log::Message::Simple>
164
165=item L<Module::Pluggable>
166
167=item L<Module::Pluggable::Object>
168
169=item L<Object::Accessor>
170
171=item L<Term::UI>
172
173=item L<Term::UI::History>
174
175=back
176
177=head3 Deprecated Utilities
178
179The following utilities will be removed from the core distribution in a
180future release as their associated modules have been deprecated. They
181will remain available with the applicable CPAN distribution.
182
183=over
184
185=item L<cpanp>
186
187Included with L<CPANPLUS>.
188
9150e781 189=item C<cpanp-run-perl>
3f01b192
CBW
190
191Included with L<CPANPLUS>.
192
193=item L<cpan2dist>
194
195Included with L<CPANPLUS>.
196
197=item L<pod2latex>
198
199The L<Pod::LaTeX> module was deprecated with 5.17.8.
200
201=back
202
ff56e4f1
KW
203=head2 Five additional characters should be escaped in patterns with C</x>
204
205When a regular expression pattern is compiled with C</x>, Perl treats 6
206characters as white space to ignore, such as SPACE and TAB. However,
207Unicode recommends 11 characters be treated thusly. In preparation to
208conforming with this in a future Perl version, in the meantime, use of
209any of the missing characters will raise a deprecation warning, unless
210turned off. The five characters are:
211U+0085 NEXT LINE,
212U+200E LEFT-TO-RIGHT MARK,
213U+200F RIGHT-TO-LEFT MARK,
214U+2028 LINE SEPARATOR,
215and
216U+2029 PARAGRAPH SEPARATOR.
217
19718730
AC
218=head1 Modules and Pragmata
219
19718730 220=head2 New Modules and Pragmata
751611d4 221
6253ee75 222=over 4
751611d4
FC
223
224=item *
225
f3f40957
CBW
226L<Config::Perl::V> version 0.16 has been added as a dual-lifed module.
227It provides structured data retrieval of C<perl -V> output including
228information only known to the C<perl> binary and not available via L<Config>.
751611d4 229
19718730 230=back
86148eee 231
19718730
AC
232=head2 Updated Modules and Pragmata
233
234=over 4
7a7a10c7 235
e14ac59b 236=item *
7a7a10c7 237
2426c394
CBW
238L<Archive::Extract> has been upgraded from version 0.62 to 0.68.
239
240NOTE: L<Archive::Extract> is deprecated and may be removed from a future version of Perl.
241
242=item *
243
244L<Attribute::Handlers> has been upgraded from version 0.93 to 0.94.
245
246=item *
247
248L<B::Lint> has been upgraded from version 1.14 to 1.17.
249
250NOTE: L<B::Lint> is deprecated and may be removed from a future version of Perl.
251
252=item *
253
a820780c
DG
254L<Benchmark> has been upgraded from version 1.13 to 1.14.
255
256The "too few iterations" message is now a warning on STDERR
257instead of being output on STDOUT.
258
259=item *
260
2426c394
CBW
261L<bignum> has been upgraded from version 0.31 to 0.32.
262
263=item *
264
265L<CPAN> has been upgraded from version 1.99_51 to 2.00.
266
267=item *
268
269L<CPANPLUS> has been upgraded from version 0.9133 to 0.9135.
270
271NOTE: L<CPANPLUS> is deprecated and may be removed from a future version of Perl.
272
273=item *
274
275L<CPANPLUS::Dist::Build> has been upgraded from version 0.68 to 0.70.
276
277NOTE: L<CPANPLUS::Dist::Build> is deprecated and may be removed from a future version of Perl.
278
279=item *
280
8cdf5bac
JK
281L<Data::Dumper> has been upgraded from version 2.141 to 2.142.
282
283Additional tests were added in order to improve statement, branch, condition
284and subroutine coverage. On the basis of the coverage analysis, some of the
285internals of Dumper.pm were refactored. Almost all methods are now
286documented.
287
288=item *
289
2426c394
CBW
290L<DBM_Filter> has been upgraded from version 0.04 to 0.05.
291
292=item *
293
294L<Digest::SHA> has been upgraded from version 5.81 to 5.82.
295
296=item *
297
298L<Encode> has been upgraded from version 2.47 to 2.48.
299
300=item *
301
302L<ExtUtils::Manifest> has been upgraded from version 1.62 to 1.63.
303
304=item *
305
306L<File::CheckTree> has been upgraded from version 4.41 to 4.42.
307
308=item *
309
310L<File::DosGlob> has been upgraded from version 1.09 to 1.10.
311
312=item *
313
46205598
DG
314L<File::Temp> has been upgraded from version 0.22 to 0.22_90
315
316Fixes various bugs involving directory removal. Defers unlinking tempfiles if
317the initial unlink fails, which fixes problems on NFS.
318
319=item *
320
2426c394
CBW
321L<Filter::Simple> has been upgraded from version 0.88 to 0.89.
322
323=item *
324
325L<IO> has been upgraded from version 1.26 to 1.27.
326
327=item *
328
329L<Log::Message> has been upgraded from version 0.04 to 0.06.
330
331NOTE: L<Log::Message> is deprecated and may be removed from a future version of Perl.
332
333=item *
334
335L<Log::Message::Simple> has been upgraded from version 0.08 to 0.10.
336
337NOTE: L<Log::Message::Simple> is deprecated and may be removed from a future version of Perl.
338
339=item *
340
341L<Math::BigInt> has been upgraded from version 1.998 to 1.999.
342
343=item *
344
345L<Module::CoreList> has been upgraded from version 2.80 to 2.82.
346
347=item *
348
349L<Module::Load> has been upgraded from version 0.22 to 0.24.
350
351=item *
352
353L<Module::Pluggable> has been upgraded from version 4.5 to 4.6.
354
355NOTE: L<Module::Pluggable> is deprecated and may be removed from a future version of Perl.
356
357=item *
358
359L<Object::Accessor> has been upgraded from version 0.44 to 0.46.
360
361NOTE: L<Object::Accessor> is deprecated and may be removed from a future version of Perl.
362
363=item *
364
365L<overload> has been upgraded from version 1.20 to 1.21.
366
367=item *
368
e58c5aaf
TC
369L<PerlIO::scalar> has been upgraded from version 0.15 to 0.16.
370
371The buffer scalar supplied may now only contain code pounts 0xFF or
372lower. [perl #109828]
7a7a10c7 373
2426c394
CBW
374=item *
375
376L<Pod::Checker> has been upgraded from version 1.51 to 1.60.
377
378=item *
379
380L<Pod::Html> has been upgraded from version 1.17 to 1.18.
381
382=item *
383
384L<Pod::Parser> has been upgraded from version 1.51 to 1.60.
385
386=item *
387
388L<Pod::Perldoc> has been upgraded from version 3.17 to 3.19.
389
390=item *
391
392L<Pod::Usage> has been upgraded from version 1.51 to 1.61.
393
394=item *
395
396L<SelfLoader> has been upgraded from version 1.20 to 1.21.
397
398=item *
399
400L<Term::UI> has been upgraded from version 0.32 to 0.34.
401
402NOTE: L<Term::UI> is deprecated and may be removed from a future version of Perl.
403
404=item *
405
406L<Test::Harness> has been upgraded from version 3.25_01 to 3.26.
407
408=item *
409
410L<Text::Soundex> has been upgraded from version 3.03_01 to 3.04.
411
412=item *
413
414L<Thread::Queue> has been upgraded from version 3.01 to 3.02.
415
416=item *
417
418L<Unicode::UCD> has been upgraded from version 0.47 to 0.50.
419
420=item *
421
422L<warnings> has been upgraded from version 1.16 to 1.17.
423
424=item *
425
426L<Win32> has been upgraded from version 0.45 to 0.46.
427
428=item *
429
430L<Win32API::File> has been upgraded from version 0.1200 to 0.1201.
431
19718730
AC
432=back
433
19718730 434=head1 Documentation
11e375e0 435
19718730
AC
436=head2 Changes to Existing Documentation
437
b9214e65 438=head3 L<perlsec>
19718730
AC
439
440=over 4
dd4b1c75
AC
441
442=item *
443
b9214e65 444A syntax error was fixed in one of illustrative examples.
cb077ed2 445
5d8c8c8a 446=back
5f877a7f 447
e14ac59b
RS
448=head1 Diagnostics
449
450The following additions or changes have been made to diagnostic output,
451including warnings and fatal error messages. For the complete list of
452diagnostic messages, see L<perldiag>.
1ea91bbe 453
6253ee75
DR
454=head2 New Diagnostics
455
19718730
AC
456=head3 New Warnings
457
458=over 4
5e0a247b
KW
459
460=item *
461
d2d1e842 462Strings with code points over 0xFF may not be mapped into in-memory file handles
19718730
AC
463
464=back
465
466=head2 Changes to Existing Diagnostics
467
19718730 468=over 4
e14ac59b 469
6253ee75 470=item *
8b877d20 471
b9214e65
CBW
472The warnings for \b{ and \B{ were added in the 5.17 series; they are a
473deprecation warning which should be turned off by that category. One
474should not have to turn off regular regexp warnings as well to get rid
475of these.
19718730
AC
476
477=back
478
479=head1 Utility Changes
480
5bf072ac 481=head3 L<corelist>
19718730
AC
482
483=over 4
e078d89d
FC
484
485=item *
486
5bf072ac
CBW
487Added C<--feature> switch which lists the first version bundle of each
488named feature given.
e078d89d 489
09a49503
CBW
490=item *
491
492Added C<--upstream> switch which shows if the given module
493is primarily maintained in perl core or on CPAN and bug tracker URL.
494
6253ee75 495=back
e078d89d 496
19718730
AC
497=head1 Configuration and Compilation
498
6253ee75 499=over 4
e078d89d 500
b7c7d786
FC
501=item *
502
d2d1e842
CBW
503Added C<useversionedarchname> option to Configure
504
505When set, it includes 'api_versionstring' in 'archname'. E.g.
506x86_64-linux-5.13.6-thread-multi. It is unset by default.
507
508This feature was requested by Tim Bunce, who observed that
509INSTALL_BASE creates a library structure that does not
510differentiate by perl version. Instead, it places architecture
511specific files in "$install_base/lib/perl5/$archname". This makes
512it difficult to use a common INSTALL_BASE library path with
513multiple versions of perl.
514
515By setting -Duseversionedarchname, the $archname will be
516distinct for architecture *and* API version, allowing mixed use of
517INSTALL_BASE.
518
519=item *
520
b9214e65
CBW
521Configure will honour the external C<MAILDOMAIN> environment variable, if set.
522
523=item *
524
f355e93d
CBW
525C<installman> no longer ignores the silent option
526
527=item *
528
8e8f9da4 529Both C<META.yml> and C<META.json> files are now included in the distribution.
19718730
AC
530
531=back
532
533=head1 Testing
534
19718730 535=over 4
e14ac59b 536
fdea6f98
FC
537=item *
538
b9214e65
CBW
539Enable perl core tests to pass when locale support is not available.
540
541use L<locale> - this will now die if $Config{d_setlocale} is not true.
542All tests that use L<locale> will skip if $Config{d_setlocale} is not true.
543This enables us to pass tests on Android which uses ICU instead of locales.
fdea6f98 544
6253ee75 545=back
7cf3104f 546
6253ee75 547=head1 Platform Support
7cf3104f 548
19718730
AC
549=head2 Platform-Specific Notes
550
19718730 551=over 4
6e50262c 552
480c6724 553=item VMS
6e50262c 554
480c6724
CB
555The character set for Extended Filename Syntax (EFS) is now enabled by default on
556VMS. Among other things, this provides better handling of dots in directory names,
557multiple dots in filenames,and spaces in filenames. To obtain the old behavior,
558set the logical name C<DECC$EFS_CHARSET> to C<DISABLE>.
785fb813 559
8a987e1a
CBW
560=item MidnightBSD
561
562C<libc_r> was removed from recent versions of MidnightBSD and older versions
563work better with C<pthread>. Threading is now enabled using C<pthread> which
564corrects build errors with threading enabled on 0.4-CURRENT.
565
0e55f0d7 566=back
785fb813 567
0e55f0d7 568=head1 Internal Changes
f5778209 569
6253ee75 570=over 4
f5778209 571
216cf7fc
DR
572=item *
573
12719193
KW
574Synonyms for the misleadingly named C<av_len()> has been created:
575C<av_top_index()> and C<av_tindex>. All three of these return the
576number of the highest index in the array, not the number of elements it
577contains. (The name C<av_top> which was introduced in Perl v.5.17.8 has
578been removed.)
579
6253ee75 580=back
216cf7fc 581
6253ee75 582=head1 Selected Bug Fixes
216cf7fc 583
19718730 584=over 4
216cf7fc 585
d76c0f4b
RS
586=item *
587
58cbf594
TC
588-DPERL_GLOBAL_STRUCT builds now free the global struct B<after>
589they've finished using it.
d76c0f4b 590
b9214e65
CBW
591=item *
592
593A trailing '/' on a path in @INC will no longer have an additional '/' appended.
594
250ef6a9
KW
595=item *
596
597The C<:crlf> layer now works when unread data doesn't fit into its own
598buffer. [perl #112244].
599
600=item *
601
602C<ungetc()> now handles UTF-8 encoded data. [perl #116322].
603
6253ee75 604=back
6c042f06 605
19718730 606=head1 Acknowledgements
f5b73711 607
58640fcb
CBW
608Perl 5.17.9 represents approximately 4 weeks of development since Perl 5.17.8
609and contains approximately 42,000 lines of changes across 510 files from 35
610authors.
611
612Perl continues to flourish into its third decade thanks to a vibrant community
613of users and developers. The following people are known to have contributed the
614improvements that became Perl 5.17.9:
615
2426c394 616Aaron Crane, Alan Haggai Alavi, Alexandr Ciornii, Andy Dougherty, Brad
58640fcb
CBW
617Gilbert, Chris 'BinGOs' Williams, Christian Hansen, Craig A. Berry, Dagfinn
618Ilmari Mannsåker, Daniel Dragan, Dave Rolsky, David Golden, David Mitchell,
619Father Chrysostomos, H.Merijn Brand, James E Keenan, Jan Dubois, Jerry D.
620Hedden, Jess Robinson, Karl Williamson, Kent Fredric, Leon Timmermans, Lucas
621Holt, Matthew Horsfall, Nicholas Clark, Peter Martini, Rafael Garcia-Suarez,
622Ricardo Signes, Smylers, Steffen Müller, Steve Hay, Thomas Sibley, Tobias
623Leich, Tony Cook.
624
625The list above is almost certainly incomplete as it is automatically generated
626from version control history. In particular, it does not include the names of
627the (very much appreciated) contributors who reported issues to the Perl bug
628tracker.
629
630Many of the changes included in this version originated in the CPAN modules
631included in Perl's core. We're grateful to the entire CPAN community for
632helping Perl to flourish.
633
634For a more complete list of all of Perl's historical contributors, please see
635the F<AUTHORS> file in the Perl source distribution.
f5b73711 636
44691e6f
AB
637=head1 Reporting Bugs
638
e08634c5
SH
639If you find what you think is a bug, you might check the articles recently
640posted to the comp.lang.perl.misc newsgroup and the perl bug database at
641http://rt.perl.org/perlbug/ . There may also be information at
642http://www.perl.org/ , the Perl Home Page.
44691e6f 643
e08634c5
SH
644If you believe you have an unreported bug, please run the L<perlbug> program
645included with your release. Be sure to trim your bug down to a tiny but
646sufficient test case. Your bug report, along with the output of C<perl -V>,
647will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
44691e6f
AB
648
649If the bug you are reporting has security implications, which make it
e08634c5
SH
650inappropriate to send to a publicly archived mailing list, then please send it
651to perl5-security-report@perl.org. This points to a closed subscription
652unarchived mailing list, which includes all the core committers, who will be
653able to help assess the impact of issues, figure out a resolution, and help
f9001595 654co-ordinate the release of patches to mitigate or fix the problem across all
e08634c5
SH
655platforms on which Perl is supported. Please only use this address for
656security issues in the Perl core, not for modules independently distributed on
657CPAN.
44691e6f
AB
658
659=head1 SEE ALSO
660
e08634c5
SH
661The F<Changes> file for an explanation of how to view exhaustive details on
662what changed.
44691e6f
AB
663
664The F<INSTALL> file for how to build Perl.
665
666The F<README> file for general stuff.
667
668The F<Artistic> and F<Copying> files for copyright information.
669
670=cut