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