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 means that these constructions are 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 means 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) the
  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.
  62
  63 This feature is currently considered experimental, and using it to do
  64 anything interesting is difficult.  Many necessary supporting facilities,
  65 such as the lexer and the pad system, can only be accessed through
  66 unsupported internal interfaces.  It is intended that the Perl 5.13
  67 development cycle will see the addition of clean, supported interfaces
  68 for many of these functions.  In Perl 5.12 most uses of pluggable keywords
  69 will be via L<Devel::Declare>.
  70
  71 See L<perlapi/PL_keyword_plugin> for the mechanism.  The Perl core source
  72 distribution also includes a new module L<XS::APItest::KeywordRPN>, which
  73 implements reverse Polish notation arithmetic via pluggable keywords.
  74 This module is mainly used for test purposes, and is not normally
  75 installed, but also serves as an example of how to use the new mechanism.
  76
  77 =head2 Overridable function lookup
  78
  79 Where an extension module hooks the creation of rv2cv ops, to modify
  80 the subroutine lookup process, this now works correctly for bareword
  81 subroutine calls.  This means that prototypes on subroutines referenced
  82 this way will be processed correctly.  (Previously bareword subroutine
  83 names were initially looked up, for parsing purposes, by an unhookable
  84 mechanism, so extensions could only properly influence subroutine names
  85 that appeared with an C<&> sigil.)
  86
  87 =head1 New Platforms
  88
  89 XXX List any platforms that this version of perl compiles on, that previous
  90 versions did not. These will either be enabled by new files in the F<hints/>
  91 directories, or new subdirectories and F<README> files at the top level of the
  92 source tree.
  93
  94 =head1 Modules and Pragmata
  95
  96 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
  97 go here, in a list ordered by distribution name. Minimally it should be the
  98 module version, but it's more useful to the end user to give a paragraph's
  99 summary of the module's changes. In an ideal world, dual-life modules would
 100 have a F<Changes> file that could be cribbed.
 101
 102 =head2 New Modules and Pragmata
 103
 104 =over 4
 105
 106 =item C<XXX>
 107
 108 XXX
 109
 110 =back
 111
 112 =head2 Pragmata Changes
 113
 114 =over 4
 115
 116 =item C<XXX>
 117
 118 XXX
 119
 120 =back
 121
 122 =head2 Updated Modules
 123
 124 =over 4
 125
 126 =item C<XXX>
 127
 128 XXX
 129
 130 =back
 131
 132 =head1 Utility Changes
 133
 134 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
 135 here. Most of these are built within the directories F<utils> and F<x2p>.
 136
 137 =over 4
 138
 139 =item F<XXX>
 140
 141 XXX
 142
 143 =back
 144
 145 =head1 New Documentation
 146
 147 XXX Changes which create B<new> files in F<pod/> go here.
 148
 149 =over 4
 150
 151 =item L<XXX>
 152
 153 XXX
 154
 155 =back
 156
 157 =head1 Changes to Existing Documentation
 158
 159 XXX Changes which significantly change existing files in F<pod/> go here.
 160 Any changes to F<pod/perldiag.pod> should go in L</New or Changed Diagnostics>.
 161
 162
 163 =head1 Performance Enhancements
 164
 165 =over 4
 166
 167 =item *
 168
 169 Reversing an array in-place in void context is now several orders of magnitude faster than it used to be.
 170 It will also preserve non-existent elements whenever possible, i.e. for non magical arrays or tied arrays with C<EXISTS> and C<DELETE> methods.
 171
 172 =back
 173
 174 =head1 Installation and Configuration Improvements
 175
 176 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
 177 go here.
 178
 179 =head2 Configuration improvements
 180
 181 XXX
 182
 183 =head2 Compilation improvements
 184
 185 XXX
 186
 187 =head2 Platform Specific Changes
 188
 189 =over 4
 190
 191 =item XXX-some-platform
 192
 193 XXX
 194
 195 =back
 196
 197 =head1 Selected Bug Fixes
 198
 199 XXX Important bug fixes in the core language are summarised here.
 200 Bug fixes in files in F<ext/> and F<lib/> are best summarised in
 201 L</Modules and Pragmata>.
 202
 203 =over 4
 204
 205 =item *
 206
 207 XXX
 208
 209 =back
 210
 211 =head1 New or Changed Diagnostics
 212
 213 XXX New or changed warnings emitted by the core's C<C> code go here.
 214
 215 =over 4
 216
 217 =item C<XXX>
 218
 219 XXX
 220
 221 =back
 222
 223 =head1 Changed Internals
 224
 225 =over 4
 226
 227 =item *
 228
 229 C<Perl_pmflag> has been removed from the public API. Calling it now generates
 230 a deprecation warning, and it will be removed in a future release. Although
 231 listed as part of the API, it was never documented, and only ever used in
 232 F<toke.c>, and prior to 5.10, F<regcomp.c>. In core, it has been replaced by a
 233 static function.
 234
 235 =back
 236
 237 =head1 New Tests
 238
 239 XXX Changes which create B<new> files in F<t/> go here. Changes to
 240 existing files in F<t/> aren't worth summarising, although the bugs that
 241 they represent may be.
 242
 243 =over 4
 244
 245 =item F<XXX>
 246
 247 XXX
 248
 249 =back
 250
 251 =head1 Known Problems
 252
 253 XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
 254 tests that had to be C<TODO>ed for the release would be noted here, unless
 255 they were specific to a particular platform (see below).
 256
 257 This is a list of some significant unfixed bugs, which are regressions
 258 from either 5.10.1 or 5.11.1.
 259
 260 =over 4
 261
 262 =item *
 263
 264 XXX
 265
 266 =back
 267
 268 =head1 Deprecations
 269
 270 XXX Add any new known deprecations here.
 271
 272 The following items are now deprecated.
 273
 274 =over 4
 275
 276 =item *
 277
 278 XXX
 279
 280 =back
 281
 282 =head1 Platform Specific Notes
 283
 284 XXX Any changes specific to a particular platform. VMS and Win32 are the usual
 285 stars here. It's probably best to group changes under the same section layout
 286 as the main perldelta
 287
 288 =head1 Obituary
 289
 290 XXX If any significant core contributor has died, we've added a short obituary
 291 here.
 292
 293 =head1 Acknowledgements
 294
 295 XXX The list of people to thank goes here.
 296
 297
 298 =head1 Reporting Bugs
 299
 300 If you find what you think is a bug, you might check the articles
 301 recently posted to the comp.lang.perl.misc newsgroup and the perl
 302 bug database at http://rt.perl.org/perlbug/ .  There may also be
 303 information at http://www.perl.org/ , the Perl Home Page.
 304
 305 If you believe you have an unreported bug, please run the B<perlbug>
 306 program included with your release.  Be sure to trim your bug down
 307 to a tiny but sufficient test case.  Your bug report, along with the
 308 output of C<perl -V>, will be sent off to perlbug@perl.org to be
 309 analysed by the Perl porting team.
 310
 311 If the bug you are reporting has security implications, which make it
 312 inappropriate to send to a publicly archived mailing list, then please send
 313 it to perl5-security-report@perl.org. This points to a closed subscription
 314 unarchived mailing list, which includes all the core committers, who be able
 315 to help assess the impact of issues, figure out a resolution, and help
 316 co-ordinate the release of patches to mitigate or fix the problem across all
 317 platforms on which Perl is supported. Please only use this address for
 318 security issues in the Perl core, not for modules independently
 319 distributed on CPAN.
 320
 321 =head1 SEE ALSO
 322
 323 The F<Changes> file for an explanation of how to view exhaustive details
 324 on what changed.
 325
 326 The F<INSTALL> file for how to build Perl.
 327
 328 The F<README> file for general stuff.
 329
 330 The F<Artistic> and F<Copying> files for copyright information.
 331
 332 =cut