Debian Codegraph @

upstream/debian-unstable/man1/perl583delta.1

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
3 .\"
4 .\" Standard preamble:
5 .\" ========================================================================
6 .de Sp \" Vertical space (when we can't use .PP)
7 .if t .sp .5v
8 .if n .sp
9 ..
10 .de Vb \" Begin verbatim text
11 .ft CW
12 .nf
13 .ne \\$1
14 ..
15 .de Ve \" End verbatim text
16 .ft R
17 .fi
18 ..
19 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20 .ie n \{\
21 . ds C` ""
22 . ds C' ""
23 'br\}
24 .el\{\
25 . ds C`
26 . ds C'
27 'br\}
28 .\"
29 .\" Escape single quotes in literal strings from groff's Unicode transform.
30 .ie \n(.g .ds Aq \(aq
31 .el .ds Aq '
32 .\"
33 .\" If the F register is >0, we'll generate index entries on stderr for
34 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35 .\" entries marked with X<> in POD. Of course, you'll have to process the
36 .\" output yourself in some meaningful fashion.
37 .\"
38 .\" Avoid warning from groff about undefined register 'F'.
39 .de IX
40 ..
41 .nr rF 0
42 .if \n(.g .if rF .nr rF 1
43 .if (\n(rF:(\n(.g==0)) \{\
44 . if \nF \{\
45 . de IX
46 . tm Index:\\$1\t\\n%\t"\\$2"
47 ..
48 . if !\nF==2 \{\
49 . nr % 0
50 . nr F 2
51 . \}
52 . \}
53 .\}
54 .rr rF
55 .\" ========================================================================
56 .\"
57 .IX Title "PERL583DELTA 1"
58 .TH PERL583DELTA 1 2025-11-16 "perl v5.40.1" "Perl Programmers Reference Guide"
59 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
60 .\" way too many mistakes in technical documents.
61 .if n .ad l
62 .nh
63 .SH NAME
64 perl583delta \- what is new for perl v5.8.3
65 .SH DESCRIPTION
66 .IX Header "DESCRIPTION"
67 This document describes differences between the 5.8.2 release and
68 the 5.8.3 release.
69 .PP
70 If you are upgrading from an earlier release such as 5.6.1, first read
71 the perl58delta, which describes differences between 5.6.0 and
72 5.8.0, and the perl581delta and perl582delta, which describe differences
73 between 5.8.0, 5.8.1 and 5.8.2
74 .SH "Incompatible Changes"
75 .IX Header "Incompatible Changes"
76 There are no changes incompatible with 5.8.2.
77 .SH "Core Enhancements"
78 .IX Header "Core Enhancements"
79 A \f(CW\*(C`SCALAR\*(C'\fR method is now available for tied hashes. This is called when
80 a tied hash is used in scalar context, such as
81 .PP
82 .Vb 3
83 \& if (%tied_hash) {
84 \& ...
85 \& }
86 .Ve
87 .PP
88 The old behaviour was that \f(CW%tied_hash\fR would return whatever would have been
89 returned for that hash before the hash was tied (so usually 0). The new
90 behaviour in the absence of a SCALAR method is to return TRUE if in the
91 middle of an \f(CW\*(C`each\*(C'\fR iteration, and otherwise call FIRSTKEY to check if the
92 hash is empty (making sure that a subsequent \f(CW\*(C`each\*(C'\fR will also begin by
93 calling FIRSTKEY). Please see "SCALAR" in perltie for the full details and
94 caveats.
95 .SH "Modules and Pragmata"
96 .IX Header "Modules and Pragmata"
97 .IP CGI 4
98 .IX Item "CGI"
99 .PD 0
100 .IP Cwd 4
101 .IX Item "Cwd"
102 .IP Digest 4
103 .IX Item "Digest"
104 .IP Digest::MD5 4
105 .IX Item "Digest::MD5"
106 .IP Encode 4
107 .IX Item "Encode"
108 .IP File::Spec 4
109 .IX Item "File::Spec"
110 .IP FindBin 4
111 .IX Item "FindBin"
112 .PD
113 A function \f(CW\*(C`again\*(C'\fR is provided to resolve problems where modules in different
114 directories wish to use FindBin.
115 .IP List::Util 4
116 .IX Item "List::Util"
117 You can now weaken references to read only values.
118 .IP Math::BigInt 4
119 .IX Item "Math::BigInt"
120 .PD 0
121 .IP PodParser 4
122 .IX Item "PodParser"
123 .IP Pod::Perldoc 4
124 .IX Item "Pod::Perldoc"
125 .IP POSIX 4
126 .IX Item "POSIX"
127 .IP Unicode::Collate 4
128 .IX Item "Unicode::Collate"
129 .IP Unicode::Normalize 4
130 .IX Item "Unicode::Normalize"
131 .IP Test::Harness 4
132 .IX Item "Test::Harness"
133 .IP threads::shared 4
134 .IX Item "threads::shared"
135 .PD
136 \&\f(CW\*(C`cond_wait\*(C'\fR has a new two argument form. \f(CW\*(C`cond_timedwait\*(C'\fR has been added.
137 .SH "Utility Changes"
138 .IX Header "Utility Changes"
139 \&\f(CW\*(C`find2perl\*(C'\fR now assumes \f(CW\*(C`\-print\*(C'\fR as a default action. Previously, it
140 needed to be specified explicitly.
141 .PP
142 A new utility, \f(CW\*(C`prove\*(C'\fR, makes it easy to run an individual regression test
143 at the command line. \f(CW\*(C`prove\*(C'\fR is part of Test::Harness, which users of earlier
144 Perl versions can install from CPAN.
145 .SH "New Documentation"
146 .IX Header "New Documentation"
147 The documentation has been revised in places to produce more standard manpages.
148 .PP
149 The documentation for the special code blocks (BEGIN, CHECK, INIT, END)
150 has been improved.
151 .SH "Installation and Configuration Improvements"
152 .IX Header "Installation and Configuration Improvements"
153 Perl now builds on OpenVMS I64
154 .SH "Selected Bug Fixes"
155 .IX Header "Selected Bug Fixes"
156 Using \fBsubstr()\fR on a UTF8 string could cause subsequent accesses on that
157 string to return garbage. This was due to incorrect UTF8 offsets being
158 cached, and is now fixed.
159 .PP
160 \&\fBjoin()\fR could return garbage when the same \fBjoin()\fR statement was used to
161 process 8 bit data having earlier processed UTF8 data, due to the flags
162 on that statement's temporary workspace not being reset correctly. This
163 is now fixed.
164 .PP
165 \&\f(CW\*(C`$a .. $b\*(C'\fR will now work as expected when either \f(CW$a\fR or \f(CW$b\fR is \f(CW\*(C`undef\*(C'\fR
166 .PP
167 Using Unicode keys with tied hashes should now work correctly.
168 .PP
169 Reading $^E now preserves $!. Previously, the C code implementing $^E
170 did not preserve \f(CW\*(C`errno\*(C'\fR, so reading $^E could cause \f(CW\*(C`errno\*(C'\fR and therefore
171 \&\f(CW$!\fR to change unexpectedly.
172 .PP
173 Reentrant functions will (once more) work with C++. 5.8.2 introduced a bugfix
174 which accidentally broke the compilation of Perl extensions written in C++
175 .SH "New or Changed Diagnostics"
176 .IX Header "New or Changed Diagnostics"
177 The fatal error "DESTROY created new reference to dead object" is now
178 documented in perldiag.
179 .SH "Changed Internals"
180 .IX Header "Changed Internals"
181 The hash code has been refactored to reduce source duplication. The
182 external interface is unchanged, and aside from the bug fixes described
183 above, there should be no change in behaviour.
184 .PP
185 \&\f(CW\*(C`hv_clear_placeholders\*(C'\fR is now part of the perl API
186 .PP
187 Some C macros have been tidied. In particular macros which create temporary
188 local variables now name these variables more defensively, which should
189 avoid bugs where names clash.
190 .PP
191 <signal.h> is now always included.
192 .SH "Configuration and Building"
193 .IX Header "Configuration and Building"
194 \&\f(CW\*(C`Configure\*(C'\fR now invokes callbacks regardless of the value of the variable
195 they are called for. Previously callbacks were only invoked in the
196 \&\f(CW\*(C`case $variable $define)\*(C'\fR branch. This change should only affect platform
197 maintainers writing configuration hints files.
198 .SH "Platform Specific Problems"
199 .IX Header "Platform Specific Problems"
200 The regression test ext/threads/shared/t/wait.t fails on early RedHat 9
201 and HP-UX 10.20 due to bugs in their threading implementations.
202 RedHat users should see https://rhn.redhat.com/errata/RHBA\-2003\-136.html
203 and consider upgrading their glibc.
204 .SH "Known Problems"
205 .IX Header "Known Problems"
206 Detached threads aren't supported on Windows yet, as they may lead to
207 memory access violation problems.
208 .PP
209 There is a known race condition opening scripts in \f(CW\*(C`suidperl\*(C'\fR. \f(CW\*(C`suidperl\*(C'\fR
210 is neither built nor installed by default, and has been deprecated since
211 perl 5.8.0. You are advised to replace use of suidperl with tools such
212 as sudo ( http://www.courtesan.com/sudo/ )
213 .PP
214 We have a backlog of unresolved bugs. Dealing with bugs and bug reports
215 is unglamorous work; not something ideally suited to volunteer labour,
216 but that is all that we have.
217 .PP
218 The perl5 development team are implementing changes to help address this
219 problem, which should go live in early 2004.
220 .SH "Future Directions"
221 .IX Header "Future Directions"
222 Code freeze for the next maintenance release (5.8.4) is on March 31st 2004,
223 with release expected by mid April. Similarly 5.8.5's freeze will be at
224 the end of June, with release by mid July.
225 .SH Obituary
226 .IX Header "Obituary"
227 Iain 'Spoon' Truskett, Perl hacker, author of perlreref and
228 contributor to CPAN, died suddenly on 29th December 2003, aged 24.
229 He will be missed.
230 .SH "Reporting Bugs"
231 .IX Header "Reporting Bugs"
232 If you find what you think is a bug, you might check the articles
233 recently posted to the comp.lang.perl.misc newsgroup and the perl
234 bug database at http://bugs.perl.org. There may also be
235 information at http://www.perl.org, the Perl Home Page.
236 .PP
237 If you believe you have an unreported bug, please run the \fBperlbug\fR
238 program included with your release. Be sure to trim your bug down
239 to a tiny but sufficient test case. Your bug report, along with the
240 output of \f(CW\*(C`perl \-V\*(C'\fR, will be sent off to [email protected] to be
241 analysed by the Perl porting team. You can browse and search
242 the Perl 5 bugs at http://bugs.perl.org/
243 .SH "SEE ALSO"
244 .IX Header "SEE ALSO"
245 The \fIChanges\fR file for exhaustive details on what changed.
246 .PP
247 The \fIINSTALL\fR file for how to build Perl.
248 .PP
249 The \fIREADME\fR file for general stuff.
250 .PP
251 The \fIArtistic\fR and \fICopying\fR files for copyright information.