diff options
Diffstat (limited to 'pod/perl5318delta.pod')
| -rw-r--r-- | pod/perl5318delta.pod | 419 |
1 files changed, 0 insertions, 419 deletions
diff --git a/pod/perl5318delta.pod b/pod/perl5318delta.pod deleted file mode 100644 index a818efde71..0000000000 --- a/pod/perl5318delta.pod +++ /dev/null @@ -1,419 +0,0 @@ -=encoding utf8 - -=head1 NAME - -perl5318delta - what is new for perl v5.31.8 - -=head1 DESCRIPTION - -This document describes differences between the 5.31.7 release and the 5.31.8 -release. - -If you are upgrading from an earlier release such as 5.31.6, first read -L<perl5317delta>, which describes differences between 5.31.6 and 5.31.7. - -=head1 Notice - -We are now in the Contentious Changes Freeze portion of the 5.31.X release -cycle. - -=head1 Performance Enhancements - -=over 4 - -=item * - -C<my_strnlen> has been sped up for systems that don't have their own -C<strnlen> implementation. - -=item * - -C<grok_bin_oct_hex> (and so, C<grok_bin>, C<grok_oct>, and C<grok_hex>) -have been sped up. - -=item * - -C<grok_number_flags> has been sped up. - -=back - -=head1 Modules and Pragmata - -=head2 Updated Modules and Pragmata - -=over 4 - -=item * - -L<autodie> has been upgraded from version 2.29 to 2.32. - -=item * - -L<DB_File> has been upgraded from version 1.852 to 1.853. - -=item * - -L<Encode> has been upgraded from version 3.01 to 3.02. - -=item * - -L<ExtUtils::MakeMaker> has been upgraded from version 7.42 to 7.44. - -=item * - -L<Hash::Util> has been upgraded from version 0.22 to 0.23. - -The Synopsis has been updated as the example code stopped working with -newer perls. - -[L<GH #17399|https://github.com/Perl/perl5/issues/17399>] - -=item * - -L<IO> has been upgraded from version 1.41 to 1.42. - -=item * - -L<Module::CoreList> has been upgraded from version 5.20191220 to 5.20200120. - -=item * - -L<podlators> has been upgraded from version 4.12 to 4.14. - -=item * - -L<POSIX> has been upgraded from version 1.90 to 1.91. - -=item * - -L<Term::ANSIColor> has been upgraded from version 4.06 to 5.01. - -=item * - -L<Test::Simple> has been upgraded from version 1.302170 to 1.302171. - -=item * - -L<XS::APItest> has been upgraded from version 1.05 to 1.06. - -=back - -=head1 Documentation - -=head2 Changes to Existing Documentation - -We have attempted to update the documentation to reflect the changes -listed in this document. If you find any we have missed, send email -to L<https://github.com/Perl/perl5/issues>. - -Additionally, the following selected changes have been made: - -=head3 L<perlapi> - -=over 4 - -=item * - -C<sv_2pvbyte> updated to mention it will croak if the SV cannot be -downgraded. - -=item * - -C<sv_setpvn> updated to mention that the UTF-8 flag will not be changed by -this function, and a terminating NUL byte is guaranteed. - -=item * - -Documentation for C<PL_phase> has been added. - -=item * - -The documentation for C<grok_bin>, C<grok_oct>, and C<grok_hex> has been -updated and clarified. - -=back - -=head3 L<perlguts> - -=over 4 - -=item * - -Don't suggest using perl's C<malloc> anymore. Modern system C<malloc> is -assumed to be much better than perl's implementation at this point. - -=back - -=head3 L<perlintro> - -=over 4 - -=item * - -The docs for the repetition operator C<x> have been clarified - -[L<GH #17335|https://github.com/Perl/perl5/issues/17335>] - -=back - -=head3 L<perlipc> - -=over 4 - -=item * - -The documentation surrounding C<open> and handle usage has been modernized -to prefer 3-arg open and lexical variables instead of barewords. - -=item * - -Various updates and fixes including making all examples strict-safe and -replacing C<-w> with C<use warnings>. - -=back - -=head3 L<perlport> - -=over 4 - -=item * - -Update C<timegm> example to use correct year format I<1970> instead of I<70>. - -[L<GH #16431|https://github.com/Perl/perl5/issues/16431>] - -=back - -=head3 L<perlvar> - -=over 4 - -=item * - -Recommend stringifying C<$]> and comparing it numerically. - -=back - -=head3 L<perlxs> - -=over 4 - -=item * - -Suggest using libffi for simple library bindings. - -=back - -=head3 L<POSIX> - -=over 4 - -=item * - -C<setlocale> warning about threaded builds updated to note it does not -apply on Perl 5.28.X and later. - -=item * - -C<< Posix::SigSet->new(...) >> updated to state it throws an error if any of -the supplied signals cannot be added to the set. - -=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 * - -The "Code point 0x%X is not Unicode, and not portable" warning removed -the line "Code points above 0xFFFF_FFFF require larger than a 32 bit word." -as code points that large are no longer legal on 32-bit platforms. - -=back - -=head1 Configuration and Compilation - -=over 4 - -=item * - -For clang++, add C<< #include <stdlib.h> >> to Configure's probes for -C<futimes>, C<strtoll>, C<strtoul>, C<strtoull>, C<strtouq>, otherwise the -probes would fail to compile. - -=item * - -Use a compile and run test for C<lchown> to satisfy clang++ which should -more reliably detect it. - -=item * - -For C++ compilers, add C<< #include <stdio.h> >> to Configure's probes for -C<getpgrp> and C<setpgrp> as they use printf and C++ compilers may fail -compilation instead of just warning. - -=back - -=head1 Testing - -Tests were added and changed to reflect the other additions and -changes in this release. Furthermore, these significant changes were -made: - -=over 4 - -=item * - -Certain test output of scalars containing control characters and Unicode -has been fixed on EBCDIC. - -=back - -=head1 Platform Support - -=head2 Platform-Specific Notes - -=over 4 - -=item NetBSD 8.0 - -Fix compilation of Perl on NetBSD 8.0 with g++. - -[L<GH #17381|https://github.com/Perl/perl5/issues/17381>] - -=item Solaris - -Configure now uses the detected types for gethostby* functions, allowing -Perl to once again compile on certain configurations of Solaris. - -=back - -=head1 Internal Changes - -=over 4 - -=item * - -C<savepvn>'s len parameter is now a C<Size_t> instead of an C<I32> since we -can handle longer strings than 31 bits. - -=back - -=head1 Selected Bug Fixes - -=over 4 - -=item * - -A heap-buffer-overflow has been fixed in the regular expression engine. - -[L<GH #17384|https://github.com/Perl/perl5/issues/17384>] - -=item * - -Fix an assertion failure in the regular expression engine. - -[L<GH #17372|https://github.com/Perl/perl5/issues/17372>] - -=item * - -Fix regression in C<tr///> added somewhere in v5.31.6. - -[L<GH #17391|https://github.com/Perl/perl5/issues/17391>] - -=item * - -Fix coredump in pp_hot.c after C<B::UNOP_AUX::aux_list()>. - -[L<GH #17301|https://github.com/Perl/perl5/issues/17301>] - -=item * - -Commit bc62bf8519 ("Add some defensive coding to av_store()" has been -reverted as it broke I<List-UtilsBy-XS-0.05> in v5.31.2. - -[L<GH #17265|https://github.com/Perl/perl5/issues/17265>] - -=item * - -Loading IO is now threadsafe. - -[L<GH #14816|https://github.com/Perl/perl5/issues/14816>] - -=back - -=head1 Acknowledgements - -Perl 5.31.8 represents approximately 4 weeks of development since Perl -5.31.7 and contains approximately 16,000 lines of changes across 400 files -from 25 authors. - -Excluding auto-generated files, documentation and release tools, there were -approximately 8,300 lines of changes to 260 .pm, .t, .c and .h files. - -Perl continues to flourish into its fourth decade thanks to a vibrant -community of users and developers. The following people are known to have -contributed the improvements that became Perl 5.31.8: - -Andy Dougherty, Bernhard M. Wiedemann, Chad Granum, Chase Whitener, Chris -'BinGOs' Williams, Craig A. Berry, Dan Book, Dan Kogai, David Mitchell, -Felipe Gasper, Hugo van der Sanden, James E Keenan, Karl Williamson, Matthew -Horsfall, Nicholas Clark, Nicolas R., Ricardo Signes, Russ Allbery, Santtu -Ojanperä, Slaven Rezic, Smylers, Todd Rinaldo, Tomasz Konojacki, 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://github.com/Perl/perl5/issues>. There may also be information at -L<http://www.perl.org/>, the Perl Home Page. - -If you believe you have an unreported bug, please open an issue at -L<https://github.com/Perl/perl5/issues>. Be sure to trim your bug down to a -tiny but sufficient test case. - -If the bug you are reporting has security implications which make it -inappropriate to send to a public issue tracker, then see -L<perlsec/SECURITY VULNERABILITY CONTACT INFORMATION> -for details of how to report the issue. - -=head1 Give Thanks - -If you wish to thank the Perl 5 Porters for the work we had done in Perl 5, -you can do so by running the C<perlthanks> program: - - perlthanks - -This will send an email to the Perl 5 Porters list with your show of thanks. - -=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 |