pod/perl5159delta.pod

   1 =encoding utf8
   2
   3 =head1 NAME
   4
   5 perl5159delta - what is new for perl v5.15.9
   6
   7 =head1 DESCRIPTION
   8
   9 This document describes differences between the 5.15.8 release and
  10 the 5.15.9 release.
  11
  12 If you are upgrading from an earlier release such as 5.15.7, first read
  13 L<perl5158delta>, which describes differences between 5.15.7 and
  14 5.15.8.
  15
  16 =head1 Notice
  17
  18 This space intentionally left blank.
  19
  20 =head1 Core Enhancements
  21
  22 =head2 C<< no feature; >> now means reset to default
  23
  24 C<< no feature >> now resets to the default feature set.  To disable all
  25 features (which is likely to be a pretty special-purpose request, since
  26 it presumably won't match any named set of semantics) you can now
  27 write C<< no feature ':all' >>.
  28
  29 =head1 Security
  30
  31 =head2 Malformed UTF-8 input could cause attempts to read beyond the end of the buffer
  32
  33 Two new XS-accessible functions, C<utf8_to_uvchr_buf()> and
  34 C<utf8_to_uvuni_buf()> are now available to prevent this, and the Perl
  35 core has been converted to use them.
  36 See L</Internal Changes>.
  37
  38 =head1 Incompatible Changes
  39
  40 =head2 C<< no feature; >>
  41
  42 C<no feature;> now means reset to default.
  43
  44 =head1 Deprecations
  45
  46 =head2 Literal C<< "{" >> characters in regular expressions.
  47
  48 It has been documented that the current plans include requiring a
  49 literal C<< "{" >> to be escaped: 5.18 will emit deprecation warnings,
  50 and it will be required in 5.20.
  51
  52 =head2 XS functions C<utf8_to_uvchr()> and C<utf8_to_uvuni()>
  53
  54 Use C<utf8_to_uvchr_buf()> and C<utf8_to_uvuni_buf()> instead.
  55 See L</Internal Changes>.
  56
  57 =head1 Performance Enhancements
  58
  59 =over 4
  60
  61 =item *
  62
  63 Fix a slowdown in freeing nested hashes. This may speedup the exit of
  64 certain programs.
  65
  66 =back
  67
  68 =head1 Modules and Pragmata
  69
  70 =head2 Updated Modules and Pragmata
  71
  72 =over 4
  73
  74 =item *
  75
  76 C<attributes> has been upgraded from version 0.17 to 0.18.
  77
  78 =item *
  79
  80 C<charnames> has been upgraded from version 1.29 to 1.30.
  81
  82 =item *
  83
  84 C<feature> has been upgraded from version 1.26 to 1.27.
  85
  86 C<no feature;> now means reset to default. The code has been refactored
  87 to reduce duplication.
  88
  89 =item *
  90
  91 C<B::Deparse> has been upgraded from version 1.12 to 1.13.
  92
  93 =item *
  94
  95 C<B::Lint> has been upgraded from version 1.13 to 1.14.
  96
  97 =item *
  98
  99 C<CPAN::Meta> has been upgraded from version 2.120351 to 2.120630.
 100
 101 =item *
 102
 103 C<CPANPLUS> has been upgraded from version 0.9118 to 0.9121.
 104
 105 =item *
 106
 107 C<Data::Dumper> has been upgraded from version 2.135_05 to 2.135_06.
 108
 109 =item *
 110
 111 C<Digest::SHA> has been upgraded from version 5.70 to 5.71.
 112
 113 =item *
 114
 115 C<ExtUtils::CBuilder> has been upgraded from version 0.280205 to 0.280206.
 116
 117 =item *
 118
 119 C<HTTP::Tiny> has been upgraded from version 0.016 to 0.017.
 120
 121 =item *
 122
 123 C<Module::CoreList> has been upgraded from version 2.60 to 2.65.
 124
 125 =item *
 126
 127 C<Pod::Html> has been upgraded from version 1.14 to 1.1501.
 128
 129 =item *
 130
 131 C<Pod::Perldoc> has been upgraded from version 3.15_15 to 3.17.
 132
 133 =item *
 134
 135 C<Pod::Simple> has been upgraded from version 3.19 to 3.20.
 136
 137 =item *
 138
 139 C<Socket> has been upgraded from version 1.98 to 2.000.
 140
 141 =item *
 142
 143 C<Term::ReadLine> has been upgraded from version 1.08 to 1.09.
 144
 145 C<< Term::ReadLine >> now optionally integrates with event loops
 146 other than C<< Tk >>.
 147
 148 =item *
 149
 150 C<Unicode::Collate> has been upgraded from version 0.87 to 0.89.
 151
 152 =item *
 153
 154 C<Unicode::Normalize> has been upgraded from version 1.13 to 1.14.
 155
 156 =item *
 157
 158 C<Unicode::UCD> has been upgraded from version 0.41 to 0.42.
 159
 160 =item *
 161
 162 C<XS::APItest> has been upgraded from version 0.36 to 0.37.
 163
 164 =back
 165
 166
 167 =head1 Documentation
 168
 169 There has been no significant change in the documentation between
 170 5.15.8 and 5.15.9.
 171
 172 =head1 Diagnostics
 173
 174 The following additions or changes have been made to diagnostic output,
 175 including warnings and fatal error messages.  For the complete list of
 176 diagnostic messages, see L<perldiag>.
 177
 178 =head2 New Diagnostics
 179
 180 =head3 New Errors
 181
 182 Compared to 5.15.8, 5.15.9 does not introduce new errors.
 183
 184 =head3 New Warnings
 185
 186 Compared to 5.15.8, 5.15.9 does not introduce new warnings, but see
 187 L</Changes to Existing Diagnostics>
 188
 189 =head2 Changes to Existing Diagnostics
 190
 191 =over 4
 192
 193 =item *
 194
 195 L<lvalue attribute %s already-defined subroutine|perldiag/"lvalue attribute %s already-defined subroutine">, which replaces
 196 C<< lvalue attribute cannot be removed after the subroutine has been defined >>.
 197
 198 =back
 199
 200 =head1 Utility Changes
 201
 202 No utilities changed between 5.15.8 and 5.15.9.
 203
 204 =head1 Configuration and Compilation
 205
 206 =over 4
 207
 208 =item *
 209
 210 C<< perlfunc.html >> is now being generated again. [perl #107870]
 211
 212 =back
 213
 214 =head1 Testing
 215
 216 =over 4
 217
 218 =item *
 219
 220 F<< t/op/require_37033.t >> has been added, to test that C<require>
 221 always closes the file handle that it opens. Previously, it had been
 222 leaking the file handle if it happened to have file descriptor 0, which
 223 would happen if C<require> was called (explicitly or implicitly) when
 224 C<STDIN> had been closed.
 225
 226 =back
 227
 228 =head1 Platform Support
 229
 230 There have been no changes to Perl's support of various platforms between
 231 5.15.8 and 5.15.9.
 232
 233 =head1 Internal Changes
 234
 235 =over 4
 236
 237 =item *
 238
 239 Two new functions C<utf8_to_uvchr_buf()> and C<utf8_to_uvuni_buf()> have
 240 been added.  These are the same as C<utf8_to_uvchr> and
 241 C<utf8_to_uvuni> (which are now deprecated), but take an extra parameter
 242 that is used to guard against reading beyond the end of the input
 243 string.
 244 See L<perlapi/utf8_to_uvchr_buf> and L<perlapi/utf8_to_uvuni_buf>.
 245
 246 =item *
 247
 248 The regular expression engine now does TRIE case insensitive matches
 249 under Unicode. This may change the output of C<< use re 'debug'; >>,
 250 and will speed up various things.
 251
 252 =back
 253
 254 =head1 Selected Bug Fixes
 255
 256 =over 4
 257
 258 =item *
 259
 260 I<Takri> now matches two more characters under the C<Script_Extensions>
 261 property. This corrects a Unicode 6.1 omission.
 262
 263 =item *
 264
 265 C<< perlfunc.html >> is now being generated again. [perl #107870]
 266
 267 =item *
 268
 269 C<< $$ >> is no longer tainted. Since this value comes directly from
 270 C<< getpid() >>, it is always safe.
 271
 272 =item *
 273
 274 Fix leaking a file handle. [perl #37033]
 275
 276 =item *
 277
 278 An off-by-one error caused C<< /[:upper:]/ >> and C<< /[:punct:]/ >> to
 279 unexpectedly match characters with code points above 255. This has been
 280 rectified. [perl 111400].
 281
 282 =item *
 283
 284 C<< (?foo: ...) >> no longer loses passed in character set.
 285
 286 =item *
 287
 288 Allow attributes to set C<< :lvalue >> on a defined sub. [perl 107366].
 289
 290 =item *
 291
 292 C<< die; >> with a non-reference, non-string value in $@ now properly
 293 propagates that value [perl #111654].
 294
 295 =back
 296
 297 =head1 Known Problems
 298
 299 This is a list of some significant unfixed bugs, which need to be
 300 resolved before 5.16.0
 301
 302 =over 4
 303
 304 =item F<< op/sigdispatch.t >> fails alarm test 14 and gets killed [perl #89718]
 305
 306 E<32>
 307
 308 =item Perl crash due to wrong delimiter in C<< PATH >> environment [perl #94846]
 309
 310 It's possible to crash perl under Win32 if the wrong delimiter is used.
 311
 312 =item Corrupt UTF8 [perl #79960, #100058]
 313
 314 It is possible to read an invalid UTF8 character, but have it marked valid,
 315 or to incorrectly read UTF8 characters if C<< $/ >> is set to read fixed
 316 length records.
 317
 318 =item UTF8 patches for 5.16 [perl #107008]
 319
 320 Brian Fraser's work on UTF8 needs further integration.
 321
 322 =item C<eval { 'fork()' }> is broken on Windows [perl #109718]
 323
 324 This is a known test failure to be fixed before 5.16.0.
 325
 326 =item Warnings from cpan/IO-Compress [perl #110736]
 327
 328 Some tests in F<< cpan/IO-Compress/t/cz-03zlib-v1.t >> issues a
 329 "isn't numeric" warning in blead, but not in maint.
 330
 331 =item C<< Pod-Html >> test failures on Windows.
 332
 333 A number of tests for C<< Pod::Html >> fail under Windows, due to an
 334 incorrect assumption by the test scripts about capitalization of the
 335 network drive.
 336
 337 =back
 338
 339 =head1 Acknowledgements
 340
 341 Perl 5.15.9 represents approximately 4 weeks of development since Perl 5.15.8
 342 and contains approximately 79,000 lines of changes across 530 files from 23
 343 authors.
 344
 345 Perl continues to flourish into its third decade thanks to a vibrant community
 346 of users and developers. The following people are known to have contributed the
 347 improvements that became Perl 5.15.9:
 348
 349 Aaron Crane, Abigail, Chris 'BinGOs' Williams, Craig A. Berry, Dave Rolsky,
 350 David Cantrell, David Golden, David Mitchell, Eric Brine, Father Chrysostomos,
 351 Florian Ragwitz, James E Keenan, Jesse Vincent, Karl Williamson, Marc Green,
 352 Max Maischein, Nicholas Clark, Pau Amma, Reini Urban, Ricardo Signes, Tony
 353 Cook, Yves Orton, Zefram.
 354
 355 The list above is almost certainly incomplete as it is automatically generated
 356 from version control history. In particular, it does not include the names of
 357 the (very much appreciated) contributors who reported issues to the Perl bug
 358 tracker.
 359
 360 Many of the changes included in this version originated in the CPAN modules
 361 included in Perl's core. We're grateful to the entire CPAN community for
 362 helping Perl to flourish.
 363
 364 For a more complete list of all of Perl's historical contributors, please see
 365 the F<AUTHORS> file in the Perl source distribution.
 366
 367 =head1 Reporting Bugs
 368
 369 If you find what you think is a bug, you might check the articles
 370 recently posted to the comp.lang.perl.misc newsgroup and the perl
 371 bug database at http://rt.perl.org/perlbug/ .  There may also be
 372 information at http://www.perl.org/ , the Perl Home Page.
 373
 374 If you believe you have an unreported bug, please run the L<perlbug>
 375 program included with your release.  Be sure to trim your bug down
 376 to a tiny but sufficient test case.  Your bug report, along with the
 377 output of C<perl -V>, will be sent off to perlbug@perl.org to be
 378 analysed by the Perl porting team.
 379
 380 If the bug you are reporting has security implications, which make it
 381 inappropriate to send to a publicly archived mailing list, then please send
 382 it to perl5-security-report@perl.org. This points to a closed subscription
 383 unarchived mailing list, which includes
 384 all the core committers, who will be able
 385 to help assess the impact of issues, figure out a resolution, and help
 386 co-ordinate the release of patches to mitigate or fix the problem across all
 387 platforms on which Perl is supported. Please only use this address for
 388 security issues in the Perl core, not for modules independently
 389 distributed on CPAN.
 390
 391 =head1 SEE ALSO
 392
 393 The F<Changes> file for an explanation of how to view exhaustive details
 394 on what changed.
 395
 396 The F<INSTALL> file for how to build Perl.
 397
 398 The F<README> file for general stuff.
 399
 400 The F<Artistic> and F<Copying> files for copyright information.
 401
 402 =cut