Adding upstream version 4.22.0.upstream/4.22.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 357 insertions, 0 deletions

diff --git a/upstream/mageia-cauldron/man1/perl5202delta.1 b/upstream/mageia-cauldron/man1/perl5202delta.1
new file mode 100644
index 00000000..8e3cf47c
--- /dev/null
+++ b/upstream/mageia-cauldron/man1/perl5202delta.1
@@ -0,0 +1,357 @@
+.\" -*- 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 "PERL5202DELTA 1"
+.TH PERL5202DELTA 1 2023-11-28 "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
+perl5202delta \- what is new for perl v5.20.2
+.SH DESCRIPTION
+.IX Header "DESCRIPTION"
+This document describes differences between the 5.20.1 release and the 5.20.2
+release.
+.PP
+If you are upgrading from an earlier release such as 5.20.0, first read
+perl5201delta, which describes differences between 5.20.0 and 5.20.1.
+.SH "Incompatible Changes"
+.IX Header "Incompatible Changes"
+There are no changes intentionally incompatible with 5.20.1.  If any exist,
+they are bugs, and we request that you submit a report.  See "Reporting Bugs"
+below.
+.SH "Modules and Pragmata"
+.IX Header "Modules and Pragmata"
+.SS "Updated Modules and Pragmata"
+.IX Subsection "Updated Modules and Pragmata"
+.IP \(bu 4
+attributes has been upgraded from version 0.22 to 0.23.
+.Sp
+The usage of \f(CW\*(C`memEQs\*(C'\fR in the XS has been corrected.
+[GH #14072] <https://github.com/Perl/perl5/issues/14072>
+.IP \(bu 4
+Data::Dumper has been upgraded from version 2.151 to 2.151_01.
+.Sp
+Fixes CVE\-2014\-4330 by adding a configuration variable/option to limit
+recursion when dumping deep data structures.
+.IP \(bu 4
+Errno has been upgraded from version 1.20_03 to 1.20_05.
+.Sp
+Warnings when building the XS on Windows with the Visual C++ compiler are now
+avoided.
+.IP \(bu 4
+feature has been upgraded from version 1.36 to 1.36_01.
+.Sp
+The \f(CW\*(C`postderef\*(C'\fR feature has now been documented.  This feature was actually
+added in Perl 5.20.0 but was accidentally omitted from the feature
+documentation until now.
+.IP \(bu 4
+IO::Socket has been upgraded from version 1.37 to 1.38.
+.Sp
+Document the limitations of the \fBconnected()\fR method.
+[GH #14199] <https://github.com/Perl/perl5/issues/14199>
+.IP \(bu 4
+Module::CoreList has been upgraded from version 5.020001 to 5.20150214.
+.Sp
+The list of Perl versions covered has been updated.
+.IP \(bu 4
+PathTools has been upgraded from version 3.48 to 3.48_01.
+.Sp
+A warning from the \fBgcc\fR compiler is now avoided when building the XS.
+.IP \(bu 4
+PerlIO::scalar has been upgraded from version 0.18 to 0.18_01.
+.Sp
+Reading from a position well past the end of the scalar now correctly returns
+end of file.
+[GH #14342] <https://github.com/Perl/perl5/issues/14342>
+.Sp
+Seeking to a negative position still fails, but no longer leaves the file
+position set to a negation location.
+.Sp
+\&\f(CWeof()\fR on a \f(CW\*(C`PerlIO::scalar\*(C'\fR handle now properly returns true when the file
+position is past the 2GB mark on 32\-bit systems.
+.IP \(bu 4
+Storable has been upgraded from version 2.49 to 2.49_01.
+.Sp
+Minor grammatical change to the documentation only.
+.IP \(bu 4
+VMS::DCLsym has been upgraded from version 1.05 to 1.05_01.
+.Sp
+Minor formatting change to the documentation only.
+.IP \(bu 4
+VMS::Stdio has been upgraded from version 2.4 to 2.41.
+.Sp
+Minor formatting change to the documentation only.
+.SH Documentation
+.IX Header "Documentation"
+.SS "New Documentation"
+.IX Subsection "New Documentation"
+\fIperlunicook\fR
+.IX Subsection "perlunicook"
+.PP
+This document, by Tom Christiansen, provides examples of handling Unicode in
+Perl.
+.SS "Changes to Existing Documentation"
+.IX Subsection "Changes to Existing Documentation"
+\fIperlexperiment\fR
+.IX Subsection "perlexperiment"
+.IP \(bu 4
+Added reference to subroutine signatures.  This feature was actually added in
+Perl 5.20.0 but was accidentally omitted from the experimental feature
+documentation until now.
+.PP
+\fIperlpolicy\fR
+.IX Subsection "perlpolicy"
+.IP \(bu 4
+The process whereby features may graduate from experimental status has now been
+formally documented.
+.PP
+\fIperlsyn\fR
+.IX Subsection "perlsyn"
+.IP \(bu 4
+An ambiguity in the documentation of the ellipsis statement has been corrected.
+[GH #14054] <https://github.com/Perl/perl5/issues/14054>
+.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
+Bad symbol for scalar is now documented.
+This error is not new, but was not previously documented here.
+.IP \(bu 4
+Missing right brace on \eN{} is now
+documented.  This error is not new, but was not previously documented here.
+.SH Testing
+.IX Header "Testing"
+.IP \(bu 4
+The test script \fIre/rt122747.t\fR has been added to verify that
+[GH #14081] <https://github.com/Perl/perl5/issues/14081> remains
+fixed.
+.SH "Platform Support"
+.IX Header "Platform Support"
+.SS "Regained Platforms"
+.IX Subsection "Regained Platforms"
+IRIX and Tru64 platforms are working again.  (Some \f(CW\*(C`make test\*(C'\fR failures
+remain.)
+.SH "Selected Bug Fixes"
+.IX Header "Selected Bug Fixes"
+.IP \(bu 4
+AIX now sets the length in \f(CW\*(C`getsockopt\*(C'\fR correctly.
+[GH #13484] <https://github.com/Perl/perl5/issues/13484>,
+[cpan #91183] <https://rt.cpan.org/Ticket/Display.html?id=91183>,
+[cpan #85570] <https://rt.cpan.org/Ticket/Display.html?id=85570>
+.IP \(bu 4
+In Perl 5.20.0, \f(CW$^N\fR accidentally had the internal UTF8 flag turned off if
+accessed from a code block within a regular expression, effectively
+UTF8\-encoding the value.  This has been fixed.
+[GH #14211] <https://github.com/Perl/perl5/issues/14211>
+.IP \(bu 4
+Various cases where the name of a sub is used (autoload, overloading, error
+messages) used to crash for lexical subs, but have been fixed.
+.IP \(bu 4
+An assertion failure when parsing \f(CW\*(C`sort\*(C'\fR with debugging enabled has been
+fixed.
+[GH #14087] <https://github.com/Perl/perl5/issues/14087>
+.IP \(bu 4
+Loading UTF8 tables during a regular expression match could cause assertion
+failures under debugging builds if the previous match used the very same
+regular expression.
+[GH #14081] <https://github.com/Perl/perl5/issues/14081>
+.IP \(bu 4
+Due to a mistake in the string-copying logic, copying the value of a state
+variable could instead steal the value and undefine the variable.  This bug,
+introduced in Perl 5.20, would happen mostly for long strings (1250 chars or
+more), but could happen for any strings under builds with copy-on-write
+disabled.
+[GH #14175] <https://github.com/Perl/perl5/issues/14175>
+.IP \(bu 4
+Fixed a bug that could cause perl to execute an infinite loop during
+compilation.
+[GH #14165] <https://github.com/Perl/perl5/issues/14165>
+.IP \(bu 4
+On Win32, restoring in a child pseudo-process a variable that was \f(CWlocal()\fRed
+in a parent pseudo-process before the \f(CW\*(C`fork\*(C'\fR happened caused memory corruption
+and a crash in the child pseudo-process (and therefore OS process).
+[GH #8641] <https://github.com/Perl/perl5/issues/8641>
+.IP \(bu 4
+Tainted constants evaluated at compile time no longer cause unrelated
+statements to become tainted.
+[GH #14059] <https://github.com/Perl/perl5/issues/14059>
+.IP \(bu 4
+Calling \f(CW\*(C`write\*(C'\fR on a format with a \f(CW\*(C`^**\*(C'\fR field could produce a panic in
+\&\fBsv_chop()\fR if there were insufficient arguments or if the variable used to fill
+the field was empty.
+[GH #14255] <https://github.com/Perl/perl5/issues/14255>
+.IP \(bu 4
+In Perl 5.20.0, \f(CW\*(C`sort CORE::fake\*(C'\fR where 'fake' is anything other than a
+keyword started chopping of the last 6 characters and treating the result as a
+sort sub name.  The previous behaviour of treating "CORE::fake" as a sort sub
+name has been restored.
+[GH #14323] <https://github.com/Perl/perl5/issues/14323>
+.IP \(bu 4
+A bug in regular expression patterns that could lead to segfaults and other
+crashes has been fixed.  This occurred only in patterns compiled with \f(CW"/i"\fR,
+while taking into account the current POSIX locale (this usually means they
+have to be compiled within the scope of \f(CW"use\ locale"\fR), and there must be
+a string of at least 128 consecutive bytes to match.
+[GH #14389] <https://github.com/Perl/perl5/issues/14389>
+.IP \(bu 4
+\&\f(CW\*(C`qr/@array(?{block})/\*(C'\fR no longer dies with "Bizarre copy of ARRAY".
+[GH #14292] <https://github.com/Perl/perl5/issues/14292>
+.IP \(bu 4
+\&\f(CW\*(C`gmtime\*(C'\fR no longer crashes with not-a-number values.
+[GH #14365] <https://github.com/Perl/perl5/issues/14365>
+.IP \(bu 4
+Certain syntax errors in substitutions, such as \f(CW\*(C`s/${<>{})//\*(C'\fR, would
+crash, and had done so since Perl 5.10.  (In some cases the crash did not start
+happening until Perl 5.16.)  The crash has, of course, been fixed.
+[GH #14391] <https://github.com/Perl/perl5/issues/14391>
+.IP \(bu 4
+A memory leak in some regular expressions, introduced in Perl 5.20.1, has been
+fixed.
+[GH #14236] <https://github.com/Perl/perl5/issues/14236>
+.IP \(bu 4
+\&\f(CW\*(C`formline("@...", "a");\*(C'\fR would crash.  The \f(CW\*(C`FF_CHECKNL\*(C'\fR case in
+\&\fBpp_formline()\fR didn't set the pointer used to mark the chop position, which led
+to the \f(CW\*(C`FF_MORE\*(C'\fR case crashing with a segmentation fault.  This has been
+fixed.
+[GH #14388] <https://github.com/Perl/perl5/issues/14388>
+[GH #14425] <https://github.com/Perl/perl5/issues/14425>
+.IP \(bu 4
+A possible buffer overrun and crash when parsing a literal pattern during
+regular expression compilation has been fixed.
+[GH #14416] <https://github.com/Perl/perl5/issues/14416>
+.SH "Known Problems"
+.IX Header "Known Problems"
+.IP \(bu 4
+It is a known bug that lexical subroutines cannot be used as the \f(CW\*(C`SUBNAME\*(C'\fR
+argument to \f(CW\*(C`sort\*(C'\fR.  This will be fixed in a future version of Perl.
+.SH "Errata From Previous Releases"
+.IX Header "Errata From Previous Releases"
+.IP \(bu 4
+A regression has been fixed that was introduced in Perl 5.20.0 (fixed in Perl
+5.20.1 as well as here) in which a UTF\-8 encoded regular expression pattern
+that contains a single ASCII lowercase letter does not match its uppercase
+counterpart.
+[GH #14051] <https://github.com/Perl/perl5/issues/14051>
+.SH Acknowledgements
+.IX Header "Acknowledgements"
+Perl 5.20.2 represents approximately 5 months of development since Perl 5.20.1
+and contains approximately 6,300 lines of changes across 170 files from 34
+authors.
+.PP
+Excluding auto-generated files, documentation and release tools, there were
+approximately 1,900 lines of changes to 80 .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.2:
+.PP
+Aaron Crane, Abigail, Andreas Voegele, Andy Dougherty, Anthony Heading,
+Aristotle Pagaltzis, Chris 'BinGOs' Williams, Craig A. Berry, Daniel Dragan,
+Doug Bell, Ed J, Father Chrysostomos, Glenn D. Golden, H.Merijn Brand, Hugo van
+der Sanden, James E Keenan, Jarkko Hietaniemi, Jim Cromie, Karen Etheridge,
+Karl Williamson, kmx, Matthew Horsfall, Max Maischein, Peter Martini, Rafael
+Garcia-Suarez, Ricardo Signes, Shlomi Fish, Slaven Rezic, Steffen Müller,
+Steve Hay, Tadeusz Sośnierz, Tony Cook, Yves Orton, Ævar Arnfjörð
+Bjarmason.
+.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.