Few uncheckedin files.
[p5sagit/p5-mst-13.2.git] / pod / perldelta.pod
index b1b44ee..8ea61b3 100644 (file)
@@ -11,17 +11,17 @@ the 5.7.0 release.
 
 A potential security vulnerability in the optional suidperl component
 of Perl has been identified.  suidperl is neither built nor installed
-by default.  As of August the 20th, 2000, the only known vulnerable
+by default.  As of September the 2nd, 2000, the only known vulnerable
 platform is Linux, most likely all Linux distributions.  CERT and
 various vendors have been alerted about the vulnerability.
 
 The problem was caused by Perl trying to report a suspected security
 exploit attempt using an external program, /bin/mail.  On Linux
-platforms the /bin/mail program had an undocumented feature which gave
-access to a root shell, resulting in a serious compromise instead of
-reporting the exploit attempt.  If you don't have /bin/mail, or if you
-have 'safe setuid scripts', or if suidperl is not installed, you
-are safe.
+platforms the /bin/mail program had an undocumented feature which
+when combined with suidperl gave access to a root shell, resulting in
+a serious compromise instead of reporting the exploit attempt.  If you
+don't have /bin/mail, or if you have 'safe setuid scripts', or if
+suidperl is not installed, you are safe.
 
 The exploit attempt reporting feature has been completely removed from
 the Perl 5.7.0 release, so that particular vulnerability isn't there
@@ -50,6 +50,12 @@ it to make some sense, it is forbidden.
 
 =item *
 
+A reference to a reference now stringify as "REF(0x81485ec)" instead
+of "SCALAR(0x81485ec)" in order to be more consistent with the return
+value of ref().
+
+=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)
@@ -69,6 +75,12 @@ since it, in a way, falsely promised that the features could be used.
 
 =item *
 
+The (bogus) escape sequences \8 and \9 now give an optional warning
+("Unrecognized escape passed through").  There is no need to \-escape
+any C<\w> character.
+
+=item *
+
 lstat(FILEHANDLE) now gives a warning because the operation makes no sense.
 In future releases this may become a fatal error.
 
@@ -97,6 +109,10 @@ functionality, see pack('U0', ...) and pack('C0', ...).
 
 =item *
 
+Formats now support zero-padded decimal fields.
+
+=item *
+
 C<perl -d:Module=arg,arg,arg> now works (previously one couldn't pass
 in multiple arguments.)
 
@@ -119,6 +135,11 @@ C<pack('U0a*', ...)> can now be used to force a string to UTF8.
 
 =item *
 
+The printf and sprintf now support parameter reordering using the
+C<%\d+\$> and C<*\d+\$> syntaxes.
+
+=item *
+
 prototype(\&) is now available.
 
 =item *
@@ -180,7 +201,7 @@ hit by saying
        use English '-no_performance_hit';
 
 (Assuming, of course, that one doesn't need the troublesome variables
-C<$`>, C<$&>, or C<$'>.)  Also, introduce C<@LAST_MATCH_START> and
+C<$`>, C<$&>, or C<$'>.)  Also, introduced C<@LAST_MATCH_START> and
 C<@LAST_MATCH_END> English aliases for C<@-> and C<@+>.
 
 =item *
@@ -211,8 +232,6 @@ C<%INC> now localised in a Safe compartment so that use/require work.
 
 The Shell module now has an OO interface.
 
-=item *
-
 =back
 
 =head1 Utility Changes
@@ -221,12 +240,13 @@ The Shell module now has an OO interface.
 
 =item *
 
-The Emacs perl mode (emacs/cperl-mode.el) has been updated to version 4.31.
+The Emacs perl mode (emacs/cperl-mode.el) has been updated to version
+4.31.
 
 =item *
 
-Perlbug is now much more robust.  It also sends the bug report to perl.org,
-not perl.com.
+Perlbug is now much more robust.  It also sends the bug report to
+perl.org, not perl.com.
 
 =item *
 
@@ -297,12 +317,12 @@ map() that changes the size of the list should now work faster.
  
 sort() has been changed to use mergesort internally as opposed to the
 earlier quicksort.  For very small lists this may result in slightly
-slower sorting times, but in general the speedup should be at least 20%.
-Additional bonuses are that the worst case behaviour of sort() is now
-better (in computer science terms it now runs in time O(N log N), as
-opposed to quicksorts Theta(N**2) worst-case run time behaviour), and
-that sort() is now stable (meaning that elements with identical keys
-will stay ordered as they were before the sort).
+slower sorting times, but in general the speedup should be at least
+20%.  Additional bonuses are that the worst case behaviour of sort()
+is now better (in computer science terms it now runs in time O(N log N),
+as opposed to quicksort's Theta(N**2) worst-case run time behaviour),
+and that sort() is now stable (meaning that elements with identical
+keys will stay ordered as they were before the sort).
 
 =back
 
@@ -314,13 +334,13 @@ will stay ordered as they were before the sort).
 
 =item *
 
-INSTALL now explains how you can configure perl to use 64-bit
+INSTALL now explains how you can configure Perl to use 64-bit
 integers even on non-64-bit platforms.
 
 =item *
 
-Policy.sh policy change: if you are reusing a Policy.sh file (see
-INSTALL) and you use Configure -Dprefix=/foo/bar and in the old
+Policy.sh policy change: if you are reusing a Policy.sh file
+(see INSTALL) and you use Configure -Dprefix=/foo/bar and in the old
 Policy $prefix eq $siteprefix and $prefix eq $vendorprefix, all of
 them will now be changed to the new prefix, /foo/bar.  (Previously
 only $prefix changed.)  If you do not like this new behaviour,
@@ -369,6 +389,12 @@ $Config{byteorder} is now computed dynamically (this is more robust
 with "fat binaries" where an executable image contains binaries for
 more than one binary platform.)
 
+=item *
+
+Configure no longer included the DBM libraries (dbm, gdbm, db, ndbm)
+when building the Perl binary. The only exception to this is SunOS 4.x,
+which needs them.
+
 =back
 
 =head1 Selected Bug Fixes
@@ -473,7 +499,7 @@ Several Unicode fixes (but still not perfect).
 
 BOMs (byte order marks) in the beginning of Perl files
 (scripts, modules) should now be transparently skipped.
-UTF16 encoded Perl files should now be read correctly.
+UTF-16 (UCS-2)encoded Perl files should now be read correctly.
 
 =item *
 
@@ -508,7 +534,9 @@ see pack('U0', ...)).
 
 =item *
 
