pod/perl5301delta.pod

   1 =encoding utf8
   2
   3 =head1 NAME
   4
   5 perl5301delta - what is new for perl v5.30.1
   6
   7 =head1 DESCRIPTION
   8
   9 This document describes differences between the 5.30.0 release and the 5.30.1
  10 release.
  11
  12 If you are upgrading from an earlier release such as 5.28.0, first read
  13 L<perl5300delta>, which describes differences between 5.28.0 and 5.30.0.
  14
  15 =head1 Incompatible Changes
  16
  17 There are no changes intentionally incompatible with 5.30.1.  If any exist,
  18 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<Module::CoreList> has been upgraded from version 5.20190522 to 5.20191110.
  30
  31 =back
  32
  33 =head1 Documentation
  34
  35 =head2 Changes to Existing Documentation
  36
  37 We have attempted to update the documentation to reflect the changes listed in
  38 this document.  If you find any we have missed, send email to
  39 L<perlbug@perl.org|mailto:perlbug@perl.org>.
  40
  41 Additionally, documentation has been updated to reference GitHub as the new
  42 canonical repository and to describe the new GitHub pull request workflow.
  43
  44 =head1 Configuration and Compilation
  45
  46 =over 4
  47
  48 =item *
  49
  50 The C<ECHO> macro is now defined.  This is used in a C<dtrace> rule that was
  51 originally changed for FreeBSD, and the FreeBSD make apparently predefines it.
  52 The Solaris make does not predefine C<ECHO> which broke this rule on Solaris.
  53 L<[perl #17057]|https://github.com/perl/perl5/issues/17057>
  54
  55 =back
  56
  57 =head1 Testing
  58
  59 Tests were added and changed to reflect the other additions and changes in this
  60 release.
  61
  62 =head1 Platform Support
  63
  64 =head2 Platform-Specific Notes
  65
  66 =over 4
  67
  68 =item Win32
  69
  70 The locale tests could crash on Win32 due to a Windows bug, and separately due
  71 to the CRT throwing an exception if the locale name wasn't validly encoded in
  72 the current code page.
  73
  74 For the second we now decode the locale name ourselves, and always decode it as
  75 UTF-8.
  76
  77 L<[perl #16922]|https://github.com/perl/perl5/issues/16922>
  78
  79 =back
  80
  81 =head1 Selected Bug Fixes
  82
  83 =over 4
  84
  85 =item *
  86
  87 Setting C<$)> now properly sets supplementary group ids, if you have the
  88 necessary privileges.
  89 L<[perl #17031]|https://github.com/perl/perl5/issues/17031>
  90
  91 =item *
  92
  93 C<readline @foo> now evaluates C<@foo> in scalar context.  Previously, it would
  94 be evaluated in list context, and since readline() pops only one argument from
  95 the stack, the stack could underflow, or be left with unexpected values on it.
  96 L<[perl #16929]|https://github.com/perl/perl5/issues/16929>
  97
  98 =item *
  99
 100 sv_gets() now recovers better if the target SV is modified by a signal handler.
 101 L<[perl #16960]|https://github.com/perl/perl5/issues/16960>
 102
 103 =item *
 104
 105 Matching a non-C<SVf_UTF8> string against a regular expression containing
 106 Unicode literals could leak an SV on each match attempt.
 107 L<[perl #17140]|https://github.com/perl/perl5/issues/17140>
 108
 109 =item *
 110
 111 C<< sprintf("%.*a", -10000, $x) >> would cause a buffer overflow due to
 112 mishandling of the negative precision value.
 113 L<[perl #16942]|https://github.com/perl/perl5/issues/16942>
 114
 115 =item *
 116
 117 C<scalar()> on a reference could cause an erroneous assertion failure during
 118 compilation.
 119 L<[perl #16969]|https://github.com/perl/perl5/issues/16969>
 120
 121 =back
 122
 123 =head1 Acknowledgements
 124
 125 Perl 5.30.1 represents approximately 6 months of development since Perl 5.30.0
 126 and contains approximately 4,700 lines of changes across 67 files from 14
 127 authors.
 128
 129 Excluding auto-generated files, documentation and release tools, there were
 130 approximately 910 lines of changes to 20 .pm, .t, .c and .h files.
 131
 132 Perl continues to flourish into its fourth decade thanks to a vibrant community
 133 of users and developers.  The following people are known to have contributed
 134 the improvements that became Perl 5.30.1:
 135
 136 Chris 'BinGOs' Williams, Dan Book, David Mitchell, Hugo van der Sanden, James E
 137 Keenan, Karen Etheridge, Karl Williamson, Manuel Mausz, Max Maischein, Nicolas
 138 R., Sawyer X, Steve Hay, Tom Hukins, Tony Cook.
 139
 140 The list above is almost certainly incomplete as it is automatically generated
 141 from version control history.  In particular, it does not include the names of
 142 the (very much appreciated) contributors who reported issues to the Perl bug
 143 tracker.
 144
 145 Many of the changes included in this version originated in the CPAN modules
 146 included in Perl's core.  We're grateful to the entire CPAN community for
 147 helping Perl to flourish.
 148
 149 For a more complete list of all of Perl's historical contributors, please see
 150 the F<AUTHORS> file in the Perl source distribution.
 151
 152 =head1 Reporting Bugs
 153
 154 If you find what you think is a bug, you might check the perl bug database at
 155 L<https://rt.perl.org/>.  There may also be information at
 156 L<http://www.perl.org/>, the Perl Home Page.
 157
 158 If you believe you have an unreported bug, please run the L<perlbug> program
 159 included with your release.  Be sure to trim your bug down to a tiny but
 160 sufficient test case.  Your bug report, along with the output of C<perl -V>,
 161 will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
 162
 163 If the bug you are reporting has security implications which make it
 164 inappropriate to send to a publicly archived mailing list, then see
 165 L<perlsec/SECURITY VULNERABILITY CONTACT INFORMATION> for details of how to
 166 report the issue.
 167
 168 =head1 Give Thanks
 169
 170 If you wish to thank the Perl 5 Porters for the work we had done in Perl 5, you
 171 can do so by running the C<perlthanks> program:
 172
 173     perlthanks
 174
 175 This will send an email to the Perl 5 Porters list with your show of thanks.
 176
 177 =head1 SEE ALSO
 178
 179 The F<Changes> file for an explanation of how to view exhaustive details on
 180 what changed.
 181
 182 The F<INSTALL> file for how to build Perl.
 183
 184 The F<README> file for general stuff.
 185
 186 The F<Artistic> and F<Copying> files for copyright information.
 187
 188 =cut