This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
disable t/io/eintr.t on windows
[perl5.git] / pod / perldelta.pod
CommitLineData
3a5c9134
CBW
1=encoding utf8
2
59773fc7 3=for comment
e3ef43a5 4This has been completed up to 04698ff.
59773fc7 5
3a5c9134
CBW
6=head1 NAME
7
8[ this is a template for a new perldelta file. Any text flagged as
9XXX needs to be processed before release. ]
10
11perldelta - what is new for perl v5.13.8
12
13=head1 DESCRIPTION
14
15This document describes differences between the 5.13.8 release and
16the 5.13.7 release.
17
dbbe2d83 18If you are upgrading from an earlier release such as 5.13.6, first read
3a5c9134
CBW
19L<perl5137delta>, which describes differences between 5.13.6 and
205.13.7.
21
22=head1 Notice
23
24XXX Any important notices here
25
26=head1 Core Enhancements
27
28XXX New core language features go here. Summarise user-visible core language
29enhancements. Particularly prominent performance optimisations could go
30here, but most should go in the L</Performance Enhancements> section.
31
32[ List each enhancement as a =head2 entry ]
33
b19934fb
NC
34=head2 C<-d:-foo> calls C<Devel::foo::unimport>
35
36The syntax C<-dI<B<:>foo>> was extended in 5.6.1 to make C<-dI<:fooB<=bar>>>
6a8c8694
FC
37equivalent to C<-MDevel::foo=bar>, which expands
38internally to C<use Devel::foo 'bar';>.
b19934fb
NC
39F<perl> now allows prefixing the module name with C<->, with the same
40semantics as C<-M>, I<i.e.>
41
42=over 4
43
44=item C<-d:-foo>
45
6a8c8694
FC
46Equivalent to C<-M-Devel::foo>, expands to
47C<no Devel::foo;>, calls C<< Devel::foo->unimport() >>
b19934fb
NC
48if the method exists.
49
50=item C<-d:-foo=bar>
51
6a8c8694
FC
52Equivalent to C<-M-Devel::foo=bar>, expands to C<no Devel::foo 'bar';>,
53calls C<< Devel::foo->unimport('bar') >> if the method exists.
b19934fb
NC
54
55=back
56
57This is particularly useful to suppresses the default actions of a
58C<Devel::*> module's C<import> method whilst still loading it for debugging.
59
3a5c9134
CBW
60=head1 Security
61
62XXX Any security-related notices go here. In particular, any security
63vulnerabilities closed should be noted here rather than in the
64L</Selected Bug Fixes> section.
65
66[ List each security issue as a =head2 entry ]
67
68=head1 Incompatible Changes
69
70XXX For a release on a stable branch, this section aspires to be:
71
72 There are no changes intentionally incompatible with 5.XXX.XXX. If any
73 exist, they are bugs and reports are welcome.
74
75[ List each incompatible change as a =head2 entry ]
76
77=head1 Deprecations
78
79XXX Any deprecated features, syntax, modules etc. should be listed here.
80In particular, deprecated modules should be listed here even if they are
81listed as an updated module in the L</Modules and Pragmata> section.
82
83[ List each deprecation as a =head2 entry ]
84
59773fc7
FC
85=head2 C<?PATTERN?> is deprecated
86
87C<?PATTERN?> (without the initial m) has been deprecated and now produces
88a warning.
89
d59a8b3e
NC
90=head2 C<sv_compile_2op> is now deprecated
91
92The C<sv_compile_2op> is now deprecated, and will be removed. Searches suggest
93that nothing on CPAN is using it, so this should have zero impact.
94
95It attempted to provide an API to compile code down to an optree, but failed
96to bind correctly to lexicals in the enclosing scope. It's not possible to
97fix this problem within the constraints of its parameters and return value.
98
3a5c9134
CBW
99=head1 Performance Enhancements
100
101XXX Changes which enhance performance without changing behaviour go here. There
102may well be none in a stable release.
103
104[ List each enhancement as a =item entry ]
105
106=over 4
107
108=item *
109
110XXX
111
112=back
113
114=head1 Modules and Pragmata
115
116XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
117go here. If Module::CoreList is updated, generate an initial draft of the
118following sections using F<Porting/corelist-perldelta.pl>, which prints stub
119entries to STDOUT. Results can be pasted in place of the '=head2' entries
120below. A paragraph summary for important changes should then be added by hand.
121In an ideal world, dual-life modules would have a F<Changes> file that could be
122cribbed.
123
124[ Within each section, list entries as a =item entry ]
125
126=head2 New Modules and Pragmata
127
128=over 4
129
130=item *
131
132XXX
133
134=back
135
136=head2 Updated Modules and Pragmata
137
138=over 4
139
140=item *
141
39b09a1b
CBW
142C<IPC::Cmd> has been upgraded from 0.64 to 0.66
143
144Resolves an issue with splitting Win32 command lines
145and documentation enhancements.
146
147=item *
148
37fa6334 149C<MIME::Base64> has been upgraded from 3.10 to 3.13
2456140e
CBW
150
151Now provides encode_base64url and decode_base64url functions to process
152the base64 scheme for "URL applications".
153
154=item *
155
5ebfb99c 156C<Socket> has been upgraded from 1.91 to 1.92.
b373eab8
FC
157
158It has several new functions for handling IPv6 addresses.
159
160=item *
161
68adb2b0
CBW
162C<Unicode::Collate> has been upgraded from 0.67 to 0.68
163
164=item *
165
59773fc7 166C<Unicode::UCD> has been upgraded from 0.29 to 0.30.
3a5c9134
CBW
167
168=back
169
170=head2 Removed Modules and Pragmata
171
172=over 4
173
174=item *
175
176XXX
177
178=back
179
180=head1 Documentation
181
182XXX Changes to files in F<pod/> go here. Consider grouping entries by
183file and be sure to link to the appropriate page, e.g. L<perlfunc>.
184
185=head2 New Documentation
186
187XXX Changes which create B<new> files in F<pod/> go here.
188
189=head3 L<XXX>
190
191XXX Description of the purpose of the new file here
192
193=head2 Changes to Existing Documentation
194
195XXX Changes which significantly change existing files in F<pod/> go here.
196However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
197section.
198
199=head3 L<XXX>
200
201=over 4
202
203=item *
204
205XXX Description of the change here
206
207=back
208
209=head1 Diagnostics
210
211The following additions or changes have been made to diagnostic output,
212including warnings and fatal error messages. For the complete list of
213diagnostic messages, see L<perldiag>.
214
215XXX New or changed warnings emitted by the core's C<C> code go here. Also
216include any changes in L<perldiag> that reconcile it to the C<C> code.
217
218[ Within each section, list entries as a =item entry ]
219
220=head2 New Diagnostics
221
222XXX Newly added diagnostic messages go here
223
224=over 4
225
226=item *
227
228XXX
229
230=back
231
232=head2 Changes to Existing Diagnostics
233
234XXX Changes (i.e. rewording) of diagnostic messages go here
235
236=over 4
237
238=item *
239
240XXX
241
242=back
243
244=head1 Utility Changes
245
246XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
247here. Most of these are built within the directories F<utils> and F<x2p>.
248
249[ List utility changes as a =head3 entry for each utility and =item
250entries for each change
251Use L<XXX> with program names to get proper documentation linking. ]
252
253=head3 L<XXX>
254
255=over 4
256
257=item *
258
259XXX
260
261=back
262
263=head1 Configuration and Compilation
264
265XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
266go here. Any other changes to the Perl build process should be listed here.
267However, any platform-specific changes should be listed in the
268L</Platform Support> section, instead.
269
270[ List changes as a =item entry ].
271
272=over 4
273
274=item *
275
276XXX
277
278=back
279
280=head1 Testing
281
282XXX Any significant changes to the testing of a freshly built perl should be
283listed here. Changes which create B<new> files in F<t/> go here as do any
284large changes to the testing harness (e.g. when parallel testing was added).
285Changes to existing files in F<t/> aren't worth summarising, although the bugs
286that they represent may be covered elsewhere.
287
288[ List each test improvement as a =item entry ]
289
290=over 4
291
292=item *
293
294XXX
295
296=back
297
298=head1 Platform Support
299
300XXX Any changes to platform support should be listed in the sections below.
301
302[ Within the sections, list each platform as a =item entry with specific
303changes as paragraphs below it. ]
304
305=head2 New Platforms
306
307XXX List any platforms that this version of perl compiles on, that previous
308versions did not. These will either be enabled by new files in the F<hints/>
309directories, or new subdirectories and F<README> files at the top level of the
310source tree.
311
312=over 4
313
314=item XXX-some-platform
315
316XXX
317
318=back
319
320=head2 Discontinued Platforms
321
322XXX List any platforms that this version of perl no longer compiles on.
323
324=over 4
325
326=item XXX-some-platform
327
328XXX
329
330=back
331
332=head2 Platform-Specific Notes
333
334XXX List any changes for specific platforms. This could include configuration
335and compilation changes or changes in portability/compatibility. However,
336changes within modules for platforms should generally be listed in the
337L</Modules and Pragmata> section.
338
339=over 4
340
341=item XXX-some-platform
342
343XXX
344
345=back
346
347=head1 Internal Changes
348
349XXX Changes which affect the interface available to C<XS> code go here.
350Other significant internal changes for future core maintainers should
351be noted as well.
352
353[ List each test improvement as a =item entry ]
354
355=over 4
356
357=item *
358
359XXX
360
361=back
362
363=head1 Selected Bug Fixes
364
365XXX Important bug fixes in the core language are summarised here.
366Bug fixes in files in F<ext/> and F<lib/> are best summarised in
367L</Modules and Pragmata>.
368
369[ List each fix as a =item entry ]
370
371=over 4
372
373=item *
374
88e9444c
NC
375C<BEGIN {require 5.12.0}> now behaves as documented, rather than behaving
376identically to C<use 5.12.0;>. Previously, C<require> in a C<BEGIN> block
377was erroneously executing the C<use feature ':5.12.0'> and
378C<use strict; use warnings;> behaviour, which only C<use> was documented to
b373eab8
FC
379provide
380L<[perl #69050]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=69050>.
381
382=item *
383
384C<use 5.42>
385L<[perl #69050]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=69050>,
386C<use 6> and C<no 5> no longer leak memory.
387
388=item *
389
390C<eval "BEGIN{die}"> no longer leaks memory on non-threaded builds.
3a5c9134 391
1428a560
FC
392=item *
393
394PerlIO no longer crashes when called recursively, e.g., from a signal
395handler. Now it just leaks memory
396L<[perl #75556]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=75556>.
397
11cd2234
FC
398=item *
399
400Defining a constant with the same name as one of perl's special blocks
401(e.g., INIT) stopped working in 5.12.0, but has now been fixed
402L<[perl #78634]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78634>.
403
e3ef43a5
FC
404=item *
405
406A reference to a literal value used as a hash key (C<$hash{\"foo"}>) used
407to be stringified, even if the hash was tied
408L<[perl #79178]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=79178>.
409
3a5c9134
CBW
410=back
411
412=head1 Known Problems
413
414XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
415tests that had to be C<TODO>ed for the release would be noted here, unless
416they were specific to a particular platform (see below).
417
418This is a list of some significant unfixed bugs, which are regressions
419from either 5.XXX.XXX or 5.XXX.XXX.
420
421[ List each fix as a =item entry ]
422
423=over 4
424
425=item *
426
2283d326
KW
427A number of bugs with regular expression bracketed character classes
428have been fixed, mostly having to do with matching characters in the
429non-ASCII Latin-1 range.
3a5c9134
CBW
430
431=back
432
433=head1 Obituary
434
435XXX If any significant core contributor has died, we've added a short obituary
436here.
437
438=head1 Acknowledgements
439
440XXX The list of people to thank goes here.
441
442=head1 Reporting Bugs
443
444If you find what you think is a bug, you might check the articles
445recently posted to the comp.lang.perl.misc newsgroup and the perl
446bug database at http://rt.perl.org/perlbug/ . There may also be
447information at http://www.perl.org/ , the Perl Home Page.
448
449If you believe you have an unreported bug, please run the L<perlbug>
450program included with your release. Be sure to trim your bug down
451to a tiny but sufficient test case. Your bug report, along with the
452output of C<perl -V>, will be sent off to perlbug@perl.org to be
453analysed by the Perl porting team.
454
455If the bug you are reporting has security implications, which make it
456inappropriate to send to a publicly archived mailing list, then please send
457it to perl5-security-report@perl.org. This points to a closed subscription
458unarchived mailing list, which includes all the core committers, who be able
459to help assess the impact of issues, figure out a resolution, and help
460co-ordinate the release of patches to mitigate or fix the problem across all
461platforms on which Perl is supported. Please only use this address for
462security issues in the Perl core, not for modules independently
463distributed on CPAN.
464
465=head1 SEE ALSO
466
467The F<Changes> file for an explanation of how to view exhaustive details
468on what changed.
469
470The F<INSTALL> file for how to build Perl.
471
472The F<README> file for general stuff.
473
474The F<Artistic> and F<Copying> files for copyright information.
475
476=cut