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