cpython-lru_cache-weakref: README annotate

annotate README @ 25838:8540887bcec6 2.2

Backport of 2.183: Fix memory leak in add_subclass() found by NealN with valgrind.

author	Guido van Rossum <guido@python.org>
date	Fri, 18 Oct 2002 13:42:21 +0000
parents	f0a74ae09ad7
children	1244f4c3834f

rev	line source
25761 69aa60d771d1 Bump release version to 2.2.2 -- the final release is imminent. Guido van Rossum <guido@python.org> parents: 25658 diff changeset	1 This is Python version 2.2.2
69aa60d771d1 Bump release version to 2.2.2 -- the final release is imminent. Guido van Rossum <guido@python.org> parents: 25658 diff changeset	2 ============================
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	3
22063 a50baa126c75 backport my checkin of Michael W. Hudson <mwh@python.net> parents: 21999 diff changeset	4 Copyright (c) 2001, 2002 Python Software Foundation.
15986 bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	5 All rights reserved.
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	6
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	7 Copyright (c) 2000 BeOpen.com.
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	8 All rights reserved.
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	9
17458 0d0546bd8448 Because this code was derived from Python 1.6.1 (amongst others), the Guido van Rossum <guido@python.org> parents: 17311 diff changeset	10 Copyright (c) 1995-2001 Corporation for National Research Initiatives.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	11 All rights reserved.
12374 f57af360b7e5 Add weasel-words about versioning, so I don't have to check in a new Guido van Rossum <guido@python.org> parents: 12205 diff changeset	12
14385 39ab28572307 Remove a comma from CWI's copyright notice. Guido van Rossum <guido@python.org> parents: 14367 diff changeset	13 Copyright (c) 1991-1995 Stichting Mathematisch Centrum.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	14 All rights reserved.
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	15
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	16
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	17 License information
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	18 -------------------
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	19
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	20 See the file "LICENSE" for information on the history of this
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	21 software, terms & conditions for usage, and a DISCLAIMER OF ALL
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	22 WARRANTIES.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	23
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	24 This Python distribution contains no GNU General Public Licensed
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	25 (GPLed) code so it may be used in proprietary projects just like prior
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	26 Python distributions. There are interfaces to some GNU code but these
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	27 are entirely optional.
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	28
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	29 All trademarks referenced herein are property of their respective
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	30 holders.
6837 96181a4a5482 Prepared the README for 1.5b2. Guido van Rossum <guido@python.org> parents: 6773 diff changeset	31
96181a4a5482 Prepared the README for 1.5b2. Guido van Rossum <guido@python.org> parents: 6773 diff changeset	32
3887 957f42ea0f84 Numerous changes, but still a lot of XXX thingies. Guido van Rossum <guido@python.org> parents: 3850 diff changeset	33 What's new in this release?
957f42ea0f84 Numerous changes, but still a lot of XXX thingies. Guido van Rossum <guido@python.org> parents: 3850 diff changeset	34 ---------------------------
3850 d1cff49e3cc8 Various changes (not done yet even for beta2 release) Guido van Rossum <guido@python.org> parents: 3778 diff changeset	35
15986 bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	36 See the file "Misc/NEWS".
6675 cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	37
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	38 If you don't read instructions
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	39 ------------------------------
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	40
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	41 Congratulations on getting this far. :-)
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 To start building right away (on UNIX): type "./configure" in the
22354 dca4a7c36eb9 Another Guido backport: Michael W. Hudson <mwh@python.net> parents: 22063 diff changeset	44 current directory and when it finishes, type "make". This creates an
dca4a7c36eb9 Another Guido backport: Michael W. Hudson <mwh@python.net> parents: 22063 diff changeset	45 executable "./python"; to install in /usr/local, first do "su root"
dca4a7c36eb9 Another Guido backport: Michael W. Hudson <mwh@python.net> parents: 22063 diff changeset	46 and then "make install".
dca4a7c36eb9 Another Guido backport: Michael W. Hudson <mwh@python.net> parents: 22063 diff changeset	47
dca4a7c36eb9 Another Guido backport: Michael W. Hudson <mwh@python.net> parents: 22063 diff changeset	48 The section `Build Instructions' below is still recommended reading,
dca4a7c36eb9 Another Guido backport: Michael W. Hudson <mwh@python.net> parents: 22063 diff changeset	49 especially the part on customizing Modules/Setup.
3850 d1cff49e3cc8 Various changes (not done yet even for beta2 release) Guido van Rossum <guido@python.org> parents: 3778 diff changeset	50
d1cff49e3cc8 Various changes (not done yet even for beta2 release) Guido van Rossum <guido@python.org> parents: 3778 diff changeset	51
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	52 What is Python anyway?
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	53 ----------------------
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	54
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	55 Python is an interpreted object-oriented programming language suitable
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	56 (amongst other uses) for distributed application development,
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	57 scripting, numeric computing and system testing. Python is often
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	58 compared to Tcl, Perl, Java, JavaScript, Visual Basic or Scheme. To
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	59 find out more about what Python can do for you, point your browser to
15986 bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	60 http://www.python.org/.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	61
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	62
4501 559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails. Guido van Rossum <guido@python.org> parents: 4427 diff changeset	63 How do I learn Python?
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails. Guido van Rossum <guido@python.org> parents: 4427 diff changeset	64 ----------------------
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails. Guido van Rossum <guido@python.org> parents: 4427 diff changeset	65
10862 4f5d4945605c Added "Learning Python" to the books section. Fred Drake <fdrake@acm.org> parents: 10587 diff changeset	66 The official tutorial is still a good place to start; see
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	67 http://www.python.org/doc/ for online and downloadable versions, as
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	68 well as a list of other introductions, and reference documentation.
10862 4f5d4945605c Added "Learning Python" to the books section. Fred Drake <fdrake@acm.org> parents: 10587 diff changeset	69
12205 253cdeeaf42e Quick update to the README file. For intros and books we now point to Guido van Rossum <guido@python.org> parents: 11474 diff changeset	70 There's a quickly growing set of books on Python. See
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 http://www.python.org/psa/bookstore/ for a list.
5591 da475e107a68 Minor edits for 1.5a2 Guido van Rossum <guido@python.org> parents: 5525 diff changeset	72
4501 559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails. Guido van Rossum <guido@python.org> parents: 4427 diff changeset	73
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	74 Documentation
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	75 -------------
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	76
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	77 All documentation is provided online in a variety of formats. In
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	78 order of importance for new users: Tutorial, Library Reference,
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	79 Language Reference, Extending & Embedding, and the Python/C API. The
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	80 Library Reference is especially of immense value since much of
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	81 Python's power is described there, including the built-in data types
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	82 and functions!
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	83
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	84 All documentation is also available online at the Python web site
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	85 (http://www.python.org/doc/, see below). It is available online for
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	86 occasional reference, or can be downloaded in many formats for faster
15325 65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	87 access. The documentation is available in HTML, PostScript, PDF, and
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	88 LaTeX formats; the LaTeX version is primarily for documentation
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	89 authors, translators, and people with special formatting requirements.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	90
21414 f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	91 The best documentation for the new (in Python 2.2) type/class unification
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	92 features is Guido's tutorial introduction, at
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	93
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	94 http://www.python.org/2.2/descrintro.html
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	95
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	96
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	97 Web sites
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	98 ---------
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	99
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	100 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	101 http://www.python.org/. Come visit us!
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	102
15986 bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	103 There's also a Python community web site at http://starship.python.net/.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	104
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	105
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	106 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	107 ----------------------------
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	108
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	109 Read comp.lang.python, a high-volume discussion newsgroup about
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	110 Python, or comp.lang.python.announce, a low-volume moderated newsgroup
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	111 for Python-related announcements. These are also accessible as
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	112 mailing lists: see http://www.python.org/psa/MailingLists.html for an
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	113 overview of the many Python-related mailing lists.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	114
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	115 Archives are accessible via Deja.com Usenet News: see
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	116 http://www.deja.com/usenet. The mailing lists are also archived, see
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	117 http://www.python.org/psa/MailingLists.html for details.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	118
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	119
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	120 Bug reports
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	121 -----------
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	122
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	123 To report or search for bugs, please use the Python Bug
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	124 Tracker at http://sourceforge.net/bugs/?group_id=5470.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	125
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	126
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	127 Patches and contributions
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	128 -------------------------
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	129
15325 65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	130 To submit a patch or other contribution, please use the Python Patch
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	131 Manager at http://sourceforge.net/patch/?group_id=5470. Guidelines
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	132 for patch submission may be found at http://www.python.org/patches/.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	133
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	134 If you have a proposal to change Python, it's best to submit a Python
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	135 Enhancement Proposal (PEP) first. All current PEPs, as well as
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	136 guidelines for submitting a new PEP, are list at
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	137 http://python.sourceforge.net/peps/.
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	138
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	139
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	140 Questions
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	141 ---------
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	142
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	143 For help, if you can't find it in the manuals or on the web site, it's
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	144 best to post to the comp.lang.python or the Python mailing list (see
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	145 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	146 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	147 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	148 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	149
13155 9919d65edc76 Tentative 2.0 and BeOpen upgrade. Guido van Rossum <guido@python.org> parents: 12374 diff changeset	150
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	151 Build instructions
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	152 ==================
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	153
21999 7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	154 Before you can build Python, you must first configure it.
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	155 Fortunately, the configuration and build process has been automated
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	156 for Unix and Linux installations, so all you usually have to do is
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	157 type a few commands and sit back. There are some platforms where
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	158 things are not quite as smooth; see the platform specific notes below.
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	159 If you want to build for multiple platforms sharing the same source
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	160 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	161
21999 7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	162 Start by running the script "./configure", which determines your
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	163 system configuration and creates the Makefile. (It takes a minute or
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	164 two -- please be patient!) You may want to pass options to the
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	165 configure script -- see the section below on configuration options and
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	166 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	167
21999 7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	168 To build Python, you normally type "make" in the toplevel directory.
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	169 If you have changed the configuration, the Makefile may have to be
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	170 rebuilt. In this case you may have to run make again to correctly
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	171 build your desired target. The interpreter executable is built in the
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	172 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	173
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	174 Once you have built a Python interpreter, see the subsections below on
21999 7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	175 testing and installation. If you run into trouble, see the next
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	176 section.
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	177
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	178 Previous versions of Python used a manual configuration process that
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	179 involved editing the file Modules/Setup. While this file still exists
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	180 and manual configuration is still supported, it is rarely needed any
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	181 more: almost all modules are automatically built as appropriate under
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	182 guidance of the setup.py script, which is run by Make after the
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	183 interpreter has been built.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	184
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	185
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	186 Troubleshooting
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	187 ---------------
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	188
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	189 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	190
6072 c7b5a722d926 New, more complete list of what's new, pointing to Misc/NEWS for the Guido van Rossum <guido@python.org> parents: 6018 diff changeset	191 If you run into other trouble, see section 3 of the FAQ
13155 9919d65edc76 Tentative 2.0 and BeOpen upgrade. Guido van Rossum <guido@python.org> parents: 12374 diff changeset	192 (http://www.python.org/cgi-bin/faqw.py or
6072 c7b5a722d926 New, more complete list of what's new, pointing to Misc/NEWS for the Guido van Rossum <guido@python.org> parents: 6018 diff changeset	193 http://www.python.org/doc/FAQ.html) for hints on what can go wrong,
c7b5a722d926 New, more complete list of what's new, pointing to Misc/NEWS for the Guido van Rossum <guido@python.org> parents: 6018 diff changeset	194 and how to fix it.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	195
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	196 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	197 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	198 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	199 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	200
4134 69edc67e5a68 Updated for 1.4beta3 Guido van Rossum <guido@python.org> parents: 3922 diff changeset	201 If the configure script fails or doesn't seem to find things that
6448 b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	202 should be there, inspect the config.log file. When you fix a
b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	203 configure problem, be sure to remove config.cache!
b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	204
b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	205 If you get a warning for every file about the -Olimit option being no
b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	206 longer supported, you can ignore it. There's no foolproof way to know
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	207 whether this option is needed; all we can do is test whether it is
6448 b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	208 accepted without error. On some systems, e.g. older SGI compilers, it
b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	209 is essential for performance (specifically when compiling ceval.c,
b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	210 which has more basic blocks than the default limit of 1000). If the
b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	211 warning bothers you, edit the Makefile to remove "-Olimit 1500" from
b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	212 the OPT variable.
4134 69edc67e5a68 Updated for 1.4beta3 Guido van Rossum <guido@python.org> parents: 3922 diff changeset	213
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	214 If you get failures in test_long, or sys.maxint gets set to -1, you
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	215 are probably experiencing compiler bugs, usually related to
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	216 optimization. This is a common problem with some versions of gcc and
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	217 egcs, and some vendor-supplied compilers, which can sometimes be
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	218 worked around by turning off optimization. Consider switching to
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	219 stable versions (gcc 2.7.2.3, egcs 1.1.2, or contact your vendor.)
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	220
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	221 From Python 2.0 onward, all Python C code is ANSI C. Compiling using
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	222 old K&R-C-only compilers is no longer possible. ANSI C compilers are
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	223 available for all modern systems, either in the form of updated
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	224 compilers from the vendor, or one of the free compilers (gcc, egcs).
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	225
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	226 Platform specific notes
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	227 -----------------------
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	228
3174 f7789945b8de release 1.3 for real Guido van Rossum <guido@python.org> parents: 3110 diff changeset	229 (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	230 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	231 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	232 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	233
6448 b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	234 64-bit platforms: The modules audioop, imageop and rgbimg don't work.
21999 7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	235 The setup.py script disables them on 64-bit installations.
6448 b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	236 Don't try to enable them in the Modules/Setup file. They
b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	237 contain code that is quite wordsize sensitive. (If you have a
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	238 fix, let us know!)
6448 b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	239
5037 9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	240 Solaris: When using Sun's C compiler with threads, at least on Solaris
9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	241 2.5.1, you need to add the "-mt" compiler option (the simplest
9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	242 way is probably to specify the compiler with this option as
9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	243 the "CC" environment variable when running the configure
9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	244 script).
9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	245
25352 2ba80a4312ff Warn about binutils 2.13 on Solaris. Guido van Rossum <guido@python.org> parents: 24446 diff changeset	246 When using GCC on Solaris, beware of binutils 2.13 or GCC
2ba80a4312ff Warn about binutils 2.13 on Solaris. Guido van Rossum <guido@python.org> parents: 24446 diff changeset	247 versions built using it. This mistakenly enables the
2ba80a4312ff Warn about binutils 2.13 on Solaris. Guido van Rossum <guido@python.org> parents: 24446 diff changeset	248 -zcombreloc option which creates broken shared libraries on
2ba80a4312ff Warn about binutils 2.13 on Solaris. Guido van Rossum <guido@python.org> parents: 24446 diff changeset	249 Solaris. binutils 2.12 works, and the binutils maintainers
2ba80a4312ff Warn about binutils 2.13 on Solaris. Guido van Rossum <guido@python.org> parents: 24446 diff changeset	250 are aware of the problem, so binutils 2.13.1 will probably fix
2ba80a4312ff Warn about binutils 2.13 on Solaris. Guido van Rossum <guido@python.org> parents: 24446 diff changeset	251 this problem.
2ba80a4312ff Warn about binutils 2.13 on Solaris. Guido van Rossum <guido@python.org> parents: 24446 diff changeset	252
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	253 Linux: A problem with threads and fork() was tracked down to a bug in
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	254 the pthreads code in glibc version 2.0.5; glibc version 2.0.7
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	255 solves the problem. This causes the popen2 test to fail;
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	256 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	257
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	258 Under Linux systems using GNU libc 2 (aka libc6), the crypt
21999 7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	259 module now needs the -lcrypt option. The setup.py script
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	260 takes care of this automatically.
6773 14d6b7a42919 For RedHat Linux 5.0, added notes about needing to remove the LinuxThreads Fred Drake <fdrake@acm.org> parents: 6710 diff changeset	261
22354 dca4a7c36eb9 Another Guido backport: Michael W. Hudson <mwh@python.net> parents: 22063 diff changeset	262 Red Hat Linux: There's an executable /usr/bin/python which is Python
dca4a7c36eb9 Another Guido backport: Michael W. Hudson <mwh@python.net> parents: 22063 diff changeset	263 1.5.2 on most Red Hat installations; several key Red Hat tools
dca4a7c36eb9 Another Guido backport: Michael W. Hudson <mwh@python.net> parents: 22063 diff changeset	264 require this version. Python 2.1.x may be installed as
dca4a7c36eb9 Another Guido backport: Michael W. Hudson <mwh@python.net> parents: 22063 diff changeset	265 /usr/bin/python2. The Makefile installs Python as
dca4a7c36eb9 Another Guido backport: Michael W. Hudson <mwh@python.net> parents: 22063 diff changeset	266 /usr/local/bin/python, which may or may not take precedence
dca4a7c36eb9 Another Guido backport: Michael W. Hudson <mwh@python.net> parents: 22063 diff changeset	267 over /usr/bin/python, depending on how you have set up $PATH.
dca4a7c36eb9 Another Guido backport: Michael W. Hudson <mwh@python.net> parents: 22063 diff changeset	268
11024 271af297aa3e Add warning FreeBSD users of a problem with curses and termcap, Guido van Rossum <guido@python.org> parents: 10862 diff changeset	269 FreeBSD 3.x and probably platforms with NCurses that use libmytinfo or
271af297aa3e Add warning FreeBSD users of a problem with curses and termcap, Guido van Rossum <guido@python.org> parents: 10862 diff changeset	270 similar: When using cursesmodule, the linking is not done in
271af297aa3e Add warning FreeBSD users of a problem with curses and termcap, Guido van Rossum <guido@python.org> parents: 10862 diff changeset	271 the correct order with the defaults. Remove "-ltermcap" from
271af297aa3e Add warning FreeBSD users of a problem with curses and termcap, Guido van Rossum <guido@python.org> parents: 10862 diff changeset	272 the readline entry in Setup, and use as curses entry: "curses
271af297aa3e Add warning FreeBSD users of a problem with curses and termcap, Guido van Rossum <guido@python.org> parents: 10862 diff changeset	273 cursesmodule.c -lmytinfo -lncurses -ltermcap" - "mytinfo" (so
271af297aa3e Add warning FreeBSD users of a problem with curses and termcap, Guido van Rossum <guido@python.org> parents: 10862 diff changeset	274 called on FreeBSD) should be the name of the auxiliary library
271af297aa3e Add warning FreeBSD users of a problem with curses and termcap, Guido van Rossum <guido@python.org> parents: 10862 diff changeset	275 required on your platform. Normally, it would be linked
271af297aa3e Add warning FreeBSD users of a problem with curses and termcap, Guido van Rossum <guido@python.org> parents: 10862 diff changeset	276 automatically, but not necessarily in the correct order.
271af297aa3e Add warning FreeBSD users of a problem with curses and termcap, Guido van Rossum <guido@python.org> parents: 10862 diff changeset	277
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	278 BSDI: BSDI versions before 4.1 have known problems with threads,
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	279 which can cause strange errors in a number of modules (for
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	280 instance, the 'test_signal' test script will hang forever.)
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	281 Turning off threads (with --with-threads=no) or upgrading to
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	282 BSDI 4.1 solves this problem.
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	283
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	284 DEC Unix: Run configure with --with-dec-threads, or with
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	285 --with-threads=no if no threads are desired (threads are on by
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	286 default). When using GCC, it is possible to get an internal
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	287 compiler error if optimization is used. This was reported for
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	288 GCC 2.7.2.3 on selectmodule.c. Manually compile the affected
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	289 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	290
10565 104a441b2bc8 Add DEC Ultrix notes (from Donn Cave's email). Guido van Rossum <guido@python.org> parents: 10549 diff changeset	291 DEC Ultrix: compile with GCC to avoid bugs in the native compiler,
104a441b2bc8 Add DEC Ultrix notes (from Donn Cave's email). Guido van Rossum <guido@python.org> parents: 10549 diff changeset	292 and pass SHELL=/bin/sh5 to Make when installing.
104a441b2bc8 Add DEC Ultrix notes (from Donn Cave's email). Guido van Rossum <guido@python.org> parents: 10549 diff changeset	293
4134 69edc67e5a68 Updated for 1.4beta3 Guido van Rossum <guido@python.org> parents: 3922 diff changeset	294 AIX: A complete overhaul of the shared library support is now in
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	295 place. See Misc/AIX-NOTES for some notes on how it's done.
7325 6e00fb723f69 Oh, well, various miscellaneous changes. Guido van Rossum <guido@python.org> parents: 7011 diff changeset	296 (The optimizer bug reported at this place in previous releases
16608 f425d8523480 Rewrite AIX blurb to make clear threads are the default, and add note about Thomas Wouters <thomas@python.org> parents: 16390 diff changeset	297 has been worked around by a minimal code change.) If you get
23416 58cac70602aa Fix typo: ptread --> pthread Fred Drake <fdrake@acm.org> parents: 22539 diff changeset	298 errors about pthread_* functions, during compile or during
16608 f425d8523480 Rewrite AIX blurb to make clear threads are the default, and add note about Thomas Wouters <thomas@python.org> parents: 16390 diff changeset	299 testing, try setting CC to a thread-safe (reentrant) compiler,
f425d8523480 Rewrite AIX blurb to make clear threads are the default, and add note about Thomas Wouters <thomas@python.org> parents: 16390 diff changeset	300 like "cc_r". For full C++ module support, set CC="xlC_r" (or
f425d8523480 Rewrite AIX blurb to make clear threads are the default, and add note about Thomas Wouters <thomas@python.org> parents: 16390 diff changeset	301 CC="xlC" without thread support).
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	302
10576 6e7f14af89b7 Add note about -D_REENTRANT for HP-UX 10.20. Guido van Rossum <guido@python.org> parents: 10572 diff changeset	303 HP-UX: Please read the file Misc/HPUX-NOTES for shared libraries.
6e7f14af89b7 Add note about -D_REENTRANT for HP-UX 10.20. Guido van Rossum <guido@python.org> parents: 10572 diff changeset	304 When using threading, you may have to add -D_REENTRANT to the
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	305 OPT variable in the top-level Makefile; reported by Pat Knight,
10576 6e7f14af89b7 Add note about -D_REENTRANT for HP-UX 10.20. Guido van Rossum <guido@python.org> parents: 10572 diff changeset	306 this seems to make a difference (at least for HP-UX 10.20)
6e7f14af89b7 Add note about -D_REENTRANT for HP-UX 10.20. Guido van Rossum <guido@python.org> parents: 10572 diff changeset	307 even though config.h defines it.
8336 6b7095b98e54 Add pointer to Misc/HPUX-NOTES. Guido van Rossum <guido@python.org> parents: 8316 diff changeset	308
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	309 Minix: When using ack, use "CC=cc AR=aal RANLIB=: ./configure"!
1882 f84b64df09c3 The usual junk Guido van Rossum <guido@python.org> parents: 1819 diff changeset	310
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	311 SCO: The following apply to SCO 3 only; Python builds out of the box
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	312 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	313
e2333969a2ca The usual edits... Updated some stuff about the mailing list. Ready Guido van Rossum <guido@python.org> parents: 7978 diff changeset	314 1) Everything works much better if you add -U__STDC__ to the
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	315 defs. This is because all the SCO header files are broken.
6675 cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	316 Anything that isn't mentioned in the C standard is
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	317 conditionally excluded when __STDC__ is defined.
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	318
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	319 2) Due to the U.S. export restrictions, SCO broke the crypt
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	320 stuff out into a separate library, libcrypt_i.a so the LIBS
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	321 needed be set to:
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	322
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	323 LIBS=' -lsocket -lcrypt_i'
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	324
19758 64bcef1702ad Revert parts of patch #453627, documenting the resulting test failures Martin v. Löwis <martin@v.loewis.de> parents: 19381 diff changeset	325 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	326 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	327 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	328 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	329
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	330 SunOS 4.x: When using the SunPro C compiler, you may want to use the
6675 cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	331 '-Xa' option instead of '-Xc', to enable some needed non-ANSI
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	332 Sunisms.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	333
19381 60d5cbbeadc3 Removed NeXT notes (replacing them with a line saying NeXT is no Jack Jansen <jack.jansen@cwi.nl> parents: 17734 diff changeset	334 NeXT: Not supported anymore. Start with the MacOSX/Darwin code if you
60d5cbbeadc3 Removed NeXT notes (replacing them with a line saying NeXT is no Jack Jansen <jack.jansen@cwi.nl> parents: 17734 diff changeset	335 want to revive it.
3922 e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	336
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	337 QNX: Chris Herborth (chrish@qnx.com) writes:
90c6390b4941 Add attributions to Jeffrey Ollie and Tim Peters for re.py; new QNX Guido van Rossum <guido@python.org> parents: 6680 diff changeset	338 configure works best if you use GNU bash; a port is available on
90c6390b4941 Add attributions to Jeffrey Ollie and Tim Peters for re.py; new QNX Guido van Rossum <guido@python.org> parents: 6680 diff changeset	339 ftp.qnx.com in /usr/free. I used the following process to build,
9696 22f3a8d803a5 Optimistically, we label this as ready to go today. Guido van Rossum <guido@python.org> parents: 9392 diff changeset	340 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	341
8818 71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	342 1) CONFIG_SHELL=/usr/local/bin/bash CC=cc RANLIB=: \
71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	343 ./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	344
15344 e59f538bb829 Update build instructions to reflect the rename from Setup.in to Setup.dist. Fred Drake <fdrake@acm.org> parents: 15325 diff changeset	345 2) edit Modules/Setup to activate everything that makes sense for
e59f538bb829 Update build instructions to reflect the rename from Setup.in to Setup.dist. Fred Drake <fdrake@acm.org> parents: 15325 diff changeset	346 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	347
8944 3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	348 array, audioop, binascii, cPickle, cStringIO, cmath,
3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	349 crypt, curses, errno, fcntl, gdbm, grp, imageop,
3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	350 _locale, math, md5, new, operator, parser, pcre,
3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	351 posix, pwd, readline, regex, reop, rgbimg, rotor,
3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	352 select, signal, socket, soundex, strop, struct,
9696 22f3a8d803a5 Optimistically, we label this as ready to go today. Guido van Rossum <guido@python.org> parents: 9392 diff changeset	353 syslog, termios, time, timing, zlib, audioop, imageop, rgbimg
6710 90c6390b4941 Add attributions to Jeffrey Ollie and Tim Peters for re.py; new QNX Guido van Rossum <guido@python.org> parents: 6680 diff changeset	354
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	355 3) make SHELL=/usr/local/bin/bash
4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	356
8818 71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	357 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	358
8818 71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	359 make SHELL=/usr/local/bin/bash OPT="-5 -Oil+nrt"
71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	360
71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	361 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	362
8944 3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	363 Using GNU readline 2.2 seems to behave strangely, but I
3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	364 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	365
71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	366 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	367
8944 3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	368 If you get SIGSEGVs while running Python (I haven't yet, but
3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	369 I've only run small programs and the test cases), you're
3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	370 probably running out of stack; the default 32k could be a
3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	371 little tight. To increase the stack size, edit the Makefile
16288 c0a2441a4454 - Edit the QNX instructions to refer to Makefile, not Modules/Makefile. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 16229 diff changeset	372 to read: LDFLAGS = -N 48k
6018 f05546743406 Added QNX remarks. Guido van Rossum <guido@python.org> parents: 5951 diff changeset	373
8818 71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	374 BeOS: Chris Herborth (chrish@qnx.com) writes:
71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	375 See BeOS/README for notes about compiling/installing Python on
8944 3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	376 BeOS R3 or later. Note that only the PowerPC platform is
9696 22f3a8d803a5 Optimistically, we label this as ready to go today. Guido van Rossum <guido@python.org> parents: 9392 diff changeset	377 supported for R3; both PowerPC and x86 are 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	378
24446 6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	379 Cray T3E: Mark Hadfield (m.hadfield@niwa.co.nz) writes:
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	380 Python can be built satisfactorily on a Cray T3E but based on
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	381 my experience with the NIWA T3E (2002-05-22, version 2.2.1)
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	382 there are a few bugs and gotchas. For more information see a
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	383 thread on comp.lang.python in May 2002 entitled "Building
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	384 Python on Cray T3E".
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	385
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	386 1) Use Cray's cc and not gcc. The latter was reported not to
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	387 work by Konrad Hinsen. It may work now, but it may not.
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	388
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	389 2) To set sys.platform to something sensible, pass the
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	390 following environment variable to the configure script:
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	391
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	392 MACHDEP=unicosmk
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	393
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	394 2) Run configure with option "--enable-unicode=ucs4".
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	395
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	396 3) The Cray T3E does not support dynamic linking, so extension
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	397 modules have to be built by adding (or uncommenting) lines
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	398 in Modules/Setup. The minimum set of modules is
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	399
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	400 posix, new, _sre, unicodedata
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	401
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	402 On NIWA's vanilla T3E system the following have also been
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	403 included successfully:
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	404
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	405 _codecs, _locale, _socket, _symtable, _testcapi, _weakref
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	406 array, binascii, cmath, cPickle, crypt, cStringIO, dbm
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	407 errno, fcntl, grp, math, md5, operator, parser, pcre, pwd
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	408 regex, rotor, select, struct, strop, syslog, termios
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	409 time, timing, xreadlines
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	410
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	411 4) Once the python executable and library have been built, make
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	412 will execute setup.py, which will attempt to build remaining
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	413 extensions and link them dynamically. Each of these attempts
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	414 will fail but should not halt the make process. This is
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	415 normal.
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	416
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	417 5) Running "make test" uses a lot of resources and causes
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	418 problems on our system. You might want to try running tests
6f824d6f1286 Put Cray fixes on the branch, too. Michael W. Hudson <mwh@python.net> parents: 23416 diff changeset	419 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	420
6132 94605b0026e7 Add warning about dumb SGI make. Guido van Rossum <guido@python.org> parents: 6122 diff changeset	421 SGI: SGI's standard "make" utility (/bin/make or /usr/bin/make)
94605b0026e7 Add warning about dumb SGI make. Guido van Rossum <guido@python.org> parents: 6122 diff changeset	422 does not check whether a command actually changed the file it
94605b0026e7 Add warning about dumb SGI make. Guido van Rossum <guido@python.org> parents: 6122 diff changeset	423 is supposed to build. This means that whenever you say "make"
94605b0026e7 Add warning about dumb SGI make. Guido van Rossum <guido@python.org> parents: 6122 diff changeset	424 it will redo the link step. The remedy is to use SGI's much
17512 76fae614526c Add more general warning against the SGI optimizer. Guido van Rossum <guido@python.org> parents: 17458 diff changeset	425 smarter "smake" utility (/usr/sbin/smake), or GNU make. If
6448 b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	426 you set the first line of the Makefile to #!/usr/sbin/smake
b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	427 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	428
17512 76fae614526c Add more general warning against the SGI optimizer. Guido van Rossum <guido@python.org> parents: 17458 diff changeset	429 WARNING: There are bugs in the optimizer of some versions of
76fae614526c Add more general warning against the SGI optimizer. Guido van Rossum <guido@python.org> parents: 17458 diff changeset	430 SGI's compilers that can cause bus errors or other strange
76fae614526c Add more general warning against the SGI optimizer. Guido van Rossum <guido@python.org> parents: 17458 diff changeset	431 behavior, especially on numerical operations. To avoid this,
76fae614526c Add more general warning against the SGI optimizer. Guido van Rossum <guido@python.org> parents: 17458 diff changeset	432 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	433
6675 cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	434 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	435 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	436 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	437 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	438
15043 c0c254fbde57 Added section on threads problems on Reliant UNIX; this relates to Fred Drake <fdrake@acm.org> parents: 14927 diff changeset	439 Monterey (64-bit AIX): The current Monterey C compiler (Visual Age)
c0c254fbde57 Added section on threads problems on Reliant UNIX; this relates to Fred Drake <fdrake@acm.org> parents: 14927 diff changeset	440 uses the OBJECT_MODE={32\|64} environment variable to set the
c0c254fbde57 Added section on threads problems on Reliant UNIX; this relates to Fred Drake <fdrake@acm.org> parents: 14927 diff changeset	441 compilation mode to either 32-bit or 64-bit (32-bit mode is
c0c254fbde57 Added section on threads problems on Reliant UNIX; this relates to Fred Drake <fdrake@acm.org> parents: 14927 diff changeset	442 the default). Presumably you want 64-bit compilation mode for
c0c254fbde57 Added section on threads problems on Reliant UNIX; this relates to Fred Drake <fdrake@acm.org> parents: 14927 diff changeset	443 this 64-bit OS. As a result you must first set OBJECT_MODE=64
c0c254fbde57 Added section on threads problems on Reliant UNIX; this relates to Fred Drake <fdrake@acm.org> parents: 14927 diff changeset	444 in your environment before configuring (./configure) or
c0c254fbde57 Added section on threads problems on Reliant UNIX; this relates to Fred Drake <fdrake@acm.org> parents: 14927 diff changeset	445 building (make) Python on Monterey.
c0c254fbde57 Added section on threads problems on Reliant UNIX; this relates to Fred Drake <fdrake@acm.org> parents: 14927 diff changeset	446
c0c254fbde57 Added section on threads problems on Reliant UNIX; this relates to Fred Drake <fdrake@acm.org> parents: 14927 diff changeset	447 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	448 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	449 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	450 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	451
25779 ade8af1aa3c6 There was a typo in the MacOSX section regarding the stacksize issue. Barry Warsaw <barry@python.org> parents: 25761 diff changeset	452 MacOSX: The tests will crash on both 10.1 and 10.2 with SEGV in
25782 f0a74ae09ad7 I'd forgotten that tcsh was the default for 10.1, but SF's 10.1 system Barry Warsaw <barry@python.org> parents: 25779 diff changeset	453 test_re and test_sre due to the small default stack size. If
f0a74ae09ad7 I'd forgotten that tcsh was the default for 10.1, but SF's 10.1 system Barry Warsaw <barry@python.org> parents: 25779 diff changeset	454 you set the stack size to 2048 before doing a "make test" the
f0a74ae09ad7 I'd forgotten that tcsh was the default for 10.1, but SF's 10.1 system Barry Warsaw <barry@python.org> parents: 25779 diff changeset	455 failure can be avoided. If you're using the tcsh (the default
f0a74ae09ad7 I'd forgotten that tcsh was the default for 10.1, but SF's 10.1 system Barry Warsaw <barry@python.org> parents: 25779 diff changeset	456 on OSX), or csh shells use "limit stacksize 2048" and for the
f0a74ae09ad7 I'd forgotten that tcsh was the default for 10.1, but SF's 10.1 system Barry Warsaw <barry@python.org> parents: 25779 diff changeset	457 bash shell, use "ulimit -s 2048".
21414 f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	458
21273 ecbbeccde07d Cleaned up Mac OS X section to the current state of affairs. Jack Jansen <jack.jansen@cwi.nl> parents: 20959 diff changeset	459 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	460 "--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	461 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	462 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	463
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	464 On a clean OSX /usr/local does not exist. Do a
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	465 "sudo mkdir -m 775 /usr/local"
21273 ecbbeccde07d Cleaned up Mac OS X section to the current state of affairs. Jack Jansen <jack.jansen@cwi.nl> parents: 20959 diff changeset	466 before you do a make install. Alternatively, do "sudo make install"
20959 da5fbc1eb1d0 OSX notes: Jack Jansen <jack.jansen@cwi.nl> parents: 20314 diff changeset	467 which installs everything as superuser.
21414 f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	468
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	469 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	470 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	471 as argument to the --enable-framework option (default
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	472 /Library/Frameworks). You may also want to check out ./Mac/OSX
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	473 for building a Python.app. You may also want to manually
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	474 install a symlink in /usr/local/bin/python to the executable
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	475 deep down in the framework.
16390 d34f25046ad4 Added note about need for -traditional-cpp on the MacOS X Public Beta. Fred Drake <fdrake@acm.org> parents: 16288 diff changeset	476
21491 ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	477 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	478 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	479 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	480 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	481
21491 ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	482 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	483 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	484 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	485 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	486
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	487 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	488
21491 ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	489 (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	490 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	491
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	492 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	493 other options you need (--prefix, etc.). Then in Modules/Setup
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	494 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	495
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	496 #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	497 #_socket socketmodule.c \
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	498 # -DUSE_SSL -I$(SSL)/include -I$(SSL)/include/openssl \
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	499 # -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	500
21491 ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	501 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	502 "make"!
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	503
21495 2474414d4342 Apparently it's Cygwin with a capital C. Michael W. Hudson <mwh@python.net> parents: 21493 diff changeset	504 (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	505 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	506 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	507
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	508 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	509
21491 ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	510 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	511 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	512
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	513 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	514
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	515 (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	516 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	517 hang.
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	518
21493 162106b16e44 Fix a typo Neal Norwitz <nnorwitz@gmail.com> parents: 21491 diff changeset	519 (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	520 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	521 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	522
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	523 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	524 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	525
21491 ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	526 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	527 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	528 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	529
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	530 test_pwd
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	531 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	532 test_socket
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	533
21491 ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	534 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	535 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	536
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	537 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	538
21491 ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	539 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	540 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	541
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	542 Configuring threads
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	543 -------------------
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	544
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	545 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	546 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	547 --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	548 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	549 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	550 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	551 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	552 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	553 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	554 send in the patch. (Don't bother patching the configure script itself
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	555 -- it is regenerated each 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	556
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	557 Compiler switches for threads
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	558 .............................
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	559
16994 459c8ef0a010 Document that _REENTRANT is not needed explicitly. Martin v. Löwis <martin@v.loewis.de> parents: 16776 diff changeset	560 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	561 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	562 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	563
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	564 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	565 (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	566
16994 459c8ef0a010 Document that _REENTRANT is not needed explicitly. Martin v. Löwis <martin@v.loewis.de> parents: 16776 diff changeset	567 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	568 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	569 DEC OSF/1 3.x/cc/DCE -threads
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	570 (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	571 Digital UNIX 4.x/cc/DCE -threads
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	572 (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	573 Digital UNIX 4.x/cc/POSIX -pthread
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	574 (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	575 AIX 4.1.4/cc_r/d7 (nothing)
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	576 (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	577 AIX 4.1.4/cc_r4/DCE (nothing)
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	578 (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	579 IRIX 6.2/cc/POSIX (nothing)
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	580 (robertl@cwi.nl)
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	581
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	582
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	583 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	584 ...........................................
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	585
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	586 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	587
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	588 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	589 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	590 DEC OSF/1 3.x/DCE -lpthreads -lmach -lc_r -lc
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	591 (butenhof@zko.dec.com)
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	592 Digital UNIX 4.x/DCE -lpthreads -lpthread -lmach -lexc -lc
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	593 (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	594 Digital UNIX 4.x/POSIX -lpthread -lmach -lexc -lc
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	595 (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	596 AIX 4.1.4/{draft7,DCE} (nothing)
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	597 (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	598 IRIX 6.2/POSIX -lpthread
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	599 (jph@emilia.engr.sgi.com)
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	600
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	601
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	602 Configuring additional built-in modules
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	603 ---------------------------------------
2162 c9aea34ae4b6 add hint for NeXT users Guido van Rossum <guido@python.org> parents: 2131 diff changeset	604
16776 2915eb07bd25 Update build notes to mention setup.py Andrew M. Kuchling <amk@amk.ca> parents: 16775 diff changeset	605 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	606 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	607 automatically compiles them. Autodetection doesn't always work, so
21999 7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	608 you can still customize the configuration by editing the Modules/Setup
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	609 file; but this should be considered a last resort. The rest of this
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	610 section only applies if you decide to edit the Modules/Setup file.
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	611 You also need this to enable static linking of certain modules (which
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	612 is needed to enable profiling on some systems).
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	613
16776 2915eb07bd25 Update build notes to mention setup.py Andrew M. Kuchling <amk@amk.ca> parents: 16775 diff changeset	614 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	615 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	616 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	617 -- 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	618 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	619 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	620 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	621 directory).
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	622
16776 2915eb07bd25 Update build notes to mention setup.py Andrew M. Kuchling <amk@amk.ca> parents: 16775 diff changeset	623 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	624 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	625 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	626 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	627 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	628 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	629
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	630 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	631 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	632 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	633
5037 9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	634 In addition to the file Setup, you can also edit the file Setup.local.
9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	635 (the makesetup script processes both). You may find it more
9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	636 convenient to edit Setup.local and leave Setup alone. Then, when
9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	637 installing a new Python version, you can copy your old Setup.local
9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	638 file.
9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	639
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	640
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	641 Setting the optimization/debugging options
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	642 ------------------------------------------
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	643
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	644 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	645 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	646 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	647 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	648 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	649 (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	650 set of libraries to link with).
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	651
15325 65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	652 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	653 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	654
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	655 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	656 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	657
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	658
20252 b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	659 Profiling
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	660 ---------
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	661
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	662 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	663 with the CC environment variable to the necessary compiler
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	664 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	665 gprof(1):
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	666
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	667 CC="gcc -pg" ./configure
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	668
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	669 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	670 libraries. The Makefile/Setup mechanism can be used to compile and
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	671 link most extension module statically.
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	672
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	673
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	674 Testing
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	675 -------
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	676
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	677 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	678 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	679 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	680 produces some output. You can generally ignore the messages about
21999 7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	681 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	682 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	683 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	684 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	685 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	686 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	687
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	688 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	689 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	690 failing test manually, as follows:
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	691
22539 e2cbe9c33411 backport akuchling's checkin of Michael W. Hudson <mwh@python.net> parents: 22354 diff changeset	692 ./python ./Lib/test/test_whatever.py
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	693
22539 e2cbe9c33411 backport akuchling's checkin of Michael W. Hudson <mwh@python.net> parents: 22354 diff changeset	694 (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	695 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	696
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	697
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	698 Installing
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	699 ----------
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	700
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	701 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	702 (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	703 just type
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	704
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	705 make install
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	706
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	707 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	708 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	709 `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	710 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	711 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	712 (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	713
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	714 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	715 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	716 "/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	717 <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	718 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	719 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	720 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	721 by default.
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	722
16629 96e9ccbf165f Add more information regarding the altinstall target. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 16608 diff changeset	723 If you have a previous installation of Python that you don't
6675 cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	724 want to replace yet, use
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	725
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	726 make altinstall
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	727
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	728 This installs the same set of files as "make install" except it
15986 bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	729 doesn't create the hard link to "python<version>" named "python" and
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	730 it doesn't install the manual page at all.
3922 e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	731
16629 96e9ccbf165f Add more information regarding the altinstall target. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 16608 diff changeset	732 Alpha/beta revision levels are stripped from the executable and
96e9ccbf165f Add more information regarding the altinstall target. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 16608 diff changeset	733 library filenames during installation. For example, Python2.1a2 will
96e9ccbf165f Add more information regarding the altinstall target. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 16608 diff changeset	734 install as python2.1, overwriting the previous python2.1. To avoid
96e9ccbf165f Add more information regarding the altinstall target. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 16608 diff changeset	735 this, you could set the Makefile VERSION variable manually
96e9ccbf165f Add more information regarding the altinstall target. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 16608 diff changeset	736 (e.g. VERSION=2.1a2) before running "make install" or "make altinstall".
96e9ccbf165f Add more information regarding the altinstall target. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 16608 diff changeset	737
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	738 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	739 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	740 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	741 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	742
19381 60d5cbbeadc3 Removed NeXT notes (replacing them with a line saying NeXT is no Jack Jansen <jack.jansen@cwi.nl> parents: 17734 diff changeset	743 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	744 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	745 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	746 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	747
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	748
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	749 Configuration options and variables
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	750 -----------------------------------
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	751
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	752 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	753 script.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	754
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	755 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	756 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	757 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	758 Modules/getpath.o.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	759
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	760 --with(out)-gcc: The configure script uses gcc (the GNU C compiler) if
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	761 it finds it. If you don't want this, or if this compiler is
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	762 installed but broken on your platform, pass the option
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	763 --without-gcc. You can also pass "CC=cc" (or whatever the
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	764 name of the proper C compiler is) in the environment, but the
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	765 advantage of using --without-gcc is that this option is
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	766 remembered by the config.status script for its --recheck
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	767 option.
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	768
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	769 --prefix, --exec-prefix: If you want to install the binaries and the
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	770 Python library somewhere else than in /usr/local/{bin,lib},
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	771 you can pass the option --prefix=DIRECTORY; the interpreter
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	772 binary will be installed as DIRECTORY/bin/python and the
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	773 library files as DIRECTORY/lib/python/*. If you pass
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	774 --exec-prefix=DIRECTORY (as well) this overrides the
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	775 installation prefix for architecture-dependent files (like the
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	776 interpreter binary). Note that --prefix=DIRECTORY also
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	777 affects the default module search path (sys.path), when
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	778 Modules/config.c is compiled. Passing make the option
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	779 prefix=DIRECTORY (and/or exec_prefix=DIRECTORY) overrides the
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	780 prefix set at configuration time; this may be more convenient
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	781 than re-running the configure script if you change your mind
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	782 about the install prefix.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	783
21999 7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	784 --with-readline: This option is no longer supported. GNU
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	785 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	786
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	787 --with-threads: On most Unix systems, you can now use multiple
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	788 threads, and support for this is enabled by default. To
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	789 disable this, pass --with-threads=no. If the library required
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	790 for threads lives in a peculiar place, you can use
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	791 --with-thread=DIRECTORY. IMPORTANT: run "make clean" after
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	792 changing (either enabling or disabling) this option, or you
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	793 will get link errors! Note: for DEC Unix use
7450 0d767614c941 Add slightly more explicit warning about running "make clean" when Guido van Rossum <guido@python.org> parents: 7325 diff changeset	794 --with-dec-threads instead.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	795
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	796 --with-sgi-dl: On SGI IRIX 4, dynamic loading of extension modules is
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	797 supported by the "dl" library by Jack Jansen, which is
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	798 ftp'able from ftp://ftp.cwi.nl/pub/dynload/dl-1.6.tar.Z.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	799 This is enabled (after you've ftp'ed and compiled the dl
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	800 library) by passing --with-sgi-dl=DIRECTORY where DIRECTORY
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	801 is the absolute pathname of the dl library. (Don't bother on
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	802 IRIX 5, it already has dynamic linking using SunOS style
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	803 shared libraries.) Support for this feature is deprecated.
2049 07cf3b3baf16 The usual changes when a release is nearing... Guido van Rossum <guido@python.org> parents: 2015 diff changeset	804
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	805 --with-dl-dld: Dynamic loading of modules is rumored to be supported
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	806 on some other systems: VAX (Ultrix), Sun3 (SunOS 3.4), Sequent
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	807 Symmetry (Dynix), and Atari ST. This is done using a
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	808 combination of the GNU dynamic loading package
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	809 (ftp://ftp.cwi.nl/pub/dynload/dl-dld-1.1.tar.Z) and an
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	810 emulation of the SGI dl library mentioned above (the emulation
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	811 can be found at
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	812 ftp://ftp.cwi.nl/pub/dynload/dld-3.2.3.tar.Z). To
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	813 enable this, ftp and compile both libraries, then call
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	814 configure, passing it the option
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	815 --with-dl-dld=DL_DIRECTORY,DLD_DIRECTORY where DL_DIRECTORY is
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	816 the absolute pathname of the dl emulation library and
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	817 DLD_DIRECTORY is the absolute pathname of the GNU dld library.
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	818 (Don't bother on SunOS 4 or 5, they already have dynamic
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	819 linking using shared libraries.) Support for this feature is
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	820 deprecated.
2049 07cf3b3baf16 The usual changes when a release is nearing... Guido van Rossum <guido@python.org> parents: 2015 diff changeset	821
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	822 --with-libm, --with-libc: It is possible to specify alternative
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	823 versions for the Math library (default -lm) and the C library
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	824 (default the empty string) using the options
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	825 --with-libm=STRING and --with-libc=STRING, respectively. For
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	826 example, if your system requires that you pass -lc_s to the C
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	827 compiler to use the shared C library, you can pass
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	828 --with-libc=-lc_s. These libraries are passed after all other
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	829 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	830
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	831 --with-libs='libs': Add 'libs' to the LIBS that the python interpreter
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	832 is linked against.
3893 958d4c67526b Added doc para for --with-libs Guido van Rossum <guido@python.org> parents: 3887 diff changeset	833
15546 bb93b1dca571 Document --with-cxx. Martin v. Löwis <martin@v.loewis.de> parents: 15344 diff changeset	834 --with-cxx=<compiler>: Some C++ compilers require that main() is
bb93b1dca571 Document --with-cxx. Martin v. Löwis <martin@v.loewis.de> parents: 15344 diff changeset	835 compiled with the C++ if there is any C++ code in the application.
bb93b1dca571 Document --with-cxx. Martin v. Löwis <martin@v.loewis.de> parents: 15344 diff changeset	836 Specifically, g++ on a.out systems may require that to support
bb93b1dca571 Document --with-cxx. Martin v. Löwis <martin@v.loewis.de> parents: 15344 diff changeset	837 construction of global objects. With this option, the main() function
bb93b1dca571 Document --with-cxx. Martin v. Löwis <martin@v.loewis.de> parents: 15344 diff changeset	838 of Python will be compiled with <compiler>; use that only if you
bb93b1dca571 Document --with-cxx. Martin v. Löwis <martin@v.loewis.de> parents: 15344 diff changeset	839 plan to use C++ extension modules, and if your compiler requires
bb93b1dca571 Document --with-cxx. Martin v. Löwis <martin@v.loewis.de> parents: 15344 diff changeset	840 compilation of main() as a C++ program.
bb93b1dca571 Document --with-cxx. Martin v. Löwis <martin@v.loewis.de> parents: 15344 diff changeset	841
bb93b1dca571 Document --with-cxx. Martin v. Löwis <martin@v.loewis.de> parents: 15344 diff changeset	842
15325 65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	843 --with-pydebug: Enable additional debugging code to help track down
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	844 memory management problems. This allows printing a list of all
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	845 live objects when the interpreter terminates.
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	846
2049 07cf3b3baf16 The usual changes when a release is nearing... Guido van Rossum <guido@python.org> parents: 2015 diff changeset	847
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	848 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	849 -------------------------------------------------------------
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	850
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	851 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	852 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	853 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	854 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	855 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	856 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	857 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	858 contain a line VPATH=... which points to a directory containing the
4134 69edc67e5a68 Updated for 1.4beta3 Guido van Rossum <guido@python.org> parents: 3922 diff changeset	859 actual sources. (On SGI systems, use "smake -J1" instead of "make" if
69edc67e5a68 Updated for 1.4beta3 Guido van Rossum <guido@python.org> parents: 3922 diff changeset	860 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	861
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	862 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	863 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	864 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	865
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	866 $ mkdir /usr/tmp/python
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	867 $ cd /usr/tmp/python
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	868 $ ~guido/src/python/configure
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	869 [...]
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	870 $ make
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	871 [...]
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	872 $
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	873
16288 c0a2441a4454 - Edit the QNX instructions to refer to Makefile, not Modules/Makefile. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 16229 diff changeset	874 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	875 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	876 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	877 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	878 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	879 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	880 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	881 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	882 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	883 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	884
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	885
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	886 Building on non-UNIX systems
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	887 ----------------------------
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	888
14673 df8d575d967d Updated Windows build info. Tim Peters <tim.peters@gmail.com> parents: 14429 diff changeset	889 For Windows (2000/NT/ME/98/95), assuming you have MS VC++ 6.0, the
df8d575d967d Updated Windows build info. Tim Peters <tim.peters@gmail.com> parents: 14429 diff changeset	890 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	891 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	892
10572 10bd2fb2a0d6 Clarify PC build instructions (point to PCbuild). Guido van Rossum <guido@python.org> parents: 10565 diff changeset	893 For other non-Unix Windows compilers, in particular Windows 3.1 and
10bd2fb2a0d6 Clarify PC build instructions (point to PCbuild). Guido van Rossum <guido@python.org> parents: 10565 diff changeset	894 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	895
3922 e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	896 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	897 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	898 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	899 (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	900 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	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 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	903 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	904
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	905 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	906 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	907 has already been done for you). A good start is to copy the file
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	908 config.h.in to config.h and edit the latter to reflect the actual
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	909 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	910 1 only if the corresponding feature is present and can be left alone
13676 5423b132bc97 Removed all instances of RETSIGTYPE from the source code: signal Tim Peters <tim.peters@gmail.com> parents: 13262 diff changeset	911 otherwise; however the *_t type symbols must be defined as some variant
5423b132bc97 Removed all instances of RETSIGTYPE from the source code: signal Tim Peters <tim.peters@gmail.com> parents: 13262 diff changeset	912 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	913
21414 f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	914 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	915 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	916 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	917 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	918 do this.
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	919
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	920
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	921 Miscellaneous issues
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	922 ====================
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	923
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	924 Emacs mode
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	925 ----------
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	926
6448 b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	927 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	928 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	929 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	930 coincidence that they now both work on the same team). The latest
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	931 version, along with various other contributed Python-related Emacs
15986 bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	932 goodies, is online at http://www.python.org/emacs/python-mode. And
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	933 if you are planning to edit the Python C code, please pick up the
15986 bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	934 latest version of CC Mode http://www.python.org/emacs/cc-mode; it
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	935 contains a "python" style used throughout most of the Python C source
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	936 files. (Newer versions of Emacs or XEmacs may already come with the
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	937 latest version of python-mode.)
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	938
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	939
21999 7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	940 Tkinter
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	941 -------
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	942
21999 7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	943 The setup.py script automatically configures this when it detects a
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	944 usable Tcl/Tk installation. This requires Tcl/Tk version 8.0 or
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	945 higher.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	946
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	947 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	948 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	949
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	950 There are demos in the Demo/tkinter directory, in the subdirectories
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	951 guido, matt and www (the matt and guido subdirectories have been
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	952 overhauled to use more recent Tkinter coding conventions).
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	953
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	954 Note that there's a Python module called "Tkinter" (capital T) which
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	955 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	956 (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	957 Modules/_tkinter.c. Demos and normal Tk applications import only the
21999 7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	958 Python Tkinter module -- only the latter imports the C _tkinter
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	959 module. In order to find the C _tkinter module, it must be compiled
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	960 and linked into the Python interpreter -- the setup.py script does
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	961 this. In order to find the Python Tkinter module, sys.path must be
7aee0f8afac5 backport guido's checkin of revision 1.139: Michael W. Hudson <mwh@python.net> parents: 21495 diff changeset	962 set correctly -- normal installation takes care of this.
3008 a51022f1980f 1.3b1 notes Guido van Rossum <guido@python.org> parents: 2730 diff changeset	963
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	964
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	965 Distribution structure
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	966 ----------------------
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	967
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	968 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	969 comments.
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	970
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	971 .cvsignore Additional filename matching patterns for CVS to ignore
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	972 BeOS/ Files specific to the BeOS port
3922 e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	973 Demo/ Demonstration scripts, modules and programs
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	974 Doc/ Documentation sources (LaTeX)
3922 e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	975 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	976 Include/ Public header files
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	977 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	978 Lib/ Python library modules
16229 e302586452a3 Update the build instructions for flat makefile. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 15986 diff changeset	979 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	980 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	981 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	982 Objects/ Implementation of most built-in object types
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	983 PC/ Files specific to PC ports (DOS, Windows, OS/2)
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	984 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	985 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	986 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	987 README The file you're reading now
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	988 Tools/ Some useful programs written in Python
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	989 acconfig.h Additional input for the GNU autoheader program
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	990 config.h.in Source from which config.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	991 configure Configuration shell script (GNU autoconf output)
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	992 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	993 install-sh Shell script used to install files
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	994
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	995 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	996 the configuration and build processes:
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	997
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	998 Makefile Build rules
16229 e302586452a3 Update the build instructions for flat makefile. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 15986 diff changeset	999 Makefile.pre Build rules before running Modules/makesetup
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	1000 buildno Keeps track of the build number
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	1001 config.cache Cache of configuration variables
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	1002 config.h Configuration header
6448 b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	1003 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	1004 config.status Status from last run of the configure script
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	1005 getbuildinfo.o Object file from Modules/getbuildinfo.c
15986 bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	1006 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	1007 python The executable interpreter
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	1008 tags, TAGS Tags files for vi and Emacs
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	1009
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	1010
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	1011 That's all, folks!
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	1012 ------------------
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	1013
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	1014
15986 bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	1015 --Guido van Rossum (home page: http://www.python.org/~guido/)

Mercurial > cpython-lru_cache-weakref

annotate README @ 25838:8540887bcec6 2.2