cpython-lru_cache-weakref: README annotate

annotate README @ 27998:e27f58a50737 legacy-trunk

SF bug #690377: Dud footnote reference in distutils docs

author	Raymond Hettinger <python@rcn.com>
date	Fri, 21 Feb 2003 02:47:09 +0000
parents	387a4122cbd1
children	736bbdecaa1d

rev	line source
27982 387a4122cbd1 Update versions/dates for release of 2.3a2. Added some last-minute news. Guido van Rossum <guido@python.org> parents: 27619 diff changeset	1 This is Python version 2.3 alpha 2
26914 c25d7d2c1710 Various updates to the version number, on the eve of the 2.3a1 release. Guido van Rossum <guido@python.org> parents: 26716 diff changeset	2 ==================================
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	3
26914 c25d7d2c1710 Various updates to the version number, on the eve of the 2.3a1 release. Guido van Rossum <guido@python.org> parents: 26716 diff changeset	4 Copyright (c) 2001, 2002, 2003 Python Software Foundation.
15986 bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	5 All rights reserved.
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	6
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	7 Copyright (c) 2000 BeOpen.com.
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	8 All rights reserved.
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	9
17458 0d0546bd8448 Because this code was derived from Python 1.6.1 (amongst others), the Guido van Rossum <guido@python.org> parents: 17311 diff changeset	10 Copyright (c) 1995-2001 Corporation for National Research Initiatives.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	11 All rights reserved.
12374 f57af360b7e5 Add weasel-words about versioning, so I don't have to check in a new Guido van Rossum <guido@python.org> parents: 12205 diff changeset	12
14385 39ab28572307 Remove a comma from CWI's copyright notice. Guido van Rossum <guido@python.org> parents: 14367 diff changeset	13 Copyright (c) 1991-1995 Stichting Mathematisch Centrum.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	14 All rights reserved.
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	15
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	16
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	17 License information
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	18 -------------------
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	19
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	20 See the file "LICENSE" for information on the history of this
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	21 software, terms & conditions for usage, and a DISCLAIMER OF ALL
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	22 WARRANTIES.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	23
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	24 This Python distribution contains no GNU General Public Licensed
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	25 (GPLed) code so it may be used in proprietary projects just like prior
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	26 Python distributions. There are interfaces to some GNU code but these
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	27 are entirely optional.
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	28
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	29 All trademarks referenced herein are property of their respective
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	30 holders.
6837 96181a4a5482 Prepared the README for 1.5b2. Guido van Rossum <guido@python.org> parents: 6773 diff changeset	31
96181a4a5482 Prepared the README for 1.5b2. Guido van Rossum <guido@python.org> parents: 6773 diff changeset	32
3887 957f42ea0f84 Numerous changes, but still a lot of XXX thingies. Guido van Rossum <guido@python.org> parents: 3850 diff changeset	33 What's new in this release?
957f42ea0f84 Numerous changes, but still a lot of XXX thingies. Guido van Rossum <guido@python.org> parents: 3850 diff changeset	34 ---------------------------
3850 d1cff49e3cc8 Various changes (not done yet even for beta2 release) Guido van Rossum <guido@python.org> parents: 3778 diff changeset	35
15986 bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	36 See the file "Misc/NEWS".
6675 cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	37
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	38 If you don't read instructions
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	39 ------------------------------
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	40
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	41 Congratulations on getting this far. :-)
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	42
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	43 To start building right away (on UNIX): type "./configure" in the
21865 53fecc8dd4c9 Quick build: clarify that you have to do "make install" as root; OS Guido van Rossum <guido@python.org> parents: 21632 diff changeset	44 current directory and when it finishes, type "make". This creates an
53fecc8dd4c9 Quick build: clarify that you have to do "make install" as root; OS Guido van Rossum <guido@python.org> parents: 21632 diff changeset	45 executable "./python"; to install in /usr/local, first do "su root"
53fecc8dd4c9 Quick build: clarify that you have to do "make install" as root; OS Guido van Rossum <guido@python.org> parents: 21632 diff changeset	46 and then "make install".
53fecc8dd4c9 Quick build: clarify that you have to do "make install" as root; OS Guido van Rossum <guido@python.org> parents: 21632 diff changeset	47
21900 57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	48 The section `Build instructions' below is still recommended reading,
21865 53fecc8dd4c9 Quick build: clarify that you have to do "make install" as root; OS Guido van Rossum <guido@python.org> parents: 21632 diff changeset	49 especially the part on customizing Modules/Setup.
3850 d1cff49e3cc8 Various changes (not done yet even for beta2 release) Guido van Rossum <guido@python.org> parents: 3778 diff changeset	50
d1cff49e3cc8 Various changes (not done yet even for beta2 release) Guido van Rossum <guido@python.org> parents: 3778 diff changeset	51
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	52 What is Python anyway?
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	53 ----------------------
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	54
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	55 Python is an interpreted object-oriented programming language suitable
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	56 (amongst other uses) for distributed application development,
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	57 scripting, numeric computing and system testing. Python is often
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	58 compared to Tcl, Perl, Java, JavaScript, Visual Basic or Scheme. To
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	59 find out more about what Python can do for you, point your browser to
15986 bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	60 http://www.python.org/.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	61
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	62
4501 559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails. Guido van Rossum <guido@python.org> parents: 4427 diff changeset	63 How do I learn Python?
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails. Guido van Rossum <guido@python.org> parents: 4427 diff changeset	64 ----------------------
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails. Guido van Rossum <guido@python.org> parents: 4427 diff changeset	65
10862 4f5d4945605c Added "Learning Python" to the books section. Fred Drake <fdrake@acm.org> parents: 10587 diff changeset	66 The official tutorial is still a good place to start; see
12205 253cdeeaf42e Quick update to the README file. For intros and books we now point to Guido van Rossum <guido@python.org> parents: 11474 diff changeset	67 http://www.python.org/doc/ for online and downloadable versions, as
253cdeeaf42e Quick update to the README file. For intros and books we now point to Guido van Rossum <guido@python.org> parents: 11474 diff changeset	68 well as a list of other introductions, and reference documentation.
10862 4f5d4945605c Added "Learning Python" to the books section. Fred Drake <fdrake@acm.org> parents: 10587 diff changeset	69
12205 253cdeeaf42e Quick update to the README file. For intros and books we now point to Guido van Rossum <guido@python.org> parents: 11474 diff changeset	70 There's a quickly growing set of books on Python. See
253cdeeaf42e Quick update to the README file. For intros and books we now point to Guido van Rossum <guido@python.org> parents: 11474 diff changeset	71 http://www.python.org/psa/bookstore/ for a list.
5591 da475e107a68 Minor edits for 1.5a2 Guido van Rossum <guido@python.org> parents: 5525 diff changeset	72
4501 559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails. Guido van Rossum <guido@python.org> parents: 4427 diff changeset	73
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	74 Documentation
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	75 -------------
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	76
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	77 All documentation is provided online in a variety of formats. In
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	78 order of importance for new users: Tutorial, Library Reference,
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	79 Language Reference, Extending & Embedding, and the Python/C API. The
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	80 Library Reference is especially of immense value since much of
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	81 Python's power is described there, including the built-in data types
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	82 and functions!
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	83
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	84 All documentation is also available online at the Python web site
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	85 (http://www.python.org/doc/, see below). It is available online for
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	86 occasional reference, or can be downloaded in many formats for faster
15325 65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	87 access. The documentation is available in HTML, PostScript, PDF, and
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	88 LaTeX formats; the LaTeX version is primarily for documentation
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	89 authors, translators, and people with special formatting requirements.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	90
23962 111c1e59ad72 Random tweaks & updates. Michael W. Hudson <mwh@python.net> parents: 23867 diff changeset	91 The best documentation for the new (in Python 2.2) type/class
111c1e59ad72 Random tweaks & updates. Michael W. Hudson <mwh@python.net> parents: 23867 diff changeset	92 unification features is Guido's tutorial introduction, at
21414 f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	93
24164 78ab086a3548 Actualized descrintro.html URL. Guido van Rossum <guido@python.org> parents: 23962 diff changeset	94 http://www.python.org/2.2.1/descrintro.html
21414 f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	95
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	96
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	97 Web sites
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	98 ---------
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	99
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	100 New Python releases and related technologies are published at
15986 bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	101 http://www.python.org/. Come visit us!
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	102
23962 111c1e59ad72 Random tweaks & updates. Michael W. Hudson <mwh@python.net> parents: 23867 diff changeset	103 There's also a Python community web site at
111c1e59ad72 Random tweaks & updates. Michael W. Hudson <mwh@python.net> parents: 23867 diff changeset	104 http://starship.python.net/.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	105
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	106
f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	107 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	108 ----------------------------
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	109
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	110 Read comp.lang.python, a high-volume discussion newsgroup about
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	111 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	112 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	113 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	114 overview of the many Python-related mailing lists.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	115
23962 111c1e59ad72 Random tweaks & updates. Michael W. Hudson <mwh@python.net> parents: 23867 diff changeset	116 Archives are accessible via the Google Groups usenet archive; see
111c1e59ad72 Random tweaks & updates. Michael W. Hudson <mwh@python.net> parents: 23867 diff changeset	117 http://groups.google.com/. The mailing lists are also archived, see
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	118 http://www.python.org/psa/MailingLists.html for details.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	119
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	120
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	121 Bug reports
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	122 -----------
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	123
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	124 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	125 Tracker at http://sourceforge.net/bugs/?group_id=5470.
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	126
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	127
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	128 Patches and contributions
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	129 -------------------------
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	130
15325 65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	131 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	132 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	133 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	134
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	135 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	136 Enhancement Proposal (PEP) first. All current PEPs, as well as
27619 558d0f3b6254 Fix typos. Walter Dörwald <walter@livinglogic.de> parents: 27253 diff changeset	137 guidelines for submitting a new PEP, are listed at
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	138 http://python.sourceforge.net/peps/.
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	139
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	140
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	141 Questions
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	142 ---------
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	143
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	144 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	145 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	146 above). If you specifically don't want to involve the newsgroup or
15986 bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	147 mailing list, send questions to help@python.org (a group of volunteers
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	148 who answer questions as they can). The newsgroup is the most
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	149 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	150
13155 9919d65edc76 Tentative 2.0 and BeOpen upgrade. Guido van Rossum <guido@python.org> parents: 12374 diff changeset	151
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	152 Build instructions
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	153 ==================
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	154
21900 57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	155 Before you can build Python, you must first configure it.
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	156 Fortunately, the configuration and build process has been automated
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	157 for Unix and Linux installations, so all you usually have to do is
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	158 type a few commands and sit back. There are some platforms where
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	159 things are not quite as smooth; see the platform specific notes below.
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	160 If you want to build for multiple platforms sharing the same source
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	161 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	162
21900 57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	163 Start by running the script "./configure", which determines your
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	164 system configuration and creates the Makefile. (It takes a minute or
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	165 two -- please be patient!) You may want to pass options to the
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	166 configure script -- see the section below on configuration options and
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	167 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	168
21900 57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	169 To build Python, you normally type "make" in the toplevel directory.
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	170 If you have changed the configuration, the Makefile may have to be
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	171 rebuilt. In this case you may have to run make again to correctly
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	172 build your desired target. The interpreter executable is built in the
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	173 top level directory.
3922 e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	174
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	175 Once you have built a Python interpreter, see the subsections below on
21900 57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	176 testing and installation. If you run into trouble, see the next
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	177 section.
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	178
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	179 Previous versions of Python used a manual configuration process that
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	180 involved editing the file Modules/Setup. While this file still exists
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	181 and manual configuration is still supported, it is rarely needed any
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	182 more: almost all modules are automatically built as appropriate under
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	183 guidance of the setup.py script, which is run by Make after the
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	184 interpreter has been built.
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
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	192 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	193 (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	194 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	195 and how to fix it.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	196
3922 e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	197 If you rerun the configure script with different options, remove all
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	198 object files by running "make clean" before rebuilding. Believe it or
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	199 not, "make clean" sometimes helps to clean up other inexplicable
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	200 problems as well. Try it before sending in a bug report!
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	201
4134 69edc67e5a68 Updated for 1.4beta3 Guido van Rossum <guido@python.org> parents: 3922 diff changeset	202 If the configure script fails or doesn't seem to find things that
6448 b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	203 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	204 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	205
b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	206 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	207 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	208 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	209 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	210 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	211 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	212 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	213 the OPT variable.
4134 69edc67e5a68 Updated for 1.4beta3 Guido van Rossum <guido@python.org> parents: 3922 diff changeset	214
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	215 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	216 are probably experiencing compiler bugs, usually related to
26240 e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning Martin v. Löwis <martin@v.loewis.de> parents: 26154 diff changeset	217 optimization. This is a common problem with some versions of gcc, and
e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning Martin v. Löwis <martin@v.loewis.de> parents: 26154 diff changeset	218 some vendor-supplied compilers, which can sometimes be worked around
e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning Martin v. Löwis <martin@v.loewis.de> parents: 26154 diff changeset	219 by turning off optimization. Consider switching to stable versions
e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning Martin v. Löwis <martin@v.loewis.de> parents: 26154 diff changeset	220 (gcc 2.95.2, or contact your vendor.)
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	221
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	222 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	223 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	224 available for all modern systems, either in the form of updated
26240 e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning Martin v. Löwis <martin@v.loewis.de> parents: 26154 diff changeset	225 compilers from the vendor, or one of the free compilers (gcc).
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	226
26499 76f79bb36fc7 Add compile-time errors for unsupported systems. Martin v. Löwis <martin@v.loewis.de> parents: 26496 diff changeset	227 Unsupported systems
76f79bb36fc7 Add compile-time errors for unsupported systems. Martin v. Löwis <martin@v.loewis.de> parents: 26496 diff changeset	228 -------------------
76f79bb36fc7 Add compile-time errors for unsupported systems. Martin v. Löwis <martin@v.loewis.de> parents: 26496 diff changeset	229
76f79bb36fc7 Add compile-time errors for unsupported systems. Martin v. Löwis <martin@v.loewis.de> parents: 26496 diff changeset	230 A number of features are not supported in Python 2.3 anymore. Some
76f79bb36fc7 Add compile-time errors for unsupported systems. Martin v. Löwis <martin@v.loewis.de> parents: 26496 diff changeset	231 support code is still present, but will be removed in Python 2.4.
76f79bb36fc7 Add compile-time errors for unsupported systems. Martin v. Löwis <martin@v.loewis.de> parents: 26496 diff changeset	232 If you still need to use current Python versions on these systems,
76f79bb36fc7 Add compile-time errors for unsupported systems. Martin v. Löwis <martin@v.loewis.de> parents: 26496 diff changeset	233 please send a message to python-dev@python.org indicating that you
76f79bb36fc7 Add compile-time errors for unsupported systems. Martin v. Löwis <martin@v.loewis.de> parents: 26496 diff changeset	234 volunteer to support this system.
76f79bb36fc7 Add compile-time errors for unsupported systems. Martin v. Löwis <martin@v.loewis.de> parents: 26496 diff changeset	235
76f79bb36fc7 Add compile-time errors for unsupported systems. Martin v. Löwis <martin@v.loewis.de> parents: 26496 diff changeset	236 More specifically, the following systems are not supported any
76f79bb36fc7 Add compile-time errors for unsupported systems. Martin v. Löwis <martin@v.loewis.de> parents: 26496 diff changeset	237 longer:
76f79bb36fc7 Add compile-time errors for unsupported systems. Martin v. Löwis <martin@v.loewis.de> parents: 26496 diff changeset	238 - SunOS 4
76f79bb36fc7 Add compile-time errors for unsupported systems. Martin v. Löwis <martin@v.loewis.de> parents: 26496 diff changeset	239 - DYNIX
76f79bb36fc7 Add compile-time errors for unsupported systems. Martin v. Löwis <martin@v.loewis.de> parents: 26496 diff changeset	240 - dgux
76f79bb36fc7 Add compile-time errors for unsupported systems. Martin v. Löwis <martin@v.loewis.de> parents: 26496 diff changeset	241 - Minix
76f79bb36fc7 Add compile-time errors for unsupported systems. Martin v. Löwis <martin@v.loewis.de> parents: 26496 diff changeset	242 - Irix 4 and --with-sgi-dl
76f79bb36fc7 Add compile-time errors for unsupported systems. Martin v. Löwis <martin@v.loewis.de> parents: 26496 diff changeset	243 - Linux 1
76f79bb36fc7 Add compile-time errors for unsupported systems. Martin v. Löwis <martin@v.loewis.de> parents: 26496 diff changeset	244 - Systems defining __d6_pthread_create (configure.in)
76f79bb36fc7 Add compile-time errors for unsupported systems. Martin v. Löwis <martin@v.loewis.de> parents: 26496 diff changeset	245 - Systems defining PY_PTHREAD_D4, PY_PTHREAD_D6,
76f79bb36fc7 Add compile-time errors for unsupported systems. Martin v. Löwis <martin@v.loewis.de> parents: 26496 diff changeset	246 or PY_PTHREAD_D7 in thread_pthread.h
76f79bb36fc7 Add compile-time errors for unsupported systems. Martin v. Löwis <martin@v.loewis.de> parents: 26496 diff changeset	247 - Systems using --with-dl-dld
26716 a3600c4ecc8b Unsupport --without-universal-newlines. Martin v. Löwis <martin@v.loewis.de> parents: 26499 diff changeset	248 - Systems using --without-universal-newlines
26499 76f79bb36fc7 Add compile-time errors for unsupported systems. Martin v. Löwis <martin@v.loewis.de> parents: 26496 diff changeset	249
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	250 Platform specific notes
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	251 -----------------------
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	252
3174 f7789945b8de release 1.3 for real Guido van Rossum <guido@python.org> parents: 3110 diff changeset	253 (Some of these may no longer apply. If you find you can build Python
15986 bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	254 on these platforms without the special directions mentioned here,
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	255 submit a documentation bug report to SourceForge (see Bug Reports
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	256 above) so we can remove them!)
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	257
6448 b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	258 64-bit platforms: The modules audioop, imageop and rgbimg don't work.
21900 57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	259 The setup.py script disables them on 64-bit installations.
6448 b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	260 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	261 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	262 fix, let us know!)
6448 b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	263
5037 9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	264 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	265 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	266 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	267 the "CC" environment variable when running the configure
9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	268 script).
9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	269
25351 033adcbb4cb2 Warn about binutils 2.13 on Solaris. Guido van Rossum <guido@python.org> parents: 24547 diff changeset	270 When using GCC on Solaris, beware of binutils 2.13 or GCC
033adcbb4cb2 Warn about binutils 2.13 on Solaris. Guido van Rossum <guido@python.org> parents: 24547 diff changeset	271 versions built using it. This mistakenly enables the
033adcbb4cb2 Warn about binutils 2.13 on Solaris. Guido van Rossum <guido@python.org> parents: 24547 diff changeset	272 -zcombreloc option which creates broken shared libraries on
033adcbb4cb2 Warn about binutils 2.13 on Solaris. Guido van Rossum <guido@python.org> parents: 24547 diff changeset	273 Solaris. binutils 2.12 works, and the binutils maintainers
27053 9d08291cd411 qualify known Solaris versions related to the binutils breakage. Skip Montanaro <skip@pobox.com> parents: 27051 diff changeset	274 are aware of the problem. Binutils 2.13.1 only partially
9d08291cd411 qualify known Solaris versions related to the binutils breakage. Skip Montanaro <skip@pobox.com> parents: 27051 diff changeset	275 fixed things. It appears that 2.13.2 solves the problem
9d08291cd411 qualify known Solaris versions related to the binutils breakage. Skip Montanaro <skip@pobox.com> parents: 27051 diff changeset	276 completely. This problem is known to occur with Solaris 2.7
9d08291cd411 qualify known Solaris versions related to the binutils breakage. Skip Montanaro <skip@pobox.com> parents: 27051 diff changeset	277 and 2.8, but may also affect earlier and later versions of the
9d08291cd411 qualify known Solaris versions related to the binutils breakage. Skip Montanaro <skip@pobox.com> parents: 27051 diff changeset	278 OS.
25351 033adcbb4cb2 Warn about binutils 2.13 on Solaris. Guido van Rossum <guido@python.org> parents: 24547 diff changeset	279
26240 e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning Martin v. Löwis <martin@v.loewis.de> parents: 26154 diff changeset	280 When the dynamic loader complains about errors finding shared
e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning Martin v. Löwis <martin@v.loewis.de> parents: 26154 diff changeset	281 libraries, such as
e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning Martin v. Löwis <martin@v.loewis.de> parents: 26154 diff changeset	282
e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning Martin v. Löwis <martin@v.loewis.de> parents: 26154 diff changeset	283 ld.so.1: ./python: fatal: libstdc++.so.5: open failed:
e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning Martin v. Löwis <martin@v.loewis.de> parents: 26154 diff changeset	284 No such file or directory
e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning Martin v. Löwis <martin@v.loewis.de> parents: 26154 diff changeset	285
e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning Martin v. Löwis <martin@v.loewis.de> parents: 26154 diff changeset	286 you need to first make sure that the library is available on
e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning Martin v. Löwis <martin@v.loewis.de> parents: 26154 diff changeset	287 your system. Then, you need to instruct the dynamic loader how
27619 558d0f3b6254 Fix typos. Walter Dörwald <walter@livinglogic.de> parents: 27253 diff changeset	288 to find it. You can choose any of the following strategies:
26240 e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning Martin v. Löwis <martin@v.loewis.de> parents: 26154 diff changeset	289
e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning Martin v. Löwis <martin@v.loewis.de> parents: 26154 diff changeset	290 1. When compiling Python, set LD_RUN_PATH to the directories
e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning Martin v. Löwis <martin@v.loewis.de> parents: 26154 diff changeset	291 containing missing libraries.
e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning Martin v. Löwis <martin@v.loewis.de> parents: 26154 diff changeset	292 2. When running Python, set LD_LIBRARY_PATH to these directories.
e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning Martin v. Löwis <martin@v.loewis.de> parents: 26154 diff changeset	293 3. Use crle(8) to extend the search path of the loader.
e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning Martin v. Löwis <martin@v.loewis.de> parents: 26154 diff changeset	294 4. Modify the installed GCC specs file, adding -R options into the
e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning Martin v. Löwis <martin@v.loewis.de> parents: 26154 diff changeset	295 *link: section.
e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning Martin v. Löwis <martin@v.loewis.de> parents: 26154 diff changeset	296
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	297 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	298 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	299 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	300 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	301
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	302 Under Linux systems using GNU libc 2 (aka libc6), the crypt
21900 57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	303 module now needs the -lcrypt option. The setup.py script
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	304 takes care of this automatically.
6773 14d6b7a42919 For RedHat Linux 5.0, added notes about needing to remove the LinuxThreads Fred Drake <fdrake@acm.org> parents: 6710 diff changeset	305
21865 53fecc8dd4c9 Quick build: clarify that you have to do "make install" as root; OS Guido van Rossum <guido@python.org> parents: 21632 diff changeset	306 Red Hat Linux: There's an executable /usr/bin/python which is Python
53fecc8dd4c9 Quick build: clarify that you have to do "make install" as root; OS Guido van Rossum <guido@python.org> parents: 21632 diff changeset	307 1.5.2 on most Red Hat installations; several key Red Hat tools
53fecc8dd4c9 Quick build: clarify that you have to do "make install" as root; OS Guido van Rossum <guido@python.org> parents: 21632 diff changeset	308 require this version. Python 2.1.x may be installed as
53fecc8dd4c9 Quick build: clarify that you have to do "make install" as root; OS Guido van Rossum <guido@python.org> parents: 21632 diff changeset	309 /usr/bin/python2. The Makefile installs Python as
53fecc8dd4c9 Quick build: clarify that you have to do "make install" as root; OS Guido van Rossum <guido@python.org> parents: 21632 diff changeset	310 /usr/local/bin/python, which may or may not take precedence
53fecc8dd4c9 Quick build: clarify that you have to do "make install" as root; OS Guido van Rossum <guido@python.org> parents: 21632 diff changeset	311 over /usr/bin/python, depending on how you have set up $PATH.
53fecc8dd4c9 Quick build: clarify that you have to do "make install" as root; OS Guido van Rossum <guido@python.org> parents: 21632 diff changeset	312
11024 271af297aa3e Add warning FreeBSD users of a problem with curses and termcap, Guido van Rossum <guido@python.org> parents: 10862 diff changeset	313 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	314 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	315 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	316 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	317 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	318 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	319 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	320 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	321
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	322 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	323 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	324 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	325 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	326 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	327
4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	328 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	329 --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	330 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	331 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	332 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	333 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	334
10565 104a441b2bc8 Add DEC Ultrix notes (from Donn Cave's email). Guido van Rossum <guido@python.org> parents: 10549 diff changeset	335 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	336 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	337
4134 69edc67e5a68 Updated for 1.4beta3 Guido van Rossum <guido@python.org> parents: 3922 diff changeset	338 AIX: A complete overhaul of the shared library support is now in
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	339 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	340 (The optimizer bug reported at this place in previous releases
16608 f425d8523480 Rewrite AIX blurb to make clear threads are the default, and add note about Thomas Wouters <thomas@python.org> parents: 16390 diff changeset	341 has been worked around by a minimal code change.) If you get
23415 211b16ac066a Fix typo: ptread --> pthread Fred Drake <fdrake@acm.org> parents: 23240 diff changeset	342 errors about pthread_* functions, during compile or during
16608 f425d8523480 Rewrite AIX blurb to make clear threads are the default, and add note about Thomas Wouters <thomas@python.org> parents: 16390 diff changeset	343 testing, try setting CC to a thread-safe (reentrant) compiler,
f425d8523480 Rewrite AIX blurb to make clear threads are the default, and add note about Thomas Wouters <thomas@python.org> parents: 16390 diff changeset	344 like "cc_r". For full C++ module support, set CC="xlC_r" (or
f425d8523480 Rewrite AIX blurb to make clear threads are the default, and add note about Thomas Wouters <thomas@python.org> parents: 16390 diff changeset	345 CC="xlC" without thread support).
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	346
27118 eb9353b43cd1 delete reference to defunct Misc/HPUX-NOTES. Adjust reference for BeOS Skip Montanaro <skip@pobox.com> parents: 27077 diff changeset	347 HP-UX: 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	348 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	349 this seems to make a difference (at least for HP-UX 10.20)
26023 9b47386ba5b8 Update config.h to pyconfig.h. Fred Drake <fdrake@acm.org> parents: 25783 diff changeset	350 even though pyconfig.h defines it.
8336 6b7095b98e54 Add pointer to Misc/HPUX-NOTES. Guido van Rossum <guido@python.org> parents: 8316 diff changeset	351
23240 76c45037113f Add warning about the HP PA-RISC 2.0 C compiler's optimizer. Guido van Rossum <guido@python.org> parents: 23029 diff changeset	352 HP PA-RISC 2.0: A recent bug report (http://www.python.org/sf/546117)
76c45037113f Add warning about the HP PA-RISC 2.0 C compiler's optimizer. Guido van Rossum <guido@python.org> parents: 23029 diff changeset	353 suggests that the C compiler in this 64-bit system has bugs
76c45037113f Add warning about the HP PA-RISC 2.0 C compiler's optimizer. Guido van Rossum <guido@python.org> parents: 23029 diff changeset	354 in the optimizer that break Python. Compiling without
76c45037113f Add warning about the HP PA-RISC 2.0 C compiler's optimizer. Guido van Rossum <guido@python.org> parents: 23029 diff changeset	355 optimization solves the problems.
76c45037113f Add warning about the HP PA-RISC 2.0 C compiler's optimizer. Guido van Rossum <guido@python.org> parents: 23029 diff changeset	356
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	357 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	358 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	359
e2333969a2ca The usual edits... Updated some stuff about the mailing list. Ready Guido van Rossum <guido@python.org> parents: 7978 diff changeset	360 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	361 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	362 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	363 conditionally excluded when __STDC__ is defined.
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	364
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	365 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	366 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	367 needed be set to:
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	368
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	369 LIBS=' -lsocket -lcrypt_i'
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	370
19758 64bcef1702ad Revert parts of patch #453627, documenting the resulting test failures Martin v. Löwis <martin@v.loewis.de> parents: 19381 diff changeset	371 UnixWare: There are known bugs in the math library of the system, as well as
64bcef1702ad Revert parts of patch #453627, documenting the resulting test failures Martin v. Löwis <martin@v.loewis.de> parents: 19381 diff changeset	372 problems in the handling of threads (calling fork in one
64bcef1702ad Revert parts of patch #453627, documenting the resulting test failures Martin v. Löwis <martin@v.loewis.de> parents: 19381 diff changeset	373 thread may interrupt system calls in others). Therefore, test_math and
64bcef1702ad Revert parts of patch #453627, documenting the resulting test failures Martin v. Löwis <martin@v.loewis.de> parents: 19381 diff changeset	374 tests involving threads will fail until those problems are fixed.
64bcef1702ad Revert parts of patch #453627, documenting the resulting test failures Martin v. Löwis <martin@v.loewis.de> parents: 19381 diff changeset	375
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	376 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	377 '-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	378 Sunisms.
26499 76f79bb36fc7 Add compile-time errors for unsupported systems. Martin v. Löwis <martin@v.loewis.de> parents: 26496 diff changeset	379 THIS SYSTEM IS NO LONGER SUPPORTED.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	380
19381 60d5cbbeadc3 Removed NeXT notes (replacing them with a line saying NeXT is no Jack Jansen <jack.jansen@cwi.nl> parents: 17734 diff changeset	381 NeXT: Not supported anymore. Start with the MacOSX/Darwin code if you
60d5cbbeadc3 Removed NeXT notes (replacing them with a line saying NeXT is no Jack Jansen <jack.jansen@cwi.nl> parents: 17734 diff changeset	382 want to revive it.
3922 e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	383
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	384 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	385 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	386 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	387 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	388
8818 71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	389 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	390 ./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	391
15344 e59f538bb829 Update build instructions to reflect the rename from Setup.in to Setup.dist. Fred Drake <fdrake@acm.org> parents: 15325 diff changeset	392 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	393 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	394
8944 3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	395 array, audioop, binascii, cPickle, cStringIO, cmath,
3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	396 crypt, curses, errno, fcntl, gdbm, grp, imageop,
3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	397 _locale, math, md5, new, operator, parser, pcre,
3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	398 posix, pwd, readline, regex, reop, rgbimg, rotor,
3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	399 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	400 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	401
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	402 3) make SHELL=/usr/local/bin/bash
4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	403
8818 71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	404 or, if you feel the need for speed:
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	405
8818 71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	406 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	407
71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	408 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	409
8944 3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	410 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	411 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	412
71fcc4ca0e8a Changes for BeOS, QNX and long long, by Chris Herborth. Guido van Rossum <guido@python.org> parents: 8603 diff changeset	413 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	414
8944 3b0291655e31 Prepping for 1.5.2a1 release... Guido van Rossum <guido@python.org> parents: 8818 diff changeset	415 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	416 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	417 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	418 little tight. To increase the stack size, edit the Makefile
16288 c0a2441a4454 - Edit the QNX instructions to refer to Makefile, not Modules/Makefile. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 16229 diff changeset	419 to read: LDFLAGS = -N 48k
6018 f05546743406 Added QNX remarks. Guido van Rossum <guido@python.org> parents: 5951 diff changeset	420
27118 eb9353b43cd1 delete reference to defunct Misc/HPUX-NOTES. Adjust reference for BeOS Skip Montanaro <skip@pobox.com> parents: 27077 diff changeset	421 BeOS: See Misc/BeOS-NOTES for notes about compiling/installing
eb9353b43cd1 delete reference to defunct Misc/HPUX-NOTES. Adjust reference for BeOS Skip Montanaro <skip@pobox.com> parents: 27077 diff changeset	422 Python on BeOS R3 or later. Note that only the PowerPC
eb9353b43cd1 delete reference to defunct Misc/HPUX-NOTES. Adjust reference for BeOS Skip Montanaro <skip@pobox.com> parents: 27077 diff changeset	423 platform is supported for R3; both PowerPC and x86 are
eb9353b43cd1 delete reference to defunct Misc/HPUX-NOTES. Adjust reference for BeOS Skip Montanaro <skip@pobox.com> parents: 27077 diff changeset	424 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	425
24445 c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	426 Cray T3E: Mark Hadfield (m.hadfield@niwa.co.nz) writes:
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	427 Python can be built satisfactorily on a Cray T3E but based on
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	428 my experience with the NIWA T3E (2002-05-22, version 2.2.1)
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	429 there are a few bugs and gotchas. For more information see a
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	430 thread on comp.lang.python in May 2002 entitled "Building
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	431 Python on Cray T3E".
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	432
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	433 1) Use Cray's cc and not gcc. The latter was reported not to
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	434 work by Konrad Hinsen. It may work now, but it may not.
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	435
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	436 2) To set sys.platform to something sensible, pass the
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	437 following environment variable to the configure script:
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	438
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	439 MACHDEP=unicosmk
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	440
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	441 2) Run configure with option "--enable-unicode=ucs4".
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	442
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	443 3) The Cray T3E does not support dynamic linking, so extension
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	444 modules have to be built by adding (or uncommenting) lines
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	445 in Modules/Setup. The minimum set of modules is
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	446
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	447 posix, new, _sre, unicodedata
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	448
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	449 On NIWA's vanilla T3E system the following have also been
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	450 included successfully:
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	451
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	452 _codecs, _locale, _socket, _symtable, _testcapi, _weakref
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	453 array, binascii, cmath, cPickle, crypt, cStringIO, dbm
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	454 errno, fcntl, grp, math, md5, operator, parser, pcre, pwd
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	455 regex, rotor, select, struct, strop, syslog, termios
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	456 time, timing, xreadlines
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	457
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	458 4) Once the python executable and library have been built, make
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	459 will execute setup.py, which will attempt to build remaining
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	460 extensions and link them dynamically. Each of these attempts
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	461 will fail but should not halt the make process. This is
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	462 normal.
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	463
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	464 5) Running "make test" uses a lot of resources and causes
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	465 problems on our system. You might want to try running tests
c3d9e01c6124 Patch: Michael W. Hudson <mwh@python.net> parents: 24164 diff changeset	466 singly or in small groups.
6122 db8ac6e109b4 Got rid of HP-UX comments (which seem to be out of date -- one should Guido van Rossum <guido@python.org> parents: 6077 diff changeset	467
6132 94605b0026e7 Add warning about dumb SGI make. Guido van Rossum <guido@python.org> parents: 6122 diff changeset	468 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	469 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	470 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	471 it will redo the link step. The remedy is to use SGI's much
17512 76fae614526c Add more general warning against the SGI optimizer. Guido van Rossum <guido@python.org> parents: 17458 diff changeset	472 smarter "smake" utility (/usr/sbin/smake), or GNU make. If
6448 b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	473 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	474 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	475
17512 76fae614526c Add more general warning against the SGI optimizer. Guido van Rossum <guido@python.org> parents: 17458 diff changeset	476 WARNING: There are bugs in the optimizer of some versions of
76fae614526c Add more general warning against the SGI optimizer. Guido van Rossum <guido@python.org> parents: 17458 diff changeset	477 SGI's compilers that can cause bus errors or other strange
76fae614526c Add more general warning against the SGI optimizer. Guido van Rossum <guido@python.org> parents: 17458 diff changeset	478 behavior, especially on numerical operations. To avoid this,
76fae614526c Add more general warning against the SGI optimizer. Guido van Rossum <guido@python.org> parents: 17458 diff changeset	479 try building with "make OPT=".
14927 c8f22f15499f Add a paragraph about an optimization bug in SGI compilers which affects Fred Drake <fdrake@acm.org> parents: 14920 diff changeset	480
6675 cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	481 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	482 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	483 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	484 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	485
15043 c0c254fbde57 Added section on threads problems on Reliant UNIX; this relates to Fred Drake <fdrake@acm.org> parents: 14927 diff changeset	486 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	487 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	488 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	489 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	490 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	491 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	492 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	493
c0c254fbde57 Added section on threads problems on Reliant UNIX; this relates to Fred Drake <fdrake@acm.org> parents: 14927 diff changeset	494 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	495 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	496 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	497 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	498
25781 cc41b9cacae8 There was a typo in the MacOSX section regarding the stacksize issue. Barry Warsaw <barry@python.org> parents: 25351 diff changeset	499 MacOSX: The tests will crash on both 10.1 and 10.2 with SEGV in
25783 2ef71f351c74 I'd forgotten that tcsh was the default for 10.1, but SF's 10.1 system Barry Warsaw <barry@python.org> parents: 25781 diff changeset	500 test_re and test_sre due to the small default stack size. If
2ef71f351c74 I'd forgotten that tcsh was the default for 10.1, but SF's 10.1 system Barry Warsaw <barry@python.org> parents: 25781 diff changeset	501 you set the stack size to 2048 before doing a "make test" the
2ef71f351c74 I'd forgotten that tcsh was the default for 10.1, but SF's 10.1 system Barry Warsaw <barry@python.org> parents: 25781 diff changeset	502 failure can be avoided. If you're using the tcsh (the default
2ef71f351c74 I'd forgotten that tcsh was the default for 10.1, but SF's 10.1 system Barry Warsaw <barry@python.org> parents: 25781 diff changeset	503 on OSX), or csh shells use "limit stacksize 2048" and for the
2ef71f351c74 I'd forgotten that tcsh was the default for 10.1, but SF's 10.1 system Barry Warsaw <barry@python.org> parents: 25781 diff changeset	504 bash shell, use "ulimit -s 2048".
21414 f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	505
21273 ecbbeccde07d Cleaned up Mac OS X section to the current state of affairs. Jack Jansen <jack.jansen@cwi.nl> parents: 20959 diff changeset	506 On naked Darwin you may want to add the configure option
20314 284eabe3b552 Mac OS X build instructions talked about --without-toolbox-glue, but Jack Jansen <jack.jansen@cwi.nl> parents: 20270 diff changeset	507 "--disable-toolbox-glue" to disable the glue code for the Carbon
21273 ecbbeccde07d Cleaned up Mac OS X section to the current state of affairs. Jack Jansen <jack.jansen@cwi.nl> parents: 20959 diff changeset	508 interface modules. The modules themselves are currently only built
ecbbeccde07d Cleaned up Mac OS X section to the current state of affairs. Jack Jansen <jack.jansen@cwi.nl> parents: 20959 diff changeset	509 if you add the --enable-framework option, see below.
21414 f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	510
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	511 On a clean OSX /usr/local does not exist. Do a
21632 5861885577e9 Rephrased the OSX stack limit problem, after a complaint about it. Jack Jansen <jack.jansen@cwi.nl> parents: 21495 diff changeset	512 "sudo mkdir -m 775 /usr/local"
24547 4f00134b561d Changes to the OSX section: Jack Jansen <jack.jansen@cwi.nl> parents: 24525 diff changeset	513 before you do a make install. It is probably not a good idea to
4f00134b561d Changes to the OSX section: Jack Jansen <jack.jansen@cwi.nl> parents: 24525 diff changeset	514 do "sudo make install" which installs everything as superuser,
4f00134b561d Changes to the OSX section: Jack Jansen <jack.jansen@cwi.nl> parents: 24525 diff changeset	515 as this may later cause problems when installing distutils-based
4f00134b561d Changes to the OSX section: Jack Jansen <jack.jansen@cwi.nl> parents: 24525 diff changeset	516 additions.
4f00134b561d Changes to the OSX section: Jack Jansen <jack.jansen@cwi.nl> parents: 24525 diff changeset	517
4f00134b561d Changes to the OSX section: Jack Jansen <jack.jansen@cwi.nl> parents: 24525 diff changeset	518 Some people have reported problems building Python after using "fink"
4f00134b561d Changes to the OSX section: Jack Jansen <jack.jansen@cwi.nl> parents: 24525 diff changeset	519 to install additional unix software. Disabling fink (remove all references
4f00134b561d Changes to the OSX section: Jack Jansen <jack.jansen@cwi.nl> parents: 24525 diff changeset	520 to /sw from your .profile or .login) should solve this.
21414 f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	521
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	522 You may want to try the configure option "--enable-framework"
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	523 which installs Python as a framework. The location can be set
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	524 as argument to the --enable-framework option (default
24547 4f00134b561d Changes to the OSX section: Jack Jansen <jack.jansen@cwi.nl> parents: 24525 diff changeset	525 /Library/Frameworks). A framework install is probably needed if you
4f00134b561d Changes to the OSX section: Jack Jansen <jack.jansen@cwi.nl> parents: 24525 diff changeset	526 want to use any Aqua-based GUI toolkit (whether Tkinter, wxPython,
4f00134b561d Changes to the OSX section: Jack Jansen <jack.jansen@cwi.nl> parents: 24525 diff changeset	527 Carbon, Cocoa or anything else).
4f00134b561d Changes to the OSX section: Jack Jansen <jack.jansen@cwi.nl> parents: 24525 diff changeset	528
4f00134b561d Changes to the OSX section: Jack Jansen <jack.jansen@cwi.nl> parents: 24525 diff changeset	529 See Mac/OSX/README for more information on framework builds.
16390 d34f25046ad4 Added note about need for -traditional-cpp on the MacOS X Public Beta. Fred Drake <fdrake@acm.org> parents: 16288 diff changeset	530
21491 ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	531 Cygwin: With recent (relative to the time of writing, 2001-12-19)
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	532 Cygwin installations, there are problems with the interaction
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	533 of dynamic linking and fork(). This manifests itself in build
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	534 failures during the execution of setup.py.
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	535
21491 ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	536 There are two workarounds that both enable Python (albeit
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	537 without threading support) to build and pass all tests on
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	538 NT/2000 (and most likely XP as well, though reports of testing
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	539 on XP would be appreciated).
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	540
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	541 The workarounds:
17311 b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	542
21491 ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	543 (a) the band-aid fix is to link the _socket module statically
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	544 rather than dynamically (which is the default).
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	545
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	546 To do this, run "./configure --with-threads=no" including any
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	547 other options you need (--prefix, etc.). Then in Modules/Setup
27619 558d0f3b6254 Fix typos. Walter Dörwald <walter@livinglogic.de> parents: 27253 diff changeset	548 uncomment the lines:
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	549
21367 8a89ff1e0662 This is what Jason Tishler and I believe to be the state of play on Cygwin Michael W. Hudson <mwh@python.net> parents: 21273 diff changeset	550 #SSL=/usr/local/ssl
8a89ff1e0662 This is what Jason Tishler and I believe to be the state of play on Cygwin Michael W. Hudson <mwh@python.net> parents: 21273 diff changeset	551 #_socket socketmodule.c \
8a89ff1e0662 This is what Jason Tishler and I believe to be the state of play on Cygwin Michael W. Hudson <mwh@python.net> parents: 21273 diff changeset	552 # -DUSE_SSL -I$(SSL)/include -I$(SSL)/include/openssl \
8a89ff1e0662 This is what Jason Tishler and I believe to be the state of play on Cygwin Michael W. Hudson <mwh@python.net> parents: 21273 diff changeset	553 # -L$(SSL)/lib -lssl -lcrypto
17311 b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	554
21491 ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	555 and remove "local/" from the SSL variable. Finally, just run
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	556 "make"!
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	557
21495 2474414d4342 Apparently it's Cygwin with a capital C. Michael W. Hudson <mwh@python.net> parents: 21493 diff changeset	558 (b) The "proper" fix is to rebase the Cygwin DLLs to prevent
21491 ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	559 base address conflicts. Details on how to do this can be
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	560 found in the following mail:
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	561
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	562 http://sources.redhat.com/ml/cygwin/2001-12/msg00894.html
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	563
21491 ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	564 It is hoped that a version of this solution will be
21495 2474414d4342 Apparently it's Cygwin with a capital C. Michael W. Hudson <mwh@python.net> parents: 21493 diff changeset	565 incorporated into the Cygwin distribution fairly soon.
21491 ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	566
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	567 Two additional problems:
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	568
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	569 (1) Threading support should still be disabled due to a known
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	570 bug in Cygwin pthreads that causes test_threadedtempfile to
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	571 hang.
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	572
21493 162106b16e44 Fix a typo Neal Norwitz <nnorwitz@gmail.com> parents: 21491 diff changeset	573 (2) The _curses module does not build. This is a known
21491 ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	574 Cygwin ncurses problem that should be resolved the next time
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	575 that this package is released.
17311 b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	576
21367 8a89ff1e0662 This is what Jason Tishler and I believe to be the state of play on Cygwin Michael W. Hudson <mwh@python.net> parents: 21273 diff changeset	577 On older versions of Cygwin, test_poll may hang and test_strftime
8a89ff1e0662 This is what Jason Tishler and I believe to be the state of play on Cygwin Michael W. Hudson <mwh@python.net> parents: 21273 diff changeset	578 may fail.
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	579
21491 ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	580 The situation on 9X/Me is not accurately known at present.
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	581 Some time ago, there were reports that the following
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	582 regression tests failed:
17311 b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	583
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	584 test_pwd
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	585 test_select (hang)
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	586 test_socket
b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	587
21491 ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	588 Due to the test_select hang on 9X/Me, one should run the
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	589 regression test using the following:
17311 b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	590
21367 8a89ff1e0662 This is what Jason Tishler and I believe to be the state of play on Cygwin Michael W. Hudson <mwh@python.net> parents: 21273 diff changeset	591 make TESTOPTS='-l -x test_select' test
17311 b0a7faf98a8e SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler. Tim Peters <tim.peters@gmail.com> parents: 17210 diff changeset	592
21491 ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	593 News regarding these platforms with more recent Cygwin
ca450e4dff9a More cygwin news. This section is getting a bit long. Oh well. Michael W. Hudson <mwh@python.net> parents: 21414 diff changeset	594 versions would be appreciated!
3922 e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	595
27077 c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	596 AtheOS: From Octavian Cerna <tavy at ylabs.com>:
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	597
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	598 Before building:
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	599
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	600 Make sure you have shared versions of the libraries you
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	601 want to use with Python. You will have to compile them
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	602 yourself, or download precompiled packages.
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	603
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	604 Recommended libraries:
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	605
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	606 ncurses-4.2
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	607 readline-4.2a
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	608 zlib-1.1.4
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	609
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	610 Build:
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	611
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	612 $ ./configure --prefix=/usr/python
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	613 $ make
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	614
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	615 Python is always built as a shared library, otherwise
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	616 dynamic loading would not work.
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	617
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	618 Testing:
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	619
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	620 $ make test
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	621
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	622 Install:
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	623
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	624 # make install
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	625 # pkgmanager -a /usr/python
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	626
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	627
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	628 AtheOS issues:
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	629
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	630 - large file support: due to a stdio bug in glibc/libio,
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	631 access to large files may not work correctly. fseeko()
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	632 tries to seek to a negative offset. ftello() returns a
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	633 negative offset, it looks like a 32->64bit
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	634 sign-extension issue. The lowlevel functions (open,
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	635 lseek, etc) are OK.
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	636 - sockets: AF_UNIX is defined in the C library and in
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	637 Python, but not implemented in the system.
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	638 - select: poll is available in the C library, but does not
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	639 work (It does not return POLLNVAL for bad fds and
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	640 hangs).
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	641 - posix: statvfs and fstatvfs always return ENOSYS.
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	642 - disabled modules:
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	643 - mmap: not yet implemented in AtheOS
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	644 - nis: broken (on an unconfigured system
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	645 yp_get_default_domain() returns junk instead of
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	646 error)
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	647 - dl: dynamic loading doesn't work via dlopen()
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	648 - resource: getrimit and setrlimit are not yet
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	649 implemented
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	650
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	651 - if you are getting segmentation faults, you probably are
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	652 low on memory. AtheOS doesn't handle very well an
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	653 out-of-memory condition and simply SEGVs the process.
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	654
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	655 Tested on:
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	656
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	657 AtheOS-0.3.7
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	658 gcc-2.95
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	659 binutils-2.10
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	660 make-3.78
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	661
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	662
23867 45d676933882 This introduces stricter library/header file checking for the Berkeley DB Skip Montanaro <skip@pobox.com> parents: 23415 diff changeset	663 Configuring the bsddb and dbm modules
45d676933882 This introduces stricter library/header file checking for the Berkeley DB Skip Montanaro <skip@pobox.com> parents: 23415 diff changeset	664 -------------------------------------
45d676933882 This introduces stricter library/header file checking for the Berkeley DB Skip Montanaro <skip@pobox.com> parents: 23415 diff changeset	665
27077 c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	666 Beginning with Python version 2.3, the PyBsddb package
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	667 <http://pybsddb.sf.net/> was adopted into Python as the bsddb package,
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	668 exposing a set of package-level functions which provide
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	669 backwards-compatible behavior. Only versions 3.1 through 4.1 of
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	670 Sleepycat's libraries provide the necessary API, so older versions
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	671 aren't supported through this interface. The old bsddb module has
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	672 been retained as bsddb185, though it is not built by default. Users
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	673 wishing to use it will have to tweak Modules/Setup to build it. The
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	674 dbm module will still be built against the Sleepycat libraries if
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	675 other preferred alternatives (ndbm, gdbm) are not found, though
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the Skip Montanaro <skip@pobox.com> parents: 27053 diff changeset	676 versions of the Sleepycat library prior to 3.1 are not considered.
23867 45d676933882 This introduces stricter library/header file checking for the Berkeley DB Skip Montanaro <skip@pobox.com> parents: 23415 diff changeset	677
45d676933882 This introduces stricter library/header file checking for the Berkeley DB Skip Montanaro <skip@pobox.com> parents: 23415 diff changeset	678
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	679 Configuring threads
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	680 -------------------
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	681
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	682 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	683 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	684 --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	685 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	686 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	687 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	688 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	689 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	690 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	691 send in the patch. (Don't bother patching the configure script itself
27619 558d0f3b6254 Fix typos. Walter Dörwald <walter@livinglogic.de> parents: 27253 diff changeset	692 -- it is regenerated each time the configure.in file changes.)
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	693
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	694 Compiler switches for threads
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	695 .............................
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	696
16994 459c8ef0a010 Document that _REENTRANT is not needed explicitly. Martin v. Löwis <martin@v.loewis.de> parents: 16776 diff changeset	697 The definition of _REENTRANT should be configured automatically, if
459c8ef0a010 Document that _REENTRANT is not needed explicitly. Martin v. Löwis <martin@v.loewis.de> parents: 16776 diff changeset	698 that does not work on your system, or if _REENTRANT is defined
459c8ef0a010 Document that _REENTRANT is not needed explicitly. Martin v. Löwis <martin@v.loewis.de> parents: 16776 diff changeset	699 incorrectly, please report that as a bug.
459c8ef0a010 Document that _REENTRANT is not needed explicitly. Martin v. Löwis <martin@v.loewis.de> parents: 16776 diff changeset	700
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	701 OS/Compiler/threads Switches for use with threads
16994 459c8ef0a010 Document that _REENTRANT is not needed explicitly. Martin v. Löwis <martin@v.loewis.de> parents: 16776 diff changeset	702 (POSIX is draft 10, DCE is draft 4) compile & link
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	703
16994 459c8ef0a010 Document that _REENTRANT is not needed explicitly. Martin v. Löwis <martin@v.loewis.de> parents: 16776 diff changeset	704 SunOS 5.{1-5}/{gcc,SunPro cc}/solaris -mt
459c8ef0a010 Document that _REENTRANT is not needed explicitly. Martin v. Löwis <martin@v.loewis.de> parents: 16776 diff changeset	705 SunOS 5.5/{gcc,SunPro cc}/POSIX (nothing)
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	706 DEC OSF/1 3.x/cc/DCE -threads
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	707 (butenhof@zko.dec.com)
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	708 Digital UNIX 4.x/cc/DCE -threads
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	709 (butenhof@zko.dec.com)
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	710 Digital UNIX 4.x/cc/POSIX -pthread
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	711 (butenhof@zko.dec.com)
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	712 AIX 4.1.4/cc_r/d7 (nothing)
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	713 (buhrt@iquest.net)
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	714 AIX 4.1.4/cc_r4/DCE (nothing)
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	715 (buhrt@iquest.net)
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	716 IRIX 6.2/cc/POSIX (nothing)
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	717 (robertl@cwi.nl)
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	718
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	719
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	720 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	721 ...........................................
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	722
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	723 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	724
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	725 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	726 SunOS 5.5/POSIX -lpthread
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	727 DEC OSF/1 3.x/DCE -lpthreads -lmach -lc_r -lc
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	728 (butenhof@zko.dec.com)
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	729 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	730 (butenhof@zko.dec.com)
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	731 Digital UNIX 4.x/POSIX -lpthread -lmach -lexc -lc
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	732 (butenhof@zko.dec.com)
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	733 AIX 4.1.4/{draft7,DCE} (nothing)
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	734 (buhrt@iquest.net)
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	735 IRIX 6.2/POSIX -lpthread
8316 63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	736 (jph@emilia.engr.sgi.com)
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	737
63cce9d77797 Add Bill Janssen's notes on configuring threads. Guido van Rossum <guido@python.org> parents: 8041 diff changeset	738
22662 1aea7af09260 Patch #527027: Allow building python as shared library. Martin v. Löwis <martin@v.loewis.de> parents: 22436 diff changeset	739 Building a shared libpython
1aea7af09260 Patch #527027: Allow building python as shared library. Martin v. Löwis <martin@v.loewis.de> parents: 22436 diff changeset	740 ---------------------------
1aea7af09260 Patch #527027: Allow building python as shared library. Martin v. Löwis <martin@v.loewis.de> parents: 22436 diff changeset	741
1aea7af09260 Patch #527027: Allow building python as shared library. Martin v. Löwis <martin@v.loewis.de> parents: 22436 diff changeset	742 Starting with Python 2.3, the majority of the interpreter can be built
1aea7af09260 Patch #527027: Allow building python as shared library. Martin v. Löwis <martin@v.loewis.de> parents: 22436 diff changeset	743 into a shared library, which can then be used by the interpreter
1aea7af09260 Patch #527027: Allow building python as shared library. Martin v. Löwis <martin@v.loewis.de> parents: 22436 diff changeset	744 executable, and by applications embedding Python. To enable this feature,
24525 3cb055aae739 Document that --enable-shared puts PIC objects into the static libpython. Martin v. Löwis <martin@v.loewis.de> parents: 24445 diff changeset	745 configure with --enable-shared.
3cb055aae739 Document that --enable-shared puts PIC objects into the static libpython. Martin v. Löwis <martin@v.loewis.de> parents: 24445 diff changeset	746
3cb055aae739 Document that --enable-shared puts PIC objects into the static libpython. Martin v. Löwis <martin@v.loewis.de> parents: 24445 diff changeset	747 If you do so, a static library will be created in addition to the
3cb055aae739 Document that --enable-shared puts PIC objects into the static libpython. Martin v. Löwis <martin@v.loewis.de> parents: 24445 diff changeset	748 shared library, which uses the same object files as the shared library
3cb055aae739 Document that --enable-shared puts PIC objects into the static libpython. Martin v. Löwis <martin@v.loewis.de> parents: 24445 diff changeset	749 In particular, the library likely object files using
3cb055aae739 Document that --enable-shared puts PIC objects into the static libpython. Martin v. Löwis <martin@v.loewis.de> parents: 24445 diff changeset	750 position-independent code (PIC) if PIC flags are needed for the shared
3cb055aae739 Document that --enable-shared puts PIC objects into the static libpython. Martin v. Löwis <martin@v.loewis.de> parents: 24445 diff changeset	751 library.
22662 1aea7af09260 Patch #527027: Allow building python as shared library. Martin v. Löwis <martin@v.loewis.de> parents: 22436 diff changeset	752
1aea7af09260 Patch #527027: Allow building python as shared library. Martin v. Löwis <martin@v.loewis.de> parents: 22436 diff changeset	753
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	754 Configuring additional built-in modules
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	755 ---------------------------------------
2162 c9aea34ae4b6 add hint for NeXT users Guido van Rossum <guido@python.org> parents: 2131 diff changeset	756
16776 2915eb07bd25 Update build notes to mention setup.py Andrew M. Kuchling <amk@amk.ca> parents: 16775 diff changeset	757 Starting with Python 2.1, the setup.py script at the top of the source
2915eb07bd25 Update build notes to mention setup.py Andrew M. Kuchling <amk@amk.ca> parents: 16775 diff changeset	758 distribution attempts to detect which modules can be built and
2915eb07bd25 Update build notes to mention setup.py Andrew M. Kuchling <amk@amk.ca> parents: 16775 diff changeset	759 automatically compiles them. Autodetection doesn't always work, so
21900 57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	760 you can still customize the configuration by editing the Modules/Setup
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	761 file; but this should be considered a last resort. The rest of this
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	762 section only applies if you decide to edit the Modules/Setup file.
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	763 You also need this to enable static linking of certain modules (which
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	764 is needed to enable profiling on some systems).
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	765
16776 2915eb07bd25 Update build notes to mention setup.py Andrew M. Kuchling <amk@amk.ca> parents: 16775 diff changeset	766 This file is initially copied from Setup.dist by the configure script;
2915eb07bd25 Update build notes to mention setup.py Andrew M. Kuchling <amk@amk.ca> parents: 16775 diff changeset	767 if it does not exist yet, create it by copying Modules/Setup.dist
2915eb07bd25 Update build notes to mention setup.py Andrew M. Kuchling <amk@amk.ca> parents: 16775 diff changeset	768 yourself (configure will never overwrite it). Never edit Setup.dist
2915eb07bd25 Update build notes to mention setup.py Andrew M. Kuchling <amk@amk.ca> parents: 16775 diff changeset	769 -- always edit Setup or Setup.local (see below). Read the comments in
2915eb07bd25 Update build notes to mention setup.py Andrew M. Kuchling <amk@amk.ca> parents: 16775 diff changeset	770 the file for information on what kind of edits are allowed. When you
2915eb07bd25 Update build notes to mention setup.py Andrew M. Kuchling <amk@amk.ca> parents: 16775 diff changeset	771 have edited Setup in the Modules directory, the interpreter will
20270 ce4a7e4ad6c4 Remove false statement about running make in the Modules directory. Guido van Rossum <guido@python.org> parents: 20252 diff changeset	772 automatically be rebuilt the next time you run make (in the toplevel
ce4a7e4ad6c4 Remove false statement about running make in the Modules directory. Guido van Rossum <guido@python.org> parents: 20252 diff changeset	773 directory).
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	774
16776 2915eb07bd25 Update build notes to mention setup.py Andrew M. Kuchling <amk@amk.ca> parents: 16775 diff changeset	775 Many useful modules can be built on any Unix system, but some optional
2915eb07bd25 Update build notes to mention setup.py Andrew M. Kuchling <amk@amk.ca> parents: 16775 diff changeset	776 modules can't be reliably autodetected. Often the quickest way to
2915eb07bd25 Update build notes to mention setup.py Andrew M. Kuchling <amk@amk.ca> parents: 16775 diff changeset	777 determine whether a particular module works or not is to see if it
2915eb07bd25 Update build notes to mention setup.py Andrew M. Kuchling <amk@amk.ca> parents: 16775 diff changeset	778 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	779 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	780 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	781
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	782 On SGI IRIX, there are modules that interface to many SGI specific
16776 2915eb07bd25 Update build notes to mention setup.py Andrew M. Kuchling <amk@amk.ca> parents: 16775 diff changeset	783 system libraries, e.g. the GL library and the audio hardware. These
2915eb07bd25 Update build notes to mention setup.py Andrew M. Kuchling <amk@amk.ca> parents: 16775 diff changeset	784 modules will not be built by the setup.py script.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	785
5037 9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	786 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	787 (the makesetup script processes both). You may find it more
9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	788 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	789 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	790 file.
9ad7b8c36c79 Various notes added: Guido van Rossum <guido@python.org> parents: 4501 diff changeset	791
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	792
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	793 Setting the optimization/debugging options
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	794 ------------------------------------------
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	795
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	796 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	797 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	798 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	799 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	800 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	801 (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	802 set of libraries to link with).
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	803
15325 65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	804 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	805 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	806
65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	807 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	808 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	809
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	810
20252 b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	811 Profiling
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	812 ---------
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	813
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	814 If you want C profiling turned on, the easiest way is to run configure
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	815 with the CC environment variable to the necessary compiler
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	816 invocation. For example, on Linux, this works for profiling using
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	817 gprof(1):
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	818
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	819 CC="gcc -pg" ./configure
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	820
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	821 Note that on Linux, gprof apparently does not work for shared
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	822 libraries. The Makefile/Setup mechanism can be used to compile and
27619 558d0f3b6254 Fix typos. Walter Dörwald <walter@livinglogic.de> parents: 27253 diff changeset	823 link most extension modules statically.
20252 b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	824
b85cd163cd5c Add note about profiling. Guido van Rossum <guido@python.org> parents: 19758 diff changeset	825
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	826 Testing
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	827 -------
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	828
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	829 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	830 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	831 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	832 produces some output. You can generally ignore the messages about
21900 57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	833 skipped tests due to optional features which can't be imported.
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	834 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	835 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	836 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	837 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	838 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	839
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	840 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	841 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	842 failing test manually, as follows:
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	843
22436 888fcd9b858d [Bug #532136] Change path in README, as suggested by Ralph Corderoy Andrew M. Kuchling <amk@amk.ca> parents: 22215 diff changeset	844 ./python ./Lib/test/test_whatever.py
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	845
22436 888fcd9b858d [Bug #532136] Change path in README, as suggested by Ralph Corderoy Andrew M. Kuchling <amk@amk.ca> parents: 22215 diff changeset	846 (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	847 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	848
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	849
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	850 Installing
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	851 ----------
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	852
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 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	854 (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	855 just type
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	856
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	857 make install
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	858
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	859 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	860 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	861 `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	862 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	863 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	864 (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	865
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	866 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	867 name, e.g. the library modules are installed in
15986 bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	868 "/usr/local/lib/python<version>/" by default, where <version> is the
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	869 <major>.<minor> release number (e.g. "2.1"). The Python binary is
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	870 installed as "python<version>" and a hard link named "python" is
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	871 created. The only file not installed with a version number in its
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	872 name is the manual page, installed as "/usr/local/man/man1/python.1"
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	873 by default.
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	874
16629 96e9ccbf165f Add more information regarding the altinstall target. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 16608 diff changeset	875 If you have a previous installation of Python that you don't
6675 cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	876 want to replace yet, use
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	877
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	878 make altinstall
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	879
cdb3279b06e7 Revamped README for release of 1.5b1. Guido van Rossum <guido@python.org> parents: 6494 diff changeset	880 This installs the same set of files as "make install" except it
15986 bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	881 doesn't create the hard link to "python<version>" named "python" and
bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	882 it doesn't install the manual page at all.
3922 e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	883
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	884 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	885 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	886 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	887 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	888
19381 60d5cbbeadc3 Removed NeXT notes (replacing them with a line saying NeXT is no Jack Jansen <jack.jansen@cwi.nl> parents: 17734 diff changeset	889 On Mac OS X, if you have configured Python with --enable-framework, you
60d5cbbeadc3 Removed NeXT notes (replacing them with a line saying NeXT is no Jack Jansen <jack.jansen@cwi.nl> parents: 17734 diff changeset	890 should use "make frameworkinstall" to do the installation. Note that this
60d5cbbeadc3 Removed NeXT notes (replacing them with a line saying NeXT is no Jack Jansen <jack.jansen@cwi.nl> parents: 17734 diff changeset	891 installs the Python executable in a place that is not normally on your
60d5cbbeadc3 Removed NeXT notes (replacing them with a line saying NeXT is no Jack Jansen <jack.jansen@cwi.nl> parents: 17734 diff changeset	892 PATH, you may want to set up a symlink in /usr/local/bin.
60d5cbbeadc3 Removed NeXT notes (replacing them with a line saying NeXT is no Jack Jansen <jack.jansen@cwi.nl> parents: 17734 diff changeset	893
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	894
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	895 Configuration options and variables
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	896 -----------------------------------
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	897
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	898 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	899 script.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	900
3922 e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	901 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	902 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	903 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	904 Modules/getpath.o.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	905
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	906 --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	907 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	908 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	909 --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	910 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	911 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	912 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	913 option.
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	914
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	915 --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	916 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	917 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	918 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	919 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	920 --exec-prefix=DIRECTORY (as well) this overrides the
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	921 installation prefix for architecture-dependent files (like the
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	922 interpreter binary). Note that --prefix=DIRECTORY also
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	923 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	924 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	925 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	926 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	927 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	928 about the install prefix.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	929
21900 57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	930 --with-readline: This option is no longer supported. GNU
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	931 readline is automatically enabled by setup.py when present.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	932
14249 4e3640a06857 Various tweaks and improvements by Thomas Wouters (who apparently lost Guido van Rossum <guido@python.org> parents: 14144 diff changeset	933 --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	934 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	935 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	936 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	937 --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	938 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	939 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	940 --with-dec-threads instead.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	941
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	942 --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	943 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	944 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	945 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	946 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	947 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	948 IRIX 5, it already has dynamic linking using SunOS style
26499 76f79bb36fc7 Add compile-time errors for unsupported systems. Martin v. Löwis <martin@v.loewis.de> parents: 26496 diff changeset	949 shared libraries.) THIS OPTION IS UNSUPPORTED.
2049 07cf3b3baf16 The usual changes when a release is nearing... Guido van Rossum <guido@python.org> parents: 2015 diff changeset	950
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	951 --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	952 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	953 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	954 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	955 (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	956 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	957 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	958 ftp://ftp.cwi.nl/pub/dynload/dld-3.2.3.tar.Z). To
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	959 enable this, ftp and compile both libraries, then call
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	960 configure, passing it the option
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	961 --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	962 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	963 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	964 (Don't bother on SunOS 4 or 5, they already have dynamic
26499 76f79bb36fc7 Add compile-time errors for unsupported systems. Martin v. Löwis <martin@v.loewis.de> parents: 26496 diff changeset	965 linking using shared libraries.) THIS OPTION IS UNSUPPORTED.
2049 07cf3b3baf16 The usual changes when a release is nearing... Guido van Rossum <guido@python.org> parents: 2015 diff changeset	966
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	967 --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	968 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	969 (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	970 --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	971 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	972 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	973 --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	974 libraries, the C library last.
17542 4493199d2b95 This is (hopefully) last checkin before releasing 2.1c2 -- get rid of Guido van Rossum <guido@python.org> parents: 17512 diff changeset	975
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	976 --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	977 is linked against.
3893 958d4c67526b Added doc para for --with-libs Guido van Rossum <guido@python.org> parents: 3887 diff changeset	978
15546 bb93b1dca571 Document --with-cxx. Martin v. Löwis <martin@v.loewis.de> parents: 15344 diff changeset	979 --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	980 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	981 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	982 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	983 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	984 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	985 compilation of main() as a C++ program.
bb93b1dca571 Document --with-cxx. Martin v. Löwis <martin@v.loewis.de> parents: 15344 diff changeset	986
bb93b1dca571 Document --with-cxx. Martin v. Löwis <martin@v.loewis.de> parents: 15344 diff changeset	987
15325 65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	988 --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	989 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	990 live objects when the interpreter terminates.
23029 8291473fde3e Mass checkin of universal newline support. Jack Jansen <jack.jansen@cwi.nl> parents: 22662 diff changeset	991
8291473fde3e Mass checkin of universal newline support. Jack Jansen <jack.jansen@cwi.nl> parents: 22662 diff changeset	992 --with(out)-universal-newlines: enable reading of text files with
8291473fde3e Mass checkin of universal newline support. Jack Jansen <jack.jansen@cwi.nl> parents: 22662 diff changeset	993 foreign newline convention (default: enabled). In other words,
8291473fde3e Mass checkin of universal newline support. Jack Jansen <jack.jansen@cwi.nl> parents: 22662 diff changeset	994 any of \r, \n or \r\n is acceptable as end-of-line character.
8291473fde3e Mass checkin of universal newline support. Jack Jansen <jack.jansen@cwi.nl> parents: 22662 diff changeset	995 If enabled import and execfile will automatically accept any newline
8291473fde3e Mass checkin of universal newline support. Jack Jansen <jack.jansen@cwi.nl> parents: 22662 diff changeset	996 in files. Python code can open a file with open(file, 'U') to
26716 a3600c4ecc8b Unsupport --without-universal-newlines. Martin v. Löwis <martin@v.loewis.de> parents: 26499 diff changeset	997 read it in universal newline mode. THIS OPTION IS UNSUPPORTED.
15325 65594feb5527 Try to clarify when the Modules/Setup file should be edited. Added Fred Drake <fdrake@acm.org> parents: 15249 diff changeset	998
2049 07cf3b3baf16 The usual changes when a release is nearing... Guido van Rossum <guido@python.org> parents: 2015 diff changeset	999
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	1000 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	1001 -------------------------------------------------------------
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	1002
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	1003 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	1004 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	1005 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	1006 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	1007 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	1008 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	1009 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	1010 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	1011 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	1012 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	1013
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	1014 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	1015 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	1016 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	1017
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	1018 $ mkdir /usr/tmp/python
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	1019 $ cd /usr/tmp/python
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	1020 $ ~guido/src/python/configure
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	1021 [...]
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	1022 $ make
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	1023 [...]
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	1024 $
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	1025
16288 c0a2441a4454 - Edit the QNX instructions to refer to Makefile, not Modules/Makefile. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 16229 diff changeset	1026 Note that configure copies the original Setup file to the build
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	1027 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	1028 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	1029 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	1030 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	1031 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	1032 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	1033 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	1034 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	1035 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	1036
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	1037
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	1038 Building on non-UNIX systems
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	1039 ----------------------------
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	1040
14673 df8d575d967d Updated Windows build info. Tim Peters <tim.peters@gmail.com> parents: 14429 diff changeset	1041 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	1042 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	1043 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	1044
10572 10bd2fb2a0d6 Clarify PC build instructions (point to PCbuild). Guido van Rossum <guido@python.org> parents: 10565 diff changeset	1045 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	1046 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	1047
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	1048 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	1049 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	1050 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	1051 (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	1052 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	1053
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	1054 Of course, there are also binary distributions available for these
15986 bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	1055 platforms -- see http://www.python.org/.
3922 e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	1056
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	1057 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	1058 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	1059 has already been done for you). A good start is to copy the file
23962 111c1e59ad72 Random tweaks & updates. Michael W. Hudson <mwh@python.net> parents: 23867 diff changeset	1060 pyconfig.h.in to pyconfig.h and edit the latter to reflect the actual
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	1061 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	1062 1 only if the corresponding feature is present and can be left alone
23962 111c1e59ad72 Random tweaks & updates. Michael W. Hudson <mwh@python.net> parents: 23867 diff changeset	1063 otherwise; however the *_t type symbols must be defined as some
111c1e59ad72 Random tweaks & updates. Michael W. Hudson <mwh@python.net> parents: 23867 diff changeset	1064 variant of int if they need to be defined at all.
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	1065
21414 f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	1066 For all platforms, it's important that the build arrange to define the
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	1067 preprocessor symbol NDEBUG on the compiler command line in a release
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	1068 build of Python (else assert() calls remain in the code, hurting
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	1069 release-build performance). The Unix, Windows and Mac builds already
f536f85295b8 Merge last minute 2.2c1 changes from branch to trunk. Barry Warsaw <barry@python.org> parents: 21367 diff changeset	1070 do this.
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	1071
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	1072
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	1073 Miscellaneous issues
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	1074 ====================
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	1075
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	1076 Emacs mode
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	1077 ----------
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	1078
6448 b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	1079 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	1080 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	1081 is now maintained by the equally famous Barry Warsaw (it's no
15986 bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	1082 coincidence that they now both work on the same team). The latest
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	1083 version, along with various other contributed Python-related Emacs
15986 bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	1084 goodies, is online at http://www.python.org/emacs/python-mode. And
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	1085 if you are planning to edit the Python C code, please pick up the
15986 bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	1086 latest version of CC Mode http://www.python.org/emacs/cc-mode; it
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	1087 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	1088 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	1089 latest version of python-mode.)
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	1090
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	1091
21900 57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	1092 Tkinter
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	1093 -------
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	1094
21900 57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	1095 The setup.py script automatically configures this when it detects a
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	1096 usable Tcl/Tk installation. This requires Tcl/Tk version 8.0 or
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	1097 higher.
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	1098
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	1099 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	1100 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	1101
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	1102 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	1103 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	1104 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	1105
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	1106 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	1107 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	1108 (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	1109 Modules/_tkinter.c. Demos and normal Tk applications import only the
21900 57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	1110 Python Tkinter module -- only the latter imports the C _tkinter
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	1111 module. In order to find the C _tkinter module, it must be compiled
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	1112 and linked into the Python interpreter -- the setup.py script does
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	1113 this. In order to find the Python Tkinter module, sys.path must be
57eaa5d69ac3 Updates related to Modules/Setup and setup.py. This addresses SF bug Guido van Rossum <guido@python.org> parents: 21865 diff changeset	1114 set correctly -- normal installation takes care of this.
3008 a51022f1980f 1.3b1 notes Guido van Rossum <guido@python.org> parents: 2730 diff changeset	1115
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	1116
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	1117 Distribution structure
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	1118 ----------------------
8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	1119
14425 f8e668447e2a Many changes suggested by Bob Weiner, mostly small grammatical fixes Guido van Rossum <guido@python.org> parents: 14385 diff changeset	1120 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	1121 comments.
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	1122
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	1123 .cvsignore Additional filename matching patterns for CVS to ignore
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	1124 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	1125 Demo/ Demonstration scripts, modules and programs
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	1126 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	1127 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	1128 Include/ Public header files
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	1129 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	1130 Lib/ Python library modules
23962 111c1e59ad72 Random tweaks & updates. Michael W. Hudson <mwh@python.net> parents: 23867 diff changeset	1131 Mac/ Macintosh specific resources
16229 e302586452a3 Update the build instructions for flat makefile. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 15986 diff changeset	1132 Makefile.pre.in Source from which config.status creates the Makefile.pre
6448 b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	1133 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	1134 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	1135 Objects/ Implementation of most built-in object types
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	1136 PC/ Files specific to PC ports (DOS, Windows, OS/2)
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	1137 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	1138 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	1139 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	1140 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	1141 Tools/ Some useful programs written in Python
23962 111c1e59ad72 Random tweaks & updates. Michael W. Hudson <mwh@python.net> parents: 23867 diff changeset	1142 pyconfig.h.in Source from which pyconfig.h is created (GNU autoheader output)
3922 e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	1143 configure Configuration shell script (GNU autoconf output)
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	1144 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	1145 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	1146
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	1147 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	1148 the configuration and build processes:
3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	1149
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	1150 Makefile Build rules
16229 e302586452a3 Update the build instructions for flat makefile. Neil Schemenauer <nascheme@enme.ucalgary.ca> parents: 15986 diff changeset	1151 Makefile.pre Build rules before running Modules/makesetup
23962 111c1e59ad72 Random tweaks & updates. Michael W. Hudson <mwh@python.net> parents: 23867 diff changeset	1152 buildno Keeps track of the build number
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	1153 config.cache Cache of configuration variables
23962 111c1e59ad72 Random tweaks & updates. Michael W. Hudson <mwh@python.net> parents: 23867 diff changeset	1154 pyconfig.h Configuration header
6448 b854ca4605e1 Ready for the release, I'd say. Guido van Rossum <guido@python.org> parents: 6132 diff changeset	1155 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	1156 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	1157 getbuildinfo.o Object file from Modules/getbuildinfo.c
15986 bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	1158 libpython<version>.a The library archive
3922 e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left. Guido van Rossum <guido@python.org> parents: 3893 diff changeset	1159 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	1160 tags, TAGS Tags files for vi and Emacs
1453 d773a5f89426 New files Guido van Rossum <guido@python.org> parents: diff changeset	1161
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	1162
14367 648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	1163 That's all, folks!
648a12a780d9 Ready to go. Guido van Rossum <guido@python.org> parents: 14249 diff changeset	1164 ------------------
2658 3a3df231327c revamped README; the usual elsewhere... Guido van Rossum <guido@python.org> parents: 2510 diff changeset	1165
1748 8286a662502b Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1456 diff changeset	1166
15986 bd5aee6b8390 Updated for 2.1; removed references to BeOpen.com and PythonLabs. Guido van Rossum <guido@python.org> parents: 15546 diff changeset	1167 --Guido van Rossum (home page: http://www.python.org/~guido/)

Mercurial > cpython-lru_cache-weakref

annotate README @ 27998:e27f58a50737 legacy-trunk