Debian Codegraph @

upstream/opensuse-tumbleweed/man1/perl583delta.1

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