Adding upstream version 4.22.0.upstream/4.22.0

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

1 files changed, 299 insertions, 0 deletions

diff --git a/upstream/debian-unstable/man1/perl584delta.1 b/upstream/debian-unstable/man1/perl584delta.1
new file mode 100644
index 00000000..db2507f2
--- /dev/null
+++ b/upstream/debian-unstable/man1/perl584delta.1
@@ -0,0 +1,299 @@
+.\" -*- 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 "PERL584DELTA 1"
+.TH PERL584DELTA 1 2024-01-12 "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
+perl584delta \- what is new for perl v5.8.4
+.SH DESCRIPTION
+.IX Header "DESCRIPTION"
+This document describes differences between the 5.8.3 release and
+the 5.8.4 release.
+.SH "Incompatible Changes"
+.IX Header "Incompatible Changes"
+Many minor bugs have been fixed. Scripts which happen to rely on previously
+erroneous behaviour will consider these fixes as incompatible changes :\-)
+You are advised to perform sufficient acceptance testing on this release
+to satisfy yourself that this does not affect you, before putting this
+release into production.
+.PP
+The diagnostic output of Carp has been changed slightly, to add a space after
+the comma between arguments. This makes it much easier for tools such as
+web browsers to wrap it, but might confuse any automatic tools which perform
+detailed parsing of Carp output.
+.PP
+The internal dump output has been improved, so that non-printable characters
+such as newline and backspace are output in \f(CW\*(C`\ex\*(C'\fR notation, rather than
+octal. This might just confuse non-robust tools which parse the output of
+modules such as Devel::Peek.
+.SH "Core Enhancements"
+.IX Header "Core Enhancements"
+.SS "Malloc wrapping"
+.IX Subsection "Malloc wrapping"
+Perl can now be built to detect attempts to assign pathologically large chunks
+of memory.  Previously such assignments would suffer from integer wrap-around
+during size calculations causing a misallocation, which would crash perl, and
+could theoretically be used for "stack smashing" attacks.  The wrapping
+defaults to enabled on platforms where we know it works (most AIX
+configurations, BSDi, Darwin, DEC OSF/1, FreeBSD, HP/UX, GNU Linux, OpenBSD,
+Solaris, VMS and most Win32 compilers) and defaults to disabled on other
+platforms.
+.SS "Unicode Character Database 4.0.1"
+.IX Subsection "Unicode Character Database 4.0.1"
+The copy of the Unicode Character Database included in Perl 5.8 has
+been updated to 4.0.1 from 4.0.0.
+.SS "suidperl less insecure"
+.IX Subsection "suidperl less insecure"
+Paul Szabo has analysed and patched \f(CW\*(C`suidperl\*(C'\fR to remove existing known
+insecurities. Currently there are no known holes in \f(CW\*(C`suidperl\*(C'\fR, but previous
+experience shows that we cannot be confident that these were the last. You may
+no longer invoke the set uid perl directly, so to preserve backwards
+compatibility with scripts that invoke #!/usr/bin/suidperl the only set uid
+binary is now \f(CW\*(C`sperl5.8.\*(C'\fR\fIn\fR (\f(CW\*(C`sperl5.8.4\*(C'\fR for this release). \f(CW\*(C`suidperl\*(C'\fR
+is installed as a hard link to \f(CW\*(C`perl\*(C'\fR; both \f(CW\*(C`suidperl\*(C'\fR and \f(CW\*(C`perl\*(C'\fR will
+invoke \f(CW\*(C`sperl5.8.4\*(C'\fR automatically the set uid binary, so this change should
+be completely transparent.
+.PP
+For new projects the core perl team would strongly recommend 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 format
+.IX Subsection "format"
+In addition to bug fixes, \f(CW\*(C`format\*(C'\fR's features have been enhanced. See
+perlform
+.SH "Modules and Pragmata"
+.IX Header "Modules and Pragmata"
+The (mis)use of \f(CW\*(C`/tmp\*(C'\fR in core modules and documentation has been tidied up.
+Some modules available both within the perl core and independently from CPAN
+("dual-life modules") have not yet had these changes applied; the changes
+will be integrated into future stable perl releases as the modules are
+updated on CPAN.
+.SS "Updated modules"
+.IX Subsection "Updated modules"
+.IP Attribute::Handlers 4
+.IX Item "Attribute::Handlers"
+.PD 0
+.IP B 4
+.IX Item "B"
+.IP Benchmark 4
+.IX Item "Benchmark"
+.IP CGI 4
+.IX Item "CGI"
+.IP Carp 4
+.IX Item "Carp"
+.IP Cwd 4
+.IX Item "Cwd"
+.IP Exporter 4
+.IX Item "Exporter"
+.IP File::Find 4
+.IX Item "File::Find"
+.IP IO 4
+.IX Item "IO"
+.IP IPC::Open3 4
+.IX Item "IPC::Open3"
+.IP Local::Maketext 4
+.IX Item "Local::Maketext"
+.IP Math::BigFloat 4
+.IX Item "Math::BigFloat"
+.IP Math::BigInt 4
+.IX Item "Math::BigInt"
+.IP Math::BigRat 4
+.IX Item "Math::BigRat"
+.IP MIME::Base64 4
+.IX Item "MIME::Base64"
+.IP ODBM_File 4
+.IX Item "ODBM_File"
+.IP POSIX 4
+.IX Item "POSIX"
+.IP Shell 4
+.IX Item "Shell"
+.IP Socket 4
+.IX Item "Socket"
+.PD
+There is experimental support for Linux abstract Unix domain sockets.
+.IP Storable 4
+.IX Item "Storable"
+.PD 0
+.IP Switch 4
+.IX Item "Switch"
+.PD
+Synced with its CPAN version 2.10
+.IP Sys::Syslog 4
+.IX Item "Sys::Syslog"
+\&\f(CWsyslog()\fR can now use numeric constants for facility names and priorities,
+in addition to strings.
+.IP Term::ANSIColor 4
+.IX Item "Term::ANSIColor"
+.PD 0
+.IP Time::HiRes 4
+.IX Item "Time::HiRes"
+.IP Unicode::UCD 4
+.IX Item "Unicode::UCD"
+.IP Win32 4
+.IX Item "Win32"
+.PD
+Win32.pm/Win32.xs has moved from the libwin32 module to core Perl
+.IP base 4
+.IX Item "base"
+.PD 0
+.IP open 4
+.IX Item "open"
+.IP threads 4
+.IX Item "threads"
+.PD
+Detached threads are now also supported on Windows.
+.IP utf8 4
+.IX Item "utf8"
+.SH "Performance Enhancements"
+.IX Header "Performance Enhancements"
+.PD 0
+.IP \(bu 4
+.PD
+Accelerated Unicode case mappings (\f(CW\*(C`/i\*(C'\fR, \f(CW\*(C`lc\*(C'\fR, \f(CW\*(C`uc\*(C'\fR, etc).
+.IP \(bu 4
+In place sort optimised (eg \f(CW\*(C`@a = sort @a\*(C'\fR)
+.IP \(bu 4
+Unnecessary assignment optimised away in
+.Sp
+.Vb 3
+\&  my $s = undef;
+\&  my @a = ();
+\&  my %h = ();
+.Ve
+.IP \(bu 4
+Optimised \f(CW\*(C`map\*(C'\fR in scalar context
+.SH "Utility Changes"
+.IX Header "Utility Changes"
+The Perl debugger (\fIlib/perl5db.pl\fR) can now save all debugger commands for
+sourcing later, and can display the parent inheritance tree of a given class.
+.SH "Installation and Configuration Improvements"
+.IX Header "Installation and Configuration Improvements"
+The build process on both VMS and Windows has had several minor improvements
+made. On Windows Borland's C compiler can now compile perl with PerlIO and/or
+USE_LARGE_FILES enabled.
+.PP
+\&\f(CW\*(C`perl.exe\*(C'\fR on Windows now has a "Camel" logo icon. The use of a camel with
+the topic of Perl is a trademark of O'Reilly and Associates Inc., and is used
+with their permission (ie distribution of the source, compiling a Windows
+executable from it, and using that executable locally). Use of the supplied
+camel for anything other than a perl executable's icon is specifically not
+covered, and anyone wishing to redistribute perl binaries \fIwith\fR the icon
+should check directly with O'Reilly beforehand.
+.PP
+Perl should build cleanly on Stratus VOS once more.
+.SH "Selected Bug Fixes"
+.IX Header "Selected Bug Fixes"
+More utf8 bugs fixed, notably in how \f(CW\*(C`chomp\*(C'\fR, \f(CW\*(C`chop\*(C'\fR, \f(CW\*(C`send\*(C'\fR, and
+\&\f(CW\*(C`syswrite\*(C'\fR and interact with utf8 data. Concatenation now works correctly
+when \f(CW\*(C`use bytes;\*(C'\fR is in scope.
+.PP
+Pragmata are now correctly propagated into (?{...}) constructions in regexps.
+Code such as
+.PP
+.Vb 1
+\&   my $x = qr{ ... (??{ $x }) ... };
+.Ve
+.PP
+will now (correctly) fail under use strict. (As the inner \f(CW$x\fR is and
+has always referred to \f(CW$::x\fR)
+.PP
+The "const in void context" warning has been suppressed for a constant in an
+optimised-away boolean expression such as \f(CW\*(C`5 || print;\*(C'\fR
+.PP
+\&\f(CW\*(C`perl \-i\*(C'\fR could \f(CWfchmod(stdin)\fR by mistake. This is serious if stdin is
+attached to a terminal, and perl is running as root. Now fixed.
+.SH "New or Changed Diagnostics"
+.IX Header "New or Changed Diagnostics"
+\&\f(CW\*(C`Carp\*(C'\fR and the internal diagnostic routines used by \f(CW\*(C`Devel::Peek\*(C'\fR have been
+made clearer, as described in "Incompatible Changes"
+.SH "Changed Internals"
+.IX Header "Changed Internals"
+Some bugs have been fixed in the hash internals. Restricted hashes and
+their place holders are now allocated and deleted at slightly different times,
+but this should not be visible to user code.
+.SH "Future Directions"
+.IX Header "Future Directions"
+Code freeze for the next maintenance release (5.8.5) will be on 30th June
+2004, with release by mid July.
+.SH "Platform Specific Problems"
+.IX Header "Platform Specific Problems"
+This release is known not to build on Windows 95.
+.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.