Mercurial > cpython-lru_cache-weakref

annotate README @ 80661:94de77bd0b4b 2.7

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Issue #16194: document imp.load_dynamic problems when read several extension modules from the same binary object file.
author Andrew Svetlov <andrew.svetlov@gmail.com>
date Thu, 29 Nov 2012 19:51:28 +0200
parents 9b9675995e29
children 4f35d9dc8a8e
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
75202
b2c6aff96e12 bump to 2.7.3rc1
Benjamin Peterson <benjamin@python.org>
parents: 74215
diff changeset
1 This is Python version 2.7.3
76208
c9910fd022fc Bump to 2.6.8
Barry Warsaw <barry@python.org>
parents: 75805
diff changeset
2 ============================
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
3
74215
01cd6db4147d add another year to glorious PSF IP
Benjamin Peterson <benjamin@python.org>
parents: 70635
diff changeset
4 Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011,
01cd6db4147d add another year to glorious PSF IP
Benjamin Peterson <benjamin@python.org>
parents: 70635
diff changeset
5 2012 Python Software Foundation. All rights reserved.
15986
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs.
Guido van Rossum <guido@python.org>
parents: 15546
diff changeset
6
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
7 Copyright (c) 2000 BeOpen.com.
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
8 All rights reserved.
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
9
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
10 Copyright (c) 1995-2001 Corporation for National Research Initiatives.
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
11 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
12
14385
39ab28572307 Remove a comma from CWI's copyright notice.
Guido van Rossum <guido@python.org>
parents: 14367
diff changeset
13 Copyright (c) 1991-1995 Stichting Mathematisch Centrum.
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
14 All rights reserved.
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
15
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
16
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
17 License information
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
18 -------------------
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
19
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
20 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
21 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
22 WARRANTIES.
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
23
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
24 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
25 (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
26 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
27 are entirely optional.
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
28
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
29 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
30 holders.
6837
96181a4a5482 Prepared the README for 1.5b2.
Guido van Rossum <guido@python.org>
parents: 6773
diff changeset
31
96181a4a5482 Prepared the README for 1.5b2.
Guido van Rossum <guido@python.org>
parents: 6773
diff changeset
32
3887
957f42ea0f84 Numerous changes, but still a lot of XXX thingies.
Guido van Rossum <guido@python.org>
parents: 3850
diff changeset
33 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
34 ---------------------------
3850
d1cff49e3cc8 Various changes (not done yet even for beta2 release)
Guido van Rossum <guido@python.org>
parents: 3778
diff changeset
35
15986
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs.
Guido van Rossum <guido@python.org>
parents: 15546
diff changeset
36 See the file "Misc/NEWS".
6675
cdb3279b06e7 Revamped README for release of 1.5b1.
Guido van Rossum <guido@python.org>
parents: 6494
diff changeset
37
34629
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
38
6675
cdb3279b06e7 Revamped README for release of 1.5b1.
Guido van Rossum <guido@python.org>
parents: 6494
diff changeset
39 If you don't read instructions
cdb3279b06e7 Revamped README for release of 1.5b1.
Guido van Rossum <guido@python.org>
parents: 6494
diff changeset
40 ------------------------------
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 Congratulations on getting this far. :-)
cdb3279b06e7 Revamped README for release of 1.5b1.
Guido van Rossum <guido@python.org>
parents: 6494
diff changeset
43
cdb3279b06e7 Revamped README for release of 1.5b1.
Guido van Rossum <guido@python.org>
parents: 6494
diff changeset
44 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
45 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
46 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
47 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
48
34629
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
49 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
50
d1cff49e3cc8 Various changes (not done yet even for beta2 release)
Guido van Rossum <guido@python.org>
parents: 3778
diff changeset
51
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
52 What is Python anyway?
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
53 ----------------------
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
54
34629
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
55 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
56 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
57 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
58 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
59 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
60 browser to http://www.python.org/.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
61
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
62
4501
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
63 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
64 ----------------------
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
65
10862
4f5d4945605c Added "Learning Python" to the books section.
Fred Drake <fdrake@acm.org>
parents: 10587
diff changeset
66 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
67 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
68 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
69
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
70 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
71 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
72
4501
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
73
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
74 Documentation
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
75 -------------
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 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
78 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
79 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
80 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
81 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
82 and functions!
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
83
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
84 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
85 (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
86 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
87 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
88 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
89 primarily for documentation authors, translators, and people with special
c11221906171 Updated README regarding doc formats
Benjamin Peterson <benjamin@python.org>
parents: 45673
diff changeset
90 formatting requirements.
21414
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk.
Barry Warsaw <barry@python.org>
parents: 21367
diff changeset
91
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
92
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
93 Web sites
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
94 ---------
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
95
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
96 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
97 http://www.python.org/. Come visit us!
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
98
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
99
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
100 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
101 ----------------------------
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
102
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
103 Read comp.lang.python, a high-volume discussion newsgroup about
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
104 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
105 for Python-related announcements. These are also accessible as
56830
97d7cd365dd5 Merged revisions 73206,73232,73299,73683,74020,74185,74544,74643,74647,74817,74838-74839,74865,74946,75402,75459,75604,75696 via svnmerge from
Georg Brandl <georg@python.org>
parents: 56742
diff changeset
106 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
107 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
108
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
109 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
110 http://groups.google.com/. The mailing lists are also archived, see
56830
97d7cd365dd5 Merged revisions 73206,73232,73299,73683,74020,74185,74544,74643,74647,74817,74838-74839,74865,74946,75402,75459,75604,75696 via svnmerge from
Georg Brandl <georg@python.org>
parents: 56742
diff changeset
111 http://www.python.org/community/lists/ for details.
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
112
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 Bug reports
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
115 -----------
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
116
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
117 To report or search for bugs, please use the Python Bug
56830
97d7cd365dd5 Merged revisions 73206,73232,73299,73683,74020,74185,74544,74643,74647,74817,74838-74839,74865,74946,75402,75459,75604,75696 via svnmerge from
Georg Brandl <georg@python.org>
parents: 56742
diff changeset
118 Tracker at http://bugs.python.org/.
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
119
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 Patches and contributions
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
122 -------------------------
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
123
15325
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added
Fred Drake <fdrake@acm.org>
parents: 15249
diff changeset
124 To submit a patch or other contribution, please use the Python Patch
56830
97d7cd365dd5 Merged revisions 73206,73232,73299,73683,74020,74185,74544,74643,74647,74817,74838-74839,74865,74946,75402,75459,75604,75696 via svnmerge from
Georg Brandl <georg@python.org>
parents: 56742
diff changeset
125 Manager at http://bugs.python.org/. Guidelines
44473
d077b0c893bc Update links to bug/patch tracker
Andrew M. Kuchling <amk@amk.ca>
parents: 44286
diff changeset
126 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
127
46260
2b0ecc7fd7ee Suggested proposed changes to Python be considered on some mailing lists first
Benjamin Peterson <benjamin@python.org>
parents: 46206
diff changeset
128 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
129 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
130 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
131 current PEPs, as well as guidelines for submitting a new PEP, are listed at
44473
d077b0c893bc Update links to bug/patch tracker
Andrew M. Kuchling <amk@amk.ca>
parents: 44286
diff changeset
132 http://www.python.org/dev/peps/.
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
133
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 Questions
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
136 ---------
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 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
139 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
140 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
141 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
142 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
143 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
144
13155
9919d65edc76 Tentative 2.0 and BeOpen upgrade.
Guido van Rossum <guido@python.org>
parents: 12374
diff changeset
145
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
146 Build instructions
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
147 ==================
1453
d773a5f89426 New files
Guido van Rossum <guido@python.org>
parents:
diff changeset
148
21900
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
149 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
150 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
151 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
152 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
153 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
154 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
155 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
156
21900
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
157 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
158 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
159 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
160 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
161 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
162
21900
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
163 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
164 If you have changed the configuration, the Makefile may have to be
61706
ef72f15864a9 Merged revisions 69924,69998-69999 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59951
diff changeset
165 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
166 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
167 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
168
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
169 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
170 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
171 section.
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
172
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
173 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
174 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
175 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
176 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
177 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
178 interpreter has been built.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
179
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 Troubleshooting
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
182 ---------------
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
183
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
184 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
185
34629
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
186 If you run into other trouble, see the FAQ
56830
97d7cd365dd5 Merged revisions 73206,73232,73299,73683,74020,74185,74544,74643,74647,74817,74838-74839,74865,74946,75402,75459,75604,75696 via svnmerge from
Georg Brandl <georg@python.org>
parents: 56742
diff changeset
187 (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
188 how to fix it.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
189
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
190 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
191 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
192 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
193 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
194
4134
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
195 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
196 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
197
b854ca4605e1 Ready for the release, I'd say.
Guido van Rossum <guido@python.org>
parents: 6132
diff changeset
198 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
199 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
200 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
201 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
202 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
203 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
204 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
205 the OPT variable.
4134
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
206
14249
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost
Guido van Rossum <guido@python.org>
parents: 14144
diff changeset
207 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
208 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
209 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
210 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
211 by turning off optimization. Consider switching to stable versions
34042
7a12904438d6 update gcc ref
Anthony Baxter <anthonybaxter@gmail.com>
parents: 33393
diff changeset
212 (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
213
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost
Guido van Rossum <guido@python.org>
parents: 14144
diff changeset
214 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
215 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
216 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
217 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
218
40342
a1c0b514cb53 Bug #1594809: add a note to README regarding PYTHONPATH and make install.
Georg Brandl <georg@python.org>
parents: 39857
diff changeset
219 If "make install" fails mysteriously during the "compiling the library"
a1c0b514cb53 Bug #1594809: add a note to README regarding PYTHONPATH and make install.
Georg Brandl <georg@python.org>
parents: 39857
diff changeset
220 step, make sure that you don't have any of the PYTHONPATH or PYTHONHOME
a1c0b514cb53 Bug #1594809: add a note to README regarding PYTHONPATH and make install.
Georg Brandl <georg@python.org>
parents: 39857
diff changeset
221 environment variables set, as they may interfere with the newly built
a1c0b514cb53 Bug #1594809: add a note to README regarding PYTHONPATH and make install.
Georg Brandl <georg@python.org>
parents: 39857
diff changeset
222 executable which is compiling the library.
a1c0b514cb53 Bug #1594809: add a note to README regarding PYTHONPATH and make install.
Georg Brandl <georg@python.org>
parents: 39857
diff changeset
223
26499
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
224 Unsupported systems
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
225 -------------------
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
226
62312
b9ecdcec0ff0 Grammar fix
Andrew M. Kuchling <amk@amk.ca>
parents: 62282
diff changeset
227 A number of systems are not supported in Python 2.7 anymore. Some
62283
61d4cc678165 Merged revisions 81933 via svnmerge from
Georg Brandl <georg@python.org>
parents: 61706
diff changeset
228 support code is still present, but will be removed in later versions.
26499
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
229 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
230 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
231 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
232 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
233 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
234
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
235 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
236 longer:
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
237 - SunOS 4
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
238 - DYNIX
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
239 - dgux
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
240 - Minix
39156
a4c4b7ea79c0 Update list of unsupported systems. Fixes #1510853.
Martin v. Löwis <martin@v.loewis.de>
parents: 39048
diff changeset
241 - NeXT
26499
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
242 - 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
243 - Linux 1
75668
f5bf91af01ca - rename configure.in to configure.ac
Matthias Klose <doko@ubuntu.com>
parents: 75207
diff changeset
244 - Systems defining __d6_pthread_create (configure.ac)
26499
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
245 - 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
246 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
247 - Systems using --with-dl-dld
26716
a3600c4ecc8b Unsupport --without-universal-newlines.
Martin v. Löwis <martin@v.loewis.de>
parents: 26499
diff changeset
248 - 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
249 - MacOS 9
a4c4b7ea79c0 Update list of unsupported systems. Fixes #1510853.
Martin v. Löwis <martin@v.loewis.de>
parents: 39048
diff changeset
250 - 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
251 - Win9x, WinME
a4c4b7ea79c0 Update list of unsupported systems. Fixes #1510853.
Martin v. Löwis <martin@v.loewis.de>
parents: 39048
diff changeset
252
26499
76f79bb36fc7 Add compile-time errors for unsupported systems.
Martin v. Löwis <martin@v.loewis.de>
parents: 26496
diff changeset
253
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
254 Platform specific notes
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
255 -----------------------
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
256
3174
f7789945b8de release 1.3 for real
Guido van Rossum <guido@python.org>
parents: 3110
diff changeset
257 (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
258 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
259 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
260 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
261
28924
b3b284436c24 add note about building with bsddb185 and making it appear as bsddb.
Skip Montanaro <skip@pobox.com>
parents: 28850
diff changeset
262 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
263 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
264 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
265 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
266
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
267 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
268
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
269 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
270 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
271
34629
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
272 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
273
41784
b7fb942b403e Remove the rgbimg module. It has been deprecated since Python 2.5.
Brett Cannon <bcannon@gmail.com>
parents: 41034
diff changeset
274 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
275 The setup.py script disables them on 64-bit installations.
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
276 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
277 contain code that is quite wordsize sensitive. (If you have a
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
278 fix, let us know!)
6448
b854ca4605e1 Ready for the release, I'd say.
Guido van Rossum <guido@python.org>
parents: 6132
diff changeset
279
5037
9ad7b8c36c79 Various notes added:
Guido van Rossum <guido@python.org>
parents: 4501
diff changeset
280 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
281 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
282 way is probably to specify the compiler with this option as
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
283 the "CC" environment variable when running the configure
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
284 script).
5037
9ad7b8c36c79 Various notes added:
Guido van Rossum <guido@python.org>
parents: 4501
diff changeset
285
25351
033adcbb4cb2 Warn about binutils 2.13 on Solaris.
Guido van Rossum <guido@python.org>
parents: 24547
diff changeset
286 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
287 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
288 -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
289 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
290 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
291 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
292 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
293 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
294 OS.
25351
033adcbb4cb2 Warn about binutils 2.13 on Solaris.
Guido van Rossum <guido@python.org>
parents: 24547
diff changeset
295
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
296 When the dynamic loader complains about errors finding shared
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
297 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
298
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
299 ld.so.1: ./python: fatal: libstdc++.so.5: open failed:
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
300 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
301
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
302 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
303 your system. Then, you need to instruct the dynamic loader how
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
304 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
305
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
306 1. When compiling Python, set LD_RUN_PATH to the directories
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
307 containing missing libraries.
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
308 2. When running Python, set LD_LIBRARY_PATH to these directories.
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
309 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
310 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
311 *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
312
35885
5b82120cb49d note build workaround for Sol10/gcc 3.4
Skip Montanaro <skip@pobox.com>
parents: 35615
diff changeset
313 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
314 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
315 HUGE_VAL(), e.g.:
5b82120cb49d note build workaround for Sol10/gcc 3.4
Skip Montanaro <skip@pobox.com>
parents: 35615
diff changeset
316
5b82120cb49d note build workaround for Sol10/gcc 3.4
Skip Montanaro <skip@pobox.com>
parents: 35615
diff changeset
317 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
318 ./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
319
14249
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost
Guido van Rossum <guido@python.org>
parents: 14144
diff changeset
320 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
321 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
322 solves the problem. This causes the popen2 test to fail;
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
323 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
324
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
325 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
326 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
327 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
328
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
329 There's an executable /usr/bin/python which is Python
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
330 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
331 require this version. Python 2.1.x may be installed as
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
332 /usr/bin/python2. The Makefile installs Python as
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
333 /usr/local/bin/python, which may or may not take precedence
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
334 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
335
11024
271af297aa3e Add warning FreeBSD users of a problem with curses and termcap,
Guido van Rossum <guido@python.org>
parents: 10862
diff changeset
336 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
337 similar: When using cursesmodule, the linking is not done in
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
338 the correct order with the defaults. Remove "-ltermcap" from
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
339 the readline entry in Setup, and use as curses entry: "curses
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
340 cursesmodule.c -lmytinfo -lncurses -ltermcap" - "mytinfo" (so
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
341 called on FreeBSD) should be the name of the auxiliary library
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
342 required on your platform. Normally, it would be linked
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
343 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
344
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
345 BSDI: BSDI versions before 4.1 have known problems with threads,
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
346 which can cause strange errors in a number of modules (for
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
347 instance, the 'test_signal' test script will hang forever.)
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
348 Turning off threads (with --with-threads=no) or upgrading to
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
349 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
350
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost
Guido van Rossum <guido@python.org>
parents: 14144
diff changeset
351 DEC Unix: Run configure with --with-dec-threads, or with
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
352 --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
353 default). When using GCC, it is possible to get an internal
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
354 compiler error if optimization is used. This was reported for
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
355 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
356 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
357
10565
104a441b2bc8 Add DEC Ultrix notes (from Donn Cave's email).
Guido van Rossum <guido@python.org>
parents: 10549
diff changeset
358 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
359 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
360
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
361 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
362 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
363 (The optimizer bug reported at this place in previous releases
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
364 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
365 errors about pthread_* functions, during compile or during
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
366 testing, try setting CC to a thread-safe (reentrant) compiler,
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
367 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
368 CC="xlC" without thread support).
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
369
35615
c6d7f1fe9d1e Update 64-bit AIX and HP-UX build instructions (forward port).
Guido van Rossum <guido@python.org>
parents: 35548
diff changeset
370 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
371 following:
c6d7f1fe9d1e Update 64-bit AIX and HP-UX build instructions (forward port).
Guido van Rossum <guido@python.org>
parents: 35548
diff changeset
372
c6d7f1fe9d1e Update 64-bit AIX and HP-UX build instructions (forward port).
Guido van Rossum <guido@python.org>
parents: 35548
diff changeset
373 export PATH=/usr/bin:/usr/vacpp/bin
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
374 ./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
375 --disable-ipv6 AR="ar -X64"
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
376 make
35615
c6d7f1fe9d1e Update 64-bit AIX and HP-UX build instructions (forward port).
Guido van Rossum <guido@python.org>
parents: 35548
diff changeset
377
30618
b7d01effe899 updated HPUX notes.
Anthony Baxter <anthonybaxter@gmail.com>
parents: 30521
diff changeset
378 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
379 OPT variable in the top-level Makefile; reported by Pat Knight,
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
380 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
381 even though pyconfig.h defines it. This seems unnecessary when
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
382 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
383 box".
30618
b7d01effe899 updated HPUX notes.
Anthony Baxter <anthonybaxter@gmail.com>
parents: 30521
diff changeset
384
34629
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
385 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
386 compiler, some experience has shown that the compiler's
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
387 optimiser produces a completely broken version of python
56830
97d7cd365dd5 Merged revisions 73206,73232,73299,73683,74020,74185,74544,74643,74647,74817,74838-74839,74865,74946,75402,75459,75604,75696 via svnmerge from
Georg Brandl <georg@python.org>
parents: 56742
diff changeset
388 (see http://bugs.python.org/814976). To work around this,
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
389 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
390
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
391 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
392 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
393
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
394 CC=cc
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
395 CXX=aCC
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
396 BASECFLAGS="+DD64"
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
397 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
398
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
399 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
400
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
401 ./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
402
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
403 then *unset* the environment variables again before running
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
404 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
405 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
406 remove -O from the OPT line.
8336
6b7095b98e54 Add pointer to Misc/HPUX-NOTES.
Guido van Rossum <guido@python.org>
parents: 8316
diff changeset
407
56830
97d7cd365dd5 Merged revisions 73206,73232,73299,73683,74020,74185,74544,74643,74647,74817,74838-74839,74865,74946,75402,75459,75604,75696 via svnmerge from
Georg Brandl <georg@python.org>
parents: 56742
diff changeset
408 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
409 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
410 in the optimizer that break Python. Compiling without
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
411 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
412
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
413 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
414 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
415
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
416 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
417 defs. This is because all the SCO header files are broken.
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
418 Anything that isn't mentioned in the C standard is
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
419 conditionally excluded when __STDC__ is defined.
1453
d773a5f89426 New files
Guido van Rossum <guido@python.org>
parents:
diff changeset
420
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
421 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
422 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
423 needed be set to:
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
424
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
425 LIBS=' -lsocket -lcrypt_i'
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
426
19758
64bcef1702ad Revert parts of patch #453627, documenting the resulting test failures
Martin v. Löwis <martin@v.loewis.de>
parents: 19381
diff changeset
427 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
428 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
429 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
430 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
431
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
432 QNX: Chris Herborth (chrish@qnx.com) writes:
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
433 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
434 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
435 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
436
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
437 1) CONFIG_SHELL=/usr/local/bin/bash CC=cc RANLIB=: \
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
438 ./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
439
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
440 2) edit Modules/Setup to activate everything that makes sense for
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
441 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
442
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
443 array, audioop, binascii, cPickle, cStringIO, cmath,
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
444 crypt, curses, errno, fcntl, gdbm, grp, imageop,
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
445 _locale, math, md5, new, operator, parser, pcre,
41790
c028b2775a9a rotor is long gone.
Neal Norwitz <nnorwitz@gmail.com>
parents: 41784
diff changeset
446 posix, pwd, readline, regex, reop,
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
447 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
448 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
449
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
450 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
451
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
452 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
453
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
454 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
455
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
456 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
457
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
458 Using GNU readline 2.2 seems to behave strangely, but I
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
459 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
460
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
461 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
462
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
463 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
464 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
465 probably running out of stack; the default 32k could be a
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
466 little tight. To increase the stack size, edit the Makefile
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
467 to read: LDFLAGS = -N 48k
6018
f05546743406 Added QNX remarks.
Guido van Rossum <guido@python.org>
parents: 5951
diff changeset
468
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
469 BeOS: See Misc/BeOS-NOTES for notes about compiling/installing
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
470 Python on BeOS R3 or later. Note that only the PowerPC
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
471 platform is supported for R3; both PowerPC and x86 are
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
472 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
473
24445
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
474 Cray T3E: Mark Hadfield (m.hadfield@niwa.co.nz) writes:
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
475 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
476 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
477 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
478 thread on comp.lang.python in May 2002 entitled "Building
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
479 Python on Cray T3E".
24445
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
480
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
481 1) Use Cray's cc and not gcc. The latter was reported not to
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
482 work by Konrad Hinsen. It may work now, but it may not.
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
483
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
484 2) To set sys.platform to something sensible, pass the
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
485 following environment variable to the configure script:
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
486
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
487 MACHDEP=unicosmk
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
488
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
489 2) Run configure with option "--enable-unicode=ucs4".
24445
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
490
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
491 3) The Cray T3E does not support dynamic linking, so extension
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
492 modules have to be built by adding (or uncommenting) lines
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
493 in Modules/Setup. The minimum set of modules is
24445
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
494
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
495 posix, new, _sre, unicodedata
24445
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
496
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
497 On NIWA's vanilla T3E system the following have also been
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
498 included successfully:
24445
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
499
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
500 _codecs, _locale, _socket, _symtable, _testcapi, _weakref
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
501 array, binascii, cmath, cPickle, crypt, cStringIO, dbm
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
502 errno, fcntl, grp, math, md5, operator, parser, pcre, pwd
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
503 regex, rotor, select, struct, strop, syslog, termios
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
504 time, timing, xreadlines
24445
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
505
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
506 4) Once the python executable and library have been built, make
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
507 will execute setup.py, which will attempt to build remaining
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
508 extensions and link them dynamically. Each of these attempts
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
509 will fail but should not halt the make process. This is
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
510 normal.
24445
Michael W. Hudson <mwh@python.net>
parents: 24164
diff changeset
511
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
512 5) Running "make test" uses a lot of resources and causes
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
513 problems on our system. You might want to try running tests
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
514 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
515
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
516 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
517 does not check whether a command actually changed the file it
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
518 is supposed to build. This means that whenever you say "make"
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
519 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
520 smarter "smake" utility (/usr/sbin/smake), or GNU make. If
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
521 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
522 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
523
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
524 WARNING: There are bugs in the optimizer of some versions of
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
525 SGI's compilers that can cause bus errors or other strange
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
526 behavior, especially on numerical operations. To avoid this,
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
527 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
528
6675
cdb3279b06e7 Revamped README for release of 1.5b1.
Guido van Rossum <guido@python.org>
parents: 6494
diff changeset
529 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
530 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
531 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
532 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
533
15043
c0c254fbde57 Added section on threads problems on Reliant UNIX; this relates to
Fred Drake <fdrake@acm.org>
parents: 14927
diff changeset
534 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
535 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
536 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
537 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
538
25781
cc41b9cacae8 There was a typo in the MacOSX section regarding the stacksize issue.
Barry Warsaw <barry@python.org>
parents: 25351
diff changeset
539 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
540 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
541 you set the stack size to 2048 before doing a "make test" the
41035
e66cfc725e8d Patch #1673121: update README wrt. OSX default shell.
Georg Brandl <georg@python.org>
parents: 40562
diff changeset
542 failure can be avoided. If you're using the tcsh or csh shells,
e66cfc725e8d Patch #1673121: update README wrt. OSX default shell.
Georg Brandl <georg@python.org>
parents: 40562
diff changeset
543 use "limit stacksize 2048" and for the bash shell (the default
e66cfc725e8d Patch #1673121: update README wrt. OSX default shell.
Georg Brandl <georg@python.org>
parents: 40562
diff changeset
544 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
545
21273
ecbbeccde07d Cleaned up Mac OS X section to the current state of affairs.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20959
diff changeset
546 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
547 "--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
548 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
549 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
550
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk.
Barry Warsaw <barry@python.org>
parents: 21367
diff changeset
551 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
552 "sudo mkdir -m 775 /usr/local"
24547
4f00134b561d Changes to the OSX section:
Jack Jansen <jack.jansen@cwi.nl>
parents: 24525
diff changeset
553 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
554 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
555 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
556 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
557
24547
4f00134b561d Changes to the OSX section:
Jack Jansen <jack.jansen@cwi.nl>
parents: 24525
diff changeset
558 Some people have reported problems building Python after using "fink"
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
559 to install additional unix software. Disabling fink (remove all
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
560 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
561
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk.
Barry Warsaw <barry@python.org>
parents: 21367
diff changeset
562 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
563 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
564 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
565 /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
566 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
567 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
568
44242
66dbe12ddf31 Remove all tabs in that file.
Georg Brandl <georg@python.org>
parents: 44241
diff changeset
569 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
570 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
571 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
572
44241
5ac874d09556 #1575: the Mac readme is now one level up.
Georg Brandl <georg@python.org>
parents: 41934
diff changeset
573 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
574 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
575
21491
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
576 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
577 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
578 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
579 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
580
21491
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
581 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
582 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
583 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
584 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
585
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
586 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
587
21491
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
588 (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
589 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
590
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
591 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
592 other options you need (--prefix, etc.). Then in Modules/Setup
27619
558d0f3b6254 Fix typos.
Walter Dörwald <walter@livinglogic.de>
parents: 27253
diff changeset
593 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
594
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
595 #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
596 #_socket socketmodule.c \
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
597 # -DUSE_SSL -I$(SSL)/include -I$(SSL)/include/openssl \
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
598 # -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
599
21491
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
600 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
601 "make"!
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
602
21495
2474414d4342 Apparently it's Cygwin with a capital C.
Michael W. Hudson <mwh@python.net>
parents: 21493
diff changeset
603 (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
604 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
605 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
606
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
607 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
608
21491
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
609 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
610 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
611
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
612 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
613
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
614 (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
615 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
616 hang.
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
617
21493
162106b16e44 Fix a typo
Neal Norwitz <nnorwitz@gmail.com>
parents: 21491
diff changeset
618 (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
619 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
620 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
621
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
622 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
623 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
624
21491
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
625 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
626 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
627 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
628
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler.
Tim Peters <tim.peters@gmail.com>
parents: 17210
diff changeset
629 test_pwd
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler.
Tim Peters <tim.peters@gmail.com>
parents: 17210
diff changeset
630 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
631 test_socket
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler.
Tim Peters <tim.peters@gmail.com>
parents: 17210
diff changeset
632
21491
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
633 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
634 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
635
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
636 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
637
21491
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well.
Michael W. Hudson <mwh@python.net>
parents: 21414
diff changeset
638 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
639 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
640
52900
4acbbb3e65e2 Merged revisions 70866-70868,70870-70871,70893,70896,70902,70905,70907,70912,70915,70927,70933,70940,70944,70954,70963,70998,71056 via svnmerge from
Georg Brandl <georg@python.org>
parents: 50522
diff changeset
641 Windows: When executing Python scripts on the command line using file type
4acbbb3e65e2 Merged revisions 70866-70868,70870-70871,70893,70896,70902,70905,70907,70912,70915,70927,70933,70940,70944,70954,70963,70998,71056 via svnmerge from
Georg Brandl <georg@python.org>
parents: 50522
diff changeset
642 associations (i.e. starting "script.py" instead of "python script.py"),
4acbbb3e65e2 Merged revisions 70866-70868,70870-70871,70893,70896,70902,70905,70907,70912,70915,70927,70933,70940,70944,70954,70963,70998,71056 via svnmerge from
Georg Brandl <georg@python.org>
parents: 50522
diff changeset
643 redirects may not work unless you set a specific registry key. See
4acbbb3e65e2 Merged revisions 70866-70868,70870-70871,70893,70896,70902,70905,70907,70912,70915,70927,70933,70940,70944,70954,70963,70998,71056 via svnmerge from
Georg Brandl <georg@python.org>
parents: 50522
diff changeset
644 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
645
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the
Skip Montanaro <skip@pobox.com>
parents: 27053
diff changeset
646
23867
45d676933882 This introduces stricter library/header file checking for the Berkeley DB
Skip Montanaro <skip@pobox.com>
parents: 23415
diff changeset
647 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
648 -------------------------------------
45d676933882 This introduces stricter library/header file checking for the Berkeley DB
Skip Montanaro <skip@pobox.com>
parents: 23415
diff changeset
649
27077
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the
Skip Montanaro <skip@pobox.com>
parents: 27053
diff changeset
650 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
651 <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
652 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
653 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
654 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
655 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
656 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
657 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
658 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
659 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
660
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
661 Building the sqlite3 module
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
662 ---------------------------
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 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
665 packages installed, including the header files. Many modern operating
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
666 systems distribute the headers in a separate package to the library -
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
667 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
668 -devel suffix.
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
669
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
670 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
671 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
672
8316
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
673 Configuring threads
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
674 -------------------
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
675
14249
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost
Guido van Rossum <guido@python.org>
parents: 14144
diff changeset
676 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
677 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
678 --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
679 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
680 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
681 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
682 more, but the information below is not enough to write a patch for the
75668
f5bf91af01ca - rename configure.in to configure.ac
Matthias Klose <doko@ubuntu.com>
parents: 75207
diff changeset
683 configure.ac file, so manual intervention is required. If you patch
f5bf91af01ca - rename configure.in to configure.ac
Matthias Klose <doko@ubuntu.com>
parents: 75207
diff changeset
684 the configure.ac 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
685 send in the patch. (Don't bother patching the configure script itself
75668
f5bf91af01ca - rename configure.in to configure.ac
Matthias Klose <doko@ubuntu.com>
parents: 75207
diff changeset
686 -- it is regenerated each time the configure.ac file changes.)
8316
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
687
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
688 Compiler switches for threads
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
689 .............................
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
690
16994
459c8ef0a010 Document that _REENTRANT is not needed explicitly.
Martin v. Löwis <martin@v.loewis.de>
parents: 16776
diff changeset
691 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
692 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
693 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
694
8316
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
695 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
696 (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
697
16994
459c8ef0a010 Document that _REENTRANT is not needed explicitly.
Martin v. Löwis <martin@v.loewis.de>
parents: 16776
diff changeset
698 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
699 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
700 DEC OSF/1 3.x/cc/DCE -threads
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
701 (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
702 Digital UNIX 4.x/cc/DCE -threads
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
703 (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
704 Digital UNIX 4.x/cc/POSIX -pthread
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
705 (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
706 AIX 4.1.4/cc_r/d7 (nothing)
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
707 (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
708 AIX 4.1.4/cc_r4/DCE (nothing)
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
709 (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
710 IRIX 6.2/cc/POSIX (nothing)
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
711 (robertl@cwi.nl)
8316
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
712
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 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
715 ...........................................
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 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
718
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
719 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
720 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
721 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
722 (butenhof@zko.dec.com)
8316
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
723 Digital UNIX 4.x/DCE -lpthreads -lpthread -lmach -lexc -lc
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
724 (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
725 Digital UNIX 4.x/POSIX -lpthread -lmach -lexc -lc
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
726 (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
727 AIX 4.1.4/{draft7,DCE} (nothing)
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
728 (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
729 IRIX 6.2/POSIX -lpthread
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
730 (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
731
63cce9d77797 Add Bill Janssen's notes on configuring threads.
Guido van Rossum <guido@python.org>
parents: 8041
diff changeset
732
22662
1aea7af09260 Patch #527027: Allow building python as shared library.
Martin v. Löwis <martin@v.loewis.de>
parents: 22436
diff changeset
733 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
734 ---------------------------
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 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
737 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
738 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
739 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
740
29954
baf2241070bf Clarify a statement regarding both shared and static library.
Fred Drake <fdrake@acm.org>
parents: 29932
diff changeset
741 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
742 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
743 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
744 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
745
1aea7af09260 Patch #527027: Allow building python as shared library.
Martin v. Löwis <martin@v.loewis.de>
parents: 22436
diff changeset
746
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
747 Configuring additional built-in modules
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
748 ---------------------------------------
2162
c9aea34ae4b6 add hint for NeXT users
Guido van Rossum <guido@python.org>
parents: 2131
diff changeset
749
16776
2915eb07bd25 Update build notes to mention setup.py
Andrew M. Kuchling <amk@amk.ca>
parents: 16775
diff changeset
750 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
751 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
752 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
753 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
754 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
755 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
756 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
757 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
758
16776
2915eb07bd25 Update build notes to mention setup.py
Andrew M. Kuchling <amk@amk.ca>
parents: 16775
diff changeset
759 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
760 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
761 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
762 -- 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
763 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
764 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
765 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
766 directory).
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
767
16776
2915eb07bd25 Update build notes to mention setup.py
Andrew M. Kuchling <amk@amk.ca>
parents: 16775
diff changeset
768 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
769 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
770 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
771 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
772 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
773 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
774
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 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
776 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
777 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
778
5037
9ad7b8c36c79 Various notes added:
Guido van Rossum <guido@python.org>
parents: 4501
diff changeset
779 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
780 (the makesetup script processes both). You may find it more
9ad7b8c36c79 Various notes added:
Guido van Rossum <guido@python.org>
parents: 4501
diff changeset
781 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
782 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
783 file.
9ad7b8c36c79 Various notes added:
Guido van Rossum <guido@python.org>
parents: 4501
diff changeset
784
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
785
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
786 Setting the optimization/debugging options
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
787 ------------------------------------------
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
788
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
789 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
790 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
791 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
792 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
793 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
794 (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
795 set of libraries to link with).
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
796
15325
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added
Fred Drake <fdrake@acm.org>
parents: 15249
diff changeset
797 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
798 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
799
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added
Fred Drake <fdrake@acm.org>
parents: 15249
diff changeset
800 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
801 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
802
34929
08e20e9c76fb Introduced EXTRA_CFLAGS as an environment variable used by the Makefile. Meant
Brett Cannon <bcannon@gmail.com>
parents: 34629
diff changeset
803 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
804 variable.
08e20e9c76fb Introduced EXTRA_CFLAGS as an environment variable used by the Makefile. Meant
Brett Cannon <bcannon@gmail.com>
parents: 34629
diff changeset
805
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
806
20252
b85cd163cd5c Add note about profiling.
Guido van Rossum <guido@python.org>
parents: 19758
diff changeset
807 Profiling
b85cd163cd5c Add note about profiling.
Guido van Rossum <guido@python.org>
parents: 19758
diff changeset
808 ---------
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 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
811 with the CC environment variable to the necessary compiler
b85cd163cd5c Add note about profiling.
Guido van Rossum <guido@python.org>
parents: 19758
diff changeset
812 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
813 gprof(1):
b85cd163cd5c Add note about profiling.
Guido van Rossum <guido@python.org>
parents: 19758
diff changeset
814
b85cd163cd5c Add note about profiling.
Guido van Rossum <guido@python.org>
parents: 19758
diff changeset
815 CC="gcc -pg" ./configure
b85cd163cd5c Add note about profiling.
Guido van Rossum <guido@python.org>
parents: 19758
diff changeset
816
b85cd163cd5c Add note about profiling.
Guido van Rossum <guido@python.org>
parents: 19758
diff changeset
817 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
818 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
819 link most extension modules statically.
20252
b85cd163cd5c Add note about profiling.
Guido van Rossum <guido@python.org>
parents: 19758
diff changeset
820
b85cd163cd5c Add note about profiling.
Guido van Rossum <guido@python.org>
parents: 19758
diff changeset
821
47156
2e9f572b7322 GHOP #217: add support for compiling Python with coverage checking enabled.
Georg Brandl <georg@python.org>
parents: 46735
diff changeset
822 Coverage checking
2e9f572b7322 GHOP #217: add support for compiling Python with coverage checking enabled.
Georg Brandl <georg@python.org>
parents: 46735
diff changeset
823 -----------------
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 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
826 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
827 ".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
828 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
829 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
830 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
831
2e9f572b7322 GHOP #217: add support for compiling Python with coverage checking enabled.
Georg Brandl <georg@python.org>
parents: 46735
diff changeset
832 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
833
2e9f572b7322 GHOP #217: add support for compiling Python with coverage checking enabled.
Georg Brandl <georg@python.org>
parents: 46735
diff changeset
834 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
835 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
836
2e9f572b7322 GHOP #217: add support for compiling Python with coverage checking enabled.
Georg Brandl <georg@python.org>
parents: 46735
diff changeset
837 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
838 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
839 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
840
2e9f572b7322 GHOP #217: add support for compiling Python with coverage checking enabled.
Georg Brandl <georg@python.org>
parents: 46735
diff changeset
841
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
842 Testing
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
843 -------
1453
d773a5f89426 New files
Guido van Rossum <guido@python.org>
parents:
diff changeset
844
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
845 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
846 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
847 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
848 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
849 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
850 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
851 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
852 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
853 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
854 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
855
61706
ef72f15864a9 Merged revisions 69924,69998-69999 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59951
diff changeset
856 By default, tests are prevented from overusing resources like disk space and
ef72f15864a9 Merged revisions 69924,69998-69999 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59951
diff changeset
857 memory. To enable these tests, run "make testall".
ef72f15864a9 Merged revisions 69924,69998-69999 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59951
diff changeset
858
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
859 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
860 *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
861 failing test manually, as follows:
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
862
61706
ef72f15864a9 Merged revisions 69924,69998-69999 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59951
diff changeset
863 ./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
864
22436
888fcd9b858d [Bug #532136] Change path in README, as suggested by Ralph Corderoy
Andrew M. Kuchling <amk@amk.ca>
parents: 22215
diff changeset
865 (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
866 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
867
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 Installing
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
870 ----------
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
871
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
872 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
873 (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
874 just type
cdb3279b06e7 Revamped README for release of 1.5b1.
Guido van Rossum <guido@python.org>
parents: 6494
diff changeset
875
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
876 make install
6675
cdb3279b06e7 Revamped README for release of 1.5b1.
Guido van Rossum <guido@python.org>
parents: 6494
diff changeset
877
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
878 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
879 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
880 `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
881 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
882 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
883 (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
884
29074
988b3e807043 Patch #718286: Support DESTDIR.
Martin v. Löwis <martin@v.loewis.de>
parents: 28924
diff changeset
885 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
886 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
887 $(DESTDIR)$(exec_prefix), etc.
988b3e807043 Patch #718286: Support DESTDIR.
Martin v. Löwis <martin@v.loewis.de>
parents: 28924
diff changeset
888
6675
cdb3279b06e7 Revamped README for release of 1.5b1.
Guido van Rossum <guido@python.org>
parents: 6494
diff changeset
889 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
890 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
891 "/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
892 <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
893 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
894 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
895 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
896 by default.
1453
d773a5f89426 New files
Guido van Rossum <guido@python.org>
parents:
diff changeset
897
45673
2216b100b2d2 Elaborate on the role of the altinstall target when installing multiple
Skip Montanaro <skip@pobox.com>
parents: 45590
diff changeset
898 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
899 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
900
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 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
902 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
903 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
904 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
905
19381
60d5cbbeadc3 Removed NeXT notes (replacing them with a line saying NeXT is no
Jack Jansen <jack.jansen@cwi.nl>
parents: 17734
diff changeset
906 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
907 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
908 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
909 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
910
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
911
45673
2216b100b2d2 Elaborate on the role of the altinstall target when installing multiple
Skip Montanaro <skip@pobox.com>
parents: 45590
diff changeset
912 Installing multiple versions
2216b100b2d2 Elaborate on the role of the altinstall target when installing multiple
Skip Montanaro <skip@pobox.com>
parents: 45590
diff changeset
913 ----------------------------
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 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
916 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
917 script) you must take care that your primary python executable is not
59951
e9b958e8391b Merged revisions 73824,78887,78895,78900,79024 via svnmerge from
Ezio Melotti <ezio.melotti@gmail.com>
parents: 59697
diff changeset
918 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
919 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
920 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
921 ${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
922 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
923 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
924 "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
925
2216b100b2d2 Elaborate on the role of the altinstall target when installing multiple
Skip Montanaro <skip@pobox.com>
parents: 45590
diff changeset
926 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
927 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
928 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
929
2216b100b2d2 Elaborate on the role of the altinstall target when installing multiple
Skip Montanaro <skip@pobox.com>
parents: 45590
diff changeset
930
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
931 Configuration options and variables
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
932 -----------------------------------
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
933
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
934 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
935 script.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
936
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
937 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
938 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
939 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
940 Modules/getpath.o.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
941
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
942 --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
943 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
944 installed but broken on your platform, pass the option
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
945 --without-gcc. You can also pass "CC=cc" (or whatever the
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
946 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
947 advantage of using --without-gcc is that this option is
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
948 remembered by the config.status script for its --recheck
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
949 option.
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
950
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
951 --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
952 Python library somewhere else than in /usr/local/{bin,lib},
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
953 you can pass the option --prefix=DIRECTORY; the interpreter
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
954 binary will be installed as DIRECTORY/bin/python and the
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
955 library files as DIRECTORY/lib/python/*. If you pass
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
956 --exec-prefix=DIRECTORY (as well) this overrides the
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
957 installation prefix for architecture-dependent files (like the
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
958 interpreter binary). Note that --prefix=DIRECTORY also
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
959 affects the default module search path (sys.path), when
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
960 Modules/config.c is compiled. Passing make the option
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
961 prefix=DIRECTORY (and/or exec_prefix=DIRECTORY) overrides the
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
962 prefix set at configuration time; this may be more convenient
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
963 than re-running the configure script if you change your mind
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
964 about the install prefix.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
965
21900
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
966 --with-readline: This option is no longer supported. GNU
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
967 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
968
14249
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost
Guido van Rossum <guido@python.org>
parents: 14144
diff changeset
969 --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
970 threads, and support for this is enabled by default. To
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
971 disable this, pass --with-threads=no. If the library required
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
972 for threads lives in a peculiar place, you can use
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
973 --with-thread=DIRECTORY. IMPORTANT: run "make clean" after
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
974 changing (either enabling or disabling) this option, or you
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
975 will get link errors! Note: for DEC Unix use
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
976 --with-dec-threads instead.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
977
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
978 --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
979 supported by the "dl" library by Jack Jansen, which is
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
980 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
981 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
982 library) by passing --with-sgi-dl=DIRECTORY where DIRECTORY
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
983 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
984 IRIX 5, it already has dynamic linking using SunOS style
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
985 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
986
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
987 --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
988 on some other systems: VAX (Ultrix), Sun3 (SunOS 3.4), Sequent
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
989 Symmetry (Dynix), and Atari ST. This is done using a
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
990 combination of the GNU dynamic loading package
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
991 (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
992 emulation of the SGI dl library mentioned above (the emulation
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
993 can be found at
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
994 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
995 enable this, ftp and compile both libraries, then call
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
996 configure, passing it the option
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
997 --with-dl-dld=DL_DIRECTORY,DLD_DIRECTORY where DL_DIRECTORY is
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
998 the absolute pathname of the dl emulation library and
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
999 DLD_DIRECTORY is the absolute pathname of the GNU dld library.
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1000 (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
1001 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
1002
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1003 --with-libm, --with-libc: It is possible to specify alternative
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1004 versions for the Math library (default -lm) and the C library
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1005 (default the empty string) using the options
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1006 --with-libm=STRING and --with-libc=STRING, respectively. For
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1007 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
1008 compiler to use the shared C library, you can pass
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1009 --with-libc=-lc_s. These libraries are passed after all other
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1010 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
1011
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
1012 --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
1013 is linked against.
3893
958d4c67526b Added doc para for --with-libs
Guido van Rossum <guido@python.org>
parents: 3887
diff changeset
1014
37709
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1015 --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
1016 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
1017 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
1018 <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
1019 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
1020 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
1021
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1022 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
1023 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
1024 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
1025 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
1026 --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
1027 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
1028 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
1029 runtime.
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1030
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1031 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
1032 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
1033 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
1034 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
1035 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
1036 --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
1037 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
1038 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
1039 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
1040 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
1041
37a8eb74c504 Patch #1324762: Change --with-cxx to --with-cxx-main.
Martin v. Löwis <martin@v.loewis.de>
parents: 37691
diff changeset
1042 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
1043 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
1044
bb93b1dca571 Document --with-cxx.
Martin v. Löwis <martin@v.loewis.de>
parents: 15344
diff changeset
1045
15325
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added
Fred Drake <fdrake@acm.org>
parents: 15249
diff changeset
1046 --with-pydebug: Enable additional debugging code to help track down
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1047 memory management problems. This allows printing a list of all
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1048 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
1049
23029
8291473fde3e Mass checkin of universal newline support.
Jack Jansen <jack.jansen@cwi.nl>
parents: 22662
diff changeset
1050 --with(out)-universal-newlines: enable reading of text files with
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1051 foreign newline convention (default: enabled). In other words,
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1052 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
1053 If enabled import and execfile will automatically accept any newline
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1054 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
1055 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
1056
32301
41c59d80bbc5 Patch #510695: Add TSC profiling for the VM.
Martin v. Löwis <martin@v.loewis.de>
parents: 32027
diff changeset
1057 --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
1058
37605
e070c316eb45 Patch #1464444: Add --with-system-ffi.
Martin v. Löwis <martin@v.loewis.de>
parents: 37431
diff changeset
1059 --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
1060 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
1061
53602
2ef2cb5773fe - Issue #4587: Add configure option --with-dbmliborder=db1:db2:... to specify
Matthias Klose <doko@ubuntu.com>
parents: 52598
diff changeset
1062 --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
1063 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
1064 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
1065
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1066 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
1067 -------------------------------------------------------------
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 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
1070 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
1071 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
1072 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
1073 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
1074 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
1075 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
1076 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
1077 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
1078 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
1079
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1080 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
1081 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
1082 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
1083
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1084 $ mkdir /usr/tmp/python
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1085 $ cd /usr/tmp/python
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1086 $ ~guido/src/python/configure
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1087 [...]
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1088 $ make
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1089 [...]
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1090 $
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1091
16288
c0a2441a4454 - Edit the QNX instructions to refer to Makefile, not Modules/Makefile.
Neil Schemenauer <nascheme@enme.ucalgary.ca>
parents: 16229
diff changeset
1092 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
1093 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
1094 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
1095 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
1096 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
1097 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
1098 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
1099 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
1100 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
1101 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
1102
44285
226a062ab43e Fixed bug #1613: Makefile's VPATH feature is broken
Christian Heimes <christian@cheimes.de>
parents: 44242
diff changeset
1103 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
1104 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
1105
1453
d773a5f89426 New files
Guido van Rossum <guido@python.org>
parents:
diff changeset
1106
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1107 Building on non-UNIX systems
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1108 ----------------------------
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1109
34255
e81152152433 Update VC references. Backported to 2.4.
Martin v. Löwis <martin@v.loewis.de>
parents: 34042
diff changeset
1110 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
1111 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
1112 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
1113
34255
e81152152433 Update VC references. Backported to 2.4.
Martin v. Löwis <martin@v.loewis.de>
parents: 34042
diff changeset
1114 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
1115 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
1116
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
1117 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
1118 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
1119 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
1120 (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
1121 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
1122
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 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
1124 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
1125
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 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
1127 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
1128 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
1129 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
1130 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
1131 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
1132 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
1133 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
1134
21414
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk.
Barry Warsaw <barry@python.org>
parents: 21367
diff changeset
1135 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
1136 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
1137 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
1138 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
1139 do this.
1453
d773a5f89426 New files
Guido van Rossum <guido@python.org>
parents:
diff changeset
1140
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1141
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1142 Miscellaneous issues
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1143 ====================
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 Emacs mode
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1146 ----------
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1147
6448
b854ca4605e1 Ready for the release, I'd say.
Guido van Rossum <guido@python.org>
parents: 6132
diff changeset
1148 There's an excellent Emacs editing mode for Python code; see the file
62409
93896a0946c2 update emacs section
Benjamin Peterson <benjamin@python.org>
parents: 62312
diff changeset
1149 Misc/python-mode.el. Originally written by the famous Tim Peters, it is now
93896a0946c2 update emacs section
Benjamin Peterson <benjamin@python.org>
parents: 62312
diff changeset
1150 maintained by the equally famous Barry Warsaw. The latest version, along with
93896a0946c2 update emacs section
Benjamin Peterson <benjamin@python.org>
parents: 62312
diff changeset
1151 various other contributed Python-related Emacs goodies, is online at
93896a0946c2 update emacs section
Benjamin Peterson <benjamin@python.org>
parents: 62312
diff changeset
1152 http://launchpad.net/python-mode/.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1153
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1154
21900
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
1155 Tkinter
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
1156 -------
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
1157
21900
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug
Guido van Rossum <guido@python.org>
parents: 21865
diff changeset
1158 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
1159 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
1160 higher.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1161
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
1162 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
1163 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
1164
34629
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
1165 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
1166
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1167 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
1168 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
1169 (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
1170 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
1171 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
1172 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
1173 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
1174 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
1175 set correctly -- normal installation takes care of this.
3008
a51022f1980f 1.3b1 notes
Guido van Rossum <guido@python.org>
parents: 2730
diff changeset
1176
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1177
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1178 Distribution structure
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1179 ----------------------
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1180
14425
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes
Guido van Rossum <guido@python.org>
parents: 14385
diff changeset
1181 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
1182 comments.
1453
d773a5f89426 New files
Guido van Rossum <guido@python.org>
parents:
diff changeset
1183
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
1184 Demo/ Demonstration scripts, modules and programs
45259
8689b67265bf Docs are rst now.
Georg Brandl <georg@python.org>
parents: 44472
diff changeset
1185 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
1186 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
1187 Include/ Public header files
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1188 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
1189 Lib/ Python library modules
23962
111c1e59ad72 Random tweaks & updates.
Michael W. Hudson <mwh@python.net>
parents: 23867
diff changeset
1190 Mac/ Macintosh specific resources
16229
e302586452a3 Update the build instructions for flat makefile.
Neil Schemenauer <nascheme@enme.ucalgary.ca>
parents: 15986
diff changeset
1191 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
1192 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
1193 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
1194 Objects/ Implementation of most built-in object types
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
1195 PC/ Files specific to PC ports (DOS, Windows, OS/2)
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1196 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
1197 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
1198 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
1199 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
1200 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
1201 Tools/ Some useful programs written in Python
23962
111c1e59ad72 Random tweaks & updates.
Michael W. Hudson <mwh@python.net>
parents: 23867
diff changeset
1202 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
1203 configure Configuration shell script (GNU autoconf output)
75668
f5bf91af01ca - rename configure.in to configure.ac
Matthias Klose <doko@ubuntu.com>
parents: 75207
diff changeset
1204 configure.ac 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
1205 install-sh Shell script used to install files
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1206 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
1207
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1208 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
1209 the configuration and build processes:
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1210
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
1211 Makefile Build rules
16229
e302586452a3 Update the build instructions for flat makefile.
Neil Schemenauer <nascheme@enme.ucalgary.ca>
parents: 15986
diff changeset
1212 Makefile.pre Build rules before running Modules/makesetup
23962
111c1e59ad72 Random tweaks & updates.
Michael W. Hudson <mwh@python.net>
parents: 23867
diff changeset
1213 buildno Keeps track of the build number
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
1214 config.cache Cache of configuration variables
23962
111c1e59ad72 Random tweaks & updates.
Michael W. Hudson <mwh@python.net>
parents: 23867
diff changeset
1215 pyconfig.h Configuration header
6448
b854ca4605e1 Ready for the release, I'd say.
Guido van Rossum <guido@python.org>
parents: 6132
diff changeset
1216 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
1217 config.status Status from last run of the configure script
37430
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1218 getbuildinfo.o Object file from Modules/getbuildinfo.c
fbc62db97e43 added sqlite3 section
Anthony Baxter <anthonybaxter@gmail.com>
parents: 37113
diff changeset
1219 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
1220 python The executable interpreter
41791
31029f6ebca2 Update directories/files at the top-level.
Neal Norwitz <nnorwitz@gmail.com>
parents: 41790
diff changeset
1221 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
1222 tags, TAGS Tags files for vi and Emacs
1453
d773a5f89426 New files
Guido van Rossum <guido@python.org>
parents:
diff changeset
1223
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1224
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
1225 That's all, folks!
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
1226 ------------------
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
1227
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
1228
15986
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs.
Guido van Rossum <guido@python.org>
parents: 15546
diff changeset
1229 --Guido van Rossum (home page: http://www.python.org/~guido/)