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