Adding upstream version 4.22.0.upstream/4.22.0

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

1 files changed, 316 insertions, 0 deletions

diff --git a/upstream/debian-bookworm/man1/perl5122delta.1 b/upstream/debian-bookworm/man1/perl5122delta.1
new file mode 100644
index 00000000..0127f0f0
--- /dev/null
+++ b/upstream/debian-bookworm/man1/perl5122delta.1
@@ -0,0 +1,316 @@
+.\" Automatically generated by Pod::Man 4.14 (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
+..
+.\" Set up some character translations and predefined strings.  \*(-- will
+.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
+.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
+.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
+.\" nothing in troff, for use with C<>.
+.tr \(*W-
+.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.ie n \{\
+.    ds -- \(*W-
+.    ds PI pi
+.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
+.    ds L" ""
+.    ds R" ""
+.    ds C` ""
+.    ds C' ""
+'br\}
+.el\{\
+.    ds -- \|\(em\|
+.    ds PI \(*p
+.    ds L" ``
+.    ds R" ''
+.    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 "PERL5122DELTA 1"
+.TH PERL5122DELTA 1 "2023-11-25" "perl v5.36.0" "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"
+perl5122delta \- what is new for perl v5.12.2
+.SH "DESCRIPTION"
+.IX Header "DESCRIPTION"
+This document describes differences between the 5.12.1 release and
+the 5.12.2 release.
+.PP
+If you are upgrading from an earlier major version, such as 5.10.1,
+first read perl5120delta, which describes differences between 5.10.0
+and 5.12.0, as well as perl5121delta, which describes earlier changes
+in the 5.12 stable release series.
+.SH "Incompatible Changes"
+.IX Header "Incompatible Changes"
+There are no changes intentionally incompatible with 5.12.1. If any exist, they
+are bugs and reports are welcome.
+.SH "Core Enhancements"
+.IX Header "Core Enhancements"
+Other than the bug fixes listed below, there should be no user-visible
+changes to the core language in this release.
+.SH "Modules and Pragmata"
+.IX Header "Modules and Pragmata"
+.SS "New Modules and Pragmata"
+.IX Subsection "New Modules and Pragmata"
+This release does not introduce any new modules or pragmata.
+.SS "Pragmata Changes"
+.IX Subsection "Pragmata Changes"
+In the previous release, \f(CW\*(C`no \f(CIVERSION\f(CW;\*(C'\fR statements triggered a bug
+which could cause feature bundles to be loaded and strict mode to
+be enabled unintentionally.
+.SS "Updated Modules"
+.IX Subsection "Updated Modules"
+.ie n .IP """Carp""" 4
+.el .IP "\f(CWCarp\fR" 4
+.IX Item "Carp"
+Upgraded from version 1.16 to 1.17.
+.Sp
+Carp now detects incomplete \fBcaller()\fR
+overrides and avoids using bogus \f(CW@DB::args\fR. To provide backtraces, Carp
+relies on particular behaviour of the caller built-in. Carp now detects
+if other code has overridden this with an incomplete implementation, and
+modifies its backtrace accordingly. Previously incomplete overrides would
+cause incorrect values in backtraces (best case), or obscure fatal errors
+(worst case)
+.Sp
+This fixes certain cases of \f(CW\*(C`Bizarre copy of ARRAY\*(C'\fR caused by modules
+overriding \f(CW\*(C`caller()\*(C'\fR incorrectly.
+.ie n .IP """CPANPLUS""" 4
+.el .IP "\f(CWCPANPLUS\fR" 4
+.IX Item "CPANPLUS"
+A patch to \fIcpanp-run-perl\fR has been backported from \s-1CPANPLUS\s0 \f(CW0.9004\fR. This
+resolves \s-1RT\s0 #55964 <http://rt.cpan.org/Public/Bug/Display.html?id=55964>
+and \s-1RT\s0 #57106 <http://rt.cpan.org/Public/Bug/Display.html?id=57106>, both
+of which related to failures to install distributions that use
+\&\f(CW\*(C`Module::Install::DSL\*(C'\fR.
+.ie n .IP """File::Glob""" 4
+.el .IP "\f(CWFile::Glob\fR" 4
+.IX Item "File::Glob"
+A regression which caused a failure to find \f(CW\*(C`CORE::GLOBAL::glob\*(C'\fR after
+loading \f(CW\*(C`File::Glob\*(C'\fR to crash has been fixed.  Now, it correctly falls back
+to external globbing via \f(CW\*(C`pp_glob\*(C'\fR.
+.ie n .IP """File::Copy""" 4
+.el .IP "\f(CWFile::Copy\fR" 4
+.IX Item "File::Copy"
+\&\f(CW\*(C`File::Copy::copy(FILE, DIR)\*(C'\fR is now documented.
+.ie n .IP """File::Spec""" 4
+.el .IP "\f(CWFile::Spec\fR" 4
+.IX Item "File::Spec"
+Upgraded from version 3.31 to 3.31_01.
+.Sp
+Several portability fixes were made in \f(CW\*(C`File::Spec::VMS\*(C'\fR: a colon is now
+recognized as a delimiter in native filespecs; caret-escaped delimiters are
+recognized for better handling of extended filespecs; \f(CW\*(C`catpath()\*(C'\fR returns
+an empty directory rather than the current directory if the input directory
+name is empty; \f(CW\*(C`abs2rel()\*(C'\fR properly handles Unix-style input.
+.SH "Utility Changes"
+.IX Header "Utility Changes"
+.IP "\(bu" 4
+\&\fIperlbug\fR now always gives the reporter a chance to change the email address it
+guesses for them.
+.IP "\(bu" 4
+\&\fIperlbug\fR should no longer warn about uninitialized values when using the \f(CW\*(C`\-d\*(C'\fR
+and \f(CW\*(C`\-v\*(C'\fR options.
+.SH "Changes to Existing Documentation"
+.IX Header "Changes to Existing Documentation"
+.IP "\(bu" 4
+The existing policy on backward-compatibility and deprecation has
+been added to perlpolicy, along with definitions of terms like
+\&\fIdeprecation\fR.
+.IP "\(bu" 4
+\&\*(L"srand\*(R" in perlfunc's usage has been clarified.
+.IP "\(bu" 4
+The entry for \*(L"die\*(R" in perlfunc was reorganized to emphasize its
+role in the exception mechanism.
+.IP "\(bu" 4
+Perl's \s-1INSTALL\s0 file has been clarified to explicitly state that Perl
+requires a C89 compliant \s-1ANSI C\s0 Compiler.
+.IP "\(bu" 4
+IO::Socket's \f(CW\*(C`getsockopt()\*(C'\fR and \f(CW\*(C`setsockopt()\*(C'\fR have been documented.
+.IP "\(bu" 4
+\&\fI\f(BIalarm()\fI\fR's inability to interrupt blocking \s-1IO\s0 on Windows has been documented.
+.IP "\(bu" 4
+Math::TrulyRandom hasn't been updated since 1996 and has been removed
+as a recommended solution for random number generation.
+.IP "\(bu" 4
+perlrun has been updated to clarify the behaviour of octal flags to \fIperl\fR.
+.IP "\(bu" 4
+To ease user confusion, \f(CW$#\fR and \f(CW$*\fR, two special variables that were
+removed in earlier versions of Perl have been documented.
+.IP "\(bu" 4
+The version of perlfaq shipped with the Perl core has been updated from the
+official \s-1FAQ\s0 version, which is now maintained in the \f(CW\*(C`briandfoy/perlfaq\*(C'\fR
+branch of the Perl repository at <git://perl5.git.perl.org/perl.git>.
+.SH "Installation and Configuration Improvements"
+.IX Header "Installation and Configuration Improvements"
+.SS "Configuration improvements"
+.IX Subsection "Configuration improvements"
+.IP "\(bu" 4
+The \f(CW\*(C`d_u32align\*(C'\fR configuration probe on \s-1ARM\s0 has been fixed.
+.SS "Compilation improvements"
+.IX Subsection "Compilation improvements"
+.IP "\(bu" 4
+An "\f(CW\*(C`incompatible operand types\*(C'\fR" error in ternary expressions when building
+with \f(CW\*(C`clang\*(C'\fR has been fixed.
+.IP "\(bu" 4
+Perl now skips setuid \f(CW\*(C`File::Copy\*(C'\fR tests on partitions it detects to be mounted
+as \f(CW\*(C`nosuid\*(C'\fR.
+.SH "Selected Bug Fixes"
+.IX Header "Selected Bug Fixes"
+.IP "\(bu" 4
+A possible segfault in the \f(CW\*(C`T_PRTOBJ\*(C'\fR default typemap has been fixed.
+.IP "\(bu" 4
+A possible memory leak when using \fBcaller()\fR to set
+\&\f(CW@DB::args\fR has been fixed.
+.IP "\(bu" 4
+Several memory leaks when loading \s-1XS\s0 modules were fixed.
+.IP "\(bu" 4
+\&\f(CW\*(C`unpack()\*(C'\fR now handles scalar context correctly for \f(CW%32H\fR and \f(CW%32u\fR,
+fixing a potential crash.  \f(CW\*(C`split()\*(C'\fR would crash because the third item
+on the stack wasn't the regular expression it expected.  \f(CW\*(C`unpack("%2H",
+\&...)\*(C'\fR would return both the unpacked result and the checksum on the stack,
+as would \f(CW\*(C`unpack("%2u", ...)\*(C'\fR.
+[\s-1GH\s0 #10257] <https://github.com/Perl/perl5/issues/10257>
+.IP "\(bu" 4
+Perl now avoids using memory after calling \f(CW\*(C`free()\*(C'\fR in \fIpp_require\fR
+when there are CODEREFs in \f(CW@INC\fR.
+.IP "\(bu" 4
+A bug that could cause "\f(CW\*(C`Unknown error\*(C'\fR\*(L" messages when
+\&\*(R"\f(CW\*(C`call_sv(code, G_EVAL)\*(C'\fR" is called from an \s-1XS\s0 destructor has been fixed.
+.IP "\(bu" 4
+The implementation of the \f(CW\*(C`open $fh, \*(Aq>\*(Aq \e$buffer\*(C'\fR feature
+now supports get/set magic and thus tied buffers correctly.
+.IP "\(bu" 4
+The \f(CW\*(C`pp_getc\*(C'\fR, \f(CW\*(C`pp_tell\*(C'\fR, and \f(CW\*(C`pp_eof\*(C'\fR opcodes now make room on the
+stack for their return values in cases where no argument was passed in.
+.IP "\(bu" 4
+When matching unicode strings under some conditions inappropriate backtracking would
+result in a \f(CW\*(C`Malformed UTF\-8 character (fatal)\*(C'\fR error. This should no longer occur.
+See  [\s-1GH\s0 #10434] <https://github.com/Perl/perl5/issues/10434>
+.SH "Platform Specific Notes"
+.IX Header "Platform Specific Notes"
+.SS "\s-1AIX\s0"
+.IX Subsection "AIX"
+.IP "\(bu" 4
+\&\fI\s-1README\s0.aix\fR has been updated with information about the \s-1XL C/\*(C+ V11\s0 compiler
+suite.
+.SS "Windows"
+.IX Subsection "Windows"
+.IP "\(bu" 4
+When building Perl with the mingw64 x64 cross-compiler \f(CW\*(C`incpath\*(C'\fR,
+\&\f(CW\*(C`libpth\*(C'\fR, \f(CW\*(C`ldflags\*(C'\fR, \f(CW\*(C`lddlflags\*(C'\fR and \f(CW\*(C`ldflags_nolargefiles\*(C'\fR values
+in \fIConfig.pm\fR and \fIConfig_heavy.pl\fR were not previously being set
+correctly because, with that compiler, the include and lib directories
+are not immediately below \f(CW\*(C`$(CCHOME)\*(C'\fR.
+.SS "\s-1VMS\s0"
+.IX Subsection "VMS"
+.IP "\(bu" 4
+\&\fIgit_version.h\fR is now installed on \s-1VMS.\s0 This was an oversight in v5.12.0 which
+caused some extensions to fail to build.
+.IP "\(bu" 4
+Several memory leaks in \fBstat()\fR have been fixed.
+.IP "\(bu" 4
+A memory leak in \f(CW\*(C`Perl_rename()\*(C'\fR due to a double allocation has been
+fixed.
+.IP "\(bu" 4
+A memory leak in \f(CW\*(C`vms_fid_to_name()\*(C'\fR (used by \f(CW\*(C`realpath()\*(C'\fR and
+\&\f(CW\*(C`realname()\*(C'\fR) has been fixed.
+.SH "Acknowledgements"
+.IX Header "Acknowledgements"
+Perl 5.12.2 represents approximately three months of development since
+Perl 5.12.1 and contains approximately 2,000 lines of changes across
+100 files from 36 authors.
+.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.12.2:
+.PP
+Abigail, Ævar Arnfjörð Bjarmason, Ben Morrow, brian d foy, Brian
+Phillips, Chas. Owens, Chris 'BinGOs' Williams, Chris Williams,
+Craig A. Berry, Curtis Jewell, Dan Dascalescu, David Golden, David
+Mitchell, Father Chrysostomos, Florian Ragwitz, George Greer, H.Merijn
+Brand, Jan Dubois, Jesse Vincent, Jim Cromie, Karl Williamson, Lars
+Dɪᴇᴄᴋᴏᴡ 迪拉斯, Leon Brocard, Maik Hentsche, Matt S Trout,
+Nicholas Clark, Rafael Garcia-Suarez, Rainer Tammer, Ricardo Signes,
+Salvador Ortiz Garcia, Sisyphus, Slaven Rezic, Steffen Mueller, Tony Cook,
+Vincent Pit and Yves Orton.
+.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://rt.perl.org/perlbug/ .  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.
+.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 \s-1CPAN.\s0
+.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 \fI\s-1INSTALL\s0\fR file for how to build Perl.
+.PP
+The \fI\s-1README\s0\fR file for general stuff.
+.PP
+The \fIArtistic\fR and \fICopying\fR files for copyright information.