pod/perl5112delta.pod

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