diff options
Diffstat (limited to 'upstream/debian-bookworm/man1/perl5321delta.1')
| -rw-r--r-- | upstream/debian-bookworm/man1/perl5321delta.1 | 280 |
1 files changed, 280 insertions, 0 deletions
diff --git a/upstream/debian-bookworm/man1/perl5321delta.1 b/upstream/debian-bookworm/man1/perl5321delta.1 new file mode 100644 index 00000000..e7086ce2 --- /dev/null +++ b/upstream/debian-bookworm/man1/perl5321delta.1 @@ -0,0 +1,280 @@ +.\" 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 "PERL5321DELTA 1" +.TH PERL5321DELTA 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" +perl5321delta \- what is new for perl v5.32.1 +.SH "DESCRIPTION" +.IX Header "DESCRIPTION" +This document describes differences between the 5.32.0 release and the 5.32.1 +release. +.PP +If you are upgrading from an earlier release such as 5.30.0, first read +perl5320delta, which describes differences between 5.30.0 and 5.32.0. +.SH "Incompatible Changes" +.IX Header "Incompatible Changes" +There are no changes intentionally incompatible with Perl 5.32.0. If any +exist, they are bugs, and we request that you submit a report. See +\&\*(L"Reporting Bugs\*(R" below. +.SH "Modules and Pragmata" +.IX Header "Modules and Pragmata" +.SS "Updated Modules and Pragmata" +.IX Subsection "Updated Modules and Pragmata" +.IP "\(bu" 4 +Data::Dumper has been upgraded from version 2.174 to 2.174_01. +.Sp +A number of memory leaks have been fixed. +.IP "\(bu" 4 +DynaLoader has been upgraded from version 1.47 to 1.47_01. +.IP "\(bu" 4 +Module::CoreList has been upgraded from version 5.20200620 to 5.20210123. +.IP "\(bu" 4 +Opcode has been upgraded from version 1.47 to 1.48. +.Sp +A warning has been added about evaluating untrusted code with the perl +interpreter. +.IP "\(bu" 4 +Safe has been upgraded from version 2.41 to 2.41_01. +.Sp +A warning has been added about evaluating untrusted code with the perl +interpreter. +.SH "Documentation" +.IX Header "Documentation" +.SS "New Documentation" +.IX Subsection "New Documentation" +\fIperlgov\fR +.IX Subsection "perlgov" +.PP +Documentation of the newly formed rules of governance for Perl. +.PP +\fIperlsecpolicy\fR +.IX Subsection "perlsecpolicy" +.PP +Documentation of how the Perl security team operates and how the team evaluates +new security reports. +.SS "Changes to Existing Documentation" +.IX Subsection "Changes to Existing Documentation" +We have attempted to update the documentation to reflect the changes listed in +this document. If you find any we have missed, open an issue at +<https://github.com/Perl/perl5/issues>. +.PP +Additionally, the following selected changes have been made: +.PP +\fIperlop\fR +.IX Subsection "perlop" +.IP "\(bu" 4 +Document range op behaviour change. +.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 +\&\eK not permitted in lookahead/lookbehind in regex; marked by <\-\- \s-1HERE\s0 in m/%s/ +.Sp +This error was incorrectly produced in some cases involving nested lookarounds. +This has been fixed. +.Sp +[\s-1GH\s0 #18123 <https://github.com/Perl/perl5/issues/18123>] +.SH "Configuration and Compilation" +.IX Header "Configuration and Compilation" +.IP "\(bu" 4 +Newer 64\-bit versions of the Intel C/\*(C+ compiler are now recognized and have +the correct flags set. +.IP "\(bu" 4 +We now trap \s-1SIGBUS\s0 when \fIConfigure\fR checks for \f(CW\*(C`va_copy\*(C'\fR. +.Sp +On several systems the attempt to determine if we need \f(CW\*(C`va_copy\*(C'\fR or similar +results in a \s-1SIGBUS\s0 instead of the expected \s-1SIGSEGV,\s0 which previously caused a +core dump. +.Sp +[\s-1GH\s0 #18148 <https://github.com/Perl/perl5/issues/18148>] +.SH "Testing" +.IX Header "Testing" +Tests were added and changed to reflect the other additions and changes in this +release. +.SH "Platform Support" +.IX Header "Platform Support" +.SS "Platform-Specific Notes" +.IX Subsection "Platform-Specific Notes" +.IP "MacOS (Darwin)" 4 +.IX Item "MacOS (Darwin)" +The hints file for darwin has been updated to handle future macOS versions +beyond 10. Perl can now be built on macOS Big Sur. +.Sp +[\s-1GH\s0 #17946 <https://github.com/Perl/perl5/issues/17946>, +\&\s-1GH\s0 #18406 <https://github.com/Perl/perl5/issues/18406>] +.IP "Minix" 4 +.IX Item "Minix" +Build errors on Minix have been fixed. +.Sp +[\s-1GH\s0 #17908 <https://github.com/Perl/perl5/issues/17908>] +.SH "Selected Bug Fixes" +.IX Header "Selected Bug Fixes" +.IP "\(bu" 4 +Some list assignments involving \f(CW\*(C`undef\*(C'\fR on the left-hand side were +over-optimized and produced incorrect results. +.Sp +[\s-1GH\s0 #16685 <https://github.com/Perl/perl5/issues/16685>, +\&\s-1GH\s0 #17816 <https://github.com/Perl/perl5/issues/17816>] +.IP "\(bu" 4 +Fixed a bug in which some regexps with recursive subpatterns matched +incorrectly. +.Sp +[\s-1GH\s0 #18096 <https://github.com/Perl/perl5/issues/18096>] +.IP "\(bu" 4 +Fixed a deadlock that hung the build when Perl is compiled for debugging memory +problems and has \s-1PERL_MEM_LOG\s0 enabled. +.Sp +[\s-1GH\s0 #18341 <https://github.com/Perl/perl5/issues/18341>] +.IP "\(bu" 4 +Fixed a crash in the use of chained comparison operators when run under \*(L"no +warnings 'uninitialized'\*(R". +.Sp +[\s-1GH\s0 #17917 <https://github.com/Perl/perl5/issues/17917>, +\&\s-1GH\s0 #18380 <https://github.com/Perl/perl5/issues/18380>] +.IP "\(bu" 4 +Exceptions thrown from destructors during global destruction are no longer +swallowed. +.Sp +[\s-1GH\s0 #18063 <https://github.com/Perl/perl5/issues/18063>] +.SH "Acknowledgements" +.IX Header "Acknowledgements" +Perl 5.32.1 represents approximately 7 months of development since Perl 5.32.0 +and contains approximately 7,000 lines of changes across 80 files from 23 +authors. +.PP +Excluding auto-generated files, documentation and release tools, there were +approximately 1,300 lines of changes to 23 .pm, .t, .c and .h files. +.PP +Perl continues to flourish into its fourth decade thanks to a vibrant community +of users and developers. The following people are known to have contributed +the improvements that became Perl 5.32.1: +.PP +Adam Hartley, Andy Dougherty, Dagfinn Ilmari Mannsåker, Dan Book, David +Mitchell, Graham Knop, Graham Ollis, Hauke D, H.Merijn Brand, Hugo van der +Sanden, John Lightsey, Karen Etheridge, Karl Williamson, Leon Timmermans, Max +Maischein, Nicolas R., Ricardo Signes, Richard Leach, Sawyer X, Sevan Janiyan, +Steve Hay, Tom Hukins, Tony Cook. +.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 \s-1CPAN\s0 modules +included in Perl's core. We're grateful to the entire \s-1CPAN\s0 community for +helping Perl to flourish. +.PP +For a more complete list of all of Perl's historical contributors, please see +the \fI\s-1AUTHORS\s0\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 perl bug database at +<https://github.com/Perl/perl5/issues>. There may also be information at +<http://www.perl.org/>, the Perl Home Page. +.PP +If you believe you have an unreported bug, please open an issue at +<https://github.com/Perl/perl5/issues>. Be sure to trim your bug down to a +tiny but sufficient test case. +.PP +If the bug you are reporting has security implications which make it +inappropriate to send to a public issue tracker, then see +\&\*(L"\s-1SECURITY VULNERABILITY CONTACT INFORMATION\*(R"\s0 in perlsec for details of how to +report the issue. +.SH "Give Thanks" +.IX Header "Give Thanks" +If you wish to thank the Perl 5 Porters for the work we had done in Perl 5, you +can do so by running the \f(CW\*(C`perlthanks\*(C'\fR program: +.PP +.Vb 1 +\& perlthanks +.Ve +.PP +This will send an email to the Perl 5 Porters list with your show of thanks. +.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. |