annotate README @ 58765:2ba7677bfa95 legacy-trunk

testCopysign was defined twice in test_math; combine the definitions
author Mark Dickinson <dickinsm@gmail.com>
date Sat, 06 Feb 2010 23:11:25 +0000
parents 4180557b7a9b
children d2e1027edde8
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
58744
4180557b7a9b bump version to 2.7a3
Benjamin Peterson <benjamin@python.org>
parents: 58213
diff changeset
1 This is Python version 2.7 alpha 3
50024
ff2263de0d6f be more specific, and parallel to the py3k branch
Fred Drake <fdrake@acm.org>
parents: 50021
diff changeset
2 ==================================
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
3
58058
fce6611241d1 more copyright year updates
Ezio Melotti <ezio.melotti@gmail.com>
parents: 57576
diff changeset
4 Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
40561
4105570da30a update to (c) years to include 2007
Anthony Baxter <anthonybaxter@gmail.com>
parents: 40408
diff changeset
5 Python Software Foundation.
15986
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs.
Guido van Rossum <guido@python.org>
parents: 15546
diff changeset
6 All rights reserved.
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs.
Guido van Rossum <guido@python.org>
parents: 15546
diff changeset
7
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
8 Copyright (c) 2000 BeOpen.com.
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
9 All rights reserved.
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
10
17458
0d0546bd8448 Because this code was derived from Python 1.6.1 (amongst others), the
Guido van Rossum <guido@python.org>
parents: 17311
diff changeset
11 Copyright (c) 1995-2001 Corporation for National Research Initiatives.
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
12 All rights reserved.
12374
f57af360b7e5 Add weasel-words about versioning, so I don't have to check in a new
Guido van Rossum <guido@python.org>
parents: 12205
diff changeset
13
14385
39ab28572307 Remove a comma from CWI's copyright notice.
Guido van Rossum <guido@python.org>
parents: 14367
diff changeset
14 Copyright (c) 1991-1995 Stichting Mathematisch Centrum.
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
15 All rights reserved.
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
16
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
17
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
18 License information
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
19 -------------------
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
20
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
21 See the file "LICENSE" for information on the history of this
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
22 software, terms & conditions for usage, and a DISCLAIMER OF ALL
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
23 WARRANTIES.
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
24
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
25 This Python distribution contains no GNU General Public Licensed
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
26 (GPLed) code so it may be used in proprietary projects just like prior
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
27 Python distributions. There are interfaces to some GNU code but these
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
28 are entirely optional.
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
29
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
30 All trademarks referenced herein are property of their respective
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
31 holders.
6837
96181a4a5482 Prepared the README for 1.5b2.
Guido van Rossum <guido@python.org>
parents: 6773
diff changeset
32
96181a4a5482 Prepared the README for 1.5b2.
Guido van Rossum <guido@python.org>
parents: 6773
diff changeset
33
3887
957f42ea0f84 Numerous changes, but still a lot of XXX thingies.
Guido van Rossum <guido@python.org>
parents: 3850
diff changeset
34 What's new in this release?
957f42ea0f84 Numerous changes, but still a lot of XXX thingies.
Guido van Rossum <guido@python.org>
parents: 3850
diff changeset
35 ---------------------------
3850
d1cff49e3cc8 Various changes (not done yet even for beta2 release)
Guido van Rossum <guido@python.org>
parents: 3778
diff changeset
36
15986
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs.
Guido van Rossum <guido@python.org>
parents: 15546
diff changeset
37 See the file "Misc/NEWS".
6675
cdb3279b06e7 Revamped README for release of 1.5b1.
Guido van Rossum <guido@python.org>
parents: 6494
diff changeset
38
34629
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
39
6675
cdb3279b06e7 Revamped README for release of 1.5b1.
Guido van Rossum <guido@python.org>
parents: 6494
diff changeset
40 If you don't read instructions
cdb3279b06e7 Revamped README for release of 1.5b1.
Guido van Rossum <guido@python.org>
parents: 6494
diff changeset
41 ------------------------------
cdb3279b06e7 Revamped README for release of 1.5b1.
Guido van Rossum <guido@python.org>
parents: 6494
diff changeset
42
cdb3279b06e7 Revamped README for release of 1.5b1.
Guido van Rossum <guido@python.org>
parents: 6494
diff changeset
43 Congratulations on getting this far. :-)
cdb3279b06e7 Revamped README for release of 1.5b1.
Guido van Rossum <guido@python.org>
parents: 6494
diff changeset
44
cdb3279b06e7 Revamped README for release of 1.5b1.
Guido van Rossum <guido@python.org>
parents: 6494
diff changeset
45 To start building right away (on UNIX): type "./configure" in the
21865
53fecc8dd4c9 Quick build: clarify that you have to do "make install" as root; OS
Guido van Rossum <guido@python.org>
parents: 21632
diff changeset
46 current directory and when it finishes, type "make". This creates an
53fecc8dd4c9 Quick build: clarify that you have to do "make install" as root; OS
Guido van Rossum <guido@python.org>
parents: 21632
diff changeset
47 executable "./python"; to install in /usr/local, first do "su root"
53fecc8dd4c9 Quick build: clarify that you have to do "make install" as root; OS
Guido van Rossum <guido@python.org>
parents: 21632
diff changeset
48 and then "make install".
53fecc8dd4c9 Quick build: clarify that you have to do "make install" as root; OS
Guido van Rossum <guido@python.org>
parents: 21632
diff changeset
49
34629
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
50 The section `Build instructions' below is still recommended reading.
3850
d1cff49e3cc8 Various changes (not done yet even for beta2 release)
Guido van Rossum <guido@python.org>
parents: 3778
diff changeset
51
d1cff49e3cc8 Various changes (not done yet even for beta2 release)
Guido van Rossum <guido@python.org>
parents: 3778
diff changeset
52
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
53 What is Python anyway?
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
54 ----------------------
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
55
34629
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
56 Python is an interpreted, interactive object-oriented programming
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
57 language suitable (amongst other uses) for distributed application
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
58 development, scripting, numeric computing and system testing. Python
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
59 is often compared to Tcl, Perl, Java, JavaScript, Visual Basic or
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
60 Scheme. To find out more about what Python can do for you, point your
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
61 browser to http://www.python.org/.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
62
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
63
4501
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
64 How do I learn Python?
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
65 ----------------------
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
66
10862
4f5d4945605c Added "Learning Python" to the books section.
Fred Drake <fdrake@acm.org>
parents: 10587
diff changeset
67 The official tutorial is still a good place to start; see
34629
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
68 http://docs.python.org/ for online and downloadable versions, as well
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
69 as a list of other introductions, and reference documentation.
10862
4f5d4945605c Added "Learning Python" to the books section.
Fred Drake <fdrake@acm.org>
parents: 10587
diff changeset
70
12205
253cdeeaf42e Quick update to the README file. For intros and books we now point to
Guido van Rossum <guido@python.org>
parents: 11474
diff changeset
71 There's a quickly growing set of books on Python. See
35097
860d7f93e6b4 Update URL.
Michael W. Hudson <mwh@python.net>
parents: 34929
diff changeset
72 http://wiki.python.org/moin/PythonBooks for a list.
5591
da475e107a68 Minor edits for 1.5a2
Guido van Rossum <guido@python.org>
parents: 5525
diff changeset
73
4501
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
74
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
75 Documentation
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
76 -------------
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
77
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
78 All documentation is provided online in a variety of formats. In
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
79 order of importance for new users: Tutorial, Library Reference,
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
80 Language Reference, Extending & Embedding, and the Python/C API. The
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
81 Library Reference is especially of immense value since much of
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
82 Python's power is described there, including the built-in data types
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
83 and functions!
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
84
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
85 All documentation is also available online at the Python web site
46205
c11221906171 Updated README regarding doc formats
Benjamin Peterson <benjamin@python.org>
parents: 45673
diff changeset
86 (http://docs.python.org/, see below). It is available online for occasional
c11221906171 Updated README regarding doc formats
Benjamin Peterson <benjamin@python.org>
parents: 45673
diff changeset
87 reference, or can be downloaded in many formats for faster access. The
46206
07f75d5519b4 The other download formats will be available for 2.6 too.
Georg Brandl <georg@python.org>
parents: 46205
diff changeset
88 documentation is downloadable in HTML, PostScript, PDF, LaTeX, and
46205
c11221906171 Updated README regarding doc formats
Benjamin Peterson <benjamin@python.org>
parents: 45673
diff changeset
89 reStructuredText (2.6+) formats; the LaTeX and reStructuredText versions are
c11221906171 Updated README regarding doc formats
Benjamin Peterson <benjamin@python.org>
parents: 45673
diff changeset
90 primarily for documentation authors, translators, and people with special
c11221906171 Updated README regarding doc formats
Benjamin Peterson <benjamin@python.org>
parents: 45673
diff changeset
91 formatting requirements.
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
92
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
93
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
94 Web sites
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
95 ---------
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
96
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
97 New Python releases and related technologies are published at
15986
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs.
Guido van Rossum <guido@python.org>
parents: 15546
diff changeset
98 http://www.python.org/. Come visit us!
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
99
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
100
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
101 Newsgroups and Mailing Lists
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
102 ----------------------------
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
103
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
104 Read comp.lang.python, a high-volume discussion newsgroup about
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
105 Python, or comp.lang.python.announce, a low-volume moderated newsgroup
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
106 for Python-related announcements. These are also accessible as
55721
675a3c1824f4 #6775: fix python.org URLs in README.
Georg Brandl <georg@python.org>
parents: 55091
diff changeset
107 mailing lists: see http://www.python.org/community/lists/ for an
34629
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
108 overview of these and many other Python-related mailing lists.
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
109
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
110 Archives are accessible via the Google Groups Usenet archive; see
23962
111c1e59ad72 Random tweaks & updates.
Michael W. Hudson <mwh@python.net>
parents: 23867
diff changeset
111 http://groups.google.com/. The mailing lists are also archived, see
55721
675a3c1824f4 #6775: fix python.org URLs in README.
Georg Brandl <georg@python.org>
parents: 55091
diff changeset
112 http://www.python.org/community/lists/ for details.
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
113
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
114
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
115 Bug reports
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
116 -----------
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
117
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
118 To report or search for bugs, please use the Python Bug
55721
675a3c1824f4 #6775: fix python.org URLs in README.
Georg Brandl <georg@python.org>
parents: 55091
diff changeset
119 Tracker at http://bugs.python.org/.
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
120
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
121
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
122 Patches and contributions
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
123 -------------------------
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
124
15325
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added
Fred Drake <fdrake@acm.org>
parents: 15249
diff changeset
125 To submit a patch or other contribution, please use the Python Patch
55721
675a3c1824f4 #6775: fix python.org URLs in README.
Georg Brandl <georg@python.org>
parents: 55091
diff changeset
126 Manager at http://bugs.python.org/. Guidelines
44472
9019086fd20a Update links to bug/patch tracker
Andrew M. Kuchling <amk@amk.ca>
parents: 44285
diff changeset
127 for patch submission may be found at http://www.python.org/dev/patches/.
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
128
46260
2b0ecc7fd7ee Suggested proposed changes to Python be considered on some mailing lists first
Benjamin Peterson <benjamin@python.org>
parents: 46206
diff changeset
129 If you have a proposal to change Python, you may want to send an email to the
2b0ecc7fd7ee Suggested proposed changes to Python be considered on some mailing lists first
Benjamin Peterson <benjamin@python.org>
parents: 46206
diff changeset
130 comp.lang.python or python-ideas mailing lists for inital feedback. A Python
2b0ecc7fd7ee Suggested proposed changes to Python be considered on some mailing lists first
Benjamin Peterson <benjamin@python.org>
parents: 46206
diff changeset
131 Enhancement Proposal (PEP) may be submitted if your idea gains ground. All
2b0ecc7fd7ee Suggested proposed changes to Python be considered on some mailing lists first
Benjamin Peterson <benjamin@python.org>
parents: 46206
diff changeset
132 current PEPs, as well as guidelines for submitting a new PEP, are listed at
2b0ecc7fd7ee Suggested proposed changes to Python be considered on some mailing lists first
Benjamin Peterson <benjamin@python.org>
parents: 46206
diff changeset
133 http://www.python.org/dev/peps/.
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
134
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
135
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
136 Questions
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
137 ---------
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
138
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
139 For help, if you can't find it in the manuals or on the web site, it's
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
140 best to post to the comp.lang.python or the Python mailing list (see
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
141 above). If you specifically don't want to involve the newsgroup or
15986
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs.
Guido van Rossum <guido@python.org>
parents: 15546
diff changeset
142 mailing list, send questions to help@python.org (a group of volunteers
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs.
Guido van Rossum <guido@python.org>
parents: 15546
diff changeset
143 who answer questions as they can). The newsgroup is the most
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs.
Guido van Rossum <guido@python.org>
parents: 15546
diff changeset
144 efficient way to ask public questions.
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
145
13155
9919d65edc76 Tentative 2.0 and BeOpen upgrade.
Guido van Rossum <guido@python.org>
parents: 12374
diff changeset
146
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
147 Build instructions
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
148 ==================
1453
d773a5f89426 New files
Guido van Rossum <guido@python.org>
parents:
diff changeset
149
21900
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
150 Before you can build Python, you must first configure it.
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
151 Fortunately, the configuration and build process has been automated
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
152 for Unix and Linux installations, so all you usually have to do is
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
153 type a few commands and sit back. There are some platforms where
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
154 things are not quite as smooth; see the platform specific notes below.
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
155 If you want to build for multiple platforms sharing the same source
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
156 tree, see the section on VPATH below.
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
157
21900
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
158 Start by running the script "./configure", which determines your
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
159 system configuration and creates the Makefile. (It takes a minute or
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
160 two -- please be patient!) You may want to pass options to the
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
161 configure script -- see the section below on configuration options and
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
162 variables. When it's done, you are ready to run make.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
163
21900
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
164 To build Python, you normally type "make" in the toplevel directory.
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
165 If you have changed the configuration, the Makefile may have to be
51875
Benjamin Peterson <benjamin@python.org>
parents: 51874
diff changeset
166 rebuilt. In this case, you may have to run make again to correctly
21900
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
167 build your desired target. The interpreter executable is built in the
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
168 top level directory.
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
169
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
170 Once you have built a Python interpreter, see the subsections below on
21900
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
171 testing and installation. If you run into trouble, see the next
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
172 section.
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
173
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
174 Previous versions of Python used a manual configuration process that
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
175 involved editing the file Modules/Setup. While this file still exists
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
176 and manual configuration is still supported, it is rarely needed any
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
177 more: almost all modules are automatically built as appropriate under
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
178 guidance of the setup.py script, which is run by Make after the
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
179 interpreter has been built.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
180
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
181
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
182 Troubleshooting
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
183 ---------------
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
184
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
185 See also the platform specific notes in the next section.
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
186
34629
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
187 If you run into other trouble, see the FAQ
55721
675a3c1824f4 #6775: fix python.org URLs in README.
Georg Brandl <georg@python.org>
parents: 55091
diff changeset
188 (http://www.python.org/doc/faq/) for hints on what can go wrong, and
34629
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
189 how to fix it.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
190
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
191 If you rerun the configure script with different options, remove all
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
192 object files by running "make clean" before rebuilding. Believe it or
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
193 not, "make clean" sometimes helps to clean up other inexplicable
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
194 problems as well. Try it before sending in a bug report!
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
195
4134
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
196 If the configure script fails or doesn't seem to find things that
34629
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
197 should be there, inspect the config.log file.
6448
b854ca4605e1 Ready for the release, I'd say.
Guido van Rossum <guido@python.org>
parents: 6132
diff changeset
198
b854ca4605e1 Ready for the release, I'd say.
Guido van Rossum <guido@python.org>
parents: 6132
diff changeset
199 If you get a warning for every file about the -Olimit option being no
b854ca4605e1 Ready for the release, I'd say.
Guido van Rossum <guido@python.org>
parents: 6132
diff changeset
200 longer supported, you can ignore it. There's no foolproof way to know
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
201 whether this option is needed; all we can do is test whether it is
6448
b854ca4605e1 Ready for the release, I'd say.
Guido van Rossum <guido@python.org>
parents: 6132
diff changeset
202 accepted without error. On some systems, e.g. older SGI compilers, it
b854ca4605e1 Ready for the release, I'd say.
Guido van Rossum <guido@python.org>
parents: 6132
diff changeset
203 is essential for performance (specifically when compiling ceval.c,
b854ca4605e1 Ready for the release, I'd say.
Guido van Rossum <guido@python.org>
parents: 6132
diff changeset
204 which has more basic blocks than the default limit of 1000). If the
b854ca4605e1 Ready for the release, I'd say.
Guido van Rossum <guido@python.org>
parents: 6132
diff changeset
205 warning bothers you, edit the Makefile to remove "-Olimit 1500" from
b854ca4605e1 Ready for the release, I'd say.
Guido van Rossum <guido@python.org>
parents: 6132
diff changeset
206 the OPT variable.
4134
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
207
14249
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost
Guido van Rossum <guido@python.org>
parents: 14144
diff changeset
208 If you get failures in test_long, or sys.maxint gets set to -1, you
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost
Guido van Rossum <guido@python.org>
parents: 14144
diff changeset
209 are probably experiencing compiler bugs, usually related to
26240
e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning
Martin v. Löwis <martin@v.loewis.de>
parents: 26154
diff changeset
210 optimization. This is a common problem with some versions of gcc, and
e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning
Martin v. Löwis <martin@v.loewis.de>
parents: 26154
diff changeset
211 some vendor-supplied compilers, which can sometimes be worked around
e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning
Martin v. Löwis <martin@v.loewis.de>
parents: 26154
diff changeset
212 by turning off optimization. Consider switching to stable versions
34042
7a12904438d6 update gcc ref
Anthony Baxter <anthonybaxter@gmail.com>
parents: 33393
diff changeset
213 (gcc 2.95.2, gcc 3.x, or contact your vendor.)
14249
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost
Guido van Rossum <guido@python.org>
parents: 14144
diff changeset
214
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost
Guido van Rossum <guido@python.org>
parents: 14144
diff changeset
215 From Python 2.0 onward, all Python C code is ANSI C. Compiling using
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost
Guido van Rossum <guido@python.org>
parents: 14144
diff changeset
216 old K&R-C-only compilers is no longer possible. ANSI C compilers are
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost
Guido van Rossum <guido@python.org>
parents: 14144
diff changeset
217 available for all modern systems, either in the form of updated
26240
e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning
Martin v. Löwis <martin@v.loewis.de>
parents: 26154
diff changeset
218 compilers from the vendor, or one of the free compilers (gcc).
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
219
40341
f91b6d85cab5 Bug #1594809: add a note to README regarding PYTHONPATH and make install.
Georg Brandl <georg@python.org>
parents: 39510
diff changeset
220 If "make install" fails mysteriously during the "compiling the library"
f91b6d85cab5 Bug #1594809: add a note to README regarding PYTHONPATH and make install.
Georg Brandl <georg@python.org>
parents: 39510
diff changeset
221 step, make sure that you don't have any of the PYTHONPATH or PYTHONHOME
f91b6d85cab5 Bug #1594809: add a note to README regarding PYTHONPATH and make install.
Georg Brandl <georg@python.org>
parents: 39510
diff changeset
222 environment variables set, as they may interfere with the newly built
f91b6d85cab5 Bug #1594809: add a note to README regarding PYTHONPATH and make install.
Georg Brandl <georg@python.org>
parents: 39510
diff changeset
223 executable which is compiling the library.
f91b6d85cab5 Bug #1594809: add a note to README regarding PYTHONPATH and make install.
Georg Brandl <georg@python.org>
parents: 39510
diff changeset
224
26499
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
225 Unsupported systems
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
226 -------------------
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
227
39156
a4c4b7ea79c0 Update list of unsupported systems. Fixes #1510853.
Martin v. Löwis <martin@v.loewis.de>
parents: 39048
diff changeset
228 A number of features are not supported in Python 2.5 anymore. Some
a4c4b7ea79c0 Update list of unsupported systems. Fixes #1510853.
Martin v. Löwis <martin@v.loewis.de>
parents: 39048
diff changeset
229 support code is still present, but will be removed in Python 2.6.
26499
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
230 If you still need to use current Python versions on these systems,
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
231 please send a message to python-dev@python.org indicating that you
39156
a4c4b7ea79c0 Update list of unsupported systems. Fixes #1510853.
Martin v. Löwis <martin@v.loewis.de>
parents: 39048
diff changeset
232 volunteer to support this system. For a more detailed discussion
a4c4b7ea79c0 Update list of unsupported systems. Fixes #1510853.
Martin v. Löwis <martin@v.loewis.de>
parents: 39048
diff changeset
233 regarding no-longer-supported and resupporting platforms, as well
a4c4b7ea79c0 Update list of unsupported systems. Fixes #1510853.
Martin v. Löwis <martin@v.loewis.de>
parents: 39048
diff changeset
234 as a list of platforms that became or will be unsupported, see PEP 11.
26499
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
235
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
236 More specifically, the following systems are not supported any
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
237 longer:
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
238 - SunOS 4
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
239 - DYNIX
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
240 - dgux
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
241 - Minix
39156
a4c4b7ea79c0 Update list of unsupported systems. Fixes #1510853.
Martin v. Löwis <martin@v.loewis.de>
parents: 39048
diff changeset
242 - NeXT
26499
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
243 - Irix 4 and --with-sgi-dl
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
244 - Linux 1
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
245 - Systems defining __d6_pthread_create (configure.in)
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
246 - Systems defining PY_PTHREAD_D4, PY_PTHREAD_D6,
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
247 or PY_PTHREAD_D7 in thread_pthread.h
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
248 - Systems using --with-dl-dld
26716
a3600c4ecc8b Unsupport --without-universal-newlines.
Martin v. Löwis <martin@v.loewis.de>
parents: 26499
diff changeset
249 - Systems using --without-universal-newlines
39156
a4c4b7ea79c0 Update list of unsupported systems. Fixes #1510853.
Martin v. Löwis <martin@v.loewis.de>
parents: 39048
diff changeset
250 - MacOS 9
a4c4b7ea79c0 Update list of unsupported systems. Fixes #1510853.
Martin v. Löwis <martin@v.loewis.de>
parents: 39048
diff changeset
251 - Systems using --with-wctype-functions
a4c4b7ea79c0 Update list of unsupported systems. Fixes #1510853.
Martin v. Löwis <martin@v.loewis.de>
parents: 39048
diff changeset
252 - Win9x, WinME
a4c4b7ea79c0 Update list of unsupported systems. Fixes #1510853.
Martin v. Löwis <martin@v.loewis.de>
parents: 39048
diff changeset
253
26499
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
254
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
255 Platform specific notes
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
256 -----------------------
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
257
3174
f7789945b8de release 1.3 for real
Guido van Rossum <guido@python.org>
parents: 3110
diff changeset
258 (Some of these may no longer apply. If you find you can build Python
15986
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs.
Guido van Rossum <guido@python.org>
parents: 15546
diff changeset
259 on these platforms without the special directions mentioned here,
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs.
Guido van Rossum <guido@python.org>
parents: 15546
diff changeset
260 submit a documentation bug report to SourceForge (see Bug Reports
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs.
Guido van Rossum <guido@python.org>
parents: 15546
diff changeset
261 above) so we can remove them!)
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
262
28924
b3b284436c24 add note about building with bsddb185 and making it appear as bsddb.
Skip Montanaro <skip@pobox.com>
parents: 28850
diff changeset
263 Unix platforms: If your vendor still ships (and you still use) Berkeley DB
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
264 1.85 you will need to edit Modules/Setup to build the bsddb185
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
265 module and add a line to sitecustomize.py which makes it the
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
266 default. In Modules/Setup a line like
28924
b3b284436c24 add note about building with bsddb185 and making it appear as bsddb.
Skip Montanaro <skip@pobox.com>
parents: 28850
diff changeset
267
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
268 bsddb185 bsddbmodule.c
28924
b3b284436c24 add note about building with bsddb185 and making it appear as bsddb.
Skip Montanaro <skip@pobox.com>
parents: 28850
diff changeset
269
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
270 should work. (You may need to add -I, -L or -l flags to direct the
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
271 compiler and linker to your include files and libraries.)
28924
b3b284436c24 add note about building with bsddb185 and making it appear as bsddb.
Skip Montanaro <skip@pobox.com>
parents: 28850
diff changeset
272
34629
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
273 XXX I think this next bit is out of date:
28924
b3b284436c24 add note about building with bsddb185 and making it appear as bsddb.
Skip Montanaro <skip@pobox.com>
parents: 28850
diff changeset
274
41784
b7fb942b403e Remove the rgbimg module. It has been deprecated since Python 2.5.
Brett Cannon <bcannon@gmail.com>
parents: 41034
diff changeset
275 64-bit platforms: The modules audioop, and imageop don't work.
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
276 The setup.py script disables them on 64-bit installations.
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
277 Don't try to enable them in the Modules/Setup file. They
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
278 contain code that is quite wordsize sensitive. (If you have a
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
279 fix, let us know!)
6448
b854ca4605e1 Ready for the release, I'd say.
Guido van Rossum <guido@python.org>
parents: 6132
diff changeset
280
5037
9ad7b8c36c79 Various notes added:
Guido van Rossum <guido@python.org>
parents: 4501
diff changeset
281 Solaris: When using Sun's C compiler with threads, at least on Solaris
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
282 2.5.1, you need to add the "-mt" compiler option (the simplest
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
283 way is probably to specify the compiler with this option as
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
284 the "CC" environment variable when running the configure
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
285 script).
5037
9ad7b8c36c79 Various notes added:
Guido van Rossum <guido@python.org>
parents: 4501
diff changeset
286
25351
033adcbb4cb2 Warn about binutils 2.13 on Solaris.
Guido van Rossum <guido@python.org>
parents: 24547
diff changeset
287 When using GCC on Solaris, beware of binutils 2.13 or GCC
033adcbb4cb2 Warn about binutils 2.13 on Solaris.
Guido van Rossum <guido@python.org>
parents: 24547
diff changeset
288 versions built using it. This mistakenly enables the
033adcbb4cb2 Warn about binutils 2.13 on Solaris.
Guido van Rossum <guido@python.org>
parents: 24547
diff changeset
289 -zcombreloc option which creates broken shared libraries on
033adcbb4cb2 Warn about binutils 2.13 on Solaris.
Guido van Rossum <guido@python.org>
parents: 24547
diff changeset
290 Solaris. binutils 2.12 works, and the binutils maintainers
27053
9d08291cd411 qualify known Solaris versions related to the binutils breakage.
Skip Montanaro <skip@pobox.com>
parents: 27051
diff changeset
291 are aware of the problem. Binutils 2.13.1 only partially
9d08291cd411 qualify known Solaris versions related to the binutils breakage.
Skip Montanaro <skip@pobox.com>
parents: 27051
diff changeset
292 fixed things. It appears that 2.13.2 solves the problem
9d08291cd411 qualify known Solaris versions related to the binutils breakage.
Skip Montanaro <skip@pobox.com>
parents: 27051
diff changeset
293 completely. This problem is known to occur with Solaris 2.7
9d08291cd411 qualify known Solaris versions related to the binutils breakage.
Skip Montanaro <skip@pobox.com>
parents: 27051
diff changeset
294 and 2.8, but may also affect earlier and later versions of the
9d08291cd411 qualify known Solaris versions related to the binutils breakage.
Skip Montanaro <skip@pobox.com>
parents: 27051
diff changeset
295 OS.
25351
033adcbb4cb2 Warn about binutils 2.13 on Solaris.
Guido van Rossum <guido@python.org>
parents: 24547
diff changeset
296
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
297 When the dynamic loader complains about errors finding shared
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
298 libraries, such as
26240
e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning
Martin v. Löwis <martin@v.loewis.de>
parents: 26154
diff changeset
299
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
300 ld.so.1: ./python: fatal: libstdc++.so.5: open failed:
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
301 No such file or directory
26240
e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning
Martin v. Löwis <martin@v.loewis.de>
parents: 26154
diff changeset
302
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
303 you need to first make sure that the library is available on
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
304 your system. Then, you need to instruct the dynamic loader how
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
305 to find it. You can choose any of the following strategies:
26240
e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning
Martin v. Löwis <martin@v.loewis.de>
parents: 26154
diff changeset
306
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
307 1. When compiling Python, set LD_RUN_PATH to the directories
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
308 containing missing libraries.
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
309 2. When running Python, set LD_LIBRARY_PATH to these directories.
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
310 3. Use crle(8) to extend the search path of the loader.
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
311 4. Modify the installed GCC specs file, adding -R options into the
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
312 *link: section.
26240
e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning
Martin v. Löwis <martin@v.loewis.de>
parents: 26154
diff changeset
313
35885
5b82120cb49d note build workaround for Sol10/gcc 3.4
Skip Montanaro <skip@pobox.com>
parents: 35615
diff changeset
314 The complex object fails to compile on Solaris 10 with gcc 3.4 (at
5b82120cb49d note build workaround for Sol10/gcc 3.4
Skip Montanaro <skip@pobox.com>
parents: 35615
diff changeset
315 least up to 3.4.3). To work around it, define Py_HUGE_VAL as
5b82120cb49d note build workaround for Sol10/gcc 3.4
Skip Montanaro <skip@pobox.com>
parents: 35615
diff changeset
316 HUGE_VAL(), e.g.:
5b82120cb49d note build workaround for Sol10/gcc 3.4
Skip Montanaro <skip@pobox.com>
parents: 35615
diff changeset
317
5b82120cb49d note build workaround for Sol10/gcc 3.4
Skip Montanaro <skip@pobox.com>
parents: 35615
diff changeset
318 make CPPFLAGS='-D"Py_HUGE_VAL=HUGE_VAL()" -I. -I$(srcdir)/Include'
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
319 ./python setup.py CPPFLAGS='-D"Py_HUGE_VAL=HUGE_VAL()"'
35885
5b82120cb49d note build workaround for Sol10/gcc 3.4
Skip Montanaro <skip@pobox.com>
parents: 35615
diff changeset
320
14249
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost
Guido van Rossum <guido@python.org>
parents: 14144
diff changeset
321 Linux: A problem with threads and fork() was tracked down to a bug in
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
322 the pthreads code in glibc version 2.0.5; glibc version 2.0.7
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
323 solves the problem. This causes the popen2 test to fail;
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
324 problem and solution reported by Pablo Bleyer.
6773
14d6b7a42919 For RedHat Linux 5.0, added notes about needing to remove the LinuxThreads
Fred Drake <fdrake@acm.org>
parents: 6710
diff changeset
325
29453
efad59f39564 Patch #753845: Update README for Redhat 9 Tkinter compile with USC-4.
Martin v. Löwis <martin@v.loewis.de>
parents: 29426
diff changeset
326 Red Hat Linux: Red Hat 9 built Python2.2 in UCS-4 mode and hacked
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
327 Tcl to support it. To compile Python2.3 with Tkinter, you will
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
328 need to pass --enable-unicode=ucs4 flag to ./configure.
29453
efad59f39564 Patch #753845: Update README for Redhat 9 Tkinter compile with USC-4.
Martin v. Löwis <martin@v.loewis.de>
parents: 29426
diff changeset
329
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
330 There's an executable /usr/bin/python which is Python
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
331 1.5.2 on most older Red Hat installations; several key Red Hat tools
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
332 require this version. Python 2.1.x may be installed as
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
333 /usr/bin/python2. The Makefile installs Python as
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
334 /usr/local/bin/python, which may or may not take precedence
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
335 over /usr/bin/python, depending on how you have set up $PATH.
21865
53fecc8dd4c9 Quick build: clarify that you have to do "make install" as root; OS
Guido van Rossum <guido@python.org>
parents: 21632
diff changeset
336
11024
271af297aa3e Add warning FreeBSD users of a problem with curses and termcap,
Guido van Rossum <guido@python.org>
parents: 10862
diff changeset
337 FreeBSD 3.x and probably platforms with NCurses that use libmytinfo or
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
338 similar: When using cursesmodule, the linking is not done in
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
339 the correct order with the defaults. Remove "-ltermcap" from
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
340 the readline entry in Setup, and use as curses entry: "curses
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
341 cursesmodule.c -lmytinfo -lncurses -ltermcap" - "mytinfo" (so
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
342 called on FreeBSD) should be the name of the auxiliary library
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
343 required on your platform. Normally, it would be linked
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
344 automatically, but not necessarily in the correct order.
11024
271af297aa3e Add warning FreeBSD users of a problem with curses and termcap,
Guido van Rossum <guido@python.org>
parents: 10862
diff changeset
345
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
346 BSDI: BSDI versions before 4.1 have known problems with threads,
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
347 which can cause strange errors in a number of modules (for
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
348 instance, the 'test_signal' test script will hang forever.)
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
349 Turning off threads (with --with-threads=no) or upgrading to
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
350 BSDI 4.1 solves this problem.
14249
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost
Guido van Rossum <guido@python.org>
parents: 14144
diff changeset
351
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost
Guido van Rossum <guido@python.org>
parents: 14144
diff changeset
352 DEC Unix: Run configure with --with-dec-threads, or with
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
353 --with-threads=no if no threads are desired (threads are on by
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
354 default). When using GCC, it is possible to get an internal
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
355 compiler error if optimization is used. This was reported for
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
356 GCC 2.7.2.3 on selectmodule.c. Manually compile the affected
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
357 file without optimization to solve the problem.
3399
02435fd95277 Added ref to Misc/NEWS file; added hint to run regen script on Linux.
Guido van Rossum <guido@python.org>
parents: 3233
diff changeset
358
10565
104a441b2bc8 Add DEC Ultrix notes (from Donn Cave's email).
Guido van Rossum <guido@python.org>
parents: 10549
diff changeset
359 DEC Ultrix: compile with GCC to avoid bugs in the native compiler,
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
360 and pass SHELL=/bin/sh5 to Make when installing.
10565
104a441b2bc8 Add DEC Ultrix notes (from Donn Cave's email).
Guido van Rossum <guido@python.org>
parents: 10549
diff changeset
361
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
362 AIX: A complete overhaul of the shared library support is now in
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
363 place. See Misc/AIX-NOTES for some notes on how it's done.
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
364 (The optimizer bug reported at this place in previous releases
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
365 has been worked around by a minimal code change.) If you get
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
366 errors about pthread_* functions, during compile or during
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
367 testing, try setting CC to a thread-safe (reentrant) compiler,
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
368 like "cc_r". For full C++ module support, set CC="xlC_r" (or
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
369 CC="xlC" without thread support).
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
370
35615
c6d7f1fe9d1e Update 64-bit AIX and HP-UX build instructions (forward port).
Guido van Rossum <guido@python.org>
parents: 35548
diff changeset
371 AIX 5.3: To build a 64-bit version with IBM's compiler, I used the
c6d7f1fe9d1e Update 64-bit AIX and HP-UX build instructions (forward port).
Guido van Rossum <guido@python.org>
parents: 35548
diff changeset
372 following:
c6d7f1fe9d1e Update 64-bit AIX and HP-UX build instructions (forward port).
Guido van Rossum <guido@python.org>
parents: 35548
diff changeset
373
c6d7f1fe9d1e Update 64-bit AIX and HP-UX build instructions (forward port).
Guido van Rossum <guido@python.org>
parents: 35548
diff changeset
374 export PATH=/usr/bin:/usr/vacpp/bin
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
375 ./configure --with-gcc="xlc_r -q64" --with-cxx="xlC_r -q64" \
35615
c6d7f1fe9d1e Update 64-bit AIX and HP-UX build instructions (forward port).
Guido van Rossum <guido@python.org>
parents: 35548
diff changeset
376 --disable-ipv6 AR="ar -X64"
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
377 make
35615
c6d7f1fe9d1e Update 64-bit AIX and HP-UX build instructions (forward port).
Guido van Rossum <guido@python.org>
parents: 35548
diff changeset
378
30618
b7d01effe899 updated HPUX notes.
Anthony Baxter <anthonybaxter@gmail.com>
parents: 30521
diff changeset
379 HP-UX: When using threading, you may have to add -D_REENTRANT to the
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
380 OPT variable in the top-level Makefile; reported by Pat Knight,
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
381 this seems to make a difference (at least for HP-UX 10.20)
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
382 even though pyconfig.h defines it. This seems unnecessary when
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
383 using HP/UX 11 and later - threading seems to work "out of the
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
384 box".
30618
b7d01effe899 updated HPUX notes.
Anthony Baxter <anthonybaxter@gmail.com>
parents: 30521
diff changeset
385
34629
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
386 HP-UX ia64: When building on the ia64 (Itanium) platform using HP's
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
387 compiler, some experience has shown that the compiler's
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
388 optimiser produces a completely broken version of python
55721
675a3c1824f4 #6775: fix python.org URLs in README.
Georg Brandl <georg@python.org>
parents: 55091
diff changeset
389 (see http://bugs.python.org/814976). To work around this,
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
390 edit the Makefile and remove -O from the OPT line.
35548
d79af0651155 - Changes donated by Elemental Security to make it work on HP-UX 11 on
Guido van Rossum <guido@python.org>
parents: 35097
diff changeset
391
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
392 To build a 64-bit executable on an Itanium 2 system using HP's
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
393 compiler, use these environment variables:
35548
d79af0651155 - Changes donated by Elemental Security to make it work on HP-UX 11 on
Guido van Rossum <guido@python.org>
parents: 35097
diff changeset
394
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
395 CC=cc
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
396 CXX=aCC
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
397 BASECFLAGS="+DD64"
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
398 LDFLAGS="+DD64 -lxnet"
35548
d79af0651155 - Changes donated by Elemental Security to make it work on HP-UX 11 on
Guido van Rossum <guido@python.org>
parents: 35097
diff changeset
399
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
400 and call configure as:
35548
d79af0651155 - Changes donated by Elemental Security to make it work on HP-UX 11 on
Guido van Rossum <guido@python.org>
parents: 35097
diff changeset
401
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
402 ./configure --without-gcc
35548
d79af0651155 - Changes donated by Elemental Security to make it work on HP-UX 11 on
Guido van Rossum <guido@python.org>
parents: 35097
diff changeset
403
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
404 then *unset* the environment variables again before running
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
405 make. (At least one of these flags causes the build to fail
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
406 if it remains set.) You still have to edit the Makefile and
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
407 remove -O from the OPT line.
8336
6b7095b98e54 Add pointer to Misc/HPUX-NOTES.
Guido van Rossum <guido@python.org>
parents: 8316
diff changeset
408
55721
675a3c1824f4 #6775: fix python.org URLs in README.
Georg Brandl <georg@python.org>
parents: 55091
diff changeset
409 HP PA-RISC 2.0: A recent bug report (http://bugs.python.org/546117)
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
410 suggests that the C compiler in this 64-bit system has bugs
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
411 in the optimizer that break Python. Compiling without
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
412 optimization solves the problems.
23240
76c45037113f Add warning about the HP PA-RISC 2.0 C compiler's optimizer.
Guido van Rossum <guido@python.org>
parents: 23029
diff changeset
413
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
414 SCO: The following apply to SCO 3 only; Python builds out of the box
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
415 on SCO 5 (or so we've heard).
8041
e2333969a2ca The usual edits... Updated some stuff about the mailing list. Ready
Guido van Rossum <guido@python.org>
parents: 7978
diff changeset
416
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
417 1) Everything works much better if you add -U__STDC__ to the
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
418 defs. This is because all the SCO header files are broken.
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
419 Anything that isn't mentioned in the C standard is
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
420 conditionally excluded when __STDC__ is defined.
1453
d773a5f89426 New files
Guido van Rossum <guido@python.org>
parents:
diff changeset
421
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
422 2) Due to the U.S. export restrictions, SCO broke the crypt
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
423 stuff out into a separate library, libcrypt_i.a so the LIBS
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
424 needed be set to:
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
425
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
426 LIBS=' -lsocket -lcrypt_i'
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
427
19758
64bcef1702ad Revert parts of patch #453627, documenting the resulting test failures
Martin v. Löwis <martin@v.loewis.de>
parents: 19381
diff changeset
428 UnixWare: There are known bugs in the math library of the system, as well as
64bcef1702ad Revert parts of patch #453627, documenting the resulting test failures
Martin v. Löwis <martin@v.loewis.de>
parents: 19381
diff changeset
429 problems in the handling of threads (calling fork in one
64bcef1702ad Revert parts of patch #453627, documenting the resulting test failures
Martin v. Löwis <martin@v.loewis.de>
parents: 19381
diff changeset
430 thread may interrupt system calls in others). Therefore, test_math and
64bcef1702ad Revert parts of patch #453627, documenting the resulting test failures
Martin v. Löwis <martin@v.loewis.de>
parents: 19381
diff changeset
431 tests involving threads will fail until those problems are fixed.
64bcef1702ad Revert parts of patch #453627, documenting the resulting test failures
Martin v. Löwis <martin@v.loewis.de>
parents: 19381
diff changeset
432
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
433 QNX: Chris Herborth (chrish@qnx.com) writes:
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
434 configure works best if you use GNU bash; a port is available on
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
435 ftp.qnx.com in /usr/free. I used the following process to build,
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
436 test and install Python 1.5.x under QNX:
6710
90c6390b4941 Add attributions to Jeffrey Ollie and Tim Peters for re.py; new QNX
Guido van Rossum <guido@python.org>
parents: 6680
diff changeset
437
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
438 1) CONFIG_SHELL=/usr/local/bin/bash CC=cc RANLIB=: \
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
439 ./configure --verbose --without-gcc --with-libm=""
6710
90c6390b4941 Add attributions to Jeffrey Ollie and Tim Peters for re.py; new QNX
Guido van Rossum <guido@python.org>
parents: 6680
diff changeset
440
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
441 2) edit Modules/Setup to activate everything that makes sense for
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
442 your system... tested here at QNX with the following modules:
6710
90c6390b4941 Add attributions to Jeffrey Ollie and Tim Peters for re.py; new QNX
Guido van Rossum <guido@python.org>
parents: 6680
diff changeset
443
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
444 array, audioop, binascii, cPickle, cStringIO, cmath,
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
445 crypt, curses, errno, fcntl, gdbm, grp, imageop,
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
446 _locale, math, md5, new, operator, parser, pcre,
41790
c028b2775a9a rotor is long gone.
Neal Norwitz <nnorwitz@gmail.com>
parents: 41784
diff changeset
447 posix, pwd, readline, regex, reop,
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
448 select, signal, socket, soundex, strop, struct,
41784
b7fb942b403e Remove the rgbimg module. It has been deprecated since Python 2.5.
Brett Cannon <bcannon@gmail.com>
parents: 41034
diff changeset
449 syslog, termios, time, timing, zlib, audioop, imageop
6710
90c6390b4941 Add attributions to Jeffrey Ollie and Tim Peters for re.py; new QNX
Guido van Rossum <guido@python.org>
parents: 6680
diff changeset
450
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
451 3) make SHELL=/usr/local/bin/bash
17542
4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of
Guido van Rossum <guido@python.org>
parents: 17512
diff changeset
452
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
453 or, if you feel the need for speed:
17542
4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of
Guido van Rossum <guido@python.org>
parents: 17512
diff changeset
454
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
455 make SHELL=/usr/local/bin/bash OPT="-5 -Oil+nrt"
8818
71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth.
Guido van Rossum <guido@python.org>
parents: 8603
diff changeset
456
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
457 4) make SHELL=/usr/local/bin/bash test
6710
90c6390b4941 Add attributions to Jeffrey Ollie and Tim Peters for re.py; new QNX
Guido van Rossum <guido@python.org>
parents: 6680
diff changeset
458
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
459 Using GNU readline 2.2 seems to behave strangely, but I
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
460 think that's a problem with my readline 2.2 port. :-\
8818
71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth.
Guido van Rossum <guido@python.org>
parents: 8603
diff changeset
461
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
462 5) make SHELL=/usr/local/bin/bash install
6710
90c6390b4941 Add attributions to Jeffrey Ollie and Tim Peters for re.py; new QNX
Guido van Rossum <guido@python.org>
parents: 6680
diff changeset
463
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
464 If you get SIGSEGVs while running Python (I haven't yet, but
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
465 I've only run small programs and the test cases), you're
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
466 probably running out of stack; the default 32k could be a
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
467 little tight. To increase the stack size, edit the Makefile
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
468 to read: LDFLAGS = -N 48k
6018
f05546743406 Added QNX remarks.
Guido van Rossum <guido@python.org>
parents: 5951
diff changeset
469
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
470 BeOS: See Misc/BeOS-NOTES for notes about compiling/installing
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
471 Python on BeOS R3 or later. Note that only the PowerPC
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
472 platform is supported for R3; both PowerPC and x86 are
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
473 supported for R4.
8818
71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth.
Guido van Rossum <guido@python.org>
parents: 8603
diff changeset
474
24445
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
475 Cray T3E: Mark Hadfield (m.hadfield@niwa.co.nz) writes:
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
476 Python can be built satisfactorily on a Cray T3E but based on
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
477 my experience with the NIWA T3E (2002-05-22, version 2.2.1)
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
478 there are a few bugs and gotchas. For more information see a
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
479 thread on comp.lang.python in May 2002 entitled "Building
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
480 Python on Cray T3E".
24445
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
481
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
482 1) Use Cray's cc and not gcc. The latter was reported not to
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
483 work by Konrad Hinsen. It may work now, but it may not.
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
484
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
485 2) To set sys.platform to something sensible, pass the
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
486 following environment variable to the configure script:
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
487
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
488 MACHDEP=unicosmk
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
489
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
490 2) Run configure with option "--enable-unicode=ucs4".
24445
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
491
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
492 3) The Cray T3E does not support dynamic linking, so extension
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
493 modules have to be built by adding (or uncommenting) lines
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
494 in Modules/Setup. The minimum set of modules is
24445
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
495
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
496 posix, new, _sre, unicodedata
24445
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
497
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
498 On NIWA's vanilla T3E system the following have also been
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
499 included successfully:
24445
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
500
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
501 _codecs, _locale, _socket, _symtable, _testcapi, _weakref
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
502 array, binascii, cmath, cPickle, crypt, cStringIO, dbm
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
503 errno, fcntl, grp, math, md5, operator, parser, pcre, pwd
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
504 regex, rotor, select, struct, strop, syslog, termios
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
505 time, timing, xreadlines
24445
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
506
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
507 4) Once the python executable and library have been built, make
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
508 will execute setup.py, which will attempt to build remaining
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
509 extensions and link them dynamically. Each of these attempts
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
510 will fail but should not halt the make process. This is
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
511 normal.
24445
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
512
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
513 5) Running "make test" uses a lot of resources and causes
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
514 problems on our system. You might want to try running tests
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
515 singly or in small groups.
6122
db8ac6e109b4 Got rid of HP-UX comments (which seem to be out of date -- one should
Guido van Rossum <guido@python.org>
parents: 6077
diff changeset
516
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
517 SGI: SGI's standard "make" utility (/bin/make or /usr/bin/make)
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
518 does not check whether a command actually changed the file it
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
519 is supposed to build. This means that whenever you say "make"
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
520 it will redo the link step. The remedy is to use SGI's much
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
521 smarter "smake" utility (/usr/sbin/smake), or GNU make. If
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
522 you set the first line of the Makefile to #!/usr/sbin/smake
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
523 smake will be invoked by make (likewise for GNU make).
6132
94605b0026e7 Add warning about dumb SGI make.
Guido van Rossum <guido@python.org>
parents: 6122
diff changeset
524
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
525 WARNING: There are bugs in the optimizer of some versions of
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
526 SGI's compilers that can cause bus errors or other strange
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
527 behavior, especially on numerical operations. To avoid this,
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
528 try building with "make OPT=".
14927
c8f22f15499f Add a paragraph about an optimization bug in SGI compilers which affects
Fred Drake <fdrake@acm.org>
parents: 14920
diff changeset
529
6675
cdb3279b06e7 Revamped README for release of 1.5b1.
Guido van Rossum <guido@python.org>
parents: 6494
diff changeset
530 OS/2: If you are running Warp3 or Warp4 and have IBM's VisualAge C/C++
cdb3279b06e7 Revamped README for release of 1.5b1.
Guido van Rossum <guido@python.org>
parents: 6494
diff changeset
531 compiler installed, just change into the pc\os2vacpp directory
cdb3279b06e7 Revamped README for release of 1.5b1.
Guido van Rossum <guido@python.org>
parents: 6494
diff changeset
532 and type NMAKE. Threading and sockets are supported by default
cdb3279b06e7 Revamped README for release of 1.5b1.
Guido van Rossum <guido@python.org>
parents: 6494
diff changeset
533 in the resulting binaries of PYTHON15.DLL and PYTHON.EXE.
cdb3279b06e7 Revamped README for release of 1.5b1.
Guido van Rossum <guido@python.org>
parents: 6494
diff changeset
534
15043
c0c254fbde57 Added section on threads problems on Reliant UNIX; this relates to
Fred Drake <fdrake@acm.org>
parents: 14927
diff changeset
535 Reliant UNIX: The thread support does not compile on Reliant UNIX, and
c0c254fbde57 Added section on threads problems on Reliant UNIX; this relates to
Fred Drake <fdrake@acm.org>
parents: 14927
diff changeset
536 there is a (minor) problem in the configure script for that
c0c254fbde57 Added section on threads problems on Reliant UNIX; this relates to
Fred Drake <fdrake@acm.org>
parents: 14927
diff changeset
537 platform as well. This should be resolved in time for a
c0c254fbde57 Added section on threads problems on Reliant UNIX; this relates to
Fred Drake <fdrake@acm.org>
parents: 14927
diff changeset
538 future release.
14144
31cda87e9ff4 This patch partly (some stuff went in already) ports Python to Monterey.
Trent Mick <trentm@activestate.com>
parents: 14137
diff changeset
539
25781
cc41b9cacae8 There was a typo in the MacOSX section regarding the stacksize issue.
Barry Warsaw <barry@python.org>
parents: 25351
diff changeset
540 MacOSX: The tests will crash on both 10.1 and 10.2 with SEGV in
25783
2ef71f351c74 I'd forgotten that tcsh was the default for 10.1, but SF's 10.1 system
Barry Warsaw <barry@python.org>
parents: 25781
diff changeset
541 test_re and test_sre due to the small default stack size. If
2ef71f351c74 I'd forgotten that tcsh was the default for 10.1, but SF's 10.1 system
Barry Warsaw <barry@python.org>
parents: 25781
diff changeset
542 you set the stack size to 2048 before doing a "make test" the
41034
6cd366e6beec Patch #1673121: update README wrt. OSX default shell.
Georg Brandl <georg@python.org>
parents: 40561
diff changeset
543 failure can be avoided. If you're using the tcsh or csh shells,
6cd366e6beec Patch #1673121: update README wrt. OSX default shell.
Georg Brandl <georg@python.org>
parents: 40561
diff changeset
544 use "limit stacksize 2048" and for the bash shell (the default
6cd366e6beec Patch #1673121: update README wrt. OSX default shell.
Georg Brandl <georg@python.org>
parents: 40561
diff changeset
545 as of OSX 10.3), use "ulimit -s 2048".
21414
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk.
Barry Warsaw <barry@python.org>
parents: 21367
diff changeset
546
21273
ecbbeccde07d Cleaned up Mac OS X section to the current state of affairs.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20959
diff changeset
547 On naked Darwin you may want to add the configure option
20314
284eabe3b552 Mac OS X build instructions talked about --without-toolbox-glue, but
Jack Jansen <jack.jansen@cwi.nl>
parents: 20270
diff changeset
548 "--disable-toolbox-glue" to disable the glue code for the Carbon
21273
ecbbeccde07d Cleaned up Mac OS X section to the current state of affairs.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20959
diff changeset
549 interface modules. The modules themselves are currently only built
ecbbeccde07d Cleaned up Mac OS X section to the current state of affairs.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20959
diff changeset
550 if you add the --enable-framework option, see below.
21414
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk.
Barry Warsaw <barry@python.org>
parents: 21367
diff changeset
551
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk.
Barry Warsaw <barry@python.org>
parents: 21367
diff changeset
552 On a clean OSX /usr/local does not exist. Do a
21632
5861885577e9 Rephrased the OSX stack limit problem, after a complaint about it.
Jack Jansen <jack.jansen@cwi.nl>
parents: 21495
diff changeset
553 "sudo mkdir -m 775 /usr/local"
24547
4f00134b561d Changes to the OSX section:
Jack Jansen <jack.jansen@cwi.nl>
parents: 24525
diff changeset
554 before you do a make install. It is probably not a good idea to
4f00134b561d Changes to the OSX section:
Jack Jansen <jack.jansen@cwi.nl>
parents: 24525
diff changeset
555 do "sudo make install" which installs everything as superuser,
4f00134b561d Changes to the OSX section:
Jack Jansen <jack.jansen@cwi.nl>
parents: 24525
diff changeset
556 as this may later cause problems when installing distutils-based
4f00134b561d Changes to the OSX section:
Jack Jansen <jack.jansen@cwi.nl>
parents: 24525
diff changeset
557 additions.
34629
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
558
24547
4f00134b561d Changes to the OSX section:
Jack Jansen <jack.jansen@cwi.nl>
parents: 24525
diff changeset
559 Some people have reported problems building Python after using "fink"
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
560 to install additional unix software. Disabling fink (remove all
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
561 references to /sw from your .profile or .login) should solve this.
21414
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk.
Barry Warsaw <barry@python.org>
parents: 21367
diff changeset
562
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk.
Barry Warsaw <barry@python.org>
parents: 21367
diff changeset
563 You may want to try the configure option "--enable-framework"
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk.
Barry Warsaw <barry@python.org>
parents: 21367
diff changeset
564 which installs Python as a framework. The location can be set
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk.
Barry Warsaw <barry@python.org>
parents: 21367
diff changeset
565 as argument to the --enable-framework option (default
24547
4f00134b561d Changes to the OSX section:
Jack Jansen <jack.jansen@cwi.nl>
parents: 24525
diff changeset
566 /Library/Frameworks). A framework install is probably needed if you
4f00134b561d Changes to the OSX section:
Jack Jansen <jack.jansen@cwi.nl>
parents: 24525
diff changeset
567 want to use any Aqua-based GUI toolkit (whether Tkinter, wxPython,
4f00134b561d Changes to the OSX section:
Jack Jansen <jack.jansen@cwi.nl>
parents: 24525
diff changeset
568 Carbon, Cocoa or anything else).
34629
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
569
44242
66dbe12ddf31 Remove all tabs in that file.
Georg Brandl <georg@python.org>
parents: 44241
diff changeset
570 You may also want to try the configure option "--enable-universalsdk"
66dbe12ddf31 Remove all tabs in that file.
Georg Brandl <georg@python.org>
parents: 44241
diff changeset
571 which builds Python as a universal binary with support for the
66dbe12ddf31 Remove all tabs in that file.
Georg Brandl <georg@python.org>
parents: 44241
diff changeset
572 i386 and PPC architetures. This requires Xcode 2.1 or later to build.
38040
36c7a4422e30 Patch 1471883: --enable-universalsdk on Mac OS X
Ronald Oussoren <ronaldoussoren@mac.com>
parents: 37709
diff changeset
573
44241
5ac874d09556 #1575: the Mac readme is now one level up.
Georg Brandl <georg@python.org>
parents: 41934
diff changeset
574 See Mac/README for more information on framework and
44242
66dbe12ddf31 Remove all tabs in that file.
Georg Brandl <georg@python.org>
parents: 44241
diff changeset
575 universal builds.
16390
d34f25046ad4 Added note about need for -traditional-cpp on the MacOS X Public Beta.
Fred Drake <fdrake@acm.org>
parents: 16288
diff changeset
576
21491
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
577 Cygwin: With recent (relative to the time of writing, 2001-12-19)
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
578 Cygwin installations, there are problems with the interaction
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
579 of dynamic linking and fork(). This manifests itself in build
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
580 failures during the execution of setup.py.
17542
4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of
Guido van Rossum <guido@python.org>
parents: 17512
diff changeset
581
21491
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
582 There are two workarounds that both enable Python (albeit
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
583 without threading support) to build and pass all tests on
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
584 NT/2000 (and most likely XP as well, though reports of testing
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
585 on XP would be appreciated).
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
586
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
587 The workarounds:
17311
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler.
Tim Peters <tim.peters@gmail.com>
parents: 17210
diff changeset
588
21491
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
589 (a) the band-aid fix is to link the _socket module statically
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
590 rather than dynamically (which is the default).
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
591
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
592 To do this, run "./configure --with-threads=no" including any
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
593 other options you need (--prefix, etc.). Then in Modules/Setup
27619
558d0f3b6254 Fix typos.
Walter Dörwald <walter@livinglogic.de>
parents: 27253
diff changeset
594 uncomment the lines:
17542
4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of
Guido van Rossum <guido@python.org>
parents: 17512
diff changeset
595
21367
8a89ff1e0662 This is what Jason Tishler and I believe to be the state of play on Cygwin
Michael W. Hudson <mwh@python.net>
parents: 21273
diff changeset
596 #SSL=/usr/local/ssl
8a89ff1e0662 This is what Jason Tishler and I believe to be the state of play on Cygwin
Michael W. Hudson <mwh@python.net>
parents: 21273
diff changeset
597 #_socket socketmodule.c \
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
598 # -DUSE_SSL -I$(SSL)/include -I$(SSL)/include/openssl \
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
599 # -L$(SSL)/lib -lssl -lcrypto
17311
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler.
Tim Peters <tim.peters@gmail.com>
parents: 17210
diff changeset
600
21491
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
601 and remove "local/" from the SSL variable. Finally, just run
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
602 "make"!
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
603
21495
2474414d4342 Apparently it's Cygwin with a capital C.
Michael W. Hudson <mwh@python.net>
parents: 21493
diff changeset
604 (b) The "proper" fix is to rebase the Cygwin DLLs to prevent
21491
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
605 base address conflicts. Details on how to do this can be
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
606 found in the following mail:
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
607
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
608 http://sources.redhat.com/ml/cygwin/2001-12/msg00894.html
17542
4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of
Guido van Rossum <guido@python.org>
parents: 17512
diff changeset
609
21491
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
610 It is hoped that a version of this solution will be
21495
2474414d4342 Apparently it's Cygwin with a capital C.
Michael W. Hudson <mwh@python.net>
parents: 21493
diff changeset
611 incorporated into the Cygwin distribution fairly soon.
21491
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
612
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
613 Two additional problems:
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
614
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
615 (1) Threading support should still be disabled due to a known
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
616 bug in Cygwin pthreads that causes test_threadedtempfile to
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
617 hang.
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
618
21493
162106b16e44 Fix a typo
Neal Norwitz <nnorwitz@gmail.com>
parents: 21491
diff changeset
619 (2) The _curses module does not build. This is a known
21491
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
620 Cygwin ncurses problem that should be resolved the next time
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
621 that this package is released.
17311
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler.
Tim Peters <tim.peters@gmail.com>
parents: 17210
diff changeset
622
21367
8a89ff1e0662 This is what Jason Tishler and I believe to be the state of play on Cygwin
Michael W. Hudson <mwh@python.net>
parents: 21273
diff changeset
623 On older versions of Cygwin, test_poll may hang and test_strftime
8a89ff1e0662 This is what Jason Tishler and I believe to be the state of play on Cygwin
Michael W. Hudson <mwh@python.net>
parents: 21273
diff changeset
624 may fail.
17542
4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of
Guido van Rossum <guido@python.org>
parents: 17512
diff changeset
625
21491
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
626 The situation on 9X/Me is not accurately known at present.
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
627 Some time ago, there were reports that the following
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
628 regression tests failed:
17311
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler.
Tim Peters <tim.peters@gmail.com>
parents: 17210
diff changeset
629
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler.
Tim Peters <tim.peters@gmail.com>
parents: 17210
diff changeset
630 test_pwd
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler.
Tim Peters <tim.peters@gmail.com>
parents: 17210
diff changeset
631 test_select (hang)
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler.
Tim Peters <tim.peters@gmail.com>
parents: 17210
diff changeset
632 test_socket
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler.
Tim Peters <tim.peters@gmail.com>
parents: 17210
diff changeset
633
21491
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
634 Due to the test_select hang on 9X/Me, one should run the
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
635 regression test using the following:
17311
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler.
Tim Peters <tim.peters@gmail.com>
parents: 17210
diff changeset
636
21367
8a89ff1e0662 This is what Jason Tishler and I believe to be the state of play on Cygwin
Michael W. Hudson <mwh@python.net>
parents: 21273
diff changeset
637 make TESTOPTS='-l -x test_select' test
17311
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler.
Tim Peters <tim.peters@gmail.com>
parents: 17210
diff changeset
638
21491
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
639 News regarding these platforms with more recent Cygwin
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
640 versions would be appreciated!
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
641
52598
fa9243bf5256 #1675026: add a note about a strange Windows problem, and remove notes about AtheOS.
Georg Brandl <georg@python.org>
parents: 52597
diff changeset
642 Windows: When executing Python scripts on the command line using file type
fa9243bf5256 #1675026: add a note about a strange Windows problem, and remove notes about AtheOS.
Georg Brandl <georg@python.org>
parents: 52597
diff changeset
643 associations (i.e. starting "script.py" instead of "python script.py"),
fa9243bf5256 #1675026: add a note about a strange Windows problem, and remove notes about AtheOS.
Georg Brandl <georg@python.org>
parents: 52597
diff changeset
644 redirects may not work unless you set a specific registry key. See
fa9243bf5256 #1675026: add a note about a strange Windows problem, and remove notes about AtheOS.
Georg Brandl <georg@python.org>
parents: 52597
diff changeset
645 the Knowledge Base article <http://support.microsoft.com/kb/321788>.
27077
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the
Skip Montanaro <skip@pobox.com>
parents: 27053
diff changeset
646
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the
Skip Montanaro <skip@pobox.com>
parents: 27053
diff changeset
647
23867
45d676933882 This introduces stricter library/header file checking for the Berkeley DB
Skip Montanaro <skip@pobox.com>
parents: 23415
diff changeset
648 Configuring the bsddb and dbm modules
45d676933882 This introduces stricter library/header file checking for the Berkeley DB
Skip Montanaro <skip@pobox.com>
parents: 23415
diff changeset
649 -------------------------------------
45d676933882 This introduces stricter library/header file checking for the Berkeley DB
Skip Montanaro <skip@pobox.com>
parents: 23415
diff changeset
650
27077
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the
Skip Montanaro <skip@pobox.com>
parents: 27053
diff changeset
651 Beginning with Python version 2.3, the PyBsddb package
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the
Skip Montanaro <skip@pobox.com>
parents: 27053
diff changeset
652 <http://pybsddb.sf.net/> was adopted into Python as the bsddb package,
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the
Skip Montanaro <skip@pobox.com>
parents: 27053
diff changeset
653 exposing a set of package-level functions which provide
37691
eac83feeb11f raise the minimum supported BerkeleyDB version to 3.3 and add notes to
Gregory P. Smith <greg@mad-scientist.com>
parents: 37605
diff changeset
654 backwards-compatible behavior. Only versions 3.3 through 4.4 of
27077
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the
Skip Montanaro <skip@pobox.com>
parents: 27053
diff changeset
655 Sleepycat's libraries provide the necessary API, so older versions
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the
Skip Montanaro <skip@pobox.com>
parents: 27053
diff changeset
656 aren't supported through this interface. The old bsddb module has
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the
Skip Montanaro <skip@pobox.com>
parents: 27053
diff changeset
657 been retained as bsddb185, though it is not built by default. Users
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the
Skip Montanaro <skip@pobox.com>
parents: 27053
diff changeset
658 wishing to use it will have to tweak Modules/Setup to build it. The
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the
Skip Montanaro <skip@pobox.com>
parents: 27053
diff changeset
659 dbm module will still be built against the Sleepycat libraries if
37691
eac83feeb11f raise the minimum supported BerkeleyDB version to 3.3 and add notes to
Gregory P. Smith <greg@mad-scientist.com>
parents: 37605
diff changeset
660 other preferred alternatives (ndbm, gdbm) are not found.
23867
45d676933882 This introduces stricter library/header file checking for the Berkeley DB
Skip Montanaro <skip@pobox.com>
parents: 23415
diff changeset
661
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
662 Building the sqlite3 module
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
663 ---------------------------
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
664
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
665 To build the sqlite3 module, you'll need the sqlite3 or libsqlite3
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
666 packages installed, including the header files. Many modern operating
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
667 systems distribute the headers in a separate package to the library -
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
668 often it will be the same name as the main package, but with a -dev or
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
669 -devel suffix.
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
670
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
671 The version of pysqlite2 that's including in Python needs sqlite3 3.0.8
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
672 or later. setup.py attempts to check that it can find a correct version.
23867
45d676933882 This introduces stricter library/header file checking for the Berkeley DB
Skip Montanaro <skip@pobox.com>
parents: 23415
diff changeset
673
8316
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
674 Configuring threads
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
675 -------------------
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
676
14249
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost
Guido van Rossum <guido@python.org>
parents: 14144
diff changeset
677 As of Python 2.0, threads are enabled by default. If you wish to
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost
Guido van Rossum <guido@python.org>
parents: 14144
diff changeset
678 compile without threads, or if your thread support is broken, pass the
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost
Guido van Rossum <guido@python.org>
parents: 14144
diff changeset
679 --with-threads=no switch to configure. Unfortunately, on some
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost
Guido van Rossum <guido@python.org>
parents: 14144
diff changeset
680 platforms, additional compiler and/or linker options are required for
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost
Guido van Rossum <guido@python.org>
parents: 14144
diff changeset
681 threads to work properly. Below is a table of those options,
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
682 collected by Bill Janssen. We would love to automate this process
14249
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost
Guido van Rossum <guido@python.org>
parents: 14144
diff changeset
683 more, but the information below is not enough to write a patch for the
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost
Guido van Rossum <guido@python.org>
parents: 14144
diff changeset
684 configure.in file, so manual intervention is required. If you patch
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost
Guido van Rossum <guido@python.org>
parents: 14144
diff changeset
685 the configure.in file and are confident that the patch works, please
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
686 send in the patch. (Don't bother patching the configure script itself
27619
558d0f3b6254 Fix typos.
Walter Dörwald <walter@livinglogic.de>
parents: 27253
diff changeset
687 -- it is regenerated each time the configure.in file changes.)
8316
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
688
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
689 Compiler switches for threads
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
690 .............................
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
691
16994
459c8ef0a010 Document that _REENTRANT is not needed explicitly.
Martin v. Löwis <martin@v.loewis.de>
parents: 16776
diff changeset
692 The definition of _REENTRANT should be configured automatically, if
459c8ef0a010 Document that _REENTRANT is not needed explicitly.
Martin v. Löwis <martin@v.loewis.de>
parents: 16776
diff changeset
693 that does not work on your system, or if _REENTRANT is defined
459c8ef0a010 Document that _REENTRANT is not needed explicitly.
Martin v. Löwis <martin@v.loewis.de>
parents: 16776
diff changeset
694 incorrectly, please report that as a bug.
459c8ef0a010 Document that _REENTRANT is not needed explicitly.
Martin v. Löwis <martin@v.loewis.de>
parents: 16776
diff changeset
695
8316
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
696 OS/Compiler/threads Switches for use with threads
16994
459c8ef0a010 Document that _REENTRANT is not needed explicitly.
Martin v. Löwis <martin@v.loewis.de>
parents: 16776
diff changeset
697 (POSIX is draft 10, DCE is draft 4) compile & link
8316
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
698
16994
459c8ef0a010 Document that _REENTRANT is not needed explicitly.
Martin v. Löwis <martin@v.loewis.de>
parents: 16776
diff changeset
699 SunOS 5.{1-5}/{gcc,SunPro cc}/solaris -mt
459c8ef0a010 Document that _REENTRANT is not needed explicitly.
Martin v. Löwis <martin@v.loewis.de>
parents: 16776
diff changeset
700 SunOS 5.5/{gcc,SunPro cc}/POSIX (nothing)
17542
4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of
Guido van Rossum <guido@python.org>
parents: 17512
diff changeset
701 DEC OSF/1 3.x/cc/DCE -threads
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
702 (butenhof@zko.dec.com)
17542
4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of
Guido van Rossum <guido@python.org>
parents: 17512
diff changeset
703 Digital UNIX 4.x/cc/DCE -threads
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
704 (butenhof@zko.dec.com)
17542
4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of
Guido van Rossum <guido@python.org>
parents: 17512
diff changeset
705 Digital UNIX 4.x/cc/POSIX -pthread
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
706 (butenhof@zko.dec.com)
17542
4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of
Guido van Rossum <guido@python.org>
parents: 17512
diff changeset
707 AIX 4.1.4/cc_r/d7 (nothing)
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
708 (buhrt@iquest.net)
17542
4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of
Guido van Rossum <guido@python.org>
parents: 17512
diff changeset
709 AIX 4.1.4/cc_r4/DCE (nothing)
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
710 (buhrt@iquest.net)
17542
4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of
Guido van Rossum <guido@python.org>
parents: 17512
diff changeset
711 IRIX 6.2/cc/POSIX (nothing)
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
712 (robertl@cwi.nl)
8316
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
713
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
714
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
715 Linker (ld) libraries and flags for threads
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
716 ...........................................
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
717
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
718 OS/threads Libraries/switches for use with threads
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
719
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
720 SunOS 5.{1-5}/solaris -lthread
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
721 SunOS 5.5/POSIX -lpthread
17542
4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of
Guido van Rossum <guido@python.org>
parents: 17512
diff changeset
722 DEC OSF/1 3.x/DCE -lpthreads -lmach -lc_r -lc
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
723 (butenhof@zko.dec.com)
8316
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
724 Digital UNIX 4.x/DCE -lpthreads -lpthread -lmach -lexc -lc
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
725 (butenhof@zko.dec.com)
17542
4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of
Guido van Rossum <guido@python.org>
parents: 17512
diff changeset
726 Digital UNIX 4.x/POSIX -lpthread -lmach -lexc -lc
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
727 (butenhof@zko.dec.com)
17542
4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of
Guido van Rossum <guido@python.org>
parents: 17512
diff changeset
728 AIX 4.1.4/{draft7,DCE} (nothing)
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
729 (buhrt@iquest.net)
17542
4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of
Guido van Rossum <guido@python.org>
parents: 17512
diff changeset
730 IRIX 6.2/POSIX -lpthread
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
731 (jph@emilia.engr.sgi.com)
8316
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
732
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
733
22662
1aea7af09260 Patch #527027: Allow building python as shared library.
Martin v. Löwis <martin@v.loewis.de>
parents: 22436
diff changeset
734 Building a shared libpython
1aea7af09260 Patch #527027: Allow building python as shared library.
Martin v. Löwis <martin@v.loewis.de>
parents: 22436
diff changeset
735 ---------------------------
1aea7af09260 Patch #527027: Allow building python as shared library.
Martin v. Löwis <martin@v.loewis.de>
parents: 22436
diff changeset
736
1aea7af09260 Patch #527027: Allow building python as shared library.
Martin v. Löwis <martin@v.loewis.de>
parents: 22436
diff changeset
737 Starting with Python 2.3, the majority of the interpreter can be built
34629
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
738 into a shared library, which can then be used by the interpreter
22662
1aea7af09260 Patch #527027: Allow building python as shared library.
Martin v. Löwis <martin@v.loewis.de>
parents: 22436
diff changeset
739 executable, and by applications embedding Python. To enable this feature,
34629
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
740 configure with --enable-shared.
24525
3cb055aae739 Document that --enable-shared puts PIC objects into the static libpython.
Martin v. Löwis <martin@v.loewis.de>
parents: 24445
diff changeset
741
29954
baf2241070bf Clarify a statement regarding both shared and static library.
Fred Drake <fdrake@acm.org>
parents: 29932
diff changeset
742 If you enable this feature, the same object files will be used to create
baf2241070bf Clarify a statement regarding both shared and static library.
Fred Drake <fdrake@acm.org>
parents: 29932
diff changeset
743 a static library. In particular, the static library will contain object
baf2241070bf Clarify a statement regarding both shared and static library.
Fred Drake <fdrake@acm.org>
parents: 29932
diff changeset
744 files using position-independent code (PIC) on platforms where PIC flags
baf2241070bf Clarify a statement regarding both shared and static library.
Fred Drake <fdrake@acm.org>
parents: 29932
diff changeset
745 are needed for the shared library.
22662
1aea7af09260 Patch #527027: Allow building python as shared library.
Martin v. Löwis <martin@v.loewis.de>
parents: 22436
diff changeset
746
1aea7af09260 Patch #527027: Allow building python as shared library.
Martin v. Löwis <martin@v.loewis.de>
parents: 22436
diff changeset
747
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
748 Configuring additional built-in modules
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
749 ---------------------------------------
2162
c9aea34ae4b6 add hint for NeXT users
Guido van Rossum <guido@python.org>
parents: 2131
diff changeset
750
16776
2915eb07bd25 Update build notes to mention setup.py
Andrew M. Kuchling <amk@amk.ca>
parents: 16775
diff changeset
751 Starting with Python 2.1, the setup.py script at the top of the source
2915eb07bd25 Update build notes to mention setup.py
Andrew M. Kuchling <amk@amk.ca>
parents: 16775
diff changeset
752 distribution attempts to detect which modules can be built and
2915eb07bd25 Update build notes to mention setup.py
Andrew M. Kuchling <amk@amk.ca>
parents: 16775
diff changeset
753 automatically compiles them. Autodetection doesn't always work, so
21900
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
754 you can still customize the configuration by editing the Modules/Setup
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
755 file; but this should be considered a last resort. The rest of this
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
756 section only applies if you decide to edit the Modules/Setup file.
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
757 You also need this to enable static linking of certain modules (which
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
758 is needed to enable profiling on some systems).
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
759
16776
2915eb07bd25 Update build notes to mention setup.py
Andrew M. Kuchling <amk@amk.ca>
parents: 16775
diff changeset
760 This file is initially copied from Setup.dist by the configure script;
2915eb07bd25 Update build notes to mention setup.py
Andrew M. Kuchling <amk@amk.ca>
parents: 16775
diff changeset
761 if it does not exist yet, create it by copying Modules/Setup.dist
2915eb07bd25 Update build notes to mention setup.py
Andrew M. Kuchling <amk@amk.ca>
parents: 16775
diff changeset
762 yourself (configure will never overwrite it). Never edit Setup.dist
2915eb07bd25 Update build notes to mention setup.py
Andrew M. Kuchling <amk@amk.ca>
parents: 16775
diff changeset
763 -- always edit Setup or Setup.local (see below). Read the comments in
2915eb07bd25 Update build notes to mention setup.py
Andrew M. Kuchling <amk@amk.ca>
parents: 16775
diff changeset
764 the file for information on what kind of edits are allowed. When you
2915eb07bd25 Update build notes to mention setup.py
Andrew M. Kuchling <amk@amk.ca>
parents: 16775
diff changeset
765 have edited Setup in the Modules directory, the interpreter will
20270
ce4a7e4ad6c4 Remove false statement about running make in the Modules directory.
Guido van Rossum <guido@python.org>
parents: 20252
diff changeset
766 automatically be rebuilt the next time you run make (in the toplevel
ce4a7e4ad6c4 Remove false statement about running make in the Modules directory.
Guido van Rossum <guido@python.org>
parents: 20252
diff changeset
767 directory).
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
768
16776
2915eb07bd25 Update build notes to mention setup.py
Andrew M. Kuchling <amk@amk.ca>
parents: 16775
diff changeset
769 Many useful modules can be built on any Unix system, but some optional
2915eb07bd25 Update build notes to mention setup.py
Andrew M. Kuchling <amk@amk.ca>
parents: 16775
diff changeset
770 modules can't be reliably autodetected. Often the quickest way to
2915eb07bd25 Update build notes to mention setup.py
Andrew M. Kuchling <amk@amk.ca>
parents: 16775
diff changeset
771 determine whether a particular module works or not is to see if it
2915eb07bd25 Update build notes to mention setup.py
Andrew M. Kuchling <amk@amk.ca>
parents: 16775
diff changeset
772 will build: enable it in Setup, then if you get compilation or link
15325
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added
Fred Drake <fdrake@acm.org>
parents: 15249
diff changeset
773 errors, disable it -- you're either missing support or need to adjust
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added
Fred Drake <fdrake@acm.org>
parents: 15249
diff changeset
774 the compilation and linking parameters for that module.
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
775
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
776 On SGI IRIX, there are modules that interface to many SGI specific
16776
2915eb07bd25 Update build notes to mention setup.py
Andrew M. Kuchling <amk@amk.ca>
parents: 16775
diff changeset
777 system libraries, e.g. the GL library and the audio hardware. These
2915eb07bd25 Update build notes to mention setup.py
Andrew M. Kuchling <amk@amk.ca>
parents: 16775
diff changeset
778 modules will not be built by the setup.py script.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
779
5037
9ad7b8c36c79 Various notes added:
Guido van Rossum <guido@python.org>
parents: 4501
diff changeset
780 In addition to the file Setup, you can also edit the file Setup.local.
9ad7b8c36c79 Various notes added:
Guido van Rossum <guido@python.org>
parents: 4501
diff changeset
781 (the makesetup script processes both). You may find it more
9ad7b8c36c79 Various notes added:
Guido van Rossum <guido@python.org>
parents: 4501
diff changeset
782 convenient to edit Setup.local and leave Setup alone. Then, when
9ad7b8c36c79 Various notes added:
Guido van Rossum <guido@python.org>
parents: 4501
diff changeset
783 installing a new Python version, you can copy your old Setup.local
9ad7b8c36c79 Various notes added:
Guido van Rossum <guido@python.org>
parents: 4501
diff changeset
784 file.
9ad7b8c36c79 Various notes added:
Guido van Rossum <guido@python.org>
parents: 4501
diff changeset
785
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
786
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
787 Setting the optimization/debugging options
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
788 ------------------------------------------
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
789
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
790 If you want or need to change the optimization/debugging options for
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
791 the C compiler, assign to the OPT variable on the toplevel make
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
792 command; e.g. "make OPT=-g" will build a debugging version of Python
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
793 on most platforms. The default is OPT=-O; a value for OPT in the
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
794 environment when the configure script is run overrides this default
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
795 (likewise for CC; and the initial value for LIBS is used as the base
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
796 set of libraries to link with).
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
797
15325
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added
Fred Drake <fdrake@acm.org>
parents: 15249
diff changeset
798 When compiling with GCC, the default value of OPT will also include
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added
Fred Drake <fdrake@acm.org>
parents: 15249
diff changeset
799 the -Wall and -Wstrict-prototypes options.
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added
Fred Drake <fdrake@acm.org>
parents: 15249
diff changeset
800
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added
Fred Drake <fdrake@acm.org>
parents: 15249
diff changeset
801 Additional debugging code to help debug memory management problems can
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added
Fred Drake <fdrake@acm.org>
parents: 15249
diff changeset
802 be enabled by using the --with-pydebug option to the configure script.
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added
Fred Drake <fdrake@acm.org>
parents: 15249
diff changeset
803
34929
08e20e9c76fb Introduced EXTRA_CFLAGS as an environment variable used by the Makefile. Meant
Brett Cannon <bcannon@gmail.com>
parents: 34629
diff changeset
804 For flags that change binary compatibility, use the EXTRA_CFLAGS
08e20e9c76fb Introduced EXTRA_CFLAGS as an environment variable used by the Makefile. Meant
Brett Cannon <bcannon@gmail.com>
parents: 34629
diff changeset
805 variable.
08e20e9c76fb Introduced EXTRA_CFLAGS as an environment variable used by the Makefile. Meant
Brett Cannon <bcannon@gmail.com>
parents: 34629
diff changeset
806
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
807
20252
b85cd163cd5c Add note about profiling.
Guido van Rossum <guido@python.org>
parents: 19758
diff changeset
808 Profiling
b85cd163cd5c Add note about profiling.
Guido van Rossum <guido@python.org>
parents: 19758
diff changeset
809 ---------
b85cd163cd5c Add note about profiling.
Guido van Rossum <guido@python.org>
parents: 19758
diff changeset
810
b85cd163cd5c Add note about profiling.
Guido van Rossum <guido@python.org>
parents: 19758
diff changeset
811 If you want C profiling turned on, the easiest way is to run configure
b85cd163cd5c Add note about profiling.
Guido van Rossum <guido@python.org>
parents: 19758
diff changeset
812 with the CC environment variable to the necessary compiler
b85cd163cd5c Add note about profiling.
Guido van Rossum <guido@python.org>
parents: 19758
diff changeset
813 invocation. For example, on Linux, this works for profiling using
b85cd163cd5c Add note about profiling.
Guido van Rossum <guido@python.org>
parents: 19758
diff changeset
814 gprof(1):
b85cd163cd5c Add note about profiling.
Guido van Rossum <guido@python.org>
parents: 19758
diff changeset
815
b85cd163cd5c Add note about profiling.
Guido van Rossum <guido@python.org>
parents: 19758
diff changeset
816 CC="gcc -pg" ./configure
b85cd163cd5c Add note about profiling.
Guido van Rossum <guido@python.org>
parents: 19758
diff changeset
817
b85cd163cd5c Add note about profiling.
Guido van Rossum <guido@python.org>
parents: 19758
diff changeset
818 Note that on Linux, gprof apparently does not work for shared
b85cd163cd5c Add note about profiling.
Guido van Rossum <guido@python.org>
parents: 19758
diff changeset
819 libraries. The Makefile/Setup mechanism can be used to compile and
27619
558d0f3b6254 Fix typos.
Walter Dörwald <walter@livinglogic.de>
parents: 27253
diff changeset
820 link most extension modules statically.
20252
b85cd163cd5c Add note about profiling.
Guido van Rossum <guido@python.org>
parents: 19758
diff changeset
821
b85cd163cd5c Add note about profiling.
Guido van Rossum <guido@python.org>
parents: 19758
diff changeset
822
47156
2e9f572b7322 GHOP #217: add support for compiling Python with coverage checking enabled.
Georg Brandl <georg@python.org>
parents: 46735
diff changeset
823 Coverage checking
2e9f572b7322 GHOP #217: add support for compiling Python with coverage checking enabled.
Georg Brandl <georg@python.org>
parents: 46735
diff changeset
824 -----------------
2e9f572b7322 GHOP #217: add support for compiling Python with coverage checking enabled.
Georg Brandl <georg@python.org>
parents: 46735
diff changeset
825
2e9f572b7322 GHOP #217: add support for compiling Python with coverage checking enabled.
Georg Brandl <georg@python.org>
parents: 46735
diff changeset
826 For C coverage checking using gcov, run "make coverage". This will
2e9f572b7322 GHOP #217: add support for compiling Python with coverage checking enabled.
Georg Brandl <georg@python.org>
parents: 46735
diff changeset
827 build a Python binary with profiling activated, and a ".gcno" and
2e9f572b7322 GHOP #217: add support for compiling Python with coverage checking enabled.
Georg Brandl <georg@python.org>
parents: 46735
diff changeset
828 ".gcda" file for every source file compiled with that option. With
2e9f572b7322 GHOP #217: add support for compiling Python with coverage checking enabled.
Georg Brandl <georg@python.org>
parents: 46735
diff changeset
829 the built binary, now run the code whose coverage you want to check.
2e9f572b7322 GHOP #217: add support for compiling Python with coverage checking enabled.
Georg Brandl <georg@python.org>
parents: 46735
diff changeset
830 Then, you can see coverage statistics for each individual source file
2e9f572b7322 GHOP #217: add support for compiling Python with coverage checking enabled.
Georg Brandl <georg@python.org>
parents: 46735
diff changeset
831 by running gcov, e.g.
2e9f572b7322 GHOP #217: add support for compiling Python with coverage checking enabled.
Georg Brandl <georg@python.org>
parents: 46735
diff changeset
832
2e9f572b7322 GHOP #217: add support for compiling Python with coverage checking enabled.
Georg Brandl <georg@python.org>
parents: 46735
diff changeset
833 gcov -o Modules zlibmodule
2e9f572b7322 GHOP #217: add support for compiling Python with coverage checking enabled.
Georg Brandl <georg@python.org>
parents: 46735
diff changeset
834
2e9f572b7322 GHOP #217: add support for compiling Python with coverage checking enabled.
Georg Brandl <georg@python.org>
parents: 46735
diff changeset
835 This will create a "zlibmodule.c.gcov" file in the current directory
2e9f572b7322 GHOP #217: add support for compiling Python with coverage checking enabled.
Georg Brandl <georg@python.org>
parents: 46735
diff changeset
836 containing coverage info for that source file.
2e9f572b7322 GHOP #217: add support for compiling Python with coverage checking enabled.
Georg Brandl <georg@python.org>
parents: 46735
diff changeset
837
2e9f572b7322 GHOP #217: add support for compiling Python with coverage checking enabled.
Georg Brandl <georg@python.org>
parents: 46735
diff changeset
838 This works only for source files statically compiled into the
2e9f572b7322 GHOP #217: add support for compiling Python with coverage checking enabled.
Georg Brandl <georg@python.org>
parents: 46735
diff changeset
839 executable; use the Makefile/Setup mechanism to compile and link
2e9f572b7322 GHOP #217: add support for compiling Python with coverage checking enabled.
Georg Brandl <georg@python.org>
parents: 46735
diff changeset
840 extension modules you want to coverage-check statically.
2e9f572b7322 GHOP #217: add support for compiling Python with coverage checking enabled.
Georg Brandl <georg@python.org>
parents: 46735
diff changeset
841
2e9f572b7322 GHOP #217: add support for compiling Python with coverage checking enabled.
Georg Brandl <georg@python.org>
parents: 46735
diff changeset
842
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
843 Testing
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
844 -------
1453
d773a5f89426 New files
Guido van Rossum <guido@python.org>
parents:
diff changeset
845
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
846 To test the interpreter, type "make test" in the top-level directory.
5525
8582f74a1d23 Update description of "make test" to new test harness.
Guido van Rossum <guido@python.org>
parents: 5466
diff changeset
847 This runs the test set twice (once with no compiled files, once with
8582f74a1d23 Update description of "make test" to new test harness.
Guido van Rossum <guido@python.org>
parents: 5466
diff changeset
848 the compiled files left by the previous test run). The test set
8582f74a1d23 Update description of "make test" to new test harness.
Guido van Rossum <guido@python.org>
parents: 5466
diff changeset
849 produces some output. You can generally ignore the messages about
21900
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
850 skipped tests due to optional features which can't be imported.
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
851 If a message is printed about a failed test or a traceback or core
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
852 dump is produced, something is wrong. On some Linux systems (those
6990
b2445c93f03b Refine note about strftime test failure (it's fixed in Linux glibc 6).
Guido van Rossum <guido@python.org>
parents: 6908
diff changeset
853 that are not yet using glibc 6), test_strftime fails due to a
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
854 non-standard implementation of strftime() in the C library. Please
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
855 ignore this, or upgrade to glibc version 6.
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
856
51825
fa747660d4d4 update README on running tests
Benjamin Peterson <benjamin@python.org>
parents: 50431
diff changeset
857 By default, tests are prevented from overusing resources like disk space and
fa747660d4d4 update README on running tests
Benjamin Peterson <benjamin@python.org>
parents: 50431
diff changeset
858 memory. To enable these tests, run "make testall".
fa747660d4d4 update README on running tests
Benjamin Peterson <benjamin@python.org>
parents: 50431
diff changeset
859
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
860 IMPORTANT: If the tests fail and you decide to mail a bug report,
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
861 *don't* include the output of "make test". It is useless. Run the
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
862 failing test manually, as follows:
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
863
51825
fa747660d4d4 update README on running tests
Benjamin Peterson <benjamin@python.org>
parents: 50431
diff changeset
864 ./python Lib/test/regrtest.py -v test_whatever
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
865
22436
888fcd9b858d [Bug #532136] Change path in README, as suggested by Ralph Corderoy
Andrew M. Kuchling <amk@amk.ca>
parents: 22215
diff changeset
866 (substituting the top of the source tree for '.' if you built in a
5525
8582f74a1d23 Update description of "make test" to new test harness.
Guido van Rossum <guido@python.org>
parents: 5466
diff changeset
867 different directory). This runs the test in verbose mode.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
868
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
869
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
870 Installing
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
871 ----------
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
872
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
873 To install the Python binary, library modules, shared library modules
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
874 (see below), include files, configuration files, and the manual page,
6675
cdb3279b06e7 Revamped README for release of 1.5b1.
Guido van Rossum <guido@python.org>
parents: 6494
diff changeset
875 just type
cdb3279b06e7 Revamped README for release of 1.5b1.
Guido van Rossum <guido@python.org>
parents: 6494
diff changeset
876
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
877 make install
6675
cdb3279b06e7 Revamped README for release of 1.5b1.
Guido van Rossum <guido@python.org>
parents: 6494
diff changeset
878
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
879 This will install all platform-independent files in subdirectories of
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
880 the directory given with the --prefix option to configure or to the
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
881 `prefix' Make variable (default /usr/local). All binary and other
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
882 platform-specific files will be installed in subdirectories if the
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
883 directory given by --exec-prefix or the `exec_prefix' Make variable
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
884 (defaults to the --prefix directory) is given.
6675
cdb3279b06e7 Revamped README for release of 1.5b1.
Guido van Rossum <guido@python.org>
parents: 6494
diff changeset
885
29074
988b3e807043 Patch #718286: Support DESTDIR.
Martin v. Löwis <martin@v.loewis.de>
parents: 28924
diff changeset
886 If DESTDIR is set, it will be taken as the root directory of the
988b3e807043 Patch #718286: Support DESTDIR.
Martin v. Löwis <martin@v.loewis.de>
parents: 28924
diff changeset
887 installation, and files will be installed into $(DESTDIR)$(prefix),
988b3e807043 Patch #718286: Support DESTDIR.
Martin v. Löwis <martin@v.loewis.de>
parents: 28924
diff changeset
888 $(DESTDIR)$(exec_prefix), etc.
988b3e807043 Patch #718286: Support DESTDIR.
Martin v. Löwis <martin@v.loewis.de>
parents: 28924
diff changeset
889
6675
cdb3279b06e7 Revamped README for release of 1.5b1.
Guido van Rossum <guido@python.org>
parents: 6494
diff changeset
890 All subdirectories created will have Python's version number in their
cdb3279b06e7 Revamped README for release of 1.5b1.
Guido van Rossum <guido@python.org>
parents: 6494
diff changeset
891 name, e.g. the library modules are installed in
15986
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs.
Guido van Rossum <guido@python.org>
parents: 15546
diff changeset
892 "/usr/local/lib/python<version>/" by default, where <version> is the
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs.
Guido van Rossum <guido@python.org>
parents: 15546
diff changeset
893 <major>.<minor> release number (e.g. "2.1"). The Python binary is
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs.
Guido van Rossum <guido@python.org>
parents: 15546
diff changeset
894 installed as "python<version>" and a hard link named "python" is
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs.
Guido van Rossum <guido@python.org>
parents: 15546
diff changeset
895 created. The only file not installed with a version number in its
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs.
Guido van Rossum <guido@python.org>
parents: 15546
diff changeset
896 name is the manual page, installed as "/usr/local/man/man1/python.1"
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs.
Guido van Rossum <guido@python.org>
parents: 15546
diff changeset
897 by default.
1453
d773a5f89426 New files
Guido van Rossum <guido@python.org>
parents:
diff changeset
898
45673
2216b100b2d2 Elaborate on the role of the altinstall target when installing multiple
Skip Montanaro <skip@pobox.com>
parents: 45590
diff changeset
899 If you want to install multiple versions of Python see the section below
2216b100b2d2 Elaborate on the role of the altinstall target when installing multiple
Skip Montanaro <skip@pobox.com>
parents: 45590
diff changeset
900 entitled "Installing multiple versions".
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
901
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
902 The only thing you may have to install manually is the Python mode for
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
903 Emacs found in Misc/python-mode.el. (But then again, more recent
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
904 versions of Emacs may already have it.) Follow the instructions that
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
905 came with Emacs for installation of site-specific files.
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
906
19381
60d5cbbeadc3 Removed NeXT notes (replacing them with a line saying NeXT is no
Jack Jansen <jack.jansen@cwi.nl>
parents: 17734
diff changeset
907 On Mac OS X, if you have configured Python with --enable-framework, you
60d5cbbeadc3 Removed NeXT notes (replacing them with a line saying NeXT is no
Jack Jansen <jack.jansen@cwi.nl>
parents: 17734
diff changeset
908 should use "make frameworkinstall" to do the installation. Note that this
60d5cbbeadc3 Removed NeXT notes (replacing them with a line saying NeXT is no
Jack Jansen <jack.jansen@cwi.nl>
parents: 17734
diff changeset
909 installs the Python executable in a place that is not normally on your
60d5cbbeadc3 Removed NeXT notes (replacing them with a line saying NeXT is no
Jack Jansen <jack.jansen@cwi.nl>
parents: 17734
diff changeset
910 PATH, you may want to set up a symlink in /usr/local/bin.
60d5cbbeadc3 Removed NeXT notes (replacing them with a line saying NeXT is no
Jack Jansen <jack.jansen@cwi.nl>
parents: 17734
diff changeset
911
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
912
45673
2216b100b2d2 Elaborate on the role of the altinstall target when installing multiple
Skip Montanaro <skip@pobox.com>
parents: 45590
diff changeset
913 Installing multiple versions
2216b100b2d2 Elaborate on the role of the altinstall target when installing multiple
Skip Montanaro <skip@pobox.com>
parents: 45590
diff changeset
914 ----------------------------
2216b100b2d2 Elaborate on the role of the altinstall target when installing multiple
Skip Montanaro <skip@pobox.com>
parents: 45590
diff changeset
915
2216b100b2d2 Elaborate on the role of the altinstall target when installing multiple
Skip Montanaro <skip@pobox.com>
parents: 45590
diff changeset
916 On Unix and Mac systems if you intend to install multiple versions of Python
2216b100b2d2 Elaborate on the role of the altinstall target when installing multiple
Skip Montanaro <skip@pobox.com>
parents: 45590
diff changeset
917 using the same installation prefix (--prefix argument to the configure
2216b100b2d2 Elaborate on the role of the altinstall target when installing multiple
Skip Montanaro <skip@pobox.com>
parents: 45590
diff changeset
918 script) you must take care that your primary python executable is not
55091
0e391bf3eb9d #6398 typo: versio. -> version.
Ezio Melotti <ezio.melotti@gmail.com>
parents: 53602
diff changeset
919 overwritten by the installation of a different version. All files and
45673
2216b100b2d2 Elaborate on the role of the altinstall target when installing multiple
Skip Montanaro <skip@pobox.com>
parents: 45590
diff changeset
920 directories installed using "make altinstall" contain the major and minor
2216b100b2d2 Elaborate on the role of the altinstall target when installing multiple
Skip Montanaro <skip@pobox.com>
parents: 45590
diff changeset
921 version and can thus live side-by-side. "make install" also creates
2216b100b2d2 Elaborate on the role of the altinstall target when installing multiple
Skip Montanaro <skip@pobox.com>
parents: 45590
diff changeset
922 ${prefix}/bin/python which refers to ${prefix}/bin/pythonX.Y. If you intend
2216b100b2d2 Elaborate on the role of the altinstall target when installing multiple
Skip Montanaro <skip@pobox.com>
parents: 45590
diff changeset
923 to install multiple versions using the same prefix you must decide which
2216b100b2d2 Elaborate on the role of the altinstall target when installing multiple
Skip Montanaro <skip@pobox.com>
parents: 45590
diff changeset
924 version (if any) is your "primary" version. Install that version using
2216b100b2d2 Elaborate on the role of the altinstall target when installing multiple
Skip Montanaro <skip@pobox.com>
parents: 45590
diff changeset
925 "make install". Install all other versions using "make altinstall".
2216b100b2d2 Elaborate on the role of the altinstall target when installing multiple
Skip Montanaro <skip@pobox.com>
parents: 45590
diff changeset
926
2216b100b2d2 Elaborate on the role of the altinstall target when installing multiple
Skip Montanaro <skip@pobox.com>
parents: 45590
diff changeset
927 For example, if you want to install Python 2.5, 2.6 and 3.0 with 2.6 being
2216b100b2d2 Elaborate on the role of the altinstall target when installing multiple
Skip Montanaro <skip@pobox.com>
parents: 45590
diff changeset
928 the primary version, you would execute "make install" in your 2.6 build
2216b100b2d2 Elaborate on the role of the altinstall target when installing multiple
Skip Montanaro <skip@pobox.com>
parents: 45590
diff changeset
929 directory and "make altinstall" in the others.
2216b100b2d2 Elaborate on the role of the altinstall target when installing multiple
Skip Montanaro <skip@pobox.com>
parents: 45590
diff changeset
930
2216b100b2d2 Elaborate on the role of the altinstall target when installing multiple
Skip Montanaro <skip@pobox.com>
parents: 45590
diff changeset
931
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
932 Configuration options and variables
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
933 -----------------------------------
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
934
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
935 Some special cases are handled by passing options to the configure
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
936 script.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
937
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
938 WARNING: if you rerun the configure script with different options, you
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
939 must run "make clean" before rebuilding. Exceptions to this rule:
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
940 after changing --prefix or --exec-prefix, all you need to do is remove
5951
8d7dc66968cb --with-readline is obsolete (and some editorial stuff in README)
Guido van Rossum <guido@python.org>
parents: 5591
diff changeset
941 Modules/getpath.o.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
942
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
943 --with(out)-gcc: The configure script uses gcc (the GNU C compiler) if
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
944 it finds it. If you don't want this, or if this compiler is
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
945 installed but broken on your platform, pass the option
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
946 --without-gcc. You can also pass "CC=cc" (or whatever the
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
947 name of the proper C compiler is) in the environment, but the
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
948 advantage of using --without-gcc is that this option is
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
949 remembered by the config.status script for its --recheck
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
950 option.
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
951
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
952 --prefix, --exec-prefix: If you want to install the binaries and the
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
953 Python library somewhere else than in /usr/local/{bin,lib},
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
954 you can pass the option --prefix=DIRECTORY; the interpreter
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
955 binary will be installed as DIRECTORY/bin/python and the
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
956 library files as DIRECTORY/lib/python/*. If you pass
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
957 --exec-prefix=DIRECTORY (as well) this overrides the
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
958 installation prefix for architecture-dependent files (like the
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
959 interpreter binary). Note that --prefix=DIRECTORY also
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
960 affects the default module search path (sys.path), when
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
961 Modules/config.c is compiled. Passing make the option
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
962 prefix=DIRECTORY (and/or exec_prefix=DIRECTORY) overrides the
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
963 prefix set at configuration time; this may be more convenient
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
964 than re-running the configure script if you change your mind
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
965 about the install prefix.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
966
21900
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
967 --with-readline: This option is no longer supported. GNU
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
968 readline is automatically enabled by setup.py when present.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
969
14249
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost
Guido van Rossum <guido@python.org>
parents: 14144
diff changeset
970 --with-threads: On most Unix systems, you can now use multiple
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
971 threads, and support for this is enabled by default. To
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
972 disable this, pass --with-threads=no. If the library required
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
973 for threads lives in a peculiar place, you can use
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
974 --with-thread=DIRECTORY. IMPORTANT: run "make clean" after
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
975 changing (either enabling or disabling) this option, or you
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
976 will get link errors! Note: for DEC Unix use
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
977 --with-dec-threads instead.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
978
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
979 --with-sgi-dl: On SGI IRIX 4, dynamic loading of extension modules is
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
980 supported by the "dl" library by Jack Jansen, which is
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
981 ftp'able from ftp://ftp.cwi.nl/pub/dynload/dl-1.6.tar.Z.
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
982 This is enabled (after you've ftp'ed and compiled the dl
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
983 library) by passing --with-sgi-dl=DIRECTORY where DIRECTORY
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
984 is the absolute pathname of the dl library. (Don't bother on
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
985 IRIX 5, it already has dynamic linking using SunOS style
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
986 shared libraries.) THIS OPTION IS UNSUPPORTED.
2049
07cf3b3baf16 The usual changes when a release is nearing...
Guido van Rossum <guido@python.org>
parents: 2015
diff changeset
987
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
988 --with-dl-dld: Dynamic loading of modules is rumored to be supported
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
989 on some other systems: VAX (Ultrix), Sun3 (SunOS 3.4), Sequent
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
990 Symmetry (Dynix), and Atari ST. This is done using a
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
991 combination of the GNU dynamic loading package
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
992 (ftp://ftp.cwi.nl/pub/dynload/dl-dld-1.1.tar.Z) and an
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
993 emulation of the SGI dl library mentioned above (the emulation
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
994 can be found at
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
995 ftp://ftp.cwi.nl/pub/dynload/dld-3.2.3.tar.Z). To
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
996 enable this, ftp and compile both libraries, then call
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
997 configure, passing it the option
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
998 --with-dl-dld=DL_DIRECTORY,DLD_DIRECTORY where DL_DIRECTORY is
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
999 the absolute pathname of the dl emulation library and
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1000 DLD_DIRECTORY is the absolute pathname of the GNU dld library.
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1001 (Don't bother on SunOS 4 or 5, they already have dynamic
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1002 linking using shared libraries.) THIS OPTION IS UNSUPPORTED.
2049
07cf3b3baf16 The usual changes when a release is nearing...
Guido van Rossum <guido@python.org>
parents: 2015
diff changeset
1003
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1004 --with-libm, --with-libc: It is possible to specify alternative
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1005 versions for the Math library (default -lm) and the C library
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1006 (default the empty string) using the options
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1007 --with-libm=STRING and --with-libc=STRING, respectively. For
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1008 example, if your system requires that you pass -lc_s to the C
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1009 compiler to use the shared C library, you can pass
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1010 --with-libc=-lc_s. These libraries are passed after all other
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1011 libraries, the C library last.
17542
4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of
Guido van Rossum <guido@python.org>
parents: 17512
diff changeset
1012
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
1013 --with-libs='libs': Add 'libs' to the LIBS that the python interpreter
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1014 is linked against.
3893
958d4c67526b Added doc para for --with-libs
Guido van Rossum <guido@python.org>
parents: 3887
diff changeset
1015
37709
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1016 --with-cxx-main=<compiler>: If you plan to use C++ extension modules,
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1017 then -- on some platforms -- you need to compile python's main()
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1018 function with the C++ compiler. With this option, make will use
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1019 <compiler> to compile main() *and* to link the python executable.
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1020 It is likely that the resulting executable depends on the C++
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1021 runtime library of <compiler>. (The default is --without-cxx-main.)
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1022
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1023 There are platforms that do not require you to build Python
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1024 with a C++ compiler in order to use C++ extension modules.
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1025 E.g., x86 Linux with ELF shared binaries and GCC 3.x, 4.x is such
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1026 a platform. We recommend that you configure Python
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1027 --without-cxx-main on those platforms because a mismatch
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1028 between the C++ compiler version used to build Python and to
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1029 build a C++ extension module is likely to cause a crash at
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1030 runtime.
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1031
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1032 The Python installation also stores the variable CXX that
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1033 determines, e.g., the C++ compiler distutils calls by default
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1034 to build C++ extensions. If you set CXX on the configure command
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1035 line to any string of non-zero length, then configure won't
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1036 change CXX. If you do not preset CXX but pass
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1037 --with-cxx-main=<compiler>, then configure sets CXX=<compiler>.
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1038 In all other cases, configure looks for a C++ compiler by
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1039 some common names (c++, g++, gcc, CC, cxx, cc++, cl) and sets
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1040 CXX to the first compiler it finds. If it does not find any
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1041 C++ compiler, then it sets CXX="".
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1042
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1043 Similarly, if you want to change the command used to link the
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1044 python executable, then set LINKCC on the configure command line.
15546
bb93b1dca571 Document --with-cxx.
Martin v. Löwis <martin@v.loewis.de>
parents: 15344
diff changeset
1045
bb93b1dca571 Document --with-cxx.
Martin v. Löwis <martin@v.loewis.de>
parents: 15344
diff changeset
1046
15325
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added
Fred Drake <fdrake@acm.org>
parents: 15249
diff changeset
1047 --with-pydebug: Enable additional debugging code to help track down
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1048 memory management problems. This allows printing a list of all
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1049 live objects when the interpreter terminates.
34629
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
1050
23029
8291473fde3e Mass checkin of universal newline support.
Jack Jansen <jack.jansen@cwi.nl>
parents: 22662
diff changeset
1051 --with(out)-universal-newlines: enable reading of text files with
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1052 foreign newline convention (default: enabled). In other words,
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1053 any of \r, \n or \r\n is acceptable as end-of-line character.
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1054 If enabled import and execfile will automatically accept any newline
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1055 in files. Python code can open a file with open(file, 'U') to
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1056 read it in universal newline mode. THIS OPTION IS UNSUPPORTED.
15325
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added
Fred Drake <fdrake@acm.org>
parents: 15249
diff changeset
1057
32301
41c59d80bbc5 Patch #510695: Add TSC profiling for the VM.
Martin v. Löwis <martin@v.loewis.de>
parents: 32027
diff changeset
1058 --with-tsc: Profile using the Pentium timestamping counter (TSC).
2049
07cf3b3baf16 The usual changes when a release is nearing...
Guido van Rossum <guido@python.org>
parents: 2015
diff changeset
1059
37605
e070c316eb45 Patch #1464444: Add --with-system-ffi.
Martin v. Löwis <martin@v.loewis.de>
parents: 37431
diff changeset
1060 --with-system-ffi: Build the _ctypes extension module using an ffi
44242
66dbe12ddf31 Remove all tabs in that file.
Georg Brandl <georg@python.org>
parents: 44241
diff changeset
1061 library installed on the system.
37605
e070c316eb45 Patch #1464444: Add --with-system-ffi.
Martin v. Löwis <martin@v.loewis.de>
parents: 37431
diff changeset
1062
53602
2ef2cb5773fe - Issue #4587: Add configure option --with-dbmliborder=db1:db2:... to specify
Matthias Klose <doko@ubuntu.com>
parents: 52598
diff changeset
1063 --with-dbmliborder=db1:db2:...: Specify the order that backends for the
2ef2cb5773fe - Issue #4587: Add configure option --with-dbmliborder=db1:db2:... to specify
Matthias Klose <doko@ubuntu.com>
parents: 52598
diff changeset
1064 dbm extension are checked. Valid value is a colon separated string
2ef2cb5773fe - Issue #4587: Add configure option --with-dbmliborder=db1:db2:... to specify
Matthias Klose <doko@ubuntu.com>
parents: 52598
diff changeset
1065 with the backend names `ndbm', `gdbm' and `bdb'.
34629
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
1066
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1067 Building for multiple architectures (using the VPATH feature)
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1068 -------------------------------------------------------------
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1069
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1070 If your file system is shared between multiple architectures, it
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1071 usually is not necessary to make copies of the sources for each
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1072 architecture you want to support. If the make program supports the
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1073 VPATH feature, you can create an empty build directory for each
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1074 architecture, and in each directory run the configure script (on the
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1075 appropriate machine with the appropriate options). This creates the
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1076 necessary subdirectories and the Makefiles therein. The Makefiles
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
1077 contain a line VPATH=... which points to a directory containing the
4134
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
1078 actual sources. (On SGI systems, use "smake -J1" instead of "make" if
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
1079 you use VPATH -- don't try gnumake.)
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1080
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1081 For example, the following is all you need to build a minimal Python
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1082 in /usr/tmp/python (assuming ~guido/src/python is the toplevel
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1083 directory and you want to build in /usr/tmp/python):
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1084
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1085 $ mkdir /usr/tmp/python
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1086 $ cd /usr/tmp/python
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1087 $ ~guido/src/python/configure
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1088 [...]
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1089 $ make
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1090 [...]
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1091 $
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1092
16288
c0a2441a4454 - Edit the QNX instructions to refer to Makefile, not Modules/Makefile.
Neil Schemenauer <nascheme@enme.ucalgary.ca>
parents: 16229
diff changeset
1093 Note that configure copies the original Setup file to the build
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1094 directory if it finds no Setup file there. This means that you can
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1095 edit the Setup file for each architecture independently. For this
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1096 reason, subsequent changes to the original Setup file are not tracked
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1097 automatically, as they might overwrite local changes. To force a copy
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1098 of a changed original Setup file, delete the target Setup file. (The
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1099 makesetup script supports multiple input files, so if you want to be
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1100 fancy you can change the rules to create an empty Setup.local if it
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1101 doesn't exist and run it with arguments $(srcdir)/Setup Setup.local;
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1102 however this assumes that you only need to add modules.)
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1103
44285
226a062ab43e Fixed bug #1613: Makefile's VPATH feature is broken
Christian Heimes <christian@cheimes.de>
parents: 44242
diff changeset
1104 Also note that you can't use a workspace for VPATH and non VPATH builds. The
226a062ab43e Fixed bug #1613: Makefile's VPATH feature is broken
Christian Heimes <christian@cheimes.de>
parents: 44242
diff changeset
1105 object files left behind by one version confuses the other.
226a062ab43e Fixed bug #1613: Makefile's VPATH feature is broken
Christian Heimes <christian@cheimes.de>
parents: 44242
diff changeset
1106
1453
d773a5f89426 New files
Guido van Rossum <guido@python.org>
parents:
diff changeset
1107
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1108 Building on non-UNIX systems
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1109 ----------------------------
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1110
34255
e81152152433 Update VC references. Backported to 2.4.
Martin v. Löwis <martin@v.loewis.de>
parents: 34042
diff changeset
1111 For Windows (2000/NT/ME/98/95), assuming you have MS VC++ 7.1, the
14673
df8d575d967d Updated Windows build info.
Tim Peters <tim.peters@gmail.com>
parents: 14429
diff changeset
1112 project files are in PCbuild, the workspace is pcbuild.dsw. See
df8d575d967d Updated Windows build info.
Tim Peters <tim.peters@gmail.com>
parents: 14429
diff changeset
1113 PCbuild\readme.txt for detailed instructions.
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1114
34255
e81152152433 Update VC references. Backported to 2.4.
Martin v. Löwis <martin@v.loewis.de>
parents: 34042
diff changeset
1115 For other non-Unix Windows compilers, in particular MS VC++ 6.0 and
10572
10bd2fb2a0d6 Clarify PC build instructions (point to PCbuild).
Guido van Rossum <guido@python.org>
parents: 10565
diff changeset
1116 for OS/2, enter the directory "PC" and read the file "readme.txt".
3887
957f42ea0f84 Numerous changes, but still a lot of XXX thingies.
Guido van Rossum <guido@python.org>
parents: 3850
diff changeset
1117
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1118 For the Mac, a separate source distribution will be made available,
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1119 for use with the CodeWarrior compiler. If you are interested in Mac
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1120 development, join the PythonMac Special Interest Group
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1121 (http://www.python.org/sigs/pythonmac-sig/, or send email to
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1122 pythonmac-sig-request@python.org).
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1123
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1124 Of course, there are also binary distributions available for these
15986
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs.
Guido van Rossum <guido@python.org>
parents: 15546
diff changeset
1125 platforms -- see http://www.python.org/.
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1126
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1127 To port Python to a new non-UNIX system, you will have to fake the
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1128 effect of running the configure script manually (for Mac and PC, this
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1129 has already been done for you). A good start is to copy the file
23962
111c1e59ad72 Random tweaks & updates.
Michael W. Hudson <mwh@python.net>
parents: 23867
diff changeset
1130 pyconfig.h.in to pyconfig.h and edit the latter to reflect the actual
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1131 configuration of your system. Most symbols must simply be defined as
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1132 1 only if the corresponding feature is present and can be left alone
23962
111c1e59ad72 Random tweaks & updates.
Michael W. Hudson <mwh@python.net>
parents: 23867
diff changeset
1133 otherwise; however the *_t type symbols must be defined as some
111c1e59ad72 Random tweaks & updates.
Michael W. Hudson <mwh@python.net>
parents: 23867
diff changeset
1134 variant of int if they need to be defined at all.
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1135
21414
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk.
Barry Warsaw <barry@python.org>
parents: 21367
diff changeset
1136 For all platforms, it's important that the build arrange to define the
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk.
Barry Warsaw <barry@python.org>
parents: 21367
diff changeset
1137 preprocessor symbol NDEBUG on the compiler command line in a release
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk.
Barry Warsaw <barry@python.org>
parents: 21367
diff changeset
1138 build of Python (else assert() calls remain in the code, hurting
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk.
Barry Warsaw <barry@python.org>
parents: 21367
diff changeset
1139 release-build performance). The Unix, Windows and Mac builds already
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk.
Barry Warsaw <barry@python.org>
parents: 21367
diff changeset
1140 do this.
1453
d773a5f89426 New files
Guido van Rossum <guido@python.org>
parents:
diff changeset
1141
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1142
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1143 Miscellaneous issues
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1144 ====================
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1145
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1146 Emacs mode
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1147 ----------
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1148
6448
b854ca4605e1 Ready for the release, I'd say.
Guido van Rossum <guido@python.org>
parents: 6132
diff changeset
1149 There's an excellent Emacs editing mode for Python code; see the file
b854ca4605e1 Ready for the release, I'd say.
Guido van Rossum <guido@python.org>
parents: 6132
diff changeset
1150 Misc/python-mode.el. Originally written by the famous Tim Peters, it
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
1151 is now maintained by the equally famous Barry Warsaw (it's no
15986
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs.
Guido van Rossum <guido@python.org>
parents: 15546
diff changeset
1152 coincidence that they now both work on the same team). The latest
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
1153 version, along with various other contributed Python-related Emacs
55721
675a3c1824f4 #6775: fix python.org URLs in README.
Georg Brandl <georg@python.org>
parents: 55091
diff changeset
1154 goodies, is online at http://www.python.org/emacs/python-mode/. And
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
1155 if you are planning to edit the Python C code, please pick up the
55721
675a3c1824f4 #6775: fix python.org URLs in README.
Georg Brandl <georg@python.org>
parents: 55091
diff changeset
1156 latest version of CC Mode http://www.python.org/emacs/cc-mode/; it
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
1157 contains a "python" style used throughout most of the Python C source
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
1158 files. (Newer versions of Emacs or XEmacs may already come with the
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
1159 latest version of python-mode.)
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1160
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1161
21900
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
1162 Tkinter
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
1163 -------
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1164
21900
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
1165 The setup.py script automatically configures this when it detects a
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
1166 usable Tcl/Tk installation. This requires Tcl/Tk version 8.0 or
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
1167 higher.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1168
13262
c6fd6ffbcb15 Update a bunch of URLs. No longer suggests to join PSA or Consortium.
Guido van Rossum <guido@python.org>
parents: 13232
diff changeset
1169 For more Tkinter information, see the Tkinter Resource page:
c6fd6ffbcb15 Update a bunch of URLs. No longer suggests to join PSA or Consortium.
Guido van Rossum <guido@python.org>
parents: 13232
diff changeset
1170 http://www.python.org/topics/tkinter/
6448
b854ca4605e1 Ready for the release, I'd say.
Guido van Rossum <guido@python.org>
parents: 6132
diff changeset
1171
34629
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
1172 There are demos in the Demo/tkinter directory.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1173
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1174 Note that there's a Python module called "Tkinter" (capital T) which
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
1175 lives in Lib/lib-tk/Tkinter.py, and a C module called "_tkinter"
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1176 (lower case t and leading underscore) which lives in
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
1177 Modules/_tkinter.c. Demos and normal Tk applications import only the
21900
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
1178 Python Tkinter module -- only the latter imports the C _tkinter
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
1179 module. In order to find the C _tkinter module, it must be compiled
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
1180 and linked into the Python interpreter -- the setup.py script does
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
1181 this. In order to find the Python Tkinter module, sys.path must be
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
1182 set correctly -- normal installation takes care of this.
3008
a51022f1980f 1.3b1 notes
Guido van Rossum <guido@python.org>
parents: 2730
diff changeset
1183
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1184
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1185 Distribution structure
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1186 ----------------------
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1187
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
1188 Most subdirectories have their own README files. Most files have
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1189 comments.
1453
d773a5f89426 New files
Guido van Rossum <guido@python.org>
parents:
diff changeset
1190
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1191 Demo/ Demonstration scripts, modules and programs
45259
8689b67265bf Docs are rst now.
Georg Brandl <georg@python.org>
parents: 44472
diff changeset
1192 Doc/ Documentation sources (reStructuredText)
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1193 Grammar/ Input for the parser generator
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1194 Include/ Public header files
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1195 LICENSE Licensing information
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1196 Lib/ Python library modules
23962
111c1e59ad72 Random tweaks & updates.
Michael W. Hudson <mwh@python.net>
parents: 23867
diff changeset
1197 Mac/ Macintosh specific resources
16229
e302586452a3 Update the build instructions for flat makefile.
Neil Schemenauer <nascheme@enme.ucalgary.ca>
parents: 15986
diff changeset
1198 Makefile.pre.in Source from which config.status creates the Makefile.pre
6448
b854ca4605e1 Ready for the release, I'd say.
Guido van Rossum <guido@python.org>
parents: 6132
diff changeset
1199 Misc/ Miscellaneous useful files
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1200 Modules/ Implementation of most built-in modules
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1201 Objects/ Implementation of most built-in object types
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
1202 PC/ Files specific to PC ports (DOS, Windows, OS/2)
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1203 PCbuild/ Build directory for Microsoft Visual C++
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1204 Parser/ The parser and tokenizer and their input handling
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
1205 Python/ The byte-compiler and interpreter
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1206 README The file you're reading now
41791
31029f6ebca2 Update directories/files at the top-level.
Neal Norwitz <nnorwitz@gmail.com>
parents: 41790
diff changeset
1207 RISCOS/ Files specific to RISC OS port
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1208 Tools/ Some useful programs written in Python
23962
111c1e59ad72 Random tweaks & updates.
Michael W. Hudson <mwh@python.net>
parents: 23867
diff changeset
1209 pyconfig.h.in Source from which pyconfig.h is created (GNU autoheader output)
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1210 configure Configuration shell script (GNU autoconf output)
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
1211 configure.in Configuration specification (input for GNU autoconf)
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1212 install-sh Shell script used to install files
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1213 setup.py Python script used to build extension modules
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1214
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1215 The following files will (may) be created in the toplevel directory by
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1216 the configuration and build processes:
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1217
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1218 Makefile Build rules
16229
e302586452a3 Update the build instructions for flat makefile.
Neil Schemenauer <nascheme@enme.ucalgary.ca>
parents: 15986
diff changeset
1219 Makefile.pre Build rules before running Modules/makesetup
23962
111c1e59ad72 Random tweaks & updates.
Michael W. Hudson <mwh@python.net>
parents: 23867
diff changeset
1220 buildno Keeps track of the build number
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
1221 config.cache Cache of configuration variables
23962
111c1e59ad72 Random tweaks & updates.
Michael W. Hudson <mwh@python.net>
parents: 23867
diff changeset
1222 pyconfig.h Configuration header
6448
b854ca4605e1 Ready for the release, I'd say.
Guido van Rossum <guido@python.org>
parents: 6132
diff changeset
1223 config.log Log from last configure run
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
1224 config.status Status from last run of the configure script
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1225 getbuildinfo.o Object file from Modules/getbuildinfo.c
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1226 libpython<version>.a The library archive
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1227 python The executable interpreter
41791
31029f6ebca2 Update directories/files at the top-level.
Neal Norwitz <nnorwitz@gmail.com>
parents: 41790
diff changeset
1228 reflog.txt Output from running the regression suite with the -R flag
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
1229 tags, TAGS Tags files for vi and Emacs
1453
d773a5f89426 New files
Guido van Rossum <guido@python.org>
parents:
diff changeset
1230
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1231
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
1232 That's all, folks!
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
1233 ------------------
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1234
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1235
15986
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs.
Guido van Rossum <guido@python.org>
parents: 15546
diff changeset
1236 --Guido van Rossum (home page: http://www.python.org/~guido/)