Debian Codegraph @

upstream/mageia-cauldron/man1/perl5121delta.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 "PERL5121DELTA 1"
61 .TH PERL5121DELTA 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 perl5121delta \- what is new for perl v5.12.1
68 .SH DESCRIPTION
69 .IX Header "DESCRIPTION"
70 This document describes differences between the 5.12.0 release and
71 the 5.12.1 release.
72 .PP
73 If you are upgrading from an earlier release such as 5.10.1, first read
74 perl5120delta, which describes differences between 5.10.0 and
75 5.12.0.
76 .SH "Incompatible Changes"
77 .IX Header "Incompatible Changes"
78 There are no changes intentionally incompatible with 5.12.0. If any
79 incompatibilities with 5.12.0 exist, they are bugs. Please report them.
80 .SH "Core Enhancements"
81 .IX Header "Core Enhancements"
82 Other than the bug fixes listed below, there should be no user\-visible
83 changes to the core language in this release.
84 .SH "Modules and Pragmata"
85 .IX Header "Modules and Pragmata"
86 .SS "Pragmata Changes"
87 .IX Subsection "Pragmata Changes"
88 .IP \(bu 4
89 We fixed exporting of \f(CW\*(C`is_strict\*(C'\fR and \f(CW\*(C`is_lax\*(C'\fR from version.
90 .Sp
91 These were being exported with a wrapper that treated them as method
92 calls, which caused them to fail. They are just functions, are
93 documented as such, and should never be subclassed, so this patch
94 just exports them directly as functions without the wrapper.
95 .SS "Updated Modules"
96 .IX Subsection "Updated Modules"
97 .IP \(bu 4
98 We upgraded CGI to version 3.49 to incorporate fixes for regressions
99 introduced in the release we shipped with Perl 5.12.0.
100 .IP \(bu 4
101 We upgraded Pod::Simple to version 3.14 to get an improvement to \eC\e<\e< \e>\e>
102 parsing.
103 .IP \(bu 4
104 We made a small fix to the CPANPLUS test suite to fix an occasional spurious test failure.
105 .IP \(bu 4
106 We upgraded Safe to version 2.27 to wrap coderefs returned by \f(CWreval()\fR and \f(CWrdo()\fR.
107 .SH "Changes to Existing Documentation"
108 .IX Header "Changes to Existing Documentation"
109 .IP \(bu 4
110 We added the new maintenance release policy to perlpolicy
111 .IP \(bu 4
112 We\*(Aqve clarified the multiple\-angle\-bracket construct in the spec for POD
113 in perlpodspec
114 .IP \(bu 4
115 We added a missing explanation for a warning about \f(CW\*(C`:=\*(C'\fR to perldiag
116 .IP \(bu 4
117 We removed a false claim in perlunitut that all text strings are Unicode strings in Perl.
118 .IP \(bu 4
119 We updated the GitHub mirror link in perlrepository to mirrors/perl, not github/perl
120 .IP \(bu 4
121 We fixed a minor error in perl5114delta.
122 .IP \(bu 4
123 We replaced a mention of the now\-obsolete Switch with \fIgiven\fR/\fIwhen\fR.
124 .IP \(bu 4
125 We improved documentation about \fR\f(CI$sitelibexp\fR\fI/sitecustomize.pl\fR in perlrun.
126 .IP \(bu 4
127 We corrected perlmodlib which had unintentionally omitted a number of modules.
128 .IP \(bu 4
129 We updated the documentation for \*(Aqrequire\*(Aq in perlfunc relating to putting Perl code in \f(CW@INC\fR.
130 .IP \(bu 4
131 We reinstated some erroneously\-removed documentation about quotemeta in perlfunc.
132 .IP \(bu 4
133 We fixed an \fIa2p\fR example in perlutil.
134 .IP \(bu 4
135 We filled in a blank in perlport with the release date of Perl 5.12.
136 .IP \(bu 4
137 We fixed broken links in a number of perldelta files.
138 .IP \(bu 4
139 The documentation for Carp incorrectly stated that the \f(CW$Carp::Verbose\fR
140 variable makes cluck generate stack backtraces.
141 .IP \(bu 4
142 We fixed a number of typos in Pod::Functions
143 .IP \(bu 4
144 We improved documentation of case\-changing functions in perlfunc
145 .IP \(bu 4
146 We corrected perlgpl to contain the correct version of the GNU
147 General Public License.
148 .SH Testing
149 .IX Header "Testing"
150 .SS "Testing Improvements"
151 .IX Subsection "Testing Improvements"
152 .IP \(bu 4
153 \&\fIt/op/sselect.t\fR is now less prone to clock jitter during timing checks
154 on Windows.
155 .Sp
156 \&\fBsleep()\fR time on Win32 may be rounded down to multiple of
157 the clock tick interval.
158 .IP \(bu 4
159 \&\fIlib/blib.t\fR and \fIlib/locale.t\fR: Fixes for test failures on Darwin/PPC
160 .IP \(bu 4
161 \&\fIperl5db.t\fR: Fix for test failures when \f(CW\*(C`Term::ReadLine::Gnu\*(C'\fR is installed.
162 .SH "Installation and Configuration Improvements"
163 .IX Header "Installation and Configuration Improvements"
164 .SS "Configuration improvements"
165 .IX Subsection "Configuration improvements"
166 .IP \(bu 4
167 We updated \fIINSTALL\fR with notes about how to deal with broken \fIdbm.h\fR
168 on OpenSUSE (and possibly other platforms)
169 .SH "Bug Fixes"
170 .IX Header "Bug Fixes"
171 .IP \(bu 4
172 A bug in how we process filetest operations could cause a segfault.
173 Filetests don\*(Aqt always expect an op on the stack, so we now use
174 TOPs only if we\*(Aqre sure that we\*(Aqre not stat\*(Aqing the _ filehandle.
175 This is indicated by OPf_KIDS (as checked in ck_ftst).
176 .Sp
177 See also: <https://github.com/Perl/perl5/issues/10335>
178 .IP \(bu 4
179 When deparsing a nextstate op that has both a change of package (relative
180 to the previous nextstate) and a label, the package declaration is now
181 emitted first, because it is syntactically impermissible for a label to
182 prefix a package declaration.
183 .IP \(bu 4
184 XSUB.h now correctly redefines fgets under PERL_IMPLICIT_SYS
185 .Sp
186 See also: <http://rt.cpan.org/Public/Bug/Display.html?id=55049>
187 .IP \(bu 4
188 utf8::is_utf8 now respects GMAGIC (e.g. \f(CW$1\fR)
189 .IP \(bu 4
190 XS code using \f(CWfputc()\fR or \f(CWfputs()\fR: on Windows could cause an error
191 due to their arguments being swapped.
192 .Sp
193 See also: <https://github.com/Perl/perl5/issues/10156>
194 .IP \(bu 4
195 We fixed a small bug in \fBlex_stuff_pvn()\fR that caused spurious syntax errors
196 in an obscure situation. It happened when stuffing was performed on the
197 last line of a file and the line ended with a statement that lacked a
198 terminating semicolon.
199 .Sp
200 See also: <https://github.com/Perl/perl5/issues/10273>
201 .IP \(bu 4
202 We fixed a bug that could cause \eN{} constructs followed by a single . to
203 be parsed incorrectly.
204 .Sp
205 See also: <https://github.com/Perl/perl5/issues/10367>
206 .IP \(bu 4
207 We fixed a bug that caused when(scalar) without an argument not to be
208 treated as a syntax error.
209 .Sp
210 See also: <https://github.com/Perl/perl5/issues/10287>
211 .IP \(bu 4
212 We fixed a regression in the handling of labels immediately before string
213 evals that was introduced in Perl 5.12.0.
214 .Sp
215 See also: <https://github.com/Perl/perl5/issues/10301>
216 .IP \(bu 4
217 We fixed a regression in case\-insensitive matching of folded characters
218 in regular expressions introduced in Perl 5.10.1.
219 .Sp
220 See also: <https://github.com/Perl/perl5/issues/10193>
221 .SH "Platform Specific Notes"
222 .IX Header "Platform Specific Notes"
223 .SS HP\-UX
224 .IX Subsection "HP-UX"
225 .IP \(bu 4
226 Perl now allows \-Duse64bitint without promoting to use64bitall on HP\-UX
227 .SS AIX
228 .IX Subsection "AIX"
229 .IP \(bu 4
230 Perl now builds on AIX 4.2
231 .Sp
232 The changes required work around AIX 4.2s\*(Aq lack of support for IPv6,
233 and limited support for POSIX \f(CWsigaction()\fR.
234 .SS "FreeBSD 7"
235 .IX Subsection "FreeBSD 7"
236 .IP \(bu 4
237 FreeBSD 7 no longer contains \fI/usr/bin/objformat\fR. At build time,
238 Perl now skips the \fIobjformat\fR check for versions 7 and higher and
239 assumes ELF.
240 .SS VMS
241 .IX Subsection "VMS"
242 .IP \(bu 4
243 It\*(Aqs now possible to build extensions on older (pre 7.3\-2) VMS systems.
244 .Sp
245 DCL symbol length was limited to 1K up until about seven years or
246 so ago, but there was no particularly deep reason to prevent those
247 older systems from configuring and building Perl.
248 .IP \(bu 4
249 We fixed the previously\-broken \f(CW\*(C`\-Uuseperlio\*(C'\fR build on VMS.
250 .Sp
251 We were checking a variable that doesn\*(Aqt exist in the non\-default
252 case of disabling perlio. Now we only look at it when it exists.
253 .IP \(bu 4
254 We fixed the \-Uuseperlio command\-line option in configure.com.
255 .Sp
256 Formerly it only worked if you went through all the questions
257 interactively and explicitly answered no.
258 .SH "Known Problems"
259 .IX Header "Known Problems"
260 .IP \(bu 4
261 \&\f(CW\*(C`List::Util::first\*(C'\fR misbehaves in the presence of a lexical \f(CW$_\fR
262 (typically introduced by \f(CW\*(C`my $_\*(C'\fR or implicitly by \f(CW\*(C`given\*(C'\fR). The variable
263 which gets set for each iteration is the package variable \f(CW$_\fR, not the
264 lexical \f(CW$_\fR.
265 .Sp
266 A similar issue may occur in other modules that provide functions which
267 take a block as their first argument, like
268 .Sp
269 .Vb 1
270 \& foo { ... $_ ...} list
271 .Ve
272 .Sp
273 See also: <https://github.com/Perl/perl5/issues/9798>
274 .IP \(bu 4
275 \&\f(CW\*(C`Module::Load::Conditional\*(C'\fR and \f(CW\*(C`version\*(C'\fR have an unfortunate
276 interaction which can cause \f(CW\*(C`CPANPLUS\*(C'\fR to crash when it encounters
277 an unparseable version string. Upgrading to \f(CW\*(C`CPANPLUS\*(C'\fR 0.9004 or
278 \&\f(CW\*(C`Module::Load::Conditional\*(C'\fR 0.38 from CPAN will resolve this issue.
279 .SH Acknowledgements
280 .IX Header "Acknowledgements"
281 Perl 5.12.1 represents approximately four weeks of development since
282 Perl 5.12.0 and contains approximately 4,000 lines of changes
283 across 142 files from 28 authors.
284 .PP
285 Perl continues to flourish into its third decade thanks to a vibrant
286 community of users and developers. The following people are known to
287 have contributed the improvements that became Perl 5.12.1:
288 .PP
289 Ævar Arnfjörð Bjarmason, Chris Williams, chromatic, Craig A. Berry,
290 David Golden, Father Chrysostomos, Florian Ragwitz, Frank Wiegand,
291 Gene Sullivan, Goro Fuji, H.Merijn Brand, James E Keenan, Jan Dubois,
292 Jesse Vincent, Josh ben Jore, Karl Williamson, Leon Brocard, Michael
293 Schwern, Nga Tang Chan, Nicholas Clark, Niko Tyni, Philippe Bruhat,
294 Rafael Garcia\-Suarez, Ricardo Signes, Steffen Mueller, Todd Rinaldo,
295 Vincent Pit and Zefram.
296 .SH "Reporting Bugs"
297 .IX Header "Reporting Bugs"
298 If you find what you think is a bug, you might check the articles
299 recently posted to the comp.lang.perl.misc newsgroup and the perl
300 bug database at http://rt.perl.org/perlbug/ . There may also be
301 information at http://www.perl.org/ , the Perl Home Page.
302 .PP
303 If you believe you have an unreported bug, please run the \fBperlbug\fR
304 program included with your release. Be sure to trim your bug down
305 to a tiny but sufficient test case. Your bug report, along with the
306 output of \f(CW\*(C`perl \-V\*(C'\fR, will be sent off to [email protected] to be
307 analysed by the Perl porting team.
308 .PP
309 If the bug you are reporting has security implications, which make it
310 inappropriate to send to a publicly archived mailing list, then please send
311 it to perl5\-security\[email protected]. This points to a closed subscription
312 unarchived mailing list, which includes
313 all the core committers, who will be able
314 to help assess the impact of issues, figure out a resolution, and help
315 co\-ordinate the release of patches to mitigate or fix the problem across all
316 platforms on which Perl is supported. Please only use this address for
317 security issues in the Perl core, not for modules independently
318 distributed on CPAN.
319 .SH "SEE ALSO"
320 .IX Header "SEE ALSO"
321 The \fIChanges\fR file for an explanation of how to view exhaustive details
322 on what changed.
323 .PP
324 The \fIINSTALL\fR file for how to build Perl.
325 .PP
326 The \fIREADME\fR file for general stuff.
327 .PP
328 The \fIArtistic\fR and \fICopying\fR files for copyright information.