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