pod/perldelta.pod

   1 =encoding utf8
   2
   3 =for comment
   4 This has been completed up to 94a75ecf, except for 1b9f127-fad448f, which
   5 Karl Williamson says he will do.
   6
   7 =head1 NAME
   8
   9 [ this is a template for a new perldelta file. Any text flagged as
  10 XXX needs to be processed before release. ]
  11
  12 perldelta - what is new for perl v5.13.8
  13
  14 =head1 DESCRIPTION
  15
  16 This document describes differences between the 5.13.8 release and
  17 the 5.13.7 release.
  18
  19 If you are upgrading from an earlier release such as 5.13.6, first read
  20 L<perl5137delta>, which describes differences between 5.13.6 and
  21 5.13.7.
  22
  23 =head1 Notice
  24
  25 XXX Any important notices here
  26
  27 =head1 Core Enhancements
  28
  29 XXX New core language features go here. Summarise user-visible core language
  30 enhancements. Particularly prominent performance optimisations could go
  31 here, but most should go in the L</Performance Enhancements> section.
  32
  33 [ List each enhancement as a =head2 entry ]
  34
  35 =head2 C<-d:-foo> calls C<Devel::foo::unimport>
  36
  37 The syntax C<-dI<B<:>foo>> was extended in 5.6.1 to make C<-dI<:fooB<=bar>>>
  38 equivalent to C<-MDevel::foo=bar>, which expands
  39 internally to C<use Devel::foo 'bar';>.
  40 F<perl> now allows prefixing the module name with C<->, with the same
  41 semantics as C<-M>, I<i.e.>
  42
  43 =over 4
  44
  45 =item C<-d:-foo>
  46
  47 Equivalent to C<-M-Devel::foo>, expands to
  48 C<no Devel::foo;>, calls C<< Devel::foo->unimport() >>
  49 if the method exists.
  50
  51 =item C<-d:-foo=bar>
  52
  53 Equivalent to C<-M-Devel::foo=bar>, expands to C<no Devel::foo 'bar';>,
  54 calls C<< Devel::foo->unimport('bar') >> if the method exists.
  55
  56 =back
  57
  58 This is particularly useful to suppresses the default actions of a
  59 C<Devel::*> module's C<import> method whilst still loading it for debugging.
  60
  61 =head1 Security
  62
  63 XXX Any security-related notices go here.  In particular, any security
  64 vulnerabilities closed should be noted here rather than in the
  65 L</Selected Bug Fixes> section.
  66
  67 [ List each security issue as a =head2 entry ]
  68
  69 =head1 Incompatible Changes
  70
  71 =head2 Attempting to use C<:=> as an empty attribute list is now a syntax error
  72
  73 Previously C<my $pi := 4;> was exactly equivalent to C<my $pi : = 4;>,
  74 with the C<:> being treated as the start of an attribute list, ending before
  75 the C<=>. The use of C<:=> to mean C<: => was deprecated in 5.12.0, and is now
  76 a syntax error. This will allow the future use of C<:=> as a new token.
  77
  78 We find no Perl 5 code on CPAN using this construction, outside the core's
  79 tests for it, so we believe that this change will have very little impact on
  80 real-world codebases.
  81
  82 If it is absolutely necessary to have empty attribute lists (for example,
  83 because of a code generator) then avoid the error by adding a space before
  84 the C<=>.
  85
  86 =head1 Deprecations
  87
  88 XXX Any deprecated features, syntax, modules etc. should be listed here.
  89 In particular, deprecated modules should be listed here even if they are
  90 listed as an updated module in the L</Modules and Pragmata> section.
  91
  92 [ List each deprecation as a =head2 entry ]
  93
  94 =head2 C<?PATTERN?> is deprecated
  95
  96 C<?PATTERN?> (without the initial m) has been deprecated and now produces
  97 a warning.
  98
  99 =head2 C<sv_compile_2op> is now deprecated
 100
 101 The C<sv_compile_2op> is now deprecated, and will be removed. Searches suggest
 102 that nothing on CPAN is using it, so this should have zero impact.
 103
 104 It attempted to provide an API to compile code down to an optree, but failed
 105 to bind correctly to lexicals in the enclosing scope. It's not possible to
 106 fix this problem within the constraints of its parameters and return value.
 107
 108 =head1 Performance Enhancements
 109
 110 XXX Changes which enhance performance without changing behaviour go here. There
 111 may well be none in a stable release.
 112
 113 [ List each enhancement as a =item entry ]
 114
 115 =over 4
 116
 117 =item *
 118
 119 XXX
 120
 121 =back
 122
 123 =head1 Modules and Pragmata
 124
 125 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
 126 go here.  If Module::CoreList is updated, generate an initial draft of the
 127 following sections using F<Porting/corelist-perldelta.pl>, which prints stub
 128 entries to STDOUT.  Results can be pasted in place of the '=head2' entries
 129 below.  A paragraph summary for important changes should then be added by hand.
 130 In an ideal world, dual-life modules would have a F<Changes> file that could be
 131 cribbed.
 132
 133 [ Within each section, list entries as a =item entry ]
 134
 135 =head2 New Modules and Pragmata
 136
 137 =over 4
 138
 139 =item *
 140
 141 XXX
 142
 143 =back
 144
 145 =head2 Updated Modules and Pragmata
 146
 147 =over 4
 148
 149 =item *
 150
 151 C<IPC::Cmd> has been upgraded from 0.64 to 0.66
 152
 153 Resolves an issue with splitting Win32 command lines
 154 and documentation enhancements.
 155
 156 =item *
 157
 158 C<MIME::Base64> has been upgraded from 3.10 to 3.13
 159
 160 Now provides encode_base64url and decode_base64url functions to process
 161 the base64 scheme for "URL applications".
 162
 163 =item *
 164
 165 C<overload> has been upgraded from 1.11 to 1.12.
 166
 167 =item *
 168
 169 C<PerlIO::scalar> has been upgraded from 0.10 to 0.11.
 170
 171 A C<read> after a C<seek> beyond the end of the string no longer thinks it
 172 has data to read
 173 L<[perl #78716]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78716>.
 174
 175 =item *
 176
 177 C<re> has been upgraded from 0.14 to 0.15.
 178
 179 =item *
 180
 181 C<Socket> has been upgraded from 1.91 to 1.92.
 182
 183 It has several new functions for handling IPv6 addresses.
 184
 185 =item *
 186
 187 C<Time::HiRes> has been upgraded from 1.9721 to 1.9721_01.
 188
 189 =item *
 190
 191 C<Unicode::Collate> has been upgraded from 0.67 to 0.68
 192
 193 =item *
 194
 195 C<Unicode::UCD> has been upgraded from 0.29 to 0.30.
 196
 197 =item *
 198
 199 C<version> has been upgraded from 0.82 to 0.86.
 200
 201 =back
 202
 203 =head2 Removed Modules and Pragmata
 204
 205 =over 4
 206
 207 =item *
 208
 209 XXX
 210
 211 =back
 212
 213 =head1 Documentation
 214
 215 XXX Changes to files in F<pod/> go here.  Consider grouping entries by
 216 file and be sure to link to the appropriate page, e.g. L<perlfunc>.
 217
 218 =head2 New Documentation
 219
 220 XXX Changes which create B<new> files in F<pod/> go here.
 221
 222 =head3 L<XXX>
 223
 224 XXX Description of the purpose of the new file here
 225
 226 =head2 Changes to Existing Documentation
 227
 228 XXX Changes which significantly change existing files in F<pod/> go here.
 229 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
 230 section.
 231
 232 =head3 L<XXX>
 233
 234 =over 4
 235
 236 =item *
 237
 238 XXX Description of the change here
 239
 240 =back
 241
 242 =head1 Diagnostics
 243
 244 The following additions or changes have been made to diagnostic output,
 245 including warnings and fatal error messages.  For the complete list of
 246 diagnostic messages, see L<perldiag>.
 247
 248 XXX New or changed warnings emitted by the core's C<C> code go here. Also
 249 include any changes in L<perldiag> that reconcile it to the C<C> code.
 250
 251 [ Within each section, list entries as a =item entry ]
 252
 253 =head2 New Diagnostics
 254
 255 XXX Newly added diagnostic messages go here
 256
 257 =over 4
 258
 259 =item *
 260
 261 XXX
 262
 263 =back
 264
 265 =head2 Changes to Existing Diagnostics
 266
 267 XXX Changes (i.e. rewording) of diagnostic messages go here
 268
 269 =over 4
 270
 271 =item *
 272
 273 XXX
 274
 275 =back
 276
 277 =head1 Utility Changes
 278
 279 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
 280 here. Most of these are built within the directories F<utils> and F<x2p>.
 281
 282 [ List utility changes as a =head3 entry for each utility and =item
 283 entries for each change
 284 Use L<XXX> with program names to get proper documentation linking. ]
 285
 286 =head3 L<XXX>
 287
 288 =over 4
 289
 290 =item *
 291
 292 XXX
 293
 294 =back
 295
 296 =head1 Configuration and Compilation
 297
 298 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
 299 go here.  Any other changes to the Perl build process should be listed here.
 300 However, any platform-specific changes should be listed in the
 301 L</Platform Support> section, instead.
 302
 303 [ List changes as a =item entry ].
 304
 305 =over 4
 306
 307 =item *
 308
 309 XXX
 310
 311 =back
 312
 313 =head1 Testing
 314
 315 XXX Any significant changes to the testing of a freshly built perl should be
 316 listed here.  Changes which create B<new> files in F<t/> go here as do any
 317 large changes to the testing harness (e.g. when parallel testing was added).
 318 Changes to existing files in F<t/> aren't worth summarising, although the bugs
 319 that they represent may be covered elsewhere.
 320
 321 [ List each test improvement as a =item entry ]
 322
 323 =over 4
 324
 325 =item *
 326
 327 XXX
 328
 329 =back
 330
 331 =head1 Platform Support
 332
 333 XXX Any changes to platform support should be listed in the sections below.
 334
 335 [ Within the sections, list each platform as a =item entry with specific
 336 changes as paragraphs below it. ]
 337
 338 =head2 New Platforms
 339
 340 XXX List any platforms that this version of perl compiles on, that previous
 341 versions did not. These will either be enabled by new files in the F<hints/>
 342 directories, or new subdirectories and F<README> files at the top level of the
 343 source tree.
 344
 345 =over 4
 346
 347 =item XXX-some-platform
 348
 349 XXX
 350
 351 =back
 352
 353 =head2 Discontinued Platforms
 354
 355 XXX List any platforms that this version of perl no longer compiles on.
 356
 357 =over 4
 358
 359 =item XXX-some-platform
 360
 361 XXX
 362
 363 =back
 364
 365 =head2 Platform-Specific Notes
 366
 367 XXX List any changes for specific platforms. This could include configuration
 368 and compilation changes or changes in portability/compatibility.  However,
 369 changes within modules for platforms should generally be listed in the
 370 L</Modules and Pragmata> section.
 371
 372 =over 4
 373
 374 =item XXX-some-platform
 375
 376 XXX
 377
 378 =back
 379
 380 =head1 Internal Changes
 381
 382 XXX Changes which affect the interface available to C<XS> code go here.
 383 Other significant internal changes for future core maintainers should
 384 be noted as well.
 385
 386 [ List each test improvement as a =item entry ]
 387
 388 =over 4
 389
 390 =item *
 391
 392 XXX
 393
 394 =back
 395
 396 =head1 Selected Bug Fixes
 397
 398 XXX Important bug fixes in the core language are summarised here.
 399 Bug fixes in files in F<ext/> and F<lib/> are best summarised in
 400 L</Modules and Pragmata>.
 401
 402 [ List each fix as a =item entry ]
 403
 404 =over 4
 405
 406 =item *
 407
 408 C<BEGIN {require 5.12.0}> now behaves as documented, rather than behaving
 409 identically to C<use 5.12.0;>. Previously, C<require> in a C<BEGIN> block
 410 was erroneously executing the C<use feature ':5.12.0'> and
 411 C<use strict; use warnings;> behaviour, which only C<use> was documented to
 412 provide
 413 L<[perl #69050]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=69050>.
 414
 415 =item *
 416
 417 C<use 5.42>
 418 L<[perl #69050]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=69050>,
 419 C<use 6> and C<no 5> no longer leak memory.
 420
 421 =item *
 422
 423 C<eval "BEGIN{die}"> no longer leaks memory on non-threaded builds.
 424
 425 =item *
 426
 427 PerlIO no longer crashes when called recursively, e.g., from a signal
 428 handler. Now it just leaks memory
 429 L<[perl #75556]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=75556>.
 430
 431 =item *
 432
 433 Defining a constant with the same name as one of perl's special blocks
 434 (e.g., INIT) stopped working in 5.12.0, but has now been fixed
 435 L<[perl #78634]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78634>.
 436
 437 =item *
 438
 439 A reference to a literal value used as a hash key (C<$hash{\"foo"}>) used
 440 to be stringified, even if the hash was tied
 441 L<[perl #79178]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=79178>.
 442
 443 =back
 444
 445 =head1 Known Problems
 446
 447 XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
 448 tests that had to be C<TODO>ed for the release would be noted here, unless
 449 they were specific to a particular platform (see below).
 450
 451 This is a list of some significant unfixed bugs, which are regressions
 452 from either 5.XXX.XXX or 5.XXX.XXX.
 453
 454 [ List each fix as a =item entry ]
 455
 456 =over 4
 457
 458 =item *
 459
 460 A number of bugs with regular expression bracketed character classes
 461 have been fixed, mostly having to do with matching characters in the
 462 non-ASCII Latin-1 range.
 463
 464 =back
 465
 466 =head1 Obituary
 467
 468 XXX If any significant core contributor has died, we've added a short obituary
 469 here.
 470
 471 =head1 Acknowledgements
 472
 473 XXX The list of people to thank goes here.
 474
 475 =head1 Reporting Bugs
 476
 477 If you find what you think is a bug, you might check the articles
 478 recently posted to the comp.lang.perl.misc newsgroup and the perl
 479 bug database at http://rt.perl.org/perlbug/ .  There may also be
 480 information at http://www.perl.org/ , the Perl Home Page.
 481
 482 If you believe you have an unreported bug, please run the L<perlbug>
 483 program included with your release.  Be sure to trim your bug down
 484 to a tiny but sufficient test case.  Your bug report, along with the
 485 output of C<perl -V>, will be sent off to perlbug@perl.org to be
 486 analysed by the Perl porting team.
 487
 488 If the bug you are reporting has security implications, which make it
 489 inappropriate to send to a publicly archived mailing list, then please send
 490 it to perl5-security-report@perl.org. This points to a closed subscription
 491 unarchived mailing list, which includes all the core committers, who be able
 492 to help assess the impact of issues, figure out a resolution, and help
 493 co-ordinate the release of patches to mitigate or fix the problem across all
 494 platforms on which Perl is supported. Please only use this address for
 495 security issues in the Perl core, not for modules independently
 496 distributed on CPAN.
 497
 498 =head1 SEE ALSO
 499
 500 The F<Changes> file for an explanation of how to view exhaustive details
 501 on what changed.
 502
 503 The F<INSTALL> file for how to build Perl.
 504
 505 The F<README> file for general stuff.
 506
 507 The F<Artistic> and F<Copying> files for copyright information.
 508
 509 =cut