Commit | Line | Data |
---|---|---|
4c793fe3 FR |
1 | =encoding utf8 |
2 | ||
c39f7439 | 3 | =for comment |
15bc3b4f | 4 | This has been completed up to 8ff3250783, except for: |
48ea5431 FC |
5 | 04777d295957ad270188e4debf51b523e07cc5b0 |
6 | c565ab54dc649bb62cd4d57149d7b2abb21df5f3 | |
a5e71717 | 7 | 1c8d11ca3d0ce8bc11562f159b94c2c7e62dea6c |
9e2ac5d4 FC |
8 | 51698cb360d5bba06e12496ef9c7bf82e3352b71 |
9 | 0c4d3b5ea916cf640ea163c5a6bcffefade55a1b | |
c39f7439 | 10 | |
4c793fe3 FR |
11 | =head1 NAME |
12 | ||
8f97a47a TM |
13 | [ this is a template for a new perldelta file. Any text flagged as |
14 | XXX needs to be processed before release. ] | |
4c793fe3 | 15 | |
8f97a47a | 16 | perldelta - what is new for perl v5.13.7 |
a12cf05f | 17 | |
8f97a47a | 18 | =head1 DESCRIPTION |
fb121860 | 19 | |
8f97a47a TM |
20 | This document describes differences between the 5.13.6 release and |
21 | the 5.13.7 release. | |
eb32ee41 | 22 | |
8f97a47a TM |
23 | If you are upgrading from an earlier release such as 5.13.5, first read |
24 | L<perl5136delta>, which describes differences between 5.13.5 and | |
25 | 5.13.6. | |
eb32ee41 | 26 | |
8f97a47a | 27 | =head1 Notice |
eb32ee41 | 28 | |
8f97a47a | 29 | XXX Any important notices here |
5e26bbbe | 30 | |
8f97a47a | 31 | =head1 Core Enhancements |
5e26bbbe | 32 | |
8f97a47a TM |
33 | XXX New core language features go here. Summarise user-visible core language |
34 | enhancements. Particularly prominent performance optimisations could go | |
35 | here, but most should go in the L</Performance Enhancements> section. | |
5e26bbbe | 36 | |
8f97a47a | 37 | [ List each enhancement as a =head2 entry ] |
4f65bc30 | 38 | |
c035a075 DG |
39 | =head2 Single term prototype |
40 | ||
41 | The C<+> prototype is a special alternative to C<$> that will act like | |
42 | C<\[@%]> when given a literal array or hash variable, but will otherwise | |
43 | force scalar context on the argument. This is useful for functions which | |
44 | should accept either a literal array or an array reference as the argument: | |
45 | ||
46 | sub smartpush (+@) { | |
47 | my $aref = shift; | |
48 | die "Not an array or arrayref" unless ref $aref eq 'ARRAY'; | |
49 | push @$aref, @_; | |
50 | } | |
51 | ||
52 | When using the C<+> prototype, your function must check that the argument | |
53 | is of an acceptable type. | |
54 | ||
b7bd32cc FC |
55 | =head2 C<use re '/flags';> |
56 | ||
57 | The C<re> pragma now has the ability to turn on regular expression flags | |
58 | till the end of the lexical scope: | |
59 | ||
60 | use re '/x'; | |
61 | "foo" =~ / (.+) /; # /x implied | |
62 | ||
63 | See L<re/'/flags' mode> for details. | |
64 | ||
a5e71717 FC |
65 | =head2 Statement labels can appear in more places |
66 | ||
67 | Statement labels can now occur before any type of statement or declaration, | |
68 | such as C<package>. | |
69 | ||
9b7c43ba KW |
70 | =head2 C<use feature "unicode_strings"> now applies to more regex matching |
71 | ||
72 | Another chunk of the L<perlunicode/The "Unicode Bug"> is fixed in this | |
73 | release. Now, regular expressions compiled within the scope of the | |
74 | "unicode_strings" feature (or under the "u" regex modifier (specifiable | |
75 | currently only with infix notation C<(?u:...)> or via C<use re '/u'>) | |
76 | will match the same whether or not the target string is encoded in utf8, | |
77 | with regard to C<[[:posix:]]> character classes | |
78 | ||
79 | Work is underway to add the case sensitive matching to the control of | |
80 | this feature, but was not complete in time for this dot release. | |
81 | ||
cba5a3b0 DG |
82 | =head2 Array and hash container functions accept references |
83 | ||
84 | All built-in functions that operate directly on array or hash | |
85 | containers now also accept hard references to arrays or hashes: | |
86 | ||
87 | |----------------------------+---------------------------| | |
88 | | Traditional syntax | Terse syntax | | |
89 | |----------------------------+---------------------------| | |
90 | | push @$arrayref, @stuff | push $arrayref, @stuff | | |
91 | | unshift @$arrayref, @stuff | unshift $arrayref, @stuff | | |
92 | | pop @$arrayref | pop $arrayref | | |
93 | | shift @$arrayref | shift $arrayref | | |
94 | | splice @$arrayref, 0, 2 | splice $arrayref, 0, 2 | | |
95 | | keys %$hashref | keys $hashref | | |
96 | | keys @$arrayref | keys $arrayref | | |
97 | | values %$hashref | values $hashref | | |
98 | | values @$arrayref | values $arrayref | | |
99 | | ($k,$v) = each %$hashref | ($k,$v) = each $hashref | | |
100 | | ($k,$v) = each @$arrayref | ($k,$v) = each $arrayref | | |
101 | |----------------------------+---------------------------| | |
102 | ||
103 | This allows these built-in functions to act on long dereferencing chains | |
104 | or on the return value of subroutines without needing to wrap them in | |
105 | C<@{}> or C<%{}>: | |
106 | ||
107 | push @{$obj->tags}, $new_tag; # old way | |
108 | push $obj->tags, $new_tag; # new way | |
109 | ||
110 | for ( keys %{$hoh->{genres}{artists}} ) {...} # old way | |
111 | for ( keys $hoh->{genres}{artists} ) {...} # new way | |
112 | ||
113 | For C<push>, C<unshift> and C<splice>, the reference will auto-vivify | |
114 | if it is not defined, just as if it were wrapped with C<@{}>. | |
115 | ||
116 | Calling C<keys> or C<values> directly on a reference gives a substantial | |
117 | performance improvement over explicit dereferencing. | |
118 | ||
119 | For C<keys>, C<values>, C<each>, when overloaded dereferencing is | |
120 | present, the overloaded dereference is used instead of dereferencing the | |
121 | underlying reftype. Warnings are issued about assumptions made in the | |
122 | following three ambiguous cases: | |
123 | ||
124 | (a) If both %{} and @{} overloading exists, %{} is used | |
125 | (b) If %{} overloading exists on a blessed arrayref, %{} is used | |
126 | (c) If @{} overloading exists on a blessed hashref, @{} is used | |
127 | ||
15bc3b4f FC |
128 | =head2 y///r |
129 | ||
130 | The C</r> flag, which was added to C<s///> in 5.13.2, has been extended to | |
131 | the C<y///> operator. | |
132 | ||
133 | It causes it to perform the substitution on a I<copy> of its operand, | |
134 | returning that copy instead of a character count. | |
135 | ||
8f97a47a | 136 | =head1 Security |
4f65bc30 | 137 | |
8f97a47a TM |
138 | XXX Any security-related notices go here. In particular, any security |
139 | vulnerabilities closed should be noted here rather than in the | |
140 | L</Selected Bug Fixes> section. | |
0eec0a4c | 141 | |
8f97a47a | 142 | [ List each security issue as a =head2 entry ] |
0eec0a4c | 143 | |
4c793fe3 FR |
144 | =head1 Incompatible Changes |
145 | ||
8f97a47a | 146 | XXX For a release on a stable branch, this section aspires to be: |
9de15fec | 147 | |
8f97a47a TM |
148 | There are no changes intentionally incompatible with 5.XXX.XXX. If any |
149 | exist, they are bugs and reports are welcome. | |
9de15fec | 150 | |
8f97a47a | 151 | [ List each incompatible change as a =head2 entry ] |
9de15fec | 152 | |
a638ba6f FC |
153 | =head2 Dereferencing typeglobs |
154 | ||
155 | If you assign a typeglob to a scalar variable: | |
156 | ||
157 | $glob = *foo; | |
158 | ||
159 | the glob that is copied to C<$glob> is marked with a special flag | |
160 | indicating that the glob is just a copy. This allows subsequent assignments | |
161 | to C<$glob> to overwrite the glob. The original glob, however, is | |
162 | immutable. | |
163 | ||
164 | Many Perl operators did not distinguish between these two types of globs. | |
165 | This would result in strange behaviour in edge cases: C<untie $scalar> | |
166 | would do nothing if the last thing assigned to the scalar was a glob | |
167 | (because it treated it as C<untie *$scalar>, which unties a handle). | |
0b6a3b5a | 168 | Assignment to a glob slot (e.g., C<(*$glob) = \@some_array>) would simply |
a638ba6f FC |
169 | assign C<\@some_array> to C<$glob>. |
170 | ||
171 | To fix this, the C<*{}> operator (including the C<*foo> and C<*$foo> forms) | |
172 | has been modified to make a new immutable glob if its operand is a glob | |
173 | copy. Various operators that make a distinction between globs and scalars | |
174 | have been modified to treat only immutable globs as globs. | |
175 | ||
176 | This causes an incompatible change in code that assigns a glob to the | |
177 | return value of C<*{}> when that operator was passed a glob copy. Take the | |
178 | following code, for instance: | |
179 | ||
180 | $glob = *foo; | |
181 | *$glob = *bar; | |
182 | ||
183 | The C<*$glob> on the second line returns a new immutable glob. That new | |
15bc3b4f FC |
184 | glob is made an alias to C<*bar>. Then it is discarded. So the second |
185 | assignment has no effect. | |
a638ba6f FC |
186 | |
187 | The upside to this incompatible change is that bugs | |
188 | L<[perl #77496]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=77496>, | |
189 | L<[perl #77502]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=77502>, | |
190 | L<[perl #77508]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=77508>, | |
191 | L<[perl #77688]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=77688>, | |
192 | and | |
193 | L<[perl #77812]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=77812>, | |
194 | and maybe others, too, have been fixed. | |
195 | ||
0b6a3b5a FC |
196 | See L<http://rt.perl.org/rt3/Public/Bug/Display.html?id=77810> for even |
197 | more detail. | |
a638ba6f | 198 | |
8f97a47a | 199 | =head1 Deprecations |
6904a83f | 200 | |
8f97a47a TM |
201 | XXX Any deprecated features, syntax, modules etc. should be listed here. |
202 | In particular, deprecated modules should be listed here even if they are | |
203 | listed as an updated module in the L</Modules and Pragmata> section. | |
6904a83f | 204 | |
8f97a47a | 205 | [ List each deprecation as a =head2 entry ] |
afa74577 | 206 | |
4c793fe3 FR |
207 | =head1 Performance Enhancements |
208 | ||
8f97a47a TM |
209 | XXX Changes which enhance performance without changing behaviour go here. There |
210 | may well be none in a stable release. | |
4c793fe3 | 211 | |
8f97a47a | 212 | [ List each enhancement as a =item entry ] |
e2babdfb | 213 | |
8f97a47a | 214 | =over 4 |
e2babdfb | 215 | |
b141c43c FR |
216 | =item * |
217 | ||
8f97a47a | 218 | XXX |
b141c43c | 219 | |
4c793fe3 FR |
220 | =back |
221 | ||
222 | =head1 Modules and Pragmata | |
223 | ||
8f97a47a TM |
224 | XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/> |
225 | go here. If Module::CoreList is updated, generate an initial draft of the | |
226 | following sections using F<Porting/corelist-perldelta.pl>, which prints stub | |
227 | entries to STDOUT. Results can be pasted in place of the '=head2' entries | |
228 | below. A paragraph summary for important changes should then be added by hand. | |
229 | In an ideal world, dual-life modules would have a F<Changes> file that could be | |
230 | cribbed. | |
e2941eb0 | 231 | |
8f97a47a | 232 | [ Within each section, list entries as a =item entry ] |
e2941eb0 | 233 | |
8f97a47a | 234 | =head2 New Modules and Pragmata |
25e68b8b | 235 | |
8f97a47a | 236 | =over 4 |
463da0ac CBW |
237 | |
238 | =item * | |
239 | ||
028d3bfa CBW |
240 | The following modules were added by the C<Unicode::Collate> |
241 | upgrade from 0.63 to 0.65. See below for details. | |
242 | ||
584e761d | 243 | C<Unicode::Collate::CJK::Big5> |
028d3bfa CBW |
244 | |
245 | C<Unicode::Collate::CJK::GB2312> | |
246 | ||
584e761d CBW |
247 | C<Unicode::Collate::CJK::JISX0208> |
248 | ||
249 | C<Unicode::Collate::CJK::Korean> | |
028d3bfa CBW |
250 | |
251 | C<Unicode::Collate::CJK::Pinyin> | |
252 | ||
253 | C<Unicode::Collate::CJK::Stroke> | |
6481ebaf | 254 | |
8f97a47a | 255 | =back |
6481ebaf | 256 | |
8f97a47a | 257 | =head2 Updated Modules and Pragmata |
6481ebaf | 258 | |
8f97a47a | 259 | =over 4 |
ac4c9720 CBW |
260 | |
261 | =item * | |
262 | ||
9f1eb87f CBW |
263 | C<Archive::Extract> has been upgraded from 0.44 to 0.46 |
264 | ||
265 | Resolves an issue with NetBSD-current and its new unzip | |
266 | executable. | |
267 | ||
268 | =item * | |
269 | ||
a5e71717 FC |
270 | C<B> has been upgraded from 1.24 to 1.25. |
271 | ||
272 | =item * | |
273 | ||
b293762b | 274 | C<B::Deparse> has been upgraded from 0.99 to 1.01. |
b7bd32cc FC |
275 | |
276 | It fixes deparsing of C<our> followed by a variable with funny characters | |
277 | (as permitted under the C<utf8> pragma) | |
278 | L<[perl #33752]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=33752>. | |
279 | ||
280 | =item * | |
281 | ||
84601d63 CBW |
282 | C<CGI> has been upgraded from 3.49 to 3.50 |
283 | ||
284 | This provides the following security fixes: the MIME boundary in | |
285 | multipart_init is now random and improvements to the handling of | |
286 | newlines embedded in header values. | |
287 | ||
288 | The documentation for param_fetch() has been corrected and clarified. | |
289 | ||
290 | =item * | |
291 | ||
07be2ace CBW |
292 | C<CPAN> has been upgraded from 1.94_61 to 1.94_62 |
293 | ||
294 | =item * | |
295 | ||
59af3f66 CBW |
296 | C<CPANPLUS> has been upgraded from 0.9007 to 0.9010 |
297 | ||
298 | Fixes for the SQLite source engine and resolving of issues with the | |
299 | testsuite when run under local::lib and/or cpanminus | |
300 | ||
301 | =item * | |
302 | ||
f5c34353 CBW |
303 | C<CPANPLUS::Dist::Build> has been upgraded from 0.48 to 0.50 |
304 | ||
305 | =item * | |
306 | ||
9e2ac5d4 FC |
307 | C<DynaLoader> has been upgraded from 1.10 to 1.11. |
308 | ||
309 | It fixes a buffer overflow when passed a very long file name. | |
310 | ||
311 | =item * | |
312 | ||
48ea5431 FC |
313 | C<ExtUtils::Constant> has been upgraded from 0.22 to 0.23. |
314 | ||
315 | =item * | |
316 | ||
317 | C<Fcntl> has been upgraded from 1.09 to 1.10. | |
318 | ||
319 | =item * | |
320 | ||
6d3bcdd8 | 321 | C<File::Fetch> has been upgraded from 0.24 to 0.28 |
0df024e2 CBW |
322 | |
323 | C<HTTP::Lite> is now supported for 'http' scheme. | |
324 | ||
6d3bcdd8 CBW |
325 | The C<fetch> utility is supported on FreeBSD, NetBSD and |
326 | Dragonfly BSD for the C<http> and C<ftp> schemes. | |
327 | ||
0df024e2 CBW |
328 | =item * |
329 | ||
48ea5431 FC |
330 | C<File::Glob> has been upgraded from 1.09 to 1.10. |
331 | ||
332 | =item * | |
333 | ||
c39f7439 FC |
334 | C<GDBM_File> has been upgraded from 1.11 to 1.12. |
335 | ||
336 | This fixes a memory leak when DBM filters are used. | |
337 | ||
338 | =item * | |
339 | ||
48ea5431 FC |
340 | C<Hash::Util> has been upgraded from 0.09 to 0.10. |
341 | ||
b293762b FC |
342 | =item * |
343 | ||
344 | C<Hash::Util::FieldHash> has been upgraded from 1.05 to 1.06. | |
48ea5431 FC |
345 | |
346 | =item * | |
347 | ||
348 | C<I18N::Langinfo> has been upgraded from 0.06 to 0.07. | |
349 | ||
350 | =item * | |
351 | ||
b22271be FR |
352 | C<Locale::Maketext> has been upgraded from 1.16 to 1.17. |
353 | ||
354 | =item * | |
355 | ||
356 | C<Math::BigInt> has been upgraded from 1.97 to 1.98. | |
e1be28b4 TR |
357 | |
358 | =item * | |
359 | ||
a0b94c24 | 360 | C<Math::BigInt::FastCalc> has been upgraded from 0.22 to 0.24. |
b293762b FC |
361 | |
362 | =item * | |
363 | ||
46787c0e CBW |
364 | C<MIME::Base64> has been upgraded from 3.09 to 3.10 |
365 | ||
366 | Includes new functions to calculate the length of encoded and decoded | |
367 | base64 strings. | |
368 | ||
369 | =item * | |
370 | ||
8ff01ef0 FC |
371 | C<mro> has been upgraded from 1.04 to 1.05. |
372 | ||
373 | =item * | |
374 | ||
c39f7439 FC |
375 | C<NDBM_File> has been upgraded from 1.09 to 1.10. |
376 | ||
377 | This fixes a memory leak when DBM filters are used. | |
378 | ||
379 | =item * | |
380 | ||
381 | C<ODBM_File> has been upgraded from 1.08 to 1.09. | |
382 | ||
383 | This fixes a memory leak when DBM filters are used. | |
384 | ||
385 | =item * | |
386 | ||
a9aeb2f1 CBW |
387 | C<parent> has been upgraded from 0.223 to 0.224 |
388 | ||
389 | =item * | |
390 | ||
48ea5431 FC |
391 | C<POSIX> has been upgraded from 1.21 to 1.22. |
392 | ||
393 | =item * | |
394 | ||
b7bd32cc FC |
395 | C<re> has been upgraded from 0.13 to 0.14, for the sake of the new |
396 | C<use re "/flags"> pragma. | |
dfa4c013 | 397 | |
48ea5431 FC |
398 | =item * |
399 | ||
8ff01ef0 FC |
400 | C<Safe> has been upgraded from 2.28 to 2.29. |
401 | ||
402 | It adds C<&version::vxs::VCMP> to the default share. | |
403 | ||
404 | =item * | |
405 | ||
48ea5431 FC |
406 | C<SDBM_File> has been upgraded from 1.07 to 1.08. |
407 | ||
408 | =item * | |
409 | ||
a5e71717 FC |
410 | C<SelfLoader> has been upgraded from 1.17 to 1.18. |
411 | ||
412 | It now works in taint mode | |
413 | L<[perl #72062]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=72062>. | |
414 | ||
415 | =item * | |
416 | ||
48ea5431 FC |
417 | C<Socket> has been upgraded from 1.90 to 1.91. |
418 | ||
a5e71717 FC |
419 | =item * |
420 | ||
421 | C<Sys::Hostname> has been upgraded from 1.13 to 1.14. | |
422 | ||
539ce3d8 CBW |
423 | =item * |
424 | ||
584e761d | 425 | C<Unicode::Collate> has been upgraded from 0.63 to 0.66 |
028d3bfa | 426 | |
584e761d | 427 | This release newly adds locales C<ja> C<ko> and C<zh> and its variants |
028d3bfa CBW |
428 | ( C<zh__big5han>, C<zh__gb2312han>, C<zh__pinyin>, C<zh__stroke> ). |
429 | ||
430 | The following modules have been added: | |
539ce3d8 | 431 | |
028d3bfa CBW |
432 | C<Unicode::Collate::CJK::Big5> for C<zh__big5han> which makes |
433 | tailoring of CJK Unified Ideographs in the order of CLDR's big5han ordering. | |
434 | ||
435 | C<Unicode::Collate::CJK::GB2312> for C<zh__gb2312han> which makes | |
436 | tailoring of CJK Unified Ideographs in the order of CLDR's gb2312han ordering. | |
437 | ||
584e761d CBW |
438 | C<Unicode::Collate::CJK::JISX0208> which makes tailoring of 6355 kanji |
439 | (CJK Unified Ideographs) in the JIS X 0208 order. | |
440 | ||
441 | C<Unicode::Collate::CJK::Korean> which makes tailoring of CJK Unified Ideographs | |
442 | in the order of CLDR's Korean ordering. | |
443 | ||
028d3bfa CBW |
444 | C<Unicode::Collate::CJK::Pinyin> for C<zh__pinyin> which makes |
445 | tailoring of CJK Unified Ideographs in the order of CLDR's pinyin ordering. | |
446 | ||
447 | C<Unicode::Collate::CJK::Stroke> for C<zh__stroke> which makes | |
448 | tailoring of CJK Unified Ideographs in the order of CLDR's stroke ordering. | |
449 | ||
8f97a47a | 450 | =back |
dfa4c013 | 451 | |
8f97a47a | 452 | =head2 Removed Modules and Pragmata |
c02ee425 | 453 | |
8f97a47a | 454 | =over 4 |
1393fe00 CBW |
455 | |
456 | =item * | |
457 | ||
8f97a47a | 458 | XXX |
c9a84c8b | 459 | |
8f97a47a | 460 | =back |
918184d1 | 461 | |
8f97a47a | 462 | =head1 Documentation |
918184d1 | 463 | |
8f97a47a TM |
464 | XXX Changes to files in F<pod/> go here. Consider grouping entries by |
465 | file and be sure to link to the appropriate page, e.g. L<perlfunc>. | |
918184d1 | 466 | |
570c3caa | 467 | L<perlvar> reorders the variables and groups them by topic. Each variable |
468 | introduced after Perl 5.000 notes the first version in which it is | |
469 | available. L<perlvar> also has a new section for deprecated variables to | |
470 | note when they were removed. | |
471 | ||
8f97a47a | 472 | =head2 New Documentation |
dca41e57 | 473 | |
8f97a47a | 474 | XXX Changes which create B<new> files in F<pod/> go here. |
dca41e57 | 475 | |
8f97a47a | 476 | =head3 L<XXX> |
c9a84c8b | 477 | |
8f97a47a | 478 | XXX Description of the purpose of the new file here |
4c793fe3 | 479 | |
ee0887a9 | 480 | =head2 Changes to Existing Documentation |
fc1418b7 | 481 | |
8f97a47a TM |
482 | XXX Changes which significantly change existing files in F<pod/> go here. |
483 | However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics> | |
484 | section. | |
485 | ||
7eb82171 DG |
486 | =over |
487 | ||
48ea5431 FC |
488 | =item * |
489 | ||
a5e71717 | 490 | Array and hash slices in scalar context are now documented in L<perldata>. |
48ea5431 | 491 | |
b293762b FC |
492 | =item * |
493 | ||
494 | L<perlform> and L<perllocale> have been corrected to state that | |
495 | C<use locale> affects formats. | |
496 | ||
7eb82171 DG |
497 | =back |
498 | ||
8f97a47a | 499 | =head3 L<XXX> |
e2babdfb | 500 | |
7bc3efda SH |
501 | =over 4 |
502 | ||
503 | =item * | |
504 | ||
8f97a47a | 505 | XXX Description of the change here |
7bc3efda SH |
506 | |
507 | =back | |
e2babdfb | 508 | |
4c793fe3 FR |
509 | =head1 Diagnostics |
510 | ||
511 | The following additions or changes have been made to diagnostic output, | |
512 | including warnings and fatal error messages. For the complete list of | |
513 | diagnostic messages, see L<perldiag>. | |
514 | ||
8f97a47a TM |
515 | XXX New or changed warnings emitted by the core's C<C> code go here. Also |
516 | include any changes in L<perldiag> that reconcile it to the C<C> code. | |
4c793fe3 | 517 | |
8f97a47a | 518 | [ Within each section, list entries as a =item entry ] |
4c793fe3 | 519 | |
8f97a47a | 520 | =head2 New Diagnostics |
4c793fe3 | 521 | |
8f97a47a | 522 | XXX Newly added diagnostic messages go here |
dc08898c FC |
523 | |
524 | =over 4 | |
525 | ||
526 | =item * | |
527 | ||
15bc3b4f FC |
528 | "Using !~ with %s doesn't make sense": This message was actually added in |
529 | 5.13.2, but was omitted from perldelta. It now applies also to the C<y///> | |
530 | operator, and has been documented. | |
dc08898c FC |
531 | |
532 | =back | |
533 | ||
8f97a47a | 534 | =head2 Changes to Existing Diagnostics |
4c793fe3 | 535 | |
8f97a47a | 536 | XXX Changes (i.e. rewording) of diagnostic messages go here |
0c692eed | 537 | |
ee0887a9 | 538 | =over 4 |
0c692eed FR |
539 | |
540 | =item * | |
541 | ||
8f97a47a | 542 | XXX |
4c793fe3 FR |
543 | |
544 | =back | |
545 | ||
8f97a47a | 546 | =head1 Utility Changes |
810f3b7c | 547 | |
8f97a47a TM |
548 | XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go |
549 | here. Most of these are built within the directories F<utils> and F<x2p>. | |
a9e68e41 | 550 | |
8f97a47a TM |
551 | [ List utility changes as a =head3 entry for each utility and =item |
552 | entries for each change | |
553 | Use L<XXX> with program names to get proper documentation linking. ] | |
a9e68e41 | 554 | |
8f97a47a | 555 | =head3 L<XXX> |
85318b69 | 556 | |
ee0887a9 | 557 | =over 4 |
80b6a949 | 558 | |
e2babdfb FR |
559 | =item * |
560 | ||
8f97a47a | 561 | XXX |
9ae8c3d9 | 562 | |
ee0887a9 | 563 | =back |
e2babdfb | 564 | |
8f97a47a | 565 | =head1 Configuration and Compilation |
e2babdfb | 566 | |
8f97a47a TM |
567 | XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools |
568 | go here. Any other changes to the Perl build process should be listed here. | |
569 | However, any platform-specific changes should be listed in the | |
570 | L</Platform Support> section, instead. | |
346e4e56 | 571 | |
8f97a47a | 572 | [ List changes as a =item entry ]. |
78846812 | 573 | |
8f97a47a | 574 | =over 4 |
e54f3f30 FC |
575 | |
576 | =item * | |
577 | ||
8f97a47a | 578 | XXX |
e54f3f30 | 579 | |
8f97a47a | 580 | =back |
a5763045 | 581 | |
8f97a47a | 582 | =head1 Testing |
5a9a79a4 | 583 | |
8f97a47a TM |
584 | XXX Any significant changes to the testing of a freshly built perl should be |
585 | listed here. Changes which create B<new> files in F<t/> go here as do any | |
586 | large changes to the testing harness (e.g. when parallel testing was added). | |
587 | Changes to existing files in F<t/> aren't worth summarising, although the bugs | |
588 | that they represent may be covered elsewhere. | |
5a9a79a4 | 589 | |
8f97a47a | 590 | [ List each test improvement as a =item entry ] |
a7e93501 | 591 | |
8f97a47a | 592 | =over 4 |
a7e93501 FC |
593 | |
594 | =item * | |
595 | ||
15bc3b4f FC |
596 | F<t/mro/isarev.t> has been added, which tests that C<PL_isarev> (accessible |
597 | at the Perl level via C<mro::get_isarev>) is updated properly. | |
598 | ||
599 | =item | |
600 | ||
601 | F<t/run/switchd-78586.t> has been added, which tests that | |
602 | L<[perl #78586]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78586> | |
603 | has been fixed (related to line numbers in the debbuger). | |
a7e93501 | 604 | |
8f97a47a | 605 | =back |
a7e93501 | 606 | |
8f97a47a | 607 | =head1 Platform Support |
a7e93501 | 608 | |
8f97a47a | 609 | XXX Any changes to platform support should be listed in the sections below. |
a7e93501 | 610 | |
8f97a47a TM |
611 | [ Within the sections, list each platform as a =item entry with specific |
612 | changes as paragraphs below it. ] | |
a7e93501 | 613 | |
8f97a47a | 614 | =head2 New Platforms |
d4a59e54 | 615 | |
8f97a47a TM |
616 | XXX List any platforms that this version of perl compiles on, that previous |
617 | versions did not. These will either be enabled by new files in the F<hints/> | |
618 | directories, or new subdirectories and F<README> files at the top level of the | |
619 | source tree. | |
d4a59e54 | 620 | |
8f97a47a | 621 | =over 4 |
dc08898c | 622 | |
8f97a47a | 623 | =item XXX-some-platform |
dc08898c | 624 | |
8f97a47a | 625 | XXX |
dc08898c | 626 | |
8f97a47a | 627 | =back |
6904a83f | 628 | |
8f97a47a | 629 | =head2 Discontinued Platforms |
6904a83f | 630 | |
8f97a47a | 631 | XXX List any platforms that this version of perl no longer compiles on. |
6904a83f | 632 | |
8f97a47a | 633 | =over 4 |
cffb3698 | 634 | |
8f97a47a | 635 | =item XXX-some-platform |
ab4c2c27 | 636 | |
8f97a47a | 637 | XXX |
ab4c2c27 | 638 | |
8f97a47a | 639 | =back |
be1cc451 | 640 | |
8f97a47a | 641 | =head2 Platform-Specific Notes |
be1cc451 | 642 | |
8f97a47a TM |
643 | XXX List any changes for specific platforms. This could include configuration |
644 | and compilation changes or changes in portability/compatibility. However, | |
645 | changes within modules for platforms should generally be listed in the | |
646 | L</Modules and Pragmata> section. | |
b20c4ee1 | 647 | |
8f97a47a | 648 | =over 4 |
b20c4ee1 | 649 | |
b293762b | 650 | =item Windows |
afa74577 | 651 | |
b293762b FC |
652 | Directory handles are now properly cloned when threads are created. In perl |
653 | 5.13.6, child threads simply stopped inheriting directory handles. In | |
654 | previous versions, threads would share handles, resulting in crashes. | |
afa74577 | 655 | |
8f97a47a | 656 | =back |
c8bbf675 | 657 | |
8f97a47a | 658 | =head1 Internal Changes |
c8bbf675 | 659 | |
8f97a47a TM |
660 | XXX Changes which affect the interface available to C<XS> code go here. |
661 | Other significant internal changes for future core maintainers should | |
662 | be noted as well. | |
07d5f7aa | 663 | |
8f97a47a | 664 | [ List each test improvement as a =item entry ] |
07d5f7aa | 665 | |
8f97a47a | 666 | =over 4 |
07d5f7aa | 667 | |
9ae8c3d9 FC |
668 | =item * |
669 | ||
b7bd32cc FC |
670 | C<lex_start> has been added to the API, but is considered experimental. |
671 | ||
672 | =item * | |
673 | ||
674 | A new C<parse_block> function has been added to the API | |
675 | L<[perl #78222]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78222>. | |
676 | ||
677 | =item * | |
678 | ||
c678e617 | 679 | A new, experimental API has been added for accessing the internal |
b7bd32cc FC |
680 | structure that Perl uses for C<%^H>. See the functions beginning with |
681 | C<cophh_> in L<perlapi>. | |
9ae8c3d9 | 682 | |
a5e71717 FC |
683 | =item * |
684 | ||
685 | A stash can now have a list of effective names in addition to its usual | |
8ff01ef0 FC |
686 | name. The first effective name can be accessed via the C<HvENAME> macro, |
687 | which is now the recommended name to use in MRO linearisations (C<HvNAME> | |
688 | being a fallback if there is no C<HvENAME>). | |
689 | ||
690 | These names are added and deleted via C<hv_ename_add> and | |
691 | C<hv_ename_delete>. These two functions are I<not> part of the API. | |
a5e71717 | 692 | |
b293762b FC |
693 | =item * |
694 | ||
695 | The way the parser handles labels has been cleaned up and refactored. As a | |
696 | result, the C<newFOROP()> constructor function no longer takes a parameter | |
697 | stating what label is to go in the state op. | |
698 | ||
699 | =item * | |
700 | ||
701 | The C<newWHILEOP()> and C<newFOROP()> functions no longer accept a line | |
702 | number as a parameter. | |
703 | ||
704 | =item * | |
705 | ||
706 | A new C<parse_barestmt()> function has been added, for parsing a statement | |
707 | without a label. | |
708 | ||
709 | =item * | |
710 | ||
711 | A new C<parse_label()> function has been added, that parses a statement | |
712 | labels, separate from statements. | |
713 | ||
714 | =item * | |
715 | ||
716 | The C<CvSTASH()> macro can now only be used as an rvalue. C<CvSTASH_set()> | |
717 | has been added to replace assignment to C<CvSTASH()>. This is to ensure | |
718 | that backreferences are handled properly. These macros are not part of the | |
719 | API. | |
720 | ||
721 | =item * | |
722 | ||
723 | The C<op_scope()> and C<op_lvalue()> functions have been added to the API, | |
724 | but are considered experimental. | |
725 | ||
8f97a47a | 726 | =back |
825563b9 | 727 | |
8f97a47a | 728 | =head1 Selected Bug Fixes |
825563b9 | 729 | |
8f97a47a TM |
730 | XXX Important bug fixes in the core language are summarised here. |
731 | Bug fixes in files in F<ext/> and F<lib/> are best summarised in | |
732 | L</Modules and Pragmata>. | |
825563b9 | 733 | |
8f97a47a | 734 | [ List each fix as a =item entry ] |
825563b9 | 735 | |
8f97a47a | 736 | =over 4 |
825563b9 | 737 | |
020fe755 AB |
738 | =item * |
739 | ||
b7bd32cc FC |
740 | The C<parse_stmt> C function added in earlier in the 5.13.x series has been |
741 | fixed to work with statements ending with C<}> | |
742 | L<[perl #78222]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78222>. | |
743 | ||
744 | =item * | |
745 | ||
746 | The C<parse_fullstmt> C function added in 5.13.5 has been fixed to work | |
747 | when called while an expression is being parsed. | |
748 | ||
749 | =item * | |
750 | ||
751 | Characters in the Latin-1 non-ASCII range (0x80 to 0xFF) used not to match | |
752 | themselves if the string happened to be UTF8-encoded internally, the | |
753 | regular expression was not, and the character in the regular expression was | |
754 | inside a repeated group (e.g., | |
c678e617 | 755 | C<Encode::decode_utf8("\303\200") =~ /(\xc0)+/>) |
b7bd32cc FC |
756 | L<[perl #78464]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78464>. |
757 | ||
758 | =item * | |
759 | ||
760 | The C<(?d)> regular expression construct now overrides a previous C<(?u)> | |
761 | or C<use feature "unicode_string"> | |
762 | L<[perl #78508]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78508>. | |
763 | ||
764 | =item * | |
765 | ||
766 | A memory leak in C<do "file">, introduced in perl 5.13.6, has been fixed | |
767 | L<[perl #78488]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78488>. | |
020fe755 | 768 | |
b293762b FC |
769 | =item * |
770 | ||
771 | Various bugs related to typeglob dereferencing have been fixed. See | |
772 | L</Dereferencing typeglobs>, above. | |
773 | ||
774 | =item * | |
775 | ||
776 | The C<SvPVbyte> function available to XS modules now calls magic before | |
777 | downgrading the SV, to avoid warnings about wide characters | |
778 | L<[perl #72398]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=72398>. | |
779 | ||
780 | =item * | |
781 | ||
782 | The C<=> operator used to ignore magic (e.g., tie methods) on its | |
783 | right-hand side if the scalar happened to hold a typeglob. This could | |
784 | happen if a typeglob was the last thing returned from or assigned to a tied | |
785 | scalar | |
786 | L<[perl #77498]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=77498>. | |
787 | ||
788 | =item * | |
789 | ||
790 | C<sprintf> was ignoring locales when called with constant arguments | |
791 | L<[perl #78632]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78632>. | |
792 | ||
9b7c43ba KW |
793 | =item * |
794 | ||
795 | A non-ASCII character in the Latin-1 range could match both a Posix | |
796 | class, such as C<[[:alnum:]]>, and its inverse C<[[:^alnum:]]>. This is | |
797 | now fixed for regular expressions compiled under the C<"u"> modifier. | |
798 | See L</C<use feature "unicode_strings"> now applies to more regex matching>. | |
799 | L<[perl #18281]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=18281>. | |
800 | ||
8ff01ef0 FC |
801 | =item * |
802 | ||
803 | Concatenating long strings under C<use encoding> no longer causes perl to | |
804 | crash | |
805 | L<[perl #78674]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78674>. | |
806 | ||
807 | =item * | |
808 | ||
809 | Typeglob assignments would crash if the glob's stash no longer existed, if | |
810 | the glob assigned to was named 'ISA' or the glob on either side of the | |
811 | assignment contained a subroutine. | |
812 | ||
813 | =item * | |
814 | ||
815 | Calling C<< ->import >> on a class lacking an import method could corrupt the stack result in strange behaviour. For instance, | |
816 | ||
817 | push @a, "foo", $b = bar->import; | |
818 | ||
819 | would assign 'foo' to C<$b> | |
820 | L<[perl #63790]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=63790>. | |
821 | ||
822 | =item * | |
823 | ||
824 | Creating an alias to a package when that package had been detached from the | |
825 | symbol table would result in corrupted isa caches | |
826 | L<[perl #77358]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=77358>. | |
827 | ||
828 | =item * | |
829 | ||
830 | C<.=> followed by C<< <> >> or C<readline> would leak memory if C<$/> | |
831 | contained characters beyond the octet range and the scalar assigned to | |
832 | happened to be encoded as UTF8 internally | |
833 | L<[perl #72246]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=72246>. | |
834 | ||
835 | =item * | |
836 | ||
837 | The C<recv> function could crash when called with the MSG_TRUNC flag | |
838 | L<[perl #75082]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=75082>. | |
839 | ||
9e2ac5d4 FC |
840 | =item * |
841 | ||
842 | Evaluating a simple glob (like C<*a>) was calling get-magic on the glob, | |
843 | even when its contents were not being used | |
844 | L<[perl #78580]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78580>. | |
845 | ||
846 | This bug was introduced in 5.13.2 and did not affect earlier perl versions. | |
847 | ||
15bc3b4f FC |
848 | =item * |
849 | ||
850 | Matching a Unicode character against an alternation containing characters | |
851 | that happened to match continuation bytes in the former's UTF8 | |
852 | representation (C<qq{\x{30ab}} =~ /\xab|\xa9/>) would cause erroneous | |
853 | warnings | |
854 | L<[perl #70998]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=70998>. | |
855 | ||
856 | =item * | |
857 | ||
858 | C<s///r> (added in 5.13.2) no longer leaks. | |
859 | ||
8f97a47a | 860 | =back |
020fe755 | 861 | |
8f97a47a | 862 | =head1 Known Problems |
020fe755 | 863 | |
8f97a47a TM |
864 | XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any |
865 | tests that had to be C<TODO>ed for the release would be noted here, unless | |
866 | they were specific to a particular platform (see below). | |
62ff64ce | 867 | |
8f97a47a TM |
868 | This is a list of some significant unfixed bugs, which are regressions |
869 | from either 5.XXX.XXX or 5.XXX.XXX. | |
62ff64ce | 870 | |
8f97a47a | 871 | [ List each fix as a =item entry ] |
62ff64ce | 872 | |
8f97a47a | 873 | =over 4 |
62ff64ce FC |
874 | |
875 | =item * | |
876 | ||
8f97a47a | 877 | XXX |
62ff64ce | 878 | |
4c793fe3 FR |
879 | =back |
880 | ||
8f97a47a | 881 | =head1 Obituary |
405fd67e | 882 | |
8f97a47a TM |
883 | XXX If any significant core contributor has died, we've added a short obituary |
884 | here. | |
405fd67e | 885 | |
dd56ec38 DG |
886 | Randy Kobes, creator of the kobesearch alternative to search.cpan.org and |
887 | contributor/maintainer to several core Perl toolchain modules, passed away | |
67fa491b | 888 | on September 18, 2010 after a battle with lung cancer. His contributions |
dd56ec38 DG |
889 | to the Perl community will be missed. |
890 | ||
ee0887a9 | 891 | =head1 Acknowledgements |
0195fb5f | 892 | |
8f97a47a | 893 | XXX The list of people to thank goes here. |
4c793fe3 FR |
894 | |
895 | =head1 Reporting Bugs | |
896 | ||
897 | If you find what you think is a bug, you might check the articles | |
898 | recently posted to the comp.lang.perl.misc newsgroup and the perl | |
899 | bug database at http://rt.perl.org/perlbug/ . There may also be | |
900 | information at http://www.perl.org/ , the Perl Home Page. | |
901 | ||
902 | If you believe you have an unreported bug, please run the B<perlbug> | |
903 | program included with your release. Be sure to trim your bug down | |
904 | to a tiny but sufficient test case. Your bug report, along with the | |
905 | output of C<perl -V>, will be sent off to perlbug@perl.org to be | |
906 | analysed by the Perl porting team. | |
907 | ||
908 | If the bug you are reporting has security implications, which make it | |
909 | inappropriate to send to a publicly archived mailing list, then please send | |
ee0887a9 | 910 | it to perl5-security-report@perl.org. This points to a closed subscription |
4c793fe3 FR |
911 | unarchived mailing list, which includes all the core committers, who be able |
912 | to help assess the impact of issues, figure out a resolution, and help | |
913 | co-ordinate the release of patches to mitigate or fix the problem across all | |
ee0887a9 | 914 | platforms on which Perl is supported. Please only use this address for |
4c793fe3 FR |
915 | security issues in the Perl core, not for modules independently |
916 | distributed on CPAN. | |
917 | ||
918 | =head1 SEE ALSO | |
919 | ||
920 | The F<Changes> file for an explanation of how to view exhaustive details | |
921 | on what changed. | |
922 | ||
923 | The F<INSTALL> file for how to build Perl. | |
924 | ||
925 | The F<README> file for general stuff. | |
926 | ||
927 | The F<Artistic> and F<Copying> files for copyright information. | |
928 | ||
929 | =cut |