blob: 12bd67358a72b2538c2b318e84df6fd4d03a9586 [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#
Guido van Rossum613b9431996-08-20 19:50:17 +000024# (As the makesetup script changes, it may recognize some other
25# arguments as well, e.g. *.so and *.sl as libraries. See the big
26# case statement in the makesetup script.)
27#
Guido van Rossumfba715a1994-01-02 00:26:09 +000028# Lines can also have the form
29#
30# <name> = <value>
31#
32# which defines a Make variable definition inserted into Makefile.in
Guido van Rossum7cc5abd1994-09-12 10:42:20 +000033#
34# Finally, if a line has the literal form
35#
Guido van Rossum613b9431996-08-20 19:50:17 +000036# *shared*
Guido van Rossum7cc5abd1994-09-12 10:42:20 +000037#
38# (that is including the '*' and '*' !) then the following modules will
39# not be included in the config.c file, nor in the list of objects to be
40# added to the library archive, and their linker options won't be added
41# to the linker options, but rules to create their .o files and their
Guido van Rossumf4449de1995-04-10 11:37:18 +000042# shared libraries will still be added to the Makefile, and their
43# names will be collected in the Make variable SHAREDMODS. This is
44# used to build modules as shared libraries. (They must be installed
Guido van Rossum613b9431996-08-20 19:50:17 +000045# using "make sharedinstall".) (For compatibility, *noconfig* has the
46# same effect as *shared*.)
Guido van Rossumb6775db1994-08-01 11:34:53 +000047
Guido van Rossumfba715a1994-01-02 00:26:09 +000048# NOTE: As a standard policy, as many modules as can be supported by a
49# platform should be present. The distribution comes with all modules
50# enabled that are supported by most platforms and don't require you
Guido van Rossumf4449de1995-04-10 11:37:18 +000051# to ftp sources from elsewhere.
Guido van Rossumfba715a1994-01-02 00:26:09 +000052
53
Guido van Rossum02530b01996-07-31 22:43:38 +000054# -------> Uncomment this line if you are running AIX <----------
55# -------> and if you are building with shared libraries <----------
56#LINKCC= makexp_aix python.exp "" $(MYLIBS) $(ADDOBJS) ; $(CC)
57
58
Guido van Rossumb6775db1994-08-01 11:34:53 +000059# Some special rules to define PYTHONPATH.
60# Edit the definitions below to indicate which options you are using.
61# Don't add any whitespace or comments!
62
Guido van Rossum0c5e3c81996-07-31 17:49:01 +000063# Directories where library files get installed.
64# DESTLIB is for Python modules; MACHDESTLIB for shared libraries.
65DESTLIB=$(LIBDEST)
66MACHDESTLIB=$(BINLIBDEST)
Guido van Rossumb6775db1994-08-01 11:34:53 +000067
Guido van Rossum0c5e3c81996-07-31 17:49:01 +000068# Standard path -- don't edit.
69# No leading colon since this is the first entry
Guido van Rossum02ca3ab1996-07-30 20:36:59 +000070DESTPATH=$(DESTLIB)
Guido van Rossum1c206481995-09-13 18:39:04 +000071
Guido van Rossum0c5e3c81996-07-31 17:49:01 +000072# Site specific path components -- should begin with : if non-empty
73SITEPATH=
74
75# Standard path components for test modules
Guido van Rossumb6775db1994-08-01 11:34:53 +000076TESTPATH=:$(DESTLIB)/test
77
Guido van Rossumd3c1bd31996-07-30 16:54:03 +000078# Path components for machine- or system-dependent modules and shared libraries
79MACHDEPPATH=:$(DESTLIB)/$(MACHDEP):$(MACHDESTLIB)/sharedmodules
Guido van Rossumb6775db1994-08-01 11:34:53 +000080
Guido van Rossum02ca3ab1996-07-30 20:36:59 +000081COREPYTHONPATH=$(DESTPATH)$(SITEPATH)$(TESTPATH)$(MACHDEPPATH)$(STDWINPATH)$(TKPATH)
Guido van Rossumf5e0ea81994-09-12 15:35:36 +000082PYTHONPATH=$(COREPYTHONPATH)
Guido van Rossumb6775db1994-08-01 11:34:53 +000083
84
Guido van Rossumcaffcdf1995-03-10 15:14:13 +000085# The modules listed here can't be built as shared libraries for
86# various reasons; therefore they are listed here instead of in the
87# normal order.
Guido van Rossum05bf2801994-10-20 22:01:38 +000088
Guido van Rossumf4449de1995-04-10 11:37:18 +000089# Some modules that are normally always on:
Guido van Rossumcaffcdf1995-03-10 15:14:13 +000090
91posix posixmodule.c # posix (UNIX) system calls
92signal signalmodule.c # signal(2)
93
Guido van Rossumf4449de1995-04-10 11:37:18 +000094# The SGI specific GL module:
Guido van Rossumcaffcdf1995-03-10 15:14:13 +000095
Guido van Rossum05bf2801994-10-20 22:01:38 +000096#gl glmodule.c -lgl -lX11 # Graphics Library -- SGI only
Guido van Rossumcaffcdf1995-03-10 15:14:13 +000097
Guido van Rossumd3c1bd31996-07-30 16:54:03 +000098# Thread module -- use only if Python has thread support for your OS.
Guido van Rossumcaffcdf1995-03-10 15:14:13 +000099# Note that you must have configured (and built!) Python with the
Guido van Rossumf4449de1995-04-10 11:37:18 +0000100# --with-thread option passed to the configure script for this to work:
Guido van Rossumcaffcdf1995-03-10 15:14:13 +0000101
102#thread threadmodule.c
Guido van Rossum05bf2801994-10-20 22:01:38 +0000103
104# Uncommenting the following line tells makesetup that all following
Guido van Rossumf4449de1995-04-10 11:37:18 +0000105# modules are to be built as shared libraries (see above for more
106# detail):
Guido van Rossum05bf2801994-10-20 22:01:38 +0000107
Guido van Rossum613b9431996-08-20 19:50:17 +0000108#*shared*
Guido van Rossum05bf2801994-10-20 22:01:38 +0000109
110
Guido van Rossumf4449de1995-04-10 11:37:18 +0000111# Modules that should always be present (non UNIX dependent):
Guido van Rossumfba715a1994-01-02 00:26:09 +0000112
Guido van Rossumf6971e21994-08-30 12:25:20 +0000113array arraymodule.c # array objects
Guido van Rossum613b9431996-08-20 19:50:17 +0000114cmath cmathmodule.c # -lm # complex math library functions
115math mathmodule.c # -lm # math library functions, e.g. sin()
Guido van Rossumf6971e21994-08-30 12:25:20 +0000116regex regexmodule.c regexpr.c # Regular expressions, GNU Emacs style
117strop stropmodule.c # fast string operations implemented in C
118struct structmodule.c # binary structure packing/unpacking
Guido van Rossum613b9431996-08-20 19:50:17 +0000119time timemodule.c # -lm # time operations and variables
Guido van Rossumd3c1bd31996-07-30 16:54:03 +0000120operator operator.c # operator.add() and similar goodies
Guido van Rossumfba715a1994-01-02 00:26:09 +0000121
122
Guido van Rossumf4449de1995-04-10 11:37:18 +0000123# Modules with some UNIX dependencies -- on by default:
Guido van Rossumb6775db1994-08-01 11:34:53 +0000124# (If you have a really backward UNIX, select and socket may not be
125# supported...)
Guido van Rossumfba715a1994-01-02 00:26:09 +0000126
Guido van Rossumf6971e21994-08-30 12:25:20 +0000127fcntl fcntlmodule.c # fcntl(2) and ioctl(2)
128pwd pwdmodule.c # pwd(3)
129grp grpmodule.c # grp(3)
Guido van Rossumd4837da1995-02-14 09:43:25 +0000130crypt cryptmodule.c # -lcrypt # crypt(3); needs -lcrypt on some systems
Guido van Rossumf6971e21994-08-30 12:25:20 +0000131select selectmodule.c # select(2); not on ancient System V
132socket socketmodule.c # socket(2); not on ancient System V
Guido van Rossumd3c1bd31996-07-30 16:54:03 +0000133errno errnomodule.c # posix (UNIX) errno values
Guido van Rossumfba715a1994-01-02 00:26:09 +0000134
135
Guido van Rossumb6775db1994-08-01 11:34:53 +0000136# Some more UNIX dependent modules -- off by default, since these
Guido van Rossumf4449de1995-04-10 11:37:18 +0000137# are not supported by all UNIX systems:
Guido van Rossumb6775db1994-08-01 11:34:53 +0000138
Guido van Rossumf6971e21994-08-30 12:25:20 +0000139#dbm dbmmodule.c # dbm(3) may require -lndbm or similar
140#nis nismodule.c # Sun yellow pages -- not everywhere
Guido van Rossum7cc5abd1994-09-12 10:42:20 +0000141#termios termios.c # Steen Lumholt's termios module
Guido van Rossum73363b51996-08-19 22:58:53 +0000142#_xdr xdrmodule.c # -lnsl # Helper for xdrlib.py
Guido van Rossumb6775db1994-08-01 11:34:53 +0000143
144
145# Multimedia modules -- on by default.
Guido van Rossumf4449de1995-04-10 11:37:18 +0000146# These represent audio samples or images as strings:
Guido van Rossumfba715a1994-01-02 00:26:09 +0000147
Guido van Rossumf6971e21994-08-30 12:25:20 +0000148audioop audioop.c # Operations on audio samples
149imageop imageop.c # Operations on images
150rgbimg rgbimgmodule.c # Read SGI RGB image files (but coded portably)
Guido van Rossumfba715a1994-01-02 00:26:09 +0000151
152
153# The stdwin module provides a simple, portable (between X11 and Mac)
154# windowing interface. You need to ftp the STDWIN library, e.g. from
Guido van Rossumf4449de1995-04-10 11:37:18 +0000155# ftp://ftp.cwi.nl/pub/stdwin. (If you get it elsewhere, be sure to
156# get version 1.0 or higher!) The STDWIN variable must point to the
157# STDWIN toplevel directory.
Guido van Rossumfba715a1994-01-02 00:26:09 +0000158
Guido van Rossumf4449de1995-04-10 11:37:18 +0000159# Uncomment and edit as needed:
Guido van Rossum7cc5abd1994-09-12 10:42:20 +0000160#STDWIN=/ufs/guido/src/stdwin
Guido van Rossumf4449de1995-04-10 11:37:18 +0000161
162# Uncomment these lines:
163#STDWINPATH=:$(DESTLIB)/stdwin
Guido van Rossum7cc5abd1994-09-12 10:42:20 +0000164#LIBTEXTEDIT=$(STDWIN)/$(MACHDEP)/Packs/textedit/libtextedit.a
165#LIBX11STDWIN=$(STDWIN)/$(MACHDEP)/Ports/x11/libstdwin.a
Guido van Rossum7cc5abd1994-09-12 10:42:20 +0000166#stdwin stdwinmodule.c -I$(STDWIN)/H $(LIBTEXTEDIT) $(LIBX11STDWIN) -lX11
167
Guido van Rossumf4449de1995-04-10 11:37:18 +0000168# Use this instead of the last two lines above for alphanumeric stdwin:
169#LIBALFASTDWIN=$(STDWIN)/$(MACHDEP)/Ports/alfa/libstdwin.a
Guido van Rossum7cc5abd1994-09-12 10:42:20 +0000170#stdwin stdwinmodule.c -I$(STDWIN)/H $(LIBTEXTEDIT) $(LIBALFASTDWIN) -ltermcap
171
Guido van Rossumfba715a1994-01-02 00:26:09 +0000172
173# The md5 module implements the RSA Data Security, Inc. MD5
174# Message-Digest Algorithm, described in RFC 1321. The necessary files
175# md5c.c and md5.h are included here.
176
Guido van Rossumf6971e21994-08-30 12:25:20 +0000177md5 md5module.c md5c.c
Guido van Rossumfba715a1994-01-02 00:26:09 +0000178
179
180# The mpz module interfaces to the GNU Multiple Precision library.
Guido van Rossumb6775db1994-08-01 11:34:53 +0000181# You need to ftp the GNU MP library.
182# The GMP variable must point to the GMP source directory.
Guido van Rossum272841c1996-08-19 23:06:45 +0000183# This was originally written and tested against GMP 1.2 and 1.3.2.
184# It has been modified by Rob Hooft to work with 2.0.2 as well, but I
185# haven't tested it recently.
Guido van Rossumfba715a1994-01-02 00:26:09 +0000186
Guido van Rossumc3706071994-10-06 16:12:06 +0000187# A compatible MP library unencombered by the GPL also exists. It was
188# posted to comp.sources.misc in volume 40 and is widely available from
189# FTP archive sites. One URL for it is:
190# ftp://gatekeeper.dec.com/.b/usenet/comp.sources.misc/volume40/fgmp/part01.Z
191
Guido van Rossumfba715a1994-01-02 00:26:09 +0000192#GMP=/ufs/guido/src/gmp
Guido van Rossumf6971e21994-08-30 12:25:20 +0000193#mpz mpzmodule.c -I$(GMP) $(GMP)/libgmp.a
Guido van Rossumfba715a1994-01-02 00:26:09 +0000194
195
196# SGI IRIX specific modules -- off by default.
Guido van Rossum05bf2801994-10-20 22:01:38 +0000197
Guido van Rossumf4449de1995-04-10 11:37:18 +0000198# These module work on any SGI machine:
Guido van Rossumfba715a1994-01-02 00:26:09 +0000199
Guido van Rossumcaffcdf1995-03-10 15:14:13 +0000200# *** gl must be enabled higher up in this file ***
Guido van Rossum05bf2801994-10-20 22:01:38 +0000201#fm fmmodule.c -lfm -lgl # Font Manager
Guido van Rossum05bf2801994-10-20 22:01:38 +0000202#sgi sgimodule.c # sgi.nap() and a few more
203
204# This module requires the header file
Guido van Rossumf4449de1995-04-10 11:37:18 +0000205# /usr/people/4Dgifts/iristools/include/izoom.h:
Guido van Rossum05bf2801994-10-20 22:01:38 +0000206
Guido van Rossum02530b01996-07-31 22:43:38 +0000207#imgfile imgfile.c -limage -lgutil # Image Processing Utilities
Guido van Rossum05bf2801994-10-20 22:01:38 +0000208
209
Guido van Rossumf4449de1995-04-10 11:37:18 +0000210# These modules require the Multimedia Development Option (I think):
Guido van Rossum05bf2801994-10-20 22:01:38 +0000211
212#al almodule.c -laudio # Audio Library
213#cd cdmodule.c -lcdaudio -lds -lmediad # CD Audio Library
214#cl clmodule.c -lcl -lawareaudio # Compression Library
215#sv svmodule.c yuvconvert.c -lsvideo -lXext -lX11 # Starter Video
216
Guido van Rossumfba715a1994-01-02 00:26:09 +0000217
218# The FORMS library, by Mark Overmars, implements user interface
219# components such as dialogs and buttons using SGI's GL and FM
220# libraries. You must ftp the FORMS library separately from
221# ftp://ftp.cs.ruu.nl/pub/SGI/FORMS. It was tested with FORMS 2.2a.
222# The FORMS variable must point to the FORMS subdirectory of the forms
Guido van Rossumf4449de1995-04-10 11:37:18 +0000223# toplevel directory:
Guido van Rossumfba715a1994-01-02 00:26:09 +0000224
225#FORMS=/ufs/guido/src/forms/FORMS
Guido van Rossumbe9f1491994-09-21 12:31:05 +0000226#fl flmodule.c -I$(FORMS) $(FORMS)/libforms.a -lfm -lgl
Guido van Rossumfba715a1994-01-02 00:26:09 +0000227
228
Guido van Rossumf4449de1995-04-10 11:37:18 +0000229# SunOS specific modules -- off by default:
Guido van Rossumfba715a1994-01-02 00:26:09 +0000230
Guido van Rossumbe9f1491994-09-21 12:31:05 +0000231#sunaudiodev sunaudiodev.c
Guido van Rossumfba715a1994-01-02 00:26:09 +0000232
233
Guido van Rossumf4449de1995-04-10 11:37:18 +0000234# George Neville-Neil's timing module:
Guido van Rossumbe9f1491994-09-21 12:31:05 +0000235
236#timing timingmodule.c
Guido van Rossumb6775db1994-08-01 11:34:53 +0000237
238
Guido van Rossum82df03e1996-08-08 19:08:47 +0000239# The _tkinter module.
Guido van Rossumd4837da1995-02-14 09:43:25 +0000240#
Guido van Rossumae75f491995-07-18 18:18:11 +0000241# See the section "The Tk interface" in ../README for more info.
Guido van Rossum82df03e1996-08-08 19:08:47 +0000242#
243# Enable the TKPATH line and choose the most applicable _tkinter line.
244# You may have to change /usr/local to wherever Tcl/Tk are installed.
245# Change the -l arguments to use Tcl 7.4 and Tk 4.0!
Guido van Rossume4485b01994-09-07 14:32:49 +0000246
Guido van Rossum82df03e1996-08-08 19:08:47 +0000247# *** ALWAYS enable this line:
Guido van Rossume4485b01994-09-07 14:32:49 +0000248#TKPATH=:$(DESTLIB)/tkinter
249
Guido van Rossum82df03e1996-08-08 19:08:47 +0000250# *** Enable *one* of the following lines:
251# For Solaris:
252#_tkinter _tkinter.c -I/usr/openwin/include -I/usr/local/include -L/usr/openwin/lib -L/usr/local/lib -ltk4.1 -ltcl7.5 -lX11
253# For generic system (may have to add -I/-L options to find X11):
254#_tkinter _tkinter.c -I/usr/local/include -L/usr/local/lib -ltk4.1 -ltcl7.5 -lX11
255
Guido van Rossume4485b01994-09-07 14:32:49 +0000256
Guido van Rossumf4449de1995-04-10 11:37:18 +0000257# Lance Ellinghaus's modules:
Guido van Rossumbe9f1491994-09-21 12:31:05 +0000258
Guido van Rossume4485b01994-09-07 14:32:49 +0000259rotor rotormodule.c # enigma-inspired encryption
Guido van Rossumbe9f1491994-09-21 12:31:05 +0000260#syslog syslogmodule.c # syslog daemon interface
Guido van Rossumf8afdcf1995-07-26 17:31:41 +0000261
262
263# Lance's curses module. This requires the System V version of
264# curses, sometimes known as ncurses (e.g. on Linux, link with
Guido van Rossum37ba0bc1995-08-04 04:20:45 +0000265# -lncurses instead of -lcurses; on SunOS 4.1.3, insert -I/usr/5include
266# -L/usr/5lib before -lcurses).
Guido van Rossumf8afdcf1995-07-26 17:31:41 +0000267
268#curses cursesmodule.c -lcurses -ltermcap
Guido van Rossumbe9f1491994-09-21 12:31:05 +0000269
Guido van Rossumb6775db1994-08-01 11:34:53 +0000270
271
Guido van Rossumf4449de1995-04-10 11:37:18 +0000272# Tommy Burnette's 'new' module (creates new empty objects of certain kinds):
Guido van Rossumbe9f1491994-09-21 12:31:05 +0000273
274#new newmodule.c
Guido van Rossumb6775db1994-08-01 11:34:53 +0000275
276
Guido van Rossumf4449de1995-04-10 11:37:18 +0000277# John Redford's sybase module (requires sybase):
Guido van Rossumae75f491995-07-18 18:18:11 +0000278# (Unfortunately this code is orphaned. Read the source for documentation.)
Guido van Rossumbe9f1491994-09-21 12:31:05 +0000279
280#sybase sybasemodule.c
Guido van Rossumb6775db1994-08-01 11:34:53 +0000281
282
Guido van Rossuma3c04b01995-01-12 11:29:01 +0000283# Generic (SunOS / SVR4) dynamic loading module.
284# This is not needed for dynamic loading of Python modules --
285# it is a highly experimental and dangerous device for calling
Guido van Rossumf4449de1995-04-10 11:37:18 +0000286# *arbitrary* C functions in *arbitrary* shared libraries:
Guido van Rossumbe9f1491994-09-21 12:31:05 +0000287
288#dl dlmodule.c
Guido van Rossumb6775db1994-08-01 11:34:53 +0000289
290
Guido van Rossum4b4c6641994-08-08 08:06:37 +0000291# Anthony Baxter's gdbm module (derived from Jack's dbm module)
Guido van Rossumf4449de1995-04-10 11:37:18 +0000292# GNU dbm(3) will require -lgdbm:
Guido van Rossumbe9f1491994-09-21 12:31:05 +0000293
294#gdbm gdbmmodule.c -I/usr/local/include -L/usr/local/lib -lgdbm
Guido van Rossumfba715a1994-01-02 00:26:09 +0000295
Guido van Rossum4b4c6641994-08-08 08:06:37 +0000296
Guido van Rossumd639b451995-08-28 02:59:06 +0000297# Berkeley DB interface.
Guido van Rossumae75f491995-07-18 18:18:11 +0000298#
299# This requires the Berkeley DB code, see
300# ftp://ftp.cs.berkeley.edu/pub/4bsd/db.1.85.tar.gz
301#
302# Edit the variables DB and DBPORT to point to the db top directory
303# and the subdirectory of PORT where you built it.
304
Guido van Rossum9687a9211996-07-24 00:42:42 +0000305#DB=/depot/sundry/src/berkeley-db/db.1.85
306#DBPORT=$(DB)/PORT/irix.5.3
307#bsddb bsddbmodule.o -I$(DBPORT)/include $(DBPORT)/libdb.a
Guido van Rossumae75f491995-07-18 18:18:11 +0000308
309
310
Guido van Rossum31affb21995-06-14 22:31:38 +0000311# Andy Bensky's "environment" module (contains putenv())
312#environment environment.c
313
314# David Wayne Williams' soundex module
315#soundex soundex.c
316
Guido van Rossum37ba0bc1995-08-04 04:20:45 +0000317# Objective-C (incomplete!!!)
318#objc.c
319
Jack Jansen72781191995-08-07 14:34:15 +0000320# Helper module for various ascii-encoders
Guido van Rossumb50667d1995-10-12 00:41:40 +0000321binascii binascii.c
322
323# Fred Drake's interface to the Python parser.
324# (Not enabled by default because it is big and doesn't compile with
325# cc on SunOS 4.1.3)
326#parser parsermodule.c
Jack Jansen72781191995-08-07 14:34:15 +0000327
Guido van Rossum31affb21995-06-14 22:31:38 +0000328
Guido van Rossumf4449de1995-04-10 11:37:18 +0000329# Example -- included for reference only:
Guido van Rossumf6971e21994-08-30 12:25:20 +0000330# xx xxmodule.c