From dc0b0fbe832042d0257c19b9bf9d672fd2b0b31a Mon Sep 17 00:00:00 2001 From: Nicholas Clark Date: Wed, 14 Jan 2004 19:28:54 +0000 Subject: [PATCH 1/1] Integrate: [ 22143] We're planning on making history today. Mind you, not that much - only 1 line. perl583delta.pod p4raw-link: @22143 on //depot/maint-5.8/perl: f8c9a4ed5b8ced3f23c496610dbc509ed17b49fe p4raw-id: //depot/perl@22153 p4raw-branched: from //depot/maint-5.8/perl@22150 'branch in' pod/perl583delta.pod p4raw-integrated: from //depot/maint-5.8/perl@22150 'copy in' pod/perlhist.pod (@22098..) --- MANIFEST | 1 + pod/perl583delta.pod | 210 +++++++++++++++++++++++++++++++++++++++++++++++++++ pod/perlhist.pod | 1 + 3 files changed, 212 insertions(+) create mode 100644 pod/perl583delta.pod diff --git a/MANIFEST b/MANIFEST index 5c05d99..9cf896a 100644 --- a/MANIFEST +++ b/MANIFEST @@ -2348,6 +2348,7 @@ pod/perl572delta.pod Perl changes in version 5.7.2 pod/perl573delta.pod Perl changes in version 5.7.3 pod/perl581delta.pod Perl changes in version 5.8.1 pod/perl582delta.pod Perl changes in version 5.8.2 +pod/perl583delta.pod Perl changes in version 5.8.3 pod/perl58delta.pod Perl changes in version 5.8.0 pod/perlapio.pod Perl internal IO abstraction interface pod/perlapi.pod Perl API listing (autogenerated) diff --git a/pod/perl583delta.pod b/pod/perl583delta.pod new file mode 100644 index 0000000..2967647 --- /dev/null +++ b/pod/perl583delta.pod @@ -0,0 +1,210 @@ +=head1 NAME + +perldelta - what is new for perl v5.8.3 + +=head1 DESCRIPTION + +This document describes differences between the 5.8.2 release and +the 5.8.3 release. + +If you are upgrading from an earlier release such as 5.6.1, first read +the L, which describes differences between 5.6.0 and +5.8.0, and the L and L, which describe differences +between 5.8.0, 5.8.1 and 5.8.2 + +=head1 Incompatible Changes + +There are no changes incompatible with 5.8.2. + +=head1 Core Enhancements + +A C method is now available for tied hashes. This is called when +a tied hash is used in scalar context, such as + + if (%tied_hash) { + ... + } + + +The old behaviour was that %tied_hash would return whatever would have been +returned for that hash before the hash was tied (so usually 0). The new +behaviour in the absence of a SCALAR method is to return TRUE if in the +middle of an C iteration, and otherwise call FIRSTKEY to check if the +hash is empty (making sure that a subsequent C will also begin by +calling FIRSTKEY). Please see L for the full details and +caveats. + +=head1 Modules and Pragmata + +=over 4 + +=item CGI + +=item Cwd + +=item Digest + +=item Digest::MD5 + +=item Encode + +=item File::Spec + +=item FindBin + +A function C is provided to resolve problems where modules in different +directories wish to use FindBin. + +=item List::Util + +You can now weaken references to read only values. + +=item Math::BigInt + +=item PodParser + +=item Pod::Perldoc + +=item POSIX + +=item Unicode::Collate + +=item Unicode::Normalize + +=item Test::Harness + +=item threads::shared + +C has a new two argument form. C has been added. + +=back + +=head1 Utility Changes + +C now assumes C<-print> as a default action. Previously, it +needed to be specified explicitly. + +A new utility, C, makes it easy to run an individual regression test +at the command line. C is part of Test::Harness, which users of earlier +Perl versions can install from CPAN. + +=head1 New Documentation + +The documentation has been revised in places to produce more standard manpages. + +The documentation for the special code blocks (BEGIN, CHECK, INIT, END) +has been improved. + +=head1 Installation and Configuration Improvements + +Perl now builds on OpenVMS I64 + +=head1 Selected Bug Fixes + +Using substr() on a UTF8 string could cause subsequent accesses on that +string to return garbage. This was due to incorrect UTF8 offsets being +cached, and is now fixed. + +join() could return garbage when the same join() statement was used to +process 8 bit data having earlier processed UTF8 data, due to the flags +on that statement's temporary workspace not being reset correctly. This +is now fixed. + +C<$a .. $b> will now work as expected when either $a or $b is C + +Using Unicode keys with tied hashes should now work correctly. + +Reading $^E now preserves $!. Previously, the C code implementing $^E +did not preserve C, so reading $^E could cause C and therefore +C<$!> to change unexpectedly. + +Reentrant functions will (once more) work with C++. 5.8.2 introduced a bugfix +which accidentally broke the compilation of Perl extensions written in C++ + +=head1 New or Changed Diagnostics + +The fatal error "DESTROY created new reference to dead object" is now +documented in L. + +=head1 Changed Internals + +The hash code has been refactored to reduce source duplication. The +external interface is unchanged, and aside from the bug fixes described +above, there should be no change in behaviour. + +C is now part of the perl API + +Some C macros have been tidied. In particular macros which create temporary +local variables now name these variables more defensively, which should +avoid bugs where names clash. + + is now always included. + +=head1 Configuration and Building + +C now invokes callbacks regardless of the value of the variable +they are called for. Previously callbacks were only invoked in the +C branch. This change should only affect platform +maintainers writing configuration hints files. + +=head1 Platform Specific Problems + +The regression test ext/threads/shared/t/wait.t fails on early RedHat 9 +and HP-UX 10.20 due to bugs in their threading implementations. +RedHat users should see https://rhn.redhat.com/errata/RHBA-2003-136.html +and consider upgrading their glibc. + +=head1 Known Problems + +Detached threads aren't supported on Windows yet, as they may lead to +memory access violation problems. + +There is a known race condition opening scripts in C. C +is neither built nor installed by default, and has been deprecated since +perl 5.8.0. You are advised to replace use of suidperl with tools such +as sudo ( http://www.courtesan.com/sudo/ ) + +We have a backlog of unresolved bugs. Dealing with bugs and bug reports +is unglamorous work; not something ideally suited to volunteer labour, +but that is all that we have. + +The perl5 development team are implementing changes to help address this +problem, which should go live in early 2004. + +=head1 Future Directions + +Code freeze for the next maintenance release (5.8.4) is on March 31st 2004, +with release expected by mid April. Similarly 5.8.5's freeze will be at +the end of June, with release by mid July. + +=head1 Obituary + +Iain 'Spoon' Truskett, Perl hacker, author of and +contributor to CPAN, died suddenly on 29th December 2003, aged 24. +He will be missed. + +=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.org, the Perl Home Page. + +If you believe you have an unreported bug, please run the B +program included with your release. Be sure to trim your bug down +to a tiny but sufficient test case. Your bug report, along with the +output of C, will be sent off to perlbug@perl.org to be +analysed by the Perl porting team. You can browse and search +the Perl 5 bugs at http://bugs.perl.org/ + +=head1 SEE ALSO + +The F file for exhaustive details on what changed. + +The F file for how to build Perl. + +The F file for general stuff. + +The F and F files for copyright information. + +=cut diff --git a/pod/perlhist.pod b/pod/perlhist.pod index ac31143..a114e49 100644 --- a/pod/perlhist.pod +++ b/pod/perlhist.pod @@ -369,6 +369,7 @@ the strings?). 5.8.2-RC2 2003-Nov-03 5.8.2 2003-Nov-05 5.8.3-RC1 2004-Jan-07 + 5.8.3 2004-Jan-14 Hugo 5.9.0 2003-Oct-27 -- 1.8.3.1