This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Retry first shot at perldelta.pod.
[perl5.git] / pod / perldelta.pod
1 =encoding utf8
2
3 =head1 NAME
4
5 perldelta - what is new for perl v5.15.9
6
7 =head1 DESCRIPTION
8
9 This document describes differences between the 5.15.8 release and
10 the 5.15.9 release.
11
12 If you are upgrading from an earlier release such as 5.15.7, first read
13 L<perl5158delta>, which describes differences between 5.15.7 and
14 5.15.8.
15
16 =head1 Notice
17
18 This space intentionally left blank.
19
20 =head1 Core Enhancements
21
22 =head2 C<< no feature; >> now means reset to default
23
24 C<< no feature >> now resets to the default feature set.  To disable all
25 features (which is likely to be a pretty special-purpose request, since
26 it presumably won't match any named set of semantics) you can now  
27 write C<< no feature ':all' >>.
28
29
30 [ List each enhancement as a =head2 entry ]
31
32 =head1 Security
33
34 XXX Any security-related notices go here.  In particular, any security
35 vulnerabilities closed should be noted here rather than in the
36 L</Selected Bug Fixes> section.
37
38 [ List each security issue as a =head2 entry ]
39
40 =head1 Incompatible Changes
41
42 XXX For a release on a stable branch, this section aspires to be:
43
44     There are no changes intentionally incompatible with 5.XXX.XXX
45     If any exist, they are bugs, and we request that you submit a
46     report.  See L</Reporting Bugs> below.
47
48 [ List each incompatible change as a =head2 entry ]
49
50 =head1 Deprecations
51
52 =head2 Literal C<< "{" >> characters in regular expressions.
53
54 It has been documented that the current plans include requiring a
55 literal C<< "{" >> to be escaped: 5.18 will emit deprecation warnings,
56 and it will be required in 5.20.
57
58 =head1 Performance Enhancements
59
60 =over 4
61
62 =item *
63
64 Fix a slowdown in freeing nested hashes. This may speedup the exit of 
65 certain programs.
66
67 =back
68
69 =head1 Modules and Pragmata
70
71 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
72 go here.  If Module::CoreList is updated, generate an initial draft of the
73 following sections using F<Porting/corelist-perldelta.pl>, which prints stub
74 entries to STDOUT.  Results can be pasted in place of the '=head2' entries
75 below.  A paragraph summary for important changes should then be added by hand.
76 In an ideal world, dual-life modules would have a F<Changes> file that could be
77 cribbed.
78
79 [ Within each section, list entries as a =item entry ]
80
81 =head2 New Modules and Pragmata
82
83 =over 4
84
85 =item *
86
87 XXX
88
89 =back
90
91 =head2 Updated Modules and Pragmata
92
93 =over 4
94
95 =item *
96
97 L<XXX> has been upgraded from version 0.69 to version 0.70.
98
99 =back
100
101 =head2 Removed Modules and Pragmata
102
103 =over 4
104
105 =item *
106
107 XXX
108
109 =back
110
111 =head1 Documentation
112
113 XXX Changes to files in F<pod/> go here.  Consider grouping entries by
114 file and be sure to link to the appropriate page, e.g. L<perlfunc>.
115
116 =head2 New Documentation
117
118 XXX Changes which create B<new> files in F<pod/> go here.
119
120 =head3 L<XXX>
121
122 XXX Description of the purpose of the new file here
123
124 =head2 Changes to Existing Documentation
125
126 XXX Changes which significantly change existing files in F<pod/> go here.
127 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
128 section.
129
130 =head3 L<XXX>
131
132 =over 4
133
134 =item *
135
136 XXX Description of the change here
137
138 =back
139
140 =head1 Diagnostics
141
142 The following additions or changes have been made to diagnostic output,
143 including warnings and fatal error messages.  For the complete list of
144 diagnostic messages, see L<perldiag>.
145
146 =head2 New Diagnostics
147
148 =head3 New Errors
149
150 Compared to 5.15.8, 5.15.9 does not introduce new errors.
151
152 =head3 New Warnings
153
154 Compared to 5.15.8, 5.15.9 does not introduce new errors, but see
155 L</Changes to Existing Diagnostics>
156
157 =head2 Changes to Existing Diagnostics
158
159 =over 4
160
161 =item *
162
163 L<lvalue attribute %s already-defined subroutine|perldiag/"lvalue attribute %s already-defined subroutine">, which replaces
164 C<< lvalue attribute cannot be removed after the subroutine has been defined >>.
165
166 =back
167
168 =head1 Utility Changes
169
170 No utilities changed between 5.15.8 and 5.15.9.
171
172 =head1 Configuration and Compilation
173
174 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
175 go here.  Any other changes to the Perl build process should be listed here.
176 However, any platform-specific changes should be listed in the
177 L</Platform Support> section, instead.
178
179 [ List changes as a =item entry ].
180
181 =over 4
182
183 =item *
184
185 XXX
186
187 =back
188
189 =head1 Testing
190
191 =over 4
192
193 =item *
194
195 F<< t/op/require_37033.t >> has been added, to test that C<require>
196 always closes the file handle that it opens. Previously, it had been
197 leaking the file handle if it happened to have file descriptor 0, which
198 would happen if C<require> was called (explicitly or implicitly) when
199 C<STDIN> had been closed.
200
201 =back
202
203 =head1 Platform Support
204
205 XXX Any changes to platform support should be listed in the sections below.
206
207 [ Within the sections, list each platform as a =item entry with specific
208 changes as paragraphs below it. ]
209
210 =head2 New Platforms
211
212 XXX List any platforms that this version of perl compiles on, that previous
213 versions did not. These will either be enabled by new files in the F<hints/>
214 directories, or new subdirectories and F<README> files at the top level of the
215 source tree.
216
217 =over 4
218
219 =item XXX-some-platform
220
221 XXX
222
223 =back
224
225 =head2 Discontinued Platforms
226
227 XXX List any platforms that this version of perl no longer compiles on.
228
229 =over 4
230
231 =item XXX-some-platform
232
233 XXX
234
235 =back
236
237 =head2 Platform-Specific Notes
238
239 XXX List any changes for specific platforms. This could include configuration
240 and compilation changes or changes in portability/compatibility.  However,
241 changes within modules for platforms should generally be listed in the
242 L</Modules and Pragmata> section.
243
244 =over 4
245
246 =item XXX-some-platform
247
248 XXX
249
250 =back
251
252 =head1 Internal Changes
253
254 XXX Changes which affect the interface available to C<XS> code go here.
255 Other significant internal changes for future core maintainers should
256 be noted as well.
257
258 [ List each change as a =item entry ]
259
260 =over 4
261
262 =item *
263
264 XXX
265
266 =back
267
268 =head1 Selected Bug Fixes
269
270 XXX Important bug fixes in the core language are summarised here.
271 Bug fixes in files in F<ext/> and F<lib/> are best summarised in
272 L</Modules and Pragmata>.
273
274 [ List each fix as a =item entry ]
275
276 =over 4
277
278 =item *
279
280 I<Takri> is now considered a script that uses two characters. This corrects
281 a Unicode 6.1 omission.
282
283 =item *
284
285 C<< perlfunc.hmtl >> is now being generated again. [perl #107870]
286
287 =item *
288
289 C<< $$ >> is no longer tainted. Since this value comes directly from
290 C<< getpid() >>, it is always safe.
291
292 =item *
293
294 Fix leaking a file handle. [perl #37033]
295
296 =item *
297
298 An off-by-one error caused C<< /[:upper:]/ >> and C<< /[:punct:]/ >> to
299 unexepectly match characters with code points above 255. This has been
300 rectified. [perl 111400].
301
302 =item *
303
304 C<< (?foo: ...) >> no longer loses passed in character set.
305
306 =item *
307
308 Allow attributes to set C<< :lvalue >> on a defined sub. [perl 107366].
309
310 =item *
311
312 C<< die; >> with a non-reference, non-string value in $@ now properly
313 propgates that value [perl #111654].
314
315 =item *
316
317 C<< Term::ReadLine >> now uses AnyEvent instead of Tk for an event loop.
318
319
320 =back
321
322 =head1 Known Problems
323
324 XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
325 tests that had to be C<TODO>ed for the release would be noted here, unless
326 they were specific to a particular platform (see below).
327
328 This is a list of some significant unfixed bugs, which are regressions
329 from either 5.XXX.XXX or 5.XXX.XXX.
330
331 [ List each fix as a =item entry ]
332
333 =over 4
334
335 =item *
336
337 XXX
338
339 =back
340
341 =head1 Obituary
342
343 XXX If any significant core contributor has died, we've added a short obituary
344 here.
345
346 =head1 Acknowledgements
347
348 XXX Redo this on 2012-03-20
349
350 Perl 5.15.9 represents approximately 4 weeks of development since Perl 5.15.8
351 and contains approximately 74,000 lines of changes across 470 files from 23
352 authors.
353
354 Perl continues to flourish into its third decade thanks to a vibrant community
355 of users and developers. The following people are known to have contributed the
356 improvements that became Perl 5.15.9:
357
358 Aaron Crane, Abigail, Chris 'BinGOs' Williams, Craig A. Berry, Dave Rolsky,
359 David Cantrell, David Golden, David Mitchell, Eric Brine, Father Chrysostomos,
360 Florian Ragwitz, James E Keenan, Jesse Vincent, Karl Williamson, Marc Green,
361 Max Maischein, Nicholas Clark, Pau Amma, Reini Urban, Ricardo Signes, Tony
362 Cook, Yves Orton, Zefram.
363
364 The list above is almost certainly incomplete as it is automatically generated
365 from version control history. In particular, it does not include the names of
366 the (very much appreciated) contributors who reported issues to the Perl bug
367 tracker.
368
369 Many of the changes included in this version originated in the CPAN modules
370 included in Perl's core. We're grateful to the entire CPAN community for
371 helping Perl to flourish.
372
373 For a more complete list of all of Perl's historical contributors, please see
374 the F<AUTHORS> file in the Perl source distribution.
375
376 =head1 Reporting Bugs
377
378 If you find what you think is a bug, you might check the articles
379 recently posted to the comp.lang.perl.misc newsgroup and the perl
380 bug database at http://rt.perl.org/perlbug/ .  There may also be
381 information at http://www.perl.org/ , the Perl Home Page.
382
383 If you believe you have an unreported bug, please run the L<perlbug>
384 program included with your release.  Be sure to trim your bug down
385 to a tiny but sufficient test case.  Your bug report, along with the
386 output of C<perl -V>, will be sent off to perlbug@perl.org to be
387 analysed by the Perl porting team.
388
389 If the bug you are reporting has security implications, which make it
390 inappropriate to send to a publicly archived mailing list, then please send
391 it to perl5-security-report@perl.org. This points to a closed subscription
392 unarchived mailing list, which includes
393 all the core committers, who will be able
394 to help assess the impact of issues, figure out a resolution, and help
395 co-ordinate the release of patches to mitigate or fix the problem across all
396 platforms on which Perl is supported. Please only use this address for
397 security issues in the Perl core, not for modules independently
398 distributed on CPAN.
399
400 =head1 SEE ALSO
401
402 The F<Changes> file for an explanation of how to view exhaustive details
403 on what changed.
404
405 The F<INSTALL> file for how to build Perl.
406
407 The F<README> file for general stuff.
408
409 The F<Artistic> and F<Copying> files for copyright information.
410
411 =cut