Mercurial > cpython-lru_cache-weakref

annotate README @ 58925:eecf1bef052d 2.6

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