1# -*- makefile -*-
2# The file Setup is used by the makesetup script to construct the files
3# Makefile and config.c, from Makefile.pre and config.c.in,
4# respectively.  The file Setup itself is initially copied from
5# Setup.dist; once it exists it will not be overwritten, so you can edit
6# Setup to your heart's content.  Note that Makefile.pre is created
7# 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 and *.dist files are in the source
11# directory.)
12
13# Each line in this file describes one or more optional modules.
14# Modules enabled here will not be compiled by the setup.py script,
15# so the file can be used to override setup.py's behavior.
16
17# Lines have the following structure:
18#
19# <module> ... [<sourcefile> ...] [<cpparg> ...] [<library> ...]
20#
21# <sourcefile> is anything ending in .c (.C, .cc, .c++ are C++ files)
22# <cpparg> is anything starting with -I, -D, -U or -C
23# <library> is anything ending in .a or beginning with -l or -L
24# <module> is anything else but should be a valid Python
25# identifier (letters, digits, underscores, beginning with non-digit)
26#
27# (As the makesetup script changes, it may recognize some other
28# arguments as well, e.g. *.so and *.sl as libraries.  See the big
29# case statement in the makesetup script.)
30#
31# Lines can also have the form
32#
33# <name> = <value>
34#
35# which defines a Make variable definition inserted into Makefile.in
36#
37# Finally, if a line contains just the word "*shared*" (without the
38# quotes but with the stars), then the following modules will not be
39# built statically.  The build process works like this:
40#
41# 1. Build all modules that are declared as static in Modules/Setup,
42#    combine them into libpythonxy.a, combine that into python.
43# 2. Build all modules that are listed as shared in Modules/Setup.
44# 3. Invoke setup.py. That builds all modules that
45#    a) are not builtin, and
46#    b) are not listed in Modules/Setup, and
47#    c) can be build on the target
48#
49# Therefore, modules declared to be shared will not be
50# included in the config.c file, nor in the list of objects to be
51# added to the library archive, and their linker options won't be
52# added to the linker options. Rules to create their .o files and
53# their shared libraries will still be added to the Makefile, and
54# their names will be collected in the Make variable SHAREDMODS.  This
55# is used to build modules as shared libraries.  (They can be
56# installed using "make sharedinstall", which is implied by the
57# toplevel "make install" target.)  (For compatibility,
58# *noconfig* has the same effect as *shared*.)
59#
60# In addition, *static* explicitly declares the following modules to
61# be static.  Lines containing "*static*" and "*shared*" may thus
62# alternate throughout this file.
63
64# NOTE: As a standard policy, as many modules as can be supported by a
65# platform should be present.  The distribution comes with all modules
66# enabled that are supported by most platforms and don't require you
67# to ftp sources from elsewhere.
68
69
70# Some special rules to define PYTHONPATH.
71# Edit the definitions below to indicate which options you are using.
72# Don't add any whitespace or comments!
73
74# Directories where library files get installed.
75# DESTLIB is for Python modules; MACHDESTLIB for shared libraries.
76DESTLIB=$(LIBDEST)
77MACHDESTLIB=$(BINLIBDEST)
78
79# NOTE: all the paths are now relative to the prefix that is computed
80# at run time!
81
82# Standard path -- don't edit.
83# No leading colon since this is the first entry.
84# Empty since this is now just the runtime prefix.
85DESTPATH=
86
87# Site specific path components -- should begin with : if non-empty
88SITEPATH=
89
90# Standard path components for test modules
91TESTPATH=
92
93# Path components for machine- or system-dependent modules and shared libraries
94MACHDEPPATH=:$(PLATDIR)
95EXTRAMACHDEPPATH=
96
97# Path component for the Tkinter-related modules
98# The TKPATH variable is always enabled, to save you the effort.
99TKPATH=:lib-tk
100
101# Path component for old modules.
102OLDPATH=:lib-old
103
104COREPYTHONPATH=$(DESTPATH)$(SITEPATH)$(TESTPATH)$(MACHDEPPATH)$(EXTRAMACHDEPPATH)$(TKPATH)$(OLDPATH)
105PYTHONPATH=$(COREPYTHONPATH)
106
107
108# The modules listed here can't be built as shared libraries for
109# various reasons; therefore they are listed here instead of in the
110# normal order.
111
112# This only contains the minimal set of modules required to run the
113# setup.py script in the root of the Python source tree.
114
115posix posixmodule.c		# posix (UNIX) system calls
116errno errnomodule.c		# posix (UNIX) errno values
117pwd pwdmodule.c			# this is needed to find out the user's home dir
118				# if $HOME is not set
119_sre _sre.c			# Fredrik Lundh's new regular expressions
120_codecs _codecsmodule.c		# access to the builtin codecs and codec registry
121_weakref _weakref.c             # weak references
122
123# The zipimport module is always imported at startup. Having it as a
124# builtin module avoids some bootstrapping problems and reduces overhead.
125zipimport zipimport.c
126
127# The rest of the modules listed in this file are all commented out by
128# default.  Usually they can be detected and built as dynamically
129# loaded modules by the new setup.py script added in Python 2.1.  If
130# you're on a platform that doesn't support dynamic loading, want to
131# compile modules statically into the Python binary, or need to
132# specify some odd set of compiler switches, you can uncomment the
133# appropriate lines below.
134
135# ======================================================================
136
137# The Python symtable module depends on .h files that setup.py doesn't track
138_symtable symtablemodule.c
139
140# The SGI specific GL module:
141
142GLHACK=-Dclear=__GLclear
143#gl glmodule.c cgensupport.c -I$(srcdir) $(GLHACK) -lgl -lX11
144
145# Pure module.  Cannot be linked dynamically.
146# -DWITH_QUANTIFY, -DWITH_PURIFY, or -DWITH_ALL_PURE
147#WHICH_PURE_PRODUCTS=-DWITH_ALL_PURE
148#PURE_INCLS=-I/usr/local/include
149#PURE_STUBLIBS=-L/usr/local/lib -lpurify_stubs -lquantify_stubs
150#pure puremodule.c $(WHICH_PURE_PRODUCTS) $(PURE_INCLS) $(PURE_STUBLIBS)
151
152# Uncommenting the following line tells makesetup that all following
153# modules are to be built as shared libraries (see above for more
154# detail; also note that *static* reverses this effect):
155
156#*shared*
157
158# GNU readline.  Unlike previous Python incarnations, GNU readline is
159# now incorporated in an optional module, configured in the Setup file
160# instead of by a configure script switch.  You may have to insert a
161# -L option pointing to the directory where libreadline.* lives,
162# and you may have to change -ltermcap to -ltermlib or perhaps remove
163# it, depending on your system -- see the GNU readline instructions.
164# It's okay for this to be a shared library, too.
165
166#readline readline.c -lreadline -ltermcap
167
168
169# Modules that should always be present (non UNIX dependent):
170
171#array arraymodule.c	# array objects
172#cmath cmathmodule.c _math.c # -lm # complex math library functions
173#math mathmodule.c _math.c # -lm # math library functions, e.g. sin()
174#_struct _struct.c	# binary structure packing/unpacking
175#time timemodule.c # -lm # time operations and variables
176#operator operator.c	# operator.add() and similar goodies
177#_testcapi _testcapimodule.c    # Python C API test module
178#_random _randommodule.c	# Random number generator
179#_collections _collectionsmodule.c # Container types
180#_heapq _heapqmodule.c		# Heapq type
181#itertools itertoolsmodule.c	# Functions creating iterators for efficient looping
182#strop stropmodule.c		# String manipulations
183#_functools _functoolsmodule.c	# Tools for working with functions and callable objects
184#_elementtree -I$(srcdir)/Modules/expat -DHAVE_EXPAT_CONFIG_H -DUSE_PYEXPAT_CAPI _elementtree.c	# elementtree accelerator
185#_pickle _pickle.c	# pickle accelerator
186#datetime datetimemodule.c	# date/time type
187#_bisect _bisectmodule.c	# Bisection algorithms
188
189#unicodedata unicodedata.c    # static Unicode character database
190
191# access to ISO C locale support
192#_locale _localemodule.c  # -lintl
193
194# Standard I/O baseline
195#_io -I$(srcdir)/Modules/_io _io/bufferedio.c _io/bytesio.c _io/fileio.c _io/iobase.c _io/_iomodule.c _io/stringio.c _io/textio.c
196
197
198# Modules with some UNIX dependencies -- on by default:
199# (If you have a really backward UNIX, select and socket may not be
200# supported...)
201
202#fcntl fcntlmodule.c	# fcntl(2) and ioctl(2)
203#spwd spwdmodule.c		# spwd(3)
204#grp grpmodule.c		# grp(3)
205#select selectmodule.c	# select(2); not on ancient System V
206
207# Memory-mapped files (also works on Win32).
208#mmap mmapmodule.c
209
210# CSV file helper
211#_csv _csv.c
212
213# Socket module helper for socket(2)
214#_socket socketmodule.c timemodule.c
215
216# Socket module helper for SSL support; you must comment out the other
217# socket line above, and possibly edit the SSL variable:
218#SSL=/usr/local/ssl
219#_ssl _ssl.c \
220#	-DUSE_SSL -I$(SSL)/include -I$(SSL)/include/openssl \
221#	-L$(SSL)/lib -lssl -lcrypto
222
223# The crypt module is now disabled by default because it breaks builds
224# on many systems (where -lcrypt is needed), e.g. Linux (I believe).
225#
226# First, look at Setup.config; configure may have set this for you.
227
228#crypt cryptmodule.c # -lcrypt	# crypt(3); needs -lcrypt on some systems
229
230
231# Some more UNIX dependent modules -- off by default, since these
232# are not supported by all UNIX systems:
233
234#nis nismodule.c -lnsl	# Sun yellow pages -- not everywhere
235#termios termios.c	# Steen Lumholt's termios module
236#resource resource.c	# Jeremy Hylton's rlimit interface
237
238
239# Multimedia modules -- off by default.
240# These don't work for 64-bit platforms!!!
241# #993173 says audioop works on 64-bit platforms, though.
242# These represent audio samples or images as strings:
243
244#audioop audioop.c	# Operations on audio samples
245#imageop imageop.c	# Operations on images
246
247
248# Note that the _md5 and _sha modules are normally only built if the
249# system does not have the OpenSSL libs containing an optimized version.
250
251# The _md5 module implements the RSA Data Security, Inc. MD5
252# Message-Digest Algorithm, described in RFC 1321.  The necessary files
253# md5.c and md5.h are included here.
254
255#_md5 md5module.c md5.c
256
257
258# The _sha module implements the SHA checksum algorithms.
259# (NIST's Secure Hash Algorithms.)
260#_sha shamodule.c
261#_sha256 sha256module.c
262#_sha512 sha512module.c
263
264
265# SGI IRIX specific modules -- off by default.
266
267# These module work on any SGI machine:
268
269# *** gl must be enabled higher up in this file ***
270#fm fmmodule.c $(GLHACK) -lfm -lgl		# Font Manager
271#sgi sgimodule.c			# sgi.nap() and a few more
272
273# This module requires the header file
274# /usr/people/4Dgifts/iristools/include/izoom.h:
275#imgfile imgfile.c -limage -lgutil -lgl -lm	# Image Processing Utilities
276
277
278# These modules require the Multimedia Development Option (I think):
279
280#al almodule.c -laudio			# Audio Library
281#cd cdmodule.c -lcdaudio -lds -lmediad	# CD Audio Library
282#cl clmodule.c -lcl -lawareaudio	# Compression Library
283#sv svmodule.c yuvconvert.c -lsvideo -lXext -lX11	# Starter Video
284
285
286# The FORMS library, by Mark Overmars, implements user interface
287# components such as dialogs and buttons using SGI's GL and FM
288# libraries.  You must ftp the FORMS library separately from
289# ftp://ftp.cs.ruu.nl/pub/SGI/FORMS.  It was tested with FORMS 2.2a.
290# NOTE: if you want to be able to use FORMS and curses simultaneously
291# (or both link them statically into the same binary), you must
292# compile all of FORMS with the cc option "-Dclear=__GLclear".
293
294# The FORMS variable must point to the FORMS subdirectory of the forms
295# toplevel directory:
296
297#FORMS=/ufs/guido/src/forms/FORMS
298#fl flmodule.c -I$(FORMS) $(GLHACK) $(FORMS)/libforms.a -lfm -lgl
299
300
301# SunOS specific modules -- off by default:
302
303#sunaudiodev sunaudiodev.c
304
305
306# A Linux specific module -- off by default; this may also work on
307# some *BSDs.
308
309#linuxaudiodev linuxaudiodev.c
310
311
312# George Neville-Neil's timing module:
313
314#timing timingmodule.c
315
316
317# The _tkinter module.
318#
319# The command for _tkinter is long and site specific.  Please
320# uncomment and/or edit those parts as indicated.  If you don't have a
321# specific extension (e.g. Tix or BLT), leave the corresponding line
322# commented out.  (Leave the trailing backslashes in!  If you
323# experience strange errors, you may want to join all uncommented
324# lines and remove the backslashes -- the backslash interpretation is
325# done by the shell's "read" command and it may not be implemented on
326# every system.
327
328# *** Always uncomment this (leave the leading underscore in!):
329# _tkinter _tkinter.c tkappinit.c -DWITH_APPINIT \
330# *** Uncomment and edit to reflect where your Tcl/Tk libraries are:
331#	-L/usr/local/lib \
332# *** Uncomment and edit to reflect where your Tcl/Tk headers are:
333#	-I/usr/local/include \
334# *** Uncomment and edit to reflect where your X11 header files are:
335#	-I/usr/X11R6/include \
336# *** Or uncomment this for Solaris:
337#	-I/usr/openwin/include \
338# *** Uncomment and edit for Tix extension only:
339#	-DWITH_TIX -ltix8.1.8.2 \
340# *** Uncomment and edit for BLT extension only:
341#	-DWITH_BLT -I/usr/local/blt/blt8.0-unoff/include -lBLT8.0 \
342# *** Uncomment and edit for PIL (TkImaging) extension only:
343#     (See http://www.pythonware.com/products/pil/ for more info)
344#	-DWITH_PIL -I../Extensions/Imaging/libImaging  tkImaging.c \
345# *** Uncomment and edit for TOGL extension only:
346#	-DWITH_TOGL togl.c \
347# *** Uncomment and edit to reflect your Tcl/Tk versions:
348#	-ltk8.2 -ltcl8.2 \
349# *** Uncomment and edit to reflect where your X11 libraries are:
350#	-L/usr/X11R6/lib \
351# *** Or uncomment this for Solaris:
352#	-L/usr/openwin/lib \
353# *** Uncomment these for TOGL extension only:
354#	-lGL -lGLU -lXext -lXmu \
355# *** Uncomment for AIX:
356#	-lld \
357# *** Always uncomment this; X11 libraries to link with:
358#	-lX11
359
360# Lance Ellinghaus's syslog module
361#syslog syslogmodule.c		# syslog daemon interface
362
363
364# Curses support, requring the System V version of curses, often
365# provided by the ncurses library.  e.g. on Linux, link with -lncurses
366# instead of -lcurses).
367#
368# First, look at Setup.config; configure may have set this for you.
369
370#_curses _cursesmodule.c -lcurses -ltermcap
371# Wrapper for the panel library that's part of ncurses and SYSV curses.
372#_curses_panel _curses_panel.c -lpanel -lncurses
373
374
375# Generic (SunOS / SVR4) dynamic loading module.
376# This is not needed for dynamic loading of Python modules --
377# it is a highly experimental and dangerous device for calling
378# *arbitrary* C functions in *arbitrary* shared libraries:
379
380#dl dlmodule.c
381
382
383# Modules that provide persistent dictionary-like semantics.  You will
384# probably want to arrange for at least one of them to be available on
385# your machine, though none are defined by default because of library
386# dependencies.  The Python module anydbm.py provides an
387# implementation independent wrapper for these; dumbdbm.py provides
388# similar functionality (but slower of course) implemented in Python.
389
390# The standard Unix dbm module has been moved to Setup.config so that
391# it will be compiled as a shared library by default.  Compiling it as
392# a built-in module causes conflicts with the pybsddb3 module since it
393# creates a static dependency on an out-of-date version of db.so.
394#
395# First, look at Setup.config; configure may have set this for you.
396
397#dbm dbmmodule.c 	# dbm(3) may require -lndbm or similar
398
399# Anthony Baxter's gdbm module.  GNU dbm(3) will require -lgdbm:
400#
401# First, look at Setup.config; configure may have set this for you.
402
403#gdbm gdbmmodule.c -I/usr/local/include -L/usr/local/lib -lgdbm
404
405
406# Sleepycat Berkeley DB interface.
407#
408# This requires the Sleepycat DB code, see http://www.sleepycat.com/
409# The earliest supported version of that library is 3.0, the latest
410# supported version is 4.0 (4.1 is specifically not supported, as that
411# changes the semantics of transactional databases). A list of available
412# releases can be found at
413#
414# http://www.sleepycat.com/update/index.html
415#
416# Edit the variables DB and DBLIBVERto point to the db top directory
417# and the subdirectory of PORT where you built it.
418#DB=/usr/local/BerkeleyDB.4.0
419#DBLIBVER=4.0
420#DBINC=$(DB)/include
421#DBLIB=$(DB)/lib
422#_bsddb _bsddb.c -I$(DBINC) -L$(DBLIB) -ldb-$(DBLIBVER)
423
424# Historical Berkeley DB 1.85
425#
426# This module is deprecated; the 1.85 version of the Berkeley DB library has
427# bugs that can cause data corruption. If you can, use later versions of the
428# library instead, available from <http://www.sleepycat.com/>.
429
430#DB=/depot/sundry/src/berkeley-db/db.1.85
431#DBPORT=$(DB)/PORT/irix.5.3
432#bsddb185 bsddbmodule.c -I$(DBPORT)/include -I$(DBPORT) $(DBPORT)/libdb.a
433
434
435
436# Helper module for various ascii-encoders
437#binascii binascii.c
438
439# Fred Drake's interface to the Python parser
440#parser parsermodule.c
441
442# cStringIO and cPickle
443#cStringIO cStringIO.c
444#cPickle cPickle.c
445
446
447# Lee Busby's SIGFPE modules.
448# The library to link fpectl with is platform specific.
449# Choose *one* of the options below for fpectl:
450
451# For SGI IRIX (tested on 5.3):
452#fpectl fpectlmodule.c -lfpe
453
454# For Solaris with SunPro compiler (tested on Solaris 2.5 with SunPro C 4.2):
455# (Without the compiler you don't have -lsunmath.)
456#fpectl fpectlmodule.c -R/opt/SUNWspro/lib -lsunmath -lm
457
458# For other systems: see instructions in fpectlmodule.c.
459#fpectl fpectlmodule.c ...
460
461# Test module for fpectl.  No extra libraries needed.
462#fpetest fpetestmodule.c
463
464# Andrew Kuchling's zlib module.
465# This require zlib 1.1.3 (or later).
466# See http://www.gzip.org/zlib/
467#zlib zlibmodule.c -I$(prefix)/include -L$(exec_prefix)/lib -lz
468
469# Interface to the Expat XML parser
470# More information on Expat can be found at www.libexpat.org.
471#
472#pyexpat expat/xmlparse.c expat/xmlrole.c expat/xmltok.c pyexpat.c -I$(srcdir)/Modules/expat -DHAVE_EXPAT_CONFIG_H -DUSE_PYEXPAT_CAPI
473
474
475# Hye-Shik Chang's CJKCodecs
476
477# multibytecodec is required for all the other CJK codec modules
478#_multibytecodec cjkcodecs/multibytecodec.c
479
480#_codecs_cn cjkcodecs/_codecs_cn.c
481#_codecs_hk cjkcodecs/_codecs_hk.c
482#_codecs_iso2022 cjkcodecs/_codecs_iso2022.c
483#_codecs_jp cjkcodecs/_codecs_jp.c
484#_codecs_kr cjkcodecs/_codecs_kr.c
485#_codecs_tw cjkcodecs/_codecs_tw.c
486
487# Example -- included for reference only:
488# xx xxmodule.c
489
490# Another example -- the 'xxsubtype' module shows C-level subtyping in action
491xxsubtype xxsubtype.c
492