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