Guido van Rossum | fc4966b | 1998-12-17 18:00:33 +0000 | [diff] [blame] | 1 | Python 1.5.x (x > 1) for BeOS |
Guido van Rossum | d8eb211 | 1998-08-04 17:57:28 +0000 | [diff] [blame] | 2 | |
| 3 | This directory contains several useful things to help you build your own |
| 4 | version of Python for BeOS. |
| 5 | |
Guido van Rossum | d8eb211 | 1998-08-04 17:57:28 +0000 | [diff] [blame] | 6 | What's Here? |
| 7 | |
Guido van Rossum | fc4966b | 1998-12-17 18:00:33 +0000 | [diff] [blame] | 8 | ar-fake - A shell script used by the build process to emulate a "real" |
| 9 | POSIX ar command; helps to build the Python shared library. |
Guido van Rossum | d8eb211 | 1998-08-04 17:57:28 +0000 | [diff] [blame] | 10 | |
| 11 | linkcc - A shell script used by the build process to build the Python |
| 12 | shared library. |
| 13 | |
| 14 | linkmodule - A shell script used by the build process to build the |
| 15 | shared library versions of the standard modules; you'll |
| 16 | probably need this if you want to build dynamically loaded |
| 17 | modules from the Python archives. |
| 18 | |
Guido van Rossum | d8eb211 | 1998-08-04 17:57:28 +0000 | [diff] [blame] | 19 | README - This file (obviously!). |
| 20 | |
| 21 | README.readline-2.2 - Instructions for compiling/installing GNU readline 2.2. |
| 22 | You'll have to grab the GNU readline source code from |
| 23 | prep.ai.mit.edu:/pub/GNU or any other GNU mirror. |
| 24 | |
| 25 | The Python interpreter is much nicer to work with |
| 26 | interactively if you've got readline installed. Highly |
| 27 | recommended. |
| 28 | |
| 29 | Compiling Your Own Version |
| 30 | |
Guido van Rossum | fc4966b | 1998-12-17 18:00:33 +0000 | [diff] [blame] | 31 | To compile your own version of Python 1.5.x for BeOS (with any luck, |
| 32 | Python 1.5.2 and later will compile "out of the box" on BeOS), try this: |
Guido van Rossum | d8eb211 | 1998-08-04 17:57:28 +0000 | [diff] [blame] | 33 | |
Guido van Rossum | fc4966b | 1998-12-17 18:00:33 +0000 | [diff] [blame] | 34 | 1) Get the latest Python source code from ftp.python.org. |
Guido van Rossum | d8eb211 | 1998-08-04 17:57:28 +0000 | [diff] [blame] | 35 | |
Guido van Rossum | fc4966b | 1998-12-17 18:00:33 +0000 | [diff] [blame] | 36 | 2) Configure with: |
Guido van Rossum | d8eb211 | 1998-08-04 17:57:28 +0000 | [diff] [blame] | 37 | |
Guido van Rossum | eb45232 | 1998-12-18 22:00:58 +0000 | [diff] [blame] | 38 | AR=$(pwd)/BeOS/ar-fake RANLIB=: ./configure --verbose \ |
Guido van Rossum | d8eb211 | 1998-08-04 17:57:28 +0000 | [diff] [blame] | 39 | --prefix=/boot/home/config --with-thread |
Guido van Rossum | eb45232 | 1998-12-18 22:00:58 +0000 | [diff] [blame] | 40 | |
Guido van Rossum | 343848b | 1998-12-22 13:35:29 +0000 | [diff] [blame] | 41 | When configure is done, add this anywhere in config.h: |
Guido van Rossum | eb45232 | 1998-12-18 22:00:58 +0000 | [diff] [blame] | 42 | |
| 43 | #ifndef DL_EXPORT |
| 44 | # define DL_EXPORT(RTYPE) __declspec(dllexport) RTYPE |
| 45 | #endif |
| 46 | #ifndef DL_IMPORT |
| 47 | # ifdef USE_DL_EXPORT |
| 48 | # define DL_IMPORT(RTYPE) __declspec(dllexport) RTYPE |
| 49 | # else |
| 50 | # define DL_IMPORT(RTYPE) __declspec(dllimport) RTYPE |
| 51 | # endif |
| 52 | #endif |
| 53 | |
Guido van Rossum | fc4966b | 1998-12-17 18:00:33 +0000 | [diff] [blame] | 54 | 3) Copy Modules/Setup.in to Modules/Setup. |
Guido van Rossum | d8eb211 | 1998-08-04 17:57:28 +0000 | [diff] [blame] | 55 | |
Guido van Rossum | fc4966b | 1998-12-17 18:00:33 +0000 | [diff] [blame] | 56 | 4) Edit Modules/Setup to turn on all the modules you want built. |
Guido van Rossum | d8eb211 | 1998-08-04 17:57:28 +0000 | [diff] [blame] | 57 | |
Guido van Rossum | d8eb211 | 1998-08-04 17:57:28 +0000 | [diff] [blame] | 58 | Make sure you use _socket instead of socket for the name of the |
| 59 | socketmodule on BeOS. |
| 60 | |
Guido van Rossum | fc4966b | 1998-12-17 18:00:33 +0000 | [diff] [blame] | 61 | If you want the modules to be built as shared libraries, instead of as |
| 62 | part of the Python shared library, be sure to uncomment the #*shared* |
| 63 | line. |
Guido van Rossum | d8eb211 | 1998-08-04 17:57:28 +0000 | [diff] [blame] | 64 | |
Guido van Rossum | 343848b | 1998-12-22 13:35:29 +0000 | [diff] [blame] | 65 | I've tried the following modules: |
| 66 | |
| 67 | regex pcre posix signal readline array cmath math strop struct time |
| 68 | operator _locale fcntl pwd grp select _socket errno crypt termios |
| 69 | audioop imageop rgbimg md5 timing rotor syslog curses new gdbm soundex |
| 70 | binascii parser cStringIO cPickle zlib |
| 71 | |
Guido van Rossum | fc4966b | 1998-12-17 18:00:33 +0000 | [diff] [blame] | 72 | 5) Make sure Modules/Makefile.pre has REALLIBRARY set to: |
Guido van Rossum | d8eb211 | 1998-08-04 17:57:28 +0000 | [diff] [blame] | 73 | |
Guido van Rossum | fc4966b | 1998-12-17 18:00:33 +0000 | [diff] [blame] | 74 | REALLIBRARY=../libpython$(VERSION).so |
Guido van Rossum | d8eb211 | 1998-08-04 17:57:28 +0000 | [diff] [blame] | 75 | |
Guido van Rossum | fc4966b | 1998-12-17 18:00:33 +0000 | [diff] [blame] | 76 | 6) Make: |
| 77 | |
Guido van Rossum | 343848b | 1998-12-22 13:35:29 +0000 | [diff] [blame] | 78 | make OPT=-DUSE_DL_EXPORT CCSHARED=-UUSE_DL_EXPORT MACHDEP=beos |
Guido van Rossum | eb45232 | 1998-12-18 22:00:58 +0000 | [diff] [blame] | 79 | |
| 80 | On PowerPC systems, you'll see lots of warnings about duplicate |
| 81 | symbols when things get linked; don't worry about this, it's |
| 82 | harmless (and should disappear soon). |
| 83 | |
Guido van Rossum | fc4966b | 1998-12-17 18:00:33 +0000 | [diff] [blame] | 84 | 7) Test: |
| 85 | |
Guido van Rossum | f96cff2 | 1998-12-22 13:40:55 +0000 | [diff] [blame] | 86 | make OPT=-DUSE_DL_EXPORT CCSHARED=-UUSE_DL_EXPORT MACHDEP=beos test |
Guido van Rossum | d8eb211 | 1998-08-04 17:57:28 +0000 | [diff] [blame] | 87 | |
| 88 | Expect the following errors: |
| 89 | |
Guido van Rossum | d8eb211 | 1998-08-04 17:57:28 +0000 | [diff] [blame] | 90 | test_grp crashed -- exceptions.KeyError : getgrnam(): name not found |
| 91 | test_pwd failed -- Writing: 'fakename', expected: 'caught e' |
| 92 | test_socket crashed -- exceptions.AttributeError : SOCK_RAW |
| 93 | |
| 94 | These are all due to either partial support for certain things (like |
Guido van Rossum | fc4966b | 1998-12-17 18:00:33 +0000 | [diff] [blame] | 95 | sockets), or valid differences between systems. |
Guido van Rossum | d8eb211 | 1998-08-04 17:57:28 +0000 | [diff] [blame] | 96 | |
Guido van Rossum | fc4966b | 1998-12-17 18:00:33 +0000 | [diff] [blame] | 97 | NOTE: On R4/x86, the pause() function is broken; expect the signal |
| 98 | module test to crash Python! |
Guido van Rossum | d8eb211 | 1998-08-04 17:57:28 +0000 | [diff] [blame] | 99 | |
Guido van Rossum | fc4966b | 1998-12-17 18:00:33 +0000 | [diff] [blame] | 100 | 8) Install: |
Guido van Rossum | d8eb211 | 1998-08-04 17:57:28 +0000 | [diff] [blame] | 101 | |
Guido van Rossum | f96cff2 | 1998-12-22 13:40:55 +0000 | [diff] [blame] | 102 | make OPT=-DUSE_DL_EXPORT CCSHARED=-UUSE_DL_EXPORT MACHDEP=beos nstall |
Guido van Rossum | d8eb211 | 1998-08-04 17:57:28 +0000 | [diff] [blame] | 103 | |
Guido van Rossum | eb45232 | 1998-12-18 22:00:58 +0000 | [diff] [blame] | 104 | This will fail trying to copy libpython1.5.a; at that point in the |
| 105 | install, everything you "normally" need is installed (all the Python |
| 106 | bits), and the stuff you need for compiling C-based modules is half- |
| 107 | installed. This will be fixed before the 1.5.2 release. |
| 108 | |
Guido van Rossum | fc4966b | 1998-12-17 18:00:33 +0000 | [diff] [blame] | 109 | 9) Enjoy! |
Guido van Rossum | d8eb211 | 1998-08-04 17:57:28 +0000 | [diff] [blame] | 110 | |
| 111 | - Chris Herborth (chrish@qnx.com) |
Guido van Rossum | 343848b | 1998-12-22 13:35:29 +0000 | [diff] [blame] | 112 | December 22, 1998 |