diff options
Diffstat (limited to 'upstream/debian-unstable/man1/perl5141delta.1')
| -rw-r--r-- | upstream/debian-unstable/man1/perl5141delta.1 | 304 |
1 files changed, 304 insertions, 0 deletions
diff --git a/upstream/debian-unstable/man1/perl5141delta.1 b/upstream/debian-unstable/man1/perl5141delta.1 new file mode 100644 index 00000000..ab09920f --- /dev/null +++ b/upstream/debian-unstable/man1/perl5141delta.1 @@ -0,0 +1,304 @@ +.\" -*- 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 "PERL5141DELTA 1" +.TH PERL5141DELTA 1 2024-01-12 "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 +perl5141delta \- what is new for perl v5.14.1 +.SH DESCRIPTION +.IX Header "DESCRIPTION" +This document describes differences between the 5.14.0 release and +the 5.14.1 release. +.PP +If you are upgrading from an earlier release such as 5.12.0, first read +perl5140delta, which describes differences between 5.12.0 and +5.14.0. +.SH "Core Enhancements" +.IX Header "Core Enhancements" +No changes since 5.14.0. +.SH Security +.IX Header "Security" +No changes since 5.14.0. +.SH "Incompatible Changes" +.IX Header "Incompatible Changes" +There are no changes intentionally incompatible with 5.14.0. If any +exist, they are bugs and reports are welcome. +.SH Deprecations +.IX Header "Deprecations" +There have been no deprecations since 5.14.0. +.SH "Modules and Pragmata" +.IX Header "Modules and Pragmata" +.SS "New Modules and Pragmata" +.IX Subsection "New Modules and Pragmata" +None +.SS "Updated Modules and Pragmata" +.IX Subsection "Updated Modules and Pragmata" +.IP \(bu 4 +B::Deparse has been upgraded from version 1.03 to 1.04, to address two +regressions in Perl 5.14.0: +.Sp +Deparsing of the \f(CW\*(C`glob\*(C'\fR operator and its diamond (\f(CW\*(C`<>\*(C'\fR) form now +works again. [perl #90898] +.Sp +The presence of subroutines named \f(CW\*(C`::::\*(C'\fR or \f(CW\*(C`::::::\*(C'\fR no longer causes +B::Deparse to hang. +.IP \(bu 4 +Pod::Perldoc has been upgraded from version 3.15_03 to 3.15_04. +.Sp +It corrects the search paths on VMS. [perl #90640] +.SS "Removed Modules and Pragmata" +.IX Subsection "Removed Modules and Pragmata" +None +.SH Documentation +.IX Header "Documentation" +.SS "New Documentation" +.IX Subsection "New Documentation" +None +.SS "Changes to Existing Documentation" +.IX Subsection "Changes to Existing Documentation" +\fIperlfunc\fR +.IX Subsection "perlfunc" +.IP \(bu 4 +\&\f(CW\*(C`given\*(C'\fR, \f(CW\*(C`when\*(C'\fR and \f(CW\*(C`default\*(C'\fR are now listed in perlfunc. +.IP \(bu 4 +Documentation for \f(CW\*(C`use\*(C'\fR now includes a pointer to \fIif.pm\fR. +.PP +\fIperllol\fR +.IX Subsection "perllol" +.IP \(bu 4 +perllol has been expanded with examples using the new \f(CW\*(C`push $scalar\*(C'\fR +syntax introduced in Perl 5.14.0. +.PP +\fIperlop\fR +.IX Subsection "perlop" +.IP \(bu 4 +The explanation of bitwise operators has been expanded to explain how they +work on Unicode strings. +.IP \(bu 4 +The section on the triple-dot or yada-yada operator has been moved up, as +it used to separate two closely related sections about the comma operator. +.IP \(bu 4 +More examples for \f(CW\*(C`m//g\*(C'\fR have been added. +.IP \(bu 4 +The \f(CW\*(C`<<\eFOO\*(C'\fR here-doc syntax has been documented. +.PP +\fIperlrun\fR +.IX Subsection "perlrun" +.IP \(bu 4 +perlrun has undergone a significant clean-up. Most notably, the +\&\fB\-0x...\fR form of the \fB\-0\fR flag has been clarified, and the final section +on environment variables has been corrected and expanded. +.PP +\fIPOSIX\fR +.IX Subsection "POSIX" +.IP \(bu 4 +The invocation documentation for \f(CW\*(C`WIFEXITED\*(C'\fR, \f(CW\*(C`WEXITSTATUS\*(C'\fR, +\&\f(CW\*(C`WIFSIGNALED\*(C'\fR, \f(CW\*(C`WTERMSIG\*(C'\fR, \f(CW\*(C`WIFSTOPPED\*(C'\fR, and \f(CW\*(C`WSTOPSIG\*(C'\fR was corrected. +.SH Diagnostics +.IX Header "Diagnostics" +The following additions or changes have been made to diagnostic output, +including warnings and fatal error messages. For the complete list of +diagnostic messages, see perldiag. +.SS "New Diagnostics" +.IX Subsection "New Diagnostics" +None +.SS "Changes to Existing Diagnostics" +.IX Subsection "Changes to Existing Diagnostics" +None +.SH "Utility Changes" +.IX Header "Utility Changes" +None +.SH "Configuration and Compilation" +.IX Header "Configuration and Compilation" +.IP \(bu 4 +\&\fIregexp.h\fR has been modified for compatibility with GCC's \f(CW\*(C`\-Werror\*(C'\fR +option, as used by some projects that include perl's header files. +.SH Testing +.IX Header "Testing" +.IP \(bu 4 +Some test failures in \fIdist/Locale\-Maketext/t/09_compile.t\fR that could +occur depending on the environment have been fixed. [perl #89896] +.IP \(bu 4 +A watchdog timer for \fIt/re/re.t\fR was lengthened to accommodate SH\-4 systems +which were unable to complete the tests before the previous timer ran out. +.SH "Platform Support" +.IX Header "Platform Support" +.SS "New Platforms" +.IX Subsection "New Platforms" +None +.SS "Discontinued Platforms" +.IX Subsection "Discontinued Platforms" +None +.SS "Platform-Specific Notes" +.IX Subsection "Platform-Specific Notes" +\fISolaris\fR +.IX Subsection "Solaris" +.IP \(bu 4 +Documentation listing the Solaris packages required to build Perl on +Solaris 9 and Solaris 10 has been corrected. +.PP +\fIMac OS X\fR +.IX Subsection "Mac OS X" +.IP \(bu 4 +The \fIlib/locale.t\fR test script has been updated to work on the upcoming +Lion release. +.IP \(bu 4 +Mac OS X specific compilation instructions have been clarified. +.PP +\fIUbuntu Linux\fR +.IX Subsection "Ubuntu Linux" +.IP \(bu 4 +The ODBM_File installation process has been updated with the new library +paths on Ubuntu natty. +.SH "Internal Changes" +.IX Header "Internal Changes" +.IP \(bu 4 +The compiled representation of formats is now stored via the mg_ptr of +their PERL_MAGIC_fm. Previously it was stored in the string buffer, +beyond \fBSvLEN()\fR, the regular end of the string. \fBSvCOMPILED()\fR and +SvCOMPILED_{on,off}() now exist solely for compatibility for XS code. +The first is always 0, the other two now no-ops. +.SH "Bug Fixes" +.IX Header "Bug Fixes" +.IP \(bu 4 +A bug has been fixed that would cause a "Use of freed value in iteration" +error if the next two hash elements that would be iterated over are +deleted. [perl #85026] +.IP \(bu 4 +Passing the same constant subroutine to both \f(CW\*(C`index\*(C'\fR and \f(CW\*(C`formline\*(C'\fR no +longer causes one or the other to fail. [perl #89218] +.IP \(bu 4 +5.14.0 introduced some memory leaks in regular expression character +classes such as \f(CW\*(C`[\ew\es]\*(C'\fR, which have now been fixed. +.IP \(bu 4 +An edge case in regular expression matching could potentially loop. +This happened only under \f(CW\*(C`/i\*(C'\fR in bracketed character classes that have +characters with multi-character folds, and the target string to match +against includes the first portion of the fold, followed by another +character that has a multi-character fold that begins with the remaining +portion of the fold, plus some more. +.Sp +.Vb 1 +\& "s\eN{U+DF}" =~ /[\ex{DF}foo]/i +.Ve +.Sp +is one such case. \f(CW\*(C`\exDF\*(C'\fR folds to \f(CW"ss"\fR. +.IP \(bu 4 +Several Unicode case-folding bugs have been fixed. +.IP \(bu 4 +The new (in 5.14.0) regular expression modifier \f(CW\*(C`/a\*(C'\fR when repeated like +\&\f(CW\*(C`/aa\*(C'\fR forbids the characters outside the ASCII range that match +characters inside that range from matching under \f(CW\*(C`/i\*(C'\fR. This did not +work under some circumstances, all involving alternation, such as: +.Sp +.Vb 1 +\& "\eN{KELVIN SIGN}" =~ /k|foo/iaa; +.Ve +.Sp +succeeded inappropriately. This is now fixed. +.IP \(bu 4 +Fixed a case where it was possible that a freed buffer may have been read +from when parsing a here document. +.SH Acknowledgements +.IX Header "Acknowledgements" +Perl 5.14.1 represents approximately four weeks of development since +Perl 5.14.0 and contains approximately 3500 lines of changes +across 38 files from 17 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.14.1: +.PP +Bo Lindbergh, Claudio Ramirez, Craig A. Berry, David Leadbeater, Father +Chrysostomos, Jesse Vincent, Jim Cromie, Justin Case, Karl Williamson, +Leo Lapworth, Nicholas Clark, Nobuhiro Iwamatsu, smash, Tom Christiansen, +Ton Hospel, Vladimir Timofeev, and Zsbán Ambrus. +.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 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 \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 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. |