README.haiku

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