+++ /dev/null
-How to make a Python-distribution.
-----------------------------------
-
-These notes are mainly for myself, or for whoever tries to make a MacPython
-distribution when I'm fed up with it. They were last updated for 2.3a1.
-
-- Increase fragment version number in PythonCore and PythonCoreCarbon.
- the fragment number is Python's sys.hexversion, it should be set in the
- "PEF" preferences.
-- Increase version number in _versioncheck.py
-- Build PythonStandSmall, run once in root folder
-- Update NEWS, readme's, Demo:build.html
-- fullbuild everything with increase-buildno
-- Test with test.regrtest
-- Update Numeric and build/install it
-- Recompile OSAm and possibly other Contrib stuff
-- mkdistr binary.include
-- mkdistr dev.include
-- make distribution archive with Installer Vise
- Things to make sure of:
- - Version number in toplevel folder name
- - Finder icon positions
- - Version numbers in "Packages..." window
- - Version number in "Installer Settings" -> "Easy Install Text"
- - Version number in "Project" -> Attributes
- - Version number in "Project" -> PostProcess
- - Version number in "Internet" -> "Download Sites"
- - Version number in "Internet" -> "File Groups".
-- Check for missing files. Do this by installing everything on your local system,
- and comparing the file tree (CodeWarrior Compare is great for this) with
- :Mac:Distributions:(vise):binary distribution and ....:dev distribution.
- Only the :Lib:plat-xxxx should be missing. Otherwise go back to Installer Vise and
- add the missing stuff. Make sure of all settings for the new files (esp. "where"
- and "gestalt" are easy to miss).
-- test on virgin systems (both OS9 and OSX).
-- Remove the local installation so you don't get confused by it.
-- checkin everything except PythonX.Y.vct.
-- mkdistr src.include
-- Rename "src distribution" and stuffit
-- Upload
-- Update README file in ftp directory
-- Change version number in public_html/macpythonversion.txt .
-- Update macpython.html
-- Send an announcement to:
- pythonmac-sig@python.org
- python-dev@python.org
-- Wait a day or so for catastrophic mistakes, then send an announcement to:
- python-announce@python.org
- archivist@info-mac.org
- adcnews@apple.com
- news@macnn.com
- http://www.macupdate.com
- http://guide.apple.com/usindex.lasso
- http://www.apple.com/downloads/macosx/submit
- http://www.versiontracker.com/ (userid Jack.Jansen@oratrix.com)
- http://www.macshareware.net (userid jackjansen)
- Also, check out Stephan Deibels http://pythonology.org/market contact list
-- Open PythonX.Y.vct again, use the "remove compressed files" command to trim down
- the size, commit.
-- Remove the subdires under (vise) so you don't get confused by them later.
\ No newline at end of file
-This is a set of build scripts and such for MacPython-OSX 2.3 that I
-will use until there are standard distributions from Jack.
+Building a MacPython distribution
+=================================
+The ``build`` shell script here creates MacPython distributions.
+It builds a complete framework-based Python out-of-tree, installs
+it in a funny place with $DESTROOT, massages that installation to remove
+.pyc files and such, creates an Installer package from the installation
+plus the stuff in ``resources`` and compresses that installer as a
+``.dmg`` disk image.
+
+Here are the steps you ned to follow to build a MacPython installer:
+
+- There are various version numbers that need to be updated. Weed through
+ ``Mac/OSXResources``, ``Mac/scripts`` and ``Mac/Tools`` and inspect the
+ various ``.plist`` and ``.strings`` files. Note that the latter are
+ UTF-16 files.
+- Edit ``resource/ReadMe.txt`` and ``resources/Welcome.rtf`` to reflect
+ version number and such.
+- Edit ``build`` to change ``PYVERSION``, ``PYVER`` and ``BUILDNUM``.
+- Run ``./build``. Optionally you can pass the name of the directory
+ where Python will be built, so you don't have to wait for the complete
+ build when you're debugging the process. For the final distribution use
+ a clean build.
+- When done the script will tell you where the DMG image is.
+
+Currently (November 2003) there is still a bug in the build procedure
+for $DESTROOT builds: building some of the applets will fail (in
+``Mac/OSX/Makefile``) if you don't have the same version of Python installed
+normally. So before doing the distribution you should build and install
+a framework Python in the normal way.
+
+When all is done, announcements can be posted to at least the following
+places:
+- pythonmac-sig@python.org
+- python-dev@python.org
+- python-announce@python.org
+- archivist@info-mac.org
+- adcnews@apple.com
+- news@macnn.com
+- http://www.macupdate.com
+- http://guide.apple.com/usindex.lasso
+- http://www.apple.com/downloads/macosx/submit
+- http://www.versiontracker.com/ (userid Jack.Jansen@oratrix.com)
+- http://www.macshareware.net (userid jackjansen)
+
+Also, check out Stephan Deibels http://pythonology.org/market contact list
+
+After all this is done you may also need to update the Package Manager
+database for the new distribution. A description of this remains TBD.
projects / python / commitdiff