Debian Codegraph @

upstream/debian-unstable/man1/perl588delta.1

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
3 .\"
4 .\" Standard preamble:
5 .\" ========================================================================
6 .de Sp \" Vertical space (when we can't use .PP)
7 .if t .sp .5v
8 .if n .sp
9 ..
10 .de Vb \" Begin verbatim text
11 .ft CW
12 .nf
13 .ne \\$1
14 ..
15 .de Ve \" End verbatim text
16 .ft R
17 .fi
18 ..
19 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20 .ie n \{\
21 . ds C` ""
22 . ds C' ""
23 'br\}
24 .el\{\
25 . ds C`
26 . ds C'
27 'br\}
28 .\"
29 .\" Escape single quotes in literal strings from groff's Unicode transform.
30 .ie \n(.g .ds Aq \(aq
31 .el .ds Aq '
32 .\"
33 .\" If the F register is >0, we'll generate index entries on stderr for
34 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35 .\" entries marked with X<> in POD. Of course, you'll have to process the
36 .\" output yourself in some meaningful fashion.
37 .\"
38 .\" Avoid warning from groff about undefined register 'F'.
39 .de IX
40 ..
41 .nr rF 0
42 .if \n(.g .if rF .nr rF 1
43 .if (\n(rF:(\n(.g==0)) \{\
44 . if \nF \{\
45 . de IX
46 . tm Index:\\$1\t\\n%\t"\\$2"
47 ..
48 . if !\nF==2 \{\
49 . nr % 0
50 . nr F 2
51 . \}
52 . \}
53 .\}
54 .rr rF
55 .\" ========================================================================
56 .\"
57 .IX Title "PERL588DELTA 1"
58 .TH PERL588DELTA 1 2025-11-16 "perl v5.40.1" "Perl Programmers Reference Guide"
59 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
60 .\" way too many mistakes in technical documents.
61 .if n .ad l
62 .nh
63 .SH NAME
64 perl588delta \- what is new for perl v5.8.8
65 .SH DESCRIPTION
66 .IX Header "DESCRIPTION"
67 This document describes differences between the 5.8.7 release and
68 the 5.8.8 release.
69 .SH "Incompatible Changes"
70 .IX Header "Incompatible Changes"
71 There are no changes intentionally incompatible with 5.8.7. If any exist,
72 they are bugs and reports are welcome.
73 .SH "Core Enhancements"
74 .IX Header "Core Enhancements"
75 .IP \(bu 4
76 \&\f(CW\*(C`chdir\*(C'\fR, \f(CW\*(C`chmod\*(C'\fR and \f(CW\*(C`chown\*(C'\fR can now work on filehandles as well as
77 filenames, if the system supports respectively \f(CW\*(C`fchdir\*(C'\fR, \f(CW\*(C`fchmod\*(C'\fR and
78 \&\f(CW\*(C`fchown\*(C'\fR, thanks to a patch provided by Gisle Aas.
79 .SH "Modules and Pragmata"
80 .IX Header "Modules and Pragmata"
81 .IP \(bu 4
82 \&\f(CW\*(C`Attribute::Handlers\*(C'\fR upgraded to version 0.78_02
83 .RS 4
84 .IP \(bu 4
85 Documentation typo fix
86 .RE
87 .RS 4
88 .RE
89 .IP \(bu 4
90 \&\f(CW\*(C`attrs\*(C'\fR upgraded to version 1.02
91 .RS 4
92 .IP \(bu 4
93 Internal cleanup only
94 .RE
95 .RS 4
96 .RE
97 .IP \(bu 4
98 \&\f(CW\*(C`autouse\*(C'\fR upgraded to version 1.05
99 .RS 4
100 .IP \(bu 4
101 Simplified implementation
102 .RE
103 .RS 4
104 .RE
105 .IP \(bu 4
106 \&\f(CW\*(C`B\*(C'\fR upgraded to version 1.09_01
107 .RS 4
108 .IP \(bu 4
109 The inheritance hierarchy of the \f(CW\*(C`B::\*(C'\fR modules has been corrected;
110 \&\f(CW\*(C`B::NV\*(C'\fR now inherits from \f(CW\*(C`B::SV\*(C'\fR (instead of \f(CW\*(C`B::IV\*(C'\fR).
111 .RE
112 .RS 4
113 .RE
114 .IP \(bu 4
115 \&\f(CW\*(C`blib\*(C'\fR upgraded to version 1.03
116 .RS 4
117 .IP \(bu 4
118 Documentation typo fix
119 .RE
120 .RS 4
121 .RE
122 .IP \(bu 4
123 \&\f(CW\*(C`ByteLoader\*(C'\fR upgraded to version 0.06
124 .RS 4
125 .IP \(bu 4
126 Internal cleanup
127 .RE
128 .RS 4
129 .RE
130 .IP \(bu 4
131 \&\f(CW\*(C`CGI\*(C'\fR upgraded to version 3.15
132 .RS 4
133 .IP \(bu 4
134 Extraneous "?" from \f(CWself_url()\fR removed
135 .IP \(bu 4
136 \&\f(CWscrolling_list()\fR select attribute fixed
137 .IP \(bu 4
138 \&\f(CW\*(C`virtual_port\*(C'\fR now works properly with the https protocol
139 .IP \(bu 4
140 \&\f(CWupload_hook()\fR and \f(CWappend()\fR now works in function-oriented mode
141 .IP \(bu 4
142 \&\f(CW\*(C`POST_MAX\*(C'\fR doesn't cause the client to hang any more
143 .IP \(bu 4
144 Automatic tab indexes are now disabled and new \f(CW\*(C`\-tabindex\*(C'\fR pragma has
145 been added to turn automatic indexes back on
146 .IP \(bu 4
147 \&\f(CWend_form()\fR doesn't emit empty (and non-validating) \f(CW\*(C`<div>\*(C'\fR
148 .IP \(bu 4
149 \&\f(CW\*(C`CGI::Carp\*(C'\fR works better in certain mod_perl configurations
150 .IP \(bu 4
151 Setting \f(CW$CGI::TMPDIRECTORY\fR is now effective
152 .IP \(bu 4
153 Enhanced documentation
154 .RE
155 .RS 4
156 .RE
157 .IP \(bu 4
158 \&\f(CW\*(C`charnames\*(C'\fR upgraded to version 1.05
159 .RS 4
160 .IP \(bu 4
161 \&\f(CWviacode()\fR now accept hex strings and has been optimized.
162 .RE
163 .RS 4
164 .RE
165 .IP \(bu 4
166 \&\f(CW\*(C`CPAN\*(C'\fR upgraded to version 1.76_02
167 .RS 4
168 .IP \(bu 4
169 1 minor bug fix for Win32
170 .RE
171 .RS 4
172 .RE
173 .IP \(bu 4
174 \&\f(CW\*(C`Cwd\*(C'\fR upgraded to version 3.12
175 .RS 4
176 .IP \(bu 4
177 \&\f(CWcanonpath()\fR on Win32 now collapses \fIfoo\e..\fR sections correctly.
178 .IP \(bu 4
179 Improved behaviour on Symbian OS.
180 .IP \(bu 4
181 Enhanced documentation and typo fixes
182 .IP \(bu 4
183 Internal cleanup
184 .RE
185 .RS 4
186 .RE
187 .IP \(bu 4
188 \&\f(CW\*(C`Data::Dumper\*(C'\fR upgraded to version 2.121_08
189 .RS 4
190 .IP \(bu 4
191 A problem where \f(CW\*(C`Data::Dumper\*(C'\fR would sometimes update the iterator state
192 of hashes has been fixed
193 .IP \(bu 4
194 Numeric labels now work
195 .IP \(bu 4
196 Internal cleanup
197 .RE
198 .RS 4
199 .RE
200 .IP \(bu 4
201 \&\f(CW\*(C`DB\*(C'\fR upgraded to version 1.01
202 .RS 4
203 .IP \(bu 4
204 A problem where the state of the regexp engine would sometimes get clobbered when running
205 under the debugger has been fixed.
206 .RE
207 .RS 4
208 .RE
209 .IP \(bu 4
210 \&\f(CW\*(C`DB_File\*(C'\fR upgraded to version 1.814
211 .RS 4
212 .IP \(bu 4
213 Adds support for Berkeley DB 4.4.
214 .RE
215 .RS 4
216 .RE
217 .IP \(bu 4
218 \&\f(CW\*(C`Devel::DProf\*(C'\fR upgraded to version 20050603.00
219 .RS 4
220 .IP \(bu 4
221 Internal cleanup
222 .RE
223 .RS 4
224 .RE
225 .IP \(bu 4
226 \&\f(CW\*(C`Devel::Peek\*(C'\fR upgraded to version 1.03
227 .RS 4
228 .IP \(bu 4
229 Internal cleanup
230 .RE
231 .RS 4
232 .RE
233 .IP \(bu 4
234 \&\f(CW\*(C`Devel::PPPort\*(C'\fR upgraded to version 3.06_01
235 .RS 4
236 .IP \(bu 4
237 \&\f(CW\*(C`\-\-compat\-version\*(C'\fR argument checking has been improved
238 .IP \(bu 4
239 Files passed on the command line are filtered by default
240 .IP \(bu 4
241 \&\f(CW\*(C`\-\-nofilter\*(C'\fR option to override the filtering has been added
242 .IP \(bu 4
243 Enhanced documentation
244 .RE
245 .RS 4
246 .RE
247 .IP \(bu 4
248 \&\f(CW\*(C`diagnostics\*(C'\fR upgraded to version 1.15
249 .RS 4
250 .IP \(bu 4
251 Documentation typo fix
252 .RE
253 .RS 4
254 .RE
255 .IP \(bu 4
256 \&\f(CW\*(C`Digest\*(C'\fR upgraded to version 1.14
257 .RS 4
258 .IP \(bu 4
259 The constructor now knows which module implements SHA\-224
260 .IP \(bu 4
261 Documentation tweaks and typo fixes
262 .RE
263 .RS 4
264 .RE
265 .IP \(bu 4
266 \&\f(CW\*(C`Digest::MD5\*(C'\fR upgraded to version 2.36
267 .RS 4
268 .IP \(bu 4
269 \&\f(CW\*(C`XSLoader\*(C'\fR is now used for faster loading
270 .IP \(bu 4
271 Enhanced documentation including MD5 weaknesses discovered lately
272 .RE
273 .RS 4
274 .RE
275 .IP \(bu 4
276 \&\f(CW\*(C`Dumpvalue\*(C'\fR upgraded to version 1.12
277 .RS 4
278 .IP \(bu 4
279 Documentation fix
280 .RE
281 .RS 4
282 .RE
283 .IP \(bu 4
284 \&\f(CW\*(C`DynaLoader\*(C'\fR upgraded but unfortunately we're not able to increment its version number :\-(
285 .RS 4
286 .IP \(bu 4
287 Implements \f(CW\*(C`dl_unload_file\*(C'\fR on Win32
288 .IP \(bu 4
289 Internal cleanup
290 .IP \(bu 4
291 \&\f(CW\*(C`XSLoader\*(C'\fR 0.06 incorporated; small optimisation for calling
292 \&\f(CWbootstrap_inherit()\fR and documentation enhancements.
293 .RE
294 .RS 4
295 .RE
296 .IP \(bu 4
297 \&\f(CW\*(C`Encode\*(C'\fR upgraded to version 2.12
298 .RS 4
299 .IP \(bu 4
300 A coderef is now acceptable for \f(CW\*(C`CHECK\*(C'\fR!
301 .IP \(bu 4
302 3 new characters added to the ISO\-8859\-7 encoding
303 .IP \(bu 4
304 New encoding \f(CW\*(C`MIME\-Header\-ISO_2022_JP\*(C'\fR added
305 .IP \(bu 4
306 Problem with partial characters and \f(CWencoding(utf\-8\-strict)\fR fixed.
307 .IP \(bu 4
308 Documentation enhancements and typo fixes
309 .RE
310 .RS 4
311 .RE
312 .IP \(bu 4
313 \&\f(CW\*(C`English\*(C'\fR upgraded to version 1.02
314 .RS 4
315 .IP \(bu 4
316 the \f(CW$COMPILING\fR variable has been added
317 .RE
318 .RS 4
319 .RE
320 .IP \(bu 4
321 \&\f(CW\*(C`ExtUtils::Constant\*(C'\fR upgraded to version 0.17
322 .RS 4
323 .IP \(bu 4
324 Improved compatibility with older versions of perl
325 .RE
326 .RS 4
327 .RE
328 .IP \(bu 4
329 \&\f(CW\*(C`ExtUtils::MakeMaker\*(C'\fR upgraded to version 6.30 (was 6.17)
330 .RS 4
331 .IP \(bu 4
332 Too much to list here; see <http://search.cpan.org/dist/ExtUtils\-MakeMaker/Changes>
333 .RE
334 .RS 4
335 .RE
336 .IP \(bu 4
337 \&\f(CW\*(C`File::Basename\*(C'\fR upgraded to version 2.74, with changes contributed by Michael Schwern.
338 .RS 4
339 .IP \(bu 4
340 Documentation clarified and errors corrected.
341 .IP \(bu 4
342 \&\f(CW\*(C`basename\*(C'\fR now strips trailing path separators before processing the name.
343 .IP \(bu 4
344 \&\f(CW\*(C`basename\*(C'\fR now returns \f(CW\*(C`/\*(C'\fR for parameter \f(CW\*(C`/\*(C'\fR, to make \f(CW\*(C`basename\*(C'\fR
345 consistent with the shell utility of the same name.
346 .IP \(bu 4
347 The suffix is no longer stripped if it is identical to the remaining characters
348 in the name, again for consistency with the shell utility.
349 .IP \(bu 4
350 Some internal code cleanup.
351 .RE
352 .RS 4
353 .RE
354 .IP \(bu 4
355 \&\f(CW\*(C`File::Copy\*(C'\fR upgraded to version 2.09
356 .RS 4
357 .IP \(bu 4
358 Copying a file onto itself used to fail.
359 .IP \(bu 4
360 Moving a file between file systems now preserves the access and
361 modification time stamps
362 .RE
363 .RS 4
364 .RE
365 .IP \(bu 4
366 \&\f(CW\*(C`File::Find\*(C'\fR upgraded to version 1.10
367 .RS 4
368 .IP \(bu 4
369 Win32 portability fixes
370 .IP \(bu 4
371 Enhanced documentation
372 .RE
373 .RS 4
374 .RE
375 .IP \(bu 4
376 \&\f(CW\*(C`File::Glob\*(C'\fR upgraded to version 1.05
377 .RS 4
378 .IP \(bu 4
379 Internal cleanup
380 .RE
381 .RS 4
382 .RE
383 .IP \(bu 4
384 \&\f(CW\*(C`File::Path\*(C'\fR upgraded to version 1.08
385 .RS 4
386 .IP \(bu 4
387 \&\f(CW\*(C`mkpath\*(C'\fR now preserves \f(CW\*(C`errno\*(C'\fR when \f(CW\*(C`mkdir\*(C'\fR fails
388 .RE
389 .RS 4
390 .RE
391 .IP \(bu 4
392 \&\f(CW\*(C`File::Spec\*(C'\fR upgraded to version 3.12
393 .RS 4
394 .IP \(bu 4
395 \&\f(CW\*(C`File::Spec\->rootdir()\*(C'\fR now returns \f(CW\*(C`\e\*(C'\fR on Win32, instead of \f(CW\*(C`/\*(C'\fR
396 .IP \(bu 4
397 \&\f(CW$^O\fR could sometimes become tainted. This has been fixed.
398 .IP \(bu 4
399 \&\f(CW\*(C`canonpath\*(C'\fR on Win32 now collapses \f(CW\*(C`foo/..\*(C'\fR (or \f(CW\*(C`foo\e..\*(C'\fR) sections
400 correctly, rather than doing the "misguided" work it was previously doing.
401 Note that \f(CW\*(C`canonpath\*(C'\fR on Unix still does \fBnot\fR collapse these sections, as
402 doing so would be incorrect.
403 .IP \(bu 4
404 Some documentation improvements
405 .IP \(bu 4
406 Some internal code cleanup
407 .RE
408 .RS 4
409 .RE
410 .IP \(bu 4
411 \&\f(CW\*(C`FileCache\*(C'\fR upgraded to version 1.06
412 .RS 4
413 .IP \(bu 4
414 POD formatting errors in the documentation fixed
415 .RE
416 .RS 4
417 .RE
418 .IP \(bu 4
419 \&\f(CW\*(C`Filter::Simple\*(C'\fR upgraded to version 0.82
420 .IP \(bu 4
421 \&\f(CW\*(C`FindBin\*(C'\fR upgraded to version 1.47
422 .RS 4
423 .IP \(bu 4
424 Now works better with directories where access rights are more
425 restrictive than usual.
426 .RE
427 .RS 4
428 .RE
429 .IP \(bu 4
430 \&\f(CW\*(C`GDBM_File\*(C'\fR upgraded to version 1.08
431 .RS 4
432 .IP \(bu 4
433 Internal cleanup
434 .RE
435 .RS 4
436 .RE
437 .IP \(bu 4
438 \&\f(CW\*(C`Getopt::Long\*(C'\fR upgraded to version 2.35
439 .RS 4
440 .IP \(bu 4
441 \&\f(CW\*(C`prefix_pattern\*(C'\fR has now been complemented by a new configuration
442 option \f(CW\*(C`long_prefix_pattern\*(C'\fR that allows the user to specify what
443 prefix patterns should have long option style semantics applied.
444 .IP \(bu 4
445 Options can now take multiple values at once (experimental)
446 .IP \(bu 4
447 Various bug fixes
448 .RE
449 .RS 4
450 .RE
451 .IP \(bu 4
452 \&\f(CW\*(C`if\*(C'\fR upgraded to version 0.05
453 .RS 4
454 .IP \(bu 4
455 Give more meaningful error messages from \f(CW\*(C`if\*(C'\fR when invoked with a
456 condition in list context.
457 .IP \(bu 4
458 Restore backwards compatibility with earlier versions of perl
459 .RE
460 .RS 4
461 .RE
462 .IP \(bu 4
463 \&\f(CW\*(C`IO\*(C'\fR upgraded to version 1.22
464 .RS 4
465 .IP \(bu 4
466 Enhanced documentation
467 .IP \(bu 4
468 Internal cleanup
469 .RE
470 .RS 4
471 .RE
472 .IP \(bu 4
473 \&\f(CW\*(C`IPC::Open2\*(C'\fR upgraded to version 1.02
474 .RS 4
475 .IP \(bu 4
476 Enhanced documentation
477 .RE
478 .RS 4
479 .RE
480 .IP \(bu 4
481 \&\f(CW\*(C`IPC::Open3\*(C'\fR upgraded to version 1.02
482 .RS 4
483 .IP \(bu 4
484 Enhanced documentation
485 .RE
486 .RS 4
487 .RE
488 .IP \(bu 4
489 \&\f(CW\*(C`List::Util\*(C'\fR upgraded to version 1.18 (was 1.14)
490 .RS 4
491 .IP \(bu 4
492 Fix pure-perl version of \f(CW\*(C`refaddr\*(C'\fR to avoid blessing an un-blessed reference
493 .IP \(bu 4
494 Use \f(CW\*(C`XSLoader\*(C'\fR for faster loading
495 .IP \(bu 4
496 Fixed various memory leaks
497 .IP \(bu 4
498 Internal cleanup and portability fixes
499 .RE
500 .RS 4
501 .RE
502 .IP \(bu 4
503 \&\f(CW\*(C`Math::Complex\*(C'\fR upgraded to version 1.35
504 .RS 4
505 .IP \(bu 4
506 \&\f(CW\*(C`atan2(0, i)\*(C'\fR now works, as do all the (computable) complex argument cases
507 .IP \(bu 4
508 Fixes for certain bugs in \f(CW\*(C`make\*(C'\fR and \f(CW\*(C`emake\*(C'\fR
509 .IP \(bu 4
510 Support returning the \fIk\fRth root directly
511 .IP \(bu 4
512 Support \f(CW\*(C`[2,\-3pi/8]\*(C'\fR in \f(CW\*(C`emake\*(C'\fR
513 .IP \(bu 4
514 Support \f(CW\*(C`inf\*(C'\fR for \f(CW\*(C`make\*(C'\fR/\f(CW\*(C`emake\*(C'\fR
515 .IP \(bu 4
516 Document \f(CW\*(C`make\*(C'\fR/\f(CW\*(C`emake\*(C'\fR more visibly
517 .RE
518 .RS 4
519 .RE
520 .IP \(bu 4
521 \&\f(CW\*(C`Math::Trig\*(C'\fR upgraded to version 1.03
522 .RS 4
523 .IP \(bu 4
524 Add more great circle routines: \f(CW\*(C`great_circle_waypoint\*(C'\fR and
525 \&\f(CW\*(C`great_circle_destination\*(C'\fR
526 .RE
527 .RS 4
528 .RE
529 .IP \(bu 4
530 \&\f(CW\*(C`MIME::Base64\*(C'\fR upgraded to version 3.07
531 .RS 4
532 .IP \(bu 4
533 Use \f(CW\*(C`XSLoader\*(C'\fR for faster loading
534 .IP \(bu 4
535 Enhanced documentation
536 .IP \(bu 4
537 Internal cleanup
538 .RE
539 .RS 4
540 .RE
541 .IP \(bu 4
542 \&\f(CW\*(C`NDBM_File\*(C'\fR upgraded to version 1.06
543 .RS 4
544 .IP \(bu 4
545 Enhanced documentation
546 .RE
547 .RS 4
548 .RE
549 .IP \(bu 4
550 \&\f(CW\*(C`ODBM_File\*(C'\fR upgraded to version 1.06
551 .RS 4
552 .IP \(bu 4
553 Documentation typo fixed
554 .IP \(bu 4
555 Internal cleanup
556 .RE
557 .RS 4
558 .RE
559 .IP \(bu 4
560 \&\f(CW\*(C`Opcode\*(C'\fR upgraded to version 1.06
561 .RS 4
562 .IP \(bu 4
563 Enhanced documentation
564 .IP \(bu 4
565 Internal cleanup
566 .RE
567 .RS 4
568 .RE
569 .IP \(bu 4
570 \&\f(CW\*(C`open\*(C'\fR upgraded to version 1.05
571 .RS 4
572 .IP \(bu 4
573 Enhanced documentation
574 .RE
575 .RS 4
576 .RE
577 .IP \(bu 4
578 \&\f(CW\*(C`overload\*(C'\fR upgraded to version 1.04
579 .RS 4
580 .IP \(bu 4
581 Enhanced documentation
582 .RE
583 .RS 4
584 .RE
585 .IP \(bu 4
586 \&\f(CW\*(C`PerlIO\*(C'\fR upgraded to version 1.04
587 .RS 4
588 .IP \(bu 4
589 \&\f(CW\*(C`PerlIO::via\*(C'\fR iterate over layers properly now
590 .IP \(bu 4
591 \&\f(CW\*(C`PerlIO::scalar\*(C'\fR understands \f(CW\*(C`$/ = ""\*(C'\fR now
592 .IP \(bu 4
593 \&\f(CWencoding(utf\-8\-strict)\fR with partial characters now works
594 .IP \(bu 4
595 Enhanced documentation
596 .IP \(bu 4
597 Internal cleanup
598 .RE
599 .RS 4
600 .RE
601 .IP \(bu 4
602 \&\f(CW\*(C`Pod::Functions\*(C'\fR upgraded to version 1.03
603 .RS 4
604 .IP \(bu 4
605 Documentation typos fixed
606 .RE
607 .RS 4
608 .RE
609 .IP \(bu 4
610 \&\f(CW\*(C`Pod::Html\*(C'\fR upgraded to version 1.0504
611 .RS 4
612 .IP \(bu 4
613 HTML output will now correctly link
614 to \f(CW\*(C`=item\*(C'\fRs on the same page, and should be valid XHTML.
615 .IP \(bu 4
616 Variable names are recognized as intended
617 .IP \(bu 4
618 Documentation typos fixed
619 .RE
620 .RS 4
621 .RE
622 .IP \(bu 4
623 \&\f(CW\*(C`Pod::Parser\*(C'\fR upgraded to version 1.32
624 .RS 4
625 .IP \(bu 4
626 Allow files that start with \f(CW\*(C`=head\*(C'\fR on the first line
627 .IP \(bu 4
628 Win32 portability fix
629 .IP \(bu 4
630 Exit status of \f(CW\*(C`pod2usage\*(C'\fR fixed
631 .IP \(bu 4
632 New \f(CW\*(C`\-noperldoc\*(C'\fR switch for \f(CW\*(C`pod2usage\*(C'\fR
633 .IP \(bu 4
634 Arbitrary URL schemes now allowed
635 .IP \(bu 4
636 Documentation typos fixed
637 .RE
638 .RS 4
639 .RE
640 .IP \(bu 4
641 \&\f(CW\*(C`POSIX\*(C'\fR upgraded to version 1.09
642 .RS 4
643 .IP \(bu 4
644 Documentation typos fixed
645 .IP \(bu 4
646 Internal cleanup
647 .RE
648 .RS 4
649 .RE
650 .IP \(bu 4
651 \&\f(CW\*(C`re\*(C'\fR upgraded to version 0.05
652 .RS 4
653 .IP \(bu 4
654 Documentation typo fixed
655 .RE
656 .RS 4
657 .RE
658 .IP \(bu 4
659 \&\f(CW\*(C`Safe\*(C'\fR upgraded to version 2.12
660 .RS 4
661 .IP \(bu 4
662 Minor documentation enhancement
663 .RE
664 .RS 4
665 .RE
666 .IP \(bu 4
667 \&\f(CW\*(C`SDBM_File\*(C'\fR upgraded to version 1.05
668 .RS 4
669 .IP \(bu 4
670 Documentation typo fixed
671 .IP \(bu 4
672 Internal cleanup
673 .RE
674 .RS 4
675 .RE
676 .IP \(bu 4
677 \&\f(CW\*(C`Socket\*(C'\fR upgraded to version 1.78
678 .RS 4
679 .IP \(bu 4
680 Internal cleanup
681 .RE
682 .RS 4
683 .RE
684 .IP \(bu 4
685 \&\f(CW\*(C`Storable\*(C'\fR upgraded to version 2.15
686 .RS 4
687 .IP \(bu 4
688 This includes the \f(CW\*(C`STORABLE_attach\*(C'\fR hook functionality added by
689 Adam Kennedy, and more frugal memory requirements when storing under \f(CW\*(C`ithreads\*(C'\fR, by
690 using the \f(CW\*(C`ithreads\*(C'\fR cloning tracking code.
691 .RE
692 .RS 4
693 .RE
694 .IP \(bu 4
695 \&\f(CW\*(C`Switch\*(C'\fR upgraded to version 2.10_01
696 .RS 4
697 .IP \(bu 4
698 Documentation typos fixed
699 .RE
700 .RS 4
701 .RE
702 .IP \(bu 4
703 \&\f(CW\*(C`Sys::Syslog\*(C'\fR upgraded to version 0.13
704 .RS 4
705 .IP \(bu 4
706 Now provides numeric macros and meaningful \f(CW\*(C`Exporter\*(C'\fR tags.
707 .IP \(bu 4
708 No longer uses \f(CW\*(C`Sys::Hostname\*(C'\fR as it may provide useless values in
709 unconfigured network environments, so instead uses \f(CW\*(C`INADDR_LOOPBACK\*(C'\fR directly.
710 .IP \(bu 4
711 \&\f(CWsyslog()\fR now uses local timestamp.
712 .IP \(bu 4
713 \&\f(CWsetlogmask()\fR now behaves like its C counterpart.
714 .IP \(bu 4
715 \&\f(CWsetlogsock()\fR will now \f(CWcroak()\fR as documented.
716 .IP \(bu 4
717 Improved error and warnings messages.
718 .IP \(bu 4
719 Improved documentation.
720 .RE
721 .RS 4
722 .RE
723 .IP \(bu 4
724 \&\f(CW\*(C`Term::ANSIColor\*(C'\fR upgraded to version 1.10
725 .RS 4
726 .IP \(bu 4
727 Fixes a bug in \f(CW\*(C`colored\*(C'\fR when \f(CW$EACHLINE\fR is set that caused it to not color
728 lines consisting solely of 0 (literal zero).
729 .IP \(bu 4
730 Improved tests.
731 .RE
732 .RS 4
733 .RE
734 .IP \(bu 4
735 \&\f(CW\*(C`Term::ReadLine\*(C'\fR upgraded to version 1.02
736 .RS 4
737 .IP \(bu 4
738 Documentation tweaks
739 .RE
740 .RS 4
741 .RE
742 .IP \(bu 4
743 \&\f(CW\*(C`Test::Harness\*(C'\fR upgraded to version 2.56 (was 2.48)
744 .RS 4
745 .IP \(bu 4
746 The \f(CW\*(C`Test::Harness\*(C'\fR timer is now off by default.
747 .IP \(bu 4
748 Now shows elapsed time in milliseconds.
749 .IP \(bu 4
750 Various bug fixes
751 .RE
752 .RS 4
753 .RE
754 .IP \(bu 4
755 \&\f(CW\*(C`Test::Simple\*(C'\fR upgraded to version 0.62 (was 0.54)
756 .RS 4
757 .IP \(bu 4
758 \&\f(CWis_deeply()\fR no longer fails to work for many cases
759 .IP \(bu 4
760 Various minor bug fixes
761 .IP \(bu 4
762 Documentation enhancements
763 .RE
764 .RS 4
765 .RE
766 .IP \(bu 4
767 \&\f(CW\*(C`Text::Tabs\*(C'\fR upgraded to version 2005.0824
768 .RS 4
769 .IP \(bu 4
770 Provides a faster implementation of \f(CW\*(C`expand\*(C'\fR
771 .RE
772 .RS 4
773 .RE
774 .IP \(bu 4
775 \&\f(CW\*(C`Text::Wrap\*(C'\fR upgraded to version 2005.082401
776 .RS 4
777 .IP \(bu 4
778 Adds \f(CW$Text::Wrap::separator2\fR, which allows you to preserve existing newlines
779 but add line-breaks with some other string.
780 .RE
781 .RS 4
782 .RE
783 .IP \(bu 4
784 \&\f(CW\*(C`threads\*(C'\fR upgraded to version 1.07
785 .RS 4
786 .IP \(bu 4
787 \&\f(CW\*(C`threads\*(C'\fR will now honour \f(CW\*(C`no warnings \*(Aqthreads\*(Aq\*(C'\fR
788 .IP \(bu 4
789 A thread's interpreter is now freed after \f(CW\*(C`$t\->join()\*(C'\fR rather than after
790 \&\f(CW\*(C`undef $t\*(C'\fR, which should fix some \f(CW\*(C`ithreads\*(C'\fR memory leaks. (Fixed by Dave
791 Mitchell)
792 .IP \(bu 4
793 Some documentation typo fixes.
794 .RE
795 .RS 4
796 .RE
797 .IP \(bu 4
798 \&\f(CW\*(C`threads::shared\*(C'\fR upgraded to version 0.94
799 .RS 4
800 .IP \(bu 4
801 Documentation changes only
802 .IP \(bu 4
803 Note: An improved implementation of \f(CW\*(C`threads::shared\*(C'\fR is available on
804 CPAN \- this will be merged into 5.8.9 if it proves stable.
805 .RE
806 .RS 4
807 .RE
808 .IP \(bu 4
809 \&\f(CW\*(C`Tie::Hash\*(C'\fR upgraded to version 1.02
810 .RS 4
811 .IP \(bu 4
812 Documentation typo fixed
813 .RE
814 .RS 4
815 .RE
816 .IP \(bu 4
817 \&\f(CW\*(C`Time::HiRes\*(C'\fR upgraded to version 1.86 (was 1.66)
818 .RS 4
819 .IP \(bu 4
820 \&\f(CWclock_nanosleep()\fR and \f(CWclock()\fR functions added
821 .IP \(bu 4
822 Support for the POSIX \f(CWclock_gettime()\fR and \f(CWclock_getres()\fR has been added
823 .IP \(bu 4
824 Return \f(CW\*(C`undef\*(C'\fR or an empty list if the C \f(CWgettimeofday()\fR function fails
825 .IP \(bu 4
826 Improved \f(CW\*(C`nanosleep\*(C'\fR detection
827 .IP \(bu 4
828 Internal cleanup
829 .IP \(bu 4
830 Enhanced documentation
831 .RE
832 .RS 4
833 .RE
834 .IP \(bu 4
835 \&\f(CW\*(C`Unicode::Collate\*(C'\fR upgraded to version 0.52
836 .RS 4
837 .IP \(bu 4
838 Now implements UCA Revision 14 (based on Unicode 4.1.0).
839 .IP \(bu 4
840 \&\f(CW\*(C`Unicode::Collate\->new\*(C'\fR method no longer overwrites user's \f(CW$_\fR
841 .IP \(bu 4
842 Enhanced documentation
843 .RE
844 .RS 4
845 .RE
846 .IP \(bu 4
847 \&\f(CW\*(C`Unicode::UCD\*(C'\fR upgraded to version 0.24
848 .RS 4
849 .IP \(bu 4
850 Documentation typos fixed
851 .RE
852 .RS 4
853 .RE
854 .IP \(bu 4
855 \&\f(CW\*(C`User::grent\*(C'\fR upgraded to version 1.01
856 .RS 4
857 .IP \(bu 4
858 Documentation typo fixed
859 .RE
860 .RS 4
861 .RE
862 .IP \(bu 4
863 \&\f(CW\*(C`utf8\*(C'\fR upgraded to version 1.06
864 .RS 4
865 .IP \(bu 4
866 Documentation typos fixed
867 .RE
868 .RS 4
869 .RE
870 .IP \(bu 4
871 \&\f(CW\*(C`vmsish\*(C'\fR upgraded to version 1.02
872 .RS 4
873 .IP \(bu 4
874 Documentation typos fixed
875 .RE
876 .RS 4
877 .RE
878 .IP \(bu 4
879 \&\f(CW\*(C`warnings\*(C'\fR upgraded to version 1.05
880 .RS 4
881 .IP \(bu 4
882 Gentler messing with \f(CW\*(C`Carp::\*(C'\fR internals
883 .IP \(bu 4
884 Internal cleanup
885 .IP \(bu 4
886 Documentation update
887 .RE
888 .RS 4
889 .RE
890 .IP \(bu 4
891 \&\f(CW\*(C`Win32\*(C'\fR upgraded to version 0.2601
892 .RS 4
893 .IP \(bu 4
894 Provides Windows Vista support to \f(CW\*(C`Win32::GetOSName\*(C'\fR
895 .IP \(bu 4
896 Documentation enhancements
897 .RE
898 .RS 4
899 .RE
900 .IP \(bu 4
901 \&\f(CW\*(C`XS::Typemap\*(C'\fR upgraded to version 0.02
902 .RS 4
903 .IP \(bu 4
904 Internal cleanup
905 .RE
906 .RS 4
907 .RE
908 .SH "Utility Changes"
909 .IX Header "Utility Changes"
910 .ie n .SS """h2xs"" enhancements"
911 .el .SS "\f(CWh2xs\fP enhancements"
912 .IX Subsection "h2xs enhancements"
913 \&\f(CW\*(C`h2xs\*(C'\fR implements new option \f(CW\*(C`\-\-use\-xsloader\*(C'\fR to force use of
914 \&\f(CW\*(C`XSLoader\*(C'\fR even in backwards compatible modules.
915 .PP
916 The handling of authors' names that had apostrophes has been fixed.
917 .PP
918 Any enums with negative values are now skipped.
919 .ie n .SS """perlivp"" enhancements"
920 .el .SS "\f(CWperlivp\fP enhancements"
921 .IX Subsection "perlivp enhancements"
922 \&\f(CW\*(C`perlivp\*(C'\fR implements new option \f(CW\*(C`\-a\*(C'\fR and will not check for \fI*.ph\fR
923 files by default any more. Use the \f(CW\*(C`\-a\*(C'\fR option to run \fIall\fR tests.
924 .SH "New Documentation"
925 .IX Header "New Documentation"
926 The perlglossary manpage is a glossary of terms used in the Perl
927 documentation, technical and otherwise, kindly provided by O'Reilly Media,
928 inc.
929 .SH "Performance Enhancements"
930 .IX Header "Performance Enhancements"
931 .IP \(bu 4
932 Weak reference creation is now \fIO(1)\fR rather than \fIO(n)\fR, courtesy of
933 Nicholas Clark. Weak reference deletion remains \fIO(n)\fR, but if deletion only
934 happens at program exit, it may be skipped completely.
935 .IP \(bu 4
936 Salvador FandiƱo provided improvements to reduce the memory usage of \f(CW\*(C`sort\*(C'\fR
937 and to speed up some cases.
938 .IP \(bu 4
939 Jarkko Hietaniemi and Andy Lester worked to mark as much data as possible in
940 the C source files as \f(CW\*(C`static\*(C'\fR, to increase the proportion of the executable
941 file that the operating system can share between process, and thus reduce
942 real memory usage on multi-user systems.
943 .SH "Installation and Configuration Improvements"
944 .IX Header "Installation and Configuration Improvements"
945 Parallel makes should work properly now, although there may still be problems
946 if \f(CW\*(C`make test\*(C'\fR is instructed to run in parallel.
947 .PP
948 Building with Borland's compilers on Win32 should work more smoothly. In
949 particular Steve Hay has worked to side step many warnings emitted by their
950 compilers and at least one C compiler internal error.
951 .PP
952 \&\f(CW\*(C`Configure\*(C'\fR will now detect \f(CW\*(C`clearenv\*(C'\fR and \f(CW\*(C`unsetenv\*(C'\fR, thanks to a patch
953 from Alan Burlison. It will also probe for \f(CW\*(C`futimes\*(C'\fR and whether \f(CW\*(C`sprintf\*(C'\fR
954 correctly returns the length of the formatted string, which will both be used
955 in perl 5.8.9.
956 .PP
957 There are improved hints for next\-3.0, vmesa, IX, Darwin, Solaris, Linux,
958 DEC/OSF, HP-UX and MPE/iX
959 .PP
960 Perl extensions on Windows now can be statically built into the Perl DLL,
961 thanks to a work by Vadim Konovalov. (This improvement was actually in 5.8.7,
962 but was accidentally omitted from perl587delta).
963 .SH "Selected Bug Fixes"
964 .IX Header "Selected Bug Fixes"
965 .SS "no warnings 'category' works correctly with \-w"
966 .IX Subsection "no warnings 'category' works correctly with -w"
967 Previously when running with warnings enabled globally via \f(CW\*(C`\-w\*(C'\fR, selective
968 disabling of specific warning categories would actually turn off all warnings.
969 This is now fixed; now \f(CW\*(C`no warnings \*(Aqio\*(Aq;\*(C'\fR will only turn off warnings in the
970 \&\f(CW\*(C`io\*(C'\fR class. Previously it would erroneously turn off all warnings.
971 .PP
972 This bug fix may cause some programs to start correctly issuing warnings.
973 .SS "Remove over-optimisation"
974 .IX Subsection "Remove over-optimisation"
975 Perl 5.8.4 introduced a change so that assignments of \f(CW\*(C`undef\*(C'\fR to a
976 scalar, or of an empty list to an array or a hash, were optimised away. As
977 this could cause problems when \f(CW\*(C`goto\*(C'\fR jumps were involved, this change
978 has been backed out.
979 .SS "\fBsprintf()\fP fixes"
980 .IX Subsection "sprintf() fixes"
981 Using the \fBsprintf()\fR function with some formats could lead to a buffer
982 overflow in some specific cases. This has been fixed, along with several
983 other bugs, notably in bounds checking.
984 .PP
985 In related fixes, it was possible for badly written code that did not follow
986 the documentation of \f(CW\*(C`Sys::Syslog\*(C'\fR to have formatting vulnerabilities.
987 \&\f(CW\*(C`Sys::Syslog\*(C'\fR has been changed to protect people from poor quality third
988 party code.
989 .SS "Debugger and Unicode slowdown"
990 .IX Subsection "Debugger and Unicode slowdown"
991 It had been reported that running under perl's debugger when processing
992 Unicode data could cause unexpectedly large slowdowns. The most likely cause
993 of this was identified and fixed by Nicholas Clark.
994 .SS "Smaller fixes"
995 .IX Subsection "Smaller fixes"
996 .IP \(bu 4
997 \&\f(CW\*(C`FindBin\*(C'\fR now works better with directories where access rights are more
998 restrictive than usual.
999 .IP \(bu 4
1000 Several memory leaks in ithreads were closed. An improved implementation of
1001 \&\f(CW\*(C`threads::shared\*(C'\fR is available on CPAN \- this will be merged into 5.8.9 if
1002 it proves stable.
1003 .IP \(bu 4
1004 Trailing spaces are now trimmed from \f(CW$!\fR and \f(CW$^E\fR.
1005 .IP \(bu 4
1006 Operations that require perl to read a process's list of groups, such as reads
1007 of \f(CW$(\fR and \f(CW$)\fR, now dynamically allocate memory rather than using a
1008 fixed sized array. The fixed size array could cause C stack exhaustion on
1009 systems configured to use large numbers of groups.
1010 .IP \(bu 4
1011 \&\f(CW\*(C`PerlIO::scalar\*(C'\fR now works better with non-default \f(CW$/\fR settings.
1012 .IP \(bu 4
1013 You can now use the \f(CW\*(C`x\*(C'\fR operator to repeat a \f(CW\*(C`qw//\*(C'\fR list. This used
1014 to raise a syntax error.
1015 .IP \(bu 4
1016 The debugger now traces correctly execution in eval("")uated code that
1017 contains #line directives.
1018 .IP \(bu 4
1019 The value of the \f(CW\*(C`open\*(C'\fR pragma is no longer ignored for three-argument
1020 opens.
1021 .IP \(bu 4
1022 The optimisation of \f(CW\*(C`for (reverse @a)\*(C'\fR introduced in perl 5.8.6 could
1023 misbehave when the array had undefined elements and was used in LVALUE
1024 context. Dave Mitchell provided a fix.
1025 .IP \(bu 4
1026 Some case insensitive matches between UTF\-8 encoded data and 8 bit regexps,
1027 and vice versa, could give malformed character warnings. These have been
1028 fixed by Dave Mitchell and Yves Orton.
1029 .IP \(bu 4
1030 \&\f(CW\*(C`lcfirst\*(C'\fR and \f(CW\*(C`ucfirst\*(C'\fR could corrupt the string for certain cases where
1031 the length UTF\-8 encoding of the string in lower case, upper case or title
1032 case differed. This was fixed by Nicholas Clark.
1033 .IP \(bu 4
1034 Perl will now use the C library calls \f(CW\*(C`unsetenv\*(C'\fR and \f(CW\*(C`clearenv\*(C'\fR if present
1035 to delete keys from \f(CW%ENV\fR and delete \f(CW%ENV\fR entirely, thanks to a patch
1036 from Alan Burlison.
1037 .SH "New or Changed Diagnostics"
1038 .IX Header "New or Changed Diagnostics"
1039 .SS "Attempt to set length of freed array"
1040 .IX Subsection "Attempt to set length of freed array"
1041 This is a new warning, produced in situations such as this:
1042 .PP
1043 .Vb 2
1044 \& $r = do {my @a; \e$#a};
1045 \& $$r = 503;
1046 .Ve
1047 .SS "Non-string passed as bitmask"
1048 .IX Subsection "Non-string passed as bitmask"
1049 This is a new warning, produced when number has been passed as an argument to
1050 \&\fBselect()\fR, instead of a bitmask.
1051 .PP
1052 .Vb 3
1053 \& # Wrong, will now warn
1054 \& $rin = fileno(STDIN);
1055 \& ($nfound,$timeleft) = select($rout=$rin, undef, undef, $timeout);
1056 \&
1057 \& # Should be
1058 \& $rin = \*(Aq\*(Aq;
1059 \& vec($rin,fileno(STDIN),1) = 1;
1060 \& ($nfound,$timeleft) = select($rout=$rin, undef, undef, $timeout);
1061 .Ve
1062 .SS "Search pattern not terminated or ternary operator parsed as search pattern"
1063 .IX Subsection "Search pattern not terminated or ternary operator parsed as search pattern"
1064 This syntax error indicates that the lexer couldn't find the final
1065 delimiter of a \f(CW\*(C`?PATTERN?\*(C'\fR construct. Mentioning the ternary operator in
1066 this error message makes it easier to diagnose syntax errors.
1067 .SH "Changed Internals"
1068 .IX Header "Changed Internals"
1069 There has been a fair amount of refactoring of the \f(CW\*(C`C\*(C'\fR source code, partly to
1070 make it tidier and more maintainable. The resulting object code and the
1071 \&\f(CW\*(C`perl\*(C'\fR binary may well be smaller than 5.8.7, in particular due to a change
1072 contributed by Dave Mitchell which reworked the warnings code to be
1073 significantly smaller. Apart from being smaller and possibly faster, there
1074 should be no user-detectable changes.
1075 .PP
1076 Andy Lester supplied many improvements to determine which function
1077 parameters and local variables could actually be declared \f(CW\*(C`const\*(C'\fR to the C
1078 compiler. Steve Peters provided new \f(CW*_set\fR macros and reworked the core to
1079 use these rather than assigning to macros in LVALUE context.
1080 .PP
1081 Dave Mitchell improved the lexer debugging output under \f(CW\*(C`\-DT\*(C'\fR
1082 .PP
1083 Nicholas Clark changed the string buffer allocation so that it is now rounded
1084 up to the next multiple of 4 (or 8 on platforms with 64 bit pointers). This
1085 should reduce the number of calls to \f(CW\*(C`realloc\*(C'\fR without actually using any
1086 extra memory.
1087 .PP
1088 The \f(CW\*(C`HV\*(C'\fR's array of \f(CW\*(C`HE*\*(C'\fRs is now allocated at the correct (minimal) size,
1089 thanks to another change by Nicholas Clark. Compile with
1090 \&\f(CW\*(C`\-DPERL_USE_LARGE_HV_ALLOC\*(C'\fR to use the old, sloppier, default.
1091 .PP
1092 For XS or embedding debugging purposes, if perl is compiled with
1093 \&\f(CW\*(C`\-DDEBUG_LEAKING_SCALARS_FORK_DUMP\*(C'\fR in addition to
1094 \&\f(CW\*(C`\-DDEBUG_LEAKING_SCALARS\*(C'\fR then a child process is \f(CW\*(C`fork\*(C'\fRed just before
1095 global destruction, which is used to display the values of any scalars
1096 found to have leaked at the end of global destruction. Without this, the
1097 scalars have already been freed sufficiently at the point of detection that
1098 it is impossible to produce any meaningful dump of their contents. This
1099 feature was implemented by the indefatigable Nicholas Clark, based on an idea
1100 by Mike Giroux.
1101 .SH "Platform Specific Problems"
1102 .IX Header "Platform Specific Problems"
1103 The optimiser on HP-UX 11.23 (Itanium 2) is currently partly disabled (scaled
1104 down to +O1) when using HP C\-ANSI-C; the cause of problems at higher
1105 optimisation levels is still unclear.
1106 .PP
1107 There are a handful of remaining test failures on VMS, mostly due to
1108 test fixes and minor module tweaks with too many dependencies to
1109 integrate into this release from the development stream, where they have
1110 all been corrected. The following is a list of expected failures with
1111 the patch number of the fix where that is known:
1112 .PP
1113 .Vb 6
1114 \& ext/Devel/PPPort/t/ppphtest.t #26913
1115 \& ext/List/Util/t/p_tainted.t #26912
1116 \& lib/ExtUtils/t/PL_FILES.t #26813
1117 \& lib/ExtUtils/t/basic.t #26813
1118 \& t/io/fs.t
1119 \& t/op/cmp.t
1120 .Ve
1121 .SH "Reporting Bugs"
1122 .IX Header "Reporting Bugs"
1123 If you find what you think is a bug, you might check the articles
1124 recently posted to the comp.lang.perl.misc newsgroup and the perl
1125 bug database at http://bugs.perl.org. There may also be
1126 information at http://www.perl.org, the Perl Home Page.
1127 .PP
1128 If you believe you have an unreported bug, please run the \fBperlbug\fR
1129 program included with your release. Be sure to trim your bug down
1130 to a tiny but sufficient test case. Your bug report, along with the
1131 output of \f(CW\*(C`perl \-V\*(C'\fR, will be sent off to [email protected] to be
1132 analysed by the Perl porting team. You can browse and search
1133 the Perl 5 bugs at http://bugs.perl.org/
1134 .SH "SEE ALSO"
1135 .IX Header "SEE ALSO"
1136 The \fIChanges\fR file for exhaustive details on what changed.
1137 .PP
1138 The \fIINSTALL\fR file for how to build Perl.
1139 .PP
1140 The \fIREADME\fR file for general stuff.
1141 .PP
1142 The \fIArtistic\fR and \fICopying\fR files for copyright information.