This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Keep perl5115delta.pod up to date
[perl5.git] / pod / perl5115delta.pod
1 =head1 NAME
2
3 perldelta - what is new for perl v5.11.5
4
5 =head1 DESCRIPTION
6
7 This document describes differences between the 5.11.4 release and
8 the 5.11.5 release.
9
10 If you are upgrading from an earlier release such as 5.11.3, first read
11 L<perl5114delta>, which describes differences between 5.11.3 and
12 5.11.4.
13
14 =head1 Core Enhancements
15
16 =head2 32-bit limit on substr arguments removed
17
18 The 32-bit limit on C<substr> arguments has now been removed. The full range
19 of the system's signed and unsigned integers is now available for the C<pos>
20 and C<len> arguments.
21
22 =head1 Modules and Pragmata
23
24 =head2 Pragmata Changes
25
26 =over 4
27
28 =item C<version>
29
30 Upgraded from version 0.81 to 0.82.
31
32 The C<is_lax> and C<is_strict> functions can now be optionally exported to the
33 caller's namespace and are also now documented.
34
35 Undefined version objects are now uninitialized with zero rather than C<undef>.
36
37 =back
38
39 =head2 Updated Modules
40
41 =over 4
42
43 =item C<CPAN>
44
45 Upgraded from version 1.94_53 to 1.94_56.
46
47 This module is also now built in a less specialized way, which resolves a
48 problem that caused C<make> after C<make clean> to fail, fixing RT #72218.
49
50 =item C<CPANPLUS::Dist::Build>
51
52 Upgraded from version 0.44 to 0.46.
53
54 =item C<Safe>
55
56 Upgraded from version 2.21 to 2.22.
57
58 This resolves RT #72700, in which an exception thrown from a closure was
59 getting lost.
60
61 =item C<Socket>
62
63 Upgraded from version 1.85 to 1.86.
64
65 This makes the new Socket implementation of C<inet_pton> consistent with the
66 existing Socket6 implementation of C<inet_pton>, fixing RT #72884.
67
68 =item C<podlators>
69
70 Upgraded from version 2.2.2 to 2.3.1.
71
72 =back
73
74 =head1 Changes to Existing Documentation
75
76 The syntax C<unless (EXPR) BLOCK else BLOCK> is now documented as valid, as
77 is the syntax C<unless (EXPR) BLOCK elsif (EXPR) BLOCK ... else BLOCK>,
78 although actually using the latter may not be the best idea for the
79 readability of your source code.
80
81 =head1 Installation and Configuration Improvements
82
83 =head2 Configuration improvements
84
85 Support for SystemTap's C<dtrace> compatibility layer has been added and an
86 issue with linking C<miniperl> has been fixed in the process.
87
88 C<less -R> is now used instead of C<less> for C<groff>'s new usage of ANSI
89 escape codes by setting C<$Config{less}> (and thereby C<$Config{pager}>,
90 which fixes RT #72156.
91
92 USE_PERL_ATOF is now reported in the compile-time options listed by the C<-V>
93 switch.
94
95 =head1 Selected Bug Fixes
96
97 =over 4
98
99 =item *
100
101 Arbitrary whitespace is now allowed between C<NAME> and C<VERSION> in
102 C<package NAME VERSION;> statements. (Fixes RT #72432)
103
104 =item *
105
106 A panic caused by trying to load C<charnames> when the parser is already in
107 error (e.g. by a missing C<my> under C<use strict;>) is now averted. This
108 was a regression since Perl 5.10.0. (Fixes RT #72590)
109
110 =item *
111
112 Reading C<$!> no longer causes a SEGV for out of range C<errno> values. (Fixes
113 RT #72850)
114
115 =item *
116
117 A possible SEGV in C</\N{...}/> has been fixed. This was a regression since
118 Perl 5.10.
119
120 =item *
121
122 A possible SEGV when freeing a scalar that was upgraded to an C<SVt_REGEXP>
123 type from a simple(r) scalar has been fixed.
124
125 =item *
126
127 A type conversion bug in C<gmtime64> that caused it to break around C<2**48>
128 has been fixed.
129
130 =item *
131
132 Filehandles are now always blessed into C<IO::File>, which, together with
133 some suitable manipulation of C<@IO::File::ISA>, fixes a breakage introduced
134 in Perl 5.11.3 by a change that always blessed filehandles into C<IO::Handle>
135 rather than checking for C<FileHandle> first.
136
137 =item *
138
139 A change in the behaviour of C<warnings::enabled> and C<warnings::warnif> in
140 Perl 5.10.0 that wasn't documented at the time is now documented in
141 L<perl5100delta>. (Fixes RT #62522)
142
143 =item *
144
145 RT #71504 is now fixed by simply skipping the tests that failed on OpenBSD
146 with ithreads and perlio.
147
148 =back
149
150 =head1 New or Changed Diagnostics
151
152 =over 4
153
154 =item *
155
156 C<gmtime> and C<localtime> called with numbers smaller than they can reliably
157 handle will now issue the warnings C<gmtime(%.0f) too small> and
158 C<localtime(%.0f) too small>.
159
160 =back
161
162 =head1 New Tests
163
164 =over 4
165
166 =item F<t/op/filehandle.t>
167
168 Tests some suitably portable filetest operators to check that they work as
169 expected, particularly in the light of some internal changes made in how
170 filehandles are blessed.
171
172 =item F<t/op/time_loop.t>
173
174 Tests that times greater than C<2**63>, which can now be handed to C<gmtime>
175 and C<localtime>, do not cause an internal overflow or an excessively long
176 loop.
177
178 =back
179
180 =head1 Known Problems
181
182 Perl 5.11.5 is a development release leading up to Perl 5.12.0.
183 Some notable known problems found in 5.11.5 are listed as dependencies
184 of RT #69710, the Perl 5 version 12 meta-ticket.
185
186 =head1 Acknowledgements
187
188 Perl 5.11.5 represents approximately one month of development since
189 Perl 5.11.4 and contains XXX lines of changes across XXX files
190 from XXX authors and committers:
191
192 XXX The list of people to thank goes here.
193
194 Many of the changes included in this version originated in the CPAN
195 modules included in Perl's core. We're grateful to the entire CPAN
196 community for helping Perl to flourish.
197
198 =head1 Reporting Bugs
199
200 If you find what you think is a bug, you might check the articles
201 recently posted to the comp.lang.perl.misc newsgroup and the perl
202 bug database at http://rt.perl.org/perlbug/ .  There may also be
203 information at http://www.perl.org/ , the Perl Home Page.
204
205 If you believe you have an unreported bug, please run the B<perlbug>
206 program included with your release.  Be sure to trim your bug down
207 to a tiny but sufficient test case.  Your bug report, along with the
208 output of C<perl -V>, will be sent off to perlbug@perl.org to be
209 analyzed by the Perl porting team.
210
211 If the bug you are reporting has security implications, which make it
212 inappropriate to send to a publicly archived mailing list, then please send
213 it to perl5-security-report@perl.org. This points to a closed subscription
214 unarchived mailing list, which includes all the core committers, who be able
215 to help assess the impact of issues, figure out a resolution, and help
216 co-ordinate the release of patches to mitigate or fix the problem across all
217 platforms on which Perl is supported. Please only use this address for
218 security issues in the Perl core, not for modules independently
219 distributed on CPAN.
220
221 =head1 SEE ALSO
222
223 The F<Changes> file for an explanation of how to view exhaustive details
224 on what changed.
225
226 The F<INSTALL> file for how to build Perl.
227
228 The F<README> file for general stuff.
229
230 The F<Artistic> and F<Copying> files for copyright information.
231
232 =cut