Home | History | Annotate | Download | only in Modules
      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.
     76 DESTLIB=$(LIBDEST)
     77 MACHDESTLIB=$(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.
     85 DESTPATH=
     86 
     87 # Site specific path components -- should begin with : if non-empty
     88 SITEPATH=
     89 
     90 # Standard path components for test modules
     91 TESTPATH=
     92 
     93 # Path components for machine- or system-dependent modules and shared libraries
     94 MACHDEPPATH=:$(PLATDIR)
     95 EXTRAMACHDEPPATH=
     96 
     97 # Path component for the Tkinter-related modules
     98 # The TKPATH variable is always enabled, to save you the effort.
     99 TKPATH=:lib-tk
    100 
    101 # Path component for old modules.
    102 OLDPATH=:lib-old
    103 
    104 COREPYTHONPATH=$(DESTPATH)$(SITEPATH)$(TESTPATH)$(MACHDEPPATH)$(EXTRAMACHDEPPATH)$(TKPATH)$(OLDPATH)
    105 PYTHONPATH=$(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 
    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
    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.
    125 zipimport 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 
    142 GLHACK=-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 #
    471 # Expat was written by James Clark and is now maintained by a group of
    472 # developers on SourceForge; see www.libexpat.org for more
    473 # information.  The pyexpat module was written by Paul Prescod after a
    474 # prototype by Jack Jansen.  Source of Expat 1.95.2 is included in
    475 # Modules/expat/.  Usage of a system shared libexpat.so/expat.dll is
    476 # not advised.
    477 #
    478 # More information on Expat can be found at www.libexpat.org.
    479 #
    480 #pyexpat expat/xmlparse.c expat/xmlrole.c expat/xmltok.c pyexpat.c -I$(srcdir)/Modules/expat -DHAVE_EXPAT_CONFIG_H -DUSE_PYEXPAT_CAPI
    481 
    482 
    483 # Hye-Shik Chang's CJKCodecs
    484 
    485 # multibytecodec is required for all the other CJK codec modules
    486 #_multibytecodec cjkcodecs/multibytecodec.c
    487 
    488 #_codecs_cn cjkcodecs/_codecs_cn.c
    489 #_codecs_hk cjkcodecs/_codecs_hk.c
    490 #_codecs_iso2022 cjkcodecs/_codecs_iso2022.c
    491 #_codecs_jp cjkcodecs/_codecs_jp.c
    492 #_codecs_kr cjkcodecs/_codecs_kr.c
    493 #_codecs_tw cjkcodecs/_codecs_tw.c
    494 
    495 # Example -- included for reference only:
    496 # xx xxmodule.c
    497 
    498 # Another example -- the 'xxsubtype' module shows C-level subtyping in action
    499 xxsubtype xxsubtype.c
    500