pod/perldelta.pod

   1 =encoding utf8
   2
   3 =for comment
   4 This has been completed up to 7cb18e1b02, except for:
   5 04777d295957ad270188e4debf51b523e07cc5b0
   6 c565ab54dc649bb62cd4d57149d7b2abb21df5f3
   7 1c8d11ca3d0ce8bc11562f159b94c2c7e62dea6c
   8
   9 =head1 NAME
  10
  11 [ this is a template for a new perldelta file. Any text flagged as
  12 XXX needs to be processed before release. ]
  13
  14 perldelta - what is new for perl v5.13.7
  15
  16 =head1 DESCRIPTION
  17
  18 This document describes differences between the 5.13.6 release and
  19 the 5.13.7 release.
  20
  21 If you are upgrading from an earlier release such as 5.13.5, first read
  22 L<perl5136delta>, which describes differences between 5.13.5 and
  23 5.13.6.
  24
  25 =head1 Notice
  26
  27 XXX Any important notices here
  28
  29 =head1 Core Enhancements
  30
  31 XXX New core language features go here. Summarise user-visible core language
  32 enhancements. Particularly prominent performance optimisations could go
  33 here, but most should go in the L</Performance Enhancements> section.
  34
  35 [ List each enhancement as a =head2 entry ]
  36
  37 =head2 Single term prototype
  38
  39 The C<+> prototype is a special alternative to C<$> that will act like
  40 C<\[@%]> when given a literal array or hash variable, but will otherwise
  41 force scalar context on the argument.  This is useful for functions which
  42 should accept either a literal array or an array reference as the argument:
  43
  44     sub smartpush (+@) {
  45         my $aref = shift;
  46         die "Not an array or arrayref" unless ref $aref eq 'ARRAY';
  47         push @$aref, @_;
  48     }
  49
  50 When using the C<+> prototype, your function must check that the argument
  51 is of an acceptable type.
  52
  53 =head2 C<use re '/flags';>
  54
  55 The C<re> pragma now has the ability to turn on regular expression flags
  56 till the end of the lexical scope:
  57
  58     use re '/x';
  59     "foo" =~ / (.+) /;  # /x implied
  60
  61 See L<re/'/flags' mode> for details.
  62
  63 =head2 Statement labels can appear in more places
  64
  65 Statement labels can now occur before any type of statement or declaration,
  66 such as C<package>.
  67
  68 =head2 C<use feature "unicode_strings"> now applies to more regex matching
  69
  70 Another chunk of the L<perlunicode/The "Unicode Bug"> is fixed in this
  71 release.  Now, regular expressions compiled within the scope of the
  72 "unicode_strings" feature (or under the "u" regex modifier (specifiable
  73 currently only with infix notation C<(?u:...)> or via C<use re '/u'>)
  74 will match the same whether or not the target string is encoded in utf8,
  75 with regard to C<[[:posix:]]> character classes
  76
  77 Work is underway to add the case sensitive matching to the control of
  78 this feature, but was not complete in time for this dot release.
  79
  80 =head2 Array and hash container functions accept references
  81
  82 All built-in functions that operate directly on array or hash
  83 containers now also accept hard references to arrays or hashes:
  84
  85   |----------------------------+---------------------------|
  86   | Traditional syntax         | Terse syntax              |
  87   |----------------------------+---------------------------|
  88   | push @$arrayref, @stuff    | push $arrayref, @stuff    |
  89   | unshift @$arrayref, @stuff | unshift $arrayref, @stuff |
  90   | pop @$arrayref             | pop $arrayref             |
  91   | shift @$arrayref           | shift $arrayref           |
  92   | splice @$arrayref, 0, 2    | splice $arrayref, 0, 2    |
  93   | keys %$hashref             | keys $hashref             |
  94   | keys @$arrayref            | keys $arrayref            |
  95   | values %$hashref           | values $hashref           |
  96   | values @$arrayref          | values $arrayref          |
  97   | ($k,$v) = each %$hashref   | ($k,$v) = each $hashref   |
  98   | ($k,$v) = each @$arrayref  | ($k,$v) = each $arrayref  |
  99   |----------------------------+---------------------------|
 100
 101 This allows these built-in functions to act on long dereferencing chains
 102 or on the return value of subroutines without needing to wrap them in
 103 C<@{}> or C<%{}>:
 104
 105   push @{$obj->tags}, $new_tag;  # old way
 106   push $obj->tags,    $new_tag;  # new way
 107
 108   for ( keys %{$hoh->{genres}{artists}} ) {...} # old way
 109   for ( keys $hoh->{genres}{artists}    ) {...} # new way
 110
 111 For C<push>, C<unshift> and C<splice>, the reference will auto-vivify
 112 if it is not defined, just as if it were wrapped with C<@{}>.
 113
 114 Calling C<keys> or C<values> directly on a reference gives a substantial
 115 performance improvement over explicit dereferencing.
 116
 117 For C<keys>, C<values>, C<each>, when overloaded dereferencing is
 118 present, the overloaded dereference is used instead of dereferencing the
 119 underlying reftype.  Warnings are issued about assumptions made in the
 120 following three ambiguous cases:
 121
 122   (a) If both %{} and @{} overloading exists, %{} is used
 123   (b) If %{} overloading exists on a blessed arrayref, %{} is used
 124   (c) If @{} overloading exists on a blessed hashref, @{} is used
 125
 126 =head1 Security
 127
 128 XXX Any security-related notices go here.  In particular, any security
 129 vulnerabilities closed should be noted here rather than in the
 130 L</Selected Bug Fixes> section.
 131
 132 [ List each security issue as a =head2 entry ]
 133
 134 =head1 Incompatible Changes
 135
 136 XXX For a release on a stable branch, this section aspires to be:
 137
 138     There are no changes intentionally incompatible with 5.XXX.XXX. If any
 139     exist, they are bugs and reports are welcome.
 140
 141 [ List each incompatible change as a =head2 entry ]
 142
 143 =head2 Dereferencing typeglobs
 144
 145 If you assign a typeglob to a scalar variable:
 146
 147     $glob = *foo;
 148
 149 the glob that is copied to C<$glob> is marked with a special flag
 150 indicating that the glob is just a copy. This allows subsequent assignments
 151 to C<$glob> to overwrite the glob. The original glob, however, is
 152 immutable.
 153
 154 Many Perl operators did not distinguish between these two types of globs.
 155 This would result in strange behaviour in edge cases: C<untie $scalar>
 156 would do nothing if the last thing assigned to the scalar was a glob
 157 (because it treated it as C<untie *$scalar>, which unties a handle).
 158 Assignment to a glob slot (e.g., C<(*$glob) = \@some_array>) would simply
 159 assign C<\@some_array> to C<$glob>.
 160
 161 To fix this, the C<*{}> operator (including the C<*foo> and C<*$foo> forms)
 162 has been modified to make a new immutable glob if its operand is a glob
 163 copy. Various operators that make a distinction between globs and scalars
 164 have been modified to treat only immutable globs as globs.
 165
 166 This causes an incompatible change in code that assigns a glob to the
 167 return value of C<*{}> when that operator was passed a glob copy. Take the
 168 following code, for instance:
 169
 170     $glob = *foo;
 171     *$glob = *bar;
 172
 173 The C<*$glob> on the second line returns a new immutable glob. That new
 174 glob is made an alias to C<*bar>. Then it is discarded.
 175
 176 The upside to this incompatible change is that bugs
 177 L<[perl #77496]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=77496>,
 178 L<[perl #77502]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=77502>,
 179 L<[perl #77508]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=77508>,
 180 L<[perl #77688]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=77688>,
 181 and
 182 L<[perl #77812]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=77812>,
 183 and maybe others, too, have been fixed.
 184
 185 See L<http://rt.perl.org/rt3/Public/Bug/Display.html?id=77810> for even
 186 more detail.
 187
 188 =head1 Deprecations
 189
 190 XXX Any deprecated features, syntax, modules etc. should be listed here.
 191 In particular, deprecated modules should be listed here even if they are
 192 listed as an updated module in the L</Modules and Pragmata> section.
 193
 194 [ List each deprecation as a =head2 entry ]
 195
 196 =head1 Performance Enhancements
 197
 198 XXX Changes which enhance performance without changing behaviour go here. There
 199 may well be none in a stable release.
 200
 201 [ List each enhancement as a =item entry ]
 202
 203 =over 4
 204
 205 =item *
 206
 207 XXX
 208
 209 =back
 210
 211 =head1 Modules and Pragmata
 212
 213 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
 214 go here.  If Module::CoreList is updated, generate an initial draft of the
 215 following sections using F<Porting/corelist-perldelta.pl>, which prints stub
 216 entries to STDOUT.  Results can be pasted in place of the '=head2' entries
 217 below.  A paragraph summary for important changes should then be added by hand.
 218 In an ideal world, dual-life modules would have a F<Changes> file that could be
 219 cribbed.
 220
 221 [ Within each section, list entries as a =item entry ]
 222
 223 =head2 New Modules and Pragmata
 224
 225 =over 4
 226
 227 =item *
 228
 229 C<Unicode::Collate::CJK::JISX0208> module was added by the C<Unicode::Collate>
 230 upgrade from 0.63 to 0.64. See below.
 231
 232 =back
 233
 234 =head2 Updated Modules and Pragmata
 235
 236 =over 4
 237
 238 =item *
 239
 240 C<Archive::Extract> has been upgraded from 0.44 to 0.46
 241
 242 Resolves an issue with NetBSD-current and its new unzip
 243 executable.
 244
 245 =item *
 246
 247 C<B> has been upgraded from 1.24 to 1.25.
 248
 249 =item *
 250
 251 C<B::Deparse> has been upgraded from 0.99 to 1.01.
 252
 253 It fixes deparsing of C<our> followed by a variable with funny characters
 254 (as permitted under the C<utf8> pragma)
 255 L<[perl #33752]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=33752>.
 256
 257 =item *
 258
 259 C<CPAN> has been upgraded from 1.94_61 to 1.94_62
 260
 261 =item *
 262
 263 C<CPANPLUS> has been upgraded from 0.9007 to 0.9010
 264
 265 Fixes for the SQLite source engine and resolving of issues with the
 266 testsuite when run under local::lib and/or cpanminus
 267
 268 =item *
 269
 270 C<CPANPLUS::Dist::Build> has been upgraded from 0.48 to 0.50
 271
 272 =item *
 273
 274 C<ExtUtils::Constant> has been upgraded from 0.22 to 0.23.
 275
 276 =item *
 277
 278 C<Fcntl> has been upgraded from 1.09 to 1.10.
 279
 280 =item *
 281
 282 C<File::Glob> has been upgraded from 1.09 to 1.10.
 283
 284 =item *
 285
 286 C<GDBM_File> has been upgraded from 1.11 to 1.12.
 287
 288 This fixes a memory leak when DBM filters are used.
 289
 290 =item *
 291
 292 C<Hash::Util> has been upgraded from 0.09 to 0.10.
 293
 294 =item *
 295
 296 C<Hash::Util::FieldHash> has been upgraded from 1.05 to 1.06.
 297
 298 =item *
 299
 300 C<I18N::Langinfo> has been upgraded from 0.06 to 0.07.
 301
 302 =item *
 303
 304 C<Locale::Maketext> has been upgraded from 1.16 to 1.17
 305
 306 =item *
 307
 308 C<Math::BigInt::FastCalc> has been upgraded from 0.22 to 0.23.
 309
 310 =item *
 311
 312 C<mro> has been upgraded from 1.04 to 1.05.
 313
 314 =item *
 315
 316 C<NDBM_File> has been upgraded from 1.09 to 1.10.
 317
 318 This fixes a memory leak when DBM filters are used.
 319
 320 =item *
 321
 322 C<ODBM_File> has been upgraded from 1.08 to 1.09.
 323
 324 This fixes a memory leak when DBM filters are used.
 325
 326 =item *
 327
 328 C<parent> has been upgraded from 0.223 to 0.224
 329
 330 =item *
 331
 332 C<POSIX> has been upgraded from 1.21 to 1.22.
 333
 334 =item *
 335
 336 C<re> has been upgraded from 0.13 to 0.14, for the sake of the new
 337 C<use re "/flags"> pragma.
 338
 339 =item *
 340
 341 C<Safe> has been upgraded from 2.28 to 2.29.
 342
 343 It adds C<&version::vxs::VCMP> to the default share.
 344
 345 =item *
 346
 347 C<SDBM_File> has been upgraded from 1.07 to 1.08.
 348
 349 =item *
 350
 351 C<SelfLoader> has been upgraded from 1.17 to 1.18.
 352
 353 It now works in taint mode
 354 L<[perl #72062]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=72062>.
 355
 356 =item *
 357
 358 C<Socket> has been upgraded from 1.90 to 1.91.
 359
 360 =item *
 361
 362 C<Sys::Hostname> has been upgraded from 1.13 to 1.14.
 363
 364 =item *
 365
 366 C<Unicode::Collate> has been upgraded from 0.63 to 0.64
 367
 368 This release newly adds locale C<ja> and the module
 369 C<Unicode::Collate::CJK::JISX0208> which makes tailoring of 6355 kanji
 370 (CJK Unified Ideographs) in the JIS X 0208 order.
 371
 372 =back
 373
 374 =head2 Removed Modules and Pragmata
 375
 376 =over 4
 377
 378 =item *
 379
 380 XXX
 381
 382 =back
 383
 384 =head1 Documentation
 385
 386 XXX Changes to files in F<pod/> go here.  Consider grouping entries by
 387 file and be sure to link to the appropriate page, e.g. L<perlfunc>.
 388
 389 =head2 New Documentation
 390
 391 XXX Changes which create B<new> files in F<pod/> go here.
 392
 393 =head3 L<XXX>
 394
 395 XXX Description of the purpose of the new file here
 396
 397 =head2 Changes to Existing Documentation
 398
 399 XXX Changes which significantly change existing files in F<pod/> go here.
 400 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
 401 section.
 402
 403 =over
 404
 405 =item *
 406
 407 Array and hash slices in scalar context are now documented in L<perldata>.
 408
 409 =item *
 410
 411 L<perlform> and L<perllocale> have been corrected to state that
 412 C<use locale> affects formats.
 413
 414 =back
 415
 416 =head3 L<XXX>
 417
 418 =over 4
 419
 420 =item *
 421
 422 XXX Description of the change here
 423
 424 =back
 425
 426 =head1 Diagnostics
 427
 428 The following additions or changes have been made to diagnostic output,
 429 including warnings and fatal error messages.  For the complete list of
 430 diagnostic messages, see L<perldiag>.
 431
 432 XXX New or changed warnings emitted by the core's C<C> code go here. Also
 433 include any changes in L<perldiag> that reconcile it to the C<C> code.
 434
 435 [ Within each section, list entries as a =item entry ]
 436
 437 =head2 New Diagnostics
 438
 439 XXX Newly added diagnostic messages go here
 440
 441 =over 4
 442
 443 =item *
 444
 445 XXX
 446
 447 =back
 448
 449 =head2 Changes to Existing Diagnostics
 450
 451 XXX Changes (i.e. rewording) of diagnostic messages go here
 452
 453 =over 4
 454
 455 =item *
 456
 457 XXX
 458
 459 =back
 460
 461 =head1 Utility Changes
 462
 463 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
 464 here. Most of these are built within the directories F<utils> and F<x2p>.
 465
 466 [ List utility changes as a =head3 entry for each utility and =item
 467 entries for each change
 468 Use L<XXX> with program names to get proper documentation linking. ]
 469
 470 =head3 L<XXX>
 471
 472 =over 4
 473
 474 =item *
 475
 476 XXX
 477
 478 =back
 479
 480 =head1 Configuration and Compilation
 481
 482 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
 483 go here.  Any other changes to the Perl build process should be listed here.
 484 However, any platform-specific changes should be listed in the
 485 L</Platform Support> section, instead.
 486
 487 [ List changes as a =item entry ].
 488
 489 =over 4
 490
 491 =item *
 492
 493 XXX
 494
 495 =back
 496
 497 =head1 Testing
 498
 499 XXX Any significant changes to the testing of a freshly built perl should be
 500 listed here.  Changes which create B<new> files in F<t/> go here as do any
 501 large changes to the testing harness (e.g. when parallel testing was added).
 502 Changes to existing files in F<t/> aren't worth summarising, although the bugs
 503 that they represent may be covered elsewhere.
 504
 505 [ List each test improvement as a =item entry ]
 506
 507 =over 4
 508
 509 =item *
 510
 511 XXX
 512
 513 =back
 514
 515 =head1 Platform Support
 516
 517 XXX Any changes to platform support should be listed in the sections below.
 518
 519 [ Within the sections, list each platform as a =item entry with specific
 520 changes as paragraphs below it. ]
 521
 522 =head2 New Platforms
 523
 524 XXX List any platforms that this version of perl compiles on, that previous
 525 versions did not. These will either be enabled by new files in the F<hints/>
 526 directories, or new subdirectories and F<README> files at the top level of the
 527 source tree.
 528
 529 =over 4
 530
 531 =item XXX-some-platform
 532
 533 XXX
 534
 535 =back
 536
 537 =head2 Discontinued Platforms
 538
 539 XXX List any platforms that this version of perl no longer compiles on.
 540
 541 =over 4
 542
 543 =item XXX-some-platform
 544
 545 XXX
 546
 547 =back
 548
 549 =head2 Platform-Specific Notes
 550
 551 XXX List any changes for specific platforms. This could include configuration
 552 and compilation changes or changes in portability/compatibility.  However,
 553 changes within modules for platforms should generally be listed in the
 554 L</Modules and Pragmata> section.
 555
 556 =over 4
 557
 558 =item Windows
 559
 560 Directory handles are now properly cloned when threads are created. In perl
 561 5.13.6, child threads simply stopped inheriting directory handles. In
 562 previous versions, threads would share handles, resulting in crashes.
 563
 564 =back
 565
 566 =head1 Internal Changes
 567
 568 XXX Changes which affect the interface available to C<XS> code go here.
 569 Other significant internal changes for future core maintainers should
 570 be noted as well.
 571
 572 [ List each test improvement as a =item entry ]
 573
 574 =over 4
 575
 576 =item *
 577
 578 C<lex_start> has been added to the API, but is considered experimental.
 579
 580 =item *
 581
 582 A new C<parse_block> function has been added to the API
 583 L<[perl #78222]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78222>.
 584
 585 =item *
 586
 587 A new, experimental API has been added for accessing the internal
 588 structure that Perl uses for C<%^H>. See the functions beginning with
 589 C<cophh_> in L<perlapi>.
 590
 591 =item *
 592
 593 A stash can now have a list of effective names in addition to its usual
 594 name. The first effective name can be accessed via the C<HvENAME> macro,
 595 which is now the recommended name to use in MRO linearisations (C<HvNAME>
 596 being a fallback if there is no C<HvENAME>).
 597
 598 These names are added and deleted via C<hv_ename_add> and
 599 C<hv_ename_delete>. These two functions are I<not> part of the API.
 600
 601 =item *
 602
 603 The way the parser handles labels has been cleaned up and refactored. As a
 604 result, the C<newFOROP()> constructor function no longer takes a parameter
 605 stating what label is to go in the state op.
 606
 607 =item *
 608
 609 The C<newWHILEOP()> and C<newFOROP()> functions no longer accept a line
 610 number as a parameter.
 611
 612 =item *
 613
 614 A new C<parse_barestmt()> function has been added, for parsing a statement
 615 without a label.
 616
 617 =item *
 618
 619 A new C<parse_label()> function has been added, that parses a statement
 620 labels, separate from statements.
 621
 622 =item *
 623
 624 The C<CvSTASH()> macro can now only be used as an rvalue. C<CvSTASH_set()>
 625 has been added to replace assignment to C<CvSTASH()>. This is to ensure
 626 that backreferences are handled properly. These macros are not part of the
 627 API.
 628
 629 =item *
 630
 631 The C<op_scope()> and C<op_lvalue()> functions have been added to the API,
 632 but are considered experimental.
 633
 634 =back
 635
 636 =head1 Selected Bug Fixes
 637
 638 XXX Important bug fixes in the core language are summarised here.
 639 Bug fixes in files in F<ext/> and F<lib/> are best summarised in
 640 L</Modules and Pragmata>.
 641
 642 [ List each fix as a =item entry ]
 643
 644 =over 4
 645
 646 =item *
 647
 648 The C<parse_stmt> C function added in earlier in the 5.13.x series has been
 649 fixed to work with statements ending with C<}>
 650 L<[perl #78222]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78222>.
 651
 652 =item *
 653
 654 The C<parse_fullstmt> C function added in 5.13.5 has been fixed to work
 655 when called while an expression is being parsed.
 656
 657 =item *
 658
 659 Characters in the Latin-1 non-ASCII range (0x80 to 0xFF) used not to match
 660 themselves if the string happened to be UTF8-encoded internally, the
 661 regular expression was not, and the character in the regular expression was
 662 inside a repeated group (e.g.,
 663 C<Encode::decode_utf8("\303\200") =~ /(\xc0)+/>)
 664 L<[perl #78464]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78464>.
 665
 666 =item *
 667
 668 The C<(?d)> regular expression construct now overrides a previous C<(?u)>
 669 or C<use feature "unicode_string">
 670 L<[perl #78508]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78508>.
 671
 672 =item *
 673
 674 A memory leak in C<do "file">, introduced in perl 5.13.6, has been fixed
 675 L<[perl #78488]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78488>.
 676
 677 =item *
 678
 679 Various bugs related to typeglob dereferencing have been fixed. See
 680 L</Dereferencing typeglobs>, above.
 681
 682 =item *
 683
 684 The C<SvPVbyte> function available to XS modules now calls magic before
 685 downgrading the SV, to avoid warnings about wide characters
 686 L<[perl #72398]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=72398>.
 687
 688 =item *
 689
 690 The C<=> operator used to ignore magic (e.g., tie methods) on its
 691 right-hand side if the scalar happened to hold a typeglob. This could
 692 happen if a typeglob was the last thing returned from or assigned to a tied
 693 scalar
 694 L<[perl #77498]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=77498>.
 695
 696 =item *
 697
 698 C<sprintf> was ignoring locales when called with constant arguments
 699 L<[perl #78632]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78632>.
 700
 701 =item *
 702
 703 A non-ASCII character in the Latin-1 range could match both a Posix
 704 class, such as C<[[:alnum:]]>, and its inverse C<[[:^alnum:]]>.  This is
 705 now fixed for regular expressions compiled under the C<"u"> modifier.
 706 See L</C<use feature "unicode_strings"> now applies to more regex matching>.
 707 L<[perl #18281]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=18281>.
 708
 709 =item *
 710
 711 Concatenating long strings under C<use encoding> no longer causes perl to
 712 crash
 713 L<[perl #78674]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78674>.
 714
 715 =item *
 716
 717 Typeglob assignments would crash if the glob's stash no longer existed, if
 718 the glob assigned to was named 'ISA' or the glob on either side of the
 719 assignment contained a subroutine.
 720
 721 =item *
 722
 723 Calling C<< ->import >> on a class lacking an import method could corrupt the stack result in strange behaviour. For instance,
 724
 725   push @a, "foo", $b = bar->import;
 726
 727 would assign 'foo' to C<$b>
 728 L<[perl #63790]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=63790>.
 729
 730 =item *
 731
 732 Creating an alias to a package when that package had been detached from the
 733 symbol table would result in corrupted isa caches
 734 L<[perl #77358]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=77358>.
 735
 736 =item *
 737
 738 C<.=> followed by C<< <> >> or C<readline> would leak memory if C<$/>
 739 contained characters beyond the octet range and the scalar assigned to
 740 happened to be encoded as UTF8 internally
 741 L<[perl #72246]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=72246>.
 742
 743 =item *
 744
 745 The C<recv> function could crash when called with the MSG_TRUNC flag
 746 L<[perl #75082]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=75082>.
 747
 748 =back
 749
 750 =head1 Known Problems
 751
 752 XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
 753 tests that had to be C<TODO>ed for the release would be noted here, unless
 754 they were specific to a particular platform (see below).
 755
 756 This is a list of some significant unfixed bugs, which are regressions
 757 from either 5.XXX.XXX or 5.XXX.XXX.
 758
 759 [ List each fix as a =item entry ]
 760
 761 =over 4
 762
 763 =item *
 764
 765 XXX
 766
 767 =back
 768
 769 =head1 Obituary
 770
 771 XXX If any significant core contributor has died, we've added a short obituary
 772 here.
 773
 774 =head1 Acknowledgements
 775
 776 XXX The list of people to thank goes here.
 777
 778 =head1 Reporting Bugs
 779
 780 If you find what you think is a bug, you might check the articles
 781 recently posted to the comp.lang.perl.misc newsgroup and the perl
 782 bug database at http://rt.perl.org/perlbug/ .  There may also be
 783 information at http://www.perl.org/ , the Perl Home Page.
 784
 785 If you believe you have an unreported bug, please run the B<perlbug>
 786 program included with your release.  Be sure to trim your bug down
 787 to a tiny but sufficient test case.  Your bug report, along with the
 788 output of C<perl -V>, will be sent off to perlbug@perl.org to be
 789 analysed by the Perl porting team.
 790
 791 If the bug you are reporting has security implications, which make it
 792 inappropriate to send to a publicly archived mailing list, then please send
 793 it to perl5-security-report@perl.org. This points to a closed subscription
 794 unarchived mailing list, which includes all the core committers, who be able
 795 to help assess the impact of issues, figure out a resolution, and help
 796 co-ordinate the release of patches to mitigate or fix the problem across all
 797 platforms on which Perl is supported. Please only use this address for
 798 security issues in the Perl core, not for modules independently
 799 distributed on CPAN.
 800
 801 =head1 SEE ALSO
 802
 803 The F<Changes> file for an explanation of how to view exhaustive details
 804 on what changed.
 805
 806 The F<INSTALL> file for how to build Perl.
 807
 808 The F<README> file for general stuff.
 809
 810 The F<Artistic> and F<Copying> files for copyright information.
 811
 812 =cut