This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta tidy-ups
[perl5.git] / pod / perldelta.pod
1 =encoding utf8
2
3 =head1 NAME
4
5 perldelta - what is new for perl v5.31.5
6
7 =head1 DESCRIPTION
8
9 This document describes differences between the 5.31.4 release and the 5.31.5
10 release.
11
12 If you are upgrading from an earlier release such as 5.31.3, first read
13 L<perl5314delta>, which describes differences between 5.31.3 and 5.31.4.
14
15 =head1 Incompatible Changes
16
17 =head2 Modifiable variables are no longer permitted in constants
18
19 Code like:
20
21     my $var;
22     $sub = sub () { $var };
23
24 where C<$var> is referenced elsewhere in some sort of modifiable context now
25 produces an exception when the sub is defined.
26
27 This error can be avoided by adding a return to the sub definition:
28
29     $sub = sub () { return $var };
30
31 This has been deprecated since Perl 5.22.
32
33 L<[perl #131138]|https://rt.perl.org/Ticket/Display.html?id=131138>.
34
35 =head1 Modules and Pragmata
36
37 =head2 Updated Modules and Pragmata
38
39 =over 4
40
41 =item *
42
43 L<B> has been upgraded from version 1.76 to 1.77.
44
45 =item *
46
47 L<B::Deparse> has been upgraded from version 1.49 to 1.50.
48
49 =item *
50
51 L<Devel::PPPort> has been upgraded from version 3.55 to 3.54.
52
53 =item *
54
55 L<Digest::MD5> has been upgraded from version 2.55 to 2.55_01.
56
57 =item *
58
59 L<Dumpvalue> has been upgraded from version 1.18 to 1.21.
60
61 Previously, when dumping elements of an array and encountering an undefined
62 value, the string printed would have been C<empty array>.  This has been
63 changed to what was apparently originally intended:  C<empty slot>.
64
65 =item *
66
67 L<ExtUtils::CBuilder> has been upgraded from version 0.280232 to 0.280233.
68
69 =item *
70
71 L<Math::BigInt> has been upgraded from version 1.999816 to 1.999817_01.
72
73 =item *
74
75 L<Math::BigInt::FastCalc> has been upgraded from version 0.5008 to 0.5009.
76
77 =item *
78
79 L<Module::CoreList> has been upgraded from version 5.20190920 to 5.20191020.
80
81 =item *
82
83 L<Safe> has been upgraded from version 2.40 to 2.41.
84
85 =item *
86
87 L<threads> has been upgraded from version 2.22 to 2.23.
88
89 =item *
90
91 L<Time::HiRes> has been upgraded from version 1.9763 to 1.9764.
92
93 =item *
94
95 L<XS::APItest> has been upgraded from version 1.03 to 1.04.
96
97 =back
98
99 =head1 Documentation
100
101 =head2 Changes to Existing Documentation
102
103 We have attempted to update the documentation to reflect the changes listed in
104 this document.  If you find any we have missed, send email to
105 L<perlbug@perl.org|mailto:perlbug@perl.org>.
106
107 =head3 L<perlguts>
108
109 =over 4
110
111 =item *
112
113 Details of the various stacks within the perl interpreter are now explained
114 here.
115
116 =back
117
118 Additionally, the following selected changes have been made:
119
120 =head3 URLs have been changed to https:// and stale links have been updated
121
122 =over 4
123
124 =item *
125
126 Where applicable, the URLs in the documentation have been moved from using the
127 http:// protocol to https:// .  This also affects the location of the bug
128 tracker at L<https://rt.perl.org>.
129
130 =item *
131
132 Some links to OS/2 libraries, Address Sanitizer and other system tools had gone
133 stale.  These have been updated with working links.
134
135 =item *
136
137 Some links to old mails on perl5-porters had gone stale.  These have been
138 updated with working links.
139
140 =back
141
142 =head1 Diagnostics
143
144 The following additions or changes have been made to diagnostic output,
145 including warnings and fatal error messages.  For the complete list of
146 diagnostic messages, see L<perldiag>.
147
148 =head2 Changes to Existing Diagnostics
149
150 =over 4
151
152 =item *
153
154 L<Can't use global %s in %s|perldiag/"Can't use global %s in %s">
155
156 This error message has been slightly reformatted from the original C<Can't use
157 global %s in "%s">, and in particular misleading error messages like C<Can't
158 use global $_ in "my"> are now rendered as C<Can't use global $_ in subroutine
159 signature>.
160
161 =item *
162
163 L<Constants from lexical variables potentially modified elsewhere are no longer permitted|perldiag/"Constants from lexical variables potentially modified elsewhere are no longer permitted">
164
165 This error message replaces the former C<Constants from lexical variables
166 potentially modified elsewhere are deprecated.  This will not be allowed in Perl
167 5.32> to reflect the fact that this previously deprecated usage has now been
168 transformed into an exception.  The message's classification has also been
169 updated from D (deprecated) to F (fatal).
170
171 See also L</Incompatible Changes>.
172
173 =back
174
175 =head1 Configuration and Compilation
176
177 =over 4
178
179 =item *
180
181 Perl now no longer probes for C<d_u32align>, defaulting to C<define> on all
182 platforms.  This check was error prone when it was done, which was on 32-bit
183 platforms only.
184 L<[perl #133495]|https://rt.perl.org/Ticket/Display.html?id=133495>.
185
186 =item *
187
188 Documentation and hints for building perl on Z/OS (native EBCDIC) have been
189 updated.  Still work in progress.
190
191 =item *
192
193 A new probe for C<malloc_usable_size> has been added.
194
195 =back
196
197 =head1 Testing
198
199 Tests were added and changed to reflect the other additions and changes in this
200 release.
201
202 =head1 Platform Support
203
204 =head2 Platform-Specific Notes
205
206 =over 4
207
208 =item Windows
209
210 =over 4
211
212 =item *
213
214 Support for building perl with Visual C++ 6.0 has now been removed.
215
216 =item *
217
218 Building perl with Visual C++ 2013 and earlier was broken in the previous
219 release but has now been fixed.
220
221 =back
222
223 =back
224
225 =head1 Internal Changes
226
227 =over 4
228
229 =item *
230
231 Added the C<<PL_curstackinfo->si_cxsubix>> field.  This records the stack index
232 of the most recently pushed sub/format/eval context.  It is set and restored
233 automatically by C<cx_pushsub()>, C<cx_popsub()> etc., but would need to be
234 manually managed if you do any unusual manipulation of the context stack.
235
236 =item *
237
238 Various macros dealing with character type classification and changing case
239 where the input is encoded in UTF-8 now require an extra parameter to prevent
240 potential reads beyond the end of the buffer.  Use of these has generated a
241 deprecation warning since Perl 5.26.  Details are in
242 L<perldeprecation/In XS code, use of various macros dealing with UTF-8.>
243
244 =back
245
246 =head1 Acknowledgements
247
248 XXX Generate this with:
249
250   perl Porting/acknowledgements.pl v5.31.4..HEAD
251
252 =head1 Reporting Bugs
253
254 If you find what you think is a bug, you might check the perl bug database at
255 L<https://rt.perl.org/>.  There may also be information at
256 L<https://www.perl.org/>, the Perl Home Page.
257
258 If you believe you have an unreported bug, please run the L<perlbug> program
259 included with your release.  Be sure to trim your bug down to a tiny but
260 sufficient test case.  Your bug report, along with the output of C<perl -V>,
261 will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
262
263 If the bug you are reporting has security implications which make it
264 inappropriate to send to a publicly archived mailing list, then see
265 L<perlsec/SECURITY VULNERABILITY CONTACT INFORMATION> for details of how to
266 report the issue.
267
268 =head1 Give Thanks
269
270 If you wish to thank the Perl 5 Porters for the work we had done in Perl 5, you
271 can do so by running the C<perlthanks> program:
272
273     perlthanks
274
275 This will send an email to the Perl 5 Porters list with your show of thanks.
276
277 =head1 SEE ALSO
278
279 The F<Changes> file for an explanation of how to view exhaustive details on
280 what changed.
281
282 The F<INSTALL> file for how to build Perl.
283
284 The F<README> file for general stuff.
285
286 The F<Artistic> and F<Copying> files for copyright information.
287
288 =cut