Adding upstream version 4.22.0.upstream/4.22.0

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

1 files changed, 303 insertions, 0 deletions

diff --git a/upstream/fedora-rawhide/man1/perl587delta.1 b/upstream/fedora-rawhide/man1/perl587delta.1
new file mode 100644
index 00000000..d7e1d485
--- /dev/null
+++ b/upstream/fedora-rawhide/man1/perl587delta.1
@@ -0,0 +1,303 @@
+.\" -*- 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 "PERL587DELTA 1"
+.TH PERL587DELTA 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
+perl587delta \- what is new for perl v5.8.7
+.SH DESCRIPTION
+.IX Header "DESCRIPTION"
+This document describes differences between the 5.8.6 release and
+the 5.8.7 release.
+.SH "Incompatible Changes"
+.IX Header "Incompatible Changes"
+There are no changes incompatible with 5.8.6.
+.SH "Core Enhancements"
+.IX Header "Core Enhancements"
+.SS "Unicode Character Database 4.1.0"
+.IX Subsection "Unicode Character Database 4.1.0"
+The copy of the Unicode Character Database included in Perl 5.8 has
+been updated to 4.1.0 from 4.0.1. See
+<http://www.unicode.org/versions/Unicode4.1.0/#NotableChanges> for the
+notable changes.
+.SS "suidperl less insecure"
+.IX Subsection "suidperl less insecure"
+A pair of exploits in \f(CW\*(C`suidperl\*(C'\fR involving debugging code have been closed.
+.PP
+For new projects the core perl team strongly recommends that you use
+dedicated, single purpose security tools such as \f(CW\*(C`sudo\*(C'\fR in preference to
+\&\f(CW\*(C`suidperl\*(C'\fR.
+.SS "Optional site customization script"
+.IX Subsection "Optional site customization script"
+The perl interpreter can be built to allow the use of a site customization
+script. By default this is not enabled, to be consistent with previous perl
+releases. To use this, add \f(CW\*(C`\-Dusesitecustomize\*(C'\fR to the command line flags
+when running the \f(CW\*(C`Configure\*(C'\fR script. See also "\-f" in perlrun.
+.ie n .SS """Config.pm"" is now much smaller."
+.el .SS "\f(CWConfig.pm\fP is now much smaller."
+.IX Subsection "Config.pm is now much smaller."
+\&\f(CW\*(C`Config.pm\*(C'\fR is now about 3K rather than 32K, with the infrequently used
+code and \f(CW%Config\fR values loaded on demand. This is transparent to the
+programmer, but means that most code will save parsing and loading 29K of
+script (for example, code that uses \f(CW\*(C`File::Find\*(C'\fR).
+.SH "Modules and Pragmata"
+.IX Header "Modules and Pragmata"
+.IP \(bu 4
+B upgraded to version 1.09
+.IP \(bu 4
+base upgraded to version 2.07
+.IP \(bu 4
+bignum upgraded to version 0.17
+.IP \(bu 4
+bytes upgraded to version 1.02
+.IP \(bu 4
+Carp upgraded to version 1.04
+.IP \(bu 4
+CGI upgraded to version 3.10
+.IP \(bu 4
+Class::ISA upgraded to version 0.33
+.IP \(bu 4
+Data::Dumper upgraded to version 2.121_02
+.IP \(bu 4
+DB_File upgraded to version 1.811
+.IP \(bu 4
+Devel::PPPort upgraded to version 3.06
+.IP \(bu 4
+Digest upgraded to version 1.10
+.IP \(bu 4
+Encode upgraded to version 2.10
+.IP \(bu 4
+FileCache upgraded to version 1.05
+.IP \(bu 4
+File::Path upgraded to version 1.07
+.IP \(bu 4
+File::Temp upgraded to version 0.16
+.IP \(bu 4
+IO::File upgraded to version 1.11
+.IP \(bu 4
+IO::Socket upgraded to version 1.28
+.IP \(bu 4
+Math::BigInt upgraded to version 1.77
+.IP \(bu 4
+Math::BigRat upgraded to version 0.15
+.IP \(bu 4
+overload upgraded to version 1.03
+.IP \(bu 4
+PathTools upgraded to version 3.05
+.IP \(bu 4
+Pod::HTML upgraded to version 1.0503
+.IP \(bu 4
+Pod::Perldoc upgraded to version 3.14
+.IP \(bu 4
+Pod::LaTeX upgraded to version 0.58
+.IP \(bu 4
+Pod::Parser upgraded to version 1.30
+.IP \(bu 4
+Symbol upgraded to version 1.06
+.IP \(bu 4
+Term::ANSIColor upgraded to version 1.09
+.IP \(bu 4
+Test::Harness upgraded to version 2.48
+.IP \(bu 4
+Test::Simple upgraded to version 0.54
+.IP \(bu 4
+Text::Wrap upgraded to version 2001.09293, to fix a bug when \fBwrap()\fR was
+called with a non-space separator.
+.IP \(bu 4
+threads::shared upgraded to version 0.93
+.IP \(bu 4
+Time::HiRes upgraded to version 1.66
+.IP \(bu 4
+Time::Local upgraded to version 1.11
+.IP \(bu 4
+Unicode::Normalize upgraded to version 0.32
+.IP \(bu 4
+utf8 upgraded to version 1.05
+.IP \(bu 4
+Win32 upgraded to version 0.24, which provides Win32::GetFileVersion
+.SH "Utility Changes"
+.IX Header "Utility Changes"
+.SS "find2perl enhancements"
+.IX Subsection "find2perl enhancements"
+\&\f(CW\*(C`find2perl\*(C'\fR has new options \f(CW\*(C`\-iname\*(C'\fR, \f(CW\*(C`\-path\*(C'\fR and \f(CW\*(C`\-ipath\*(C'\fR.
+.SH "Performance Enhancements"
+.IX Header "Performance Enhancements"
+The internal pointer mapping hash used during ithreads cloning now uses an
+arena for memory allocation. In tests this reduced ithreads cloning time by
+about 10%.
+.SH "Installation and Configuration Improvements"
+.IX Header "Installation and Configuration Improvements"
+.IP \(bu 4
+The Win32 "dmake" makefile.mk has been updated to make it compatible
+with the latest versions of dmake.
+.IP \(bu 4
+\&\f(CW\*(C`PERL_MALLOC\*(C'\fR, \f(CW\*(C`DEBUG_MSTATS\*(C'\fR, \f(CW\*(C`PERL_HASH_SEED_EXPLICIT\*(C'\fR and \f(CW\*(C`NO_HASH_SEED\*(C'\fR
+should now work in Win32 makefiles.
+.SH "Selected Bug Fixes"
+.IX Header "Selected Bug Fixes"
+.IP \(bu 4
+The \fBsocket()\fR function on Win32 has been fixed so that it is able to use
+transport providers which specify a protocol of 0 (meaning any protocol
+is allowed) once more.  (This was broken in 5.8.6, and typically caused
+the use of ICMP sockets to fail.)
+.IP \(bu 4
+Another obscure bug involving \f(CW\*(C`substr\*(C'\fR and UTF\-8 caused by bad internal
+offset caching has been identified and fixed.
+.IP \(bu 4
+A bug involving the loading of UTF\-8 tables by the regexp engine has been
+fixed \- code such as \f(CW\*(C`"\ex{100}" =~ /[[:print:]]/\*(C'\fR will no longer give
+corrupt results.
+.IP \(bu 4
+Case conversion operations such as \f(CW\*(C`uc\*(C'\fR on a long Unicode string could
+exhaust memory. This has been fixed.
+.IP \(bu 4
+\&\f(CW\*(C`index\*(C'\fR/\f(CW\*(C`rindex\*(C'\fR were buggy for some combinations of Unicode and
+non-Unicode data. This has been fixed.
+.IP \(bu 4
+\&\f(CW\*(C`read\*(C'\fR (and presumably \f(CW\*(C`sysread\*(C'\fR) would expose the UTF\-8 internals when
+reading from a byte oriented file handle into a UTF\-8 scalar. This has
+been fixed.
+.IP \(bu 4
+Several \f(CW\*(C`pack\*(C'\fR/\f(CW\*(C`unpack\*(C'\fR bug fixes:
+.RS 4
+.IP \(bu 4
+Checksums with \f(CW\*(C`b\*(C'\fR or \f(CW\*(C`B\*(C'\fR formats were broken.
+.IP \(bu 4
+\&\f(CW\*(C`unpack\*(C'\fR checksums could overflow with the \f(CW\*(C`C\*(C'\fR format.
+.IP \(bu 4
+\&\f(CW\*(C`U0\*(C'\fR and \f(CW\*(C`C0\*(C'\fR are now scoped to \f(CW\*(C`()\*(C'\fR \f(CW\*(C`pack\*(C'\fR sub-templates.
+.IP \(bu 4
+Counted length prefixes now don't change \f(CW\*(C`C0\*(C'\fR/\f(CW\*(C`U0\*(C'\fR mode.
+.IP \(bu 4
+\&\f(CW\*(C`pack\*(C'\fR \f(CW\*(C`Z0\*(C'\fR used to destroy the preceding character.
+.IP \(bu 4
+\&\f(CW\*(C`P\*(C'\fR/\f(CW\*(C`p\*(C'\fR \f(CW\*(C`pack\*(C'\fR formats used to only recognise literal \f(CW\*(C`undef\*(C'\fR
+.RE
+.RS 4
+.RE
+.IP \(bu 4
+Using closures with ithreads could cause perl to crash. This was due to
+failure to correctly lock internal OP structures, and has been fixed.
+.IP \(bu 4
+The return value of \f(CW\*(C`close\*(C'\fR now correctly reflects any file errors that
+occur while flushing the handle's data, instead of just giving failure if
+the actual underlying file close operation failed.
+.IP \(bu 4
+\&\f(CW\*(C`not() || 1\*(C'\fR used to segfault. \f(CWnot()\fR now behaves like \f(CWnot(0)\fR, which was
+the pre 5.6.0 behaviour.
+.IP \(bu 4
+\&\f(CW\*(C`h2ph\*(C'\fR has various enhancements to cope with constructs in header files that
+used to result in incorrect or invalid output.
+.SH "New or Changed Diagnostics"
+.IX Header "New or Changed Diagnostics"
+There is a new taint error, "%ENV is aliased to \f(CW%s\fR". This error is thrown
+when taint checks are enabled and when \f(CW*ENV\fR has been aliased, so that
+\&\f(CW%ENV\fR has no env-magic anymore and hence the environment cannot be verified
+as taint-free.
+.PP
+The internals of \f(CW\*(C`pack\*(C'\fR and \f(CW\*(C`unpack\*(C'\fR have been updated. All legitimate
+templates should work as before, but there may be some changes in the error
+reported for complex failure cases. Any behaviour changes for non-error cases
+are bugs, and should be reported.
+.SH "Changed Internals"
+.IX Header "Changed Internals"
+There has been a fair amount of refactoring of the \f(CW\*(C`C\*(C'\fR source code, partly to
+make it tidier and more maintainable. The resulting object code and the
+\&\f(CW\*(C`perl\*(C'\fR binary may well be smaller than 5.8.6, and hopefully faster in some
+cases, but apart from this there should be no user-detectable changes.
+.PP
+\&\f(CW\*(C`${^UTF8LOCALE}\*(C'\fR has been added to give perl space access to \f(CW\*(C`PL_utf8locale\*(C'\fR.
+.PP
+The size of the arenas used to allocate SV heads and most SV bodies can now
+be changed at compile time. The old size was 1008 bytes, the new default size
+is 4080 bytes.
+.SH "Known Problems"
+.IX Header "Known Problems"
+Unicode strings returned from overloaded operators can be buggy. This is a
+long standing bug reported since 5.8.6 was released, but we do not yet have
+a suitable fix for it.
+.SH "Platform Specific Problems"
+.IX Header "Platform Specific Problems"
+On UNICOS, lib/Math/BigInt/t/bigintc.t hangs burning CPU.
+ext/B/t/bytecode.t and ext/Socket/t/socketpair.t both fail tests.
+These are unlikely to be resolved, as our valiant UNICOS porter's last
+Cray is being decommissioned.
+.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 http://bugs.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 \fBperlbug\fR
+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.  You can browse and search
+the Perl 5 bugs at http://bugs.perl.org/
+.SH "SEE ALSO"
+.IX Header "SEE ALSO"
+The \fIChanges\fR file for 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.