cpython-lru_cache-weakref: README annotate

annotate README @ 21283:d4907cdcc299 legacy-trunk

Use an immutable tuple for __slots instead of a mutable list Bump version number

author	Andrew M. Kuchling <amk@amk.ca>
date	Fri, 07 Dec 2001 14:22:13 +0000
parents	ecbbeccde07d
children	8a89ff1e0662

rev	line source
17571 3eac20afd54a Bump the version number in more places Guido van Rossum <guido@python.org> parents: 17542 diff changeset	1 This is Python version 2.2
15249 735ed856de60 the usual Jeremy Hylton <jeremy@alum.mit.edu> parents: 15132 diff changeset	2 ==========================
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	3
17139 c9b4eff15dcd Set copyright to PSF. Don't bother with 2000. Guido van Rossum <guido@python.org> parents: 16994 diff changeset	4 Copyright (c) 2001 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
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	44 current directory and when it finishes, type "make". The section
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	45 `Build Instructions' below is still recommended reading, especially
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	46 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	47
d1cff49e3cc8 Various changes (not done yet even for beta2 release) Guido van Rossum <guido@python.org> parents: 3778 diff changeset	48
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	49 What is Python anyway?
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	50 ----------------------
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	51
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	52 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	53 (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	54 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	55 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	56 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	57 http://www.python.org/.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	58
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	59
4501 559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails. Guido van Rossum <guido@python.org> parents: 4427 diff changeset	60 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	61 ----------------------
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails. Guido van Rossum <guido@python.org> parents: 4427 diff changeset	62
10862 4f5d4945605c Added "Learning Python" to the books section. Fred Drake <fdrake@acm.org> parents: 10587 diff changeset	63 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	64 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	65 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	66
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 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	68 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	69
4501 559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails. Guido van Rossum <guido@python.org> parents: 4427 diff changeset	70
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	71 Documentation
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	72 -------------
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	73
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	74 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	75 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	76 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	77 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	78 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	79 and functions!
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	80
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	81 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	82 (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	83 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	84 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	85 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	86 authors, translators, and people with special formatting requirements.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	87
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	88
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	89 Web sites
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	90 ---------
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	91
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	92 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	93 http://www.python.org/. Come visit us!
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	94
15986 bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	95 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	96
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	97
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	98 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	99 ----------------------------
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	100
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	101 Read comp.lang.python, a high-volume discussion newsgroup about
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	102 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	103 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	104 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	105 overview of the many Python-related mailing lists.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	106
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	107 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	108 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	109 http://www.python.org/psa/MailingLists.html for details.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	110
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	111
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	112 Bug reports
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	113 -----------
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	114
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	115 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	116 Tracker at http://sourceforge.net/bugs/?group_id=5470.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	117
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	118
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	119 Patches and contributions
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	120 -------------------------
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	121
15325 65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	122 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	123 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	124 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	125
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	126 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	127 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	128 guidelines for submitting a new PEP, are list at
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	129 http://python.sourceforge.net/peps/.
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	130
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	131
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	132 Questions
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	133 ---------
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	134
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	135 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	136 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	137 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	138 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	139 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	140 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	141
13155 9919d65edc76 Tentative 2.0 and BeOpen upgrade. Guido van Rossum <guido@python.org> parents: 12374 diff changeset	142
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	143 Build instructions
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	144 ==================
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	145
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	146 Before you can build Python, you must first configure it. Fortunately,
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	147 the configuration and build process has been streamlined for most Unix
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	148 installations, so all you have to do is type a few commands,
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	149 optionally edit one file, and sit back. There are some platforms
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	150 where things are not quite as smooth; see the platform specific notes
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	151 below. If you want to build for multiple platforms sharing the same
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	152 source 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	153
16229 e302586452a3 Update the build instructions for flat makefile. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 15986 diff changeset	154 Start by running the script "./configure", which determines your system
e302586452a3 Update the build instructions for flat makefile. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 15986 diff changeset	155 configuration and creates the Makefile. (It takes a minute or two --
e302586452a3 Update the build instructions for flat makefile. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 15986 diff changeset	156 please be patient!) You may want to pass options to the configure
e302586452a3 Update the build instructions for flat makefile. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 15986 diff changeset	157 script or edit the Modules/Setup file after running configure -- see the
e302586452a3 Update the build instructions for flat makefile. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 15986 diff changeset	158 section below on configuration options and variables. When it's done,
e302586452a3 Update the build instructions for flat makefile. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 15986 diff changeset	159 you are ready to run make.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	160
16229 e302586452a3 Update the build instructions for flat makefile. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 15986 diff changeset	161 To build Python, you normally type "make" in the toplevel directory. If
e302586452a3 Update the build instructions for flat makefile. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 15986 diff changeset	162 you have changed the configuration or have modified Modules/Setup, the
e302586452a3 Update the build instructions for flat makefile. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 15986 diff changeset	163 Makefile may have to be rebuilt. In this case you may have to run make
e302586452a3 Update the build instructions for flat makefile. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 15986 diff changeset	164 again to correctly build your desired target. The interpreter
e302586452a3 Update the build instructions for flat makefile. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 15986 diff changeset	165 executable is built in the 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	166
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	167 Once you have built a Python interpreter, see the subsections below on
3922 e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	168 testing, configuring additional modules, and installation. If you run
15344 e59f538bb829 Update build instructions to reflect the rename from Setup.in to Setup.dist. Fred Drake <fdrake@acm.org> parents: 15325 diff changeset	169 into trouble, see the next section. Editing the Modules/Setup file
e59f538bb829 Update build instructions to reflect the rename from Setup.in to Setup.dist. Fred Drake <fdrake@acm.org> parents: 15325 diff changeset	170 after running make is supported; just run "make" again after making
e59f538bb829 Update build instructions to reflect the rename from Setup.in to Setup.dist. Fred Drake <fdrake@acm.org> parents: 15325 diff changeset	171 the desired changes.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	172
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	173
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	174 Troubleshooting
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	175 ---------------
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	176
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	177 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	178
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	179 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	180 (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	181 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	182 and how to fix it.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	183
3922 e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	184 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	185 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	186 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	187 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	188
4134 69edc67e5a68 Updated for 1.4beta3 Guido van Rossum <guido@python.org> parents: 3922 diff changeset	189 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	190 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	191 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	192
b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	193 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	194 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	195 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	196 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	197 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	198 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	199 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	200 the OPT variable.
4134 69edc67e5a68 Updated for 1.4beta3 Guido van Rossum <guido@python.org> parents: 3922 diff changeset	201
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	202 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	203 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	204 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	205 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	206 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	207 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	208
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	209 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	210 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	211 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	212 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	213
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	214 Platform specific notes
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	215 -----------------------
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	216
3174 f7789945b8de release 1.3 for real Guido van Rossum <guido@python.org> parents: 3110 diff changeset	217 (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	218 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	219 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	220 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	221
6448 b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	222 64-bit platforms: The modules audioop, imageop and rgbimg don't work.
b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	223 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	224 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	225 fix, let us know!)
6448 b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	226
5037 9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	227 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	228 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	229 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	230 the "CC" environment variable when running the configure
9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	231 script).
9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	232
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	233 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	234 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	235 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	236 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	237
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	238 Under Linux systems using GNU libc 2 (aka libc6), the crypt
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	239 module now needs the -lcrypt option. Uncomment this flag in
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	240 Modules/Setup, or comment out the crypt module in the same
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	241 file. Most modern Linux systems use glibc2.
6773 14d6b7a42919 For RedHat Linux 5.0, added notes about needing to remove the LinuxThreads Fred Drake <fdrake@acm.org> parents: 6710 diff changeset	242
11024 271af297aa3e Add warning FreeBSD users of a problem with curses and termcap, Guido van Rossum <guido@python.org> parents: 10862 diff changeset	243 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	244 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	245 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	246 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	247 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	248 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	249 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	250 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	251
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	252 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	253 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	254 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	255 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	256 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	257
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	258 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	259 --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	260 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	261 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	262 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	263 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	264
10565 104a441b2bc8 Add DEC Ultrix notes (from Donn Cave's email). Guido van Rossum <guido@python.org> parents: 10549 diff changeset	265 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	266 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	267
4134 69edc67e5a68 Updated for 1.4beta3 Guido van Rossum <guido@python.org> parents: 3922 diff changeset	268 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	269 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	270 (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	271 has been worked around by a minimal code change.) If you get
f425d8523480 Rewrite AIX blurb to make clear threads are the default, and add note about Thomas Wouters <thomas@python.org> parents: 16390 diff changeset	272 errors about ptread_* functions, during compile or during
f425d8523480 Rewrite AIX blurb to make clear threads are the default, and add note about Thomas Wouters <thomas@python.org> parents: 16390 diff changeset	273 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	274 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	275 CC="xlC" without thread support).
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	276
10576 6e7f14af89b7 Add note about -D_REENTRANT for HP-UX 10.20. Guido van Rossum <guido@python.org> parents: 10572 diff changeset	277 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	278 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	279 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	280 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	281 even though config.h defines it.
8336 6b7095b98e54 Add pointer to Misc/HPUX-NOTES. Guido van Rossum <guido@python.org> parents: 8316 diff changeset	282
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	283 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	284
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	285 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	286 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	287
e2333969a2ca The usual edits... Updated some stuff about the mailing list. Ready Guido van Rossum <guido@python.org> parents: 7978 diff changeset	288 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	289 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	290 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	291 conditionally excluded when __STDC__ is defined.
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	292
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	293 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	294 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	295 needed be set to:
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	296
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	297 LIBS=' -lsocket -lcrypt_i'
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	298
19758 64bcef1702ad Revert parts of patch #453627, documenting the resulting test failures Martin v. Löwis <martin@v.loewis.de> parents: 19381 diff changeset	299 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	300 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	301 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	302 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	303
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	304 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	305 '-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	306 Sunisms.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	307
19381 60d5cbbeadc3 Removed NeXT notes (replacing them with a line saying NeXT is no Jack Jansen <jack.jansen@cwi.nl> parents: 17734 diff changeset	308 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	309 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	310
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	311 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	312 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	313 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	314 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	315
8818 71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	316 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	317 ./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	318
15344 e59f538bb829 Update build instructions to reflect the rename from Setup.in to Setup.dist. Fred Drake <fdrake@acm.org> parents: 15325 diff changeset	319 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	320 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	321
8944 3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	322 array, audioop, binascii, cPickle, cStringIO, cmath,
3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	323 crypt, curses, errno, fcntl, gdbm, grp, imageop,
3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	324 _locale, math, md5, new, operator, parser, pcre,
3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	325 posix, pwd, readline, regex, reop, rgbimg, rotor,
3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	326 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	327 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	328
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	329 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	330
8818 71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	331 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	332
8818 71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	333 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	334
71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	335 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	336
8944 3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	337 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	338 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	339
71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	340 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	341
8944 3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	342 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	343 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	344 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	345 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	346 to read: LDFLAGS = -N 48k
6018 f05546743406 Added QNX remarks. Guido van Rossum <guido@python.org> parents: 5951 diff changeset	347
8818 71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	348 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	349 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	350 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	351 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	352
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	353 Cray T3E: Konrad Hinsen writes:
8944 3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	354 1) Don't use gcc. It compiles Python/graminit.c into something
3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	355 that the Cray assembler doesn't like. Cray's cc seems to work
3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	356 fine.
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	357 2) Comment out modules md5 (won't compile) and audioop (will
8944 3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	358 crash the interpreter during the test suite).
3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	359 If you run the test suite, two tests will fail (rotate and
3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	360 binascii), but these are not the modules you'd expect to need
3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	361 on a Cray.
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	362
6132 94605b0026e7 Add warning about dumb SGI make. Guido van Rossum <guido@python.org> parents: 6122 diff changeset	363 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	364 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	365 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	366 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	367 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	368 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	369 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	370
17512 76fae614526c Add more general warning against the SGI optimizer. Guido van Rossum <guido@python.org> parents: 17458 diff changeset	371 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	372 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	373 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	374 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	375
6675 cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	376 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	377 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	378 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	379 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	380
15043 c0c254fbde57 Added section on threads problems on Reliant UNIX; this relates to Fred Drake <fdrake@acm.org> parents: 14927 diff changeset	381 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	382 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	383 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	384 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	385 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	386 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	387 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	388
c0c254fbde57 Added section on threads problems on Reliant UNIX; this relates to Fred Drake <fdrake@acm.org> parents: 14927 diff changeset	389 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	390 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	391 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	392 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	393
21273 ecbbeccde07d Cleaned up Mac OS X section to the current state of affairs. Jack Jansen <jack.jansen@cwi.nl> parents: 20959 diff changeset	394 Mac OS X 10: One of the regular expression tests fails
20959 da5fbc1eb1d0 OSX notes: Jack Jansen <jack.jansen@cwi.nl> parents: 20314 diff changeset	395 with a SEGV due to the small stack size used by default, if you do
da5fbc1eb1d0 OSX notes: Jack Jansen <jack.jansen@cwi.nl> parents: 20314 diff changeset	396 "limit stacksize 2048" before "make test" it should work.
da5fbc1eb1d0 OSX notes: Jack Jansen <jack.jansen@cwi.nl> parents: 20314 diff changeset	397
21273 ecbbeccde07d Cleaned up Mac OS X section to the current state of affairs. Jack Jansen <jack.jansen@cwi.nl> parents: 20959 diff changeset	398 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	399 "--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	400 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	401 if you add the --enable-framework option, see below.
20959 da5fbc1eb1d0 OSX notes: Jack Jansen <jack.jansen@cwi.nl> parents: 20314 diff changeset	402
da5fbc1eb1d0 OSX notes: Jack Jansen <jack.jansen@cwi.nl> parents: 20314 diff changeset	403 On a clean OSX /usr/local does not exist. Do a "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	404 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	405 which installs everything as superuser.
da5fbc1eb1d0 OSX notes: Jack Jansen <jack.jansen@cwi.nl> parents: 20314 diff changeset	406
19381 60d5cbbeadc3 Removed NeXT notes (replacing them with a line saying NeXT is no Jack Jansen <jack.jansen@cwi.nl> parents: 17734 diff changeset	407 You may want to try the configure option "--enable-framework" which
60d5cbbeadc3 Removed NeXT notes (replacing them with a line saying NeXT is no Jack Jansen <jack.jansen@cwi.nl> parents: 17734 diff changeset	408 installs Python as a framework. The location can be set as argument
20959 da5fbc1eb1d0 OSX notes: Jack Jansen <jack.jansen@cwi.nl> parents: 20314 diff changeset	409 to the --enable-framework option (default /Library/Frameworks). You may
21273 ecbbeccde07d Cleaned up Mac OS X section to the current state of affairs. Jack Jansen <jack.jansen@cwi.nl> parents: 20959 diff changeset	410 also want to check out ./Mac/OSX for building a Python.app. You may also
ecbbeccde07d Cleaned up Mac OS X section to the current state of affairs. Jack Jansen <jack.jansen@cwi.nl> parents: 20959 diff changeset	411 want to manually install a symlink in /usr/local/bin/python to the
ecbbeccde07d Cleaned up Mac OS X section to the current state of affairs. Jack Jansen <jack.jansen@cwi.nl> parents: 20959 diff changeset	412 executable 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	413
17311 b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	414 Cygwin: Cygwin Python builds OOTB when configured as follows:
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	415
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	416 configure --with-threads=no
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	417
17311 b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	418 assuming Cygwin 1.1.8-2 and gcc 2.95.3-1 or later. At the time
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	419 of this writing, Cygwin pthread support is being significantly
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	420 enhanced. Hopefully, there will be a Cygwin Python with thread
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	421 support soon.
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	422
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	423 Cygwin Python supports the building of shared extensions via the
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	424 traditional Misc/Makefile.pre.in and the newer distutils methods.
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	425
17311 b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	426 On NT/2000, the following regression tests fail:
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	427
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	428 test_poll (hang)
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	429 test_strftime
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	430
17311 b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	431 Due to the test_poll hang on NT/2000, one should run the
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	432 regression test using the following:
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	433
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	434 PYTHONPATH= ./python.exe -tt ./Lib/test/regrtest.py -l -x test_poll
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	435
17311 b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	436 On 9X/Me, in addition the above NT/2000 failures, it has been
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	437 reported that the following regression tests also fail:
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	438
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	439 test_pwd
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	440 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	441 test_socket
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	442
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	443 Due to the test_poll and test_select hang on 9X/Me, one should
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	444 run the regression test using the following:
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	445
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	446 PYTHONPATH= ./python.exe -tt ./Lib/test/regrtest.py -l -x test_poll -x test_select
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	447
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	448 Help trying to track down the root causes for these known problems
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	449 will be greatly appreciated.
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	450
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	451
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	452 Configuring threads
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	453 -------------------
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	454
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	455 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	456 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	457 --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	458 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	459 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	460 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	461 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	462 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	463 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	464 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	465 -- 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	466
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	467 Compiler switches for threads
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	468 .............................
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	469
16994 459c8ef0a010 Document that _REENTRANT is not needed explicitly. Martin v. Löwis <martin@v.loewis.de> parents: 16776 diff changeset	470 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	471 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	472 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	473
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	474 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	475 (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	476
16994 459c8ef0a010 Document that _REENTRANT is not needed explicitly. Martin v. Löwis <martin@v.loewis.de> parents: 16776 diff changeset	477 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	478 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	479 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	480 (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	481 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	482 (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	483 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	484 (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	485 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	486 (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	487 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	488 (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	489 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	490 (robertl@cwi.nl)
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	491
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	492
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	493 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	494 ...........................................
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	495
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	496 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	497
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	498 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	499 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	500 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	501 (butenhof@zko.dec.com)
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	502 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	503 (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	504 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	505 (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	506 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	507 (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	508 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	509 (jph@emilia.engr.sgi.com)
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	510
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	511
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	512 Configuring additional built-in modules
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	513 ---------------------------------------
2162 c9aea34ae4b6 add hint for NeXT users Guido van Rossum <guido@python.org> parents: 2131 diff changeset	514
16776 2915eb07bd25 Update build notes to mention setup.py Andrew M. Kuchling <amk@amk.ca> parents: 16775 diff changeset	515 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	516 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	517 automatically compiles them. Autodetection doesn't always work, so
2915eb07bd25 Update build notes to mention setup.py Andrew M. Kuchling <amk@amk.ca> parents: 16775 diff changeset	518 you can customize the configuration by editing the Modules/Setup file.
2915eb07bd25 Update build notes to mention setup.py Andrew M. Kuchling <amk@amk.ca> parents: 16775 diff changeset	519 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	520 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	521 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	522 -- 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	523 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	524 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	525 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	526 directory).
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	527
16776 2915eb07bd25 Update build notes to mention setup.py Andrew M. Kuchling <amk@amk.ca> parents: 16775 diff changeset	528 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	529 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	530 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	531 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	532 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	533 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	534
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	535 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	536 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	537 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	538
5037 9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	539 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	540 (the makesetup script processes both). You may find it more
9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	541 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	542 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	543 file.
9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	544
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	545
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	546 Setting the optimization/debugging options
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	547 ------------------------------------------
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	548
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	549 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	550 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	551 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	552 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	553 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	554 (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	555 set of libraries to link with).
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	556
15325 65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	557 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	558 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	559
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	560 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	561 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	562
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	563
20252 b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	564 Profiling
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	565 ---------
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	566
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	567 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	568 with the CC environment variable to the necessary compiler
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	569 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	570 gprof(1):
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	571
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	572 CC="gcc -pg" ./configure
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	573
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	574 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	575 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	576 link most extension module statically.
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	577
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	578
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	579 Testing
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	580 -------
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	581
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	582 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	583 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	584 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	585 produces some output. You can generally ignore the messages about
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	586 skipped tests due to optional features which can't be imported. (If
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	587 you want to test those modules, edit Modules/Setup to configure them.)
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	588 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	589 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	590 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	591 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	592 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	593
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	594 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	595 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	596 failing test manually, as follows:
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	597
5525 8582f74a1d23 Update description of "make test" to new test harness. Guido van Rossum <guido@python.org> parents: 5466 diff changeset	598 python ../Lib/test/test_whatever.py
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	599
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	600 (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	601 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	602
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	603
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	604 Installing
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	605 ----------
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	606
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	607 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	608 (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	609 just type
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	610
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	611 make install
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	612
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	613 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	614 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	615 `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	616 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	617 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	618 (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	619
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	620 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	621 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	622 "/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	623 <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	624 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	625 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	626 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	627 by default.
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	628
16629 96e9ccbf165f Add more information regarding the altinstall target. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 16608 diff changeset	629 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	630 want to replace yet, use
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	631
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	632 make altinstall
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	633
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	634 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	635 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	636 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	637
16629 96e9ccbf165f Add more information regarding the altinstall target. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 16608 diff changeset	638 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	639 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	640 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	641 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	642 (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	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 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	645 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	646 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	647 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	648
19381 60d5cbbeadc3 Removed NeXT notes (replacing them with a line saying NeXT is no Jack Jansen <jack.jansen@cwi.nl> parents: 17734 diff changeset	649 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	650 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	651 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	652 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	653
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	654
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	655 Configuration options and variables
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	656 -----------------------------------
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	657
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	658 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	659 script.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	660
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	661 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	662 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	663 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	664 Modules/getpath.o.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	665
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	666 --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	667 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	668 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	669 --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	670 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	671 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	672 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	673 option.
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	674
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	675 --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	676 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	677 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	678 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	679 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	680 --exec-prefix=DIRECTORY (as well) this overrides the
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	681 installation prefix for architecture-dependent files (like the
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	682 interpreter binary). Note that --prefix=DIRECTORY also
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	683 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	684 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	685 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	686 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	687 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	688 about the install prefix.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	689
5951 8d7dc66968cb --with-readline is obsolete (and some editorial stuff in README) Guido van Rossum <guido@python.org> parents: 5591 diff changeset	690 --with-readline: This option is no longer supported. To use GNU
8d7dc66968cb --with-readline is obsolete (and some editorial stuff in README) Guido van Rossum <guido@python.org> parents: 5591 diff changeset	691 readline, enable module "readline" in the Modules/Setup file.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	692
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	693 --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	694 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	695 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	696 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	697 --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	698 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	699 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	700 --with-dec-threads instead.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	701
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	702 --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	703 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	704 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	705 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	706 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	707 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	708 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	709 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	710
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	711 --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	712 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	713 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	714 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	715 (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	716 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	717 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	718 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	719 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	720 configure, passing it the option
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	721 --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	722 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	723 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	724 (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	725 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	726 deprecated.
2049 07cf3b3baf16 The usual changes when a release is nearing... Guido van Rossum <guido@python.org> parents: 2015 diff changeset	727
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	728 --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	729 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	730 (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	731 --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	732 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	733 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	734 --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	735 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	736
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	737 --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	738 is linked against.
3893 958d4c67526b Added doc para for --with-libs Guido van Rossum <guido@python.org> parents: 3887 diff changeset	739
15546 bb93b1dca571 Document --with-cxx. Martin v. Löwis <martin@v.loewis.de> parents: 15344 diff changeset	740 --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	741 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	742 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	743 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	744 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	745 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	746 compilation of main() as a C++ program.
bb93b1dca571 Document --with-cxx. Martin v. Löwis <martin@v.loewis.de> parents: 15344 diff changeset	747
bb93b1dca571 Document --with-cxx. Martin v. Löwis <martin@v.loewis.de> parents: 15344 diff changeset	748
15325 65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	749 --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	750 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	751 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	752
2049 07cf3b3baf16 The usual changes when a release is nearing... Guido van Rossum <guido@python.org> parents: 2015 diff changeset	753
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	754 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	755 -------------------------------------------------------------
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	756
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	757 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	758 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	759 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	760 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	761 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	762 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	763 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	764 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	765 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	766 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	767
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	768 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	769 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	770 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	771
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	772 $ mkdir /usr/tmp/python
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	773 $ cd /usr/tmp/python
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	774 $ ~guido/src/python/configure
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	775 [...]
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	776 $ make
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	777 [...]
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	778 $
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	779
16288 c0a2441a4454 - Edit the QNX instructions to refer to Makefile, not Modules/Makefile. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 16229 diff changeset	780 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	781 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	782 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	783 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	784 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	785 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	786 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	787 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	788 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	789 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	790
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	791
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	792 Building on non-UNIX systems
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	793 ----------------------------
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	794
14673 df8d575d967d Updated Windows build info. Tim Peters <tim.peters@gmail.com> parents: 14429 diff changeset	795 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	796 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	797 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	798
10572 10bd2fb2a0d6 Clarify PC build instructions (point to PCbuild). Guido van Rossum <guido@python.org> parents: 10565 diff changeset	799 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	800 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	801
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	802 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	803 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	804 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	805 (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	806 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	807
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	808 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	809 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	810
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	811 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	812 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	813 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	814 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	815 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	816 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	817 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	818 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	819
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	820
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	821
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	822 Miscellaneous issues
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	823 ====================
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	824
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	825 Emacs mode
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	826 ----------
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	827
6448 b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	828 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	829 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	830 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	831 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	832 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	833 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	834 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	835 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	836 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	837 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	838 latest version of python-mode.)
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	839
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	840
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	841 The Tk interface
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	842 ----------------
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	843
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	844 Tk (the user interface component of John Ousterhout's Tcl language) is
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	845 also usable from Python. Since this requires that you first build and
14919 95b20019b711 Clarify that the Tk interface is not enabled by default when building Fred Drake <fdrake@acm.org> parents: 14874 diff changeset	846 install Tcl/Tk, the Tk interface is not enabled by default when
95b20019b711 Clarify that the Tk interface is not enabled by default when building Fred Drake <fdrake@acm.org> parents: 14874 diff changeset	847 building Python from source. Python supports Tcl/Tk version 8.0 and
95b20019b711 Clarify that the Tk interface is not enabled by default when building Fred Drake <fdrake@acm.org> parents: 14874 diff changeset	848 higher.
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	849
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	850 See http://dev.ajubasolutions.com/ for more info on Tcl/Tk, including
c6fd6ffbcb15 Update a bunch of URLs. No longer suggests to join PSA or Consortium. Guido van Rossum <guido@python.org> parents: 13232 diff changeset	851 the on-line manual pages.
6675 cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	852
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	853
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	854 To enable the Python/Tk interface, once you've built and installed
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	855 Tcl/Tk, load the file Modules/Setup into your favorite text editor and
6675 cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	856 search for the string "_tkinter". Then follow the instructions found
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	857 there. If you have installed Tcl/Tk or X11 in unusual places, you
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	858 will have to edit the first line to fix or add the -I and -L options.
6675 cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	859 (Also see the general instructions at the top of that file.)
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	860
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	861 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	862 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	863
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	864 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	865 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	866 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	867
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	868 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	869 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	870 (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	871 Modules/_tkinter.c. Demos and normal Tk applications import only the
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	872 Python Tkinter module -- the latter uses the C _tkinter 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	873 directly. In order to find the C _tkinter module, it must be compiled
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	874 and linked into the Python interpreter -- the _tkinter line 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	875 Setup file does this. In order to find the Python Tkinter module,
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	876 sys.path must be set correctly -- the TKPATH assignment in the Setup
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	877 file takes care of this, but only if you install Python properly
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	878 ("make install libinstall"). (You can also use dynamic loading 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	879 the C _tkinter module, in which case you must manually fix up sys.path
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	880 or set $PYTHONPATH for the Python Tkinter module.)
3008 a51022f1980f 1.3b1 notes Guido van Rossum <guido@python.org> parents: 2730 diff changeset	881
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	882
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	883 Distribution structure
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	884 ----------------------
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	885
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	886 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	887 comments.
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	888
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	889 .cvsignore Additional filename matching patterns for CVS to ignore
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	890 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	891 Demo/ Demonstration scripts, modules and programs
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	892 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	893 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	894 Include/ Public header files
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	895 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	896 Lib/ Python library modules
16229 e302586452a3 Update the build instructions for flat makefile. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 15986 diff changeset	897 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	898 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	899 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	900 Objects/ Implementation of most built-in object types
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	901 PC/ Files specific to PC ports (DOS, Windows, OS/2)
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	902 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	903 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	904 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	905 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	906 Tools/ Some useful programs written in Python
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	907 acconfig.h Additional input for the GNU autoheader program
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	908 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	909 configure Configuration shell script (GNU autoconf output)
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	910 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	911 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	912
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	913 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	914 the configuration and build processes:
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	915
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	916 Makefile Build rules
16229 e302586452a3 Update the build instructions for flat makefile. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 15986 diff changeset	917 Makefile.pre Build rules before running Modules/makesetup
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	918 buildno Keeps track of the build number
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	919 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	920 config.h Configuration header
6448 b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	921 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	922 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	923 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	924 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	925 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	926 tags, TAGS Tags files for vi and Emacs
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	927
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	928
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	929 That's all, folks!
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	930 ------------------
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	931
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	932
15986 bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	933 --Guido van Rossum (home page: http://www.python.org/~guido/)

Mercurial > cpython-lru_cache-weakref

annotate README @ 21283:d4907cdcc299 legacy-trunk