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.
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
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.
17 # Lines have the following structure:
19 # <module> ... [<sourcefile> ...] [<cpparg> ...] [<library> ...]
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)
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.)
31 # Lines can also have the form
35 # which defines a Make variable definition inserted into Makefile.in
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:
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
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*.)
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.
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.
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!
74 # Directories where library files get installed.
75 # DESTLIB is for Python modules; MACHDESTLIB for shared libraries.
77 MACHDESTLIB=$(BINLIBDEST)
79 # NOTE: all the paths are now relative to the prefix that is computed
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.
87 # Site specific path components -- should begin with : if non-empty
90 # Standard path components for test modules
93 # Path components for machine- or system-dependent modules and shared libraries
94 MACHDEPPATH=:plat-$(MACHDEP)
97 # Path component for the Tkinter-related modules
98 # The TKPATH variable is always enabled, to save you the effort.
101 # Path component for old modules.
104 COREPYTHONPATH=$(DESTPATH)$(SITEPATH)$(TESTPATH)$(MACHDEPPATH)$(EXTRAMACHDEPPATH)$(TKPATH)$(OLDPATH)
105 PYTHONPATH=$(COREPYTHONPATH)
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
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.
115 posix posixmodule.c # posix (UNIX) system calls
116 errno errnomodule.c # posix (UNIX) errno values
117 pwd 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
122 # The zipimport module is always imported at startup. Having it as a
123 # builtin module avoids some bootstrapping problems and reduces overhead.
124 zipimport zipimport.c
126 # The rest of the modules listed in this file are all commented out by
127 # default. Usually they can be detected and built as dynamically
128 # loaded modules by the new setup.py script added in Python 2.1. If
129 # you're on a platform that doesn't support dynamic loading, want to
130 # compile modules statically into the Python binary, or need to
131 # specify some odd set of compiler switches, you can uncomment the
132 # appropriate lines below.
134 # ======================================================================
136 # The Python symtable module depends on .h files that setup.py doesn't track
137 _symtable symtablemodule.c
139 # The SGI specific GL module:
141 GLHACK=-Dclear=__GLclear
142 #gl glmodule.c cgensupport.c -I$(srcdir) $(GLHACK) -lgl -lX11
144 # Pure module. Cannot be linked dynamically.
145 # -DWITH_QUANTIFY, -DWITH_PURIFY, or -DWITH_ALL_PURE
146 #WHICH_PURE_PRODUCTS=-DWITH_ALL_PURE
147 #PURE_INCLS=-I/usr/local/include
148 #PURE_STUBLIBS=-L/usr/local/lib -lpurify_stubs -lquantify_stubs
149 #pure puremodule.c $(WHICH_PURE_PRODUCTS) $(PURE_INCLS) $(PURE_STUBLIBS)
151 # Uncommenting the following line tells makesetup that all following
152 # modules are to be built as shared libraries (see above for more
153 # detail; also note that *static* reverses this effect):
157 # GNU readline. Unlike previous Python incarnations, GNU readline is
158 # now incorporated in an optional module, configured in the Setup file
159 # instead of by a configure script switch. You may have to insert a
160 # -L option pointing to the directory where libreadline.* lives,
161 # and you may have to change -ltermcap to -ltermlib or perhaps remove
162 # it, depending on your system -- see the GNU readline instructions.
163 # It's okay for this to be a shared library, too.
165 #readline readline.c -lreadline -ltermcap
168 # Modules that should always be present (non UNIX dependent):
170 #array arraymodule.c # array objects
171 #cmath cmathmodule.c # -lm # complex math library functions
172 #math mathmodule.c # -lm # math library functions, e.g. sin()
173 #_struct _struct.c # binary structure packing/unpacking
174 #time timemodule.c # -lm # time operations and variables
175 #operator operator.c # operator.add() and similar goodies
176 #_weakref _weakref.c # basic weak reference support
177 #_testcapi _testcapimodule.c # Python C API test module
178 #_random _randommodule.c # Random number generator
179 #collections collectionsmodule.c # Container types
180 #itertools itertoolsmodule.c # Functions creating iterators for efficient looping
181 #strop stropmodule.c # String manipulations
183 #unicodedata unicodedata.c # static Unicode character database
185 # access to ISO C locale support
186 #_locale _localemodule.c # -lintl
189 # Modules with some UNIX dependencies -- on by default:
190 # (If you have a really backward UNIX, select and socket may not be
193 #fcntl fcntlmodule.c # fcntl(2) and ioctl(2)
194 #spwd spwdmodule.c # spwd(3)
195 #grp grpmodule.c # grp(3)
196 #select selectmodule.c # select(2); not on ancient System V
198 # Memory-mapped files (also works on Win32).
204 # Socket module helper for socket(2)
205 #_socket socketmodule.c
207 # Socket module helper for SSL support; you must comment out the other
208 # socket line above, and possibly edit the SSL variable:
211 # -DUSE_SSL -I$(SSL)/include -I$(SSL)/include/openssl \
212 # -L$(SSL)/lib -lssl -lcrypto
214 # The crypt module is now disabled by default because it breaks builds
215 # on many systems (where -lcrypt is needed), e.g. Linux (I believe).
217 # First, look at Setup.config; configure may have set this for you.
219 #crypt cryptmodule.c # -lcrypt # crypt(3); needs -lcrypt on some systems
222 # Some more UNIX dependent modules -- off by default, since these
223 # are not supported by all UNIX systems:
225 #nis nismodule.c -lnsl # Sun yellow pages -- not everywhere
226 #termios termios.c # Steen Lumholt's termios module
227 #resource resource.c # Jeremy Hylton's rlimit interface
230 # Multimedia modules -- off by default.
231 # These don't work for 64-bit platforms!!!
232 # #993173 says audioop works on 64-bit platforms, though.
233 # These represent audio samples or images as strings:
235 #audioop audioop.c # Operations on audio samples
236 #imageop imageop.c # Operations on images
239 # Note that the _md5 and _sha modules are normally only built if the
240 # system does not have the OpenSSL libs containing an optimized version.
242 # The _md5 module implements the RSA Data Security, Inc. MD5
243 # Message-Digest Algorithm, described in RFC 1321. The necessary files
244 # md5.c and md5.h are included here.
246 #_md5 md5module.c md5.c
249 # The _sha module implements the SHA checksum algorithms.
250 # (NIST's Secure Hash Algorithms.)
252 #_sha256 sha256module.c
253 #_sha512 sha512module.c
256 # SGI IRIX specific modules -- off by default.
258 # These module work on any SGI machine:
260 # *** gl must be enabled higher up in this file ***
261 #fm fmmodule.c $(GLHACK) -lfm -lgl # Font Manager
262 #sgi sgimodule.c # sgi.nap() and a few more
264 # This module requires the header file
265 # /usr/people/4Dgifts/iristools/include/izoom.h:
266 #imgfile imgfile.c -limage -lgutil -lgl -lm # Image Processing Utilities
269 # These modules require the Multimedia Development Option (I think):
271 #al almodule.c -laudio # Audio Library
272 #cd cdmodule.c -lcdaudio -lds -lmediad # CD Audio Library
273 #cl clmodule.c -lcl -lawareaudio # Compression Library
274 #sv svmodule.c yuvconvert.c -lsvideo -lXext -lX11 # Starter Video
277 # The FORMS library, by Mark Overmars, implements user interface
278 # components such as dialogs and buttons using SGI's GL and FM
279 # libraries. You must ftp the FORMS library separately from
280 # ftp://ftp.cs.ruu.nl/pub/SGI/FORMS. It was tested with FORMS 2.2a.
281 # NOTE: if you want to be able to use FORMS and curses simultaneously
282 # (or both link them statically into the same binary), you must
283 # compile all of FORMS with the cc option "-Dclear=__GLclear".
285 # The FORMS variable must point to the FORMS subdirectory of the forms
286 # toplevel directory:
288 #FORMS=/ufs/guido/src/forms/FORMS
289 #fl flmodule.c -I$(FORMS) $(GLHACK) $(FORMS)/libforms.a -lfm -lgl
292 # SunOS specific modules -- off by default:
294 #sunaudiodev sunaudiodev.c
297 # A Linux specific module -- off by default; this may also work on
300 #linuxaudiodev linuxaudiodev.c
303 # George Neville-Neil's timing module:
305 #timing timingmodule.c
308 # The _tkinter module.
310 # The command for _tkinter is long and site specific. Please
311 # uncomment and/or edit those parts as indicated. If you don't have a
312 # specific extension (e.g. Tix or BLT), leave the corresponding line
313 # commented out. (Leave the trailing backslashes in! If you
314 # experience strange errors, you may want to join all uncommented
315 # lines and remove the backslashes -- the backslash interpretation is
316 # done by the shell's "read" command and it may not be implemented on
319 # *** Always uncomment this (leave the leading underscore in!):
320 # _tkinter _tkinter.c tkappinit.c -DWITH_APPINIT \
321 # *** Uncomment and edit to reflect where your Tcl/Tk libraries are:
323 # *** Uncomment and edit to reflect where your Tcl/Tk headers are:
324 # -I/usr/local/include \
325 # *** Uncomment and edit to reflect where your X11 header files are:
326 # -I/usr/X11R6/include \
327 # *** Or uncomment this for Solaris:
328 # -I/usr/openwin/include \
329 # *** Uncomment and edit for Tix extension only:
330 # -DWITH_TIX -ltix8.1.8.2 \
331 # *** Uncomment and edit for BLT extension only:
332 # -DWITH_BLT -I/usr/local/blt/blt8.0-unoff/include -lBLT8.0 \
333 # *** Uncomment and edit for PIL (TkImaging) extension only:
334 # (See http://www.pythonware.com/products/pil/ for more info)
335 # -DWITH_PIL -I../Extensions/Imaging/libImaging tkImaging.c \
336 # *** Uncomment and edit for TOGL extension only:
337 # -DWITH_TOGL togl.c \
338 # *** Uncomment and edit to reflect your Tcl/Tk versions:
340 # *** Uncomment and edit to reflect where your X11 libraries are:
342 # *** Or uncomment this for Solaris:
343 # -L/usr/openwin/lib \
344 # *** Uncomment these for TOGL extension only:
345 # -lGL -lGLU -lXext -lXmu \
346 # *** Uncomment for AIX:
348 # *** Always uncomment this; X11 libraries to link with:
351 # Lance Ellinghaus's syslog module
352 #syslog syslogmodule.c # syslog daemon interface
355 # Curses support, requring the System V version of curses, often
356 # provided by the ncurses library. e.g. on Linux, link with -lncurses
357 # instead of -lcurses).
359 # First, look at Setup.config; configure may have set this for you.
361 #_curses _cursesmodule.c -lcurses -ltermcap
362 # Wrapper for the panel library that's part of ncurses and SYSV curses.
363 #_curses_panel _curses_panel.c -lpanel -lncurses
366 # Generic (SunOS / SVR4) dynamic loading module.
367 # This is not needed for dynamic loading of Python modules --
368 # it is a highly experimental and dangerous device for calling
369 # *arbitrary* C functions in *arbitrary* shared libraries:
374 # Modules that provide persistent dictionary-like semantics. You will
375 # probably want to arrange for at least one of them to be available on
376 # your machine, though none are defined by default because of library
377 # dependencies. The Python module anydbm.py provides an
378 # implementation independent wrapper for these; dumbdbm.py provides
379 # similar functionality (but slower of course) implemented in Python.
381 # The standard Unix dbm module has been moved to Setup.config so that
382 # it will be compiled as a shared library by default. Compiling it as
383 # a built-in module causes conflicts with the pybsddb3 module since it
384 # creates a static dependency on an out-of-date version of db.so.
386 # First, look at Setup.config; configure may have set this for you.
388 #dbm dbmmodule.c # dbm(3) may require -lndbm or similar
390 # Anthony Baxter's gdbm module. GNU dbm(3) will require -lgdbm:
392 # First, look at Setup.config; configure may have set this for you.
394 #gdbm gdbmmodule.c -I/usr/local/include -L/usr/local/lib -lgdbm
397 # Sleepycat Berkeley DB interface.
399 # This requires the Sleepycat DB code, see http://www.sleepycat.com/
400 # The earliest supported version of that library is 3.0, the latest
401 # supported version is 4.0 (4.1 is specifically not supported, as that
402 # changes the semantics of transactional databases). A list of available
403 # releases can be found at
405 # http://www.sleepycat.com/update/index.html
407 # Edit the variables DB and DBLIBVERto point to the db top directory
408 # and the subdirectory of PORT where you built it.
409 #DB=/usr/local/BerkeleyDB.4.0
413 #_bsddb _bsddb.c -I$(DBINC) -L$(DBLIB) -ldb-$(DBLIBVER)
415 # Historical Berkeley DB 1.85
417 # This module is deprecated; the 1.85 version of the Berkeley DB library has
418 # bugs that can cause data corruption. If you can, use later versions of the
419 # library instead, available from <http://www.sleepycat.com/>.
421 #DB=/depot/sundry/src/berkeley-db/db.1.85
422 #DBPORT=$(DB)/PORT/irix.5.3
423 #bsddb185 bsddbmodule.c -I$(DBPORT)/include -I$(DBPORT) $(DBPORT)/libdb.a
427 # Helper module for various ascii-encoders
430 # Fred Drake's interface to the Python parser
431 #parser parsermodule.c
433 # cStringIO and cPickle
434 #cStringIO cStringIO.c
438 # Lee Busby's SIGFPE modules.
439 # The library to link fpectl with is platform specific.
440 # Choose *one* of the options below for fpectl:
442 # For SGI IRIX (tested on 5.3):
443 #fpectl fpectlmodule.c -lfpe
445 # For Solaris with SunPro compiler (tested on Solaris 2.5 with SunPro C 4.2):
446 # (Without the compiler you don't have -lsunmath.)
447 #fpectl fpectlmodule.c -R/opt/SUNWspro/lib -lsunmath -lm
449 # For other systems: see instructions in fpectlmodule.c.
450 #fpectl fpectlmodule.c ...
452 # Test module for fpectl. No extra libraries needed.
453 #fpetest fpetestmodule.c
455 # Andrew Kuchling's zlib module.
456 # This require zlib 1.1.3 (or later).
457 # See http://www.gzip.org/zlib/
458 #zlib zlibmodule.c -I$(prefix)/include -L$(exec_prefix)/lib -lz
460 # Interface to the Expat XML parser
462 # Expat was written by James Clark and is now maintained by a group of
463 # developers on SourceForge; see www.libexpat.org for more
464 # information. The pyexpat module was written by Paul Prescod after a
465 # prototype by Jack Jansen. Source of Expat 1.95.2 is included in
466 # Modules/expat/. Usage of a system shared libexpat.so/expat.dll is
469 # More information on Expat can be found at www.libexpat.org.
471 #EXPAT_DIR=/usr/local/src/expat-1.95.2
472 #pyexpat pyexpat.c -DHAVE_EXPAT_H -I$(EXPAT_DIR)/lib -L$(EXPAT_DIR) -lexpat
475 # Hye-Shik Chang's CJKCodecs
477 # multibytecodec is required for all the other CJK codec modules
478 #_multibytecodec cjkcodecs/multibytecodec.c
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
487 # Example -- included for reference only:
490 # Another example -- the 'xxsubtype' module shows C-level subtyping in action
491 xxsubtype xxsubtype.c