Debian Codegraph @

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