pod/perl5112delta.pod

   1 =head1 NAME
   2
   3 [ Any text flagged as XXX needs to be processed before release. ]
   4
   5 perldelta - what is new for perl v5.11.2
   6
   7 =head1 DESCRIPTION
   8
   9 This document describes differences between the 5.11.1 release and
  10 the 5.11.2 release.
  11
  12 =head1 Notice
  13
  14 XXX Unlikely to need this section.
  15
  16 =head1 Incompatible Changes
  17
  18 =head2 Use of C<:=> to mean an empty attribute list is now deprecated.
  19
  20 An accident of Perl's parser meant that these constructions were all equivalent:
  21
  22     my $pi := 4;
  23     my $pi : = 4;
  24     my $pi :  = 4;
  25
  26 with the C<:> being treated as the start of an attribute list, which ends
  27 before the C<=>. As whitespace is not significant here, all are parsed as an
  28 empty attribute list, hence all the above are equivalent to, and better written
  29 as
  30
  31     my $pi = 4;
  32
  33 because no attribute processing is done for an empty list.
  34
  35 As is, this meant that C<:=> cannot be used as a new token, without silently
  36 changing the meaning of existing code. Hence that particular form is now
  37 deprecated, and will become a syntax error. If it is absolutely necessary to
  38 have empty attribute lists (for example, because of a code generator) then
  39 avoid the warning by adding a space before the C<=>.
  40
  41 =head1 Core Enhancements
  42
  43 XXX New core language features go here. Summarise user-visible core language
  44 enhancements. Particularly prominent performance optimisations could go
  45 here, but most should go in the L</Performance Enhancements> section.
  46
  47 =head2 qr overloading
  48
  49 It is now possible to overload the C<qr//> operator, that is, conversion
  50 to regexp, like it was already possible to overload conversion to
  51 boolean, string or number of objects. It is invoked when an object
  52 appears on the right hand side of the C<=~> operator, or when it is
  53 interpolated into a regexp. See L<overload>.
  54
  55 =head2 Pluggable keywords
  56
  57 Extension modules can now cleanly hook into the Perl parser to define new
  58 kinds of keyword-headed expression and compound statement. The syntax
  59 following the keyword is defined entirely by the extension. This allow
  60 a completely non-Perl sublanguage to be parsed inline, with the right
  61 ops cleanly generated. This feature is currently considered experimental.
  62
  63 See L<perlapi/PL_keyword_plugin> for the mechanism. The Perl core source
  64 distribution also includes a new module L<XS::APItest::KeywordRPN>, which
  65 implements reverse Polish notation arithmetic via pluggable keywords.
  66 This module is mainly used for test purposes, and is not normally
  67 installed, but also serves as an example of how to use the new mechanism.
  68
  69 =head2 APIs for more internals
  70
  71 The lowest layers of the lexer and parts of the pad system now have C
  72 APIs available to XS extensions. These are necessary to support proper
  73 use of pluggable keywords, but have other uses too. The new APIs are
  74 experimental, and only cover a small proportion of what would be necessary
  75 to take full advantage of the core's facilities in these areas. It is
  76 intended that the Perl 5.13 development cycle will see the addition of
  77 a full range of clean, supported interfaces.
  78
  79 =head2 Overridable function lookup
  80
  81 Where an extension module hooks the creation of rv2cv ops to modify
  82 the subroutine lookup process, this now works correctly for bareword
  83 subroutine calls. This means that prototypes on subroutines referenced
  84 this way will be processed correctly. (Previously bareword subroutine
  85 names were initially looked up, for parsing purposes, by an unhookable
  86 mechanism, so extensions could only properly influence subroutine names
  87 that appeared with an C<&> sigil.)
  88
  89 =head1 New Platforms
  90
  91 XXX List any platforms that this version of perl compiles on, that previous
  92 versions did not. These will either be enabled by new files in the F<hints/>
  93 directories, or new subdirectories and F<README> files at the top level of the
  94 source tree.
  95
  96 =head1 Modules and Pragmata
  97
  98 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
  99 go here, in a list ordered by distribution name. Minimally it should be the
 100 module version, but it's more useful to the end user to give a paragraph's
 101 summary of the module's changes. In an ideal world, dual-life modules would
 102 have a F<Changes> file that could be cribbed.
 103
 104 =head2 New Modules and Pragmata
 105
 106 =over 4
 107
 108 =item C<legacy>
 109
 110 Preserves legacy behaviors or enable new non-default behaviors.
 111 Currently the only behaviour concerns semantics for the 128 characters
 112 on ASCII systems that have the 8th bit set.
 113
 114 =back
 115
 116 =head2 Pragmata Changes
 117
 118 =over 4
 119
 120 =item C<diagnostics>
 121
 122 Supports %.0f formatting internally.
 123
 124 =item C<overload>
 125
 126 Allow overloading of 'qr'.
 127
 128 =back
 129
 130 =head2 Updated Modules
 131
 132 =over 4
 133
 134 =item C<B::Concise>
 135
 136 =item C<B::Deparse>
 137
 138 =item C<Carp>
 139
 140 =item C<Compress::Zlib>
 141
 142 =item C<CPANPLUS>
 143
 144 =item C<DBM_Filter>
 145
 146 =item C<Encode>
 147
 148 =item C<ExtUtils::CBuilder>
 149
 150 =item C<Env>
 151
 152 =item C<Exporter>
 153
 154 =item C<File::Fetch>
 155
 156 =item C<I8N::Langinfo>
 157
 158 =item C<I8N::LangTags>
 159
 160 =item C<IO::Compress>
 161
 162 =item C<IPC::Cmd>
 163
 164 =item C<List::Util>
 165
 166 =item C<Locale::Maketext>
 167
 168 =item C<Module::Build>
 169
 170 =item C<Module::CoreList>
 171
 172 =item C<Pod::Perldoc>
 173
 174 =item C<Pod::Simple>
 175
 176 =item C<Scalar::Util>
 177
 178 =item C<Switch>
 179
 180 =item C<XS::APItest>
 181
 182 =back
 183
 184 =head1 Utility Changes
 185
 186 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
 187 here. Most of these are built within the directories F<utils> and F<x2p>.
 188
 189 =over 4
 190
 191 =item F<XXX>
 192
 193 XXX
 194
 195 =back
 196
 197 =head1 New Documentation
 198
 199 XXX Changes which create B<new> files in F<pod/> go here.
 200
 201 =over 4
 202
 203 =item L<XXX>
 204
 205 XXX
 206
 207 =back
 208
 209 =head1 Changes to Existing Documentation
 210
 211 XXX Changes which significantly change existing files in F<pod/> go here.
 212 Any changes to F<pod/perldiag.pod> should go in L</New or Changed Diagnostics>.
 213
 214 =head1 Performance Enhancements
 215
 216 =over 4
 217
 218 =item *
 219
 220 Reversing an array to itself (as in C<@a = reverse @a>) in void context now
 221 happens in-place and is several orders of magnitude faster than it used to be.
 222 It will also preserve non-existent elements whenever possible, i.e. for non
 223 magical arrays or tied arrays with C<EXISTS> and C<DELETE> methods.
 224
 225 =back
 226
 227 =head1 Installation and Configuration Improvements
 228
 229 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
 230 go here.
 231
 232 =head2 Configuration improvements
 233
 234 XXX
 235
 236 =head2 Compilation improvements
 237
 238 XXX
 239
 240 =head2 Platform Specific Changes
 241
 242 =over 4
 243
 244 =item XXX-some-platform
 245
 246 XXX
 247
 248 =back
 249
 250 =head1 Selected Bug Fixes
 251
 252 XXX Important bug fixes in the core language are summarised here.
 253 Bug fixes in files in F<ext/> and F<lib/> are best summarised in
 254 L</Modules and Pragmata>.
 255
 256 =over 4
 257
 258 =item *
 259
 260 XXX
 261
 262 =back
 263
 264 =head1 New or Changed Diagnostics
 265
 266 XXX New or changed warnings emitted by the core's C<C> code go here.
 267
 268 =over 4
 269
 270 =item C<XXX>
 271
 272 XXX
 273
 274 =back
 275
 276 =head1 Changed Internals
 277
 278 =over 4
 279
 280 =item *
 281
 282 C<Perl_pmflag> has been removed from the public API. Calling it now generates
 283 a deprecation warning, and it will be removed in a future release. Although
 284 listed as part of the API, it was never documented, and only ever used in
 285 F<toke.c>, and prior to 5.10, F<regcomp.c>. In core, it has been replaced by a
 286 static function.
 287
 288 =back
 289
 290 =head1 New Tests
 291
 292 XXX Changes which create B<new> files in F<t/> go here. Changes to
 293 existing files in F<t/> aren't worth summarising, although the bugs that
 294 they represent may be.
 295
 296 =over 4
 297
 298 =item F<XXX>
 299
 300 XXX
 301
 302 =back
 303
 304 =head1 Known Problems
 305
 306 XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
 307 tests that had to be C<TODO>ed for the release would be noted here, unless
 308 they were specific to a particular platform (see below).
 309
 310 This is a list of some significant unfixed bugs, which are regressions
 311 from either 5.10.1 or 5.11.1.
 312
 313 =over 4
 314
 315 =item *
 316
 317 XXX
 318
 319 =back
 320
 321 =head1 Deprecations
 322
 323 XXX Add any new known deprecations here.
 324
 325 The following items are now deprecated.
 326
 327 =over 4
 328
 329 =item *
 330
 331 XXX
 332
 333 =back
 334
 335 =head1 Platform Specific Notes
 336
 337 XXX Any changes specific to a particular platform. VMS and Win32 are the usual
 338 stars here. It's probably best to group changes under the same section layout
 339 as the main perldelta
 340
 341 =head1 Obituary
 342
 343 XXX If any significant core contributor has died, we've added a short obituary
 344 here.
 345
 346 =head1 Acknowledgements
 347
 348 XXX The list of people to thank goes here.
 349
 350
 351 =head1 Reporting Bugs
 352
 353 If you find what you think is a bug, you might check the articles
 354 recently posted to the comp.lang.perl.misc newsgroup and the perl
 355 bug database at http://rt.perl.org/perlbug/ .  There may also be
 356 information at http://www.perl.org/ , the Perl Home Page.
 357
 358 If you believe you have an unreported bug, please run the B<perlbug>
 359 program included with your release.  Be sure to trim your bug down
 360 to a tiny but sufficient test case.  Your bug report, along with the
 361 output of C<perl -V>, will be sent off to perlbug@perl.org to be
 362 analysed by the Perl porting team.
 363
 364 If the bug you are reporting has security implications, which make it
 365 inappropriate to send to a publicly archived mailing list, then please send
 366 it to perl5-security-report@perl.org. This points to a closed subscription
 367 unarchived mailing list, which includes all the core committers, who be able
 368 to help assess the impact of issues, figure out a resolution, and help
 369 co-ordinate the release of patches to mitigate or fix the problem across all
 370 platforms on which Perl is supported. Please only use this address for
 371 security issues in the Perl core, not for modules independently
 372 distributed on CPAN.
 373
 374 =head1 SEE ALSO
 375
 376 The F<Changes> file for an explanation of how to view exhaustive details
 377 on what changed.
 378
 379 The F<INSTALL> file for how to build Perl.
 380
 381 The F<README> file for general stuff.
 382
 383 The F<Artistic> and F<Copying> files for copyright information.
 384
 385 =cut