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