This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
62750201660ed2ddfa2ded754d3052a18370c019
[perl5.git] / pod / perldelta.pod
1 =encoding utf8
2
3 =head1 NAME
4
5 perldelta - what is new for perl v5.17.9
6
7 =head1 DESCRIPTION
8
9 This document describes differences between the 5.17.8 release and the 5.17.9
10 release.
11
12 If you are upgrading from an earlier release such as 5.17.7, first read
13 L<perl5178delta>, which describes differences between 5.17.7 and 5.17.8.
14
15 =head1 Core Enhancements
16
17 =head2 Interpolations now Accepted in Regular Expression Set Operations
18
19 Perl v5.17.8 introduced L<regular expression set operations|perlre/(?[ ])>.
20 They have now been expanded to allow the interpolation of a
21 previously-compiled set into a bigger set, like this:
22
23  my $thai_or_lao = qr/\p{Thai} + \p{Lao}/;
24  ...
25  qr/(?[ \p{Digit} & $thai_or_lao ])/;
26
27 =head1 Incompatible Changes
28
29 =head2 C<$ENV{foo} = undef> no longer deletes value from environ
30
31 5.17.3 Introduced a change where assiging C<undef> to an C<%ENV> key was equivalent
32 to C<delete $ENV{foo}>.
33
34 This release reverts that change.
35
36 =head1 Deprecations
37
38 The deprecation of lexical C<$_> in 5.17.7 has been commuted.  The feature
39 is now marked experimental.
40
41 =head2 Deprecated pragma
42
43 =over
44
45 =item L<encoding>
46
47 This module is deprecated under perl 5.18.  It uses a mechanism provided by
48 perl that is deprecated under 5.18 and higher, and may be removed in a
49 future version.
50
51 =back
52
53 =head2 Deprecated Modules
54
55 The following modules will be removed from the core distribution in a
56 future release, and should be installed from CPAN instead. Distributions
57 on CPAN which require these should add them to their prerequisites. The
58 core versions of these modules C<warnings> will issue a deprecation warning.
59
60 You can silence these deprecation warnings by installing the modules
61 in 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
83 =item C<CPANPLUS::Configure::Setup>
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
103 =item C<CPANPLUS::Internals::Constants>
104
105 =item C<CPANPLUS::Internals::Constants::Report>
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
121 =item C<CPANPLUS::Internals::Source::SQLite::Tie>
122
123 =item L<CPANPLUS::Internals::Utils>
124
125 =item C<CPANPLUS::Internals::Utils::Autoflush>
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
137 =item C<CPANPLUS::Module::Signature>
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
179 The following utilities will be removed from the core distribution in a
180 future release as their associated modules have been deprecated. They
181 will remain available with the applicable CPAN distribution.
182
183 =over
184
185 =item L<cpanp>
186
187 Included with L<CPANPLUS>.
188
189 =item C<cpanp-run-perl>
190
191 Included with L<CPANPLUS>.
192
193 =item L<cpan2dist>
194
195 Included with L<CPANPLUS>.
196
197 =item L<pod2latex>
198
199 The L<Pod::LaTeX> module was deprecated with 5.17.8.
200
201 =back
202
203 =head2 Five additional characters should be escaped in patterns with C</x>
204
205 When a regular expression pattern is compiled with C</x>, Perl treats 6
206 characters as white space to ignore, such as SPACE and TAB.  However,
207 Unicode recommends 11 characters be treated thusly.  In preparation to
208 conforming with this in a future Perl version, in the meantime, use of
209 any of the missing characters will raise a deprecation warning, unless
210 turned off.  The five characters are:
211 U+0085 NEXT LINE,
212 U+200E LEFT-TO-RIGHT MARK,
213 U+200F RIGHT-TO-LEFT MARK,
214 U+2028 LINE SEPARATOR,
215 and
216 U+2029 PARAGRAPH SEPARATOR.
217
218 =head1 Modules and Pragmata
219
220 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
221 go here.  If Module::CoreList is updated, generate an initial draft of the
222 following sections using F<Porting/corelist-perldelta.pl>, which prints stub
223 entries to STDOUT.  Results can be pasted in place of the '=head2' entries
224 below.  A paragraph summary for important changes should then be added by hand.
225 In an ideal world, dual-life modules would have a F<Changes> file that could be
226 cribbed.
227
228 [ Within each section, list entries as a =item entry ]
229
230 =head2 New Modules and Pragmata
231
232 =over 4
233
234 =item *
235
236 L<Config::Perl::V> version 0.16 has been added as a dual-lifed module.
237 It provides structured data retrieval of C<perl -V> output including
238 information only known to the C<perl> binary and not available via L<Config>.
239
240 =back
241
242 =head2 Updated Modules and Pragmata
243
244 =over 4
245
246 =item *
247
248 L<Benchmark> has been upgraded from version 1.13 to 1.14.
249
250 The "too few iterations" message is now a warning on STDERR
251 instead of being output on STDOUT.
252
253 =item *
254
255 L<Data::Dumper> has been upgraded from version 2.141 to 2.142.
256
257 Additional tests were added in order to improve statement, branch, condition
258 and subroutine coverage.  On the basis of the coverage analysis, some of the
259 internals of Dumper.pm were refactored.  Almost all methods are now
260 documented.
261
262 =item *
263
264 L<File::Temp> has been upgraded from version 0.22 to 0.22_90
265
266 Fixes various bugs involving directory removal.  Defers unlinking tempfiles if
267 the initial unlink fails, which fixes problems on NFS.
268
269 =item *
270
271 L<PerlIO::scalar> has been upgraded from version 0.15 to 0.16.
272
273 The buffer scalar supplied may now only contain code pounts 0xFF or
274 lower. [perl #109828]
275
276 =back
277
278 =head1 Documentation
279
280 =head2 Changes to Existing Documentation
281
282 =head3 L<perlsec>
283
284 =over 4
285
286 =item *
287
288 A syntax error was fixed in one of illustrative examples.
289
290 =back
291
292 =head1 Diagnostics
293
294 The following additions or changes have been made to diagnostic output,
295 including warnings and fatal error messages.  For the complete list of
296 diagnostic messages, see L<perldiag>.
297
298 =head2 New Diagnostics
299
300 =head3 New Warnings
301
302 =over 4
303
304 =item *
305
306 Strings with code points over 0xFF may not be mapped into in-memory file handles
307
308 =back
309
310 =head2 Changes to Existing Diagnostics
311
312 =over 4
313
314 =item *
315
316 The warnings for \b{ and \B{ were added in the 5.17 series; they are a
317 deprecation warning which should be turned off by that category.  One
318 should not have to turn off regular regexp warnings as well to get rid
319 of these.
320
321 =back
322
323 =head1 Utility Changes
324
325 =head3 L<corelist>
326
327 =over 4
328
329 =item *
330
331 Added C<--feature> switch which lists the first version bundle of each
332 named feature given.
333
334 =item *
335
336 Added C<--upstream> switch which shows if the given module
337 is primarily maintained in perl core or on CPAN and bug tracker URL.
338
339 =back
340
341 =head1 Configuration and Compilation
342
343 =over 4
344
345 =item *
346
347 Added C<useversionedarchname> option to Configure
348
349 When set, it includes 'api_versionstring' in 'archname'. E.g.
350 x86_64-linux-5.13.6-thread-multi.  It is unset by default.
351
352 This feature was requested by Tim Bunce, who observed that
353 INSTALL_BASE creates a library structure that does not
354 differentiate by perl version.  Instead, it places architecture
355 specific files in "$install_base/lib/perl5/$archname".  This makes
356 it difficult to use a common INSTALL_BASE library path with
357 multiple versions of perl.
358
359 By setting -Duseversionedarchname, the $archname will be
360 distinct for architecture *and* API version, allowing mixed use of
361 INSTALL_BASE.
362
363 =item *
364
365 Configure will honour the external C<MAILDOMAIN> environment variable, if set.
366
367 =item *
368
369 C<installman> no longer ignores the silent option
370
371 =item *
372
373 Both C<META.yml> and C<META.json> files are now included in the distribution.
374
375 =back
376
377 =head1 Testing
378
379 =over 4
380
381 =item *
382
383 Enable perl core tests to pass when locale support is not available.
384
385 use L<locale> - this will now die if $Config{d_setlocale} is not true.
386 All tests that use L<locale> will skip if $Config{d_setlocale} is not true.
387 This enables us to pass tests on Android which uses ICU instead of locales.
388
389 =back
390
391 =head1 Platform Support
392
393 =head2 Platform-Specific Notes
394
395 =over 4
396
397 =item VMS
398
399 The character set for Extended Filename Syntax (EFS) is now enabled by default on
400 VMS.  Among other things, this provides better handling of dots in directory names,
401 multiple dots in filenames,and spaces in filenames.  To obtain the old behavior,
402 set the logical name C<DECC$EFS_CHARSET> to C<DISABLE>.
403
404 =item MidnightBSD
405
406 C<libc_r> was removed from recent versions of MidnightBSD and older versions
407 work better with C<pthread>. Threading is now enabled using C<pthread> which
408 corrects build errors with threading enabled on 0.4-CURRENT.
409
410 =back
411
412 =head1 Internal Changes
413
414 =over 4
415
416 =item *
417
418 Synonyms for the misleadingly named C<av_len()> has been created:
419 C<av_top_index()> and C<av_tindex>.  All three of these return the
420 number of the highest index in the array, not the number of elements it
421 contains.  (The name C<av_top> which was introduced in Perl v.5.17.8 has
422 been removed.)
423
424 =back
425
426 =head1 Selected Bug Fixes
427
428 =over 4
429
430 =item *
431
432 -DPERL_GLOBAL_STRUCT builds now free the global struct B<after>
433 they've finished using it.
434
435 =item *
436
437 A trailing '/' on a path in @INC will no longer have an additional '/' appended.
438
439 =item *
440
441 The C<:crlf> layer now works when unread data doesn't fit into its own
442 buffer. [perl #112244].
443
444 =item *
445
446 C<ungetc()> now handles UTF-8 encoded data. [perl #116322].
447
448 =back
449
450 =head1 Acknowledgements
451
452 Perl 5.17.9 represents approximately 4 weeks of development since Perl 5.17.8
453 and contains approximately 42,000 lines of changes across 510 files from 35
454 authors.
455
456 Perl continues to flourish into its third decade thanks to a vibrant community
457 of users and developers. The following people are known to have contributed the
458 improvements that became Perl 5.17.9:
459
460 !, Aaron Crane, Alan Haggai Alavi, Alexandr Ciornii, Andy Dougherty, Brad
461 Gilbert, Chris 'BinGOs' Williams, Christian Hansen, Craig A. Berry, Dagfinn
462 Ilmari Mannsåker, Daniel Dragan, Dave Rolsky, David Golden, David Mitchell,
463 Father Chrysostomos, H.Merijn Brand, James E Keenan, Jan Dubois, Jerry D.
464 Hedden, Jess Robinson, Karl Williamson, Kent Fredric, Leon Timmermans, Lucas
465 Holt, Matthew Horsfall, Nicholas Clark, Peter Martini, Rafael Garcia-Suarez,
466 Ricardo Signes, Smylers, Steffen Müller, Steve Hay, Thomas Sibley, Tobias
467 Leich, Tony Cook.
468
469 The list above is almost certainly incomplete as it is automatically generated
470 from version control history. In particular, it does not include the names of
471 the (very much appreciated) contributors who reported issues to the Perl bug
472 tracker.
473
474 Many of the changes included in this version originated in the CPAN modules
475 included in Perl's core. We're grateful to the entire CPAN community for
476 helping Perl to flourish.
477
478 For a more complete list of all of Perl's historical contributors, please see
479 the F<AUTHORS> file in the Perl source distribution.
480
481 =head1 Reporting Bugs
482
483 If you find what you think is a bug, you might check the articles recently
484 posted to the comp.lang.perl.misc newsgroup and the perl bug database at
485 http://rt.perl.org/perlbug/ .  There may also be information at
486 http://www.perl.org/ , the Perl Home Page.
487
488 If you believe you have an unreported bug, please run the L<perlbug> program
489 included with your release.  Be sure to trim your bug down to a tiny but
490 sufficient test case.  Your bug report, along with the output of C<perl -V>,
491 will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
492
493 If the bug you are reporting has security implications, which make it
494 inappropriate to send to a publicly archived mailing list, then please send it
495 to perl5-security-report@perl.org.  This points to a closed subscription
496 unarchived mailing list, which includes all the core committers, who will be
497 able to help assess the impact of issues, figure out a resolution, and help
498 co-ordinate the release of patches to mitigate or fix the problem across all
499 platforms on which Perl is supported.  Please only use this address for
500 security issues in the Perl core, not for modules independently distributed on
501 CPAN.
502
503 =head1 SEE ALSO
504
505 The F<Changes> file for an explanation of how to view exhaustive details on
506 what changed.
507
508 The F<INSTALL> file for how to build Perl.
509
510 The F<README> file for general stuff.
511
512 The F<Artistic> and F<Copying> files for copyright information.
513
514 =cut