Commit | Line | Data |
fa7da8f7 |
1 | =encoding utf8 |
2 | |
7120b314 |
3 | =head1 NAME |
4 | |
5a00ee6a |
5 | perl5110delta - what is new for perl v5.11.0 |
7120b314 |
6 | |
7 | =head1 DESCRIPTION |
8 | |
5a00ee6a |
9 | This document describes differences between the 5.10.0 release and |
10 | the 5.11.0 development release. |
7120b314 |
11 | |
12 | =head1 Incompatible Changes |
13 | |
ad1d1c50 |
14 | =head2 In @INC, move ARCHLIB and PRIVLIB after the current version's site_perl and vendor_perl. |
15 | |
8b8da387 |
16 | =head2 Switch statement changes |
17 | |
18 | The handling of complex expressions by the C<given>/C<when> switch |
a98ccf1e |
19 | statement has been enhanced. These enhancements are also available in |
20 | 5.10.1 and subsequent 5.10 releases. There are two new cases where C<when> now |
412304fb |
21 | interprets its argument as a boolean, instead of an expression to be used |
8b8da387 |
22 | in a smart match: |
23 | |
24 | =over 4 |
25 | |
8b8da387 |
26 | =item flip-flop operators |
27 | |
98814a2b |
28 | The C<..> and C<...> flip-flop operators are now evaluated in boolean |
29 | context, following their usual semantics; see L<perlop/"Range Operators">. |
30 | |
31 | Note that, as in perl 5.10.0, C<when (1..10)> will not work to test |
32 | whether a given value is an integer between 1 and 10; you should use |
33 | C<when ([1..10])> instead (note the array reference). |
34 | |
35 | However, contrary to 5.10.0, evaluating the flip-flop operators in boolean |
36 | context ensures it can now be useful in a C<when()>, notably for |
37 | implementing bistable conditions, like in: |
38 | |
5a00ee6a |
39 | when (/^=begin/ .. /^=end/) { |
40 | # do something |
41 | } |
8b8da387 |
42 | |
43 | =item defined-or operator |
44 | |
45 | A compound expression involving the defined-or operator, as in |
46 | C<when (expr1 // expr2)>, will be treated as boolean if the first |
47 | expression is boolean. (This just extends the existing rule that applies |
48 | to the regular or operator, as in C<when (expr1 || expr2)>.) |
49 | |
50 | =back |
51 | |
98814a2b |
52 | The next section details more changes brought to the semantics to |
8b8da387 |
53 | the smart match operator, that naturally also modify the behaviour |
54 | of the switch statements where smart matching is implicitly used. |
a98ccf1e |
55 | These changers were also made for the 5.10.1 release, and will remain in |
56 | subsequent 5.10 releases. |
8b8da387 |
57 | |
58 | =head2 Smart match changes |
59 | |
60 | =head3 Changes to type-based dispatch |
61 | |
62 | The smart match operator C<~~> is no longer commutative. The behaviour of |
63 | a smart match now depends primarily on the type of its right hand |
5a00ee6a |
64 | argument. Moreover, its semantics have been adjusted for greater |
ee18cc6c |
65 | consistency or usefulness in several cases. While the general backwards |
66 | compatibility is maintained, several changes must be noted: |
8b8da387 |
67 | |
68 | =over 4 |
69 | |
70 | =item * |
71 | |
72 | Code references with an empty prototype are no longer treated specially. |
73 | They are passed an argument like the other code references (even if they |
74 | choose to ignore it). |
75 | |
76 | =item * |
77 | |
78 | C<%hash ~~ sub {}> and C<@array ~~ sub {}> now test that the subroutine |
9091a618 |
79 | returns a true value for each key of the hash (or element of the |
8b8da387 |
80 | array), instead of passing the whole hash or array as a reference to |
81 | the subroutine. |
82 | |
83 | =item * |
84 | |
ee18cc6c |
85 | Due to the commutativity breakage, code references are no longer |
86 | treated specially when appearing on the left of the C<~~> operator, |
87 | but like any vulgar scalar. |
88 | |
89 | =item * |
90 | |
8b8da387 |
91 | C<undef ~~ %hash> is always false (since C<undef> can't be a key in a |
92 | hash). No implicit conversion to C<""> is done (as was the case in perl |
93 | 5.10.0). |
94 | |
95 | =item * |
96 | |
97 | C<$scalar ~~ @array> now always distributes the smart match across the |
98 | elements of the array. It's true if one element in @array verifies |
99 | C<$scalar ~~ $element>. This is a generalization of the old behaviour |
100 | that tested whether the array contained the scalar. |
101 | |
102 | =back |
103 | |
104 | The full dispatch table for the smart match operator is given in |
105 | L<perlsyn/"Smart matching in detail">. |
106 | |
107 | =head3 Smart match and overloading |
108 | |
109 | According to the rule of dispatch based on the rightmost argument type, |
110 | when an object overloading C<~~> appears on the right side of the |
111 | operator, the overload routine will always be called (with a 3rd argument |
112 | set to a true value, see L<overload>.) However, when the object will |
113 | appear on the left, the overload routine will be called only when the |
9091a618 |
114 | rightmost argument is a simple scalar. This way distributivity of smart match |
8b8da387 |
115 | across arrays is not broken, as well as the other behaviours with complex |
116 | types (coderefs, hashes, regexes). Thus, writers of overloading routines |
ee18cc6c |
117 | for smart match mostly need to worry only with comparing against a scalar, |
118 | and possibly with stringification overloading; the other common cases |
119 | will be automatically handled consistently. |
8b8da387 |
120 | |
121 | C<~~> will now refuse to work on objects that do not overload it (in order |
665f5e98 |
122 | to avoid relying on the object's underlying structure). (However, if the |
123 | object overloads the stringification or the numification operators, and |
124 | if overload fallback is active, it will be used instead, as usual.) |
8b8da387 |
125 | |
f71d6157 |
126 | =head2 Labels can't be keywords |
127 | |
128 | Labels used as targets for the C<goto>, C<last>, C<next> or C<redo> |
129 | statements cannot be keywords anymore. This restriction will prevent |
130 | potential confusion between the C<goto LABEL> and C<goto EXPR> syntaxes: |
131 | for example, a statement like C<goto print> would jump to a label whose |
132 | name would be the return value of print(), (usually 1), instead of a |
133 | label named C<print>. Moreover, the other control flow statements |
134 | would just ignore any keyword passed to them as a label name. Since |
135 | such labels cannot be defined anymore, this kind of error will be |
136 | avoided. |
137 | |
5a00ee6a |
138 | =head2 Other incompatible changes |
139 | |
140 | =over 4 |
141 | |
142 | =item * |
143 | |
144 | The semantics of C<use feature :5.10*> have changed slightly. |
145 | See L<"Modules and Pragmata"> for more information. |
146 | |
147 | =item * |
148 | |
149 | It is now a run-time error to use the smart match operator C<~~> |
150 | with an object that has no overload defined for it. (This way |
151 | C<~~> will not break encapsulation by matching against the |
152 | object's internal representation as a reference.) |
153 | |
154 | =item * |
155 | |
156 | The version control system used for the development of the perl |
157 | interpreter has been switched from Perforce to git. This is mainly an |
158 | internal issue that only affects people actively working on the perl core; |
159 | but it may have minor external visibility, for example in some of details |
160 | of the output of C<perl -V>. See L<perlrepository> for more information. |
161 | |
162 | =item * |
163 | |
164 | The internal structure of the C<ext/> directory in the perl source has |
165 | been reorganised. In general, a module C<Foo::Bar> whose source was |
166 | stored under F<ext/Foo/Bar/> is now located under F<ext/Foo-Bar/>. Also, |
167 | some modules have been moved from F<lib/> to F<ext/>. This is purely a |
168 | source tarball change, and should make no difference to the compilation or |
169 | installation of perl, unless you have a very customised build process that |
170 | explicitly relies on this structure, or which hard-codes the C<nonxs_ext> |
171 | F<Configure> parameter. Specifically, this change does not by default |
172 | alter the location of any files in the final installation. |
173 | |
174 | =item * |
175 | |
176 | As part of the C<Test::Harness> 2.x to 3.x upgrade, the experimental |
177 | C<Test::Harness::Straps> module has been removed. |
178 | See L</"Updated Modules"> for more details. |
179 | |
180 | =item * |
181 | |
182 | As part of the C<ExtUtils::MakeMaker> upgrade, the |
183 | C<ExtUtils::MakeMaker::bytes> and C<ExtUtils::MakeMaker::vmsish> modules |
184 | have been removed from this distribution. |
185 | |
186 | =item * |
187 | |
188 | C<Module::CoreList> no longer contains the C<%:patchlevel> hash. |
189 | |
190 | =item * |
191 | |
192 | This one is actually a change introduced in 5.10.0, but it was missed |
193 | from that release's perldelta, so it is mentioned here instead. |
194 | |
195 | A bugfix related to the handling of the C</m> modifier and C<qr> resulted |
196 | in a change of behaviour between 5.8.x and 5.10.0: |
197 | |
198 | # matches in 5.8.x, doesn't match in 5.10.0 |
199 | $re = qr/^bar/; "foo\nbar" =~ /$re/m; |
200 | |
ad1d1c50 |
201 | =item * |
202 | |
203 | C<length undef> now returns undef. |
204 | |
5a00ee6a |
205 | =back |
206 | |
7120b314 |
207 | =head1 Core Enhancements |
208 | |
5a00ee6a |
209 | =head2 Unicode Character Database 5.1.0 |
210 | |
3141b5e1 |
211 | The copy of the Unicode Character Database included in Perl 5.11.0 has |
5a00ee6a |
212 | been updated to 5.1.0 from 5.0.0. See |
213 | L<http://www.unicode.org/versions/Unicode5.1.0/#Notable_Changes> for the |
214 | notable changes. |
215 | |
216 | =head2 A proper interface for pluggable Method Resolution Orders |
217 | |
3141b5e1 |
218 | As of Perl 5.11.0 there is a new interface for plugging and using method |
5a00ee6a |
219 | resolution orders other than the default (linear depth first search). |
220 | The C3 method resolution order added in 5.10.0 has been re-implemented as |
221 | a plugin, without changing its Perl-space interface. See L<perlmroapi> for |
222 | more information. |
223 | |
ef55af2a |
224 | =head2 The C<overloading> pragma |
1839a850 |
225 | |
226 | This pragma allows you to lexically disable or enable overloading |
227 | for some or all operations. (Yuval Kogman) |
228 | |
71e9c532 |
229 | =head2 C<\N> regex escape |
230 | |
231 | A new regex escape has been added, C<\N>. It will match any character that |
232 | is not a newline, independently from the presence or absence of the single |
233 | line match modifier C</s>. (If C<\N> is followed by an opening brace and |
234 | by a letter, perl will still assume that a Unicode character name is |
235 | coming, so compatibility is preserved.) (Rafael Garcia-Suarez) |
236 | |
4b3db487 |
237 | =head2 Implicit strictures |
238 | |
239 | Using the C<use VERSION> syntax with a version number greater or equal |
240 | to 5.11.0 will also lexically enable strictures just like C<use strict> |
241 | would do (in addition to enabling features.) So, the following: |
242 | |
243 | use 5.11.0; |
244 | |
245 | will now imply: |
246 | |
247 | use strict; |
248 | use feature ':5.11'; |
249 | |
5ee651a9 |
250 | =head2 Parallel tests |
251 | |
252 | The core distribution can now run its regression tests in parallel on |
253 | Unix-like platforms. Instead of running C<make test>, set C<TEST_JOBS> in |
254 | your environment to the number of tests to run in parallel, and run |
255 | C<make test_harness>. On a Bourne-like shell, this can be done as |
256 | |
257 | TEST_JOBS=3 make test_harness # Run 3 tests in parallel |
258 | |
259 | An environment variable is used, rather than parallel make itself, because |
260 | L<TAP::Harness> needs to be able to schedule individual non-conflicting test |
261 | scripts itself, and there is no standard interface to C<make> utilities to |
262 | interact with their job schedulers. |
263 | |
5a00ee6a |
264 | Note that currently some test scripts may fail when run in parallel (most |
265 | notably C<ext/IO/t/io_dir.t>). If necessary run just the failing scripts |
266 | again sequentially and see if the failures go away. |
267 | |
044c880b |
268 | =head2 The C<...> operator |
269 | |
270 | A new operator, C<...>, nicknamed the Yada Yada operator, has been added. |
271 | It is intended to mark placeholder code, that is not yet implemented. |
272 | See L<perlop/"Yada Yada Operator">. (chromatic) |
273 | |
5a00ee6a |
274 | =head2 DTrace support |
275 | |
276 | Some support for DTrace has been added. See "DTrace support" in F<INSTALL>. |
277 | |
278 | =head2 Support for C<configure_requires> in CPAN module metadata |
279 | |
280 | Both C<CPAN> and C<CPANPLUS> now support the C<configure_requires> keyword |
038a5866 |
281 | in the F<META.yml> metadata file included in most recent CPAN distributions. |
5a00ee6a |
282 | This allows distribution authors to specify configuration prerequisites that |
283 | must be installed before running F<Makefile.PL> or F<Build.PL>. |
284 | |
285 | See the documentation for C<ExtUtils::MakeMaker> or C<Module::Build> for more |
286 | on how to specify C<configure_requires> when creating a distribution for CPAN. |
287 | |
ad1d1c50 |
288 | =head2 The C<each> function can now operate on arrays |
289 | |
290 | =head2 Perl's core time-related functions are now Y2038 compliand |
291 | |
292 | =head2 The variable C<$,> may now be tied |
293 | |
294 | =head2 // now behaves like || in when clauses |
295 | |
296 | =head2 You can now set C<-W> from the C<PERL5OPT> environment varialbe |
297 | |
7120b314 |
298 | =head1 Modules and Pragmata |
299 | |
5a00ee6a |
300 | =head2 New Modules and Pragmata |
301 | |
302 | =over 4 |
303 | |
304 | =item C<autodie> |
305 | |
306 | This is a new lexically-scoped alternative for the C<Fatal> module. |
307 | The bundled version is 2.06_01. Note that in this release, using a string |
308 | eval when C<autodie> is in effect can cause the autodie behaviour to leak |
309 | into the surrounding scope. See L<autodie/"BUGS"> for more details. |
310 | |
311 | =item C<Compress::Raw::Bzip2> |
312 | |
313 | This has been added to the core (version 2.020). |
314 | |
315 | =item C<parent> |
316 | |
317 | This pragma establishes an ISA relationship with base classes at compile |
318 | time. It provides the key feature of C<base> without the feature creep. |
319 | |
320 | =item C<Parse::CPAN::Meta> |
321 | |
322 | This has been added to the core (version 1.39). |
323 | |
324 | =back |
325 | |
1839a850 |
326 | =head2 Pragmata Changes |
327 | |
328 | =over 4 |
329 | |
330 | =item C<overloading> |
331 | |
332 | See L</"The C<overloading> pragma"> above. |
333 | |
5a00ee6a |
334 | =item C<attributes> |
335 | |
336 | Upgraded from version 0.08 to 0.09. |
337 | |
338 | =item C<attrs> |
339 | |
42f099ed |
340 | The C<attrs> pragma has been removed. It had been marked as deprecated since |
341 | 5.6.0. |
5a00ee6a |
342 | |
343 | =item C<base> |
344 | |
345 | Upgraded from version 2.13 to 2.14. See L<parent> for a replacement. |
346 | |
347 | =item C<bigint> |
348 | |
349 | Upgraded from version 0.22 to 0.23. |
350 | |
351 | =item C<bignum> |
352 | |
353 | Upgraded from version 0.22 to 0.23. |
354 | |
355 | =item C<bigrat> |
356 | |
357 | Upgraded from version 0.22 to 0.23. |
358 | |
359 | =item C<charnames> |
360 | |
361 | Upgraded from version 1.06 to 1.07. |
362 | |
363 | The Unicode F<NameAliases.txt> database file has been added. This has the |
364 | effect of adding some extra C<\N> character names that formerly wouldn't |
365 | have been recognised; for example, C<"\N{LATIN CAPITAL LETTER GHA}">. |
366 | |
367 | =item C<constant> |
368 | |
9f808eed |
369 | Upgraded from version 1.13 to 1.19. Some code has been shifted from run time to |
370 | compile time, and the amount of MRO cache flushing has been minimised. |
5a00ee6a |
371 | |
372 | =item C<feature> |
373 | |
374 | The meaning of the C<:5.10> and C<:5.10.X> feature bundles has |
375 | changed slightly. The last component, if any (i.e. C<X>) is simply ignored. |
376 | This is predicated on the assumption that new features will not, in |
377 | general, be added to maintenance releases. So C<:5.10> and C<:5.10.X> |
378 | have identical effect. This is a change to the behaviour documented for |
379 | 5.10.0. |
380 | |
381 | =item C<fields> |
382 | |
383 | Upgraded from version 2.13 to 2.14 (this was just a version bump; there |
384 | were no functional changes). |
385 | |
386 | =item C<lib> |
387 | |
388 | Upgraded from version 0.5565 to 0.62. |
389 | |
390 | =item C<open> |
391 | |
392 | Upgraded from version 1.06 to 1.07. |
393 | |
394 | =item C<overload> |
395 | |
396 | Upgraded from version 1.06 to 1.07. |
397 | |
398 | =item C<overloading> |
399 | |
400 | See L</"The C<overloading> pragma"> above. |
401 | |
402 | =item C<version> |
403 | |
404 | Upgraded from version 0.74 to 0.77. |
405 | |
1839a850 |
406 | =back |
407 | |
5a00ee6a |
408 | =head2 Updated Modules |
02569b83 |
409 | |
410 | =over 4 |
411 | |
5a00ee6a |
412 | =item C<Archive::Extract> |
413 | |
414 | Upgraded from version 0.24 to 0.34. |
415 | |
416 | =item C<Archive::Tar> |
417 | |
418 | Upgraded from version 1.38 to 1.52. |
419 | |
420 | =item C<Attribute::Handlers> |
421 | |
422 | Upgraded from version 0.79 to 0.85. |
423 | |
424 | =item C<AutoLoader> |
425 | |
426 | Upgraded from version 5.63 to 5.68. |
427 | |
428 | =item C<AutoSplit> |
429 | |
430 | Upgraded from version 1.05 to 1.06. |
431 | |
432 | =item C<B> |
433 | |
434 | Upgraded from version 1.17 to 1.22. |
435 | |
436 | =item C<B::Debug> |
437 | |
438 | Upgraded from version 1.05 to 1.11. |
439 | |
440 | =item C<B::Deparse> |
441 | |
442 | Upgraded from version 0.83 to 0.89. |
443 | |
444 | =item C<B::Lint> |
445 | |
446 | Upgraded from version 1.09 to 1.11. |
447 | |
448 | =item C<B::Xref> |
449 | |
450 | Upgraded from version 1.01 to 1.02. |
451 | |
452 | =item C<Benchmark> |
453 | |
454 | Upgraded from version 1.10 to 1.11. |
455 | |
456 | =item C<Carp> |
457 | |
458 | Upgraded from version 1.08 to 1.11. |
459 | |
02569b83 |
460 | L<Carp> now includes all the necessary code to function. Previously, it |
461 | used to be a lightweight placeholder that loaded the actual code from |
462 | C<Carp::Heavy> on demand. C<Carp::Heavy> is now a simple, empty module |
463 | kept for backwards compatibility for programs that used to pre-load it. |
464 | |
5a00ee6a |
465 | =item C<CGI> |
7120b314 |
466 | |
5a00ee6a |
467 | Upgraded from version 3.29 to 3.43. |
468 | (also includes the "default_value for popup_menu()" fix from 3.45). |
7120b314 |
469 | |
5a00ee6a |
470 | =item C<Compress::Zlib> |
7120b314 |
471 | |
5a00ee6a |
472 | Upgraded from version 2.008 to 2.020. |
7120b314 |
473 | |
5a00ee6a |
474 | =item C<CPAN> |
7120b314 |
475 | |
5a00ee6a |
476 | Upgraded from version 1.9205 to 1.9402. C<CPAN::FTP> has a local fix to |
477 | stop it being too verbose on download failure. |
54ad55c5 |
478 | |
5a00ee6a |
479 | =item C<CPANPLUS> |
54ad55c5 |
480 | |
5a00ee6a |
481 | Upgraded from version 0.84 to 0.88. |
54ad55c5 |
482 | |
5a00ee6a |
483 | =item C<CPANPLUS::Dist::Build> |
e2c0f81f |
484 | |
5a00ee6a |
485 | Upgraded from version 0.06_02 to 0.36. |
e2c0f81f |
486 | |
5a00ee6a |
487 | =item C<Cwd> |
fc46f0f6 |
488 | |
5a00ee6a |
489 | Upgraded from version 3.25_01 to 3.30. |
fc46f0f6 |
490 | |
5a00ee6a |
491 | =item C<Data::Dumper> |
54ad55c5 |
492 | |
5a00ee6a |
493 | Upgraded from version 2.121_14 to 2.124. |
7120b314 |
494 | |
5a00ee6a |
495 | =item C<DB> |
7120b314 |
496 | |
5a00ee6a |
497 | Upgraded from version 1.01 to 1.02. |
498 | |
499 | =item C<DB_File> |
500 | |
501 | Upgraded from version 1.816_1 to 1.820. |
502 | |
503 | =item C<Devel::PPPort> |
504 | |
505 | Upgraded from version 3.13 to 3.19. |
506 | |
507 | =item C<Digest::MD5> |
508 | |
509 | Upgraded from version 2.36_01 to 2.39. |
510 | |
511 | =item C<Digest::SHA> |
512 | |
513 | Upgraded from version 5.45 to 5.47. |
514 | |
515 | =item C<DirHandle> |
516 | |
517 | Upgraded from version 1.01 to 1.03. |
518 | |
519 | =item C<Dumpvalue> |
520 | |
521 | Upgraded from version 1.12 to 1.13. |
522 | |
523 | =item C<DynaLoader> |
524 | |
525 | Upgraded from version 1.08 to 1.10. |
526 | |
527 | =item C<Encode> |
528 | |
529 | Upgraded from version 2.23 to 2.35. |
530 | |
531 | =item C<Errno> |
532 | |
533 | Upgraded from version 1.10 to 1.11. |
534 | |
535 | =item C<Exporter> |
536 | |
537 | Upgraded from version 5.62 to 5.63. |
538 | |
539 | =item C<ExtUtils::CBuilder> |
540 | |
541 | Upgraded from version 0.21 to 0.2602. |
542 | |
543 | =item C<ExtUtils::Command> |
544 | |
545 | Upgraded from version 1.13 to 1.16. |
546 | |
547 | =item C<ExtUtils::Constant> |
548 | |
549 | Upgraded from 0.20 to 0.22. (Note that neither of these versions are |
550 | available on CPAN.) |
551 | |
552 | =item C<ExtUtils::Embed> |
553 | |
554 | Upgraded from version 1.27 to 1.28. |
555 | |
556 | =item C<ExtUtils::Install> |
557 | |
558 | Upgraded from version 1.44 to 1.54. |
559 | |
560 | =item C<ExtUtils::MakeMaker> |
561 | |
562 | Upgraded from version 6.42 to 6.55_02. |
563 | |
564 | Note that C<ExtUtils::MakeMaker::bytes> and C<ExtUtils::MakeMaker::vmsish> |
565 | have been removed from this distribution. |
566 | |
567 | =item C<ExtUtils::Manifest> |
568 | |
569 | Upgraded from version 1.51_01 to 1.56. |
570 | |
571 | =item C<ExtUtils::ParseXS> |
572 | |
573 | Upgraded from version 2.18_02 to 2.2002. |
574 | |
575 | =item C<Fatal> |
576 | |
577 | Upgraded from version 1.05 to 2.06_01. See also the new pragma C<autodie>. |
578 | |
579 | =item C<File::Basename> |
580 | |
581 | Upgraded from version 2.76 to 2.77. |
582 | |
583 | =item C<File::Compare> |
584 | |
585 | Upgraded from version 1.1005 to 1.1006. |
586 | |
587 | =item C<File::Copy> |
588 | |
0de885a9 |
589 | Upgraded from version 2.11 to 2.16. |
5a00ee6a |
590 | |
ad1d1c50 |
591 | File::Copy now always return 0 (not "") on failure. |
592 | |
0de885a9 |
593 | FIXME - describe C<cp> |
594 | |
5a00ee6a |
595 | =item C<File::Fetch> |
596 | |
597 | Upgraded from version 0.14 to 0.20. |
598 | |
599 | =item C<File::Find> |
600 | |
601 | Upgraded from version 1.12 to 1.14. |
602 | |
603 | =item C<File::Path> |
604 | |
605 | Upgraded from version 2.04 to 2.07_03. |
606 | |
607 | =item C<File::Spec> |
608 | |
609 | Upgraded from version 3.2501 to 3.30. |
610 | |
611 | =item C<File::stat> |
612 | |
613 | Upgraded from version 1.00 to 1.01. |
614 | |
ad1d1c50 |
615 | Added -X overloading, -M, -C and -A. |
616 | |
5a00ee6a |
617 | =item C<File::Temp> |
618 | |
619 | Upgraded from version 0.18 to 0.22. |
620 | |
621 | =item C<FileCache> |
622 | |
623 | Upgraded from version 1.07 to 1.08. |
624 | |
625 | =item C<FileHandle> |
626 | |
627 | Upgraded from version 2.01 to 2.02. |
628 | |
629 | =item C<Filter::Simple> |
630 | |
631 | Upgraded from version 0.82 to 0.84. |
632 | |
633 | =item C<Filter::Util::Call> |
634 | |
635 | Upgraded from version 1.07 to 1.08. |
636 | |
637 | =item C<FindBin> |
638 | |
639 | Upgraded from version 1.49 to 1.50. |
640 | |
641 | =item C<GDBM_File> |
642 | |
643 | Upgraded from version 1.08 to 1.09. |
644 | |
645 | =item C<Getopt::Long> |
646 | |
647 | Upgraded from version 2.37 to 2.38. |
648 | |
649 | =item C<Hash::Util::FieldHash> |
650 | |
651 | Upgraded from version 1.03 to 1.04. This fixes a memory leak. |
652 | |
653 | =item C<I18N::Collate> |
654 | |
655 | Upgraded from version 1.00 to 1.01. |
656 | |
657 | =item C<IO> |
658 | |
659 | Upgraded from version 1.23_01 to 1.25. |
660 | |
661 | This makes non-blocking mode work on Windows in C<IO::Socket::INET> |
662 | [CPAN #43573]. |
663 | |
664 | =item C<IO::Compress::*> |
665 | |
666 | Upgraded from version 2.008 to 2.020. |
667 | |
668 | =item C<IO::Dir> |
669 | |
670 | Upgraded from version 1.06 to 1.07. |
671 | |
672 | =item C<IO::Handle> |
673 | |
674 | Upgraded from version 1.27 to 1.28. |
675 | |
676 | =item C<IO::Socket> |
677 | |
678 | Upgraded from version 1.30_01 to 1.31. |
679 | |
680 | =item C<IO::Zlib> |
681 | |
682 | Upgraded from version 1.07 to 1.09. |
683 | |
684 | =item C<IPC::Cmd> |
685 | |
686 | Upgraded from version 0.40_1 to 0.46. |
687 | |
688 | =item C<IPC::Open3> |
689 | |
690 | Upgraded from version 1.02 to 1.04. |
691 | |
692 | =item C<IPC::SysV> |
693 | |
694 | Upgraded from version 1.05 to 2.01. |
695 | |
696 | =item C<lib> |
697 | |
698 | Upgraded from version 0.5565 to 0.62. |
699 | |
700 | =item C<List::Util> |
701 | |
702 | Upgraded from version 1.19 to 1.21. |
703 | |
704 | =item C<Locale::MakeText> |
705 | |
706 | Upgraded from version 1.12 to 1.13. |
707 | |
708 | =item C<Log::Message> |
709 | |
710 | Upgraded from version 0.01 to 0.02. |
711 | |
712 | =item C<Math::BigFloat> |
713 | |
714 | Upgraded from version 1.59 to 1.60. |
715 | |
716 | =item C<Math::BigInt> |
717 | |
718 | Upgraded from version 1.88 to 1.89. |
719 | |
720 | =item C<Math::BigInt::FastCalc> |
721 | |
722 | Upgraded from version 0.16 to 0.19. |
723 | |
724 | =item C<Math::BigRat> |
725 | |
726 | Upgraded from version 0.21 to 0.22. |
727 | |
728 | =item C<Math::Complex> |
729 | |
730 | Upgraded from version 1.37 to 1.56. |
731 | |
732 | =item C<Math::Trig> |
733 | |
734 | Upgraded from version 1.04 to 1.20. |
735 | |
736 | =item C<Memoize> |
737 | |
738 | Upgraded from version 1.01_02 to 1.01_03 (just a minor documentation |
739 | change). |
740 | |
741 | =item C<Module::Build> |
742 | |
743 | Upgraded from version 0.2808_01 to 0.34_02. |
744 | |
745 | =item C<Module::CoreList> |
746 | |
747 | Upgraded from version 2.13 to 2.18. This release no longer contains the |
748 | C<%Module::CoreList::patchlevel> hash. |
749 | |
750 | =item C<Module::Load> |
751 | |
752 | Upgraded from version 0.12 to 0.16. |
753 | |
754 | =item C<Module::Load::Conditional> |
755 | |
756 | Upgraded from version 0.22 to 0.30. |
757 | |
758 | =item C<Module::Loaded> |
759 | |
760 | Upgraded from version 0.01 to 0.02. |
761 | |
762 | =item C<Module::Pluggable> |
763 | |
764 | Upgraded from version 3.6 to 3.9. |
765 | |
766 | =item C<NDBM_File> |
767 | |
768 | Upgraded from version 1.07 to 1.08. |
769 | |
770 | =item C<Net::Ping> |
771 | |
772 | Upgraded from version 2.33 to 2.36. |
773 | |
774 | =item C<NEXT> |
775 | |
776 | Upgraded from version 0.60_01 to 0.64. |
777 | |
778 | =item C<Object::Accessor> |
779 | |
780 | Upgraded from version 0.32 to 0.34. |
781 | |
782 | =item C<OS2::REXX> |
783 | |
784 | Upgraded from version 1.03 to 1.04. |
785 | |
786 | =item C<Package::Constants> |
787 | |
788 | Upgraded from version 0.01 to 0.02. |
789 | |
790 | =item C<PerlIO> |
791 | |
792 | Upgraded from version 1.04 to 1.06. |
793 | |
794 | =item C<PerlIO::via> |
795 | |
796 | Upgraded from version 0.04 to 0.07. |
797 | |
798 | =item C<Pod::Man> |
799 | |
800 | Upgraded from version 2.16 to 2.22. |
801 | |
802 | =item C<Pod::Parser> |
803 | |
804 | Upgraded from version 1.35 to 1.37. |
805 | |
ad1d1c50 |
806 | =item Pod::Perldoc |
807 | |
808 | Upgrade from version 3.14_02 to 3.15. |
809 | |
5a00ee6a |
810 | =item C<Pod::Simple> |
811 | |
812 | Upgraded from version 3.05 to 3.07. |
813 | |
814 | =item C<Pod::Text> |
815 | |
816 | Upgraded from version 3.08 to 3.13. |
817 | |
818 | =item C<POSIX> |
819 | |
820 | Upgraded from version 1.13 to 1.17. |
821 | |
822 | =item C<Safe> |
823 | |
824 | Upgraded from 2.12 to 2.18. |
825 | |
826 | =item C<Scalar::Util> |
827 | |
828 | Upgraded from version 1.19 to 1.21. |
829 | |
830 | =item C<SelectSaver> |
831 | |
832 | Upgraded from 1.01 to 1.02. |
833 | |
834 | =item C<SelfLoader> |
835 | |
836 | Upgraded from 1.11 to 1.17. |
837 | |
838 | =item C<Socket> |
839 | |
840 | Upgraded from 1.80 to 1.82. |
841 | |
842 | =item C<Storable> |
843 | |
844 | Upgraded from 2.18 to 2.20. |
845 | |
846 | =item C<Switch> |
847 | |
848 | Upgraded from version 2.13 to 2.14. Please see L</Deprecations>. |
849 | |
850 | =item C<Symbol> |
851 | |
852 | Upgraded from version 1.06 to 1.07. |
853 | |
854 | =item C<Sys::Syslog> |
855 | |
856 | Upgraded from version 0.22 to 0.27. |
857 | |
858 | =item C<Term::ANSIColor> |
859 | |
ad1d1c50 |
860 | Upgraded from version 1.12 to 2.01. |
5a00ee6a |
861 | |
862 | =item C<Term::ReadLine> |
863 | |
864 | Upgraded from version 1.03 to 1.04. |
865 | |
866 | =item C<Term::UI> |
867 | |
868 | Upgraded from version 0.18 to 0.20. |
869 | |
870 | =item C<Test::Harness> |
871 | |
872 | Upgraded from version 2.64 to 3.17. |
873 | |
874 | Note that one side-effect of the 2.x to 3.x upgrade is that the |
875 | experimental C<Test::Harness::Straps> module (and its supporting |
876 | C<Assert>, C<Iterator>, C<Point> and C<Results> modules) have been |
877 | removed. If you still need this, then they are available in the |
878 | (unmaintained) C<Test-Harness-Straps> distribution on CPAN. |
879 | |
880 | =item C<Test::Simple> |
881 | |
882 | Upgraded from version 0.72 to 0.92. |
883 | |
884 | =item C<Text::ParseWords> |
885 | |
886 | Upgraded from version 3.26 to 3.27. |
887 | |
888 | =item C<Text::Tabs> |
889 | |
890 | Upgraded from version 2007.1117 to 2009.0305. |
891 | |
892 | =item C<Text::Wrap> |
893 | |
894 | Upgraded from version 2006.1117 to 2009.0305. |
895 | |
896 | =item C<Thread::Queue> |
897 | |
898 | Upgraded from version 2.00 to 2.11. |
899 | |
900 | =item C<Thread::Semaphore> |
901 | |
902 | Upgraded from version 2.01 to 2.09. |
903 | |
904 | =item C<threads> |
905 | |
ad1d1c50 |
906 | Upgraded from version 1.67 to 1.73. |
5a00ee6a |
907 | |
908 | =item C<threads::shared> |
909 | |
910 | Upgraded from version 1.14 to 1.29. |
911 | |
912 | =item C<Tie::RefHash> |
913 | |
914 | Upgraded from version 1.37 to 1.38. |
915 | |
916 | =item C<Tie::StdHandle> |
917 | |
918 | This has documentation changes, and has been assigned a version for the |
919 | first time: version 4.2. |
920 | |
921 | =item C<Time::HiRes> |
922 | |
923 | Upgraded from version 1.9711 to 1.9719. |
924 | |
925 | =item C<Time::Local> |
926 | |
927 | Upgraded from version 1.18 to 1.1901. |
928 | |
929 | =item C<Time::Piece> |
930 | |
931 | Upgraded from version 1.12 to 1.15. |
932 | |
933 | =item C<Unicode::Normalize> |
934 | |
935 | Upgraded from version 1.02 to 1.03. |
936 | |
937 | =item C<Unicode::UCD> |
938 | |
939 | Upgraded from version 0.25 to 0.27. |
940 | |
941 | C<charinfo()> now works on Unified CJK code points added to later versions |
942 | of Unicode. |
943 | |
944 | C<casefold()> has new fields returned to provide both a simpler interface |
945 | and previously missing information. The old fields are retained for |
946 | backwards compatibility. Information about Turkic-specific code points is |
947 | now returned. |
948 | |
949 | The documentation has been corrected and expanded. |
950 | |
951 | =item C<UNIVERSAL> |
952 | |
953 | Upgraded from version 1.04 to 1.05. |
954 | |
ad1d1c50 |
955 | UNIVERSAL->import() is now deprecated. |
956 | |
5a00ee6a |
957 | =item C<Win32> |
958 | |
959 | Upgraded from version 0.34 to 0.39. |
960 | |
961 | =item C<Win32API::File> |
962 | |
963 | Upgraded from version 0.1001_01 to 0.1101. |
964 | |
965 | =item C<XSLoader> |
966 | |
967 | Upgraded from version 0.08 to 0.10. |
968 | |
969 | =back |
970 | |
971 | =head1 Utility Changes |
972 | |
973 | =over 4 |
974 | |
975 | =item F<h2ph> |
976 | |
977 | Now looks in C<include-fixed> too, which is a recent addition to gcc's |
978 | search path. |
979 | |
980 | =item F<h2xs> |
981 | |
982 | No longer incorrectly treats enum values like macros (Daniel Burr). |
983 | |
984 | Now handles C++ style constants (C<//>) properly in enums. (A patch from |
985 | Rainer Weikusat was used; Daniel Burr also proposed a similar fix). |
986 | |
987 | =item F<perl5db.pl> |
988 | |
989 | C<LVALUE> subroutines now work under the debugger. |
990 | |
991 | The debugger now correctly handles proxy constant subroutines, and |
992 | subroutine stubs. |
993 | |
ad1d1c50 |
994 | =item F<perlbug> |
995 | |
038a5866 |
996 | F<perlbug> now uses C<%Module::CoreList::bug_tracker> to print out upstream bug |
76e3c4a8 |
997 | tracker URLs. |
ad1d1c50 |
998 | |
999 | Where the user names a module that their bug report is about, and we know the |
1000 | URL for its upstream bug tracker, provide a message to the user explaining |
1001 | that the core copies the CPAN version directly, and provide the URL for |
1002 | reporting the bug directly to upstream. |
1003 | |
5a00ee6a |
1004 | =item F<perlthanks> |
1005 | |
3141b5e1 |
1006 | Perl 5.11.0 added a new utility F<perlthanks>, which is a variant of |
5a00ee6a |
1007 | F<perlbug>, but for sending non-bug-reports to the authors and maintainers |
1008 | of Perl. Getting nothing but bug reports can become a bit demoralising: |
1009 | we'll see if this changes things. |
1010 | |
1011 | =back |
1012 | |
1013 | =head1 New Documentation |
1014 | |
1015 | =over 4 |
1016 | |
1017 | =item L<perlhaiku> |
1018 | |
1019 | This contains instructions on how to build perl for the Haiku platform. |
1020 | |
1021 | =item L<perlmroapi> |
1022 | |
1023 | This describes the new interface for pluggable Method Resolution Orders. |
1024 | |
1025 | =item L<perlperf> |
1026 | |
1027 | This document, by Richard Foley, provides an introduction to the use of |
1028 | performance and optimization techniques which can be used with particular |
1029 | reference to perl programs. |
1030 | |
1031 | =item L<perlrepository> |
1032 | |
1033 | This describes how to access the perl source using the I<git> version |
1034 | control system. |
1035 | |
1036 | =item L<perlthanks> |
1037 | |
1038 | This describes the new F<perlthanks> utility. |
1039 | |
1040 | =back |
1041 | |
1042 | =head1 Changes to Existing Documentation |
1043 | |
76e3c4a8 |
1044 | The various large F<Changes*> files (which listed every change made to perl |
5a00ee6a |
1045 | over the last 18 years) have been removed, and replaced by a small file, |
76e3c4a8 |
1046 | also called F<Changes>, which just explains how that same information may |
5a00ee6a |
1047 | be extracted from the git version control system. |
1048 | |
1049 | The file F<Porting/patching.pod> has been deleted, as it mainly described |
1050 | interacting with the old Perforce-based repository, which is now obsolete. |
1051 | Information still relevant has been moved to L<perlrepository>. |
1052 | |
1053 | L<perlapi>, L<perlintern>, L<perlmodlib> and L<perltoc> are now all |
1054 | generated at build time, rather than being shipped as part of the release. |
1055 | |
ad1d1c50 |
1056 | =head2 Documented -X overloading. |
1057 | |
1058 | =head2 Documented that when() treats specially most of the filetest operators |
1059 | |
ad1d1c50 |
1060 | =head2 Documented when as a syntax modifier |
1061 | |
1062 | =head2 Eliminated "Old Perl threads tutorial", which describes 5005 threads. |
1063 | |
1064 | pod/perlthrtut.pod is the same material reworked for ithreads. |
1065 | |
ad1d1c50 |
1066 | =head2 Correct previous documentation: v-strings are not deprecated |
1067 | |
1068 | With version objects, we need them to use MODULE VERSION syntax. This |
1069 | patch removes the deprecation note. |
1070 | |
5a00ee6a |
1071 | =head1 Performance Enhancements |
1072 | |
1073 | =over 4 |
1074 | |
1075 | =item * |
1076 | |
1077 | A new internal cache means that C<isa()> will often be faster. |
1078 | |
1079 | =item * |
1080 | |
6f54462f |
1081 | The implementation of C<C3> Method Resolution Order has been optimised - |
1082 | linearisation for classes with single inheritance is 40% faster. Performance |
1083 | for multiple inheritance is unchanged. |
1084 | |
1085 | =item * |
1086 | |
5a00ee6a |
1087 | Under C<use locale>, the locale-relevant information is now cached on |
1088 | read-only values, such as the list returned by C<keys %hash>. This makes |
1089 | operations such as C<sort keys %hash> in the scope of C<use locale> much |
1090 | faster. |
1091 | |
1092 | =item * |
1093 | |
1094 | Empty C<DESTROY> methods are no longer called. |
1095 | |
ad1d1c50 |
1096 | =item * |
1097 | |
1098 | Faster sv_utf8_upgrade() |
1099 | |
1100 | =item * |
1101 | |
1102 | Speed up keys() on empty hash |
1103 | |
5a00ee6a |
1104 | =back |
1105 | |
1106 | =head1 Installation and Configuration Improvements |
1107 | |
1108 | =head2 F<ext/> reorganisation |
1109 | |
1110 | The layout of directories in F<ext> has been revised. Specifically, all |
1111 | extensions are now flat, and at the top level, with C</> in pathnames |
1112 | replaced by C<->, so that F<ext/Data/Dumper/> is now F<ext/Data-Dumper/>, |
1113 | etc. The names of the extensions as specified to F<Configure>, and as |
1114 | reported by C<%Config::Config> under the keys C<dynamic_ext>, |
1115 | C<known_extensions>, C<nonxs_ext> and C<static_ext> have not changed, and |
1116 | still use C</>. Hence this change will not have any affect once perl is |
1117 | installed. However, C<Attribute::Handlers>, C<Safe> and C<mro> have now |
1118 | become extensions in their own right, so if you run F<Configure> with |
1119 | options to specify an exact list of extensions to build, you will need to |
1120 | change it to account for this. |
1121 | |
3141b5e1 |
1122 | For 5.11.1, it is planned that many dual-life modules will have been moved |
5a00ee6a |
1123 | from F<lib> to F<ext>; again this will have no effect on an installed |
1124 | perl, but will matter if you invoke F<Configure> with a pre-canned list of |
1125 | extensions to build. |
1126 | |
1127 | =head2 Configuration improvements |
1128 | |
1129 | If C<vendorlib> and C<vendorarch> are the same, then they are only added to |
1130 | C<@INC> once. |
1131 | |
1132 | C<$Config{usedevel}> and the C-level C<PERL_USE_DEVEL> are now defined if |
1133 | perl is built with C<-Dusedevel>. |
1134 | |
1135 | F<Configure> will enable use of C<-fstack-protector>, to provide protection |
1136 | against stack-smashing attacks, if the compiler supports it. |
1137 | |
1138 | F<Configure> will now determine the correct prototypes for re-entrant |
1139 | functions, and for C<gconvert>, if you are using a C++ compiler rather |
1140 | than a C compiler. |
1141 | |
1142 | On Unix, if you build from a tree containing a git repository, the |
1143 | configuration process will note the commit hash you have checked out, for |
1144 | display in the output of C<perl -v> and C<perl -V>. Unpushed local commits |
1145 | are automatically added to the list of local patches displayed by |
1146 | C<perl -V>. |
1147 | |
1148 | =head2 Compilation improvements |
1149 | |
1150 | As part of the flattening of F<ext>, all extensions on all platforms are |
1151 | built by F<make_ext.pl>. This replaces the Unix-specific |
1152 | F<ext/util/make_ext>, VMS-specific F<make_ext.com> and Win32-specific |
1153 | F<win32/buildext.pl>. |
1154 | |
1155 | =head2 Platform Specific Changes |
1156 | |
1157 | =over 4 |
1158 | |
1159 | =item AIX |
1160 | |
1161 | Removed F<libbsd> for AIX 5L and 6.1. Only flock() was used from F<libbsd>. |
1162 | |
1163 | Removed F<libgdbm> for AIX 5L and 6.1. The F<libgdbm> is delivered as an |
1164 | optional package with the AIX Toolbox. Unfortunately the 64 bit version |
1165 | is broken. |
1166 | |
1167 | Hints changes mean that AIX 4.2 should work again. |
1168 | |
1169 | =item Cygwin |
1170 | |
1171 | On Cygwin we now strip the last number from the DLL. This has been the |
1172 | behaviour in the cygwin.com build for years. The hints files have been |
1173 | updated. |
1174 | |
81afb674 |
1175 | =item DomainOS |
1176 | |
1177 | Support for Apollo DomainOS was removed in Perl 5.11.0 |
1178 | |
5a00ee6a |
1179 | =item FreeBSD |
1180 | |
1181 | The hints files now identify the correct threading libraries on FreeBSD 7 |
1182 | and later. |
1183 | |
1184 | =item Irix |
1185 | |
1186 | We now work around a bizarre preprocessor bug in the Irix 6.5 compiler: |
1187 | C<cc -E -> unfortunately goes into K&R mode, but C<cc -E file.c> doesn't. |
1188 | |
1189 | =item Haiku |
1190 | |
1191 | Patches from the Haiku maintainers have been merged in. Perl should now |
1192 | build on Haiku. |
1193 | |
81afb674 |
1194 | =item MiNT |
1195 | |
1196 | Support for Atari MiNT was removed in Perl 5.11.0. |
1197 | |
5a00ee6a |
1198 | =item MirOS BSD |
1199 | |
1200 | Perl should now build on MirOS BSD. |
1201 | |
1202 | =item NetBSD |
1203 | |
1204 | Hints now supports versions 5.*. |
1205 | |
1206 | =item Stratus VOS |
1207 | |
1208 | Various changes from Stratus have been merged in. |
1209 | |
1210 | =item Symbian |
1211 | |
1212 | There is now support for Symbian S60 3.2 SDK and S60 5.0 SDK. |
1213 | |
1214 | =item Win32 |
1215 | |
1216 | Improved message window handling means that C<alarm> and C<kill> messages |
1217 | will no longer be dropped under race conditions. |
1218 | |
1219 | =item VMS |
1220 | |
1221 | Reads from the in-memory temporary files of C<PerlIO::scalar> used to fail |
1222 | if C<$/> was set to a numeric reference (to indicate record-style reads). |
1223 | This is now fixed. |
1224 | |
1225 | VMS now supports C<getgrgid>. |
1226 | |
1227 | Many improvements and cleanups have been made to the VMS file name handling |
1228 | and conversion code. |
1229 | |
1230 | Enabling the C<PERL_VMS_POSIX_EXIT> logical name now encodes a POSIX exit |
1231 | status in a VMS condition value for better interaction with GNV's bash |
1232 | shell and other utilities that depend on POSIX exit values. See |
1233 | L<perlvms/"$?"> for details. |
1234 | |
76e3c4a8 |
1235 | C<File::Copy> now detects Unix compatibility mode on VMS. |
ad1d1c50 |
1236 | |
5a00ee6a |
1237 | =back |
1238 | |
1239 | =head1 Selected Bug Fixes |
1240 | |
1241 | =over 4 |
1242 | |
038a5866 |
1243 | =item * |
5a00ee6a |
1244 | |
038a5866 |
1245 | C<-I> on shebang line now adds directories in front of @INC. |
5a00ee6a |
1246 | as documented, and as does C<-I> when specified on the command-line. |
1247 | (Renée Bäcker) |
1248 | |
76e3c4a8 |
1249 | =item * |
5a00ee6a |
1250 | |
76e3c4a8 |
1251 | C<kill> is now fatal when called on non-numeric process identifiers. |
5a00ee6a |
1252 | Previously, an 'undef' process identifier would be interpreted as a request to |
1253 | kill process "0", which would terminate the current process group on POSIX |
1254 | systems. Since process identifiers are always integers, killing a non-numeric |
1255 | process is now fatal. |
1256 | |
1257 | =item * |
1258 | |
1259 | 5.10.0 inadvertently disabled an optimisation, which caused a measurable |
1260 | performance drop in list assignment, such as is often used to assign |
1261 | function parameters from C<@_>. The optimisation has been re-instated, and |
1262 | the performance regression fixed. |
1263 | |
1264 | =item * |
1265 | |
1266 | Fixed memory leak on C<while (1) { map 1, 1 }> [RT #53038]. |
1267 | |
1268 | =item * |
1269 | |
1270 | Some potential coredumps in PerlIO fixed [RT #57322,54828]. |
1271 | |
1272 | =item * |
1273 | |
1274 | The debugger now works with lvalue subroutines. |
1275 | |
1276 | =item * |
1277 | |
1278 | The debugger's C<m> command was broken on modules that defined constants |
1279 | [RT #61222]. |
1280 | |
1281 | =item * |
1282 | |
1283 | C<crypt()> and string complement could return tainted values for untainted |
1284 | arguments [RT #59998]. |
1285 | |
1286 | =item * |
1287 | |
038a5866 |
1288 | The C<-i>I<.suffix> command-line switch now recreates the file using |
5a00ee6a |
1289 | restricted permissions, before changing its mode to match the original |
1290 | file. This eliminates a potential race condition [RT #60904]. |
1291 | |
1292 | =item * |
1293 | |
1294 | On some UNIX systems, the value in C<$?> would not have the top bit set |
1295 | (C<$? & 128>) even if the child core dumped. |
1296 | |
1297 | =item * |
1298 | |
038a5866 |
1299 | Under some circumstances, C<$^R> could incorrectly become undefined |
5a00ee6a |
1300 | [RT #57042]. |
1301 | |
1302 | =item * |
1303 | |
a048364f |
1304 | In the XS API, various hash functions, when passed a pre-computed hash where |
1305 | the key is UTF-8, might result in an incorrect lookup. |
5a00ee6a |
1306 | |
1307 | =item * |
1308 | |
a048364f |
1309 | XS code including F<XSUB.h> before F<perl.h> gave a compile-time error |
5a00ee6a |
1310 | [RT #57176]. |
1311 | |
1312 | =item * |
1313 | |
1314 | C<< $object->isa('Foo') >> would report false if the package C<Foo> didn't |
1315 | exist, even if the object's C<@ISA> contained C<Foo>. |
1316 | |
1317 | =item * |
1318 | |
1319 | Various bugs in the new-to 5.10.0 mro code, triggered by manipulating |
1320 | C<@ISA>, have been found and fixed. |
1321 | |
1322 | =item * |
1323 | |
1324 | Bitwise operations on references could crash the interpreter, e.g. |
1325 | C<$x=\$y; $x |= "foo"> [RT #54956]. |
1326 | |
1327 | =item * |
1328 | |
1329 | Patterns including alternation might be sensitive to the internal UTF-8 |
1330 | representation, e.g. |
1331 | |
1332 | my $byte = chr(192); |
1333 | my $utf8 = chr(192); utf8::upgrade($utf8); |
1334 | $utf8 =~ /$byte|X}/i; # failed in 5.10.0 |
1335 | |
1336 | =item * |
1337 | |
1338 | Within UTF8-encoded Perl source files (i.e. where C<use utf8> is in |
1339 | effect), double-quoted literal strings could be corrupted where a C<\xNN>, |
1340 | C<\0NNN> or C<\N{}> is followed by a literal character with ordinal value |
1341 | greater than 255 [RT #59908]. |
1342 | |
1343 | =item * |
1344 | |
1345 | C<B::Deparse> failed to correctly deparse various constructs: |
1346 | C<readpipe STRING> [RT #62428], C<CORE::require(STRING)> [RT #62488], |
1347 | C<sub foo(_)> [RT #62484]. |
1348 | |
1349 | =item * |
1350 | |
1351 | Using C<setpgrp()> with no arguments could corrupt the perl stack. |
1352 | |
1353 | =item * |
1354 | |
1355 | The block form of C<eval> is now specifically trappable by C<Safe> and |
1356 | C<ops>. Previously it was erroneously treated like string C<eval>. |
1357 | |
1358 | =item * |
1359 | |
1360 | In 5.10.0, the two characters C<[~> were sometimes parsed as the smart |
1361 | match operator (C<~~>) [RT #63854]. |
1362 | |
1363 | =item * |
1364 | |
1365 | In 5.10.0, the C<*> quantifier in patterns was sometimes treated as |
1366 | C<{0,32767}> [RT #60034, #60464]. For example, this match would fail: |
1367 | |
1368 | ("ab" x 32768) =~ /^(ab)*$/ |
1369 | |
1370 | =item * |
1371 | |
1372 | C<shmget> was limited to a 32 bit segment size on a 64 bit OS [RT #63924]. |
1373 | |
1374 | =item * |
1375 | |
1376 | Using C<next> or C<last> to exit a C<given> block no longer produces a |
1377 | spurious warning like the following: |
1378 | |
1379 | Exiting given via last at foo.pl line 123 |
1380 | |
1381 | =item * |
1382 | |
1383 | On Windows, C<'.\foo'> and C<'..\foo'> were treated differently than |
1384 | C<'./foo'> and C<'../foo'> by C<do> and C<require> [RT #63492]. |
1385 | |
1386 | =item * |
1387 | |
1388 | Assigning a format to a glob could corrupt the format; e.g.: |
1389 | |
1390 | *bar=*foo{FORMAT}; # foo format now bad |
1391 | |
1392 | =item * |
1393 | |
1394 | Attempting to coerce a typeglob to a string or number could cause an |
1395 | assertion failure. The correct error message is now generated, |
1396 | C<Can't coerce GLOB to I<$type>>. |
1397 | |
1398 | =item * |
1399 | |
1400 | Under C<use filetest 'access'>, C<-x> was using the wrong access mode. This |
1401 | has been fixed [RT #49003]. |
1402 | |
1403 | =item * |
1404 | |
1405 | C<length> on a tied scalar that returned a Unicode value would not be |
1406 | correct the first time. This has been fixed. |
1407 | |
1408 | =item * |
1409 | |
1410 | Using an array C<tie> inside in array C<tie> could SEGV. This has been |
1411 | fixed. [RT #51636] |
1412 | |
1413 | =item * |
1414 | |
1415 | A race condition inside C<PerlIOStdio_close()> has been identified and |
1416 | fixed. This used to cause various threading issues, including SEGVs. |
1417 | |
1418 | =item * |
1419 | |
1420 | In C<unpack>, the use of C<()> groups in scalar context was internally |
1421 | placing a list on the interpreter's stack, which manifested in various |
1422 | ways, including SEGVs. This is now fixed [RT #50256]. |
1423 | |
1424 | =item * |
1425 | |
1426 | Magic was called twice in C<substr>, C<\&$x>, C<tie $x, $m> and C<chop>. |
1427 | These have all been fixed. |
1428 | |
1429 | =item * |
1430 | |
1431 | A 5.10.0 optimisation to clear the temporary stack within the implicit |
1432 | loop of C<s///ge> has been reverted, as it turned out to be the cause of |
1433 | obscure bugs in seemingly unrelated parts of the interpreter [commit |
1434 | ef0d4e17921ee3de]. |
1435 | |
1436 | =item * |
1437 | |
1438 | The line numbers for warnings inside C<elsif> are now correct. |
1439 | |
1440 | =item * |
1441 | |
1442 | The C<..> operator now works correctly with ranges whose ends are at or |
1443 | close to the values of the smallest and largest integers. |
1444 | |
1445 | =item * |
1446 | |
1447 | C<binmode STDIN, ':raw'> could lead to segmentation faults on some platforms. |
1448 | This has been fixed [RT #54828]. |
1449 | |
1450 | =item * |
1451 | |
1452 | An off-by-one error meant that C<index $str, ...> was effectively being |
1453 | executed as C<index "$str\0", ...>. This has been fixed [RT #53746]. |
1454 | |
1455 | =item * |
1456 | |
1457 | Various leaks associated with named captures in regexes have been fixed |
1458 | [RT #57024]. |
1459 | |
1460 | =item * |
1461 | |
1462 | A weak reference to a hash would leak. This was affecting C<DBI> |
1463 | [RT #56908]. |
1464 | |
1465 | =item * |
1466 | |
1467 | Using (?|) in a regex could cause a segfault [RT #59734]. |
1468 | |
1469 | =item * |
1470 | |
1471 | Use of a UTF-8 C<tr//> within a closure could cause a segfault [RT #61520]. |
1472 | |
1473 | =item * |
1474 | |
1475 | Calling C<sv_chop()> or otherwise upgrading an SV could result in an |
1476 | unaligned 64-bit access on the SPARC architecture [RT #60574]. |
1477 | |
1478 | =item * |
1479 | |
1480 | In the 5.10.0 release, C<inc_version_list> would incorrectly list |
1481 | C<5.10.*> after C<5.8.*>; this affected the C<@INC> search order |
1482 | [RT #67628]. |
1483 | |
1484 | =item * |
1485 | |
1486 | In 5.10.0, C<pack "a*", $tainted_value> returned a non-tainted value |
1487 | [RT #52552]. |
1488 | |
1489 | =item * |
1490 | |
1491 | In 5.10.0, C<printf> and C<sprintf> could produce the fatal error |
1492 | C<panic: utf8_mg_pos_cache_update> when printing UTF-8 strings |
1493 | [RT #62666]. |
1494 | |
1495 | =item * |
1496 | |
1497 | In the 5.10.0 release, a dynamically created C<AUTOLOAD> method might be |
1498 | missed (method cache issue) [RT #60220,60232]. |
1499 | |
1500 | =item * |
1501 | |
1502 | In the 5.10.0 release, a combination of C<use feature> and C<//ee> could |
1503 | cause a memory leak [RT #63110]. |
1504 | |
1505 | =item * |
1506 | |
1507 | C<-C> on the shebang (C<#!>) line is once more permitted if it is also |
1508 | specified on the command line. C<-C> on the shebang line used to be a |
1509 | silent no-op I<if> it was not also on the command line, so perl 5.10.0 |
1510 | disallowed it, which broke some scripts. Now perl checks whether it is |
1511 | also on the command line and only dies if it is not [RT #67880]. |
1512 | |
1513 | =item * |
1514 | |
1515 | In 5.10.0, certain types of re-entrant regular expression could crash, |
1516 | or cause the following assertion failure [RT #60508]: |
1517 | |
1518 | Assertion rx->sublen >= (s - rx->subbeg) + i failed |
1519 | |
5a00ee6a |
1520 | =back |
1521 | |
1522 | =head1 New or Changed Diagnostics |
1523 | |
1524 | =over 4 |
1525 | |
1526 | =item C<panic: sv_chop %s> |
1527 | |
1528 | This new fatal error occurs when the C routine C<Perl_sv_chop()> was |
1529 | passed a position that is not within the scalar's string buffer. This |
1530 | could be caused by buggy XS code, and at this point recovery is not |
1531 | possible. |
1532 | |
1533 | =item C<Can't locate package %s for the parents of %s> |
1534 | |
1535 | This warning has been removed. In general, it only got produced in |
1536 | conjunction with other warnings, and removing it allowed an ISA lookup |
1537 | optimisation to be added. |
1538 | |
1539 | =item C<v-string in use/require is non-portable> |
1540 | |
1541 | This warning has been removed. |
1542 | |
1543 | =item C<Deep recursion on subroutine "%s"> |
1544 | |
1545 | It is now possible to change the depth threshold for this warning from the |
1546 | default of 100, by recompiling the F<perl> binary, setting the C |
1547 | pre-processor macro C<PERL_SUB_DEPTH_WARN> to the desired value. |
1548 | |
1549 | =back |
1550 | |
1551 | =head1 Changed Internals |
1552 | |
1553 | =over 4 |
1554 | |
1555 | =item * |
1556 | |
1557 | The J.R.R. Tolkien quotes at the head of C source file have been checked and |
1558 | proper citations added, thanks to a patch from Tom Christiansen. |
1559 | |
1560 | =item * |
1561 | |
1562 | C<vcroak()> now accepts a null first argument. In addition, a full audit |
1563 | was made of the "not NULL" compiler annotations, and those for several |
1564 | other internal functions were corrected. |
1565 | |
1566 | =item * |
1567 | |
1568 | New macros C<dSAVEDERRNO>, C<dSAVE_ERRNO>, C<SAVE_ERRNO>, C<RESTORE_ERRNO> |
1569 | have been added to formalise the temporary saving of the C<errno> |
1570 | variable. |
1571 | |
1572 | =item * |
1573 | |
1574 | The function C<Perl_sv_insert_flags> has been added to augment |
1575 | C<Perl_sv_insert>. |
1576 | |
1577 | =item * |
1578 | |
1579 | The function C<Perl_newSV_type(type)> has been added, equivalent to |
1580 | C<Perl_newSV()> followed by C<Perl_sv_upgrade(type)>. |
1581 | |
1582 | =item * |
1583 | |
1584 | The function C<Perl_newSVpvn_flags()> has been added, equivalent to |
1585 | C<Perl_newSVpvn()> and then performing the action relevant to the flag. |
1586 | |
1587 | Two flag bits are currently supported. |
1588 | |
1589 | =over 4 |
1590 | |
1591 | =item C<SVf_UTF8> |
1592 | |
1593 | This will call C<SvUTF8_on()> for you. (Note that this does not convert an |
1594 | sequence of ISO 8859-1 characters to UTF-8). A wrapper, C<newSVpvn_utf8()> |
1595 | is available for this. |
1596 | |
1597 | =item C<SVs_TEMP> |
1598 | |
1599 | Call C<sv_2mortal()> on the new SV. |
1600 | |
1601 | =back |
1602 | |
1603 | There is also a wrapper that takes constant strings, C<newSVpvs_flags()>. |
1604 | |
1605 | =item * |
1606 | |
1607 | The function C<Perl_croak_xs_usage> has been added as a wrapper to |
1608 | C<Perl_croak>. |
1609 | |
1610 | =item * |
1611 | |
1612 | The functions C<PerlIO_find_layer> and C<PerlIO_list_alloc> are now |
1613 | exported. |
1614 | |
1615 | =item * |
1616 | |
1617 | C<PL_na> has been exterminated from the core code, replaced by local STRLEN |
1618 | temporaries, or C<*_nolen()> calls. Either approach is faster than C<PL_na>, |
1619 | which is a pointer deference into the interpreter structure under ithreads, |
1620 | and a global variable otherwise. |
1621 | |
1622 | =item * |
1623 | |
1624 | C<Perl_mg_free()> used to leave freed memory accessible via SvMAGIC() on |
1625 | the scalar. It now updates the linked list to remove each piece of magic |
1626 | as it is freed. |
1627 | |
1628 | =item * |
1629 | |
1630 | Under ithreads, the regex in C<PL_reg_curpm> is now reference counted. This |
1631 | eliminates a lot of hackish workarounds to cope with it not being reference |
1632 | counted. |
1633 | |
1634 | =item * |
1635 | |
1636 | C<Perl_mg_magical()> would sometimes incorrectly turn on C<SvRMAGICAL()>. |
1637 | This has been fixed. |
1638 | |
1639 | =item * |
1640 | |
1641 | The I<public> IV and NV flags are now not set if the string value has |
1642 | trailing "garbage". This behaviour is consistent with not setting the |
1643 | public IV or NV flags if the value is out of range for the type. |
1644 | |
1645 | =item * |
1646 | |
1647 | SV allocation tracing has been added to the diagnostics enabled by C<-Dm>. |
1648 | The tracing can alternatively output via the C<PERL_MEM_LOG> mechanism, if |
1649 | that was enabled when the F<perl> binary was compiled. |
1650 | |
1651 | =item * |
1652 | |
1653 | Uses of C<Nullav>, C<Nullcv>, C<Nullhv>, C<Nullop>, C<Nullsv> etc have been |
1654 | replaced by C<NULL> in the core code, and non-dual-life modules, as C<NULL> |
1655 | is clearer to those unfamiliar with the core code. |
1656 | |
1657 | =item * |
1658 | |
1659 | A macro C<MUTABLE_PTR(p)> has been added, which on (non-pedantic) gcc will |
1660 | not cast away C<const>, returning a C<void *>. Macros C<MUTABLE_SV(av)>, |
1661 | C<MUTABLE_SV(cv)> etc build on this, casting to C<AV *> etc without |
1662 | casting away C<const>. This allows proper compile-time auditing of |
1663 | C<const> correctness in the core, and helped picked up some errors (now |
1664 | fixed). |
1665 | |
1666 | =item * |
1667 | |
1668 | Macros C<mPUSHs()> and C<mXPUSHs()> have been added, for pushing SVs on the |
1669 | stack and mortalizing them. |
1670 | |
1671 | =item * |
1672 | |
1673 | Use of the private structure C<mro_meta> has changed slightly. Nothing |
1674 | outside the core should be accessing this directly anyway. |
1675 | |
1676 | =item * |
1677 | |
76e3c4a8 |
1678 | A new tool, F<Porting/expand-macro.pl> has been added, that allows you |
5a00ee6a |
1679 | to view how a C preprocessor macro would be expanded when compiled. |
1680 | This is handy when trying to decode the macro hell that is the perl |
1681 | guts. |
1682 | |
1683 | =back |
1684 | |
1685 | =head1 New Tests |
1686 | |
1687 | Many modules updated from CPAN incorporate new tests. |
1688 | |
1689 | Several tests that have the potential to hang forever if they fail now |
1690 | incorporate a "watchdog" functionality that will kill them after a timeout, |
1691 | which helps ensure that C<make test> and C<make test_harness> run to |
1692 | completion automatically. (Jerry Hedden). |
1693 | |
1694 | Some core-specific tests have been added: |
1695 | |
1696 | =over 4 |
1697 | |
1698 | =item t/comp/retainedlines.t |
1699 | |
1700 | Check that the debugger can retain source lines from C<eval>. |
1701 | |
1702 | =item t/io/perlio_fail.t |
1703 | |
1704 | Check that bad layers fail. |
1705 | |
1706 | =item t/io/perlio_leaks.t |
1707 | |
1708 | Check that PerlIO layers are not leaking. |
1709 | |
1710 | =item t/io/perlio_open.t |
1711 | |
1712 | Check that certain special forms of open work. |
1713 | |
1714 | =item t/io/perlio.t |
1715 | |
1716 | General PerlIO tests. |
1717 | |
1718 | =item t/io/pvbm.t |
1719 | |
1720 | Check that there is no unexpected interaction between the internal types |
1721 | C<PVBM> and C<PVGV>. |
1722 | |
1723 | =item t/mro/package_aliases.t |
1724 | |
1725 | Check that mro works properly in the presence of aliased packages. |
1726 | |
1727 | =item t/op/dbm.t |
1728 | |
1729 | Tests for C<dbmopen> and C<dbmclose>. |
1730 | |
1731 | =item t/op/index_thr.t |
1732 | |
1733 | Tests for the interaction of C<index> and threads. |
1734 | |
1735 | =item t/op/pat_thr.t |
1736 | |
1737 | Tests for the interaction of esoteric patterns and threads. |
1738 | |
1739 | =item t/op/qr_gc.t |
1740 | |
1741 | Test that C<qr> doesn't leak. |
1742 | |
1743 | =item t/op/reg_email_thr.t |
1744 | |
1745 | Tests for the interaction of regex recursion and threads. |
1746 | |
1747 | =item t/op/regexp_qr_embed_thr.t |
1748 | |
1749 | Tests for the interaction of patterns with embedded C<qr//> and threads. |
1750 | |
1751 | =item t/op/regexp_unicode_prop.t |
1752 | |
1753 | Tests for Unicode properties in regular expressions. |
1754 | |
1755 | =item t/op/regexp_unicode_prop_thr.t |
1756 | |
1757 | Tests for the interaction of Unicode properties and threads. |
1758 | |
1759 | =item t/op/reg_nc_tie.t |
1760 | |
1761 | Test the tied methods of C<Tie::Hash::NamedCapture>. |
1762 | |
1763 | =item t/op/reg_posixcc.t |
1764 | |
1765 | Check that POSIX character classes behave consistently. |
1766 | |
1767 | =item t/op/re.t |
1768 | |
1769 | Check that exportable C<re> functions in F<universal.c> work. |
1770 | |
1771 | =item t/op/setpgrpstack.t |
1772 | |
1773 | Check that C<setpgrp> works. |
1774 | |
1775 | =item t/op/substr_thr.t |
1776 | |
1777 | Tests for the interaction of C<substr> and threads. |
1778 | |
1779 | =item t/op/upgrade.t |
1780 | |
1781 | Check that upgrading and assigning scalars works. |
1782 | |
1783 | =item t/uni/lex_utf8.t |
1784 | |
1785 | Check that Unicode in the lexer works. |
1786 | |
1787 | =item t/uni/tie.t |
1788 | |
1789 | Check that Unicode and C<tie> work. |
1790 | |
1791 | =back |
1792 | |
1793 | =head1 Known Problems |
1794 | |
1795 | This is a list of some significant unfixed bugs, which are regressions |
1796 | from either 5.10.0 or 5.8.x. |
1797 | |
1798 | =over 4 |
1799 | |
1800 | =item * |
1801 | |
1802 | C<List::Util::first> misbehaves in the presence of a lexical C<$_> |
1803 | (typically introduced by C<my $_> or implicitly by C<given>). The variable |
1804 | which gets set for each iteration is the package variable C<$_>, not the |
1805 | lexical C<$_> [RT #67694]. |
1806 | |
1807 | A similar issue may occur in other modules that provide functions which |
1808 | take a block as their first argument, like |
1809 | |
1810 | foo { ... $_ ...} list |
1811 | |
1812 | =item * |
1813 | |
1814 | The C<charnames> pragma may generate a run-time error when a regex is |
1815 | interpolated [RT #56444]: |
1816 | |
1817 | use charnames ':full'; |
1818 | my $r1 = qr/\N{THAI CHARACTER SARA I}/; |
1819 | "foo" =~ $r1; # okay |
1820 | "foo" =~ /$r1+/; # runtime error |
1821 | |
1822 | A workaround is to generate the character outside of the regex: |
1823 | |
1824 | my $a = "\N{THAI CHARACTER SARA I}"; |
1825 | my $r1 = qr/$a/; |
1826 | |
1827 | =item * |
1828 | |
1829 | Some regexes may run much more slowly when run in a child thread compared |
1830 | with the thread the pattern was compiled into [RT #55600]. |
1831 | |
5a00ee6a |
1832 | =back |
1833 | |
1834 | =head1 Deprecations |
1835 | |
1836 | The following items are now deprecated. |
1837 | |
1838 | =over 4 |
1839 | |
1840 | =item * |
1841 | |
1842 | C<Switch> is buggy and should be avoided. From perl 5.11.0 onwards, it is |
1843 | intended that any use of the core version of this module will emit a |
1844 | warning, and that the module will eventually be removed from the core |
1845 | (probably in perl 5.14.0). See L<perlsyn/"Switch statements"> for its |
1846 | replacement. |
1847 | |
1848 | =item * |
1849 | |
ad1d1c50 |
1850 | C<suidperl> has been removed. It used to provide a mechanism to |
5a00ee6a |
1851 | emulate setuid permission bits on systems that don't support it properly. |
1852 | |
ad1d1c50 |
1853 | =item * |
1854 | |
1855 | Deprecate assignment to $[ |
1856 | |
1857 | =item * |
1858 | |
1859 | Remove attrs, which has been deprecated since 1999/10/02. |
1860 | |
1861 | =item * |
1862 | |
1863 | Deprecate use of the attribute :locked on subroutines. |
1864 | |
1865 | =item * |
1866 | |
1867 | Deprecate using "locked" with the attributes pragma. |
1868 | |
1869 | =item * |
1870 | |
1871 | Deprecate using "unique" with the attributes pragma. |
1872 | |
1873 | =item * |
1874 | |
1875 | warn if ++ or -- are unable to change the value because it's beyond the limit of representation |
1876 | |
1877 | This uses a new warnings category: "imprecision". |
1878 | |
ad1d1c50 |
1879 | =item * |
1880 | |
1881 | Make lc/uc/lcfirst/ucfirst warn when passed undef. |
1882 | |
1883 | =item * |
1884 | |
1885 | Show constant in "Useless use of a constant in void context" |
1886 | |
1887 | =item * |
1888 | |
1889 | Make the new warning report undef constants as undef |
1890 | |
1891 | =item * |
1892 | |
1893 | Add a new warning, "Prototype after '%s'" |
1894 | |
1895 | =item * |
1896 | |
1897 | Tweak the "Illegal character in prototype" warning so it's more precise when reporting illegal characters after _ |
1898 | |
1899 | =item * |
1900 | |
1901 | Unintented interpolation of $\ in regex |
1902 | |
1903 | =item * |
1904 | |
1905 | Make overflow warnings in gmtime/localtime only occur when warnings are on |
1906 | |
1907 | =item * |
1908 | |
1909 | Improve mro merging error messages. |
1910 | |
1911 | They are now very similar to those produced by Algorithm::C3. |
1912 | |
1913 | =item * |
1914 | |
1915 | Amelioration of the error message "Unrecognized character %s in column %d" |
1916 | |
1917 | Changes the error message to "Unrecognized character %s; marked by <-- |
1918 | HERE after %s<-- HERE near column %d". This should make it a little |
1919 | simpler to spot and correct the suspicious character. |
1920 | |
1921 | =item * |
1922 | |
1923 | Explicitely point to $. when it causes an uninitialized warning for ranges in scalar context |
1924 | |
5a00ee6a |
1925 | =back |
1926 | |
1927 | =head1 Acknowledgements |
1928 | |
1929 | Some of the work in this release was funded by a TPF grant. |
1930 | |
1931 | Nicholas Clark officially retired from maintenance pumpking duty at the |
1932 | end of 2008; however in reality he has put much effort in since then to |
1933 | help get 5.10.1 into a fit state to be released, including writing a |
1934 | considerable chunk of this perldelta. |
1935 | |
1936 | Steffen Mueller and David Golden in particular helped getting CPAN modules |
1937 | polished and synchronised with their in-core equivalents. |
1938 | |
1939 | Craig Berry was tireless in getting maint to run under VMS, no matter how |
1940 | many times we broke it for him. |
1941 | |
1942 | The other core committers contributed most of the changes, and applied most |
1943 | of the patches sent in by the hundreds of contributors listed in F<AUTHORS>. |
7120b314 |
1944 | |
ad1d1c50 |
1945 | Much of the work of categorizing changes in this perldelta file was contributed |
1946 | by the following porters using changelogger.bestpractical.com: |
1947 | |
1948 | Nicholas Clark, leon, shawn, alexm, rjbs, rafl, Pedro Melo, brunorc, |
1949 | anonymous, ☄, Tom Hukins, anonymous, Jesse, dagolden, Moritz Onken, |
1950 | Mark Fowler, chorny, anonymous, tmtm |
1951 | |
5a00ee6a |
1952 | Finally, thanks to Larry Wall, without whom none of this would be |
1953 | necessary. |
7120b314 |
1954 | |
1955 | =head1 Reporting Bugs |
1956 | |
1957 | If you find what you think is a bug, you might check the articles |
1958 | recently posted to the comp.lang.perl.misc newsgroup and the perl |
5a00ee6a |
1959 | bug database at http://rt.perl.org/perlbug/ . There may also be |
7120b314 |
1960 | information at http://www.perl.org/ , the Perl Home Page. |
1961 | |
1962 | If you believe you have an unreported bug, please run the B<perlbug> |
1963 | program included with your release. Be sure to trim your bug down |
1964 | to a tiny but sufficient test case. Your bug report, along with the |
1965 | output of C<perl -V>, will be sent off to perlbug@perl.org to be |
1966 | analysed by the Perl porting team. |
1967 | |
49f8307e |
1968 | If the bug you are reporting has security implications, which make it |
1969 | inappropriate to send to a publicly archived mailing list, then please send |
1970 | it to perl5-security-report@perl.org. This points to a closed subscription |
1971 | unarchived mailing list, which includes all the core committers, who be able |
1972 | to help assess the impact of issues, figure out a resolution, and help |
1973 | co-ordinate the release of patches to mitigate or fix the problem across all |
5a00ee6a |
1974 | platforms on which Perl is supported. Please only use this address for |
1975 | security issues in the Perl core, not for modules independently |
1976 | distributed on CPAN. |
49f8307e |
1977 | |
7120b314 |
1978 | =head1 SEE ALSO |
1979 | |
5a00ee6a |
1980 | The F<Changes> file for an explanation of how to view exhaustive details |
1981 | on what changed. |
7120b314 |
1982 | |
1983 | The F<INSTALL> file for how to build Perl. |
1984 | |
1985 | The F<README> file for general stuff. |
1986 | |
1987 | The F<Artistic> and F<Copying> files for copyright information. |
1988 | |
1989 | =cut |
ad1d1c50 |
1990 | |
1991 | |
1992 | =head1 TODO |
1993 | |
1994 | The following changes are a filtered list of changes which weren't backported |
1995 | to 5.10.1. They were run through changelogger.bestpractical.com and triaged |
1996 | by a set of Perl 5 Porters. Changes to blead after 5945e41e have not yet |
1997 | been triaged or integrated. |
1998 | |
1999 | The following changes need to be |
2000 | |
2001 | 1) deleted if they don't merit inclusion |
2002 | |
2003 | OR |
2004 | |
2005 | 2) lightly copyedited and integrated into the perldelta above. Unfortunately, many of our |
2006 | commit messages are somewhat terse and require a bit more help to turn into something readable |
2007 | |
2008 | |
2009 | |
2010 | |
2011 | =head1 API |
2012 | |
2013 | =head2 Move the reg_stringify logic to Perl_sv_2pv_flags |
2014 | |
2015 | =head2 mg_copy ought to take an I32 |
2016 | |
2017 | =head2 Perl_store_cop_label() isn't meant to be part of the public API. |
2018 | |
2019 | =head2 Perl_gv_fetchmethod{,_autoload,_flags} are actually never* called with a non-NULL stash. |
2020 | So change the parameter to NN. |
2021 | |
2022 | |
2023 | =head2 Promote Perl_setdefout() to the public API. |
2024 | |
2025 | =head2 Add get_cvs() as a shortcut for STR_WITH_LEN() and Perl_get_cvn_flags() |
2026 | |
2027 | =head2 In Perl_newCONSTSUB(), sv should not be NULL. |
2028 | |
2029 | =head2 GvUNIQUE* have been defined as 0 since 2005/06/30 - high time to remove them. |
2030 | |
2031 | =head2 invert and rename PERL_MEM_LOG_STDERR to PERL_MEM_LOG_NOIMPL |
2032 | |
2033 | Most users who want PERL_MEM_LOG want the default implementation, |
2034 | give it to them. Users providing their own implementation can |
2035 | obtain current behavior by adding -DPERL_MEM_LOG_NOIMPL. |
2036 | Frankly, the average user probably wants _ENV by default too. |
2037 | |
2038 | =head2 simplify PERL_MEM_LOG |
2039 | |
2040 | This combines multiple environment variable reads into 1, |
2041 | where it looks for values like "2mst" |
2042 | -2 leading digits are atoi()d to get FD |
2043 | -m memory logging please |
2044 | -s sv logging also |
2045 | -t timestamp those please. |
2046 | |
2047 | Combining these reduces overhead such that it seemed |
2048 | worthwhile to drop all the ifdefs. TBD whether this works |
2049 | in the environment that drove the original tradeoffs. |
2050 | |
2051 | If it isnt enough, Id be tempted by a global static ptr, |
2052 | and on 1st use, is read, seen 0, a lock is taken, and getenvar |
2053 | run to populate it, unlocked, proceed. This would remove |
2054 | iterative overheads. |
2055 | |
2056 | =head2 Add a parameter "destructing" to Gv_AMupdate() |
2057 | |
2058 | This boolean parameter indicates if the function has been called |
2059 | to update the overload magic table while looking up the DESTROY |
2060 | method. In this case, it's probably best to avoid croaking if |
2061 | those tables could not be updated (for example due to a method |
2062 | that could not be loaded.) |
2063 | |
2064 | =head2 Modify the return value of Gv_AMupdate to indicate a compilation error |
2065 | |
2066 | This way we'll restore most of the performance on object desctruction |
2067 | lost by the previous commit |
2068 | |
2069 | |
2070 | =head2 local $SIG{FOO} = sub {...}; sets signal handler to SIG_DFL |
2071 | |
2072 | Re: [perl #60360] [PATCH] UPDATED: local $SIG{FOO} = sub {...}; sets signal handler to SIG_DFL |
2073 | Message-ID: <20081112234504.GI2062@tytlal.topaz.cx> |
2074 | |
2075 | Updated patch to retain source compatibility. |
2076 | |
2077 | Plus using the correct PERL_ARGS_ASSERT_SAVE_HELEM_FLAGS |
2078 | macro and running make regen. |
2079 | |
2080 | =head2 Respecting inc_version_list while processing PERL_VENDORLIB_STEM |
2081 | |
2082 | Respecting inc_version_list while processing PERL_VENDORLIB_STEM |
2083 | From: "Mandalemula, Rajesh" <Rajesh.Mandalemula@deshaw.com> |
2084 | |
2085 | =head2 Change PL_debug behaviour |
2086 | |
2087 | |
2088 | String eval lines are now saved whenever |
2089 | a subroutine is defined, even if the eval'd string has subsequent |
2090 | syntax errors. This allows the debugger to single step into these |
2091 | subroutines. |
2092 | |
2093 | |
2094 | =head2 Tied filehandles now have an additional method EOF which provides the EOF type |
2095 | |
2096 | =head2 Perl is now smarter about adding a -I dir to the beginning or end of @INC |
2097 | |
2098 | =head2 On scope end, delete localized array elements that should not exist anymore, so that the array recovers its previous length. Honour EXISTS and DELETE for tied arrays. |
2099 | |
2100 | =head2 When a glob is deleted, mark its sub as ANON. |
2101 | |
2102 | =head2 Require a space or a newline after a "#line XXX" directive |
2103 | |
2104 | =head2 Forbid using "foreach" as an attribute |
2105 | |
2106 | (like all other control flow statements) |
2107 | |
2108 | |
2109 | =head2 Unregister signal handlers before destroying my_perl |
2110 | |
2111 | If the signal handler runs after perl_destruct() has been called, it |
2112 | will get an invalid (or NULL) my_perl when it asks for the |
2113 | thread-specific interpreter struct. This patch resets the signal |
2114 | handler for any signal previously handled by PL_csighandlerp to SIG_DFL |
2115 | before calling perl_destruct(). |
2116 | |
2117 | =head2 Perl_magic_clearsig() needs to remove magic, else delete $SIG{INT} returns undef |
2118 | |
2119 | Perl_magic_clearsig() needs to remove magic, else delete $SIG{INT} returns undef |
2120 | instead of the now-removed INT handler. |
2121 | |
2122 | =head2 [perl #66452] TMPDIR not honored when opening an anonymous temporary file |
2123 | |
2124 | [perl #66452] TMPDIR not honored when opening an anonymous temporary file |
2125 | |
2126 | =head2 The attached patch to perlio.c fixes the problem of errno getting set. |
2127 | |
2128 | While I am firmly in the school of "do not look at $! except immediately |
2129 | after a failure", I also agree that spuriously setting it is messy. But |
2130 | there is just no way of knowing where your errno might have been. |
2131 | |
2132 | The problem was that PerlIO_fast_gets() (and other nearby similar |
2133 | capability-checking PerlIO routines) set the errno (and it was being |
2134 | called a lot, from sv_gets()). I think setting the errno here was |
2135 | a mistake: checking for "can has FOO" should not set external state, |
2136 | such as the errno. The patch removes that errno trashing from all those |
2137 | routines. |
2138 | |
2139 | =head2 Trim all trailing / from "." in @INC when filling %INC |
2140 | |
2141 | This fixes bug #66942 : as a / was left in the directory name, |
2142 | $INC{"Foo.pm"} for a file loaded from the current directory |
2143 | was given the incorrect value "/Foo.pm". |
2144 | |
2145 | =head2 Don't enqueue pending signals during global destruction |
2146 | |
2147 | Global destruction is not signal-safe. PL_psig_pend may already |
2148 | be gone when the signal handler is called (with destruct_level > 0). |
2149 | NULL it before freeing it to prevent a race condition. |
2150 | |
2151 | =head2 Eliminate struct regexp_allocated and xpvio_allocated. |
2152 | |
2153 | Calculate memory allocation using regexp and XPVIO, and the offset of the first |
2154 | real structure member. This avoids tripping over alignment differences between |
2155 | X* and x*_allocated, because x*_allocated doesn't have a double in it. |
2156 | |
2157 | |
2158 | =head1 internals |
2159 | |
2160 | =head2 [perl #47047] Use of inherited AUTOLOAD for non-method is deprecated |
2161 | |
2162 | =head2 Remove the definitions of Null(), Nullch, Nullfp, Nullsv and PL_na when code is within the perl source tree |
2163 | |
2164 | =head2 Replace our assert-which-can-be-caught-by-eval with the real deal from the standard C library. |
2165 | |
2166 | =head2 Tweak Perl_sv_upgrade() so that references can upgrade to SVt_PV |
2167 | |
2168 | =head2 Eliminate prelen from struct regexp. |
2169 | |
2170 | =head2 Change Perl_av_iter_p() to return IV* rather than I32* (which means |
2171 | |
2172 | =head2 Reorder the external regexp flags to get RXf_PMf_STD_PMMOD into the |
2173 | |
2174 | lowest 4 bits (which saves a shift), and the "flags indicating special |
2175 | patterns" into contiguous bits. This makes everything a little tidier, |
2176 | and saves 88 bytes (woohoo!) of object file with -Os on x86 FreeBSD. |
2177 | |
2178 | |
2179 | =head2 Re-implement the SvOOK() hack to store the offset as a BER encoded number in the part of the PVX that is being released. |
2180 | (It will always |
2181 | fit, as chopping off 1 byte gives just enough space for recording a |
2182 | delta of up to 127). This allows SvOOK() to co-exist with SvIOK_on(), |
2183 | which means all the calls to SvOOK_off() [with the possibility of a |
2184 | call to sv_backoff()] in SvIOK_on() can be removed. This ought to make |
2185 | a lot of straight line code a little bit simpler. |
2186 | OOK()d scalars can now be SVt_PV, as the IVX isn't needed. |
2187 | |
2188 | =head2 Abolish wraplen from struct regexp. We're already storing it in SvCUR. |
2189 | |
2190 | =head2 Make Perl_pregcomp() use SvUTF8() of the pattern, rather than the flag bit in pmflags, to decide whether the pattern is UTF-8. |
2191 | |
2192 | =head2 Abolish RXf_UTF8. Store the UTF-8-ness of the pattern with SvUTF8(). |
2193 | |
2194 | =head2 In struct regexp move the member paren_names to the IV union. |
2195 | |
2196 | =head2 Make REGEXP a type distinct from SV. (Much like AV, CV, GV, HV). |
2197 | |
2198 | =head2 Allow sv_setsv_flags() to copy SVt_REGEXP much like it copies SVt_FORMAT - the just string buffer. |
2199 | |
2200 | |
2201 | =head2 Correct a long-standing ithreads reference counting anonamly |
2202 | |
2203 | The reference count only needs "doubling" when the scalar is pushed onto |
2204 | PL_regex_padav for the second time. |
2205 | |
2206 | |
2207 | =head2 In PL_regexp_padav, store regexps via real references, rather than hiding them within IVs. |
2208 | |
2209 | We can do this now that they are real SV pointers. |
2210 | |
2211 | =head2 With regexps stored as real RVs, we can eliminate SvREPADTMP(). |
2212 | |
2213 | =head2 REGEXPs are now stored directly in PL_regex_padav, rather than indirectly via RVs. |
2214 | |
2215 | =head2 Remove code that protected pp_qr against REGEXPs going away during global destruction whilst they were stored via true references in PL_regex_padav. |
2216 | |
2217 | =head2 Remove PM_GETRE_SAFE and PM_SETRE_SAFE as nothing uses them. |
2218 | |
2219 | =head2 Note the U8 sized space created by removing -P, and check that it is now an illegal command line flag. |
2220 | |
2221 | =head2 Pack the recycled pad offsets into an SV at PL_regex_pad[0]. |
2222 | |
2223 | =head2 Re-order so that the !SvOK() case is last (which should be rare) |
2224 | |
2225 | =head2 Extend PUSHFORMAT() to take a second parameter to set retop, to save NULLing it and then reassigning. |
2226 | |
2227 | =head2 Split struct block_sub into struct block_sub and struct block_format. |
2228 | |
2229 | Split struct block_sub into struct block_sub and struct block_format. |
2230 | (CXt_SUB and CXt_FORMAT were using some comon members, but some members |
2231 | were only for one or the other.) |
2232 | |
2233 | =head2 Change the wantarray result from caller from IV to bool for the SCALAR/ARRAY case. |
2234 | |
2235 | This doesn't contradict the documentation, as there isn't any. Oops. |
2236 | |
2237 | |
2238 | =head2 Give G_VOID, G_SCALAR and G_ARRAY the same numeric values as OPf_WANT_VOID, OPf_WANT_SCALAR and OPf_WANT_LIST. |
2239 | |
2240 | |
2241 | =head2 Squeeze the context type down to 4 bits, and move the private flags to fit within the next 4 bits. |
2242 | |
2243 | |
2244 | =head2 In struct block change blku_type from U8 to U16, and the "spare" U8 to U16, with the lockstep changes in struct subst. |
2245 | Eliminate lval from |
2246 | struct block_sub, and instead store it in the U16 in struct block. |
2247 | |
2248 | |
2249 | =head2 In struct block_eval, eliminate old_in_eval and old_op_type by storing the data in blk_u16. |
2250 | |
2251 | |
2252 | =head2 The layout for struct block_loop under ithreads can be simplified. |
2253 | |
2254 | Instead of wedging the pad offset into a void* iterdata, and always |
2255 | storing PL_comppad even when it isn't used, instead do this: |
2256 | |
2257 | PAD *oldcomppad; /* Also used for the GV, if targoffset is 0 */ |
2258 | /* This is also accesible via cx->blk_loop.my_op->op_targ */ |
2259 | PADOFFSET targoffset; |
2260 | |
2261 | and store the GV pointer in oldcompad. Pointers to pointers seems |
2262 | cleaner. This also allows us to eliminate the flag bit CXp_PADVAR. |
2263 | |
2264 | |
2265 | =head2 In XS_PerlIO_get_layers() take advantage of the implementation of |
2266 | |
2267 | In XS_PerlIO_get_layers() take advantage of the implementation of |
2268 | PerlIO_get_layers(), by co-opting the new SVs it creates, rather than |
2269 | copying them. |
2270 | |
2271 | |
2272 | =head2 Micro-optimise the order of the context types. [Because I can :-)] |
2273 | |
2274 | =head2 [patch] optimize OP_IS_(FILETEST|SOCKET) macros |
2275 | |
2276 | =head2 Eliminate ck_lengthconst. |
2277 | |
2278 | =head2 Chainsaw DEBUG_S out, as suggested by Vincent Pit. |
2279 | |
2280 | =head2 Unsupported private API functions are now declared "static" to prevent leakage to the public API |
2281 | |
2282 | =head2 Perl_cv_ckproto() is not part of the public API, and not used anywhere. It has been removed |
2283 | |
2284 | =head2 Remove all the 5005threads specific mutex macros, which are now vestigial. |
2285 | |
2286 | =head2 Do not honor TMPDIR for anonymous temporary files when tainting |
2287 | |
2288 | Use a default of /tmp on Unixes when TMPDIR is unset or empty, or |
2289 | when creation of a temporary file in it fails |
2290 | |
2291 | =head2 Add a pluggable hook in op_free() |
2292 | |
2293 | |