Mercurial > cpython-lru_cache-weakref
annotate README @ 1944:8e8fddcbdfd2 legacy-trunk
Hopefully the last edits for 1.1
| author | Guido van Rossum <guido@python.org> |
|---|---|
| date | Thu, 06 Oct 1994 16:15:09 +0000 |
| parents | f84b64df09c3 |
| children | f22cb5fee9c8 |
| rev | line source |
|---|---|
| 1819 | 1 Python release 1.1 |
| 2 ================== | |
|
1748
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
3 |
| 1819 | 4 ==> This is Python version 1.1. |
|
1748
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
5 |
| 1819 | 6 ==> Python 1.1 contains many improvements over 1.0.3, but is almost |
| 7 backward compatible (though the magic number for .pyc file has | |
|
1944
8e8fddcbdfd2
Hopefully the last edits for 1.1
Guido van Rossum <guido@python.org>
parents:
1882
diff
changeset
|
8 changed). It is portable to many more non-UNIX platforms. |
|
1748
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
9 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
10 ==> If you don't know yet what Python is: it's an interpreted, |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
11 extensible, embeddable, interactive, object-oriented programming |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
12 language. For a quick summary of what Python can mean for a |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
13 UNIX/C programmer, read Misc/BLURB.LUTZ. |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
14 |
|
1944
8e8fddcbdfd2
Hopefully the last edits for 1.1
Guido van Rossum <guido@python.org>
parents:
1882
diff
changeset
|
15 ==> If you want to start compiling right away (on UNIX): just type |
|
8e8fddcbdfd2
Hopefully the last edits for 1.1
Guido van Rossum <guido@python.org>
parents:
1882
diff
changeset
|
16 "./configure" in the current directory and when it finishes, type |
|
8e8fddcbdfd2
Hopefully the last edits for 1.1
Guido van Rossum <guido@python.org>
parents:
1882
diff
changeset
|
17 "make". See the section Build Instructions below for more |
|
8e8fddcbdfd2
Hopefully the last edits for 1.1
Guido van Rossum <guido@python.org>
parents:
1882
diff
changeset
|
18 details. |
|
1748
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
19 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
20 ==> All documentation is in the subdirectory Doc in the form of LaTeX |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
21 files. In order of importance for new users: Tutorial (tut), |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
22 Library Reference (lib), Language Reference (ref), Extending |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
23 (ext). Note that especially the Library Reference is of immense |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
24 value since much of Python's power (including the built-in data |
|
1944
8e8fddcbdfd2
Hopefully the last edits for 1.1
Guido van Rossum <guido@python.org>
parents:
1882
diff
changeset
|
25 types and functions!) is described there. [NB The ext document |
|
1748
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
26 has not been updated to reflect this release yet.] |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
27 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
28 ==> Python is COPYRIGHTED but free to use for all. See the copyright |
|
1944
8e8fddcbdfd2
Hopefully the last edits for 1.1
Guido van Rossum <guido@python.org>
parents:
1882
diff
changeset
|
29 notice at the end of this file. Moreover, the Python distribution |
|
8e8fddcbdfd2
Hopefully the last edits for 1.1
Guido van Rossum <guido@python.org>
parents:
1882
diff
changeset
|
30 is not affected by the GNU Public Licence (GPL). There is support |
|
8e8fddcbdfd2
Hopefully the last edits for 1.1
Guido van Rossum <guido@python.org>
parents:
1882
diff
changeset
|
31 for interfaces to some GNU code but this is entirely optional and |
|
8e8fddcbdfd2
Hopefully the last edits for 1.1
Guido van Rossum <guido@python.org>
parents:
1882
diff
changeset
|
32 no GNU code is distributed with Python. For all these packages, |
|
8e8fddcbdfd2
Hopefully the last edits for 1.1
Guido van Rossum <guido@python.org>
parents:
1882
diff
changeset
|
33 GPL-free public domain versions also exist. |
|
1748
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
34 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
35 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
36 Build instructions |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
37 ------------------ |
| 1453 | 38 |
|
1748
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
39 Before you start building Python, you must first configure it. This |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
40 entails (at least) running the script "./configure", which figures out |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
41 your system configuration and creates several Makefiles. (This will |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
42 take a minute or two -- please be patient!) When it is done, you are |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
43 ready to run make. Typing "make" in the toplevel directory will |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
44 recursively run make in each of the subdirectories Parser, Objects, |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
45 Python and Modules, creating a library file in each one. The |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
46 executable of the interpreter is built in the Modules subdirectory but |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
47 moved up here when it is built. If you want or need to, you can also |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
48 chdir into each subdirectory in turn and run make there manually |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
49 (do the Modules subdirectory last!). If you run into trouble, first |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
50 see the section Troubleshooting later in this file. |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
51 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
52 EXCEPTIONS: on SVR4 derived systems, you need to pass the configure |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
53 script the option --with-svr4. See below for more options you can |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
54 pass to the configure script. |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
55 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
56 AIX users: read the file Misc/AIX-NOTES before trying to build. |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
57 |
| 1882 | 58 HP-UX users: read the file Misc/HPUX-NOTES if you want to be able to |
| 59 use shared libraries for dynamically loaded modules. | |
| 60 | |
|
1748
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
61 Minix users: when using ack, use "CC=cc AR=aal RANLIB=: ./configure"! |
| 1453 | 62 |
|
1748
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
63 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
|
64 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
|
65 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
|
66 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
|
67 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
|
68 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
|
69 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
|
70 will automatically be rebuilt the next time you run make in the |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
71 toplevel directory. (There are some example Setup files which you may |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
72 copy to Setup for specific systems; have a look at Setup.*.) |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
73 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
74 If you want to change the optimization level of the build, assign to |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
75 the OPT variable on the toplevel make command; e.g. "make OPT=-g" will |
| 1819 | 76 build a debugging version of Python on most platforms. The default is |
| 77 OPT=-O; a value for OPT in the environment when the configure script | |
| 78 is run overrides this default (likewise for CC; and the initial value | |
| 79 for LIBS is used as the base set of libraries to link with). | |
| 1453 | 80 |
|
1748
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
81 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
|
82 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
|
83 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
|
84 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
|
85 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
|
86 with the interpreter.) |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
87 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
88 To install the interpreter as /usr/local/bin/python, type "make |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
89 install". To install the library as /usr/local/lib/python, type "make |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
90 libinstall". To install the manual page as |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
91 /usr/local/man/man1/python.1, type "make maninstall". To install the |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
92 Emacs editing mode for python, manually copy the file |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
93 Misc/python-mode.el to your local Emacs lisp directory. The directory |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
94 /usr/local can be overridden at configuration time by passing |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
95 --prefix=DIRECTORY to the configure script, or at make time by passing |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
96 "prefix=DIRECTORY" to make. See below for more information on --prefix. |
| 1453 | 97 |
|
1748
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
98 If you plan to do development of extension modules or to embed Python |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
99 in another application and don't want to reference the original source |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
100 tree, you can type "make inclinstall" and "make libainstall" to |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
101 install the include files and lib*.a files, respectively, as |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
102 /usr/local/include/Py/*.h and /usr/local/lib/python/lib/lib*.a. The |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
103 make libainstall target also installs copies of several other files |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
104 used or produced during the build process which are needed to build |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
105 extensions or to generate their Makefiles. |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
106 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
107 To print the documentation, cd into the Doc subdirectory, type "make" |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
108 (let's hope you have LaTeX installed!), and send the four resulting |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
109 PostScript files (tut.ps, lib.ps, ref.ps, and ext.ps) to the printer. |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
110 See the README file there; you can also build a texinfo version of the |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
111 library manual and from that construct an Emacs info version (the |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
112 hypertext format used by the Emacs "info" command) and an HTML version |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
113 (the hypertext format used by the World Wide Web distributed |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
114 information initiative). You don't need to have LaTeX installed for |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
115 this. Note that the Python archive sites also carry the resulting |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
116 PostScript files, in case you have a PostScript printer but not LaTeX. |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
117 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
118 Some special cases are handled by passing environment variables or |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
119 options to the configure script: |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
120 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
121 - The configure script uses gcc (the GNU C compiler) if it finds it. |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
122 If you don't want this, or if this compiler is installed but broken on |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
123 your platform, pass "CC=cc" (or whatever the name of the proper C |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
124 compiler is) in the environment. |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
125 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
126 - On System V, Release 4 derived systems (e.g. SOLARIS 2, but not |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
127 IRIX 5) you need to call the configure script with the option |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
128 --with-svr4. This is needed so the libraries -lnsl and -lsocket are |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
129 found. (On some other systems, e.g. IRIX 5, these libraries exist but |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
130 are incompatible with other system libraries such as X11 and GL.) |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
131 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
132 - If you want to install the binaries and the Python library somewhere |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
133 else than in /usr/local/{bin,lib}, you can pass the option |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
134 --prefix=DIRECTORY; the interpreter binary will be installed as |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
135 DIRECTORY/bin/python and the library files as DIRECTORY/lib/python/*. |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
136 If you pass --exec-prefix=DIRECTORY (as well) this overrides the |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
137 installation prefix for architecture-dependent files (like the |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
138 interpreter binary). Note that --prefix=DIRECTORY also affects the |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
139 default module search path (sys.path), when Modules/config.c is |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
140 compiled. Passing make the option prefix=DIRECTORY (and/or |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
141 exec_prefix=DIRECTORY) overrides the prefix set at configuration time; |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
142 this may be more convenient than re-running the configure script if |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
143 you change your mind about the install prefix... |
| 1453 | 144 |
|
1772
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
145 - You can use the GNU readline library to improve the interactive user |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
146 interface: this gives you line editing and command history when |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
147 calling python interactively. You need to configure build the GNU |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
148 readline library before running the configure script. Its sources are |
|
1944
8e8fddcbdfd2
Hopefully the last edits for 1.1
Guido van Rossum <guido@python.org>
parents:
1882
diff
changeset
|
149 not distributed with Python; you can ftp them from any GNU mirror |
|
8e8fddcbdfd2
Hopefully the last edits for 1.1
Guido van Rossum <guido@python.org>
parents:
1882
diff
changeset
|
150 site, or from its home site: |
|
1772
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
151 ftp://slc2.ins.cwru.edu/pub/dist/readline-2.0.tar.gz (or a higher |
|
1944
8e8fddcbdfd2
Hopefully the last edits for 1.1
Guido van Rossum <guido@python.org>
parents:
1882
diff
changeset
|
152 version number -- using version 1.x is not recommended). |
|
8e8fddcbdfd2
Hopefully the last edits for 1.1
Guido van Rossum <guido@python.org>
parents:
1882
diff
changeset
|
153 |
|
8e8fddcbdfd2
Hopefully the last edits for 1.1
Guido van Rossum <guido@python.org>
parents:
1882
diff
changeset
|
154 A GPL-free version was posted to comp.sources.misc in volume 31 and is |
|
8e8fddcbdfd2
Hopefully the last edits for 1.1
Guido van Rossum <guido@python.org>
parents:
1882
diff
changeset
|
155 widely available from FTP archive sites. One URL for it is: |
|
8e8fddcbdfd2
Hopefully the last edits for 1.1
Guido van Rossum <guido@python.org>
parents:
1882
diff
changeset
|
156 ftp://gatekeeper.dec.com/.b/usenet/comp.sources.misc/volume31/editline/part01.Z |
|
8e8fddcbdfd2
Hopefully the last edits for 1.1
Guido van Rossum <guido@python.org>
parents:
1882
diff
changeset
|
157 |
|
8e8fddcbdfd2
Hopefully the last edits for 1.1
Guido van Rossum <guido@python.org>
parents:
1882
diff
changeset
|
158 Pass the Python configure script the option --with-readline=DIRECTORY |
|
8e8fddcbdfd2
Hopefully the last edits for 1.1
Guido van Rossum <guido@python.org>
parents:
1882
diff
changeset
|
159 where DIRECTORY is the absolute pathname of the directory where you've |
|
8e8fddcbdfd2
Hopefully the last edits for 1.1
Guido van Rossum <guido@python.org>
parents:
1882
diff
changeset
|
160 built the readline library. Some hints on building and using the |
|
8e8fddcbdfd2
Hopefully the last edits for 1.1
Guido van Rossum <guido@python.org>
parents:
1882
diff
changeset
|
161 readline library: |
|
1772
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
162 |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
163 - On SGI IRIX 5, you may have to add the following |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
164 to rldefs.h: |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
165 |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
166 #ifndef sigmask |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
167 #define sigmask(sig) (1L << ((sig)-1)) |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
168 #endif |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
169 |
| 1819 | 170 - On most systems, you will have to add #include "rldefs.h" to the |
| 171 top of several source files, and if you use the VPATH feature, you | |
| 172 will have to add dependencies of the form foo.o: foo.c to the | |
| 173 Makefile for several values of foo. | |
| 174 | |
|
1772
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
175 - The readline library requires use of the termcap library. A |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
176 known problem with this is that it contains entry points which |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
177 cause conflicts with the STDWIN and SGI GL libraries. The stdwin |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
178 conflict can be solved (and will be, in the next release of |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
179 stdwin) by adding a line saying '#define werase w_erase' to the |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
180 stdwin.h file (in the stdwin distribution, subdirectory H). The |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
181 GL conflict has been solved in the Python configure script by a |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
182 hack that forces use of the static version of the termcap library. |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
183 |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
184 - Check the newsgroup gnu.bash.bugs for specific problems with the |
| 1819 | 185 readline library (I don't get this group here but I've been told |
| 186 that it is the place for readline bugs.) | |
|
1748
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
187 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
188 - On SGI IRIX, and on Sun SOLARIS 2, you can use multiple threads. To |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
189 enable this, pass --with-thread. In the Modules/Setup file, enable |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
190 the thread module. (Threads aren't enabled automatically because |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
191 there are run-time penalties when support for them is compiled in even |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
192 if you don't use them.) |
| 1453 | 193 |
|
1748
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
194 - On SGI IRIX, there are modules that interface to many SGI specific |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
195 system libraries, e.g. the GL library and the audio hardware. To |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
196 enable these modules, you must edit the Modules/Setup file (or copy the |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
197 Setup.irix4 file to it). |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
198 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
199 - On SGI IRIX 4, dynamic loading of extension modules is supported by |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
200 the "dl" library by Jack Jansen, which is ftp'able from |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
201 ftp://ftp.cwi.nl/pub/dynload/dl-1.6.tar.Z. This is enabled (after |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
202 you've ftp'ed and compiled the dl library!) by passing |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
203 --with-sgi-dl=DIRECTORY where DIRECTORY is the absolute pathname of |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
204 the dl library. (Don't bother on IRIX 5, it already has dynamic |
| 1819 | 205 linking using SunOS style shared libraries.) Support for this feature |
| 206 is deprecated. | |
|
1748
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
207 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
208 - Dynamic loading of modules is rumoured to be supported on some other |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
209 systems: VAX (Ultrix), Sun3 (SunOS 3.4), Sequent Symmetry (Dynix), and |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
210 Atari ST. This is done using a combination of the GNU dynamic loading |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
211 package (ftp://ftp.cwi.nl/pub/dynload/dl-dld-1.1.tar.Z) and an |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
212 emulation of the SGI dl library mentioned above (the emulation can be |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
213 found at ftp://ftp.cwi.nl/pub/dynload/dld-3.2.3.tar.Z). To enable |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
214 this, ftp and compile both libraries, then call the configure passing |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
215 it the option --with-dl-dld=DL_DIRECTORY,DLD_DIRECTORY where |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
216 DL_DIRECTORY is the absolute pathname of the dl emulation library and |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
217 DLD_DIRECTORY is the absolute pathname of the GNU dld library. (Don't |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
218 bother on SunOS 4 or 5, they already have dynamic linking using shared |
| 1819 | 219 libraries.) Support for this feature is deprecated. |
|
1748
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
220 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
221 - It is possible to specify alternative versions for the Math library |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
222 (default -lm) and the C library (default the empty string) using the |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
223 options --with-libm=STRING and --with-libc=STRING, respectively. E.g. |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
224 if your system requires that you pass -lc_s to the C compiler to use |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
225 the shared C library, you can pass --with-libc=-lc_s. These libraries |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
226 are passed after all other libraries, the C library last. |
| 1453 | 227 |
|
1748
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
228 You can also build an "extended" interpreter, using modules that are |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
229 not contained in the Modules directory. Extensions are distributed as |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
230 a separate tar file (currently extensions.tar.Z). See the README file |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
231 there. |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
232 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
233 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
234 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
|
235 ------------------------------------------------------------- |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
236 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
237 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
|
238 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
|
239 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
|
240 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
|
241 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
|
242 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
|
243 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
|
244 contain a line VPATH=... which points to directory containing the |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
245 actual sources. |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
246 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
247 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
|
248 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
|
249 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
|
250 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
251 $ mkdir /usr/tmp/python |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
252 $ cd /usr/tmp/python |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
253 $ ~guido/src/python/configure |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
254 [...] |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
255 $ make |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
256 [...] |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
257 $ |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
258 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
259 To use the readline library in this case, you will have to create a |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
260 subdirectory of your build directory called readline, copy |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
261 readline/Makefile into it, edit the Makefile to contain a proper VPATH |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
262 line (and possibly edit the compiler flags set in the Makefile), and |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
263 pass the configure script a --with-readline=DIRECTORY option giving it |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
264 the absolute (!) pathname of the readline build directory. |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
265 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
266 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
|
267 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
|
268 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
|
269 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
|
270 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
|
271 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
|
272 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
|
273 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
|
274 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
|
275 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
|
276 |
| 1453 | 277 |
|
1748
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
278 Troubleshooting |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
279 --------------- |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
280 |
| 1819 | 281 See section 3 of the FAQ (in subdirectory Misc of the distribution) |
| 282 for hints on what can go wrong, and how to fix it. | |
|
1748
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
283 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
284 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
285 Building on non-UNIX systems |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
286 ---------------------------- |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
287 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
288 On non-UNIX systems, you will have to fake the effect of running the |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
289 configure script manually. A good start is to copy the file |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
290 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
|
291 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
|
292 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
|
293 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
|
294 as void, and the *_t type symbols must be defined as some variant of |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
295 int if they need to be defined at all. Then arrange that the symbol |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
296 HAVE_CONFIG_H is defined during compilation (usually by passing an |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
297 argument of the form `-DHAVE_CONFIG_H' to the compiler, but this is |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
298 necessarily system-dependent). |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
299 |
| 1819 | 300 I have tried to collect instructions, Makefiles and additional sources |
| 301 for various platforms in this release. The following directories | |
| 302 exist: | |
| 303 | |
| 304 Mac/ Apple Macintosh, using THINK C 6.0 or MPW 3.2. | |
| 305 Dos/ MS-DOS and Windows 3.1, using Microsoft C. | |
| 306 Nt/ Windows NT, using Microsoft Visual C/C++. | |
| 307 Os2/ OS/2. | |
| 308 | |
| 309 Most of these instructions were last tested with a previous Python | |
| 310 release, so you may still experience occasional problems. If you have | |
| 311 fixes or suggestions, please let me know and I'll try to incorporate | |
| 312 them in the next release. | |
| 313 | |
| 1453 | 314 |
|
1748
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
315 Distribution structure |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
316 ---------------------- |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
317 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
318 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
|
319 comments. |
| 1453 | 320 |
|
1748
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
321 ChangeLog A raw list of changes since the first 1.0.0 BETA release |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
322 Demo/ Demonstration scripts, modules and programs |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
323 Doc/ Documentation (in LaTeX) |
| 1819 | 324 Extensions/ Extension modules (distributed separately) |
|
1748
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
325 Grammar/ Input for the parser generator |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
326 Include/ Public header files |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
327 Lib/ Python library modules |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
328 Makefile Rules for building the distribution |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
329 Misc/ Miscellaneous files |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
330 Modules/ Implementation of most built-in modules |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
331 Objects/ Implementation of most built-in object types |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
332 Parser/ The parser and tokenizer and their input handling |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
333 Python/ The "compiler" and interpreter |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
334 README The file you're reading now |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
335 acconfig.h Additional input for the autoheader program |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
336 config.h Configuration header (generated) |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
337 config.h.in Source from which config.status creates config.h |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
338 config.status status from last run of configure script (generated) |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
339 configure Configuration shell script (GNU autoconf output) |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
340 configure.in Configuration specification (GNU autoconf input) |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
341 tags, TAGS Tags files for vi and Emacs (generated) |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
342 python The executable interpreter (generated) |
| 1453 | 343 |
|
1748
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
344 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
345 Ftp access |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
346 ---------- |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
347 |
|
1772
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
348 The latest Python source distribution can be ftp'ed from |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
349 ftp://ftp.cwi.nl/pub/python/python<version>.tar.gz. You can also find |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
350 PostScript of the main Python documentation there, Macintosh and PC |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
351 binaries, and the latest STDWIN source distribution (in directory |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
352 /pub/stdwin). oFr mirror sites, see the list in the FAQ (Misc/FAQ |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
353 this directory). |
|
1748
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
354 |
| 1453 | 355 |
|
1772
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
356 Mailing list and Newsgroup |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
357 -------------------------- |
|
1748
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
358 |
|
1772
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
359 There are a mailing list and a newsgroup devoted to Python |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
360 programming, design and bugs. The newsgroup, comp.lang.python, |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
361 contains exactly the same messages as the mailing list. To subscribe |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
362 to the mailing list, send mail containing your real name and e-mail |
|
7b3a767924a1
Rewrote sections on GNU readline (now that I'm using 2.0), ftp, and
Guido van Rossum <guido@python.org>
parents:
1748
diff
changeset
|
363 address in Internet form to "python-list-request@cwi.nl". |
|
1748
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
364 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
365 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
366 Author |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
367 ------ |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
368 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
369 Guido van Rossum |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
370 CWI, dept. CST |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
371 P.O. Box 94079 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
372 1090 GB Amsterdam |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
373 The Netherlands |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
374 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
375 E-mail: Guido.van.Rossum@cwi.nl |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
376 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
377 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
378 Copyright Notice |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
379 ---------------- |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
380 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
381 The Python source is copyrighted, but you can freely use and copy it |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
382 as long as you don't change or remove the copyright: |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
383 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
384 Copyright 1991, 1992, 1993, 1994 by Stichting Mathematisch Centrum, |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
385 Amsterdam, The Netherlands. |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
386 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
387 All Rights Reserved |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
388 |
| 1819 | 389 Permission to use, copy, modify, and distribute this software and its |
| 390 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
|
391 provided that the above copyright notice appear in all copies and that |
| 1819 | 392 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
|
393 supporting documentation, and that the names of Stichting Mathematisch |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
394 Centrum or CWI not be used in advertising or publicity pertaining to |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
395 distribution of the software without specific, written prior permission. |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
396 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
397 STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
398 THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
399 FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH CENTRUM BE LIABLE |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
400 FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
401 WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
402 ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
403 OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
404 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
405 |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
406 Signature |
|
8286a662502b
Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents:
1456
diff
changeset
|
407 --------- |
| 1453 | 408 |
| 409 --Guido van Rossum, CWI, Amsterdam <Guido.van.Rossum@cwi.nl> | |
| 1819 | 410 <URL:http://www.cwi.nl/cwi/people/Guido.van.Rossum.html> |