Debian Codegraph @

upstream/debian-unstable/man1/perl587delta.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 "PERL587DELTA 1"
58 .TH PERL587DELTA 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 perl587delta \- what is new for perl v5.8.7
65 .SH DESCRIPTION
66 .IX Header "DESCRIPTION"
67 This document describes differences between the 5.8.6 release and
68 the 5.8.7 release.
69 .SH "Incompatible Changes"
70 .IX Header "Incompatible Changes"
71 There are no changes incompatible with 5.8.6.
72 .SH "Core Enhancements"
73 .IX Header "Core Enhancements"
74 .SS "Unicode Character Database 4.1.0"
75 .IX Subsection "Unicode Character Database 4.1.0"
76 The copy of the Unicode Character Database included in Perl 5.8 has
77 been updated to 4.1.0 from 4.0.1. See
78 <http://www.unicode.org/versions/Unicode4.1.0/#NotableChanges> for the
79 notable changes.
80 .SS "suidperl less insecure"
81 .IX Subsection "suidperl less insecure"
82 A pair of exploits in \f(CW\*(C`suidperl\*(C'\fR involving debugging code have been closed.
83 .PP
84 For new projects the core perl team strongly recommends that you use
85 dedicated, single purpose security tools such as \f(CW\*(C`sudo\*(C'\fR in preference to
86 \&\f(CW\*(C`suidperl\*(C'\fR.
87 .SS "Optional site customization script"
88 .IX Subsection "Optional site customization script"
89 The perl interpreter can be built to allow the use of a site customization
90 script. By default this is not enabled, to be consistent with previous perl
91 releases. To use this, add \f(CW\*(C`\-Dusesitecustomize\*(C'\fR to the command line flags
92 when running the \f(CW\*(C`Configure\*(C'\fR script. See also "\-f" in perlrun.
93 .ie n .SS """Config.pm"" is now much smaller"
94 .el .SS "\f(CWConfig.pm\fP is now much smaller"
95 .IX Subsection "Config.pm is now much smaller"
96 \&\f(CW\*(C`Config.pm\*(C'\fR is now about 3K rather than 32K, with the infrequently used
97 code and \f(CW%Config\fR values loaded on demand. This is transparent to the
98 programmer, but means that most code will save parsing and loading 29K of
99 script (for example, code that uses \f(CW\*(C`File::Find\*(C'\fR).
100 .SH "Modules and Pragmata"
101 .IX Header "Modules and Pragmata"
102 .IP \(bu 4
103 B upgraded to version 1.09
104 .IP \(bu 4
105 base upgraded to version 2.07
106 .IP \(bu 4
107 bignum upgraded to version 0.17
108 .IP \(bu 4
109 bytes upgraded to version 1.02
110 .IP \(bu 4
111 Carp upgraded to version 1.04
112 .IP \(bu 4
113 CGI upgraded to version 3.10
114 .IP \(bu 4
115 Class::ISA upgraded to version 0.33
116 .IP \(bu 4
117 Data::Dumper upgraded to version 2.121_02
118 .IP \(bu 4
119 DB_File upgraded to version 1.811
120 .IP \(bu 4
121 Devel::PPPort upgraded to version 3.06
122 .IP \(bu 4
123 Digest upgraded to version 1.10
124 .IP \(bu 4
125 Encode upgraded to version 2.10
126 .IP \(bu 4
127 FileCache upgraded to version 1.05
128 .IP \(bu 4
129 File::Path upgraded to version 1.07
130 .IP \(bu 4
131 File::Temp upgraded to version 0.16
132 .IP \(bu 4
133 IO::File upgraded to version 1.11
134 .IP \(bu 4
135 IO::Socket upgraded to version 1.28
136 .IP \(bu 4
137 Math::BigInt upgraded to version 1.77
138 .IP \(bu 4
139 Math::BigRat upgraded to version 0.15
140 .IP \(bu 4
141 overload upgraded to version 1.03
142 .IP \(bu 4
143 PathTools upgraded to version 3.05
144 .IP \(bu 4
145 Pod::HTML upgraded to version 1.0503
146 .IP \(bu 4
147 Pod::Perldoc upgraded to version 3.14
148 .IP \(bu 4
149 Pod::LaTeX upgraded to version 0.58
150 .IP \(bu 4
151 Pod::Parser upgraded to version 1.30
152 .IP \(bu 4
153 Symbol upgraded to version 1.06
154 .IP \(bu 4
155 Term::ANSIColor upgraded to version 1.09
156 .IP \(bu 4
157 Test::Harness upgraded to version 2.48
158 .IP \(bu 4
159 Test::Simple upgraded to version 0.54
160 .IP \(bu 4
161 Text::Wrap upgraded to version 2001.09293, to fix a bug when \fBwrap()\fR was
162 called with a non-space separator.
163 .IP \(bu 4
164 threads::shared upgraded to version 0.93
165 .IP \(bu 4
166 Time::HiRes upgraded to version 1.66
167 .IP \(bu 4
168 Time::Local upgraded to version 1.11
169 .IP \(bu 4
170 Unicode::Normalize upgraded to version 0.32
171 .IP \(bu 4
172 utf8 upgraded to version 1.05
173 .IP \(bu 4
174 Win32 upgraded to version 0.24, which provides Win32::GetFileVersion
175 .SH "Utility Changes"
176 .IX Header "Utility Changes"
177 .SS "find2perl enhancements"
178 .IX Subsection "find2perl enhancements"
179 \&\f(CW\*(C`find2perl\*(C'\fR has new options \f(CW\*(C`\-iname\*(C'\fR, \f(CW\*(C`\-path\*(C'\fR and \f(CW\*(C`\-ipath\*(C'\fR.
180 .SH "Performance Enhancements"
181 .IX Header "Performance Enhancements"
182 The internal pointer mapping hash used during ithreads cloning now uses an
183 arena for memory allocation. In tests this reduced ithreads cloning time by
184 about 10%.
185 .SH "Installation and Configuration Improvements"
186 .IX Header "Installation and Configuration Improvements"
187 .IP \(bu 4
188 The Win32 "dmake" makefile.mk has been updated to make it compatible
189 with the latest versions of dmake.
190 .IP \(bu 4
191 \&\f(CW\*(C`PERL_MALLOC\*(C'\fR, \f(CW\*(C`DEBUG_MSTATS\*(C'\fR, \f(CW\*(C`PERL_HASH_SEED_EXPLICIT\*(C'\fR and \f(CW\*(C`NO_HASH_SEED\*(C'\fR
192 should now work in Win32 makefiles.
193 .SH "Selected Bug Fixes"
194 .IX Header "Selected Bug Fixes"
195 .IP \(bu 4
196 The \fBsocket()\fR function on Win32 has been fixed so that it is able to use
197 transport providers which specify a protocol of 0 (meaning any protocol
198 is allowed) once more. (This was broken in 5.8.6, and typically caused
199 the use of ICMP sockets to fail.)
200 .IP \(bu 4
201 Another obscure bug involving \f(CW\*(C`substr\*(C'\fR and UTF\-8 caused by bad internal
202 offset caching has been identified and fixed.
203 .IP \(bu 4
204 A bug involving the loading of UTF\-8 tables by the regexp engine has been
205 fixed \- code such as \f(CW\*(C`"\ex{100}" =~ /[[:print:]]/\*(C'\fR will no longer give
206 corrupt results.
207 .IP \(bu 4
208 Case conversion operations such as \f(CW\*(C`uc\*(C'\fR on a long Unicode string could
209 exhaust memory. This has been fixed.
210 .IP \(bu 4
211 \&\f(CW\*(C`index\*(C'\fR/\f(CW\*(C`rindex\*(C'\fR were buggy for some combinations of Unicode and
212 non-Unicode data. This has been fixed.
213 .IP \(bu 4
214 \&\f(CW\*(C`read\*(C'\fR (and presumably \f(CW\*(C`sysread\*(C'\fR) would expose the UTF\-8 internals when
215 reading from a byte oriented file handle into a UTF\-8 scalar. This has
216 been fixed.
217 .IP \(bu 4
218 Several \f(CW\*(C`pack\*(C'\fR/\f(CW\*(C`unpack\*(C'\fR bug fixes:
219 .RS 4
220 .IP \(bu 4
221 Checksums with \f(CW\*(C`b\*(C'\fR or \f(CW\*(C`B\*(C'\fR formats were broken.
222 .IP \(bu 4
223 \&\f(CW\*(C`unpack\*(C'\fR checksums could overflow with the \f(CW\*(C`C\*(C'\fR format.
224 .IP \(bu 4
225 \&\f(CW\*(C`U0\*(C'\fR and \f(CW\*(C`C0\*(C'\fR are now scoped to \f(CW\*(C`()\*(C'\fR \f(CW\*(C`pack\*(C'\fR sub-templates.
226 .IP \(bu 4
227 Counted length prefixes now don't change \f(CW\*(C`C0\*(C'\fR/\f(CW\*(C`U0\*(C'\fR mode.
228 .IP \(bu 4
229 \&\f(CW\*(C`pack\*(C'\fR \f(CW\*(C`Z0\*(C'\fR used to destroy the preceding character.
230 .IP \(bu 4
231 \&\f(CW\*(C`P\*(C'\fR/\f(CW\*(C`p\*(C'\fR \f(CW\*(C`pack\*(C'\fR formats used to only recognise literal \f(CW\*(C`undef\*(C'\fR
232 .RE
233 .RS 4
234 .RE
235 .IP \(bu 4
236 Using closures with ithreads could cause perl to crash. This was due to
237 failure to correctly lock internal OP structures, and has been fixed.
238 .IP \(bu 4
239 The return value of \f(CW\*(C`close\*(C'\fR now correctly reflects any file errors that
240 occur while flushing the handle's data, instead of just giving failure if
241 the actual underlying file close operation failed.
242 .IP \(bu 4
243 \&\f(CW\*(C`not() || 1\*(C'\fR used to segfault. \f(CWnot()\fR now behaves like \f(CWnot(0)\fR, which was
244 the pre 5.6.0 behaviour.
245 .IP \(bu 4
246 \&\f(CW\*(C`h2ph\*(C'\fR has various enhancements to cope with constructs in header files that
247 used to result in incorrect or invalid output.
248 .SH "New or Changed Diagnostics"
249 .IX Header "New or Changed Diagnostics"
250 There is a new taint error, "%ENV is aliased to \f(CW%s\fR". This error is thrown
251 when taint checks are enabled and when \f(CW*ENV\fR has been aliased, so that
252 \&\f(CW%ENV\fR has no env-magic anymore and hence the environment cannot be verified
253 as taint-free.
254 .PP
255 The internals of \f(CW\*(C`pack\*(C'\fR and \f(CW\*(C`unpack\*(C'\fR have been updated. All legitimate
256 templates should work as before, but there may be some changes in the error
257 reported for complex failure cases. Any behaviour changes for non-error cases
258 are bugs, and should be reported.
259 .SH "Changed Internals"
260 .IX Header "Changed Internals"
261 There has been a fair amount of refactoring of the \f(CW\*(C`C\*(C'\fR source code, partly to
262 make it tidier and more maintainable. The resulting object code and the
263 \&\f(CW\*(C`perl\*(C'\fR binary may well be smaller than 5.8.6, and hopefully faster in some
264 cases, but apart from this there should be no user-detectable changes.
265 .PP
266 \&\f(CW\*(C`${^UTF8LOCALE}\*(C'\fR has been added to give perl space access to \f(CW\*(C`PL_utf8locale\*(C'\fR.
267 .PP
268 The size of the arenas used to allocate SV heads and most SV bodies can now
269 be changed at compile time. The old size was 1008 bytes, the new default size
270 is 4080 bytes.
271 .SH "Known Problems"
272 .IX Header "Known Problems"
273 Unicode strings returned from overloaded operators can be buggy. This is a
274 long standing bug reported since 5.8.6 was released, but we do not yet have
275 a suitable fix for it.
276 .SH "Platform Specific Problems"
277 .IX Header "Platform Specific Problems"
278 On UNICOS, lib/Math/BigInt/t/bigintc.t hangs burning CPU.
279 ext/B/t/bytecode.t and ext/Socket/t/socketpair.t both fail tests.
280 These are unlikely to be resolved, as our valiant UNICOS porter's last
281 Cray is being decommissioned.
282 .SH "Reporting Bugs"
283 .IX Header "Reporting Bugs"
284 If you find what you think is a bug, you might check the articles
285 recently posted to the comp.lang.perl.misc newsgroup and the perl
286 bug database at http://bugs.perl.org. There may also be
287 information at http://www.perl.org, the Perl Home Page.
288 .PP
289 If you believe you have an unreported bug, please run the \fBperlbug\fR
290 program included with your release. Be sure to trim your bug down
291 to a tiny but sufficient test case. Your bug report, along with the
292 output of \f(CW\*(C`perl \-V\*(C'\fR, will be sent off to [email protected] to be
293 analysed by the Perl porting team. You can browse and search
294 the Perl 5 bugs at http://bugs.perl.org/
295 .SH "SEE ALSO"
296 .IX Header "SEE ALSO"
297 The \fIChanges\fR file for exhaustive details on what changed.
298 .PP
299 The \fIINSTALL\fR file for how to build Perl.
300 .PP
301 The \fIREADME\fR file for general stuff.
302 .PP
303 The \fIArtistic\fR and \fICopying\fR files for copyright information.