pod/perl5133delta.pod

   1 =encoding utf8
   2
   3 =head1 NAME
   4
   5 perldelta - what is new for perl v5.13.3
   6
   7 XXX Add links around modules throughout
   8
   9 =head1 DESCRIPTION
  10
  11 This document describes differences between the 5.13.3 release and
  12 the 5.13.2 release.
  13
  14 If you are upgrading from an earlier release such as 5.13.1, first read
  15 L<perl5132delta>, which describes differences between 5.13.1 and
  16 5.13.2.
  17
  18 =head1 Core Enhancements
  19
  20 =head2 \o{...}
  21
  22 The escape sequence C<"\o"> in double-quotish contexts is now defined.  It
  23 must be followed by braces enclosing an octal number of at least one digit.  It
  24 means the character whose ordinal value is that octal number.  This construct
  25 allows large octal ordinals beyond the current max of 0777 to be represented.
  26 It also allows you to specify a character in octal which can safely be
  27 concatenated with other regex snippets without danger of changing its meaning,
  28 and one which won't ever be confused with being a backreference to a regex
  29 capture group.  See L<perlre/Capture groups>
  30
  31 =head2 C<\N{I<name>}> and C<charnames> enhancements
  32
  33 C<\N{}> and C<charnames::vianame> now know about the abbreviated character
  34 names listed by Unicode, such as NBSP, SHY, LRO, ZWJ, etc., as well as all the
  35 customary abbreviations for the C0 and C1 control characters (such as ACK, BEL,
  36 CAN, etc.), as well as a few new variants in common usage of some C1 full
  37 names.
  38
  39 In the past, it was ineffective to override one of Perl's abbreviations with
  40 your own custom alias.  Now it works.
  41
  42 And you can create a custom alias directly to the ordinal of a character, known
  43 by C<\N{...}>, C<charnames::vianame()>, and C<charnames::viacode()>.
  44 Previously, an alias had to be to an official Unicode character name.  This
  45 made it impossible to create an alias for a code point that had no name,
  46 such as the ones reserved for private use.  So this change allows you to make
  47 more effective use of private use characters.  Only if there is no official
  48 name will C<charnames::viacode()> return your custom one.
  49
  50 See L<charnames> for details on all these changes.
  51
  52 =head2 Uppercase X/B allowed in hexadecimal/binary literals
  53
  54 Literals may now use either upper case C<0X...> or C<0B...> prefixes,
  55 in addition to the already supported C<0x...> and C<0b...>
  56 syntax. (RT#76296) (a674e8d)
  57
  58 C, Ruby, Python and PHP already supported this syntax, and it makes
  59 Perl more internally consistent. A round-trip with C<eval sprintf
  60 "%#X", 0x10> now returns C<16> in addition to C<eval sprintf "%#x",
  61 0x10>, which worked before.
  62
  63 =head1 Incompatible Changes
  64
  65 =head2 \400 - \777
  66
  67 Use of C<\400> - C<\777> in regexes in certain circumstances has given different,
  68 anomalous behavior than their use in all other double-quotish contexts.   Since
  69 5.10.1, a deprecated warning message has been raised when this happens.  Now,
  70 all double-quotish contexts have the same behavior, namely to be equivalent to
  71 C<\x{100}> - C<\x{1FF}>, with no deprecation warning. Use of these values in the
  72 command line option C<"-0"> retains the current meaning to slurp input files
  73 whole; previously, this was documented only for C<"-0777">.  It is recommended,
  74 however, because of various ambiguities, to use the new L</\o{...}> construct
  75 to represent characters in octal.
  76
  77 =head1 Deprecations
  78
  79 =head2 Omitting a space between regular expression and subsequent word
  80
  81 Omitting a space between a regex pattern or pattern modifiers and the
  82 following word is deprecated. Deprecation for regular expression matches
  83 was added in Perl 5.13.2.  In this release, the deprecation is extended
  84 to regular expression substitutions. For example,
  85 C<< s/foo/bar/sand $bar >> will still be parsed as
  86 C<< s/foo/bar/s and $bar >> but will issue a warning.
  87
  88 =head2 Deprecation warning added for deprecated-in-core .pl libs
  89
  90 This is a mandatory warning, not obeying -X or lexical warning bits.
  91 The warning is modelled on that supplied by deprecate.pm for
  92 deprecated-in-core .pm libraries.  It points to the specific CPAN
  93 distribution that contains the .pl libraries. The CPAN version, of
  94 course, does not generate the warning. (0111154)
  95
  96 =head1 Performance Enhancements
  97
  98 =over 4
  99
 100 =item *
 101
 102 There are several small optimizations to improve CPU cache performance
 103
 104 =back
 105
 106 =head1 Modules and Pragmata
 107
 108 =head2 Updated Modules and Pragmata
 109
 110 XXX Make sure these get sorted, are phrased similarly and all version
 111 numbers are correct
 112
 113 =over 4
 114
 115 =item *
 116
 117 autodie updated to CPAN version 2.10 (a009834)
 118
 119 =item *
 120
 121 charnames -- viacode() is now significantly faster (f3227b7)
 122
 123 =item *
 124
 125 version now prevents object methods from being called as class methods
 126 (d808b68)
 127
 128 =item *
 129
 130 warnings updated to 1.10.  Calling C<use warnings> without
 131 arguments is now significantly more efficient. (8452af9)
 132
 133 =item *
 134
 135 Archive-Extract updated to CPAN version 0.42 (d7f8799)
 136
 137 Updates since 0.38 include: a safe print method that Michael Schwern
 138 contributed, that guards Archive::Extract from changes to $\; a
 139 fix to the tests when run in core perl from Robin Barker; and
 140 support for TZ files contributed by Paul Marquess, who also supplied a
 141 modification for the lzma logic to favour IO::Uncompress::Unlzma
 142
 143 =item *
 144
 145 Archive-Tar updated to version 1.64 (afabe0e)
 146
 147 Important changes since 1.54 include: compatibility with busybox
 148 implementations of tar which was added by Mark Swayne; a fix so
 149 that write() and create_archive() close only handles
 150 they opened by Darrell K.; and a bug was fixed regarding the exit code
 151 of extract_archive which was spotted by and upstreamed from RedHat by
 152 Martin Cermak.
 153
 154 =item *
 155
 156 Attribute-Handlers updated to CPAN version 0.88 (f2ea78b)
 157
 158 =item *
 159
 160 Compress-Raw-Bzip2 updated to CPAN version 2.027 (9e09409)
 161
 162 =item *
 163
 164 Compress-Raw-Zlib updated  to CPAN version 2.027 (f02c02e)
 165
 166 =item *
 167
 168 CPANPLUS updated to version 0.9007 (d4e225a)
 169
 170 Fix the shell test to skip if test is not being run under a
 171 terminal; resolved the issue where a prereq on Config would not be
 172 recognised as a core module
 173
 174 =item *
 175
 176 Digest-MD5 updated to CPAN version 2.40 (326fafa)
 177
 178 =item *
 179
 180 Digest-SHA updated to CPAN version 5.48 (dfe1edc)
 181
 182 =item *
 183
 184 Exporter no longer overrides C<$SIG{__WARN__}> (RT #74472) (9b86bb5)
 185
 186 =item *
 187
 188 ExtUtils-CBuilder updated to CPAN version 0.2703 (7b0eef9)
 189
 190 =item *
 191
 192 ExtUtils-Manifest updated to CPAN version 1.58 (49c6bc4)
 193
 194 =item *
 195
 196 ExtUtil-ParseXS updated to version 2.2206 (494e8c4)
 197
 198 =item *
 199
 200 File::Copy skips suid tests on a nosuid partition (cae9400)
 201
 202 These tests were being skipped on OpenBSD, but nosuid partitions can
 203 exist on other systems too. Now it just checks if it can create a suid
 204 directory, if not the tests are skipped.
 205
 206 Perl builds without errors in a nosuid /tmp with this patch.
 207
 208 =item *
 209
 210 IO-Compress upated to CPAN version 2.027 (e8796d6)
 211
 212 =item *
 213
 214 IPC-Cmd updated to CPAN version 0.60 (e667e1e)
 215
 216 =item *
 217
 218 IPC-SysV updated to CPAN version 2.03 (10613b6)
 219
 220 =item *
 221
 222 Locale::Maketext guts have been merged back into the main module (87d86da)
 223 and adds external cache support (ace47d6)
 224
 225 =item *
 226
 227 Module-Build updated to CPAN version 0.3607 (40c9afb)
 228
 229 =item *
 230
 231 Module-Load updated to CPAN version 0.18 (93eaa32)
 232
 233 =item *
 234
 235 Term-ANSIColor to CPAN version 3.00 (2c33c76)
 236
 237 =item *
 238
 239 Test-Harness to CPAN version 3.21 (6d31366)
 240
 241 =item *
 242
 243 Time-HiRes updated to CPAN version 1.9721 (68c5b4d)
 244
 245 =item *
 246
 247 Time-Piece updated to CPAN version 1.20 (90d55c2)
 248
 249 =item *
 250
 251 Unicode-Collate updated to CPAN version 0.53.  Includes Unicode Collation
 252 Algorithm 18 (74b94a7)
 253
 254 =item *
 255
 256 Unicode-Normalize updated to CPAN release 1.06 (a96160d)
 257
 258 =back
 259
 260 =head1 Documentation
 261
 262 =head2 New Documentation
 263
 264 =head3 L<perl5121delta>
 265
 266 The Perl 5.12.1 perldelta file was added from the Perl maintenance branch
 267
 268 =head2 Changes to Existing Documentation
 269
 270 =head3 General changes
 271
 272 =over
 273
 274 =item *
 275
 276 Octal character escapes in documentation now prefer a three-digit octal
 277 escape or the new C<\o{}> escape as they have more consistent behavior
 278 in different contexts than other forms. (ce7b6f0) (d8b950d) (e1f120a)
 279
 280 =item *
 281
 282 Documentation now standardizes on the term 'capture group' over 'buffer'
 283 in regular expression documentation (c27a5cf)
 284
 285 =back
 286
 287 =head3 L<perlfunc>
 288
 289 =over
 290
 291 =item *
 292
 293 Added cautionary note about "no VERSION" (e0de7c2)
 294
 295 =item *
 296
 297 Add additional notes regarding srand and forking (d460397)
 298
 299 =back
 300
 301 =head3 L<perlop>
 302
 303 =over 4
 304
 305 =item *
 306
 307 Improved documentation of unusual character escapes (bf82ca4)
 308
 309 =item *
 310
 311 Clarifies how hexadecimal escapes are interpreted, with particular
 312 attention to the treatment of invalid characters. (9644846)
 313
 314 =back
 315
 316 =head3 L<perlrun>
 317
 318 =over
 319
 320 =item *
 321
 322 Clarifies the behavior of the C<-0NNN> switch for C<-0400> or higher (7ba31cb)
 323
 324 =back
 325
 326 =head3 L<perlpolicy>
 327
 328 =over
 329
 330 =item *
 331
 332 Added the policy on compatibility and deprecation along with definitions of
 333 terms like "deprecation" (70e4a83)
 334
 335 =back
 336
 337 =head3 L<perlre>
 338
 339 =over
 340
 341 =item *
 342
 343 Added examples on the perils of not using \g{} when there are more
 344 than nine back-references (9d86067)
 345
 346 =back
 347
 348 =head3 L<perltie>
 349
 350 =over
 351
 352 =item *
 353
 354 Some examples updated for modern Perl style (67d00dd)
 355
 356 =back
 357
 358 =head1 Utility Changes
 359
 360 =head3 L<perldb>
 361
 362 =over
 363
 364 =item *
 365
 366 The remote terminal works after forking and spawns new sessions - one
 367 for each forked process.
 368
 369 =item *
 370
 371 Uses the less pager path from Config instead of searching for it (bf320d6)
 372
 373 =back
 374
 375 =head1 Configuration and Compilation
 376
 377 =over 4
 378
 379 =item *
 380
 381 Adjusts 'make test.valgrind' to account for cpan/dist/ext separation. (e07ce2e)
 382
 383 =back
 384
 385 =head1 Testing
 386
 387 =over 4
 388
 389 =item *
 390
 391 F<t/harness> clears PERL5LIB, PERLLIB, PERL5OPT as t/TEST does (a2d3de1)
 392
 393 =item *
 394
 395 Many common testing routines were refactored into t/lib/common.pl
 396
 397 =item *
 398
 399 Several test files have been modernized to use Test::More
 400
 401 =back
 402
 403 =head1 Platform Support
 404
 405 =head2 Discontinued Platforms
 406
 407 =over 4
 408
 409 =item MacOS Classic
 410
 411 Support for MacOS Classic within ExtUtils::MakeMaker was removed from Perl in
 412 December 2004.  Vestigial MacOS Classic specific code has now been removed
 413 from other core modules as well (8f8c2a4..c457df0).
 414
 415 =back
 416
 417 =head2 Platform-Specific Notes
 418
 419 =over 4
 420
 421 =item Win32
 422
 423 t/io/openpid.t now uses the alarm() watchdog strategy for more
 424 robustness. (5732108)
 425
 426 =back
 427
 428 =head1 Internal Changes
 429
 430 =over 4
 431
 432 =item *
 433
 434 Under some circumstances, the C<CvGV()> field of a CV is now reference
 435 counted. To ensure consistent behaviour, direct assignment to it, for
 436 example C<CvGV(cv) = gv> is now a compile-time error. A new macro,
 437 C<CvGV_set(cv,gv)> has been introduced to perform this operation safely.
 438 Note that modification of this field is not part of of the public API,
 439 regardless of this new macro. This change caused some
 440 L<issues|/"Known Problems"> in modules that used the private C<GvGV()>
 441 field.
 442
 443 =item *
 444
 445 It is now possible for XS code to hook into Perl's lexical scope
 446 mechanism at compile time, using the new C<Perl_blockhook_register>
 447 function. See L<perlguts/"Compile-time scope hooks">.
 448
 449 =item *
 450
 451 Added C<Perl_croak_no_modify()> to implement
 452 C<Perl_croak("%s", PL_no_modify)>. (6ad8f25)
 453
 454 =item *
 455
 456 Added prototypes for C<tie()> and C<untie()> to allow overloading. (RT#75902)
 457 (1db4d19)
 458
 459 =item *
 460
 461 Adds C<my_[l]stat_flags()> to replace C<my_[l]stat()>.  C<my_stat()> and
 462 C<my_lstat()> call get magic on the stack arg, so create C<_flags()>
 463 variants that allow us to control this. (0d7d409)
 464
 465 =back
 466
 467 =head1 Selected Bug Fixes
 468
 469 =over 4
 470
 471 =item *
 472
 473 Some work has been done on the internal pointers that link between symbol
 474 tables (stashes), typeglobs and subroutines. This has the effect that
 475 various edge cases related to deleting stashes or stash entries (e.g.
 476 <%FOO:: = ()>), and complex typeglob or code reference aliasing, will no
 477 longer crash the interpreter.
 478
 479 =item *
 480
 481 Fixed readline() when interrupted by signals so it no longer returns
 482 the "same thing" as before or random memory.
 483
 484 =item *
 485
 486 Fixed a regression of kill() when a match variable is used for the
 487 process ID to kill.  (RT#75812) (8af710e)
 488
 489 =item *
 490
 491 Fixed several subtle bugs in sort() when @_ is accessed within a subroutine
 492 used for sorting. (RT#72334) (8f443ca)
 493
 494 =item *
 495
 496 Catch yyparse() exceptions in C<< (?{...}) >> (RT#2353) (634d691)
 497
 498 =item *
 499
 500 Avoid UTF-8 cache panics with offsets beyond a string (RT #75898) (3e2d381)
 501
 502 =item *
 503
 504 Fixed POSIX::strftime memory leak (RT#73520) (c4bc4aa)
 505
 506 =item *
 507
 508 Doesn't set strict with C<no VERSION> if C<VERSION> is greater than 5.12.
 509 (da8fb5d)
 510
 511 =item *
 512
 513 Avoids multiple FETCH/stringify on filetest ops (40c852d)
 514
 515 =item *
 516
 517 Fixed issue with string C<eval> not detecting taint of overloaded/tied
 518 arguments (RT #75716) (895b760)
 519
 520 =item *
 521
 522 Fix potential crashes of string C<eval> when evaluating a object with
 523 overloaded stringification by creating a stringified copy when necessary
 524 (3e5c018)
 525
 526 =item *
 527
 528 Fixed bug where overloaded stringification could remove tainting
 529 (RT #75716) (a02ec77)
 530
 531 =item *
 532
 533 Plugs more memory leaks in vms.c. (9e2bec0)
 534
 535 =item *
 536
 537 Fix pthread include error for Time::Piece (e9f284c)
 538
 539 =back
 540
 541 =head1 Known Problems
 542
 543 =over 4
 544
 545 =item *
 546
 547 Bug fixes involving CvGV reference counting break L<Sub::Name>.  A
 548 patch has been sent upstream to the maintainer.
 549
 550 =item *
 551
 552 readline() returns an empty string instead of undef when it is
 553 interrupted by a signal.
 554
 555 =back
 556
 557 =head1 Errata
 558
 559 =over 4
 560
 561 =item *
 562
 563 Retroactively added the Acknowledgements list to L<perl5132delta>,
 564 which was excluded in the original release (d1e2db0)
 565
 566 =back
 567
 568 =head1 Acknowledgements
 569
 570 XXX The list of people to thank goes here.
 571
 572 =head1 Reporting Bugs
 573
 574 If you find what you think is a bug, you might check the articles
 575 recently posted to the comp.lang.perl.misc newsgroup and the perl
 576 bug database at http://rt.perl.org/perlbug/ .  There may also be
 577 information at http://www.perl.org/ , the Perl Home Page.
 578
 579 If you believe you have an unreported bug, please run the B<perlbug>
 580 program included with your release.  Be sure to trim your bug down
 581 to a tiny but sufficient test case.  Your bug report, along with the
 582 output of C<perl -V>, will be sent off to perlbug@perl.org to be
 583 analysed by the Perl porting team.
 584
 585 If the bug you are reporting has security implications, which make it
 586 inappropriate to send to a publicly archived mailing list, then please send
 587 it to perl5-security-report@perl.org. This points to a closed subscription
 588 unarchived mailing list, which includes all the core committers, who be able
 589 to help assess the impact of issues, figure out a resolution, and help
 590 co-ordinate the release of patches to mitigate or fix the problem across all
 591 platforms on which Perl is supported. Please only use this address for
 592 security issues in the Perl core, not for modules independently
 593 distributed on CPAN.
 594
 595 =head1 SEE ALSO
 596
 597 The F<Changes> file for an explanation of how to view exhaustive details
 598 on what changed.
 599
 600 The F<INSTALL> file for how to build Perl.
 601
 602 The F<README> file for general stuff.
 603
 604 The F<Artistic> and F<Copying> files for copyright information.
 605
 606 =cut