This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
fcfe8f2f90f85aad636bb172ff37035b44cc141d
[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 =head1 Security
30
31 =head2 Malformed UTF-8 input could cause attempts to read beyond the end of the buffer
32
33 Two new XS-accessible functions, C<utf8_to_uvchr_buf()> and
34 C<utf8_to_uvuni_buf()> are now available to prevent this, and the Perl
35 core has been converted to use them.
36 See L</Internal Changes>.
37
38 =head1 Incompatible Changes
39
40 =head2 C<< no feature; >>
41
42 C<no feature;> now means reset to default.
43
44 =head1 Deprecations
45
46 =head2 Literal C<< "{" >> characters in regular expressions.
47
48 It has been documented that the current plans include requiring a
49 literal C<< "{" >> to be escaped: 5.18 will emit deprecation warnings,
50 and it will be required in 5.20.
51
52 =head2 XS functions C<utf8_to_uvchr()> and C<utf8_to_uvuni()>
53
54 Use C<utf8_to_uvchr_buf()> and C<utf8_to_uvuni_buf()> instead.
55 See L</Internal Changes>.
56
57 =head1 Performance Enhancements
58
59 =over 4
60
61 =item *
62
63 Fix a slowdown in freeing nested hashes. This may speedup the exit of 
64 certain programs.
65
66 =back
67
68 =head1 Modules and Pragmata
69
70 =head2 Updated Modules and Pragmata
71
72 =over 4
73
74 =item *
75
76 C<attributes> has been upgraded from version 0.17 to 0.18.
77
78 =item *
79
80 C<feature> has been upgraded from version 1.26 to 1.27.
81
82 C<no feature;> now means reset to default. The code has been refactored
83 to reduce duplication.
84
85 =item *
86
87 C<B::Deparse> has been upgraded from version 1.12 to 1.13.
88
89 =item *
90
91 C<B::Lint> has been upgraded from version 1.13 to 1.14.
92
93 =item *
94
95 C<CPAN::Meta> has been upgraded from version 2.120351 to 2.120630.
96
97 =item *
98
99 C<CPANPLUS> has been upgraded from version 0.9118 to 0.9121.
100
101 =item *
102
103 C<Data::Dumper> has been upgraded from version 2.135_05 to 2.135_06.
104
105 =item *
106
107 C<Digest::SHA> has been upgraded from version 5.70 to 5.71.
108
109 =item *
110
111 C<ExtUtils::CBuilder> has been upgraded from version 0.280205 to 0.280206.
112
113 =item *
114
115 C<HTTP::Tiny> has been upgraded from version 0.016 to 0.017.
116
117 =item *
118
119 C<Module::CoreList> has been upgraded from version 2.60 to 2.63.
120
121 =item *
122
123 C<Pod::Html> has been upgraded from version 1.14 to 1.1501.
124
125 =item *
126
127 C<Pod::Perldoc> has been upgraded from version 3.15_15 to 3.17.
128
129 =item *
130
131 C<Pod::Simple> has been upgraded from version 3.19 to 3.20.
132
133 =item *
134
135 C<Socket> has been upgraded from version 1.98 to 2.000.
136
137 =item *
138
139 C<Term::ReadLine> has been upgraded from version 1.08 to 1.09.
140
141 =item *
142
143 C<Unicode::Collate> has been upgraded from version 0.87 to 0.89.
144
145 =item *
146
147 C<Unicode::Normalize> has been upgraded from version 1.13 to 1.14.
148
149 =item *
150
151 C<Unicode::UCD> has been upgraded from version 0.41 to 0.42.
152
153 =item *
154
155 C<XS::APItest> has been upgraded from version 0.36 to 0.37.
156
157 =back
158
159
160 =head1 Documentation
161
162 There has been no significant change in the documentation between 
163 5.15.8 and 5.15.9.
164
165 =head1 Diagnostics
166
167 The following additions or changes have been made to diagnostic output,
168 including warnings and fatal error messages.  For the complete list of
169 diagnostic messages, see L<perldiag>.
170
171 =head2 New Diagnostics
172
173 =head3 New Errors
174
175 Compared to 5.15.8, 5.15.9 does not introduce new errors.
176
177 =head3 New Warnings
178
179 Compared to 5.15.8, 5.15.9 does not introduce new errors, but see
180 L</Changes to Existing Diagnostics>
181
182 =head2 Changes to Existing Diagnostics
183
184 =over 4
185
186 =item *
187
188 L<lvalue attribute %s already-defined subroutine|perldiag/"lvalue attribute %s already-defined subroutine">, which replaces
189 C<< lvalue attribute cannot be removed after the subroutine has been defined >>.
190
191 =back
192
193 =head1 Utility Changes
194
195 No utilities changed between 5.15.8 and 5.15.9.
196
197 =head1 Configuration and Compilation
198
199 =over 4
200
201 =item *
202
203 C<< perlfunc.html >> is now being generated again. [perl #107870]
204
205 =back
206
207 =head1 Testing
208
209 =over 4
210
211 =item *
212
213 F<< t/op/require_37033.t >> has been added, to test that C<require>
214 always closes the file handle that it opens. Previously, it had been
215 leaking the file handle if it happened to have file descriptor 0, which
216 would happen if C<require> was called (explicitly or implicitly) when
217 C<STDIN> had been closed.
218
219 =back
220
221 =head1 Platform Support
222
223 There have been no changes to Perl's support of various platforms between
224 5.15.8 and 5.15.9.
225
226 =head1 Internal Changes
227
228 =over 4
229
230 =item *
231
232 Two new functions C<utf8_to_uvchr_buf()> and C<utf8_to_uvuni_buf()> have
233 been added.  These are the same as C<utf8_to_uvchr> and
234 C<utf8_to_uvuni> (which are now deprecated), but take an extra parameter
235 that is used to guard against reading beyond the end of the input
236 string.
237 See L<perlapi/utf8_to_uvchr_buf> and L<perlapi/utf8_to_uvuni_buf>.
238
239 =back
240
241 =head1 Selected Bug Fixes
242
243 =over 4
244
245 =item *
246
247 I<Takri> now matches two more characters under the C<Script_Extensions>
248 property. This corrects a Unicode 6.1 omission.
249
250 =item *
251
252 C<< perlfunc.html >> is now being generated again. [perl #107870]
253
254 =item *
255
256 C<< $$ >> is no longer tainted. Since this value comes directly from
257 C<< getpid() >>, it is always safe.
258
259 =item *
260
261 Fix leaking a file handle. [perl #37033]
262
263 =item *
264
265 An off-by-one error caused C<< /[:upper:]/ >> and C<< /[:punct:]/ >> to
266 unexpectedly match characters with code points above 255. This has been
267 rectified. [perl 111400].
268
269 =item *
270
271 C<< (?foo: ...) >> no longer loses passed in character set.
272
273 =item *
274
275 Allow attributes to set C<< :lvalue >> on a defined sub. [perl 107366].
276
277 =item *
278
279 C<< die; >> with a non-reference, non-string value in $@ now properly
280 propagates that value [perl #111654].
281
282 =item *
283
284 C<< Term::ReadLine >> now uses AnyEvent instead of Tk for an event loop.
285
286 =back
287
288 =head1 Known Problems
289
290 This is a list of some significant unfixed bugs, which are regressions
291 from either 5.14.0 or 5.15.8.
292
293 =over 4
294
295 =item C<eval { 'fork()' }> is broken on Windows [perl #109718]
296
297 This is a known test failure to be fixed before 5.16.0. 
298
299 =item C<< Pod-Html >> test failures on Windows.
300
301 A number of tests for C<< Pod::Html >> fail under Windows, due to an 
302 incorrect assumption by the test scripts about capitalization of the
303 network drive.
304
305 =back
306
307 =head1 Acknowledgements
308
309 XXX Redo this on 2012-03-20
310
311 Perl 5.15.9 represents approximately 4 weeks of development since Perl 5.15.8
312 and contains approximately 74,000 lines of changes across 470 files from 23
313 authors.
314
315 Perl continues to flourish into its third decade thanks to a vibrant community
316 of users and developers. The following people are known to have contributed the
317 improvements that became Perl 5.15.9:
318
319 Aaron Crane, Abigail, Chris 'BinGOs' Williams, Craig A. Berry, Dave Rolsky,
320 David Cantrell, David Golden, David Mitchell, Eric Brine, Father Chrysostomos,
321 Florian Ragwitz, James E Keenan, Jesse Vincent, Karl Williamson, Marc Green,
322 Max Maischein, Nicholas Clark, Pau Amma, Reini Urban, Ricardo Signes, Tony
323 Cook, Yves Orton, Zefram.
324
325 The list above is almost certainly incomplete as it is automatically generated
326 from version control history. In particular, it does not include the names of
327 the (very much appreciated) contributors who reported issues to the Perl bug
328 tracker.
329
330 Many of the changes included in this version originated in the CPAN modules
331 included in Perl's core. We're grateful to the entire CPAN community for
332 helping Perl to flourish.
333
334 For a more complete list of all of Perl's historical contributors, please see
335 the F<AUTHORS> file in the Perl source distribution.
336
337 =head1 Reporting Bugs
338
339 If you find what you think is a bug, you might check the articles
340 recently posted to the comp.lang.perl.misc newsgroup and the perl
341 bug database at http://rt.perl.org/perlbug/ .  There may also be
342 information at http://www.perl.org/ , the Perl Home Page.
343
344 If you believe you have an unreported bug, please run the L<perlbug>
345 program included with your release.  Be sure to trim your bug down
346 to a tiny but sufficient test case.  Your bug report, along with the
347 output of C<perl -V>, will be sent off to perlbug@perl.org to be
348 analysed by the Perl porting team.
349
350 If the bug you are reporting has security implications, which make it
351 inappropriate to send to a publicly archived mailing list, then please send
352 it to perl5-security-report@perl.org. This points to a closed subscription
353 unarchived mailing list, which includes
354 all the core committers, who will be able
355 to help assess the impact of issues, figure out a resolution, and help
356 co-ordinate the release of patches to mitigate or fix the problem across all
357 platforms on which Perl is supported. Please only use this address for
358 security issues in the Perl core, not for modules independently
359 distributed on CPAN.
360
361 =head1 SEE ALSO
362
363 The F<Changes> file for an explanation of how to view exhaustive details
364 on what changed.
365
366 The F<INSTALL> file for how to build Perl.
367
368 The F<README> file for general stuff.
369
370 The F<Artistic> and F<Copying> files for copyright information.
371
372 =cut