make "lstat FH" croak
[p5sagit/p5-mst-13.2.git] / pod / perldelta.pod
index 27e4d7d..a2923f8 100644 (file)
@@ -4,8 +4,45 @@ perldelta - what is new for perl v5.8.0
 
 =head1 DESCRIPTION
 
-This document describes differences between the 5.6.0 release and the
-5.8.0 release.
+This document describes differences between the 5.6.0 release
+and the 5.8.0 release.
+
+Many of the bug fixes in 5.8.0 were already seen in the 5.6.1
+maintenance release since the two releases were kept closely
+coordinated.
+
+If you are upgrading from Perl 5.005_03, you might also want
+to read L<perl56delta>.
+
+=head1 Highlights In 5.8.0
+
+=over 4
+
+=item *
+
+Better Unicode support
+
+=item *
+
+New Thread Implementation
+
+=item *
+
+Many New Modules
+
+=item *
+
+Better Numeric Accuracy
+
+=item *
+
+Safe Signals
+
+=item *
+
+More Extensive Regression Testing
+
+=back
 
 =head1 Incompatible Changes
 
@@ -28,6 +65,15 @@ change will probably break backward compatibility with compiled
 modules.  The change was made to make Perl more compliant with other
 applications like modperl which are using the AIX native interface.
 
+=head2 Attributes for C<my> variables now handled at run-time.
+
+The C<my EXPR : ATTRS> syntax now applies variable attributes at
+run-time.  (Subroutine and C<our> variables still get attributes applied
+at compile-time.)  See L<attributes> for additional details.  In particular,
+however, this allows variable attributes to be useful for C<tie> interfaces,
+which was a deficiency of earlier releases.  Note that the new semantics
+doesn't work with the Attribute::Handlers module (as of version 0.76).
+
 =head2 Socket Extension Dynamic in VMS
 
 The Socket extension is now dynamically loaded instead of being
@@ -35,33 +81,38 @@ statically built in.  This may or may not be a problem with ancient
 TCP/IP stacks of VMS: we do not know since we weren't able to test
 Perl in such configurations.
 
-=head2 Different Definition of the Unicode Character Classes \p{In...}
-
-As suggested by the Unicode consortium, the Unicode character classes
-now prefer I<scripts> as opposed to I<blocks> (as defined by Unicode);
-in Perl, when the C<\p{In....}> and the C<\p{In....}> regular expression
-constructs are used.  This has changed the definition of some of those
-character classes.
-
-The difference between scripts and blocks is that scripts are the
-glyphs used by a language or a group of languages, while the blocks
-are more artificial groupings of 256 characters based on the Unicode
-numbering.
-
-In general this change results in more inclusive Unicode character
-classes, but changes to the other direction also do take place:
-for example while the script C<Latin> includes all the Latin
-characters and their various diacritic-adorned versions, it
-does not include the various punctuation or digits (since they
-are not solely C<Latin>).
-
-Changes in the character class semantics may have happened if a script
-and a block happen to have the same name, for example C<Hebrew>.
-In such cases the script wins and C<\p{InHebrew}> now means the script
-definition of Hebrew.  The block definition in still available,
-though, by appending C<Block> to the name: C<\p{InHebrewBlock}> means
-what C<\p{InHebrew}> meant in perl 5.6.0.  For the full list
-of affected character classes, see L<perlunicode/Blocks>.
+=head2 IEEE-format Floating Point Default on OpenVMS Alpha
+
+Perl now uses IEEE format (T_FLOAT) as the default internal floating
+point format on OpenVMS Alpha, potentially breaking binary compatibility
+with external libraries or existing data.  G_FLOAT is still available as
+a configuration option.  The default on VAX (D_FLOAT) has not changed.
+
+=head2 New Unicode Properties
+
+Unicode I<scripts> are now supported. Scripts are similar to (and superior
+to) Unicode I<blocks>. The difference between scripts and blocks is that
+scripts are the glyphs used by a language or a group of languages, while
+the blocks are more artificial groupings of (mostly) 256 characters based
+on the Unicode numbering.
+
+In general, scripts are more inclusive, but not universally so. For
+example, while the script C<Latin> includes all the Latin characters and
+their various diacritic-adorned versions, it does not include the various
+punctuation or digits (since they are not solely C<Latin>).
+
+A number of other properties are now supported, including C<\p{L&}>,
+C<\p{Any}> C<\p{Assigned}>, C<\p{Unassigned}>, C<\p{Blank}> and
+C<\p{SpacePerl}> (along with their C<\P{...}> versions, of course).
+See L<perlunicode> for details, and more additions.
+
+The C<In> or C<Is> prefix to names used with the C<\p{...}> and C<\P{...}>
+are now almost always optional. The only exception is that a C<In> prefix
+is required to signify a Unicode block when a block name conflicts with a
+script name. For example, C<\p{Tibetan}> refers to the script, while
+C<\p{InTibetan}> refers to the block. When there is no name conflict, you
+can omit the C<In> from the block name (e.g. C<\p{BraillePatterns}>), but
+to be safe, it's probably best to always use the C<In>).
 
 =head2 Perl Parser Stress Tested
 
