summaryrefslogtreecommitdiff
path: root/pod/perl5121delta.pod
blob: ca922bcf9648ce6f130d26f5b77e21a0a2339016 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
=encoding utf8

=head1 NAME

perl5121delta - what is new for perl v5.12.1

=head1 DESCRIPTION

This document describes differences between the 5.12.0 release and
the 5.12.1 release.

If you are upgrading from an earlier release such as 5.10.1, first read
L<perl5120delta>, which describes differences between 5.10.1 and
5.12.0.

=head1 Incompatible Changes

There are no changes intentionally incompatible with 5.12.0. If any
incompatibilities with 5.12.0 exist, they are bugs. Please report them.

=head1 Core Enhancements

Other than the bug fixes listed below, there should be no user-visible
changes to the core language in this release.

=head1 Modules and Pragmata

=head2 Pragmata Changes

=over 

=item *

We fixed exporting of C<is_strict> and C<is_lax> from L<version>.

These were being exported with a wrapper that treated them as method
calls, which caused them to fail.  They are just functions, are
documented as such, and should never be subclassed, so this patch
just exports them directly as functions without the wrapper.

=back

=head2 Updated Modules

=over 

=item *

We upgraded L<CGI.pm> to version 3.49 to incorporate fixes for regressions
introduced in the release we shipped with Perl 5.12.0.

=item *

We upgraded L<Pod::Simple> to version 3.14 to get an improvement to \C\<\< \>\>
parsing.

=item *

We made a small fix to the L<CPANPLUS> test suite to fix an occasional spurious test failure.

=item *

We upgraded L<Safe> to version 2.27 to wrap coderefs retured by C<reval()> and C<rdo()>.

=back

=head1 Changes to Existing Documentation

=over

=item *

We added the new maintenance release policy to L<perlpolicy.pod>

=item *

We've clarified the multiple-angle-bracket construct in the spec for POD
in L<perlpodspec>

=item *

We added a missing explanation for a warning about C<:=> to L<perldiag.pod>

=item *

We removed a false claim in L<perlunitut> that all text strings are Unicode strings in Perl.

=item *

We updated the Github mirror link in L<perlrepository> to mirrors/perl, not github/perl

=item *

We fixed a a minor error in L<perl5114delta.pod>.

=item * 

We replaced a mention of the now-obsolete L<Switch.pm> with F<given>/F<when>.

=item *

We improved documentation about F<$sitelibexp/sitecustomize.pl> in L<perlrun>.

=item * 

We corrected L<perlmodlib.pod> which had unintentionally omitted a number of modules.

=item * 

We updated the documentation for 'require' in L<perlfunc.pod> relating to putting Perl code in @INC.

=item *

We reinstated some erroneously-removed documentation about quotemeta in L<perlfunc>.

=item *

We fixed an F<a2p> example in L<perlutil.pod>.

=item  *

We filled in a blank in L<perlport.pod> with the release date of Perl 5.12.

=item  *

We fixed broken links in a number of perldelta files.

=item * 

The documentation for L<Carp.pm> incorrectly stated that the $Carp::Verbose
variable makes cluck generate stack backtraces.

=item *

We fixed a number of typos in L<Pod::Functions>

=item *

We improved documentation of case-changing functions in L<perlfunc.pod>

=item *

We corrected L<perlgpl.pod> to contain the correct version of the GNU
General Public License.



=back

=head1 Testing

=head2 Testing Improvements

=over

=item *

F<t/op/sselect.t> is now less prone to clock jitter during timing checks
on Windows.

sleep() time on Win32 may be rounded down to multiple of
the clock tick interval.

=item *

F<lib/blib.t> and F<lib/locale.t>: Fixes for test failures on Darwin/PPC

=item *

F<perl5db.t>: Fix for test failures when C<Term::ReadLine::Gnu> is installed.

=back

=head1 Installation and Configuration Improvements

=head2 Configuration improvements

=over 

=item * 

We updated F<INSTALL> with notes about how to deal with broken F<dbm.h>
on OpenSUSE (and possibly other platforms)

=back

=head1 Bug Fixes

=over 4

=item *

A bug in how we process filetest operations could cause a segfault.
Filetests don't always expect an op on the stack, so we now use
TOPs only if we're sure that we're not stat'ing the _ filehandle.
This is indicated by OPf_KIDS (as checked in ck_ftst).

See also: L<http://rt.perl.org/rt3/Public/Bug/Display.html?id=74542>

=item *

When deparsing a nextstate op that has both a change of package (relative
to the previous nextstate) and a label, the package declaration is now
emitted first, because it is syntactically impermissible for a label to
prefix a package declaration.

=item * 

XSUB.h now correctly redefines fgets under PERL_IMPLICIT_SYS

See also: L<http://rt.cpan.org/Public/Bug/Display.html?id=55049>


=item * 

utf8::is_utf8 now respects GMAGIC (e.g. $1)


=item * 

XS code using C<fputc()> or C<fputs()>: on Windows could cause an error
due to their arguments being swapped.

See also: L<http://rt.perl.org/rt3/Public/Bug/Display.html?id=72704>

=item *

