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