pod/perl5112delta.pod

   1 =head1 NAME
   2
   3 perl5112delta - what is new for perl v5.11.2
   4
   5 =head1 DESCRIPTION
   6
   7 This document describes differences between the 5.11.1 release and the
   8 5.11.2 release.
   9
  10 =head1 Core Enhancements
  11
  12 =head2 qr overloading
  13
  14 It is now possible to overload the C<qr//> operator, that is,
  15 conversion to regexp, like it was already possible to overload
  16 conversion to boolean, string or number of objects. It is invoked when
  17 an object appears on the right hand side of the C<=~> operator, or when
  18 it is interpolated into a regexp. See L<overload>.
  19
  20 =head2 Pluggable keywords
  21
  22 Extension modules can now cleanly hook into the Perl parser to define
  23 new kinds of keyword-headed expression and compound statement. The
  24 syntax following the keyword is defined entirely by the extension. This
  25 allow a completely non-Perl sublanguage to be parsed inline, with the
  26 right ops cleanly generated. This feature is currently considered
  27 experimental.
  28
  29 See L<perlapi/PL_keyword_plugin> for the mechanism. The Perl core
  30 source distribution also includes a new module
  31 L<XS::APItest::KeywordRPN>, which implements reverse Polish notation
  32 arithmetic via pluggable keywords. This module is mainly used for test
  33 purposes, and is not normally installed, but also serves as an example
  34 of how to use the new mechanism.
  35
  36 =head2 APIs for more internals
  37
  38 The lowest layers of the lexer and parts of the pad system now have C
  39 APIs available to XS extensions. These are necessary to support proper
  40 use of pluggable keywords, but have other uses too. The new APIs are
  41 experimental, and only cover a small proportion of what would be
  42 necessary to take full advantage of the core's facilities in these
  43 areas. It is intended that the Perl 5.13 development cycle will see the
  44 addition of a full range of clean, supported interfaces.
  45
  46 =head2 Overridable function lookup
  47
  48 Where an extension module hooks the creation of rv2cv ops to modify the
  49 subroutine lookup process, this now works correctly for bareword
  50 subroutine calls. This means that prototypes on subroutines referenced
  51 this way will be processed correctly. (Previously bareword subroutine
  52 names were initially looked up, for parsing purposes, by an unhookable
  53 mechanism, so extensions could only properly influence subroutine names
  54 that appeared with an C<&> sigil.)
  55
  56 =head1 Modules and Pragmata
  57
  58 =head2 New Modules and Pragmata
  59
  60 =over 4
  61
  62 =item C<legacy>
  63
  64 Preserves legacy behaviors or enable new non-default behaviors.
  65 Currently the only behaviour concerns semantics for the 128 characters
  66 on ASCII systems that have the 8th bit set.
  67
  68 =back
  69
  70 =head2 Pragmata Changes
  71
  72 =over 4
  73
  74 =item C<diagnostics>
  75
  76 Supports %.0f formatting internally.
  77
  78 =item C<overload>
  79
  80 Allow overloading of 'qr'.
  81
  82 =back
  83
  84 =head2 Updated Modules
  85
  86 =over 4
  87
  88 =item C<B::Concise>
  89
  90 Optimize reversing an array in-place, avoid using defined %hash in core
  91 code and tests.
  92
  93 =item C<B::Deparse>
  94
  95 Teach B::Deparse about in-place reverse.
  96
  97 =item C<Carp>
  98
  99 Refine Carp caller() fix and add tests.
 100
 101 =item C<Compress::Zlib>
 102
 103 Updated to 2.022.
 104
 105 =item C<CPANPLUS>
 106
 107 Updated to 0.89_09.
 108
 109 =item C<Encode>
 110
 111 Updated to 2.38.
 112
 113 =item C<ExtUtils::CBuilder>
 114
 115 Updated to 0.27.
 116
 117 =item C<Env>
 118
 119 Add EXISTS and DELETE methods to Env.pm.
 120
 121 =item C<File::Fetch>
 122
 123 Updated to 0.22.
 124
 125 =item C<I8N::Langinfo>
 126
 127 Correctly document export of I18N::Langinfo.
 128
 129 =item C<I8N::LangTags>
 130
 131 In I18N::LangTags::Detect, avoid using defined @array and defined
 132 %hash.
 133
 134 =item C<IO::Compress>
 135
 136 Updated to 2.022.
 137
 138 =item C<IPC::Cmd>
 139
 140 Updated to 0.54.
 141
 142 =item C<List::Util>
 143
 144 Updated to 1.22.
 145
 146 =item C<Locale::Maketext>
 147
 148 In Locale::Maketext, avoid using defined @array and defined %hash.
 149 Convert the odd Locale::Maketext test out from Test to Test::More.
 150
 151 =item C<Module::Build>
 152
 153 Updated to 0.35_08.
 154
 155 =item C<Module::CoreList>
 156
 157 Implemented is_deprecated().
 158
 159 =item C<Pod::Simple>
 160
 161 Updated to 3.10.
 162
 163 =item C<Scalar::Util>
 164
 165 Updated to 1.22.
 166
 167 =item C<Switch>
 168
 169 Updated to 2.16.
 170
 171 =back
 172
 173 =head1 Utility Changes
 174
 175 =over 4
 176
 177 =item F<a2p>
 178
 179 Fixed bugs with the match() operator in list context, remove mention of
 180 $[.
 181
 182 =back
 183
 184 =head1 Performance Enhancements
 185
 186 =over 4
 187
 188 =item *
 189
 190 Reversing an array to itself (as in C<@a = reverse @a>) in void context
 191 now happens in-place and is several orders of magnitude faster than it
 192 used to be. It will also preserve non-existent elements whenever
 193 possible, i.e. for non magical arrays or tied arrays with C<EXISTS> and
 194 C<DELETE> methods.
 195
 196 =back
 197
 198 =head1 New or Changed Diagnostics
 199
 200 Several new diagnostics, see L<perldiag> for details.
 201
 202 =over 4
 203
 204 =item C<Bad plugin affecting keyword '%s'>
 205
 206 =item C<gmtime(%.0f) too large>
 207
 208 =item C<Lexing code attempted to stuff non-Latin-1 character into Latin-1 input>
 209
 210 =item C<Lexing code internal error (%s)>
 211
 212 =item C<localtime(%.0f) too large>
 213
 214 =item C<Overloaded dereference did not return a reference>
 215
 216 =item C<Overloaded qr did not return a REGEXP>
 217
 218 =item C<Perl_pmflag() is deprecated, and will be removed from the XS API>
 219
 220 =back
 221
 222 One diagnostic has been removed:
 223
 224 =over 4
 225
 226 =item C<Runaway format>
 227
 228 =back
 229
 230 =head1 Changed Internals
 231
 232 =over 4
 233
 234 =item *
 235
 236 C<Perl_pmflag> has been removed from the public API. Calling it now
 237 generates a deprecation warning, and it will be removed in a future
 238 release. Although listed as part of the API, it was never documented,
 239 and only ever used in F<toke.c>, and prior to 5.10, F<regcomp.c>. In
 240 core, it has been replaced by a static function.
 241
 242 =back
 243
 244 =head1 New Tests
 245
 246 =over 4
 247
 248 =item F<t/op/while_readdir.t>
 249
 250 Test that a bare readdir in while loop sets $_.
 251
 252 =back
 253
 254 =head1 Known Problems
 255
 256 =over 4
 257
 258 =item Known test failures on VMS
 259
 260 Perl 5.11.2 fails a small set of core and CPAN tests as of this
 261 release. With luck, that'll be sorted out for 5.11.3.
 262
 263 =back
 264
 265 =head1 Deprecations
 266
 267 The following items are now deprecated.
 268
 269 =head2 Use of C<:=> to mean an empty attribute list is now deprecated.
 270
 271 An accident of Perl's parser meant that these constructions were all
 272 equivalent:
 273
 274     my $pi := 4;
 275     my $pi : = 4;
 276     my $pi :  = 4;
 277
 278 with the C<:> being treated as the start of an attribute list, which
 279 ends before the C<=>. As whitespace is not significant here, all are
 280 parsed as an empty attribute list, hence all the above are equivalent
 281 to, and better written as
 282
 283     my $pi = 4;
 284
 285 because no attribute processing is done for an empty list.
 286
 287 As is, this meant that C<:=> cannot be used as a new token, without
 288 silently changing the meaning of existing code. Hence that particular
 289 form is now deprecated, and will become a syntax error. If it is
 290 absolutely necessary to have empty attribute lists (for example,
 291 because of a code generator) then avoid the warning by adding a space
 292 before the C<=>.
 293
 294 =head1 Acknowledgements
 295
 296 Perl 5.11.2 represents approximately 3 weeks development since Perl
 297 5.11.1 and contains 29,992 lines of changes across 458 files from 38
 298 authors and committers:
 299
 300 Abhijit Menon-Sen, Abigail, Ben Morrow, Bo Borgerson, Brad Gilbert,
 301 Bram, Chris Williams, Craig A. Berry, Daniel Frederick Crisman, Dave
 302 Rolsky, David E. Wheeler, David Golden, Eric Brine, Father
 303 Chrysostomos, Frank Wiegand, Gerard Goossen, Gisle Aas, Graham Barr,
 304 Harmen, H.Merijn Brand, Jan Dubois, Jerry D. Hedden, Jesse Vincent,
 305 Karl Williamson, Kevin Ryde, Leon Brocard, Nicholas Clark, Paul
 306 Marquess, Philippe Bruhat, Rafael Garcia-Suarez, Sisyphus, Steffen
 307 Mueller, Steve Hay, Steve Peters, Vincent Pit, Yuval Kogman, Yves
 308 Orton, and Zefram.
 309
 310 Many of the changes included in this version originated in the CPAN
 311 modules included in Perl's core. We're grateful to the entire CPAN
 312 community for helping Perl to flourish.
 313
 314 =head1 Reporting Bugs
 315
 316 If you find what you think is a bug, you might check the articles
 317 recently posted to the comp.lang.perl.misc newsgroup and the perl bug
 318 database at http://rt.perl.org/perlbug/ . There may also be information
 319 at http://www.perl.org/ , the Perl Home Page.
 320
 321 If you believe you have an unreported bug, please run the B<perlbug>
 322 program included with your release. Be sure to trim your bug down to a
 323 tiny but sufficient test case. Your bug report, along with the output
 324 of C<perl -V>, will be sent off to perlbug@perl.org to be analysed by
 325 the Perl porting team.
 326
 327 If the bug you are reporting has security implications, which make it
 328 inappropriate to send to a publicly archived mailing list, then please
 329 send it to perl5-security-report@perl.org. This points to a closed
 330 subscription unarchived mailing list, which includes all the core
 331 committers, who be able to help assess the impact of issues, figure out
 332 a resolution, and help co-ordinate the release of patches to mitigate
 333 or fix the problem across all platforms on which Perl is supported.
 334 Please only use this address for security issues in the Perl core, not
 335 for modules independently distributed on CPAN.
 336
 337 =head1 SEE ALSO
 338
 339 The F<Changes> file for an explanation of how to view exhaustive
 340 details on what changed.
 341
 342 The F<INSTALL> file for how to build Perl.
 343
 344 The F<README> file for general stuff.
 345
 346 The F<Artistic> and F<Copying> files for copyright information.
 347
 348 =cut