annotate README @ 4566:6403c94de50d legacy-trunk

Added safeguard against failure in __del__.
author Guido van Rossum <guido@python.org>
date Wed, 27 Nov 1996 19:39:58 +0000
parents 559aa47b2e2c
children 9ad7b8c36c79
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
4501
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
1 This is Python release 1.4 (final)
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
2 ==================================
3698
97b1c2a70eae Some cleanups. Change of address.
Guido van Rossum <guido@python.org>
parents: 3399
diff changeset
3
4501
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
4 I appreciate everybody's patience... This is the official, final
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
5 release of Python 1.4. You can throw away your copies of 1.3 and the
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
6 1.4 betas now!
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
7
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
8
3887
957f42ea0f84 Numerous changes, but still a lot of XXX thingies.
Guido van Rossum <guido@python.org>
parents: 3850
diff changeset
9 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
10 ---------------------------
3850
d1cff49e3cc8 Various changes (not done yet even for beta2 release)
Guido van Rossum <guido@python.org>
parents: 3778
diff changeset
11
4501
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
12 An exhaustive list of (nearly) everything that changed since the
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
13 release of Python 1.3, over a year ago, can be found in the file
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
14 Misc/NEWS. (A history of all changes before that time is kept in
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
15 Misc/HISTORY.) An overview of the most important user-visible changes
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
16 is appended as a new chapter to the Tutorial (Doc/tut.tex). Perhaps
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
17 the most visible changes are the new power operator, complex numbers,
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
18 new slicing and indexing syntax, and class-private names of the form
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
19 __spam (an experimental feature).
3850
d1cff49e3cc8 Various changes (not done yet even for beta2 release)
Guido van Rossum <guido@python.org>
parents: 3778
diff changeset
20
d1cff49e3cc8 Various changes (not done yet even for beta2 release)
Guido van Rossum <guido@python.org>
parents: 3778
diff changeset
21
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
22 What is Python anyway?
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
23 ----------------------
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
24
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
25 Python is an interpreted object-oriented programming language, and 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
26 often compared to Tcl, Perl, Scheme or Java. For a quick summary of
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
27 what Python can mean for a UNIX/C programmer, read Misc/BLURB.LUTZ.
4152
9881a5214fd2 Reformatted some stuff. Put FEATURE FREEZE in all caps.
Guido van Rossum <guido@python.org>
parents: 4134
diff changeset
28 If you have web access, point your browser to http://www.python.org.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
29
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
30
4501
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
31 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
32 ----------------------
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
33
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
34 The official tutorial is still a good place to start (in the Doc
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
35 directory as tut.tex; and http://www.python.org/doc/tut/tut.html).
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
36 Aaron Watters wrote a second tutorial, that may be more accessible for
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
37 some: http://www.wcmh.com/uworld/archives/95/tutorial/005.html.
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
38
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
39 There are now also two books on Python. While these are still based
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
40 on Python 1.3 or 1.4beta2, the language is so stable now that you'd be
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
41 hard pressed to find places where the books are out of date. The
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
42 books, both first published in October 1996 and both including a
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
43 CD-ROM, form excellent companions to each other:
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
44
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
45 Internet Programming with Python
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
46 by Aaron Watters, Guido van Rossum, and James Ahlstrom
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
47 MIS Press/Henry Holt publishers
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
48 ISBN: 1-55851-484-8
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
49
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
50 Programming Python
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
51 by Mark Lutz
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
52 O'Reilly & Associates
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
53 ISBN: 1-56592-197-6
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
54
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
55
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
56 If you don't read instructions
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
57 ------------------------------
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
58
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
59 Congratulations on getting this far. :-)
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
60
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
61 To start building right away (on UNIX): type "./configure" in the
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
62 current directory and when it finishes, type "make". The section
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
63 Build Instructions below is still recommended reading. :-)
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
64
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
65
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
66 Copyright issues
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
67 ----------------
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
68
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
69 Python is COPYRIGHTED but free to use for all. See the full copyright
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
70 notice at the end of this file.
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
71
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
72 The Python distribution is *not* affected by the GNU Public Licence
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
73 (GPL). There are interfaces to some GNU code but these are entirely
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
74 optional and no GNU code is distributed with Python. For all these
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
75 packages, GPL-free public domain versions also exist.
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
76
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
77
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
78
3110
5c0a7f7836fb added psa plug
Guido van Rossum <guido@python.org>
parents: 3008
diff changeset
79 A modest plug
5c0a7f7836fb added psa plug
Guido van Rossum <guido@python.org>
parents: 3008
diff changeset
80 =============
5c0a7f7836fb added psa plug
Guido van Rossum <guido@python.org>
parents: 3008
diff changeset
81
4501
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
82 *********************************************************************
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
83 * Without your help, I won't be able to continue to support Python! *
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
84 *********************************************************************
3110
5c0a7f7836fb added psa plug
Guido van Rossum <guido@python.org>
parents: 3008
diff changeset
85
4501
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
86 If you use Python, please consider joining the Python Software
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
87 Activity (PSA). See http://www.python.org/psa/.
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
88
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
89 Organizations that make heavy use of Python are especially encouraged
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
90 to become corporate members!
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
91
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
92
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
93 Build instructions
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
94 ==================
1453
d773a5f89426 New files
Guido van Rossum <guido@python.org>
parents:
diff changeset
95
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
96 Before you can build Python, you must first configure it.
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
97 Fortunately, the configuration and build process has been streamlined
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
98 for most Unix installations, so all you have to do is type a few
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
99 commands, optionally edit one file, and sit back. There are some
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
100 platforms where things are not quite as smooth; see the platform
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
101 specific notes below. If you want to build for multiple platforms
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
102 sharing the same source tree, see the section on VPATH below.
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
103
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
104 You start by running the script "./configure", which figures out your
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
105 system configuration and creates several Makefiles. (It takes a
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
106 minute or two -- please be patient!) When it's done, you are ready to
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
107 run make. You may want to pass options to the configure script -- see
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
108 the section below on configuration options and variables.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
109
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
110 To build Python, you normally type "make" in the toplevel directory.
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
111 This will recursively run make in each of the subdirectories Parser,
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
112 Objects, Python and Modules, creating a library file in each one. 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
113 executable of the interpreter is built in the Modules subdirectory and
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
114 moved up here when it is built. If you want or need to, you can also
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
115 chdir into each subdirectory in turn and run make there manually (do
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
116 the Modules subdirectory last!).
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
117
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
118 Once you have built an interpreter, see the subsections below on
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
119 testing, configuring additional modules, and installation. If you run
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
120 in trouble, see the next section.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
121
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
122
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
123 Troubleshooting
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
124 ---------------
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
125
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
126 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
127
3698
97b1c2a70eae Some cleanups. Change of address.
Guido van Rossum <guido@python.org>
parents: 3399
diff changeset
128 If recursive makes fail, try invoking make as "make MAKE=make".
97b1c2a70eae Some cleanups. Change of address.
Guido van Rossum <guido@python.org>
parents: 3399
diff changeset
129
97b1c2a70eae Some cleanups. Change of address.
Guido van Rossum <guido@python.org>
parents: 3399
diff changeset
130 If you run into other trouble, see section 3 of the FAQ (file
97b1c2a70eae Some cleanups. Change of address.
Guido van Rossum <guido@python.org>
parents: 3399
diff changeset
131 Misc/FAQ) for hints on what can go wrong, and how to fix it.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
132
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
133 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
134 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
135 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
136 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
137
4134
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
138 If the configure script fails or doesn't seem to find things that
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
139 should be there, inspect the config.log file.
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
140
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
141
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
142 Platform specific notes
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
143 -----------------------
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
144
3174
f7789945b8de release 1.3 for real
Guido van Rossum <guido@python.org>
parents: 3110
diff changeset
145 (Some of these may no longer apply. If you find you can build Python
f7789945b8de release 1.3 for real
Guido van Rossum <guido@python.org>
parents: 3110
diff changeset
146 on these platforms without the special directions mentioned here, let
f7789945b8de release 1.3 for real
Guido van Rossum <guido@python.org>
parents: 3110
diff changeset
147 me know so I can remove them!)
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
148
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
149 Linux: On Linux version 1.x, once you've built Python, use it to run
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
150 the regen script in the Lib/linux1 directory. Apparently
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
151 the files as distributed don't match the system headers on
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
152 some Linux versions. (The "h2py" command refers 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
153 Tools/scripts/h2py.py.) The modules distributed for Linux 2.x
4134
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
154 should be okay. Shared library support now works by default
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
155 on ELF-based x86 Linux systems.
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
156
4134
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
157 AIX: A complete overhaul of the shared library support is now in
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
158 place. To enable it, uncomment the LINKCC line in the Setup
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
159 file. See Misc/AIX-NOTES for some notes on how it's done.
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
160
4134
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
161 WARNING! In some versions of AIX 3.x, you get errors about
3778
f9907f57327e Added extra notes for AIX and SCO.
Guido van Rossum <guido@python.org>
parents: 3698
diff changeset
162 Invalid Indent when running the Python test set. This appears
f9907f57327e Added extra notes for AIX and SCO.
Guido van Rossum <guido@python.org>
parents: 3698
diff changeset
163 to be a bug in the AIX compiler. Rebuild Parser/tokenizer.c
f9907f57327e Added extra notes for AIX and SCO.
Guido van Rossum <guido@python.org>
parents: 3698
diff changeset
164 using OPT="" or OPT=-g, or use gcc.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
165
4134
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
166 HP-UX: Shared library support now works by default (at least on HP-UX
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
167 9.x). One other problem remains: the HP ANSI C compiler (cc
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
168 -Aa) is too pedantic to use, but in K&R mode, it barfs on a
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
169 few files (complexobject.c, getargs.c and operator.c). Until
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
170 this is fixed, the following seems to work:
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
171
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
172 make -k # this compiles all but a few files
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
173 make OPT=-Aa # compile the remaining files
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
174
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
175 Minix: When using ack, use "CC=cc AR=aal RANLIB=: ./configure"!
1882
f84b64df09c3 The usual junk
Guido van Rossum <guido@python.org>
parents: 1819
diff changeset
176
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
177 SCO: 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
178 defs. This is because all the SCO header files are broken.
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
179 Anything that isn't mentioned in the C standard it's
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
180 conditionally excluded when __STDC__ is defined.
1453
d773a5f89426 New files
Guido van Rossum <guido@python.org>
parents:
diff changeset
181
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
182 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
183 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
184 needed be set to:
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 LIBS=' -lsocket -lcrypt_i'
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
187
3778
f9907f57327e Added extra notes for AIX and SCO.
Guido van Rossum <guido@python.org>
parents: 3698
diff changeset
188 3) According to at least one report, the above apply only to
f9907f57327e Added extra notes for AIX and SCO.
Guido van Rossum <guido@python.org>
parents: 3698
diff changeset
189 SCO 3 -- Python builds out of the box on SCO 5.
f9907f57327e Added extra notes for AIX and SCO.
Guido van Rossum <guido@python.org>
parents: 3698
diff changeset
190
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
191 SunOS: On SunOS 4.x, when using the native "cc" compiler, you have 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
192 disable modules "cmath" and "operator" in Modules/Setup (see
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
193 the next section) and edit the various Makefiles to add
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
194 "-DWITHOUT_COMPLEX" to the CFLAGS variable, in order 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
195 overcome the limitation to pre-ANSI C. (Or, of course, 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
196 could get gcc :-).
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
197
4427
9c7ef030bec8 Changes in description of NeXT options. Fixed reference to newsgroup
Guido van Rossum <guido@python.org>
parents: 4152
diff changeset
198 NeXT: To build fat binaries, use the --with-next-archs switch
9c7ef030bec8 Changes in description of NeXT options. Fixed reference to newsgroup
Guido van Rossum <guido@python.org>
parents: 4152
diff changeset
199 described below.
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
200
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
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
202 Configuring additional built-in modules
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
203 ---------------------------------------
2162
c9aea34ae4b6 add hint for NeXT users
Guido van Rossum <guido@python.org>
parents: 2131
diff changeset
204
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
205 You can configure the interpreter to contain fewer or more built-in
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
206 modules by editing the file Modules/Setup. This file is initially
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
207 copied (when the toplevel Makefile makes Modules/Makefile for the
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
208 first time) from Setup.in; if it does not exist yet, make a copy
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
209 yourself. Never edit Setup.in -- always edit Setup. Read the
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
210 comments in the file for information on what kind of edits you can
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
211 make. When you have edited Setup, Makefile and config.c in Modules
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
212 will automatically be rebuilt the next time you run make in the
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
213 toplevel directory. (When working inside the Modules directory, use
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
214 "make Makefile; make".)
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
215
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
216 The default collection of modules should build on any Unix system, but
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
217 many optional modules should work on all modern Unices (e.g. try dbm,
4134
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
218 nis, termios, timing, syslog, curses, new, soundex, parser). Often
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
219 the quickest way to determine whether a particular module works or not
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
220 is to see if it will build: enable it in Setup, then if you get
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
221 compilation or link errors, disable it -- you're missing support.
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
222
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
223 On SGI IRIX, there are modules that interface to many SGI specific
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
224 system libraries, e.g. the GL library and the audio hardware.
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
225
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
226 For SunOS and Solaris, enable module "sunaudiodev" to support 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
227 audio device.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
228
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
229
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
230 Setting the optimization/debugging options
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
231 ------------------------------------------
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
232
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
233 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
234 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
235 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
236 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
237 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
238 (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
239 set of libraries to link with).
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
240
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
241
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
242 Testing
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
243 -------
1453
d773a5f89426 New files
Guido van Rossum <guido@python.org>
parents:
diff changeset
244
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
245 To test the interpreter that you have just built, type "make test".
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
246 This runs the test set silently, twice (once with no compiled files,
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
247 once with the compiled files left by the previous test run). Each
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
248 test run should print "All tests OK." and nothing more. (The test set
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
249 does not test the built-in modules, but will find most other problems
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
250 with the interpreter.)
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
251
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
252 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
253 *don't* include the output of "make test". It is useless. Run the
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
254 following command instead:
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
255
4152
9881a5214fd2 Reformatted some stuff. Put FEATURE FREEZE in all caps.
Guido van Rossum <guido@python.org>
parents: 4134
diff changeset
256 PYTHONPATH=../Lib:../Lib/test:./Modules ./python -c 'import testall'
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
257
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
258 (substituting the top of the source tree for .. if you built in a
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
259 different directory). This gives the output of the tests and shows
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
260 which test failed.
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
261
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
262
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
263 Installing
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
264 ----------
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
265
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
266 Installing Python was never this easy!
3887
957f42ea0f84 Numerous changes, but still a lot of XXX thingies.
Guido van Rossum <guido@python.org>
parents: 3850
diff changeset
267
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
268 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
269 (see below), include files, configuration files, and the manual page,
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
270 just type "make install". This will install all platform-independent
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
271 files in subdirectories the directory given with the --prefix option
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
272 to configure or the 'prefix' Make variable (default /usr/local), and
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
273 all binary and other platform-specific files in subdirectories if 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
274 directory given by --exec-prefix or the 'exec_prefix' Make variable
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
275 (defaults to the --prefix directory). All subdirectories created will
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
276 have Python's version number in their name, e.g. the 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
277 are installed in "/usr/local/lib/python1.4/" by default. The 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
278 binary is installed as "python1.4" and a hard link named "python" is
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
279 created. The only file not installed with a version number in its
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
280 name is the manual page, installed as "/usr/local/man/man1/python.1"
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
281 by default.
1453
d773a5f89426 New files
Guido van Rossum <guido@python.org>
parents:
diff changeset
282
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
283 If you have a previous installation of a pre-1.4 Python that you don't
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
284 want to replace yet, use "make altinstall". This installs the same
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
285 set of files as "make install" except it doesn't create the hard link
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
286 to "python1.4" named "python" and it doesn't install the manual page
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
287 at 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
288
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
289 The only thing you may have to install manually is the Python mode 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
290 Emacs. (But then again, more recent versions of Emacs may already
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
291 have it!) This is the file Misc/python-mode.el; follow 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
292 instructions that came with Emacs for installation of site specific
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
293 files.
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
294
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
295
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
296 Configuration options and variables
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
297 -----------------------------------
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
298
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
299 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
300 script.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
301
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
302 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
303 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
304 after changing --prefix or --exec-prefix, all you need to do is remove
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
305 Modules/getpath.o; after changing --with-readline, just remove
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
306 Parser/myreadline.o.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
307
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
308 --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
309 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
310 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
311 --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
312 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
313 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
314 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
315 option.
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
316
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
317 --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
318 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
319 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
320 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
321 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
322 --exec-prefix=DIRECTORY (as well) this overrides the
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
323 installation prefix for architecture-dependent files (like the
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
324 interpreter binary). Note that --prefix=DIRECTORY also
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
325 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
326 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
327 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
328 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
329 than re-running the configure script if you change your mind
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
330 about the install prefix...
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
331
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
332 --with-readline: You can use the GNU readline library to improve the
3698
97b1c2a70eae Some cleanups. Change of address.
Guido van Rossum <guido@python.org>
parents: 3399
diff changeset
333 interactive user interface. This gives you line editing and
97b1c2a70eae Some cleanups. Change of address.
Guido van Rossum <guido@python.org>
parents: 3399
diff changeset
334 command history when calling Python interactively. Unless GNU
97b1c2a70eae Some cleanups. Change of address.
Guido van Rossum <guido@python.org>
parents: 3399
diff changeset
335 readline is a standard part of your system (it is on Linux),
97b1c2a70eae Some cleanups. Change of address.
Guido van Rossum <guido@python.org>
parents: 3399
diff changeset
336 you need to configure build the GNU readline library before
97b1c2a70eae Some cleanups. Change of address.
Guido van Rossum <guido@python.org>
parents: 3399
diff changeset
337 running the configure script. Its sources are not distributed
97b1c2a70eae Some cleanups. Change of address.
Guido van Rossum <guido@python.org>
parents: 3399
diff changeset
338 with Python; you can ftp them from any GNU mirror site, or
97b1c2a70eae Some cleanups. Change of address.
Guido van Rossum <guido@python.org>
parents: 3399
diff changeset
339 from its home site:
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
340 ftp://slc2.ins.cwru.edu/pub/dist/readline-2.0.tar.gz (or
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
341 a higher version number -- using version 1.x is not
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
342 recommended).
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
343
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
344 A GPL-free version was posted to comp.sources.misc in volume
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
345 31 and is widely available from FTP archive sites, e.g.
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
346 ftp://gatekeeper.dec.com/.
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
347
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
348 Pass the Python configure script the option
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
349 --with-readline=DIRECTORY where DIRECTORY is the absolute
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
350 pathname of the directory where you've built the readline
3698
97b1c2a70eae Some cleanups. Change of address.
Guido van Rossum <guido@python.org>
parents: 3399
diff changeset
351 library. If GNU readline is a standard part of your system,
97b1c2a70eae Some cleanups. Change of address.
Guido van Rossum <guido@python.org>
parents: 3399
diff changeset
352 don't pass '=DIRECTORY'. Some hints on building and using the
97b1c2a70eae Some cleanups. Change of address.
Guido van Rossum <guido@python.org>
parents: 3399
diff changeset
353 readline library are in the FAQ (file Misc/FAQ).
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
354
3698
97b1c2a70eae Some cleanups. Change of address.
Guido van Rossum <guido@python.org>
parents: 3399
diff changeset
355 --with-thread: On most Unix systems, you can now use multiple threads.
97b1c2a70eae Some cleanups. Change of address.
Guido van Rossum <guido@python.org>
parents: 3399
diff changeset
356 To enable this, pass --with-thread. If the library required
97b1c2a70eae Some cleanups. Change of address.
Guido van Rossum <guido@python.org>
parents: 3399
diff changeset
357 for threads lives in a peculiar place, you can use
97b1c2a70eae Some cleanups. Change of address.
Guido van Rossum <guido@python.org>
parents: 3399
diff changeset
358 --with-thread=DIRECTORY. In the Modules/Setup file, enable
97b1c2a70eae Some cleanups. Change of address.
Guido van Rossum <guido@python.org>
parents: 3399
diff changeset
359 the thread module. (Threads aren't enabled automatically
97b1c2a70eae Some cleanups. Change of address.
Guido van Rossum <guido@python.org>
parents: 3399
diff changeset
360 because there are run-time penalties when support for them 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
361 compiled in even if you don't use them.) IMPORTANT: run "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
362 clean" after changing (either enabling or disabling) 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
363 option!
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
364
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
365 --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
366 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
367 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
368 This is enabled (after you've ftp'ed and compiled the dl
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
369 library!) by passing --with-sgi-dl=DIRECTORY where DIRECTORY
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
370 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
371 IRIX 5, it already has dynamic linking using SunOS style
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
372 shared libraries.) Support for this feature is deprecated.
2049
07cf3b3baf16 The usual changes when a release is nearing...
Guido van Rossum <guido@python.org>
parents: 2015
diff changeset
373
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
374 --with-dl-dld: Dynamic loading of modules is rumoured to be supported
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
375 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
376 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
377 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
378 (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
379 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
380 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
381 ftp://ftp.cwi.nl/pub/dynload/dld-3.2.3.tar.Z). To
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
382 enable this, ftp and compile both libraries, then call the
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
383 configure passing it the option
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
384 --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
385 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
386 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
387 (Don't bother on SunOS 4 or 5, they already have dynamic
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
388 linking using shared libraries.) Support for this feature is
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
389 deprecated.
2049
07cf3b3baf16 The usual changes when a release is nearing...
Guido van Rossum <guido@python.org>
parents: 2015
diff changeset
390
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
391 --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
392 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
393 (default the empty string) using the options
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
394 --with-libm=STRING and --with-libc=STRING, respectively. E.g.
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
395 if your system requires that you pass -lc_s to the C compiler
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
396 to use the shared C library, you can pass --with-libc=-lc_s.
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
397 These libraries are passed after all other libraries, the C
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
398 library last.
3850
d1cff49e3cc8 Various changes (not done yet even for beta2 release)
Guido van Rossum <guido@python.org>
parents: 3778
diff changeset
399
d1cff49e3cc8 Various changes (not done yet even for beta2 release)
Guido van Rossum <guido@python.org>
parents: 3778
diff changeset
400 --with-next-archs='arch1 arch2': Under NEXTSTEP, this will build
d1cff49e3cc8 Various changes (not done yet even for beta2 release)
Guido van Rossum <guido@python.org>
parents: 3778
diff changeset
401 all compiled binaries with the architectures listed. Includes
d1cff49e3cc8 Various changes (not done yet even for beta2 release)
Guido van Rossum <guido@python.org>
parents: 3778
diff changeset
402 correctly setting the target architecture specific resource
4427
9c7ef030bec8 Changes in description of NeXT options. Fixed reference to newsgroup
Guido van Rossum <guido@python.org>
parents: 4152
diff changeset
403 directory. (This option is not supported on other platforms.)
2049
07cf3b3baf16 The usual changes when a release is nearing...
Guido van Rossum <guido@python.org>
parents: 2015
diff changeset
404
3893
958d4c67526b Added doc para for --with-libs
Guido van Rossum <guido@python.org>
parents: 3887
diff changeset
405 --with-libs='libs': Add 'libs' to the LIBS that the python
958d4c67526b Added doc para for --with-libs
Guido van Rossum <guido@python.org>
parents: 3887
diff changeset
406 linked against.
958d4c67526b Added doc para for --with-libs
Guido van Rossum <guido@python.org>
parents: 3887
diff changeset
407
2049
07cf3b3baf16 The usual changes when a release is nearing...
Guido van Rossum <guido@python.org>
parents: 2015
diff changeset
408
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
409 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
410 -------------------------------------------------------------
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
411
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
412 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
413 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
414 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
415 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
416 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
417 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
418 necessary subdirectories and the Makefiles therein. The Makefiles
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
419 contain a line VPATH=... which points to directory containing the
4134
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
420 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
421 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
422
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
423 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
424 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
425 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
426
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
427 $ mkdir /usr/tmp/python
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
428 $ cd /usr/tmp/python
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
429 $ ~guido/src/python/configure
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
430 [...]
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
431 $ make
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
432 [...]
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
433 $
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
434
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
435 Note that Modules/Makefile copies the original Setup file to the build
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
436 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
437 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
438 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
439 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
440 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
441 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
442 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
443 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
444 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
445
1453
d773a5f89426 New files
Guido van Rossum <guido@python.org>
parents:
diff changeset
446
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
447 Building on non-UNIX systems
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
448 ----------------------------
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
449
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
450 Building Python for a PC is now a piece of cake!
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
451
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
452 Enter the directory "PC" and read the file "readme.txt". Most popular
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
453 non-Unix PC platforms and compilers are supported (Unix ports to 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
454 PC such as Linux, FreeBSD or Solaris-x86 of course use the standard
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
455 Unix build instructions).
3887
957f42ea0f84 Numerous changes, but still a lot of XXX thingies.
Guido van Rossum <guido@python.org>
parents: 3850
diff changeset
456
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
457 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
458 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
459 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
460 (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
461 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
462
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
463 Of course, there are also binary distributions available for these
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
464 platforms -- see http://www.python.org/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
465
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
466 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
467 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
468 has already been done for you). A good start is to copy the file
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
469 config.h.in to config.h and edit the latter to reflect the actual
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
470 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
471 1 only if the corresponding feature is present and can be left alone
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
472 otherwise; however RETSIGTYPE must always be defined, either as int or
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
473 as void, and the *_t type symbols must be defined as some variant of
4134
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
474 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
475
1453
d773a5f89426 New files
Guido van Rossum <guido@python.org>
parents:
diff changeset
476
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
477
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
478 Miscellaneous issues
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
479 ====================
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
480
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
481 Documentation
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
482 -------------
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
483
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
484 All documentation is provided in the subdirectory Doc in the form of
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
485 LaTeX files. In order of importance for new users: Tutorial (tut),
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
486 Library Reference (lib), Language Reference (ref), Extending (ext).
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
487 Especially the Library Reference is of immense value since much of
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
488 Python's power (including the built-in data types and functions!) is
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
489 described here.
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
490
4152
9881a5214fd2 Reformatted some stuff. Put FEATURE FREEZE in all caps.
Guido van Rossum <guido@python.org>
parents: 4134
diff changeset
491 To print the documentation from the LaTeX files, chdir into the Doc
9881a5214fd2 Reformatted some stuff. Put FEATURE FREEZE in all caps.
Guido van Rossum <guido@python.org>
parents: 4134
diff changeset
492 subdirectory, type "make" (let's hope you have LaTeX installed!), and
9881a5214fd2 Reformatted some stuff. Put FEATURE FREEZE in all caps.
Guido van Rossum <guido@python.org>
parents: 4134
diff changeset
493 send the four resulting PostScript files (tut.ps, lib.ps, ref.ps, and
9881a5214fd2 Reformatted some stuff. Put FEATURE FREEZE in all caps.
Guido van Rossum <guido@python.org>
parents: 4134
diff changeset
494 ext.ps) to the printer. See the README file there. If you don't have
9881a5214fd2 Reformatted some stuff. Put FEATURE FREEZE in all caps.
Guido van Rossum <guido@python.org>
parents: 4134
diff changeset
495 LaTeX, you can ftp the PostScript files from the ftp archives (see
9881a5214fd2 Reformatted some stuff. Put FEATURE FREEZE in all caps.
Guido van Rossum <guido@python.org>
parents: 4134
diff changeset
496 below).
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
497
4152
9881a5214fd2 Reformatted some stuff. Put FEATURE FREEZE in all caps.
Guido van Rossum <guido@python.org>
parents: 4134
diff changeset
498 All documentation is also available on-line via the Python web site
9881a5214fd2 Reformatted some stuff. Put FEATURE FREEZE in all caps.
Guido van Rossum <guido@python.org>
parents: 4134
diff changeset
499 (http://www.python.org/, see below). It can also be downloaded
9881a5214fd2 Reformatted some stuff. Put FEATURE FREEZE in all caps.
Guido van Rossum <guido@python.org>
parents: 4134
diff changeset
500 separately from the ftp archives (see below) in Emacs INFO, HTML or
9881a5214fd2 Reformatted some stuff. Put FEATURE FREEZE in all caps.
Guido van Rossum <guido@python.org>
parents: 4134
diff changeset
501 PostScript form -- see the web site or the FAQ (file Misc/FAQ) for
9881a5214fd2 Reformatted some stuff. Put FEATURE FREEZE in all caps.
Guido van Rossum <guido@python.org>
parents: 4134
diff changeset
502 more info.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
503
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
504
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
505 Emacs mode
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
506 ----------
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
507
4134
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
508 There's an excellent Emacs editing mode for Python code; see the file
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
509 Misc/python-mode.el. Originally written by Tim Peters, it is now
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
510 maintained by Barry Warsaw <bwarsaw@cnri.reston.va.us>.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
511
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
512
3887
957f42ea0f84 Numerous changes, but still a lot of XXX thingies.
Guido van Rossum <guido@python.org>
parents: 3850
diff changeset
513 Web site
957f42ea0f84 Numerous changes, but still a lot of XXX thingies.
Guido van Rossum <guido@python.org>
parents: 3850
diff changeset
514 --------
957f42ea0f84 Numerous changes, but still a lot of XXX thingies.
Guido van Rossum <guido@python.org>
parents: 3850
diff changeset
515
957f42ea0f84 Numerous changes, but still a lot of XXX thingies.
Guido van Rossum <guido@python.org>
parents: 3850
diff changeset
516 Python's own web site has URL http://www.python.org/. Come visit us!
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
517 There are a number of mirrors, listed on the home page -- try a mirror
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
518 that's close you you.
3887
957f42ea0f84 Numerous changes, but still a lot of XXX thingies.
Guido van Rossum <guido@python.org>
parents: 3850
diff changeset
519
957f42ea0f84 Numerous changes, but still a lot of XXX thingies.
Guido van Rossum <guido@python.org>
parents: 3850
diff changeset
520
4134
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
521 Ftp site
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
522 --------
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
523
3887
957f42ea0f84 Numerous changes, but still a lot of XXX thingies.
Guido van Rossum <guido@python.org>
parents: 3850
diff changeset
524 Python's own ftp site is ftp.python.org, directory /pub/python. See
957f42ea0f84 Numerous changes, but still a lot of XXX thingies.
Guido van Rossum <guido@python.org>
parents: 3850
diff changeset
525 the FAQ (file Misc/FAQ) for a list of other ftp sites carrying the
3698
97b1c2a70eae Some cleanups. Change of address.
Guido van Rossum <guido@python.org>
parents: 3399
diff changeset
526 Python distribution.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
527
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
528
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
529 Newsgroup and mailing list
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
530 --------------------------
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
531
4152
9881a5214fd2 Reformatted some stuff. Put FEATURE FREEZE in all caps.
Guido van Rossum <guido@python.org>
parents: 4134
diff changeset
532 There are a newsgroup and a mailing list devoted to Python. The
9881a5214fd2 Reformatted some stuff. Put FEATURE FREEZE in all caps.
Guido van Rossum <guido@python.org>
parents: 4134
diff changeset
533 newsgroup, comp.lang.python, contains exactly the same messages as the
9881a5214fd2 Reformatted some stuff. Put FEATURE FREEZE in all caps.
Guido van Rossum <guido@python.org>
parents: 4134
diff changeset
534 mailing list (though not always in the same order, due to the
9881a5214fd2 Reformatted some stuff. Put FEATURE FREEZE in all caps.
Guido van Rossum <guido@python.org>
parents: 4134
diff changeset
535 mysterious nature of the Usenet news distribution algorithm). To
9881a5214fd2 Reformatted some stuff. Put FEATURE FREEZE in all caps.
Guido van Rossum <guido@python.org>
parents: 4134
diff changeset
536 subscribe to the mailing list, send mail containing your real name and
9881a5214fd2 Reformatted some stuff. Put FEATURE FREEZE in all caps.
Guido van Rossum <guido@python.org>
parents: 4134
diff changeset
537 e-mail address to "python-list-request@cwi.nl". Use the same address
9881a5214fd2 Reformatted some stuff. Put FEATURE FREEZE in all caps.
Guido van Rossum <guido@python.org>
parents: 4134
diff changeset
538 if you want to unsibscribed. (A real person reads these messages, so
9881a5214fd2 Reformatted some stuff. Put FEATURE FREEZE in all caps.
Guido van Rossum <guido@python.org>
parents: 4134
diff changeset
539 no LISTPROC or Majordomo commands, please, and please be patient --
9881a5214fd2 Reformatted some stuff. Put FEATURE FREEZE in all caps.
Guido van Rossum <guido@python.org>
parents: 4134
diff changeset
540 normal turn-around time is about one working day.)
4134
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
541
4152
9881a5214fd2 Reformatted some stuff. Put FEATURE FREEZE in all caps.
Guido van Rossum <guido@python.org>
parents: 4134
diff changeset
542 The Python web site contains a search form that lets you search the
9881a5214fd2 Reformatted some stuff. Put FEATURE FREEZE in all caps.
Guido van Rossum <guido@python.org>
parents: 4134
diff changeset
543 newsgroup archives (or the web site itself). Click on the "search"
9881a5214fd2 Reformatted some stuff. Put FEATURE FREEZE in all caps.
Guido van Rossum <guido@python.org>
parents: 4134
diff changeset
544 link in the banner menu on any page of http://www.python.org/.
4134
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
545
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
546
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
547 Bug reports
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
548 -----------
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
549
4152
9881a5214fd2 Reformatted some stuff. Put FEATURE FREEZE in all caps.
Guido van Rossum <guido@python.org>
parents: 4134
diff changeset
550 Bugs are best reported to the comp.lang.python newsgroup or the Python
4427
9c7ef030bec8 Changes in description of NeXT options. Fixed reference to newsgroup
Guido van Rossum <guido@python.org>
parents: 4152
diff changeset
551 mailing list -- see the section "Newsgroup and mailing list" above.
4152
9881a5214fd2 Reformatted some stuff. Put FEATURE FREEZE in all caps.
Guido van Rossum <guido@python.org>
parents: 4134
diff changeset
552 Before posting, check the newsgroup archives (see above) to see if
4501
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
553 your bug has already been reported!
4134
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
554
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
555
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
556 Questions
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
557 ---------
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
558
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
559 For help, if you can't find it in the manuals, the FAQ or on the web
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
560 site, it's best to post to the comp.lang.python or the Python mailing
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
561 list (see above). If you specifically don't want to involve the
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
562 newsgroup or mailing list, send questions to python-help@python.org.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
563
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
564
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
565 The Tk interface
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
566 ----------------
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
567
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
568 Tk (the user interface component of John Ousterhout's Tcl language) is
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
569 also usable from Python. Since this requires that you first build and
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
570 install Tcl/Tk, the Tk interface is not enabled by default. It works
4501
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
571 with Tcl 7.5 and Tk 4.1 as well as with Tcl 7.4 and Tk 4.0. I didn't
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
572 have the time to test it with Tcl 7.6 and Tk 4.2 yet, but it might
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
573 well work.
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
574
4501
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
575 See http://www.sunlabs.com/research/tcl/ for more info on where to get
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
576 Tcl/Tk.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
577
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
578 To enable the Python/Tk interface, once you've built and installed
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
579 Tcl/Tk, all you need to do is edit two lines in Modules/Setup; search
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
580 for the string "_tkinter". Uncomment one (normally the first) of 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
581 lines beginning with "#_tkinter" and un-comment the line beginning
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
582 with "#TKPATH". If you have installed Tcl/Tk or X11 in unusual
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
583 places, you will have to edit the first line to fix or add -I and -L
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
584 options. See the Build Instructions above for more details.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
585
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
586 There is little documentation on how to use Tkinter; however most of
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
587 the Tk manual pages apply quite straightforwardly. Begin with
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
588 fetching the "Tk Lifesaver" document,
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
589 e.g. ftp://ftp.python.org/pub/python/doc/tkinter-doc.tar.gz (a gzipped
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
590 tar file containing a PostScript file) or the on-line version
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
591 http://www.python.org/doc/life-preserver/index.html. Reading 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
592 Tkinter.py source will reveal most details on how Tkinter calls are
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
593 translated into Tcl code.
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
594
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 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
596 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
597 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
598
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
599 Note that there's a Python module called "Tkinter" (capital T) which
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
600 lives in Lib/tkinter/Tkinter.py, and a C module called "_tkinter"
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
601 (lower case t and leading underscore) which lives in
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
602 Modules/_tkinter.c. Demos and normal Tk applications only import 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
603 Python Tkinter module -- only the latter uses the C _tkinter module
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
604 directly. In order to find the C _tkinter module, it must be compiled
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
605 and linked into the Python interpreter -- the _tkinter line in the
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
606 Setup file does this. In order to find the Python Tkinter module,
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
607 sys.path must be set correctly -- the TKPATH assignment in the Setup
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
608 file takes care of this, but only if you install Python properly
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
609 ("make install libinstall"). (You can also use dynamic loading for
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
610 the C _tkinter module, in which case you must manually fix up sys.path
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
611 or set $PYTHONPATH for the Python Tkinter module.)
3008
a51022f1980f 1.3b1 notes
Guido van Rossum <guido@python.org>
parents: 2730
diff changeset
612
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
613
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
614 Distribution structure
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
615 ----------------------
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
616
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
617 Most subdirectories have their own README file. Most files have
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
618 comments.
1453
d773a5f89426 New files
Guido van Rossum <guido@python.org>
parents:
diff changeset
619
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
620 BUGS A list of known bugs (not completely up-to-date)
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
621 Demo/ Demonstration scripts, modules and programs
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
622 Doc/ Documentation (LaTeX sources)
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
623 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
624 Include/ Public header files
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
625 Lib/ Python 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
626 Makefile.in Source from which config.status creates Makefile
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
627 Misc/ Miscellaneous files
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
628 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
629 Objects/ Implementation of most built-in object types
4501
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
630 PC/ PC porting files (DOS, Windows, NT, OS/2)
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
631 Parser/ The parser and tokenizer and their input handling
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
632 Python/ The "compiler" and 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
633 README The file you're reading now
4501
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
634 TODO A list of things that could be done (not up-to-date)
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
635 Tools/ Some useful programs written in 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
636 acconfig.h Additional input for the autoheader program
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
637 config.h.in Source from which config.status creates config.h
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
638 configure Configuration shell script (GNU autoconf output)
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
639 configure.in Configuration specification (GNU autoconf input)
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
640 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
641
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
642 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
643 the configuration and build processes:
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
644
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
645 Makefile Build rules
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
646 config.cache cache of configuration variables
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
647 config.h Configuration header
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
648 config.log log from last configure run
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
649 config.status status from last run of configure script
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
650 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
651 tags, TAGS Tags files for vi and Emacs
1453
d773a5f89426 New files
Guido van Rossum <guido@python.org>
parents:
diff changeset
652
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
653
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
654 Author's address
4134
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
655 ================
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
656
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
657 Guido van Rossum
3698
97b1c2a70eae Some cleanups. Change of address.
Guido van Rossum <guido@python.org>
parents: 3399
diff changeset
658 CNRI
97b1c2a70eae Some cleanups. Change of address.
Guido van Rossum <guido@python.org>
parents: 3399
diff changeset
659 1895 Preston White Drive
3887
957f42ea0f84 Numerous changes, but still a lot of XXX thingies.
Guido van Rossum <guido@python.org>
parents: 3850
diff changeset
660 Reston, VA 20191
3698
97b1c2a70eae Some cleanups. Change of address.
Guido van Rossum <guido@python.org>
parents: 3399
diff changeset
661 USA
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
662
4134
69edc67e5a68 Updated for 1.4beta3
Guido van Rossum <guido@python.org>
parents: 3922
diff changeset
663 E-mail: guido@cnri.reston.va.us or guido@python.org
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
664
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
665
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
666
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
667 Copyright notice
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
668 ================
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
669
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
670 The Python source is copyrighted, but you can freely use and copy it
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
671 as long as you don't change or remove the copyright notice:
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
672
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
673 ----------------------------------------------------------------------
2057
79c171f581fc README: changed URL format to <URL:...>; added section on Tk.
Guido van Rossum <guido@python.org>
parents: 2049
diff changeset
674 Copyright 1991-1995 by Stichting Mathematisch Centrum, Amsterdam,
79c171f581fc README: changed URL format to <URL:...>; added section on Tk.
Guido van Rossum <guido@python.org>
parents: 2049
diff changeset
675 The Netherlands.
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
676
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
677 All Rights Reserved
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
678
1819
a26b31e159be The usual...
Guido van Rossum <guido@python.org>
parents: 1772
diff changeset
679 Permission to use, copy, modify, and distribute this software and its
a26b31e159be The usual...
Guido van Rossum <guido@python.org>
parents: 1772
diff changeset
680 documentation for any purpose and without fee is hereby granted,
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
681 provided that the above copyright notice appear in all copies and that
1819
a26b31e159be The usual...
Guido van Rossum <guido@python.org>
parents: 1772
diff changeset
682 both that copyright notice and this permission notice appear in
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
683 supporting documentation, and that the names of Stichting Mathematisch
4501
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
684 Centrum or CWI or Corporation for National Research Initiatives or
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
685 CNRI not be used in advertising or publicity pertaining to
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
686 distribution of the software without specific, written prior
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
687 permission.
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
688
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
689 While CWI is the initial source for this software, a modified version
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
690 is made available by the Corporation for National Research Initiatives
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
691 (CNRI) at the Internet address ftp://ftp.python.org.
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
692
4501
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
693 STICHTING MATHEMATISCH CENTRUM AND CNRI DISCLAIM ALL WARRANTIES WITH
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
694 REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
695 MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
696 CENTRUM OR CNRI BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
697 DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
698 PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
699 TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
700 PERFORMANCE OF THIS SOFTWARE.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
701 ----------------------------------------------------------------------
1748
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
702
8286a662502b Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1456
diff changeset
703
3698
97b1c2a70eae Some cleanups. Change of address.
Guido van Rossum <guido@python.org>
parents: 3399
diff changeset
704 --Guido van Rossum (home page: http://www.python.org/~guido/)