Debian Codegraph @

upstream/fedora-44/man1/perl584delta.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 "PERL584DELTA 1"
61 .TH PERL584DELTA 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 perl584delta \- what is new for perl v5.8.4
68 .SH DESCRIPTION
69 .IX Header "DESCRIPTION"
70 This document describes differences between the 5.8.3 release and
71 the 5.8.4 release.
72 .SH "Incompatible Changes"
73 .IX Header "Incompatible Changes"
74 Many minor bugs have been fixed. Scripts which happen to rely on previously
75 erroneous behaviour will consider these fixes as incompatible changes :\-)
76 You are advised to perform sufficient acceptance testing on this release
77 to satisfy yourself that this does not affect you, before putting this
78 release into production.
79 .PP
80 The diagnostic output of Carp has been changed slightly, to add a space after
81 the comma between arguments. This makes it much easier for tools such as
82 web browsers to wrap it, but might confuse any automatic tools which perform
83 detailed parsing of Carp output.
84 .PP
85 The internal dump output has been improved, so that non\-printable characters
86 such as newline and backspace are output in \f(CW\*(C`\ex\*(C'\fR notation, rather than
87 octal. This might just confuse non\-robust tools which parse the output of
88 modules such as Devel::Peek.
89 .SH "Core Enhancements"
90 .IX Header "Core Enhancements"
91 .SS "Malloc wrapping"
92 .IX Subsection "Malloc wrapping"
93 Perl can now be built to detect attempts to assign pathologically large chunks
94 of memory. Previously such assignments would suffer from integer wrap\-around
95 during size calculations causing a misallocation, which would crash perl, and
96 could theoretically be used for "stack smashing" attacks. The wrapping
97 defaults to enabled on platforms where we know it works (most AIX
98 configurations, BSDi, Darwin, DEC OSF/1, FreeBSD, HP/UX, GNU Linux, OpenBSD,
99 Solaris, VMS and most Win32 compilers) and defaults to disabled on other
100 platforms.
101 .SS "Unicode Character Database 4.0.1"
102 .IX Subsection "Unicode Character Database 4.0.1"
103 The copy of the Unicode Character Database included in Perl 5.8 has
104 been updated to 4.0.1 from 4.0.0.
105 .SS "suidperl less insecure"
106 .IX Subsection "suidperl less insecure"
107 Paul Szabo has analysed and patched \f(CW\*(C`suidperl\*(C'\fR to remove existing known
108 insecurities. Currently there are no known holes in \f(CW\*(C`suidperl\*(C'\fR, but previous
109 experience shows that we cannot be confident that these were the last. You may
110 no longer invoke the set uid perl directly, so to preserve backwards
111 compatibility with scripts that invoke #!/usr/bin/suidperl the only set uid
112 binary is now \f(CW\*(C`sperl5.8.\*(C'\fR\fIn\fR (\f(CW\*(C`sperl5.8.4\*(C'\fR for this release). \f(CW\*(C`suidperl\*(C'\fR
113 is installed as a hard link to \f(CW\*(C`perl\*(C'\fR; both \f(CW\*(C`suidperl\*(C'\fR and \f(CW\*(C`perl\*(C'\fR will
114 invoke \f(CW\*(C`sperl5.8.4\*(C'\fR automatically the set uid binary, so this change should
115 be completely transparent.
116 .PP
117 For new projects the core perl team would strongly recommend that you use
118 dedicated, single purpose security tools such as \f(CW\*(C`sudo\*(C'\fR in preference to
119 \&\f(CW\*(C`suidperl\*(C'\fR.
120 .SS format
121 .IX Subsection "format"
122 In addition to bug fixes, \f(CW\*(C`format\*(C'\fR\*(Aqs features have been enhanced. See
123 perlform
124 .SH "Modules and Pragmata"
125 .IX Header "Modules and Pragmata"
126 The (mis)use of \f(CW\*(C`/tmp\*(C'\fR in core modules and documentation has been tidied up.
127 Some modules available both within the perl core and independently from CPAN
128 ("dual\-life modules") have not yet had these changes applied; the changes
129 will be integrated into future stable perl releases as the modules are
130 updated on CPAN.
131 .SS "Updated modules"
132 .IX Subsection "Updated modules"
133 .IP Attribute::Handlers 4
134 .IX Item "Attribute::Handlers"
135 .PD 0
136 .IP B 4
137 .IX Item "B"
138 .IP Benchmark 4
139 .IX Item "Benchmark"
140 .IP CGI 4
141 .IX Item "CGI"
142 .IP Carp 4
143 .IX Item "Carp"
144 .IP Cwd 4
145 .IX Item "Cwd"
146 .IP Exporter 4
147 .IX Item "Exporter"
148 .IP File::Find 4
149 .IX Item "File::Find"
150 .IP IO 4
151 .IX Item "IO"
152 .IP IPC::Open3 4
153 .IX Item "IPC::Open3"
154 .IP Local::Maketext 4
155 .IX Item "Local::Maketext"
156 .IP Math::BigFloat 4
157 .IX Item "Math::BigFloat"
158 .IP Math::BigInt 4
159 .IX Item "Math::BigInt"
160 .IP Math::BigRat 4
161 .IX Item "Math::BigRat"
162 .IP MIME::Base64 4
163 .IX Item "MIME::Base64"
164 .IP ODBM_File 4
165 .IX Item "ODBM_File"
166 .IP POSIX 4
167 .IX Item "POSIX"
168 .IP Shell 4
169 .IX Item "Shell"
170 .IP Socket 4
171 .IX Item "Socket"
172 .PD
173 There is experimental support for Linux abstract Unix domain sockets.
174 .IP Storable 4
175 .IX Item "Storable"
176 .PD 0
177 .IP Switch 4
178 .IX Item "Switch"
179 .PD
180 Synced with its CPAN version 2.10
181 .IP Sys::Syslog 4
182 .IX Item "Sys::Syslog"
183 \&\f(CWsyslog()\fR can now use numeric constants for facility names and priorities,
184 in addition to strings.
185 .IP Term::ANSIColor 4
186 .IX Item "Term::ANSIColor"
187 .PD 0
188 .IP Time::HiRes 4
189 .IX Item "Time::HiRes"
190 .IP Unicode::UCD 4
191 .IX Item "Unicode::UCD"
192 .IP Win32 4
193 .IX Item "Win32"
194 .PD
195 Win32.pm/Win32.xs has moved from the libwin32 module to core Perl
196 .IP base 4
197 .IX Item "base"
198 .PD 0
199 .IP open 4
200 .IX Item "open"
201 .IP threads 4
202 .IX Item "threads"
203 .PD
204 Detached threads are now also supported on Windows.
205 .IP utf8 4
206 .IX Item "utf8"
207 .SH "Performance Enhancements"
208 .IX Header "Performance Enhancements"
209 .IP \(bu 4
210 Accelerated Unicode case mappings (\f(CW\*(C`/i\*(C'\fR, \f(CW\*(C`lc\*(C'\fR, \f(CW\*(C`uc\*(C'\fR, etc).
211 .IP \(bu 4
212 In place sort optimised (eg \f(CW\*(C`@a = sort @a\*(C'\fR)
213 .IP \(bu 4
214 Unnecessary assignment optimised away in
215 .Sp
216 .Vb 3
217 \& my $s = undef;
218 \& my @a = ();
219 \& my %h = ();
220 .Ve
221 .IP \(bu 4
222 Optimised \f(CW\*(C`map\*(C'\fR in scalar context
223 .SH "Utility Changes"
224 .IX Header "Utility Changes"
225 The Perl debugger (\fIlib/perl5db.pl\fR) can now save all debugger commands for
226 sourcing later, and can display the parent inheritance tree of a given class.
227 .SH "Installation and Configuration Improvements"
228 .IX Header "Installation and Configuration Improvements"
229 The build process on both VMS and Windows has had several minor improvements
230 made. On Windows Borland\*(Aqs C compiler can now compile perl with PerlIO and/or
231 USE_LARGE_FILES enabled.
232 .PP
233 \&\f(CW\*(C`perl.exe\*(C'\fR on Windows now has a "Camel" logo icon. The use of a camel with
234 the topic of Perl is a trademark of O\*(AqReilly and Associates Inc., and is used
235 with their permission (ie distribution of the source, compiling a Windows
236 executable from it, and using that executable locally). Use of the supplied
237 camel for anything other than a perl executable\*(Aqs icon is specifically not
238 covered, and anyone wishing to redistribute perl binaries \fIwith\fR the icon
239 should check directly with O\*(AqReilly beforehand.
240 .PP
241 Perl should build cleanly on Stratus VOS once more.
242 .SH "Selected Bug Fixes"
243 .IX Header "Selected Bug Fixes"
244 More utf8 bugs fixed, notably in how \f(CW\*(C`chomp\*(C'\fR, \f(CW\*(C`chop\*(C'\fR, \f(CW\*(C`send\*(C'\fR, and
245 \&\f(CW\*(C`syswrite\*(C'\fR and interact with utf8 data. Concatenation now works correctly
246 when \f(CW\*(C`use bytes;\*(C'\fR is in scope.
247 .PP
248 Pragmata are now correctly propagated into (?{...}) constructions in regexps.
249 Code such as
250 .PP
251 .Vb 1
252 \& my $x = qr{ ... (??{ $x }) ... };
253 .Ve
254 .PP
255 will now (correctly) fail under use strict. (As the inner \f(CW$x\fR is and
256 has always referred to \f(CW$::x\fR)
257 .PP
258 The "const in void context" warning has been suppressed for a constant in an
259 optimised\-away boolean expression such as \f(CW\*(C`5 || print;\*(C'\fR
260 .PP
261 \&\f(CW\*(C`perl \-i\*(C'\fR could \f(CWfchmod(stdin)\fR by mistake. This is serious if stdin is
262 attached to a terminal, and perl is running as root. Now fixed.
263 .SH "New or Changed Diagnostics"
264 .IX Header "New or Changed Diagnostics"
265 \&\f(CW\*(C`Carp\*(C'\fR and the internal diagnostic routines used by \f(CW\*(C`Devel::Peek\*(C'\fR have been
266 made clearer, as described in "Incompatible Changes"
267 .SH "Changed Internals"
268 .IX Header "Changed Internals"
269 Some bugs have been fixed in the hash internals. Restricted hashes and
270 their place holders are now allocated and deleted at slightly different times,
271 but this should not be visible to user code.
272 .SH "Future Directions"
273 .IX Header "Future Directions"
274 Code freeze for the next maintenance release (5.8.5) will be on 30th June
275 2004, with release by mid July.
276 .SH "Platform Specific Problems"
277 .IX Header "Platform Specific Problems"
278 This release is known not to build on Windows 95.
279 .SH "Reporting Bugs"
280 .IX Header "Reporting Bugs"
281 If you find what you think is a bug, you might check the articles
282 recently posted to the comp.lang.perl.misc newsgroup and the perl
283 bug database at http://bugs.perl.org. There may also be
284 information at http://www.perl.org, the Perl Home Page.
285 .PP
286 If you believe you have an unreported bug, please run the \fBperlbug\fR
287 program included with your release. Be sure to trim your bug down
288 to a tiny but sufficient test case. Your bug report, along with the
289 output of \f(CW\*(C`perl \-V\*(C'\fR, will be sent off to [email protected] to be
290 analysed by the Perl porting team. You can browse and search
291 the Perl 5 bugs at http://bugs.perl.org/
292 .SH "SEE ALSO"
293 .IX Header "SEE ALSO"
294 The \fIChanges\fR file for exhaustive details on what changed.
295 .PP
296 The \fIINSTALL\fR file for how to build Perl.
297 .PP
298 The \fIREADME\fR file for general stuff.
299 .PP
300 The \fIArtistic\fR and \fICopying\fR files for copyright information.