pod/perldelta.pod

   1 =encoding utf8
   2
   3 =for comment
   4 This has been completed up to a75c6ed6bbe, except for:
   5 803e389 rurban  CYG17 utf8 paths
   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.15.8
  13
  14 =head1 DESCRIPTION
  15
  16 This document describes differences between the 5.15.7 release and
  17 the 5.15.8 release.
  18
  19 If you are upgrading from an earlier release such as 5.15.6, first read
  20 L<perl5157delta>, which describes differences between 5.15.6 and
  21 5.15.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 Improved ability to mix locales and Unicode, including UTF-8 locales
  36
  37 An optional parameter has been added to C<use locale>
  38
  39  use locale ':not_characters';
  40
  41 which tells Perl to use all but the C<LC_CTYPE> and C<LC_COLLATE>
  42 portions of the current locale.  Instead, the character set is assumed
  43 to be Unicode.  This allows locales and Unicode to be seamlessly mixed,
  44 including the increasingly frequent UTF-8 locales.  When using this
  45 hybrid form of locales, the C<:locale> layer to the L<open> pragma can
  46 be used to interface with the file system, and there are CPAN modules
  47 available for ARGV and environment variable conversions.
  48
  49 Full details are in L<perllocale>.
  50
  51 =head2 New function C<fc> and corresponding escape sequence C<\F> for Unicode foldcase
  52
  53 Unicode foldcase is an extension to lowercase that gives better results
  54 when comparing two strings case-insensitively.  It has long been used
  55 internally in regular expression C</i> matching.  Now it is available
  56 explicitly through the new C<fc> function call (enabled by
  57 S<C<"use feature 'fc'">>, or C<use v5.16>, or explicitly callable via
  58 C<CORE::fc>) or through the new C<\F> sequence in double-quotish
  59 strings.
  60
  61 Full details are in L<perlfunc/fc>.
  62
  63 =head2 C<_> in subroutine prototypes
  64
  65 The C<_> character in subroutine prototypes is now allowed before C<@> or
  66 C<%>.
  67
  68 =head1 Security
  69
  70 XXX Any security-related notices go here.  In particular, any security
  71 vulnerabilities closed should be noted here rather than in the
  72 L</Selected Bug Fixes> section.
  73
  74 [ List each security issue as a =head2 entry ]
  75
  76 =head1 Incompatible Changes
  77
  78 XXX For a release on a stable branch, this section aspires to be:
  79
  80     There are no changes intentionally incompatible with 5.XXX.XXX
  81     If any exist, they are bugs, and we request that you submit a
  82     report.  See L</Reporting Bugs> below.
  83
  84 [ List each incompatible change as a =head2 entry ]
  85
  86 =head2 Special blocks called in void context
  87
  88 Special blocks (C<BEGIN>, C<CHECK>, C<INIT>, C<UNITCHECK>, C<END>) are now
  89 called in void context.  This avoids wasteful copying of the result of the
  90 last statement [perl #108794].
  91
  92 =head2 The C<overloading> pragma and regexp objects
  93
  94 With C<no overloading>, regular expression objects returned by C<qr//> are
  95 now stringified as "Regexp=REGEXP(0xbe600d)" instead of the regular
  96 expression itself [perl #108780].
  97
  98 =head1 Deprecations
  99
 100 XXX Any deprecated features, syntax, modules etc. should be listed here.
 101 In particular, deprecated modules should be listed here even if they are
 102 listed as an updated module in the L</Modules and Pragmata> section.
 103
 104 [ List each deprecation as a =head2 entry ]
 105
 106 =head1 Performance Enhancements
 107
 108 XXX Changes which enhance performance without changing behaviour go here. There
 109 may well be none in a stable release.
 110
 111 [ List each enhancement as a =item entry ]
 112
 113 =over 4
 114
 115 =item *
 116
 117 XXX
 118
 119 =back
 120
 121 =head1 Modules and Pragmata
 122
 123 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
 124 go here.  If Module::CoreList is updated, generate an initial draft of the
 125 following sections using F<Porting/corelist-perldelta.pl>, which prints stub
 126 entries to STDOUT.  Results can be pasted in place of the '=head2' entries
 127 below.  A paragraph summary for important changes should then be added by hand.
 128 In an ideal world, dual-life modules would have a F<Changes> file that could be
 129 cribbed.
 130
 131 [ Within each section, list entries as a =item entry ]
 132
 133 =head2 New Modules and Pragmata
 134
 135 =over 4
 136
 137 =item *
 138
 139 XXX
 140
 141 =back
 142
 143 =head2 Updated Modules and Pragmata
 144
 145 =over 4
 146
 147 =item *
 148
 149 L<B> has been upgraded from version 1.33 to version 1.34.
 150
 151 C<B::COP> now has a C<stashflags> method, corresponding to a new internal
 152 field added in 5.15.4 [perl #108860].
 153
 154 =item *
 155
 156 L<Compress::Raw::Bzip2> has been upgraded from version 2.045 to version 2.048.
 157
 158 =item *
 159
 160 L<Compress::Raw::Zlib> has been upgraded from version 2.045 to version 2.048.
 161
 162 =item *
 163
 164 L<Compress::Zlib> has been upgraded from version 2.046 to version 2.048.
 165
 166 =item *
 167
 168 L<DB_File> has been upgraded from version 1.824 to version 1.826.
 169
 170 =item *
 171
 172 L<diagnostics> has been upgraded from version 1.27 to version 1.28.
 173
 174 When searching for F<perldiag.pod>, it no longer uses paths that were only
 175 relevant on Perl 5.004 and earlier.
 176
 177 =item *
 178
 179 L<IPC::Cmd> has been upgraded from version 0.72 to version 0.76.
 180
 181 =item *
 182
 183 L<Math::Complex> has been upgraded from version 1.58 to version 1.59.
 184
 185 This avoids a new core warning.
 186
 187 =item *
 188
 189 L<Pod::Parser> has been upgraded from version 1.37 to version 1.51.
 190
 191 =item *
 192
 193 L<Time::HiRes>  has been upgraded from version 1.9724 to version 1.9725.
 194
 195 There is an important bugfix for C<Time::HiRes::stat()>.
 196
 197 =item *
 198
 199 L<Unicode::UCD> has been upgraded from version 0.39 to 0.40.
 200
 201 The only change is to fix a formatting error in the Pod.
 202
 203 =back
 204
 205 =head2 Removed Modules and Pragmata
 206
 207 =over 4
 208
 209 =item *
 210
 211 XXX
 212
 213 =back
 214
 215 =head1 Documentation
 216
 217 XXX Changes to files in F<pod/> go here.  Consider grouping entries by
 218 file and be sure to link to the appropriate page, e.g. L<perlfunc>.
 219
 220 =head2 New Documentation
 221
 222 XXX Changes which create B<new> files in F<pod/> go here.
 223
 224 =head3 L<XXX>
 225
 226 XXX Description of the purpose of the new file here
 227
 228 =head2 Changes to Existing Documentation
 229
 230 XXX Changes which significantly change existing files in F<pod/> go here.
 231 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
 232 section.
 233
 234 =head3 L<XXX>
 235
 236 =over 4
 237
 238 =item *
 239
 240 XXX Description of the change here
 241
 242 =back
 243
 244 =head1 Diagnostics
 245
 246 The following additions or changes have been made to diagnostic output,
 247 including warnings and fatal error messages.  For the complete list of
 248 diagnostic messages, see L<perldiag>.
 249
 250 XXX New or changed warnings emitted by the core's C<C> code go here. Also
 251 include any changes in L<perldiag> that reconcile it to the C<C> code.
 252
 253 [ Within each section, list entries as a =item entry that links to perldiag,
 254   e.g.
 255
 256   =item *
 257
 258   L<Invalid version object|perldiag/"Invalid version object">
 259 ]
 260
 261 =head2 New Diagnostics
 262
 263 XXX Newly added diagnostic messages go here
 264
 265 =head3 New Errors
 266
 267 =over 4
 268
 269 =item *
 270
 271 XXX L<message|perldiag/"message">
 272
 273 =back
 274
 275 =head3 New Warnings
 276
 277 =over 4
 278
 279 =item *
 280
 281 XXX L<message|perldiag/"message">
 282
 283 =back
 284
 285 =head2 Changes to Existing Diagnostics
 286
 287 XXX Changes (i.e. rewording) of diagnostic messages go here
 288
 289 =over 4
 290
 291 =item *
 292
 293 XXX Describe change here
 294
 295 =back
 296
 297 =head1 Utility Changes
 298
 299 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
 300 here. Most of these are built within the directories F<utils> and F<x2p>.
 301
 302 [ List utility changes as a =head3 entry for each utility and =item
 303 entries for each change
 304 Use L<XXX> with program names to get proper documentation linking. ]
 305
 306 =head3 L<XXX>
 307
 308 =over 4
 309
 310 =item *
 311
 312 XXX
 313
 314 =back
 315
 316 =head1 Configuration and Compilation
 317
 318 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
 319 go here.  Any other changes to the Perl build process should be listed here.
 320 However, any platform-specific changes should be listed in the
 321 L</Platform Support> section, instead.
 322
 323 [ List changes as a =item entry ].
 324
 325 =over 4
 326
 327 =item *
 328
 329 XXX
 330
 331 =back
 332
 333 =head1 Testing
 334
 335 XXX Any significant changes to the testing of a freshly built perl should be
 336 listed here.  Changes which create B<new> files in F<t/> go here as do any
 337 large changes to the testing harness (e.g. when parallel testing was added).
 338 Changes to existing files in F<t/> aren't worth summarising, although the bugs
 339 that they represent may be covered elsewhere.
 340
 341 [ List each test improvement as a =item entry ]
 342
 343 =over 4
 344
 345 =item *
 346
 347 XXX
 348
 349 =back
 350
 351 =head1 Platform Support
 352
 353 XXX Any changes to platform support should be listed in the sections below.
 354
 355 [ Within the sections, list each platform as a =item entry with specific
 356 changes as paragraphs below it. ]
 357
 358 =head2 New Platforms
 359
 360 XXX List any platforms that this version of perl compiles on, that previous
 361 versions did not. These will either be enabled by new files in the F<hints/>
 362 directories, or new subdirectories and F<README> files at the top level of the
 363 source tree.
 364
 365 =over 4
 366
 367 =item XXX-some-platform
 368
 369 XXX
 370
 371 =back
 372
 373 =head2 Discontinued Platforms
 374
 375 XXX List any platforms that this version of perl no longer compiles on.
 376
 377 =over 4
 378
 379 =item XXX-some-platform
 380
 381 XXX
 382
 383 =back
 384
 385 =head2 Platform-Specific Notes
 386
 387 XXX List any changes for specific platforms. This could include configuration
 388 and compilation changes or changes in portability/compatibility.  However,
 389 changes within modules for platforms should generally be listed in the
 390 L</Modules and Pragmata> section.
 391
 392 =over 4
 393
 394 =item XXX-some-platform
 395
 396 XXX
 397
 398 =back
 399
 400 =head1 Internal Changes
 401
 402 XXX Changes which affect the interface available to C<XS> code go here.
 403 Other significant internal changes for future core maintainers should
 404 be noted as well.
 405
 406 [ List each change as a =item entry ]
 407
 408 =over 4
 409
 410 =item *
 411
 412 XXX
 413
 414 =back
 415
 416 =head1 Selected Bug Fixes
 417
 418 XXX Important bug fixes in the core language are summarised here.
 419 Bug fixes in files in F<ext/> and F<lib/> are best summarised in
 420 L</Modules and Pragmata>.
 421
 422 [ List each fix as a =item entry ]
 423
 424 =over 4
 425
 426 =item *
 427
 428 C<~~> now correctly handles the precedence of Any~~Object, and is not tricked
 429 by an overloaded object on the left-hand side.
 430
 431 =item *
 432
 433 C<stat _> no longer warns about unopened filehandles [perl #71002].
 434
 435 =item *
 436
 437 C<stat> on an unopened filehandle now warns consistently, instead of
 438 skipping the warning at times.
 439
 440 =item *
 441
 442 A change in an earlier 5.15 release caused warning hints to propagate into
 443 C<do $file>.  This has been fixed [rt.cpan.org #72767].
 444
 445 =item *
 446
 447 Starting with 5.12.0, Perl used to get its internal bookkeeping muddled up
 448 after assigning C<${ qr// }> to a hash element and locking it with
 449 L<Hash::Util>.  This could result in double frees, crashes or erratic
 450 behaviour.
 451
 452 =item *
 453
 454 In 5.15.7, some typeglobs in the CORE namespace were made read-only by
 455 mistake.  This has been fixed [rt.cpan.org #74289].
 456
 457 =item *
 458
 459 C<-t> now works when stacked with other filetest operators [perl #77388].
 460
 461 =item *
 462
 463 Stacked filetest operators now only call FETCH once on a tied argument.
 464
 465 =back
 466
 467 =head1 Known Problems
 468
 469 XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
 470 tests that had to be C<TODO>ed for the release would be noted here, unless
 471 they were specific to a particular platform (see below).
 472
 473 This is a list of some significant unfixed bugs, which are regressions
 474 from either 5.XXX.XXX or 5.XXX.XXX.
 475
 476 [ List each fix as a =item entry ]
 477
 478 =over 4
 479
 480 =item *
 481
 482 XXX
 483
 484 =back
 485
 486 =head1 Obituary
 487
 488 XXX If any significant core contributor has died, we've added a short obituary
 489 here.
 490
 491 =head1 Acknowledgements
 492
 493 XXX Generate this with:
 494
 495   perl Porting/acknowledgements.pl v5.15.7..HEAD
 496
 497 =head1 Reporting Bugs
 498
 499 If you find what you think is a bug, you might check the articles
 500 recently posted to the comp.lang.perl.misc newsgroup and the perl
 501 bug database at http://rt.perl.org/perlbug/ .  There may also be
 502 information at http://www.perl.org/ , the Perl Home Page.
 503
 504 If you believe you have an unreported bug, please run the L<perlbug>
 505 program included with your release.  Be sure to trim your bug down
 506 to a tiny but sufficient test case.  Your bug report, along with the
 507 output of C<perl -V>, will be sent off to perlbug@perl.org to be
 508 analysed by the Perl porting team.
 509
 510 If the bug you are reporting has security implications, which make it
 511 inappropriate to send to a publicly archived mailing list, then please send
 512 it to perl5-security-report@perl.org. This points to a closed subscription
 513 unarchived mailing list, which includes
 514 all the core committers, who will be able
 515 to help assess the impact of issues, figure out a resolution, and help
 516 co-ordinate the release of patches to mitigate or fix the problem across all
 517 platforms on which Perl is supported. Please only use this address for
 518 security issues in the Perl core, not for modules independently
 519 distributed on CPAN.
 520
 521 =head1 SEE ALSO
 522
 523 The F<Changes> file for an explanation of how to view exhaustive details
 524 on what changed.
 525
 526 The F<INSTALL> file for how to build Perl.
 527
 528 The F<README> file for general stuff.
 529
 530 The F<Artistic> and F<Copying> files for copyright information.
 531
 532 =cut