Debian Codegraph @

upstream/fedora-44/man1/perl5101delta.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 "PERL5101DELTA 1"
61 .TH PERL5101DELTA 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 perl5101delta \- what is new for perl v5.10.1
68 .SH DESCRIPTION
69 .IX Header "DESCRIPTION"
70 This document describes differences between the 5.10.0 release and
71 the 5.10.1 release.
72 .PP
73 If you are upgrading from an earlier release such as 5.8.8, first read
74 the perl5100delta, which describes differences between 5.8.8 and
75 5.10.0
76 .SH "Incompatible Changes"
77 .IX Header "Incompatible Changes"
78 .SS "Switch statement changes"
79 .IX Subsection "Switch statement changes"
80 The handling of complex expressions by the \f(CW\*(C`given\*(C'\fR/\f(CW\*(C`when\*(C'\fR switch
81 statement has been enhanced. There are two new cases where \f(CW\*(C`when\*(C'\fR now
82 interprets its argument as a boolean, instead of an expression to be used
83 in a smart match:
84 .IP "flip\-flop operators" 4
85 .IX Item "flip-flop operators"
86 The \f(CW\*(C`..\*(C'\fR and \f(CW\*(C`...\*(C'\fR flip\-flop operators are now evaluated in boolean
87 context, following their usual semantics; see "Range Operators" in perlop.
88 .Sp
89 Note that, as in perl 5.10.0, \f(CW\*(C`when (1..10)\*(C'\fR will not work to test
90 whether a given value is an integer between 1 and 10; you should use
91 \&\f(CW\*(C`when ([1..10])\*(C'\fR instead (note the array reference).
92 .Sp
93 However, contrary to 5.10.0, evaluating the flip\-flop operators in boolean
94 context ensures it can now be useful in a \f(CWwhen()\fR, notably for
95 implementing bistable conditions, like in:
96 .Sp
97 .Vb 3
98 \& when (/^=begin/ .. /^=end/) {
99 \& # do something
100 \& }
101 .Ve
102 .IP "defined\-or operator" 4
103 .IX Item "defined-or operator"
104 A compound expression involving the defined\-or operator, as in
105 \&\f(CW\*(C`when (expr1 // expr2)\*(C'\fR, will be treated as boolean if the first
106 expression is boolean. (This just extends the existing rule that applies
107 to the regular or operator, as in \f(CW\*(C`when (expr1 || expr2)\*(C'\fR.)
108 .PP
109 The next section details more changes brought to the semantics to
110 the smart match operator, that naturally also modify the behaviour
111 of the switch statements where smart matching is implicitly used.
112 .SS "Smart match changes"
113 .IX Subsection "Smart match changes"
114 \fIChanges to type\-based dispatch\fR
115 .IX Subsection "Changes to type-based dispatch"
116 .PP
117 The smart match operator \f(CW\*(C`~~\*(C'\fR is no longer commutative. The behaviour of
118 a smart match now depends primarily on the type of its right hand
119 argument. Moreover, its semantics have been adjusted for greater
120 consistency or usefulness in several cases. While the general backwards
121 compatibility is maintained, several changes must be noted:
122 .IP \(bu 4
123 Code references with an empty prototype are no longer treated specially.
124 They are passed an argument like the other code references (even if they
125 choose to ignore it).
126 .IP \(bu 4
127 \&\f(CW\*(C`%hash ~~ sub {}\*(C'\fR and \f(CW\*(C`@array ~~ sub {}\*(C'\fR now test that the subroutine
128 returns a true value for each key of the hash (or element of the
129 array), instead of passing the whole hash or array as a reference to
130 the subroutine.
131 .IP \(bu 4
132 Due to the commutativity breakage, code references are no longer
133 treated specially when appearing on the left of the \f(CW\*(C`~~\*(C'\fR operator,
134 but like any vulgar scalar.
135 .IP \(bu 4
136 \&\f(CW\*(C`undef ~~ %hash\*(C'\fR is always false (since \f(CW\*(C`undef\*(C'\fR can\*(Aqt be a key in a
137 hash). No implicit conversion to \f(CW""\fR is done (as was the case in perl
138 5.10.0).
139 .IP \(bu 4
140 \&\f(CW\*(C`$scalar ~~ @array\*(C'\fR now always distributes the smart match across the
141 elements of the array. It\*(Aqs true if one element in \f(CW@array\fR verifies
142 \&\f(CW\*(C`$scalar ~~ $element\*(C'\fR. This is a generalization of the old behaviour
143 that tested whether the array contained the scalar.
144 .PP
145 The full dispatch table for the smart match operator is given in
146 "Smart matching in detail" in perlsyn.
147 .PP
148 \fISmart match and overloading\fR
149 .IX Subsection "Smart match and overloading"
150 .PP
151 According to the rule of dispatch based on the rightmost argument type,
152 when an object overloading \f(CW\*(C`~~\*(C'\fR appears on the right side of the
153 operator, the overload routine will always be called (with a 3rd argument
154 set to a true value, see overload.) However, when the object will
155 appear on the left, the overload routine will be called only when the
156 rightmost argument is a simple scalar. This way distributivity of smart match
157 across arrays is not broken, as well as the other behaviours with complex
158 types (coderefs, hashes, regexes). Thus, writers of overloading routines
159 for smart match mostly need to worry only with comparing against a scalar,
160 and possibly with stringification overloading; the other common cases
161 will be automatically handled consistently.
162 .PP
163 \&\f(CW\*(C`~~\*(C'\fR will now refuse to work on objects that do not overload it (in order
164 to avoid relying on the object\*(Aqs underlying structure). (However, if the
165 object overloads the stringification or the numification operators, and
166 if overload fallback is active, it will be used instead, as usual.)
167 .SS "Other incompatible changes"
168 .IX Subsection "Other incompatible changes"
169 .IP \(bu 4
170 The semantics of \f(CW\*(C`use feature :5.10*\*(C'\fR have changed slightly.
171 See "Modules and Pragmata" for more information.
172 .IP \(bu 4
173 It is now a run\-time error to use the smart match operator \f(CW\*(C`~~\*(C'\fR
174 with an object that has no overload defined for it. (This way
175 \&\f(CW\*(C`~~\*(C'\fR will not break encapsulation by matching against the
176 object\*(Aqs internal representation as a reference.)
177 .IP \(bu 4
178 The version control system used for the development of the perl
179 interpreter has been switched from Perforce to git. This is mainly an
180 internal issue that only affects people actively working on the perl core;
181 but it may have minor external visibility, for example in some of details
182 of the output of \f(CW\*(C`perl \-V\*(C'\fR. See perlrepository for more information.
183 .IP \(bu 4
184 The internal structure of the \f(CW\*(C`ext/\*(C'\fR directory in the perl source has
185 been reorganised. In general, a module \f(CW\*(C`Foo::Bar\*(C'\fR whose source was
186 stored under \fIext/Foo/Bar/\fR is now located under \fIext/Foo\-Bar/\fR. Also,
187 some modules have been moved from \fIlib/\fR to \fIext/\fR. This is purely a
188 source tarball change, and should make no difference to the compilation or
189 installation of perl, unless you have a very customised build process that
190 explicitly relies on this structure, or which hard\-codes the \f(CW\*(C`nonxs_ext\*(C'\fR
191 \&\fIConfigure\fR parameter. Specifically, this change does not by default
192 alter the location of any files in the final installation.
193 .IP \(bu 4
194 As part of the \f(CW\*(C`Test::Harness\*(C'\fR 2.x to 3.x upgrade, the experimental
195 \&\f(CW\*(C`Test::Harness::Straps\*(C'\fR module has been removed.
196 See "Updated Modules" for more details.
197 .IP \(bu 4
198 As part of the \f(CW\*(C`ExtUtils::MakeMaker\*(C'\fR upgrade, the
199 \&\f(CW\*(C`ExtUtils::MakeMaker::bytes\*(C'\fR and \f(CW\*(C`ExtUtils::MakeMaker::vmsish\*(C'\fR modules
200 have been removed from this distribution.
201 .IP \(bu 4
202 \&\f(CW\*(C`Module::CoreList\*(C'\fR no longer contains the \f(CW%:patchlevel\fR hash.
203 .IP \(bu 4
204 This one is actually a change introduced in 5.10.0, but it was missed
205 from that release\*(Aqs perldelta, so it is mentioned here instead.
206 .Sp
207 A bugfix related to the handling of the \f(CW\*(C`/m\*(C'\fR modifier and \f(CW\*(C`qr\*(C'\fR resulted
208 in a change of behaviour between 5.8.x and 5.10.0:
209 .Sp
210 .Vb 2
211 \& # matches in 5.8.x, doesn\*(Aqt match in 5.10.0
212 \& $re = qr/^bar/; "foo\enbar" =~ /$re/m;
213 .Ve
214 .SH "Core Enhancements"
215 .IX Header "Core Enhancements"
216 .SS "Unicode Character Database 5.1.0"
217 .IX Subsection "Unicode Character Database 5.1.0"
218 The copy of the Unicode Character Database included in Perl 5.10.1 has
219 been updated to 5.1.0 from 5.0.0. See
220 <http://www.unicode.org/versions/Unicode5.1.0/#Notable_Changes> for the
221 notable changes.
222 .SS "A proper interface for pluggable Method Resolution Orders"
223 .IX Subsection "A proper interface for pluggable Method Resolution Orders"
224 As of Perl 5.10.1 there is a new interface for plugging and using method
225 resolution orders other than the default (linear depth first search).
226 The C3 method resolution order added in 5.10.0 has been re\-implemented as
227 a plugin, without changing its Perl\-space interface. See perlmroapi for
228 more information.
229 .ie n .SS "The ""overloading"" pragma"
230 .el .SS "The \f(CWoverloading\fP pragma"
231 .IX Subsection "The overloading pragma"
232 This pragma allows you to lexically disable or enable overloading
233 for some or all operations. (Yuval Kogman)
234 .SS "Parallel tests"
235 .IX Subsection "Parallel tests"
236 The core distribution can now run its regression tests in parallel on
237 Unix\-like platforms. Instead of running \f(CW\*(C`make test\*(C'\fR, set \f(CW\*(C`TEST_JOBS\*(C'\fR in
238 your environment to the number of tests to run in parallel, and run
239 \&\f(CW\*(C`make test_harness\*(C'\fR. On a Bourne\-like shell, this can be done as
240 .PP
241 .Vb 1
242 \& TEST_JOBS=3 make test_harness # Run 3 tests in parallel
243 .Ve
244 .PP
245 An environment variable is used, rather than parallel make itself, because
246 TAP::Harness needs to be able to schedule individual non\-conflicting test
247 scripts itself, and there is no standard interface to \f(CW\*(C`make\*(C'\fR utilities to
248 interact with their job schedulers.
249 .PP
250 Note that currently some test scripts may fail when run in parallel (most
251 notably \f(CW\*(C`ext/IO/t/io_dir.t\*(C'\fR). If necessary run just the failing scripts
252 again sequentially and see if the failures go away.
253 .SS "DTrace support"
254 .IX Subsection "DTrace support"
255 Some support for DTrace has been added. See "DTrace support" in \fIINSTALL\fR.
256 .ie n .SS "Support for ""configure_requires"" in CPAN module metadata"
257 .el .SS "Support for \f(CWconfigure_requires\fP in CPAN module metadata"
258 .IX Subsection "Support for configure_requires in CPAN module metadata"
259 Both \f(CW\*(C`CPAN\*(C'\fR and \f(CW\*(C`CPANPLUS\*(C'\fR now support the \f(CW\*(C`configure_requires\*(C'\fR keyword
260 in the \f(CW\*(C`META.yml\*(C'\fR metadata file included in most recent CPAN distributions.
261 This allows distribution authors to specify configuration prerequisites that
262 must be installed before running \fIMakefile.PL\fR or \fIBuild.PL\fR.
263 .PP
264 See the documentation for \f(CW\*(C`ExtUtils::MakeMaker\*(C'\fR or \f(CW\*(C`Module::Build\*(C'\fR for more
265 on how to specify \f(CW\*(C`configure_requires\*(C'\fR when creating a distribution for CPAN.
266 .SH "Modules and Pragmata"
267 .IX Header "Modules and Pragmata"
268 .SS "New Modules and Pragmata"
269 .IX Subsection "New Modules and Pragmata"
270 .ie n .IP """autodie""" 4
271 .el .IP \f(CWautodie\fR 4
272 .IX Item "autodie"
273 This is a new lexically\-scoped alternative for the \f(CW\*(C`Fatal\*(C'\fR module.
274 The bundled version is 2.06_01. Note that in this release, using a string
275 eval when \f(CW\*(C`autodie\*(C'\fR is in effect can cause the autodie behaviour to leak
276 into the surrounding scope. See "BUGS" in autodie for more details.
277 .ie n .IP """Compress::Raw::Bzip2""" 4
278 .el .IP \f(CWCompress::Raw::Bzip2\fR 4
279 .IX Item "Compress::Raw::Bzip2"
280 This has been added to the core (version 2.020).
281 .ie n .IP """parent""" 4
282 .el .IP \f(CWparent\fR 4
283 .IX Item "parent"
284 This pragma establishes an ISA relationship with base classes at compile
285 time. It provides the key feature of \f(CW\*(C`base\*(C'\fR without the feature creep.
286 .ie n .IP """Parse::CPAN::Meta""" 4
287 .el .IP \f(CWParse::CPAN::Meta\fR 4
288 .IX Item "Parse::CPAN::Meta"
289 This has been added to the core (version 1.39).
290 .SS "Pragmata Changes"
291 .IX Subsection "Pragmata Changes"
292 .ie n .IP """attributes""" 4
293 .el .IP \f(CWattributes\fR 4
294 .IX Item "attributes"
295 Upgraded from version 0.08 to 0.09.
296 .ie n .IP """attrs""" 4
297 .el .IP \f(CWattrs\fR 4
298 .IX Item "attrs"
299 Upgraded from version 1.02 to 1.03.
300 .ie n .IP """base""" 4
301 .el .IP \f(CWbase\fR 4
302 .IX Item "base"
303 Upgraded from version 2.13 to 2.14. See parent for a replacement.
304 .ie n .IP """bigint""" 4
305 .el .IP \f(CWbigint\fR 4
306 .IX Item "bigint"
307 Upgraded from version 0.22 to 0.23.
308 .ie n .IP """bignum""" 4
309 .el .IP \f(CWbignum\fR 4
310 .IX Item "bignum"
311 Upgraded from version 0.22 to 0.23.
312 .ie n .IP """bigrat""" 4
313 .el .IP \f(CWbigrat\fR 4
314 .IX Item "bigrat"
315 Upgraded from version 0.22 to 0.23.
316 .ie n .IP """charnames""" 4
317 .el .IP \f(CWcharnames\fR 4
318 .IX Item "charnames"
319 Upgraded from version 1.06 to 1.07.
320 .Sp
321 The Unicode \fINameAliases.txt\fR database file has been added. This has the
322 effect of adding some extra \f(CW\*(C`\eN\*(C'\fR character names that formerly wouldn\*(Aqt
323 have been recognised; for example, \f(CW"\eN{LATIN CAPITAL LETTER GHA}"\fR.
324 .ie n .IP """constant""" 4
325 .el .IP \f(CWconstant\fR 4
326 .IX Item "constant"
327 Upgraded from version 1.13 to 1.17.
328 .ie n .IP """feature""" 4
329 .el .IP \f(CWfeature\fR 4
330 .IX Item "feature"
331 The meaning of the \f(CW\*(C`:5.10\*(C'\fR and \f(CW\*(C`:5.10.X\*(C'\fR feature bundles has
332 changed slightly. The last component, if any (i.e. \f(CW\*(C`X\*(C'\fR) is simply ignored.
333 This is predicated on the assumption that new features will not, in
334 general, be added to maintenance releases. So \f(CW\*(C`:5.10\*(C'\fR and \f(CW\*(C`:5.10.X\*(C'\fR
335 have identical effect. This is a change to the behaviour documented for
336 5.10.0.
337 .ie n .IP """fields""" 4
338 .el .IP \f(CWfields\fR 4
339 .IX Item "fields"
340 Upgraded from version 2.13 to 2.14 (this was just a version bump; there
341 were no functional changes).
342 .ie n .IP """lib""" 4
343 .el .IP \f(CWlib\fR 4
344 .IX Item "lib"
345 Upgraded from version 0.5565 to 0.62.
346 .ie n .IP """open""" 4
347 .el .IP \f(CWopen\fR 4
348 .IX Item "open"
349 Upgraded from version 1.06 to 1.07.
350 .ie n .IP """overload""" 4
351 .el .IP \f(CWoverload\fR 4
352 .IX Item "overload"
353 Upgraded from version 1.06 to 1.07.
354 .ie n .IP """overloading""" 4
355 .el .IP \f(CWoverloading\fR 4
356 .IX Item "overloading"
357 See "The \f(CW\*(C`overloading\*(C'\fR pragma" above.
358 .ie n .IP """version""" 4
359 .el .IP \f(CWversion\fR 4
360 .IX Item "version"
361 Upgraded from version 0.74 to 0.77.
362 .SS "Updated Modules"
363 .IX Subsection "Updated Modules"
364 .ie n .IP """Archive::Extract""" 4
365 .el .IP \f(CWArchive::Extract\fR 4
366 .IX Item "Archive::Extract"
367 Upgraded from version 0.24 to 0.34.
368 .ie n .IP """Archive::Tar""" 4
369 .el .IP \f(CWArchive::Tar\fR 4
370 .IX Item "Archive::Tar"
371 Upgraded from version 1.38 to 1.52.
372 .ie n .IP """Attribute::Handlers""" 4
373 .el .IP \f(CWAttribute::Handlers\fR 4
374 .IX Item "Attribute::Handlers"
375 Upgraded from version 0.79 to 0.85.
376 .ie n .IP """AutoLoader""" 4
377 .el .IP \f(CWAutoLoader\fR 4
378 .IX Item "AutoLoader"
379 Upgraded from version 5.63 to 5.68.
380 .ie n .IP """AutoSplit""" 4
381 .el .IP \f(CWAutoSplit\fR 4
382 .IX Item "AutoSplit"
383 Upgraded from version 1.05 to 1.06.
384 .ie n .IP """B""" 4
385 .el .IP \f(CWB\fR 4
386 .IX Item "B"
387 Upgraded from version 1.17 to 1.22.
388 .ie n .IP """B::Debug""" 4
389 .el .IP \f(CWB::Debug\fR 4
390 .IX Item "B::Debug"
391 Upgraded from version 1.05 to 1.11.
392 .ie n .IP """B::Deparse""" 4
393 .el .IP \f(CWB::Deparse\fR 4
394 .IX Item "B::Deparse"
395 Upgraded from version 0.83 to 0.89.
396 .ie n .IP """B::Lint""" 4
397 .el .IP \f(CWB::Lint\fR 4
398 .IX Item "B::Lint"
399 Upgraded from version 1.09 to 1.11.
400 .ie n .IP """B::Xref""" 4
401 .el .IP \f(CWB::Xref\fR 4
402 .IX Item "B::Xref"
403 Upgraded from version 1.01 to 1.02.
404 .ie n .IP """Benchmark""" 4
405 .el .IP \f(CWBenchmark\fR 4
406 .IX Item "Benchmark"
407 Upgraded from version 1.10 to 1.11.
408 .ie n .IP """Carp""" 4
409 .el .IP \f(CWCarp\fR 4
410 .IX Item "Carp"
411 Upgraded from version 1.08 to 1.11.
412 .ie n .IP """CGI""" 4
413 .el .IP \f(CWCGI\fR 4
414 .IX Item "CGI"
415 Upgraded from version 3.29 to 3.43.
416 (also includes the "default_value for \fBpopup_menu()\fR" fix from 3.45).
417 .ie n .IP """Compress::Zlib""" 4
418 .el .IP \f(CWCompress::Zlib\fR 4
419 .IX Item "Compress::Zlib"
420 Upgraded from version 2.008 to 2.020.
421 .ie n .IP """CPAN""" 4
422 .el .IP \f(CWCPAN\fR 4
423 .IX Item "CPAN"
424 Upgraded from version 1.9205 to 1.9402. \f(CW\*(C`CPAN::FTP\*(C'\fR has a local fix to
425 stop it being too verbose on download failure.
426 .ie n .IP """CPANPLUS""" 4
427 .el .IP \f(CWCPANPLUS\fR 4
428 .IX Item "CPANPLUS"
429 Upgraded from version 0.84 to 0.88.
430 .ie n .IP """CPANPLUS::Dist::Build""" 4
431 .el .IP \f(CWCPANPLUS::Dist::Build\fR 4
432 .IX Item "CPANPLUS::Dist::Build"
433 Upgraded from version 0.06_02 to 0.36.
434 .ie n .IP """Cwd""" 4
435 .el .IP \f(CWCwd\fR 4
436 .IX Item "Cwd"
437 Upgraded from version 3.25_01 to 3.30.
438 .ie n .IP """Data::Dumper""" 4
439 .el .IP \f(CWData::Dumper\fR 4
440 .IX Item "Data::Dumper"
441 Upgraded from version 2.121_14 to 2.124.
442 .ie n .IP """DB""" 4
443 .el .IP \f(CWDB\fR 4
444 .IX Item "DB"
445 Upgraded from version 1.01 to 1.02.
446 .ie n .IP """DB_File""" 4
447 .el .IP \f(CWDB_File\fR 4
448 .IX Item "DB_File"
449 Upgraded from version 1.816_1 to 1.820.
450 .ie n .IP """Devel::PPPort""" 4
451 .el .IP \f(CWDevel::PPPort\fR 4
452 .IX Item "Devel::PPPort"
453 Upgraded from version 3.13 to 3.19.
454 .ie n .IP """Digest::MD5""" 4
455 .el .IP \f(CWDigest::MD5\fR 4
456 .IX Item "Digest::MD5"
457 Upgraded from version 2.36_01 to 2.39.
458 .ie n .IP """Digest::SHA""" 4
459 .el .IP \f(CWDigest::SHA\fR 4
460 .IX Item "Digest::SHA"
461 Upgraded from version 5.45 to 5.47.
462 .ie n .IP """DirHandle""" 4
463 .el .IP \f(CWDirHandle\fR 4
464 .IX Item "DirHandle"
465 Upgraded from version 1.01 to 1.03.
466 .ie n .IP """Dumpvalue""" 4
467 .el .IP \f(CWDumpvalue\fR 4
468 .IX Item "Dumpvalue"
469 Upgraded from version 1.12 to 1.13.
470 .ie n .IP """DynaLoader""" 4
471 .el .IP \f(CWDynaLoader\fR 4
472 .IX Item "DynaLoader"
473 Upgraded from version 1.08 to 1.10.
474 .ie n .IP """Encode""" 4
475 .el .IP \f(CWEncode\fR 4
476 .IX Item "Encode"
477 Upgraded from version 2.23 to 2.35.
478 .ie n .IP """Errno""" 4
479 .el .IP \f(CWErrno\fR 4
480 .IX Item "Errno"
481 Upgraded from version 1.10 to 1.11.
482 .ie n .IP """Exporter""" 4
483 .el .IP \f(CWExporter\fR 4
484 .IX Item "Exporter"
485 Upgraded from version 5.62 to 5.63.
486 .ie n .IP """ExtUtils::CBuilder""" 4
487 .el .IP \f(CWExtUtils::CBuilder\fR 4
488 .IX Item "ExtUtils::CBuilder"
489 Upgraded from version 0.21 to 0.2602.
490 .ie n .IP """ExtUtils::Command""" 4
491 .el .IP \f(CWExtUtils::Command\fR 4
492 .IX Item "ExtUtils::Command"
493 Upgraded from version 1.13 to 1.16.
494 .ie n .IP """ExtUtils::Constant""" 4
495 .el .IP \f(CWExtUtils::Constant\fR 4
496 .IX Item "ExtUtils::Constant"
497 Upgraded from 0.20 to 0.22. (Note that neither of these versions are
498 available on CPAN.)
499 .ie n .IP """ExtUtils::Embed""" 4
500 .el .IP \f(CWExtUtils::Embed\fR 4
501 .IX Item "ExtUtils::Embed"
502 Upgraded from version 1.27 to 1.28.
503 .ie n .IP """ExtUtils::Install""" 4
504 .el .IP \f(CWExtUtils::Install\fR 4
505 .IX Item "ExtUtils::Install"
506 Upgraded from version 1.44 to 1.54.
507 .ie n .IP """ExtUtils::MakeMaker""" 4
508 .el .IP \f(CWExtUtils::MakeMaker\fR 4
509 .IX Item "ExtUtils::MakeMaker"
510 Upgraded from version 6.42 to 6.55_02.
511 .Sp
512 Note that \f(CW\*(C`ExtUtils::MakeMaker::bytes\*(C'\fR and \f(CW\*(C`ExtUtils::MakeMaker::vmsish\*(C'\fR
513 have been removed from this distribution.
514 .ie n .IP """ExtUtils::Manifest""" 4
515 .el .IP \f(CWExtUtils::Manifest\fR 4
516 .IX Item "ExtUtils::Manifest"
517 Upgraded from version 1.51_01 to 1.56.
518 .ie n .IP """ExtUtils::ParseXS""" 4
519 .el .IP \f(CWExtUtils::ParseXS\fR 4
520 .IX Item "ExtUtils::ParseXS"
521 Upgraded from version 2.18_02 to 2.2002.
522 .ie n .IP """Fatal""" 4
523 .el .IP \f(CWFatal\fR 4
524 .IX Item "Fatal"
525 Upgraded from version 1.05 to 2.06_01. See also the new pragma \f(CW\*(C`autodie\*(C'\fR.
526 .ie n .IP """File::Basename""" 4
527 .el .IP \f(CWFile::Basename\fR 4
528 .IX Item "File::Basename"
529 Upgraded from version 2.76 to 2.77.
530 .ie n .IP """File::Compare""" 4
531 .el .IP \f(CWFile::Compare\fR 4
532 .IX Item "File::Compare"
533 Upgraded from version 1.1005 to 1.1006.
534 .ie n .IP """File::Copy""" 4
535 .el .IP \f(CWFile::Copy\fR 4
536 .IX Item "File::Copy"
537 Upgraded from version 2.11 to 2.14.
538 .ie n .IP """File::Fetch""" 4
539 .el .IP \f(CWFile::Fetch\fR 4
540 .IX Item "File::Fetch"
541 Upgraded from version 0.14 to 0.20.
542 .ie n .IP """File::Find""" 4
543 .el .IP \f(CWFile::Find\fR 4
544 .IX Item "File::Find"
545 Upgraded from version 1.12 to 1.14.
546 .ie n .IP """File::Path""" 4
547 .el .IP \f(CWFile::Path\fR 4
548 .IX Item "File::Path"
549 Upgraded from version 2.04 to 2.07_03.
550 .ie n .IP """File::Spec""" 4
551 .el .IP \f(CWFile::Spec\fR 4
552 .IX Item "File::Spec"
553 Upgraded from version 3.2501 to 3.30.
554 .ie n .IP """File::stat""" 4
555 .el .IP \f(CWFile::stat\fR 4
556 .IX Item "File::stat"
557 Upgraded from version 1.00 to 1.01.
558 .ie n .IP """File::Temp""" 4
559 .el .IP \f(CWFile::Temp\fR 4
560 .IX Item "File::Temp"
561 Upgraded from version 0.18 to 0.22.
562 .ie n .IP """FileCache""" 4
563 .el .IP \f(CWFileCache\fR 4
564 .IX Item "FileCache"
565 Upgraded from version 1.07 to 1.08.
566 .ie n .IP """FileHandle""" 4
567 .el .IP \f(CWFileHandle\fR 4
568 .IX Item "FileHandle"
569 Upgraded from version 2.01 to 2.02.
570 .ie n .IP """Filter::Simple""" 4
571 .el .IP \f(CWFilter::Simple\fR 4
572 .IX Item "Filter::Simple"
573 Upgraded from version 0.82 to 0.84.
574 .ie n .IP """Filter::Util::Call""" 4
575 .el .IP \f(CWFilter::Util::Call\fR 4
576 .IX Item "Filter::Util::Call"
577 Upgraded from version 1.07 to 1.08.
578 .ie n .IP """FindBin""" 4
579 .el .IP \f(CWFindBin\fR 4
580 .IX Item "FindBin"
581 Upgraded from version 1.49 to 1.50.
582 .ie n .IP """GDBM_File""" 4
583 .el .IP \f(CWGDBM_File\fR 4
584 .IX Item "GDBM_File"
585 Upgraded from version 1.08 to 1.09.
586 .ie n .IP """Getopt::Long""" 4
587 .el .IP \f(CWGetopt::Long\fR 4
588 .IX Item "Getopt::Long"
589 Upgraded from version 2.37 to 2.38.
590 .ie n .IP """Hash::Util::FieldHash""" 4
591 .el .IP \f(CWHash::Util::FieldHash\fR 4
592 .IX Item "Hash::Util::FieldHash"
593 Upgraded from version 1.03 to 1.04. This fixes a memory leak.
594 .ie n .IP """I18N::Collate""" 4
595 .el .IP \f(CWI18N::Collate\fR 4
596 .IX Item "I18N::Collate"
597 Upgraded from version 1.00 to 1.01.
598 .ie n .IP """IO""" 4
599 .el .IP \f(CWIO\fR 4
600 .IX Item "IO"
601 Upgraded from version 1.23_01 to 1.25.
602 .Sp
603 This makes non\-blocking mode work on Windows in \f(CW\*(C`IO::Socket::INET\*(C'\fR
604 [CPAN #43573].
605 .ie n .IP """IO::Compress::*""" 4
606 .el .IP \f(CWIO::Compress::*\fR 4
607 .IX Item "IO::Compress::*"
608 Upgraded from version 2.008 to 2.020.
609 .ie n .IP """IO::Dir""" 4
610 .el .IP \f(CWIO::Dir\fR 4
611 .IX Item "IO::Dir"
612 Upgraded from version 1.06 to 1.07.
613 .ie n .IP """IO::Handle""" 4
614 .el .IP \f(CWIO::Handle\fR 4
615 .IX Item "IO::Handle"
616 Upgraded from version 1.27 to 1.28.
617 .ie n .IP """IO::Socket""" 4
618 .el .IP \f(CWIO::Socket\fR 4
619 .IX Item "IO::Socket"
620 Upgraded from version 1.30_01 to 1.31.
621 .ie n .IP """IO::Zlib""" 4
622 .el .IP \f(CWIO::Zlib\fR 4
623 .IX Item "IO::Zlib"
624 Upgraded from version 1.07 to 1.09.
625 .ie n .IP """IPC::Cmd""" 4
626 .el .IP \f(CWIPC::Cmd\fR 4
627 .IX Item "IPC::Cmd"
628 Upgraded from version 0.40_1 to 0.46.
629 .ie n .IP """IPC::Open3""" 4
630 .el .IP \f(CWIPC::Open3\fR 4
631 .IX Item "IPC::Open3"
632 Upgraded from version 1.02 to 1.04.
633 .ie n .IP """IPC::SysV""" 4
634 .el .IP \f(CWIPC::SysV\fR 4
635 .IX Item "IPC::SysV"
636 Upgraded from version 1.05 to 2.01.
637 .ie n .IP """lib""" 4
638 .el .IP \f(CWlib\fR 4
639 .IX Item "lib"
640 Upgraded from version 0.5565 to 0.62.
641 .ie n .IP """List::Util""" 4
642 .el .IP \f(CWList::Util\fR 4
643 .IX Item "List::Util"
644 Upgraded from version 1.19 to 1.21.
645 .ie n .IP """Locale::MakeText""" 4
646 .el .IP \f(CWLocale::MakeText\fR 4
647 .IX Item "Locale::MakeText"
648 Upgraded from version 1.12 to 1.13.
649 .ie n .IP """Log::Message""" 4
650 .el .IP \f(CWLog::Message\fR 4
651 .IX Item "Log::Message"
652 Upgraded from version 0.01 to 0.02.
653 .ie n .IP """Math::BigFloat""" 4
654 .el .IP \f(CWMath::BigFloat\fR 4
655 .IX Item "Math::BigFloat"
656 Upgraded from version 1.59 to 1.60.
657 .ie n .IP """Math::BigInt""" 4
658 .el .IP \f(CWMath::BigInt\fR 4
659 .IX Item "Math::BigInt"
660 Upgraded from version 1.88 to 1.89.
661 .ie n .IP """Math::BigInt::FastCalc""" 4
662 .el .IP \f(CWMath::BigInt::FastCalc\fR 4
663 .IX Item "Math::BigInt::FastCalc"
664 Upgraded from version 0.16 to 0.19.
665 .ie n .IP """Math::BigRat""" 4
666 .el .IP \f(CWMath::BigRat\fR 4
667 .IX Item "Math::BigRat"
668 Upgraded from version 0.21 to 0.22.
669 .ie n .IP """Math::Complex""" 4
670 .el .IP \f(CWMath::Complex\fR 4
671 .IX Item "Math::Complex"
672 Upgraded from version 1.37 to 1.56.
673 .ie n .IP """Math::Trig""" 4
674 .el .IP \f(CWMath::Trig\fR 4
675 .IX Item "Math::Trig"
676 Upgraded from version 1.04 to 1.20.
677 .ie n .IP """Memoize""" 4
678 .el .IP \f(CWMemoize\fR 4
679 .IX Item "Memoize"
680 Upgraded from version 1.01_02 to 1.01_03 (just a minor documentation
681 change).
682 .ie n .IP """Module::Build""" 4
683 .el .IP \f(CWModule::Build\fR 4
684 .IX Item "Module::Build"
685 Upgraded from version 0.2808_01 to 0.34_02.
686 .ie n .IP """Module::CoreList""" 4
687 .el .IP \f(CWModule::CoreList\fR 4
688 .IX Item "Module::CoreList"
689 Upgraded from version 2.13 to 2.18. This release no longer contains the
690 \&\f(CW%Module::CoreList::patchlevel\fR hash.
691 .ie n .IP """Module::Load""" 4
692 .el .IP \f(CWModule::Load\fR 4
693 .IX Item "Module::Load"
694 Upgraded from version 0.12 to 0.16.
695 .ie n .IP """Module::Load::Conditional""" 4
696 .el .IP \f(CWModule::Load::Conditional\fR 4
697 .IX Item "Module::Load::Conditional"
698 Upgraded from version 0.22 to 0.30.
699 .ie n .IP """Module::Loaded""" 4
700 .el .IP \f(CWModule::Loaded\fR 4
701 .IX Item "Module::Loaded"
702 Upgraded from version 0.01 to 0.02.
703 .ie n .IP """Module::Pluggable""" 4
704 .el .IP \f(CWModule::Pluggable\fR 4
705 .IX Item "Module::Pluggable"
706 Upgraded from version 3.6 to 3.9.
707 .ie n .IP """NDBM_File""" 4
708 .el .IP \f(CWNDBM_File\fR 4
709 .IX Item "NDBM_File"
710 Upgraded from version 1.07 to 1.08.
711 .ie n .IP """Net::Ping""" 4
712 .el .IP \f(CWNet::Ping\fR 4
713 .IX Item "Net::Ping"
714 Upgraded from version 2.33 to 2.36.
715 .ie n .IP """NEXT""" 4
716 .el .IP \f(CWNEXT\fR 4
717 .IX Item "NEXT"
718 Upgraded from version 0.60_01 to 0.64.
719 .ie n .IP """Object::Accessor""" 4
720 .el .IP \f(CWObject::Accessor\fR 4
721 .IX Item "Object::Accessor"
722 Upgraded from version 0.32 to 0.34.
723 .ie n .IP """OS2::REXX""" 4
724 .el .IP \f(CWOS2::REXX\fR 4
725 .IX Item "OS2::REXX"
726 Upgraded from version 1.03 to 1.04.
727 .ie n .IP """Package::Constants""" 4
728 .el .IP \f(CWPackage::Constants\fR 4
729 .IX Item "Package::Constants"
730 Upgraded from version 0.01 to 0.02.
731 .ie n .IP """PerlIO""" 4
732 .el .IP \f(CWPerlIO\fR 4
733 .IX Item "PerlIO"
734 Upgraded from version 1.04 to 1.06.
735 .ie n .IP """PerlIO::via""" 4
736 .el .IP \f(CWPerlIO::via\fR 4
737 .IX Item "PerlIO::via"
738 Upgraded from version 0.04 to 0.07.
739 .ie n .IP """Pod::Man""" 4
740 .el .IP \f(CWPod::Man\fR 4
741 .IX Item "Pod::Man"
742 Upgraded from version 2.16 to 2.22.
743 .ie n .IP """Pod::Parser""" 4
744 .el .IP \f(CWPod::Parser\fR 4
745 .IX Item "Pod::Parser"
746 Upgraded from version 1.35 to 1.37.
747 .ie n .IP """Pod::Simple""" 4
748 .el .IP \f(CWPod::Simple\fR 4
749 .IX Item "Pod::Simple"
750 Upgraded from version 3.05 to 3.07.
751 .ie n .IP """Pod::Text""" 4
752 .el .IP \f(CWPod::Text\fR 4
753 .IX Item "Pod::Text"
754 Upgraded from version 3.08 to 3.13.
755 .ie n .IP """POSIX""" 4
756 .el .IP \f(CWPOSIX\fR 4
757 .IX Item "POSIX"
758 Upgraded from version 1.13 to 1.17.
759 .ie n .IP """Safe""" 4
760 .el .IP \f(CWSafe\fR 4
761 .IX Item "Safe"
762 Upgraded from 2.12 to 2.18.
763 .ie n .IP """Scalar::Util""" 4
764 .el .IP \f(CWScalar::Util\fR 4
765 .IX Item "Scalar::Util"
766 Upgraded from version 1.19 to 1.21.
767 .ie n .IP """SelectSaver""" 4
768 .el .IP \f(CWSelectSaver\fR 4
769 .IX Item "SelectSaver"
770 Upgraded from 1.01 to 1.02.
771 .ie n .IP """SelfLoader""" 4
772 .el .IP \f(CWSelfLoader\fR 4
773 .IX Item "SelfLoader"
774 Upgraded from 1.11 to 1.17.
775 .ie n .IP """Socket""" 4
776 .el .IP \f(CWSocket\fR 4
777 .IX Item "Socket"
778 Upgraded from 1.80 to 1.82.
779 .ie n .IP """Storable""" 4
780 .el .IP \f(CWStorable\fR 4
781 .IX Item "Storable"
782 Upgraded from 2.18 to 2.20.
783 .ie n .IP """Switch""" 4
784 .el .IP \f(CWSwitch\fR 4
785 .IX Item "Switch"
786 Upgraded from version 2.13 to 2.14. Please see "Deprecations".
787 .ie n .IP """Symbol""" 4
788 .el .IP \f(CWSymbol\fR 4
789 .IX Item "Symbol"
790 Upgraded from version 1.06 to 1.07.
791 .ie n .IP """Sys::Syslog""" 4
792 .el .IP \f(CWSys::Syslog\fR 4
793 .IX Item "Sys::Syslog"
794 Upgraded from version 0.22 to 0.27.
795 .ie n .IP """Term::ANSIColor""" 4
796 .el .IP \f(CWTerm::ANSIColor\fR 4
797 .IX Item "Term::ANSIColor"
798 Upgraded from version 1.12 to 2.00.
799 .ie n .IP """Term::ReadLine""" 4
800 .el .IP \f(CWTerm::ReadLine\fR 4
801 .IX Item "Term::ReadLine"
802 Upgraded from version 1.03 to 1.04.
803 .ie n .IP """Term::UI""" 4
804 .el .IP \f(CWTerm::UI\fR 4
805 .IX Item "Term::UI"
806 Upgraded from version 0.18 to 0.20.
807 .ie n .IP """Test::Harness""" 4
808 .el .IP \f(CWTest::Harness\fR 4
809 .IX Item "Test::Harness"
810 Upgraded from version 2.64 to 3.17.
811 .Sp
812 Note that one side\-effect of the 2.x to 3.x upgrade is that the
813 experimental \f(CW\*(C`Test::Harness::Straps\*(C'\fR module (and its supporting
814 \&\f(CW\*(C`Assert\*(C'\fR, \f(CW\*(C`Iterator\*(C'\fR, \f(CW\*(C`Point\*(C'\fR and \f(CW\*(C`Results\*(C'\fR modules) have been
815 removed. If you still need this, then they are available in the
816 (unmaintained) \f(CW\*(C`Test\-Harness\-Straps\*(C'\fR distribution on CPAN.
817 .ie n .IP """Test::Simple""" 4
818 .el .IP \f(CWTest::Simple\fR 4
819 .IX Item "Test::Simple"
820 Upgraded from version 0.72 to 0.92.
821 .ie n .IP """Text::ParseWords""" 4
822 .el .IP \f(CWText::ParseWords\fR 4
823 .IX Item "Text::ParseWords"
824 Upgraded from version 3.26 to 3.27.
825 .ie n .IP """Text::Tabs""" 4
826 .el .IP \f(CWText::Tabs\fR 4
827 .IX Item "Text::Tabs"
828 Upgraded from version 2007.1117 to 2009.0305.
829 .ie n .IP """Text::Wrap""" 4
830 .el .IP \f(CWText::Wrap\fR 4
831 .IX Item "Text::Wrap"
832 Upgraded from version 2006.1117 to 2009.0305.
833 .ie n .IP """Thread::Queue""" 4
834 .el .IP \f(CWThread::Queue\fR 4
835 .IX Item "Thread::Queue"
836 Upgraded from version 2.00 to 2.11.
837 .ie n .IP """Thread::Semaphore""" 4
838 .el .IP \f(CWThread::Semaphore\fR 4
839 .IX Item "Thread::Semaphore"
840 Upgraded from version 2.01 to 2.09.
841 .ie n .IP """threads""" 4
842 .el .IP \f(CWthreads\fR 4
843 .IX Item "threads"
844 Upgraded from version 1.67 to 1.72.
845 .ie n .IP """threads::shared""" 4
846 .el .IP \f(CWthreads::shared\fR 4
847 .IX Item "threads::shared"
848 Upgraded from version 1.14 to 1.29.
849 .ie n .IP """Tie::RefHash""" 4
850 .el .IP \f(CWTie::RefHash\fR 4
851 .IX Item "Tie::RefHash"
852 Upgraded from version 1.37 to 1.38.
853 .ie n .IP """Tie::StdHandle""" 4
854 .el .IP \f(CWTie::StdHandle\fR 4
855 .IX Item "Tie::StdHandle"
856 This has documentation changes, and has been assigned a version for the
857 first time: version 4.2.
858 .ie n .IP """Time::HiRes""" 4
859 .el .IP \f(CWTime::HiRes\fR 4
860 .IX Item "Time::HiRes"
861 Upgraded from version 1.9711 to 1.9719.
862 .ie n .IP """Time::Local""" 4
863 .el .IP \f(CWTime::Local\fR 4
864 .IX Item "Time::Local"
865 Upgraded from version 1.18 to 1.1901.
866 .ie n .IP """Time::Piece""" 4
867 .el .IP \f(CWTime::Piece\fR 4
868 .IX Item "Time::Piece"
869 Upgraded from version 1.12 to 1.15.
870 .ie n .IP """Unicode::Normalize""" 4
871 .el .IP \f(CWUnicode::Normalize\fR 4
872 .IX Item "Unicode::Normalize"
873 Upgraded from version 1.02 to 1.03.
874 .ie n .IP """Unicode::UCD""" 4
875 .el .IP \f(CWUnicode::UCD\fR 4
876 .IX Item "Unicode::UCD"
877 Upgraded from version 0.25 to 0.27.
878 .Sp
879 \&\f(CWcharinfo()\fR now works on Unified CJK code points added to later versions
880 of Unicode.
881 .Sp
882 \&\f(CWcasefold()\fR has new fields returned to provide both a simpler interface
883 and previously missing information. The old fields are retained for
884 backwards compatibility. Information about Turkic\-specific code points is
885 now returned.
886 .Sp
887 The documentation has been corrected and expanded.
888 .ie n .IP """UNIVERSAL""" 4
889 .el .IP \f(CWUNIVERSAL\fR 4
890 .IX Item "UNIVERSAL"
891 Upgraded from version 1.04 to 1.05.
892 .ie n .IP """Win32""" 4
893 .el .IP \f(CWWin32\fR 4
894 .IX Item "Win32"
895 Upgraded from version 0.34 to 0.39.
896 .ie n .IP """Win32API::File""" 4
897 .el .IP \f(CWWin32API::File\fR 4
898 .IX Item "Win32API::File"
899 Upgraded from version 0.1001_01 to 0.1101.
900 .ie n .IP """XSLoader""" 4
901 .el .IP \f(CWXSLoader\fR 4
902 .IX Item "XSLoader"
903 Upgraded from version 0.08 to 0.10.
904 .SH "Utility Changes"
905 .IX Header "Utility Changes"
906 .IP \fIh2ph\fR 4
907 .IX Item "h2ph"
908 Now looks in \f(CW\*(C`include\-fixed\*(C'\fR too, which is a recent addition to gcc\*(Aqs
909 search path.
910 .IP \fIh2xs\fR 4
911 .IX Item "h2xs"
912 No longer incorrectly treats enum values like macros (Daniel Burr).
913 .Sp
914 Now handles C++ style constants (\f(CW\*(C`//\*(C'\fR) properly in enums. (A patch from
915 Rainer Weikusat was used; Daniel Burr also proposed a similar fix).
916 .IP \fIperl5db.pl\fR 4
917 .IX Item "perl5db.pl"
918 \&\f(CW\*(C`LVALUE\*(C'\fR subroutines now work under the debugger.
919 .Sp
920 The debugger now correctly handles proxy constant subroutines, and
921 subroutine stubs.
922 .IP \fIperlthanks\fR 4
923 .IX Item "perlthanks"
924 Perl 5.10.1 adds a new utility \fIperlthanks\fR, which is a variant of
925 \&\fIperlbug\fR, but for sending non\-bug\-reports to the authors and maintainers
926 of Perl. Getting nothing but bug reports can become a bit demoralising:
927 we\*(Aqll see if this changes things.
928 .SH "New Documentation"
929 .IX Header "New Documentation"
930 .IP perlhaiku 4
931 .IX Item "perlhaiku"
932 This contains instructions on how to build perl for the Haiku platform.
933 .IP perlmroapi 4
934 .IX Item "perlmroapi"
935 This describes the new interface for pluggable Method Resolution Orders.
936 .IP perlperf 4
937 .IX Item "perlperf"
938 This document, by Richard Foley, provides an introduction to the use of
939 performance and optimization techniques which can be used with particular
940 reference to perl programs.
941 .IP perlrepository 4
942 .IX Item "perlrepository"
943 This describes how to access the perl source using the \fIgit\fR version
944 control system.
945 .IP perlthanks 4
946 .IX Item "perlthanks"
947 This describes the new \fIperlthanks\fR utility.
948 .SH "Changes to Existing Documentation"
949 .IX Header "Changes to Existing Documentation"
950 The various large \f(CW\*(C`Changes*\*(C'\fR files (which listed every change made to perl
951 over the last 18 years) have been removed, and replaced by a small file,
952 also called \f(CW\*(C`Changes\*(C'\fR, which just explains how that same information may
953 be extracted from the git version control system.
954 .PP
955 The file \fIPorting/patching.pod\fR has been deleted, as it mainly described
956 interacting with the old Perforce\-based repository, which is now obsolete.
957 Information still relevant has been moved to perlrepository.
958 .PP
959 perlapi, perlintern, perlmodlib and perltoc are now all
960 generated at build time, rather than being shipped as part of the release.
961 .SH "Performance Enhancements"
962 .IX Header "Performance Enhancements"
963 .IP \(bu 4
964 A new internal cache means that \f(CWisa()\fR will often be faster.
965 .IP \(bu 4
966 Under \f(CW\*(C`use locale\*(C'\fR, the locale\-relevant information is now cached on
967 read\-only values, such as the list returned by \f(CW\*(C`keys %hash\*(C'\fR. This makes
968 operations such as \f(CW\*(C`sort keys %hash\*(C'\fR in the scope of \f(CW\*(C`use locale\*(C'\fR much
969 faster.
970 .IP \(bu 4
971 Empty \f(CW\*(C`DESTROY\*(C'\fR methods are no longer called.
972 .SH "Installation and Configuration Improvements"
973 .IX Header "Installation and Configuration Improvements"
974 .SS "\fIext/\fP reorganisation"
975 .IX Subsection "ext/ reorganisation"
976 The layout of directories in \fIext\fR has been revised. Specifically, all
977 extensions are now flat, and at the top level, with \f(CW\*(C`/\*(C'\fR in pathnames
978 replaced by \f(CW\*(C`\-\*(C'\fR, so that \fIext/Data/Dumper/\fR is now \fIext/Data\-Dumper/\fR,
979 etc. The names of the extensions as specified to \fIConfigure\fR, and as
980 reported by \f(CW%Config::Config\fR under the keys \f(CW\*(C`dynamic_ext\*(C'\fR,
981 \&\f(CW\*(C`known_extensions\*(C'\fR, \f(CW\*(C`nonxs_ext\*(C'\fR and \f(CW\*(C`static_ext\*(C'\fR have not changed, and
982 still use \f(CW\*(C`/\*(C'\fR. Hence this change will not have any effect once perl is
983 installed. However, \f(CW\*(C`Attribute::Handlers\*(C'\fR, \f(CW\*(C`Safe\*(C'\fR and \f(CW\*(C`mro\*(C'\fR have now
984 become extensions in their own right, so if you run \fIConfigure\fR with
985 options to specify an exact list of extensions to build, you will need to
986 change it to account for this.
987 .PP
988 For 5.10.2, it is planned that many dual\-life modules will have been moved
989 from \fIlib\fR to \fIext\fR; again this will have no effect on an installed
990 perl, but will matter if you invoke \fIConfigure\fR with a pre\-canned list of
991 extensions to build.
992 .SS "Configuration improvements"
993 .IX Subsection "Configuration improvements"
994 If \f(CW\*(C`vendorlib\*(C'\fR and \f(CW\*(C`vendorarch\*(C'\fR are the same, then they are only added to
995 \&\f(CW@INC\fR once.
996 .PP
997 \&\f(CW$Config{usedevel}\fR and the C\-level \f(CW\*(C`PERL_USE_DEVEL\*(C'\fR are now defined if
998 perl is built with \f(CW\*(C`\-Dusedevel\*(C'\fR.
999 .PP
1000 \&\fIConfigure\fR will enable use of \f(CW\*(C`\-fstack\-protector\*(C'\fR, to provide protection
1001 against stack\-smashing attacks, if the compiler supports it.
1002 .PP
1003 \&\fIConfigure\fR will now determine the correct prototypes for re\-entrant
1004 functions, and for \f(CW\*(C`gconvert\*(C'\fR, if you are using a C++ compiler rather
1005 than a C compiler.
1006 .PP
1007 On Unix, if you build from a tree containing a git repository, the
1008 configuration process will note the commit hash you have checked out, for
1009 display in the output of \f(CW\*(C`perl \-v\*(C'\fR and \f(CW\*(C`perl \-V\*(C'\fR. Unpushed local commits
1010 are automatically added to the list of local patches displayed by
1011 \&\f(CW\*(C`perl \-V\*(C'\fR.
1012 .SS "Compilation improvements"
1013 .IX Subsection "Compilation improvements"
1014 As part of the flattening of \fIext\fR, all extensions on all platforms are
1015 built by \fImake_ext.pl\fR. This replaces the Unix\-specific
1016 \&\fIext/util/make_ext\fR, VMS\-specific \fImake_ext.com\fR and Win32\-specific
1017 \&\fIwin32/buildext.pl\fR.
1018 .SS "Platform Specific Changes"
1019 .IX Subsection "Platform Specific Changes"
1020 .IP AIX 4
1021 .IX Item "AIX"
1022 Removed \fIlibbsd\fR for AIX 5L and 6.1. Only \fBflock()\fR was used from \fIlibbsd\fR.
1023 .Sp
1024 Removed \fIlibgdbm\fR for AIX 5L and 6.1. The \fIlibgdbm\fR is delivered as an
1025 optional package with the AIX Toolbox. Unfortunately the 64 bit version
1026 is broken.
1027 .Sp
1028 Hints changes mean that AIX 4.2 should work again.
1029 .IP Cygwin 4
1030 .IX Item "Cygwin"
1031 On Cygwin we now strip the last number from the DLL. This has been the
1032 behaviour in the cygwin.com build for years. The hints files have been
1033 updated.
1034 .IP FreeBSD 4
1035 .IX Item "FreeBSD"
1036 The hints files now identify the correct threading libraries on FreeBSD 7
1037 and later.
1038 .IP Irix 4
1039 .IX Item "Irix"
1040 We now work around a bizarre preprocessor bug in the Irix 6.5 compiler:
1041 \&\f(CW\*(C`cc \-E \-\*(C'\fR unfortunately goes into K&R mode, but \f(CW\*(C`cc \-E file.c\*(C'\fR doesn\*(Aqt.
1042 .IP Haiku 4
1043 .IX Item "Haiku"
1044 Patches from the Haiku maintainers have been merged in. Perl should now
1045 build on Haiku.
1046 .IP "MirOS BSD" 4
1047 .IX Item "MirOS BSD"
1048 Perl should now build on MirOS BSD.
1049 .IP NetBSD 4
1050 .IX Item "NetBSD"
1051 Hints now supports versions 5.*.
1052 .IP "Stratus VOS" 4
1053 .IX Item "Stratus VOS"
1054 Various changes from Stratus have been merged in.
1055 .IP Symbian 4
1056 .IX Item "Symbian"
1057 There is now support for Symbian S60 3.2 SDK and S60 5.0 SDK.
1058 .IP Win32 4
1059 .IX Item "Win32"
1060 Improved message window handling means that \f(CW\*(C`alarm\*(C'\fR and \f(CW\*(C`kill\*(C'\fR messages
1061 will no longer be dropped under race conditions.
1062 .IP VMS 4
1063 .IX Item "VMS"
1064 Reads from the in\-memory temporary files of \f(CW\*(C`PerlIO::scalar\*(C'\fR used to fail
1065 if \f(CW$/\fR was set to a numeric reference (to indicate record\-style reads).
1066 This is now fixed.
1067 .Sp
1068 VMS now supports \f(CW\*(C`getgrgid\*(C'\fR.
1069 .Sp
1070 Many improvements and cleanups have been made to the VMS file name handling
1071 and conversion code.
1072 .Sp
1073 Enabling the \f(CW\*(C`PERL_VMS_POSIX_EXIT\*(C'\fR logical name now encodes a POSIX exit
1074 status in a VMS condition value for better interaction with GNV\*(Aqs bash
1075 shell and other utilities that depend on POSIX exit values. See
1076 "$?" in perlvms for details.
1077 .SH "Selected Bug Fixes"
1078 .IX Header "Selected Bug Fixes"
1079 .IP \(bu 4
1080 5.10.0 inadvertently disabled an optimisation, which caused a measurable
1081 performance drop in list assignment, such as is often used to assign
1082 function parameters from \f(CW@_\fR. The optimisation has been re\-instated, and
1083 the performance regression fixed.
1084 .IP \(bu 4
1085 Fixed memory leak on \f(CW\*(C`while (1) { map 1, 1 }\*(C'\fR [RT #53038].
1086 .IP \(bu 4
1087 Some potential coredumps in PerlIO fixed [RT #57322,54828].
1088 .IP \(bu 4
1089 The debugger now works with lvalue subroutines.
1090 .IP \(bu 4
1091 The debugger\*(Aqs \f(CW\*(C`m\*(C'\fR command was broken on modules that defined constants
1092 [RT #61222].
1093 .IP \(bu 4
1094 \&\f(CWcrypt()\fR and string complement could return tainted values for untainted
1095 arguments [RT #59998].
1096 .IP \(bu 4
1097 The \f(CW\*(C`\-i.suffix\*(C'\fR command\-line switch now recreates the file using
1098 restricted permissions, before changing its mode to match the original
1099 file. This eliminates a potential race condition [RT #60904].
1100 .IP \(bu 4
1101 On some Unix systems, the value in \f(CW$?\fR would not have the top bit set
1102 (\f(CW\*(C`$? & 128\*(C'\fR) even if the child core dumped.
1103 .IP \(bu 4
1104 Under some circumstances, $^R could incorrectly become undefined
1105 [RT #57042].
1106 .IP \(bu 4
1107 (XS) In various hash functions, passing a pre\-computed hash to when the
1108 key is UTF\-8 might result in an incorrect lookup.
1109 .IP \(bu 4
1110 (XS) Including \fIXSUB.h\fR before \fIperl.h\fR gave a compile\-time error
1111 [RT #57176].
1112 .IP \(bu 4
1113 \&\f(CW\*(C`$object\->isa(\*(AqFoo\*(Aq)\*(C'\fR would report false if the package \f(CW\*(C`Foo\*(C'\fR didn\*(Aqt
1114 exist, even if the object\*(Aqs \f(CW@ISA\fR contained \f(CW\*(C`Foo\*(C'\fR.
1115 .IP \(bu 4
1116 Various bugs in the new\-to 5.10.0 mro code, triggered by manipulating
1117 \&\f(CW@ISA\fR, have been found and fixed.
1118 .IP \(bu 4
1119 Bitwise operations on references could crash the interpreter, e.g.
1120 \&\f(CW\*(C`$x=\e$y; $x |= "foo"\*(C'\fR [RT #54956].
1121 .IP \(bu 4
1122 Patterns including alternation might be sensitive to the internal UTF\-8
1123 representation, e.g.
1124 .Sp
1125 .Vb 3
1126 \& my $byte = chr(192);
1127 \& my $utf8 = chr(192); utf8::upgrade($utf8);
1128 \& $utf8 =~ /$byte|X}/i; # failed in 5.10.0
1129 .Ve
1130 .IP \(bu 4
1131 Within UTF8\-encoded Perl source files (i.e. where \f(CW\*(C`use utf8\*(C'\fR is in
1132 effect), double\-quoted literal strings could be corrupted where a \f(CW\*(C`\exNN\*(C'\fR,
1133 \&\f(CW\*(C`\e0NNN\*(C'\fR or \f(CW\*(C`\eN{}\*(C'\fR is followed by a literal character with ordinal value
1134 greater than 255 [RT #59908].
1135 .IP \(bu 4
1136 \&\f(CW\*(C`B::Deparse\*(C'\fR failed to correctly deparse various constructs:
1137 \&\f(CW\*(C`readpipe STRING\*(C'\fR [RT #62428], \f(CWCORE::require(STRING)\fR [RT #62488],
1138 \&\f(CW\*(C`sub foo(_)\*(C'\fR [RT #62484].
1139 .IP \(bu 4
1140 Using \f(CWsetpgrp()\fR with no arguments could corrupt the perl stack.
1141 .IP \(bu 4
1142 The block form of \f(CW\*(C`eval\*(C'\fR is now specifically trappable by \f(CW\*(C`Safe\*(C'\fR and
1143 \&\f(CW\*(C`ops\*(C'\fR. Previously it was erroneously treated like string \f(CW\*(C`eval\*(C'\fR.
1144 .IP \(bu 4
1145 In 5.10.0, the two characters \f(CW\*(C`[~\*(C'\fR were sometimes parsed as the smart
1146 match operator (\f(CW\*(C`~~\*(C'\fR) [RT #63854].
1147 .IP \(bu 4
1148 In 5.10.0, the \f(CW\*(C`*\*(C'\fR quantifier in patterns was sometimes treated as
1149 \&\f(CW\*(C`{0,32767}\*(C'\fR [RT #60034, #60464]. For example, this match would fail:
1150 .Sp
1151 .Vb 1
1152 \& ("ab" x 32768) =~ /^(ab)*$/
1153 .Ve
1154 .IP \(bu 4
1155 \&\f(CW\*(C`shmget\*(C'\fR was limited to a 32 bit segment size on a 64 bit OS [RT #63924].
1156 .IP \(bu 4
1157 Using \f(CW\*(C`next\*(C'\fR or \f(CW\*(C`last\*(C'\fR to exit a \f(CW\*(C`given\*(C'\fR block no longer produces a
1158 spurious warning like the following:
1159 .Sp
1160 .Vb 1
1161 \& Exiting given via last at foo.pl line 123
1162 .Ve
1163 .IP \(bu 4
1164 On Windows, \f(CW\*(Aq.\efoo\*(Aq\fR and \f(CW\*(Aq..\efoo\*(Aq\fR were treated differently than
1165 \&\f(CW\*(Aq./foo\*(Aq\fR and \f(CW\*(Aq../foo\*(Aq\fR by \f(CW\*(C`do\*(C'\fR and \f(CW\*(C`require\*(C'\fR [RT #63492].
1166 .IP \(bu 4
1167 Assigning a format to a glob could corrupt the format; e.g.:
1168 .Sp
1169 .Vb 1
1170 \& *bar=*foo{FORMAT}; # foo format now bad
1171 .Ve
1172 .IP \(bu 4
1173 Attempting to coerce a typeglob to a string or number could cause an
1174 assertion failure. The correct error message is now generated,
1175 \&\f(CW\*(C`Can\*(Aqt coerce GLOB to \fR\f(CI$type\fR\f(CW\*(C'\fR.
1176 .IP \(bu 4
1177 Under \f(CW\*(C`use filetest \*(Aqaccess\*(Aq\*(C'\fR, \f(CW\*(C`\-x\*(C'\fR was using the wrong access mode. This
1178 has been fixed [RT #49003].
1179 .IP \(bu 4
1180 \&\f(CW\*(C`length\*(C'\fR on a tied scalar that returned a Unicode value would not be
1181 correct the first time. This has been fixed.
1182 .IP \(bu 4
1183 Using an array \f(CW\*(C`tie\*(C'\fR inside in array \f(CW\*(C`tie\*(C'\fR could SEGV. This has been
1184 fixed. [RT #51636]
1185 .IP \(bu 4
1186 A race condition inside \f(CWPerlIOStdio_close()\fR has been identified and
1187 fixed. This used to cause various threading issues, including SEGVs.
1188 .IP \(bu 4
1189 In \f(CW\*(C`unpack\*(C'\fR, the use of \f(CW\*(C`()\*(C'\fR groups in scalar context was internally
1190 placing a list on the interpreter\*(Aqs stack, which manifested in various
1191 ways, including SEGVs. This is now fixed [RT #50256].
1192 .IP \(bu 4
1193 Magic was called twice in \f(CW\*(C`substr\*(C'\fR, \f(CW\*(C`\e&$x\*(C'\fR, \f(CW\*(C`tie $x, $m\*(C'\fR and \f(CW\*(C`chop\*(C'\fR.
1194 These have all been fixed.
1195 .IP \(bu 4
1196 A 5.10.0 optimisation to clear the temporary stack within the implicit
1197 loop of \f(CW\*(C`s///ge\*(C'\fR has been reverted, as it turned out to be the cause of
1198 obscure bugs in seemingly unrelated parts of the interpreter [commit
1199 ef0d4e17921ee3de].
1200 .IP \(bu 4
1201 The line numbers for warnings inside \f(CW\*(C`elsif\*(C'\fR are now correct.
1202 .IP \(bu 4
1203 The \f(CW\*(C`..\*(C'\fR operator now works correctly with ranges whose ends are at or
1204 close to the values of the smallest and largest integers.
1205 .IP \(bu 4
1206 \&\f(CW\*(C`binmode STDIN, \*(Aq:raw\*(Aq\*(C'\fR could lead to segmentation faults on some platforms.
1207 This has been fixed [RT #54828].
1208 .IP \(bu 4
1209 An off\-by\-one error meant that \f(CW\*(C`index $str, ...\*(C'\fR was effectively being
1210 executed as \f(CW\*(C`index "$str\e0", ...\*(C'\fR. This has been fixed [RT #53746].
1211 .IP \(bu 4
1212 Various leaks associated with named captures in regexes have been fixed
1213 [RT #57024].
1214 .IP \(bu 4
1215 A weak reference to a hash would leak. This was affecting \f(CW\*(C`DBI\*(C'\fR
1216 [RT #56908].
1217 .IP \(bu 4
1218 Using (?|) in a regex could cause a segfault [RT #59734].
1219 .IP \(bu 4
1220 Use of a UTF\-8 \f(CW\*(C`tr//\*(C'\fR within a closure could cause a segfault [RT #61520].
1221 .IP \(bu 4
1222 Calling \f(CWsv_chop()\fR or otherwise upgrading an SV could result in an
1223 unaligned 64\-bit access on the SPARC architecture [RT #60574].
1224 .IP \(bu 4
1225 In the 5.10.0 release, \f(CW\*(C`inc_version_list\*(C'\fR would incorrectly list
1226 \&\f(CW\*(C`5.10.*\*(C'\fR after \f(CW\*(C`5.8.*\*(C'\fR; this affected the \f(CW@INC\fR search order
1227 [RT #67628].
1228 .IP \(bu 4
1229 In 5.10.0, \f(CW\*(C`pack "a*", $tainted_value\*(C'\fR returned a non\-tainted value
1230 [RT #52552].
1231 .IP \(bu 4
1232 In 5.10.0, \f(CW\*(C`printf\*(C'\fR and \f(CW\*(C`sprintf\*(C'\fR could produce the fatal error
1233 \&\f(CW\*(C`panic: utf8_mg_pos_cache_update\*(C'\fR when printing UTF\-8 strings
1234 [RT #62666].
1235 .IP \(bu 4
1236 In the 5.10.0 release, a dynamically created \f(CW\*(C`AUTOLOAD\*(C'\fR method might be
1237 missed (method cache issue) [RT #60220,60232].
1238 .IP \(bu 4
1239 In the 5.10.0 release, a combination of \f(CW\*(C`use feature\*(C'\fR and \f(CW\*(C`//ee\*(C'\fR could
1240 cause a memory leak [RT #63110].
1241 .IP \(bu 4
1242 \&\f(CW\*(C`\-C\*(C'\fR on the shebang (\f(CW\*(C`#!\*(C'\fR) line is once more permitted if it is also
1243 specified on the command line. \f(CW\*(C`\-C\*(C'\fR on the shebang line used to be a
1244 silent no\-op \fIif\fR it was not also on the command line, so perl 5.10.0
1245 disallowed it, which broke some scripts. Now perl checks whether it is
1246 also on the command line and only dies if it is not [RT #67880].
1247 .IP \(bu 4
1248 In 5.10.0, certain types of re\-entrant regular expression could crash,
1249 or cause the following assertion failure [RT #60508]:
1250 .Sp
1251 .Vb 1
1252 \& Assertion rx\->sublen >= (s \- rx\->subbeg) + i failed
1253 .Ve
1254 .SH "New or Changed Diagnostics"
1255 .IX Header "New or Changed Diagnostics"
1256 .ie n .IP """panic: sv_chop %s""" 4
1257 .el .IP "\f(CWpanic: sv_chop %s\fR" 4
1258 .IX Item "panic: sv_chop %s"
1259 This new fatal error occurs when the C routine \f(CWPerl_sv_chop()\fR was
1260 passed a position that is not within the scalar\*(Aqs string buffer. This
1261 could be caused by buggy XS code, and at this point recovery is not
1262 possible.
1263 .ie n .IP """Can\*(Aqt locate package %s for the parents of %s""" 4
1264 .el .IP "\f(CWCan\*(Aqt locate package %s for the parents of %s\fR" 4
1265 .IX Item "Can't locate package %s for the parents of %s"
1266 This warning has been removed. In general, it only got produced in
1267 conjunction with other warnings, and removing it allowed an ISA lookup
1268 optimisation to be added.
1269 .ie n .IP """v\-string in use/require is non\-portable""" 4
1270 .el .IP "\f(CWv\-string in use/require is non\-portable\fR" 4
1271 .IX Item "v-string in use/require is non-portable"
1272 This warning has been removed.
1273 .ie n .IP """Deep recursion on subroutine ""%s""""" 4
1274 .el .IP "\f(CWDeep recursion on subroutine ""%s""\fR" 4
1275 .IX Item "Deep recursion on subroutine ""%s"""
1276 It is now possible to change the depth threshold for this warning from the
1277 default of 100, by recompiling the \fIperl\fR binary, setting the C
1278 pre\-processor macro \f(CW\*(C`PERL_SUB_DEPTH_WARN\*(C'\fR to the desired value.
1279 .SH "Changed Internals"
1280 .IX Header "Changed Internals"
1281 .IP \(bu 4
1282 The J.R.R. Tolkien quotes at the head of C source file have been checked and
1283 proper citations added, thanks to a patch from Tom Christiansen.
1284 .IP \(bu 4
1285 \&\f(CWvcroak()\fR now accepts a null first argument. In addition, a full audit
1286 was made of the "not NULL" compiler annotations, and those for several
1287 other internal functions were corrected.
1288 .IP \(bu 4
1289 New macros \f(CW\*(C`dSAVEDERRNO\*(C'\fR, \f(CW\*(C`dSAVE_ERRNO\*(C'\fR, \f(CW\*(C`SAVE_ERRNO\*(C'\fR, \f(CW\*(C`RESTORE_ERRNO\*(C'\fR
1290 have been added to formalise the temporary saving of the \f(CW\*(C`errno\*(C'\fR
1291 variable.
1292 .IP \(bu 4
1293 The function \f(CW\*(C`Perl_sv_insert_flags\*(C'\fR has been added to augment
1294 \&\f(CW\*(C`Perl_sv_insert\*(C'\fR.
1295 .IP \(bu 4
1296 The function \f(CWPerl_newSV_type(type)\fR has been added, equivalent to
1297 \&\f(CWPerl_newSV()\fR followed by \f(CWPerl_sv_upgrade(type)\fR.
1298 .IP \(bu 4
1299 The function \f(CWPerl_newSVpvn_flags()\fR has been added, equivalent to
1300 \&\f(CWPerl_newSVpvn()\fR and then performing the action relevant to the flag.
1301 .Sp
1302 Two flag bits are currently supported.
1303 .RS 4
1304 .ie n .IP """SVf_UTF8""" 4
1305 .el .IP \f(CWSVf_UTF8\fR 4
1306 .IX Item "SVf_UTF8"
1307 This will call \f(CWSvUTF8_on()\fR for you. (Note that this does not convert a
1308 sequence of ISO 8859\-1 characters to UTF\-8). A wrapper, \f(CWnewSVpvn_utf8()\fR
1309 is available for this.
1310 .ie n .IP """SVs_TEMP""" 4
1311 .el .IP \f(CWSVs_TEMP\fR 4
1312 .IX Item "SVs_TEMP"
1313 Call \f(CWsv_2mortal()\fR on the new SV.
1314 .RE
1315 .RS 4
1316 .Sp
1317 There is also a wrapper that takes constant strings, \f(CWnewSVpvs_flags()\fR.
1318 .RE
1319 .IP \(bu 4
1320 The function \f(CW\*(C`Perl_croak_xs_usage\*(C'\fR has been added as a wrapper to
1321 \&\f(CW\*(C`Perl_croak\*(C'\fR.
1322 .IP \(bu 4
1323 The functions \f(CW\*(C`PerlIO_find_layer\*(C'\fR and \f(CW\*(C`PerlIO_list_alloc\*(C'\fR are now
1324 exported.
1325 .IP \(bu 4
1326 \&\f(CW\*(C`PL_na\*(C'\fR has been exterminated from the core code, replaced by local STRLEN
1327 temporaries, or \f(CW*_nolen()\fR calls. Either approach is faster than \f(CW\*(C`PL_na\*(C'\fR,
1328 which is a pointer deference into the interpreter structure under ithreads,
1329 and a global variable otherwise.
1330 .IP \(bu 4
1331 \&\f(CWPerl_mg_free()\fR used to leave freed memory accessible via \fBSvMAGIC()\fR on
1332 the scalar. It now updates the linked list to remove each piece of magic
1333 as it is freed.
1334 .IP \(bu 4
1335 Under ithreads, the regex in \f(CW\*(C`PL_reg_curpm\*(C'\fR is now reference counted. This
1336 eliminates a lot of hackish workarounds to cope with it not being reference
1337 counted.
1338 .IP \(bu 4
1339 \&\f(CWPerl_mg_magical()\fR would sometimes incorrectly turn on \f(CWSvRMAGICAL()\fR.
1340 This has been fixed.
1341 .IP \(bu 4
1342 The \fIpublic\fR IV and NV flags are now not set if the string value has
1343 trailing "garbage". This behaviour is consistent with not setting the
1344 public IV or NV flags if the value is out of range for the type.
1345 .IP \(bu 4
1346 SV allocation tracing has been added to the diagnostics enabled by \f(CW\*(C`\-Dm\*(C'\fR.
1347 The tracing can alternatively output via the \f(CW\*(C`PERL_MEM_LOG\*(C'\fR mechanism, if
1348 that was enabled when the \fIperl\fR binary was compiled.
1349 .IP \(bu 4
1350 Uses of \f(CW\*(C`Nullav\*(C'\fR, \f(CW\*(C`Nullcv\*(C'\fR, \f(CW\*(C`Nullhv\*(C'\fR, \f(CW\*(C`Nullop\*(C'\fR, \f(CW\*(C`Nullsv\*(C'\fR etc have been
1351 replaced by \f(CW\*(C`NULL\*(C'\fR in the core code, and non\-dual\-life modules, as \f(CW\*(C`NULL\*(C'\fR
1352 is clearer to those unfamiliar with the core code.
1353 .IP \(bu 4
1354 A macro \f(CWMUTABLE_PTR(p)\fR has been added, which on (non\-pedantic) gcc will
1355 not cast away \f(CW\*(C`const\*(C'\fR, returning a \f(CW\*(C`void *\*(C'\fR. Macros \f(CWMUTABLE_SV(av)\fR,
1356 \&\f(CWMUTABLE_SV(cv)\fR etc build on this, casting to \f(CW\*(C`AV *\*(C'\fR etc without
1357 casting away \f(CW\*(C`const\*(C'\fR. This allows proper compile\-time auditing of
1358 \&\f(CW\*(C`const\*(C'\fR correctness in the core, and helped picked up some errors (now
1359 fixed).
1360 .IP \(bu 4
1361 Macros \f(CWmPUSHs()\fR and \f(CWmXPUSHs()\fR have been added, for pushing SVs on the
1362 stack and mortalizing them.
1363 .IP \(bu 4
1364 Use of the private structure \f(CW\*(C`mro_meta\*(C'\fR has changed slightly. Nothing
1365 outside the core should be accessing this directly anyway.
1366 .IP \(bu 4
1367 A new tool, \f(CW\*(C`Porting/expand\-macro.pl\*(C'\fR has been added, that allows you
1368 to view how a C preprocessor macro would be expanded when compiled.
1369 This is handy when trying to decode the macro hell that is the perl
1370 guts.
1371 .SH "New Tests"
1372 .IX Header "New Tests"
1373 Many modules updated from CPAN incorporate new tests.
1374 .PP
1375 Several tests that have the potential to hang forever if they fail now
1376 incorporate a "watchdog" functionality that will kill them after a timeout,
1377 which helps ensure that \f(CW\*(C`make test\*(C'\fR and \f(CW\*(C`make test_harness\*(C'\fR run to
1378 completion automatically. (Jerry Hedden).
1379 .PP
1380 Some core\-specific tests have been added:
1381 .IP t/comp/retainedlines.t 4
1382 .IX Item "t/comp/retainedlines.t"
1383 Check that the debugger can retain source lines from \f(CW\*(C`eval\*(C'\fR.
1384 .IP t/io/perlio_fail.t 4
1385 .IX Item "t/io/perlio_fail.t"
1386 Check that bad layers fail.
1387 .IP t/io/perlio_leaks.t 4
1388 .IX Item "t/io/perlio_leaks.t"
1389 Check that PerlIO layers are not leaking.
1390 .IP t/io/perlio_open.t 4
1391 .IX Item "t/io/perlio_open.t"
1392 Check that certain special forms of open work.
1393 .IP t/io/perlio.t 4
1394 .IX Item "t/io/perlio.t"
1395 General PerlIO tests.
1396 .IP t/io/pvbm.t 4
1397 .IX Item "t/io/pvbm.t"
1398 Check that there is no unexpected interaction between the internal types
1399 \&\f(CW\*(C`PVBM\*(C'\fR and \f(CW\*(C`PVGV\*(C'\fR.
1400 .IP t/mro/package_aliases.t 4
1401 .IX Item "t/mro/package_aliases.t"
1402 Check that mro works properly in the presence of aliased packages.
1403 .IP t/op/dbm.t 4
1404 .IX Item "t/op/dbm.t"
1405 Tests for \f(CW\*(C`dbmopen\*(C'\fR and \f(CW\*(C`dbmclose\*(C'\fR.
1406 .IP t/op/index_thr.t 4
1407 .IX Item "t/op/index_thr.t"
1408 Tests for the interaction of \f(CW\*(C`index\*(C'\fR and threads.
1409 .IP t/op/pat_thr.t 4
1410 .IX Item "t/op/pat_thr.t"
1411 Tests for the interaction of esoteric patterns and threads.
1412 .IP t/op/qr_gc.t 4
1413 .IX Item "t/op/qr_gc.t"
1414 Test that \f(CW\*(C`qr\*(C'\fR doesn\*(Aqt leak.
1415 .IP t/op/reg_email_thr.t 4
1416 .IX Item "t/op/reg_email_thr.t"
1417 Tests for the interaction of regex recursion and threads.
1418 .IP t/op/regexp_qr_embed_thr.t 4
1419 .IX Item "t/op/regexp_qr_embed_thr.t"
1420 Tests for the interaction of patterns with embedded \f(CW\*(C`qr//\*(C'\fR and threads.
1421 .IP t/op/regexp_unicode_prop.t 4
1422 .IX Item "t/op/regexp_unicode_prop.t"
1423 Tests for Unicode properties in regular expressions.
1424 .IP t/op/regexp_unicode_prop_thr.t 4
1425 .IX Item "t/op/regexp_unicode_prop_thr.t"
1426 Tests for the interaction of Unicode properties and threads.
1427 .IP t/op/reg_nc_tie.t 4
1428 .IX Item "t/op/reg_nc_tie.t"
1429 Test the tied methods of \f(CW\*(C`Tie::Hash::NamedCapture\*(C'\fR.
1430 .IP t/op/reg_posixcc.t 4
1431 .IX Item "t/op/reg_posixcc.t"
1432 Check that POSIX character classes behave consistently.
1433 .IP t/op/re.t 4
1434 .IX Item "t/op/re.t"
1435 Check that exportable \f(CW\*(C`re\*(C'\fR functions in \fIuniversal.c\fR work.
1436 .IP t/op/setpgrpstack.t 4
1437 .IX Item "t/op/setpgrpstack.t"
1438 Check that \f(CW\*(C`setpgrp\*(C'\fR works.
1439 .IP t/op/substr_thr.t 4
1440 .IX Item "t/op/substr_thr.t"
1441 Tests for the interaction of \f(CW\*(C`substr\*(C'\fR and threads.
1442 .IP t/op/upgrade.t 4
1443 .IX Item "t/op/upgrade.t"
1444 Check that upgrading and assigning scalars works.
1445 .IP t/uni/lex_utf8.t 4
1446 .IX Item "t/uni/lex_utf8.t"
1447 Check that Unicode in the lexer works.
1448 .IP t/uni/tie.t 4
1449 .IX Item "t/uni/tie.t"
1450 Check that Unicode and \f(CW\*(C`tie\*(C'\fR work.
1451 .SH "Known Problems"
1452 .IX Header "Known Problems"
1453 This is a list of some significant unfixed bugs, which are regressions
1454 from either 5.10.0 or 5.8.x.
1455 .IP \(bu 4
1456 \&\f(CW\*(C`List::Util::first\*(C'\fR misbehaves in the presence of a lexical \f(CW$_\fR
1457 (typically introduced by \f(CW\*(C`my $_\*(C'\fR or implicitly by \f(CW\*(C`given\*(C'\fR). The variable
1458 which gets set for each iteration is the package variable \f(CW$_\fR, not the
1459 lexical \f(CW$_\fR [RT #67694].
1460 .Sp
1461 A similar issue may occur in other modules that provide functions which
1462 take a block as their first argument, like
1463 .Sp
1464 .Vb 1
1465 \& foo { ... $_ ...} list
1466 .Ve
1467 .IP \(bu 4
1468 The \f(CW\*(C`charnames\*(C'\fR pragma may generate a run\-time error when a regex is
1469 interpolated [RT #56444]:
1470 .Sp
1471 .Vb 4
1472 \& use charnames \*(Aq:full\*(Aq;
1473 \& my $r1 = qr/\eN{THAI CHARACTER SARA I}/;
1474 \& "foo" =~ $r1; # okay
1475 \& "foo" =~ /$r1+/; # runtime error
1476 .Ve
1477 .Sp
1478 A workaround is to generate the character outside of the regex:
1479 .Sp
1480 .Vb 2
1481 \& my $a = "\eN{THAI CHARACTER SARA I}";
1482 \& my $r1 = qr/$a/;
1483 .Ve
1484 .IP \(bu 4
1485 Some regexes may run much more slowly when run in a child thread compared
1486 with the thread the pattern was compiled into [RT #55600].
1487 .SH Deprecations
1488 .IX Header "Deprecations"
1489 The following items are now deprecated.
1490 .IP \(bu 4
1491 \&\f(CW\*(C`Switch\*(C'\fR is buggy and should be avoided. From perl 5.11.0 onwards, it is
1492 intended that any use of the core version of this module will emit a
1493 warning, and that the module will eventually be removed from the core
1494 (probably in perl 5.14.0). See "Switch statements" in perlsyn for its
1495 replacement.
1496 .IP \(bu 4
1497 \&\f(CW\*(C`suidperl\*(C'\fR will be removed in 5.12.0. This provides a mechanism to
1498 emulate setuid permission bits on systems that don\*(Aqt support it properly.
1499 .SH Acknowledgements
1500 .IX Header "Acknowledgements"
1501 Some of the work in this release was funded by a TPF grant.
1502 .PP
1503 Nicholas Clark officially retired from maintenance pumpking duty at the
1504 end of 2008; however in reality he has put much effort in since then to
1505 help get 5.10.1 into a fit state to be released, including writing a
1506 considerable chunk of this perldelta.
1507 .PP
1508 Steffen Mueller and David Golden in particular helped getting CPAN modules
1509 polished and synchronised with their in\-core equivalents.
1510 .PP
1511 Craig Berry was tireless in getting maint to run under VMS, no matter how
1512 many times we broke it for him.
1513 .PP
1514 The other core committers contributed most of the changes, and applied most
1515 of the patches sent in by the hundreds of contributors listed in \fIAUTHORS\fR.
1516 .PP
1517 (Sorry to all the people I haven\*(Aqt mentioned by name).
1518 .PP
1519 Finally, thanks to Larry Wall, without whom none of this would be
1520 necessary.
1521 .SH "Reporting Bugs"
1522 .IX Header "Reporting Bugs"
1523 If you find what you think is a bug, you might check the articles
1524 recently posted to the comp.lang.perl.misc newsgroup and the perl
1525 bug database at http://rt.perl.org/perlbug/ . There may also be
1526 information at http://www.perl.org/ , the Perl Home Page.
1527 .PP
1528 If you believe you have an unreported bug, please run the \fBperlbug\fR
1529 program included with your release. Be sure to trim your bug down
1530 to a tiny but sufficient test case. Your bug report, along with the
1531 output of \f(CW\*(C`perl \-V\*(C'\fR, will be sent off to [email protected] to be
1532 analysed by the Perl porting team.
1533 .PP
1534 If the bug you are reporting has security implications, which make it
1535 inappropriate to send to a publicly archived mailing list, then please send
1536 it to perl5\-security\[email protected]. This points to a closed subscription
1537 unarchived mailing list, which includes
1538 all the core committers, who will be able
1539 to help assess the impact of issues, figure out a resolution, and help
1540 co\-ordinate the release of patches to mitigate or fix the problem across all
1541 platforms on which Perl is supported. Please only use this address for
1542 security issues in the Perl core, not for modules independently
1543 distributed on CPAN.
1544 .SH "SEE ALSO"
1545 .IX Header "SEE ALSO"
1546 The \fIChanges\fR file for an explanation of how to view exhaustive details
1547 on what changed.
1548 .PP
1549 The \fIINSTALL\fR file for how to build Perl.
1550 .PP
1551 The \fIREADME\fR file for general stuff.
1552 .PP
1553 The \fIArtistic\fR and \fICopying\fR files for copyright information.