This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
8902b448d41bcb2f1b5d186d3356658e0229681c
[perl5.git] / pod / perldelta.pod
1 =encoding utf8
2
3 =head1 NAME
4
5 [ this is a template for a new perldelta file. Any text flagged as
6 XXX needs to be processed before release. ]
7
8 perldelta - what is new for perl v5.13.6
9
10 =head1 DESCRIPTION
11
12 This document describes differences between the 5.13.5 release and
13 the 5.13.6 release.
14
15 If you are upgrading from an earlier release such as 5.13.4, first read
16 L<perl5135delta>, which describes differences between 5.13.4 and
17 5.13.5.
18
19 =head1 Notice
20
21 XXX Any important notices here
22
23 =head1 Core Enhancements
24
25 XXX New core language features go here. Summarise user-visible core language
26 enhancements. Particularly prominent performance optimisations could go
27 here, but most should go in the L</Performance Enhancements> section.
28
29 [ List each enhancement as a =head2 entry ]
30
31 =head2  C<(?^...)> regex construct added to signify default modifiers
32
33 A caret (also called a "cirumflex accent") C<"^"> immediately following
34 a C<"(?"> in a regular expression now means that the subexpression is to
35 not inherit the surrounding modifiers such as C</i>, but to revert to the
36 Perl defaults.  Any modifiers following the caret override the defaults.
37
38 The stringification of regular expressions now uses this notation.  The
39 main purpose of this is to allow tests that rely on the stringification
40 to not have to change when new modifiers are added.  See
41 L<perlre/Extended Patterns>.
42
43 =head2 C<"d">, C<"l">, and C<"u"> regex modifiers added
44
45 These modifiers are currently only available within a C<(?...)> construct.
46
47 The C<"l"> modifier says to compile the regular expression as if it were
48 in the scope of C<use locale>, even if it is not.
49
50 The C<"u"> modifier currently does nothing.
51
52 The C<"d"> modifier is used in the scope of C<use locale> to compile the
53 regular expression as if it were not in that scope.
54 See L<perlre/(?dlupimsx-imsx)>.
55
56 =head1 Security
57
58 XXX Any security-related notices go here.  In particular, any security
59 vulnerabilities closed should be noted here rather than in the
60 L</Selected Bug Fixes> section.
61
62 [ List each security issue as a =head2 entry ]
63
64 =head1 Incompatible Changes
65
66 =head2 Stringification of regexes has changed
67
68 Default regular expression modifiers are now notated by using
69 C<(?^...)>.  Code relying on the old stringification will fail.  The
70 purpose of this is so that when new modifiers are added, such code will
71 not have to change, as the stringification will automatically
72 incorporate the new modifiers.
73
74 Code that needs to work properly with both old- and new-style regexes
75 can use something like the following:
76
77     # Accept both old and new-style stringification
78     my $modifiers = (qr/foobar/ =~ /\Q(?^/) ? '^' : '-xism';
79
80 And then use C<$modifiers> instead of C<-xism>.
81
82 =head2 Regular expressions retain their localeness when interpolated
83
84 Regular expressions compiled under C<"use locale"> now retain this when
85 interpolated into a new regular expression compiled outside a
86 C<"use locale">, and vice-versa.
87
88 Previously, a regular expression interpolated into another one inherited
89 the localeness of the surrounding one, losing whatever state it
90 originally had.  This is considered a bug fix, but may trip up code that
91 has come to rely on the incorrect behavior.
92
93 [ List each incompatible change as a =head2 entry ]
94
95 =head1 Deprecations
96
97 XXX Any deprecated features, syntax, modules etc. should be listed here.
98 In particular, deprecated modules should be listed here even if they are
99 listed as an updated module in the L</Modules and Pragmata> section.
100
101 [ List each deprecation as a =head2 entry ]
102
103 =head1 Performance Enhancements
104
105 XXX Changes which enhance performance without changing behaviour go here. There
106 may well be none in a stable release.
107
108 [ List each enhancement as a =item entry ]
109
110 =over 4
111
112 =item *
113
114 XXX
115
116 =back
117
118 =head1 Modules and Pragmata
119
120 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
121 go here.  If Module::CoreList is updated, generate an initial draft of the
122 following sections using F<Porting/corelist-perldelta.pl>, which prints stub
123 entries to STDOUT.  Results can be pasted in place of the '=head2' entries
124 below.  A paragraph summary for important changes should then be added by hand.
125 In an ideal world, dual-life modules would have a F<Changes> file that could be
126 cribbed.
127
128 [ Within each section, list entries as a =item entry ]
129
130 =head2 New Modules and Pragmata
131
132 =over 4
133
134 =item *
135
136 XXX
137
138 =back
139
140 =head2 Updated Modules and Pragmata
141
142 =over 4
143
144 =item *
145
146 C<File::DosGlob> has been upgraded from version 1.02 to 1.03.
147
148 It allows patterns containing literal parentheses (they no longer need to
149 be escaped). On Windows, it no longer adds an extra F<./> to the file names
150 returned when the pattern is a relative glob with a drive specification,
151 like F<c:*.pl>.
152
153 =item *
154
155 C<File::Find> has been upgraded from version 1.17 to 1.18.
156
157 It improves handling of backslashes on Windows, so that paths such as
158 F<c:\dir\/file> are no longer generated.
159
160 =item *
161
162 C<NEXT> has been upgraded from version 0.64 to 0.65.
163
164 =item *
165
166 C<PathTools> has been upgraded from version 3.31_01 to 3.33.
167
168 =item *
169
170 C<Unicode::Collate> has been upgraded from version 0.59 to 0.60
171
172 =item *
173
174 C<Unicode::Normalize> has been upgraded from version 1.06 to 1.07
175
176 =back
177
178 =head2 Removed Modules and Pragmata
179
180 =over 4
181
182 =item *
183
184 XXX
185
186 =back
187
188 =head1 Documentation
189
190 XXX Changes to files in F<pod/> go here.  Consider grouping entries by
191 file and be sure to link to the appropriate page, e.g. L<perlfunc>.
192
193 =head2 New Documentation
194
195 XXX Changes which create B<new> files in F<pod/> go here.
196
197 =head3 L<XXX>
198
199 XXX Description of the purpose of the new file here
200
201 =head2 Changes to Existing Documentation
202
203 XXX Changes which significantly change existing files in F<pod/> go here.
204 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
205 section.
206
207 =head3 L<XXX>
208
209 =over 4
210
211 =item *
212
213 XXX Description of the change here
214
215 =back
216
217 =head1 Diagnostics
218
219 The following additions or changes have been made to diagnostic output,
220 including warnings and fatal error messages.  For the complete list of
221 diagnostic messages, see L<perldiag>.
222
223 XXX New or changed warnings emitted by the core's C<C> code go here. Also
224 include any changes in L<perldiag> that reconcile it to the C<C> code.
225
226 [ Within each section, list entries as a =item entry ]
227
228 =head2 New Diagnostics
229
230 XXX Newly added diagnostic messages go here
231
232 =over 4
233
234 =item *
235
236 XXX
237
238 =back
239
240 =head2 Changes to Existing Diagnostics
241
242 XXX Changes (i.e. rewording) of diagnostic messages go here
243
244 =over 4
245
246 =item *
247
248 XXX
249
250 =back
251
252 =head1 Utility Changes
253
254 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
255 here. Most of these are built within the directories F<utils> and F<x2p>.
256
257 [ List utility changes as a =head3 entry for each utility and =item
258 entries for each change
259 Use L<XXX> with program names to get proper documentation linking. ]
260
261 =head3 L<XXX>
262
263 =over 4
264
265 =item *
266
267 XXX
268
269 =back
270
271 =head1 Configuration and Compilation
272
273 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
274 go here.  Any other changes to the Perl build process should be listed here.
275 However, any platform-specific changes should be listed in the
276 L</Platform Support> section, instead.
277
278 [ List changes as a =item entry ].
279
280 =over 4
281
282 =item *
283
284 XXX
285
286 =back
287
288 =head1 Testing
289
290 XXX Any significant changes to the testing of a freshly built perl should be
291 listed here.  Changes which create B<new> files in F<t/> go here as do any
292 large changes to the testing harness (e.g. when parallel testing was added).
293 Changes to existing files in F<t/> aren't worth summarising, although the bugs
294 that they represent may be covered elsewhere.
295
296 [ List each test improvement as a =item entry ]
297
298 =over 4
299
300 =item *
301
302 XXX
303
304 =back
305
306 =head1 Platform Support
307
308 XXX Any changes to platform support should be listed in the sections below.
309
310 [ Within the sections, list each platform as a =item entry with specific
311 changes as paragraphs below it. ]
312
313 =head2 New Platforms
314
315 XXX List any platforms that this version of perl compiles on, that previous
316 versions did not. These will either be enabled by new files in the F<hints/>
317 directories, or new subdirectories and F<README> files at the top level of the
318 source tree.
319
320 =over 4
321
322 =item XXX-some-platform
323
324 XXX
325
326 =back
327
328 =head2 Discontinued Platforms
329
330 XXX List any platforms that this version of perl no longer compiles on.
331
332 =over 4
333
334 =item XXX-some-platform
335
336 XXX
337
338 =back
339
340 =head2 Platform-Specific Notes
341
342 XXX List any changes for specific platforms. This could include configuration
343 and compilation changes or changes in portability/compatibility.  However,
344 changes within modules for platforms should generally be listed in the
345 L</Modules and Pragmata> section.
346
347 =over 4
348
349 =item XXX-some-platform
350
351 XXX
352
353 =back
354
355 =head1 Internal Changes
356
357 XXX Changes which affect the interface available to C<XS> code go here.
358 Other significant internal changes for future core maintainers should
359 be noted as well.
360
361 [ List each test improvement as a =item entry ]
362
363 =over 4
364
365 =item *
366
367 See L</Regular expressions retain their localeness when interpolated>,
368 above.
369
370 =back
371
372 =head1 Selected Bug Fixes
373
374 XXX Important bug fixes in the core language are summarised here.
375 Bug fixes in files in F<ext/> and F<lib/> are best summarised in
376 L</Modules and Pragmata>.
377
378 [ List each fix as a =item entry ]
379
380 =over 4
381
382 =item *
383
384 A regular expression match in the right-hand side of a global substitution
385 (C<s///g>) that is in the same scope will no longer cause match variables
386 to have the wrong values on subsequent iterations. This can happen when an
387 array or hash subscript is interpolated in the right-hand side, as in
388 C<s|(.)|@a{ print($1), /./ }|g>
389 L<[perl #19078]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=19078>.
390
391 =item *
392
393 Constant-folding used to cause
394
395   $text =~ ( 1 ? /phoo/ : /bear/)
396
397 to turn into
398
399   $text =~ /phoo/
400
401 at compile time. Now it correctly matches against C<$_>
402 L<[perl #20444]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=20444>.
403
404 =item *
405
406 Parsing Perl code (either with string C<eval> or by loading modules) from
407 within a C<UNITCHECK> block no longer causes the interpreter to crash
408 L<[perl #70614]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=70614>.
409
410 =item *
411
412 When C<-d> is used on the shebang (C<#!>) line, the debugger now has access
413 to the lines of the main program. In the past, this sometimes worked and
414 sometimes did not, depending on what order things happened to be arranged
415 in memory.
416
417 =back
418
419 =head1 Known Problems
420
421 XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
422 tests that had to be C<TODO>ed for the release would be noted here, unless
423 they were specific to a particular platform (see below).
424
425 This is a list of some significant unfixed bugs, which are regressions
426 from either 5.XXX.XXX or 5.XXX.XXX.
427
428 [ List each fix as a =item entry ]
429
430 =over 4
431
432 =item *
433
434 XXX
435
436 =back
437
438 =head1 Obituary
439
440 XXX If any significant core contributor has died, we've added a short obituary
441 here.
442
443 =head1 Acknowledgements
444
445 XXX The list of people to thank goes here.
446
447 =head1 Reporting Bugs
448
449 If you find what you think is a bug, you might check the articles
450 recently posted to the comp.lang.perl.misc newsgroup and the perl
451 bug database at http://rt.perl.org/perlbug/ .  There may also be
452 information at http://www.perl.org/ , the Perl Home Page.
453
454 If you believe you have an unreported bug, please run the B<perlbug>
455 program included with your release.  Be sure to trim your bug down
456 to a tiny but sufficient test case.  Your bug report, along with the
457 output of C<perl -V>, will be sent off to perlbug@perl.org to be
458 analysed by the Perl porting team.
459
460 If the bug you are reporting has security implications, which make it
461 inappropriate to send to a publicly archived mailing list, then please send
462 it to perl5-security-report@perl.org. This points to a closed subscription
463 unarchived mailing list, which includes all the core committers, who be able
464 to help assess the impact of issues, figure out a resolution, and help
465 co-ordinate the release of patches to mitigate or fix the problem across all
466 platforms on which Perl is supported. Please only use this address for
467 security issues in the Perl core, not for modules independently
468 distributed on CPAN.
469
470 =head1 SEE ALSO
471
472 The F<Changes> file for an explanation of how to view exhaustive details
473 on what changed.
474
475 The F<INSTALL> file for how to build Perl.
476
477 The F<README> file for general stuff.
478
479 The F<Artistic> and F<Copying> files for copyright information.
480
481 =cut