pod/perldelta.pod

   1 =encoding utf8
   2
   3 =head1 NAME
   4
   5 [ this is a template for a new perldelta file. Any text flagged as
   6 XXX needs to be processed before release. ]
   7
   8 perldelta - what is new for perl v5.13.6
   9
  10 =head1 DESCRIPTION
  11
  12 This document describes differences between the 5.13.5 release and
  13 the 5.13.6 release.
  14
  15 If you are upgrading from an earlier release such as 5.13.4, first read
  16 L<perl5135delta>, which describes differences between 5.13.4 and
  17 5.13.5.
  18
  19 =head1 Notice
  20
  21 XXX Any important notices here
  22
  23 =head1 Core Enhancements
  24
  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.
  28
  29 [ List each enhancement as a =head2 entry ]
  30
  31 =head2  C<(?^...)> regex construct added to signify default modifiers
  32
  33 A caret (also called a "cirumflex accent") C<"^"> immediately following
  34 a C<"(?"> in a regular expression now means that the subexpression is to
  35 not inherit the surrounding modifiers such as C</i>, but to revert to the
  36 Perl defaults.  Any modifiers following the caret override the defaults.
  37
  38 The stringification of regular expressions now uses this notation.  The
  39 main purpose of this is to allow tests that rely on the stringification
  40 to not have to change when new modifiers are added.  See
  41 L<perlre/Extended Patterns>.
  42
  43 =head2 C<"d">, C<"l">, and C<"u"> regex modifiers added
  44
  45 These modifiers are currently only available within a C<(?...)> construct.
  46
  47 The C<"l"> modifier says to compile the regular expression as if it were
  48 in the scope of C<use locale>, even if it is not.
  49
  50 The C<"u"> modifier currently does nothing.
  51
  52 The C<"d"> modifier is used in the scope of C<use locale> to compile the
  53 regular expression as if it were not in that scope.
  54 See L<perlre/(?dlupimsx-imsx)>.
  55
  56 =head1 Security
  57
  58 XXX Any security-related notices go here.  In particular, any security
  59 vulnerabilities closed should be noted here rather than in the
  60 L</Selected Bug Fixes> section.
  61
  62 [ List each security issue as a =head2 entry ]
  63
  64 =head1 Incompatible Changes
  65
  66 =head2 Stringification of regexes has changed
  67
  68 Default regular expression modifiers are now notated by using
  69 C<(?^...)>.  Code relying on the old stringification will fail.  The
  70 purpose of this is so that when new modifiers are added, such code will
  71 not have to change, as the stringification will automatically
  72 incorporate the new modifiers.
  73
  74 Code that needs to work properly with both old- and new-style regexes
  75 can use something like the following:
  76
  77     # Accept both old and new-style stringification
  78     my $modifiers = (qr/foobar/ =~ /\Q(?^/) ? '^' : '-xism';
  79
  80 And then use C<$modifiers> instead of C<-xism>.
  81
  82 =head2 Regular expressions retain their localeness when interpolated
  83
  84 Regular expressions compiled under C<"use locale"> now retain this when
  85 interpolated into a new regular expression compiled outside a
  86 C<"use locale">, and vice-versa.
  87
  88 Previously, a regular expression interpolated into another one inherited
  89 the localeness of the surrounding one, losing whatever state it
  90 originally had.  This is considered a bug fix, but may trip up code that
  91 has come to rely on the incorrect behavior.
  92
  93 [ List each incompatible change as a =head2 entry ]
  94
  95 =head1 Deprecations
  96
  97 XXX Any deprecated features, syntax, modules etc. should be listed here.
  98 In particular, deprecated modules should be listed here even if they are
  99 listed as an updated module in the L</Modules and Pragmata> section.
 100
 101 [ List each deprecation as a =head2 entry ]
 102
 103 =head1 Performance Enhancements
 104
 105 XXX Changes which enhance performance without changing behaviour go here. There
 106 may well be none in a stable release.
 107
 108 [ List each enhancement as a =item entry ]
 109
 110 =over 4
 111
 112 =item *
 113
 114 XXX
 115
 116 =back
 117
 118 =head1 Modules and Pragmata
 119
 120 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
 121 go here.  If Module::CoreList is updated, generate an initial draft of the
 122 following sections using F<Porting/corelist-perldelta.pl>, which prints stub
 123 entries to STDOUT.  Results can be pasted in place of the '=head2' entries
 124 below.  A paragraph summary for important changes should then be added by hand.
 125 In an ideal world, dual-life modules would have a F<Changes> file that could be
 126 cribbed.
 127
 128 [ Within each section, list entries as a =item entry ]
 129
 130 =head2 New Modules and Pragmata
 131
 132 =over 4
 133
 134 =item *
 135
 136 XXX
 137
 138 =back
 139
 140 =head2 Updated Modules and Pragmata
 141
 142 =over 4
 143
 144 =item *
 145
 146 C<File::DosGlob> has been upgraded from version 1.02 to 1.03.
 147
 148 It allows patterns containing literal parentheses (they no longer need to
 149 be escaped). On Windows, it no longer adds an extra F<./> to the file names
 150 returned when the pattern is a relative glob with a drive specification,
 151 like F<c:*.pl>.
 152
 153 =item *
 154
 155 C<File::Find> has been upgraded from version 1.17 to 1.18.
 156
 157 It improves handling of backslashes on Windows, so that paths such as
 158 F<c:\dir\/file> are no longer generated.
 159
 160 =item *
 161
 162 C<NEXT> has been upgraded from version 0.64 to 0.65.
 163
 164 =item *
 165
 166 C<PathTools> has been upgraded from version 3.31_01 to 3.33.
 167
 168 =item *
 169
 170 C<Unicode::Collate> has been upgraded from version 0.59 to 0.60
 171
 172 =item *
 173
 174 C<Unicode::Normalize> has been upgraded from version 1.06 to 1.07
 175
 176 =back
 177
 178 =head2 Removed Modules and Pragmata
 179
 180 =over 4
 181
 182 =item *
 183
 184 XXX
 185
 186 =back
 187
 188 =head1 Documentation
 189
 190 XXX Changes to files in F<pod/> go here.  Consider grouping entries by
 191 file and be sure to link to the appropriate page, e.g. L<perlfunc>.
 192
 193 =head2 New Documentation
 194
 195 XXX Changes which create B<new> files in F<pod/> go here.
 196
 197 =head3 L<XXX>
 198
 199 XXX Description of the purpose of the new file here
 200
 201 =head2 Changes to Existing Documentation
 202
 203 XXX Changes which significantly change existing files in F<pod/> go here.
 204 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
 205 section.
 206
 207 =head3 L<XXX>
 208
 209 =over 4
 210
 211 =item *
 212
 213 XXX Description of the change here
 214
 215 =back
 216
 217 =head1 Diagnostics
 218
 219 The following additions or changes have been made to diagnostic output,
 220 including warnings and fatal error messages.  For the complete list of
 221 diagnostic messages, see L<perldiag>.
 222
 223 XXX New or changed warnings emitted by the core's C<C> code go here. Also
 224 include any changes in L<perldiag> that reconcile it to the C<C> code.
 225
 226 [ Within each section, list entries as a =item entry ]
 227
 228 =head2 New Diagnostics
 229
 230 XXX Newly added diagnostic messages go here
 231
 232 =over 4
 233
 234 =item *
 235
 236 XXX
 237
 238 =back
 239
 240 =head2 Changes to Existing Diagnostics
 241
 242 XXX Changes (i.e. rewording) of diagnostic messages go here
 243
 244 =over 4
 245
 246 =item *
 247
 248 XXX
 249
 250 =back
 251
 252 =head1 Utility Changes
 253
 254 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
 255 here. Most of these are built within the directories F<utils> and F<x2p>.
 256
 257 [ List utility changes as a =head3 entry for each utility and =item
 258 entries for each change
 259 Use L<XXX> with program names to get proper documentation linking. ]
 260
 261 =head3 L<XXX>
 262
 263 =over 4
 264
 265 =item *
 266
 267 XXX
 268
 269 =back
 270
 271 =head1 Configuration and Compilation
 272
 273 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
 274 go here.  Any other changes to the Perl build process should be listed here.
 275 However, any platform-specific changes should be listed in the
 276 L</Platform Support> section, instead.
 277
 278 [ List changes as a =item entry ].
 279
 280 =over 4
 281
 282 =item *
 283
 284 XXX
 285
 286 =back
 287
 288 =head1 Testing
 289
 290 XXX Any significant changes to the testing of a freshly built perl should be
 291 listed here.  Changes which create B<new> files in F<t/> go here as do any
 292 large changes to the testing harness (e.g. when parallel testing was added).
 293 Changes to existing files in F<t/> aren't worth summarising, although the bugs
 294 that they represent may be covered elsewhere.
 295
 296 [ List each test improvement as a =item entry ]
 297
 298 =over 4
 299
 300 =item *
 301
 302 XXX
 303
 304 =back
 305
 306 =head1 Platform Support
 307
 308 XXX Any changes to platform support should be listed in the sections below.
 309
 310 [ Within the sections, list each platform as a =item entry with specific
 311 changes as paragraphs below it. ]
 312
 313 =head2 New Platforms
 314
 315 XXX List any platforms that this version of perl compiles on, that previous
 316 versions did not. These will either be enabled by new files in the F<hints/>
 317 directories, or new subdirectories and F<README> files at the top level of the
 318 source tree.
 319
 320 =over 4
 321
 322 =item XXX-some-platform
 323
 324 XXX
 325
 326 =back
 327
 328 =head2 Discontinued Platforms
 329
 330 XXX List any platforms that this version of perl no longer compiles on.
 331
 332 =over 4
 333
 334 =item XXX-some-platform
 335
 336 XXX
 337
 338 =back
 339
 340 =head2 Platform-Specific Notes
 341
 342 XXX List any changes for specific platforms. This could include configuration
 343 and compilation changes or changes in portability/compatibility.  However,
 344 changes within modules for platforms should generally be listed in the
 345 L</Modules and Pragmata> section.
 346
 347 =over 4
 348
 349 =item XXX-some-platform
 350
 351 XXX
 352
 353 =back
 354
 355 =head1 Internal Changes
 356
 357 XXX Changes which affect the interface available to C<XS> code go here.
 358 Other significant internal changes for future core maintainers should
 359 be noted as well.
 360
 361 [ List each test improvement as a =item entry ]
 362
 363 =over 4
 364
 365 =item *
 366
 367 See L</Regular expressions retain their localeness when interpolated>,
 368 above.
 369
 370 =back
 371
 372 =head1 Selected Bug Fixes
 373
 374 XXX Important bug fixes in the core language are summarised here.
 375 Bug fixes in files in F<ext/> and F<lib/> are best summarised in
 376 L</Modules and Pragmata>.
 377
 378 [ List each fix as a =item entry ]
 379
 380 =over 4
 381
 382 =item *
 383
 384 A regular expression match in the right-hand side of a global substitution
 385 (C<s///g>) that is in the same scope will no longer cause match variables
 386 to have the wrong values on subsequent iterations. This can happen when an
 387 array or hash subscript is interpolated in the right-hand side, as in
 388 C<s|(.)|@a{ print($1), /./ }|g>
 389 L<[perl #19078]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=19078>.
 390
 391 =item *
 392
 393 Constant-folding used to cause
 394
 395   $text =~ ( 1 ? /phoo/ : /bear/)
 396
 397 to turn into
 398
 399   $text =~ /phoo/
 400
 401 at compile time. Now it correctly matches against C<$_>
 402 L<[perl #20444]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=20444>.
 403
 404 =item *
 405
 406 Parsing Perl code (either with string C<eval> or by loading modules) from
 407 within a C<UNITCHECK> block no longer causes the interpreter to crash
 408 L<[perl #70614]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=70614>.
 409
 410 =item *
 411
 412 When C<-d> is used on the shebang (C<#!>) line, the debugger now has access
 413 to the lines of the main program. In the past, this sometimes worked and
 414 sometimes did not, depending on what order things happened to be arranged
 415 in memory.
 416
 417 =back
 418
 419 =head1 Known Problems
 420
 421 XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
 422 tests that had to be C<TODO>ed for the release would be noted here, unless
 423 they were specific to a particular platform (see below).
 424
 425 This is a list of some significant unfixed bugs, which are regressions
 426 from either 5.XXX.XXX or 5.XXX.XXX.
 427
 428 [ List each fix as a =item entry ]
 429
 430 =over 4
 431
 432 =item *
 433
 434 XXX
 435
 436 =back
 437
 438 =head1 Obituary
 439
 440 XXX If any significant core contributor has died, we've added a short obituary
 441 here.
 442
 443 =head1 Acknowledgements
 444
 445 XXX The list of people to thank goes here.
 446
 447 =head1 Reporting Bugs
 448
 449 If you find what you think is a bug, you might check the articles
 450 recently posted to the comp.lang.perl.misc newsgroup and the perl
 451 bug database at http://rt.perl.org/perlbug/ .  There may also be
 452 information at http://www.perl.org/ , the Perl Home Page.
 453
 454 If you believe you have an unreported bug, please run the B<perlbug>
 455 program included with your release.  Be sure to trim your bug down
 456 to a tiny but sufficient test case.  Your bug report, along with the
 457 output of C<perl -V>, will be sent off to perlbug@perl.org to be
 458 analysed by the Perl porting team.
 459
 460 If the bug you are reporting has security implications, which make it
 461 inappropriate to send to a publicly archived mailing list, then please send
 462 it to perl5-security-report@perl.org. This points to a closed subscription
 463 unarchived mailing list, which includes all the core committers, who be able
 464 to help assess the impact of issues, figure out a resolution, and help
 465 co-ordinate the release of patches to mitigate or fix the problem across all
 466 platforms on which Perl is supported. Please only use this address for
 467 security issues in the Perl core, not for modules independently
 468 distributed on CPAN.
 469
 470 =head1 SEE ALSO
 471
 472 The F<Changes> file for an explanation of how to view exhaustive details
 473 on what changed.
 474
 475 The F<INSTALL> file for how to build Perl.
 476
 477 The F<README> file for general stuff.
 478
 479 The F<Artistic> and F<Copying> files for copyright information.
 480
 481 =cut