@@ -91,6 +142,13 @@ to escape the laboratory has been decommissioned.
 
 =item *
 
+The builtin dump() function has probably outlived most of its
+usefulness.  The core-dumping functionality will remain in future
+available as an explicit call to C<CORE::dump()>, but in future
+releases the behaviour of an unqualified C<dump()> call may change.
+
+=item *
+
 The very dusty examples in the eg/ directory have been removed.
 Suggestions for new shiny examples welcome but the main issue is that
 the examples need to be documented, tested and (most importantly)
@@ -105,11 +163,17 @@ any C<\w> character.
 =item *
 
 The list of filenames from glob() (or <...>) is now by default sorted
-alphabetically to be csh-compliant.  (bsd_glob() does still sort platform
+alphabetically to be csh-compliant (which is what happened before
+in most UNIX platforms).  (bsd_glob() does still sort platform
 natively, ASCII or EBCDIC, unless GLOB_ALPHASORT is specified.)
 
 =item *
 
+Spurious syntax errors generated in certain situations, when glob()
+caused File::Glob to be loaded for the first time, have been fixed.
+
+=item *
+
 Although "you shouldn't do that", it was possible to write code that
 depends on Perl's hashed key order (Data::Dumper does this).  The new
 algorithm "One-at-a-Time" produces a different hashed key order.
@@ -146,7 +210,7 @@ available.
 
 =item *
 
-The syntaxes C<< @a->[...] >> and  C<< %h->{...}>> have now been deprecated.
+The syntaxes C<< @a->[...] >> and  C<< %h->{...} >> have now been deprecated.
 
 =item *
 
@@ -165,6 +229,13 @@ The tr///C and tr///U features have been removed and will not return;
 the interface was a mistake.  Sorry about that.  For similar
 functionality, see pack('U0', ...) and pack('C0', ...).
 
+=item *
+
+Earlier Perls treated "sub foo (@bar)" as equivalent to "sub foo (@)".
+The prototypes are now checked at compile-time for invalid characters.
+An optional warning is generated ("Illegal character in prototype...")
+but this may be upgraded to a fatal error in a future release.
+
 =back
 
 =head1 Core Enhancements
@@ -241,11 +312,19 @@ the child process.
 
 =back
 
-=head2 Signals Are Now Safe
+=head2 Safe Signals
 
 Perl used to be fragile in that signals arriving at inopportune moments
 could corrupt Perl's internal state.  Now Perl postpones handling of
-signals until it's safe.
+signals until it's safe (between opcodes).
+
+This change may have surprising side effects because signals no longer
+interrupt Perl instantly.  Perl will now first finish whatever it was
+doing, like finishing an internal operation (like sort()) or an
+external operation (like an I/O operation), and only then look at any
+arrived signals (and before starting the next operation).  No more corrupt
+internal state since the current operation is always finished first,
+but the signal may take more time to get heard.
 
 =head2 Unicode Overhaul
 
@@ -265,17 +344,19 @@ to Unicode 3.1.1.  For more information, see http://www.unicode.org/.
 
 For developers interested in enhancing Perl's Unicode capabilities:
 almost all the UCD files are included with the Perl distribution in
-the lib/unicore subdirectory.  The most notable omission, for space
+the F<lib/unicore subdirectory>.  The most notable omission, for space
 considerations, is the Unihan database.
 
 =item *
 
-The Unicode character classes \p{Blank} and \p{SpacePerl} have been
-added.  "Blank" is like C isblank(), that is, it contains only
-"horizontal whitespace" (the space character is, the newline isn't),
-and the "SpacePerl" is the Unicode equivalent of C<\s> (\p{Space}
-isn't, since that includes the vertical tabulator character, whereas
-C<\s> doesn't.)
+The properties \p{Blank} and \p{SpacePerl} have been added. "Blank" is like
+C isblank(), that is, it contains only "horizontal whitespace" (the space
+character is, the newline isn't), and the "SpacePerl" is the Unicode
+equivalent of C<\s> (\p{Space} isn't, since that includes the vertical
+tabulator character, whereas C<\s> doesn't.)
+
+See "New Unicode Properties" earlier in this document for additional
+information on changes with Unicode properties.
 
 =back
 
@@ -294,7 +375,7 @@ This change leads to often slightly faster and always less lossy
 arithmetics. (Previously Perl always preferred floating point numbers
 in its math.)
 
-=head2 Miscellaneous Enhancements
+=head2 Miscellaneous Changes
 
 =over 4
 
@@ -310,6 +391,23 @@ in multiple arguments.)
 
 =item *
 
+The builtin dump() now gives an optional warning
+C<Ambiguous call resolved as CORE::dump(), qualify as such or use &>
+meaning that by default C<dump(...)> is resolved as the builtin 
+dump() which dumps core and aborts, not as (possibly) user-defined
+C<sub dump>.  To call the latter, qualify the call as C<&dump(...)>.
+(The whole dump() feature is to considered deprecated, and possibly
+removed/changed in future releases.)
+
+=item *
+
+chomp() and chop() have been demoted back to I<not> being overrideable
+because they cannot really be overridden-- the problem is that their
+prototype cannot be expressed and therefore one really cannot write
+replacements to override these builtins.
+
+=item *
+
 END blocks are now run even if you exit/die in a BEGIN block.
 Internally, the execution of END blocks is now controlled by 
 PL_exit_flags & PERL_EXIT_DESTRUCT_END. This enables the new
@@ -323,6 +421,12 @@ Formats now support zero-padded decimal fields.
 =item *
 
 Lvalue subroutines can now return C<undef> in list context.
+However, the lvalue subroutine feature still remains experimental.
+
+=item *
+
+A lost warning "Can't declare ... dereference in my" has been
+restored (Perl had it earlier but it became lost in later releases.)
 
 =item *
 
@@ -358,8 +462,9 @@ C<%\d+\$> and C<*\d+\$> syntaxes.  For example
 
     print "%2\$s %1\$s\n", "foo", "bar";
 
-will print "bar foo\n"; This feature helps in writing
-internationalised software.
+will print "bar foo\n".  This feature helps in writing
+internationalised software, and in general when the order
+of the parameters can vary.
 
 =item *
 
@@ -372,7 +477,21 @@ prototype(\[$@%&]) is now available to implicitly create references
 
 =item *
 
-UNTIE method is now recognised.
+A new command-line option, C<-t> is available.  It is the
+little brother of C<-T>: instead of dieing on taint violations,
+lexical warnings are given.  B<This is only meant as a temporary
+debugging aid while securing the code of old legacy applications.
+This is not a substitute for -T.>
+
+=item *
+
+If tr/// is just counting characters, it doesn't attempt to
+modify its target.
+
+=item *
+
+untie() will now call an UNTIE() hook if it exists.  See L<perltie>
+for details.
 
 =item *
 
@@ -628,7 +747,7 @@ to Quoted-Printable.  See L<PerlIO::Via>.
 =item *
 
 C<Pod::ParseLink>, by Russ Allbery, has been added,
-to parse L&lt;&gt; links in pods as described in the new
+to parse LZ<><> links in pods as described in the new
 perlpodspec.
 
 =item *
@@ -685,7 +804,7 @@ more extensive than Test::Simple, by Michael Schwern.  See L<Test::More>.
 
 =item *
 
-C<Test::Simple> has the- basic utilities for writing tests, by Michael
+C<Test::Simple> has basic utilities for writing tests, by Michael
 Schwern.   See L<Test::Simple>.
 
 =item *
@@ -799,6 +918,11 @@ using B::Deparse.
 
 =item *
 
+DB_File now supports newer Berkeley DB versions, among
+other improvements.
+
+=item *
+
 The English module can now be used without the infamous performance
 hit by saying
 
@@ -816,6 +940,10 @@ This means that they will be more robust and hopefully faster.
 
 =item *
 
+File::Find now chdir()s correctly when chasing symbolic links.
+
+=item *
+
 File::Find now has pre- and post-processing callbacks.  It also
 correctly changes directories when chasing symbolic links.  Callbacks
 (naughtily) exiting with "next;" instead of "return;" now work.
@@ -869,26 +997,47 @@ with 'no lib' now works.
 
 =item *
 
+ExtUtils::MakeMaker now uses File::Spec internally, which hopefully
+leads into better portability.
+
+=item *
+
 Math::BigFloat and Math::BigInt have undergone a full rewrite.
 They are now magnitudes faster, and they support various
 bignum libraries such as GMP and PARI as their backends.
 
 =item *
 
-Net::Ping has been enhanced.  There is now "external" protocol which
-uses Net::Ping::External module which runs external ping(1) and parses
-the output.  An alpha version of Net::Ping::External is available in
-CPAN and in 5.7.2 the Net::Ping::External may be integrated to Perl.
+Math::Complex handles inf, NaN etc., better.
+
+=item *
+
+Net::Ping has been muchly enhanced.  Multihoming is now supported.
+There is now "external" protocol which uses Net::Ping::External module
+which runs external ping(1) and parses the output.  A version of
+Net::Ping::External is available in CPAN.
 
 =item *
 
-C<POSIX::sigaction()> is now much more flexible and robust.
+POSIX::sigaction() is now much more flexible and robust.
 You can now install coderef handlers, 'DEFAULT', and 'IGNORE'
 handlers, installing new handlers was not atomic.
 
 =item *
 
-C<%INC> now localised in a Safe compartment so that use/require work.
+In Safe the C<%INC> now localised in a Safe compartment so that
+use/require work.
+
+=item *
+
+In SDBM_File on dosish platforms, some keys went missing because of
+lack of support for files with "holes".  A workaround for the problem
+has been added.
+
+=item *
+
+In Search::Dict one can now have a pre-processing hook for the
+lines being searched.
 
 =item *
 
@@ -900,12 +1049,12 @@ The Test module has been significantly enhanced.
 
 =item *
 
-The C<vars> pragma now supports declaring fully qualified variables.
+The vars pragma now supports declaring fully qualified variables.
 (Something that C<our()> does not and will not support.)
 
 =item *
 
-The utf8:: name space (as in the pragma) provides various
+The C<utf8::> name space (as in the pragma) provides various
 Perl-callable functions to provide low level access to Perl's
 internal Unicode representation.  At the moment only length()
 has been implemented.
@@ -963,11 +1112,12 @@ perl.org, not perl.com.
 
 C<perlcc> has been rewritten and its user interface (that is,
 command line) is much more like that of the UNIX C compiler, cc.
+(The perlbc tools has been removed.  Use C<perlcc -B> instead.)
 
 =item *
 
-C<perlivp> is a new utility for doing Installation Verification
-Procedure after installing Perl.
+C<perlivp> is a new Installation Verification Procedure utility
+for running any time after installing Perl.
 
 =item *
 
@@ -1011,9 +1161,6 @@ perldebtut is a Perl debugging tutorial.
 =item *
 
 perlebcdic contains considerations for running Perl on EBCDIC platforms.
-Note that unfortunately EBCDIC platforms that used to be supported back 
-in Perl 5.005 are still unsupported by Perl 5.8.0; the plan, however, is 
-to bring them back to the fold.  
 
 =item *
 
@@ -1033,6 +1180,10 @@ perlnewmod tells about writing and submitting a new module.
 
 =item *
 
+perlpacktut is a pack() tutorial.
+
+=item *
+
 perlpod has been rewritten to be clearer and to record the best
 practices gathered over the years.
 
@@ -1044,11 +1195,6 @@ people writing in pod.
 
 =item *
 
-perlposix-bc explains using Perl on the POSIX-BC platform
-(an EBCDIC mainframe platform).
-
-=item *
-
 perlretut is a regular expression tutorial.
 
 =item *
@@ -1067,8 +1213,9 @@ with perltoot in filesystems restricted to "8.3" names)
 
 =item *
 
-perluniintro is an introduction to using Unicode in Perl
-(perlunicode is more of a reference)
+perluniintro is an introduction to using Unicode in Perl.
+(perlunicode is more of a detailed reference and background
+information)
 
 =item *
 
@@ -1107,7 +1254,9 @@ confusion with the perlwin32 documentation on 8.3-restricted filesystems.
 
 =item *
 
-map() that changes the size of the list should now work faster.
+map() could get pathologically slow when the result list it generates
+is larger than the source list.  The performance has been improved for
+common scenarios.
 
 =item *
 
@@ -1256,6 +1405,11 @@ Configure C<-S> can now run non-interactively.
 
 =item *
 
+Configure support for pdp11-style memory models has been removed due
+to obsolescence.
+
+=item *
+
 configure.gnu now works with options with whitespace in them.
 
 =item *
@@ -1406,6 +1560,10 @@ AtheOS (http://www.atheos.cx/) is a new platform.
 
 =item *
 
+BeOS has been reclaimed.
+
+=item *
+
 DG/UX platform now supports the 5.005-style threads.  See L<perldgux>.
 
 =item *
@@ -1443,6 +1601,11 @@ NCR MP-RAS is now supported.
 
 =item *
 
+All the NetBSD specific patches (except for the installation
+specific ones) have been merged back to the main distribution.
+
+=item *
+
 NetWare from Novell is now supported.  See L<perlnetware>.
 
 =item *
@@ -1451,6 +1614,22 @@ NonStop-UX is now supported.
 
 =item *
 
+NEC SUPER-UX is now supported.
+
+=item *
+
+All the OpenBSD specific patches (except for the installation
+specific ones) have been merged back to the main distribution.
+
+=item *
+
+Perl has been tested with the GNU pth userlevel thread package
+( http://www.gnu.org/software/pth/pth.html ) . All but one thread
+test worked, and that one failure was because of test results arriving
+in unexpected order.
+
+=item *
+
 Amdahl UTS UNIX mainframe platform is now supported.
 
 =item *
@@ -1479,6 +1658,11 @@ The autouse pragma didn't work for Multi::Part::Function::Names.
 
 =item *
 
+caller() could cause core dumps in certain situations.  Carp was sometimes
+affected by this problem.
+
+=item *
+
 chop(@list) in list context returned the characters chopped in
 reverse order.  This has been reversed to be in the right order.
 
@@ -1505,8 +1689,13 @@ The order of DESTROYs has been made more predictable.
 
 Several debugger fixes: exit code now reflects the script exit code,
 condition C<"0"> now treated correctly, the C<d> command now checks
-line number, the C<$.> no longer gets corrupted, all debugger output now
-goes correctly to the socket if RemotePort is set.
+line number, the C<$.> no longer gets corrupted, all debugger output
+now goes correctly to the socket if RemotePort is set.
+
+=item *
+
+Perl 5.6.0 could emit spurious warnings about redefinition of dl_error()
+when statically building extensions into perl.  This has been corrected.
 
 =item *
 
@@ -1515,6 +1704,9 @@ L<dprofpp> -R didn't work.
 =item *
 
 C<*foo{FORMAT}> now works.
+=item *
+
+Infinity is now recognized as a number.
 
 =item *
 
@@ -1534,7 +1726,18 @@ were declared before the lexicals.
 
 =item *
 
-Lexical warnings now propagating correctly between scopes.
+Lexical warnings now propagating correctly between scopes
+and into C<eval "...">.
+
+=item *
+
+C<use warnings qw(FATAL all)> did not work as intended.  This has been
+corrected.
+
+=item *
+
+warnings::enabled() now reports the state of $^W correctly if the caller
+isn't using lexical warnings.
 
 =item *
 
@@ -1568,6 +1771,11 @@ more compatible with 5.005.  Infinity is now recognised as a number.
 
 =item *
 
+Numeric conversions did not recognize changes in the string value
+properly in certain circumstances.
+
+=item *
+
 Attributes (like :shared) didn't work with our().
 
 =item *
@@ -1576,6 +1784,12 @@ our() variables will not cause "will not stay shared" warnings.
 
 =item *
 
+"our" variables of the same name declared in two sibling blocks
+resulted in bogus warnings about "redeclaration" of the variables.
+The problem has been corrected.
+
+=item *
+
 pack "Z" now correctly terminates the string with "\0".
 
 =item *
@@ -1598,7 +1812,12 @@ printf() no longer resets the numeric locale to "C".
 
 =item *
 
-C<q(a\\b)> now parses correctly as C<'a\\b'>.
+C<qw(a\\b)> now parses correctly as C<'a\\b'>.
+
+=item *
+
+pos() did not return the correct value within s///ge in earlier
+versions.  This is now handled correctly.
 
 =item *
 
@@ -1626,6 +1845,8 @@ SOCKS support is now much more robust.
 
 sort() arguments are now compiled in the right wantarray context
 (they were accidentally using the context of the sort() itself).
+The comparison block is now run in scalar context, and the arguments
+to be sorted are always provided list context.
 
 =item *
 
@@ -1642,13 +1863,49 @@ behaviour consistent with that of string interpolation.
 
 =item *
 
+Some cases of inconsistent taint propagation (such as within hash
+values) have been fixed.
+
+=item *
+
+The RE engine found in Perl 5.6.0 accidentally pessimised certain kinds
+of simple pattern matches.  These are now handled better.
+
+=item *
+
+Regular expression debug output (whether through C<use re 'debug'>
+or via C<-Dr>) now looks better.
+
+=item *
+
+Multi-line matches like C<"a\nxb\n" =~ /(?!\A)x/m> were flawed.  The
+bug has been fixed.
+
+=item *
+
+Use of $& could trigger a core dump under some situations.  This
+is now avoided.
+
+=item *
+
 The regular expression captured submatches ($1, $2, ...) are now
 more consistently unset if the match fails, instead of leaving false
 data lying around in them.
 
 =item *
 
-C<Sys::Syslog> ignored the C<LOG_AUTH> constant.
+readline() on files opened in "slurp" mode could return an extra "" at
+the end in certain situations.  This has been corrected.
+
+=item *
+
+Autovivification of symbolic references of special variables described
+in L<perlvar> (as in C<${$num}>) was accidentally disabled.  This works
+again now.
+
+=item *
+
+Sys::Syslog ignored the C<LOG_AUTH> constant.
 
 =item *
 
@@ -1686,7 +1943,14 @@ The character tables have been updated to Unicode 3.1.1.
 =item *
 
 Comparing with utf8 data does not magically upgrade non-utf8 data
-into utf8.
+into utf8.  (This was a problem for example if you were mixing data
+from I/O and Unicode data: your output might have got magically encoded
+as UTF-8.)
+
+=item *
+
+Generating illegal Unicode code points like U+FFFE, or the UTF-16
+surrogates, now also generates an optional warning.
 
 =item *
 
@@ -1709,10 +1973,20 @@ C<eval "v200"> now works.
 
 =item *
 
+Perl 5.6.0 parsed m/\x{ab}/ incorrectly, leading to spurious warnings.
+This has been corrected.
+
+=item *
+
 Zero entries were missing from the Unicode classes like C<IsDigit>.
 
 =back
 
+=item *
+
+Large unsigned numbers (those above 2**31) could sometimes lose their
+unsignedness, causing bogus results in arithmetic operations.
+
 =back
 
 =head2 Platform Specific Changes and Fixes
@@ -1841,6 +2115,20 @@ VMS
 chdir() now works better despite a CRT bug; now works with MULTIPLICITY
 (see INSTALL); now works with Perl's malloc.
 
+The tainting of C<%ENV> elements via C<keys> or C<values> was previously
+unimplemented.  It now works as documented.
+
+The C<waitpid> emulation has been improved.  The worst bug (now fixed)
+was that a pid of -1 would cause a wildcard search of all processes on
+the system.  The most significant enhancement is that we can now
+usually get the completion status of a terminated process.
+
+POSIX-style signals are now emulated much better on VMS versions prior
+to 7.0.
+
+The C<system> function and backticks operator have improved
+functionality and better error handling.
+
 =item *
 
 Windows
@@ -1871,12 +2159,17 @@ New %ENV entries now propagate to subprocesses.
 
 =item *
 
+Current directory entries in %ENV are now correctly propagated to child
+processes.
+
+=item *
+
 $ENV{LIB} now used to search for libs under Visual C.
 
 =item *
 
-Win32::GetCwd() correctly returns C:\ instead of C: when at the drive root.
-Other bugs in chdir() and Cwd::cwd() have also been fixed.
+fork() emulation has been improved in various ways, but still continues
+to be experimental.  See L<perlfork> for known bugs and caveats.
 
 =item *
 
@@ -1884,6 +2177,11 @@ A failed (pseudo)fork now returns undef and sets errno to EAGAIN.
 
 =item *
 
+Win32::GetCwd() correctly returns C:\ instead of C: when at the drive root.
+Other bugs in chdir() and Cwd::cwd() have also been fixed.
+
+=item *
+
 HTML files will be installed in c:\perl\html instead of c:\perl\lib\pod\html
 
 =item *
@@ -1905,6 +2203,11 @@ Fake signal handling reenabled, bugs and all.
 
 =item *
 
+%SIG has been enabled under USE_ITHREADS, but its use is completely
+unsupported under all configurations.
+
+=item *
+
 Less stack reserved per thread so that more threads can run
 concurrently. (Still 16M per thread.)
 
@@ -1919,7 +2222,8 @@ Better UNC path handling under ithreads.
 
 =item *
 
-wait() and waitpid() now work much better.
+wait(), waitpid() and backticks now return the correct exit status under
+Windows 9x.
 
 =item *
 
@@ -2018,7 +2322,8 @@ Made possible to propagate customised exceptions via croak()ing.
 
 =item *
 
-Now xsubs can have attributes just like subs.
+Now xsubs can have attributes just like subs.  (Well, at least the
+built-in attributes.)
 
 =item *
 
@@ -2097,7 +2402,18 @@ such as sudo (see http://www.courtesan.com/sudo/).
 
 =head1 New Tests
 
-Several new tests have been added, especially for the F<lib> subsection.
+Several new tests have been added, especially for the F<lib>
+subsection.  There are now about 34 000 individual tests (spread over
+about 530 test scripts), in the regression suite (5.6.1 has about
+11700 tests, in 258 test scripts) Many of the new tests are introduced
+by the new modules, but still in general Perl is now more thoroughly
+tested.
+
+Because of the large number of tests, running the regression suite
+will take considerably longer time than it used to: expect the suite
+to take up to 4-5 times longer to run than in perl 5.6.  In a really
+fast machine you can hope to finish the suite in about 5 minutes
+(wallclock time).
 
 The tests are now reported in a different order than in earlier Perls.
 (This happens because the test scripts from under t/lib have been moved
@@ -2105,10 +2421,6 @@ to be closer to the library/extension they are testing.)
 
 =head1 Known Problems
 
-Note that unlike other sections in this document (which describe
-changes since 5.7.0) this section is cumulative containing known
-problems for all the 5.7 releases.
-
 =head2 AIX
 
 =over 4
@@ -2168,6 +2480,17 @@ subtest 9 failed.
 
 No known fix.
 
+=head2 Mac OS X
+
+The following tests are known to fail:
+
+ Failed Test                 Stat Wstat Total Fail  Failed  List of Failed
+ -------------------------------------------------------------------------
+ ../ext/DB_File/t/db-btree.t    0    11    ??   ??       %  ??
+ ../ext/DB_File/t/db-recno.t              149    3   2.01%  61 63 65
+ ../ext/POSIX/t/posix.t                    31    1   3.23%  10
+ ../lib/warnings.t                        450    1   0.22%  316
+
 =head2 OS/390
 
 OS/390 has rather many test failures but the situation is actually
@@ -2207,14 +2530,18 @@ the printf format "%.0f", most often they produce "0" and "-0".)
 
 =head2  Failure of Thread tests
 
-B<Note that support for 5.005-style threading remains experimental.>
+B<Note that support for 5.005-style threading remains experimental
+and practically unsupported.>
 
 The following tests are known to fail due to fundamental problems in
 the 5.005 threading implementation. These are not new failures--Perl
 5.005_0x has the same bugs, but didn't have these tests.
 
-  lib/autouse.t                 4
-  t/lib/thr5005.t               19-20
+  ext/List/Util/t/first         2
+  lib/autouse                   4
+  ext/Thread/thr5005            19-20
+
+These failures are unlikely to get fixed.
 
 =head2 UNICOS
 
@@ -2249,42 +2576,9 @@ There are a few known test failures, see L<perluts>.
 
 =head2 VMS
 
-Rather a lot of tests are failing in VMS, but actually more tests
-succeed in VMS than they used to; it's just that there are many,
-many more tests than there used to be.
-
-Here are the known failures from some compiler/platform combinations.
-
-DEC C V5.3-006 on OpenVMS VAX V6.2
-
-  [-.ext.list.util.t]tainted..............FAILED on test 3
-  [-.ext.posix]sigaction..................FAILED on test 7
-  [-.ext.time.hires]hires.................FAILED on test 14
-  [-.lib.file.find]taint..................FAILED on test 17
-  [-.lib.math.bigint.t]bigintpm...........FAILED on test 1183
-  [-.lib.test.simple.t]exit...............FAILED on test 1
-  [.lib]vmsish............................FAILED on test 13
-  [.op]sprintf............................FAILED on test 12
-  Failed 8/399 tests, 91.23% okay.
+There is one known test failure with a default configuration:
 
-DEC C V6.0-001 on OpenVMS Alpha V7.2-1 and
-Compaq C V6.2-008 on OpenVMS Alpha V7.1
-
-  [-.ext.list.util.t]tainted..............FAILED on test 3 
-  [-.lib.file.find]taint..................FAILED on test 17
-  [-.lib.test.simple.t]exit...............FAILED on test 1
-  [.lib]vmsish............................FAILED on test 13
-  Failed 4/399 tests, 92.48% okay.
-
-Compaq C V6.4-005 on OpenVMS Alpha 7.2.1
-
-  [-.ext.b]showlex........................FAILED on test 1
-  [-.ext.list.util.t]tainted..............FAILED on test 3
-  [-.lib.file.find]taint..................FAILED on test 17 
-  [-.lib.test.simple.t]exit...............FAILED on test 1
-  [.lib]vmsish............................FAILED on test 13
-  [.op]misc...............................FAILED on test 49
-  Failed 6/401 tests, 92.77% okay.
+  [.run]switches..........................FAILED on test 1
 
 =head2 Win32
 
@@ -2303,6 +2597,13 @@ some output may appear twice.
 Code like the above is known to leak memory every time the local()
 is executed.
 
+=head2 Localising Tied Arrays and Hashes Is Broken
+
+    local %tied_array;
+
+doesn't work as one would expect: the old value is restored
+incorrectly.
+
 =head2 Self-tying of Arrays and Hashes Is Forbidden
 
 Self-tying of arrays and hashes is broken in rather deep and
@@ -2310,11 +2611,6 @@ hard-to-fix ways.  As a stop-gap measure to avoid people from getting
 frustrated at the mysterious results (core dumps, most often) it is
 for now forbidden (you will get a fatal error even from an attempt).
 
-=head2 Variable Attributes are not Currently Usable for Tieing
-
-This limitation will hopefully be fixed in future.  (Subroutine
-attributes work fine for tieing, see L<Attribute::Handlers>).
-
 =head2 Building Extensions Can Fail Because Of Largefiles
 
 Some extensions like mod_perl are known to have issues with
@@ -2331,12 +2627,19 @@ one can (or, if one can, whether it's a good idea) link together at
 all binaries with different ideas about file offsets, all this is
 platform-dependent.
 
+=head2 Unicode Support on EBCDIC Still Spotty
+
+Though mostly working, Unicode support still has problem spots on
+EBCDIC platforms.  One such known spot are the C<\p{}> and C<\P{}>
+regular expression constructs for code points less than 256: the
+pP are testing for Unicode code points, not knowing about EBCDIC.
+
 =head2 The Compiler Suite Is Still Experimental
 
-The compiler suite is slowly getting better but is nowhere near
-working order yet.
+The compiler suite is slowly getting better but it continues to be
+highly experimental.  Use in production environments is discouraged.
 
-=head2 The Long Double Support is Still Experimental
+=head2 The Long Double Support Is Still Experimental
 
 The ability to configure Perl's numbers to use "long doubles",
 floating point numbers of hopefully better accuracy, is still
@@ -2348,12 +2651,19 @@ by slowdown in computations (more bits to move around, and the
 operations are more likely to be executed by less optimised
 libraries).
 
+=head2 Seen In Perl 5.7 But Gone Now
+
+C<Time::Piece> (previously known as C<Time::Object>) was removed
+because it was felt that it didn't have enough value in it to be a
+core module.  It is still a useful module, though, and is available
+from the CPAN.
+
 =head1 Reporting Bugs
 
 If you find what you think is a bug, you might check the articles
 recently posted to the comp.lang.perl.misc newsgroup and the perl
 bug database at http://bugs.perl.org.  There may also be
-information at http://www.perl.com/perl/, the Perl Home Page.
+information at http://www.perl.com/, the Perl Home Page.
 
 If you believe you have an unreported bug, please run the B<perlbug>
 program included with your release.  Be sure to trim your bug down