Note legacy.pm changes in perldelta
[p5sagit/p5-mst-13.2.git] / pod / perl5113delta.pod
1 =head1 NAME
2
3 [ this is a template for a new perldelta file. Any text flagged as
4 XXX needs to be processed before release. ]
5
6 perldelta - what is new for perl v5.11.3
7
8 =head1 DESCRIPTION
9
10 This document describes differences between the 5.11.2 release and
11 the 5.11.3 release.
12
13 If you are upgrading from an earlier release such as 5.11.3, first read
14 the L<perl5XXXdelta>, which describes differences between 5.11.3 and
15 5.10.0
16
17 =head1 Notice
18
19 XXX Any important notices here
20
21 =head1 Incompatible Changes
22
23 =over
24
25 =item Filehandles are blessed directly into C<IO::Handle::>, as C<FileHandle> is merely a wrapper around C<IO::Handle>.
26
27 =back
28
29 =head1 Core Enhancements
30
31 XXX New core language features go here. Summarise user-visible core language
32 enhancements. Particularly prominent performance optimisations could go
33 here, but most should go in the L</Performance Enhancements> section.
34
35 =head2 Unicode version
36
37 Perl is shipped with the latest Unicode version, 5.2, October 2009.  See
38 L<http://www.unicode.org/versions/Unicode5.2.0> for details about this release
39 of Unicode.
40
41 But, an installation can now fairly easily change Perl to operate on any
42 Unicode release.  Perl is shipped with the latest official release, but
43 an installation can download and install any prior release from Unicode, and
44 cause Perl to work with that (or even multiple releases).  Instructions are in
45 L<perlunicode>.
46
47 =head2 Unicode properties
48
49 Perl can now handle every Unicode character property.  A new pod,
50 L<perluniprops>, lists all available non-Unihan character properties.  By
51 default the Unihan properties and certain others (deprecated and Unicode
52 internal-only ones) are not exposed.  See below for more details on
53 these; there is also a section in the pod listing them, and why they are
54 not exposed.
55
56 Perl now fully supports the Unicode compound-style of using C<=> and C<:>
57 in writing regular expressions: C<\p{property=value}> and
58 C<\p{property:value}> (both of which mean the same thing).
59
60 Perl now supports fully the Unicode loose matching rules for text
61 between the braces in C<\p{...}> constructs.  In addition, Perl also allows
62 underscores between digits of numbers.
63
64 All the Unicode-defined synonyms for properties and property values are
65 now accepted.
66
67 C<qr/\X/>, which matches a Unicode logical character, has been expanded to work
68 better with various Asian languages.  It now is defined as an C<extended
69 grapheme cluster>.  (See L<http://www.unicode.org/reports/tr29/>).  One change
70 due to this is that C<\X> will match the whole sequence C<S<CR LF>>.  Another
71 change is that C<\X> will match an isolated mark.  Marks generally come after a
72 base character, but it is possible in Unicode to have them in isolation, and
73 C<\X> will now handle that case.  Otherwise, this change should be transparent
74 for the non-affected languages.
75
76 C<\p{...}> matches using the Canonical_Combining_Class property were
77 completely broken in previous Perls.  This is now fixed.
78
79 In previous Perls, the Unicode Decomposition_Type=Compat property and a
80 Perl extension had the same name, which led to neither matching all the
81 correct values (with more than 100 mistakes in one, and several thousand
82 in the other).  The Perl extension has now been renamed to be
83 Decomposition_Type=Noncanonical (short: dt=noncanon).  It has the same
84 meaning as was previously intended, namely the union of all the
85 non-canonical Decomposition types, with Unicode Compat being just one of
86 those.
87
88 C<\p{Uppercase}> and C<\p{Lowercase}> have been brought into line with the
89 Unicode definitions.  This means they each match a few more characters
90 than previously.
91
92 C<\p{Cntrl}> now matches the same characters as C<\p{Control}>.  This means it
93 no longer will match Private Use (gc=co), Surrogates (gc=cs), nor Format
94 (gc=cf) code points.  The Format code points represent the biggest
95 possible problem.  All but 36 of them are either officially deprecated
96 or strongly discouraged from being used.  Of those 36, likely the most
97 widely used are the soft hyphen (U+00AD), and BOM, ZWSP, ZWNJ, WJ, and
98 similar, plus Bi-directional controls.
99
100 C<\p{Alpha}> now matches the same characters as C<\p{Alphabetic}>.  The Perl
101 definition included a number of things that aren't really alpha (all
102 marks), while omitting many that were.  The Unicode definition is
103 clearly better, so we are switching to it.  As a direct consequence, the
104 definitions of C<\p{Alnum}> and C<\p{Word}> which depend on Alpha also change.
105
106 C<\p{Word}> also now doesn't match certain characters it wasn't supposed
107 to, such as fractions.
108
109 C<\p{Print}> no longer matches the line control characters: tab, lf, cr,
110 ff, vt, and nel.  This brings it in line with the documentation.
111
112 \p{Decomposition_Type=Canonical} now includes the Hangul syllables
113
114 The Numeric type property has been extended to include the Unihan
115 characters.
116
117 There is a new Perl extension, the 'Present_In', or simply 'In'
118 property.  This is an extension of the Unicode Age property, but
119 C<\p{In=5.0}> matches any code point whose usage has been determined as of
120 Unicode version 5.0.  The C<\p{Age=5.0}> only matches code points added in 5.0.
121
122 A number of properties did not have the correct values for unassigned
123 code points.  This is now fixed.  The affected properties are
124 Bidi_Class, East_Asian_Width, Joining_Type, Decomposition_Type,
125 Hangul_Syllable_Type, Numeric_Type, and Line_Break.
126
127 The Default_Ignorable_Code_Point, ID_Continue, and ID_Start properties
128 have been updated to their current definitions.
129
130 Certain properties that are supposed to be Unicode internal-only were
131 erroneously exposed by previous Perls.  Use of these in regular
132 expressions will now generate a deprecated warning message, if those
133 warnings are enabled.  The properties are: Other_Alphabetic,
134 Other_Default_Ignorable_Code_Point, Other_Grapheme_Extend,
135 Other_ID_Continue, Other_ID_Start, Other_Lowercase, Other_Math, and
136 Other_Uppercase.
137
138 An installation can now fairly easily change which Unicode properties
139 Perl understands.  As mentioned above, certain properties are by default
140 turned off.  These include all the Unihan properties (which should be
141 accessible via the CPAN module Unicode::Unihan) and any deprecated or
142 Unicode internal-only property that Perl has never exposed.
143
144 The files in the To directory are now more clearly marked as being
145 stable, directly usable by applications.  New hash entries in them give
146 the format of the normal entries which allows for easier machine
147 parsing.  Perl can generate files in this directory for any property,
148 though most are suppressed.  An installation can choose to change which
149 get written.   Instructions are in L<perluniprops>.
150
151 =head1 New Platforms
152
153 XXX List any platforms that this version of perl compiles on, that previous
154 versions did not. These will either be enabled by new files in the F<hints/>
155 directories, or new subdirectories and F<README> files at the top level of the
156 source tree.
157
158 =head1 Modules and Pragmata
159
160 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
161 go here, in a list ordered by distribution name. Minimally it should be the
162 module version, but it's more useful to the end user to give a paragraph's
163 summary of the module's changes. In an ideal world, dual-life modules would
164 have a F<Changes> file that could be cribbed.
165
166 =head2 New Modules and Pragmata
167
168 =over 4
169
170 =item C<warnings::fatal_enabled>
171
172     Add code and starting perldoc for warnings::fatal_enabled.
173     
174     This is an analog for warnings::enabled, except it tests whether the
175     given category has been set fatal using "use warnings FATAL => foo".
176     This is mostly for symmetry.
177     
178     Assumes that the fatal bit for a category will have an offset one higher
179     than the regular bit for the category, because otherwise much rewriting
180     of __chk would be required.
181
182 XXX
183
184 =back
185
186 =head2 Pragmata Changes
187
188 =over 4
189
190 =item C<use feature "unicode_strings">
191
192 This pragma turns on Unicode semantics for the case-changing operations
193 (uc/lc/ucfirst/lcfirst) on strings that don't have the internal UTF-8
194 flag set, but that however contain higher characters (between 128 and
195 255).
196
197 =item C<legacy>
198
199 The experimental C<legacy> pragma, introduced in 5.11.2, has been removed,
200 and its functionality replaced by a new feature pragma, C<use feature
201 "unicode_strings">.
202
203 =back
204
205 =head2 Updated Modules
206
207 =over 4
208
209 =item C<XXX>
210
211     Updated CPANPLUS to cpan release 0.90
212     Bring up ExtUtils::MakeMaker to 6.56 - no functional changes from 6.55_03
213     Upgrade to threads 1.75
214
215     Import CPAN.pm 1.94_53 from CPAN
216
217     Updated Module::Build to 0.35_15
218     
219     Update Cwd / PathTools to 3.31 to get us a non-devel version number based on a chat with Steffen. No code changes.
220
221     Updated to Pod::Simple 3.11 from CPAN [perl #71004]
222
223
224     Update Archive::Extract to cpan version 0.36
225
226 XXX
227 =item
228
229     File::Find was not resolving paths of the form "/..////../" correctly.
230     Fixed by adding a quantifier to the substitution parameter in
231     contract_name().
232
233 =item ExtUtils::MakeMaker
234
235     New BUILD_REQUIRES key to indicate build-only prerequisites.
236
237     mingw64 support.
238
239     Support new "package NAME VERSION" syntax.
240
241 =back
242
243 =head1 Utility Changes
244
245 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
246 here. Most of these are built within the directories F<utils> and F<x2p>.
247
248 =over 4
249
250 =item F<XXX>
251
252 XXX
253
254     Perlbug no longer reports "Message sent" when it hasn't actually sent the message
255
256 =back
257
258 =head1 New Documentation
259
260 XXX Changes which create B<new> files in F<pod/> go here.
261
262 =over 4
263
264 =item L<XXX>
265
266 XXX
267
268 =back
269
270 =head1 Changes to Existing Documentation
271
272 XXX Changes which significantly change existing files in F<pod/> go here.
273 Any changes to F<pod/perldiag.pod> should go in L</New or Changed Diagnostics>.
274
275
276 The Pod specification (L<perlpodspec>) has been updated to bring the
277 specification in line with modern usage already supported by most Pod systems.
278 A parameter string may now follow the format name in a "begin/end" region.
279 Links to URIs with a text description are now allowed.  The usage of
280 C<LE<lt>"section"E<gt>> has been marked as deprecated.
281
282 L<if.pm|if> has been documented in L<perlfunc/use> as a means to get
283 conditional loading of modules despite the implicit BEGIN block around C<use>.
284
285
286
287 =head1 Performance Enhancements
288
289 XXX Changes which enhance performance without changing behaviour go here. There
290 may well be none in a stable release.
291
292 =over 4
293
294 =item *
295
296 XXX
297
298 =back
299
300 =head1 Installation and Configuration Improvements
301
302 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
303 go here.
304
305 =head2 Configuration improvements
306
307 XXX
308
309 =head2 Compilation improvements
310
311     Make distclean work again
312 XXX
313
314 =head2 Testing improvements
315
316 =over 4
317
318 =item It's now possible to override C<PERL5OPT> and friends in F<t/TEST>
319
320 =back
321
322 =head2 Platform Specific Changes
323
324 =over 4
325
326 =item Win32
327
328 =over 4 
329
330 =item *
331
332 Always add a manifest resource to C<perl.exe> to specify the <trustInfo>
333 settings for Windows Vista and later.  Without this setting Windows
334 will treat C<perl.exe> as a legacy application and apply various
335 heuristics like redirecting access to protected file system areas
336 (like the "Program Files" folder) to the users "VirtualStore"
337 instead of generating a proper "permission denied" error.
338
339 For VC8 and VC9 this manifest setting is automatically generated by
340 the compiler/linker (together with the binding information for their
341 respective runtime libraries); for all other compilers we need to
342 embed the manifest resource explicitly in the external resource file.
343
344 This change also requests the Microsoft Common-Controls version 6.0
345 (themed controls introduced in Windows XP) via the dependency list
346 in the assembly manifest.  For VC8 and VC9 this is specified using the
347 C</manifestdependency> linker commandline option instead.
348
349 =back
350
351 =item cygwin
352
353 =over 4
354
355 =item Enable IPv6 support on cygwin 1.7 and newer
356
357 =back
358
359 =item OpenVMS
360
361 =over 4
362
363 =item Make -UDEBUGGING the default on VMS for 5.12.0.
364
365 Like it has been everywhere else for ages and ages.  Also make
366 command-line selection of -UDEBUGGING and -DDEBUGGING work in
367 configure.com; before the only way to turn it off was by saying
368 no in answer to the interactive question.
369
370 =back
371
372 =back
373
374 =head1 Selected Bug Fixes
375
376 XXX Important bug fixes in the core language are summarised here.
377 Bug fixes in files in F<ext/> and F<lib/> are best summarised in
378 L</Modules and Pragmata>.
379
380 =over 4
381
382 =item *
383
384 Ensure that pp_qr returns a new regexp SV each time. Resolves RT #69852.
385
386 Instead of returning a(nother) reference to the (pre-compiled) regexp in the
387 optree, use reg_temp_copy() to create a copy of it, and return a reference to
388 that. This resolves issues about Regexp::DESTROY not being called in a timely
389 fashion (the original bug tracked by RT #69852), as well as bugs related to
390 blessing regexps, and of assigning to regexps, as described in correspondence
391 added to the ticket.
392
393 It transpires that we also need to undo the SvPVX() sharing when ithreads
394 cloning a Regexp SV, because mother_re is set to NULL, instead of a cloned
395 copy of the mother_re. This change might fix bugs with regexps and threads in
396 certain other situations, but as yet neither tests nor bug reports have
397 indicated any problems, so it might not actually be an edge case that it's
398 possible to reach.
399
400 =item  *
401
402 Several compilation errors and segfaults when perl was built with C<-Dmad> were fixed.
403
404 =item *
405
406 Fixes for lexer API changes in 5.11.2 which broke NYTProf's savesrc option.
407
408 =back
409
410 =head1 New or Changed Diagnostics
411
412 XXX New or changed warnings emitted by the core's C<C> code go here.
413
414 =over 4
415
416 =item C<XXX>
417
418     Make split warn in void context
419 XXX
420
421 =back
422
423 =head1 Changed Internals
424
425 XXX Changes which affect the interface available to C<XS> code go here.
426
427 =over 4
428
429 =item *
430
431 XXX
432
433 =back
434
435 =head1 New Tests
436
437 XXX Changes which create B<new> files in F<t/> go here. Changes to
438 existing files in F<t/> aren't worth summarising, although the bugs that
439 they represent may be.
440
441 =over 4
442
443 =item F<XXX>
444
445 XXX
446
447 =back
448
449 =head1 Known Problems
450
451 XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
452 tests that had to be C<TODO>ed for the release would be noted here, unless
453 they were specific to a particular platform (see below).
454
455 This is a list of some significant unfixed bugs, which are regressions
456 from either 5.11.3 or 5.11.3.
457
458 =over 4
459
460 =item *
461
462 XXX
463
464 =back
465
466 =head1 Deprecations
467
468 XXX Add any new known deprecations here.
469
470 The following items are now deprecated.
471
472 =over 4
473
474 =item Use of "goto" to jump into a construct is deprecated
475
476 Using C<goto> to jump from an outer scope into an inner
477 scope is now deprecated. This rare use case was causing
478 problems in the implementation of scopes.
479
480 =back
481
482 =head1 Platform Specific Notes
483
484 XXX Any changes specific to a particular platform. VMS and Win32 are the usual
485 stars here. It's probably best to group changes under the same section layout
486 as the main perldelta
487
488 =head1 Obituary
489
490 XXX If any significant core contributor has died, we've added a short obituary
491 here.
492
493 =head1 Acknowledgements
494
495 XXX The list of people to thank goes here.
496
497
498 =head1 Reporting Bugs
499
500 If you find what you think is a bug, you might check the articles
501 recently posted to the comp.lang.perl.misc newsgroup and the perl
502 bug database at http://rt.perl.org/perlbug/ .  There may also be
503 information at http://www.perl.org/ , the Perl Home Page.
504
505 If you believe you have an unreported bug, please run the B<perlbug>
506 program included with your release.  Be sure to trim your bug down
507 to a tiny but sufficient test case.  Your bug report, along with the
508 output of C<perl -V>, will be sent off to perlbug@perl.org to be
509 analysed by the Perl porting team.
510
511 If the bug you are reporting has security implications, which make it
512 inappropriate to send to a publicly archived mailing list, then please send
513 it to perl5-security-report@perl.org. This points to a closed subscription
514 unarchived mailing list, which includes all the core committers, who be able
515 to help assess the impact of issues, figure out a resolution, and help
516 co-ordinate the release of patches to mitigate or fix the problem across all
517 platforms on which Perl is supported. Please only use this address for
518 security issues in the Perl core, not for modules independently
519 distributed on CPAN.
520
521 =head1 SEE ALSO
522
523 The F<Changes> file for an explanation of how to view exhaustive details
524 on what changed.
525
526 The F<INSTALL> file for how to build Perl.
527
528 The F<README> file for general stuff.
529
530 The F<Artistic> and F<Copying> files for copyright information.
531
532 =cut
533
534
535
536
537 All changes through commit b4178430270dbe109e7609d0b50d6d54bf9e95d8
538 One "triage" pass done.
539
540 A second triage pass is still needed to remove unimportant changes
541
542 commit 9307c420fad2f6f5bd314f9ed66dd53288703e09
543 Author: Jan Dubois <jand@activestate.com>
544 Date:   Thu Dec 17 18:28:16 2009 -0800
545
546     Export PL_curinterp symbol for MULTIPLICITY without USE_ITHREADS
547     
548     This is necessary for XS extensions that define PERL_CORE.  In that
549     situation PERL_GET_CONTEXT will resolve to PL_curinterp, which is
550     normally not exported (extensions call Perl_Gcurinterp_ptr() to get a
551     pointer to PL_curinterp instead). With USE_ITHREADS defined
552     PERL_GET_CONTEXT will expand to Perl_get_context() even inside the
553     core because the context needs to be fetched from threadlocal storage.
554
555 commit 8703a9a4fd75723318bc4ba1afc42a215806f2d1
556
557     Correct some #ifdef USE_ITHREADS / USE_MULTI 
558
559 Author: Jan Dubois <jand@activestate.com>
560 Date:   Wed Dec 16 15:42:19 2009 -0800
561
562     -t should only return TRUE for file handles connected to a TTY
563     
564     The Microsoft C version of isatty() returns TRUE for all
565     character mode devices, including the /dev/null style "nul"
566     device and printers like "lpt1".
567     
568     The included test has only been tested on Windows and Linux;
569     the device names for OS/2 and VMS are just best guesses...
570
571 commit 0f907b96d618c97cd2e020841a70ae037954a616
572
573     [perl #70171] 5.10.0 -> 5.10.1 Regression in fafafbaf70 (Big slowdown in 5.10 @_ parameter passing)
574     
575 commit 2ab54efd6265713df5cd4bd0927024245675c1c2
576
577     fix bug 67156: overload: nomethod(..., '!') return value inverted
578
579 commit 412147f664b7f5805591ad996d7e5a9e70b3d80f
580
581     [perl #71204] diagnostics.pm suppresses 'Use of uninitialized value in range (or flip)' warning
582     
583
584 commit 69dc4b30f4725ad5f212d45d3c856ac1caaacf17
585 Author: Father Chrysostomos <sprout@cpan.org>
586 Date:   Mon Dec 14 12:19:35 2009 +0100
587
588     [perl #70764] $' fails to initialized for pre-compiled regular expression matches
589     
590     The match vars are associated with the regexp that last matched
591     successfully. In the case of $str =~ $qr or /$qr/, since the $qr could
592     be used in multiple scopes that need their own sets of match vars, the
593     $qr is cloned by Perl_reg_temp_copy as of change 30677/28d8d7f. This
594     happens in pp_regcomp before pp_match has stringified the LHS, hence the
595     bug. In short, /$gror/ is not equivalent to
596     ($which = !$which) ? /$gror/ : /$gror/, which is weird.
597     
598 Author: Reini Urban <rurban@x-ray.at>
599 Date:   Sun Dec 13 08:06:43 2009 +0100
600
601     Eliminate OP_SETSTATE from cop.h header
602     
603     It had been added with change 3728 to track linenumbers in
604     optimized else, disabled by change 4309,
605     and removed with change 33072.
606     
607     Bump copyright, latest change was "Fix MULTICALL in List-Util" 2009-03-07
608     with commit 1bbbfc50
609
610
611     Fix for [perl #70910] wrong line number in syntax error message
612
613     Document config_args limitations reported in [perl #70912]
614
615     proper error on "grep $x (1,2,3)". Solves [perl #37314]
616
617 commit 8a27a13e89107aaf68c0748b68ee71fbd86d774b
618
619     [perl #71076] sort with active sub (5.10 regression)
620     
621     One of the tests in sort.t causes a bus error (or sometimes Ã¢\80\98Undefined
622     subroutine calledâ\80\99) if run multiple times. This is because sort
623     decreases the refcount of an active sub used as a comparison routine.
624     
625 commit 69c3dccf5322a59cb855347c04712ba11b65328f
626
627     Fix [perl #71078] Smart match against @_ gives false negatives
628     
629     @_ can contain NULLs for undefined elements
630
631     [perl #71000] Wrong variable name in warning ; Add a new warning "Missing argument in %s"
632
633
634     preserve readonly flag when saving and restoring magic flags
635
636 commit c9930541bfa04399c3b648e83c9b750cee1154fb
637
638     [perl #70802] -i'*' refuses to work
639
640 commit adab996997d7ef1b54d382f5ab4304f438cd1dd0
641
642     Cleanup all scopes before exiting a pseudo-forked process.
643     
644     perl_destruct() contains an assertion that the scope stack
645     is empty.  The remaining scopes are due to fork() being
646     called from within a BEGIN block.
647
648 commit 576b33a19ccaf98d4dfe201d529c55c3747f0cb6
649
650     [rt.cpan.org #51574] Safe.pm sort {} bug accessing $a and $b with -Dusethreads
651
652 commit ee6ba15dedda3e88eb66891eaf387c00a4c0a2fb
653
654     Fix -DPERL_NO_UTF16_FILTER
655
656 commit dfd167e94af611f6248e804cb228b35ca4123bd6
657
658     Handle $@ being assigned a read-only value (without error or busting the stack).
659     
660     Discovered whilst investigating RT #70862.
661
662 commit f5fa9033b8c1fdcbd7710850b3b0380d6b937853
663
664     Fix RT #70862 by converting ERRSV to GvSVn() to ensure a non-NULL GvSV().
665
666 commit ff868e665bf85a829dc47bfa1243b26d4367cacd
667
668     Add error codes for getaddrinfo() and getnameinfo()
669
670 commit 61fc5122f0d8a509834282b8ecb3252d2e4c9f5d
671
672     Make unicode semantics the default
673
674     *****************
675
676 commit 021f53de09926928546378b3552f9240c9241dde
677 Author: Gerard Goossen <gerard@ggoossen.net>
678 Date:   Mon Nov 16 13:58:24 2009 +0100
679
680     Force OP_REQUIRE to scalar context at the end of ck_require and don't let it become void context. Fixes problem with require not always being in scalar context.
681
682 commit 6a0e50422a84b53e998825128c56791913cd03aa
683 Author: Craig A. Berry <craigberry@mac.com>
684 Date:   Sat Nov 21 11:17:38 2009 -0600
685