pod/perldelta.pod

   1 =head1 NAME
   2
   3 perldelta - what's new for perl v5.7.0
   4
   5 =head1 DESCRIPTION
   6
   7 This document describes differences between the 5.6.0 release and
   8 the 5.7.0 release.
   9
  10 =head1 Security Vulnerability
  11
  12 A potential security vulnerability in the optional suidperl component
  13 of Perl has been identified.  The suidperl is neither built nor
  14 installed by default.  As of August the 20th, 2000, the only known
  15 vulnerable platform is Linux, most likely all Linux distributions.
  16 The CERT and various vendors have been alerted about the vulnerability.
  17
  18 The problem was caused by Perl trying to report a suspected security
  19 exploit attempt using an external program, /bin/mail.  In Linux
  20 platforms the /bin/mail program had an undocumented feature which gave
  21 access to a root shell, resulting in a serious compromise, instead of
  22 reporting the exploit attempt.  If you don't have /bin/mail or if you
  23 have 'safe suid scripts' or if you haven't installed the suidperl, you
  24 are safe.
  25
  26 The exploit attempt reporting feature has been completely removed from
  27 the Perl 5.7.0 release, so that particular vulnerability isn't there
  28 anymore.  However, further security vulnerabilities are,
  29 unfortunately, always possible.  The suidperl code is being reviewed
  30 and if deemed too risky to continue being supported, in the extreme
  31 case it may be completely removed in future releases.  In any case,
  32 suidperl should only be used by security experts who know exactly what
  33 they are doing and why they are using suidperl instead of some other solution.
  34 A good tool for similar needs is sudo: http://www.courtesan.com/sudo/
  35
  36 =head1 Incompatible Changes
  37
  38 =head2 Arrays Now Always Interpolate Into Double-Quoted Strings
  39
  40 Constructs like "foo@bar" now always assume the C<@bar> to be an array,
  41 regardless of whether it is known that C<@bar> is an array.
  42
  43 =head2 bless(REF, REF) is now a fatal error
  44
  45 The semantics of bless(REF, REF) were unclear and until someone proves
  46 it to make some sense, it is forbidden.
  47
  48 =head2 The eg/* Directory Removed
  49
  50 The very dusty examples in the eg/ directory have been removed.
  51 Suggestions for new shiny examples welcome but the main issue is that
  52 the examples need to be documented, tested, and--most importantly--maintained.
  53
  54 =head2 The lib/chat2.pl
  55
  56 The obsolete chat2 library that should never have been allowed
  57 to escape the laboratory has been decommissioned.
  58
  59 =head2 Unimplemented (But Recognized) POSIX Regex Features Now Fatal
  60
  61 The unimplemented POSIX regex features [[.cc.]] and [[=c=]] are still
  62 recognized but now cause fatal errors.  The previous behaviour of
  63 ignoring them by default and warning if requested was unacceptable
  64 since it, in a way, falsely promised that the features could be used.
  65
  66 =head2 lstat(FILEHANDLE) now warns
  67
  68 lstat(FILEHANDLE) now gives a warning because the operation makes no sense.
  69 In future releases this may become a fatal error.
  70
  71 =head2 Obsolete String Comparison Operators Removed
  72
  73 The long since deprecated uppercase aliases for the string comparison
  74 operators (EQ, NE, LT, LE, GE, GT) have now been removed.
  75
  76 =head2 The Regular Expression Submatches Are Now Unset When Backtracking
  77
  78 The regular expression captured submatches ($1, $2, ...) are now
  79 consistently unset if the match fails, instead of leaving false
  80 data lying around in them.
  81
  82 =head2 tr///CU Removed, Not To Return
  83
  84 The tr///C and tr///U features have been removed and will not return;
  85 the interface was a mistake.  Sorry about that.  For similar
  86 functionality, see pack('U0', ...) and pack('C0', ...).
  87
  88 =head1 Core Enhancements
  89
  90 =over 4
  91
  92 =item *
  93
  94 C<perl -d:Module=arg,arg,arg> now works (previously one couldn't pass
  95 in multiple arguments.)
  96
  97 =item *
  98
  99 my __PACKAGE__ now works.
 100
 101 =item *
 102
 103 no Module; now works even if there is no "sub unimport" in the Module.
 104
 105 =item *
 106
 107 The numerical comparison operators return C<undef> if either operand
 108 is a NaN.  Previously the behaviour was unspecified.
 109
 110 =item *
 111
 112 C<pack('U0a*', ...)> can now be used to force the string to UTF8.
 113
 114 =item *
 115
 116 prototype(\&) is now available.
 117
 118 =back
 119
 120 =head1 Modules and Pragmata
 121
 122 =head2 New Modules
 123
 124 =over 4
 125
 126 =item *
 127
 128 File::Temp, version 0.10, allows one to create temporary files
 129 and directories in an easy, portable, and secure way.
 130
 131 =item *
 132
 133 The Storable extension, version 0.7.2, released the 14th of August
 134 2000, has been added to the Perl distribution.  Storable gives
 135 persistence to Perl data structures by allowing the storage and
 136 retrieval of Perl data to and from files in a fast and compact binary
 137 format.
 138
 139 =back
 140
 141 =head2 Updated And Improved Modules and Pragmata
 142
 143 =over 4
 144
 145 =item *
 146
 147 The attributes::reftype() now works on tied arguments.
 148
 149 =item *
 150
 151 AutoLoader can now be `stopped' by
 152
 153         no AutoLoader;
 154
 155 =item *
 156
 157 B::Deparse now understands sub attributes.
 158
 159 =item *
 160
 161 Data::Dumper now works on negative number on 32-bit platforms where IV
 162 (the Perl's integer datatype) is greater than 32 bits.  Also, large
 163 unsigned numbers are now dumped as such, not as large negative numbers.
 164
 165 =item *
 166
 167 CGI has been updated to version 2.72, released
 168 the 20th of August 2000.
 169
 170 =item *
 171
 172 CPAN has been updated to version 1.57, released
 173 the 16th of August 2000.
 174
 175 =item *
 176
 177 DB_File has been updated to version 1.73, released the
 178 27th of April 2000.
 179
 180 =item *
 181
 182 The English module can now be used without the infamous performance
 183 hit by saying
 184
 185         use English '-no_performance_hit';
 186
 187 (Assuming, of course, that one doesn't need the troublesome variables
 188 C<$`>, C<$&>, or C<$'>.)  Also, introduce C<@LAST_MATCH_START> and
 189 C<@LAST_MATCH_END> English aliases for C<@-> and C<@+>.
 190
 191 =item *
 192
 193 File::Find now has pre- and postprocessing callbacks.
 194 It also correctly changes directories when chasing symbolic links.
 195 Callbacks doing (naughtily) "next;" instead of "return;" now work.
 196
 197 =item *
 198
 199 File::Glob::glob() renamed to File::Glob::bsd_glob() to avoid
 200 prototype mismatch with CORE::glob().
 201
 202 =item *
 203
 204 File::Spec has been updated to version 0.82, released the
 205 1st of July 2000.
 206
 207 =item *
 208
 209 Getopt::Long has been updated to version 2.23_05, released the 2nd of
 210 August 2000.
 211
 212 =item *
 213
 214 IO::Poll has been thoroughly fixed.
 215
 216 =item *
 217
 218 IO::Socket::INET now works when given an unknown service name with
 219 a port number.
 220
 221 =item *
 222
 223 IPC::Open3 now allows the use of numeric file descriptors.
 224
 225 =item *
 226
 227 use lib now works identically to @INC.  Removing directories
 228 with 'no lib' now works.
 229
 230 =item *
 231
 232 Math::BigFloat now more robust (fewer "uninitialized" warnings).
 233
 234 =item *
 235
 236 Math::Complex now handles extreme values (e.g. cplx(1E20, 1E30)) more
 237 gracefully.
 238
 239 =item *
 240
 241 The podlators bundle has been updated to version 1.02, released the
 242 25th of April 2000.  It contains the modules Pod::Man 1.04, Pod::Text
 243 2.04, and modules Pod::Text::Color and Pod::Text::Termcap (no version
 244 numbers).
 245
 246 =item *
 247
 248 Pod::LaTeX has been updated to version 0.52, released the 15th of May
 249 2000.  Note that this is a complete rewrite which translates pod much
 250 better, has many more options and much better documentation.  It also
 251 now uses the Pod::Parser backend, meaning that Pod::LaTeX will stay
 252 abreast other pod translators.
 253
 254 =item *
 255
 256 Pod::Parser has been updated to version 1.17, released the 25th of
 257 July 2000.  It contains the modules Pod::Checker 1.20, Pod::Find 0.21,
 258 Pod::InputObjects 1.13, Pod::ParseUtils 0.22, Pod::Parser 1.12,
 259 Pod::Select 1.13, and Pod::Usage 1.13.
 260
 261 =item *
 262
 263 The 'debug' subpragma the 're' pragma now produces cleaner output.
 264
 265 =item *
 266
 267 C<%INC> now localized in a Safe compartment so that use/require work.
 268
 269 =item *
 270
 271 SelfLoader no longer loses C<$@> in AUTOLOAD.
 272
 273 =item *
 274
 275 The Shell module now has an OO interface.
 276
 277 =item *
 278
 279 Sys::Syslog now works on domain sockets.  Also, a forked child
 280 now exits correctly if it fails to open /dev/console.
 281
 282 =item *
 283
 284 Term::ANSIColor has been updated to version 1.03, released the 6th of
 285 August 2000.
 286
 287 =item *
 288
 289 The Test module has been updated to version 1.14, released the 21st of June
 290 1999.  This is for all practical purposes identical to the previous release
 291 of Test included with the Perl distribution, 1.13, but upgrading the module
 292 stops the CPAN module from suggesting an upgrade.
 293
 294 =item *
 295
 296 Test::Harness output now prettier on failed test.
 297
 298 =item *
 299
 300 Text::Wrap::wtbrap now handles multiline strings properly.
 301
 302 =item *
 303
 304 UNIVERSAL::isa no longer caches methods incorrectly.
 305
 306 =back
 307
 308 =head1 Utility Changes
 309
 310 =head2 cperl-mode version 4.31
 311
 312 The Emacs perl mode (emacs/cperl-mode.el) has been updated to version 4.31.
 313
 314 =head2 perlbug
 315
 316 Perlbug is now much more robust.  It also sends the bug report to perl.org,
 317 not perl.com.
 318
 319 =head2 perlcc now more cc-like and more robust
 320
 321 The perlcc utility has been rewritten and its user interface (that is,
 322 command line) is much more like that of the UNIX C compiler, cc.
 323
 324 =head2 xsubpp now understands embedded pod
 325
 326 The xsubpp utility for extension writers now understands POD
 327 documentation embedded in the *.xs files.
 328
 329 =head1 Improved Documentation
 330
 331 =over 4
 332
 333 =item *
 334
 335 In many places say "alphanumeric characters" instead of "word
 336 characters" because that was what was meant.
 337
 338 =item *
 339
 340 Eradicate "array context" from the documentation and diagnostics.
 341
 342 =item *
 343
 344 The return values of failing backticks (`, qx{}) are now documented
 345 in perlop.
 346
 347 =item *
 348
 349 caller() return values now better documented.
 350
 351 =item *
 352
 353 SDBM_File, NDBM_File, ODBM_File, now tell about tying instead of
 354 glossing over.
 355
 356 =item *
 357
 358 Document that the C<$(> special variable does not interpolate
 359 in regular expressions.
 360
 361 =item *
 362
 363 The timeout unit of IO::Select is now documented to be identical
 364 to the timeout unit of the 4-arg select(), that is, (optionally
 365 fractional) seconds, or an undef to wait indefinitely.
 366
 367 =item *
 368
 369 Document the C<D> and C<d> magic types.
 370
 371 =item *
 372
 373 The ordering of PODs in perl.pod is now more sensible.
 374
 375 =item *
 376
 377 perlbook now only mentions the Camel III; all other book references
 378 have been moved to perlfaq2; some good known books added.
 379
 380 =item *
 381
 382 Numerous missing warning/error messages added to perldiag.
 383
 384 =item *
 385
 386 Changed the description of perl6 in perlfaq1.
 387
 388 =item *
 389
 390 perlhack much extended.
 391
 392 =item *
 393
 394 perltrap cleaned up.
 395
 396 =item *
 397
 398 Add perlxstut example for passing/returning refs to arrays.
 399
 400 =item *
 401
 402 POSIX module documentation embellished.
 403
 404 =item *
 405
 406 Clarified the status of shadow password support.
 407
 408 =item *
 409
 410 Reminded that preprocessors and source filters can alter
 411 your code before Perl sees it and therefore debugging
 412 can be somewhat surprising.  ("I didn't write *that*!")
 413
 414 =item *
 415
 416 Removed incorrect documentation about implicit split to @_
 417 in list context, which never really worked in Perl 5 anyway.
 418
 419 =item *
 420
 421 Explain that split /^/ is split /^/m.
 422
 423 =item *
 424
 425 Added many more sprintf() examples in perlfunc.
 426
 427 =item *
 428
 429 Documented the handling of negative indices to tied arrays.
 430
 431 =item *
 432
 433 The C<$yday> in localtime()/gmtime() is 0..364, not 1..365.
 434
 435 =item *
 436
 437 Documented that tr() is not tr(1): that is, do not expect regular expressions.
 438
 439 =item *
 440
 441 Warn about the vagaries of UDP.
 442
 443 =item *
 444
 445 The uninitialized variable warnings now say "concat or string" or
 446 "join or string" instead of just "concat" or "join" since many users
 447 found the "concat" a bit surprising when they were doing "just"
 448 variable interpolation.
 449
 450 =item *
 451
 452 Documented that the values() are aliases, not copies.
 453
 454 =back
 455
 456 =head2 New Documentation
 457
 458 =over 4
 459
 460 =item *
 461
 462 perl56delta details the changes between the 5.005 release and the
 463 5.6.0 release.
 464
 465 =item *
 466
 467 perldebtut is a Perl debugging tutorial.
 468
 469 =item *
 470
 471 perlebcdic contains considerations for running Perl on EBCDIC platforms.
 472 Note that unfortunately EBCDIC platforms that used to supported back in
 473 Perl 5.005 are still unsupported by Perl 5.7.0; the plan, however, is to
 474 bring them back to the fold.
 475
 476 =item *
 477
 478 perlnewmod tells about writing and submitting a new module.
 479
 480 =item *
 481
 482 perlposix-bc explains using Perl on the POSIX-BC platform
 483 (a mainframe platform).
 484
 485 =item *
 486
 487 perlretut is a regular expression tutorial.
 488
 489 =item *
 490
 491 perlrequick is a regular expressions quick-start guide.
 492 Yes, much quicker than perlretut.
 493
 494 =item *
 495
 496 perlutil explains the command line utilities packaged with the Perl
 497 distribution.
 498
 499 =back
 500
 501 =head1 Performance Enhancements
 502
 503 map() that changes the size of the list should now work faster.
 504
 505 =head1 Installation and Configuration Improvements
 506
 507 =head2 INSTALL now explains 64-bit configuration.
 508
 509 In some platforms Perl can be configured to use 64-bit integers,
 510 allowing 4 billion times better...sorry, switched accidentally to
 511 marketdroid mode for a moment in there.  (In platforms which are
 512 natively 64-bit this makes no difference.)
 513
 514 =head2 Policy.sh policy change
 515
 516 If you are reusing a Policy.sh file (see INSTALL) and you use
 517 Configure -Dprefix=/foo/bar and in the old Policy $prefix eq
 518 $siteprefix and $prefix eq $vendorprefix, all of them will now be
 519 changed to the new prefix, /foo/bar.  (Previously only $prefix
 520 changed.)  If you do not like this new behaviour, specify prefix,
 521 siteprefix, and vendorprefix explicitly.
 522
 523 =head2 Additional Library Locations
 524
 525 A new optional location for Perl libraries, otherlibdirs, is available.
 526 It can be used for example for vendor add-ons without disturbing Perl's
 527 own library directories.
 528
 529 =head2 gcc automatically tried if 'cc' does not seem to be working
 530
 531 In many platforms the vendor-supplied 'cc' is too stripped-down to
 532 build Perl (basically, the 'cc' doesn't do ANSI C).  If this seems
 533 to be the case and the 'cc' does not seem to be the GNU C compiler
 534 'gcc', an automatic attempt is made to find and use 'gcc' instead.
 535
 536 =head2 If gcc seems to be from a different operating system release ...
 537
 538 gcc needs to closely track the operating system release because gcc
 539 wants to have its own versions of the operating system header files
 540 fixed to be clean enough for gcc's tastes.  Therefore using a gcc
 541 compiled for a different release of the operating system is often a
 542 bad idea.  If Configure can find out the operating system release that
 543 was used to compile the gcc and that release is different from the one
 544 being used now, gcc gives a clearly visible warning that trouble may
 545 lie ahead.
 546
 547 =head2 If no binary compatibility with 5.005 wanted, no 5.005 modules, either
 548
 549 If no binary compatibility with the 5.005 release is wanted, Configure
 550 does not suggest including the 5.005 modules in the @INC.
 551
 552 =head2 Configuration and Installation fixes
 553
 554 =over 4
 555
 556 =item *
 557
 558 Configure C<-S> can now run non-interactively
 559
 560 =item *
 561
 562 configure.gnu now works with options with whitespace in them
 563
 564 =item *
 565
 566 installperl now outputs everything to STDERR
 567
 568 =item *
 569
 570 $Config{byteorder} is now computed dynamically (this is more robust
 571 with "fat binaries" where an executable image contains binaries for
 572 more than one binary platform.)
 573
 574 =back
 575
 576 =head1 Platform Specific Changes and Fixes
 577
 578 =head2 BSDI 4.*
 579
 580 Perl now works on post-4.0 BSD/OSes.
 581
 582 =head2 All BSDs
 583
 584 Setting the C<$0> now works (as much as possible; see perlvar for details).
 585
 586 =head2 Cygwin
 587
 588 =over 4
 589
 590 =item *
 591
 592 Numerous updates; currently synchronized with Cygwin 1.1.4.
 593
 594 =back
 595
 596 =head2 EPOC
 597
 598 EPOC update after Perl 5.6.0.  The EPOC port home page is at
 599 http://members.linuxstart.com/~oflebbe/perl/perl5.html
 600
 601 =head2 FreeBSD 3.*
 602
 603 Perl now works on post-3.0 FreeBSDs.
 604
 605 =head2 HP-UX
 606
 607 =over 4
 608
 609 =item *
 610
 611 Document that the C<perl -P> causes problems if one uses C<s/foo//>
 612 (because the HP C compiler does funny things to that // thinking it
 613 to be C++), document also the workaround.
 614
 615 =item *
 616
 617 C<Configure -Duse64bitall> now almost works (one failing test).
 618
 619 =back
 620
 621 =head2 IRIX
 622
 623 =over 4
 624
 625 =item *
 626
 627 Numerous compilation flag and hint enhancements.
 628
 629 =item *
 630
 631 Accidental mixing of 32-bit and 64-bit libraries (a doomed attempt)
 632 made much harder.
 633
 634 =back
 635
 636 =head2 Linux
 637
 638 =over 4
 639
 640 =item *
 641
 642 Long doubles should now work (see INSTALL).
 643
 644 =back
 645
 646 =head2 MacOS Classic
 647
 648 =over 4
 649
 650 =item *
 651
 652 Compilation of the standard Perl distribution in MacOS Classic should
 653 now work--assuming you have the Metrowerks development environment and
 654 the missing Mac-specific toolkit bits, contact the macperl mailing
 655 list for details.
 656
 657 =back
 658
 659 =head2 MPE/iX
 660
 661 MPE/iX update after Perl 5.6.0.  The Perl/iX home page is at
 662 http://www.bixby.org/mark/perlix.html
 663
 664 =head2 NetBSD/sparc
 665
 666 Perl now works on NetBSD/sparc.
 667
 668 =head2 OS/2
 669
 670 =over 4
 671
 672 =item *
 673
 674 Now works with usethreads (see INSTALL).
 675
 676 =back
 677
 678 =head2 Solaris
 679
 680 =over 4
 681
 682 =item *
 683
 684 64-bitness using the Sun Workshop compiler now works.
 685
 686 =back
 687
 688 =head2 Tru64 (aka Digital UNIX, aka DEC OSF/1)
 689
 690 =over 4
 691
 692 =item *
 693
 694 Allow compiling with gcc (previously explicitly forbidden).  Compiling
 695 with gcc still not recommended because buggy code results, even with
 696 gcc 2.95.2.
 697
 698 =item *
 699
 700 The operating system version letter now recorded in $Config{osvers}.
 701
 702 =back
 703
 704 =head2 Unicos
 705
 706 =over 4
 707
 708 =item *
 709
 710 Fixed various alignment problems that lead into core dumps either
 711 during build or later.
 712
 713 =item *
 714
 715 no longer dying on math errors in runtime.
 716
 717 =item *
 718
 719 Now using full quad integers (64 bits), previously was using
 720 only 46 bit integers for speed.
 721
 722 =back
 723
 724 =head2 VMS
 725
 726 =over 4
 727
 728 =item *
 729
 730 chdir() now works better despite a CRT bug.
 731
 732 =item *
 733
 734 Now works with MULTIPLICITY (see INSTALL).
 735
 736 =item *
 737
 738 Now works with Perl's malloc.
 739
 740 =back
 741
 742 =head2 Windows
 743
 744 =over 4
 745
 746 =item *
 747
 748 accept() no longer leaks memory.
 749
 750 =item *
 751
 752 Better chdir() return value for a non-existent directory.
 753
 754 =item *
 755
 756 New %ENV entries now propagate to subprocesses.
 757
 758 =item *
 759
 760 $ENV{LIB} now used to search for libs under Visual C.
 761
 762 =item *
 763
 764 A failed (pseudo)fork now returns undef and sets errno to EAGAIN.
 765
 766 =item *
 767
 768 Allow REG_EXPAND_SZ keys in the registry.
 769
 770 =item *
 771
 772 Can now send() from all threads, not just the first one.
 773
 774 =item *
 775
 776 Fake signal handling reenabled, bugs and all.
 777
 778 =item *
 779
 780 Less stack reserved per thread so that more threads can run
 781 concurrently. (still 16M perl thread)
 782
 783 =item *
 784
 785 C<File::Spec->tmpdir()> now prefers C:/temp over /tmp
 786 (works better when perl running as service).
 787
 788 =item *
 789
 790 Better UNC path handling under ithreads.
 791
 792 =item *
 793
 794 wait() and waitpid() now work much better.
 795
 796 =item *
 797
 798 winsock handle leak fixed.
 799
 800 =back
 801
 802 =head1 Selected Bug Fixes
 803
 804 The following is by no means a comprehensive list of all the
 805 numerous bug fixes.
 806
 807 =over 4
 808
 809 =item *
 810
 811 Redefining constant subroutines using eval (again) warns.
 812
 813 =item *
 814
 815 Several debugger fixes: exit code now reflects the script exit code,
 816 condition C<"0"> now treated correctly, the C<d> command now checks
 817 line number, the C<$.> no longer gets corrupted, all debugger output now
 818 goes correctly to the socket if RemotePort is set.
 819
 820 =item *
 821
 822 C<*foo{FORMAT}> now works.
 823
 824 =item *
 825
 826 Lexical warnings now propagating correctly between scopes.
 827
 828 =item *
 829
 830 Line renumbering with eval and C<#line> now works.
 831
 832 =item *
 833
 834 Module name now mandatory after the C<-M> switch.
 835
 836 =item *
 837
 838 Fixed numerous memory leaks, especially in eval "".
 839
 840 =item *
 841
 842 Modulus of unsigned numbers now works (4063328477 % 65535 used to
 843 return 27406, instead of 27047).
 844
 845 =item *
 846
 847 msgrcv() no longer warns about uninitialized input scalar.
 848
 849 =item *
 850
 851 Some "not a number" warnings introduced in 5.6.0 eliminated to be
 852 more compatible with 5.005.  Infinity is now recognized as a number.
 853
 854 =item *
 855
 856 our() variables will not cause "will not stay shared" warnings
 857
 858 =item *
 859
 860 pack "Z" now correctly terminates the string with an "\0".
 861
 862 =item *
 863
 864 Fix password routines which in some shadow password platforms
 865 (e.g. HP-UX) caused getpwent() to return every other entry.
 866
 867 =item *
 868
 869 POSIX::STDERR_FILENO (not POSIX::STRERR_FILENO).
 870
 871 =item *
 872
 873 printf() no longer resets the numeric locale to "C".
 874
 875 =item *
 876
 877 C<q(a\\b)> now parses as C<'a\\b'>.
 878
 879 =item *
 880
 881 In quad (64-bit) platforms numbers now stay integers longer
 882 (as opposed to converting automatically to floating point numbers).
 883
 884 =item *
 885
 886 Printing quads (64-bit integers) with printf/sprintf works now
 887 without q L ll prefixes (assuming you are on a quad-capable platform).
 888
 889 =item *
 890
 891 Regular expressions on references and overloaded scalars now work.
 892
 893 =item *
 894
 895 Multiline matching of C<"a\nxb\n" =~ /(?!\A)x/m> now works.
 896
 897 =item *
 898
 899 C</(?i)/> now works.
 900
 901 =item *
 902
 903 C</x{ab}/> now works.
 904
 905 =item *
 906
 907 scalar() now forces scalar context even when used in void context.
 908
 909 =item *
 910
 911 All the documented Shell.pm examples now work.
 912
 913 =item *
 914
 915 sort() arguments are now compiled in the right wantarray context
 916 (they were accidentally using the context of the sort() itself).
 917
 918 =item *
 919
 920 Changed the POSIX character class C<[[:space:]]> to include the (very
 921 rare) vertical tabulator character.  Added a new POSIX-ish character
 922 class C<[[:blank:]]> which stands for horizontal whitespace (currently,
 923 the space and the tabulator).
 924
 925 =item *
 926
 927 sprintf() format specs like C<%v-*d> now work.
 928
 929 =item *
 930
 931 The (nonsensical) C<%#p> format made illegal.
 932
 933 =item *
 934
 935 C<${$1}> now works (again).
 936
 937 =item *
 938
 939 $AUTOLOAD, sort(), lock(), and spawning subprocesses
 940 in multiple thread simultaneously are now thread-safe.
 941
 942 =item *
 943
 944 Allow read-only string on left hand side of non-modifying tr///.
 945
 946 =item *
 947
 948 Several Unicode fixes (but still not perfect).
 949
 950 BOMs (byte order marks) in the beginning of Perl files
 951 (scripts, modules) should now be transparently skipped.
 952 UTF16 encoded Perl files should now be read correctly.
 953
 954 The character tables have been updated to new Unicode 3.0 features.
 955
 956 chr() for values greater than 127 now create utf8 when under use
 957 utf8.
 958
 959 Comparing with utf8 data does not magically upgrade non-utf8 data into
 960 utf8.
 961
 962 C<IsAlnum>, C<IsAlpha>, and C<IsWord> now match titlecase.
 963
 964 Concatenation with the C<.> operator or via variable interpolation,
 965 C<eq>, C<substr>, C<reverse>, C<quotemeta>, the C<x> operator,
 966 substitution with C<s///>, single-quoted UTF8, should now work--in
 967 theory.
 968
 969 The C<tr///> operator now works I<slightly> better but is still rather
 970 broken.  Note that the C<tr///CU> functionality has been removed (but
 971 see pack('U0', ...)).
 972
 973 Zero entries were missing from the Unicode classes like C<IsDigit>.
 974
 975 =item *
 976
 977 Unsignedness could disappear from a scalar causing later numeric
 978 comparisons to fail.
 979
 980 =item *
 981
 982 vec() now drops numericalness.
 983
 984 =back
 985
 986 =head1 New or Changed Diagnostics
 987
 988 All regular expression compilation error messages are now hopefully
 989 easier to understand both because the error message now comes before
 990 the failed regex and because the point of failure is now clearly
 991 marked.
 992
 993 The various "opened only for", "on closed", "never opened" warnings
 994 drop the C<main::> prefix for filehandles in the C<main> package,
 995 for example C<STDIN> instead of <main::STDIN>.
 996
 997 =over 4
 998
 999 =item *
1000
1001 (perhaps you forgot to load "%s"?)
1002
1003 (F) This is an educated guess made in conjunction with the message
1004 "Can't locate object method \"%s\" via package \"%s\"".  It often means
1005 that a method requires a package that has not been loaded.
1006
1007 =item *
1008
1009 Ambiguous range in transliteration operator
1010
1011 (F) You wrote something like C<tr/a-z-0//> which doesn't mean anything at
1012 all.  To include a C<-> character in a transliteration, put it either
1013 first or last.  (In the past, C<tr/a-z-0//> was synonymous with
1014 C<tr/a-y//>, which was probably not what you would have expected.)
1015
1016 =item *
1017
1018 The "Unrecognized escape" warning has been extended to include C<\8>,
1019 C<\9>, and C<\_>.  There is no need to escape any of the C<\w> characters.
1020
1021 =back
1022
1023 =head1 New tests
1024
1025 =over 4
1026
1027 =item *
1028
1029 lib/b tests the various compiler backends (see L<perlcompile>).
1030
1031 =item *
1032
1033 lib/cgi-pretty tests CGI pretty printing.
1034
1035 =item *
1036
1037 lib/ftmp-*.t test File::Temp.
1038
1039 =item *
1040
1041 lib/gol-oo tests Getopt::Long objected-oriented interface.
1042
1043 =item *
1044
1045 lib/peek tests Devel::Peek.
1046
1047 =item *
1048
1049 lib/selfloader tests SelfLoader.
1050
1051 =item *
1052
1053 lib/syslog tests Sys::Syslog.
1054
1055 =item *
1056
1057 op/bless tests bless().
1058
1059 =item *
1060
1061 op/stash tests the "my Package ..." feature.
1062
1063 =item *
1064
1065 op/regmesg exercises all various regex errors.
1066
1067 =item *
1068
1069 pod/find tests Pod::Find.
1070
1071 =back
1072
1073 =head2 Improved Tests
1074
1075 =over 4
1076
1077 =item *
1078
1079 op/sprintf coverage is now much more comprehensive.
1080
1081 =item *
1082
1083 op/taint now continues on failed shmget().
1084
1085 =item *
1086
1087 lib/sysfs.t now continues even if SIXFSZ happens.
1088
1089 =item *
1090
1091 lib/syslog.t now works without sockets.
1092
1093 =back
1094
1095 =head1 Changed Internals
1096
1097 =head2 apidoc
1098
1099 perlapi.pod (a companion to perlguts) now attempts to document the
1100 internal API.
1101
1102 =head2 microperl
1103
1104 There is now a way to build a really minimal perl called microperl.
1105 Building microperl does not require even running Configure;
1106 C<make -f Makefile.micro> should be enough.  Beware: microperl makes
1107 many assumptions, some of which may be too bold; the resulting
1108 executable may crash or otherwise misbehave in wondrous ways.  For
1109 careful hackers only.
1110
1111 =head2 Publicize More Functions
1112
1113 Added rsignal(), whichsig(), do_join() to the publicized API.
1114
1115 =head2 Propagating Exception Objects via Perl_croak() IN XS code
1116
1117 Made possible to propagate customized exceptions via croak()ing.
1118
1119 =head2 UTF8 Interfaces
1120
1121 Added is_utf8_char(), is_utf8_string(), bytes_to_utf8(), and utf8_to_bytes().
1122
1123 =head2 xsub attributes
1124
1125 Now xsubs can have attributes just like subs.
1126
1127 =head1 Known Problems
1128
1129 =head2 Unicode Support Still Far From Perfect
1130
1131 We're working on it.  Stay tuned.
1132
1133 =head2 EBCDIC Still A Lost Platform
1134
1135 The plan is to bring them back.
1136
1137 =head2 Building Extensions Can Fail Because Of Largefiles
1138
1139 Certain extensions like mod_perl and BSD::Resource are known to have
1140 issues with `largefiles', a change brought by Perl 5.6.0 in where file
1141 offsets are by default 64 bits wide (assuming the platform supports
1142 such large files).  Modules may fail to compile at all or compile and
1143 work incorrectly.  Currently there is no good solution for the problem
1144 but Configure now stores the flags and libraries that affect the
1145 largefileness to the %Config hash, the extensions that are having
1146 problems can try configuring themselves without the largefileness.
1147 This is admittedly not a clean solution.
1148
1149 =head1 Obsolete Diagnostics
1150
1151 =head1 Reporting Bugs
1152
1153 If you find what you think is a bug, you might check the articles
1154 recently posted to the comp.lang.perl.misc newsgroup and the perl
1155 bug database at http://bugs.perl.org.  There may also be
1156 information at http://www.perl.com/perl/, the Perl Home Page.
1157
1158 If you believe you have an unreported bug, please run the B<perlbug>
1159 program included with your release.  Be sure to trim your bug down
1160 to a tiny but sufficient test case.  Your bug report, along with the
1161 output of C<perl -V>, will be sent off to perlbug@perl.org to be
1162 analysed by the Perl porting team.
1163
1164 =head1 SEE ALSO
1165
1166 The F<Changes> file for exhaustive details on what changed.
1167
1168 The F<INSTALL> file for how to build Perl.
1169
1170 The F<README> file for general stuff.
1171
1172 The F<Artistic> and F<Copying> files for copyright information.
1173
1174 =head1 HISTORY
1175
1176 Written by Jarkko Hietaniemi <F<jhi@iki.fi>>, with many contributions
1177 from The Perl Porters and Perl Users submitting feedback and patches.
1178
1179 Send omissions or corrections to <F<perlbug@perl.org>>.
1180
1181 =cut