cpython/BeOS/README

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