Setup.in 13.9 KB
Newer Older
1
# -*- makefile -*-
2 3 4 5
# The file Setup is used by the makesetup script to construct the files
# Makefile and config.c, from Makefile.pre and config.c.in,
# respectively.  The file Setup itself is initially copied from
# Setup.in; once it exists it will not be overwritten, so you can edit
6 7
# Setup to your heart's content.  Note that Makefile.pre is created
# from Makefile.pre.in by the toplevel configure script.
8 9

# (VPATH notes: Setup and Makefile.pre are in the build directory, as
10
# are Makefile and config.c; the *.in files are in the source
11 12
# directory.)

13 14 15 16
# Each line in this file describes one or more optional modules.
# Comment out lines to suppress modules.
# Lines have the following structure:
#
17
# <module> ... [<sourcefile> ...] [<cpparg> ...] [<library> ...]
18
#
19
# <sourcefile> is anything ending in .c (.C, .cc, .c++ are C++ files)
20 21 22 23 24
# <cpparg> is anything starting with -I, -D, -U or -C
# <library> is anything ending in .a or beginning with -l or -L
# <module> is anything else but should be a valid Python
# identifier (letters, digits, underscores, beginning with non-digit)
#
25 26 27 28
# (As the makesetup script changes, it may recognize some other
# arguments as well, e.g. *.so and *.sl as libraries.  See the big
# case statement in the makesetup script.)
#
29 30 31 32 33
# Lines can also have the form
#
# <name> = <value>
#
# which defines a Make variable definition inserted into Makefile.in
34
#
35 36 37 38 39 40 41 42 43 44
# Finally, if a line contains just the word "*shared*" (without the
# quotes but with the stars), then the following modules will not be
# included in the config.c file, nor in the list of objects to be
# added to the library archive, and their linker options won't be
# added to the linker options, but rules to create their .o files and
# their shared libraries will still be added to the Makefile, and
# their names will be collected in the Make variable SHAREDMODS.  This
# is used to build modules as shared libraries.  (They must be
# installed using "make sharedinstall".)  (For compatibility,
# *noconfig* has the same effect as *shared*.)
45

46 47 48
# NOTE: As a standard policy, as many modules as can be supported by a
# platform should be present.  The distribution comes with all modules
# enabled that are supported by most platforms and don't require you
49
# to ftp sources from elsewhere.
50 51


52 53 54 55
# Some special rules to define PYTHONPATH.
# Edit the definitions below to indicate which options you are using.
# Don't add any whitespace or comments!

56 57 58 59
# Directories where library files get installed.
# DESTLIB is for Python modules; MACHDESTLIB for shared libraries.
DESTLIB=$(LIBDEST)
MACHDESTLIB=$(BINLIBDEST)
60

61 62 63
# NOTE: all the paths are now relative to the prefix that is computed
# at run time!

64
# Standard path -- don't edit.
65 66 67
# No leading colon since this is the first entry.
# Empty since this is now just the runtime prefix.
DESTPATH=
68

69 70 71 72
# Site specific path components -- should begin with : if non-empty
SITEPATH=

# Standard path components for test modules
73
TESTPATH=:test
74

75
# Path components for machine- or system-dependent modules and shared libraries
76
MACHDEPPATH=:plat-$(MACHDEP)
77

78
COREPYTHONPATH=$(DESTPATH)$(SITEPATH)$(TESTPATH)$(MACHDEPPATH)$(STDWINPATH)$(TKPATH)
79
PYTHONPATH=$(COREPYTHONPATH)
80 81


82 83 84 85
# The modules listed here can't be built as shared libraries for
# various reasons; therefore they are listed here instead of in the
# normal order.

86
# Some modules that are normally always on:
87

88
regex regexmodule.c regexpr.c	# Regular expressions, GNU Emacs style
89 90
reop reopmodule.c		# Additional RE support (for re1.py)
pcre pcremodule.c pypcre.c	# Regular expressions, Perl style (for re.py)
91 92 93
posix posixmodule.c		# posix (UNIX) system calls
signal signalmodule.c		# signal(2)

94
# The SGI specific GL module:
Guido van Rossum's avatar
Guido van Rossum committed
95

96
#gl glmodule.c cgensupport.c -I$(srcdir) -lgl -lX11
97

98
# The thread module is now automatically enabled, see Setup.thread.
Guido van Rossum's avatar
Guido van Rossum committed
99

