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