summaryrefslogtreecommitdiff
path: root/Master/tlpkg/tlperl/lib/pods/perl5121delta.pod
diff options
context:
space:
mode:
Diffstat (limited to 'Master/tlpkg/tlperl/lib/pods/perl5121delta.pod')
-rw-r--r--Master/tlpkg/tlperl/lib/pods/perl5121delta.pod412
1 files changed, 412 insertions, 0 deletions
diff --git a/Master/tlpkg/tlperl/lib/pods/perl5121delta.pod b/Master/tlpkg/tlperl/lib/pods/perl5121delta.pod
new file mode 100644
index 00000000000..2c8a08fb289
--- /dev/null
+++ b/Master/tlpkg/tlperl/lib/pods/perl5121delta.pod
@@ -0,0 +1,412 @@
+=encoding utf8
+
+=head1 NAME
+
+perldelta - 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
+