Track /etc/gitconfig
[msysgit/mtrensch.git] / lib / perl5 / 5.8.8 / pods / perl585delta.pod
blob1717c74e0282b5463ba8cc5cb5cfaf4138e44054
1 =head1 NAME
3 perl585delta - what is new for perl v5.8.5
5 =head1 DESCRIPTION
7 This document describes differences between the 5.8.4 release and
8 the 5.8.5 release.
10 =head1 Incompatible Changes
12 There are no changes incompatible with 5.8.4.
14 =head1 Core Enhancements
16 Perl's regular expression engine now contains support for matching on the
17 intersection of two Unicode character classes. You can also now refer to
18 user-defined character classes from within other user defined character
19 classes.
21 =head1 Modules and Pragmata
23 =over 4
25 =item *
27 Carp improved to work nicely with Safe. Carp's message reporting should now
28 be anomaly free - it will always print out line number information.
30 =item *
32 CGI upgraded to version 3.05
34 =item *
36 charnames now avoids clobbering $_
38 =item *
40 Digest upgraded to version 1.08
42 =item *
44 Encode upgraded to version 2.01
46 =item *
48 FileCache upgraded to version 1.04
50 =item *
52 libnet upgraded to version 1.19
54 =item *
56 Pod::Parser upgraded to version 1.28
58 =item *
60 Pod::Perldoc upgraded to version 3.13
62 =item *
64 Pod::LaTeX upgraded to version 0.57
66 =item *
68 Safe now works properly with Carp
70 =item *
72 Scalar-List-Utils upgraded to version 1.14
74 =item *
76 Shell's documentation has been re-written, and its historical partial
77 auto-quoting of command arguments can now be disabled.
79 =item *
81 Test upgraded to version 1.25
83 =item *
85 Test::Harness upgraded to version 2.42
87 =item *
89 Time::Local upgraded to version 1.10
91 =item *
93 Unicode::Collate upgraded to version 0.40
95 =item *
97 Unicode::Normalize upgraded to version 0.30
99 =back
101 =head1 Utility Changes
103 =head2 Perl's debugger
105 The debugger can now emulate stepping backwards, by restarting and rerunning
106 all bar the last command from a saved command history.
108 =head2 h2ph
110 F<h2ph> is now able to understand a very limited set of C inline functions
111 -- basically, the inline functions that look like CPP macros. This has
112 been introduced to deal with some of the headers of the newest versions of
113 the glibc. The standard warning still applies; to quote F<h2ph>'s
114 documentation, I<you may need to dicker with the files produced>.
116 =head1 Installation and Configuration Improvements
118 Perl 5.8.5 should build cleanly from source on LynxOS.
120 =head1 Selected Bug Fixes
122 =over 4
124 =item *
126 The in-place sort optimisation introduced in 5.8.4 had a bug. For example,
127 in code such as
129     @a = sort ($b, @a)
131 the result would omit the value $b. This is now fixed.
133 =item *
135 The optimisation for unnecessary assignments introduced in 5.8.4 could give
136 spurious warnings. This has been fixed.
138 =item *
140 Perl should now correctly detect and read BOM-marked and (BOMless) UTF-16
141 scripts of either endianness.
143 =item *
145 Creating a new thread when weak references exist was buggy, and would often
146 cause warnings at interpreter destruction time. The known bug is now fixed.
148 =item *
150 Several obscure bugs involving manipulating Unicode strings with C<substr> have
151 been fixed.
153 =item *
155 Previously if Perl's file globbing function encountered a directory that it
156 did not have permission to open it would return immediately, leading to
157 unexpected truncation of the list of results. This has been fixed, to be
158 consistent with Unix shells' globbing behaviour.
160 =item *
162 Thread creation time could vary wildly between identical runs. This was caused
163 by a poor hashing algorithm in the thread cloning routines, which has now
164 been fixed.
166 =item *
168 The internals of the ithreads implementation were not checking if OS-level
169 thread creation had failed. threads->create() now returns C<undef> in if
170 thread creation fails instead of crashing perl.
172 =back
174 =head1 New or Changed Diagnostics
176 =over 4
178 =item *
180 Perl -V has several improvements
182 =over 4
184 =item  *
186 correctly outputs local patch names that contain embedded code snippets
187 or other characters that used to confuse it.
189 =item * 
191 arguments to -V that look like regexps will give multiple lines of output.
193 =item *
195 a trailing colon suppresses the linefeed and ';'  terminator, allowing
196 embedding of queries into shell commands.
198 =item *
200 a leading colon removes the 'name=' part of the response, allowing mapping to
201 any name.
203 =back
205 =item *
207 When perl fails to find the specified script, it now outputs a second line
208 suggesting that the user use the C<-S> flag:
210     $ perl5.8.5 missing.pl
211     Can't open perl script "missing.pl": No such file or directory.
212     Use -S to search $PATH for it.
214 =back
216 =head1 Changed Internals
218 The Unicode character class files used by the regular expression engine are
219 now built at build time from the supplied Unicode consortium data files,
220 instead of being shipped prebuilt. This makes the compressed Perl source
221 tarball about 200K smaller. A side effect is that the layout of files inside
222 lib/unicore has changed.
224 =head1 Known Problems
226 The regression test F<t/uni/class.t> is now performing considerably more
227 tests, and can take several minutes to run even on a fast machine.
229 =head1 Platform Specific Problems
231 This release is known not to build on Windows 95.
233 =head1 Reporting Bugs
235 If you find what you think is a bug, you might check the articles
236 recently posted to the comp.lang.perl.misc newsgroup and the perl
237 bug database at http://bugs.perl.org.  There may also be
238 information at http://www.perl.org, the Perl Home Page.
240 If you believe you have an unreported bug, please run the B<perlbug>
241 program included with your release.  Be sure to trim your bug down
242 to a tiny but sufficient test case.  Your bug report, along with the
243 output of C<perl -V>, will be sent off to perlbug@perl.org to be
244 analysed by the Perl porting team.  You can browse and search
245 the Perl 5 bugs at http://bugs.perl.org/
247 =head1 SEE ALSO
249 The F<Changes> file for exhaustive details on what changed.
251 The F<INSTALL> file for how to build Perl.
253 The F<README> file for general stuff.
255 The F<Artistic> and F<Copying> files for copyright information.
257 =cut