Debian Codegraph @

upstream/opensuse-tumbleweed/man1/perl5122delta.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 "PERL5122DELTA 1"
61 .TH PERL5122DELTA 1 2026-03-09 "perl v5.42.1" "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 perl5122delta \- what is new for perl v5.12.2
68 .SH DESCRIPTION
69 .IX Header "DESCRIPTION"
70 This document describes differences between the 5.12.1 release and
71 the 5.12.2 release.
72 .PP
73 If you are upgrading from an earlier major version, such as 5.10.1,
74 first read perl5120delta, which describes differences between 5.10.0
75 and 5.12.0, as well as perl5121delta, which describes earlier changes
76 in the 5.12 stable release series.
77 .SH "Incompatible Changes"
78 .IX Header "Incompatible Changes"
79 There are no changes intentionally incompatible with 5.12.1. If any exist, they
80 are bugs and reports are welcome.
81 .SH "Core Enhancements"
82 .IX Header "Core Enhancements"
83 Other than the bug fixes listed below, there should be no user\-visible
84 changes to the core language in this release.
85 .SH "Modules and Pragmata"
86 .IX Header "Modules and Pragmata"
87 .SS "New Modules and Pragmata"
88 .IX Subsection "New Modules and Pragmata"
89 This release does not introduce any new modules or pragmata.
90 .SS "Pragmata Changes"
91 .IX Subsection "Pragmata Changes"
92 In the previous release, \f(CW\*(C`no \fR\f(CIVERSION\fR\f(CW;\*(C'\fR statements triggered a bug
93 which could cause feature bundles to be loaded and strict mode to
94 be enabled unintentionally.
95 .SS "Updated Modules"
96 .IX Subsection "Updated Modules"
97 .ie n .IP """Carp""" 4
98 .el .IP \f(CWCarp\fR 4
99 .IX Item "Carp"
100 Upgraded from version 1.16 to 1.17.
101 .Sp
102 Carp now detects incomplete \fBcaller()\fR
103 overrides and avoids using bogus \f(CW@DB::args\fR. To provide backtraces, Carp
104 relies on particular behaviour of the caller built\-in. Carp now detects
105 if other code has overridden this with an incomplete implementation, and
106 modifies its backtrace accordingly. Previously incomplete overrides would
107 cause incorrect values in backtraces (best case), or obscure fatal errors
108 (worst case)
109 .Sp
110 This fixes certain cases of \f(CW\*(C`Bizarre copy of ARRAY\*(C'\fR caused by modules
111 overriding \f(CWcaller()\fR incorrectly.
112 .ie n .IP """CPANPLUS""" 4
113 .el .IP \f(CWCPANPLUS\fR 4
114 .IX Item "CPANPLUS"
115 A patch to \fIcpanp\-run\-perl\fR has been backported from CPANPLUS \f(CW0.9004\fR. This
116 resolves RT #55964 <http://rt.cpan.org/Public/Bug/Display.html?id=55964>
117 and RT #57106 <http://rt.cpan.org/Public/Bug/Display.html?id=57106>, both
118 of which related to failures to install distributions that use
119 \&\f(CW\*(C`Module::Install::DSL\*(C'\fR.
120 .ie n .IP """File::Glob""" 4
121 .el .IP \f(CWFile::Glob\fR 4
122 .IX Item "File::Glob"
123 A regression which caused a failure to find \f(CW\*(C`CORE::GLOBAL::glob\*(C'\fR after
124 loading \f(CW\*(C`File::Glob\*(C'\fR to crash has been fixed. Now, it correctly falls back
125 to external globbing via \f(CW\*(C`pp_glob\*(C'\fR.
126 .ie n .IP """File::Copy""" 4
127 .el .IP \f(CWFile::Copy\fR 4
128 .IX Item "File::Copy"
129 \&\f(CW\*(C`File::Copy::copy(FILE, DIR)\*(C'\fR is now documented.
130 .ie n .IP """File::Spec""" 4
131 .el .IP \f(CWFile::Spec\fR 4
132 .IX Item "File::Spec"
133 Upgraded from version 3.31 to 3.31_01.
134 .Sp
135 Several portability fixes were made in \f(CW\*(C`File::Spec::VMS\*(C'\fR: a colon is now
136 recognized as a delimiter in native filespecs; caret\-escaped delimiters are
137 recognized for better handling of extended filespecs; \f(CWcatpath()\fR returns
138 an empty directory rather than the current directory if the input directory
139 name is empty; \f(CWabs2rel()\fR properly handles Unix\-style input.
140 .SH "Utility Changes"
141 .IX Header "Utility Changes"
142 .IP \(bu 4
143 \&\fIperlbug\fR now always gives the reporter a chance to change the email address it
144 guesses for them.
145 .IP \(bu 4
146 \&\fIperlbug\fR should no longer warn about uninitialized values when using the \f(CW\*(C`\-d\*(C'\fR
147 and \f(CW\*(C`\-v\*(C'\fR options.
148 .SH "Changes to Existing Documentation"
149 .IX Header "Changes to Existing Documentation"
150 .IP \(bu 4
151 The existing policy on backward\-compatibility and deprecation has
152 been added to perlpolicy, along with definitions of terms like
153 \&\fIdeprecation\fR.
154 .IP \(bu 4
155 "srand" in perlfunc\*(Aqs usage has been clarified.
156 .IP \(bu 4
157 The entry for "die" in perlfunc was reorganized to emphasize its
158 role in the exception mechanism.
159 .IP \(bu 4
160 Perl\*(Aqs \fIINSTALL\fR file has been clarified to explicitly state that Perl
161 requires a C89 compliant ANSI C Compiler.
162 .IP \(bu 4
163 IO::Socket\*(Aqs \f(CWgetsockopt()\fR and \f(CWsetsockopt()\fR have been documented.
164 .IP \(bu 4
165 \&\fR\f(BIalarm()\fR\fI\fR\*(Aqs inability to interrupt blocking IO on Windows has been documented.
166 .IP \(bu 4
167 Math::TrulyRandom hasn\*(Aqt been updated since 1996 and has been removed
168 as a recommended solution for random number generation.
169 .IP \(bu 4
170 perlrun has been updated to clarify the behaviour of octal flags to \fIperl\fR.
171 .IP \(bu 4
172 To ease user confusion, \f(CW$#\fR and \f(CW$*\fR, two special variables that were
173 removed in earlier versions of Perl have been documented.
174 .IP \(bu 4
175 The version of perlfaq shipped with the Perl core has been updated from the
176 official FAQ version, which is now maintained in the \f(CW\*(C`briandfoy/perlfaq\*(C'\fR
177 branch of the Perl repository at <git://perl5.git.perl.org/perl.git>.
178 .SH "Installation and Configuration Improvements"
179 .IX Header "Installation and Configuration Improvements"
180 .SS "Configuration improvements"
181 .IX Subsection "Configuration improvements"
182 .IP \(bu 4
183 The \f(CW\*(C`d_u32align\*(C'\fR configuration probe on ARM has been fixed.
184 .SS "Compilation improvements"
185 .IX Subsection "Compilation improvements"
186 .IP \(bu 4
187 An "\f(CW\*(C`incompatible operand types\*(C'\fR" error in ternary expressions when building
188 with \f(CW\*(C`clang\*(C'\fR has been fixed.
189 .IP \(bu 4
190 Perl now skips setuid \f(CW\*(C`File::Copy\*(C'\fR tests on partitions it detects to be mounted
191 as \f(CW\*(C`nosuid\*(C'\fR.
192 .SH "Selected Bug Fixes"
193 .IX Header "Selected Bug Fixes"
194 .IP \(bu 4
195 A possible segfault in the \f(CW\*(C`T_PRTOBJ\*(C'\fR default typemap has been fixed.
196 .IP \(bu 4
197 A possible memory leak when using \fBcaller()\fR to set
198 \&\f(CW@DB::args\fR has been fixed.
199 .IP \(bu 4
200 Several memory leaks when loading XS modules were fixed.
201 .IP \(bu 4
202 \&\f(CWunpack()\fR now handles scalar context correctly for \f(CW%32H\fR and \f(CW%32u\fR,
203 fixing a potential crash. \f(CWsplit()\fR would crash because the third item
204 on the stack wasn\*(Aqt the regular expression it expected. \f(CW\*(C`unpack("%2H",
205 \&...)\*(C'\fR would return both the unpacked result and the checksum on the stack,
206 as would \f(CW\*(C`unpack("%2u", ...)\*(C'\fR.
207 [GH #10257] <https://github.com/Perl/perl5/issues/10257>
208 .IP \(bu 4
209 Perl now avoids using memory after calling \f(CWfree()\fR in \fIpp_require\fR
210 when there are CODEREFs in \f(CW@INC\fR.
211 .IP \(bu 4
212 A bug that could cause "\f(CW\*(C`Unknown error\*(C'\fR" messages when
213 "\f(CW\*(C`call_sv(code, G_EVAL)\*(C'\fR" is called from an XS destructor has been fixed.
214 .IP \(bu 4
215 The implementation of the \f(CW\*(C`open $fh, \*(Aq>\*(Aq \e$buffer\*(C'\fR feature
216 now supports get/set magic and thus tied buffers correctly.
217 .IP \(bu 4
218 The \f(CW\*(C`pp_getc\*(C'\fR, \f(CW\*(C`pp_tell\*(C'\fR, and \f(CW\*(C`pp_eof\*(C'\fR opcodes now make room on the
219 stack for their return values in cases where no argument was passed in.
220 .IP \(bu 4
221 When matching Unicode strings under some conditions inappropriate backtracking would
222 result in a \f(CW\*(C`Malformed UTF\-8 character (fatal)\*(C'\fR error. This should no longer occur.
223 See [GH #10434] <https://github.com/Perl/perl5/issues/10434>
224 .SH "Platform Specific Notes"
225 .IX Header "Platform Specific Notes"
226 .SS AIX
227 .IX Subsection "AIX"
228 .IP \(bu 4
229 \&\fIREADME.aix\fR has been updated with information about the XL C/C++ V11 compiler
230 suite.
231 .SS Windows
232 .IX Subsection "Windows"
233 .IP \(bu 4
234 When building Perl with the mingw64 x64 cross\-compiler \f(CW\*(C`incpath\*(C'\fR,
235 \&\f(CW\*(C`libpth\*(C'\fR, \f(CW\*(C`ldflags\*(C'\fR, \f(CW\*(C`lddlflags\*(C'\fR and \f(CW\*(C`ldflags_nolargefiles\*(C'\fR values
236 in \fIConfig.pm\fR and \fIConfig_heavy.pl\fR were not previously being set
237 correctly because, with that compiler, the include and lib directories
238 are not immediately below \f(CW\*(C`$(CCHOME)\*(C'\fR.
239 .SS VMS
240 .IX Subsection "VMS"
241 .IP \(bu 4
242 \&\fIgit_version.h\fR is now installed on VMS. This was an oversight in v5.12.0 which
243 caused some extensions to fail to build.
244 .IP \(bu 4
245 Several memory leaks in \fBstat()\fR have been fixed.
246 .IP \(bu 4
247 A memory leak in \f(CWPerl_rename()\fR due to a double allocation has been
248 fixed.
249 .IP \(bu 4
250 A memory leak in \f(CWvms_fid_to_name()\fR (used by \f(CWrealpath()\fR and
251 \&\f(CWrealname()\fR) has been fixed.
252 .SH Acknowledgements
253 .IX Header "Acknowledgements"
254 Perl 5.12.2 represents approximately three months of development since
255 Perl 5.12.1 and contains approximately 2,000 lines of changes across
256 100 files from 36 authors.
257 .PP
258 Perl continues to flourish into its third decade thanks to a vibrant
259 community of users and developers. The following people are known to
260 have contributed the improvements that became Perl 5.12.2:
261 .PP
262 Abigail, Ævar Arnfjörð Bjarmason, Ben Morrow, brian d foy, Brian
263 Phillips, Chas. Owens, Chris \*(AqBinGOs\*(Aq Williams, Chris Williams,
264 Craig A. Berry, Curtis Jewell, Dan Dascalescu, David Golden, David
265 Mitchell, Father Chrysostomos, Florian Ragwitz, George Greer, H.Merijn
266 Brand, Jan Dubois, Jesse Vincent, Jim Cromie, Karl Williamson, Lars
267 Dɪᴇᴄᴋᴏᴡ 迪拉斯, Leon Brocard, Maik Hentsche, Matt S Trout,
268 Nicholas Clark, Rafael Garcia\-Suarez, Rainer Tammer, Ricardo Signes,
269 Salvador Ortiz Garcia, Sisyphus, Slaven Rezic, Steffen Mueller, Tony Cook,
270 Vincent Pit and Yves Orton.
271 .SH "Reporting Bugs"
272 .IX Header "Reporting Bugs"
273 If you find what you think is a bug, you might check the articles
274 recently posted to the comp.lang.perl.misc newsgroup and the perl
275 bug database at http://rt.perl.org/perlbug/ . There may also be
276 information at http://www.perl.org/ , the Perl Home Page.
277 .PP
278 If you believe you have an unreported bug, please run the \fBperlbug\fR
279 program included with your release. Be sure to trim your bug down
280 to a tiny but sufficient test case. Your bug report, along with the
281 output of \f(CW\*(C`perl \-V\*(C'\fR, will be sent off to [email protected] to be
282 analysed by the Perl porting team.
283 .PP
284 If the bug you are reporting has security implications, which make it
285 inappropriate to send to a publicly archived mailing list, then please send
286 it to perl5\-security\[email protected]. This points to a closed subscription
287 unarchived mailing list, which includes
288 all the core committers, who will be able
289 to help assess the impact of issues, figure out a resolution, and help
290 co\-ordinate the release of patches to mitigate or fix the problem across all
291 platforms on which Perl is supported. Please only use this address for
292 security issues in the Perl core, not for modules independently
293 distributed on CPAN.
294 .SH "SEE ALSO"
295 .IX Header "SEE ALSO"
296 The \fIChanges\fR file for an explanation of how to view exhaustive details
297 on what changed.
298 .PP
299 The \fIINSTALL\fR file for how to build Perl.
300 .PP
301 The \fIREADME\fR file for general stuff.
302 .PP
303 The \fIArtistic\fR and \fICopying\fR files for copyright information.