pod/perldelta.pod

   1 =encoding utf8
   2
   3 =head1 NAME
   4
   5 [ this is a template for a new perldelta file.  Any text flagged as XXX needs
   6 to be processed before release. ]
   7
   8 perldelta - what is new for perl v5.17.7
   9
  10 =head1 DESCRIPTION
  11
  12 This document describes differences between the 5.17.6 release and the 5.17.7
  13 release.
  14
  15 If you are upgrading from an earlier release such as 5.17.5, first read
  16 L<perl5176delta>, which describes differences between 5.17.5 and 5.17.6.
  17
  18 =head1 Notice
  19
  20 XXX Any important notices here
  21
  22 =head1 Core Enhancements
  23
  24 =head2 $&, $` and $' are no longer slow
  25
  26 These three infamous variables have been redeemed and no longer slow down
  27 your program when used.  Hence, the /p regular expression flag now does
  28 nothing.
  29
  30 =head1 Security
  31
  32 XXX Any security-related notices go here.  In particular, any security
  33 vulnerabilities closed should be noted here rather than in the
  34 L</Selected Bug Fixes> section.
  35
  36 [ List each security issue as a =head2 entry ]
  37
  38 =head1 Incompatible Changes
  39
  40 =head2 readline() with C<$/ = \N> now reads N characters, not N bytes
  41
  42 Previously, when reading from a stream with I/O layers such as
  43 C<encoding>, the readline() function, otherwise known as the C<< <> >>
  44 operator, would read I<N> bytes from the top-most layer. [perl #79960]
  45
  46 Now, I<N> characters are read instead.
  47
  48 There is no change in behaviour when reading from streams with no
  49 extra layers, since bytes map exactly to characters.
  50
  51 =head2 Lexical subroutine warnings have moved
  52
  53 The warning about the use of an experimental feature emitted when lexical
  54 subroutines (added in 5.17.4) are used now happens when the subroutine
  55 itself is declared, not when the "lexical_subs" feature is activated via
  56 C<use feature>.
  57
  58 This stops C<use feature ':all'> from warning, but causes
  59 C<my sub foo; my sub bar> to warn twice.
  60
  61 =head1 Deprecations
  62
  63 XXX Any deprecated features, syntax, modules etc. should be listed here.  In
  64 particular, deprecated modules should be listed here even if they are listed as
  65 an updated module in the L</Modules and Pragmata> section.
  66
  67 [ List each deprecation as a =head2 entry ]
  68
  69 =head2 Lexical $_ is now deprecated
  70
  71 Since it was introduced in Perl 5.10, it has caused much confusion with no
  72 obvious solution:
  73
  74 =over
  75
  76 =item *
  77
  78 Various modules (e.g., List::Util) expect callback routines to use the
  79 global $_.  C<use List::Util 'first'; my $_; first { $_ == 1 } @list> does
  80 not work as one would expect.
  81
  82 =item *
  83
  84 A C<my $_> declaration earlier in the same file can cause confusing closure
  85 warnings.
  86
  87 =item *
  88
  89 The "_" subroutine prototype character allows called subroutines to access
  90 your lexical $_, so it is not really private after all.
  91
  92 =item *
  93
  94 Nevertheless, subroutines with a "(@)" prototype and methods cannot access
  95 the caller's lexical $_, unless they are written in XS.
  96
  97 =item *
  98
  99 But even XS routines cannot access a lexical $_ declared, not in the
 100 calling subroutine, but in an outer scope, iff that subroutine happened not
 101 to mention $_ or use any operators that default to $_.
 102
 103 =back
 104
 105 =head2 Various XS-callable functions are now deprecated
 106
 107 The following functions will be removed from a future version of Perl,
 108 and should not be used.  With participating C compilers (e.g., gcc),
 109 compiling any file that uses any of these will generate a warning.
 110 These were not intended for public use; there are equivalent, faster,
 111 macros for most of them.  See L<perlapi/Character classes>:
 112 C<is_uni_ascii>,
 113 C<is_uni_ascii_lc>,
 114 C<is_uni_blank>,
 115 C<is_uni_blank_lc>,
 116 C<is_uni_cntrl>,
 117 C<is_uni_cntrl_lc>,
 118 C<is_uni_idfirst_lc>,
 119 C<is_uni_space>,
 120 C<is_uni_space_lc>,
 121 C<is_uni_xdigit>,
 122 C<is_uni_xdigit_lc>,
 123 C<is_utf8_ascii>,
 124 C<is_utf8_blank>,
 125 C<is_utf8_cntrl>,
 126 C<is_utf8_idcont>,
 127 C<is_utf8_idfirst>,
 128 C<is_utf8_perl_space>,
 129 C<is_utf8_perl_word>,
 130 C<is_utf8_posix_digit>,
 131 C<is_utf8_space>,
 132 C<is_utf8_xdigit>.
 133 C<is_utf8_xidcont>,
 134 C<is_utf8_xidfirst>,
 135 C<to_uni_lower_lc>,
 136 C<to_uni_title_lc>,
 137 and
 138 C<to_uni_upper_lc>.
 139
 140 =head1 Performance Enhancements
 141
 142 XXX Changes which enhance performance without changing behaviour go here.
 143 There may well be none in a stable release.
 144
 145 [ List each enhancement as a =item entry ]
 146
 147 =over 4
 148
 149 =item *
 150
 151 Perl has a new copy-on-write mechanism that avoids the need to copy the
 152 internal string buffer when assigning from one scalar to another.  This
 153 makes copying large strings appear much faster.  Modifying one of the two
 154 (or more) strings after an assignment will force a copy internally.  This
 155 makes it unnecessary to pass strings by reference for efficiency.
 156
 157 =back
 158
 159 =head1 Modules and Pragmata
 160
 161 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
 162 go here.  If Module::CoreList is updated, generate an initial draft of the
 163 following sections using F<Porting/corelist-perldelta.pl>, which prints stub
 164 entries to STDOUT.  Results can be pasted in place of the '=head2' entries
 165 below.  A paragraph summary for important changes should then be added by hand.
 166 In an ideal world, dual-life modules would have a F<Changes> file that could be
 167 cribbed.
 168
 169 [ Within each section, list entries as a =item entry ]
 170
 171 =head2 New Modules and Pragmata
 172
 173 =over 4
 174
 175 =item *
 176
 177 XXX
 178
 179 =back
 180
 181 =head2 Updated Modules and Pragmata
 182
 183 =over 4
 184
 185 =item *
 186
 187 L<GDBM_File> has been upgraded from version 1.14 to 1.15. The undocumented
 188 optional fifth parameter to C<TIEHASH> has been removed. This was intended
 189 to provide control of the callback used by C<gdbm*> functions in case of
 190 fatal errors (such as filesystem problems), but did not work (and could
 191 never have worked). No code on CPAN even attempted to use it. The callback
 192 is now always the previous default, C<croak>. Problems on some platforms with
 193 how the C<C> C<croak> function is called have also been resolved.
 194
 195 =back
 196
 197 =head2 Removed Modules and Pragmata
 198
 199 =over 4
 200
 201 =item *
 202
 203 XXX
 204
 205 =back
 206
 207 =head1 Documentation
 208
 209 XXX Changes to files in F<pod/> go here.  Consider grouping entries by
 210 file and be sure to link to the appropriate page, e.g. L<perlfunc>.
 211
 212 =head2 New Documentation
 213
 214 XXX Changes which create B<new> files in F<pod/> go here.
 215
 216 =head3 L<XXX>
 217
 218 XXX Description of the purpose of the new file here
 219
 220 =head2 Changes to Existing Documentation
 221
 222 XXX Changes which significantly change existing files in F<pod/> go here.
 223 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
 224 section.
 225
 226 =head3 L<perlapi/Character classes>
 227
 228 =over 4
 229
 230 =item *
 231
 232 There are quite a few macros callable from XS modules that classify
 233 characters into things like alphabetic, punctuation, etc.  More of these
 234 are now documented, including ones which work on characters whose code
 235 points are outside the Latin-1 range.
 236
 237 =back
 238
 239 =head1 Diagnostics
 240
 241 The following additions or changes have been made to diagnostic output,
 242 including warnings and fatal error messages.  For the complete list of
 243 diagnostic messages, see L<perldiag>.
 244
 245 XXX New or changed warnings emitted by the core's C<C> code go here.  Also
 246 include any changes in L<perldiag> that reconcile it to the C<C> code.
 247
 248 =head2 New Diagnostics
 249
 250 XXX Newly added diagnostic messages go under here, separated into New Errors
 251 and New Warnings
 252
 253 =head3 New Errors
 254
 255 =over 4
 256
 257 =item *
 258
 259 XXX L<message|perldiag/"message">
 260
 261 =back
 262
 263 =head3 New Warnings
 264
 265 =over 4
 266
 267 =item *
 268
 269 XXX L<message|perldiag/"message">
 270
 271 =back
 272
 273 =head2 Changes to Existing Diagnostics
 274
 275 XXX Changes (i.e. rewording) of diagnostic messages go here
 276
 277 =over 4
 278
 279 =item *
 280
 281 L<Constant(%s): Call to &{$^H{%s}} did not return a defined value|perldiag/Constant(%s): Call to &{$^H{%s}} did not return a defined value>
 282
 283 Constant overloading that returns C<undef> results in this error message.
 284 For numeric constants, it used to say "Constant(undef)".  "undef" has been
 285 replaced with the number itself.
 286
 287 =back
 288
 289 =head1 Utility Changes
 290
 291 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go here.
 292 Most of these are built within the directories F<utils> and F<x2p>.
 293
 294 [ List utility changes as a =head3 entry for each utility and =item
 295 entries for each change
 296 Use L<XXX> with program names to get proper documentation linking. ]
 297
 298 =head3 L<XXX>
 299
 300 =over 4
 301
 302 =item *
 303
 304 XXX
 305
 306 =back
 307
 308 =head1 Configuration and Compilation
 309
 310 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
 311 go here.  Any other changes to the Perl build process should be listed here.
 312 However, any platform-specific changes should be listed in the
 313 L</Platform Support> section, instead.
 314
 315 [ List changes as a =item entry ].
 316
 317 =over 4
 318
 319 =item *
 320
 321 XXX
 322
 323 =back
 324
 325 =head1 Testing
 326
 327 XXX Any significant changes to the testing of a freshly built perl should be
 328 listed here.  Changes which create B<new> files in F<t/> go here as do any
 329 large changes to the testing harness (e.g. when parallel testing was added).
 330 Changes to existing files in F<t/> aren't worth summarizing, although the bugs
 331 that they represent may be covered elsewhere.
 332
 333 [ List each test improvement as a =item entry ]
 334
 335 =over 4
 336
 337 =item *
 338
 339 XXX
 340
 341 =back
 342
 343 =head1 Platform Support
 344
 345 XXX Any changes to platform support should be listed in the sections below.
 346
 347 [ Within the sections, list each platform as a =item entry with specific
 348 changes as paragraphs below it. ]
 349
 350 =head2 New Platforms
 351
 352 XXX List any platforms that this version of perl compiles on, that previous
 353 versions did not.  These will either be enabled by new files in the F<hints/>
 354 directories, or new subdirectories and F<README> files at the top level of the
 355 source tree.
 356
 357 =over 4
 358
 359 =item XXX-some-platform
 360
 361 XXX
 362
 363 =back
 364
 365 =head2 Discontinued Platforms
 366
 367 =over 4
 368
 369 =item BeOS
 370
 371 Support for BeOS has been removed.
 372
 373 =back
 374
 375 =head2 Platform-Specific Notes
 376
 377 XXX List any changes for specific platforms.  This could include configuration
 378 and compilation changes or changes in portability/compatibility.  However,
 379 changes within modules for platforms should generally be listed in the
 380 L</Modules and Pragmata> section.
 381
 382 =over 4
 383
 384 =item XXX-some-platform
 385
 386 XXX
 387
 388 =back
 389
 390 =head1 Internal Changes
 391
 392 XXX Changes which affect the interface available to C<XS> code go here.  Other
 393 significant internal changes for future core maintainers should be noted as
 394 well.
 395
 396 [ List each change as a =item entry ]
 397
 398 =over 4
 399
 400 =item *
 401
 402 SvUPGRADE() is no longer an expression. Originally this macro (and its
 403 underlying function, sv_upgrade()) were documented as boolean, although
 404 in reality they always croaked on error and never returned false. In 2005
 405 the documentation was updated to specify a void return value, but
 406 SvUPGRADE() was left always returning 1 for backwards compatibility. This
 407 has now been removed, and SvUPGRADE() is now a statement with no return
 408 value.
 409
 410 So this is now a syntax error:
 411
 412     if (!SvUPGRADE(sv)) { croak(...); }
 413
 414 If you have code like that, simply replace it with
 415
 416     SvUPGRADE(sv);
 417
 418 or to to avoid compiler warnings with older perls, possibly
 419
 420     (void)SvUPGRADE(sv);
 421
 422 =item *
 423
 424 Perl has a new copy-on-write mechanism that allows any SvPOK scalar to be
 425 upgraded to a copy-on-write scalar.  A reference count on the string buffer
 426 is stored in the string buffer itself.
 427
 428 This breaks a few XS modules by allowing copy-on-write scalars to go
 429 through code paths that never encountered them before.
 430
 431 This behaviour can still be disabled by running F<Configure> with
 432 B<-Accflags=-DPERL_NO_COW>.  This option will probably be removed in Perl
 433 5.20.
 434
 435 =item *
 436
 437 Copy-on-write no longer uses the SvFAKE and SvREADONLY flags.  Hence,
 438 SvREADONLY indicates a true read-only SV.
 439
 440 Use the SvIsCOW macro (as before) to identify a copy-on-write scalar.
 441
 442 =item *
 443
 444 C<PL_sawampersand> is now a constant.  The switch this variable provided
 445 (to enable/disable the pre-match copy depending on whether C<$&> had been
 446 seen) has been removed and replaced with copy-on-write, eliminating a few
 447 bugs.
 448
 449 The previous behaviour can still be enabled by running F<Configure> with
 450 B<-Accflags=-DPERL_SAWAMPERSAND>.
 451
 452 =back
 453
 454 =head1 Selected Bug Fixes
 455
 456 XXX Important bug fixes in the core language are summarized here.  Bug fixes in
 457 files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
 458
 459 [ List each fix as a =item entry ]
 460
 461 =over 4
 462
 463 =item *
 464
 465 C<sort {undef} ...> under fatal warnings no longer crashes.  It started
 466 crashing in Perl 5.16.
 467
 468 =item *
 469
 470 Stashes blessed into each other
 471 (C<bless \%Foo::, 'Bar'; bless \%Bar::, 'Foo'>) no longer result in double
 472 frees.  This bug started happening in Perl 5.16.
 473
 474 =item *
 475
 476 Numerous memory leaks have been fixed, mostly involving fatal warnings and
 477 syntax errors.
 478
 479 =item *
 480
 481 Lexical constants (C<my sub answer () { 42 }>) no longer cause double
 482 frees.
 483
 484 =item *
 485
 486 Constant subroutine redefinition warns by default, but lexical constants
 487 were accidentally exempt from default warnings.  This has been corrected.
 488
 489 =item *
 490
 491 Some failed regular expression matches such as C<'f' =~ /../g> were not
 492 resetting C<pos>.  Also, "match-once" patterns (C<m?...?g>) failed to reset
 493 it, too, when invoked a second time [perl #23180].
 494
 495 =item *
 496
 497 Accessing C<$&> after a pattern match now works if it had not been seen
 498 before the match.  I.e., this applies to C<${'&'}> (under C<no strict>) and
 499 C<eval '$&'>.  The same applies to C<$'> and C<$`> [perl #4289].
 500
 501 =item *
 502
 503 Several bugs involving C<local *ISA> and C<local *Foo::> causing stale
 504 MRO caches have been fixed.
 505
 506 =item *
 507
 508 Defining a subroutine when its typeglob has been aliased no longer results
 509 in stale method caches.  This bug was introduced in Perl 5.10.
 510
 511 =item *
 512
 513 Localising a typeglob containing a subroutine when the typeglob's package
 514 has been deleted from its parent stash no longer produces an error.  This
 515 bug was introduced in Perl 5.14.
 516
 517 =item *
 518
 519 Under some circumstances, C<local *method=...> would fail to reset method
 520 caches upon scope exit.
 521
 522 =item *
 523
 524 C</[.foo.]/> is no longer an error, but produces a warning (as before) and
 525 is treated as C</[.fo]/> [perl #115818].
 526
 527 =item *
 528
 529 C<goto $tied_var> now calls FETCH before deciding what type of goto
 530 (subroutine or label) this is.
 531
 532 =item *
 533
 534 Renaming packages through glob assignment
 535 (C<*Foo:: = *Bar::; *Bar:: = *Baz::>) in combination with C<m?...?> and
 536 C<reset> no longer makes threaded builds crash.
 537
 538 =item *
 539
 540 An earlier release in the 5.17.x series could crash if user code prevented
 541 _charnames from loading via C<$INC{'_charnames.pm'}++>.
 542
 543 =back
 544
 545 =head1 Known Problems
 546
 547 XXX Descriptions of platform agnostic bugs we know we can't fix go here.  Any
 548 tests that had to be C<TODO>ed for the release would be noted here.  Unfixed
 549 platform specific bugs also go here.
 550
 551 [ List each fix as a =item entry ]
 552
 553 =over 4
 554
 555 =item *
 556
 557 XXX
 558
 559 =back
 560
 561 =head1 Obituary
 562
 563 XXX If any significant core contributor has died, we've added a short obituary
 564 here.
 565
 566 =head1 Acknowledgements
 567
 568 XXX Generate this with:
 569
 570   perl Porting/acknowledgements.pl v5.17.6..HEAD
 571
 572 =head1 Reporting Bugs
 573
 574 If you find what you think is a bug, you might check the articles recently
 575 posted to the comp.lang.perl.misc newsgroup and the perl bug database at
 576 http://rt.perl.org/perlbug/ .  There may also be information at
 577 http://www.perl.org/ , the Perl Home Page.
 578
 579 If you believe you have an unreported bug, please run the L<perlbug> program
 580 included with your release.  Be sure to trim your bug down to a tiny but
 581 sufficient test case.  Your bug report, along with the output of C<perl -V>,
 582 will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
 583
 584 If the bug you are reporting has security implications, which make it
 585 inappropriate to send to a publicly archived mailing list, then please send it
 586 to perl5-security-report@perl.org.  This points to a closed subscription
 587 unarchived mailing list, which includes all the core committers, who will be
 588 able to help assess the impact of issues, figure out a resolution, and help
 589 co-ordinate the release of patches to mitigate or fix the problem across all
 590 platforms on which Perl is supported.  Please only use this address for
 591 security issues in the Perl core, not for modules independently distributed on
 592 CPAN.
 593
 594 =head1 SEE ALSO
 595
 596 The F<Changes> file for an explanation of how to view exhaustive details on
 597 what changed.
 598
 599 The F<INSTALL> file for how to build Perl.
 600
 601 The F<README> file for general stuff.
 602
 603 The F<Artistic> and F<Copying> files for copyright information.
 604
 605 =cut