Debian Codegraph @

upstream/debian-unstable/man1/perl5261delta.1

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