Commit | Line | Data |
---|---|---|
9f26aead SH |
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 | ||
90f6751c KT |
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. | |
9f26aead SH |
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 |