This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta for 75f5d3312
[perl5.git] / pod / perldelta.pod
CommitLineData
3a5c9134
CBW
1=encoding utf8
2
59773fc7 3=for comment
d4238815 4This has been completed up to 75f5d3312.
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
2638c0ff
FC
156C<overload> has been upgraded from 1.11 to 1.12.
157
158=item *
159
160C<PerlIO::scalar> has been upgraded from 0.10 to 0.11.
161
162A C<read> after a C<seek> beyond the end of the string no longer thinks it
163has data to read
164L<[perl #78716]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78716>.
165
166=item *
167
5ebfb99c 168C<Socket> has been upgraded from 1.91 to 1.92.
b373eab8
FC
169
170It has several new functions for handling IPv6 addresses.
171
172=item *
173
d4238815
FC
174C<Time::HiRes> has been upgraded from 1.9721 to 1.9721_01.
175
176=item *
177
68adb2b0
CBW
178C<Unicode::Collate> has been upgraded from 0.67 to 0.68
179
180=item *
181
59773fc7 182C<Unicode::UCD> has been upgraded from 0.29 to 0.30.
3a5c9134
CBW
183
184=back
185
186=head2 Removed Modules and Pragmata
187
188=over 4
189
190=item *
191
192XXX
193
194=back
195
196=head1 Documentation
197
198XXX Changes to files in F<pod/> go here. Consider grouping entries by
199file and be sure to link to the appropriate page, e.g. L<perlfunc>.
200
201=head2 New Documentation
202
203XXX Changes which create B<new> files in F<pod/> go here.
204
205=head3 L<XXX>
206
207XXX Description of the purpose of the new file here
208
209=head2 Changes to Existing Documentation
210
211XXX Changes which significantly change existing files in F<pod/> go here.
212However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
213section.
214
215=head3 L<XXX>
216
217=over 4
218
219=item *
220
221XXX Description of the change here
222
223=back
224
225=head1 Diagnostics
226
227The following additions or changes have been made to diagnostic output,
228including warnings and fatal error messages. For the complete list of
229diagnostic messages, see L<perldiag>.
230
231XXX New or changed warnings emitted by the core's C<C> code go here. Also
232include any changes in L<perldiag> that reconcile it to the C<C> code.
233
234[ Within each section, list entries as a =item entry ]
235
236=head2 New Diagnostics
237
238XXX Newly added diagnostic messages go here
239
240=over 4
241
242=item *
243
244XXX
245
246=back
247
248=head2 Changes to Existing Diagnostics
249
250XXX Changes (i.e. rewording) of diagnostic messages go here
251
252=over 4
253
254=item *
255
256XXX
257
258=back
259
260=head1 Utility Changes
261
262XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
263here. Most of these are built within the directories F<utils> and F<x2p>.
264
265[ List utility changes as a =head3 entry for each utility and =item
266entries for each change
267Use L<XXX> with program names to get proper documentation linking. ]
268
269=head3 L<XXX>
270
271=over 4
272
273=item *
274
275XXX
276
277=back
278
279=head1 Configuration and Compilation
280
281XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
282go here. Any other changes to the Perl build process should be listed here.
283However, any platform-specific changes should be listed in the
284L</Platform Support> section, instead.
285
286[ List changes as a =item entry ].
287
288=over 4
289
290=item *
291
292XXX
293
294=back
295
296=head1 Testing
297
298XXX Any significant changes to the testing of a freshly built perl should be
299listed here. Changes which create B<new> files in F<t/> go here as do any
300large changes to the testing harness (e.g. when parallel testing was added).
301Changes to existing files in F<t/> aren't worth summarising, although the bugs
302that they represent may be covered elsewhere.
303
304[ List each test improvement as a =item entry ]
305
306=over 4
307
308=item *
309
310XXX
311
312=back
313
314=head1 Platform Support
315
316XXX Any changes to platform support should be listed in the sections below.
317
318[ Within the sections, list each platform as a =item entry with specific
319changes as paragraphs below it. ]
320
321=head2 New Platforms
322
323XXX List any platforms that this version of perl compiles on, that previous
324versions did not. These will either be enabled by new files in the F<hints/>
325directories, or new subdirectories and F<README> files at the top level of the
326source tree.
327
328=over 4
329
330=item XXX-some-platform
331
332XXX
333
334=back
335
336=head2 Discontinued Platforms
337
338XXX List any platforms that this version of perl no longer compiles on.
339
340=over 4
341
342=item XXX-some-platform
343
344XXX
345
346=back
347
348=head2 Platform-Specific Notes
349
350XXX List any changes for specific platforms. This could include configuration
351and compilation changes or changes in portability/compatibility. However,
352changes within modules for platforms should generally be listed in the
353L</Modules and Pragmata> section.
354
355=over 4
356
357=item XXX-some-platform
358
359XXX
360
361=back
362
363=head1 Internal Changes
364
365XXX Changes which affect the interface available to C<XS> code go here.
366Other significant internal changes for future core maintainers should
367be noted as well.
368
369[ List each test improvement as a =item entry ]
370
371=over 4
372
373=item *
374
375XXX
376
377=back
378
379=head1 Selected Bug Fixes
380
381XXX Important bug fixes in the core language are summarised here.
382Bug fixes in files in F<ext/> and F<lib/> are best summarised in
383L</Modules and Pragmata>.
384
385[ List each fix as a =item entry ]
386
387=over 4
388
389=item *
390
88e9444c
NC
391C<BEGIN {require 5.12.0}> now behaves as documented, rather than behaving
392identically to C<use 5.12.0;>. Previously, C<require> in a C<BEGIN> block
393was erroneously executing the C<use feature ':5.12.0'> and
394C<use strict; use warnings;> behaviour, which only C<use> was documented to
b373eab8
FC
395provide
396L<[perl #69050]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=69050>.
397
398=item *
399
400C<use 5.42>
401L<[perl #69050]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=69050>,
402C<use 6> and C<no 5> no longer leak memory.
403
404=item *
405
406C<eval "BEGIN{die}"> no longer leaks memory on non-threaded builds.
3a5c9134 407
1428a560
FC
408=item *
409
410PerlIO no longer crashes when called recursively, e.g., from a signal
411handler. Now it just leaks memory
412L<[perl #75556]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=75556>.
413
11cd2234
FC
414=item *
415
416Defining a constant with the same name as one of perl's special blocks
417(e.g., INIT) stopped working in 5.12.0, but has now been fixed
418L<[perl #78634]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78634>.
419
e3ef43a5
FC
420=item *
421
422A reference to a literal value used as a hash key (C<$hash{\"foo"}>) used
423to be stringified, even if the hash was tied
424L<[perl #79178]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=79178>.
425
3a5c9134
CBW
426=back
427
428=head1 Known Problems
429
430XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
431tests that had to be C<TODO>ed for the release would be noted here, unless
432they were specific to a particular platform (see below).
433
434This is a list of some significant unfixed bugs, which are regressions
435from either 5.XXX.XXX or 5.XXX.XXX.
436
437[ List each fix as a =item entry ]
438
439=over 4
440
441=item *
442
2283d326
KW
443A number of bugs with regular expression bracketed character classes
444have been fixed, mostly having to do with matching characters in the
445non-ASCII Latin-1 range.
3a5c9134
CBW
446
447=back
448
449=head1 Obituary
450
451XXX If any significant core contributor has died, we've added a short obituary
452here.
453
454=head1 Acknowledgements
455
456XXX The list of people to thank goes here.
457
458=head1 Reporting Bugs
459
460If you find what you think is a bug, you might check the articles
461recently posted to the comp.lang.perl.misc newsgroup and the perl
462bug database at http://rt.perl.org/perlbug/ . There may also be
463information at http://www.perl.org/ , the Perl Home Page.
464
465If you believe you have an unreported bug, please run the L<perlbug>
466program included with your release. Be sure to trim your bug down
467to a tiny but sufficient test case. Your bug report, along with the
468output of C<perl -V>, will be sent off to perlbug@perl.org to be
469analysed by the Perl porting team.
470
471If the bug you are reporting has security implications, which make it
472inappropriate to send to a publicly archived mailing list, then please send
473it to perl5-security-report@perl.org. This points to a closed subscription
474unarchived mailing list, which includes all the core committers, who be able
475to help assess the impact of issues, figure out a resolution, and help
476co-ordinate the release of patches to mitigate or fix the problem across all
477platforms on which Perl is supported. Please only use this address for
478security issues in the Perl core, not for modules independently
479distributed on CPAN.
480
481=head1 SEE ALSO
482
483The F<Changes> file for an explanation of how to view exhaustive details
484on what changed.
485
486The F<INSTALL> file for how to build Perl.
487
488The F<README> file for general stuff.
489
490The F<Artistic> and F<Copying> files for copyright information.
491
492=cut