100 101 102 103 104 105 106
# Pure module.  Cannot be linked dynamically.
# -DWITH_QUANTIFY, -DWITH_PURIFY, or -DWITH_ALL_PURE
#WHICH_PURE_PRODUCTS=-DWITH_ALL_PURE
#PURE_INCLS=-I/usr/local/include
#PURE_STUBLIBS=-L/usr/local/lib -lpurify_stubs -lquantify_stubs
#pure puremodule.c $(WHICH_PURE_PRODUCTS) $(PURE_INCLS) $(PURE_STUBLIBS)

Guido van Rossum's avatar
Guido van Rossum committed
107
# Uncommenting the following line tells makesetup that all following
108 109
# modules are to be built as shared libraries (see above for more
# detail):
Guido van Rossum's avatar
Guido van Rossum committed
110

111
#*shared*
Guido van Rossum's avatar
Guido van Rossum committed
112

113 114 115 116 117 118 119 120 121 122
# GNU readline.  Unlike previous Python incarnations, GNU readline is
# now incorporated in an optional module, configured in the Setup file
# instead of by a configure script switch.  You may have to insert a
# -L option pointing to the directory where libreadline.* lives,
# and you may have to change -ltermcap to -ltermlib or perhaps remove
# it, depending on your system -- see the GNU readline instructions.
# It's okay for this to be a shared library, too.

#readline readline.c -lreadline -ltermcap

Guido van Rossum's avatar
Guido van Rossum committed
123

124
# Modules that should always be present (non UNIX dependent):
125

126
array arraymodule.c	# array objects
127 128
cmath cmathmodule.c # -lm # complex math library functions
math mathmodule.c # -lm # math library functions, e.g. sin()
129 130
strop stropmodule.c	# fast string operations implemented in C
struct structmodule.c	# binary structure packing/unpacking
131
time timemodule.c # -lm # time operations and variables
132
operator operator.c	# operator.add() and similar goodies
133

134 135
#_locale _localemodule.c  # access to ISO C locale support

136

137
# Modules with some UNIX dependencies -- on by default:
138 139
# (If you have a really backward UNIX, select and socket may not be
# supported...)
140

141 142 143 144 145
fcntl fcntlmodule.c	# fcntl(2) and ioctl(2)
pwd pwdmodule.c		# pwd(3) 
grp grpmodule.c		# grp(3)
select selectmodule.c	# select(2); not on ancient System V
socket socketmodule.c	# socket(2); not on ancient System V
146
errno errnomodule.c	# posix (UNIX) errno values
147

148 149 150 151
# The crypt module is now disabled by default because it breaks builds
# on many systems (where -lcrypt is needed), e.g. Linux (I believe).
#crypt cryptmodule.c # -lcrypt	# crypt(3); needs -lcrypt on some systems

152

153
# Some more UNIX dependent modules -- off by default, since these
154
# are not supported by all UNIX systems:
155

156
#nis nismodule.c 	# Sun yellow pages -- not everywhere
157
#termios termios.c	# Steen Lumholt's termios module
158
#resource resource.c	# Jeremy Hylton's rlimit interface
159 160


161
# Multimedia modules -- off by default.
162
# These don't work for 64-bit platforms!!!
163
# These represent audio samples or images as strings:
164

165 166 167
#audioop audioop.c	# Operations on audio samples
#imageop imageop.c	# Operations on images
#rgbimg rgbimgmodule.c   # Read SGI RGB image files (but coded portably)
168 169 170 171


# The stdwin module provides a simple, portable (between X11 and Mac)
# windowing interface.  You need to ftp the STDWIN library, e.g. from
172 173 174
# ftp://ftp.cwi.nl/pub/stdwin.  (If you get it elsewhere, be sure to
# get version 1.0 or higher!)  The STDWIN variable must point to the
# STDWIN toplevel directory.
175

176 177
# Uncomment and edit as needed:
#STDWIN=/ufs/guido/src/stdwin
178

179
# Uncomment these lines:
180
#STDWINPATH=:lib-stdwin
181 182 183 184
#LIBTEXTEDIT=$(STDWIN)/$(MACHDEP)/Packs/textedit/libtextedit.a
#LIBX11STDWIN=$(STDWIN)/$(MACHDEP)/Ports/x11/libstdwin.a
#stdwin stdwinmodule.c -I$(STDWIN)/H $(LIBTEXTEDIT) $(LIBX11STDWIN) -lX11

185 186
# Use this instead of the last two lines above for alphanumeric stdwin:
#LIBALFASTDWIN=$(STDWIN)/$(MACHDEP)/Ports/alfa/libstdwin.a
187 188
#stdwin stdwinmodule.c -I$(STDWIN)/H $(LIBTEXTEDIT) $(LIBALFASTDWIN) -ltermcap

189 190 191 192 193

# The md5 module implements the RSA Data Security, Inc. MD5
# Message-Digest Algorithm, described in RFC 1321.  The necessary files
# md5c.c and md5.h are included here.

