Home | History | Annotate | Download | only in config
      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 $(DELIM) 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=$(DELIM)plat-$(MACHDEP)
     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=$(DELIM)lib-tk
    100 
    101 # Path component for old modules.
    102 OLDPATH=$(DELIM)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 errno errnomodule.c		# posix (UNIX) errno values
    116 #FIXME: setup.py detect this module along with grp and spwd.
    117 #FIXME: what about to comment ?
    118 #pwd pwdmodule.c			# this is needed to find out the user's home dir
    119 				# if $HOME is not set
    120 _sre _sre.c			# Fredrik Lundh's new regular expressions
    121 _codecs _codecsmodule.c		# access to the builtin codecs and codec registry
    122 _weakref _weakref.c             # weak references
    123 
    124 # The zipimport module is always imported at startup. Having it as a
    125 # builtin module avoids some bootstrapping problems and reduces overhead.
    126 zipimport zipimport.c
    127 
    128 # The rest of the modules listed in this file are all commented out by
    129 # default.  Usually they can be detected and built as dynamically
    130 # loaded modules by the new setup.py script added in Python 2.1.  If
    131 # you're on a platform that doesn't support dynamic loading, want to 
    132 # compile modules statically into the Python binary, or need to 
    133 # specify some odd set of compiler switches, you can uncomment the 
    134 # appropriate lines below.
    135 
    136 # ======================================================================
    137 
    138 # The Python symtable module depends on .h files that setup.py doesn't track
    139 _symtable symtablemodule.c
    140 
    141 # The SGI specific GL module:
    142 
    143 GLHACK=-Dclear=__GLclear
    144 #gl glmodule.c cgensupport.c -I$(srcdir) $(GLHACK) -lgl -lX11
    145 
    146 # Pure module.  Cannot be linked dynamically.
    147 # -DWITH_QUANTIFY, -DWITH_PURIFY, or -DWITH_ALL_PURE
    148 #WHICH_PURE_PRODUCTS=-DWITH_ALL_PURE
    149 #PURE_INCLS=-I/usr/local/include
    150 #PURE_STUBLIBS=-L/usr/local/lib -lpurify_stubs -lquantify_stubs
    151 #pure puremodule.c $(WHICH_PURE_PRODUCTS) $(PURE_INCLS) $(PURE_STUBLIBS)
    152 
    153 # Uncommenting the following line tells makesetup that all following
    154 # modules are to be built as shared libraries (see above for more
    155 # detail; also note that *static* reverses this effect):
    156 
    157 #*shared*
    158 
    159 # GNU readline.  Unlike previous Python incarnations, GNU readline is
    160 # now incorporated in an optional module, configured in the Setup file
    161 # instead of by a configure script switch.  You may have to insert a
    162 # -L option pointing to the directory where libreadline.* lives,
    163 # and you may have to change -ltermcap to -ltermlib or perhaps remove
    164 # it, depending on your system -- see the GNU readline instructions.
    165 # It's okay for this to be a shared library, too.
    166 
    167 #readline readline.c -lreadline -ltermcap
    168 
    169 
    170 # Modules that should always be present (non UNIX dependent):
    171 
    172 #array arraymodule.c	# array objects
    173 #cmath cmathmodule.c _math.c # -lm # complex math library functions
    174 #math mathmodule.c _math.c # -lm # math library functions, e.g. sin()
    175 #_struct _struct.c	# binary structure packing/unpacking
    176 #time timemodule.c # -lm # time operations and variables
    177 #operator operator.c	# operator.add() and similar goodies
    178 #_testcapi _testcapimodule.c    # Python C API test module
    179 #_random _randommodule.c	# Random number generator
    180 #_collections _collectionsmodule.c # Container types
    181 #_heapq _heapqmodule.c		# Heapq type
    182 #itertools itertoolsmodule.c	# Functions creating iterators for efficient looping 
    183 #strop stropmodule.c		# String manipulations
    184 #_functools _functoolsmodule.c	# Tools for working with functions and callable objects
    185 #_elementtree -I$(srcdir)/Modules/expat -DHAVE_EXPAT_CONFIG_H -DUSE_PYEXPAT_CAPI _elementtree.c	# elementtree accelerator
    186 #_pickle _pickle.c	# pickle accelerator
    187 #datetime datetimemodule.c	# date/time type
    188 #_bisect _bisectmodule.c	# Bisection algorithms
    189 
    190 #unicodedata unicodedata.c    # static Unicode character database
    191 
    192 # access to ISO C locale support
    193 #_locale _localemodule.c  # -lintl
    194 
    195 # Standard I/O baseline
    196 #_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
    197 
    198 
    199 # Modules with some UNIX dependencies -- on by default:
    200 # (If you have a really backward UNIX, select and socket may not be
    201 # supported...)
    202 
    203 #fcntl fcntlmodule.c	# fcntl(2) and ioctl(2)
    204 #spwd spwdmodule.c		# spwd(3) 
    205 #grp grpmodule.c		# grp(3)
    206 #select selectmodule.c	# select(2); not on ancient System V
    207 
    208 # Memory-mapped files (also works on Win32).
    209 #mmap mmapmodule.c
    210 
    211 # CSV file helper
    212 #_csv _csv.c
    213 
    214 # Socket module helper for socket(2)
    215 #_socket socketmodule.c timemodule.c
    216 
    217 # Socket module helper for SSL support; you must comment out the other
    218 # socket line above, and possibly edit the SSL variable:
    219 #SSL=/usr/local/ssl
    220 #_ssl _ssl.c \
    221 #	-DUSE_SSL -I$(SSL)/include -I$(SSL)/include/openssl \
    222 #	-L$(SSL)/lib -lssl -lcrypto
    223 
    224 # The crypt module is now disabled by default because it breaks builds
    225 # on many systems (where -lcrypt is needed), e.g. Linux (I believe).
    226 #
    227 # First, look at Setup.config; configure may have set this for you.
    228 
    229 #crypt cryptmodule.c # -lcrypt	# crypt(3); needs -lcrypt on some systems
    230 
    231 
    232 # Some more UNIX dependent modules -- off by default, since these
    233 # are not supported by all UNIX systems:
    234 
    235 #nis nismodule.c -lnsl	# Sun yellow pages -- not everywhere
    236 #termios termios.c	# Steen Lumholt's termios module
    237 #resource resource.c	# Jeremy Hylton's rlimit interface
    238 
    239 
    240 # Multimedia modules -- off by default.
    241 # These don't work for 64-bit platforms!!!
    242 # #993173 says audioop works on 64-bit platforms, though.
    243 # These represent audio samples or images as strings:
    244 
    245 #audioop audioop.c	# Operations on audio samples
    246 #imageop imageop.c	# Operations on images
    247 
    248 
    249 # Note that the _md5 and _sha modules are normally only built if the
    250 # system does not have the OpenSSL libs containing an optimized version.
    251 
    252 # The _md5 module implements the RSA Data Security, Inc. MD5
    253 # Message-Digest Algorithm, described in RFC 1321.  The necessary files
    254 # md5.c and md5.h are included here.
    255 
    256 #_md5 md5module.c md5.c
    257 
    258 
    259 # The _sha module implements the SHA checksum algorithms.
    260 # (NIST's Secure Hash Algorithms.)
    261 #_sha shamodule.c
    262 #_sha256 sha256module.c
    263 #_sha512 sha512module.c
    264 
    265 
    266 # SGI IRIX specific modules -- off by default.
    267 
    268 # These module work on any SGI machine:
    269 
    270 # *** gl must be enabled higher up in this file ***
    271 #fm fmmodule.c $(GLHACK) -lfm -lgl		# Font Manager
    272 #sgi sgimodule.c			# sgi.nap() and a few more
    273 
    274 # This module requires the header file
    275 # /usr/people/4Dgifts/iristools/include/izoom.h:
    276 #imgfile imgfile.c -limage -lgutil -lgl -lm	# Image Processing Utilities
    277 
    278 
    279 # These modules require the Multimedia Development Option (I think):
    280 
    281 #al almodule.c -laudio			# Audio Library
    282 #cd cdmodule.c -lcdaudio -lds -lmediad	# CD Audio Library
    283 #cl clmodule.c -lcl -lawareaudio	# Compression Library
    284 #sv svmodule.c yuvconvert.c -lsvideo -lXext -lX11	# Starter Video
    285 
    286 
    287 # The FORMS library, by Mark Overmars, implements user interface
    288 # components such as dialogs and buttons using SGI's GL and FM
    289 # libraries.  You must ftp the FORMS library separately from
    290 # ftp://ftp.cs.ruu.nl/pub/SGI/FORMS.  It was tested with FORMS 2.2a.
    291 # NOTE: if you want to be able to use FORMS and curses simultaneously
    292 # (or both link them statically into the same binary), you must
    293 # compile all of FORMS with the cc option "-Dclear=__GLclear".
    294 
    295 # The FORMS variable must point to the FORMS subdirectory of the forms
    296 # toplevel directory:
    297 
    298 #FORMS=/ufs/guido/src/forms/FORMS
    299 #fl flmodule.c -I$(FORMS) $(GLHACK) $(FORMS)/libforms.a -lfm -lgl
    300 
    301 
    302 # SunOS specific modules -- off by default:
    303 
    304 #sunaudiodev sunaudiodev.c
    305 
    306 
    307 # A Linux specific module -- off by default; this may also work on 
    308 # some *BSDs.
    309 
    310 #linuxaudiodev linuxaudiodev.c
    311 
    312 
    313 # George Neville-Neil's timing module:
    314 
    315 #timing timingmodule.c
    316 
    317 
    318 # The _tkinter module.
    319 #
    320 # The command for _tkinter is long and site specific.  Please
    321 # uncomment and/or edit those parts as indicated.  If you don't have a
    322 # specific extension (e.g. Tix or BLT), leave the corresponding line
    323 # commented out.  (Leave the trailing backslashes in!  If you
    324 # experience strange errors, you may want to join all uncommented
    325 # lines and remove the backslashes -- the backslash interpretation is
    326 # done by the shell's "read" command and it may not be implemented on
    327 # every system.
    328 
    329 # *** Always uncomment this (leave the leading underscore in!):
    330 # _tkinter _tkinter.c tkappinit.c -DWITH_APPINIT \
    331 # *** Uncomment and edit to reflect where your Tcl/Tk libraries are:
    332 #	-L/usr/local/lib \
    333 # *** Uncomment and edit to reflect where your Tcl/Tk headers are:
    334 #	-I/usr/local/include \
    335 # *** Uncomment and edit to reflect where your X11 header files are:
    336 #	-I/usr/X11R6/include \
    337 # *** Or uncomment this for Solaris:
    338 #	-I/usr/openwin/include \
    339 # *** Uncomment and edit for Tix extension only:
    340 #	-DWITH_TIX -ltix8.1.8.2 \
    341 # *** Uncomment and edit for BLT extension only:
    342 #	-DWITH_BLT -I/usr/local/blt/blt8.0-unoff/include -lBLT8.0 \
    343 # *** Uncomment and edit for PIL (TkImaging) extension only:
    344 #     (See http://www.pythonware.com/products/pil/ for more info)
    345 #	-DWITH_PIL -I../Extensions/Imaging/libImaging  tkImaging.c \
    346 # *** Uncomment and edit for TOGL extension only:
    347 #	-DWITH_TOGL togl.c \
    348 # *** Uncomment and edit to reflect your Tcl/Tk versions:
    349 #	-ltk8.2 -ltcl8.2 \
    350 # *** Uncomment and edit to reflect where your X11 libraries are:
    351 #	-L/usr/X11R6/lib \
    352 # *** Or uncomment this for Solaris:
    353 #	-L/usr/openwin/lib \
    354 # *** Uncomment these for TOGL extension only:
    355 #	-lGL -lGLU -lXext -lXmu \
    356 # *** Uncomment for AIX:
    357 #	-lld \
    358 # *** Always uncomment this; X11 libraries to link with:
    359 #	-lX11
    360 
    361 # Lance Ellinghaus's syslog module
    362 #syslog syslogmodule.c		# syslog daemon interface
    363 
    364 
    365 # Curses support, requring the System V version of curses, often
    366 # provided by the ncurses library.  e.g. on Linux, link with -lncurses
    367 # instead of -lcurses).
    368 #
    369 # First, look at Setup.config; configure may have set this for you.
    370 
    371 #_curses _cursesmodule.c -lcurses -ltermcap
    372 # Wrapper for the panel library that's part of ncurses and SYSV curses.
    373 #_curses_panel _curses_panel.c -lpanel -lncurses 
    374 
    375 
    376 # Generic (SunOS / SVR4) dynamic loading module.
    377 # This is not needed for dynamic loading of Python modules --
    378 # it is a highly experimental and dangerous device for calling
    379 # *arbitrary* C functions in *arbitrary* shared libraries:
    380 
    381 #dl dlmodule.c
    382 
    383 
    384 # Modules that provide persistent dictionary-like semantics.  You will
    385 # probably want to arrange for at least one of them to be available on
    386 # your machine, though none are defined by default because of library
    387 # dependencies.  The Python module anydbm.py provides an
    388 # implementation independent wrapper for these; dumbdbm.py provides
    389 # similar functionality (but slower of course) implemented in Python.
    390 
    391 # The standard Unix dbm module has been moved to Setup.config so that
    392 # it will be compiled as a shared library by default.  Compiling it as
    393 # a built-in module causes conflicts with the pybsddb3 module since it
    394 # creates a static dependency on an out-of-date version of db.so.
    395 #
    396 # First, look at Setup.config; configure may have set this for you.
    397 
    398 #dbm dbmmodule.c 	# dbm(3) may require -lndbm or similar
    399 
    400 # Anthony Baxter's gdbm module.  GNU dbm(3) will require -lgdbm:
    401 #
    402 # First, look at Setup.config; configure may have set this for you.
    403 
    404 #gdbm gdbmmodule.c -I/usr/local/include -L/usr/local/lib -lgdbm
    405 
    406 
    407 # Sleepycat Berkeley DB interface.
    408 #
    409 # This requires the Sleepycat DB code, see http://www.sleepycat.com/
    410 # The earliest supported version of that library is 3.0, the latest
    411 # supported version is 4.0 (4.1 is specifically not supported, as that
    412 # changes the semantics of transactional databases). A list of available
    413 # releases can be found at
    414 #
    415 # http://www.sleepycat.com/update/index.html
    416 #
    417 # Edit the variables DB and DBLIBVERto point to the db top directory
    418 # and the subdirectory of PORT where you built it.
    419 #DB=/usr/local/BerkeleyDB.4.0
    420 #DBLIBVER=4.0
    421 #DBINC=$(DB)/include
    422 #DBLIB=$(DB)/lib
    423 #_bsddb _bsddb.c -I$(DBINC) -L$(DBLIB) -ldb-$(DBLIBVER)
    424 
    425 # Historical Berkeley DB 1.85
    426 #
    427 # This module is deprecated; the 1.85 version of the Berkeley DB library has
    428 # bugs that can cause data corruption. If you can, use later versions of the
    429 # library instead, available from <http://www.sleepycat.com/>.
    430 
    431 #DB=/depot/sundry/src/berkeley-db/db.1.85
    432 #DBPORT=$(DB)/PORT/irix.5.3
    433 #bsddb185 bsddbmodule.c -I$(DBPORT)/include -I$(DBPORT) $(DBPORT)/libdb.a
    434 
    435 
    436 
    437 # Helper module for various ascii-encoders
    438 #binascii binascii.c
    439 
    440 # Fred Drake's interface to the Python parser
    441 #parser parsermodule.c
    442 
    443 # cStringIO and cPickle
    444 #cStringIO cStringIO.c
    445 #cPickle cPickle.c
    446 
    447 
    448 # Lee Busby's SIGFPE modules.
    449 # The library to link fpectl with is platform specific.
    450 # Choose *one* of the options below for fpectl:
    451 
    452 # For SGI IRIX (tested on 5.3):
    453 #fpectl fpectlmodule.c -lfpe
    454 
    455 # For Solaris with SunPro compiler (tested on Solaris 2.5 with SunPro C 4.2):
    456 # (Without the compiler you don't have -lsunmath.)
    457 #fpectl fpectlmodule.c -R/opt/SUNWspro/lib -lsunmath -lm
    458 
    459 # For other systems: see instructions in fpectlmodule.c.
    460 #fpectl fpectlmodule.c ...
    461 
    462 # Test module for fpectl.  No extra libraries needed.
    463 #fpetest fpetestmodule.c
    464 
    465 # Andrew Kuchling's zlib module.
    466 # This require zlib 1.1.3 (or later).
    467 # See http://www.gzip.org/zlib/
    468 #zlib zlibmodule.c -I$(prefix)/include -L$(exec_prefix)/lib -lz
    469 
    470 # Interface to the Expat XML parser
    471 #
    472 # Expat was written by James Clark and is now maintained by a group of
    473 # developers on SourceForge; see www.libexpat.org for more
    474 # information.  The pyexpat module was written by Paul Prescod after a
    475 # prototype by Jack Jansen.  Source of Expat 1.95.2 is included in
    476 # Modules/expat/.  Usage of a system shared libexpat.so/expat.dll is
    477 # not advised.
    478 #
    479 # More information on Expat can be found at www.libexpat.org.
    480 #
    481 #pyexpat expat/xmlparse.c expat/xmlrole.c expat/xmltok.c pyexpat.c -I$(srcdir)/Modules/expat -DHAVE_EXPAT_CONFIG_H -DUSE_PYEXPAT_CAPI
    482 
    483 
    484 # Hye-Shik Chang's CJKCodecs
    485 
    486 # multibytecodec is required for all the other CJK codec modules
    487 #_multibytecodec cjkcodecs/multibytecodec.c
    488 
    489 #_codecs_cn cjkcodecs/_codecs_cn.c
    490 #_codecs_hk cjkcodecs/_codecs_hk.c
    491 #_codecs_iso2022 cjkcodecs/_codecs_iso2022.c
    492 #_codecs_jp cjkcodecs/_codecs_jp.c
    493 #_codecs_kr cjkcodecs/_codecs_kr.c
    494 #_codecs_tw cjkcodecs/_codecs_tw.c
    495 
    496 # Example -- included for reference only:
    497 # xx xxmodule.c
    498 
    499 # Another example -- the 'xxsubtype' module shows C-level subtyping in action
    500 xxsubtype xxsubtype.c
    501