cpython/BeOS/README
1998-08-04 17:57:28 +00:00

141 lines
5.1 KiB
Plaintext

Python 1.5.1 for BeOS
This directory contains several useful things to help you build your own
version of Python for BeOS.
At this time, Python only supports BeOS on the PowerPC platform; if you'd
like to help me port it to the x86 platform, please let me know (I only
have limited access to BeOS on an x86 system). If you'd like to lend
me an x86 laptop running BeOS to do the port, _definitely_ let me know! :-)
I'll even give it back when I'm done.
What's Here?
ar-1.1 - An "ar" command with a POSIX 1003.2 interface; you'll need
this for building the Python libraries under BeOS
(/bin/ar just won't cut it).
linkcc - A shell script used by the build process to build the Python
shared library.
linkmodule - A shell script used by the build process to build the
shared library versions of the standard modules; you'll
probably need this if you want to build dynamically loaded
modules from the Python archives.
PyImport_BeImageID.html - Documentation for a function added to the
Python interpreter under BeOS; not interesting
unless you're writing your own BeOS-specific
modules for dealing with dynamically-loaded
Python modules.
README - This file (obviously!).
README.readline-2.2 - Instructions for compiling/installing GNU readline 2.2.
You'll have to grab the GNU readline source code from
prep.ai.mit.edu:/pub/GNU or any other GNU mirror.
The Python interpreter is much nicer to work with
interactively if you've got readline installed. Highly
recommended.
Compiling Your Own Version
To compile your own version of Python 1.5.1 for BeOS (with any luck,
Python 1.6 will compile "out of the box" on BeOS), try this:
1) Get the Python 1.5.1 source code from ftp.python.org.
2) Get the Python 1.5.1 diffs from my web pages
(http://www.qnx.com/~chrish/Be/software/); if you can't get them through
a web browser, send me email and I'll mail them back to you. These
diffs should also be available at ftp.python.org along with the BeOS
binary archive.
Run autoconf. If you don't have autoconf, you can get a precompiled
version from GeekGadgets (ftp://ftp.ninemoons.com/pub/geekgadgets/...).
3) Compile and install the POSIX ar from the ar-1.1 directory; see the
README in there for details.
4) Configure with:
AR=ar-posix RANLIB=: ./configure --verbose --without-gcc \
--prefix=/boot/home/config --with-thread
The only strange thing that happens during the configure is that
we fail the "genuine getopt()" test; this is odd because we've got
a real live GNU getopt() in the system libs. Other packages built
using configure (such as all of the goodies in GeekGadgets) suffer
the same fate though, so it's not a Python problem.
5) Copy Modules/Setup.in to Modules/Setup.
6) Edit Modules/Setup to turn on all the modules you want built. I've
personally built the following modules:
array, audioop, binascii, cPickle, cStringIO, cmath, crypt, curses,
errno, fcntl, gdbm, grp, imageop, math, md5, new, operator, parser,
pcre, posix, pwd, readline, regex, reop, rgbimg, rotor, select,
signal, socket, soundex, strop, struct, syslog, termios, thread,
time, timing, zlib
Newly compiled/tested with 1.5.1:
_locale
You can get precompiled gdbm, ncurses, and zlib libraries from the
GeekGadgets repository (ftp://ftp.ninemoons.com/pub/geekgadgets/...).
Make sure you use _socket instead of socket for the name of the
socketmodule on BeOS.
7) Make:
make
or, if you feel the need for speed:
make OPT="-O7 -opt schedule604"
You can safely ignore any warnings you see during the build (and you'll
see several if you use full warnings; I compiled the distribution with
-w9 -ansi strict and cleaned up any errors...).
8) Test:
make test
Expect the following errors:
test_builtin failed -- round(1000000000.0)
test_fcntl skipped -- an optional feature could not be imported
test_grp crashed -- exceptions.KeyError : getgrnam(): name not found
test_pwd failed -- Writing: 'fakename', expected: 'caught e'
test_socket crashed -- exceptions.AttributeError : SOCK_RAW
These are all due to either partial support for certain things (like
sockets), or valid differences between systems (like the round()
error; different CPUs represent floating point numbers differently,
which can cause minor rounding errors).
9) Install:
make install
10) Enjoy!
NOTE
If you're going to build your own C/C++-based Python modules, link them
against the libpython1.5.so shared library (in /boot/home/config/lib)
instead of the libpython1.5.a (in /boot/home/config/lib/python1.5/config),
unless you're building a statically-linked python interpreter (then you
could try linking against _APP_ instead).
Mixing modules linked against the shared library with a statically-linked
interpreter is a bad idea (and it'll fail in _interesting_ ways).
- Chris Herborth (chrish@qnx.com)
April 25, 1998