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 =head2 New Modules and Pragmata
 221
 222 =over 4
 223
 224 =item *
 225
 226 L<Config::Perl::V> version 0.16 has been added as a dual-lifed module.
 227 It provides structured data retrieval of C<perl -V> output including
 228 information only known to the C<perl> binary and not available via L<Config>.
 229
 230 =back
 231
 232 =head2 Updated Modules and Pragmata
 233
 234 =over 4
 235
 236 =item *
 237
 238 L<Archive::Extract> has been upgraded from version 0.62 to 0.68.
 239
 240 NOTE: L<Archive::Extract> is deprecated and may be removed from a future version of Perl.
 241
 242 =item *
 243
 244 L<Attribute::Handlers> has been upgraded from version 0.93 to 0.94.
 245
 246 =item *
 247
 248 L<B::Lint> has been upgraded from version 1.14 to 1.17.
 249
 250 NOTE: L<B::Lint> is deprecated and may be removed from a future version of Perl.
 251
 252 =item *
 253
 254 L<Benchmark> has been upgraded from version 1.13 to 1.14.
 255
 256 The "too few iterations" message is now a warning on STDERR
 257 instead of being output on STDOUT.
 258
 259 =item *
 260
 261 L<bignum> has been upgraded from version 0.31 to 0.32.
 262
 263 =item *
 264
 265 L<CPAN> has been upgraded from version 1.99_51 to 2.00.
 266
 267 =item *
 268
 269 L<CPANPLUS> has been upgraded from version 0.9133 to 0.9135.
 270
 271 NOTE: L<CPANPLUS> is deprecated and may be removed from a future version of Perl.
 272
 273 =item *
 274
 275 L<CPANPLUS::Dist::Build> has been upgraded from version 0.68 to 0.70.
 276
 277 NOTE: L<CPANPLUS::Dist::Build> is deprecated and may be removed from a future version of Perl.
 278
 279 =item *
 280
 281 L<Data::Dumper> has been upgraded from version 2.141 to 2.142.
 282
 283 Additional tests were added in order to improve statement, branch, condition
 284 and subroutine coverage.  On the basis of the coverage analysis, some of the
 285 internals of Dumper.pm were refactored.  Almost all methods are now
 286 documented.
 287
 288 =item *
 289
 290 L<DBM_Filter> has been upgraded from version 0.04 to 0.05.
 291
 292 =item *
 293
 294 L<Digest::SHA> has been upgraded from version 5.81 to 5.82.
 295
 296 =item *
 297
 298 L<Encode> has been upgraded from version 2.47 to 2.48.
 299
 300 =item *
 301
 302 L<ExtUtils::Manifest> has been upgraded from version 1.62 to 1.63.
 303
 304 =item *
 305
 306 L<File::CheckTree> has been upgraded from version 4.41 to 4.42.
 307
 308 =item *
 309
 310 L<File::DosGlob> has been upgraded from version 1.09 to 1.10.
 311
 312 =item *
 313
 314 L<File::Temp> has been upgraded from version 0.22 to 0.22_90
 315
 316 Fixes various bugs involving directory removal.  Defers unlinking tempfiles if
 317 the initial unlink fails, which fixes problems on NFS.
 318
 319 =item *
 320
 321 L<Filter::Simple> has been upgraded from version 0.88 to 0.89.
 322
 323 =item *
 324
 325 L<IO> has been upgraded from version 1.26 to 1.27.
 326
 327 =item *
 328
 329 L<Log::Message> has been upgraded from version 0.04 to 0.06.
 330
 331 NOTE: L<Log::Message> is deprecated and may be removed from a future version of Perl.
 332
 333 =item *
 334
 335 L<Log::Message::Simple> has been upgraded from version 0.08 to 0.10.
 336
 337 NOTE: L<Log::Message::Simple> is deprecated and may be removed from a future version of Perl.
 338
 339 =item *
 340
 341 L<Math::BigInt> has been upgraded from version 1.998 to 1.999.
 342
 343 =item *
 344
 345 L<Module::CoreList> has been upgraded from version 2.80 to 2.82.
 346
 347 =item *
 348
 349 L<Module::Load> has been upgraded from version 0.22 to 0.24.
 350
 351 =item *
 352
 353 L<Module::Pluggable> has been upgraded from version 4.5 to 4.6.
 354
 355 NOTE: L<Module::Pluggable> is deprecated and may be removed from a future version of Perl.
 356
 357 =item *
 358
 359 L<Object::Accessor> has been upgraded from version 0.44 to 0.46.
 360
 361 NOTE: L<Object::Accessor> is deprecated and may be removed from a future version of Perl.
 362
 363 =item *
 364
 365 L<overload> has been upgraded from version 1.20 to 1.21.
 366
 367 =item *
 368
 369 L<PerlIO::scalar> has been upgraded from version 0.15 to 0.16.
 370
 371 The buffer scalar supplied may now only contain code pounts 0xFF or
 372 lower. [perl #109828]
 373
 374 =item *
 375
 376 L<Pod::Checker> has been upgraded from version 1.51 to 1.60.
 377
 378 =item *
 379
 380 L<Pod::Html> has been upgraded from version 1.17 to 1.18.
 381
 382 =item *
 383
 384 L<Pod::Parser> has been upgraded from version 1.51 to 1.60.
 385
 386 =item *
 387
 388 L<Pod::Perldoc> has been upgraded from version 3.17 to 3.19.
 389
 390 =item *
 391
 392 L<Pod::Usage> has been upgraded from version 1.51 to 1.61.
 393
 394 =item *
 395
 396 L<SelfLoader> has been upgraded from version 1.20 to 1.21.
 397
 398 =item *
 399
 400 L<Term::UI> has been upgraded from version 0.32 to 0.34.
 401
 402 NOTE: L<Term::UI> is deprecated and may be removed from a future version of Perl.
 403
 404 =item *
 405
 406 L<Test::Harness> has been upgraded from version 3.25_01 to 3.26.
 407
 408 =item *
 409
 410 L<Text::Soundex> has been upgraded from version 3.03_01 to 3.04.
 411
 412 =item *
 413
 414 L<Thread::Queue> has been upgraded from version 3.01 to 3.02.
 415
 416 =item *
 417
 418 L<Unicode::UCD> has been upgraded from version 0.47 to 0.50.
 419
 420 =item *
 421
 422 L<warnings> has been upgraded from version 1.16 to 1.17.
 423
 424 =item *
 425
 426 L<Win32> has been upgraded from version 0.45 to 0.46.
 427
 428 =item *
 429
 430 L<Win32API::File> has been upgraded from version 0.1200 to 0.1201.
 431
 432 =back
 433
 434 =head1 Documentation
 435
 436 =head2 Changes to Existing Documentation
 437
 438 =head3 L<perlsec>
 439
 440 =over 4
 441
 442 =item *
 443
 444 A syntax error was fixed in one of illustrative examples.
 445
 446 =back
 447
 448 =head1 Diagnostics
 449
 450 The following additions or changes have been made to diagnostic output,
 451 including warnings and fatal error messages.  For the complete list of
 452 diagnostic messages, see L<perldiag>.
 453
 454 =head2 New Diagnostics
 455
 456 =head3 New Warnings
 457
 458 =over 4
 459
 460 =item *
 461
 462 Strings with code points over 0xFF may not be mapped into in-memory file handles
 463
 464 =back
 465
 466 =head2 Changes to Existing Diagnostics
 467
 468 =over 4
 469
 470 =item *
 471
 472 The warnings for \b{ and \B{ were added in the 5.17 series; they are a
 473 deprecation warning which should be turned off by that category.  One
 474 should not have to turn off regular regexp warnings as well to get rid
 475 of these.
 476
 477 =back
 478
 479 =head1 Utility Changes
 480
 481 =head3 L<corelist>
 482
 483 =over 4
 484
 485 =item *
 486
 487 Added C<--feature> switch which lists the first version bundle of each
 488 named feature given.
 489
 490 =item *
 491
 492 Added C<--upstream> switch which shows if the given module
 493 is primarily maintained in perl core or on CPAN and bug tracker URL.
 494
 495 =back
 496
 497 =head1 Configuration and Compilation
 498
 499 =over 4
 500
 501 =item *
 502
 503 Added C<useversionedarchname> option to Configure
 504
 505 When set, it includes 'api_versionstring' in 'archname'. E.g.
 506 x86_64-linux-5.13.6-thread-multi.  It is unset by default.
 507
 508 This feature was requested by Tim Bunce, who observed that
 509 INSTALL_BASE creates a library structure that does not
 510 differentiate by perl version.  Instead, it places architecture
 511 specific files in "$install_base/lib/perl5/$archname".  This makes
 512 it difficult to use a common INSTALL_BASE library path with
 513 multiple versions of perl.
 514
 515 By setting -Duseversionedarchname, the $archname will be
 516 distinct for architecture *and* API version, allowing mixed use of
 517 INSTALL_BASE.
 518
 519 =item *
 520
 521 Configure will honour the external C<MAILDOMAIN> environment variable, if set.
 522
 523 =item *
 524
 525 C<installman> no longer ignores the silent option
 526
 527 =item *
 528
 529 Both C<META.yml> and C<META.json> files are now included in the distribution.
 530
 531 =back
 532
 533 =head1 Testing
 534
 535 =over 4
 536
 537 =item *
 538
 539 Enable perl core tests to pass when locale support is not available.
 540
 541 use L<locale> - this will now die if $Config{d_setlocale} is not true.
 542 All tests that use L<locale> will skip if $Config{d_setlocale} is not true.
 543 This enables us to pass tests on Android which uses ICU instead of locales.
 544
 545 =back
 546
 547 =head1 Platform Support
 548
 549 =head2 Platform-Specific Notes
 550
 551 =over 4
 552
 553 =item VMS
 554
 555 The character set for Extended Filename Syntax (EFS) is now enabled by default on
 556 VMS.  Among other things, this provides better handling of dots in directory names,
 557 multiple dots in filenames,and spaces in filenames.  To obtain the old behavior,
 558 set the logical name C<DECC$EFS_CHARSET> to C<DISABLE>.
 559
 560 =item MidnightBSD
 561
 562 C<libc_r> was removed from recent versions of MidnightBSD and older versions
 563 work better with C<pthread>. Threading is now enabled using C<pthread> which
 564 corrects build errors with threading enabled on 0.4-CURRENT.
 565
 566 =back
 567
 568 =head1 Internal Changes
 569
 570 =over 4
 571
 572 =item *
 573
 574 Synonyms for the misleadingly named C<av_len()> has been created:
 575 C<av_top_index()> and C<av_tindex>.  All three of these return the
 576 number of the highest index in the array, not the number of elements it
 577 contains.  (The name C<av_top> which was introduced in Perl v.5.17.8 has
 578 been removed.)
 579
 580 =back
 581
 582 =head1 Selected Bug Fixes
 583
 584 =over 4
 585
 586 =item *
 587
 588 -DPERL_GLOBAL_STRUCT builds now free the global struct B<after>
 589 they've finished using it.
 590
 591 =item *
 592
 593 A trailing '/' on a path in @INC will no longer have an additional '/' appended.
 594
 595 =item *
 596
 597 The C<:crlf> layer now works when unread data doesn't fit into its own
 598 buffer. [perl #112244].
 599
 600 =item *
 601
 602 C<ungetc()> now handles UTF-8 encoded data. [perl #116322].
 603
 604 =back
 605
 606 =head1 Acknowledgements
 607
 608 Perl 5.17.9 represents approximately 4 weeks of development since Perl 5.17.8
 609 and contains approximately 42,000 lines of changes across 510 files from 35
 610 authors.
 611
 612 Perl continues to flourish into its third decade thanks to a vibrant community
 613 of users and developers. The following people are known to have contributed the
 614 improvements that became Perl 5.17.9:
 615
 616 Aaron Crane, Alan Haggai Alavi, Alexandr Ciornii, Andy Dougherty, Brad
 617 Gilbert, Chris 'BinGOs' Williams, Christian Hansen, Craig A. Berry, Dagfinn
 618 Ilmari Mannsåker, Daniel Dragan, Dave Rolsky, David Golden, David Mitchell,
 619 Father Chrysostomos, H.Merijn Brand, James E Keenan, Jan Dubois, Jerry D.
 620 Hedden, Jess Robinson, Karl Williamson, Kent Fredric, Leon Timmermans, Lucas
 621 Holt, Matthew Horsfall, Nicholas Clark, Peter Martini, Rafael Garcia-Suarez,
 622 Ricardo Signes, Smylers, Steffen Müller, Steve Hay, Thomas Sibley, Tobias
 623 Leich, Tony Cook.
 624
 625 The list above is almost certainly incomplete as it is automatically generated
 626 from version control history. In particular, it does not include the names of
 627 the (very much appreciated) contributors who reported issues to the Perl bug
 628 tracker.
 629
 630 Many of the changes included in this version originated in the CPAN modules
 631 included in Perl's core. We're grateful to the entire CPAN community for
 632 helping Perl to flourish.
 633
 634 For a more complete list of all of Perl's historical contributors, please see
 635 the F<AUTHORS> file in the Perl source distribution.
 636
 637 =head1 Reporting Bugs
 638
 639 If you find what you think is a bug, you might check the articles recently
 640 posted to the comp.lang.perl.misc newsgroup and the perl bug database at
 641 http://rt.perl.org/perlbug/ .  There may also be information at
 642 http://www.perl.org/ , the Perl Home Page.
 643
 644 If you believe you have an unreported bug, please run the L<perlbug> program
 645 included with your release.  Be sure to trim your bug down to a tiny but
 646 sufficient test case.  Your bug report, along with the output of C<perl -V>,
 647 will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
 648
 649 If the bug you are reporting has security implications, which make it
 650 inappropriate to send to a publicly archived mailing list, then please send it
 651 to perl5-security-report@perl.org.  This points to a closed subscription
 652 unarchived mailing list, which includes all the core committers, who will be
 653 able to help assess the impact of issues, figure out a resolution, and help
 654 co-ordinate the release of patches to mitigate or fix the problem across all
 655 platforms on which Perl is supported.  Please only use this address for
 656 security issues in the Perl core, not for modules independently distributed on
 657 CPAN.
 658
 659 =head1 SEE ALSO
 660
 661 The F<Changes> file for an explanation of how to view exhaustive details on
 662 what changed.
 663
 664 The F<INSTALL> file for how to build Perl.
 665
 666 The F<README> file for general stuff.
 667
 668 The F<Artistic> and F<Copying> files for copyright information.
 669
 670 =cut