/Modules/Setup.dist

http://unladen-swallow.googlecode.com/ · Unknown · 495 lines · 379 code · 116 blank · 0 comment · 0 complexity · a606fd1d14b8da23bff735705a0178ee MD5 · raw file

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