Debian Codegraph @

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