This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta - Remove boilerplate stuff
[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 modiable context
25 now 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 [perl #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 If there was something important to note about this change, include that here.
98
99 =back
100
101 =head1 Documentation
102
103 =head2 Changes to Existing Documentation
104
105 We have attempted to update the documentation to reflect the changes
106 listed in this document.  If you find any we have missed, send email
107 to L<perlbug@perl.org|mailto:perlbug@perl.org>.
108
109 =head3 L<perlguts>
110
111 =over 4
112
113 =item *
114
115 Details of the various stacks within the perl interpreter are now explained
116 here.
117
118 =back
119
120 Additionally, the following selected changes have been made:
121
122 =head3 URLs have been changed to https://, stale links updated
123
124 =over 4
125
126 =item *
127
128 Where applicable, the URLs in the documentation have been moved from
129 using the http:// protocol to https:// . This also affects the location
130 of the bug tracker at L<https://rt.perl.org>.
131
132 =item *
133
134 Some links to OS/2 libraries, Address Sanitizer and other system tools
135 had gone stale. These have been updated with working links.
136
137 =item *
138
139 Some links to old mails on perl5-porters had gone stale. These have been
140 updated with working links.
141
142 =back
143
144 =head1 Diagnostics
145
146 The following additions or changes have been made to diagnostic output,
147 including warnings and fatal error messages.  For the complete list of
148 diagnostic messages, see L<perldiag>.
149
150 =head2 Changes to Existing Diagnostics
151
152 =over 4
153
154 =item *
155
156 L<Can't use global %s in %s|perldiag/"Can't use global %s in %s">
157
158 This error message has been slightly reformatted from the original C<Can't use
159 global %s in "%s">, and in particular misleading error messages like C<Can't
160 use global $_ in "my"> are now rendered as C<Can't use global $_ in subroutine
161 signature>.
162
163 =item *
164
165 L<Constants from lexical variables potentially modified elsewhere are no longer permitted|perldiag/"Constants from lexical variables potentially modified elsewhere are no longer permitted">
166
167 This error message replaces the former C<Constants from lexical variables
168 potentially modified elsewhere are deprecated. This will not be allowed in Perl
169 5.32> to reflect the fact that this previously deprecated usage has now been
170 transformed into an exception.  The message's classification has also been
171 updated from D (deprecated) to F (fatal).
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>
182 on all platforms.  This check was error prone when it was done, which
183 was on 32-bit platforms only.  [perl #133495]
184
185 =item *
186
187 Documentation and hints for building perl on Z/OS (native EBCDIC) have
188 been updated. Still work in progress.
189
190 =item *
191
192 New probe for malloc_usable_size
193
194 =back
195
196 =head1 Testing
197
198 Tests were added and changed to reflect the other additions and changes
199 in this release.
200
201 =head1 Platform Support
202
203 =head2 Platform-Specific Notes
204
205 =over 4
206
207 =item Windows
208
209 =over 4
210
211 =item *
212
213 Support for building perl with Visual C++ 6.0 has now been removed.
214
215 =item *
216
217 Building perl with Visual C++ 2013 and earlier was broken in the previous
218 release but has now been fixed.
219
220 =back
221
222 =back
223
224 =head1 Internal Changes
225
226 =over 4
227
228 =item *
229
230 Added the C<<PL_curstackinfo->si_cxsubix>> field. This records the stack
231 index of the most recently pushed sub/format/eval context.  It is set and
232 restored automatically by C<cx_pushsub()>, C<cx_popsub()> etc., but would
233 need to be manually managed if you do any unusual manipulation of the
234 context stack.
235
236 =item *
237
238 Various macros dealing with character type classification and changing
239 case where the input is encoded in UTF-8 now require an extra parameter
240 to prevent potential reads beyond the end of the buffer.  Use of these
241 has generated a deprecation warning since 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
255 at 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>
266 for details of how to 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,
271 you 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