Debian Codegraph @

upstream/mageia-cauldron/man1/perl5261delta.1

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
3 .\"
4 .\" Standard preamble:
5 .\" ========================================================================
6 .de Sp \" Vertical space (when we can't use .PP)
7 .if t .sp .5v
8 .if n .sp
9 ..
10 .de Vb \" Begin verbatim text
11 .ft CW
12 .nf
13 .ne \\$1
14 ..
15 .de Ve \" End verbatim text
16 .ft R
17 .fi
18 ..
19 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20 .ie n \{\
21 . ds C` ""
22 . ds C' ""
23 'br\}
24 .el\{\
25 . ds C`
26 . ds C'
27 'br\}
28 .\"
29 .\" Escape single quotes in literal strings from groff's Unicode transform.
30 .ie \n(.g .ds Aq \(aq
31 .el .ds Aq '
32 .\"
33 .\" If the F register is >0, we'll generate index entries on stderr for
34 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35 .\" entries marked with X<> in POD. Of course, you'll have to process the
36 .\" output yourself in some meaningful fashion.
37 .\"
38 .\" Avoid warning from groff about undefined register 'F'.
39 .de IX
40 ..
41 .nr rF 0
42 .if \n(.g .if rF .nr rF 1
43 .if (\n(rF:(\n(.g==0)) \{\
44 . if \nF \{\
45 . de IX
46 . tm Index:\\$1\t\\n%\t"\\$2"
47 ..
48 . if !\nF==2 \{\
49 . nr % 0
50 . nr F 2
51 . \}
52 . \}
53 .\}
54 .rr rF
55 .\"
56 .\" Required to disable full justification in groff 1.23.0.
57 .if n .ds AD l
58 .\" ========================================================================
59 .\"
60 .IX Title "PERL5261DELTA 1"
61 .TH PERL5261DELTA 1 2023-12-22 "perl v5.42.0" "Perl Programmers Reference Guide"
62 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
63 .\" way too many mistakes in technical documents.
64 .if n .ad l
65 .nh
66 .SH NAME
67 perl5261delta \- what is new for perl v5.26.1
68 .SH DESCRIPTION
69 .IX Header "DESCRIPTION"
70 This document describes differences between the 5.26.0 release and the 5.26.1
71 release.
72 .PP
73 If you are upgrading from an earlier release such as 5.24.0, first read
74 perl5260delta, which describes differences between 5.24.0 and 5.26.0.
75 .SH Security
76 .IX Header "Security"
77 .SS "[CVE\-2017\-12837] Heap buffer overflow in regular expression compiler"
78 .IX Subsection "[CVE-2017-12837] Heap buffer overflow in regular expression compiler"
79 Compiling certain regular expression patterns with the case\-insensitive
80 modifier could cause a heap buffer overflow and crash perl. This has now been
81 fixed.
82 [GH #16021] <https://github.com/Perl/perl5/issues/16021>
83 .SS "[CVE\-2017\-12883] Buffer over\-read in regular expression parser"
84 .IX Subsection "[CVE-2017-12883] Buffer over-read in regular expression parser"
85 For certain types of syntax error in a regular expression pattern, the error
86 message could either contain the contents of a random, possibly large, chunk of
87 memory, or could crash perl. This has now been fixed.
88 [GH #16025] <https://github.com/Perl/perl5/issues/16025>
89 .ie n .SS "[CVE\-2017\-12814] $ENV{$key} stack buffer overflow on Windows"
90 .el .SS "[CVE\-2017\-12814] \f(CW$ENV{$key}\fP stack buffer overflow on Windows"
91 .IX Subsection "[CVE-2017-12814] $ENV{$key} stack buffer overflow on Windows"
92 A possible stack buffer overflow in the \f(CW%ENV\fR code on Windows has been fixed
93 by removing the buffer completely since it was superfluous anyway.
94 [GH #16051] <https://github.com/Perl/perl5/issues/16051>
95 .SH "Incompatible Changes"
96 .IX Header "Incompatible Changes"
97 There are no changes intentionally incompatible with 5.26.0. If any exist,
98 they are bugs, and we request that you submit a report. See "Reporting
99 Bugs" below.
100 .SH "Modules and Pragmata"
101 .IX Header "Modules and Pragmata"
102 .SS "Updated Modules and Pragmata"
103 .IX Subsection "Updated Modules and Pragmata"
104 .IP \(bu 4
105 base has been upgraded from version 2.25 to 2.26.
106 .Sp
107 The effects of dotless \f(CW@INC\fR on this module have been limited by the
108 introduction of a more refined and accurate solution for removing \f(CW\*(Aq.\*(Aq\fR from
109 \&\f(CW@INC\fR while reducing the false positives.
110 .IP \(bu 4
111 charnames has been upgraded from version 1.44 to 1.45.
112 .IP \(bu 4
113 Module::CoreList has been upgraded from version 5.20170530 to 5.20170922_26.
114 .SH "Platform Support"
115 .IX Header "Platform Support"
116 .SS "Platform\-Specific Notes"
117 .IX Subsection "Platform-Specific Notes"
118 .IP FreeBSD 4
119 .IX Item "FreeBSD"
120 .RS 4
121 .PD 0
122 .IP \(bu 4
123 .PD
124 Building with \fBg++\fR on FreeBSD\-11.0 has been fixed.
125 [GH #15984] <https://github.com/Perl/perl5/issues/15984>
126 .RE
127 .RS 4
128 .RE
129 .IP Windows 4
130 .IX Item "Windows"
131 .RS 4
132 .PD 0
133 .IP \(bu 4
134 .PD
135 Support for compiling perl on Windows using Microsoft Visual Studio 2017
136 (containing Visual C++ 14.1) has been added.
137 .IP \(bu 4
138 Building XS modules with GCC 6 in a 64\-bit build of Perl failed due to
139 incorrect mapping of \f(CW\*(C`strtoll\*(C'\fR and \f(CW\*(C`strtoull\*(C'\fR. This has now been fixed.
140 [GH #16074] <https://github.com/Perl/perl5/issues/16074>
141 [cpan #121683] <https://rt.cpan.org/Public/Bug/Display.html?id=121683>
142 [cpan #122353] <https://rt.cpan.org/Public/Bug/Display.html?id=122353>
143 .RE
144 .RS 4
145 .RE
146 .SH "Selected Bug Fixes"
147 .IX Header "Selected Bug Fixes"
148 .IP \(bu 4
149 Several built\-in functions previously had bugs that could cause them to write
150 to the internal stack without allocating room for the item being written. In
151 rare situations, this could have led to a crash. These bugs have now been
152 fixed, and if any similar bugs are introduced in future, they will be detected
153 automatically in debugging builds.
154 [GH #16076] <https://github.com/Perl/perl5/issues/16076>
155 .IP \(bu 4
156 Using a symbolic ref with postderef syntax as the key in a hash lookup was
157 yielding an assertion failure on debugging builds.
158 [GH #16029] <https://github.com/Perl/perl5/issues/16029>
159 .IP \(bu 4
160 List assignment (\f(CW\*(C`aassign\*(C'\fR) could in some rare cases allocate an entry on the
161 mortal stack and leave the entry uninitialized.
162 [GH #16017] <https://github.com/Perl/perl5/issues/16017>
163 .IP \(bu 4
164 Attempting to apply an attribute to an \f(CW\*(C`our\*(C'\fR variable where a function of that
165 name already exists could result in a NULL pointer being supplied where an SV
166 was expected, crashing perl.
167 [perl #131597] <https://rt.perl.org/Public/Bug/Display.html?id=131597>
168 .IP \(bu 4
169 The code that vivifies a typeglob out of a code ref made some false assumptions
170 that could lead to a crash in cases such as \f(CW\*(C`$::{"A"} = sub {}; \e&{"A"}\*(C'\fR.
171 This has now been fixed.
172 [GH #15937] <https://github.com/Perl/perl5/issues/15937>
173 .IP \(bu 4
174 \&\f(CW\*(C`my_atof2\*(C'\fR no longer reads beyond the terminating NUL, which previously
175 occurred if the decimal point is immediately before the NUL.
176 [GH #16002] <https://github.com/Perl/perl5/issues/16002>
177 .IP \(bu 4
178 Occasional "Malformed UTF\-8 character" crashes in \f(CW\*(C`s//\*(C'\fR on utf8 strings have
179 been fixed.
180 [GH #16019] <https://github.com/Perl/perl5/issues/16019>
181 .IP \(bu 4
182 \&\f(CW\*(C`perldoc \-f s\*(C'\fR now finds \f(CW\*(C`s///\*(C'\fR.
183 [GH #15989] <https://github.com/Perl/perl5/issues/15989>
184 .IP \(bu 4
185 Some erroneous warnings after utf8 conversion have been fixed.
186 [GH #15958] <https://github.com/Perl/perl5/issues/15958>
187 .IP \(bu 4
188 The \f(CW\*(C`jmpenv\*(C'\fR frame to catch Perl exceptions is set up lazily, and this used to
189 be a bit too lazy. The catcher is now set up earlier, preventing some possible
190 crashes.
191 [GH #11804] <https://github.com/Perl/perl5/issues/11804>
192 .IP \(bu 4
193 Spurious "Assuming NOT a POSIX class" warnings have been removed.
194 [GH #16001] <https://github.com/Perl/perl5/issues/16001>
195 .SH Acknowledgements
196 .IX Header "Acknowledgements"
197 Perl 5.26.1 represents approximately 4 months of development since Perl 5.26.0
198 and contains approximately 8,900 lines of changes across 85 files from 23
199 authors.
200 .PP
201 Excluding auto\-generated files, documentation and release tools, there were
202 approximately 990 lines of changes to 38 .pm, .t, .c and .h files.
203 .PP
204 Perl continues to flourish into its third decade thanks to a vibrant community
205 of users and developers. The following people are known to have contributed
206 the improvements that became Perl 5.26.1:
207 .PP
208 Aaron Crane, Andy Dougherty, Aristotle Pagaltzis, Chris \*(AqBinGOs\*(Aq Williams,
209 Craig A. Berry, Dagfinn Ilmari Mannsåker, David Mitchell, E. Choroba, Eric
210 Herman, Father Chrysostomos, Jacques Germishuys, James E Keenan, John SJ
211 Anderson, Karl Williamson, Ken Brown, Lukas Mai, Matthew Horsfall, Ricardo
212 Signes, Sawyer X, Steve Hay, Tony Cook, Yves Orton, Zefram.
213 .PP
214 The list above is almost certainly incomplete as it is automatically generated
215 from version control history. In particular, it does not include the names of
216 the (very much appreciated) contributors who reported issues to the Perl bug
217 tracker.
218 .PP
219 Many of the changes included in this version originated in the CPAN modules
220 included in Perl\*(Aqs core. We\*(Aqre grateful to the entire CPAN community for
221 helping Perl to flourish.
222 .PP
223 For a more complete list of all of Perl\*(Aqs historical contributors, please see
224 the \fIAUTHORS\fR file in the Perl source distribution.
225 .SH "Reporting Bugs"
226 .IX Header "Reporting Bugs"
227 If you find what you think is a bug, you might check the perl bug database
228 at <https://rt.perl.org/> . There may also be information at
229 <http://www.perl.org/> , the Perl Home Page.
230 .PP
231 If you believe you have an unreported bug, please run the perlbug program
232 included with your release. Be sure to trim your bug down to a tiny but
233 sufficient test case. Your bug report, along with the output of \f(CW\*(C`perl \-V\*(C'\fR,
234 will be sent off to [email protected] to be analysed by the Perl porting team.
235 .PP
236 If the bug you are reporting has security implications which make it
237 inappropriate to send to a publicly archived mailing list, then see
238 "SECURITY VULNERABILITY CONTACT INFORMATION" in perlsec for details of how to
239 report the issue.
240 .SH "Give Thanks"
241 .IX Header "Give Thanks"
242 If you wish to thank the Perl 5 Porters for the work we had done in Perl 5, you
243 can do so by running the \f(CW\*(C`perlthanks\*(C'\fR program:
244 .PP
245 .Vb 1
246 \& perlthanks
247 .Ve
248 .PP
249 This will send an email to the Perl 5 Porters list with your show of thanks.
250 .SH "SEE ALSO"
251 .IX Header "SEE ALSO"
252 The \fIChanges\fR file for an explanation of how to view exhaustive details on
253 what changed.
254 .PP
255 The \fIINSTALL\fR file for how to build Perl.
256 .PP
257 The \fIREADME\fR file for general stuff.
258 .PP
259 The \fIArtistic\fR and \fICopying\fR files for copyright information.