194
md5 md5module.c md5c.c
195 196 197


# The mpz module interfaces to the GNU Multiple Precision library.
198 199
# You need to ftp the GNU MP library.  
# The GMP variable must point to the GMP source directory.
200 201 202
# This was originally written and tested against GMP 1.2 and 1.3.2.
# It has been modified by Rob Hooft to work with 2.0.2 as well, but I
# haven't tested it recently.
203

204 205 206 207 208
# A compatible MP library unencombered by the GPL also exists.  It was
# posted to comp.sources.misc in volume 40 and is widely available from
# FTP archive sites. One URL for it is:
# ftp://gatekeeper.dec.com/.b/usenet/comp.sources.misc/volume40/fgmp/part01.Z

209
#GMP=/ufs/guido/src/gmp
210
#mpz mpzmodule.c -I$(GMP) $(GMP)/libgmp.a
211 212 213


# SGI IRIX specific modules -- off by default.
Guido van Rossum's avatar
Guido van Rossum committed
214

215
# These module work on any SGI machine:
216

217
# *** gl must be enabled higher up in this file ***
Guido van Rossum's avatar
Guido van Rossum committed
218 219 220 221
#fm fmmodule.c -lfm -lgl		# Font Manager
#sgi sgimodule.c			# sgi.nap() and a few more

# This module requires the header file
222
# /usr/people/4Dgifts/iristools/include/izoom.h:
223
#imgfile imgfile.c -limage -lgutil -lgl -lm	# Image Processing Utilities
Guido van Rossum's avatar
Guido van Rossum committed
224 225


226
# These modules require the Multimedia Development Option (I think):
Guido van Rossum's avatar
Guido van Rossum committed
227 228 229 230 231 232

#al almodule.c -laudio			# Audio Library
#cd cdmodule.c -lcdaudio -lds -lmediad	# CD Audio Library
#cl clmodule.c -lcl -lawareaudio	# Compression Library
#sv svmodule.c yuvconvert.c -lsvideo -lXext -lX11	# Starter Video

233 234 235 236 237 238

# The FORMS library, by Mark Overmars, implements user interface
# components such as dialogs and buttons using SGI's GL and FM
# libraries.  You must ftp the FORMS library separately from
# ftp://ftp.cs.ruu.nl/pub/SGI/FORMS.  It was tested with FORMS 2.2a.
# The FORMS variable must point to the FORMS subdirectory of the forms
239
# toplevel directory:
240 241

#FORMS=/ufs/guido/src/forms/FORMS
242
#fl flmodule.c -I$(FORMS) $(FORMS)/libforms.a -lfm -lgl
243 244


245
# SunOS specific modules -- off by default:
246

247
#sunaudiodev sunaudiodev.c
248 249


250
# George Neville-Neil's timing module:
251 252

#timing timingmodule.c
253 254


255
# The _tkinter module.
256
#
257 258 259 260 261 262 263 264 265 266 267 268 269 270
# The TKPATH variable is always enabled, to save you the effort.
TKPATH=:lib-tk

# The command for _tkinter is long and site specific.  Please
# uncomment and/or edit those parts as indicated.  If you don't have a
# specific extension (e.g. Tix or BLT), leave the corresponding line
# commented out.  (Leave the trailing backslashes in!  If you
# experience strange errors, you may want to join all uncommented
# lines and remove the backslashes -- the backslash interpretation is
# done by the shell's "read" command and it may not be implemented on
# every system.

# *** Always uncomment this (leave the leading underscore in!):
# _tkinter _tkinter.c tkappinit.c -DWITH_APPINIT \
271
# *** Uncomment and edit to reflect where your X11 header files are:
272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292
#	-I/usr/X11R6/include \
# *** Or uncomment this for Solaris:
#	-I/usr/openwin/include \
# *** Uncomment and edit to reflect where your Tcl/Tk headers are:
#	-I/usr/local/include \
# *** Uncomment and edit for Tix extension only:
#	-DWITH_TIX -ltix4.1.8.0 \
# *** Uncomment and edit for BLT extension only:
#	-DWITH_BLT -I/usr/local/blt/blt8.0-unoff/include -lBLT8.0 \
# *** Uncomment and edit for PIL (TkImaging) extension only:
#	-DWITH_PIL -I../Extensions/Imaging/libImaging  tkImaging.c \
# *** Uncomment and edit for TOGL extension only:
#	-DWITH_TOGL togl.c \
# *** Uncomment and edit to reflect where your Tcl/Tk libraries are:
#	-L/usr/local/lib \
# *** Uncomment and edit to reflect your Tcl/Tk versions:
#	-ltk8.0 -ltcl8.0 \
# *** Uncomment and edit to reflect where your X11 libraries are:
#	-L/usr/X11R6/lib \
# *** Or uncomment this for Solaris:
#	-L/usr/openwin/lib \
293 294
# *** Uncomment these for TOGL extension only:
#	-lGL -lGLU -lXext -lXmu \
295 296
# *** Uncomment for AIX:
#	-lld \
297
# *** Always uncomment this; X11 libraries to link with:
298
#	-lX11
299

