Commit | Line | Data |
---|---|---|
44691e6f AB |
1 | =encoding utf8 |
2 | ||
3 | =head1 NAME | |
4 | ||
0aaeb177 SH |
5 | [ this is a template for a new perldelta file. Any text flagged as |
6 | XXX needs to be processed before release. ] | |
760696b8 | 7 | |
0aaeb177 | 8 | perldelta - what is new for perl v5.15.6 |
062678b2 | 9 | |
0aaeb177 | 10 | =head1 DESCRIPTION |
ad32999b | 11 | |
0aaeb177 SH |
12 | This document describes differences between the 5.15.5 release and |
13 | the 5.15.6 release. | |
ad32999b | 14 | |
0aaeb177 SH |
15 | If you are upgrading from an earlier release such as 5.15.4, first read |
16 | L<perl5155delta>, which describes differences between 5.15.4 and | |
17 | 5.15.5. | |
ad32999b | 18 | |
0aaeb177 | 19 | =head1 Notice |
ad32999b | 20 | |
0aaeb177 | 21 | XXX Any important notices here |
ad32999b | 22 | |
0aaeb177 | 23 | =head1 Core Enhancements |
a3f52e2e | 24 | |
0aaeb177 SH |
25 | XXX New core language features go here. Summarise user-visible core language |
26 | enhancements. Particularly prominent performance optimisations could go | |
27 | here, but most should go in the L</Performance Enhancements> section. | |
a3f52e2e | 28 | |
0aaeb177 | 29 | [ List each enhancement as a =head2 entry ] |
6d110ad0 | 30 | |
e3c71926 | 31 | =head1 Security |
6d110ad0 | 32 | |
0aaeb177 SH |
33 | XXX Any security-related notices go here. In particular, any security |
34 | vulnerabilities closed should be noted here rather than in the | |
35 | L</Selected Bug Fixes> section. | |
6d110ad0 | 36 | |
0aaeb177 | 37 | [ List each security issue as a =head2 entry ] |
6d110ad0 | 38 | |
e3c71926 | 39 | =head1 Incompatible Changes |
6d110ad0 | 40 | |
0aaeb177 | 41 | XXX For a release on a stable branch, this section aspires to be: |
ad32999b | 42 | |
0aaeb177 SH |
43 | There are no changes intentionally incompatible with 5.XXX.XXX |
44 | If any exist, they are bugs and reports are welcome. | |
ad32999b | 45 | |
0aaeb177 | 46 | [ List each incompatible change as a =head2 entry ] |
ad32999b | 47 | |
e3c71926 | 48 | =head1 Deprecations |
6d110ad0 | 49 | |
0aaeb177 SH |
50 | XXX Any deprecated features, syntax, modules etc. should be listed here. |
51 | In particular, deprecated modules should be listed here even if they are | |
52 | listed as an updated module in the L</Modules and Pragmata> section. | |
ae92a9ae | 53 | |
0aaeb177 | 54 | [ List each deprecation as a =head2 entry ] |
ae92a9ae | 55 | |
e3c71926 | 56 | =head1 Performance Enhancements |
6d110ad0 | 57 | |
0aaeb177 SH |
58 | XXX Changes which enhance performance without changing behaviour go here. There |
59 | may well be none in a stable release. | |
60 | ||
61 | [ List each enhancement as a =item entry ] | |
62 | ||
e3c71926 | 63 | =over 4 |
6d110ad0 FC |
64 | |
65 | =item * | |
66 | ||
0aaeb177 | 67 | XXX |
6d110ad0 | 68 | |
e3c71926 | 69 | =back |
6d110ad0 | 70 | |
e3c71926 | 71 | =head1 Modules and Pragmata |
6d110ad0 | 72 | |
0aaeb177 SH |
73 | XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/> |
74 | go here. If Module::CoreList is updated, generate an initial draft of the | |
75 | following sections using F<Porting/corelist-perldelta.pl>, which prints stub | |
76 | entries to STDOUT. Results can be pasted in place of the '=head2' entries | |
77 | below. A paragraph summary for important changes should then be added by hand. | |
78 | In an ideal world, dual-life modules would have a F<Changes> file that could be | |
79 | cribbed. | |
80 | ||
81 | [ Within each section, list entries as a =item entry ] | |
82 | ||
e3c71926 | 83 | =head2 New Modules and Pragmata |
6d110ad0 | 84 | |
e3c71926 | 85 | =over 4 |
6d110ad0 FC |
86 | |
87 | =item * | |
88 | ||
0aaeb177 | 89 | XXX |
6d110ad0 FC |
90 | |
91 | =back | |
92 | ||
e3c71926 | 93 | =head2 Updated Modules and Pragmata |
6d110ad0 | 94 | |
e3c71926 | 95 | =over 4 |
6d110ad0 FC |
96 | |
97 | =item * | |
98 | ||
f8c9502f CBW |
99 | L<Archive::Tar> has been upgraded from version 1.80 to version 1.82. |
100 | ||
101 | Adjustments to handle files >8gb (>0777777777777 octal) and a feature to | |
102 | return the MD5SUM of files in the archive. | |
a3f52e2e | 103 | |
87b9431e CBW |
104 | =item * |
105 | ||
106 | L<Compress::Raw::Zlib> has been upgraded from version 2.042 to version 2.043. | |
107 | ||
7e700369 CBW |
108 | =item * |
109 | ||
110 | L<Compress::Raw::Bzip2> has been upgraded from version 2.042 to version 2.043. | |
111 | ||
dc7edc5c CBW |
112 | =item * |
113 | ||
114 | L<IO::Compress::Base> has been upgraded from version 2.042 to version 2.043. | |
115 | ||
7788a270 CBW |
116 | =item * |
117 | ||
118 | L<Unicode::Collate> has been upgraded from version 0.85 to version 0.86. | |
119 | ||
120 | Tailored compatibility ideographs as well as unified ideographs for | |
121 | the locales: ja, ko, zh__big5han, zh__gb2312han, zh__pinyin, zh__stroke. | |
122 | ||
0aaeb177 | 123 | =back |
6138a722 | 124 | |
0aaeb177 | 125 | =head2 Removed Modules and Pragmata |
6138a722 | 126 | |
0aaeb177 | 127 | =over 4 |
be539103 | 128 | |
a47fb3fe CBW |
129 | =item * |
130 | ||
0aaeb177 | 131 | XXX |
a3f52e2e | 132 | |
0aaeb177 | 133 | =back |
a3f52e2e | 134 | |
0aaeb177 | 135 | =head1 Documentation |
a3f52e2e | 136 | |
0aaeb177 SH |
137 | XXX Changes to files in F<pod/> go here. Consider grouping entries by |
138 | file and be sure to link to the appropriate page, e.g. L<perlfunc>. | |
a3f52e2e | 139 | |
0aaeb177 | 140 | =head2 New Documentation |
ad32999b | 141 | |
0aaeb177 | 142 | XXX Changes which create B<new> files in F<pod/> go here. |
ad32999b | 143 | |
0aaeb177 | 144 | =head3 L<XXX> |
ad32999b | 145 | |
0aaeb177 | 146 | XXX Description of the purpose of the new file here |
6138a722 | 147 | |
0aaeb177 | 148 | =head2 Changes to Existing Documentation |
6138a722 | 149 | |
0aaeb177 SH |
150 | XXX Changes which significantly change existing files in F<pod/> go here. |
151 | However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics> | |
152 | section. | |
a47fb3fe | 153 | |
0aaeb177 | 154 | =head3 L<XXX> |
a47fb3fe | 155 | |
0aaeb177 | 156 | =over 4 |
7ef25837 | 157 | |
6d110ad0 FC |
158 | =item * |
159 | ||
0aaeb177 | 160 | XXX Description of the change here |
6d110ad0 FC |
161 | |
162 | =back | |
163 | ||
e3c71926 FR |
164 | =head1 Diagnostics |
165 | ||
166 | The following additions or changes have been made to diagnostic output, | |
167 | including warnings and fatal error messages. For the complete list of | |
168 | diagnostic messages, see L<perldiag>. | |
6d110ad0 | 169 | |
0aaeb177 SH |
170 | XXX New or changed warnings emitted by the core's C<C> code go here. Also |
171 | include any changes in L<perldiag> that reconcile it to the C<C> code. | |
6138a722 | 172 | |
0aaeb177 SH |
173 | [ Within each section, list entries as a =item entry that links to perldiag, |
174 | e.g. | |
6138a722 | 175 | |
0aaeb177 | 176 | =item * |
6138a722 | 177 | |
0aaeb177 SH |
178 | L<Invalid version object|perldiag/"Invalid version object"> |
179 | ] | |
6138a722 | 180 | |
0aaeb177 | 181 | =head2 New Diagnostics |
828d6195 | 182 | |
0aaeb177 | 183 | XXX Newly added diagnostic messages go here |
83307084 | 184 | |
0aaeb177 | 185 | =head3 New Errors |
d39de893 | 186 | |
3432e5a1 | 187 | =over 4 |
39afdc5a CBW |
188 | |
189 | =item * | |
190 | ||
0aaeb177 | 191 | XXX L<message|perldiag/"message"> |
6138a722 | 192 | |
e3c71926 | 193 | =back |
7b8e5ef0 | 194 | |
0aaeb177 | 195 | =head3 New Warnings |
91710846 | 196 | |
e3c71926 | 197 | =over 4 |
91710846 DG |
198 | |
199 | =item * | |
200 | ||
0aaeb177 | 201 | XXX L<message|perldiag/"message"> |
f81e39ef | 202 | |
e3c71926 | 203 | =back |
a2fa999d | 204 | |
0aaeb177 SH |
205 | =head2 Changes to Existing Diagnostics |
206 | ||
207 | XXX Changes (i.e. rewording) of diagnostic messages go here | |
bd65daab | 208 | |
e3c71926 | 209 | =over 4 |
bd65daab | 210 | |
3f2cb5bf S |
211 | =item * |
212 | ||
0aaeb177 | 213 | XXX Describe change here |
b420b12a | 214 | |
3432e5a1 | 215 | =back |
b420b12a | 216 | |
0aaeb177 | 217 | =head1 Utility Changes |
9cfd094e | 218 | |
0aaeb177 SH |
219 | XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go |
220 | here. Most of these are built within the directories F<utils> and F<x2p>. | |
95f7e41f | 221 | |
0aaeb177 SH |
222 | [ List utility changes as a =head3 entry for each utility and =item |
223 | entries for each change | |
224 | Use L<XXX> with program names to get proper documentation linking. ] | |
95f7e41f | 225 | |
0aaeb177 | 226 | =head3 L<XXX> |
d6cf2367 | 227 | |
e3c71926 | 228 | =over 4 |
b53e16ae FC |
229 | |
230 | =item * | |
231 | ||
0aaeb177 | 232 | XXX |
b53e16ae | 233 | |
3432e5a1 | 234 | =back |
60092ce4 | 235 | |
0aaeb177 SH |
236 | =head1 Configuration and Compilation |
237 | ||
238 | XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools | |
239 | go here. Any other changes to the Perl build process should be listed here. | |
240 | However, any platform-specific changes should be listed in the | |
241 | L</Platform Support> section, instead. | |
242 | ||
243 | [ List changes as a =item entry ]. | |
309aab3a | 244 | |
e3c71926 | 245 | =over 4 |
b53e16ae FC |
246 | |
247 | =item * | |
248 | ||
0aaeb177 | 249 | XXX |
a3f52e2e | 250 | |
0aaeb177 | 251 | =back |
a3f52e2e | 252 | |
0aaeb177 | 253 | =head1 Testing |
a3f52e2e | 254 | |
0aaeb177 SH |
255 | XXX Any significant changes to the testing of a freshly built perl should be |
256 | listed here. Changes which create B<new> files in F<t/> go here as do any | |
257 | large changes to the testing harness (e.g. when parallel testing was added). | |
258 | Changes to existing files in F<t/> aren't worth summarising, although the bugs | |
259 | that they represent may be covered elsewhere. | |
a3f52e2e | 260 | |
0aaeb177 | 261 | [ List each test improvement as a =item entry ] |
a3f52e2e | 262 | |
0aaeb177 | 263 | =over 4 |
a3f52e2e FC |
264 | |
265 | =item * | |
266 | ||
0aaeb177 | 267 | XXX |
a3f52e2e | 268 | |
0aaeb177 | 269 | =back |
a3f52e2e | 270 | |
0aaeb177 | 271 | =head1 Platform Support |
a3f52e2e | 272 | |
0aaeb177 | 273 | XXX Any changes to platform support should be listed in the sections below. |
a3f52e2e | 274 | |
0aaeb177 SH |
275 | [ Within the sections, list each platform as a =item entry with specific |
276 | changes as paragraphs below it. ] | |
a3f52e2e | 277 | |
0aaeb177 | 278 | =head2 New Platforms |
a3f52e2e | 279 | |
0aaeb177 SH |
280 | XXX List any platforms that this version of perl compiles on, that previous |
281 | versions did not. These will either be enabled by new files in the F<hints/> | |
282 | directories, or new subdirectories and F<README> files at the top level of the | |
283 | source tree. | |
a3f52e2e | 284 | |
0aaeb177 | 285 | =over 4 |
a3f52e2e | 286 | |
0aaeb177 | 287 | =item XXX-some-platform |
a3f52e2e | 288 | |
0aaeb177 | 289 | XXX |
a3f52e2e | 290 | |
0aaeb177 | 291 | =back |
a3f52e2e | 292 | |
0aaeb177 | 293 | =head2 Discontinued Platforms |
ca955add | 294 | |
0aaeb177 | 295 | XXX List any platforms that this version of perl no longer compiles on. |
bbdd8bad | 296 | |
0aaeb177 | 297 | =over 4 |
bbdd8bad | 298 | |
0aaeb177 | 299 | =item XXX-some-platform |
ad32999b | 300 | |
0aaeb177 | 301 | XXX |
ad32999b | 302 | |
0aaeb177 | 303 | =back |
ad32999b | 304 | |
0aaeb177 | 305 | =head2 Platform-Specific Notes |
ad32999b | 306 | |
0aaeb177 SH |
307 | XXX List any changes for specific platforms. This could include configuration |
308 | and compilation changes or changes in portability/compatibility. However, | |
309 | changes within modules for platforms should generally be listed in the | |
310 | L</Modules and Pragmata> section. | |
ad32999b | 311 | |
0aaeb177 | 312 | =over 4 |
ad32999b | 313 | |
0aaeb177 | 314 | =item XXX-some-platform |
ad32999b | 315 | |
0aaeb177 | 316 | XXX |
ad32999b | 317 | |
0aaeb177 | 318 | =back |
ad32999b | 319 | |
0aaeb177 | 320 | =head1 Internal Changes |
ad32999b | 321 | |
0aaeb177 SH |
322 | XXX Changes which affect the interface available to C<XS> code go here. |
323 | Other significant internal changes for future core maintainers should | |
324 | be noted as well. | |
ad32999b | 325 | |
0aaeb177 | 326 | [ List each change as a =item entry ] |
ad32999b | 327 | |
0aaeb177 | 328 | =over 4 |
ad32999b | 329 | |
3973654e FC |
330 | =item * |
331 | ||
0aaeb177 | 332 | XXX |
3973654e | 333 | |
0aaeb177 | 334 | =back |
cca38fda | 335 | |
0aaeb177 | 336 | =head1 Selected Bug Fixes |
9c7c1651 | 337 | |
0aaeb177 SH |
338 | XXX Important bug fixes in the core language are summarised here. |
339 | Bug fixes in files in F<ext/> and F<lib/> are best summarised in | |
340 | L</Modules and Pragmata>. | |
9c7c1651 | 341 | |
0aaeb177 | 342 | [ List each fix as a =item entry ] |
fce59cd4 | 343 | |
0aaeb177 | 344 | =over 4 |
fce59cd4 | 345 | |
b9e83cd1 FC |
346 | =item * |
347 | ||
0aaeb177 | 348 | XXX |
b9e83cd1 | 349 | |
0aaeb177 | 350 | =back |
bf19b80e | 351 | |
0aaeb177 | 352 | =head1 Known Problems |
bf19b80e | 353 | |
0aaeb177 SH |
354 | XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any |
355 | tests that had to be C<TODO>ed for the release would be noted here, unless | |
356 | they were specific to a particular platform (see below). | |
65b66aa9 | 357 | |
0aaeb177 SH |
358 | This is a list of some significant unfixed bugs, which are regressions |
359 | from either 5.XXX.XXX or 5.XXX.XXX. | |
65b66aa9 | 360 | |
0aaeb177 | 361 | [ List each fix as a =item entry ] |
b53e16ae | 362 | |
0aaeb177 | 363 | =over 4 |
b53e16ae | 364 | |
7c864bb3 VP |
365 | =item * |
366 | ||
0aaeb177 | 367 | XXX |
7c864bb3 | 368 | |
63ac71b9 | 369 | =back |
bbc28bfc | 370 | |
0aaeb177 | 371 | =head1 Obituary |
8fe05716 | 372 | |
0aaeb177 SH |
373 | XXX If any significant core contributor has died, we've added a short obituary |
374 | here. | |
8fe05716 | 375 | |
0aaeb177 | 376 | =head1 Acknowledgements |
8fe05716 | 377 | |
0aaeb177 | 378 | XXX Generate this with: |
8fe05716 | 379 | |
0aaeb177 | 380 | perl Porting/acknowledgements.pl v5.15.5..HEAD |
29cf780c | 381 | |
44691e6f AB |
382 | =head1 Reporting Bugs |
383 | ||
384 | If you find what you think is a bug, you might check the articles | |
34dc2ec0 | 385 | recently posted to the comp.lang.perl.misc newsgroup and the perl |
44691e6f AB |
386 | bug database at http://rt.perl.org/perlbug/ . There may also be |
387 | information at http://www.perl.org/ , the Perl Home Page. | |
388 | ||
389 | If you believe you have an unreported bug, please run the L<perlbug> | |
390 | program included with your release. Be sure to trim your bug down | |
391 | to a tiny but sufficient test case. Your bug report, along with the | |
392 | output of C<perl -V>, will be sent off to perlbug@perl.org to be | |
393 | analysed by the Perl porting team. | |
394 | ||
395 | If the bug you are reporting has security implications, which make it | |
396 | inappropriate to send to a publicly archived mailing list, then please send | |
34dc2ec0 | 397 | it to perl5-security-report@perl.org. This points to a closed subscription |
b4707b2a FC |
398 | unarchived mailing list, which includes |
399 | all the core committers, who will be able | |
44691e6f AB |
400 | to help assess the impact of issues, figure out a resolution, and help |
401 | co-ordinate the release of patches to mitigate or fix the problem across all | |
34dc2ec0 DM |
402 | platforms on which Perl is supported. Please only use this address for |
403 | security issues in the Perl core, not for modules independently | |
44691e6f AB |
404 | distributed on CPAN. |
405 | ||
406 | =head1 SEE ALSO | |
407 | ||
408 | The F<Changes> file for an explanation of how to view exhaustive details | |
409 | on what changed. | |
410 | ||
411 | The F<INSTALL> file for how to build Perl. | |
412 | ||
413 | The F<README> file for general stuff. | |
414 | ||
415 | The F<Artistic> and F<Copying> files for copyright information. | |
416 | ||
417 | =cut |