This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
7dbee18be955a565afe33be1f6b275acdcc2427f
[perl5.git] / pod / perl5134delta.pod
1 =encoding utf8
2
3 =head1 NAME
4
5 perl5134delta - what is new for perl v5.13.4
6
7 =head1 DESCRIPTION
8
9 This document describes differences between the 5.13.4 release and
10 the 5.13.3 release.
11
12 If you are upgrading from an earlier release such as 5.13.2, first read
13 L<perl5133delta>, which describes differences between 5.13.2 and
14 5.13.3.
15
16 =head1 Core Enhancements
17
18 =head2 C<srand()> now returns the seed
19
20 This allows programs that need to have repeatable results to not have to come
21 up with their own seed generating mechanism.  Instead, they can use C<srand()>
22 and somehow stash the return for future use.  Typical is a test program which
23 has too many combinations to test comprehensively in the time available to it
24 each run.  It can test a random subset each time, and should there be a failure,
25 log the seed used for that run so that it can later be used to reproduce the
26 exact results.
27
28 =head2 Creating unary functions with prototypes
29
30 Calls to functions created with the following prototypes are now correctly parsed
31
32 Functions declared with the following prototypes now behave correctly as unary functions:
33
34 =over 4
35
36 =item *
37
38 C<*>
39
40 =item *
41
42 C<\sigil>
43
44 =item *
45
46 C<\[...]>
47
48 =item *
49
50 C<;$>
51
52 =item *
53
54 C<;*>
55
56 =item *
57
58 C<;\sigil>
59
60 =item *
61
62 C<;\[...]>
63
64 =back
65
66 =head2 C<\N{I<name>}> and C<charnames> enhancements
67
68 C<\N{}>, C<charnames::vianame>, C<charnames::viacode> now know about every
69 character in Unicode.  Previously, they didn't know about the Hangul syllables
70 nor a number of CJK (Chinese/Japanese/Korean) characters.
71
72 =head1 Incompatible Changes
73
74 =head2 Declare API incompatibility between blead releases
75
76 Only stable releases (5.10.x, 5.12.x, 5.14.x, ...) guarantee binary
77 compatibility with each other, while blead releases (5.13.x, 5.15.x, ...) often
78 break this compatibility. However, prior to perl 5.13.4, all blead releases had
79 the same C<PERL_API_REVISION>, C<PERL_API_VERSION>, and C<PERL_API_SUBVERSION>,
80 effectively declaring them as binary compatible, which they weren't. From now
81 on, blead releases will have a C<PERL_API_SUBVERSION> equal to their
82 C<PERL_SUBVERSION>, explicitly marking them as incompatible with each other.
83
84 Maintenance releases of stable perl versions will continue to make no
85 intentionally incompatible API changes.
86
87 =head2 Check API compatibility when loading XS modules
88
89 When perl's API changes in incompatible ways (which usually happens between
90 every major release), XS modules compiled for previous versions of perl will not
91 work anymore. They will need to be recompiled against the new perl.
92
93 In order to ensure that modules are recompiled, and to prevent users from
94 accidentally loading modules compiled for old perls into newer ones, the
95 C<XS_APIVERSION_BOOTCHECK> macro has been added. That macro, which is called
96 when loading every newly compiled extension, compares the API version of the
97 running perl with the version a module has been compiled for and raises an
98 exception if they don't match.
99
100 =head2 Binary Incompatible with all previous Perls
101
102 Some bit fields have been reordered; therefore, this release will not be binary
103 compatible with any previous Perl release.
104
105 =head1 Deprecations
106
107 =head2 List assignment to C<$[>
108
109 After assignment to C<$[> has been deprecated and started to give warnings in
110 perl version 5.12.0, this version of perl also starts to emit a warning when
111 assigning to C<$[> in list context. This fixes an oversight in 5.12.0.
112
113 =head1 Performance Enhancements
114
115 =over 4
116
117 =item *
118
119 Make string appending 100 times faster
120
121 When doing a lot of string appending, perl could end up allocating a lot more
122 memory than needed in a very inefficient way, if perl was configured to use the
123 system's C<malloc> implementation instead of its own.
124
125 C<sv_grow>, which is what's being used to allocate more memory if necessary when
126 appending to a string, has now been taught how to round up the memory it
127 requests to a certain geometric progression, making it much faster on certain
128 platforms and configurations. On Win32, it's now about 100 times faster.
129
130 =item *
131
132 For weak references, the common case of just a single weak reference per
133 referent has been optimised to reduce the storage required. In this case it
134 saves the equivalent of one small perl array per referent.
135
136 =item *
137
138 C<XPV>, C<XPVIV>, and C<XPVNV> now only allocate the parts of the C<SV> body
139 they actually use, saving some space.
140
141 =back
142
143 =head1 Modules and Pragmata
144
145 =head2 New Modules and Pragmata
146
147 This release does not introduce any new modules or pragmata.
148
149 =head2 Updated Modules and Pragmata
150
151 =over 4
152
153 =item C<Archive::Tar>
154
155 Upgraded from version 1.64 to 1.68.
156
157 Among other things, the new version adds a new option to C<ptar> to allow safe
158 creation of tarballs without world-writable files on Windows, allowing those
159 archives to be uploaded to CPAN.
160
161 =item C<B::Lint>
162
163 Upgraded from version 1.11 to 1.12.
164
165 =item C<Carp>
166
167 Upgraded from version 1.16 to 1.18.
168
169 L<Carp> now detects incomplete L<caller()|perlfunc/"caller EXPR"> overrides and
170 avoids using bogus C<@DB::args>. To provide backtraces, Carp relies on
171 particular behaviour of the caller built-in. Carp now detects if other code has
172 overridden this with an incomplete implementation, and modifies its backtrace
173 accordingly. Previously incomplete overrides would cause incorrect values in
174 backtraces (best case), or obscure fatal errors (worst case)
175
176 This fixes certain cases of C<Bizarre copy of ARRAY> caused by modules
177 overriding C<caller()> incorrectly.
178
179 =item C<Compress::Raw::Bzip2>
180
181 Upgraded from version 2.027 to 2.030.
182
183 =item C<Compress::Raw::Zlib>
184
185 Upgraded from version 2.027 to 2.030.
186
187 =item C<File::Spec>
188
189 Upgraded from version 3.31 to 3.31_01.
190
191 Various issues in L<File::Spec::VMS> have been fixed.
192
193 =item C<I18N::Langinfo>
194
195 Upgraded from version 0.03 to 0.04.
196
197 C<langinfo()> now defaults to using C<$_> if there is no argument given, just
198 like the documentation always claimed it did.
199
200 =item C<IO::Compress>
201
202 Upgraded from version 2.027 to 2.030.
203
204 =item C<Module::CoreList>
205
206 Upgraded from version 2.36 to 2.37.
207
208 Besides listing the updated core modules of this release, it also stops listing
209 the C<Filespec> module. That module never existed in core. The scripts
210 generating C<Module::CoreList> confused it with C<VMS::Filespec>, which actually
211 is a core module, since the time of perl 5.8.7.
212
213 =item C<Test::Harness>
214
215 Upgraded from version 3.21 to 3.22.
216
217 =item C<Test::Simple>
218
219 Upgraded from version 0.94 to 0.96.
220
221 Among many other things, subtests without a C<plan> or C<no_plan> now have an
222 implicit C<done_testing()> added to them.
223
224 =item C<Unicode::Collate>
225
226 Upgraded from version 0.53 to 0.56.
227
228 Among other things, it is now using UCA Revision 20 (based on Unicode 5.2.0) and
229 supports a couple of new locales.
230
231 =item C<feature>
232
233 Upgraded from version 1.17 to 1.18.
234
235 =back
236
237 =head2 Removed Modules and Pragmata
238
239 This release does not remove any modules or pragmata.
240
241 =head1 Documentation
242
243 =head2 Changes to Existing Documentation
244
245 =head3 L<perldiag>
246
247 =over 4
248
249 =item *
250
251 The following existing diagnostics are now documented:
252
253 =over 4
254
255 =item *
256
257 L<Ambiguous use of %c resolved as operator %c|perldiag/"Ambiguous use of %c resolved as operator %c">
258
259 =item *
260
261 L<Ambiguous use of %c{%s} resolved to %c%s|perldiag/"Ambiguous use of %c{%s} resolved to %c%s">
262
263 =item *
264
265 L<Ambiguous use of %c{%s%s} resolved to %c%s%s|perldiag/"Ambiguous use of %c{%s%s} resolved to %c%s%s">
266
267 =item *
268
269 L<Ambiguous use of -%s resolved as -&%s()|perldiag/"Ambiguous use of -%s resolved as -&%s()">
270
271 =item *
272
273 L<Invalid strict version format (%s)|perldiag/"Invalid strict version format (%s)">
274
275 =item *
276
277 L<Invalid version format (%s)|perldiag/"Invalid version format (%s)">
278
279 =item *
280
281 L<Invalid version object|perldiag/"Invalid version object">
282
283 =back
284
285 =back
286
287 =head3 L<perlport>
288
289 =over 4
290
291 =item *
292
293 Documented a L<limitation|perlport/alarm> of L<alarm()|perlfunc/"alarm SECONDS">
294 on Win32.
295
296 =back
297
298 =head3 L<perlre>
299
300 =over 4
301
302 =item *
303
304 Minor fix to a multiple scalar match example.
305
306 =back
307
308 =head1 Configuration and Compilation
309
310 =over 4
311
312 =item *
313
314 Compatibility with C<C++> compilers has been improved.
315
316 =item *
317
318 On compilers that support it, C<-Wwrite-strings> is now added to cflags by
319 default.
320
321 =back
322
323 =head1 Testing
324
325 =over 4
326
327 =item *
328
329 F<t/op/print.t> has been added to test implicit printing of C<$_>.
330
331 =item *
332
333 F<t/io/errnosig.t> has been added to test for restoration of of C<$!> when
334 leaving signal handlers.
335
336 =item *
337
338 F<t/op/tie_fetch_count.t> has been added to see if C<FETCH> is only called once
339 on tied variables.
340
341 =item *
342
343 F<lib/Tie/ExtraHash.t> has been added to make sure the, previously untested,
344 L<Tie::ExtraHash> keeps working.
345
346 =item *
347
348 F<t/re/overload.t> has been added to test against string corruption in pattern
349 matches on overloaded objects. This is a TODO test.
350
351 =back
352
353 =head1 Platform Support
354
355 =head2 Platform-Specific Notes
356
357 =over 4
358
359 =item Win32
360
361 =over 4
362
363 =item *
364
365 Fixed a possible hang in F<t/op/readline.t>.
366
367 =item *
368
369 Fixed build process for SDK2003SP1 compilers.
370
371 =item *
372
373 When using old 32-bit compilers, the define C<_USE_32BIT_TIME_T> will now be set
374 in C<$Config{ccflags}>. This improves portability when compiling XS extensions
375 using new compilers, but for a perl compiled with old 32-bit compilers.
376
377 =back
378
379 =back
380
381 =head1 Internal Changes
382
383 =over 4
384
385 =item Removed C<PERL_POLLUTE>
386
387 The option to define C<PERL_POLLUTE> to expose older 5.005 symbols for backwards
388 compatibility has been removed. It's use was always discouraged, and MakeMaker
389 contains a more specific escape hatch:
390
391     perl Makefile.PL POLLUTE=1
392
393 This can be used for modules that have not been upgraded to 5.6 naming
394 conventions (and really should be completely obsolete by now).
395
396 =item Added C<PERL_STATIC_INLINE>
397
398 The C<PERL_STATIC_INLINE> define has been added to provide the best-guess
399 incantation to use for static inline functions, if the C compiler supports
400 C99-style static inline. If it doesn't, it'll give a plain C<static>.
401
402 C<HAS_STATIC_INLINE> can be used to check if the compiler actually supports
403 inline functions.
404
405 =back
406
407 =head1 Selected Bug Fixes
408
409 =over 4
410
411 =item *
412
413 A possible memory leak when using L<caller()|perlfunc/"caller EXPR"> to set
414 C<@DB::args> has been fixed.
415
416 =item *
417
418 Several memory leaks when loading XS modules were fixed.
419
420 =item *
421
422 A panic in the regular expression optimizer has been fixed (RT#75762).
423
424 =item *
425
426 Assignments to lvalue subroutines now honor copy-on-write behavior again, which
427 has been broken since version 5.10.0 (RT#75656).
428
429 =item *
430
431 Assignments to glob copies now behave just like assignments to regular globs
432 (RT#1804).
433
434 =item *
435
436 Within signal handlers, C<$!> is now implicitly localized.
437
438 =item *
439
440 L<readline|perlfunc/"readline EXPR"> now honors C<< <> >> overloading on tied
441 arguments.
442
443 =item *
444
445 L<substr()|perlfunc/"substr EXPR,OFFSET,LENGTH,REPLACEMENT">,
446 L<pos()|perlfunc/"index STR,SUBSTR,POSITION">, L<keys()|perlfunc/"keys HASH">,
447 and L<vec()|perlfunc/"vec EXPR,OFFSET,BITS"> could, when used in combination
448 with lvalues, result in leaking the scalar value they operate on, and cause its
449 destruction to happen too late. This has now been fixed.
450
451 =item *
452
453 Building with C<PERL_GLOBAL_STRUCT>, which has been broken accidentally in
454 5.13.3, now works again.
455
456 =back
457
458 =head1 Known Problems
459
460 =over 4
461
462 =item *
463
464 The changes in L<substr()|perlfunc/"substr EXPR,OFFSET,LENGTH,REPLACEMENT">
465 broke C<HTML::Parser> <= 3.66. A fixed C<HTML::Parser> is available as version
466 3.67 on CPAN.
467
468 =item *
469
470 The changes in prototype handling break C<Switch>. A patch has been sent
471 upstream and will hopefully appear on CPAN soon.
472
473 =back
474
475 =head1 Acknowledgements
476
477 Perl 5.13.4 represents approximately one month of development since Perl 5.13.3,
478 and contains 91,200 lines of changes across 436 files from 34 authors and
479 committers.
480
481 Thank you to the following for contributing to this release:
482
483 Abigail, Andy Armstrong, Andy Dougherty, Chas. Owens, Chip Salzenberg, Chris
484 'BinGOs' Williams, Craig A. Berry, David Cantrell, David Golden, David Mitchell,
485 Eric Brine, Father Chrysostomos, Florian Ragwitz, George Greer, Gerard Goossen,
486 H.Merijn Brand, James Mastros, Jan Dubois, Jerry D. Hedden, Joshua ben Jore,
487 Karl Williamson, Lars Dɪᴇᴄᴋᴏᴡ 迪拉斯, Leon Brocard, Lubomir Rintel, Nicholas
488 Clark, Paul Marquess, Rafael Garcia-Suarez, Reini Urban, Robin Barker, Slaven
489 Rezic, Steve Peters, Tony Cook, Wolfram Humann, Zefram
490
491 =head1 Reporting Bugs
492
493 If you find what you think is a bug, you might check the articles recently
494 posted to the comp.lang.perl.misc newsgroup and the perl bug database at
495 http://rt.perl.org/perlbug/ .  There may also be information at
496 http://www.perl.org/ , the Perl Home Page.
497
498 If you believe you have an unreported bug, please run the B<perlbug> program
499 included with your release.  Be sure to trim your bug down to a tiny but
500 sufficient test case.  Your bug report, along with the output of C<perl -V>,
501 will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
502
503 If the bug you are reporting has security implications, which make it
504 inappropriate to send to a publicly archived mailing list, then please send it
505 to perl5-security-report@perl.org. This points to a closed subscription
506 unarchived mailing list, which includes all the core committers, who be able to
507 help assess the impact of issues, figure out a resolution, and help co-ordinate
508 the release of patches to mitigate or fix the problem across all platforms on
509 which Perl is supported. Please only use this address for security issues in the
510 Perl core, not for modules independently distributed on CPAN.
511
512 =head1 SEE ALSO
513
514 The F<Changes> file for an explanation of how to view exhaustive details
515 on what changed.
516
517 The F<INSTALL> file for how to build Perl.
518
519 The F<README> file for general stuff.
520
521 The F<Artistic> and F<Copying> files for copyright information.
522
523 =cut