pod/perl5321delta.pod

   1 =encoding utf8
   2
   3 =head1 NAME
   4
   5 perl5321delta - what is new for perl v5.32.1
   6
   7 =head1 DESCRIPTION
   8
   9 This document describes differences between the 5.32.0 release and the 5.32.1
  10 release.
  11
  12 If you are upgrading from an earlier release such as 5.30.0, first read
  13 L<perl5320delta>, which describes differences between 5.30.0 and 5.32.0.
  14
  15 =head1 Incompatible Changes
  16
  17 There are no changes intentionally incompatible with Perl 5.32.0.  If any
  18 exist, they are bugs, and we request that you submit a report.  See
  19 L</Reporting Bugs> below.
  20
  21 =head1 Modules and Pragmata
  22
  23 =head2 Updated Modules and Pragmata
  24
  25 =over 4
  26
  27 =item *
  28
  29 L<Data::Dumper> has been upgraded from version 2.174 to 2.174_01.
  30
  31 A number of memory leaks have been fixed.
  32
  33 =item *
  34
  35 L<DynaLoader> has been upgraded from version 1.47 to 1.47_01.
  36
  37 =item *
  38
  39 L<Module::CoreList> has been upgraded from version 5.20200620 to 5.20210123.
  40
  41 =item *
  42
  43 L<Opcode> has been upgraded from version 1.47 to 1.48.
  44
  45 A warning has been added about evaluating untrusted code with the perl
  46 interpreter.
  47
  48 =item *
  49
  50 L<Safe> has been upgraded from version 2.41 to 2.41_01.
  51
  52 A warning has been added about evaluating untrusted code with the perl
  53 interpreter.
  54
  55 =back
  56
  57 =head1 Documentation
  58
  59 =head2 New Documentation
  60
  61 =head3 L<perlgov>
  62
  63 Documentation of the newly formed rules of governance for Perl.
  64
  65 =head3 L<perlsecpolicy>
  66
  67 Documentation of how the Perl security team operates and how the team evaluates
  68 new security reports.
  69
  70 =head2 Changes to Existing Documentation
  71
  72 We have attempted to update the documentation to reflect the changes listed in
  73 this document.  If you find any we have missed, open an issue at
  74 L<https://github.com/Perl/perl5/issues>.
  75
  76 Additionally, the following selected changes have been made:
  77
  78 =head3 L<perlop>
  79
  80 =over 4
  81
  82 =item *
  83
  84 Document range op behaviour change.
  85
  86 =back
  87
  88 =head1 Diagnostics
  89
  90 The following additions or changes have been made to diagnostic output,
  91 including warnings and fatal error messages.  For the complete list of
  92 diagnostic messages, see L<perldiag>.
  93
  94 =head2 Changes to Existing Diagnostics
  95
  96 =over 4
  97
  98 =item *
  99
 100 L<\K not permitted in lookahead/lookbehind in regex; marked by <-- HERE in mE<sol>%sE<sol>|perldiag/"\K not permitted in lookahead/lookbehind in regex; marked by <-- HERE in m/%s/">
 101
 102 This error was incorrectly produced in some cases involving nested lookarounds.
 103 This has been fixed.
 104
 105 [L<GH #18123|https://github.com/Perl/perl5/issues/18123>]
 106
 107 =back
 108
 109 =head1 Configuration and Compilation
 110
 111 =over 4
 112
 113 =item *
 114
 115 Newer 64-bit versions of the Intel C/C++ compiler are now recognized and have
 116 the correct flags set.
 117
 118 =item *
 119
 120 We now trap SIGBUS when F<Configure> checks for C<va_copy>.
 121
 122 On several systems the attempt to determine if we need C<va_copy> or similar
 123 results in a SIGBUS instead of the expected SIGSEGV, which previously caused a
 124 core dump.
 125
 126 [L<GH #18148|https://github.com/Perl/perl5/issues/18148>]
 127
 128 =back
 129
 130 =head1 Testing
 131
 132 Tests were added and changed to reflect the other additions and changes in this
 133 release.
 134
 135 =head1 Platform Support
 136
 137 =head2 Platform-Specific Notes
 138
 139 =over 4
 140
 141 =item MacOS (Darwin)
 142
 143 The hints file for darwin has been updated to handle future macOS versions
 144 beyond 10.  Perl can now be built on macOS Big Sur.
 145
 146 [L<GH #17946|https://github.com/Perl/perl5/issues/17946>,
 147 L<GH #18406|https://github.com/Perl/perl5/issues/18406>]
 148
 149 =item Minix
 150
 151 Build errors on Minix have been fixed.
 152
 153 [L<GH #17908|https://github.com/Perl/perl5/issues/17908>]
 154
 155 =back
 156
 157 =head1 Selected Bug Fixes
 158
 159 =over 4
 160
 161 =item *
 162
 163 Some list assignments involving C<undef> on the left-hand side were
 164 over-optimized and produced incorrect results.
 165
 166 [L<GH #16685|https://github.com/Perl/perl5/issues/16685>,
 167 L<GH #17816|https://github.com/Perl/perl5/issues/17816>]
 168
 169 =item *
 170
 171 Fixed a bug in which some regexps with recursive subpatterns matched
 172 incorrectly.
 173
 174 [L<GH #18096|https://github.com/Perl/perl5/issues/18096>]
 175
 176 =item *
 177
 178 Fixed a deadlock that hung the build when Perl is compiled for debugging memory
 179 problems and has PERL_MEM_LOG enabled.
 180
 181 [L<GH #18341|https://github.com/Perl/perl5/issues/18341>]
 182
 183 =item *
 184
 185 Fixed a crash in the use of chained comparison operators when run under "no
 186 warnings 'uninitialized'".
 187
 188 [L<GH #17917|https://github.com/Perl/perl5/issues/17917>,
 189 L<GH #18380|https://github.com/Perl/perl5/issues/18380>]
 190
 191 =item *
 192
 193 Exceptions thrown from destructors during global destruction are no longer
 194 swallowed.
 195
 196 [L<GH #18063|https://github.com/Perl/perl5/issues/18063>]
 197
 198 =back
 199
 200 =head1 Acknowledgements
 201
 202 Perl 5.32.1 represents approximately 7 months of development since Perl 5.32.0
 203 and contains approximately 7,000 lines of changes across 80 files from 23
 204 authors.
 205
 206 Excluding auto-generated files, documentation and release tools, there were
 207 approximately 1,300 lines of changes to 23 .pm, .t, .c and .h files.
 208
 209 Perl continues to flourish into its fourth decade thanks to a vibrant community
 210 of users and developers.  The following people are known to have contributed
 211 the improvements that became Perl 5.32.1:
 212
 213 Adam Hartley, Andy Dougherty, Dagfinn Ilmari Mannsåker, Dan Book, David
 214 Mitchell, Graham Knop, Graham Ollis, Hauke D, H.Merijn Brand, Hugo van der
 215 Sanden, John Lightsey, Karen Etheridge, Karl Williamson, Leon Timmermans, Max
 216 Maischein, Nicolas R., Ricardo Signes, Richard Leach, Sawyer X, Sevan Janiyan,
 217 Steve Hay, Tom Hukins, Tony Cook.
 218
 219 The list above is almost certainly incomplete as it is automatically generated
 220 from version control history.  In particular, it does not include the names of
 221 the (very much appreciated) contributors who reported issues to the Perl bug
 222 tracker.
 223
 224 Many of the changes included in this version originated in the CPAN modules
 225 included in Perl's core.  We're grateful to the entire CPAN community for
 226 helping Perl to flourish.
 227
 228 For a more complete list of all of Perl's historical contributors, please see
 229 the F<AUTHORS> file in the Perl source distribution.
 230
 231 =head1 Reporting Bugs
 232
 233 If you find what you think is a bug, you might check the perl bug database at
 234 L<https://github.com/Perl/perl5/issues>.  There may also be information at
 235 L<http://www.perl.org/>, the Perl Home Page.
 236
 237 If you believe you have an unreported bug, please open an issue at
 238 L<https://github.com/Perl/perl5/issues>.  Be sure to trim your bug down to a
 239 tiny but sufficient test case.
 240
 241 If the bug you are reporting has security implications which make it
 242 inappropriate to send to a public issue tracker, then see
 243 L<perlsec/SECURITY VULNERABILITY CONTACT INFORMATION> for details of how to
 244 report the issue.
 245
 246 =head1 Give Thanks
 247
 248 If you wish to thank the Perl 5 Porters for the work we had done in Perl 5, you
 249 can do so by running the C<perlthanks> program:
 250
 251     perlthanks
 252
 253 This will send an email to the Perl 5 Porters list with your show of thanks.
 254
 255 =head1 SEE ALSO
 256
 257 The F<Changes> file for an explanation of how to view exhaustive details on
 258 what changed.
 259
 260 The F<INSTALL> file for how to build Perl.
 261
 262 The F<README> file for general stuff.
 263
 264 The F<Artistic> and F<Copying> files for copyright information.
 265
 266 =cut