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