cpython-lru_cache-weakref: README annotate

annotate README @ 15842:f6cd36498a50 legacy-trunk

Document extensions to .pth files.

author	Martin v. Löwis <martin@v.loewis.de>
date	Sat, 13 Jan 2001 09:54:41 +0000
parents	bb93b1dca571
children	bd5aee6b8390

rev	line source
15249 735ed856de60 the usual Jeremy Hylton <jeremy@alum.mit.edu> parents: 15132 diff changeset	1 This is Python version 2.0
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
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	4 Copyright (c) 2000 BeOpen.com.
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	5 All rights reserved.
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	6
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	7 Copyright (c) 1995-2000 Corporation for National Research Initiatives.
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	8 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	9
14385 39ab28572307 Remove a comma from CWI's copyright notice. Guido van Rossum <guido@python.org> parents: 14367 diff changeset	10 Copyright (c) 1991-1995 Stichting Mathematisch Centrum.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	11 All rights reserved.
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	12
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	13
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	14 License information
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	15 -------------------
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	16
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	17 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	18 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	19 WARRANTIES.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	20
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	21 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	22 (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	23 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	24 are entirely optional.
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	25
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	26 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	27 holders.
6837 96181a4a5482 Prepared the README for 1.5b2. Guido van Rossum <guido@python.org> parents: 6773 diff changeset	28
96181a4a5482 Prepared the README for 1.5b2. Guido van Rossum <guido@python.org> parents: 6773 diff changeset	29
3887 957f42ea0f84 Numerous changes, but still a lot of XXX thingies. Guido van Rossum <guido@python.org> parents: 3850 diff changeset	30 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	31 ---------------------------
3850 d1cff49e3cc8 Various changes (not done yet even for beta2 release) Guido van Rossum <guido@python.org> parents: 3778 diff changeset	32
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	33 See the file "Misc/NEWS"; see also this URL:
14874 6431cf5c8a00 It's beta 2 now. Updated some stale URLs at pythonlabs.com. Guido van Rossum <guido@python.org> parents: 14673 diff changeset	34 http://www.pythonlabs.com/products/python2.0/
6675 cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	35
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	36 If you don't read instructions
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
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	39 Congratulations on getting this far. :-)
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 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	42 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	43 `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	44 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	45
d1cff49e3cc8 Various changes (not done yet even for beta2 release) Guido van Rossum <guido@python.org> parents: 3778 diff changeset	46
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	47 What is Python anyway?
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	48 ----------------------
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	49
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	50 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	51 (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	52 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	53 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	54 find out more about what Python can do for you, point your browser to
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	55 http://www.pythonlabs.com/.
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	56
14429 9f1f0a6bc18e Added BeOpen support plug. Guido van Rossum <guido@python.org> parents: 14425 diff changeset	57 BeOpen.com offers corporate support, custom development and
9f1f0a6bc18e Added BeOpen support plug. Guido van Rossum <guido@python.org> parents: 14425 diff changeset	58 sponsorships for Python. Contact <sales@beopen.com> for more
9f1f0a6bc18e Added BeOpen support plug. Guido van Rossum <guido@python.org> parents: 14425 diff changeset	59 information.
9f1f0a6bc18e Added BeOpen support plug. Guido van Rossum <guido@python.org> parents: 14425 diff changeset	60
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	61 BeOpen Python releases include pre-built Python executables for major
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	62 platforms and are available from PythonLabs.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	63
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	64
4501 559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails. Guido van Rossum <guido@python.org> parents: 4427 diff changeset	65 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	66 ----------------------
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails. Guido van Rossum <guido@python.org> parents: 4427 diff changeset	67
10862 4f5d4945605c Added "Learning Python" to the books section. Fred Drake <fdrake@acm.org> parents: 10587 diff changeset	68 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	69 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	70 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	71
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	72 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	73 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	74
4501 559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails. Guido van Rossum <guido@python.org> parents: 4427 diff changeset	75
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	76 Documentation
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	77 -------------
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	78
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	79 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	80 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	81 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	82 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	83 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	84 and functions!
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	85
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	86 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	87 (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	88 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	89 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	90 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	91 authors, translators, and people with special formatting requirements.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	92
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	93
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	94 Web sites
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	95 ---------
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	96
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	97 New Python releases and related technologies are published at
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	98 http://www.pythonlabs.com/. Come visit us!
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	99
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	100 The present Python community web site is http://www.python.org/.
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	101 BeOpen.com is developing a next-generation community site for Python
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	102 and is looking for volunteers to help make this an even better
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	103 resource than the existing community site. If you know Python well
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	104 and would like to volunteer to work with us on this project, please
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	105 contact <volunteer@pythonlabs.com> with a summary of your skills.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	106
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	107
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	108 Newsgroups and Mailing Lists
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	109 ----------------------------
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	110
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	111 Read comp.lang.python, a high-volume discussion newsgroup about
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	112 Python, or comp.lang.python.announce, a low-volume moderated newsgroup
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	113 for Python-related announcements. These are also accessible as
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	114 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	115 overview of the many Python-related mailing lists.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	116
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	117 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	118 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	119 http://www.python.org/psa/MailingLists.html for details.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	120
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	121
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	122 Bug reports
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	123 -----------
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	124
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	125 To report or search for bugs, please use the Python Bug
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	126 Tracker at http://sourceforge.net/bugs/?group_id=5470.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	127
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	128
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	129 Patches and contributions
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	130 -------------------------
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	131
15325 65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	132 To submit a patch or other contribution, please use the Python Patch
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	133 Manager at http://sourceforge.net/patch/?group_id=5470. Guidelines
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	134 for patch submission may be found at http://www.python.org/patches/.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	135
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	136 If you have a proposal to change Python, it's best to submit a Python
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	137 Enhancement Proposal (PEP) first. All current PEPs, as well as
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	138 guidelines for submitting a new PEP, are list at
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	139 http://python.sourceforge.net/peps/.
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	140
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	141
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	142 Questions
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	143 ---------
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	144
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	145 For help, if you can't find it in the manuals or on the web site, it's
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	146 best to post to the comp.lang.python or the Python mailing list (see
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	147 above). If you specifically don't want to involve the newsgroup or
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	148 mailing list, send questions to <help@python.org> (a group of
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	149 volunteers who answer questions as they can). The newsgroup is the
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	150 most efficient way to ask public questions.
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	151
13155 9919d65edc76 Tentative 2.0 and BeOpen upgrade. Guido van Rossum <guido@python.org> parents: 12374 diff changeset	152
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	153 Build instructions
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	154 ==================
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	155
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	156 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	157 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	158 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	159 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	160 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	161 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	162 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	163
15325 65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	164 Start by running the script "./configure", which determines your
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	165 system configuration and creates several Makefiles. (It takes a
15325 65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	166 minute or two -- please be patient!) You may want to pass options to
15344 e59f538bb829 Update build instructions to reflect the rename from Setup.in to Setup.dist. Fred Drake <fdrake@acm.org> parents: 15325 diff changeset	167 the configure script or edit the Modules/Setup file after running
e59f538bb829 Update build instructions to reflect the rename from Setup.in to Setup.dist. Fred Drake <fdrake@acm.org> parents: 15325 diff changeset	168 configure -- see the section below on configuration options and
e59f538bb829 Update build instructions to reflect the rename from Setup.in to Setup.dist. Fred Drake <fdrake@acm.org> parents: 15325 diff changeset	169 variables. When it's done, you are ready to run make.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	170
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	171 To build Python, you normally type "make" in the toplevel directory.
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	172 This will recursively run make in each of the subdirectories: Grammar,
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	173 Parser, Objects, Python and Modules, creating a library file in each
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	174 one (except Grammar). The interpreter executable is built in the top
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	175 level directory. If you want or need to, you can also chdir into each
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	176 subdirectory in turn and run make there manually (do the Modules
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	177 subdirectory last; you must use "make all sharedmods" to build the
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	178 dynamically loadable modules, if you have any).
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	179
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	180 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	181 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	182 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	183 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	184 the desired changes.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	185
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	186
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	187 Troubleshooting
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	188 ---------------
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	189
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	190 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	191
3698 97b1c2a70eae Some cleanups. Change of address. Guido van Rossum <guido@python.org> parents: 3399 diff changeset	192 If recursive makes fail, try invoking make as "make MAKE=make".
97b1c2a70eae Some cleanups. Change of address. Guido van Rossum <guido@python.org> parents: 3399 diff changeset	193
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	194 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	195 (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	196 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	197 and how to fix it.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	198
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	199 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	200 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	201 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	202 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	203
4134 69edc67e5a68 Updated for 1.4beta3 Guido van Rossum <guido@python.org> parents: 3922 diff changeset	204 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	205 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	206 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	207
b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	208 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	209 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	210 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	211 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	212 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	213 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	214 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	215 the OPT variable.
4134 69edc67e5a68 Updated for 1.4beta3 Guido van Rossum <guido@python.org> parents: 3922 diff changeset	216
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	217 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	218 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	219 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	220 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	221 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	222 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	223
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	224 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	225 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	226 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	227 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	228
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	229 Platform specific notes
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	230 -----------------------
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	231
3174 f7789945b8de release 1.3 for real Guido van Rossum <guido@python.org> parents: 3110 diff changeset	232 (Some of these may no longer apply. If you find you can build Python
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	233 on these platforms without the special directions mentioned here, mail
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	234 to <python@pythonlabs.com> so we can remove them!)
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	235
6448 b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	236 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	237 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	238 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	239 fix, let us know!)
6448 b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	240
5037 9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	241 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	242 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	243 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	244 the "CC" environment variable when running the configure
9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	245 script).
9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	246
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	247 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	248 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	249 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	250 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	251
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	252 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	253 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	254 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	255 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	256
11024 271af297aa3e Add warning FreeBSD users of a problem with curses and termcap, Guido van Rossum <guido@python.org> parents: 10862 diff changeset	257 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	258 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	259 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	260 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	261 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	262 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	263 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	264 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	265
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	266 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	267 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	268 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	269 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	270 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	271
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	272 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	273 --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	274 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	275 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	276 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	277 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	278
10565 104a441b2bc8 Add DEC Ultrix notes (from Donn Cave's email). Guido van Rossum <guido@python.org> parents: 10549 diff changeset	279 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	280 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	281
4134 69edc67e5a68 Updated for 1.4beta3 Guido van Rossum <guido@python.org> parents: 3922 diff changeset	282 AIX: A complete overhaul of the shared library support is now in
6494 17e3d9b6b42e AIX notes are simpler -- no need to enable sharedlibs with an edit. Guido van Rossum <guido@python.org> parents: 6448 diff changeset	283 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	284 (The optimizer bug reported at this place in previous releases
6e00fb723f69 Oh, well, various miscellaneous changes. Guido van Rossum <guido@python.org> parents: 7011 diff changeset	285 has been worked around by a minimal code change.)
11474 8b46ee325dc0 Hint for C++ users on AIX by Gary Duzan added. Guido van Rossum <guido@python.org> parents: 11024 diff changeset	286 In addition, Gary Duzan has a hint for C++ users: to enable
8b46ee325dc0 Hint for C++ users on AIX by Gary Duzan added. Guido van Rossum <guido@python.org> parents: 11024 diff changeset	287 full C++ module support, set CC="xlC" (or CC="xlC_r" for thread
8b46ee325dc0 Hint for C++ users on AIX by Gary Duzan added. Guido van Rossum <guido@python.org> parents: 11024 diff changeset	288 support in AIX 4.2.1).
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	289
10576 6e7f14af89b7 Add note about -D_REENTRANT for HP-UX 10.20. Guido van Rossum <guido@python.org> parents: 10572 diff changeset	290 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	291 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	292 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	293 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	294 even though config.h defines it.
8336 6b7095b98e54 Add pointer to Misc/HPUX-NOTES. Guido van Rossum <guido@python.org> parents: 8316 diff changeset	295
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	296 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	297
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	298 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	299 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	300
e2333969a2ca The usual edits... Updated some stuff about the mailing list. Ready Guido van Rossum <guido@python.org> parents: 7978 diff changeset	301 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	302 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	303 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	304 conditionally excluded when __STDC__ is defined.
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	305
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	306 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	307 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	308 needed be set to:
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	309
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	310 LIBS=' -lsocket -lcrypt_i'
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	311
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	312 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	313 '-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	314 Sunisms.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	315
4427 9c7ef030bec8 Changes in description of NeXT options. Fixed reference to newsgroup Guido van Rossum <guido@python.org> parents: 4152 diff changeset	316 NeXT: To build fat binaries, use the --with-next-archs switch
9c7ef030bec8 Changes in description of NeXT options. Fixed reference to newsgroup Guido van Rossum <guido@python.org> parents: 4152 diff changeset	317 described 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	318
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	319 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	320 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	321 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	322 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	323
8818 71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	324 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	325 ./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	326
15344 e59f538bb829 Update build instructions to reflect the rename from Setup.in to Setup.dist. Fred Drake <fdrake@acm.org> parents: 15325 diff changeset	327 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	328 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	329
8944 3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	330 array, audioop, binascii, cPickle, cStringIO, cmath,
3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	331 crypt, curses, errno, fcntl, gdbm, grp, imageop,
3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	332 _locale, math, md5, new, operator, parser, pcre,
3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	333 posix, pwd, readline, regex, reop, rgbimg, rotor,
3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	334 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	335 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	336
8818 71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	337 3) make SHELL=/usr/local/bin/bash
71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	338
71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	339 or, if you feel the need for speed:
71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	340
71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	341 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	342
71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	343 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	344
8944 3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	345 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	346 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	347
71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	348 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	349
8944 3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	350 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	351 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	352 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	353 little tight. To increase the stack size, edit the Makefile
3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	354 in the Modules directory to read: LDFLAGS = -N 48k
6018 f05546743406 Added QNX remarks. Guido van Rossum <guido@python.org> parents: 5951 diff changeset	355
8818 71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	356 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	357 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	358 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	359 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	360
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	361 Cray T3E: Konrad Hinsen writes:
8944 3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	362 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	363 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	364 fine.
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	365 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	366 crash the interpreter during the test suite).
3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	367 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	368 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	369 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	370
6132 94605b0026e7 Add warning about dumb SGI make. Guido van Rossum <guido@python.org> parents: 6122 diff changeset	371 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	372 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	373 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	374 it will redo the link step. The remedy is to use SGI's much
6448 b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	375 smarter "smake " utility (/usr/sbin/smake), or GNU make. If
b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	376 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	377 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	378
14927 c8f22f15499f Add a paragraph about an optimization bug in SGI compilers which affects Fred Drake <fdrake@acm.org> parents: 14920 diff changeset	379 There is a bug in the SGI compiler's optimization that causes a
c8f22f15499f Add a paragraph about an optimization bug in SGI compilers which affects Fred Drake <fdrake@acm.org> parents: 14920 diff changeset	380 bus error in PyComplex_ImagAsDouble(); this has been reported to
c8f22f15499f Add a paragraph about an optimization bug in SGI compilers which affects Fred Drake <fdrake@acm.org> parents: 14920 diff changeset	381 be triggered when importing Numeric Python and may be caused at
c8f22f15499f Add a paragraph about an optimization bug in SGI compilers which affects Fred Drake <fdrake@acm.org> parents: 14920 diff changeset	382 other times. The work-around is to build Python, delete the
c8f22f15499f Add a paragraph about an optimization bug in SGI compilers which affects Fred Drake <fdrake@acm.org> parents: 14920 diff changeset	383 Objects/complexobject.o file, and then recompile without
c8f22f15499f Add a paragraph about an optimization bug in SGI compilers which affects Fred Drake <fdrake@acm.org> parents: 14920 diff changeset	384 optimization (use "make OPT=").
c8f22f15499f Add a paragraph about an optimization bug in SGI compilers which affects Fred Drake <fdrake@acm.org> parents: 14920 diff changeset	385
6675 cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	386 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	387 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	388 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	389 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	390
15043 c0c254fbde57 Added section on threads problems on Reliant UNIX; this relates to Fred Drake <fdrake@acm.org> parents: 14927 diff changeset	391 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	392 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	393 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	394 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	395 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	396 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	397 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	398
c0c254fbde57 Added section on threads problems on Reliant UNIX; this relates to Fred Drake <fdrake@acm.org> parents: 14927 diff changeset	399 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	400 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	401 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	402 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	403
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	404
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	405 Configuring threads
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	406 -------------------
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	407
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	408 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	409 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	410 --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	411 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	412 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	413 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	414 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	415 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	416 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	417 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	418 -- 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	419
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	420 Compiler switches for threads
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	421 .............................
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	422
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	423 OS/Compiler/threads Switches for use with threads
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	424 (POSIX is draft 10, DCE is draft 4) (1) compile only (2) compile & link
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	425
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	426 SunOS 5.{1-5}/{gcc,SunPro cc}/solaris (1) -D_REENTRANT (2) -mt
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	427 SunOS 5.5/{gcc,SunPro cc}/POSIX (1) -D_REENTRANT
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	428 DEC OSF/1 3.x/cc/DCE (1) -D_REENTRANT (2) -threads
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	429 (butenhof@zko.dec.com)
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	430 Digital UNIX 4.x/cc/DCE (1) -D_REENTRANT (2) -threads
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	431 (butenhof@zko.dec.com)
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	432 Digital UNIX 4.x/cc/POSIX (1) -D_REENTRANT (2) -pthread
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	433 (butenhof@zko.dec.com)
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	434 AIX 4.1.4/cc_r/d7 (nothing)
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	435 (buhrt@iquest.net)
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	436 AIX 4.1.4/cc_r4/DCE (nothing)
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	437 (buhrt@iquest.net)
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	438 IRIX 6.2/cc/POSIX (nothing)
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	439 (robertl@cwi.nl)
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	440
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	441
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	442 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	443 ...........................................
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	444
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	445 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	446
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	447 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	448 SunOS 5.5/POSIX -lpthread
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	449 DEC OSF/1 3.x/DCE -lpthreads -lmach -lc_r -lc
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	450 (butenhof@zko.dec.com)
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	451 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	452 (butenhof@zko.dec.com)
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	453 Digital UNIX 4.x/POSIX -lpthread -lmach -lexc -lc
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	454 (butenhof@zko.dec.com)
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	455 AIX 4.1.4/{draft7,DCE} (nothing)
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	456 (buhrt@iquest.net)
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	457 IRIX 6.2/POSIX -lpthread
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	458 (jph@emilia.engr.sgi.com)
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	459
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	460
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	461 Configuring additional built-in modules
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	462 ---------------------------------------
2162 c9aea34ae4b6 add hint for NeXT users Guido van Rossum <guido@python.org> parents: 2131 diff changeset	463
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	464 You can configure the interpreter to contain fewer or more built-in
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	465 modules by editing the Modules/Setup file. This file is initially
15344 e59f538bb829 Update build instructions to reflect the rename from Setup.in to Setup.dist. Fred Drake <fdrake@acm.org> parents: 15325 diff changeset	466 copied from Setup.dist by the configure script; if it does not exist
e59f538bb829 Update build instructions to reflect the rename from Setup.in to Setup.dist. Fred Drake <fdrake@acm.org> parents: 15325 diff changeset	467 yet, create it by copying Modules/Setup.dist yourself (configure will
e59f538bb829 Update build instructions to reflect the rename from Setup.in to Setup.dist. Fred Drake <fdrake@acm.org> parents: 15325 diff changeset	468 never overwrite it). Never edit Setup.dist -- always edit Setup or
15325 65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	469 Setup.local (see below). Read the comments in the file for
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	470 information on what kind of edits are allowed. When you have edited
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	471 Setup in the Modules directory, the interpreter will automatically be
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	472 rebuilt the next time you run make in the toplevel directory. (When
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	473 working inside the Modules directory, use "make Makefile; make".)
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	474
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	475 The default collection of modules should build on any Unix system, but
14920 fad8247ef0a5 Update list of extension modules that may be interesting to enable on Fred Drake <fdrake@acm.org> parents: 14919 diff changeset	476 many optional modules should work on all modern Unices (e.g. try
fad8247ef0a5 Update list of extension modules that may be interesting to enable on Fred Drake <fdrake@acm.org> parents: 14919 diff changeset	477 audioop, imageop, crypt, dbm, gdbm, nis, resource, termios, timing,
fad8247ef0a5 Update list of extension modules that may be interesting to enable on Fred Drake <fdrake@acm.org> parents: 14919 diff changeset	478 syslog, _curses, pyexpat, readline, rgbimg, zlib). Often the quickest
fad8247ef0a5 Update list of extension modules that may be interesting to enable on Fred Drake <fdrake@acm.org> parents: 14919 diff changeset	479 way to determine whether a particular module works or not is to see if
fad8247ef0a5 Update list of extension modules that may be interesting to enable on Fred Drake <fdrake@acm.org> parents: 14919 diff changeset	480 it 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	481 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	482 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	483
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	484 On SGI IRIX, there are modules that interface to many SGI specific
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	485 system libraries, e.g. the GL library and the audio hardware.
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	486
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	487 For SunOS and Solaris, enable module "sunaudiodev" to support the
15325 65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	488 audio device. Likewise, for Linux and some *BSD systems, enable
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	489 "linuxaudiodev".
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	490
5037 9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	491 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	492 (the makesetup script processes both). You may find it more
9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	493 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	494 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	495 file.
9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	496
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	497
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	498 Setting the optimization/debugging options
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	499 ------------------------------------------
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	500
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	501 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	502 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	503 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	504 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	505 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	506 (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	507 set of libraries to link with).
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	508
15325 65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	509 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	510 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	511
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	512 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	513 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	514
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	515
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	516 Testing
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	517 -------
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	518
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	519 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	520 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	521 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	522 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	523 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	524 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	525 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	526 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	527 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	528 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	529 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	530
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	531 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	532 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	533 failing test manually, as follows:
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	534
5525 8582f74a1d23 Update description of "make test" to new test harness. Guido van Rossum <guido@python.org> parents: 5466 diff changeset	535 python ../Lib/test/test_whatever.py
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	536
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	537 (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	538 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	539
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	540
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	541 Installing
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	542 ----------
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	543
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	544 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	545 (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	546 just type
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	547
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	548 make install
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	549
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	550 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	551 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	552 `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	553 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	554 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	555 (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	556
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	557 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	558 name, e.g. the library modules are installed in
13155 9919d65edc76 Tentative 2.0 and BeOpen upgrade. Guido van Rossum <guido@python.org> parents: 12374 diff changeset	559 "/usr/local/lib/python2.0/" by default. The Python binary is
9919d65edc76 Tentative 2.0 and BeOpen upgrade. Guido van Rossum <guido@python.org> parents: 12374 diff changeset	560 installed as "python2.0" and a hard link named "python" is created.
6675 cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	561 The only file not installed with a version number in its name is the
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	562 manual page, installed as "/usr/local/man/man1/python.1" by default.
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	563
13155 9919d65edc76 Tentative 2.0 and BeOpen upgrade. Guido van Rossum <guido@python.org> parents: 12374 diff changeset	564 If you have a previous installation of a pre-2.0 Python that you don't
6675 cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	565 want to replace yet, use
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	566
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	567 make altinstall
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	568
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	569 This installs the same set of files as "make install" except it
13155 9919d65edc76 Tentative 2.0 and BeOpen upgrade. Guido van Rossum <guido@python.org> parents: 12374 diff changeset	570 doesn't create the hard link to "python2.0" named "python" and it
6675 cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	571 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	572
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	573 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	574 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	575 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	576 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	577
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	578
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	579 Configuration options and variables
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	580 -----------------------------------
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	581
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	582 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	583 script.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	584
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	585 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	586 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	587 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	588 Modules/getpath.o.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	589
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	590 --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	591 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	592 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	593 --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	594 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	595 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	596 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	597 option.
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	598
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	599 --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	600 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	601 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	602 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	603 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	604 --exec-prefix=DIRECTORY (as well) this overrides the
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	605 installation prefix for architecture-dependent files (like the
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	606 interpreter binary). Note that --prefix=DIRECTORY also
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	607 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	608 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	609 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	610 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	611 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	612 about the install prefix.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	613
5951 8d7dc66968cb --with-readline is obsolete (and some editorial stuff in README) Guido van Rossum <guido@python.org> parents: 5591 diff changeset	614 --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	615 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	616
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	617 --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	618 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	619 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	620 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	621 --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	622 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	623 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	624 --with-dec-threads instead.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	625
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	626 --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	627 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	628 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	629 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	630 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	631 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	632 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	633 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	634
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	635 --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	636 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	637 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	638 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	639 (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	640 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	641 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	642 ftp://ftp.cwi.nl/pub/dynload/dld-3.2.3.tar.Z). To
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	643 enable this, ftp and compile both libraries, then call
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	644 configure, passing it the option
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	645 --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	646 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	647 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	648 (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	649 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	650 deprecated.
2049 07cf3b3baf16 The usual changes when a release is nearing... Guido van Rossum <guido@python.org> parents: 2015 diff changeset	651
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	652 --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	653 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	654 (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	655 --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	656 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	657 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	658 --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	659 libraries, the C library last.
3850 d1cff49e3cc8 Various changes (not done yet even for beta2 release) Guido van Rossum <guido@python.org> parents: 3778 diff changeset	660
d1cff49e3cc8 Various changes (not done yet even for beta2 release) Guido van Rossum <guido@python.org> parents: 3778 diff changeset	661 --with-next-archs='arch1 arch2': Under NEXTSTEP, this will build
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	662 all compiled binaries with the architectures listed. This will
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	663 also correctly set the target architecture-specific resource
4427 9c7ef030bec8 Changes in description of NeXT options. Fixed reference to newsgroup Guido van Rossum <guido@python.org> parents: 4152 diff changeset	664 directory. (This option is not supported on other platforms.)
2049 07cf3b3baf16 The usual changes when a release is nearing... Guido van Rossum <guido@python.org> parents: 2015 diff changeset	665
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	666 --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	667 is linked against.
3893 958d4c67526b Added doc para for --with-libs Guido van Rossum <guido@python.org> parents: 3887 diff changeset	668
15546 bb93b1dca571 Document --with-cxx. Martin v. Löwis <martin@v.loewis.de> parents: 15344 diff changeset	669 --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	670 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	671 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	672 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	673 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	674 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	675 compilation of main() as a C++ program.
bb93b1dca571 Document --with-cxx. Martin v. Löwis <martin@v.loewis.de> parents: 15344 diff changeset	676
bb93b1dca571 Document --with-cxx. Martin v. Löwis <martin@v.loewis.de> parents: 15344 diff changeset	677
15325 65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	678 --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	679 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	680 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	681
2049 07cf3b3baf16 The usual changes when a release is nearing... Guido van Rossum <guido@python.org> parents: 2015 diff changeset	682
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	683 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	684 -------------------------------------------------------------
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	685
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	686 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	687 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	688 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	689 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	690 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	691 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	692 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	693 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	694 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	695 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	696
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	697 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	698 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	699 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	700
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	701 $ mkdir /usr/tmp/python
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	702 $ cd /usr/tmp/python
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	703 $ ~guido/src/python/configure
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	704 [...]
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	705 $ make
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	706 [...]
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	707 $
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	708
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	709 Note that Modules/Makefile copies the original Setup file to the build
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	710 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	711 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	712 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	713 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	714 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	715 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	716 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	717 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	718 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	719
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	720
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	721 Building on non-UNIX systems
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	722 ----------------------------
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	723
14673 df8d575d967d Updated Windows build info. Tim Peters <tim.peters@gmail.com> parents: 14429 diff changeset	724 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	725 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	726 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	727
10572 10bd2fb2a0d6 Clarify PC build instructions (point to PCbuild). Guido van Rossum <guido@python.org> parents: 10565 diff changeset	728 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	729 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	730
3922 e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	731 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	732 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	733 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	734 (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	735 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	736
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	737 Of course, there are also binary distributions available for these
14874 6431cf5c8a00 It's beta 2 now. Updated some stale URLs at pythonlabs.com. Guido van Rossum <guido@python.org> parents: 14673 diff changeset	738 platforms -- see http://www.pythonlabs.com/products/python2.0/.
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	739
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	740 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	741 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	742 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	743 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	744 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	745 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	746 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	747 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	748
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	749
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	750
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	751 Miscellaneous issues
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	752 ====================
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	753
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	754 Emacs mode
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	755 ----------
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	756
6448 b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	757 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	758 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	759 is now maintained by the equally famous Barry Warsaw (it's no
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	760 coincidence that they now both work at PythonLabs). The latest
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	761 version, along with various other contributed Python-related Emacs
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	762 goodies, is online at <http://www.python.org/emacs/python-mode>. And
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	763 if you are planning to edit the Python C code, please pick up the
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	764 latest version of CC Mode <http://www.python.org/emacs/cc-mode>; it
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	765 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	766 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	767 latest version of python-mode.)
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	768
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	769
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	770 The Tk interface
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	771 ----------------
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	772
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	773 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	774 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	775 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	776 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	777 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	778
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	779 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	780 the on-line manual pages.
6675 cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	781
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	782
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	783 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	784 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	785 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	786 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	787 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	788 (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	789
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	790 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	791 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	792
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	793 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	794 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	795 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	796
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	797 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	798 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	799 (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	800 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	801 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	802 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	803 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	804 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	805 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	806 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	807 ("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	808 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	809 or set $PYTHONPATH for the Python Tkinter module.)
3008 a51022f1980f 1.3b1 notes Guido van Rossum <guido@python.org> parents: 2730 diff changeset	810
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	811
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	812 Distribution structure
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	813 ----------------------
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	814
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	815 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	816 comments.
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	817
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	818 .cvsignore Additional filename matching patterns for CVS to ignore
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	819 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	820 Demo/ Demonstration scripts, modules and programs
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	821 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	822 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	823 Include/ Public header files
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	824 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	825 Lib/ Python library modules
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	826 Makefile.in Source from which config.status creates the Makefile
6448 b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	827 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	828 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	829 Objects/ Implementation of most built-in object types
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	830 PC/ Files specific to PC ports (DOS, Windows, OS/2)
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	831 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	832 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	833 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	834 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	835 Tools/ Some useful programs written in Python
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	836 acconfig.h Additional input for the GNU autoheader program
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	837 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	838 configure Configuration shell script (GNU autoconf output)
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	839 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	840 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	841
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	842 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	843 the configuration and build processes:
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	844
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	845 Makefile Build rules
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	846 buildno Keeps track of the build number
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	847 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	848 config.h Configuration header
6448 b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	849 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	850 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	851 getbuildinfo.o Object file from Modules/getbuildinfo.c
13155 9919d65edc76 Tentative 2.0 and BeOpen upgrade. Guido van Rossum <guido@python.org> parents: 12374 diff changeset	852 libpython2.0.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	853 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	854 tags, TAGS Tags files for vi and Emacs
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	855
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	856
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	857 That's all, folks!
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	858 ------------------
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	859
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	860
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	861 --Guido van Rossum (home page: http://www.pythonlabs.com/~guido/)

Mercurial > cpython-lru_cache-weakref

annotate README @ 15842:f6cd36498a50 legacy-trunk