This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta for 9cef83062267e94311e1fd8744396e440642738e
[perl5.git] / pod / perldelta.pod
1 =encoding utf8
2
3 =for comment
4 This has been completed up to 91fad77, except for:
5 8e88cfee26d866223a6b3bfffce6270271de00db
6
7 =head1 NAME
8
9 [ this is a template for a new perldelta file. Any text flagged as
10 XXX needs to be processed before release. ]
11
12 perldelta - what is new for perl v5.13.8
13
14 =head1 DESCRIPTION
15
16 This document describes differences between the 5.13.8 release and
17 the 5.13.7 release.
18
19 If you are upgrading from an earlier release such as 5.13.6, first read
20 L<perl5137delta>, which describes differences between 5.13.6 and
21 5.13.7.
22
23 =head1 Notice
24
25 XXX Any important notices here
26
27 =head1 Core Enhancements
28
29 XXX New core language features go here. Summarise user-visible core language
30 enhancements. Particularly prominent performance optimisations could go
31 here, but most should go in the L</Performance Enhancements> section.
32
33 [ List each enhancement as a =head2 entry ]
34
35 =head2 C<-d:-foo> calls C<Devel::foo::unimport>
36
37 The syntax C<-dI<B<:>foo>> was extended in 5.6.1 to make C<-dI<:fooB<=bar>>>
38 equivalent to C<-MDevel::foo=bar>, which expands
39 internally to C<use Devel::foo 'bar';>.
40 F<perl> now allows prefixing the module name with C<->, with the same
41 semantics as C<-M>, I<i.e.>
42
43 =over 4
44
45 =item C<-d:-foo>
46
47 Equivalent to C<-M-Devel::foo>, expands to
48 C<no Devel::foo;>, calls C<< Devel::foo->unimport() >>
49 if the method exists.
50
51 =item C<-d:-foo=bar>
52
53 Equivalent to C<-M-Devel::foo=bar>, expands to C<no Devel::foo 'bar';>,
54 calls C<< Devel::foo->unimport('bar') >> if the method exists.
55
56 =back
57
58 This is particularly useful to suppresses the default actions of a
59 C<Devel::*> module's C<import> method whilst still loading it for debugging.
60
61 =head2 Filehandle method calls load IO::File on demand
62
63 When a method call on a filehandle would die because the method can not
64 be resolved and L<IO::File> has not been loaded, Perl now loads IO::File
65 via C<require> and attempts method resolution again:
66
67   open my $fh, ">", $file;
68   $fh->binmode(":raw");     # loads IO::File and succeeds
69
70 This also works for globs like STDOUT, STDERR and STDIN:
71
72   STDOUT->autoflush(1);
73
74 Because this on-demand load only happens if method resolution fails, the
75 legacy approach of manually loading an IO::File parent class for partial
76 method support still works as expected:
77
78   use IO::Handle;
79   open my $fh, ">", $file;
80   $fh->autoflush(1);        # IO::File not loaded
81
82 =head2 Full functionality for C<use feature 'unicode_strings'>
83
84 This release provides full functionality for C<use feature
85 'unicode_strings'>.  Under its scope, all string operations executed and
86 regular expressions compiled (even if executed outside its scope) have
87 Unicode semantics.   See L<feature>.
88
89 This feature avoids the "Unicode Bug" (See
90 L<perlunicode/The "Unicode Bug"> for details.)  If their is a
91 possibility that your code will process Unicode strings, you are
92 B<strongly> encouraged to use this subpragma to avoid nasty surprises.
93
94 This availability of this should strongly affect the whole tone of
95 various documents, such as L<perlunicode> and L<perluniintro>, but this
96 work has not been done yet.
97
98 =head2 Exception Handling Backcompat Hack
99
100 When an exception is thrown in an C<eval BLOCK>, C<$@> is now set before
101 unwinding, as well as being set after unwinding as the eval block exits.  This
102 early setting supports code that has historically treated C<$@> during unwinding
103 as an indicator of whether the unwinding was due to an exception.  These modules
104 had been broken by 5.13.1's change from setting C<$@> early to setting it late.
105 This double setting arrangement is a stopgap until the reason for unwinding can
106 be made properly introspectable.  C<$@> has never been a reliable indicator of
107 this.
108
109 =head2 printf-like functions understand size modifiers "hh", "z", "t", and sometimes "j"
110
111 Perl's printf and sprintf operators, and Perl's internal printf replacement
112 function, now understand the C90 size modifiers "hh" (C<char>), "z"
113 (C<size_t>), and "t" (C<ptrdiff_t>).  Also, when compiled with a C99
114 compiler, Perl now understands the size modifier "j" (C<intmax_t>).
115
116 So, for example, on any modern machine, C<sprintf('%hhd', 257)> returns '1'.
117
118 =head2 DTrace probes now include package name
119
120 The DTrace probes now include an additional argument (C<arg3>) which contains
121 the package the subroutine being entered or left was compiled in.
122
123 For example using the following DTrace script:
124
125   perl$target:::sub-entry
126   {
127       printf("%s::%s\n", copyinstr(arg0), copyinstr(arg3));
128   }
129
130 and then running:
131
132   perl -e'sub test { }; test'
133
134 DTrace will print:
135
136   main::test
137
138 =head2 Stacked labels
139
140 Multiple statement labels can now appear before a single statement.
141
142 =head1 Security
143
144 XXX Any security-related notices go here.  In particular, any security
145 vulnerabilities closed should be noted here rather than in the
146 L</Selected Bug Fixes> section.
147
148 [ List each security issue as a =head2 entry ]
149
150 =head1 Incompatible Changes
151
152 =head2 Attempting to use C<:=> as an empty attribute list is now a syntax error
153
154 Previously C<my $pi := 4;> was exactly equivalent to C<my $pi : = 4;>,
155 with the C<:> being treated as the start of an attribute list, ending before
156 the C<=>. The use of C<:=> to mean C<: => was deprecated in 5.12.0, and is now
157 a syntax error. This will allow the future use of C<:=> as a new token.
158
159 We find no Perl 5 code on CPAN using this construction, outside the core's
160 tests for it, so we believe that this change will have very little impact on
161 real-world codebases.
162
163 If it is absolutely necessary to have empty attribute lists (for example,
164 because of a code generator) then avoid the error by adding a space before
165 the C<=>.
166
167 =head2 Run-time code block in regular expressions
168
169 Code blocks in regular expressions (C<(?{...})> and C<(??{...})>) used not
170 to inherit any pragmata (strict, warnings, etc.) if the regular expression
171 was compiled at run time as happens in cases like these two:
172
173   use re 'eval';
174   $foo =~ $bar; # when $bar contains (?{...})
175   $foo =~ /$bar(?{ $finished = 1 })/;
176
177 This was a bug, which has now been fixed. But it has the potential to break
178 any code that was relying on this bug.
179
180 =head1 Deprecations
181
182 XXX Any deprecated features, syntax, modules etc. should be listed here.
183 In particular, deprecated modules should be listed here even if they are
184 listed as an updated module in the L</Modules and Pragmata> section.
185
186 [ List each deprecation as a =head2 entry ]
187
188 =head2 C<?PATTERN?> is deprecated
189
190 C<?PATTERN?> (without the initial m) has been deprecated and now produces
191 a warning.
192
193 =head2 C<sv_compile_2op> is now deprecated
194
195 The C<sv_compile_2op> is now deprecated, and will be removed. Searches suggest
196 that nothing on CPAN is using it, so this should have zero impact.
197
198 It attempted to provide an API to compile code down to an optree, but failed
199 to bind correctly to lexicals in the enclosing scope. It's not possible to
200 fix this problem within the constraints of its parameters and return value.
201
202 =head2 Tie functions on scalars holding typeglobs
203
204 Calling a tie function (C<tie>, C<tied>, C<untie>) with a scalar argument
205 acts on a file handle if the scalar happens to hold a typeglob.
206
207 This is a long-standing bug that will be removed in Perl 5.16, as
208 there is currently no way to tie the scalar itself when it holds
209 a typeglob, and no way to untie a scalar that has had a typeglob
210 assigned to it.
211
212 This bug was fixed in 5.13.7 but, because of the breakage it caused, the
213 fix has been reverted. Now there is a deprecation warning whenever a tie
214 function is used on a handle without an explicit C<*>.
215
216 =head1 Performance Enhancements
217
218 XXX Changes which enhance performance without changing behaviour go here. There
219 may well be none in a stable release.
220
221 [ List each enhancement as a =item entry ]
222
223 =over 4
224
225 =item *
226
227 XXX
228
229 =back
230
231 =head1 Modules and Pragmata
232
233 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
234 go here.  If Module::CoreList is updated, generate an initial draft of the
235 following sections using F<Porting/corelist-perldelta.pl>, which prints stub
236 entries to STDOUT.  Results can be pasted in place of the '=head2' entries
237 below.  A paragraph summary for important changes should then be added by hand.
238 In an ideal world, dual-life modules would have a F<Changes> file that could be
239 cribbed.
240
241 [ Within each section, list entries as a =item entry ]
242
243 =head2 New Modules and Pragmata
244
245 =over 4
246
247 =item *
248
249 XXX
250
251 =back
252
253 =head2 Updated Modules and Pragmata
254
255 =over 4
256
257 =item *
258
259 C<Archive::Tar> has been upgraded from version 1.72 to 1.74
260
261 =item *
262
263 C<B::Concise> has been upgraded from version 0.81 to 0.82.
264
265 It no longer produces mangled output with the C<-tree> option
266 L<[perl #80632]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=80632>.
267
268 =item *
269
270 C<Devel::SelfStubber> has been upgraded from version 1.04 to 1.05.
271
272 =item *
273
274 C<Digest::SHA> has been upgraded from 5.48 to 5.50
275
276 shasum now more closely mimics sha1sum/md5sum and Addfile
277 accepts all POSIX filenames.
278
279 =item *
280
281 C<Dumpvalue> has been upgraded from version 1.14 to 1.15.
282
283 =item *
284
285 C<Env> has been upgraded from version 1.01 to 1.02.
286
287 =item *
288
289 C<ExtUtils::CBuilder> has been upgraded from 0.2703 to 0.2802
290
291 =item *
292
293 C<ExtUtils::Embed> has been upgraded from 1.29 to 1.30.
294
295 =item *
296
297 C<if> has been upgraded from 0.06 to 0.0601.
298
299 =item *
300
301 C<Devel::SelfStubber> has been upgraded from version 1.03 to 1.04.
302
303 =item *
304
305 C<IPC::Cmd> has been upgraded from 0.64 to 0.66
306
307 Resolves an issue with splitting Win32 command lines
308 and documentation enhancements.
309
310 =item *
311
312 C<IPC::Open3> has been upgraded from 1.07 to 1.08.
313
314 =item *
315
316 C<Locale::Codes> has been upgraded from version 3.14 to 3.15
317
318 =item *
319
320 C<Memoize> has been upgraded from version 1.01_03 to 1.02.
321
322 =item *
323
324 C<MIME::Base64> has been upgraded from 3.10 to 3.13
325
326 Now provides encode_base64url and decode_base64url functions to process
327 the base64 scheme for "URL applications".
328
329 =item *
330
331 C<mro> has been upgraded from version 1.05 to 1.06.
332
333 C<next::method> I<et al.> now take into account that every class inherits
334 from UNIVERSAL
335 L<[perl #68654]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=68654>.
336
337 =item *
338
339 C<Net::Ping> has been upgraded from 2.36 to 2.37.
340
341 =item *
342
343 C<overload> has been upgraded from 1.11 to 1.12.
344
345 =item *
346
347 C<PerlIO::encoding> has been upgraded from 0.13 to 0.14.
348
349 =item *
350
351 C<PerlIO::scalar> has been upgraded from 0.10 to 0.11.
352
353 A C<read> after a C<seek> beyond the end of the string no longer thinks it
354 has data to read
355 L<[perl #78716]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78716>.
356
357 =item *
358
359 C<re> has been upgraded from 0.14 to 0.15.
360
361 =item *
362
363 C<Socket> has been upgraded from 1.91 to 1.92.
364
365 It has several new functions for handling IPv6 addresses.
366
367 =item *
368
369 C<Storable> has been upgraded from 2.24 to 2.25.
370
371 This adds support for serialising code references that contain UTF-8 strings
372 correctly. The Storable minor version number changed as a result -- this means
373 Storable users that set C<$Storable::accept_future_minor> to a C<FALSE> value
374 will see errors (see L<Storable/FORWARD COMPATIBILITY> for more details).
375
376 =item *
377
378 C<Time::HiRes> has been upgraded from 1.9721 to 1.9721_01.
379
380 =item *
381
382 C<Unicode::Collate> has been upgraded from 0.67 to 0.68
383
384 =item *
385
386 C<Unicode::UCD> has been upgraded from 0.29 to 0.30.
387
388 =item *
389
390 C<version> has been upgraded from 0.82 to 0.86.
391
392 =item *
393
394 C<Win32> has been upgraded from 0.039 to 0.040.
395
396 =back
397
398 =head2 Removed Modules and Pragmata
399
400 =over 4
401
402 =item *
403
404 XXX
405
406 =back
407
408 =head1 Documentation
409
410 XXX Changes to files in F<pod/> go here.  Consider grouping entries by
411 file and be sure to link to the appropriate page, e.g. L<perlfunc>.
412
413 =head2 New Documentation
414
415 XXX Changes which create B<new> files in F<pod/> go here.
416
417 =head3 L<XXX>
418
419 XXX Description of the purpose of the new file here
420
421 =head2 Changes to Existing Documentation
422
423 XXX Changes which significantly change existing files in F<pod/> go here.
424 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
425 section.
426
427 =head3 L<XXX>
428
429 =over 4
430
431 =item *
432
433 XXX Description of the change here
434
435 =back
436
437 =head1 Diagnostics
438
439 The following additions or changes have been made to diagnostic output,
440 including warnings and fatal error messages.  For the complete list of
441 diagnostic messages, see L<perldiag>.
442
443 XXX New or changed warnings emitted by the core's C<C> code go here. Also
444 include any changes in L<perldiag> that reconcile it to the C<C> code.
445
446 [ Within each section, list entries as a =item entry ]
447
448 =head2 New Diagnostics
449
450 XXX Newly added diagnostic messages go here
451
452 =over 4
453
454 =item *
455
456 There is a new "Closure prototype called" error.
457
458 =back
459
460 =head2 Changes to Existing Diagnostics
461
462 XXX Changes (i.e. rewording) of diagnostic messages go here
463
464 =over 4
465
466 =item *
467
468 The "Found = in conditional" warning that is emitted when a constant is
469 assigned to a variable in a condition is now withheld if the constant is
470 actually a subroutine or one generated by C<use constant>, since the value
471 of the constant may not be known at the time the program is written
472 L<[perl #77762]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=77762>.
473
474 =back
475
476 =head1 Utility Changes
477
478 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
479 here. Most of these are built within the directories F<utils> and F<x2p>.
480
481 [ List utility changes as a =head3 entry for each utility and =item
482 entries for each change
483 Use L<XXX> with program names to get proper documentation linking. ]
484
485 =head3 L<XXX>
486
487 =over 4
488
489 =item *
490
491 XXX
492
493 =back
494
495 =head1 Configuration and Compilation
496
497 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
498 go here.  Any other changes to the Perl build process should be listed here.
499 However, any platform-specific changes should be listed in the
500 L</Platform Support> section, instead.
501
502 [ List changes as a =item entry ].
503
504 =over 4
505
506 =item *
507
508 The C<Encode> module can now (once again) be included in a static Perl
509 build.  The special-case handling for this situation got broken in Perl
510 5.11.0, and has now been repaired.
511
512 =item *
513
514 XXX
515
516 =back
517
518 =head1 Testing
519
520 XXX Any significant changes to the testing of a freshly built perl should be
521 listed here.  Changes which create B<new> files in F<t/> go here as do any
522 large changes to the testing harness (e.g. when parallel testing was added).
523 Changes to existing files in F<t/> aren't worth summarising, although the bugs
524 that they represent may be covered elsewhere.
525
526 [ List each test improvement as a =item entry ]
527
528 =over 4
529
530 =item *
531
532 XXX
533
534 =back
535
536 =head1 Platform Support
537
538 XXX Any changes to platform support should be listed in the sections below.
539
540 [ Within the sections, list each platform as a =item entry with specific
541 changes as paragraphs below it. ]
542
543 =head2 New Platforms
544
545 XXX List any platforms that this version of perl compiles on, that previous
546 versions did not. These will either be enabled by new files in the F<hints/>
547 directories, or new subdirectories and F<README> files at the top level of the
548 source tree.
549
550 =over 4
551
552 =item XXX-some-platform
553
554 XXX
555
556 =back
557
558 =head2 Discontinued Platforms
559
560 XXX List any platforms that this version of perl no longer compiles on.
561
562 =over 4
563
564 =item XXX-some-platform
565
566 XXX
567
568 =back
569
570 =head2 Platform-Specific Notes
571
572 XXX List any changes for specific platforms. This could include configuration
573 and compilation changes or changes in portability/compatibility.  However,
574 changes within modules for platforms should generally be listed in the
575 L</Modules and Pragmata> section.
576
577 =over 4
578
579 =item NetBSD
580
581 The NetBSD hints file has been changed to make the system's malloc the
582 default.
583
584 =item Windows
585
586 The option to use an externally-supplied C<crypt()>, or to build with no
587 C<crypt()> at all, has been removed.  Perl supplies its own C<crypt()>
588 implementation for Windows, and the political situation that required
589 this part of the distribution to sometimes be omitted is long gone.
590
591 =back
592
593 =head1 Internal Changes
594
595 XXX Changes which affect the interface available to C<XS> code go here.
596 Other significant internal changes for future core maintainers should
597 be noted as well.
598
599 [ List each test improvement as a =item entry ]
600
601 =over 4
602
603 =item *
604
605 C<mg_findext> and C<sv_unmagicext> have been added.
606
607 These new functions allow extension authors to find and remove magic attached to
608 scalars based on both the magic type and the magic virtual table, similar to how
609 C<sv_magicext> attaches magic of a certain type and with a given virtual table
610 to a scalar. This eliminates the need for extensions to walk the list of
611 C<MAGIC> pointers of an C<SV> to find the magic that belongs to them.
612
613 =item *
614
615 The C<parse_fullexpr()>, C<parse_listexpr(), C<parse_termexpr()> and
616 C<parse_arithexpr()> functions have been added.
617
618 These are for parsing expressions at various precedence levels.
619
620 =back
621
622 =head1 Selected Bug Fixes
623
624 XXX Important bug fixes in the core language are summarised here.
625 Bug fixes in files in F<ext/> and F<lib/> are best summarised in
626 L</Modules and Pragmata>.
627
628 [ List each fix as a =item entry ]
629
630 =over 4
631
632 =item *
633
634 C<BEGIN {require 5.12.0}> now behaves as documented, rather than behaving
635 identically to C<use 5.12.0;>. Previously, C<require> in a C<BEGIN> block
636 was erroneously executing the C<use feature ':5.12.0'> and
637 C<use strict; use warnings;> behaviour, which only C<use> was documented to
638 provide
639 L<[perl #69050]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=69050>.
640
641 =item *
642
643 C<use 5.42>
644 L<[perl #69050]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=69050>,
645 C<use 6> and C<no 5> no longer leak memory.
646
647 =item *
648
649 C<eval "BEGIN{die}"> no longer leaks memory on non-threaded builds.
650
651 =item *
652
653 PerlIO no longer crashes when called recursively, e.g., from a signal
654 handler. Now it just leaks memory
655 L<[perl #75556]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=75556>.
656
657 =item *
658
659 Defining a constant with the same name as one of perl's special blocks
660 (e.g., INIT) stopped working in 5.12.0, but has now been fixed
661 L<[perl #78634]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78634>.
662
663 =item *
664
665 A reference to a literal value used as a hash key (C<$hash{\"foo"}>) used
666 to be stringified, even if the hash was tied
667 L<[perl #79178]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=79178>.
668
669 =item *
670
671 A closure containing an C<if> statement followed by a constant or variable
672 is no longer treated as a constant
673 L<[perl #63540]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=63540>.
674
675 =item *
676
677 Calling a closure prototype (what is passed to an attribute handler for a
678 closure) now results in a "Closure prototype called" error message instead
679 of a crash
680 L<[perl #68560]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=68560>.
681
682 =item *
683
684 A regular expression optimisation would sometimes cause a match with a
685 C<{n,m}> quantifier to fail when it should match
686 L<[perl #79152]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=79152>.
687
688 =item *
689
690 What has become known as the "Unicode Bug" is resolved in this release.
691 Under C<use feature 'unicode_strings'>, the internal storage format of a
692 string no longer affects the external semantics.  There are two known
693 exceptions.  User-defined case changing functions, which are planned to
694 be deprecated in 5.14, require utf8-encoded strings to function; and the
695 character C<LATIN SMALL LETTER SHARP S> in regular expression
696 case-insensitive matching has a somewhat different set of bugs depending
697 on the internal storage format.  Case-insensitive matching of all
698 characters that have multi-character matches, as this one does, is
699 problematical in Perl.
700 L<[perl #58182]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=58182>.
701
702 =item *
703
704 Mentioning a read-only lexical variable from the enclosing scope in a
705 string C<eval> would cause the variable to become writable
706 L<[perl #19135]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=19135>.
707
708 =item *
709
710 C<state> can now be used with attributes. It used to mean the same thing as
711 C<my> if attributes were present
712 L<[perl #68658]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=68658>.
713
714 =item *
715
716 Expressions like C<< @$a > 3 >> no longer cause C<$a> to be mentioned in
717 the "Use of uninitialized value in numeric gt" warning when C<$a> is
718 undefined (since it is not part of the C<E<gt>> expression, but the operand
719 of the C<@>)
720 L<[perl #72090]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=72090>.
721
722 =item *
723
724 C<require> no longer causes C<caller> to return the wrong file name for
725 the scope that called C<require> and other scopes higher up that had the
726 same file name
727 L<[perl #68712]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=68712>.
728
729 =item *
730
731 The ref types in the typemap for XS bindings now support magical variables
732 L<[perl #72684]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=72684>.
733
734 =item *
735
736 Match variables (e.g., C<$1>) no longer persist between calls to a sort
737 subroutine
738 L<[perl #76026]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=76026>.
739
740 =item *
741
742 The C<B> module was returning B::OPs instead of B::LOGOPs for C<entertry>
743 L<[perl #80622]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=80622>.
744
745 This was due to a bug in the perl core, not in C<B> itself.
746
747 =item *
748
749 Some numeric operators were converting integers to floating point,
750 resulting in loss of precision on 64-bit platforms
751 L<[perl #77456]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=77456>.
752
753 =item *
754
755 The fallback behaviour of overloading on binary operators was asymmetric
756 L<[perl #71286]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=71286>.
757
758 =back
759
760 =head1 Known Problems
761
762 XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
763 tests that had to be C<TODO>ed for the release would be noted here, unless
764 they were specific to a particular platform (see below).
765
766 This is a list of some significant unfixed bugs, which are regressions
767 from either 5.XXX.XXX or 5.XXX.XXX.
768
769 [ List each fix as a =item entry ]
770
771 =over 4
772
773 =item *
774
775 XXX
776
777 =back
778
779 =head1 Obituary
780
781 XXX If any significant core contributor has died, we've added a short obituary
782 here.
783
784 =head1 Acknowledgements
785
786 XXX The list of people to thank goes here.
787
788 =head1 Reporting Bugs
789
790 If you find what you think is a bug, you might check the articles
791 recently posted to the comp.lang.perl.misc newsgroup and the perl
792 bug database at http://rt.perl.org/perlbug/ .  There may also be
793 information at http://www.perl.org/ , the Perl Home Page.
794
795 If you believe you have an unreported bug, please run the L<perlbug>
796 program included with your release.  Be sure to trim your bug down
797 to a tiny but sufficient test case.  Your bug report, along with the
798 output of C<perl -V>, will be sent off to perlbug@perl.org to be
799 analysed by the Perl porting team.
800
801 If the bug you are reporting has security implications, which make it
802 inappropriate to send to a publicly archived mailing list, then please send
803 it to perl5-security-report@perl.org. This points to a closed subscription
804 unarchived mailing list, which includes all the core committers, who be able
805 to help assess the impact of issues, figure out a resolution, and help
806 co-ordinate the release of patches to mitigate or fix the problem across all
807 platforms on which Perl is supported. Please only use this address for
808 security issues in the Perl core, not for modules independently
809 distributed on CPAN.
810
811 =head1 SEE ALSO
812
813 The F<Changes> file for an explanation of how to view exhaustive details
814 on what changed.
815
816 The F<INSTALL> file for how to build Perl.
817
818 The F<README> file for general stuff.
819
820 The F<Artistic> and F<Copying> files for copyright information.
821
822 =cut