Create perldelta for 5.14.3
[perl.git] / pod / perl583delta.pod
1 =head1 NAME
2
3 perl583delta - what is new for perl v5.8.3
4
5 =head1 DESCRIPTION
6
7 This document describes differences between the 5.8.2 release and
8 the 5.8.3 release.
9
10 If you are upgrading from an earlier release such as 5.6.1, first read
11 the L<perl58delta>, which describes differences between 5.6.0 and
12 5.8.0, and the L<perl581delta> and L<perl582delta>, which describe differences
13 between 5.8.0, 5.8.1 and 5.8.2
14
15 =head1 Incompatible Changes
16
17 There are no changes incompatible with 5.8.2.
18
19 =head1 Core Enhancements
20
21 A C<SCALAR> method is now available for tied hashes. This is called when
22 a tied hash is used in scalar context, such as
23
24     if (%tied_hash) {
25         ...
26     }
27
28
29 The old behaviour was that %tied_hash would return whatever would have been
30 returned for that hash before the hash was tied (so usually 0). The new
31 behaviour in the absence of a SCALAR method is to return TRUE if in the
32 middle of an C<each> iteration, and otherwise call FIRSTKEY to check if the
33 hash is empty (making sure that a subsequent C<each> will also begin by
34 calling FIRSTKEY). Please see L<perltie/SCALAR> for the full details and
35 caveats.
36
37 =head1 Modules and Pragmata
38
39 =over 4
40
41 =item CGI
42
43 =item Cwd
44
45 =item Digest
46
47 =item Digest::MD5
48
49 =item Encode
50
51 =item File::Spec
52
53 =item FindBin
54
55 A function C<again> is provided to resolve problems where modules in different
56 directories wish to use FindBin.
57
58 =item List::Util
59
60 You can now weaken references to read only values.
61
62 =item Math::BigInt
63
64 =item PodParser
65
66 =item Pod::Perldoc
67
68 =item POSIX
69
70 =item Unicode::Collate
71
72 =item Unicode::Normalize
73
74 =item Test::Harness
75
76 =item threads::shared
77
78 C<cond_wait> has a new two argument form. C<cond_timedwait> has been added.
79
80 =back
81
82 =head1 Utility Changes
83
84 C<find2perl> now assumes C<-print> as a default action. Previously, it
85 needed to be specified explicitly.
86
87 A new utility, C<prove>, makes it easy to run an individual regression test
88 at the command line. C<prove> is part of Test::Harness, which users of earlier
89 Perl versions can install from CPAN.
90
91 =head1 New Documentation
92
93 The documentation has been revised in places to produce more standard manpages.
94
95 The documentation for the special code blocks (BEGIN, CHECK, INIT, END)
96 has been improved.
97
98 =head1 Installation and Configuration Improvements
99
100 Perl now builds on OpenVMS I64
101
102 =head1 Selected Bug Fixes
103
104 Using substr() on a UTF8 string could cause subsequent accesses on that
105 string to return garbage. This was due to incorrect UTF8 offsets being
106 cached, and is now fixed.
107
108 join() could return garbage when the same join() statement was used to
109 process 8 bit data having earlier processed UTF8 data, due to the flags
110 on that statement's temporary workspace not being reset correctly. This
111 is now fixed.
112
113 C<$a .. $b> will now work as expected when either $a or $b is C<undef>
114
115 Using Unicode keys with tied hashes should now work correctly.
116
117 Reading $^E now preserves $!. Previously, the C code implementing $^E
118 did not preserve C<errno>, so reading $^E could cause C<errno> and therefore
119 C<$!> to change unexpectedly.
120
121 Reentrant functions will (once more) work with C++. 5.8.2 introduced a bugfix
122 which accidentally broke the compilation of Perl extensions written in C++
123
124 =head1 New or Changed Diagnostics
125
126 The fatal error "DESTROY created new reference to dead object" is now
127 documented in L<perldiag>.
128
129 =head1 Changed Internals
130
131 The hash code has been refactored to reduce source duplication. The
132 external interface is unchanged, and aside from the bug fixes described
133 above, there should be no change in behaviour.
134
135 C<hv_clear_placeholders> is now part of the perl API
136
137 Some C macros have been tidied. In particular macros which create temporary
138 local variables now name these variables more defensively, which should
139 avoid bugs where names clash.
140
141 <signal.h> is now always included.
142
143 =head1 Configuration and Building
144
145 C<Configure> now invokes callbacks regardless of the value of the variable
146 they are called for. Previously callbacks were only invoked in the
147 C<case $variable $define)> branch. This change should only affect platform
148 maintainers writing configuration hints files.
149
150 =head1 Platform Specific Problems
151
152 The regression test ext/threads/shared/t/wait.t fails on early RedHat 9
153 and HP-UX 10.20 due to bugs in their threading implementations.
154 RedHat users should see https://rhn.redhat.com/errata/RHBA-2003-136.html
155 and consider upgrading their glibc.
156
157 =head1 Known Problems
158
159 Detached threads aren't supported on Windows yet, as they may lead to 
160 memory access violation problems.
161
162 There is a known race condition opening scripts in C<suidperl>. C<suidperl>
163 is neither built nor installed by default, and has been deprecated since
164 perl 5.8.0. You are advised to replace use of suidperl with tools such
165 as sudo ( http://www.courtesan.com/sudo/ )
166
167 We have a backlog of unresolved bugs. Dealing with bugs and bug reports
168 is unglamorous work; not something ideally suited to volunteer labour,
169 but that is all that we have.
170
171 The perl5 development team are implementing changes to help address this
172 problem, which should go live in early 2004.
173
174 =head1 Future Directions
175
176 Code freeze for the next maintenance release (5.8.4) is on March 31st 2004,
177 with release expected by mid April. Similarly 5.8.5's freeze will be at
178 the end of June, with release by mid July.
179
180 =head1 Obituary
181
182 Iain 'Spoon' Truskett, Perl hacker, author of L<perlreref> and
183 contributor to CPAN, died suddenly on 29th December 2003, aged 24.
184 He will be missed.
185
186 =head1 Reporting Bugs
187
188 If you find what you think is a bug, you might check the articles
189 recently posted to the comp.lang.perl.misc newsgroup and the perl
190 bug database at http://bugs.perl.org.  There may also be
191 information at http://www.perl.org, the Perl Home Page.
192
193 If you believe you have an unreported bug, please run the B<perlbug>
194 program included with your release.  Be sure to trim your bug down
195 to a tiny but sufficient test case.  Your bug report, along with the
196 output of C<perl -V>, will be sent off to perlbug@perl.org to be
197 analysed by the Perl porting team.  You can browse and search
198 the Perl 5 bugs at http://bugs.perl.org/
199
200 =head1 SEE ALSO
201
202 The F<Changes> file for exhaustive details on what changed.
203
204 The F<INSTALL> file for how to build Perl.
205
206 The F<README> file for general stuff.
207
208 The F<Artistic> and F<Copying> files for copyright information.
209
210 =cut