300
# Lance Ellinghaus's modules:
301

302
rotor rotormodule.c		# enigma-inspired encryption
303
#syslog syslogmodule.c		# syslog daemon interface
304 305 306 307


# Lance's curses module.  This requires the System V version of
# curses, sometimes known as ncurses (e.g. on Linux, link with
308 309
# -lncurses instead of -lcurses; on SunOS 4.1.3, insert -I/usr/5include
# -L/usr/5lib before -lcurses).
310 311

#curses cursesmodule.c -lcurses -ltermcap
312

313 314


315
# Tommy Burnette's 'new' module (creates new empty objects of certain kinds):
316 317

#new newmodule.c
318 319


Guido van Rossum's avatar
Guido van Rossum committed
320 321 322
# Generic (SunOS / SVR4) dynamic loading module.
# This is not needed for dynamic loading of Python modules --
# it is a highly experimental and dangerous device for calling
323
# *arbitrary* C functions in *arbitrary* shared libraries:
324 325

#dl dlmodule.c
326 327


328 329 330 331 332 333 334 335 336 337 338 339
# Modules that provide persistent dictionary-like semantics.  You will
# probably want to arrange for at least one of them to be available on
# your machine, though none are defined by default because of library
# dependencies.  The Python module anydbm.py provides an
# implementation independent wrapper for these; dumbdbm.py provides
# similar functionality (but slower of course) implemented in Python.

# The standard Unix dbm module:

#dbm dbmmodule.c 	# dbm(3) may require -lndbm or similar

# Anthony Baxter's gdbm module.  GNU dbm(3) will require -lgdbm:
340 341

#gdbm gdbmmodule.c -I/usr/local/include -L/usr/local/lib -lgdbm
342

343

Guido van Rossum's avatar
Guido van Rossum committed
344
# Berkeley DB interface.
345 346 347 348 349 350
#
# This requires the Berkeley DB code, see
# ftp://ftp.cs.berkeley.edu/pub/4bsd/db.1.85.tar.gz
#
# Edit the variables DB and DBPORT to point to the db top directory
# and the subdirectory of PORT where you built it.
351 352 353
#
# (See http://www.jenkon-dev.com/~rd/python/ for an interface to
# BSD DB 2.1.0.)
354

355 356
#DB=/depot/sundry/src/berkeley-db/db.1.85
#DBPORT=$(DB)/PORT/irix.5.3
357
#bsddb bsddbmodule.c -I$(DBPORT)/include -I$(DBPORT) $(DBPORT)/libdb.a
358 359 360



361 362 363
# David Wayne Williams' soundex module
#soundex soundex.c

364
# Helper module for various ascii-encoders
365 366
binascii binascii.c

367 368
# Fred Drake's interface to the Python parser
parser parsermodule.c
369

370 371 372
# Digital Creations' cStringIO and cPickle
cStringIO cStringIO.c
cPickle cPickle.c
373

374

375 376
# Lee Busby's SIGFPE modules.
# The library to link fpectl with is platform specific.
377 378 379 380 381
# Choose *one* of the options below for fpectl:

# For SGI IRIX (tested on 5.3):
#fpectl fpectlmodule.c -lfpe

382 383
# For Solaris with SunPro compiler (tested on Solaris 2.5 with SunPro C 4.2):
# (Without the compiler you don't have -lsunmath.)
384
#fpectl fpectlmodule.c -R/opt/SUNWspro/lib -lsunmath -lm
385

386 387 388 389
# For other systems: see instructions in fpectlmodule.c.
#fpectl fpectlmodule.c ...

# Test module for fpectl.  No extra libraries needed.
390 391
#fpetest fpetestmodule.c

392
# Andrew Kuchling's zlib module.
393
# This require zlib 1.0.4 (or later).  See http://quest.jpl.nasa.gov/zlib/
Guido van Rossum's avatar
Guido van Rossum committed
394
# See http://www.cdrom.com/pub/infozip/zlib/
395
#zlib zlibmodule.c -I$(prefix)/include -L$(exec_prefix)/lib -lz
396

397

398
# Example -- included for reference only:
399
# xx xxmodule.c