Commit | Line | Data |
---|---|---|
39c4a6cf PM |
1 | =encoding utf8 |
2 | ||
3 | =head1 NAME | |
4 | ||
5 | perl5213delta - what is new for perl v5.21.3 | |
6 | ||
7 | =head1 DESCRIPTION | |
8 | ||
9 | This document describes differences between the 5.21.2 release and the 5.21.3 | |
10 | release. | |
11 | ||
12 | If you are upgrading from an earlier release such as 5.21.1, first read | |
13 | L<perl5212delta>, which describes differences between 5.21.1 and 5.21.2. | |
14 | ||
15 | =head1 Core Enhancements | |
16 | ||
17 | =head2 C<defined(@array = LIST)> is no longer fatal | |
18 | ||
19 | In 5.21.1, C<defined(@array)> was made fatal. This has been relaxed | |
20 | to not die if the argument is assigning to an array. | |
21 | ||
22 | =head2 Floating point parsing has been improved | |
23 | ||
24 | Parsing and printing of floating point values has been improved. | |
25 | ||
26 | As a completely new feature, hexadecimal floating point literals | |
27 | (like 0x1.23p-4) are now supported, and they can be output with | |
28 | C<printf %a>. | |
29 | ||
30 | =head1 Security | |
31 | ||
32 | =head2 The L<Safe> module could allow outside packages to be replaced | |
33 | ||
34 | Critical bugfix: outside packages could be replaced. L<Safe> has | |
35 | been patched to 2.38 to address this. | |
36 | ||
37 | =head1 Incompatible Changes | |
38 | ||
39 | =head2 S<C<use UNIVERSAL '...'>> is now a fatal error | |
40 | ||
41 | Importing functions from C<UNIVERSAL> has been deprecated since v5.12, and | |
42 | is now a fatal error. S<C<"use UNIVERSAL">> without any arguments is still | |
43 | allowed. | |
44 | ||
45 | =head1 Modules and Pragmata | |
46 | ||
47 | =head2 Updated Modules and Pragmata | |
48 | ||
49 | =over 4 | |
50 | ||
51 | =item * | |
52 | ||
53 | L<B::Debug> has been upgraded from version 1.19 to 1.21. | |
54 | ||
55 | =item * | |
56 | ||
57 | L<Config::Perl::V> has been upgraded from version 0.20 to 0.22. | |
58 | ||
59 | =item * | |
60 | ||
61 | L<CPAN::Meta> has been upgraded from version 2.141520 to 2.142060. | |
62 | ||
63 | =item * | |
64 | ||
65 | L<CPAN::Meta::Requirements> has been upgraded from version 2.125 to 2.126. | |
66 | ||
67 | =item * | |
68 | ||
69 | L<ExtUtils::CBuilder> was moved from F<dist> to F<cpan>. | |
70 | ||
71 | =item * | |
72 | ||
73 | L<ExtUtils::CBuilder> has been upgraded from version 0.280216 to 0.280217. | |
74 | ||
75 | =item * | |
76 | ||
77 | L<ExtUtils::Install> was moved from F<dist> to F<cpan>. | |
78 | ||
79 | =item * | |
80 | ||
81 | L<ExtUtils::Manifest> has been upgraded from version 1.64 to 1.65. | |
82 | It was also moved from F<dist> to F<cpan>. | |
83 | ||
84 | =item * | |
85 | ||
86 | L<HTTP::Tiny> has been upgraded from version 0.043 to 0.047. | |
87 | ||
88 | =item * | |
89 | ||
90 | L<IPC::Open3> has been upgraded from version 1.17 to 1.18. | |
91 | ||
92 | =item * | |
93 | ||
94 | L<Module::CoreList> has been upgraded from version 5.021002 to 5.021003. | |
95 | ||
96 | =item * | |
97 | ||
98 | L<Opcode> has been upgraded from version 1.27 to 1.28. | |
99 | ||
100 | =item * | |
101 | ||
102 | L<perl5db.pl> has been upgraded from version 1.45 to 1.46. | |
103 | ||
104 | =item * | |
105 | ||
106 | L<perlfaq> has been upgraded from version 5.0150044 to 5.0150045. | |
107 | ||
108 | =item * | |
109 | ||
110 | L<POSIX> has been upgraded from version 1.41 to 1.42. | |
111 | ||
112 | =item * | |
113 | ||
114 | L<Safe> has been upgraded from version 2.37 to 2.38. | |
115 | ||
116 | =item * | |
117 | ||
118 | L<Socket> has been upgraded from version 2.014 to 2.015. | |
119 | ||
120 | =item * | |
121 | ||
122 | L<Sys::Hostname> has been upgraded from version 1.18 to 1.19 | |
123 | ||
124 | =item * | |
125 | ||
126 | L<UNIVERSAL> has been upgraded from version 1.11 to 1.12. | |
127 | ||
128 | =back | |
129 | ||
130 | =head1 Documentation | |
131 | ||
132 | =head2 Changes to Existing Documentation | |
133 | ||
134 | =head3 L<perlexperiment> | |
135 | ||
136 | =over 4 | |
137 | ||
138 | =item * | |
139 | ||
140 | Added reference to L<feature>. | |
141 | ||
142 | =back | |
143 | ||
144 | =head3 L<perlguts> | |
145 | ||
146 | =over 4 | |
147 | ||
148 | =item * | |
149 | ||
150 | Details on C level symbols and libperl.t added. | |
151 | ||
152 | =back | |
153 | ||
154 | =head3 L<perlhacktips> | |
155 | ||
156 | =over 4 | |
157 | ||
158 | =item * | |
159 | ||
160 | Recommended replacements for tmpfile, atoi, strtol, and strtoul added. | |
161 | ||
162 | =back | |
163 | ||
164 | =head3 L<perlop> | |
165 | ||
166 | =over 4 | |
167 | ||
168 | =item * | |
169 | ||
170 | ASCII v. EBCDIC clarifications added. | |
171 | ||
172 | =back | |
173 | ||
174 | =head3 L<perlsec> | |
175 | ||
176 | =over 4 | |
177 | ||
178 | =item * | |
179 | ||
180 | Comments added on algorithmic complexity and tied hashes. | |
181 | ||
182 | =back | |
183 | ||
184 | =head3 L<perlvms> | |
185 | ||
186 | =over 4 | |
187 | ||
188 | =item * | |
189 | ||
190 | Updated documentation on environment and shell interaction in VMS. | |
191 | ||
192 | =back | |
193 | ||
194 | =head1 Diagnostics | |
195 | ||
196 | The following additions or changes have been made to diagnostic output, | |
197 | including warnings and fatal error messages. For the complete list of | |
198 | diagnostic messages, see L<perldiag>. | |
199 | ||
200 | =head2 New Diagnostics | |
201 | ||
202 | =head3 New Errors | |
203 | ||
204 | =over 4 | |
205 | ||
206 | =item * | |
207 | ||
208 | L<Hexadecimal float: internal error|perldiag/"Hexadecimal float: internal error"> | |
209 | ||
210 | (F) Something went horribly bad in hexadecimal float handling. | |
211 | ||
212 | =item * | |
213 | ||
214 | L<Hexadecimal float: unsupported long double format|perldiag/"Hexadecimal float: unsupported long double format"> | |
215 | ||
216 | (F) You have configured Perl to use long doubles but | |
217 | the internals of the long double format are unknown, | |
218 | therefore the hexadecimal float output is impossible. | |
219 | ||
220 | =back | |
221 | ||
222 | =head3 New Warnings | |
223 | ||
224 | =over 4 | |
225 | ||
226 | =item * | |
227 | ||
228 | L<Hexadecimal float: exponent overflow|perldiag/"Hexadecimal float: exponent overflow"> | |
229 | ||
230 | (W overflow) The hexadecimal floating point has larger exponent | |
231 | than the floating point supports. | |
232 | ||
233 | =item * | |
234 | ||
235 | L<Hexadecimal float: exponent underflow|perldiag/"Hexadecimal float: exponent underflow"> | |
236 | ||
237 | (W overflow) The hexadecimal floating point has smaller exponent | |
238 | than the floating point supports. | |
239 | ||
240 | =item * | |
241 | ||
242 | L<Hexadecimal float: mantissa overflow|perldiag/"Hexadecimal float: mantissa overflow"> | |
243 | ||
244 | (W overflow) The hexadecimal floating point literal had more bits in | |
245 | the mantissa (the part between the 0x and the exponent, also known as | |
246 | the fraction or the significand) than the floating point supports. | |
247 | ||
248 | =item * | |
249 | ||
250 | L<Hexadecimal float: precision loss|perldiag/"Hexadecimal float: precision loss"> | |
251 | ||
252 | (W overflow) The hexadecimal floating point had internally more | |
253 | digits than could be output. This can be caused by unsupported | |
254 | long double formats, or by 64-bit integers not being available | |
255 | (needed to retrieve the digits under some configurations). | |
256 | ||
257 | =back | |
258 | ||
259 | =head2 Changes to Existing Diagnostics | |
260 | ||
261 | =over 4 | |
262 | ||
263 | =item * | |
264 | ||
265 | C<require> with no argument or undef used to warn about a Null filename; now | |
266 | it dies with C<Missing or undefined argument to require>. | |
267 | ||
268 | =back | |
269 | ||
270 | =head1 Configuration and Compilation | |
271 | ||
272 | =over 4 | |
273 | ||
274 | =item * | |
275 | ||
276 | MurmurHash64A and MurmurHash64B can now be configured as the internal hash | |
277 | function. | |
278 | ||
279 | =back | |
280 | ||
281 | =head1 Platform Support | |
282 | ||
283 | =head2 Platform-Specific Notes | |
284 | ||
285 | =over 4 | |
286 | ||
287 | =item Android | |
288 | ||
289 | Build support has been improved for cross-compiling in general and for | |
290 | Android in particular. | |
291 | ||
292 | =item Solaris | |
293 | ||
294 | C<c99> options have been cleaned up, hints look for C<solstudio> | |
295 | as well as C<SUNWspro>, and support for native C<setenv> has been added. | |
296 | ||
297 | =item VMS | |
298 | ||
299 | C<finite>, C<finitel>, and C<isfinite> detection has been added to | |
300 | C<configure.com>, environment handling has had some minor changes, and | |
301 | a fix for legacy feature checking status. | |
302 | ||
303 | =item Windows | |
304 | ||
305 | C<%I64d> is now being used instead of C<%lld> for MinGW. | |
306 | ||
307 | =back | |
308 | ||
309 | =head1 Internal Changes | |
310 | ||
311 | =over 4 | |
312 | ||
313 | =item * | |
314 | ||
315 | Added L<perlapi/sync_locale>. | |
316 | Changing the program's locale should be avoided by XS code. Nevertheless, | |
317 | certain non-Perl libraries called from XS, such as C<Gtk> do so. When this | |
318 | happens, Perl needs to be told that the locale has changed. Use this function | |
319 | to do so, before returning to Perl. | |
320 | ||
321 | =item * | |
322 | ||
323 | Added L<perlapi/grok_atou> as a safer replacement for atoi and strtol. | |
324 | ||
325 | =back | |
326 | ||
327 | =head1 Selected Bug Fixes | |
328 | ||
329 | =over 4 | |
330 | ||
331 | =item * | |
332 | ||
333 | Failing to compile C<use Foo> in an eval could leave a spurious | |
334 | C<BEGIN> subroutine definition, which would produce a "Subroutine | |
335 | BEGIN redefined" warning on the next use of C<use>, or other C<BEGIN> | |
336 | block. [perl #122107] | |
337 | ||
338 | =item * | |
339 | ||
340 | C<method { BLOCK } ARGS> syntax now correctly parses the arguments if they | |
341 | begin with an opening brace. [perl #46947] | |
342 | ||
343 | =item * | |
344 | ||
345 | External libraries and Perl may have different ideas of what the locale is. | |
346 | This is problematic when parsing version strings if the locale's numeric | |
347 | separator has been changed. Version parsing has been patched to ensure | |
348 | it handles the locales correctly. [perl #121930] | |
349 | ||
350 | =item * | |
351 | ||
352 | A bug has been fixed where zero-length assertions and code blocks inside of a | |
353 | regex could cause C<pos> to see an incorrect value. [perl #122460] | |
354 | ||
355 | =back | |
356 | ||
357 | =head1 Acknowledgements | |
358 | ||
359 | Perl 5.21.3 represents approximately 4 weeks of development since Perl 5.21.2 | |
360 | and contains approximately 21,000 lines of changes across 250 files from 25 | |
361 | authors. | |
362 | ||
363 | Excluding auto-generated files, documentation and release tools, there were | |
364 | approximately 18,000 lines of changes to 160 .pm, .t, .c and .h files. | |
365 | ||
366 | Perl continues to flourish into its third decade thanks to a vibrant community | |
367 | of users and developers. The following people are known to have contributed the | |
368 | improvements that became Perl 5.21.3: | |
369 | ||
370 | Aaron Crane, Abigail, Alberto Simões, Andy Dougherty, Brian Fraser, Chad | |
371 | Granum, Chris 'BinGOs' Williams, Craig A. Berry, Dagfinn Ilmari Mannsåker, | |
372 | Daniel Dragan, David Mitchell, Father Chrysostomos, H.Merijn Brand, James E | |
373 | Keenan, Jan Dubois, Jarkko Hietaniemi, Karen Etheridge, Karl Williamson, Lukas | |
374 | Mai, Peter Martini, Rafael Garcia-Suarez, syber, Tony Cook, Vladimir Marek, | |
375 | Yves Orton. | |
376 | ||
377 | The list above is almost certainly incomplete as it is automatically generated | |
378 | from version control history. In particular, it does not include the names of | |
379 | the (very much appreciated) contributors who reported issues to the Perl bug | |
380 | tracker. | |
381 | ||
382 | Many of the changes included in this version originated in the CPAN modules | |
383 | included in Perl's core. We're grateful to the entire CPAN community for | |
384 | helping Perl to flourish. | |
385 | ||
386 | For a more complete list of all of Perl's historical contributors, please see | |
387 | the F<AUTHORS> file in the Perl source distribution. | |
388 | ||
389 | =head1 Reporting Bugs | |
390 | ||
391 | If you find what you think is a bug, you might check the articles recently | |
392 | posted to the comp.lang.perl.misc newsgroup and the perl bug database at | |
393 | https://rt.perl.org/ . There may also be information at | |
394 | http://www.perl.org/ , the Perl Home Page. | |
395 | ||
396 | If you believe you have an unreported bug, please run the L<perlbug> program | |
397 | included with your release. Be sure to trim your bug down to a tiny but | |
398 | sufficient test case. Your bug report, along with the output of C<perl -V>, | |
399 | will be sent off to perlbug@perl.org to be analysed by the Perl porting team. | |
400 | ||
401 | If the bug you are reporting has security implications, which make it | |
402 | inappropriate to send to a publicly archived mailing list, then please send it | |
403 | to perl5-security-report@perl.org. This points to a closed subscription | |
404 | unarchived mailing list, which includes all the core committers, who will be | |
405 | able to help assess the impact of issues, figure out a resolution, and help | |
406 | co-ordinate the release of patches to mitigate or fix the problem across all | |
407 | platforms on which Perl is supported. Please only use this address for | |
408 | security issues in the Perl core, not for modules independently distributed on | |
409 | CPAN. | |
410 | ||
411 | =head1 SEE ALSO | |
412 | ||
413 | The F<Changes> file for an explanation of how to view exhaustive details on | |
414 | what changed. | |
415 | ||
416 | The F<INSTALL> file for how to build Perl. | |
417 | ||
418 | The F<README> file for general stuff. | |
419 | ||
420 | The F<Artistic> and F<Copying> files for copyright information. | |
421 | ||
422 | =cut |