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
   6 XXX needs to be processed before release. ]
   7
   8 perldelta - what is new for perl v5.17.2
   9
  10 =head1 DESCRIPTION
  11
  12 This document describes differences between the 5.17.1 release and
  13 the 5.17.2 release.
  14
  15 If you are upgrading from an earlier release such as 5.17.0, first read
  16 L<perl5171delta>, which describes differences between 5.17.0 and
  17 5.17.1.
  18
  19 =head1 Notice
  20
  21 XXX Any important notices here
  22
  23 =head1 Core Enhancements
  24
  25 XXX New core language features go here. Summarise user-visible core language
  26 enhancements. Particularly prominent performance optimisations could go
  27 here, but most should go in the L</Performance Enhancements> section.
  28
  29 [ List each enhancement as a =head2 entry ]
  30
  31 =head1 Security
  32
  33 XXX Any security-related notices go here.  In particular, any security
  34 vulnerabilities closed should be noted here rather than in the
  35 L</Selected Bug Fixes> section.
  36
  37 [ List each security issue as a =head2 entry ]
  38
  39 =head1 Incompatible Changes
  40
  41 XXX For a release on a stable branch, this section aspires to be:
  42
  43     There are no changes intentionally incompatible with 5.XXX.XXX
  44     If any exist, they are bugs, and we request that you submit a
  45     report.  See L</Reporting Bugs> below.
  46
  47 [ List each incompatible change as a =head2 entry ]
  48
  49 =head1 Deprecations
  50
  51 XXX Any deprecated features, syntax, modules etc. should be listed here.
  52 In particular, deprecated modules should be listed here even if they are
  53 listed as an updated module in the L</Modules and Pragmata> section.
  54
  55 [ List each deprecation as a =head2 entry ]
  56
  57 =head1 Performance Enhancements
  58
  59 XXX Changes which enhance performance without changing behaviour go here. There
  60 may well be none in a stable release.
  61
  62 [ List each enhancement as a =item entry ]
  63
  64 =over 4
  65
  66 =item *
  67
  68 XXX
  69
  70 =back
  71
  72 =head1 Modules and Pragmata
  73
  74 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
  75 go here.  If Module::CoreList is updated, generate an initial draft of the
  76 following sections using F<Porting/corelist-perldelta.pl>, which prints stub
  77 entries to STDOUT.  Results can be pasted in place of the '=head2' entries
  78 below.  A paragraph summary for important changes should then be added by hand.
  79 In an ideal world, dual-life modules would have a F<Changes> file that could be
  80 cribbed.
  81
  82 [ Within each section, list entries as a =item entry ]
  83
  84 =head2 New Modules and Pragmata
  85
  86 =over 4
  87
  88 =item *
  89
  90 XXX
  91
  92 =back
  93
  94 =head2 Updated Modules and Pragmata
  95
  96 =over 4
  97
  98 =item *
  99
 100 L<File::stat> has been upgraded from version 1.06 to 1.07.
 101
 102 Previously C<File::stat>'s overloaded C<-x> and C<-X> operators did not give
 103 the correct results for directories or executable files when running as
 104 root. They had been treating executable permissions for root just like for
 105 any other user, performing group membership tests I<etc> for files not owned
 106 by root. They now follow the correct Unix behaviour - for a directory they
 107 are always true, and for a file if any of the three execute permission bits
 108 are set then they report that root can execute the file. Perl's builtin
 109 C<-x> and C<-X> operators have always been correct.
 110
 111 =item *
 112
 113 L<Tie::StdHandle> has been upgraded from version 4.2 to 4.3.
 114
 115 C<READ> now respects the offset argument to C<read> [perl #112826].
 116
 117 =item *
 118
 119 L<IO> has been upgraded from version 1.25_07 to 1.25_08.
 120
 121 L<IO::Socket> tries harder to cache or otherwise fetch socket
 122 information.
 123
 124 =back
 125
 126 =head2 Removed Modules and Pragmata
 127
 128 =over 4
 129
 130 =item *
 131
 132 XXX
 133
 134 =back
 135
 136 =head1 Documentation
 137
 138 XXX Changes to files in F<pod/> go here.  Consider grouping entries by
 139 file and be sure to link to the appropriate page, e.g. L<perlfunc>.
 140
 141 =head2 New Documentation
 142
 143 XXX Changes which create B<new> files in F<pod/> go here.
 144
 145 =head3 L<XXX>
 146
 147 XXX Description of the purpose of the new file here
 148
 149 =head2 Changes to Existing Documentation
 150
 151 XXX Changes which significantly change existing files in F<pod/> go here.
 152 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
 153 section.
 154
 155 =head3 L<perlfunc>
 156
 157 =over 4
 158
 159 =item *
 160
 161 Clarified documentation of C<our>.
 162
 163 =back
 164
 165 =head1 Diagnostics
 166
 167 The following additions or changes have been made to diagnostic output,
 168 including warnings and fatal error messages.  For the complete list of
 169 diagnostic messages, see L<perldiag>.
 170
 171 XXX New or changed warnings emitted by the core's C<C> code go here. Also
 172 include any changes in L<perldiag> that reconcile it to the C<C> code.
 173
 174 [ Within each section, list entries as a =item entry that links to perldiag,
 175   e.g.
 176
 177   =item *
 178
 179   L<Invalid version object|perldiag/"Invalid version object">
 180 ]
 181
 182 =head2 New Diagnostics
 183
 184 XXX Newly added diagnostic messages go here
 185
 186 =head3 New Errors
 187
 188 =over 4
 189
 190 =item *
 191
 192 L<Group name must start with a non-digit word character in regex; marked by <-- HERE in mE<sol>%sE<sol>|perldiag/"Group name must start with a non-digit word character in regex; marked by <-- HERE in m/%s/">
 193
 194 This error has been added for C<(?&0)>, which is invalid.  It used to
 195 produce an incomprehensible error message [perl #101666].
 196
 197 =back
 198
 199 =head3 New Warnings
 200
 201 =over 4
 202
 203 =item *
 204
 205 C<chr()> now warns when passed a negative value [perl #83048].
 206
 207 =item *
 208
 209 C<srand()> now warns when passed a value that doesn't fit in a C<UV> (since the
 210 value will be truncated rather than overflowing) [perl #40605].
 211
 212 =item *
 213
 214 Running perl with the C<-i> flag now warns if no input files are provided on
 215 the command line [perl #113410].
 216
 217 =back
 218
 219 =head2 Changes to Existing Diagnostics
 220
 221 XXX Changes (i.e. rewording) of diagnostic messages go here
 222
 223 =over 4
 224
 225 =item *
 226
 227 XXX Describe change here
 228
 229 =back
 230
 231 =head1 Utility Changes
 232
 233 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
 234 here. Most of these are built within the directories F<utils> and F<x2p>.
 235
 236 [ List utility changes as a =head3 entry for each utility and =item
 237 entries for each change
 238 Use L<XXX> with program names to get proper documentation linking. ]
 239
 240 =head3 L<XXX>
 241
 242 =over 4
 243
 244 =item *
 245
 246 XXX
 247
 248 =back
 249
 250 =head1 Configuration and Compilation
 251
 252 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
 253 go here.  Any other changes to the Perl build process should be listed here.
 254 However, any platform-specific changes should be listed in the
 255 L</Platform Support> section, instead.
 256
 257 [ List changes as a =item entry ].
 258
 259 =over 4
 260
 261 =item *
 262
 263 Building perl with some Windows compilers used to fail due to a problem
 264 with miniperl's C<glob> operator (which uses the C<perlglob> program)
 265 deleting the PATH environment variable [perl #113798].
 266
 267 =back
 268
 269 =head1 Testing
 270
 271 XXX Any significant changes to the testing of a freshly built perl should be
 272 listed here.  Changes which create B<new> files in F<t/> go here as do any
 273 large changes to the testing harness (e.g. when parallel testing was added).
 274 Changes to existing files in F<t/> aren't worth summarising, although the bugs
 275 that they represent may be covered elsewhere.
 276
 277 [ List each test improvement as a =item entry ]
 278
 279 =over 4
 280
 281 =item *
 282
 283 XXX
 284
 285 =back
 286
 287 =head1 Platform Support
 288
 289 XXX Any changes to platform support should be listed in the sections below.
 290
 291 [ Within the sections, list each platform as a =item entry with specific
 292 changes as paragraphs below it. ]
 293
 294 =head2 New Platforms
 295
 296 XXX List any platforms that this version of perl compiles on, that previous
 297 versions did not. These will either be enabled by new files in the F<hints/>
 298 directories, or new subdirectories and F<README> files at the top level of the
 299 source tree.
 300
 301 =over 4
 302
 303 =item *
 304
 305 Configure now always adds -qlanglvl=extc99 to the CC flags on AIX when
 306 using xlC.  This will make it easier to compile a number of XS-based modules
 307 that assume C99 [perl #113778].
 308
 309 =back
 310
 311 =head2 Discontinued Platforms
 312
 313 XXX List any platforms that this version of perl no longer compiles on.
 314
 315 =over 4
 316
 317 =item XXX-some-platform
 318
 319 XXX
 320
 321 =back
 322
 323 =head2 Platform-Specific Notes
 324
 325 XXX List any changes for specific platforms. This could include configuration
 326 and compilation changes or changes in portability/compatibility.  However,
 327 changes within modules for platforms should generally be listed in the
 328 L</Modules and Pragmata> section.
 329
 330 =over 4
 331
 332 =item VMS
 333
 334 Quotes are now removed from the command verb (but not the parameters) for commands
 335 spawned via C<system>, backticks, or a piped C<open>.  Previously, quotes on the verb
 336 were passed through to DCL, which would fail to recognize the command.  Also, if the
 337 verb is actually a path to an image or command procedure on an ODS-5 volume, quoting it
 338 now allows the path to contain spaces.
 339
 340 =back
 341
 342 =head1 Internal Changes
 343
 344 XXX Changes which affect the interface available to C<XS> code go here.
 345 Other significant internal changes for future core maintainers should
 346 be noted as well.
 347
 348 [ List each change as a =item entry ]
 349
 350 =over 4
 351
 352 =item *
 353
 354 XXX
 355
 356 =back
 357
 358 =head1 Selected Bug Fixes
 359
 360 XXX Important bug fixes in the core language are summarised here.
 361 Bug fixes in files in F<ext/> and F<lib/> are best summarised in
 362 L</Modules and Pragmata>.
 363
 364 [ List each fix as a =item entry ]
 365
 366 =over 4
 367
 368 =item *
 369
 370 A regression introduced in v5.14.0 has been fixed, in which some calls
 371 to the C<re> module would clobber C<$_>.
 372
 373 =item *
 374
 375 C<do FILE> now always either sets or clears C<$@>, even when the file can't be
 376 read. This ensures that testing C<$@> first (as recommended by the
 377 documentation) always returns the correct result.
 378
 379 =item *
 380
 381 The array iterator used for the C<each @array> construct is now correctly
 382 reset when C<@array> is cleared (RT #75596). This happens for example when the
 383 array is globally assigned to, as in C<@array = (...)>, but not when its
 384 B<values> are assigned to. In terms of the XS API, it means that C<av_clear()>
 385 will now reset the iterator.
 386
 387 This mirrors the behaviour of the hash iterator when the hash is cleared.
 388
 389 =item *
 390
 391 C<< $class->can >>, C<< $class->isa >>, and C<< $class->DOES >> now return
 392 correct results, regardless of whether that package referred to by C<$class>
 393 exists [perl #47113].
 394
 395 =item *
 396
 397 Arriving signals no longer clear C<$@> [perl #45173].
 398
 399 =item *
 400
 401 Allow C<my ()> declarations with an empty variable list [perl #113554].
 402
 403 =item *
 404
 405 During parsing, subs declared after errors no longer leave stubs
 406 [perl #113712].
 407
 408 =item *
 409
 410 Closures containing no string evals no longer hang on to their containing
 411 subroutines, allowing variables closed over by outer subroutines to be
 412 freed when the outer sub is freed, even if the inner sub still exists
 413 [perl #89544].
 414
 415 =item *
 416
 417 Duplication of in-memory filehandles by opening with a "<&=" or ">&=" mode
 418 stopped working properly in 5.16.0.  It was causing the new handle to
 419 reference a different scalar variable.  This has been fixed [perl #113764].
 420
 421 =item *
 422
 423 C<qr//> expressions no longer crash with custom regular expression engines
 424 that do not set C<offs> at regular expression compilation time
 425 [perl #112962].
 426
 427 =item *
 428
 429 C<delete local> no longer crashes with certain magical arrays and hashes
 430 [perl #112966].
 431
 432 =item *
 433
 434 C<local> on elements of certain magical arrays and hashes used not to
 435 arrange to have the element deleted on scope exit, even if the element did
 436 not exist before C<local>.
 437
 438 =item *
 439
 440 C<scalar(write)> no longer returns multiple items [perl #73690].
 441
 442 =item *
 443
 444 String to floating point conversions no longer misparse certain strings under
 445 C<use locale> [perl #109318].
 446
 447 =item *
 448
 449 C<@INC> filters that die no longer leak memory [perl #92252].
 450
 451 =item *
 452
 453 The implementations of overloaded operations are now called in the correct
 454 context. This allows, among other things, being able to properly override
 455 C<< <> >> [perl #47119].
 456
 457 =item *
 458
 459 Specifying only the C<fallback> key when calling C<use overload> now behaves
 460 properly [perl #113010].
 461
 462 =item *
 463
 464 C<< sub foo { my $a = 0; while ($a) { ... } } >> and
 465 C<< sub foo { while (0) { ... } } >> now return the same thing [perl #73618].
 466
 467 =back
 468
 469 =head1 Known Problems
 470
 471 XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
 472 tests that had to be C<TODO>ed for the release would be noted here. Unfixed
 473 platform specific bugs also go here.
 474
 475 [ List each fix as a =item entry ]
 476
 477 =over 4
 478
 479 =item *
 480
 481 XXX
 482
 483 =back
 484
 485 =head1 Obituary
 486
 487 XXX If any significant core contributor has died, we've added a short obituary
 488 here.
 489
 490 =head1 Acknowledgements
 491
 492 XXX Generate this with:
 493
 494   perl Porting/acknowledgements.pl v5.17.1..HEAD
 495
 496 =head1 Reporting Bugs
 497
 498 If you find what you think is a bug, you might check the articles
 499 recently posted to the comp.lang.perl.misc newsgroup and the perl
 500 bug database at http://rt.perl.org/perlbug/ .  There may also be
 501 information at http://www.perl.org/ , the Perl Home Page.
 502
 503 If you believe you have an unreported bug, please run the L<perlbug>
 504 program included with your release.  Be sure to trim your bug down
 505 to a tiny but sufficient test case.  Your bug report, along with the
 506 output of C<perl -V>, will be sent off to perlbug@perl.org to be
 507 analysed by the Perl porting team.
 508
 509 If the bug you are reporting has security implications, which make it
 510 inappropriate to send to a publicly archived mailing list, then please send
 511 it to perl5-security-report@perl.org. This points to a closed subscription
 512 unarchived mailing list, which includes
 513 all the core committers, who will be able
 514 to help assess the impact of issues, figure out a resolution, and help
 515 co-ordinate the release of patches to mitigate or fix the problem across all
 516 platforms on which Perl is supported. Please only use this address for
 517 security issues in the Perl core, not for modules independently
 518 distributed on CPAN.
 519
 520 =head1 SEE ALSO
 521
 522 The F<Changes> file for an explanation of how to view exhaustive details
 523 on what changed.
 524
 525 The F<INSTALL> file for how to build Perl.
 526
 527 The F<README> file for general stuff.
 528
 529 The F<Artistic> and F<Copying> files for copyright information.
 530
 531 =cut