This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Reapply "docs: clarify effect of $^H, %^H, ${^WARNING_BITS}"
[perl5.git] / pod / perl5352delta.pod
1 =encoding utf8
2
3 =head1 NAME
4
5 perl5352delta - what is new for perl v5.35.2
6
7 =head1 DESCRIPTION
8
9 This document describes differences between the 5.35.1 release and the 5.35.2
10 release.
11
12 If you are upgrading from an earlier release such as 5.35.0, first read
13 L<perl5351delta>, which describes differences between 5.35.0 and 5.35.1.
14
15
16
17
18 =head1 Modules and Pragmata
19
20
21 =head2 Updated Modules and Pragmata
22
23 =over 4
24
25 =item *
26
27 L<B::Concise> has been upgraded from version 1.004 to 1.005.
28
29 =item *
30
31 L<bignum> has been upgraded from version 0.51 to 0.53.
32
33 =item *
34
35 L<Data::Dumper> has been upgraded from version 2.181 to 2.183.
36
37 =item *
38
39 L<DB_File> has been upgraded from version 1.855 to 1.856.
40
41 =item *
42
43 L<Devel::Peek> has been upgraded from version 1.30 to 1.31.
44
45 =item *
46
47 L<Devel::PPPort> has been upgraded from version 3.62 to 3.63.
48
49 =item *
50
51 L<DynaLoader> has been upgraded from version 1.50 to 1.51.
52
53 =item *
54
55 L<Encode> has been upgraded from version 3.08 to 3.10.
56
57 =item *
58
59 L<Errno> has been upgraded from version 1.33 to 1.34.
60
61 =item *
62
63 L<ExtUtils::Miniperl> has been upgraded from version 1.10 to 1.11.
64
65 =item *
66
67 L<Fcntl> has been upgraded from version 1.14 to 1.15.
68
69 =item *
70
71 L<File::Find> has been upgraded from version 1.39 to 1.39_01.
72
73 =item *
74
75 L<File::Glob> has been upgraded from version 1.35 to 1.36.
76
77 =item *
78
79 L<File::Spec> has been upgraded from version 3.81 to 3.82.
80
81 =item *
82
83 L<File::stat> has been upgraded from version 1.10 to 1.11.
84
85 =item *
86
87 L<GDBM_File> has been upgraded from version 1.19 to 1.20.
88
89 =item *
90
91 L<Hash::Util> has been upgraded from version 0.25 to 0.26.
92
93 =item *
94
95 L<Hash::Util::FieldHash> has been upgraded from version 1.21 to 1.22.
96
97 =item *
98
99 L<I18N::Langinfo> has been upgraded from version 0.19 to 0.20.
100
101 =item *
102
103 L<if> has been upgraded from version 0.0609 to 0.0610.
104
105 =item *
106
107 L<IPC::Open3> has been upgraded from version 1.21 to 1.22.
108
109 =item *
110
111 L<Math::BigInt> has been upgraded from version 1.999818 to 1.999823.
112
113 Made the C<from_*()> functions consistent with the core C<oct()> function,
114 in not requiring a leading 0 before the letter ("x", "o", or "b").
115
116 Made the from_oct() and new() methods accept octal numbers with prefix
117 "0o", "0O", "o" (lowercase letter o), and "O" (capital letter O).
118 Similarly with "x" and "b" for hexadecimal and binary numbers.
119
120 Improved the handling of the backend libraries.
121 More useful warnings and error messages.
122
123
124 =item *
125
126 L<Math::BigInt::FastCalc> has been upgraded from version 0.5009 to 0.5010.
127
128 Made it possible to specify a smaller base length than the default.
129
130 Updated the SUPPORT information.
131
132 Sync'd test files with Math::BigInt.
133
134 =item *
135
136 L<Math::BigRat> has been upgraded from version 0.2614 to 0.2617.
137
138 C<bnok()> was fixed - it didn't work at all.
139
140 The handling of backend libraries was improved.
141
142 Existing test files were reorganised and more tests added.
143
144 =item *
145
146 L<Module::CoreList> has been upgraded from version 5.20210620 to 5.20210723.
147
148 =item *
149
150 L<Opcode> has been upgraded from version 1.51 to 1.52.
151
152 =item *
153
154 C<perl5db.pl> has been upgraded from version 1.60 to 1.61.
155
156 The C<v> command works again, and now has some tests.
157
158 =item *
159
160 L<PerlIO> has been upgraded from version 1.11 to 1.12.
161
162 =item *
163
164 L<Pod::Functions> has been upgraded from version 1.13 to 1.14.
165
166 =item *
167
168 L<Pod::Html> has been upgraded from version 1.27 to 1.31.
169
170 =item *
171
172 L<Pod::Simple> has been upgraded from version 3.42 to 3.43.
173
174 =item *
175
176 L<Sys::Hostname> has been upgraded from version 1.23 to 1.24.
177
178 =item *
179
180 L<Text::Tabs> has been upgraded from version 2013.0523 to 2021.0717.
181
182 Explicitly declared strictures and warnings everywhere.
183
184 =item *
185
186 L<Text::Wrap> has been upgraded from version 2013.0523 to 2021.0717.
187
188 Explicitly declared strictures and warnings everywhere.
189
190 =item *
191
192 L<threads> has been upgraded from version 2.26 to 2.27.
193
194 =item *
195
196 L<Time::HiRes> has been upgraded from version 1.9767 to 1.9768.
197
198 =item *
199
200 L<Unicode::UCD> has been upgraded from version 0.76 to 0.77.
201
202 =item *
203
204 L<VMS::Filespec> has been upgraded from version 1.12 to 1.13.
205
206 =item *
207
208 L<VMS::Stdio> has been upgraded from version 2.45 to 2.46.
209
210 =item *
211
212 L<warnings> has been upgraded from version 1.51 to 1.52.
213
214 =item *
215
216 L<XSLoader> has been upgraded from version 0.30 to 0.31.
217
218 =back
219
220
221 =head1 Documentation
222
223 =head2 Changes to Existing Documentation
224
225 =head3 L<perlintro>
226
227 =over 4
228
229 =item *
230
231 A number of sentences in L<perlintro> have been simplified,
232 to make things clearer.
233 Ambiguities were resolved, related to "special variables".
234
235 =back
236
237
238 =head1 Platform Support
239
240 The :win32 IO layer has been removed. This experimental replacement for the
241 :unix layer never reached maturity in its nearly two decades of existence.
242
243 =head1 Internal Changes
244
245 =over 4
246
247 =item *
248
249 The API constant formerly named C<G_ARRAY>, indicating list context, has now
250 been renamed to a more accurate C<G_LIST>.  A compatibilty macro C<G_ARRAY> has
251 been added to allow existing code to work unaffected.  New code should be
252 written using the new constant instead.  This is supported by C<Devel::PPPort>
253 version 3.63.
254
255 =back
256
257 =head1 Selected Bug Fixes
258
259 =over 4
260
261 =item *
262
263 The flags on the OPTVAL parameter to setsockopt() were previously
264 checked before magic was called, possibly treating a numeric value as
265 a packed buffer or vice versa.  It also ignored the UTF-8 flag,
266 potentially treating the internal representation of an upgraded SV as
267 the bytes to supply to the setsockopt() system call.  (github L<#18660|https://github.com/Perl/perl5/issues/18660>)
268
269 =item *
270
271 Only set IOKp, not IOK on $) and $(.
272 This was issue L<#18955|https://github.com/Perl/perl5/issues/18955>: This will prevent serializers from serializing these
273 variables as numbers (which loses the additional groups).
274 This restores behaviour from 5.16
275
276 =back
277
278
279 =head1 Acknowledgements
280
281 Perl 5.35.2 represents approximately 5 weeks of development since Perl
282 5.35.1 and contains approximately 27,000 lines of changes across 420 files
283 from 25 authors.
284
285 Excluding auto-generated files, documentation and release tools, there were
286 approximately 14,000 lines of changes to 200 .pm, .t, .c and .h files.
287
288 Perl continues to flourish into its fourth decade thanks to a vibrant
289 community of users and developers. The following people are known to have
290 contributed the improvements that became Perl 5.35.2:
291
292 Atsushi Sugawara, Ben Cornett, Chris 'BinGOs' Williams, Christian Walde
293 (Mithaldu), Craig A. Berry, David Golden, David Marshall, Felipe Gasper,
294 Jakub Wilk, James E Keenan, Karl Williamson, Leam Hall, Leon Timmermans, Max
295 Maischein, Neil Bowers, Nicholas Clark, Paul Evans, Paul Marquess, Richard
296 Leach, Sawyer X, Sergey Poznyakoff, Sven Kirmess, Thibault Duponchelle, Todd
297 Rinaldo, Tony Cook.
298
299 The list above is almost certainly incomplete as it is automatically
300 generated from version control history. In particular, it does not include
301 the names of the (very much appreciated) contributors who reported issues to
302 the Perl bug tracker.
303
304 Many of the changes included in this version originated in the CPAN modules
305 included in Perl's core. We're grateful to the entire CPAN community for
306 helping Perl to flourish.
307
308 For a more complete list of all of Perl's historical contributors, please
309 see the F<AUTHORS> file in the Perl source distribution.
310
311
312 =head1 Reporting Bugs
313
314 If you find what you think is a bug, you might check the perl bug database
315 at L<https://github.com/Perl/perl5/issues>.  There may also be information at
316 L<http://www.perl.org/>, the Perl Home Page.
317
318 If you believe you have an unreported bug, please open an issue at
319 L<https://github.com/Perl/perl5/issues>.  Be sure to trim your bug down to a
320 tiny but sufficient test case.
321
322 If the bug you are reporting has security implications which make it
323 inappropriate to send to a public issue tracker, then see
324 L<perlsec/SECURITY VULNERABILITY CONTACT INFORMATION>
325 for details of how to report the issue.
326
327 =head1 Give Thanks
328
329 If you wish to thank the Perl 5 Porters for the work we had done in Perl 5,
330 you can do so by running the C<perlthanks> program:
331
332     perlthanks
333
334 This will send an email to the Perl 5 Porters list with your show of thanks.
335
336 =head1 SEE ALSO
337
338 The F<Changes> file for an explanation of how to view exhaustive details on
339 what changed.
340
341 The F<INSTALL> file for how to build Perl.
342
343 The F<README> file for general stuff.
344
345 The F<Artistic> and F<Copying> files for copyright information.
346
347 =cut