-vec() now refuses to deal with characters >255.
+vec() now tries to work with characters <= 255 when possible, but it leaves
+higher character values in place.  In that case, if vec() was used to modify
+the string, it is no longer considered to be utf8-encoded.
 
 =item *
 
@@ -675,12 +703,12 @@ Fake signal handling reenabled, bugs and all.
 =item *
 
 Less stack reserved per thread so that more threads can run
-concurrently. (still 16M perl thread)
+concurrently. (Still 16M per thread.)
 
 =item *
 
 C<File::Spec->tmpdir()> now prefers C:/temp over /tmp
-(works better when perl running as service).
+(works better when perl is running as service).
 
 =item *
 
@@ -696,6 +724,8 @@ winsock handle leak fixed.
 
 =back
 
+=back
+
 =head1 New or Changed Diagnostics
 
 All regular expression compilation error messages are now hopefully
@@ -725,8 +755,8 @@ You can now build a really minimal perl called microperl.
 Building microperl does not require even running Configure;
 C<make -f Makefile.micro> should be enough.  Beware: microperl makes
 many assumptions, some of which may be too bold; the resulting
-executable may crash or otherwise misbehave in wondrous ways.  For
-careful hackers only.
+executable may crash or otherwise misbehave in wondrous ways.
+For careful hackers only.
 
 =item *
 
@@ -793,6 +823,15 @@ this area.)
 
 No known fix.
 
+=head2 sprintf tests 129 and 130
+
+The op/sprintf tests 129 and 130 are known to fail in some platforms.
+Examples include any platform using sfio, and Tandem's NonStop-UX.
+The failing platforms do not comply with the ANSI C Standard, line
+19ff on page 134 of ANSI X3.159 1989 to be exact.  (They produce
+something else than "1" and "-1" when formatting 0.6 and -0.6 using
+the printf format "%.0f", most often they produce "0" and "-0".)
+
 =head2 Storable tests fail in some platforms
 
 If any Storable tests fail the use of Storable is not advisable.
@@ -822,6 +861,8 @@ made in other platforms.
 
 st-store.t and st-retrieve may fail with Compaq C 6.2 on OpenVMS Alpha 7.2.
 
+=back
+
 =head2 Threads Are Still Experimental
 
 Multithreading is still an experimental feature.  Some platforms
@@ -833,7 +874,7 @@ emit the following message for lib/thr5005
     # from deploying threads in production. ;-)
     #
  
-and another known warning is
+and another known thread-related warning is
 
    pragma/overload......Unbalanced saves: 3 more saves than restores
    panic: magic_mutexfree during global destruction.
@@ -847,11 +888,9 @@ and another known warning is
 
 =head2 The Compiler Suite Is Still Experimental
 
-The compiler suite is slowly getting better but is nowhere near yet.
-The backend part that has seen perhaps the most progress is the
-bytecode compiler.
-
-=back
+The compiler suite is slowly getting better but is nowhere near
+working order yet.  The backend part that has seen perhaps the most
+progress is the bytecode compiler.
 
 =head1 Reporting Bugs