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 XXX needs
   6 to be processed before release. ]
   7
   8 perldelta - what is new for perl v5.19.3
   9
  10 =head1 DESCRIPTION
  11
  12 This document describes differences between the 5.19.2 release and the 5.19.3
  13 release.
  14
  15 If you are upgrading from an earlier release such as 5.19.1, first read
  16 L<perl5192delta>, which describes differences between 5.19.1 and 5.19.2.
  17
  18 =head1 Notice
  19
  20 XXX Any important notices here
  21
  22 =head1 Core Enhancements
  23
  24 XXX New core language features go here.  Summarize user-visible core language
  25 enhancements.  Particularly prominent performance optimisations could go
  26 here, but most should go in the L</Performance Enhancements> section.
  27
  28 [ List each enhancement as a =head2 entry ]
  29
  30 =head2 B<-F> now implies B<-a> and B<-a> implies B<-n>
  31
  32 Previously B<-F> without B<-a> was a no-op, and B<-a> without B<-n> or
  33 B<-p> was a no-op, with this change, if you supply B<-F> then both
  34 B<-a> and B<-n> are implied and if you supply B<-a> then B<-n> is implied.
  35
  36 You can still use B<-p> for its extra behaviour. [perl #116190]
  37
  38 =head1 Security
  39
  40 XXX Any security-related notices go here.  In particular, any security
  41 vulnerabilities closed should be noted here rather than in the
  42 L</Selected Bug Fixes> section.
  43
  44 [ List each security issue as a =head2 entry ]
  45
  46 =head1 Incompatible Changes
  47
  48 XXX For a release on a stable branch, this section aspires to be:
  49
  50     There are no changes intentionally incompatible with 5.XXX.XXX
  51     If any exist, they are bugs, and we request that you submit a
  52     report.  See L</Reporting Bugs> below.
  53
  54 [ List each incompatible change as a =head2 entry ]
  55
  56 =head1 Deprecations
  57
  58 XXX Any deprecated features, syntax, modules etc. should be listed here.
  59
  60 =head2 Module removals
  61
  62 XXX Remove this section if inapplicable.
  63
  64 The following modules will be removed from the core distribution in a
  65 future release, and will at that time need to be installed from CPAN.
  66 Distributions on CPAN which require these modules will need to list them as
  67 prerequisites.
  68
  69 The core versions of these modules will now issue C<"deprecated">-category
  70 warnings to alert you to this fact.  To silence these deprecation warnings,
  71 install the modules in question from CPAN.
  72
  73 Note that these are (with rare exceptions) fine modules that you are encouraged
  74 to continue to use.  Their disinclusion from core primarily hinges on their
  75 necessity to bootstrapping a fully functional, CPAN-capable Perl installation,
  76 not usually on concerns over their design.
  77
  78 =over
  79
  80 XXX Note that deprecated modules should be listed here even if they are listed
  81 as an updated module in the L</Modules and Pragmata> section.
  82
  83 =back
  84
  85 [ List each other deprecation as a =head2 entry ]
  86
  87 =head1 Performance Enhancements
  88
  89 XXX Changes which enhance performance without changing behaviour go here.
  90 There may well be none in a stable release.
  91
  92 [ List each enhancement as a =item entry ]
  93
  94 =over 4
  95
  96 =item *
  97
  98 XXX
  99
 100 =back
 101
 102 =head1 Modules and Pragmata
 103
 104 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
 105 go here.  If Module::CoreList is updated, generate an initial draft of the
 106 following sections using F<Porting/corelist-perldelta.pl>, which prints stub
 107 entries to STDOUT.  Results can be pasted in place of the '=head2' entries
 108 below.  A paragraph summary for important changes should then be added by hand.
 109 In an ideal world, dual-life modules would have a F<Changes> file that could be
 110 cribbed.
 111
 112 [ Within each section, list entries as a =item entry ]
 113
 114 =head2 New Modules and Pragmata
 115
 116 =over 4
 117
 118 =item *
 119
 120 XXX
 121
 122 =back
 123
 124 =head2 Updated Modules and Pragmata
 125
 126 =over 4
 127
 128 =item *
 129
 130 L<B> has been upgraded from version 1.44 to 1.45.
 131
 132 Calling the C<GV> method on C<B::CV> objects created from a lexical
 133 sub would return nonsense, possibly crashing perl. C<GV> now returns
 134 C<undef> for lexical subs. [perl #118525]
 135
 136 Added the C<NAME_HEK> method to return the name of a lexical sub.
 137
 138 =item *
 139
 140 L<bignum> has been upgraded from version 0.35 to 0.36.
 141
 142 L<bigrat> wasn't correctly updating an internal variable when C<use>d
 143 with a C<lib> option.
 144
 145 =item *
 146
 147 L<Config::Perl::V> has been upgraded from version 0.18 to 0.19.
 148
 149 =item *
 150
 151 L<Data::Dumper> has been upgraded from version 2.147 to 2.148.
 152
 153 The compatbility of the XS implementation with the pure perl version
 154 under C<Useqq> has been improved. [perl #118933]
 155
 156 =item *
 157
 158 L<Devel::Peek> has been upgraded from version 1.12 to 1.13.
 159
 160 The C<SvREFCNT_inc()> and C<SvREFCNT_dec()> functions have been
 161 removed and C<SvREFCNT()> will now work on non-scalars. [perl #117793]
 162
 163 =item *
 164
 165 L<Exporter> has been upgraded from version 5.68 to 5.69.
 166
 167 L<Exporter> would ignore custom C<$SIG{__WARN__}> handlers in
 168 C<Exporter::Heavy>. [perl #39739]
 169
 170 =item *
 171
 172 L<IPC::Cmd> has been upgraded from version 0.82 to 0.84.
 173
 174 C<run_forked> has various fixes/improvements, L<Socket> is only used where
 175 needed and a regression introduced in 0.78 has been fixed.
 176
 177 =item *
 178
 179 The libnet module collection has been upgraded from version 1.22 to 1.22_02.
 180
 181 =item *
 182
 183 L<List::Util> has been upgraded from version 1.27 to 1.30
 184
 185 L<List::Util> now includes C<pairgrep>, C<pairmap>, C<pairs>, C<pairkeys>,
 186 C<pairvalues> and C<pairfirst> functions that operate on even-sized lists of
 187 pairs.
 188
 189 =item *
 190
 191 L<parent> has been upgraded from version 0.225 to 0.226.
 192
 193 =item *
 194
 195 L<Socket> has been upgraded from version 2.010 to 2.011.
 196
 197 Handle FreeBSD (or other platforms) returning shorter AF_UNIX sockaddr
 198 structures due to embedded sun_len. [cpan #86613]
 199
 200 =item *
 201
 202 L<Storable> has been upgraded from version 2.45 to 2.46.
 203
 204 Avoid creating temporary objects for STORABLE_attach when they aren't
 205 required. [perl #118907]
 206
 207 =back
 208
 209 =head2 Removed Modules and Pragmata
 210
 211 =over 4
 212
 213 =item *
 214
 215 XXX
 216
 217 =back
 218
 219 =head1 Documentation
 220
 221 XXX Changes to files in F<pod/> go here.  Consider grouping entries by
 222 file and be sure to link to the appropriate page, e.g. L<perlfunc>.
 223
 224 =head2 New Documentation
 225
 226 XXX Changes which create B<new> files in F<pod/> go here.
 227
 228 =head3 L<XXX>
 229
 230 XXX Description of the purpose of the new file here
 231
 232 =head2 Changes to Existing Documentation
 233
 234 XXX Changes which significantly change existing files in F<pod/> go here.
 235 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
 236 section.
 237
 238 =head3 L<perlopentut>
 239
 240 =over 4
 241
 242 =item *
 243
 244 The C<open> tutorial has been completely rewriten by Tom Christiansen, and now
 245 focuses on covering only the basics, rather than providing a comprehensive
 246 reference to all things openable.  This rewrite came as the result of a
 247 vigorous discussion on perl5-porters kicked off by a set of improvements
 248 written by Alexander Hartmaier to the existing C<perlopentut>.  A "more than
 249 you ever wanted to know about C<open>" document may follow in subsequent
 250 versions of perl.
 251
 252 =back
 253
 254 =head1 Diagnostics
 255
 256 The following additions or changes have been made to diagnostic output,
 257 including warnings and fatal error messages.  For the complete list of
 258 diagnostic messages, see L<perldiag>.
 259
 260 XXX New or changed warnings emitted by the core's C<C> code go here.  Also
 261 include any changes in L<perldiag> that reconcile it to the C<C> code.
 262
 263 =head2 New Diagnostics
 264
 265 XXX Newly added diagnostic messages go under here, separated into New Errors
 266 and New Warnings
 267
 268 =head3 New Errors
 269
 270 =over 4
 271
 272 =item *
 273
 274 XXX L<message|perldiag/"message">
 275
 276 =back
 277
 278 =head3 New Warnings
 279
 280 =over 4
 281
 282 =item *
 283
 284 XXX L<message|perldiag/"message">
 285
 286 =back
 287
 288 =head2 Changes to Existing Diagnostics
 289
 290 XXX Changes (i.e. rewording) of diagnostic messages go here
 291
 292 =over 4
 293
 294 =item *
 295
 296 XXX Describe change here
 297
 298 =back
 299
 300 =head1 Utility Changes
 301
 302 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go here.
 303 Most of these are built within the directories F<utils> and F<x2p>.
 304
 305 [ List utility changes as a =head3 entry for each utility and =item
 306 entries for each change
 307 Use L<XXX> with program names to get proper documentation linking. ]
 308
 309 =head3 L<XXX>
 310
 311 =over 4
 312
 313 =item *
 314
 315 XXX
 316
 317 =back
 318
 319 =head1 Configuration and Compilation
 320
 321 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
 322 go here.  Any other changes to the Perl build process should be listed here.
 323 However, any platform-specific changes should be listed in the
 324 L</Platform Support> section, instead.
 325
 326 [ List changes as a =item entry ].
 327
 328 =over 4
 329
 330 =item *
 331
 332 XXX
 333
 334 =back
 335
 336 =head1 Testing
 337
 338 XXX Any significant changes to the testing of a freshly built perl should be
 339 listed here.  Changes which create B<new> files in F<t/> go here as do any
 340 large changes to the testing harness (e.g. when parallel testing was added).
 341 Changes to existing files in F<t/> aren't worth summarizing, although the bugs
 342 that they represent may be covered elsewhere.
 343
 344 [ List each test improvement as a =item entry ]
 345
 346 =over 4
 347
 348 =item *
 349
 350 XXX
 351
 352 =back
 353
 354 =head1 Platform Support
 355
 356 XXX Any changes to platform support should be listed in the sections below.
 357
 358 [ Within the sections, list each platform as a =item entry with specific
 359 changes as paragraphs below it. ]
 360
 361 =head2 New Platforms
 362
 363 XXX List any platforms that this version of perl compiles on, that previous
 364 versions did not.  These will either be enabled by new files in the F<hints/>
 365 directories, or new subdirectories and F<README> files at the top level of the
 366 source tree.
 367
 368 =over 4
 369
 370 =item XXX-some-platform
 371
 372 XXX
 373
 374 =back
 375
 376 =head2 Discontinued Platforms
 377
 378 XXX List any platforms that this version of perl no longer compiles on.
 379
 380 =over 4
 381
 382 =item XXX-some-platform
 383
 384 XXX
 385
 386 =back
 387
 388 =head2 Platform-Specific Notes
 389
 390 XXX List any changes for specific platforms.  This could include configuration
 391 and compilation changes or changes in portability/compatibility.  However,
 392 changes within modules for platforms should generally be listed in the
 393 L</Modules and Pragmata> section.
 394
 395 =over 4
 396
 397 =item XXX-some-platform
 398
 399 XXX
 400
 401 =back
 402
 403 =head1 Internal Changes
 404
 405 XXX Changes which affect the interface available to C<XS> code go here.  Other
 406 significant internal changes for future core maintainers should be noted as
 407 well.
 408
 409 [ List each change as a =item entry ]
 410
 411 =over 4
 412
 413 =item *
 414
 415 XXX
 416
 417 =back
 418
 419 =head1 Selected Bug Fixes
 420
 421 XXX Important bug fixes in the core language are summarized here.  Bug fixes in
 422 files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
 423
 424 [ List each fix as a =item entry ]
 425
 426 =over 4
 427
 428 =item *
 429
 430 Autovivifying a subroutine stub via C<\&$glob> started causing crashes in
 431 Perl 5.18.0 if the $glob was merely a copy of a real glob, i.e., a scalar
 432 that had had a glob assigned to it.  This has been fixed [perl #119051].
 433
 434 =back
 435
 436 =head1 Known Problems
 437
 438 XXX Descriptions of platform agnostic bugs we know we can't fix go here.  Any
 439 tests that had to be C<TODO>ed for the release would be noted here.  Unfixed
 440 platform specific bugs also go here.
 441
 442 [ List each fix as a =item entry ]
 443
 444 =over 4
 445
 446 =item *
 447
 448 XXX
 449
 450 =back
 451
 452 =head1 Obituary
 453
 454 XXX If any significant core contributor has died, we've added a short obituary
 455 here.
 456
 457 =head1 Acknowledgements
 458
 459 XXX Generate this with:
 460
 461   perl Porting/acknowledgements.pl v5.19.2..HEAD
 462
 463 =head1 Reporting Bugs
 464
 465 If you find what you think is a bug, you might check the articles recently
 466 posted to the comp.lang.perl.misc newsgroup and the perl bug database at
 467 http://rt.perl.org/perlbug/ .  There may also be information at
 468 http://www.perl.org/ , the Perl Home Page.
 469
 470 If you believe you have an unreported bug, please run the L<perlbug> program
 471 included with your release.  Be sure to trim your bug down to a tiny but
 472 sufficient test case.  Your bug report, along with the output of C<perl -V>,
 473 will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
 474
 475 If the bug you are reporting has security implications, which make it
 476 inappropriate to send to a publicly archived mailing list, then please send it
 477 to perl5-security-report@perl.org.  This points to a closed subscription
 478 unarchived mailing list, which includes all the core committers, who will be
 479 able to help assess the impact of issues, figure out a resolution, and help
 480 co-ordinate the release of patches to mitigate or fix the problem across all
 481 platforms on which Perl is supported.  Please only use this address for
 482 security issues in the Perl core, not for modules independently distributed on
 483 CPAN.
 484
 485 =head1 SEE ALSO
 486
 487 The F<Changes> file for an explanation of how to view exhaustive details on
 488 what changed.
 489
 490 The F<INSTALL> file for how to build Perl.
 491
 492 The F<README> file for general stuff.
 493
 494 The F<Artistic> and F<Copying> files for copyright information.
 495
 496 =cut