pod/perldelta.pod

   1 =encoding utf8
   2
   3 =head1 NAME
   4
   5 perldelta - what is new for perl v5.33.9
   6
   7 =head1 DESCRIPTION
   8
   9 This document describes differences between the 5.33.8 release and the 5.33.9
  10 release.
  11
  12 If you are upgrading from an earlier release such as 5.33.7, first read
  13 L<perl5338delta>, which describes differences between 5.33.7 and 5.33.8.
  14
  15 =head1 Modules and Pragmata
  16
  17 =head2 Updated Modules and Pragmata
  18
  19 =over 4
  20
  21 =item *
  22
  23 L<perlfaq> has been upgraded from version 5.20201107 to 5.20210411.
  24
  25 - Added entry to faq4 for equivalent to ruby #{}, python fstring
  26
  27 =item *
  28
  29 L<ExtUtils::MakeMaker> has been upgraded from version 7.60 to 7.62
  30
  31 - Now using shellwords in ExtUtils::Liblist::Kid::_unix_os2_ext
  32
  33 =item *
  34
  35 L<NEXT> has been upgraded from version 0.67 to 0.68
  36
  37 - This aligns NEXT with changes already shipped with Perl as well as improving the test suite.
  38
  39 =item *
  40
  41 L<ExtUtils::ParseXS> has been upgraded from version 3.42 to 3.43
  42
  43 - Emphasize SvPVbyte and SvPVutf8 over SvPV in docs. Also includes minor output changes to clarify failure conditions.
  44
  45 =back
  46
  47 =head1 Documentation
  48
  49 =over 4
  50
  51 =item *
  52
  53 L<perlguts> now explains in greater detail the need to consult SvUTF8
  54 when calling SvPV (or variants). A new "How do I pass a Perl string to a C
  55 library?" section in the same document discusses when to use which style of
  56 macro to read an SV's string value.
  57
  58 L<perlapi>, L<perlguts>, L<perlxs>, and L<perlxstut> now prefer SvPVbyte
  59 over SvPV.
  60
  61 =item *
  62
  63 References to B<Pumpking> have been replaced with a more accurate term or B<Steering Council> where appropriate.
  64
  65 =item *
  66
  67 L<perldiag> now documents additional examples of "not imported" warnings.
  68
  69 =item *
  70
  71 B<The Perl Steering Council> is now the fallback contact for security issues.
  72
  73 =item *
  74
  75 Simplify the split() documentation by removing the join()s from the examples (#18676)
  76
  77 Remove join() from split() examples as it confuses the concepts
  78
  79 split() is a very basic function, and the documentation should be
  80 simple for novinces. The split() documentation contains a lot of join()
  81 in the examples which only serve to muddle the concepts. This replaces
  82 the join() in the example with output in comments.
  83
  84 =back
  85
  86 =head1 Diagnostics
  87
  88 The following additions or changes have been made to diagnostic output,
  89 including warnings and fatal error messages.  For the complete list of
  90 diagnostic messages, see L<perldiag>.
  91
  92 =head2 New Diagnostics
  93
  94 =head3 New Warnings
  95
  96 =over 4
  97
  98 =item *
  99
 100 L<Wide character in setenv key (encoding to utf8)|perldiag/"Wide character in %s">
 101
 102 Attempts to put wide characters into environment variable keys via C<%ENV> now
 103 provoke this warning.
 104
 105 =back
 106
 107 =head1 Configuration and Compilation
 108
 109 =over 4
 110
 111 =item *
 112
 113 Prevented incpath to spill into libpth
 114
 115 =over 4
 116
 117 =item - Use realpath if available.
 118
 119 =item - This might catch more duplicate paths.
 120
 121 =item - Only include real existing paths.
 122
 123 =item - Filter inc paths out of libpth.
 124
 125 =back
 126
 127 =back
 128
 129 =head1 Platform Support
 130
 131 =head2 Platform-Specific Notes
 132
 133 =over 4
 134
 135 =item Windows
 136
 137 Reading non-ASCII characters from the console when its codepage was set to
 138 65001 (UTF-8) was broken due to a bug in Windows. A workaround for this
 139 problem has been implemented.
 140 [L<GH #18701|https://github.com/Perl/perl5/issues/18701>]
 141
 142 =back
 143
 144 =head1 Internal Changes
 145
 146 =over 4
 147
 148 =item *
 149
 150 Corrected handling of double and long double parameters for perl's
 151 implementation of formatted output for C<-Dusequadmath> builds.
 152
 153 This applies to PerlIO_printf(), croak(), warn(), sv_catpvf() and
 154 their variants.
 155
 156 Previously in C<quadmath> builds, code like:
 157
 158   PerlIO_printf(PerlIO_stderr(), "%g", somedouble);
 159
 160 or
 161
 162   PerlIO_printf(PerlIO_stderr(), "%Lg", somelongdouble);
 163
 164 would erroneously throw an exception "panic: quadmath invalid format
 165 ...", since the code added for quadmath builds assumed C<NV>s were the
 166 only floating point format passed into these functions.
 167
 168 This code would also process the standard C long double specifier C<L>
 169 as if it expected an C<NV> (C<__float128> for quadmath builds),
 170 resulting in undefined behaviour.
 171
 172 These functions now correctly accept doubles, long doubles and NVs.
 173
 174 =item *
 175
 176 Previously the right operand of bitwise shift operators (shift amount)
 177 was implicitly cast from IV to int, but it might lead wrong results
 178 if IV does not fit in int.
 179
 180 And also, shifting INT_MIN bits used to yield the shiftee unchanged
 181 (treated as 0-bit shift instead of negative shift).
 182
 183 =back
 184
 185 =head1 Selected Bug Fixes
 186
 187 =over 4
 188
 189 =item *
 190
 191 Setting %ENV now properly handles upgraded strings in the key. Previously
 192 Perl sent the SV's internal PV directly to the OS; now it will handle keys
 193 as it has handled values since 5.18: attempt to downgrade the string first;
 194 if that fails then warn and use the utf8 form.
 195
 196 =back
 197
 198 =head1 Acknowledgements
 199
 200 Perl 5.33.9 represents approximately 4 weeks of development since Perl
 201 5.33.8 and contains approximately 3,900 lines of changes across 190 files
 202 from 23 authors.
 203
 204 Excluding auto-generated files, documentation and release tools, there were
 205 approximately 780 lines of changes to 82 .pm, .t, .c and .h files.
 206
 207 Perl continues to flourish into its fourth decade thanks to a vibrant
 208 community of users and developers. The following people are known to have
 209 contributed the improvements that became Perl 5.33.9:
 210
 211 Dan Book, Dominic Hamon, E. Choroba, Ed J, Felipe Gasper, H.Merijn Brand,
 212 Hugo van der Sanden, James E Keenan, John Lightsey, Karen Etheridge, Karl
 213 Williamson, Marc Reisner, Max Maischein, Nicolas R., Paul Evans, Ricardo
 214 Signes, Richard Leach, Scott Baker, TAKAI Kousuke, Todd Rinaldo, Tomasz
 215 Konojacki, Tony Cook, Михаил Козачков.
 216
 217 The list above is almost certainly incomplete as it is automatically
 218 generated from version control history. In particular, it does not include
 219 the names of the (very much appreciated) contributors who reported issues to
 220 the Perl bug tracker.
 221
 222 Many of the changes included in this version originated in the CPAN modules
 223 included in Perl's core. We're grateful to the entire CPAN community for
 224 helping Perl to flourish.
 225
 226 For a more complete list of all of Perl's historical contributors, please
 227 see the F<AUTHORS> file in the Perl source distribution.
 228
 229 =head1 Reporting Bugs
 230
 231 If you find what you think is a bug, you might check the perl bug database
 232 at L<https://github.com/Perl/perl5/issues>.  There may also be information at
 233 L<http://www.perl.org/>, the Perl Home Page.
 234
 235 If you believe you have an unreported bug, please open an issue at
 236 L<https://github.com/Perl/perl5/issues>.  Be sure to trim your bug down to a
 237 tiny but sufficient test case.
 238
 239 If the bug you are reporting has security implications which make it
 240 inappropriate to send to a public issue tracker, then see
 241 L<perlsec/SECURITY VULNERABILITY CONTACT INFORMATION>
 242 for details of how to report the issue.
 243
 244 =head1 Give Thanks
 245
 246 If you wish to thank the Perl 5 Porters for the work we had done in Perl 5,
 247 you can do so by running the C<perlthanks> program:
 248
 249     perlthanks
 250
 251 This will send an email to the Perl 5 Porters list with your show of thanks.
 252
 253 =head1 SEE ALSO
 254
 255 The F<Changes> file for an explanation of how to view exhaustive details on
 256 what changed.
 257
 258 The F<INSTALL> file for how to build Perl.
 259
 260 The F<README> file for general stuff.
 261
 262 The F<Artistic> and F<Copying> files for copyright information.
 263
 264 =cut