diff options
Diffstat (limited to 'upstream/fedora-rawhide/man1/perl5201delta.1')
| -rw-r--r-- | upstream/fedora-rawhide/man1/perl5201delta.1 | 340 |
1 files changed, 340 insertions, 0 deletions
diff --git a/upstream/fedora-rawhide/man1/perl5201delta.1 b/upstream/fedora-rawhide/man1/perl5201delta.1 new file mode 100644 index 00000000..92199833 --- /dev/null +++ b/upstream/fedora-rawhide/man1/perl5201delta.1 @@ -0,0 +1,340 @@ +.\" -*- mode: troff; coding: utf-8 -*- +.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) +.\" +.\" Standard preamble: +.\" ======================================================================== +.de Sp \" Vertical space (when we can't use .PP) +.if t .sp .5v +.if n .sp +.. +.de Vb \" Begin verbatim text +.ft CW +.nf +.ne \\$1 +.. +.de Ve \" End verbatim text +.ft R +.fi +.. +.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. +.ie n \{\ +. ds C` "" +. ds C' "" +'br\} +.el\{\ +. ds C` +. ds C' +'br\} +.\" +.\" Escape single quotes in literal strings from groff's Unicode transform. +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" +.\" If the F register is >0, we'll generate index entries on stderr for +.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index +.\" entries marked with X<> in POD. Of course, you'll have to process the +.\" output yourself in some meaningful fashion. +.\" +.\" Avoid warning from groff about undefined register 'F'. +.de IX +.. +.nr rF 0 +.if \n(.g .if rF .nr rF 1 +.if (\n(rF:(\n(.g==0)) \{\ +. if \nF \{\ +. de IX +. tm Index:\\$1\t\\n%\t"\\$2" +.. +. if !\nF==2 \{\ +. nr % 0 +. nr F 2 +. \} +. \} +.\} +.rr rF +.\" ======================================================================== +.\" +.IX Title "PERL5201DELTA 1" +.TH PERL5201DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.\" For nroff, turn off justification. Always turn off hyphenation; it makes +.\" way too many mistakes in technical documents. +.if n .ad l +.nh +.SH NAME +perl5201delta \- what is new for perl v5.20.1 +.SH DESCRIPTION +.IX Header "DESCRIPTION" +This document describes differences between the 5.20.0 release and the 5.20.1 +release. +.PP +If you are upgrading from an earlier release such as 5.18.0, first read +perl5200delta, which describes differences between 5.18.0 and 5.20.0. +.SH "Incompatible Changes" +.IX Header "Incompatible Changes" +There are no changes intentionally incompatible with 5.20.0. If any exist, +they are bugs, and we request that you submit a report. See "Reporting Bugs" +below. +.SH "Performance Enhancements" +.IX Header "Performance Enhancements" +.IP \(bu 4 +An optimization to avoid problems with COW and deliberately overallocated PVs +has been disabled because it interfered with another, more important, +optimization, causing a slowdown on some platforms. +[GH #13878] <https://github.com/Perl/perl5/issues/13878> +.IP \(bu 4 +Returning a string from a lexical variable could be slow in some cases. This +has now been fixed. +[GH #13880] <https://github.com/Perl/perl5/issues/13880> +.SH "Modules and Pragmata" +.IX Header "Modules and Pragmata" +.SS "Updated Modules and Pragmata" +.IX Subsection "Updated Modules and Pragmata" +.IP \(bu 4 +Config::Perl::V has been upgraded from version 0.20 to 0.22. +.Sp +The list of Perl versions covered has been updated and some flaws in the +parsing have been fixed. +.IP \(bu 4 +Exporter has been upgraded from version 5.70 to 5.71. +.Sp +Illegal POD syntax in the documentation has been corrected. +.IP \(bu 4 +ExtUtils::CBuilder has been upgraded from version 0.280216 to 0.280217. +.Sp +Android builds now link to both \fB\-lperl\fR and \f(CW$Config::Config{perllibs}\fR. +.IP \(bu 4 +File::Copy has been upgraded from version 2.29 to 2.30. +.Sp +The documentation now notes that \f(CW\*(C`copy\*(C'\fR will not overwrite read-only files. +.IP \(bu 4 +Module::CoreList has been upgraded from version 3.11 to 5.020001. +.Sp +The list of Perl versions covered has been updated. +.IP \(bu 4 +The PathTools module collection has been upgraded from version 3.47 to 3.48. +.Sp +Fallbacks are now in place when cross-compiling for Android and +\&\f(CW$Config::Config{sh}\fR is not yet defined. +[GH #13872] <https://github.com/Perl/perl5/issues/13872> +.IP \(bu 4 +PerlIO::via has been upgraded from version 0.14 to 0.15. +.Sp +A minor portability improvement has been made to the XS implementation. +.IP \(bu 4 +Unicode::UCD has been upgraded from version 0.57 to 0.58. +.Sp +The documentation includes many clarifications and fixes. +.IP \(bu 4 +utf8 has been upgraded from version 1.13 to 1.13_01. +.Sp +The documentation has some minor formatting improvements. +.IP \(bu 4 +version has been upgraded from version 0.9908 to 0.9909. +.Sp +External libraries and Perl may have different ideas of what the locale is. +This is problematic when parsing version strings if the locale's numeric +separator has been changed. Version parsing has been patched to ensure it +handles the locales correctly. +[GH #13863] <https://github.com/Perl/perl5/issues/13863> +.SH Documentation +.IX Header "Documentation" +.SS "Changes to Existing Documentation" +.IX Subsection "Changes to Existing Documentation" +\fIperlapi\fR +.IX Subsection "perlapi" +.IP \(bu 4 +\&\f(CW\*(C`av_len\*(C'\fR \- Emphasize that this returns the highest index in the array, not the +size of the array. +[GH #13377] <https://github.com/Perl/perl5/issues/13377> +.IP \(bu 4 +Note that \f(CW\*(C`SvSetSV\*(C'\fR doesn't do set magic. +.IP \(bu 4 +\&\f(CW\*(C`sv_usepvn_flags\*(C'\fR \- Fix documentation to mention the use of \f(CW\*(C`NewX\*(C'\fR instead of +\&\f(CW\*(C`malloc\*(C'\fR. +[GH #13835] <https://github.com/Perl/perl5/issues/13835> +.IP \(bu 4 +Clarify where \f(CW\*(C`NUL\*(C'\fR may be embedded or is required to terminate a string. +.PP +\fIperlfunc\fR +.IX Subsection "perlfunc" +.IP \(bu 4 +Clarify the meaning of \f(CW\*(C`\-B\*(C'\fR and \f(CW\*(C`\-T\*(C'\fR. +.IP \(bu 4 +\&\f(CW\*(C`\-l\*(C'\fR now notes that it will return false if symlinks aren't supported by the +file system. +[GH #13695] <https://github.com/Perl/perl5/issues/13695> +.IP \(bu 4 +Note that \f(CW\*(C`each\*(C'\fR, \f(CW\*(C`keys\*(C'\fR and \f(CW\*(C`values\*(C'\fR may produce different orderings for +tied hashes compared to other perl hashes. +[GH #13650] <https://github.com/Perl/perl5/issues/13650> +.IP \(bu 4 +Note that \f(CW\*(C`exec LIST\*(C'\fR and \f(CW\*(C`system LIST\*(C'\fR may fall back to the shell on Win32. +Only \f(CW\*(C`exec PROGRAM LIST\*(C'\fR and \f(CW\*(C`system PROGRAM LIST\*(C'\fR indirect object syntax +will reliably avoid using the shell. This has also been noted in perlport. +[GH #13907] <https://github.com/Perl/perl5/issues/13907> +.IP \(bu 4 +Clarify the meaning of \f(CW\*(C`our\*(C'\fR. +[GH #13938] <https://github.com/Perl/perl5/issues/13938> +.PP +\fIperlguts\fR +.IX Subsection "perlguts" +.IP \(bu 4 +Explain various ways of modifying an existing SV's buffer. +[GH #12813] <https://github.com/Perl/perl5/issues/12813> +.PP +\fIperlpolicy\fR +.IX Subsection "perlpolicy" +.IP \(bu 4 +We now have a code of conduct for the \fIp5p\fR mailing list, as documented in +"STANDARDS OF CONDUCT" in perlpolicy. +.PP +\fIperlre\fR +.IX Subsection "perlre" +.IP \(bu 4 +The \f(CW\*(C`/x\*(C'\fR modifier has been clarified to note that comments cannot be continued +onto the next line by escaping them. +.PP +\fIperlsyn\fR +.IX Subsection "perlsyn" +.IP \(bu 4 +Mention the use of empty conditionals in \f(CW\*(C`for\*(C'\fR/\f(CW\*(C`while\*(C'\fR loops for infinite +loops. +.PP +\fIperlxs\fR +.IX Subsection "perlxs" +.IP \(bu 4 +Added a discussion of locale issues in XS code. +.SH Diagnostics +.IX Header "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 perldiag. +.SS "Changes to Existing Diagnostics" +.IX Subsection "Changes to Existing Diagnostics" +.IP \(bu 4 +Variable length lookbehind not implemented in regex m/%s/ +.Sp +Information about Unicode behaviour has been added. +.SH "Configuration and Compilation" +.IX Header "Configuration and Compilation" +.IP \(bu 4 +Building Perl no longer writes to the source tree when configured with +\&\fIConfigure\fR's \fB\-Dmksymlinks\fR option. +[GH #13712] <https://github.com/Perl/perl5/issues/13712> +.SH "Platform Support" +.IX Header "Platform Support" +.SS "Platform-Specific Notes" +.IX Subsection "Platform-Specific Notes" +.IP Android 4 +.IX Item "Android" +Build support has been improved for cross-compiling in general and for Android +in particular. +.IP OpenBSD 4 +.IX Item "OpenBSD" +Corrected architectures and version numbers used in configuration hints when +building Perl. +.IP Solaris 4 +.IX Item "Solaris" +\&\fBc99\fR options have been cleaned up, hints look for \fBsolstudio\fR as well as +\&\fBSUNWspro\fR, and support for native \f(CW\*(C`setenv\*(C'\fR has been added. +.IP VMS 4 +.IX Item "VMS" +An old bug in feature checking, mainly affecting pre\-7.3 systems, has been +fixed. +.IP Windows 4 +.IX Item "Windows" +\&\f(CW%I64d\fR is now being used instead of \f(CW%lld\fR for MinGW. +.SH "Internal Changes" +.IX Header "Internal Changes" +.IP \(bu 4 +Added "sync_locale" in perlapi. +Changing the program's locale should be avoided by XS code. Nevertheless, +certain non-Perl libraries called from XS, such as \f(CW\*(C`Gtk\*(C'\fR do so. When this +happens, Perl needs to be told that the locale has changed. Use this function +to do so, before returning to Perl. +.SH "Selected Bug Fixes" +.IX Header "Selected Bug Fixes" +.IP \(bu 4 +A bug has been fixed where zero-length assertions and code blocks inside of a +regex could cause \f(CW\*(C`pos\*(C'\fR to see an incorrect value. +[GH #14016] <https://github.com/Perl/perl5/issues/14016> +.IP \(bu 4 +Using \f(CW\*(C`s///e\*(C'\fR on tainted utf8 strings could issue bogus "Malformed UTF\-8 +character (unexpected end of string)" warnings. This has now been fixed. +[GH #13948] <https://github.com/Perl/perl5/issues/13948> +.IP \(bu 4 +\&\f(CW\*(C`system\*(C'\fR and friends should now work properly on more Android builds. +.Sp +Due to an oversight, the value specified through \fB\-Dtargetsh\fR to \fIConfigure\fR +would end up being ignored by some of the build process. This caused perls +cross-compiled for Android to end up with defective versions of \f(CW\*(C`system\*(C'\fR, +\&\f(CW\*(C`exec\*(C'\fR and backticks: the commands would end up looking for \fI/bin/sh\fR instead +of \fI/system/bin/sh\fR, and so would fail for the vast majority of devices, +leaving \f(CW$!\fR as \f(CW\*(C`ENOENT\*(C'\fR. +.IP \(bu 4 +Many issues have been detected by Coverity <http://www.coverity.com/> and +fixed. +.SH Acknowledgements +.IX Header "Acknowledgements" +Perl 5.20.1 represents approximately 4 months of development since Perl 5.20.0 +and contains approximately 12,000 lines of changes across 170 files from 36 +authors. +.PP +Excluding auto-generated files, documentation and release tools, there were +approximately 2,600 lines of changes to 110 .pm, .t, .c and .h files. +.PP +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.20.1: +.PP +Aaron Crane, Abigail, Alberto Simões, Alexandr Ciornii, Alexandre (Midnite) +Jousset, Andrew Fresh, Andy Dougherty, Brian Fraser, Chris 'BinGOs' Williams, +Craig A. Berry, Daniel Dragan, David Golden, David Mitchell, H.Merijn Brand, +James E Keenan, Jan Dubois, Jarkko Hietaniemi, John Peacock, kafka, Karen +Etheridge, Karl Williamson, Lukas Mai, Matthew Horsfall, Michael Bunk, Peter +Martini, Rafael Garcia-Suarez, Reini Urban, Ricardo Signes, Shirakata Kentaro, +Smylers, Steve Hay, Thomas Sibley, Todd Rinaldo, Tony Cook, Vladimir Marek, +Yves Orton. +.PP +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. +.PP +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. +.PP +For a more complete list of all of Perl's historical contributors, please see +the \fIAUTHORS\fR file in the Perl source distribution. +.SH "Reporting Bugs" +.IX Header "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 +https://rt.perl.org/ . There may also be information at http://www.perl.org/ , +the Perl Home Page. +.PP +If you believe you have an unreported bug, please run the 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 \f(CW\*(C`perl \-V\*(C'\fR, +will be sent off to perlbug@perl.org to be analysed by the Perl porting team. +.PP +If the bug you are reporting has security implications, which make it +inappropriate to send to a publicly archived mailing list, then please send it +to perl5\-security\-report@perl.org. This points to a closed subscription +unarchived mailing list, which includes all the core committers, who will be +able to help assess the impact of issues, figure out a resolution, and help +co-ordinate the release of patches to mitigate or fix the problem across all +platforms on which Perl is supported. Please only use this address for +security issues in the Perl core, not for modules independently distributed on +CPAN. +.SH "SEE ALSO" +.IX Header "SEE ALSO" +The \fIChanges\fR file for an explanation of how to view exhaustive details on +what changed. +.PP +The \fIINSTALL\fR file for how to build Perl. +.PP +The \fIREADME\fR file for general stuff. +.PP +The \fIArtistic\fR and \fICopying\fR files for copyright information. |