We fixed a small bug in lex_stuff_pvn() that caused spurious syntax errors
in an obscure situation.  It happened when stuffing was performed on the
last line of a file and the line ended with a statement that lacked a
terminating semicolon.  

See also: L<http://rt.perl.org/rt3/Public/Bug/Display.html?id=74006>

=item *

We fixed a bug that could cause \N{} constructs followed by a single . to
be parsed incorrectly.

See also: L<http://rt.perl.org/rt3/Public/Bug/Display.html?id=74978>

=item *


We fixed a bug that caused when(scalar) without an argument not to be
treated as a syntax error.

See also: L<http://rt.perl.org/rt3/Public/Bug/Display.html?id=74114>

=item *

We fixed a regression in the handling of labels immediately before string
evals that was introduced in Perl 5.12.0.

See also: L<http://rt.perl.org/rt3/Public/Bug/Display.html?id=74290>

=item *

We fixed a regression in case-insensitive matching of folded characters
in regular expressions introduced in Perl 5.12.0.

See also: L<http://rt.perl.org/rt3/Public/Bug/Display.html?id=72998>

=back

=head1 Platform Specific Notes

=head2 HP-UX

=over 

=item *

Perl now allows -Duse64bitint without promoting to use64bitall on HP-UX

=back

=head2 AIX

=over

=item * 

Perl now builds on AIX 4.2

The changes required work around AIX 4.2s' lack of support for IPv6,
and limited support for POSIX C<sigaction()>.

=back

=head2 FreeBSD 7

=over

=item * 

FreeBSD 7 no longer contains F</usr/bin/objformat>. At build time,
Perl now skips the F<objformat> check for versions 7 and higher and
assumes ELF.

=back

=head2 VMS

=over

=item *

It's now possible to build extensions on older (pre 7.3-2) VMS systems.

DCL symbol length was limited to 1K up until about seven years or
so ago, but there was no particularly deep reason to prevent those
older systems from configuring and building Perl.

=item *

We fixed the previously-broken C<-Uuseperlio> build on VMS.

We were checking a variable that doesn't exist in the non-default
case of disabling perlio.  Now we only look at it when it exists.

=item *

We fixed the -Uuseperlio command-line option in configure.com.

Formerly it only worked if you went through all the questions
interactively and explicitly answered no.

=back

=head1 Known Problems

=over

=item *

C<List::Util::first> misbehaves in the presence of a lexical C<$_>
(typically introduced by C<my $_> or implicitly by C<given>). The variable
which gets set for each iteration is the package variable C<$_>, not the
lexical C<$_>.

A similar issue may occur in other modules that provide functions which
take a block as their first argument, like

    foo { ... $_ ...} list

See also: L<http://rt.perl.org/rt3/Public/Bug/Display.html?id=67694>

=item *

C<Module::Load::Conditional> and C<version> have an unfortunate
interaction which can cause C<CPANPLUS> to crash when it encounters
an unparseable version string.  Upgrading to C<CPANPLUS> 0.9004 or
C<Module::Load::Conditional> 0.38 from CPAN will resolve this issue.

=back


=head1 Acknowledgements

Perl 5.12.1 represents approximately four weeks of development since
Perl 5.12.0 and contains approximately 4,000 lines of changes
across 142 files from 28 authors.

Perl continues to flourish into its third decade thanks to a vibrant
community of users and developers.  The following people are known to
have contributed the improvements that became Perl 5.12.1:

Ævar Arnfjörð Bjarmason, Chris Williams, chromatic, Craig A. Berry,
David Golden, Father Chrysostomos, Florian Ragwitz, Frank Wiegand,
Gene Sullivan, Goro Fuji, H.Merijn Brand, James E Keenan, Jan Dubois,
Jesse Vincent, Josh ben Jore, Karl Williamson, Leon Brocard, Michael
Schwern, Nga Tang Chan, Nicholas Clark, Niko Tyni, Philippe Bruhat,
Rafael Garcia-Suarez, Ricardo Signes, Steffen Mueller, Todd Rinaldo,
Vincent Pit and Zefram.

=head1 Reporting Bugs

If you find what you think is a bug, you might check the articles
recently posted to the comp.lang.perl.misc newsgroup and the perl
bug database at http://rt.perl.org/perlbug/ .  There may also be
information at http://www.perl.org/ , the Perl Home Page.

If you believe you have an unreported bug, please run the B<perlbug>
program included with your release.  Be sure to trim your bug down
to a tiny but sufficient test case.  Your bug report, along with the
output of C<perl -V>, will be sent off to perlbug@perl.org to be
analysed by the Perl porting team.

If the bug you are reporting has security implications, which make it
inappropriate to send to a publicly archived mailing list, then please send
it to perl5-security-report@perl.org. This points to a closed subscription
unarchived mailing list, which includes all the core committers, who be able
to help assess the impact of issues, figure out a resolution, and help
co-ordinate the release of patches to mitigate or fix the problem across all
platforms on which Perl is supported. Please only use this address for
security issues in the Perl core, not for modules independently
distributed on CPAN.

=head1 SEE ALSO

The F<Changes> file for an explanation of how to view exhaustive details
on what changed.

The F<INSTALL> file for how to build Perl.

The F<README> file for general stuff.

The F<Artistic> and F<Copying> files for copyright information.

=cut