Mac/BuildScript/README.txt

   1 Building a MacPython distribution
   2 =================================
   3
   4 The ``build-install.py`` script creates MacPython distributions, including
   5 sleepycat db4, sqlite3 and readline support.  It builds a complete
   6 framework-based Python out-of-tree, installs it in a funny place with
   7 $DESTROOT, massages that installation to remove .pyc files and such, creates
   8 an Installer package from the installation plus other files in ``resources``
   9 and ``scripts`` and placed that on a ``.dmg`` disk image.
  10
  11 Prerequisites
  12 -------------
  13
  14 * A MacOS X 10.4 (or later)
  15
  16 * XCode 2.2 (or later), with the universal SDK
  17
  18 * No Fink (in ``/sw``) or DarwinPorts (in ``/opt/local``), those could
  19   interfere with the build.
  20
  21 * The documentation for the release must be available on python.org
  22   because it is included in the installer.
  23
  24
  25 The Recipe
  26 ----------
  27
  28 Here are the steps you need to follow to build a MacPython installer:
  29
  30 *  Run ``./build-installer.py``. Optionally you can pass a number of arguments
  31    to specify locations of various files. Please see the top of
  32   ``build-installer.py`` for its usage.
  33
  34   Running this script takes some time, I will not only build Python itself
  35   but also some 3th-party libraries that are needed for extensions.
  36
  37 * When done the script will tell you where the DMG image is (by default
  38   somewhere in ``/tmp/_py``).
  39
  40 Building a 4-way universal installer
  41 ....................................
  42
  43 It is also possible to build a 4-way universal installer that runs on
  44 OSX Leopard or later::
  45
  46   $ ./build-installer.py --dep-target=10.5 --universal-archs=all --sdk=/
  47
  48 This requires that the deployment target is 10.5 (or later), and hence
  49 also that your building on at least OSX 10.5.
  50
  51 Testing
  52 -------
  53
  54 The resulting binaries should work on MacOSX 10.3.9 or later. I usually run
  55 the installer on a 10.3.9, a 10.4.x PPC and a 10.4.x Intel system and then
  56 run the testsuite to make sure.
  57
  58
  59 Announcements
  60 -------------
  61
  62 (This is mostly of historic interest)
  63
  64 When all is done, announcements can be posted to at least the following
  65 places:
  66 -   pythonmac-sig@python.org
  67 -   python-dev@python.org
  68 -   python-announce@python.org
  69 -   archivist@info-mac.org
  70 -   adcnews@apple.com
  71 -   news@macnn.com
  72 -   http://www.macupdate.com
  73 -   http://guide.apple.com/usindex.lasso
  74 -   http://www.apple.com/downloads/macosx/submit
  75 -   http://www.versiontracker.com/ (userid Jack.Jansen@oratrix.com)
  76 -   http://www.macshareware.net (userid jackjansen)
  77
  78 Also, check out Stephan Deibels http://pythonology.org/market contact list