Debian Codegraph @

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