| 1 | If you read this file _as_is_, just ignore the funny characters you see. |
| 2 | It is written in the POD format (see pod/perlpod.pod) which is specially |
| 3 | designed to be readable as is. |
| 4 | |
| 5 | =head1 NAME |
| 6 | |
| 7 | README.hurd - Perl version 5 on Hurd |
| 8 | |
| 9 | =head1 DESCRIPTION |
| 10 | |
| 11 | If you want to use Perl on the Hurd, I recommend using the Debian |
| 12 | GNU/Hurd distribution ( see http://www.debian.org/ ), even if an |
| 13 | official, stable release has not yet been made. The old "gnu-0.2" |
| 14 | binary distribution will most certainly have additional problems. |
| 15 | |
| 16 | =head2 Known Problems with Perl on Hurd |
| 17 | |
| 18 | The Perl test suite may still report some errors on the Hurd. The |
| 19 | "lib/anydbm" and "pragma/warnings" tests will almost certainly fail. |
| 20 | Both failures are not really specific to the Hurd, as indicated by the |
| 21 | test suite output. |
| 22 | |
| 23 | The socket tests may fail if the network is not configured. You have |
| 24 | to make "/hurd/pfinet" the translator for "/servers/socket/2", giving |
| 25 | it the right arguments. Try "/hurd/pfinet --help" for more |
| 26 | information. |
| 27 | |
| 28 | Here are the statistics for Perl 5.005_62 on my system: |
| 29 | |
| 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. |
| 37 | |
| 38 | There are quite a few systems out there that do worse! |
| 39 | |
| 40 | However, since I am running a very recent Hurd snapshot, in which a lot of |
| 41 | bugs that were exposed by the Perl test suite have been fixed, you may |
| 42 | encounter more failures. Likely candidates are: "op/stat", "lib/io_pipe", |
| 43 | "lib/io_sock", "lib/io_udp" and "lib/time". |
| 44 | |
| 45 | In any way, if you're seeing failures beyond those mentioned in this |
| 46 | document, please consider upgrading to the latest Hurd before reporting |
| 47 | the failure as a bug. |
| 48 | |
| 49 | =head1 AUTHOR |
| 50 | |
| 51 | Mark Kettenis <kettenis@gnu.org> |
| 52 | |
| 53 | Last Updated: Fri, 29 Oct 1999 22:50:30 +0200 |
| 54 | |