diff options
Diffstat (limited to 'upstream/debian-bookworm/man1/perl5121delta.1')
| -rw-r--r-- | upstream/debian-bookworm/man1/perl5121delta.1 | 341 |
1 files changed, 341 insertions, 0 deletions
diff --git a/upstream/debian-bookworm/man1/perl5121delta.1 b/upstream/debian-bookworm/man1/perl5121delta.1 new file mode 100644 index 00000000..c57104ae --- /dev/null +++ b/upstream/debian-bookworm/man1/perl5121delta.1 @@ -0,0 +1,341 @@ +.\" 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 "PERL5121DELTA 1" +.TH PERL5121DELTA 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" +perl5121delta \- what is new for perl v5.12.1 +.SH "DESCRIPTION" +.IX Header "DESCRIPTION" +This document describes differences between the 5.12.0 release and +the 5.12.1 release. +.PP +If you are upgrading from an earlier release such as 5.10.1, first read +perl5120delta, which describes differences between 5.10.0 and +5.12.0. +.SH "Incompatible Changes" +.IX Header "Incompatible Changes" +There are no changes intentionally incompatible with 5.12.0. If any +incompatibilities with 5.12.0 exist, they are bugs. Please report them. +.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 "Pragmata Changes" +.IX Subsection "Pragmata Changes" +.IP "\(bu" 4 +We fixed exporting of \f(CW\*(C`is_strict\*(C'\fR and \f(CW\*(C`is_lax\*(C'\fR from version. +.Sp +These were being exported with a wrapper that treated them as method +calls, which caused them to fail. They are just functions, are +documented as such, and should never be subclassed, so this patch +just exports them directly as functions without the wrapper. +.SS "Updated Modules" +.IX Subsection "Updated Modules" +.IP "\(bu" 4 +We upgraded \s-1CGI\s0 to version 3.49 to incorporate fixes for regressions +introduced in the release we shipped with Perl 5.12.0. +.IP "\(bu" 4 +We upgraded Pod::Simple to version 3.14 to get an improvement to \eC\e<\e< \e>\e> +parsing. +.IP "\(bu" 4 +We made a small fix to the \s-1CPANPLUS\s0 test suite to fix an occasional spurious test failure. +.IP "\(bu" 4 +We upgraded Safe to version 2.27 to wrap coderefs returned by \f(CW\*(C`reval()\*(C'\fR and \f(CW\*(C`rdo()\*(C'\fR. +.SH "Changes to Existing Documentation" +.IX Header "Changes to Existing Documentation" +.IP "\(bu" 4 +We added the new maintenance release policy to perlpolicy +.IP "\(bu" 4 +We've clarified the multiple-angle-bracket construct in the spec for \s-1POD\s0 +in perlpodspec +.IP "\(bu" 4 +We added a missing explanation for a warning about \f(CW\*(C`:=\*(C'\fR to perldiag +.IP "\(bu" 4 +We removed a false claim in perlunitut that all text strings are Unicode strings in Perl. +.IP "\(bu" 4 +We updated the GitHub mirror link in perlrepository to mirrors/perl, not github/perl +.IP "\(bu" 4 +We fixed a minor error in perl5114delta. +.IP "\(bu" 4 +We replaced a mention of the now-obsolete Switch with \fIgiven\fR/\fIwhen\fR. +.IP "\(bu" 4 +We improved documentation about \fI\f(CI$sitelibexp\fI/sitecustomize.pl\fR in perlrun. +.IP "\(bu" 4 +We corrected perlmodlib which had unintentionally omitted a number of modules. +.IP "\(bu" 4 +We updated the documentation for 'require' in perlfunc relating to putting Perl code in \f(CW@INC\fR. +.IP "\(bu" 4 +We reinstated some erroneously-removed documentation about quotemeta in perlfunc. +.IP "\(bu" 4 +We fixed an \fIa2p\fR example in perlutil. +.IP "\(bu" 4 +We filled in a blank in perlport with the release date of Perl 5.12. +.IP "\(bu" 4 +We fixed broken links in a number of perldelta files. +.IP "\(bu" 4 +The documentation for Carp incorrectly stated that the \f(CW$Carp::Verbose\fR +variable makes cluck generate stack backtraces. +.IP "\(bu" 4 +We fixed a number of typos in Pod::Functions +.IP "\(bu" 4 +We improved documentation of case-changing functions in perlfunc +.IP "\(bu" 4 +We corrected perlgpl to contain the correct version of the \s-1GNU\s0 +General Public License. +.SH "Testing" +.IX Header "Testing" +.SS "Testing Improvements" +.IX Subsection "Testing Improvements" +.IP "\(bu" 4 +\&\fIt/op/sselect.t\fR is now less prone to clock jitter during timing checks +on Windows. +.Sp +\&\fBsleep()\fR time on Win32 may be rounded down to multiple of +the clock tick interval. +.IP "\(bu" 4 +\&\fIlib/blib.t\fR and \fIlib/locale.t\fR: Fixes for test failures on Darwin/PPC +.IP "\(bu" 4 +\&\fIperl5db.t\fR: Fix for test failures when \f(CW\*(C`Term::ReadLine::Gnu\*(C'\fR is installed. +.SH "Installation and Configuration Improvements" +.IX Header "Installation and Configuration Improvements" +.SS "Configuration improvements" +.IX Subsection "Configuration improvements" +.IP "\(bu" 4 +We updated \fI\s-1INSTALL\s0\fR with notes about how to deal with broken \fIdbm.h\fR +on OpenSUSE (and possibly other platforms) +.SH "Bug Fixes" +.IX Header "Bug Fixes" +.IP "\(bu" 4 +A bug in how we process filetest operations could cause a segfault. +Filetests don't always expect an op on the stack, so we now use +TOPs only if we're sure that we're not stat'ing the _ filehandle. +This is indicated by OPf_KIDS (as checked in ck_ftst). +.Sp +See also: <https://github.com/Perl/perl5/issues/10335> +.IP "\(bu" 4 +When deparsing a nextstate op that has both a change of package (relative +to the previous nextstate) and a label, the package declaration is now +emitted first, because it is syntactically impermissible for a label to +prefix a package declaration. +.IP "\(bu" 4 +\&\s-1XSUB\s0.h now correctly redefines fgets under \s-1PERL_IMPLICIT_SYS\s0 +.Sp +See also: <http://rt.cpan.org/Public/Bug/Display.html?id=55049> +.IP "\(bu" 4 +utf8::is_utf8 now respects \s-1GMAGIC\s0 (e.g. \f(CW$1\fR) +.IP "\(bu" 4 +\&\s-1XS\s0 code using \f(CW\*(C`fputc()\*(C'\fR or \f(CW\*(C`fputs()\*(C'\fR: on Windows could cause an error +due to their arguments being swapped. +.Sp +See also: <https://github.com/Perl/perl5/issues/10156> +.IP "\(bu" 4 +We fixed a small bug in \fBlex_stuff_pvn()\fR that caused spurious syntax errors +in an obscure situation. It happened when stuffing was performed on the +last line of a file and the line ended with a statement that lacked a +terminating semicolon. +.Sp +See also: <https://github.com/Perl/perl5/issues/10273> +.IP "\(bu" 4 +We fixed a bug that could cause \eN{} constructs followed by a single . to +be parsed incorrectly. +.Sp +See also: <https://github.com/Perl/perl5/issues/10367> +.IP "\(bu" 4 +We fixed a bug that caused when(scalar) without an argument not to be +treated as a syntax error. +.Sp +See also: <https://github.com/Perl/perl5/issues/10287> +.IP "\(bu" 4 +We fixed a regression in the handling of labels immediately before string +evals that was introduced in Perl 5.12.0. +.Sp +See also: <https://github.com/Perl/perl5/issues/10301> +.IP "\(bu" 4 +We fixed a regression in case-insensitive matching of folded characters +in regular expressions introduced in Perl 5.10.1. +.Sp +See also: <https://github.com/Perl/perl5/issues/10193> +.SH "Platform Specific Notes" +.IX Header "Platform Specific Notes" +.SS "HP-UX" +.IX Subsection "HP-UX" +.IP "\(bu" 4 +Perl now allows \-Duse64bitint without promoting to use64bitall on HP-UX +.SS "\s-1AIX\s0" +.IX Subsection "AIX" +.IP "\(bu" 4 +Perl now builds on \s-1AIX 4.2\s0 +.Sp +The changes required work around \s-1AIX 4\s0.2s' lack of support for IPv6, +and limited support for \s-1POSIX\s0 \f(CW\*(C`sigaction()\*(C'\fR. +.SS "FreeBSD 7" +.IX Subsection "FreeBSD 7" +.IP "\(bu" 4 +FreeBSD 7 no longer contains \fI/usr/bin/objformat\fR. At build time, +Perl now skips the \fIobjformat\fR check for versions 7 and higher and +assumes \s-1ELF.\s0 +.SS "\s-1VMS\s0" +.IX Subsection "VMS" +.IP "\(bu" 4 +It's now possible to build extensions on older (pre 7.3\-2) \s-1VMS\s0 systems. +.Sp +\&\s-1DCL\s0 symbol length was limited to 1K up until about seven years or +so ago, but there was no particularly deep reason to prevent those +older systems from configuring and building Perl. +.IP "\(bu" 4 +We fixed the previously-broken \f(CW\*(C`\-Uuseperlio\*(C'\fR build on \s-1VMS.\s0 +.Sp +We were checking a variable that doesn't exist in the non-default +case of disabling perlio. Now we only look at it when it exists. +.IP "\(bu" 4 +We fixed the \-Uuseperlio command-line option in configure.com. +.Sp +Formerly it only worked if you went through all the questions +interactively and explicitly answered no. +.SH "Known Problems" +.IX Header "Known Problems" +.IP "\(bu" 4 +\&\f(CW\*(C`List::Util::first\*(C'\fR misbehaves in the presence of a lexical \f(CW$_\fR +(typically introduced by \f(CW\*(C`my $_\*(C'\fR or implicitly by \f(CW\*(C`given\*(C'\fR). The variable +which gets set for each iteration is the package variable \f(CW$_\fR, not the +lexical \f(CW$_\fR. +.Sp +A similar issue may occur in other modules that provide functions which +take a block as their first argument, like +.Sp +.Vb 1 +\& foo { ... $_ ...} list +.Ve +.Sp +See also: <https://github.com/Perl/perl5/issues/9798> +.IP "\(bu" 4 +\&\f(CW\*(C`Module::Load::Conditional\*(C'\fR and \f(CW\*(C`version\*(C'\fR have an unfortunate +interaction which can cause \f(CW\*(C`CPANPLUS\*(C'\fR to crash when it encounters +an unparseable version string. Upgrading to \f(CW\*(C`CPANPLUS\*(C'\fR 0.9004 or +\&\f(CW\*(C`Module::Load::Conditional\*(C'\fR 0.38 from \s-1CPAN\s0 will resolve this issue. +.SH "Acknowledgements" +.IX Header "Acknowledgements" +Perl 5.12.1 represents approximately four weeks of development since +Perl 5.12.0 and contains approximately 4,000 lines of changes +across 142 files from 28 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.1: +.PP +Ævar Arnfjörð Bjarmason, Chris Williams, chromatic, Craig A. Berry, +David Golden, Father Chrysostomos, Florian Ragwitz, Frank Wiegand, +Gene Sullivan, Goro Fuji, H.Merijn Brand, James E Keenan, Jan Dubois, +Jesse Vincent, Josh ben Jore, Karl Williamson, Leon Brocard, Michael +Schwern, Nga Tang Chan, Nicholas Clark, Niko Tyni, Philippe Bruhat, +Rafael Garcia-Suarez, Ricardo Signes, Steffen Mueller, Todd Rinaldo, +Vincent Pit and Zefram. +.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. |