Bump $XS::Typemap::VERSION after previous commit.
[perl.git] / pod / perl5170delta.pod
1 =encoding utf8
2
3 =head1 NAME
4
5 perl5170delta - what is new for perl v5.17.0
6
7 =head1 DESCRIPTION
8
9 This document describes differences between the 5.16.0 release and
10 the 5.17.0 release.
11
12 If you are upgrading from an earlier release such as 5.16.0, first read
13 L<perl5160delta>, which describes differences between 5.14.0 and
14 5.16.0.
15
16 =head1 Incompatible Changes
17
18 =head2 qw(...) can no longer be used as parentheses
19
20 C<qw> lists used to fool the parser into thinking they were always
21 surrounded by parentheses.  This permitted some surprising constructions
22 such as C<foreach $x qw(a b c) {...}>, which should really be written
23 C<foreach $x (qw(a b c)) {...}>.  These would sometimes get the lexer into
24 the wrong state, so they didn't fully work, and the similar C<foreach qw(a
25 b c) {...}> that one might expect to be permitted never worked at all.
26
27 This side effect of C<qw> has now been abolished.  It has been deprecated
28 since Perl 5.13.11.  It is now necessary to use real parentheses
29 everywhere that the grammar calls for them.
30
31 =head2 C<\s> in regular expressions now matches a Vertical Tab (experimental)
32
33 This is an experiment early in the development cycle to see what
34 repercussions arise from this change.  It may well be that we decide
35 to require a C<"use feature"> to activate this behavior.  Because
36 of the experimental nature of this, which may be reversed, the
37 documentation has not been changed to reflect it.
38
39 =head1 Deprecations
40
41 =head2 Unescaped braces in regexps
42
43 Literal unescaped C<{> in regular expressions is now deprecated.  Every
44 brace character should be either escaped (by a preceding backslash) or
45 part of a construct where it's a metacharacter.  This catches likely typos
46 such as C</f{,3}/>.  It will also allow braces to be used in the future
47 to delimit parameters to metacharacters that currently take no parameters.
48
49 =head1 Performance Enhancements
50
51 =over 4
52
53 =item *
54
55 Filetest ops manage the stack in a fractionally more efficient manner.
56
57 =item *
58
59 Globs used in a numeric context are now numerified directly in most cases,
60 rather than being numerified via stringification.
61
62 =back
63
64 =head1 Modules and Pragmata
65
66 =head2 Updated Modules and Pragmata
67
68 =over 4
69
70 =item *
71
72 L<B> has been upgraded from version 1.34 to 1.35.
73
74 The C<stashlen> method of COPs has been added.   This provides access to an
75 internal field added in perl 5.16 under threaded builds [perl #113034].
76
77 =item *
78
79 L<ExtUtils::ParseXS> has been upgraded from version 3.16 to 3.17.
80
81 The generated C code now avoids unnecessarily incrementing
82 C<PL_amagic_generation> on Perl versions where it's done automatically
83 (or on current Perl where the variable no longer exists).
84
85 =item *
86
87 L<File::DosGlob> has been upgraded from version 1.06 to 1.07.
88
89 Small documentation and comment fixes.
90
91 =item *
92
93 L<File::Find> has been upgraded from version 1.20 to 1.21.
94
95 Individual files may now appear in list of directories to be searched
96 [perl #59750].
97
98 =item *
99
100 L<File::stat> has been upgraded from version 1.05 to 1.06.
101
102 C<File::stat> ignores the L<filetest> pragma, and warns when used in
103 combination therewith.  But it was not warning for C<-r>.  This has been
104 fixed [perl #111640].
105
106 C<-p> now works, and does not return false for pipes [perl #111638].
107
108 =item *
109
110 L<Hash::Util> has been upgraded from version 0.11 to 0.12.
111
112 C<hash_unlocked> and C<hashref_unlocked> now returns true if the hash is
113 unlocked, instead of always returning false [perl #112126].
114
115 C<hash_unlocked>, C<hashref_unlocked>, C<lock_hash_recurse> and
116 C<unlock_hash_recurse> are now exportable [perl #112126].
117
118 Two new functions, C<hash_locked> and C<hashref_locked>, have been added.
119 Oddly enough, these two functions were already exported, even though they
120 did not exist [perl #112126].
121
122 =item *
123
124 L<Module::CoreList> has been upgraded from version 2.66 to 2.67.
125
126 =item *
127
128 L<overload> has been upgraded from version 1.18 to 1.19.
129
130 C<no overload> now warns for invalid arguments, just like C<use overload>.
131
132 =item *
133
134 L<Pod::Functions> has been upgraded from version 1.05 to 1.06.
135
136 Typo fix in generated documentation.
137
138 =item *
139
140 L<Storable> has been upgraded from version 2.34 to 2.35.
141
142 Modifying C<$_[0]> within C<STORABLE_freeze> no longer results in crashes
143 [perl #112358].
144
145 An object whose class implements C<STORABLE_attach> is now thawed only once
146 when there are multiple references to it in the structure being thawed
147 [perl #111918].
148
149 =item *
150
151 L<utf8> has been upgraded from version 1.09 to 1.10.
152
153 Some documentation has been clarified.
154
155 =back
156
157 =head2 Removed Modules and Pragmata
158
159 =over 4
160
161 =item *
162
163 L<Version::Requirements> has been removed from the core distribution.  It is
164 available under a different name: L<CPAN::Meta::Requirements>.
165
166 =back
167
168 =head1 Documentation
169
170 =head2 Changes to Existing Documentation
171
172 =head3 L<perldata>
173
174 =over 4
175
176 =item *
177
178 Now explicitly documents the behaviour of hash initializer lists that
179 contain duplicate keys.
180
181 =back
182
183 =head3 L<perldiag>
184
185 =over 4
186
187 =item *
188
189 The explanation of symbolic references being prevented by "strict refs"
190 now doesn't assume that the reader knows what symbolic references are.
191
192 =back
193
194 =head3 L<perlfunc>
195
196 =over 4
197
198 =item *
199
200 The return value of C<pipe> is now documented.
201
202 =back
203
204 =head1 Diagnostics
205
206 The following additions or changes have been made to diagnostic output,
207 including warnings and fatal error messages.  For the complete list of
208 diagnostic messages, see L<perldiag>.
209
210 =head2 New Diagnostics
211
212 =head3 New Warnings
213
214 =over 4
215
216 =item *
217
218 "L<Unescaped left brace in regex is deprecated, passed
219 through|perldiag/"Unescaped left brace in regex is deprecated, passed
220 through">" is a new deprecation warning.  See L</Unescaped braces in
221 regexps>.
222
223 =back
224
225 =head1 Testing
226
227 =over 4
228
229 =item *
230
231 The test suite now has a section for tests that require very large amounts
232 of memory.  These tests won't run by default; they can be enabled by
233 setting the C<PERL_TEST_MEMORY> environment variable to the number of
234 gibibytes of memory that may be safely used.
235
236 =back
237
238 =head1 Platform Support
239
240 =head2 Platform-Specific Notes
241
242 =over 4
243
244 =item clang++
245
246 There is now a workaround for a compiler bug that prevented compiling
247 with clang++ since Perl 5.15.7 [perl #112786].
248
249 =item C++
250
251 When compiling the Perl core as C++ (which is only semi-supported), the
252 mathom functions are now compiled as C<extern "C">, to ensure proper
253 binary compatibility.  (However, binary compatibility isn't generally
254 guaranteed anyway in the situations where this would matter.)
255
256 =item VMS
257
258 It should now be possible to compile Perl as C++ on VMS.
259
260 =back
261
262 =head1 Internal Changes
263
264 =over 4
265
266 =item *
267
268 The C<CV *> typemap entry now supports C<&{}> overloading and typeglobs,
269 just like C<&{...}> [perl #96872].
270
271 =item *
272
273 The C<SVf_AMAGIC> flag to indicate overloading is now on the stash, not the
274 object.  It is now set automatically whenever a method or @ISA changes, so
275 its meaning has changed, too.  It now means "potentially overloaded".  When
276 the overload table is calculated, the flag is automatically turned off if
277 there is no overloading, so there should be no noticeable slowdown.
278
279 The staleness of the overload tables is now checked when overload methods
280 are invoked, rather than during C<bless>.
281
282 "A" magic is gone.  The changes to the handling of the C<SVf_AMAGIC> flag
283 eliminate the need for it.
284
285 C<PL_amagic_generation> has been removed as no longer necessary.  For XS
286 modules, it is now a macro alias to C<PL_na>.
287
288 The fallback overload setting is now stored in a stash entry separate from
289 overloadedness itself.
290
291 =item *
292
293 The character-processing code has been cleaned up in places.  The changes
294 should be operationally invisible.
295
296 =back
297
298 =head1 Selected Bug Fixes
299
300 =over 4
301
302 =item *
303
304 C<goto ''> now looks for an empty label, producing the "goto must have
305 label" error message, instead of exiting the program [perl #111794].
306
307 =item *
308
309 C<goto "\0"> now dies with "Can't find label" instead of "goto must have
310 label".
311
312 =item *
313
314 The C function C<hv_store> used to result in crashes when used on C<%^H>
315 [perl #111000].
316
317 =item *
318
319 A call checker attached to a closure prototype via C<cv_set_call_checker>
320 is now copied to closures cloned from it.  So C<cv_set_call_checker> now
321 works inside an attribute handler for a closure.
322
323 =item *
324
325 Writing to C<$^N> used to have no effect.  Now it croaks with "Modification
326 of a read-only value" by default, but that can be overridden by a custom
327 regular expression engine, as with C<$1> [perl #112184].
328
329 =item *
330
331 C<undef> on a control character glob (C<undef *^H>) no longer emits an
332 erroneous warning about ambiguity [perl #112456].
333
334 =item *
335
336 For efficiency's sake, many operators and built-in functions return the
337 same scalar each time.  Lvalue subroutines and subroutines in the CORE::
338 namespace were allowing this implementation detail to leak through.
339 C<print &CORE::uc("a"), &CORE::uc("b")> used to print "BB".  The same thing
340 would happen with an lvalue subroutine returning the return value of C<uc>.
341 Now the value is copied in such cases.
342
343 =item *
344
345 C<method {}> syntax with an empty block or a block returning an empty list
346 used to crash or use some random value left on the stack as its invocant.
347 Now it produces an error.
348
349 =item *
350
351 C<vec> now works with extremely large offsets (E<gt>2 GB) [perl #111730].
352
353 =item *
354
355 Changes to overload settings now take effect immediately, as do changes to
356 inheritance that affect overloading.  They used to take effect only after
357 C<bless>.
358
359 Objects that were created before a class had any overloading used to remain
360 non-overloaded even if the class gained overloading through C<use overload>
361 or @ISA changes, and even after C<bless>.  This has been fixed
362 [perl #112708].
363
364 =item *
365
366 Classes with overloading can now inherit fallback values.
367
368 =item *
369
370 Overloading was not respecting a fallback value of 0 if there were
371 overloaded objects on both sides of an assignment operator like C<+=>
372 [perl #111856].
373
374 =item *
375
376 C<pos> now croaks with hash and array arguments, instead of producing
377 erroneous warnings.
378
379 =item *
380
381 C<while(each %h)> now implies C<while(defined($_ = each %h))>, like
382 C<readline> and C<readdir>.
383
384 =item *
385
386 Subs in the CORE:: namespace no longer crash after C<undef *_> when called
387 with no argument list (C<&CORE::time> with no parentheses).
388
389 =item *
390
391 Unicode 6.1 published an incorrect alias for one of the
392 Canonical_Combining_Class property's values (which range between 0 and
393 254).  The alias C<CCC133> should have been C<CCC132>.  Perl now
394 overrides the data file furnished by Unicode to give the correct value.
395
396 =item *
397
398 C<unpack> no longer produces the "'/' must follow a numeric type in unpack"
399 error when it is the data that are at fault [perl #60204].
400
401 =item *
402
403 C<join> and C<"@array"> now call FETCH only once on a tied C<$">
404 [perl #8931].
405
406 =item *
407
408 Some subroutine calls generated by compiling core ops affected by a
409 C<CORE::GLOBAL> override had op checking performed twice.  The checking
410 is always idempotent for pure Perl code, but the double checking can
411 matter when custom call checkers are involved.
412
413 =item *
414
415 A race condition used to exist around fork that could cause a signal sent to
416 the parent to be handled by both parent and child. Signals are now blocked
417 briefly around fork to prevent this from happening [perl #82580].
418
419 =back
420
421 =head1 Acknowledgements
422
423 Perl 5.17.0 represents approximately 1 week of development since Perl 5.16.0
424 and contains approximately 17,000 lines of changes across 180 files from 26
425 authors.
426
427 Perl continues to flourish into its third decade thanks to a vibrant community
428 of users and developers. The following people are known to have contributed the
429 improvements that became Perl 5.16.1:
430
431 Alan Haggai Alavi, Aristotle Pagaltzis, Brian Fraser, Chris 'BinGOs' Williams,
432 Craig A. Berry, Dagfinn Ilmari Mannsåker, Eric Brine, Father Chrysostomos,
433 Igor Zaytsev, James E Keenan, Karl Williamson, Leon Timmermans, Lukas Mai,
434 Marcus Holland-Moritz, Matthew Horsfall, Moritz Lenz, Rafael Garcia-Suarez,
435 Reini Urban, Ricardo Signes, Robin Barker, Ronald J. Kimball, Smylers, Steffen
436 Müller, Steve Hay, Tony Cook, Zefram.
437
438 The list above is almost certainly incomplete as it is automatically generated
439 from version control history. In particular, it does not include the names of
440 the (very much appreciated) contributors who reported issues to the Perl bug
441 tracker.
442
443 Many of the changes included in this version originated in the CPAN modules
444 included in Perl's core. We're grateful to the entire CPAN community for
445 helping Perl to flourish.
446
447 For a more complete list of all of Perl's historical contributors, please see
448 the F<AUTHORS> file in the Perl source distribution.
449
450 =head1 Reporting Bugs
451
452 If you find what you think is a bug, you might check the articles
453 recently posted to the comp.lang.perl.misc newsgroup and the perl
454 bug database at http://rt.perl.org/perlbug/ .  There may also be
455 information at http://www.perl.org/ , the Perl Home Page.
456
457 If you believe you have an unreported bug, please run the L<perlbug>
458 program included with your release.  Be sure to trim your bug down
459 to a tiny but sufficient test case.  Your bug report, along with the
460 output of C<perl -V>, will be sent off to perlbug@perl.org to be
461 analysed by the Perl porting team.
462
463 If the bug you are reporting has security implications, which make it
464 inappropriate to send to a publicly archived mailing list, then please send
465 it to perl5-security-report@perl.org. This points to a closed subscription
466 unarchived mailing list, which includes
467 all the core committers, who will be able
468 to help assess the impact of issues, figure out a resolution, and help
469 co-ordinate the release of patches to mitigate or fix the problem across all
470 platforms on which Perl is supported. Please only use this address for
471 security issues in the Perl core, not for modules independently
472 distributed on CPAN.
473
474 =head1 SEE ALSO
475
476 The F<Changes> file for an explanation of how to view exhaustive details
477 on what changed.
478
479 The F<INSTALL> file for how to build Perl.
480
481 The F<README> file for general stuff.
482
483 The F<Artistic> and F<Copying> files for copyright information.
484
485 =cut