Minimal instructions on building a MacPython-OSX addon for Apple's

/usr/bin/python.

1 files changed, 62 insertions, 0 deletions

diff --git a/Mac/OSX/README.JAGUAR b/Mac/OSX/README.JAGUAR
new file mode 100644
index 0000000..f92326f
--- /dev/null
+++ b/Mac/OSX/README.JAGUAR
@@ -0,0 +1,62 @@
+Building a MacPython-OSX on top of Jaguar's /usr/bin/python
+-----------------------------------------------------------
+
+One way of getting MacPython functionality is to use the Python that Apple
+supplies since MacOSX 10.2, and extend this with the missing bits.
+
+(Another way is building a framework python, see Mac/OSX/README for
+details on that).
+
+Preparation
+-----------
+
+First of all you have to fix two things in the python distributed
+by Apple. This paragraph is valid for 10.2 through 10.2.2, so if you
+have a later version of Jaguar your mileage may vary.
+
+1. /usr/lib/python2.2/config/Makefile has an erronuous reference to
+   building for intel processors. Edit the file with sudo, and change
+   the line
+   LDFLAGS=        -arch i386 -arch ppc
+   to
+   LDFLAGS=        -arch ppc
+2. /usr/lib/python2.2/site-packages is not writeable except by root.
+   Make it writeable by administrators by doing
+   sudo chgrp admin /usr/lib/python2.2/site-packages
+   sudo chmod g+w /usr/lib/python2.2/site-packages
+   Alternatively you can do the make's below as superuser, but I
+   would advise against this.
+   
+Building
+--------
+
+Typing "make -f Makefile.jaguar" will build and install almost everything you need.
+If you also want the "pythonw" unix program, which allows you to run GUI scripts from
+a Terminal window, you should also do "sudo make -f Makefile.jaguar install_pythonw".
+
+What do you get
+---------------
+
+After the make you will have a folder /Applications/MacPython-OSX that contains the
+IDE and BuildApplet applications. Also, you will find a folder "python-additions" there
+that contains the MacPython-specific additions to your installed Python. The only thing
+that is installed outside the /Applications/MacPython-OSX folder is
+/usr/lib/python2.2/site-packages/MacPython.pth, which is the magic file that will make
+python find the new modules.
+
+Uninstalling
+------------
+1. Remove /Applications/MacPython-OSX
+2. Remove /usr/lib/python2.2/site-packages/MacPython.pth
+
+How does it work?
+-----------------
+
+Makefile.jaguar does most of the work by calling on Makefile (which is normally used
+to build the Mac extensions for a framework-based python) after setting various
+variables such that everything is built for /usr/bin/python. Some extension modules
+(that are included in framework python 2.3a0, but missing from static python 2.2)
+are built with setup.py. And some Carbon modules are built to replace their 2.2
+versions, which lack required functionality. The stubs in Mac/Lib/Carbon know about
+this overriding.
+