| 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 | perlhaiku - Perl version 5.10+ on Haiku |
| 8 | |
| 9 | =head1 DESCRIPTION |
| 10 | |
| 11 | This file contains instructions how to build Perl for Haiku and lists |
| 12 | known problems. |
| 13 | |
| 14 | =head1 BUILD AND INSTALL |
| 15 | |
| 16 | The build procedure is completely standard: |
| 17 | |
| 18 | ./Configure -de |
| 19 | make |
| 20 | make install |
| 21 | |
| 22 | Make perl executable and create a symlink for libperl: |
| 23 | |
| 24 | chmod a+x /boot/common/bin/perl |
| 25 | cd /boot/common/lib; ln -s perl5/5.17.5/BePC-haiku/CORE/libperl.so . |
| 26 | |
| 27 | Replace C<5.17.5> with your respective version of Perl. |
| 28 | |
| 29 | =head1 KNOWN PROBLEMS |
| 30 | |
| 31 | The following problems are encountered with Haiku revision 28311: |
| 32 | |
| 33 | =over 4 |
| 34 | |
| 35 | =item * |
| 36 | |
| 37 | Perl cannot be compiled with threading support ATM. |
| 38 | |
| 39 | =item * |
| 40 | |
| 41 | The F<ext/Socket/t/socketpair.t> test fails. More precisely: the subtests |
| 42 | using datagram sockets fail. Unix datagram sockets aren't implemented in |
| 43 | Haiku yet. |
| 44 | |
| 45 | =item * |
| 46 | |
| 47 | A subtest of the F<ext/Sys/Syslog/t/syslog.t> test fails. This is due to Haiku |
| 48 | not implementing C</dev/log> support yet. |
| 49 | |
| 50 | =item * |
| 51 | |
| 52 | The tests F<lib/Net/Ping/t/450_service.t> and F<lib/Net/Ping/t/510_ping_udp.t> |
| 53 | fail. This is due to bugs in Haiku's network stack implementation. |
| 54 | |
| 55 | =back |
| 56 | |
| 57 | =head1 CONTACT |
| 58 | |
| 59 | For Haiku specific problems contact the HaikuPorts developers: |
| 60 | L<http://ports.haiku-files.org/> |
| 61 | |
| 62 | The initial Haiku port was done by Ingo Weinhold <ingo_weinhold@gmx.de>. |
| 63 | |
| 64 | Last update: 2008-10-29 |