This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Move ANYOF folding from regexec to regcomp
[perl5.git] / pod / perldelta.pod
CommitLineData
3a5c9134
CBW
1=encoding utf8
2
3=head1 NAME
4
d17f3dbc
JV
5[ this is a template for a new perldelta file. Any text flagged as
6XXX needs to be processed before release. ]
15e6cdd9 7
d17f3dbc 8perldelta - what is new for perl v5.13.10
0d157ee2 9
d17f3dbc 10=head1 DESCRIPTION
b16cfc56 11
d17f3dbc
JV
12This document describes differences between the 5.XXX.XXX release and
13the 5.XXX.XXX release.
3a5c9134 14
d17f3dbc
JV
15If you are upgrading from an earlier release such as 5.YYY.YYY, first read
16L<perl5YYYdelta>, which describes differences between 5.ZZZ.ZZZ and
175.YYY.YYY.
d4560299 18
d17f3dbc 19=head1 Notice
d4560299 20
d17f3dbc 21XXX Any important notices here
d4560299 22
d17f3dbc 23=head1 Core Enhancements
d4560299 24
d17f3dbc
JV
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.
2638c0ff 28
d17f3dbc 29[ List each enhancement as a =head2 entry ]
2638c0ff 30
9e9ca9d7
KW
31=head2 Add C<\p{Titlecase}> as a synonym for C<\p{Title}>
32
33This synyom is added for symmetry with the Unicode property names
34C<\p{Uppercase}> and C<\p{Lowercase}>.
35
36
d17f3dbc 37=head1 Security
17096837 38
d17f3dbc
JV
39XXX Any security-related notices go here. In particular, any security
40vulnerabilities closed should be noted here rather than in the
41L</Selected Bug Fixes> section.
e1165778 42
d17f3dbc 43[ List each security issue as a =head2 entry ]
17096837 44
d17f3dbc 45=head1 Incompatible Changes
935c8d19 46
d17f3dbc 47XXX For a release on a stable branch, this section aspires to be:
a3ab329f 48
d17f3dbc
JV
49 There are no changes intentionally incompatible with 5.XXX.XXX. If any
50 exist, they are bugs and reports are welcome.
a3ab329f 51
d17f3dbc 52[ List each incompatible change as a =head2 entry ]
6def3600 53
56ca34ca
KW
54=head2 Most C<\p{}> properties are now immune from case-insensitive matching
55
56For most Unicode properties, it doesn't make sense to have them match
57differently under C</i> case-insensitive matching than not. And doing
58so leads to unexpected results and potential security holes. For
59example
60
61 m/\p{ASCII_Hex_Digit}+/i
62
63could previously match non-ASCII characters because of the Unicode
64matching rules. There were a number of bugs in this feature until an
65earlier release in the 5.13 series. Now this release reverts, and
66removes the feature completely except for the few properties where
67people have come to expect it, namely the ones where casing is an
68integral part of their functionality, such as C<m/\p{Uppercase}/i> and
69C<m/\p{Lowercase}/i>, both of which match the exact same code points,
70namely those matched by C<m/\p{Cased}/i>. Details are in
71L<perlrecharclass/Unicode Properties>.
72
73User-defined property handlers that need to match differently under
74C</i> must change to read the new boolean parameter passed it which is
75non-zero if case-insensitive matching is in effect; 0 if not. See
76L<perluniprops/User-Defined Character Properties>.
77
d17f3dbc 78=head1 Deprecations
6def3600 79
d17f3dbc
JV
80XXX Any deprecated features, syntax, modules etc. should be listed here.
81In particular, deprecated modules should be listed here even if they are
82listed as an updated module in the L</Modules and Pragmata> section.
e8b333e6 83
d17f3dbc 84[ List each deprecation as a =head2 entry ]
e8b333e6 85
d17f3dbc 86=head1 Performance Enhancements
935c8d19 87
d17f3dbc
JV
88XXX Changes which enhance performance without changing behaviour go here. There
89may well be none in a stable release.
e1165778 90
d17f3dbc 91[ List each enhancement as a =item entry ]
f295f417 92
9f7a72d0 93=over 4
17096837 94
f295f417
FC
95=item *
96
d17f3dbc 97XXX
9c88a88b 98
d17f3dbc 99=back
9c88a88b 100
d17f3dbc 101=head1 Modules and Pragmata
b16cfc56 102
d17f3dbc
JV
103XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
104go here. If Module::CoreList is updated, generate an initial draft of the
105following sections using F<Porting/corelist-perldelta.pl>, which prints stub
106entries to STDOUT. Results can be pasted in place of the '=head2' entries
107below. A paragraph summary for important changes should then be added by hand.
108In an ideal world, dual-life modules would have a F<Changes> file that could be
109cribbed.
b16cfc56 110
d17f3dbc 111[ Within each section, list entries as a =item entry ]
8e1e0801 112
d17f3dbc 113=head2 New Modules and Pragmata
8e1e0801 114
d17f3dbc 115=over 4
4df1dffa
FC
116
117=item *
118
d17f3dbc 119XXX
4df1dffa 120
d17f3dbc 121=back
f5d41534 122
d17f3dbc 123=head2 Updated Modules and Pragmata
f5d41534 124
d17f3dbc 125=over 4
f5d41534
CBW
126
127=item *
128
f4c5852c
CBW
129C<CGI> has been upgraded from version 3.51 to 3.52
130
131=item *
132
f7f926be
CBW
133C<IPC::Cmd> has been upgraded from version 0.68 to 0.70
134
135=item *
136
7cf8bfc0
DG
137C<Module::Build> has been upgraded from version 0.3607 to 0.3622.
138
139A notable change is the deprecation of several modules.
140Module::Build::Version has been deprecated and Module::Build now relies
141directly upon L<version>. Module::Build::ModuleInfo has been deprecated in
142favor of a standalone copy of it called L<Module::Metadata>.
143Module::Build::YAML has been deprecated in favor of L<CPAN::Meta::YAML>.
144
145=item *
146
f58b9ef1
CBW
147C<Unicode::Collate> has been upgraded from version 0.68 to 0.72
148
149This also sees the switch from using the pure-perl version of this
150module to the XS version.`
151
152=item *
153
d17f3dbc 154XXX
17096837 155
d17f3dbc 156=back
788ba0f4 157
d17f3dbc 158=head2 Removed Modules and Pragmata
98d645a7 159
d17f3dbc 160=over 4
98d645a7 161
7abec982
FC
162=item *
163
d17f3dbc 164XXX
7abec982 165
9f7a72d0 166=back
e1165778 167
9f7a72d0 168=head1 Documentation
17096837 169
d17f3dbc
JV
170XXX Changes to files in F<pod/> go here. Consider grouping entries by
171file and be sure to link to the appropriate page, e.g. L<perlfunc>.
b16cfc56 172
d17f3dbc 173=head2 New Documentation
b16cfc56 174
d17f3dbc 175XXX Changes which create B<new> files in F<pod/> go here.
b16cfc56 176
d17f3dbc 177=head3 L<XXX>
b16cfc56 178
d17f3dbc 179XXX Description of the purpose of the new file here
b16cfc56 180
d17f3dbc 181=head2 Changes to Existing Documentation
b16cfc56 182
d17f3dbc
JV
183XXX Changes which significantly change existing files in F<pod/> go here.
184However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
185section.
b16cfc56 186
d17f3dbc 187=head3 L<XXX>
d4238815 188
9f7a72d0 189=over 4
17096837 190
d4238815
FC
191=item *
192
d17f3dbc 193XXX Description of the change here
e1165778 194
9f7a72d0 195=back
17096837 196
9f7a72d0 197=head1 Diagnostics
17096837 198
9f7a72d0
Z
199The following additions or changes have been made to diagnostic output,
200including warnings and fatal error messages. For the complete list of
201diagnostic messages, see L<perldiag>.
e1165778 202
d17f3dbc
JV
203XXX New or changed warnings emitted by the core's C<C> code go here. Also
204include any changes in L<perldiag> that reconcile it to the C<C> code.
205
206[ Within each section, list entries as a =item entry ]
207
9f7a72d0 208=head2 New Diagnostics
3a5c9134 209
d17f3dbc
JV
210XXX Newly added diagnostic messages go here
211
9f7a72d0 212=over 4
17096837 213
c2e0289e
FC
214=item *
215
d17f3dbc 216XXX
17096837 217
9f7a72d0 218=back
e6f1cc4d 219
9f7a72d0 220=head2 Changes to Existing Diagnostics
e1165778 221
d17f3dbc
JV
222XXX Changes (i.e. rewording) of diagnostic messages go here
223
9f7a72d0 224=over 4
17096837 225
e1165778
Z
226=item *
227
d17f3dbc 228XXX
17096837 229
3a5c9134
CBW
230=back
231
9f7a72d0 232=head1 Utility Changes
e1165778 233
d17f3dbc
JV
234XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
235here. Most of these are built within the directories F<utils> and F<x2p>.
e1165778 236
d17f3dbc
JV
237[ List utility changes as a =head3 entry for each utility and =item
238entries for each change
239Use L<XXX> with program names to get proper documentation linking. ]
e1165778 240
d17f3dbc 241=head3 L<XXX>
b16cfc56
JV
242
243=over 4
244
245=item *
246
d17f3dbc 247XXX
b16cfc56
JV
248
249=back
250
d17f3dbc 251=head1 Configuration and Compilation
3a5c9134 252
d17f3dbc
JV
253XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
254go here. Any other changes to the Perl build process should be listed here.
255However, any platform-specific changes should be listed in the
256L</Platform Support> section, instead.
b16cfc56 257
d17f3dbc 258[ List changes as a =item entry ].
b16cfc56 259
d17f3dbc 260=over 4
3a5c9134 261
b16cfc56
JV
262=item *
263
d17f3dbc 264XXX
b16cfc56 265
d17f3dbc 266=back
b16cfc56 267
d17f3dbc 268=head1 Testing
b16cfc56 269
d17f3dbc
JV
270XXX Any significant changes to the testing of a freshly built perl should be
271listed here. Changes which create B<new> files in F<t/> go here as do any
272large changes to the testing harness (e.g. when parallel testing was added).
273Changes to existing files in F<t/> aren't worth summarising, although the bugs
274that they represent may be covered elsewhere.
b16cfc56 275
d17f3dbc 276[ List each test improvement as a =item entry ]
b16cfc56 277
d17f3dbc 278=over 4
b16cfc56
JV
279
280=item *
281
d17f3dbc 282XXX
b16cfc56 283
3a5c9134
CBW
284=back
285
9f7a72d0 286=head1 Platform Support
3a5c9134 287
d17f3dbc 288XXX Any changes to platform support should be listed in the sections below.
b16cfc56 289
d17f3dbc
JV
290[ Within the sections, list each platform as a =item entry with specific
291changes as paragraphs below it. ]
b16cfc56 292
d17f3dbc 293=head2 New Platforms
3a5c9134 294
d17f3dbc
JV
295XXX List any platforms that this version of perl compiles on, that previous
296versions did not. These will either be enabled by new files in the F<hints/>
297directories, or new subdirectories and F<README> files at the top level of the
298source tree.
3a5c9134 299
9f7a72d0 300=over 4
3a5c9134 301
d17f3dbc 302=item XXX-some-platform
b16cfc56 303
d17f3dbc 304XXX
b16cfc56 305
d17f3dbc 306=back
b16cfc56 307
d17f3dbc 308=head2 Discontinued Platforms
b16cfc56 309
d17f3dbc 310XXX List any platforms that this version of perl no longer compiles on.
b16cfc56 311
d17f3dbc 312=over 4
b16cfc56 313
d17f3dbc 314=item XXX-some-platform
b16cfc56 315
d17f3dbc 316XXX
b16cfc56
JV
317
318=back
319
d17f3dbc 320=head2 Platform-Specific Notes
b16cfc56 321
d17f3dbc
JV
322XXX List any changes for specific platforms. This could include configuration
323and compilation changes or changes in portability/compatibility. However,
324changes within modules for platforms should generally be listed in the
325L</Modules and Pragmata> section.
3a5c9134 326
9f7a72d0 327=over 4
3a5c9134 328
347ee86f 329=item Windows
c61b6d0f 330
347ee86f
TC
331=over 4
332
333=item *
334
335The C<test-prep> build target now depends on F<pod/perltoc.pod> to allow the
336F<t/porting/buildtoc.t> test to run successfully.
337
338=back
6d4f9cf2 339
d17f3dbc 340=back
a62b1201 341
d17f3dbc 342=head1 Internal Changes
a62b1201 343
d17f3dbc
JV
344XXX Changes which affect the interface available to C<XS> code go here.
345Other significant internal changes for future core maintainers should
346be noted as well.
b030240b 347
d17f3dbc 348[ List each test improvement as a =item entry ]
b030240b 349
d17f3dbc 350=over 4
b16cfc56 351
4dc93f40
JV
352=item *
353
d17f3dbc 354XXX
b16cfc56 355
3a5c9134
CBW
356=back
357
358=head1 Selected Bug Fixes
359
d17f3dbc
JV
360XXX Important bug fixes in the core language are summarised here.
361Bug fixes in files in F<ext/> and F<lib/> are best summarised in
362L</Modules and Pragmata>.
0c7420e7 363
d17f3dbc 364[ List each fix as a =item entry ]
0c7420e7 365
d17f3dbc 366=over 4
f3fe4ed7 367
712ef7ca
FC
368=item *
369
e40e74fe
KW
370A Unicode C<\p{}> property match in a regular rexpression pattern will
371now force Unicode rules for the rest of the regular expression
712ef7ca 372
d17f3dbc 373=back
ecede56a 374
d17f3dbc 375=head1 Known Problems
ecede56a 376
d17f3dbc
JV
377XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
378tests that had to be C<TODO>ed for the release would be noted here, unless
379they were specific to a particular platform (see below).
ecede56a 380
d17f3dbc
JV
381This is a list of some significant unfixed bugs, which are regressions
382from either 5.XXX.XXX or 5.XXX.XXX.
d4560299 383
d17f3dbc 384[ List each fix as a =item entry ]
d4560299 385
d17f3dbc 386=over 4
d4560299 387
7db1267d
KW
388=item *
389
d17f3dbc 390XXX
7db1267d 391
9f7a72d0 392=back
460c4bfb 393
d17f3dbc 394=head1 Obituary
836d5805 395
d17f3dbc
JV
396XXX If any significant core contributor has died, we've added a short obituary
397here.
3a5c9134 398
9f7a72d0 399=head1 Acknowledgements
b0c3724f 400
d17f3dbc 401XXX The list of people to thank goes here.
3a5c9134
CBW
402
403=head1 Reporting Bugs
404
405If you find what you think is a bug, you might check the articles
406recently posted to the comp.lang.perl.misc newsgroup and the perl
407bug database at http://rt.perl.org/perlbug/ . There may also be
408information at http://www.perl.org/ , the Perl Home Page.
409
410If you believe you have an unreported bug, please run the L<perlbug>
411program included with your release. Be sure to trim your bug down
412to a tiny but sufficient test case. Your bug report, along with the
413output of C<perl -V>, will be sent off to perlbug@perl.org to be
414analysed by the Perl porting team.
415
416If the bug you are reporting has security implications, which make it
417inappropriate to send to a publicly archived mailing list, then please send
418it to perl5-security-report@perl.org. This points to a closed subscription
419unarchived mailing list, which includes all the core committers, who be able
420to help assess the impact of issues, figure out a resolution, and help
421co-ordinate the release of patches to mitigate or fix the problem across all
422platforms on which Perl is supported. Please only use this address for
423security issues in the Perl core, not for modules independently
424distributed on CPAN.
425
426=head1 SEE ALSO
427
428The F<Changes> file for an explanation of how to view exhaustive details
429on what changed.
430
431The F<INSTALL> file for how to build Perl.
432
433The F<README> file for general stuff.
434
435The F<Artistic> and F<Copying> files for copyright information.
436
437=cut