pod/perldelta.pod

   1 =encoding utf8
   2
   3 =head1 NAME
   4
   5 perldelta - 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<feature> has been upgraded from version 1.26 to 1.27.
  81
  82 C<no feature;> now means reset to default. The code has been refactored
  83 to reduce duplication.
  84
  85 =item *
  86
  87 C<B::Deparse> has been upgraded from version 1.12 to 1.13.
  88
  89 =item *
  90
  91 C<B::Lint> has been upgraded from version 1.13 to 1.14.
  92
  93 =item *
  94
  95 C<CPAN::Meta> has been upgraded from version 2.120351 to 2.120630.
  96
  97 =item *
  98
  99 C<CPANPLUS> has been upgraded from version 0.9118 to 0.9121.
 100
 101 =item *
 102
 103 C<Digest::SHA> has been upgraded from version 5.70 to 5.71.
 104
 105 =item *
 106
 107 C<ExtUtils::CBuilder> has been upgraded from version 0.280205 to 0.280206.
 108
 109 =item *
 110
 111 C<HTTP::Tiny> has been upgraded from version 0.016 to 0.017.
 112
 113 =item *
 114
 115 C<Module::CoreList> has been upgraded from version 2.60 to 2.63.
 116
 117 =item *
 118
 119 C<Pod::Html> has been upgraded from version 1.14 to 1.1501.
 120
 121 =item *
 122
 123 C<Pod::Perldoc> has been upgraded from version 3.15_15 to 3.17.
 124
 125 =item *
 126
 127 C<Pod::Simple> has been upgraded from version 3.19 to 3.20.
 128
 129 =item *
 130
 131 C<Socket> has been upgraded from version 1.98 to 2.000.
 132
 133 =item *
 134
 135 C<Term::ReadLine> has been upgraded from version 1.08 to 1.09.
 136
 137 =item *
 138
 139 C<Unicode::Collate> has been upgraded from version 0.87 to 0.89.
 140
 141 =item *
 142
 143 C<Unicode::Normalize> has been upgraded from version 1.13 to 1.14.
 144
 145 =item *
 146
 147 C<Unicode::UCD> has been upgraded from version 0.41 to 0.42.
 148
 149 =back
 150
 151
 152 =head1 Documentation
 153
 154 There has been no significant change in the documentation between
 155 5.15.8 and 5.15.9.
 156
 157 =head1 Diagnostics
 158
 159 The following additions or changes have been made to diagnostic output,
 160 including warnings and fatal error messages.  For the complete list of
 161 diagnostic messages, see L<perldiag>.
 162
 163 =head2 New Diagnostics
 164
 165 =head3 New Errors
 166
 167 Compared to 5.15.8, 5.15.9 does not introduce new errors.
 168
 169 =head3 New Warnings
 170
 171 Compared to 5.15.8, 5.15.9 does not introduce new errors, but see
 172 L</Changes to Existing Diagnostics>
 173
 174 =head2 Changes to Existing Diagnostics
 175
 176 =over 4
 177
 178 =item *
 179
 180 L<lvalue attribute %s already-defined subroutine|perldiag/"lvalue attribute %s already-defined subroutine">, which replaces
 181 C<< lvalue attribute cannot be removed after the subroutine has been defined >>.
 182
 183 =back
 184
 185 =head1 Utility Changes
 186
 187 No utilities changed between 5.15.8 and 5.15.9.
 188
 189 =head1 Configuration and Compilation
 190
 191 =over 4
 192
 193 =item *
 194
 195 C<< perlfunc.html >> is now being generated again. [perl #107870]
 196
 197 =back
 198
 199 =head1 Testing
 200
 201 =over 4
 202
 203 =item *
 204
 205 F<< t/op/require_37033.t >> has been added, to test that C<require>
 206 always closes the file handle that it opens. Previously, it had been
 207 leaking the file handle if it happened to have file descriptor 0, which
 208 would happen if C<require> was called (explicitly or implicitly) when
 209 C<STDIN> had been closed.
 210
 211 =back
 212
 213 =head1 Platform Support
 214
 215 There have been no changes to Perl's support of various platforms between
 216 5.15.8 and 5.15.9.
 217
 218 =head1 Internal Changes
 219
 220 =over 4
 221
 222 =item *
 223
 224 Two new functions C<utf8_to_uvchr_buf()> and C<utf8_to_uvuni_buf()> have
 225 been added.  These are the same as C<utf8_to_uvchr> and
 226 C<utf8_to_uvuni> (which are now deprecated), but take an extra parameter
 227 that is used to guard against reading beyond the end of the input
 228 string.
 229 See L<perlapi/utf8_to_uvchr_buf> and L<perlapi/utf8_to_uvuni_buf>.
 230
 231 =back
 232
 233 =head1 Selected Bug Fixes
 234
 235 =over 4
 236
 237 =item *
 238
 239 I<Takri> now matches two more characters under the C<Script_Extensions>
 240 property. This corrects a Unicode 6.1 omission.
 241
 242 =item *
 243
 244 C<< perlfunc.html >> is now being generated again. [perl #107870]
 245
 246 =item *
 247
 248 C<< $$ >> is no longer tainted. Since this value comes directly from
 249 C<< getpid() >>, it is always safe.
 250
 251 =item *
 252
 253 Fix leaking a file handle. [perl #37033]
 254
 255 =item *
 256
 257 An off-by-one error caused C<< /[:upper:]/ >> and C<< /[:punct:]/ >> to
 258 unexepectly match characters with code points above 255. This has been
 259 rectified. [perl 111400].
 260
 261 =item *
 262
 263 C<< (?foo: ...) >> no longer loses passed in character set.
 264
 265 =item *
 266
 267 Allow attributes to set C<< :lvalue >> on a defined sub. [perl 107366].
 268
 269 =item *
 270
 271 C<< die; >> with a non-reference, non-string value in $@ now properly
 272 propgates that value [perl #111654].
 273
 274 =item *
 275
 276 C<< Term::ReadLine >> now uses AnyEvent instead of Tk for an event loop.
 277
 278 =back
 279
 280 =head1 Known Problems
 281
 282 This is a list of some significant unfixed bugs, which are regressions
 283 from either 5.14.0 or 5.15.8.
 284
 285 =over 4
 286
 287 =item C<eval { 'fork()' }> is broken on Windows [perl #109718]
 288
 289 This is a known test failure to be fixed before 5.16.0.
 290
 291 =item C<< Pod-Html >> test failures on Windows.
 292
 293 A number of tests for C<< Pod::Html >> fail under Windows, due to an
 294 incorrect assumption by the test scripts about capitalization of the
 295 network drive.
 296
 297 =back
 298
 299 =head1 Acknowledgements
 300
 301 XXX Redo this on 2012-03-20
 302
 303 Perl 5.15.9 represents approximately 4 weeks of development since Perl 5.15.8
 304 and contains approximately 74,000 lines of changes across 470 files from 23
 305 authors.
 306
 307 Perl continues to flourish into its third decade thanks to a vibrant community
 308 of users and developers. The following people are known to have contributed the
 309 improvements that became Perl 5.15.9:
 310
 311 Aaron Crane, Abigail, Chris 'BinGOs' Williams, Craig A. Berry, Dave Rolsky,
 312 David Cantrell, David Golden, David Mitchell, Eric Brine, Father Chrysostomos,
 313 Florian Ragwitz, James E Keenan, Jesse Vincent, Karl Williamson, Marc Green,
 314 Max Maischein, Nicholas Clark, Pau Amma, Reini Urban, Ricardo Signes, Tony
 315 Cook, Yves Orton, Zefram.
 316
 317 The list above is almost certainly incomplete as it is automatically generated
 318 from version control history. In particular, it does not include the names of
 319 the (very much appreciated) contributors who reported issues to the Perl bug
 320 tracker.
 321
 322 Many of the changes included in this version originated in the CPAN modules
 323 included in Perl's core. We're grateful to the entire CPAN community for
 324 helping Perl to flourish.
 325
 326 For a more complete list of all of Perl's historical contributors, please see
 327 the F<AUTHORS> file in the Perl source distribution.
 328
 329 =head1 Reporting Bugs
 330
 331 If you find what you think is a bug, you might check the articles
 332 recently posted to the comp.lang.perl.misc newsgroup and the perl
 333 bug database at http://rt.perl.org/perlbug/ .  There may also be
 334 information at http://www.perl.org/ , the Perl Home Page.
 335
 336 If you believe you have an unreported bug, please run the L<perlbug>
 337 program included with your release.  Be sure to trim your bug down
 338 to a tiny but sufficient test case.  Your bug report, along with the
 339 output of C<perl -V>, will be sent off to perlbug@perl.org to be
 340 analysed by the Perl porting team.
 341
 342 If the bug you are reporting has security implications, which make it
 343 inappropriate to send to a publicly archived mailing list, then please send
 344 it to perl5-security-report@perl.org. This points to a closed subscription
 345 unarchived mailing list, which includes
 346 all the core committers, who will be able
 347 to help assess the impact of issues, figure out a resolution, and help
 348 co-ordinate the release of patches to mitigate or fix the problem across all
 349 platforms on which Perl is supported. Please only use this address for
 350 security issues in the Perl core, not for modules independently
 351 distributed on CPAN.
 352
 353 =head1 SEE ALSO
 354
 355 The F<Changes> file for an explanation of how to view exhaustive details
 356 on what changed.
 357
 358 The F<INSTALL> file for how to build Perl.
 359
 360 The F<README> file for general stuff.
 361
 362 The F<Artistic> and F<Copying> files for copyright information.
 363
 364 =cut