pod/perl5121delta.pod

   1 =encoding utf8
   2
   3 =head1 NAME
   4
   5 perl5121delta - what is new for perl v5.12.1
   6
   7 =head1 DESCRIPTION
   8
   9 This document describes differences between the 5.12.0 release and
  10 the 5.12.1 release.
  11
  12 If you are upgrading from an earlier release such as 5.10.1, first read
  13 L<perl5120delta>, which describes differences between 5.10.1 and
  14 5.12.0.
  15
  16 =head1 Incompatible Changes
  17
  18 There are no changes intentionally incompatible with 5.12.0. If any
  19 incompatibilities with 5.12.0 exist, they are bugs. Please report them.
  20
  21 =head1 Core Enhancements
  22
  23 Other than the bug fixes listed below, there should be no user-visible
  24 changes to the core language in this release.
  25
  26 =head1 Modules and Pragmata
  27
  28 =head2 Pragmata Changes
  29
  30 =over
  31
  32 =item *
  33
  34 We fixed exporting of C<is_strict> and C<is_lax> from L<version>.
  35
  36 These were being exported with a wrapper that treated them as method
  37 calls, which caused them to fail.  They are just functions, are
  38 documented as such, and should never be subclassed, so this patch
  39 just exports them directly as functions without the wrapper.
  40
  41 =back
  42
  43 =head2 Updated Modules
  44
  45 =over
  46
  47 =item *
  48
  49 We upgraded L<CGI.pm> to version 3.49 to incorporate fixes for regressions
  50 introduced in the release we shipped with Perl 5.12.0.
  51
  52 =item *
  53
  54 We upgraded L<Pod::Simple> to version 3.14 to get an improvement to \C\<\< \>\>
  55 parsing.
  56
  57 =item *
  58
  59 We made a small fix to the L<CPANPLUS> test suite to fix an occasional spurious test failure.
  60
  61 =item *
  62
  63 We upgraded L<Safe> to version 2.27 to wrap coderefs returned by C<reval()> and C<rdo()>.
  64
  65 =back
  66
  67 =head1 Changes to Existing Documentation
  68
  69 =over
  70
  71 =item *
  72
  73 We added the new maintenance release policy to L<perlpolicy.pod>
  74
  75 =item *
  76
  77 We've clarified the multiple-angle-bracket construct in the spec for POD
  78 in L<perlpodspec>
  79
  80 =item *
  81
  82 We added a missing explanation for a warning about C<:=> to L<perldiag.pod>
  83
  84 =item *
  85
  86 We removed a false claim in L<perlunitut> that all text strings are Unicode strings in Perl.
  87
  88 =item *
  89
  90 We updated the Github mirror link in L<perlrepository> to mirrors/perl, not github/perl
  91
  92 =item *
  93
  94 We fixed a a minor error in L<perl5114delta.pod>.
  95
  96 =item *
  97
  98 We replaced a mention of the now-obsolete L<Switch.pm> with F<given>/F<when>.
  99
 100 =item *
 101
 102 We improved documentation about F<$sitelibexp/sitecustomize.pl> in L<perlrun>.
 103
 104 =item *
 105
 106 We corrected L<perlmodlib.pod> which had unintentionally omitted a number of modules.
 107
 108 =item *
 109
 110 We updated the documentation for 'require' in L<perlfunc.pod> relating to putting Perl code in @INC.
 111
 112 =item *
 113
 114 We reinstated some erroneously-removed documentation about quotemeta in L<perlfunc>.
 115
 116 =item *
 117
 118 We fixed an F<a2p> example in L<perlutil.pod>.
 119
 120 =item  *
 121
 122 We filled in a blank in L<perlport.pod> with the release date of Perl 5.12.
 123
 124 =item  *
 125
 126 We fixed broken links in a number of perldelta files.
 127
 128 =item *
 129
 130 The documentation for L<Carp.pm> incorrectly stated that the $Carp::Verbose
 131 variable makes cluck generate stack backtraces.
 132
 133 =item *
 134
 135 We fixed a number of typos in L<Pod::Functions>
 136
 137 =item *
 138
 139 We improved documentation of case-changing functions in L<perlfunc.pod>
 140
 141 =item *
 142
 143 We corrected L<perlgpl.pod> to contain the correct version of the GNU
 144 General Public License.
 145
 146
 147
 148 =back
 149
 150 =head1 Testing
 151
 152 =head2 Testing Improvements
 153
 154 =over
 155
 156 =item *
 157
 158 F<t/op/sselect.t> is now less prone to clock jitter during timing checks
 159 on Windows.
 160
 161 sleep() time on Win32 may be rounded down to multiple of
 162 the clock tick interval.
 163
 164 =item *
 165
 166 F<lib/blib.t> and F<lib/locale.t>: Fixes for test failures on Darwin/PPC
 167
 168 =item *
 169
 170 F<perl5db.t>: Fix for test failures when C<Term::ReadLine::Gnu> is installed.
 171
 172 =back
 173
 174 =head1 Installation and Configuration Improvements
 175
 176 =head2 Configuration improvements
 177
 178 =over
 179
 180 =item *
 181
 182 We updated F<INSTALL> with notes about how to deal with broken F<dbm.h>
 183 on OpenSUSE (and possibly other platforms)
 184
 185 =back
 186
 187 =head1 Bug Fixes
 188
 189 =over 4
 190
 191 =item *
 192
 193 A bug in how we process filetest operations could cause a segfault.
 194 Filetests don't always expect an op on the stack, so we now use
 195 TOPs only if we're sure that we're not stat'ing the _ filehandle.
 196 This is indicated by OPf_KIDS (as checked in ck_ftst).
 197
 198 See also: L<http://rt.perl.org/rt3/Public/Bug/Display.html?id=74542>
 199
 200 =item *
 201
 202 When deparsing a nextstate op that has both a change of package (relative
 203 to the previous nextstate) and a label, the package declaration is now
 204 emitted first, because it is syntactically impermissible for a label to
 205 prefix a package declaration.
 206
 207 =item *
 208
 209 XSUB.h now correctly redefines fgets under PERL_IMPLICIT_SYS
 210
 211 See also: L<http://rt.cpan.org/Public/Bug/Display.html?id=55049>
 212
 213 =item *
 214
 215 utf8::is_utf8 now respects GMAGIC (e.g. $1)
 216
 217 =item *
 218
 219 XS code using C<fputc()> or C<fputs()>: on Windows could cause an error
 220 due to their arguments being swapped.
 221
 222 See also: L<http://rt.perl.org/rt3/Public/Bug/Display.html?id=72704>
 223
 224 =item *
 225
 226 We fixed a small bug in lex_stuff_pvn() that caused spurious syntax errors
 227 in an obscure situation.  It happened when stuffing was performed on the
 228 last line of a file and the line ended with a statement that lacked a
 229 terminating semicolon.
 230
 231 See also: L<http://rt.perl.org/rt3/Public/Bug/Display.html?id=74006>
 232
 233 =item *
 234
 235 We fixed a bug that could cause \N{} constructs followed by a single . to
 236 be parsed incorrectly.
 237
 238 See also: L<http://rt.perl.org/rt3/Public/Bug/Display.html?id=74978>
 239
 240 =item *
 241
 242
 243 We fixed a bug that caused when(scalar) without an argument not to be
 244 treated as a syntax error.
 245
 246 See also: L<http://rt.perl.org/rt3/Public/Bug/Display.html?id=74114>
 247
 248 =item *
 249
 250 We fixed a regression in the handling of labels immediately before string
 251 evals that was introduced in Perl 5.12.0.
 252
 253 See also: L<http://rt.perl.org/rt3/Public/Bug/Display.html?id=74290>
 254
 255 =item *
 256
 257 We fixed a regression in case-insensitive matching of folded characters
 258 in regular expressions introduced in Perl 5.10.1.
 259
 260 See also: L<http://rt.perl.org/rt3/Public/Bug/Display.html?id=72998>
 261
 262 =back
 263
 264 =head1 Platform Specific Notes
 265
 266 =head2 HP-UX
 267
 268 =over
 269
 270 =item *
 271
 272 Perl now allows -Duse64bitint without promoting to use64bitall on HP-UX
 273
 274 =back
 275
 276 =head2 AIX
 277
 278 =over
 279
 280 =item *
 281
 282 Perl now builds on AIX 4.2
 283
 284 The changes required work around AIX 4.2s' lack of support for IPv6,
 285 and limited support for POSIX C<sigaction()>.
 286
 287 =back
 288
 289 =head2 FreeBSD 7
 290
 291 =over
 292
 293 =item *
 294
 295 FreeBSD 7 no longer contains F</usr/bin/objformat>. At build time,
 296 Perl now skips the F<objformat> check for versions 7 and higher and
 297 assumes ELF.
 298
 299 =back
 300
 301 =head2 VMS
 302
 303 =over
 304
 305 =item *
 306
 307 It's now possible to build extensions on older (pre 7.3-2) VMS systems.
 308
 309 DCL symbol length was limited to 1K up until about seven years or
 310 so ago, but there was no particularly deep reason to prevent those
 311 older systems from configuring and building Perl.
 312
 313 =item *
 314
 315 We fixed the previously-broken C<-Uuseperlio> build on VMS.
 316
 317 We were checking a variable that doesn't exist in the non-default
 318 case of disabling perlio.  Now we only look at it when it exists.
 319
 320 =item *
 321
 322 We fixed the -Uuseperlio command-line option in configure.com.
 323
 324 Formerly it only worked if you went through all the questions
 325 interactively and explicitly answered no.
 326
 327 =back
 328
 329 =head1 Known Problems
 330
 331 =over
 332
 333 =item *
 334
 335 C<List::Util::first> misbehaves in the presence of a lexical C<$_>
 336 (typically introduced by C<my $_> or implicitly by C<given>). The variable
 337 which gets set for each iteration is the package variable C<$_>, not the
 338 lexical C<$_>.
 339
 340 A similar issue may occur in other modules that provide functions which
 341 take a block as their first argument, like
 342
 343     foo { ... $_ ...} list
 344
 345 See also: L<http://rt.perl.org/rt3/Public/Bug/Display.html?id=67694>
 346
 347 =item *
 348
 349 C<Module::Load::Conditional> and C<version> have an unfortunate
 350 interaction which can cause C<CPANPLUS> to crash when it encounters
 351 an unparseable version string.  Upgrading to C<CPANPLUS> 0.9004 or
 352 C<Module::Load::Conditional> 0.38 from CPAN will resolve this issue.
 353
 354 =back
 355
 356
 357 =head1 Acknowledgements
 358
 359 Perl 5.12.1 represents approximately four weeks of development since
 360 Perl 5.12.0 and contains approximately 4,000 lines of changes
 361 across 142 files from 28 authors.
 362
 363 Perl continues to flourish into its third decade thanks to a vibrant
 364 community of users and developers.  The following people are known to
 365 have contributed the improvements that became Perl 5.12.1:
 366
 367 Ævar Arnfjörð Bjarmason, Chris Williams, chromatic, Craig A. Berry,
 368 David Golden, Father Chrysostomos, Florian Ragwitz, Frank Wiegand,
 369 Gene Sullivan, Goro Fuji, H.Merijn Brand, James E Keenan, Jan Dubois,
 370 Jesse Vincent, Josh ben Jore, Karl Williamson, Leon Brocard, Michael
 371 Schwern, Nga Tang Chan, Nicholas Clark, Niko Tyni, Philippe Bruhat,
 372 Rafael Garcia-Suarez, Ricardo Signes, Steffen Mueller, Todd Rinaldo,
 373 Vincent Pit and Zefram.
 374
 375 =head1 Reporting Bugs
 376
 377 If you find what you think is a bug, you might check the articles
 378 recently posted to the comp.lang.perl.misc newsgroup and the perl
 379 bug database at http://rt.perl.org/perlbug/ .  There may also be
 380 information at http://www.perl.org/ , the Perl Home Page.
 381
 382 If you believe you have an unreported bug, please run the B<perlbug>
 383 program included with your release.  Be sure to trim your bug down
 384 to a tiny but sufficient test case.  Your bug report, along with the
 385 output of C<perl -V>, will be sent off to perlbug@perl.org to be
 386 analysed by the Perl porting team.
 387
 388 If the bug you are reporting has security implications, which make it
 389 inappropriate to send to a publicly archived mailing list, then please send
 390 it to perl5-security-report@perl.org. This points to a closed subscription
 391 unarchived mailing list, which includes
 392 all the core committers, who will be able
 393 to help assess the impact of issues, figure out a resolution, and help
 394 co-ordinate the release of patches to mitigate or fix the problem across all
 395 platforms on which Perl is supported. Please only use this address for
 396 security issues in the Perl core, not for modules independently
 397 distributed on CPAN.
 398
 399 =head1 SEE ALSO
 400
 401 The F<Changes> file for an explanation of how to view exhaustive details
 402 on what changed.
 403
 404 The F<INSTALL> file for how to build Perl.
 405
 406 The F<README> file for general stuff.
 407
 408 The F<Artistic> and F<Copying> files for copyright information.
 409
 410 =cut
 411