Debian Codegraph @

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