blob: 5dd3037e997272e3ec6d64c17c53c70959061d01 [file] [log] [blame]
Guido van Rossumb6775db1994-08-01 11:34:53 +00001# The file Setup is used by the makesetup script to construct the files
2# Makefile and config.c, from Makefile.pre and config.c.in,
3# respectively. The file Setup itself is initially copied from
4# Setup.in; once it exists it will not be overwritten, so you can edit
Guido van Rossumf4449de1995-04-10 11:37:18 +00005# Setup to your heart's content. Note that Makefile.pre is created
6# from Makefile.pre.in by the toplevel configure script.
Guido van Rossumb6775db1994-08-01 11:34:53 +00007
8# (VPATH notes: Setup and Makefile.pre are in the build directory, as
Guido van Rossumf4449de1995-04-10 11:37:18 +00009# are Makefile and config.c; the *.in files are in the source
Guido van Rossumb6775db1994-08-01 11:34:53 +000010# directory.)
11
Guido van Rossumfba715a1994-01-02 00:26:09 +000012# Each line in this file describes one or more optional modules.
13# Comment out lines to suppress modules.
14# Lines have the following structure:
15#
Guido van Rossumf6971e21994-08-30 12:25:20 +000016# <module> ... [<sourcefile> ...] [<cpparg> ...] [<library> ...]
Guido van Rossumfba715a1994-01-02 00:26:09 +000017#
Guido van Rossumf6971e21994-08-30 12:25:20 +000018# <sourcefile> is anything ending in .c (.C, .cc, .c++ are C++ files)
Guido van Rossumfba715a1994-01-02 00:26:09 +000019# <cpparg> is anything starting with -I, -D, -U or -C
20# <library> is anything ending in .a or beginning with -l or -L
21# <module> is anything else but should be a valid Python
22# identifier (letters, digits, underscores, beginning with non-digit)
23#
24# Lines can also have the form
25#
26# <name> = <value>
27#
28# which defines a Make variable definition inserted into Makefile.in
Guido van Rossum7cc5abd1994-09-12 10:42:20 +000029#
30# Finally, if a line has the literal form
31#
32# *noconfig*
33#
34# (that is including the '*' and '*' !) then the following modules will
35# not be included in the config.c file, nor in the list of objects to be
36# added to the library archive, and their linker options won't be added
37# to the linker options, but rules to create their .o files and their
Guido van Rossumf4449de1995-04-10 11:37:18 +000038# shared libraries will still be added to the Makefile, and their
39# names will be collected in the Make variable SHAREDMODS. This is
40# used to build modules as shared libraries. (They must be installed
41# using "make sharedinstall".)
Guido van Rossumb6775db1994-08-01 11:34:53 +000042
Guido van Rossumfba715a1994-01-02 00:26:09 +000043# NOTE: As a standard policy, as many modules as can be supported by a
44# platform should be present. The distribution comes with all modules
45# enabled that are supported by most platforms and don't require you
Guido van Rossumf4449de1995-04-10 11:37:18 +000046# to ftp sources from elsewhere.
Guido van Rossumfba715a1994-01-02 00:26:09 +000047
48
Guido van Rossumb6775db1994-08-01 11:34:53 +000049# Some special rules to define PYTHONPATH.
50# Edit the definitions below to indicate which options you are using.
51# Don't add any whitespace or comments!
52
53# Don't edit this (usually)
54DESTLIB=$(prefix)/lib/python
55
Guido van Rossum1c206481995-09-13 18:39:04 +000056# Site specific path insertions -- should begin with : if non-empty
57SITEPATH=
58
59# Standard path -- don't edit
60DESTPATH=:$(DESTLIB)
61
Guido van Rossumb6775db1994-08-01 11:34:53 +000062# Standard enabled (tests are always available)
63TESTPATH=:$(DESTLIB)/test
64
Guido van Rossum7cc5abd1994-09-12 10:42:20 +000065# Path for machine- or system-dependent modules (and shared libraries)
66MACHDEPPATH=:$(DESTLIB)/$(MACHDEP)
Guido van Rossumb6775db1994-08-01 11:34:53 +000067
Guido van Rossum1c206481995-09-13 18:39:04 +000068COREPYTHONPATH=.$(SITEPATH)$(DESTPATH)$(TESTPATH)$(MACHDEPPATH)$(STDWINPATH)$(TKPATH)
Guido van Rossumf5e0ea81994-09-12 15:35:36 +000069PYTHONPATH=$(COREPYTHONPATH)
Guido van Rossumb6775db1994-08-01 11:34:53 +000070
71
Guido van Rossumcaffcdf1995-03-10 15:14:13 +000072# The modules listed here can't be built as shared libraries for
73# various reasons; therefore they are listed here instead of in the
74# normal order.
Guido van Rossum05bf2801994-10-20 22:01:38 +000075
Guido van Rossumf4449de1995-04-10 11:37:18 +000076# Some modules that are normally always on:
Guido van Rossumcaffcdf1995-03-10 15:14:13 +000077
78posix posixmodule.c # posix (UNIX) system calls
79signal signalmodule.c # signal(2)
80
Guido van Rossumf4449de1995-04-10 11:37:18 +000081# The SGI specific GL module:
Guido van Rossumcaffcdf1995-03-10 15:14:13 +000082
Guido van Rossum05bf2801994-10-20 22:01:38 +000083#gl glmodule.c -lgl -lX11 # Graphics Library -- SGI only
Guido van Rossumcaffcdf1995-03-10 15:14:13 +000084
85# Thread module -- works on selected systems only, e.g. SGI IRIX and
86# on SunOS 5.x (SOLARIS) only.
87# Note that you must have configured (and built!) Python with the
Guido van Rossumf4449de1995-04-10 11:37:18 +000088# --with-thread option passed to the configure script for this to work:
Guido van Rossumcaffcdf1995-03-10 15:14:13 +000089
90#thread threadmodule.c
Guido van Rossum05bf2801994-10-20 22:01:38 +000091
92# Uncommenting the following line tells makesetup that all following
Guido van Rossumf4449de1995-04-10 11:37:18 +000093# modules are to be built as shared libraries (see above for more
94# detail):
Guido van Rossum05bf2801994-10-20 22:01:38 +000095
96#*noconfig*
97
98
Guido van Rossumf4449de1995-04-10 11:37:18 +000099# Modules that should always be present (non UNIX dependent):
Guido van Rossumfba715a1994-01-02 00:26:09 +0000100
Guido van Rossumf6971e21994-08-30 12:25:20 +0000101array arraymodule.c # array objects
Guido van Rossumf5e0ea81994-09-12 15:35:36 +0000102math mathmodule.c -lm # math library functions, e.g. sin()
Guido van Rossumf6971e21994-08-30 12:25:20 +0000103parser parsermodule.c # raw interface to the Python parser
Guido van Rossumf6971e21994-08-30 12:25:20 +0000104regex regexmodule.c regexpr.c # Regular expressions, GNU Emacs style
105strop stropmodule.c # fast string operations implemented in C
106struct structmodule.c # binary structure packing/unpacking
107time timemodule.c # time operations and variables
Guido van Rossumfba715a1994-01-02 00:26:09 +0000108
109
Guido van Rossumf4449de1995-04-10 11:37:18 +0000110# Modules with some UNIX dependencies -- on by default:
Guido van Rossumb6775db1994-08-01 11:34:53 +0000111# (If you have a really backward UNIX, select and socket may not be
112# supported...)
Guido van Rossumfba715a1994-01-02 00:26:09 +0000113
Guido van Rossumf6971e21994-08-30 12:25:20 +0000114fcntl fcntlmodule.c # fcntl(2) and ioctl(2)
115pwd pwdmodule.c # pwd(3)
116grp grpmodule.c # grp(3)
Guido van Rossumd4837da1995-02-14 09:43:25 +0000117crypt cryptmodule.c # -lcrypt # crypt(3); needs -lcrypt on some systems
Guido van Rossumf6971e21994-08-30 12:25:20 +0000118select selectmodule.c # select(2); not on ancient System V
119socket socketmodule.c # socket(2); not on ancient System V
Guido van Rossumfba715a1994-01-02 00:26:09 +0000120
121
Guido van Rossumb6775db1994-08-01 11:34:53 +0000122# Some more UNIX dependent modules -- off by default, since these
Guido van Rossumf4449de1995-04-10 11:37:18 +0000123# are not supported by all UNIX systems:
Guido van Rossumb6775db1994-08-01 11:34:53 +0000124
Guido van Rossumf6971e21994-08-30 12:25:20 +0000125#dbm dbmmodule.c # dbm(3) may require -lndbm or similar
126#nis nismodule.c # Sun yellow pages -- not everywhere
Guido van Rossum7cc5abd1994-09-12 10:42:20 +0000127#termios termios.c # Steen Lumholt's termios module
Guido van Rossumb6775db1994-08-01 11:34:53 +0000128
129
130# Multimedia modules -- on by default.
Guido van Rossumf4449de1995-04-10 11:37:18 +0000131# These represent audio samples or images as strings:
Guido van Rossumfba715a1994-01-02 00:26:09 +0000132
Guido van Rossumf6971e21994-08-30 12:25:20 +0000133audioop audioop.c # Operations on audio samples
134imageop imageop.c # Operations on images
135rgbimg rgbimgmodule.c # Read SGI RGB image files (but coded portably)
Guido van Rossumfba715a1994-01-02 00:26:09 +0000136
137
138# The stdwin module provides a simple, portable (between X11 and Mac)
139# windowing interface. You need to ftp the STDWIN library, e.g. from
Guido van Rossumf4449de1995-04-10 11:37:18 +0000140# ftp://ftp.cwi.nl/pub/stdwin. (If you get it elsewhere, be sure to
141# get version 1.0 or higher!) The STDWIN variable must point to the
142# STDWIN toplevel directory.
Guido van Rossumfba715a1994-01-02 00:26:09 +0000143
Guido van Rossumf4449de1995-04-10 11:37:18 +0000144# Uncomment and edit as needed:
Guido van Rossum7cc5abd1994-09-12 10:42:20 +0000145#STDWIN=/ufs/guido/src/stdwin
Guido van Rossumf4449de1995-04-10 11:37:18 +0000146
147# Uncomment these lines:
148#STDWINPATH=:$(DESTLIB)/stdwin
Guido van Rossum7cc5abd1994-09-12 10:42:20 +0000149#LIBTEXTEDIT=$(STDWIN)/$(MACHDEP)/Packs/textedit/libtextedit.a
150#LIBX11STDWIN=$(STDWIN)/$(MACHDEP)/Ports/x11/libstdwin.a
Guido van Rossum7cc5abd1994-09-12 10:42:20 +0000151#stdwin stdwinmodule.c -I$(STDWIN)/H $(LIBTEXTEDIT) $(LIBX11STDWIN) -lX11
152
Guido van Rossumf4449de1995-04-10 11:37:18 +0000153# Use this instead of the last two lines above for alphanumeric stdwin:
154#LIBALFASTDWIN=$(STDWIN)/$(MACHDEP)/Ports/alfa/libstdwin.a
Guido van Rossum7cc5abd1994-09-12 10:42:20 +0000155#stdwin stdwinmodule.c -I$(STDWIN)/H $(LIBTEXTEDIT) $(LIBALFASTDWIN) -ltermcap
156
Guido van Rossumfba715a1994-01-02 00:26:09 +0000157
158# The md5 module implements the RSA Data Security, Inc. MD5
159# Message-Digest Algorithm, described in RFC 1321. The necessary files
160# md5c.c and md5.h are included here.
161
Guido van Rossumf6971e21994-08-30 12:25:20 +0000162md5 md5module.c md5c.c
Guido van Rossumfba715a1994-01-02 00:26:09 +0000163
164
165# The mpz module interfaces to the GNU Multiple Precision library.
Guido van Rossumb6775db1994-08-01 11:34:53 +0000166# You need to ftp the GNU MP library.
167# The GMP variable must point to the GMP source directory.
168# This was originally written and tested against GMP 1.2. I have
169# compiled it against GMP 1.3.2 (the latest I believe) and it seems to
170# work OK, but I haven't tested it thoroughly (lacking knowledge about
171# it).
Guido van Rossumfba715a1994-01-02 00:26:09 +0000172
Guido van Rossumc3706071994-10-06 16:12:06 +0000173# A compatible MP library unencombered by the GPL also exists. It was
174# posted to comp.sources.misc in volume 40 and is widely available from
175# FTP archive sites. One URL for it is:
176# ftp://gatekeeper.dec.com/.b/usenet/comp.sources.misc/volume40/fgmp/part01.Z
177
Guido van Rossumfba715a1994-01-02 00:26:09 +0000178#GMP=/ufs/guido/src/gmp
Guido van Rossumf6971e21994-08-30 12:25:20 +0000179#mpz mpzmodule.c -I$(GMP) $(GMP)/libgmp.a
Guido van Rossumfba715a1994-01-02 00:26:09 +0000180
181
182# SGI IRIX specific modules -- off by default.
Guido van Rossum05bf2801994-10-20 22:01:38 +0000183
Guido van Rossumf4449de1995-04-10 11:37:18 +0000184# These module work on any SGI machine:
Guido van Rossumfba715a1994-01-02 00:26:09 +0000185
Guido van Rossumcaffcdf1995-03-10 15:14:13 +0000186# *** gl must be enabled higher up in this file ***
Guido van Rossum05bf2801994-10-20 22:01:38 +0000187#fm fmmodule.c -lfm -lgl # Font Manager
Guido van Rossum05bf2801994-10-20 22:01:38 +0000188#sgi sgimodule.c # sgi.nap() and a few more
189
190# This module requires the header file
Guido van Rossumf4449de1995-04-10 11:37:18 +0000191# /usr/people/4Dgifts/iristools/include/izoom.h:
Guido van Rossum05bf2801994-10-20 22:01:38 +0000192
193#imgfile imgfile.c -limage -lgutil -lm # Image Processing Utilities
194
195
Guido van Rossumf4449de1995-04-10 11:37:18 +0000196# These modules require the Multimedia Development Option (I think):
Guido van Rossum05bf2801994-10-20 22:01:38 +0000197
198#al almodule.c -laudio # Audio Library
199#cd cdmodule.c -lcdaudio -lds -lmediad # CD Audio Library
200#cl clmodule.c -lcl -lawareaudio # Compression Library
201#sv svmodule.c yuvconvert.c -lsvideo -lXext -lX11 # Starter Video
202
Guido van Rossumfba715a1994-01-02 00:26:09 +0000203
204# The FORMS library, by Mark Overmars, implements user interface
205# components such as dialogs and buttons using SGI's GL and FM
206# libraries. You must ftp the FORMS library separately from
207# ftp://ftp.cs.ruu.nl/pub/SGI/FORMS. It was tested with FORMS 2.2a.
208# The FORMS variable must point to the FORMS subdirectory of the forms
Guido van Rossumf4449de1995-04-10 11:37:18 +0000209# toplevel directory:
Guido van Rossumfba715a1994-01-02 00:26:09 +0000210
211#FORMS=/ufs/guido/src/forms/FORMS
Guido van Rossumbe9f1491994-09-21 12:31:05 +0000212#fl flmodule.c -I$(FORMS) $(FORMS)/libforms.a -lfm -lgl
Guido van Rossumfba715a1994-01-02 00:26:09 +0000213
214
Guido van Rossumf4449de1995-04-10 11:37:18 +0000215# SunOS specific modules -- off by default:
Guido van Rossumfba715a1994-01-02 00:26:09 +0000216
Guido van Rossumbe9f1491994-09-21 12:31:05 +0000217#sunaudiodev sunaudiodev.c
Guido van Rossumfba715a1994-01-02 00:26:09 +0000218
219
Guido van Rossumf4449de1995-04-10 11:37:18 +0000220# George Neville-Neil's timing module:
Guido van Rossumbe9f1491994-09-21 12:31:05 +0000221
222#timing timingmodule.c
Guido van Rossumb6775db1994-08-01 11:34:53 +0000223
224
Guido van Rossum524b5881995-01-04 19:10:35 +0000225# Steen Lumholt's tkinter module.
226#
227# For use with plain Tk, use the first line.
228#
229# For use with extended Tk (i.e. if you have added extra widgets to
230# the Tk library, such as the common "studButton" and "triButton"
231# extensions), edit tkappinit.c, add appropriate -DWITH_... and
232# libraries/objects to the second line, and use that.
233#
234# In all cases also enable the last line (TKPATH).
Guido van Rossumd4837da1995-02-14 09:43:25 +0000235#
Guido van Rossumae75f491995-07-18 18:18:11 +0000236# See the section "The Tk interface" in ../README for more info.
Guido van Rossume4485b01994-09-07 14:32:49 +0000237
Guido van Rossumbe9f1491994-09-21 12:31:05 +0000238# *** Use ONE of the following two lines, see previous comments ***
Guido van Rossume4485b01994-09-07 14:32:49 +0000239#tkinter tkintermodule.c -I/usr/local/include -L/usr/local/lib -ltk -ltcl -lX11
240#tkinter tkintermodule.c tkappinit.c -DWITH_APPINIT -I/usr/local/include -L/usr/local/lib -ltk -ltcl -lX11
Guido van Rossumbe9f1491994-09-21 12:31:05 +0000241
Guido van Rossum524b5881995-01-04 19:10:35 +0000242# *** ALWAYS use this line as well ***
Guido van Rossume4485b01994-09-07 14:32:49 +0000243#TKPATH=:$(DESTLIB)/tkinter
244
245
Guido van Rossumf4449de1995-04-10 11:37:18 +0000246# Lance Ellinghaus's modules:
Guido van Rossumbe9f1491994-09-21 12:31:05 +0000247
Guido van Rossume4485b01994-09-07 14:32:49 +0000248rotor rotormodule.c # enigma-inspired encryption
Guido van Rossumbe9f1491994-09-21 12:31:05 +0000249#syslog syslogmodule.c # syslog daemon interface
Guido van Rossumf8afdcf1995-07-26 17:31:41 +0000250
251
252# Lance's curses module. This requires the System V version of
253# curses, sometimes known as ncurses (e.g. on Linux, link with
Guido van Rossum37ba0bc1995-08-04 04:20:45 +0000254# -lncurses instead of -lcurses; on SunOS 4.1.3, insert -I/usr/5include
255# -L/usr/5lib before -lcurses).
Guido van Rossumf8afdcf1995-07-26 17:31:41 +0000256
257#curses cursesmodule.c -lcurses -ltermcap
Guido van Rossumbe9f1491994-09-21 12:31:05 +0000258
Guido van Rossumb6775db1994-08-01 11:34:53 +0000259
260
Guido van Rossumf4449de1995-04-10 11:37:18 +0000261# Tommy Burnette's 'new' module (creates new empty objects of certain kinds):
Guido van Rossumbe9f1491994-09-21 12:31:05 +0000262
263#new newmodule.c
Guido van Rossumb6775db1994-08-01 11:34:53 +0000264
265
Guido van Rossumf4449de1995-04-10 11:37:18 +0000266# John Redford's sybase module (requires sybase):
Guido van Rossumae75f491995-07-18 18:18:11 +0000267# (Unfortunately this code is orphaned. Read the source for documentation.)
Guido van Rossumbe9f1491994-09-21 12:31:05 +0000268
269#sybase sybasemodule.c
Guido van Rossumb6775db1994-08-01 11:34:53 +0000270
271
Guido van Rossuma3c04b01995-01-12 11:29:01 +0000272# Generic (SunOS / SVR4) dynamic loading module.
273# This is not needed for dynamic loading of Python modules --
274# it is a highly experimental and dangerous device for calling
Guido van Rossumf4449de1995-04-10 11:37:18 +0000275# *arbitrary* C functions in *arbitrary* shared libraries:
Guido van Rossumbe9f1491994-09-21 12:31:05 +0000276
277#dl dlmodule.c
Guido van Rossumb6775db1994-08-01 11:34:53 +0000278
279
Guido van Rossum4b4c6641994-08-08 08:06:37 +0000280# Anthony Baxter's gdbm module (derived from Jack's dbm module)
Guido van Rossumf4449de1995-04-10 11:37:18 +0000281# GNU dbm(3) will require -lgdbm:
Guido van Rossumbe9f1491994-09-21 12:31:05 +0000282
283#gdbm gdbmmodule.c -I/usr/local/include -L/usr/local/lib -lgdbm
Guido van Rossumfba715a1994-01-02 00:26:09 +0000284
Guido van Rossum4b4c6641994-08-08 08:06:37 +0000285
Guido van Rossumd639b451995-08-28 02:59:06 +0000286# Berkeley DB interface.
Guido van Rossumae75f491995-07-18 18:18:11 +0000287#
288# This requires the Berkeley DB code, see
289# ftp://ftp.cs.berkeley.edu/pub/4bsd/db.1.85.tar.gz
290#
291# Edit the variables DB and DBPORT to point to the db top directory
292# and the subdirectory of PORT where you built it.
293
Guido van Rossumf8afdcf1995-07-26 17:31:41 +0000294#DB=/depot/sundry/src/db.1.85/
Guido van Rossumae75f491995-07-18 18:18:11 +0000295#DBPORT=$(DB)/PORT/sunos.5.2
Guido van Rossumf45e5861995-08-30 23:44:41 +0000296#bsddb bsddbmodule.o -I$(DB)/include -I$(DBPORT) $(DBPORT)/libdb.a
Guido van Rossumae75f491995-07-18 18:18:11 +0000297
298
299
Guido van Rossum31affb21995-06-14 22:31:38 +0000300# Andy Bensky's "environment" module (contains putenv())
301#environment environment.c
302
303# David Wayne Williams' soundex module
304#soundex soundex.c
305
Guido van Rossum37ba0bc1995-08-04 04:20:45 +0000306# Objective-C (incomplete!!!)
307#objc.c
308
Jack Jansen72781191995-08-07 14:34:15 +0000309# Helper module for various ascii-encoders
310binascii binasciimodule.c
311
Guido van Rossum31affb21995-06-14 22:31:38 +0000312
Guido van Rossumf4449de1995-04-10 11:37:18 +0000313# Example -- included for reference only:
Guido van Rossumf6971e21994-08-30 12:25:20 +0000314# xx xxmodule.c