Debian Codegraph @

upstream/debian-unstable/man1/perl5161delta.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 "PERL5161DELTA 1"
58 .TH PERL5161DELTA 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 perl5161delta \- what is new for perl v5.16.1
65 .SH DESCRIPTION
66 .IX Header "DESCRIPTION"
67 This document describes differences between the 5.16.0 release and
68 the 5.16.1 release.
69 .PP
70 If you are upgrading from an earlier release such as 5.14.0, first read
71 perl5160delta, which describes differences between 5.14.0 and
72 5.16.0.
73 .SH Security
74 .IX Header "Security"
75 .SS "an off-by-two error in Scalar-List-Util has been fixed"
76 .IX Subsection "an off-by-two error in Scalar-List-Util has been fixed"
77 The bugfix was in Scalar-List-Util 1.23_04, and perl 5.16.1 includes
78 Scalar-List-Util 1.25.
79 .SH "Incompatible Changes"
80 .IX Header "Incompatible Changes"
81 There are no changes intentionally incompatible with 5.16.0 If any
82 exist, they are bugs, and we request that you submit a report. See
83 "Reporting Bugs" below.
84 .SH "Modules and Pragmata"
85 .IX Header "Modules and Pragmata"
86 .SS "Updated Modules and Pragmata"
87 .IX Subsection "Updated Modules and Pragmata"
88 .IP \(bu 4
89 Scalar::Util and List::Util have been upgraded from version 1.23 to
90 version 1.25.
91 .IP \(bu 4
92 B::Deparse has been updated from version 1.14 to 1.14_01. An
93 "uninitialized" warning emitted by B::Deparse has been squashed
94 [perl #113464].
95 .SH "Configuration and Compilation"
96 .IX Header "Configuration and Compilation"
97 .IP \(bu 4
98 Building perl with some Windows compilers used to fail due to a problem
99 with miniperl's \f(CW\*(C`glob\*(C'\fR operator (which uses the \f(CW\*(C`perlglob\*(C'\fR program)
100 deleting the PATH environment variable [perl #113798].
101 .SH "Platform Support"
102 .IX Header "Platform Support"
103 .SS "Platform-Specific Notes"
104 .IX Subsection "Platform-Specific Notes"
105 .IP VMS 4
106 .IX Item "VMS"
107 All C header files from the top-level directory of the distribution are now
108 installed on VMS, providing consistency with a long-standing practice on other
109 platforms. Previously only a subset were installed, which broke non-core extension
110 builds for extensions that depended on the missing include files.
111 .SH "Selected Bug Fixes"
112 .IX Header "Selected Bug Fixes"
113 .IP \(bu 4
114 A regression introduced in Perl v5.16.0 involving
115 \&\f(CW\*(C`tr/\fR\f(CISEARCHLIST\fR\f(CW/\fR\f(CIREPLACEMENTLIST\fR\f(CW/\*(C'\fR has been fixed. Only the first
116 instance is supposed to be meaningful if a character appears more than
117 once in \f(CW\*(C`\fR\f(CISEARCHLIST\fR\f(CW\*(C'\fR. Under some circumstances, the final instance
118 was overriding all earlier ones. [perl #113584]
119 .IP \(bu 4
120 \&\f(CW\*(C`B::COP::stashlen\*(C'\fR has been added. This provides access to an internal
121 field added in perl 5.16 under threaded builds. It was broken at the last
122 minute before 5.16 was released [perl #113034].
123 .IP \(bu 4
124 The re pragma will no longer clobber \f(CW$_\fR. [perl #113750]
125 .IP \(bu 4
126 Unicode 6.1 published an incorrect alias for one of the
127 Canonical_Combining_Class property's values (which range between 0 and
128 254). The alias \f(CW\*(C`CCC133\*(C'\fR should have been \f(CW\*(C`CCC132\*(C'\fR. Perl now
129 overrides the data file furnished by Unicode to give the correct value.
130 .IP \(bu 4
131 Duplicating scalar filehandles works again. [perl #113764]
132 .IP \(bu 4
133 Under threaded perls, a runtime code block in a regular expression could
134 corrupt the package name stored in the op tree, resulting in bad reads
135 in \f(CW\*(C`caller\*(C'\fR, and possibly crashes [perl #113060].
136 .IP \(bu 4
137 For efficiency's sake, many operators and built-in functions return the
138 same scalar each time. Lvalue subroutines and subroutines in the CORE::
139 namespace were allowing this implementation detail to leak through.
140 \&\f(CW\*(C`print &CORE::uc("a"), &CORE::uc("b")\*(C'\fR used to print "BB". The same thing
141 would happen with an lvalue subroutine returning the return value of \f(CW\*(C`uc\*(C'\fR.
142 Now the value is copied in such cases [perl #113044].
143 .IP \(bu 4
144 \&\f(CW\*(C`_\|_SUB_\|_\*(C'\fR now works in special blocks (\f(CW\*(C`BEGIN\*(C'\fR, \f(CW\*(C`END\*(C'\fR, etc.).
145 .IP \(bu 4
146 Formats that reference lexical variables from outside no longer result
147 in crashes.
148 .SH "Known Problems"
149 .IX Header "Known Problems"
150 There are no new known problems, but consult "Known
151 Problems" in perl5160delta to see those identified in the 5.16.0 release.
152 .SH Acknowledgements
153 .IX Header "Acknowledgements"
154 Perl 5.16.1 represents approximately 2 months of development since Perl
155 5.16.0 and contains approximately 14,000 lines of changes across 96
156 files from 8 authors.
157 .PP
158 Perl continues to flourish into its third decade thanks to a vibrant
159 community of users and developers. The following people are known to
160 have contributed the improvements that became Perl 5.16.1:
161 .PP
162 Chris 'BinGOs' Williams, Craig A. Berry, Father Chrysostomos, Karl
163 Williamson, Paul Johnson, Reini Urban, Ricardo Signes, Tony Cook.
164 .PP
165 The list above is almost certainly incomplete as it is automatically
166 generated from version control history. In particular, it does not
167 include the names of the (very much appreciated) contributors who
168 reported issues to the Perl bug tracker.
169 .PP
170 Many of the changes included in this version originated in the CPAN
171 modules included in Perl's core. We're grateful to the entire CPAN
172 community for helping Perl to flourish.
173 .PP
174 For a more complete list of all of Perl's historical contributors,
175 please see the \fIAUTHORS\fR file in the Perl source distribution.
176 .SH "Reporting Bugs"
177 .IX Header "Reporting Bugs"
178 If you find what you think is a bug, you might check the articles
179 recently posted to the comp.lang.perl.misc newsgroup and the perl
180 bug database at http://rt.perl.org/perlbug/ . There may also be
181 information at http://www.perl.org/ , the Perl Home Page.
182 .PP
183 If you believe you have an unreported bug, please run the perlbug
184 program included with your release. Be sure to trim your bug down
185 to a tiny but sufficient test case. Your bug report, along with the
186 output of \f(CW\*(C`perl \-V\*(C'\fR, will be sent off to [email protected] to be
187 analysed by the Perl porting team.
188 .PP
189 If the bug you are reporting has security implications, which make it
190 inappropriate to send to a publicly archived mailing list, then please
191 send it to perl5\-security\[email protected]. This points to a closed
192 subscription unarchived mailing list, which includes all the core
193 committers, who will be able to help assess the impact of issues, figure
194 out a resolution, and help co-ordinate the release of patches to
195 mitigate or fix the problem across all platforms on which Perl is
196 supported. Please only use this address for security issues in the Perl
197 core, not for modules independently distributed on CPAN.
198 .SH "SEE ALSO"
199 .IX Header "SEE ALSO"
200 The \fIChanges\fR file for an explanation of how to view exhaustive details
201 on what changed.
202 .PP
203 The \fIINSTALL\fR file for how to build Perl.
204 .PP
205 The \fIREADME\fR file for general stuff.
206 .PP
207 The \fIArtistic\fR and \fICopying\fR files for copyright information.