pod/perl52510delta.pod

   1 =encoding utf8
   2
   3 =head1 NAME
   4
   5 perl52510delta - what is new for perl v5.25.10
   6
   7 =head1 DESCRIPTION
   8
   9 This document describes differences between the 5.25.9 release and the 5.25.10
  10 release.
  11
  12 If you are upgrading from an earlier release such as 5.25.8, first read
  13 L<perl5259delta>, which describes differences between 5.25.8 and 5.25.9.
  14
  15 =head1 Modules and Pragmata
  16
  17 =head2 Updated Modules and Pragmata
  18
  19 =over 4
  20
  21 =item *
  22
  23 L<B> has been upgraded from version 1.65 to 1.68.
  24
  25 =item *
  26
  27 L<CPAN> has been upgraded from version 2.16 to 2.17.
  28
  29 =item *
  30
  31 L<feature> has been upgraded from version 1.46 to 1.47.
  32
  33 =item *
  34
  35 L<Getopt::Std> has been upgraded from version 1.11 to 1.12.
  36
  37 =item *
  38
  39 L<Module::CoreList> has been upgraded from version 5.20170120 to 5.20170220.
  40
  41 =item *
  42
  43 L<open> has been upgraded from version 1.10 to 1.11.
  44
  45 =item *
  46
  47 L<PerlIO> has been upgraded from version 1.09 to 1.10.
  48
  49 =item *
  50
  51 L<Storable> has been upgraded from version 2.61 to 2.62.
  52
  53 =item *
  54
  55 L<Thread::Queue> has been upgraded from version 3.11 to 3.12.
  56
  57 =item *
  58
  59 L<threads> has been upgraded from version 2.12 to 2.13.
  60
  61 =back
  62
  63 =head1 Diagnostics
  64
  65 The following additions or changes have been made to diagnostic output,
  66 including warnings and fatal error messages.  For the complete list of
  67 diagnostic messages, see L<perldiag>.
  68
  69 =head2 Changes to Existing Diagnostics
  70
  71 =over 4
  72
  73 =item *
  74
  75 Use of unassigned code point or non-standalone grapheme for a delimiter will be a fatal error starting in Perl 5.30
  76
  77 This was changed to drop a leading C<v> in C<v5.30>, so it uses the same
  78 style as other deprecation messages.
  79
  80 =item *
  81
  82 "\c%c" is more clearly written simply as "%s".
  83
  84 It was decided to undeprecate the use of "\c%c", see L<http://www.nntp.perl.org/group/perl.perl5.porters/2017/02/msg242944.html>
  85
  86 =back
  87
  88 =head1 Platform Support
  89
  90 =head2 Platform-Specific Notes
  91
  92 =over 4
  93
  94 =item Windows
  95
  96 =over 4
  97
  98 =item *
  99
 100 Support for compiling perl on Windows using Microsoft Visual Studio 2015
 101 (containing Visual C++ 14.0) has been added.
 102
 103 This version of VC++ includes a completely rewritten C run-time library, some
 104 of the changes in which mean that work done to resolve a socket close() bug in
 105 perl #120091 and perl #118059 is not workable in its current state with this
 106 version of VC++.  Therefore, we have effectively reverted that bug fix for
 107 VS2015 onwards on the basis that being able to build with VS2015 onwards is
 108 more important than keeping the bug fix.  We may revisit this in the future to
 109 attempt to fix the bug again in a way that is compatible with VS2015.
 110
 111 These changes do not affect compilation with GCC or with Visual Studio versions
 112 up to and including VS2013, i.e. the bug fix is retained (unchanged) for those
 113 compilers.
 114
 115 Note that you may experience compatibility problems if you mix a perl built
 116 with GCC or VS E<lt>= VS2013 with XS modules built with VS2015, or if you mix a
 117 perl built with VS2015 with XS modules built with GCC or VS E<lt>= VS2013.
 118 Some incompatibility may arise because of the bug fix that has been reverted
 119 for VS2015 builds of perl, but there may well be incompatibility anyway because
 120 of the rewritten CRT in VS2015 (e.g. see discussion at
 121 http://stackoverflow.com/questions/30412951).
 122
 123 =back
 124
 125 =back
 126
 127 =head1 Internal Changes
 128
 129 =over 4
 130
 131 =item *
 132
 133 The C<op_class()> API function has been added. This is like the existing
 134 C<OP_CLASS()> macro, but can more accurately determine what struct an op
 135 has been allocated as. For example C<OP_CLASS()> might return
 136 C<OA_BASEOP_OR_UNOP> indicating that ops of this type are usually
 137 allocated as an C<OP> or C<UNOP>; while C<op_class()> will return
 138 C<OPclass_BASEOP> or C<OPclass_UNOP> as appropriate.
 139
 140 =item *
 141
 142 The output format of the C<op_dump()> function (as used by C<perl -Dx>)
 143 has changed: it now displays an "ASCII-art" tree structure, and shows more
 144 low-level details about each op, such as its address and class.
 145
 146 =back
 147
 148 =head1 Selected Bug Fixes
 149
 150 =over 4
 151
 152 =item *
 153
 154 Attempting to use the deprecated variable C<$#> as the object in an
 155 indirect object method call could cause a heap use after free or
 156 buffer overflow.  [perl #129274]
 157
 158 =item *
 159
 160 When checking for an indirect object method call in some rare cases
 161 the parser could reallocate the line buffer but then continue to use
 162 pointers to the old buffer.  [perl #129190]
 163
 164 =item *
 165
 166 Supplying a glob as the format argument to L<perlfunc/formline> would
 167 cause an assertion failure.  [perl #130722]
 168
 169 =item *
 170
 171 Code like C< $value1 =~ qr/.../ ~~ $value2 > would have the match
 172 converted into a qr// operator, leaving extra elements on the stack to
 173 confuse any surrounding expression.  [perl #130705]
 174
 175 =item *
 176
 177 Since 5.24.0 in some obscure cases, a regex which included code blocks
 178 from multiple sources (e.g. via embedded via qr// objects) could end up
 179 with the wrong current pad and crash or give weird results. [perl #129881]
 180
 181 =item *
 182
 183 Occasionally C<local()>s in a code block within a patterns weren't being
 184 undone when the pattern matching backtracked over the code block.
 185 [perl #126697]
 186
 187 =item *
 188
 189 Using C<substr()> to modify a magic variable could access freed memory
 190 in some cases.  [perl #129340]
 191
 192 =item *
 193
 194 Perl 5.25.9 was fixed so that under C<use utf8>, the entire Perl program
 195 is checked that the UTF-8 is wellformed.  It turns out that several edge
 196 cases were missed, and are now fixed.  [perl #126310] was the original
 197 ticket.
 198
 199 =back
 200
 201 =head1 Acknowledgements
 202
 203 Perl 5.25.10 represents approximately 4 weeks of development since Perl 5.25.9
 204 and contains approximately 12,000 lines of changes across 200 files from 25
 205 authors.
 206
 207 Excluding auto-generated files, documentation and release tools, there were
 208 approximately 6,700 lines of changes to 130 .pm, .t, .c and .h files.
 209
 210 Perl continues to flourish into its third decade thanks to a vibrant community
 211 of users and developers. The following people are known to have contributed the
 212 improvements that became Perl 5.25.10:
 213
 214 Aaron Crane, Abigail, Andreas König, Andy Lester, Chris 'BinGOs' Williams,
 215 Christian Millour, Colin Newell, Dagfinn Ilmari Mannsåker, David Mitchell,
 216 Hugo van der Sanden, James E Keenan, Jarkko Hietaniemi, Jerry D. Hedden, John
 217 Lightsey, Karl Williamson, Neil Bowers, Pali, Renee Baecker, Sawyer X, Sergey
 218 Aleynikov, Steffen Müller, Steve Hay, Tony Cook, Yves Orton, Zefram.
 219
 220 The list above is almost certainly incomplete as it is automatically generated
 221 from version control history. In particular, it does not include the names of
 222 the (very much appreciated) contributors who reported issues to the Perl bug
 223 tracker.
 224
 225 Many of the changes included in this version originated in the CPAN modules
 226 included in Perl's core. We're grateful to the entire CPAN community for
 227 helping Perl to flourish.
 228
 229 For a more complete list of all of Perl's historical contributors, please see
 230 the F<AUTHORS> file in the Perl source distribution.
 231
 232 =head1 Reporting Bugs
 233
 234 If you find what you think is a bug, you might check the perl bug database
 235 at L<https://rt.perl.org/> .  There may also be information at
 236 L<http://www.perl.org/> , the Perl Home Page.
 237
 238 If you believe you have an unreported bug, please run the L<perlbug> program
 239 included with your release.  Be sure to trim your bug down to a tiny but
 240 sufficient test case.  Your bug report, along with the output of C<perl -V>,
 241 will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
 242
 243 If the bug you are reporting has security implications which make it
 244 inappropriate to send to a publicly archived mailing list, then see
 245 L<perlsec/SECURITY VULNERABILITY CONTACT INFORMATION>
 246 for details of how to report the issue.
 247
 248 =head1 SEE ALSO
 249
 250 The F<Changes> file for an explanation of how to view exhaustive details on
 251 what changed.
 252
 253 The F<INSTALL> file for how to build Perl.
 254
 255 The F<README> file for general stuff.
 256
 257 The F<Artistic> and F<Copying> files for copyright information.
 258
 259 =cut