Debian Codegraph @

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