Debian Codegraph @

upstream/debian-unstable/man1/perl5262delta.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 "PERL5262DELTA 1"
58 .TH PERL5262DELTA 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 perl5262delta \- what is new for perl v5.26.2
65 .SH DESCRIPTION
66 .IX Header "DESCRIPTION"
67 This document describes differences between the 5.26.1 release and the 5.26.2
68 release.
69 .PP
70 If you are upgrading from an earlier release such as 5.26.0, first read
71 perl5261delta, which describes differences between 5.26.0 and 5.26.1.
72 .SH Security
73 .IX Header "Security"
74 .SS "[CVE\-2018\-6797] heap-buffer-overflow (WRITE of size 1) in S_regatom (regcomp.c)"
75 .IX Subsection "[CVE-2018-6797] heap-buffer-overflow (WRITE of size 1) in S_regatom (regcomp.c)"
76 A crafted regular expression could cause a heap buffer write overflow, with
77 control over the bytes written.
78 [GH #16185] <https://github.com/Perl/perl5/issues/16185>
79 .SS "[CVE\-2018\-6798] Heap-buffer-overflow in Perl_\|_byte_dump_string (utf8.c)"
80 .IX Subsection "[CVE-2018-6798] Heap-buffer-overflow in Perl__byte_dump_string (utf8.c)"
81 Matching a crafted locale dependent regular expression could cause a heap
82 buffer read overflow and potentially information disclosure.
83 [GH #16143] <https://github.com/Perl/perl5/issues/16143>
84 .SS "[CVE\-2018\-6913] heap-buffer-overflow in S_pack_rec"
85 .IX Subsection "[CVE-2018-6913] heap-buffer-overflow in S_pack_rec"
86 \&\f(CWpack()\fR could cause a heap buffer write overflow with a large item count.
87 [GH #16098] <https://github.com/Perl/perl5/issues/16098>
88 .SS "Assertion failure in Perl_\|_core_swash_init (utf8.c)"
89 .IX Subsection "Assertion failure in Perl__core_swash_init (utf8.c)"
90 Control characters in a supposed Unicode property name could cause perl to
91 crash. This has been fixed.
92 [perl #132055] <https://rt.perl.org/Public/Bug/Display.html?id=132055>
93 [perl #132553] <https://rt.perl.org/Public/Bug/Display.html?id=132553>
94 [perl #132658] <https://rt.perl.org/Public/Bug/Display.html?id=132658>
95 .SH "Incompatible Changes"
96 .IX Header "Incompatible Changes"
97 There are no changes intentionally incompatible with 5.26.1. 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 Module::CoreList has been upgraded from version 5.20170922_26 to 5.20180414_26.
106 .IP \(bu 4
107 PerlIO::via has been upgraded from version 0.16 to 0.17.
108 .IP \(bu 4
109 Term::ReadLine has been upgraded from version 1.16 to 1.17.
110 .IP \(bu 4
111 Unicode::UCD has been upgraded from version 0.68 to 0.69.
112 .SH Documentation
113 .IX Header "Documentation"
114 .SS "Changes to Existing Documentation"
115 .IX Subsection "Changes to Existing Documentation"
116 \fIperluniprops\fR
117 .IX Subsection "perluniprops"
118 .IP \(bu 4
119 This has been updated to note that \f(CW\*(C`\ep{Word}\*(C'\fR now includes code points
120 matching the \f(CW\*(C`\ep{Join_Control}\*(C'\fR property. The change to the property was made
121 in Perl 5.18, but not documented until now. There are currently only two code
122 points that match this property: U+200C (ZERO WIDTH NON-JOINER) and U+200D
123 (ZERO WIDTH JOINER).
124 .SH "Platform Support"
125 .IX Header "Platform Support"
126 .SS "Platform-Specific Notes"
127 .IX Subsection "Platform-Specific Notes"
128 .IP Windows 4
129 .IX Item "Windows"
130 Visual C++ compiler version detection has been improved to work on non-English
131 language systems.
132 [GH #16235] <https://github.com/Perl/perl5/issues/16235>
133 .Sp
134 We now set \f(CW$Config{libpth}\fR correctly for 64\-bit builds using Visual C++
135 versions earlier than 14.1.
136 [GH #16269] <https://github.com/Perl/perl5/issues/16269>
137 .SH "Selected Bug Fixes"
138 .IX Header "Selected Bug Fixes"
139 .IP \(bu 4
140 The \f(CWreadpipe()\fR built-in function now checks at compile time that it has only
141 one parameter expression, and puts it in scalar context, thus ensuring that it
142 doesn't corrupt the stack at runtime.
143 [GH #2793] <https://github.com/Perl/perl5/issues/2793>
144 .IP \(bu 4
145 Fixed a use after free bug in \f(CW\*(C`pp_list\*(C'\fR introduced in Perl 5.27.1.
146 [GH #16124] <https://github.com/Perl/perl5/issues/16124>
147 .IP \(bu 4
148 Parsing a \f(CW\*(C`sub\*(C'\fR definition could cause a use after free if the \f(CW\*(C`sub\*(C'\fR keyword
149 was followed by whitespace including newlines (and comments).
150 [GH #16097] <https://github.com/Perl/perl5/issues/16097>
151 .IP \(bu 4
152 The tokenizer now correctly adjusts a parse pointer when skipping whitespace in
153 an \f(CW\*(C` ${identifier} \*(C'\fR construct.
154 [perl #131949] <https://rt.perl.org/Public/Bug/Display.html?id=131949>
155 .IP \(bu 4
156 Accesses to \f(CW\*(C`${^LAST_FH}\*(C'\fR no longer assert after using any of a variety of I/O
157 operations on a non-glob.
158 [GH #15372] <https://github.com/Perl/perl5/issues/15372>
159 .IP \(bu 4
160 \&\f(CW\*(C`sort\*(C'\fR now performs correct reference counting when aliasing \f(CW$a\fR and \f(CW$b\fR,
161 thus avoiding premature destruction and leakage of scalars if they are
162 re-aliased during execution of the sort comparator.
163 [GH #11422] <https://github.com/Perl/perl5/issues/11422>
164 .IP \(bu 4
165 Some convoluted kinds of regexp no longer cause an arithmetic overflow when
166 compiled.
167 [GH #16113] <https://github.com/Perl/perl5/issues/16113>
168 .IP \(bu 4
169 Fixed a duplicate symbol failure with \fB\-flto \-mieee\-fp\fR builds. \fIpp.c\fR
170 defined \f(CW\*(C`_LIB_VERSION\*(C'\fR which \fB\-lieee\fR already defines.
171 [GH #16086] <https://github.com/Perl/perl5/issues/16086>
172 .IP \(bu 4
173 A NULL pointer dereference in the \f(CWS_regmatch()\fR function has been fixed.
174 [perl #132017] <https://rt.perl.org/Public/Bug/Display.html?id=132017>
175 .IP \(bu 4
176 Failures while compiling code within other constructs, such as with string
177 interpolation and the right part of \f(CW\*(C`s///e\*(C'\fR now cause compilation to abort
178 earlier.
179 .Sp
180 Previously compilation could continue in order to report other errors, but the
181 failed sub-parse could leave partly parsed constructs on the parser
182 shift-reduce stack, confusing the parser, leading to perl crashes.
183 [GH #14739] <https://github.com/Perl/perl5/issues/14739>
184 .SH Acknowledgements
185 .IX Header "Acknowledgements"
186 Perl 5.26.2 represents approximately 7 months of development since Perl 5.26.1
187 and contains approximately 3,300 lines of changes across 82 files from 17
188 authors.
189 .PP
190 Excluding auto-generated files, documentation and release tools, there were
191 approximately 1,800 lines of changes to 36 .pm, .t, .c and .h files.
192 .PP
193 Perl continues to flourish into its third decade thanks to a vibrant community
194 of users and developers. The following people are known to have contributed
195 the improvements that became Perl 5.26.2:
196 .PP
197 Aaron Crane, Abigail, Chris 'BinGOs' Williams, H.Merijn Brand, James E Keenan,
198 Jarkko Hietaniemi, John SJ Anderson, Karen Etheridge, Karl Williamson, Lukas
199 Mai, Renee Baecker, Sawyer X, Steve Hay, Todd Rinaldo, Tony Cook, Yves Orton,
200 Zefram.
201 .PP
202 The list above is almost certainly incomplete as it is automatically generated
203 from version control history. In particular, it does not include the names of
204 the (very much appreciated) contributors who reported issues to the Perl bug
205 tracker.
206 .PP
207 Many of the changes included in this version originated in the CPAN modules
208 included in Perl's core. We're grateful to the entire CPAN community for
209 helping Perl to flourish.
210 .PP
211 For a more complete list of all of Perl's historical contributors, please see
212 the \fIAUTHORS\fR file in the Perl source distribution.
213 .SH "Reporting Bugs"
214 .IX Header "Reporting Bugs"
215 If you find what you think is a bug, you might check the perl bug database
216 at <https://rt.perl.org/> . There may also be information at
217 <http://www.perl.org/> , the Perl Home Page.
218 .PP
219 If you believe you have an unreported bug, please run the perlbug program
220 included with your release. Be sure to trim your bug down to a tiny but
221 sufficient test case. Your bug report, along with the output of \f(CW\*(C`perl \-V\*(C'\fR,
222 will be sent off to [email protected] to be analysed by the Perl porting team.
223 .PP
224 If the bug you are reporting has security implications which make it
225 inappropriate to send to a publicly archived mailing list, then see
226 "SECURITY VULNERABILITY CONTACT INFORMATION" in perlsec
227 for details of how to report the issue.
228 .SH "Give Thanks"
229 .IX Header "Give Thanks"
230 If you wish to thank the Perl 5 Porters for the work we had done in Perl 5,
231 you can do so by running the \f(CW\*(C`perlthanks\*(C'\fR program:
232 .PP
233 .Vb 1
234 \& perlthanks
235 .Ve
236 .PP
237 This will send an email to the Perl 5 Porters list with your show of thanks.
238 .SH "SEE ALSO"
239 .IX Header "SEE ALSO"
240 The \fIChanges\fR file for an explanation of how to view exhaustive details on
241 what changed.
242 .PP
243 The \fIINSTALL\fR file for how to build Perl.
244 .PP
245 The \fIREADME\fR file for general stuff.
246 .PP
247 The \fIArtistic\fR and \fICopying\fR files for copyright information.