Debian Codegraph @

upstream/debian-unstable/man1/perl5321delta.1

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
3 .\"
4 .\" Standard preamble:
5 .\" ========================================================================
6 .de Sp \" Vertical space (when we can't use .PP)
7 .if t .sp .5v
8 .if n .sp
9 ..
10 .de Vb \" Begin verbatim text
11 .ft CW
12 .nf
13 .ne \\$1
14 ..
15 .de Ve \" End verbatim text
16 .ft R
17 .fi
18 ..
19 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20 .ie n \{\
21 . ds C` ""
22 . ds C' ""
23 'br\}
24 .el\{\
25 . ds C`
26 . ds C'
27 'br\}
28 .\"
29 .\" Escape single quotes in literal strings from groff's Unicode transform.
30 .ie \n(.g .ds Aq \(aq
31 .el .ds Aq '
32 .\"
33 .\" If the F register is >0, we'll generate index entries on stderr for
34 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35 .\" entries marked with X<> in POD. Of course, you'll have to process the
36 .\" output yourself in some meaningful fashion.
37 .\"
38 .\" Avoid warning from groff about undefined register 'F'.
39 .de IX
40 ..
41 .nr rF 0
42 .if \n(.g .if rF .nr rF 1
43 .if (\n(rF:(\n(.g==0)) \{\
44 . if \nF \{\
45 . de IX
46 . tm Index:\\$1\t\\n%\t"\\$2"
47 ..
48 . if !\nF==2 \{\
49 . nr % 0
50 . nr F 2
51 . \}
52 . \}
53 .\}
54 .rr rF
55 .\" ========================================================================
56 .\"
57 .IX Title "PERL5321DELTA 1"
58 .TH PERL5321DELTA 1 2025-11-16 "perl v5.40.1" "Perl Programmers Reference Guide"
59 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
60 .\" way too many mistakes in technical documents.
61 .if n .ad l
62 .nh
63 .SH NAME
64 perl5321delta \- what is new for perl v5.32.1
65 .SH DESCRIPTION
66 .IX Header "DESCRIPTION"
67 This document describes differences between the 5.32.0 release and the 5.32.1
68 release.
69 .PP
70 If you are upgrading from an earlier release such as 5.30.0, first read
71 perl5320delta, which describes differences between 5.30.0 and 5.32.0.
72 .SH "Incompatible Changes"
73 .IX Header "Incompatible Changes"
74 There are no changes intentionally incompatible with Perl 5.32.0. If any
75 exist, they are bugs, and we request that you submit a report. See
76 "Reporting Bugs" below.
77 .SH "Modules and Pragmata"
78 .IX Header "Modules and Pragmata"
79 .SS "Updated Modules and Pragmata"
80 .IX Subsection "Updated Modules and Pragmata"
81 .IP \(bu 4
82 Data::Dumper has been upgraded from version 2.174 to 2.174_01.
83 .Sp
84 A number of memory leaks have been fixed.
85 .IP \(bu 4
86 DynaLoader has been upgraded from version 1.47 to 1.47_01.
87 .IP \(bu 4
88 Module::CoreList has been upgraded from version 5.20200620 to 5.20210123.
89 .IP \(bu 4
90 Opcode has been upgraded from version 1.47 to 1.48.
91 .Sp
92 A warning has been added about evaluating untrusted code with the perl
93 interpreter.
94 .IP \(bu 4
95 Safe has been upgraded from version 2.41 to 2.41_01.
96 .Sp
97 A warning has been added about evaluating untrusted code with the perl
98 interpreter.
99 .SH Documentation
100 .IX Header "Documentation"
101 .SS "New Documentation"
102 .IX Subsection "New Documentation"
103 \fIperlgov\fR
104 .IX Subsection "perlgov"
105 .PP
106 Documentation of the newly formed rules of governance for Perl.
107 .PP
108 \fIperlsecpolicy\fR
109 .IX Subsection "perlsecpolicy"
110 .PP
111 Documentation of how the Perl security team operates and how the team evaluates
112 new security reports.
113 .SS "Changes to Existing Documentation"
114 .IX Subsection "Changes to Existing Documentation"
115 We have attempted to update the documentation to reflect the changes listed in
116 this document. If you find any we have missed, open an issue at
117 <https://github.com/Perl/perl5/issues>.
118 .PP
119 Additionally, the following selected changes have been made:
120 .PP
121 \fIperlop\fR
122 .IX Subsection "perlop"
123 .IP \(bu 4
124 Document range op behaviour change.
125 .SH Diagnostics
126 .IX Header "Diagnostics"
127 The following additions or changes have been made to diagnostic output,
128 including warnings and fatal error messages. For the complete list of
129 diagnostic messages, see perldiag.
130 .SS "Changes to Existing Diagnostics"
131 .IX Subsection "Changes to Existing Diagnostics"
132 .IP \(bu 4
133 \&\eK not permitted in lookahead/lookbehind in regex; marked by <\-\- HERE in m/%s/
134 .Sp
135 This error was incorrectly produced in some cases involving nested lookarounds.
136 This has been fixed.
137 .Sp
138 [GH #18123 <https://github.com/Perl/perl5/issues/18123>]
139 .SH "Configuration and Compilation"
140 .IX Header "Configuration and Compilation"
141 .IP \(bu 4
142 Newer 64\-bit versions of the Intel C/C++ compiler are now recognized and have
143 the correct flags set.
144 .IP \(bu 4
145 We now trap SIGBUS when \fIConfigure\fR checks for \f(CW\*(C`va_copy\*(C'\fR.
146 .Sp
147 On several systems the attempt to determine if we need \f(CW\*(C`va_copy\*(C'\fR or similar
148 results in a SIGBUS instead of the expected SIGSEGV, which previously caused a
149 core dump.
150 .Sp
151 [GH #18148 <https://github.com/Perl/perl5/issues/18148>]
152 .SH Testing
153 .IX Header "Testing"
154 Tests were added and changed to reflect the other additions and changes in this
155 release.
156 .SH "Platform Support"
157 .IX Header "Platform Support"
158 .SS "Platform-Specific Notes"
159 .IX Subsection "Platform-Specific Notes"
160 .IP "MacOS (Darwin)" 4
161 .IX Item "MacOS (Darwin)"
162 The hints file for darwin has been updated to handle future macOS versions
163 beyond 10. Perl can now be built on macOS Big Sur.
164 .Sp
165 [GH #17946 <https://github.com/Perl/perl5/issues/17946>,
166 GH #18406 <https://github.com/Perl/perl5/issues/18406>]
167 .IP Minix 4
168 .IX Item "Minix"
169 Build errors on Minix have been fixed.
170 .Sp
171 [GH #17908 <https://github.com/Perl/perl5/issues/17908>]
172 .SH "Selected Bug Fixes"
173 .IX Header "Selected Bug Fixes"
174 .IP \(bu 4
175 Some list assignments involving \f(CW\*(C`undef\*(C'\fR on the left-hand side were
176 over-optimized and produced incorrect results.
177 .Sp
178 [GH #16685 <https://github.com/Perl/perl5/issues/16685>,
179 GH #17816 <https://github.com/Perl/perl5/issues/17816>]
180 .IP \(bu 4
181 Fixed a bug in which some regexps with recursive subpatterns matched
182 incorrectly.
183 .Sp
184 [GH #18096 <https://github.com/Perl/perl5/issues/18096>]
185 .IP \(bu 4
186 Fixed a deadlock that hung the build when Perl is compiled for debugging memory
187 problems and has PERL_MEM_LOG enabled.
188 .Sp
189 [GH #18341 <https://github.com/Perl/perl5/issues/18341>]
190 .IP \(bu 4
191 Fixed a crash in the use of chained comparison operators when run under "no
192 warnings 'uninitialized'".
193 .Sp
194 [GH #17917 <https://github.com/Perl/perl5/issues/17917>,
195 GH #18380 <https://github.com/Perl/perl5/issues/18380>]
196 .IP \(bu 4
197 Exceptions thrown from destructors during global destruction are no longer
198 swallowed.
199 .Sp
200 [GH #18063 <https://github.com/Perl/perl5/issues/18063>]
201 .SH Acknowledgements
202 .IX Header "Acknowledgements"
203 Perl 5.32.1 represents approximately 7 months of development since Perl 5.32.0
204 and contains approximately 7,000 lines of changes across 80 files from 23
205 authors.
206 .PP
207 Excluding auto-generated files, documentation and release tools, there were
208 approximately 1,300 lines of changes to 23 .pm, .t, .c and .h files.
209 .PP
210 Perl continues to flourish into its fourth decade thanks to a vibrant community
211 of users and developers. The following people are known to have contributed
212 the improvements that became Perl 5.32.1:
213 .PP
214 Adam Hartley, Andy Dougherty, Dagfinn Ilmari Mannsåker, Dan Book, David
215 Mitchell, Graham Knop, Graham Ollis, Hauke D, H.Merijn Brand, Hugo van der
216 Sanden, John Lightsey, Karen Etheridge, Karl Williamson, Leon Timmermans, Max
217 Maischein, Nicolas R., Ricardo Signes, Richard Leach, Sawyer X, Sevan Janiyan,
218 Steve Hay, Tom Hukins, Tony Cook.
219 .PP
220 The list above is almost certainly incomplete as it is automatically generated
221 from version control history. In particular, it does not include the names of
222 the (very much appreciated) contributors who reported issues to the Perl bug
223 tracker.
224 .PP
225 Many of the changes included in this version originated in the CPAN modules
226 included in Perl's core. We're grateful to the entire CPAN community for
227 helping Perl to flourish.
228 .PP
229 For a more complete list of all of Perl's historical contributors, please see
230 the \fIAUTHORS\fR file in the Perl source distribution.
231 .SH "Reporting Bugs"
232 .IX Header "Reporting Bugs"
233 If you find what you think is a bug, you might check the perl bug database at
234 <https://github.com/Perl/perl5/issues>. There may also be information at
235 <http://www.perl.org/>, the Perl Home Page.
236 .PP
237 If you believe you have an unreported bug, please open an issue at
238 <https://github.com/Perl/perl5/issues>. Be sure to trim your bug down to a
239 tiny but sufficient test case.
240 .PP
241 If the bug you are reporting has security implications which make it
242 inappropriate to send to a public issue tracker, then see
243 "SECURITY VULNERABILITY CONTACT INFORMATION" in perlsec for details of how to
244 report the issue.
245 .SH "Give Thanks"
246 .IX Header "Give Thanks"
247 If you wish to thank the Perl 5 Porters for the work we had done in Perl 5, you
248 can do so by running the \f(CW\*(C`perlthanks\*(C'\fR program:
249 .PP
250 .Vb 1
251 \& perlthanks
252 .Ve
253 .PP
254 This will send an email to the Perl 5 Porters list with your show of thanks.
255 .SH "SEE ALSO"
256 .IX Header "SEE ALSO"
257 The \fIChanges\fR file for an explanation of how to view exhaustive details on
258 what changed.
259 .PP
260 The \fIINSTALL\fR file for how to build Perl.
261 .PP
262 The \fIREADME\fR file for general stuff.
263 .PP
264 The \fIArtistic\fR and \fICopying\fR files for copyright information.