diff options
Diffstat (limited to 'upstream/mageia-cauldron/man1/perl5122delta.1')
| -rw-r--r-- | upstream/mageia-cauldron/man1/perl5122delta.1 | 300 |
1 files changed, 300 insertions, 0 deletions
diff --git a/upstream/mageia-cauldron/man1/perl5122delta.1 b/upstream/mageia-cauldron/man1/perl5122delta.1 new file mode 100644 index 00000000..6437cc1c --- /dev/null +++ b/upstream/mageia-cauldron/man1/perl5122delta.1 @@ -0,0 +1,300 @@ +.\" -*- mode: troff; coding: utf-8 -*- +.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) +.\" +.\" Standard preamble: +.\" ======================================================================== +.de Sp \" Vertical space (when we can't use .PP) +.if t .sp .5v +.if n .sp +.. +.de Vb \" Begin verbatim text +.ft CW +.nf +.ne \\$1 +.. +.de Ve \" End verbatim text +.ft R +.fi +.. +.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. +.ie n \{\ +. ds C` "" +. ds C' "" +'br\} +.el\{\ +. ds C` +. ds C' +'br\} +.\" +.\" Escape single quotes in literal strings from groff's Unicode transform. +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" +.\" If the F register is >0, we'll generate index entries on stderr for +.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index +.\" entries marked with X<> in POD. Of course, you'll have to process the +.\" output yourself in some meaningful fashion. +.\" +.\" Avoid warning from groff about undefined register 'F'. +.de IX +.. +.nr rF 0 +.if \n(.g .if rF .nr rF 1 +.if (\n(rF:(\n(.g==0)) \{\ +. if \nF \{\ +. de IX +. tm Index:\\$1\t\\n%\t"\\$2" +.. +. if !\nF==2 \{\ +. nr % 0 +. nr F 2 +. \} +. \} +.\} +.rr rF +.\" ======================================================================== +.\" +.IX Title "PERL5122DELTA 1" +.TH PERL5122DELTA 1 2023-11-28 "perl v5.38.2" "Perl Programmers Reference Guide" +.\" For nroff, turn off justification. Always turn off hyphenation; it makes +.\" way too many mistakes in technical documents. +.if n .ad l +.nh +.SH NAME +perl5122delta \- what is new for perl v5.12.2 +.SH DESCRIPTION +.IX Header "DESCRIPTION" +This document describes differences between the 5.12.1 release and +the 5.12.2 release. +.PP +If you are upgrading from an earlier major version, such as 5.10.1, +first read perl5120delta, which describes differences between 5.10.0 +and 5.12.0, as well as perl5121delta, which describes earlier changes +in the 5.12 stable release series. +.SH "Incompatible Changes" +.IX Header "Incompatible Changes" +There are no changes intentionally incompatible with 5.12.1. If any exist, they +are bugs and reports are welcome. +.SH "Core Enhancements" +.IX Header "Core Enhancements" +Other than the bug fixes listed below, there should be no user-visible +changes to the core language in this release. +.SH "Modules and Pragmata" +.IX Header "Modules and Pragmata" +.SS "New Modules and Pragmata" +.IX Subsection "New Modules and Pragmata" +This release does not introduce any new modules or pragmata. +.SS "Pragmata Changes" +.IX Subsection "Pragmata Changes" +In the previous release, \f(CW\*(C`no \fR\f(CIVERSION\fR\f(CW;\*(C'\fR statements triggered a bug +which could cause feature bundles to be loaded and strict mode to +be enabled unintentionally. +.SS "Updated Modules" +.IX Subsection "Updated Modules" +.ie n .IP """Carp""" 4 +.el .IP \f(CWCarp\fR 4 +.IX Item "Carp" +Upgraded from version 1.16 to 1.17. +.Sp +Carp now detects incomplete \fBcaller()\fR +overrides and avoids using bogus \f(CW@DB::args\fR. To provide backtraces, Carp +relies on particular behaviour of the caller built-in. Carp now detects +if other code has overridden this with an incomplete implementation, and +modifies its backtrace accordingly. Previously incomplete overrides would +cause incorrect values in backtraces (best case), or obscure fatal errors +(worst case) +.Sp +This fixes certain cases of \f(CW\*(C`Bizarre copy of ARRAY\*(C'\fR caused by modules +overriding \f(CWcaller()\fR incorrectly. +.ie n .IP """CPANPLUS""" 4 +.el .IP \f(CWCPANPLUS\fR 4 +.IX Item "CPANPLUS" +A patch to \fIcpanp-run-perl\fR has been backported from CPANPLUS \f(CW0.9004\fR. This +resolves RT #55964 <http://rt.cpan.org/Public/Bug/Display.html?id=55964> +and RT #57106 <http://rt.cpan.org/Public/Bug/Display.html?id=57106>, both +of which related to failures to install distributions that use +\&\f(CW\*(C`Module::Install::DSL\*(C'\fR. +.ie n .IP """File::Glob""" 4 +.el .IP \f(CWFile::Glob\fR 4 +.IX Item "File::Glob" +A regression which caused a failure to find \f(CW\*(C`CORE::GLOBAL::glob\*(C'\fR after +loading \f(CW\*(C`File::Glob\*(C'\fR to crash has been fixed. Now, it correctly falls back +to external globbing via \f(CW\*(C`pp_glob\*(C'\fR. +.ie n .IP """File::Copy""" 4 +.el .IP \f(CWFile::Copy\fR 4 +.IX Item "File::Copy" +\&\f(CW\*(C`File::Copy::copy(FILE, DIR)\*(C'\fR is now documented. +.ie n .IP """File::Spec""" 4 +.el .IP \f(CWFile::Spec\fR 4 +.IX Item "File::Spec" +Upgraded from version 3.31 to 3.31_01. +.Sp +Several portability fixes were made in \f(CW\*(C`File::Spec::VMS\*(C'\fR: a colon is now +recognized as a delimiter in native filespecs; caret-escaped delimiters are +recognized for better handling of extended filespecs; \f(CWcatpath()\fR returns +an empty directory rather than the current directory if the input directory +name is empty; \f(CWabs2rel()\fR properly handles Unix-style input. +.SH "Utility Changes" +.IX Header "Utility Changes" +.IP \(bu 4 +\&\fIperlbug\fR now always gives the reporter a chance to change the email address it +guesses for them. +.IP \(bu 4 +\&\fIperlbug\fR should no longer warn about uninitialized values when using the \f(CW\*(C`\-d\*(C'\fR +and \f(CW\*(C`\-v\*(C'\fR options. +.SH "Changes to Existing Documentation" +.IX Header "Changes to Existing Documentation" +.IP \(bu 4 +The existing policy on backward-compatibility and deprecation has +been added to perlpolicy, along with definitions of terms like +\&\fIdeprecation\fR. +.IP \(bu 4 +"srand" in perlfunc's usage has been clarified. +.IP \(bu 4 +The entry for "die" in perlfunc was reorganized to emphasize its +role in the exception mechanism. +.IP \(bu 4 +Perl's INSTALL file has been clarified to explicitly state that Perl +requires a C89 compliant ANSI C Compiler. +.IP \(bu 4 +IO::Socket's \f(CWgetsockopt()\fR and \f(CWsetsockopt()\fR have been documented. +.IP \(bu 4 +\&\fR\f(BIalarm()\fR\fI\fR's inability to interrupt blocking IO on Windows has been documented. +.IP \(bu 4 +Math::TrulyRandom hasn't been updated since 1996 and has been removed +as a recommended solution for random number generation. +.IP \(bu 4 +perlrun has been updated to clarify the behaviour of octal flags to \fIperl\fR. +.IP \(bu 4 +To ease user confusion, \f(CW$#\fR and \f(CW$*\fR, two special variables that were +removed in earlier versions of Perl have been documented. +.IP \(bu 4 +The version of perlfaq shipped with the Perl core has been updated from the +official FAQ version, which is now maintained in the \f(CW\*(C`briandfoy/perlfaq\*(C'\fR +branch of the Perl repository at <git://perl5.git.perl.org/perl.git>. +.SH "Installation and Configuration Improvements" +.IX Header "Installation and Configuration Improvements" +.SS "Configuration improvements" +.IX Subsection "Configuration improvements" +.IP \(bu 4 +The \f(CW\*(C`d_u32align\*(C'\fR configuration probe on ARM has been fixed. +.SS "Compilation improvements" +.IX Subsection "Compilation improvements" +.IP \(bu 4 +An "\f(CW\*(C`incompatible operand types\*(C'\fR" error in ternary expressions when building +with \f(CW\*(C`clang\*(C'\fR has been fixed. +.IP \(bu 4 +Perl now skips setuid \f(CW\*(C`File::Copy\*(C'\fR tests on partitions it detects to be mounted +as \f(CW\*(C`nosuid\*(C'\fR. +.SH "Selected Bug Fixes" +.IX Header "Selected Bug Fixes" +.IP \(bu 4 +A possible segfault in the \f(CW\*(C`T_PRTOBJ\*(C'\fR default typemap has been fixed. +.IP \(bu 4 +A possible memory leak when using \fBcaller()\fR to set +\&\f(CW@DB::args\fR has been fixed. +.IP \(bu 4 +Several memory leaks when loading XS modules were fixed. +.IP \(bu 4 +\&\f(CWunpack()\fR now handles scalar context correctly for \f(CW%32H\fR and \f(CW%32u\fR, +fixing a potential crash. \f(CWsplit()\fR would crash because the third item +on the stack wasn't the regular expression it expected. \f(CW\*(C`unpack("%2H", +\&...)\*(C'\fR would return both the unpacked result and the checksum on the stack, +as would \f(CW\*(C`unpack("%2u", ...)\*(C'\fR. +[GH #10257] <https://github.com/Perl/perl5/issues/10257> +.IP \(bu 4 +Perl now avoids using memory after calling \f(CWfree()\fR in \fIpp_require\fR +when there are CODEREFs in \f(CW@INC\fR. +.IP \(bu 4 +A bug that could cause "\f(CW\*(C`Unknown error\*(C'\fR" messages when +"\f(CW\*(C`call_sv(code, G_EVAL)\*(C'\fR" is called from an XS destructor has been fixed. +.IP \(bu 4 +The implementation of the \f(CW\*(C`open $fh, \*(Aq>\*(Aq \e$buffer\*(C'\fR feature +now supports get/set magic and thus tied buffers correctly. +.IP \(bu 4 +The \f(CW\*(C`pp_getc\*(C'\fR, \f(CW\*(C`pp_tell\*(C'\fR, and \f(CW\*(C`pp_eof\*(C'\fR opcodes now make room on the +stack for their return values in cases where no argument was passed in. +.IP \(bu 4 +When matching unicode strings under some conditions inappropriate backtracking would +result in a \f(CW\*(C`Malformed UTF\-8 character (fatal)\*(C'\fR error. This should no longer occur. +See [GH #10434] <https://github.com/Perl/perl5/issues/10434> +.SH "Platform Specific Notes" +.IX Header "Platform Specific Notes" +.SS AIX +.IX Subsection "AIX" +.IP \(bu 4 +\&\fIREADME.aix\fR has been updated with information about the XL C/C++ V11 compiler +suite. +.SS Windows +.IX Subsection "Windows" +.IP \(bu 4 +When building Perl with the mingw64 x64 cross-compiler \f(CW\*(C`incpath\*(C'\fR, +\&\f(CW\*(C`libpth\*(C'\fR, \f(CW\*(C`ldflags\*(C'\fR, \f(CW\*(C`lddlflags\*(C'\fR and \f(CW\*(C`ldflags_nolargefiles\*(C'\fR values +in \fIConfig.pm\fR and \fIConfig_heavy.pl\fR were not previously being set +correctly because, with that compiler, the include and lib directories +are not immediately below \f(CW\*(C`$(CCHOME)\*(C'\fR. +.SS VMS +.IX Subsection "VMS" +.IP \(bu 4 +\&\fIgit_version.h\fR is now installed on VMS. This was an oversight in v5.12.0 which +caused some extensions to fail to build. +.IP \(bu 4 +Several memory leaks in \fBstat()\fR have been fixed. +.IP \(bu 4 +A memory leak in \f(CWPerl_rename()\fR due to a double allocation has been +fixed. +.IP \(bu 4 +A memory leak in \f(CWvms_fid_to_name()\fR (used by \f(CWrealpath()\fR and +\&\f(CWrealname()\fR) has been fixed. +.SH Acknowledgements +.IX Header "Acknowledgements" +Perl 5.12.2 represents approximately three months of development since +Perl 5.12.1 and contains approximately 2,000 lines of changes across +100 files from 36 authors. +.PP +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.2: +.PP +Abigail, Ævar Arnfjörð Bjarmason, Ben Morrow, brian d foy, Brian +Phillips, Chas. Owens, Chris 'BinGOs' Williams, Chris Williams, +Craig A. Berry, Curtis Jewell, Dan Dascalescu, David Golden, David +Mitchell, Father Chrysostomos, Florian Ragwitz, George Greer, H.Merijn +Brand, Jan Dubois, Jesse Vincent, Jim Cromie, Karl Williamson, Lars +Dɪᴇᴄᴋᴏᴡ 迪拉斯, Leon Brocard, Maik Hentsche, Matt S Trout, +Nicholas Clark, Rafael Garcia-Suarez, Rainer Tammer, Ricardo Signes, +Salvador Ortiz Garcia, Sisyphus, Slaven Rezic, Steffen Mueller, Tony Cook, +Vincent Pit and Yves Orton. +.SH "Reporting Bugs" +.IX Header "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. +.PP +If you believe you have an unreported bug, please run the \fBperlbug\fR +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 \f(CW\*(C`perl \-V\*(C'\fR, will be sent off to perlbug@perl.org to be +analysed by the Perl porting team. +.PP +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 will 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. +.SH "SEE ALSO" +.IX Header "SEE ALSO" +The \fIChanges\fR file for an explanation of how to view exhaustive details +on what changed. +.PP +The \fIINSTALL\fR file for how to build Perl. +.PP +The \fIREADME\fR file for general stuff. +.PP +The \fIArtistic\fR and \fICopying\fR files for copyright information. |