This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Tick off 5.29.1
[perl5.git] / pod / perldelta.pod
CommitLineData
44691e6f
AB
1=encoding utf8
2
3=head1 NAME
4
1060c83c 5perldelta - what is new for perl v5.29.1
e4c43fa1 6
4026b091
S
7=head1 DESCRIPTION
8
1060c83c 9This document describes differences between the 5.29.0 release and the 5.29.1
4026b091
S
10release.
11
1060c83c
S
12If you are upgrading from an earlier release such as 5.28.0, first read
13L<perl5290delta>, which describes differences between 5.28.0 and 5.29.0.
14
569dc109 15=head1 Incompatible Changes
1060c83c 16
569dc109 17=head2 Delimiters must now be graphemes
1060c83c 18
569dc109
SH
19See L<perldeprecation/Use of unassigned code point or non-standalone grapheme
20for a delimiter.>
1060c83c 21
569dc109
SH
22=head2 Some formerly deprecated uses of an unescaped left brace C<"{"> in
23regular expression patterns are now illegal
1060c83c 24
569dc109
SH
25But to avoid breaking code unnecessarily, most instances that issued a
26deprecation warning, remain legal and now have a non-deprecation warning
27raised. See L<perldeprecation/Unescaped left braces in regular expressions>.
1060c83c 28
569dc109 29=head1 Performance Enhancements
1060c83c 30
569dc109 31=over 4
4026b091 32
569dc109 33=item *
4026b091 34
569dc109
SH
35Translating from UTF-8 into the code point it represents now is done via a
36deterministic finite automaton, speeding it up. As a typical example,
37C<ord("\x7fff")> now requires 12% fewer instructions than before. The
38performance of checking that a sequence of bytes is valid UTF-8 is similarly
39improved, again by using a dfa.
1060c83c 40
569dc109 41=back
1060c83c 42
569dc109 43=head1 Modules and Pragmata
1060c83c 44
569dc109 45=head2 Updated Modules and Pragmata
b2247a87 46
569dc109 47=over 4
b2247a87 48
569dc109 49=item *
b2247a87 50
569dc109 51L<bignum> has been upgraded from version 0.49 to 0.50.
b2247a87 52
569dc109 53=item *
1060c83c 54
569dc109 55L<Compress::Raw::Bzip2> has been upgraded from version 2.074 to 2.081.
1060c83c 56
569dc109 57=item *
1060c83c 58
569dc109 59L<Compress::Raw::Zlib> has been upgraded from version 2.076 to 2.081.
1060c83c 60
569dc109 61=item *
1060c83c 62
569dc109 63L<Config::Perl::V> has been upgraded from version 0.29 to 0.30.
1060c83c 64
569dc109 65=item *
1060c83c 66
569dc109 67L<DB_File> has been upgraded from version 1.840 to 1.842.
1060c83c 68
569dc109 69=item *
1060c83c 70
0bb5a0fe
SH
71L<Devel::PPPort> has been upgraded from version 3.40 to 3.42.
72
73=item *
74
569dc109 75L<Digest::SHA> has been upgraded from version 6.01 to 6.02.
1060c83c 76
569dc109 77=item *
1060c83c 78
569dc109 79L<experimental> has been upgraded from version 0.019 to 0.020.
fe2048ea 80
569dc109 81=item *
1060c83c 82
569dc109 83L<ExtUtils::Manifest> has been upgraded from version 1.70 to 1.71.
1060c83c 84
569dc109 85=item *
1060c83c 86
569dc109 87L<File::Temp> has been upgraded from version 0.2304 to 0.2308.
1060c83c
S
88
89=item *
90
569dc109 91IO-Compress has been upgraded from version 2.074 to 2.081.
4026b091 92
569dc109 93=item *
94fc6237 94
569dc109 95L<IPC::Cmd> has been upgraded from version 1.00 to 1.02.
1060c83c 96
569dc109 97=item *
1060c83c 98
569dc109 99L<Locale::Codes> has been upgraded from version 3.56 to 3.57.
1060c83c 100
569dc109 101=item *
1060c83c 102
569dc109 103L<Math::BigInt> has been upgraded from version 1.999811 to 1.999813.
1060c83c
S
104
105=item *
106
569dc109 107L<Math::BigInt::FastCalc> has been upgraded from version 0.5006 to 0.5007.
1060c83c 108
569dc109 109=item *
1060c83c 110
569dc109 111L<Math::BigRat> has been upgraded from version 0.2613 to 0.2614.
4026b091 112
569dc109
SH
113=item *
114
0bb5a0fe
SH
115L<Module::CoreList> has been upgraded from version 5.20180626 to 5.20180720.
116
117=item *
118
569dc109 119L<parent> has been upgraded from version 0.236 to 0.237.
4026b091
S
120
121=item *
122
569dc109 123L<perlfaq> has been upgraded from version 5.021011 to 5.20180605.
1060c83c 124
569dc109 125=item *
1060c83c 126
569dc109 127podlators has been upgraded from version 4.10 to 4.11.
1060c83c 128
569dc109 129=item *
1060c83c 130
0bb5a0fe
SH
131L<Storable> has been upgraded from version 3.08 to 3.11.
132
133=item *
134
569dc109 135L<Test::Simple> has been upgraded from version 1.302133 to 1.302138.
1060c83c
S
136
137=item *
138
569dc109 139L<Thread::Queue> has been upgraded from version 3.12 to 3.13.
1060c83c 140
569dc109 141=item *
1060c83c 142
569dc109 143L<Time::Local> has been upgraded from version 1.25 to 1.28.
1060c83c 144
569dc109 145=item *
1060c83c 146
569dc109 147L<version> has been upgraded from version 0.9923 to 0.9924.
1060c83c 148
569dc109 149=back
1060c83c 150
569dc109 151=head1 Documentation
1060c83c
S
152
153=head2 Changes to Existing Documentation
154
569dc109
SH
155We have attempted to update the documentation to reflect the changes listed in
156this document. If you find any we have missed, send email to
157L<perlbug@perl.org|mailto:perlbug@perl.org>.
1060c83c
S
158
159Additionally, the following selected changes have been made:
160
b0a362a2
SH
161=head3 L<perlapi>
162
163=over 4
164
165=item *
166
167C<AvFILL()> was wrongly listed as deprecated. This has been corrected.
168L<[perl #133278]|https://rt.perl.org/Ticket/Display.html?id=133278>
169
170=back
171
172=head3 L<perlop>
1060c83c
S
173
174=over 4
175
176=item *
177
b0a362a2
SH
178The behaviour of C<tr> when the delimiter is an apostrophe has been clarified.
179In particular, hyphens aren't special, and C<\x{}> isn't interpolated.
180L<[perl #130679]|https://rt.perl.org/Ticket/Display.html?id=130679>
1060c83c
S
181
182=back
183
184=head1 Diagnostics
185
186The following additions or changes have been made to diagnostic output,
187including warnings and fatal error messages. For the complete list of
188diagnostic messages, see L<perldiag>.
189
1060c83c
S
190=head2 Changes to Existing Diagnostics
191
1060c83c
S
192=over 4
193
194=item *
195
569dc109
SH
196As noted under L<Incompatible Changes> above, the deprecation warning
197"Unescaped left brace in regex is deprecated here (and will be fatal in Perl
1985.30), passed through in regex; marked by S<<-- HERE> in m/%s/" has been
199changed to the non-deprecation warning "Unescaped left brace in regex is passed
200through in regex; marked by S<<-- HERE> in m/%s/".
1060c83c
S
201
202=back
203
204=head1 Testing
205
569dc109
SH
206Tests were added and changed to reflect the other additions and changes in this
207release.
1060c83c
S
208
209=head1 Platform Support
210
1060c83c
S
211=head2 Platform-Specific Notes
212
1060c83c
S
213=over 4
214
b0a362a2 215=item HP-UX 11.11
1060c83c 216
b0a362a2
SH
217An obscure problem in C<pack()> when compiling with HP C-ANSI-C has been fixed
218by disabling optimizations in F<pp_pack.c>.
219
220=item Windows
221
222=over 4
223
224=item *
225
226The C<USE_CPLUSPLUS> build option which has long been available in
227F<win32/Makefile> (for B<nmake>) and F<win32/makefile.mk> (for B<dmake>) is now
228also available in F<win32/GNUmakefile> (for B<gmake>).
229
230=item *
231
232The B<nmake> makefile no longer defaults to Visual C++ 6.0 (a very old version
233which is unlikely to be widely used today). As a result, it is now a
234requirement to specify the C<CCTYPE> since there is no obvious choice of which
235modern version to default to instead. Failure to specify C<CCTYPE> will result
236in an error being output and the build will stop.
237
238(The B<dmake> and B<gmake> makefiles will automatically detect which compiler
239is being used, so do not require C<CCTYPE> to be set. This feature has not yet
240been added to the B<nmake> makefile.)
241
242=back
1060c83c
S
243
244=back
245
1060c83c
S
246=head1 Selected Bug Fixes
247
1060c83c
S
248=over 4
249
250=item *
251
b0a362a2
SH
252Compilation under C<-DPERL_MEM_LOG> and C<-DNO_LOCALE> have been fixed.
253
254=item *
255
256Perl 5.28 introduced an C<index()> optimization when comparing to -1 (or
257indirectly, e.g. >= 0). When this optimization was triggered inside a C<when>
258clause it caused a warning ("Argument %s isn't numeric in smart match"). This
259has now been fixed.
260L<[perl #133368]|https://rt.perl.org/Ticket/Display.html?id=133368>
1060c83c
S
261
262=back
263
1060c83c 264=head1 Acknowledgements
4026b091 265
c4070876
SH
266Perl 5.29.1 represents approximately 3 weeks of development since Perl 5.29.0
267and contains approximately 68,000 lines of changes across 510 files from 18
268authors.
5ef73200 269
c4070876
SH
270Excluding auto-generated files, documentation and release tools, there were
271approximately 62,000 lines of changes to 320 .pm, .t, .c and .h files.
272
273Perl continues to flourish into its fourth decade thanks to a vibrant community
274of users and developers. The following people are known to have contributed the
275improvements that became Perl 5.29.1:
276
277Chris 'BinGOs' Williams, Craig A. Berry, Dagfinn Ilmari Mannsåker, Daniel
278Dragan, David Mitchell, François Perrad, H.Merijn Brand, Hugo van der Sanden,
279James E Keenan, Jerry D. Hedden, Jim Cromie, Karen Etheridge, Karl Williamson,
280Nicholas Clark, Sawyer X, Steve Hay, Tina Müller, Yves Orton.
281
282The list above is almost certainly incomplete as it is automatically generated
283from version control history. In particular, it does not include the names of
284the (very much appreciated) contributors who reported issues to the Perl bug
285tracker.
286
287Many of the changes included in this version originated in the CPAN modules
288included in Perl's core. We're grateful to the entire CPAN community for
289helping Perl to flourish.
290
291For a more complete list of all of Perl's historical contributors, please see
292the F<AUTHORS> file in the Perl source distribution.
f5b73711 293
44691e6f
AB
294=head1 Reporting Bugs
295
569dc109
SH
296If you find what you think is a bug, you might check the perl bug database at
297L<https://rt.perl.org/> . There may also be information at
b5cbfe35 298L<http://www.perl.org/> , the Perl Home Page.
44691e6f 299
e08634c5
SH
300If you believe you have an unreported bug, please run the L<perlbug> program
301included with your release. Be sure to trim your bug down to a tiny but
302sufficient test case. Your bug report, along with the output of C<perl -V>,
b5cbfe35 303will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
44691e6f 304
87c118b9
DM
305If the bug you are reporting has security implications which make it
306inappropriate to send to a publicly archived mailing list, then see
569dc109
SH
307L<perlsec/SECURITY VULNERABILITY CONTACT INFORMATION> for details of how to
308report the issue.
44691e6f 309
390ae6f9
S
310=head1 Give Thanks
311
569dc109
SH
312If you wish to thank the Perl 5 Porters for the work we had done in Perl 5, you
313can do so by running the C<perlthanks> program:
390ae6f9
S
314
315 perlthanks
316
317This will send an email to the Perl 5 Porters list with your show of thanks.
318
44691e6f
AB
319=head1 SEE ALSO
320
e08634c5
SH
321The F<Changes> file for an explanation of how to view exhaustive details on
322what changed.
44691e6f
AB
323
324The F<INSTALL> file for how to build Perl.
325
326The F<README> file for general stuff.
327
328The F<Artistic> and F<Copying> files for copyright information.
329
330=cut