pod/perldelta.pod

   1 =encoding utf8
   2
   3 =for comment
   4 This has been completed up to 3ea0c5818 except for:
   5 a1da11a30dfa4f3543dcab00834ff535202f5085 (GNU/Hurd hints)
   6
   7 =head1 NAME
   8
   9 [ this is a template for a new perldelta file. Any text flagged as
  10 XXX needs to be processed before release. ]
  11
  12 perldelta - what is new for perl v5.15.5
  13
  14 =head1 DESCRIPTION
  15
  16 This document describes differences between the 5.15.4 release and
  17 the 5.15.5 release.
  18
  19 If you are upgrading from an earlier release such as 5.15.3, first read
  20 L<perl5154delta>, which describes differences between 5.15.3 and
  21 5.15.4.
  22
  23 =head1 Notice
  24
  25 XXX Any important notices here
  26
  27 =head1 Core Enhancements
  28
  29 XXX New core language features go here. Summarise user-visible core language
  30 enhancements. Particularly prominent performance optimisations could go
  31 here, but most should go in the L</Performance Enhancements> section.
  32
  33 =head2 C<$[> is back
  34
  35 The C<$[> variable is back again, but is now implemented as a module, so
  36 programs that do not mention it (i.e., most of them), will not incur any
  37 run-time penalty.  It is disabled in the scope of C<use v5.16>.
  38
  39 XXX That last sentence is not true yet.
  40
  41 The new implementation has some bug fixes.  See L<arybase>.
  42
  43 =head2 new dot feature
  44
  45 C<use feature 'dot'> tells the compiler to accept . everywhere it would
  46 normally accept -> and to accept ~ as concatenation.
  47
  48 =head1 Security
  49
  50 XXX Any security-related notices go here.  In particular, any security
  51 vulnerabilities closed should be noted here rather than in the
  52 L</Selected Bug Fixes> section.
  53
  54 [ List each security issue as a =head2 entry ]
  55
  56 =head1 Incompatible Changes
  57
  58 XXX For a release on a stable branch, this section aspires to be:
  59
  60     There are no changes intentionally incompatible with 5.XXX.XXX
  61     If any exist, they are bugs and reports are welcome.
  62
  63 [ List each incompatible change as a =head2 entry ]
  64
  65 =head1 Deprecations
  66
  67 XXX Any deprecated features, syntax, modules etc. should be listed here.
  68 In particular, deprecated modules should be listed here even if they are
  69 listed as an updated module in the L</Modules and Pragmata> section.
  70
  71 [ List each deprecation as a =head2 entry ]
  72
  73 =head1 Performance Enhancements
  74
  75 XXX Changes which enhance performance without changing behaviour go here. There
  76 may well be none in a stable release.
  77
  78 [ List each enhancement as a =item entry ]
  79
  80 =over 4
  81
  82 =item *
  83
  84 Due to changes in L<File::Glob>, Perl's C<glob> function and its
  85 C<< <...> >> equivalent are now much faster.  The splitting of the pattern
  86 into words has been rewritten in C, resulting in speed-ups of 20% in some
  87 cases.
  88
  89 This does not affect VMS, as it does not use File::Glob.
  90
  91 =back
  92
  93 =head1 Modules and Pragmata
  94
  95 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
  96 go here.  If Module::CoreList is updated, generate an initial draft of the
  97 following sections using F<Porting/corelist-perldelta.pl>, which prints stub
  98 entries to STDOUT.  Results can be pasted in place of the '=head2' entries
  99 below.  A paragraph summary for important changes should then be added by hand.
 100 In an ideal world, dual-life modules would have a F<Changes> file that could be
 101 cribbed.
 102
 103 [ Within each section, list entries as a =item entry ]
 104
 105 =head2 New Modules and Pragmata
 106
 107 =over 4
 108
 109 =item *
 110
 111 L<arybase> -- this new module implements the C<$[> variable.
 112
 113 =back
 114
 115 =head2 Updated Modules and Pragmata
 116
 117 =over 4
 118
 119 =item *
 120
 121 L<Archive::Extract> has been upgraded from version 0.56 to version 0.58.
 122
 123 =item *
 124
 125 L<B::Deparse> has been upgraded from version 1.08 to 1.08.
 126
 127 It now correctly deparses C<CORE::do> and C<CORE::glob>.
 128
 129 =item *
 130
 131 L<CPANPLUS::Dist::Build> has been upgraded from version 0.58 to version 0.60.
 132
 133 =item *
 134
 135 L<ExtUtils::MakeMaker> has been upgraded from version 6.61_01 to version 6.63_01.
 136
 137 =item *
 138
 139 L<File::Glob> has been upgrade from version 1.13 to 1.14.
 140
 141 It has a new C<:bsd_glob> export tag, intended to replace C<:glob>.  Like
 142 C<:glob> it overrides C<glob> with a function that does not split the glob
 143 pattern into words, but, unlike C<:glob>, it iterates properly in scalar
 144 context, instead of returning the last file.
 145
 146 There are other changes affecting Perl's own C<glob> operator (which uses
 147 File::Glob internally, except on VMS).  See L</Performance Enhancements>
 148 and L</Selected Bug Fixes>.
 149
 150 =item *
 151
 152 L<HTTP::Tiny> has been upgraded from version 0.013 to version 0.016.
 153
 154 Adds additional shorthand methods for all common HTTP verbs,
 155 a C<post_form()> method for POST-ing x-www-form-urlencoded data and
 156 a C<www_form_urlencode()> utility method.
 157
 158 =item *
 159
 160 L<perlfaq> has been upgraded from version 5.0150035 to version 5.0150036.
 161
 162 =item *
 163
 164 L<Socket> as been upgraded from version 1.94_01 to 1.94_02.
 165
 166 It has new functions and constants for handling IPv6 sockets:
 167
 168     pack_ipv6_mreq
 169     unpack_ipv6_mreq
 170     IPV6_ADD_MEMBERSHIP
 171     IPV6_DROP_MEMBERSHIP
 172     IPV6_MTU
 173     IPV6_MTU_DISCOVER
 174     IPV6_MULTICAST_HOPS
 175     IPV6_MULTICAST_IF
 176     IPV6_MULTICAST_LOOP
 177     IPV6_UNICAST_HOPS
 178     IPV6_V6ONLY
 179
 180 =item *
 181
 182 L<Unicode::Collate> has been upgraded from version 0.80 to version 0.81.
 183
 184 Locales updated to CLDR 2.0: mk, mt, nb, nn, ro, ru.
 185 Newly supported locales: ml, mr, or, pa.
 186
 187 =back
 188
 189 =head2 Removed Modules and Pragmata
 190
 191 =over 4
 192
 193 =item *
 194
 195 XXX
 196
 197 =back
 198
 199 =head1 Documentation
 200
 201 XXX Changes to files in F<pod/> go here.  Consider grouping entries by
 202 file and be sure to link to the appropriate page, e.g. L<perlfunc>.
 203
 204 =head2 New Documentation
 205
 206 XXX Changes which create B<new> files in F<pod/> go here.
 207
 208 =head3 L<XXX>
 209
 210 XXX Description of the purpose of the new file here
 211
 212 =head2 Changes to Existing Documentation
 213
 214 XXX Changes which significantly change existing files in F<pod/> go here.
 215 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
 216 section.
 217
 218 =head3 L<XXX>
 219
 220 =over 4
 221
 222 =item *
 223
 224 XXX Description of the change here
 225
 226 =back
 227
 228 =head1 Diagnostics
 229
 230 The following additions or changes have been made to diagnostic output,
 231 including warnings and fatal error messages.  For the complete list of
 232 diagnostic messages, see L<perldiag>.
 233
 234 XXX New or changed warnings emitted by the core's C<C> code go here. Also
 235 include any changes in L<perldiag> that reconcile it to the C<C> code.
 236
 237 [ Within each section, list entries as a =item entry that links to perldiag,
 238   e.g.
 239
 240   =item *
 241
 242   L<Invalid version object|perldiag/"Invalid version object">
 243 ]
 244
 245 =head2 New Diagnostics
 246
 247 XXX Newly added diagnostic messages go here
 248
 249 =head3 New Errors
 250
 251 =over 4
 252
 253 =item *
 254
 255 XXX L<message|perldiag/"message">
 256
 257 =back
 258
 259 =head3 New Warnings
 260
 261 =over 4
 262
 263 =item *
 264
 265 XXX L<message|perldiag/"message">
 266
 267 =back
 268
 269 =head2 Changes to Existing Diagnostics
 270
 271 XXX Changes (i.e. rewording) of diagnostic messages go here
 272
 273 =over 4
 274
 275 =item *
 276
 277 XXX Describe change here
 278
 279 =back
 280
 281 =head1 Utility Changes
 282
 283 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
 284 here. Most of these are built within the directories F<utils> and F<x2p>.
 285
 286 [ List utility changes as a =head3 entry for each utility and =item
 287 entries for each change
 288 Use L<XXX> with program names to get proper documentation linking. ]
 289
 290 =head3 L<XXX>
 291
 292 =over 4
 293
 294 =item *
 295
 296 XXX
 297
 298 =back
 299
 300 =head1 Configuration and Compilation
 301
 302 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
 303 go here.  Any other changes to the Perl build process should be listed here.
 304 However, any platform-specific changes should be listed in the
 305 L</Platform Support> section, instead.
 306
 307 [ List changes as a =item entry ].
 308
 309 =over 4
 310
 311 =item *
 312
 313 XXX
 314
 315 =back
 316
 317 =head1 Testing
 318
 319 XXX Any significant changes to the testing of a freshly built perl should be
 320 listed here.  Changes which create B<new> files in F<t/> go here as do any
 321 large changes to the testing harness (e.g. when parallel testing was added).
 322 Changes to existing files in F<t/> aren't worth summarising, although the bugs
 323 that they represent may be covered elsewhere.
 324
 325 [ List each test improvement as a =item entry ]
 326
 327 =over 4
 328
 329 =item *
 330
 331 XXX
 332
 333 =back
 334
 335 =head1 Platform Support
 336
 337 XXX Any changes to platform support should be listed in the sections below.
 338
 339 [ Within the sections, list each platform as a =item entry with specific
 340 changes as paragraphs below it. ]
 341
 342 =head2 New Platforms
 343
 344 XXX List any platforms that this version of perl compiles on, that previous
 345 versions did not. These will either be enabled by new files in the F<hints/>
 346 directories, or new subdirectories and F<README> files at the top level of the
 347 source tree.
 348
 349 =over 4
 350
 351 =item XXX-some-platform
 352
 353 XXX
 354
 355 =back
 356
 357 =head2 Discontinued Platforms
 358
 359 XXX List any platforms that this version of perl no longer compiles on.
 360
 361 =over 4
 362
 363 =item XXX-some-platform
 364
 365 XXX
 366
 367 =back
 368
 369 =head2 Platform-Specific Notes
 370
 371 XXX List any changes for specific platforms. This could include configuration
 372 and compilation changes or changes in portability/compatibility.  However,
 373 changes within modules for platforms should generally be listed in the
 374 L</Modules and Pragmata> section.
 375
 376 =over 4
 377
 378 =item XXX-some-platform
 379
 380 XXX
 381
 382 =back
 383
 384 =head1 Internal Changes
 385
 386 XXX Changes which affect the interface available to C<XS> code go here.
 387 Other significant internal changes for future core maintainers should
 388 be noted as well.
 389
 390 [ List each change as a =item entry ]
 391
 392 =over 4
 393
 394 =item *
 395
 396 C<PL_curstash> is now reference-counted.
 397
 398 =back
 399
 400 =head1 Selected Bug Fixes
 401
 402 XXX Important bug fixes in the core language are summarised here.
 403 Bug fixes in files in F<ext/> and F<lib/> are best summarised in
 404 L</Modules and Pragmata>.
 405
 406 [ List each fix as a =item entry ]
 407
 408 =over 4
 409
 410 =item *
 411
 412 Perl now holds an extra reference count on the package that code is
 413 currently compiling in.  This means that the following code no longer crashes [perl #101486]:
 414
 415     package Foo;
 416     BEGIN {*Foo:: = *Bar::}
 417     sub foo;
 418
 419 =item *
 420
 421 F<dumpvar.pl>, and consequently the C<x> command in the debugger, have been
 422 fixed to handle objects blessed into classes whose names contain "=".  The
 423 contents of such objects used not to be dumped [perl #101814].
 424
 425 =item *
 426
 427 The C<x> repetition operator no longer crashes on 64-bit builds with large
 428 repeate counts [perl #94560].
 429
 430 =item *
 431
 432 A fix to C<glob> under miniperl (used to configure modules when perl itself
 433 is built) in Perl 5.15.3 stopped C<< <~> >> from returning the home
 434 directory, because it cleared %ENV before calling csh.  Now C<$ENV{HOME}>
 435 is preserved.  This fix probably does not affect anything.  If
 436 L<File::Glob> fails to load for some reason, Perl reverts to using csh.
 437 So it would apply in that case.
 438
 439 =item *
 440
 441 On OSes other than VMS, Perl's C<glob> operator (and the C<< <...> >> form)
 442 use L<File::Glob> underneath.  L<File::Glob> splits the pattern into words,
 443 before feeding each word to its C<bsd_glob> function.
 444
 445 There were several inconsistencies in the way the split was done.  Now
 446 quotation marks (' and ") are always treated as shell-style word delimiters
 447 (that allow whitespace as part of a word) and backslashes are always
 448 preserved, unless they exist to escape quotation marks.  Before, those
 449 would only sometimes be the case, depending on whether the pattern
 450 contained whitespace.  Also, escaped whitespace at the end of the pattern
 451 is no longer stripped.
 452
 453 =item *
 454
 455 C<CORE::glob> now works as a way to call the default globbing function.  It
 456 used to respect overrides, despite the C<CORE::> prefix.
 457
 458 =item *
 459
 460 In 5.14, C</[[:lower:]]/i> and C</[[:upper:]]/i> no longer matched the
 461 opposite case.  This has been fixed [perl #101970].
 462
 463 =item *
 464
 465 A regular expression match with an overloaded object on the right-hand side
 466 would in some cases stringify the object too many times.
 467
 468 =item *
 469
 470 The C-level C<pregcomp> function could become confused as to whether the
 471 pattern was in UTF8 if the pattern was an overloaded, tied, or otherwise
 472 magical scalar [perl #101940].
 473
 474 =back
 475
 476 =head1 Known Problems
 477
 478 XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
 479 tests that had to be C<TODO>ed for the release would be noted here, unless
 480 they were specific to a particular platform (see below).
 481
 482 This is a list of some significant unfixed bugs, which are regressions
 483 from either 5.XXX.XXX or 5.XXX.XXX.
 484
 485 [ List each fix as a =item entry ]
 486
 487 =over 4
 488
 489 =item *
 490
 491 XXX
 492
 493 =back
 494
 495 =head1 Obituary
 496
 497 XXX If any significant core contributor has died, we've added a short obituary
 498 here.
 499
 500 =head1 Acknowledgements
 501
 502 XXX Generate this with:
 503
 504   perl Porting/acknowledgements.pl v5.15.4..HEAD
 505
 506 =head1 Reporting Bugs
 507
 508 If you find what you think is a bug, you might check the articles
 509 recently posted to the comp.lang.perl.misc newsgroup and the perl
 510 bug database at http://rt.perl.org/perlbug/ .  There may also be
 511 information at http://www.perl.org/ , the Perl Home Page.
 512
 513 If you believe you have an unreported bug, please run the L<perlbug>
 514 program included with your release.  Be sure to trim your bug down
 515 to a tiny but sufficient test case.  Your bug report, along with the
 516 output of C<perl -V>, will be sent off to perlbug@perl.org to be
 517 analysed by the Perl porting team.
 518
 519 If the bug you are reporting has security implications, which make it
 520 inappropriate to send to a publicly archived mailing list, then please send
 521 it to perl5-security-report@perl.org. This points to a closed subscription
 522 unarchived mailing list, which includes
 523 all the core committers, who will be able
 524 to help assess the impact of issues, figure out a resolution, and help
 525 co-ordinate the release of patches to mitigate or fix the problem across all
 526 platforms on which Perl is supported. Please only use this address for
 527 security issues in the Perl core, not for modules independently
 528 distributed on CPAN.
 529
 530 =head1 SEE ALSO
 531
 532 The F<Changes> file for an explanation of how to view exhaustive details
 533 on what changed.
 534
 535 The F<INSTALL> file for how to build Perl.
 536
 537 The F<README> file for general stuff.
 538
 539 The F<Artistic> and F<Copying> files for copyright information.
 540
 541 =cut