Mercurial > cpython-lru_cache-weakref

annotate README @ 39042:c02fa187e0f4 legacy-trunk

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