In perl.git, the branch blead has been updated <http://perl5.git.perl.org/perl.git/commitdiff/d87a032802254436136774d9e4e2b11cb35fcc6e?hp=83469c74ff807965a2f94c233cd2780970531683>
- Log ----------------------------------------------------------------- commit d87a032802254436136774d9e4e2b11cb35fcc6e Author: David Mitchell <[email protected]> Date: Thu May 25 09:13:36 2017 +0100 remove perl525*delta.pod M MANIFEST M pod/perl.pod D pod/perl5250delta.pod D pod/perl52510delta.pod D pod/perl52511delta.pod D pod/perl52512delta.pod D pod/perl5251delta.pod D pod/perl5252delta.pod D pod/perl5253delta.pod D pod/perl5254delta.pod D pod/perl5255delta.pod D pod/perl5256delta.pod D pod/perl5257delta.pod D pod/perl5258delta.pod D pod/perl5259delta.pod M win32/pod.mak commit df512de60d2cb9acc6da21de4438a7531bfd7286 Author: David Mitchell <[email protected]> Date: Thu May 25 09:10:54 2017 +0100 perldelta: remove mention of comp.lang.perl.misc M pod/perldelta.pod ----------------------------------------------------------------------- Summary of changes: MANIFEST | 13 - pod/perl.pod | 13 - pod/perl5250delta.pod | 95 ------- pod/perl52510delta.pod | 259 ----------------- pod/perl52511delta.pod | 201 -------------- pod/perl52512delta.pod | 140 ---------- pod/perl5251delta.pod | 421 ---------------------------- pod/perl5252delta.pod | 482 -------------------------------- pod/perl5253delta.pod | 492 --------------------------------- pod/perl5254delta.pod | 429 ----------------------------- pod/perl5255delta.pod | 326 ---------------------- pod/perl5256delta.pod | 413 ---------------------------- pod/perl5257delta.pod | 733 ------------------------------------------------- pod/perl5258delta.pod | 213 -------------- pod/perl5259delta.pod | 678 --------------------------------------------- pod/perldelta.pod | 3 +- win32/pod.mak | 52 ---- 17 files changed, 1 insertion(+), 4962 deletions(-) delete mode 100644 pod/perl5250delta.pod delete mode 100644 pod/perl52510delta.pod delete mode 100644 pod/perl52511delta.pod delete mode 100644 pod/perl52512delta.pod delete mode 100644 pod/perl5251delta.pod delete mode 100644 pod/perl5252delta.pod delete mode 100644 pod/perl5253delta.pod delete mode 100644 pod/perl5254delta.pod delete mode 100644 pod/perl5255delta.pod delete mode 100644 pod/perl5256delta.pod delete mode 100644 pod/perl5257delta.pod delete mode 100644 pod/perl5258delta.pod delete mode 100644 pod/perl5259delta.pod diff --git a/MANIFEST b/MANIFEST index 197c7046a7..0a3757ea3b 100644 --- a/MANIFEST +++ b/MANIFEST @@ -4931,19 +4931,6 @@ pod/perl5222delta.pod Perl changes in version 5.22.2 pod/perl5223delta.pod Perl changes in version 5.22.3 pod/perl5240delta.pod Perl changes in version 5.24.0 pod/perl5241delta.pod Perl changes in version 5.24.1 -pod/perl5250delta.pod Perl changes in version 5.25.0 -pod/perl52510delta.pod Perl changes in version 5.25.10 -pod/perl52511delta.pod Perl changes in version 5.25.11 -pod/perl52512delta.pod Perl changes in version 5.25.12 -pod/perl5251delta.pod Perl changes in version 5.25.1 -pod/perl5252delta.pod Perl changes in version 5.25.2 -pod/perl5253delta.pod Perl changes in version 5.25.3 -pod/perl5254delta.pod Perl changes in version 5.25.4 -pod/perl5255delta.pod Perl changes in version 5.25.5 -pod/perl5256delta.pod Perl changes in version 5.25.6 -pod/perl5257delta.pod Perl changes in version 5.25.7 -pod/perl5258delta.pod Perl changes in version 5.25.8 -pod/perl5259delta.pod Perl changes in version 5.25.9 pod/perl561delta.pod Perl changes in version 5.6.1 pod/perl56delta.pod Perl changes in version 5.6 pod/perl581delta.pod Perl changes in version 5.8.1 diff --git a/pod/perl.pod b/pod/perl.pod index 46f746558e..8e2041cb3b 100644 --- a/pod/perl.pod +++ b/pod/perl.pod @@ -181,19 +181,6 @@ aux h2ph h2xs perlbug pl2pm pod2html pod2man splain xsubpp perlhist Perl history records perldelta Perl changes since previous version - perl52512delta Perl changes in version 5.25.12 - perl52511delta Perl changes in version 5.25.11 - perl52510delta Perl changes in version 5.25.10 - perl5259delta Perl changes in version 5.25.9 - perl5258delta Perl changes in version 5.25.8 - perl5257delta Perl changes in version 5.25.7 - perl5256delta Perl changes in version 5.25.6 - perl5255delta Perl changes in version 5.25.5 - perl5254delta Perl changes in version 5.25.4 - perl5253delta Perl changes in version 5.25.3 - perl5252delta Perl changes in version 5.25.2 - perl5251delta Perl changes in version 5.25.1 - perl5250delta Perl changes in version 5.25.0 perl5241delta Perl changes in version 5.24.1 perl5240delta Perl changes in version 5.24.0 perl5223delta Perl changes in version 5.22.3 diff --git a/pod/perl5250delta.pod b/pod/perl5250delta.pod deleted file mode 100644 index c8a6d13bbf..0000000000 --- a/pod/perl5250delta.pod +++ /dev/null @@ -1,95 +0,0 @@ -=encoding utf8 - -=head1 NAME - -[ this is a template for a new perldelta file. Any text flagged as XXX needs -to be processed before release. ] - -perl5250delta - what is new for perl v5.25.0 - -=head1 DESCRIPTION - -This document describes differences between the 5.24.0 release and the 5.25.0 -release. - -=head1 Known Problems - -=over 4 - -=item * - -Some modules have been broken by the L<context stack rework|/Internal Changes>. -These modules were relying on non-guaranteed implementation details in perl. -Their maintainers have been informed, and should contact perl5-porters for -advice if needed. Below is a subset of these modules: - -=over 4 - -=item L<Algorithm::Permute> - -=item L<Coro> - -L<Coro> and perl v5.22.0 were already incompatible due to a change in the perl, -and the reworking on the perl context stack creates a further incompatibility. -perl5-porters has L<discussed the issue on the mailing -list|http://www.nntp.perl.org/group/perl.perl5.porters/2016/05/msg236174.html>. - -=item L<Data::Alias> - -=item L<RPerl> - -=item L<Scope::Upper> - -=item L<TryCatch> - -=back - -=item * - -The module L<lexical::underscore> no longer works on perl v5.24.0, because perl -no longer has a lexical C<$_>! - -=item * - -C<mod_perl> has been patched for compatibility for v5.22.0 and later but no -release has been made. The relevant patch (and other changes) can be found in -their source code repository, L<mirrored at -GitHub|https://github.com/apache/mod_perl/commit/82827132efd3c2e25cc413c85af61bb63375da6e>. - -=back - -=head1 Acknowledgements - -XXX Generate this with: - - perl Porting/acknowledgements.pl v5.24.0..HEAD - -=head1 Reporting Bugs - -If you find what you think is a bug, you might check the articles recently -posted to the comp.lang.perl.misc newsgroup and the perl bug database at -L<https://rt.perl.org/> . There may also be information at -L<http://www.perl.org/> , the Perl Home Page. - -If you believe you have an unreported bug, please run the L<perlbug> program -included with your release. Be sure to trim your bug down to a tiny but -sufficient test case. Your bug report, along with the output of C<perl -V>, -will be sent off to [email protected] to be analysed by the Perl porting team. - -If the bug you are reporting has security implications which make it -inappropriate to send to a publicly archived mailing list, then see -L<perlsec/SECURITY VULNERABILITY CONTACT INFORMATION> -for details of how to report the issue. - -=head1 SEE ALSO - -The F<Changes> file for an explanation of how to view exhaustive details on -what changed. - -The F<INSTALL> file for how to build Perl. - -The F<README> file for general stuff. - -The F<Artistic> and F<Copying> files for copyright information. - -=cut diff --git a/pod/perl52510delta.pod b/pod/perl52510delta.pod deleted file mode 100644 index 5d5d02d297..0000000000 --- a/pod/perl52510delta.pod +++ /dev/null @@ -1,259 +0,0 @@ -=encoding utf8 - -=head1 NAME - -perl52510delta - what is new for perl v5.25.10 - -=head1 DESCRIPTION - -This document describes differences between the 5.25.9 release and the 5.25.10 -release. - -If you are upgrading from an earlier release such as 5.25.8, first read -L<perl5259delta>, which describes differences between 5.25.8 and 5.25.9. - -=head1 Modules and Pragmata - -=head2 Updated Modules and Pragmata - -=over 4 - -=item * - -L<B> has been upgraded from version 1.65 to 1.68. - -=item * - -L<CPAN> has been upgraded from version 2.16 to 2.17. - -=item * - -L<feature> has been upgraded from version 1.46 to 1.47. - -=item * - -L<Getopt::Std> has been upgraded from version 1.11 to 1.12. - -=item * - -L<Module::CoreList> has been upgraded from version 5.20170120 to 5.20170220. - -=item * - -L<open> has been upgraded from version 1.10 to 1.11. - -=item * - -L<PerlIO> has been upgraded from version 1.09 to 1.10. - -=item * - -L<Storable> has been upgraded from version 2.61 to 2.62. - -=item * - -L<Thread::Queue> has been upgraded from version 3.11 to 3.12. - -=item * - -L<threads> has been upgraded from version 2.12 to 2.13. - -=back - -=head1 Diagnostics - -The following additions or changes have been made to diagnostic output, -including warnings and fatal error messages. For the complete list of -diagnostic messages, see L<perldiag>. - -=head2 Changes to Existing Diagnostics - -=over 4 - -=item * - -Use of unassigned code point or non-standalone grapheme for a delimiter will be a fatal error starting in Perl 5.30 - -This was changed to drop a leading C<v> in C<v5.30>, so it uses the same -style as other deprecation messages. - -=item * - -"\c%c" is more clearly written simply as "%s". - -It was decided to undeprecate the use of "\c%c", see L<http://www.nntp.perl.org/group/perl.perl5.porters/2017/02/msg242944.html> - -=back - -=head1 Platform Support - -=head2 Platform-Specific Notes - -=over 4 - -=item Windows - -=over 4 - -=item * - -Support for compiling perl on Windows using Microsoft Visual Studio 2015 -(containing Visual C++ 14.0) has been added. - -This version of VC++ includes a completely rewritten C run-time library, some -of the changes in which mean that work done to resolve a socket close() bug in -perl #120091 and perl #118059 is not workable in its current state with this -version of VC++. Therefore, we have effectively reverted that bug fix for -VS2015 onwards on the basis that being able to build with VS2015 onwards is -more important than keeping the bug fix. We may revisit this in the future to -attempt to fix the bug again in a way that is compatible with VS2015. - -These changes do not affect compilation with GCC or with Visual Studio versions -up to and including VS2013, i.e. the bug fix is retained (unchanged) for those -compilers. - -Note that you may experience compatibility problems if you mix a perl built -with GCC or VS E<lt>= VS2013 with XS modules built with VS2015, or if you mix a -perl built with VS2015 with XS modules built with GCC or VS E<lt>= VS2013. -Some incompatibility may arise because of the bug fix that has been reverted -for VS2015 builds of perl, but there may well be incompatibility anyway because -of the rewritten CRT in VS2015 (e.g. see discussion at -http://stackoverflow.com/questions/30412951). - -=back - -=back - -=head1 Internal Changes - -=over 4 - -=item * - -The C<op_class()> API function has been added. This is like the existing -C<OP_CLASS()> macro, but can more accurately determine what struct an op -has been allocated as. For example C<OP_CLASS()> might return -C<OA_BASEOP_OR_UNOP> indicating that ops of this type are usually -allocated as an C<OP> or C<UNOP>; while C<op_class()> will return -C<OPclass_BASEOP> or C<OPclass_UNOP> as appropriate. - -=item * - -The output format of the C<op_dump()> function (as used by C<perl -Dx>) -has changed: it now displays an "ASCII-art" tree structure, and shows more -low-level details about each op, such as its address and class. - -=back - -=head1 Selected Bug Fixes - -=over 4 - -=item * - -Attempting to use the deprecated variable C<$#> as the object in an -indirect object method call could cause a heap use after free or -buffer overflow. [perl #129274] - -=item * - -When checking for an indirect object method call in some rare cases -the parser could reallocate the line buffer but then continue to use -pointers to the old buffer. [perl #129190] - -=item * - -Supplying a glob as the format argument to L<perlfunc/formline> would -cause an assertion failure. [perl #130722] - -=item * - -Code like C< $value1 =~ qr/.../ ~~ $value2 > would have the match -converted into a qr// operator, leaving extra elements on the stack to -confuse any surrounding expression. [perl #130705] - -=item * - -Since 5.24.0 in some obscure cases, a regex which included code blocks -from multiple sources (e.g. via embedded via qr// objects) could end up -with the wrong current pad and crash or give weird results. [perl #129881] - -=item * - -Occasionally C<local()>s in a code block within a patterns weren't being -undone when the pattern matching backtracked over the code block. -[perl #126697] - -=item * - -Using C<substr()> to modify a magic variable could access freed memory -in some cases. [perl #129340] - -=item * - -Perl 5.25.9 was fixed so that under C<use utf8>, the entire Perl program -is checked that the UTF-8 is wellformed. It turns out that several edge -cases were missed, and are now fixed. [perl #126310] was the original -ticket. - -=back - -=head1 Acknowledgements - -Perl 5.25.10 represents approximately 4 weeks of development since Perl 5.25.9 -and contains approximately 12,000 lines of changes across 200 files from 25 -authors. - -Excluding auto-generated files, documentation and release tools, there were -approximately 6,700 lines of changes to 130 .pm, .t, .c and .h files. - -Perl continues to flourish into its third decade thanks to a vibrant community -of users and developers. The following people are known to have contributed the -improvements that became Perl 5.25.10: - -Aaron Crane, Abigail, Andreas König, Andy Lester, Chris 'BinGOs' Williams, -Christian Millour, Colin Newell, Dagfinn Ilmari Mannsåker, David Mitchell, -Hugo van der Sanden, James E Keenan, Jarkko Hietaniemi, Jerry D. Hedden, John -Lightsey, Karl Williamson, Neil Bowers, Pali, Renee Baecker, Sawyer X, Sergey -Aleynikov, Steffen Müller, Steve Hay, Tony Cook, Yves Orton, Zefram. - -The list above is almost certainly incomplete as it is automatically generated -from version control history. In particular, it does not include the names of -the (very much appreciated) contributors who reported issues to the Perl bug -tracker. - -Many of the changes included in this version originated in the CPAN modules -included in Perl's core. We're grateful to the entire CPAN community for -helping Perl to flourish. - -For a more complete list of all of Perl's historical contributors, please see -the F<AUTHORS> file in the Perl source distribution. - -=head1 Reporting Bugs - -If you find what you think is a bug, you might check the perl bug database -at L<https://rt.perl.org/> . There may also be information at -L<http://www.perl.org/> , the Perl Home Page. - -If you believe you have an unreported bug, please run the L<perlbug> program -included with your release. Be sure to trim your bug down to a tiny but -sufficient test case. Your bug report, along with the output of C<perl -V>, -will be sent off to [email protected] to be analysed by the Perl porting team. - -If the bug you are reporting has security implications which make it -inappropriate to send to a publicly archived mailing list, then see -L<perlsec/SECURITY VULNERABILITY CONTACT INFORMATION> -for details of how to report the issue. - -=head1 SEE ALSO - -The F<Changes> file for an explanation of how to view exhaustive details on -what changed. - -The F<INSTALL> file for how to build Perl. - -The F<README> file for general stuff. - -The F<Artistic> and F<Copying> files for copyright information. - -=cut diff --git a/pod/perl52511delta.pod b/pod/perl52511delta.pod deleted file mode 100644 index a34f0afac3..0000000000 --- a/pod/perl52511delta.pod +++ /dev/null @@ -1,201 +0,0 @@ -=encoding utf8 - -=head1 NAME - -perl52511delta - what is new for perl v5.25.11 - -=head1 DESCRIPTION - -This document describes differences between the 5.25.10 release and the 5.25.11 -release. - -If you are upgrading from an earlier release such as 5.25.9, first read -L<perl52510delta>, which describes differences between 5.25.9 and 5.25.10. - -=head1 Notice - -This release includes two important updates: - -=over 4 - -=item * Turning on the removal of C<.> in C<@INC> - -=item * Providing a warning when C<do> is used on a file in C<.> - -=back - -=head1 Security - -=head2 Remove current dir (C<.>) from C<@INC> - -For security reasons, C<@INC> no longer contains the default directory -(C<.>). - -=head1 Modules and Pragmata - -=head2 Updated Modules and Pragmata - -=over 4 - -=item * - -L<Compress::Raw::Bzip2> has been upgraded from version 2.070 to 2.074. - -=item * - -L<Compress::Raw::Zlib> has been upgraded from version 2.070 to 2.074. - -=item * - -L<Config::Perl::V> has been upgraded from version 0.27 to 0.28. - -=item * - -L<ExtUtils::ParseXS> has been upgraded from version 3.33 to 3.34. - -=item * - -L<ExtUtils::Typemaps> has been upgraded from version 3.33 to 3.34. - -=item * - -L<File::Spec> has been upgraded from version 3.66 to 3.67. - -=item * - -L<Module::CoreList> has been upgraded from version 5.20170220 to 5.20170320. - -=item * - -L<Pod::Perldoc> has been upgraded from version 3.27 to 3.28. - -=item * - -L<Test::Harness> has been upgraded from version 3.36_01 to 3.38. - -=item * - -L<threads> has been upgraded from version 2.13 to 2.15. - -=item * - -L<threads::shared> has been upgraded from version 1.54 to 1.55. - -=item * - -L<VMS::Stdio> has been upgraded from version 2.42 to 2.41. - -=back - -=head1 Diagnostics - -=head2 New Diagnostics - -=head3 New Warnings - -=over 4 - -=item * - -Since C<.> is removed from C<@INC>, C<do> will now trigger a warning -recommending on fixing the C<do> statement. - -L<do "%s" failed, '.' is no longer in @INC|perldiag/"do "%s" failed, '.' is no longer in @INC"> - -=back - -=head1 Configuration and Compilation - -=over 4 - -=item * - -C<DEFAULT_INC_EXCLUDES_DOT> has been turned on as default. - -=back - -=head1 Selected Bug Fixes - -=over 4 - -=item * - -C< $-{$name} > would leak an C<AV> on each access if the regular -expression had no named captures. The same applies to access to any -hash tied with L<Tie::Hash::NamedCapture> and C<< all =E<gt> 1 >>. [perl -#130822] - -=back - -=head1 Obituary - -It is with great sadness we note that Kip Hampton passed away. Probably -best known as the author of the Perl & XML column on XML.com, he was a -core contributor to AxKit, an XML server platform that became an Apache -Foundation project. He was a frequent speaker in the early days at -OSCON, and most recently at YAPC::NA in Madison. He was frequently on -irc.perl.org as `ubu`, generally in the #axkit-dahut community, the -group responsible for YAPC::NA Asheville in 2011. - -Kip and his constant contributions to the community will be greatly missed. - -=head1 Acknowledgements - - -Perl 5.25.11 represents approximately 4 weeks of development since Perl 5.25.10 -and contains approximately 4,900 lines of changes across 240 files from 21 -authors. - -Excluding auto-generated files, documentation and release tools, there were -approximately 2,200 lines of changes to 170 .pm, .t, .c and .h files. - -Perl continues to flourish into its third decade thanks to a vibrant community -of users and developers. The following people are known to have contributed the -improvements that became Perl 5.25.11: - -Aaron Crane, Andy Lester, Chris 'BinGOs' Williams, Craig A. Berry, Dave Cross, -David Golden, David Mitchell, Dominic Hargreaves, H.Merijn Brand, Hugo van der -Sanden, James E Keenan, Jarkko Hietaniemi, Jerry D. Hedden, Karl Williamson, -Leon Timmermans, Matthew Horsfall, Renee Baecker, Sawyer X, Shlomi Fish, Steve -Hay, Tony Cook. - -The list above is almost certainly incomplete as it is automatically generated -from version control history. In particular, it does not include the names of -the (very much appreciated) contributors who reported issues to the Perl bug -tracker. - -Many of the changes included in this version originated in the CPAN modules -included in Perl's core. We're grateful to the entire CPAN community for -helping Perl to flourish. - -For a more complete list of all of Perl's historical contributors, please see -the F<AUTHORS> file in the Perl source distribution. - -=head1 Reporting Bugs - -If you find what you think is a bug, you might check the perl bug database -at L<https://rt.perl.org/> . There may also be information at -L<http://www.perl.org/> , the Perl Home Page. - -If you believe you have an unreported bug, please run the L<perlbug> program -included with your release. Be sure to trim your bug down to a tiny but -sufficient test case. Your bug report, along with the output of C<perl -V>, -will be sent off to [email protected] to be analysed by the Perl porting team. - -If the bug you are reporting has security implications which make it -inappropriate to send to a publicly archived mailing list, then see -L<perlsec/SECURITY VULNERABILITY CONTACT INFORMATION> -for details of how to report the issue. - -=head1 SEE ALSO - -The F<Changes> file for an explanation of how to view exhaustive details on -what changed. - -The F<INSTALL> file for how to build Perl. - -The F<README> file for general stuff. - -The F<Artistic> and F<Copying> files for copyright information. - -=cut diff --git a/pod/perl52512delta.pod b/pod/perl52512delta.pod deleted file mode 100644 index 9ef471e859..0000000000 --- a/pod/perl52512delta.pod +++ /dev/null @@ -1,140 +0,0 @@ -=encoding utf8 - -=head1 NAME - -perl52512delta - what is new for perl v5.25.12 - -=head1 DESCRIPTION - -This document describes differences between the 5.25.11 release and the 5.25.12 -release. - -If you are upgrading from an earlier release such as 5.25.10, first read -L<perl52511delta>, which describes differences between 5.25.10 and 5.25.11. - -=head1 Modules and Pragmata - -=head2 Updated Modules and Pragmata - -=over 4 - -=item * - -L<base> has been upgraded from version 2.24 to 2.25. - -=item * - -L<CPAN> has been upgraded from version 2.17 to 2.18. - -=item * - -L<DynaLoader> has been upgraded from version 1.41 to 1.42. - -=item * - -L<Module::CoreList> has been upgraded from version 5.20170320 to -5.20170420. - -=item * - -L<Safe> has been upgraded from version 2.39 to 2.40. - -=item * - -L<threads::shared> has been upgraded from version 1.55 to 1.56. - -=item * - -L<XSLoader> has been upgraded from version 0.26 to 0.27. - -=back - -=head1 Diagnostics - -=head2 New Diagnostics - -=head3 New Errors - -=over 4 - -=item * - -Since C<.> is now removed from C<@INC> by default, C<do> will now trigger -a warning recommending to fix the C<do> statement: - -L<do "%s" failed, '.' is no longer in @INC|perldiag/do "%s" failed, '.' is no longer in @INC; did you mean do ".E<sol>%s"?> - -=back - -=head2 Changes to Existing Diagnostics - -=over 4 - -=item * - -When a C<require> fails, we now do not provide C<@INC> when the C<require> -is for a file instead of a module. - -=item * - -When C<@INC> is not scanned for a C<require> call, we no longer display -C<@INC> to avoid confusion. - -=back - -=head1 Acknowledgements - -Perl 5.25.12 represents approximately 4 weeks of development since Perl 5.25.11 -and contains approximately 1,700 lines of changes across 150 files from 8 -authors. - -Excluding auto-generated files, documentation and release tools, there were -approximately 700 lines of changes to 73 .pm, .t, .c and .h files. - -Perl continues to flourish into its third decade thanks to a vibrant community -of users and developers. The following people are known to have contributed the -improvements that became Perl 5.25.12: - -Chris 'BinGOs' Williams, Dagfinn Ilmari Mannsåker, David Mitchell, James E -Keenan, Jarkko Hietaniemi, Karl Williamson, Pali, Sawyer X. - -The list above is almost certainly incomplete as it is automatically generated -from version control history. In particular, it does not include the names of -the (very much appreciated) contributors who reported issues to the Perl bug -tracker. - -Many of the changes included in this version originated in the CPAN modules -included in Perl's core. We're grateful to the entire CPAN community for -helping Perl to flourish. - -For a more complete list of all of Perl's historical contributors, please see -the F<AUTHORS> file in the Perl source distribution. - -=head1 Reporting Bugs - -If you find what you think is a bug, you might check the perl bug database -at L<https://rt.perl.org/> . There may also be information at -L<http://www.perl.org/> , the Perl Home Page. - -If you believe you have an unreported bug, please run the L<perlbug> program -included with your release. Be sure to trim your bug down to a tiny but -sufficient test case. Your bug report, along with the output of C<perl -V>, -will be sent off to [email protected] to be analysed by the Perl porting team. - -If the bug you are reporting has security implications which make it -inappropriate to send to a publicly archived mailing list, then see -L<perlsec/SECURITY VULNERABILITY CONTACT INFORMATION> -for details of how to report the issue. - -=head1 SEE ALSO - -The F<Changes> file for an explanation of how to view exhaustive details on -what changed. - -The F<INSTALL> file for how to build Perl. - -The F<README> file for general stuff. - -The F<Artistic> and F<Copying> files for copyright information. - -=cut diff --git a/pod/perl5251delta.pod b/pod/perl5251delta.pod deleted file mode 100644 index b61511261a..0000000000 --- a/pod/perl5251delta.pod +++ /dev/null @@ -1,421 +0,0 @@ -=encoding utf8 - -=head1 NAME - -perl5251delta - what is new for perl v5.25.1 - -=head1 DESCRIPTION - -This document describes differences between the 5.25.0 release and the 5.25.1 -release. - -If you are upgrading from an earlier release such as 5.24.0, first read -L<perl5250delta>, which describes differences between 5.24.0 and 5.25.0. - -=head1 Core Enhancements - -=head2 POSIX::tmpnam() has been removed - -The fundamentally unsafe C<tmpnam()> interface was deprecated in -Perl 5.22.0 and has now been removed. In its place you can use -for example the L<File::Temp> interfaces. - -=head2 require ::Foo::Bar is now illegal. - -Formerly, C<require ::Foo::Bar> would try to read F</Foo/Bar.pm>. Now any -bareword require which starts with a double colon dies instead. - -=head2 Unescaped literal C<"{"> characters in regular expression -patterns are no longer permissible - -You have to now say something like C<"\{"> or C<"[{]"> to specify to -match a LEFT CURLY BRACKET. This will allow future extensions to the -language. This restriction is not enforced, nor are there current plans -to enforce it, if the C<"{"> is the first character in the pattern. - -These have been deprecated since v5.16, with a deprecation message -displayed starting in v5.22. - -=head2 Literal control character variable names are no longer permissible - -A variable name may no longer contain a literal control character under -any circumstances. These previously were allowed in single-character -names on ASCII platforms, but have been deprecated there since Perl -v5.20. This affects things like C<$I<\cT>>, where I<\cT> is a literal -control (such as a C<NAK> or C<NEGATIVE ACKNOWLEDGE> character) in the -source code. - -=head2 C<qr//xx> is no longer permissible - -Using more than one C</x> regular expression pattern modifier on a -single pattern is now forbidden. This is to allow a future enhancement -to the language. This usage has been deprecated since v5.22. - -=head2 C<NBSP> is no longer permissible in C<\N{...}> - -The name of a character may no longer contain non-breaking spaces. It -has been deprecated to do so since Perl v5.22. - -=head1 Performance Enhancements - -=over 4 - -=item * - -Bareword constant strings are now permitted to take part in constant -folding. They were originally exempted from constant folding in August 1999, -during the development of Perl 5.6, to ensure that C<use strict "subs"> -would still apply to bareword constants. That has now been accomplished a -different way, so barewords, like other constants, now gain the performance -benefits of constant folding. - -This also means that void-context warnings on constant expressions of -barewords now report the folded constant operand, rather than the operation; -this matches the behaviour for non-bareword constants. - -=back - -=head1 Modules and Pragmata - -=head2 Updated Modules and Pragmata - -=over 4 - -=item * - -L<Archive::Tar> has been upgraded from version 2.04 to 2.08. - -=item * - -L<Carp> has been upgraded from version 1.40 to 1.41. - -=item * - -L<charnames> has been upgraded from version 1.43 to 1.44. - -=item * - -L<Config::Perl::V> has been upgraded from version 0.25 to 0.26. - -=item * - -L<DB_File> has been upgraded from version 1.835 to 1.838. - -=item * - -L<Digest::MD5> has been upgraded from version 2.54 to 2.55. - -=item * - -L<IPC::Cmd> has been upgraded from version 0.92 to 0.94. - -=item * - -L<IPC::SysV> has been upgraded from version 2.06_01 to 2.07. - -=item * - -L<List::Util> has been upgraded from version 1.42_02 to 1.45_01. - -=item * - -L<Locale::Codes> has been upgraded from version 3.37 to 3.38. - -=item * - -L<Locale::Maketext> has been upgraded from version 1.26 to 1.27. - -=item * - -L<Module::CoreList> has been upgraded from version 5.20160507 to 5.20160520. - -=item * - -L<Module::Metadata> has been upgraded from version 1.000031 to 1.000032. - -=item * - -L<perlfaq> has been upgraded from version 5.021010 to 5.021011. - -=item * - -L<POSIX> has been upgraded from version 1.65 to 1.69. This remedies several -defects in making its symbols exportable. [perl #127821] -The C<POSIX::tmpnam()> interface has been removed, -see L</"POSIX::tmpnam() has been removed">. -Trying to import POSIX subs that have no real implementations -(like C<POSIX::atend()>) now fails at import time, instead of -waiting until runtime. - -=item * - -L<re> has been upgraded from version 0.32 to 0.33. - -=item * - -L<Scalar::Util> has been upgraded from version 1.42_02 to 1.45_01. - -=item * - -L<Sys::Syslog> has been upgraded from version 0.33 to 0.34. - -=item * - -L<Term::ANSIColor> has been upgraded from version 4.04 to 4.05. - -=item * - -L<Test::Simple> has been upgraded from version 1.001014 to 1.302015. - -=item * - -L<threads> has been upgraded from version 2.07 to 2.08. Compatibility -with 5.8 has been restored. - -=item * - -L<threads::shared> has been upgraded from version 1.51 to 1.52. -Compatibility with 5.8 has been restored. - -=back - -=head1 Documentation - -=head2 Changes to Existing Documentation - -=over 4 - -=item * - -Fixed link to Crosby paper on hash complexity attack in L<perlsec>. - -=back - -=head1 Diagnostics - -=head2 New Diagnostics - -=head3 New Errors - -=over 4 - -=item * - -L<Bareword in require contains "%s"|perldiag/"Bareword in require contains "%s""> - -=item * - -L<Bareword in require maps to empty filename|perldiag/"Bareword in require maps to empty filename"> - -=item * - -L<Bareword in require maps to disallowed filename "%s"|perldiag/"Bareword in require maps to disallowed filename "%s""> - -=item * - -L<Bareword in require must not start with a double-colon: "%s"|perldiag/"Bareword in require must not start with a double-colon: "%s""> - -=back - -=head2 Changes to Existing Diagnostics - -=over 4 - -=item * - -Code like C<$x = $x . "a"> was incorrectly failing to yield a -L<use of uninitialized value|perldiag/"Use of uninitialized value%s"> -warning when C<$x> was a lexical variable with an undefined value. That has -now been fixed. [perl #127877] - -=item * - -When the error "Experimental push on scalar is now forbidden" is raised for -the hash functions C<keys>, C<each>, and C<values>, it is now followed by -the more helpful message, "Type of arg 1 to whatever must be hash or -array". [perl #127976] - -=item * - -C<undef *_; shift> or C<undef *_; pop> inside a subroutine, with no -argument to C<shift> or C<pop>, began crashing in Perl 5.14.0, but has now -been fixed. - -=item * - -C<< "string$scalar-E<gt>$*" >> now correctly prefers concat overloading to -string overloading if C<< $scalar-E<gt>$* >> returns an overloaded object, -bringing it into consistency with C<$$scalar>. - -=item * - -C<< /@0{0*-E<gt>@*/*0 >> and similar contortions used to crash, but no longer -do, but merely produce a syntax error. [perl #128171] - -=item * - -C<do> or C<require> with a reference or typeglob which, when stringified, -contains a null character started crashing in Perl 5.20.0, but has now been -fixed. [perl #128182] - -=back - -=head1 Utility Changes - -=head2 L<perlbug> - -=over 4 - -=item * - -Long lines in the message body are now wrapped at 900 characters, to stay -well within the 1000-character limit imposed by SMTP mail transfer agents. -This is particularly likely to be important for the list of arguments to -C<Configure>, which can readily exceed the limit if, for example, it names -several non-default installation paths. This change also adds the first unit -tests for perlbug. [perl #128020] - -=back - -=head1 Configuration and Compilation - -=over 4 - -=item * - -C<Configure> now builds C<miniperl> and C<generate_uudmap> if you -invoke it with C<-Dusecrosscompiler> but not C<-Dtargethost=somehost>. -This means you can supply your target platform C<config.sh>, generate -the headers and proceed to build your cross-target perl. [perl #127234] - -=item * - -Builds with C<-Accflags=-DPERL_TRACE_OPS> now only dump the operator -counts when the environment variable C<PERL_TRACE_OPS> to be set to a -non-zero integer. This allows C<make test> to pass on such a build. - -=item * - -When building with GCC 6 and link-time optimization (the C<-flto> option to -C<gcc>), C<Configure> was treating all probed symbols as present on the -system, regardless of whether they actually exist. This has been fixed. -[perl #128131] - -=item * - -The F<t/test.pl> library is used for internal testing of Perl itself, and -also copied by several CPAN modules. Some of those modules must work on -older versions of Perl, so F<t/test.pl> must in turn avoid newer Perl -features. Compatibility with Perl 5.8 was inadvertently removed some time -ago; it has now been restored. [perl #128052] - -=item * - -The build process no longer emits an extra blank line before building each -"simple" extension (those with only F<*.pm> and F<*.pod> files). - -=back - -=head1 Internal Changes - -=over 4 - -=item * - -Perl is now built with the C<PERL_OP_PARENT> compiler define enabled by -default. To disable it, use the C<PERL_NO_OP_PARENT> compiler define. -This flag alters how the C<op_sibling> field is used in C<OP> structures, -and has been available optionally since perl 5.22.0. - -See L<perl5220delta/"Internal Changes"> for more details of what this -build option does. - -=back - -=head1 Selected Bug Fixes - -=over 4 - -=item * - -Expressions containing an C<&&> or C<||> operator (or their synonyms C<and> -and C<or>) were being compiled incorrectly in some cases. If the left-hand -side consisted of either a negated bareword constant or a negated C<do {}> -block containing a constant expression, and the right-hand side consisted of -a negated non-foldable expression, one of the negations was effectively -ignored. The same was true of C<if> and C<unless> statement modifiers, -though with the left-hand and right-hand sides swapped. This long-standing -bug has now been fixed. [perl #127952] - -=item * - -C<reset> with an argument no longer crashes when encountering stash entries -other than globs. [perl #128106] - -=item * - -Assignment of hashes to, and deletion of, typeglobs named C<*::::::> no -longer causes crashes. [perl #128086] - -=back - -=head1 Acknowledgements - -Perl 5.25.1 represents approximately 2 weeks of development since Perl 5.25.0 -and contains approximately 46,000 lines of changes across 630 files from 24 -authors. - -Excluding auto-generated files, documentation and release tools, there were -approximately 40,000 lines of changes to 510 .pm, .t, .c and .h files. - -Perl continues to flourish into its third decade thanks to a vibrant community -of users and developers. The following people are known to have contributed the -improvements that became Perl 5.25.1: - -Aaron Crane, Andreas Voegele, Chad Granum, Chris 'BinGOs' Williams, Craig A. -Berry, David Mitchell, Doug Bell, Father Chrysostomos, H.Merijn Brand, Hugo van -der Sanden, Jarkko Hietaniemi, Jerry D. Hedden, Jim Cromie, John Lightsey, -Karen Etheridge, Karl Williamson, Lukas Mai, Maxwell Carey, Nicholas Clark, -Niko Tyni, Ricardo Signes, Sawyer X, Tony Cook, Yves Orton. - -The list above is almost certainly incomplete as it is automatically generated -from version control history. In particular, it does not include the names of -the (very much appreciated) contributors who reported issues to the Perl bug -tracker. - -Many of the changes included in this version originated in the CPAN modules -included in Perl's core. We're grateful to the entire CPAN community for -helping Perl to flourish. - -For a more complete list of all of Perl's historical contributors, please see -the F<AUTHORS> file in the Perl source distribution. - -=head1 Reporting Bugs - -If you find what you think is a bug, you might check the articles recently -posted to the comp.lang.perl.misc newsgroup and the perl bug database at -L<https://rt.perl.org/> . There may also be information at -L<http://www.perl.org/> , the Perl Home Page. - -If you believe you have an unreported bug, please run the L<perlbug> program -included with your release. Be sure to trim your bug down to a tiny but -sufficient test case. Your bug report, along with the output of C<perl -V>, -will be sent off to [email protected] to be analysed by the Perl porting team. - -If the bug you are reporting has security implications which make it -inappropriate to send to a publicly archived mailing list, then see -L<perlsec/SECURITY VULNERABILITY CONTACT INFORMATION> -for details of how to report the issue. - -=head1 SEE ALSO - -The F<Changes> file for an explanation of how to view exhaustive details on -what changed. - -The F<INSTALL> file for how to build Perl. - -The F<README> file for general stuff. - -The F<Artistic> and F<Copying> files for copyright information. - -=cut diff --git a/pod/perl5252delta.pod b/pod/perl5252delta.pod deleted file mode 100644 index 0410a923c1..0000000000 --- a/pod/perl5252delta.pod +++ /dev/null @@ -1,482 +0,0 @@ -=encoding utf8 - -=head1 NAME - -perl5252delta - what is new for perl v5.25.2 - -=head1 DESCRIPTION - -This document describes differences between the 5.25.1 release and the 5.25.2 -release. - -If you are upgrading from an earlier release such as 5.25.0, first read -L<perl5251delta>, which describes differences between 5.25.0 and 5.25.1. - -=head1 Core Enhancements - -=head2 Perl can now do default collation in UTF-8 locales on platforms -that support it - -Some platforms natively do a reasonable job of collating and sorting in -UTF-8 locales. Perl now works with those. For portability and full -control, L<Unicode::Collate> is still recommended, but now you may -not need to do anything special to get good-enough results, depending on -your application. See -L<perllocale/Category C<LC_COLLATE>: Collation: Text Comparisons and Sorting>. - -=head2 Better locale collation of strings containing embedded C<NUL> -characters - -In locales that have multi-level character weights, these are now -ignored at the higher priority ones. There are still some gotchas in -some strings, though. See -L<perllocale/Collation of strings containing embedded C<NUL> characters>. - -=head2 Lexical subroutines are no longer experimental - -Using the C<lexical_subs> feature no longer emits a warning. Existing code that disables the C<experimental::lexical_subs> warning category that the -feature previously used will continue to work. The C<lexical_subs> feature -has no effect; all Perl code can use lexical subroutines, regardless of -what feature declarations are in scope. - -=head2 C<CORE> subroutines for hash and array functions callable via -reference - -The hash and array functions in the C<CORE> namespace--C<keys>, C<each>, -C<values>, C<push>, C<pop>, C<shift>, C<unshift> and C<splice>--, can now -be called with ampersand syntax (C<&CORE::keys(\%hash>) and via reference -(C<< my $k = \&CORE::keys; $k->(\%hash) >>). Previously they could only be -used when inlined. - -=head1 Security - -=head2 C<-Di> switch is now required for PerlIO debugging output - -Previously PerlIO debugging output would be sent to the file specified -by the C<PERLIO_DEBUG> environment variable if perl wasn't running -setuid and the C<-T> or C<-t> switches hadn't been parsed yet. - -If perl performed output at a point where it hadn't yet parsed its -switches this could result in perl creating or overwriting the file -named by C<PERLIO_DEBUG> even when the C<-T> switch had been supplied. - -Perl now requires the C<-Di> switch to produce PerlIO debugging -output. By default this is written to C<stderr>, but can optionally -be redirected to a file by setting the C<PERLIO_DEBUG> environment -variable. - -If perl is running setuid or the C<-T> switch has supplied -C<PERLIO_DEBUG> is ignored and the debugging output is sent to -C<stderr> as for any other C<-D> switch. - -=head1 Incompatible Changes - -=head2 C<keys> returned from an lvalue subroutine - -C<keys> returned from an lvalue subroutine can no longer be assigned -to in list context. - - sub foo : lvalue { keys(%INC) } - (foo) = 3; # death - sub bar : lvalue { keys(@_) } - (bar) = 3; # also an error - -This makes the lvalue sub case consistent with C<(keys %hash) = ...> and -C<(keys @_) = ...>, which are also errors. [perl #128187] - -=head1 Modules and Pragmata - -=head2 Updated Modules and Pragmata - -=over 4 - -=item * - -L<CPAN> has been upgraded from version 2.11 to 2.14. - -=item * - -L<Devel::Peek> has been upgraded from version 1.23 to 1.24. - -=item * - -L<diagnostics> has been upgraded from version 1.34 to 1.35. - -=item * - -L<DynaLoader> has been upgraded from version 1.38 to 1.39. - -=item * - -L<ExtUtils::MakeMaker> has been upgraded from version 7.10_01 to 7.18. - -=item * - -L<ExtUtils::Miniperl> has been upgraded from version 1.05 to 1.06. - -=item * - -L<ExtUtils::ParseXS> has been upgraded from version 3.31 to 3.32. - -=item * - -L<ExtUtils::Typemaps> has been upgraded from version 3.31 to 3.32. - -=item * - -L<feature> has been upgraded from version 1.43 to 1.44. - -=item * - -L<File::Copy> has been upgraded from version 2.31 to 2.32. - -=item * - -L<File::Glob> has been upgraded from version 1.26 to 1.27. - -=item * - -L<File::Spec> has been upgraded from version 3.63 to 3.64. - -=item * - -L<FileHandle> has been upgraded from version 2.02 to 2.03. - -=item * - -L<Getopt::Long> has been upgraded from version 2.48 to 2.49. - -=item * - -L<HTTP::Tiny> has been upgraded from version 0.056 to 0.058. - -=item * - -L<JSON::PP> has been upgraded from version 2.27300 to 2.27400. - -=item * - -L<Locale::Codes> has been upgraded from version 3.38 to 3.39. - -=item * - -L<Module::CoreList> has been upgraded from 5.20160520 to 5.20160620. - -=item * - -L<Opcode> has been upgraded from version 1.34 to 1.35. - -=item * - -L<Pod::Checker> has been upgraded from version 1.60 to 1.73. - -=item * - -L<Pod::Functions> has been upgraded from version 1.10 to 1.11. - -=item * - -L<Pod::Usage> has been upgraded from version 1.68 to 1.69. - -=item * - -L<POSIX> has been upgraded from version 1.69 to 1.70. - -=item * - -L<Test::Simple> has been upgraded from version 1.302015 to 1.302026. - -=item * - -L<Thread::Queue> has been upgraded from version 3.09 to 3.11. - -=item * - -L<threads> has been upgraded from version 2.08 to 2.09. - -=item * - -L<Time::HiRes> has been upgraded from version 1.9733 to 1.9734. - -=item * - -L<Unicode::UCD> has been upgraded from version 0.64 to 0.65. - -=item * - -L<VMS::DCLsym> has been upgraded from version 1.06 to 1.07. - -=back - -=head1 Documentation - -=head2 Changes to Existing Documentation - -=head3 L<perlcommunity> - -=over 4 - -=item * - -All references to Usenet have been removed. - -=back - -=head3 L<perldelta> - -=over 4 - -=item * - -All references to Usenet have been removed. - -=back - -=head3 L<perllocale> - -=over 4 - -=item * - -Document NUL collation handling. - -=back - -=head3 L<perlmodinstall> - -=over 4 - -=item * - -All references to Usenet have been removed. - -=back - -=head3 L<perlmodlib> - -=over 4 - -=item * - -Updated the mirror list. - -=item * - -All references to Usenet have been removed. - -=back - -=head3 L<perlnewmod> - -=over 4 - -=item * - -All references to Usenet have been removed. - -=back - -=head1 Diagnostics - -The following additions or changes have been made to diagnostic output, -including warnings and fatal error messages. For the complete list of -diagnostic messages, see L<perldiag>. - -=head2 New Diagnostics - -=head3 New Errors - -=over 4 - -=item * - -L<Version control conflict marker|perldiag/"Version control conflict marker"> - -(F) The parser found a line starting with C<E<lt><<<<<<>, -C<E<gt>E<gt>E<gt>E<gt>E<gt>E<gt>E<gt>>, or C<=======>. These may be left by a -version control system to mark conflicts after a failed merge operation. - -=item * - -L<%s: command not found|perldiag/"%s: command not found"> - -(A) You've accidentally run your script through B<bash> or another shell -instead of Perl. Check the #! line, or manually feed your script into -Perl yourself. The #! line at the top of your file could look like: - - #!/usr/bin/perl - -=item * - -L<%s: command not found: %s|perldiag/"%s: command not found: %s"> - -(A) You've accidentally run your script through B<zsh> or another shell -instead of Perl. Check the #! line, or manually feed your script into -Perl yourself. The #! line at the top of your file could look like: - - #!/usr/bin/perl - -=item * - -L<Unescaped left brace in regex is deprecated here, passed through in regex; marked by S<<-- HERE> in mE<sol>%sE<sol>|perldiag/"Unescaped left brace in regex is deprecated here, passed through in reg ... [36 chars truncated] - -Unescaped left braces are already illegal in some contexts in regular -expression patterns, but, due to an oversight, no deprecation warning -was raised in other contexts where they are intended to become illegal. -This warning is now raised in these contexts. - -=back - -=head2 Changes to Existing Diagnostics - -=over 4 - -=item * - -L<Unescaped left brace in regex is illegal here in regex; marked by S<<-- HERE> in mE<sol>%sE<sol>|perldiag/"Unescaped left brace in regex is illegal here in regex; marked by S<<-- HERE> in m/%s/"> - -The word "here" has been added to the message that was raised in -v5.25.1. This is to indicate that there are contexts in which unescaped -left braces are not (yet) illegal. - -=back - -=head1 Configuration and Compilation - -=over 4 - -=item * - -F<make_ext.pl> no longer updates a module's F<pm_to_blib> file when no -files require updates. This could cause dependencies, F<perlmain.c> -in particular, to be rebuilt unnecessarily. [perl #126710] - -=item * - -The output of C<perl -V> has been reformatted so that each configuration -and compile-time option is now listed one per line, to improve -readability. - -=back - -=head1 Testing - -=over 4 - -=item * - -F<t/harness> now tries really hard not to run tests outside of the Perl -source tree. [perl #124050] - -=back - -=head1 Internal Changes - -=over 4 - -=item * - -Perl no longer panics when switching into some locales on machines with -buggy C<strxfrm()> implementations in their libc. [perl #121734] - -=back - -=head1 Selected Bug Fixes - -=over 4 - -=item * - -C< until ($x = 1) { ... } > and C< ... until $x = 1 > now properly -warn when syntax warnings are enabled. [perl #127333] - -=item * - -socket() now leaves the error code returned by the system in C<$!> on -failure. [perl #128316] - -=item * - -Assignment variants of any bitwise ops under the C<bitwise> feature would -crash if the left-hand side was an array or hash. [perl #128204] - -=item * - -C<require> followed by a single colon (as in C<foo() ? require : ...> is -now parsed correctly as C<require> with implicit $_, rather than -C<require "">. [perl #128307] - -=item * - -Scalar C<keys %hash> can now be assigned to consistently in all scalar -lvalue contexts. Previously it worked for some contexts but not others. - -=item * - -List assignment to C<vec> or C<substr> with an array or hash for its first -argument used to result in crashes or "Can't coerce" error messages at run -time, unlike scalar assignment, which would give an error at compile time. -List assignment now gives a compile-time error, too. [perl #128260] - -=back - -=head1 Acknowledgements - -Perl 5.25.2 represents approximately 4 weeks of development since Perl 5.25.1 -and contains approximately 32,000 lines of changes across 430 files from 28 -authors. - -Excluding auto-generated files, documentation and release tools, there were -approximately 27,000 lines of changes to 300 .pm, .t, .c and .h files. - -Perl continues to flourish into its third decade thanks to a vibrant community -of users and developers. The following people are known to have contributed the -improvements that became Perl 5.25.2: - -Aaron Crane, Andreas König, Andy Lester, Chad Granum, Chase Whitener, Chris -'BinGOs' Williams, Craig A. Berry, Dagfinn Ilmari Mannsåker, Dan Collins, -David Mitchell, Dominic Hargreaves, Ed Avis, Father Chrysostomos, H.Merijn -Brand, Ivan Pozdeev, James E Keenan, Jarkko Hietaniemi, Jerry D. Hedden, Jim -Cromie, Karl Williamson, Lukas Mai, Matthew Horsfall, Misty De Meo, Samuel -Thibault, Sawyer X, Sullivan Beck, Tony Cook, Yves Orton. - -The list above is almost certainly incomplete as it is automatically generated -from version control history. In particular, it does not include the names of -the (very much appreciated) contributors who reported issues to the Perl bug -tracker. - -Many of the changes included in this version originated in the CPAN modules -included in Perl's core. We're grateful to the entire CPAN community for -helping Perl to flourish. - -For a more complete list of all of Perl's historical contributors, please see -the F<AUTHORS> file in the Perl source distribution. - -=head1 Reporting Bugs - -If you find what you think is a bug, you might check the perl bug database -at L<https://rt.perl.org/> . There may also be information at -L<http://www.perl.org/> , the Perl Home Page. - -If you believe you have an unreported bug, please run the L<perlbug> program -included with your release. Be sure to trim your bug down to a tiny but -sufficient test case. Your bug report, along with the output of C<perl -V>, -will be sent off to [email protected] to be analysed by the Perl porting team. - -If the bug you are reporting has security implications which make it -inappropriate to send to a publicly archived mailing list, then see -L<perlsec/SECURITY VULNERABILITY CONTACT INFORMATION> -for details of how to report the issue. - -=head1 SEE ALSO - -The F<Changes> file for an explanation of how to view exhaustive details on -what changed. - -The F<INSTALL> file for how to build Perl. - -The F<README> file for general stuff. - -The F<Artistic> and F<Copying> files for copyright information. - -=cut diff --git a/pod/perl5253delta.pod b/pod/perl5253delta.pod deleted file mode 100644 index bc1b3758b5..0000000000 --- a/pod/perl5253delta.pod +++ /dev/null @@ -1,492 +0,0 @@ -=encoding utf8 - -=head1 NAME - -perl5253delta - what is new for perl v5.25.3 - -=head1 DESCRIPTION - -This document describes differences between the 5.25.2 release and the 5.25.3 -release. - -If you are upgrading from an earlier release such as 5.25.1, first read -L<perl5252delta>, which describes differences between 5.25.1 and 5.25.2. - -=head1 Core Enhancements - -=head2 Unicode 9.0 is now supported - -A list of changes is at L<http://www.unicode.org/versions/Unicode9.0.0/>. -Modules that are shipped with core Perl but not maintained by p5p do not -necessarily support Unicode 9.0. L<Unicode::Normalize> does work on 9.0. - -=head2 Use of C<\p{I<script>}> uses the improved Script_Extensions property - -Unicode 6.0 introduced an improved form of the Script (C<sc>) property, and -called it Script_Extensions (C<scx>). As of now, Perl uses this improved -version when a property is specified as just C<\p{I<script>}>. The meaning of -compound forms, like C<\p{sc=I<script>}> are unchanged. This should make -programs be more accurate when determining if a character is used in a given -script, but there is a slight chance of breakage for programs that very -specifically needed the old behavior. See L<perlunicode/Scripts>. - -=head2 Declaring a reference to a variable - -As an experimental feature, Perl now allows the referencing operator to come -after L<C<my()>|perlfunc/my>, L<C<state()>|perlfunc/state>, -L<C<our()>|perlfunc/our>, or L<C<local()>|perlfunc/local>. This syntax must -be enabled with C<use feature 'declared_refs'>. It is experimental, and will -warn by default unless C<no warnings 'experimental::refaliasing'> is in effect. -It is intended mainly for use in assignments to references. For example: - - use experimental 'refaliasing', 'declared_refs'; - my \$a = \$b; - -See L<perlref/Assigning to References> for slightly more detail. - -=head1 Incompatible Changes - -=head2 C<${^ENCODING}> has been removed - -Consequently, the L<encoding> pragma's default mode is no longer supported. If -you still need to write your source code in encodings other than UTF-8, use a -source filter such as L<Filter::Encoding> on CPAN or L<encoding>'s C<Filter> -option. - -=head2 C<scalar(%hash)> return signature changed - -The value returned for C<scalar(%hash)> will no longer show information about -the buckets allocated in the hash. It will simply return the count of used -keys. It is thus equivalent to C<0+keys(%hash)>. - -A form of backwards compatibility is provided via C<Hash::Util::bucket_ratio()> -which provides the same behavior as C<scalar(%hash)> provided prior to Perl -5.25. - -=head1 Modules and Pragmata - -=head2 Updated Modules and Pragmata - -=over 4 - -=item * - -L<bignum> has been upgraded from version 0.42 to 0.43. - -=item * - -L<Data::Dumper> has been upgraded from version 2.160 to 2.161. - -=item * - -L<Devel::PPPort> has been upgraded from version 3.32 to 3.35. - -=item * - -L<Encode> has been upgraded from version 2.80 to 2.84. - -=item * - -L<encoding> has been upgraded from version 2.17 to 2.17_01. - -This module's default mode is no longer supported as of Perl 5.25.3. It now -dies when imported, unless the C<Filter> option is being used. - -=item * - -L<encoding::warnings> has been upgraded from version 0.12 to 0.13. - -This module is no longer supported as of Perl 5.25.3. It emits a warning to -that effect and then does nothing. - -=item * - -L<ExtUtils::ParseXS> has been upgraded from version 3.32 to 3.33. - -=item * - -L<ExtUtils::Typemaps> has been upgraded from version 3.32 to 3.33. - -=item * - -L<feature> has been upgraded from version 1.44 to 1.45. - -=item * - -L<Hash::Util> has been upgraded from version 0.19 to 0.20. - -=item * - -L<Math::BigInt> has been upgraded from version 1.999715 to 1.999726. - -=item * - -L<Math::BigInt::FastCalc> has been upgraded from version 0.40 to 0.42. - -=item * - -L<Math::BigRat> has been upgraded from version 0.260802 to 0.260804. - -=item * - -L<Module::CoreList> has been upgraded from version 5.20160620 to 5.20160720. - -=item * - -L<Parse::CPAN::Meta> has been upgraded from version 1.4417 to 1.4422. - -=item * - -L<Perl::OSType> has been upgraded from version 1.009 to 1.010. - -=item * - -L<Test::Simple> has been upgraded from version 1.302026 to 1.302045. - -=item * - -L<Time::HiRes> has been upgraded from version 1.9734 to 1.9739. - -=item * - -L<Unicode::UCD> has been upgraded from version 0.65 to 0.66. - -=item * - -L<version> has been upgraded from version 0.9916 to 0.9917. - -=item * - -L<warnings> has been upgraded from version 1.36 to 1.37. - -=item * - -L<XSLoader> has been upgraded from version 0.21 to 0.22, fixing a security hole -in which binary files could be loaded from a path outside of -L<C<@INC>|perlvar/@INC>. - -=back - -=head1 Documentation - -=head2 Changes to Existing Documentation - -=head3 L<perldata> and L<perltie> - -=over 4 - -=item * - -Updated documentation of C<scalar(%hash)>. See L</scalar(%hash) return -signature changed> above. - -=back - -=head3 L<perlexperiment> and L<perlref> - -=over 4 - -=item * - -Documented new feature: See L</Declaring a reference to a variable> above. - -=back - -=head3 L<perlfunc> - -=over 4 - -=item * - -Clarified documentation of L<C<seek()>|perlfunc/seek>, -L<C<tell()>|perlfunc/tell> and L<C<sysseek()>|perlfunc/sysseek>. -L<[perl #128607]|https://rt.perl.org/Public/Bug/Display.html?id=128607> - -=item * - -Removed obsolete documentation of L<C<study()>|perlfunc/study>. - -=back - -=head3 L<perlunicode> - -=over 4 - -=item * - -Documented change to C<\p{I<script>}> to now use the improved Script_Extensions -property. See L</Use of \p{script} uses the improved Script_Extensions -property> above. - -=item * - -Updated the text to correspond with changes in Unicode UTS#18, concerning -regular expressions, and Perl compatibility with what it says. - -=back - -=head3 L<perlvar> - -=over 4 - -=item * - -Removed obsolete documentation of C<${^ENCODING}>. See L</${^ENCODING} has -been removed> above. - -=back - -=head1 Diagnostics - -The following additions or changes have been made to diagnostic output, -including warnings and fatal error messages. For the complete list of -diagnostic messages, see L<perldiag>. - -=head2 New Diagnostics - -=head3 New Errors - -=over 4 - -=item * - -L<The experimental declared_refs feature is not enabled|perldiag/"The experimental declared_refs feature is not enabled"> - -(F) To declare references to variables, as in C<my \%x>, you must first enable -the feature: - - no warnings "experimental::declared_refs"; - use feature "declared_refs"; - -=back - -=head3 New Warnings - -=over 4 - -=item * - -L<Declaring references is experimental|perldiag/"Declaring references is experimental"> - -(S experimental::declared_refs) This warning is emitted if you use a reference -constructor on the right-hand side of C<my()>, C<state()>, C<our()>, or -C<local()>. Simply suppress the warning if you want to use the feature, but -know that in doing so you are taking the risk of using an experimental feature -which may change or be removed in a future Perl version: - - no warnings "experimental::declared_refs"; - use feature "declared_refs"; - $fooref = my \$foo; - -=item * - -L<C<${^ENCODING}> is no longer supported|perldiag/"${^ENCODING} is no longer supported"> - -(D deprecated) The special variable C<${^ENCODING}>, formerly used to implement -the C<encoding> pragma, is no longer supported as of Perl 5.26.0. - -=back - -=head1 Configuration and Compilation - -=over 4 - -=item * - -F<Configure> now aborts if both "-Duselongdouble" and "-Dusequadmath" are -requested. -L<[perl #126203]|https://rt.perl.org/Public/Bug/Display.html?id=126203> - -=item * - -Fixed a bug in which F<Configure> could append "-quadmath" to the archname even -if it was already present. -L<[perl #128538]|https://rt.perl.org/Public/Bug/Display.html?id=128538> - -=item * - -Clang builds with "-DPERL_GLOBAL_STRUCT" or "-DPERL_GLOBAL_STRUCT_PRIVATE" have -been fixed (by disabling Thread Safety Analysis for these configurations). - -=back - **** PATCH TRUNCATED AT 2000 LINES -- 3106 NOT SHOWN **** -- Perl5 Master Repository
