Remove Encode::Tcl::Extended, suggested by
[p5sagit/p5-mst-13.2.git] / README.beos
CommitLineData
a83b6f46 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.
c4f23d77 4
a83b6f46 5=head1 NAME
6
7README.beos - Perl version 5 on BeOS
8
9=head1 DESCRIPTION
10
11Notes for building Perl under BeOS.
12
13=head2 General Issues with Perl on BeOS
c4f23d77 14
46193409 15To compile perl under BeOS R4 x86:
c4f23d77 16
a83b6f46 17 ./Configure -d
c4f23d77 18
a83b6f46 19and hit ^C when it asks you if you want to make changes to config.sh;
46193409 20edit config.sh and do the following:
21change d_socket='define' to ='undef';
22remove SDBM, Errno, and Socket from dynamic_ext= and nonxs_ext=;
46193409 23add '#define bool short' to x2p/a2p.h;
c4f23d77 24
a83b6f46 25 ../Configure -S; make; make install
26
27 cd ~/config/lib; ln -s 5.00502/BeOS-BePC/CORE/libperl.so .
c4f23d77 28
46193409 29(substitute 5.00502 with the appropriate filename)
c4f23d77 30
a83b6f46 31=head2 BeOS Release-specific Notes
32
33=over 4
34
35=item R4 x86
36
37Dynamic loading finally works! Yay! This means you can compile your
38own modules into perl. However, Sockets and Errno still don't work.
46193409 39(Hopefully, sockets will at least work by R5, if not sooner.)
c4f23d77 40
a83b6f46 41=item R4 PPC
42
43I have not tested this. I rather severely doubt that dynamic loading
44will work. (My BeBox is in pieces right now, following a nasty disk
45crash.) You may have to disable dynamic loading to get the thing to
46compile at all. (use `./Configure` without -d, and say 'no' to 'Build
47a shared libperl.so'.)
48
49=back
50
51=head2 Contact Information
c4f23d77 52
c4f23d77 53If you have comments, problem reports, or even patches or bugfixes (gasp!)
54please email me.
55
46193409 5628 Jan 1999
c4f23d77 57Tom Spindler
46193409 58dogcow@isi.net
c4f23d77 59
9c966d23 60=head2 Update 2002-03-02
dff18f87 61
9c966d23 62The following tests fail on pre-5.8.0 Perl in BeOS Personal 5.0:
dff18f87 63
64 op/magic 24-26
65 ext/POSIX/t/sigaction 13
66 ext/POSIX/t/waitpid 1
67 lib/ExtUtils/t/Installed 9-10 25-27 29-30 33-36
68
69None of the failures look too serious:
70
71=over 4
72
73=item *
74
75The op/magic failures look like something funny going on with $0 and
76$^X that I can't now figure out: none of the generated pathnames are
77wrong as such, they just seem to accumulate "./" prefixes and infixes
78in ways that define logic.
79
80=item *
81
82The sigaction #13 means that signal mask doesn't get properly restored
83if sigaction returns early.
84
85=item *
86
87The waitpid failure means that after there are no more child
9c966d23 88processes, waitpid is supposed to start returning -1 (and set
89errno to ECHILD). In BeOS, it doesn't seem to.
dff18f87 90
91=item *
92
93The Installed test has some filesystem portability assumptions.
94
95=back
96
97Disclaimer: I just installed BeOS Personal Edition 5.0 and the
98Developer Tools, that is the whole extent of my BeOS expertise,
9c966d23 99so please don't ask me for further help in BeOS Perl problems.
dff18f87 100
101jhi@iki.fi