Mercurial > cpython-lru_cache-weakref

annotate Mac/BuildScript/README.txt @ 79691:05c8928362ee

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Merge __next__ method link fixes with 3.3.
author Ezio Melotti <ezio.melotti@gmail.com>
date Fri, 12 Oct 2012 13:46:37 +0300
parents 6c898f297925
children 6e6a76166c47
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
67596
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
1 Building a Python Mac OS X distribution
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
2 =======================================
38673
a19c20c5e5c7 Merge the rest of the trunk.
Thomas Wouters <thomas@python.org>
parents:
diff changeset
3
67596
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
4 The ``build-install.py`` script creates Python distributions, including
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
5 certain third-party libraries as necessary. It builds a complete
38673
a19c20c5e5c7 Merge the rest of the trunk.
Thomas Wouters <thomas@python.org>
parents:
diff changeset
6 framework-based Python out-of-tree, installs it in a funny place with
a19c20c5e5c7 Merge the rest of the trunk.
Thomas Wouters <thomas@python.org>
parents:
diff changeset
7 $DESTROOT, massages that installation to remove .pyc files and such, creates
a19c20c5e5c7 Merge the rest of the trunk.
Thomas Wouters <thomas@python.org>
parents:
diff changeset
8 an Installer package from the installation plus other files in ``resources``
a19c20c5e5c7 Merge the rest of the trunk.
Thomas Wouters <thomas@python.org>
parents:
diff changeset
9 and ``scripts`` and placed that on a ``.dmg`` disk image.
a19c20c5e5c7 Merge the rest of the trunk.
Thomas Wouters <thomas@python.org>
parents:
diff changeset
10
78759
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
11 As of Python 3.3.0, PSF practice is to build two installer variants
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
12 for each release.
67596
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
13
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
14 1. 32-bit-only, i386 and PPC universal, capable on running on all machines
78759
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
15 supported by Mac OS X 10.5 through (at least) 10.8::
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
16
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
17 /usr/bin/python build-installer.py \
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
18 --sdk-path=/Developer/SDKs/MacOSX10.5.sdk \
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
19 --universal-archs=32-bit \
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
20 --dep-target=10.5
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
21
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
22 - builds the following third-party libraries
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
23
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
24 * NCurses 5.9 (http://bugs.python.org/issue15037)
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
25 * SQLite 3.7.13
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
26 * XZ 5.0.3
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
27
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
28 - uses system-supplied versions of third-party libraries
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
29
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
30 * readline module links with Apple BSD editline (libedit)
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
31
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
32 - requires ActiveState ``Tcl/Tk 8.4`` (currently 8.4.19) to be installed for building
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
33
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
34 - recommended build environment:
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
35
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
36 * Mac OS X 10.5.8 Intel or PPC
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
37 * Xcode 3.1.4
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
38 * ``MacOSX10.5`` SDK
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
39 * ``MACOSX_DEPLOYMENT_TARGET=10.5``
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
40 * Apple ``gcc-4.2``
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
41 * system Python 2.5 for documentation build with Sphinx
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
42
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
43 - alternate build environments:
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
44
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
45 * Mac OS X 10.6.8 with Xcode 3.2.6
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
46 - need to change ``/System/Library/Frameworks/{Tcl,Tk}.framework/Version/Current`` to ``8.4``
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
47 * Note Xcode 4.* does not support building for PPC so cannot be used for this build
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
48
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
49 2. 64-bit / 32-bit, x86_64 and i386 universal, for OS X 10.6 (and later)::
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
50
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
51 /usr/bin/python build-installer.py \
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
52 --sdk-path=/Developer/SDKs/MacOSX10.6.sdk \
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
53 --universal-archs=intel \
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
54 --dep-target=10.6
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
55
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
56 - builds the following third-party libraries
67596
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
57
78759
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
58 * NCurses 5.9 (http://bugs.python.org/issue15037)
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
59 * SQLite 3.7.13
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
60 * XZ 5.0.3
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
61
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
62 - uses system-supplied versions of third-party libraries
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
63
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
64 * readline module links with Apple BSD editline (libedit)
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
65
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
66 - requires ActiveState Tcl/Tk 8.5.9 (or later) to be installed for building
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
67
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
68 - recommended build environment:
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
69
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
70 * Mac OS X 10.6.8 (or later)
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
71 * Xcode 3.2.6
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
72 * ``MacOSX10.6`` SDK
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
73 * ``MACOSX_DEPLOYMENT_TARGET=10.6``
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
74 * Apple ``gcc-4.2``
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
75 * system Python 2.6 for documentation build with Sphinx
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
76
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
77 - alternate build environments:
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
78
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
79 * none. Xcode 4.x currently supplies two C compilers.
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
80 ``llvm-gcc-4.2.1`` has been found to miscompile Python 3.3.x and
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
81 produce a non-functional Python executable. As it appears to be
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
82 considered a migration aid by Apple and is not likely to be fixed,
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
83 its use should be avoided. The other compiler, ``clang``, has been
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
84 undergoing rapid development. While it appears to have become
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
85 production-ready in the most recent Xcode 4 releases (Xcode 4.4.1
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
86 as of this writing), there are still some open issues when
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
87 building Python and there has not yet been the level of exposure in
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
88 production environments that the Xcode 3 gcc-4.2 compiler has had.
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
89
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
90
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
91 * For Python 2.7.x and 3.2.x, the 32-bit-only installer was configured to
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
92 support Mac OS X 10.3.9 through (at least) 10.6. Because it is
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
93 believed that there are few systems still running OS X 10.3 or 10.4
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
94 and because it has become increasingly difficult to test and
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
95 support the differences in these earlier systems, as of Python 3.3.0 the PSF
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
96 32-bit installer no longer supports them. For reference in building such
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
97 an installer yourself, the details are::
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
98
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
99 /usr/bin/python build-installer.py \
67596
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
100 --sdk-path=/Developer/SDKs/MacOSX10.4u.sdk \
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
101 --universal-archs=32-bit \
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
102 --dep-target=10.3
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
103
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
104 - builds the following third-party libraries
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
105
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
106 * Bzip2
78759
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
107 * NCurses
67596
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
108 * GNU Readline (GPL)
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
109 * SQLite 3
78759
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
110 * XZ
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
111 * Zlib 1.2.3
67596
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
112 * Oracle Sleepycat DB 4.8 (Python 2.x only)
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
113
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
114 - requires ActiveState ``Tcl/Tk 8.4`` (currently 8.4.19) to be installed for building
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
115
78759
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
116 - recommended build environment:
67596
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
117
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
118 * Mac OS X 10.5.8 PPC or Intel
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
119 * Xcode 3.1.4 (or later)
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
120 * ``MacOSX10.4u`` SDK (later SDKs do not support PPC G3 processors)
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
121 * ``MACOSX_DEPLOYMENT_TARGET=10.3``
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
122 * Apple ``gcc-4.0``
78759
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
123 * system Python 2.5 for documentation build with Sphinx
67596
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
124
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
125 - alternate build environments:
39442
654c380cf8b9 Merged revisions 46753-51188 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 38673
diff changeset
126
78759
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
127 * Mac OS X 10.6.8 with Xcode 3.2.6
67596
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
128 - need to change ``/System/Library/Frameworks/{Tcl,Tk}.framework/Version/Current`` to ``8.4``
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
129
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
130
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
131
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
132 General Prerequisites
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
133 ---------------------
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
134
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
135 * No Fink (in ``/sw``) or MacPorts (in ``/opt/local``) or other local
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
136 libraries or utilities (in ``/usr/local``) as they could
39442
654c380cf8b9 Merged revisions 46753-51188 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 38673
diff changeset
137 interfere with the build.
38673
a19c20c5e5c7 Merge the rest of the trunk.
Thomas Wouters <thomas@python.org>
parents:
diff changeset
138
67596
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
139 * The documentation for the release is built using Sphinx
39442
654c380cf8b9 Merged revisions 46753-51188 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 38673
diff changeset
140 because it is included in the installer.
654c380cf8b9 Merged revisions 46753-51188 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 38673
diff changeset
141
67596
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
142 * It is safest to start each variant build with an empty source directory
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
143 populated with a fresh copy of the untarred source.
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
144
78759
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
145 * It is recommended that you remove any existing installed version of the
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
146 Python being built::
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
147
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
148 sudo rm -rf /Library/Frameworks/Python.framework/Versions/n.n
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
149
39442
654c380cf8b9 Merged revisions 46753-51188 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 38673
diff changeset
150
654c380cf8b9 Merged revisions 46753-51188 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 38673
diff changeset
151 The Recipe
654c380cf8b9 Merged revisions 46753-51188 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 38673
diff changeset
152 ----------
654c380cf8b9 Merged revisions 46753-51188 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 38673
diff changeset
153
67596
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
154 Here are the steps you need to follow to build a Python installer:
39442
654c380cf8b9 Merged revisions 46753-51188 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 38673
diff changeset
155
67596
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
156 * Run ``build-installer.py``. Optionally you can pass a number of arguments
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
157 to specify locations of various files. Please see the top of
38673
a19c20c5e5c7 Merge the rest of the trunk.
Thomas Wouters <thomas@python.org>
parents:
diff changeset
158 ``build-installer.py`` for its usage.
39442
654c380cf8b9 Merged revisions 46753-51188 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 38673
diff changeset
159
67596
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
160 Running this script takes some time, it will not only build Python itself
39442
654c380cf8b9 Merged revisions 46753-51188 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 38673
diff changeset
161 but also some 3th-party libraries that are needed for extensions.
654c380cf8b9 Merged revisions 46753-51188 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 38673
diff changeset
162
654c380cf8b9 Merged revisions 46753-51188 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 38673
diff changeset
163 * When done the script will tell you where the DMG image is (by default
654c380cf8b9 Merged revisions 46753-51188 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 38673
diff changeset
164 somewhere in ``/tmp/_py``).
654c380cf8b9 Merged revisions 46753-51188 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 38673
diff changeset
165
67596
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
166 Building other universal installers
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
167 ...................................
52461
857be5d95120 Merged revisions 70737 via svnmerge from
Ronald Oussoren <ronaldoussoren@mac.com>
parents: 39442
diff changeset
168
857be5d95120 Merged revisions 70737 via svnmerge from
Ronald Oussoren <ronaldoussoren@mac.com>
parents: 39442
diff changeset
169 It is also possible to build a 4-way universal installer that runs on
78759
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
170 OS X 10.5 Leopard or later::
67596
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
171
78759
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
172 /usr/bin/python /build-installer.py \
67596
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
173 --dep-target=10.5
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
174 --universal-archs=all
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
175 --sdk-path=/Developer/SDKs/MacOSX10.5.sdk
52461
857be5d95120 Merged revisions 70737 via svnmerge from
Ronald Oussoren <ronaldoussoren@mac.com>
parents: 39442
diff changeset
176
67596
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
177 This requires that the deployment target is 10.5, and hence
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
178 also that you are building on at least OS X 10.5. 4-way includes
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
179 ``i386``, ``x86_64``, ``ppc``, and ``ppc64`` (G5). ``ppc64`` executable
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
180 variants can only be run on G5 machines running 10.5. Note that,
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
181 while OS X 10.6 is only supported on Intel-based machines, it is possible
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
182 to run ``ppc`` (32-bit) executables unmodified thanks to the Rosetta ppc
78759
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
183 emulation in OS X 10.5 and 10.6. The 4-way installer variant must be
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
184 built with Xcode 3. It is not regularly built or tested.
52461
857be5d95120 Merged revisions 70737 via svnmerge from
Ronald Oussoren <ronaldoussoren@mac.com>
parents: 39442
diff changeset
185
67596
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
186 Other ``--universal-archs`` options are ``64-bit`` (``x86_64``, ``ppc64``),
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
187 and ``3-way`` (``ppc``, ``i386``, ``x86_64``). None of these options
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
188 are regularly exercised; use at your own risk.
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
189
52461
857be5d95120 Merged revisions 70737 via svnmerge from
Ronald Oussoren <ronaldoussoren@mac.com>
parents: 39442
diff changeset
190
39442
654c380cf8b9 Merged revisions 46753-51188 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 38673
diff changeset
191 Testing
654c380cf8b9 Merged revisions 46753-51188 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 38673
diff changeset
192 -------
38673
a19c20c5e5c7 Merge the rest of the trunk.
Thomas Wouters <thomas@python.org>
parents:
diff changeset
193
67596
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
194 Ideally, the resulting binaries should be installed and the test suite run
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
195 on all supported OS X releases and architectures. As a practical matter,
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
196 that is generally not possible. At a minimum, variant 1 should be run on
78759
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
197 a PPC G4 system with OS X 10.5 and at least one Intel system running OS X
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
198 10.8, 10.7, 10.6, or 10.5. Variant 2 should be run on 10.8, 10.7, and 10.6
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
199 systems in both 32-bit and 64-bit modes.::
38673
a19c20c5e5c7 Merge the rest of the trunk.
Thomas Wouters <thomas@python.org>
parents:
diff changeset
200
78759
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
201 /usr/local/bin/pythonn.n -m test -w -u all,-largefile
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
202 /usr/local/bin/pythonn.n-32 -m test -w -u all
67596
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
203
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
204 Certain tests will be skipped and some cause the interpreter to fail
2afcdf68a389 #10907: Update OS X installer build README to better reflect
Ned Deily <nad@acm.org>
parents: 52461
diff changeset
205 which will likely generate ``Python quit unexpectedly`` alert messages
78759
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
206 to be generated at several points during a test run. These are normal
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
207 during testing and can be ignored.
38673
a19c20c5e5c7 Merge the rest of the trunk.
Thomas Wouters <thomas@python.org>
parents:
diff changeset
208
78759
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
209 It is also recommend to launch IDLE and verify that it is at least
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
210 functional. Double-click on the IDLE app icon in ``/Applications/Pythonn.n``.
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
211 It should also be tested from the command line::
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
212
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
213 /usr/local/bin/idlen.n
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67799
diff changeset
214