path: root/upstream/debian-unstable/man1/perl585delta.1

.\" -*- 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 "PERL585DELTA 1"
.TH PERL585DELTA 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
perl585delta \- what is new for perl v5.8.5
.SH DESCRIPTION
.IX Header "DESCRIPTION"
This document describes differences between the 5.8.4 release and
the 5.8.5 release.
.SH "Incompatible Changes"
.IX Header "Incompatible Changes"
There are no changes incompatible with 5.8.4.
.SH "Core Enhancements"
.IX Header "Core Enhancements"
Perl's regular expression engine now contains support for matching on the
intersection of two Unicode character classes. You can also now refer to
user-defined character classes from within other user defined character
classes.
.SH "Modules and Pragmata"
.IX Header "Modules and Pragmata"
.IP \(bu 4
Carp improved to work nicely with Safe. Carp's message reporting should now
be anomaly free \- it will always print out line number information.
.IP \(bu 4
CGI upgraded to version 3.05
.IP \(bu 4
charnames now avoids clobbering \f(CW$_\fR
.IP \(bu 4
Digest upgraded to version 1.08
.IP \(bu 4
Encode upgraded to version 2.01
.IP \(bu 4
FileCache upgraded to version 1.04
.IP \(bu 4
libnet upgraded to version 1.19
.IP \(bu 4
Pod::Parser upgraded to version 1.28
.IP \(bu 4
Pod::Perldoc upgraded to version 3.13
.IP \(bu 4
Pod::LaTeX upgraded to version 0.57
.IP \(bu 4
Safe now works properly with Carp
.IP \(bu 4
Scalar-List-Utils upgraded to version 1.14
.IP \(bu 4
Shell's documentation has been re-written, and its historical partial
auto-quoting of command arguments can now be disabled.
.IP \(bu 4
Test upgraded to version 1.25
.IP \(bu 4
Test::Harness upgraded to version 2.42
.IP \(bu 4
Time::Local upgraded to version 1.10
.IP \(bu 4
Unicode::Collate upgraded to version 0.40
.IP \(bu 4
Unicode::Normalize upgraded to version 0.30
.SH "Utility Changes"
.IX Header "Utility Changes"
.SS "Perl's debugger"
.IX Subsection "Perl's debugger"
The debugger can now emulate stepping backwards, by restarting and rerunning
all bar the last command from a saved command history.
.SS h2ph
.IX Subsection "h2ph"
\&\fIh2ph\fR is now able to understand a very limited set of C inline functions
\&\-\- basically, the inline functions that look like CPP macros. This has
been introduced to deal with some of the headers of the newest versions of
the glibc. The standard warning still applies; to quote \fIh2ph\fR's
documentation, \fIyou may need to dicker with the files produced\fR.
.SH "Installation and Configuration Improvements"
.IX Header "Installation and Configuration Improvements"
Perl 5.8.5 should build cleanly from source on LynxOS.
.SH "Selected Bug Fixes"
.IX Header "Selected Bug Fixes"
.IP \(bu 4
The in-place sort optimisation introduced in 5.8.4 had a bug. For example,
in code such as
.Sp
.Vb 1
\&    @a = sort ($b, @a)
.Ve
.Sp
the result would omit the value \f(CW$b\fR. This is now fixed.
.IP \(bu 4
The optimisation for unnecessary assignments introduced in 5.8.4 could give
spurious warnings. This has been fixed.
.IP \(bu 4
Perl should now correctly detect and read BOM-marked and (BOMless) UTF\-16
scripts of either endianness.
.IP \(bu 4
Creating a new thread when weak references exist was buggy, and would often
cause warnings at interpreter destruction time. The known bug is now fixed.
.IP \(bu 4
Several obscure bugs involving manipulating Unicode strings with \f(CW\*(C`substr\*(C'\fR have
been fixed.
.IP \(bu 4
Previously if Perl's file globbing function encountered a directory that it
did not have permission to open it would return immediately, leading to
unexpected truncation of the list of results. This has been fixed, to be
consistent with Unix shells' globbing behaviour.
.IP \(bu 4
Thread creation time could vary wildly between identical runs. This was caused
by a poor hashing algorithm in the thread cloning routines, which has now
been fixed.
.IP \(bu 4
The internals of the ithreads implementation were not checking if OS-level
thread creation had failed. threads\->\fBcreate()\fR now returns \f(CW\*(C`undef\*(C'\fR in if
thread creation fails instead of crashing perl.
.SH "New or Changed Diagnostics"
.IX Header "New or Changed Diagnostics"
.IP \(bu 4
Perl \-V has several improvements
.RS 4
.IP \(bu 4
correctly outputs local patch names that contain embedded code snippets
or other characters that used to confuse it.
.IP \(bu 4
arguments to \-V that look like regexps will give multiple lines of output.
.IP \(bu 4
a trailing colon suppresses the linefeed and ';'  terminator, allowing
embedding of queries into shell commands.
.IP \(bu 4
a leading colon removes the 'name=' part of the response, allowing mapping to
any name.
.RE
.RS 4
.RE
.IP \(bu 4
When perl fails to find the specified script, it now outputs a second line
suggesting that the user use the \f(CW\*(C`\-S\*(C'\fR flag:
.Sp
.Vb 3
\&    $ perl5.8.5 missing.pl
\&    Can\*(Aqt open perl script "missing.pl": No such file or directory.
\&    Use \-S to search $PATH for it.
.Ve
.SH "Changed Internals"
.IX Header "Changed Internals"
The Unicode character class files used by the regular expression engine are
now built at build time from the supplied Unicode consortium data files,
instead of being shipped prebuilt. This makes the compressed Perl source
tarball about 200K smaller. A side effect is that the layout of files inside
lib/unicore has changed.
.SH "Known Problems"
.IX Header "Known Problems"
The regression test \fIt/uni/class.t\fR is now performing considerably more
tests, and can take several minutes to run even on a fast machine.
.SH "Platform Specific Problems"
.IX Header "Platform Specific Problems"
This release is known not to build on Windows 95.
.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://bugs.perl.org.  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.  You can browse and search
the Perl 5 bugs at http://bugs.perl.org/
.SH "SEE ALSO"
.IX Header "SEE ALSO"
The \fIChanges\fR file for 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.