This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Add terse changelog entry for 2.29
[perl5.git] / README.hurd
CommitLineData
a83b6f46
JH
1If you read this file _as_is_, just ignore the funny characters you see.
2It is written in the POD format (see pod/perlpod.pod) which is specially
3designed to be readable as is.
4
5=head1 NAME
6
7README.hurd - Perl version 5 on Hurd
8
9=head1 DESCRIPTION
7b73750b 10
c2da85ba 11If you want to use Perl on the Hurd, I recommend using the Debian
f224927c 12GNU/Hurd distribution ( see http://www.debian.org/ ), even if an
b432a672 13official, stable release has not yet been made. The old "gnu-0.2"
c2da85ba 14binary distribution will most certainly have additional problems.
7b73750b 15
a83b6f46 16=head2 Known Problems with Perl on Hurd
7b73750b 17
0a74eaba 18The Perl test suite may still report some errors on the Hurd. The
b432a672 19"lib/anydbm" and "pragma/warnings" tests will almost certainly fail.
0a74eaba
JH
20Both failures are not really specific to the Hurd, as indicated by the
21test suite output.
7b73750b
GS
22
23The socket tests may fail if the network is not configured. You have
b432a672
AL
24to make "/hurd/pfinet" the translator for "/servers/socket/2", giving
25it the right arguments. Try "/hurd/pfinet --help" for more
c2da85ba 26information.
7b73750b 27
0a74eaba 28Here are the statistics for Perl 5.005_62 on my system:
7b73750b 29
a83b6f46
JH
30 Failed Test Status Wstat Total Fail Failed List of failed
31 -------------------------------------------------------------------------
32 lib/anydbm.t 12 1 8.33% 12
33 pragma/warnings 333 1 0.30% 215
34
35 8 tests and 24 subtests skipped.
36 Failed 2/229 test scripts, 99.13% okay. 2/10850 subtests failed, 99.98% okay.
c2da85ba
GS
37
38There are quite a few systems out there that do worse!
39
40However, since I am running a very recent Hurd snapshot, in which a lot of
0a74eaba 41bugs that were exposed by the Perl test suite have been fixed, you may
b432a672
AL
42encounter more failures. Likely candidates are: "op/stat", "lib/io_pipe",
43"lib/io_sock", "lib/io_udp" and "lib/time".
7b73750b 44
0a74eaba
JH
45In any way, if you're seeing failures beyond those mentioned in this
46document, please consider upgrading to the latest Hurd before reporting
47the failure as a bug.
a83b6f46
JH
48
49=head1 AUTHOR
50
51Mark Kettenis <kettenis@gnu.org>
52
53Last Updated: Fri, 29 Oct 1999 22:50:30 +0200
54