cpython/Modules/Setup.in

315 lines
10 KiB
Plaintext
Raw Normal View History

# The file Setup is used by the makesetup script to construct the files
# Makefile and config.c, from Makefile.pre and config.c.in,
# respectively. The file Setup itself is initially copied from
# Setup.in; once it exists it will not be overwritten, so you can edit
1995-04-10 11:37:18 +00:00
# Setup to your heart's content. Note that Makefile.pre is created
# from Makefile.pre.in by the toplevel configure script.
# (VPATH notes: Setup and Makefile.pre are in the build directory, as
1995-04-10 11:37:18 +00:00
# are Makefile and config.c; the *.in files are in the source
# directory.)
1994-01-02 00:26:09 +00:00
# Each line in this file describes one or more optional modules.
# Comment out lines to suppress modules.
# Lines have the following structure:
#
# <module> ... [<sourcefile> ...] [<cpparg> ...] [<library> ...]
1994-01-02 00:26:09 +00:00
#
# <sourcefile> is anything ending in .c (.C, .cc, .c++ are C++ files)
1994-01-02 00:26:09 +00:00
# <cpparg> is anything starting with -I, -D, -U or -C
# <library> is anything ending in .a or beginning with -l or -L
# <module> is anything else but should be a valid Python
# identifier (letters, digits, underscores, beginning with non-digit)
#
# Lines can also have the form
#
# <name> = <value>
#
# which defines a Make variable definition inserted into Makefile.in
1994-09-12 10:42:20 +00:00
#
# Finally, if a line has the literal form
#
# *noconfig*
#
# (that is including the '*' and '*' !) then the following modules will
# not be included in the config.c file, nor in the list of objects to be
# added to the library archive, and their linker options won't be added
# to the linker options, but rules to create their .o files and their
1995-04-10 11:37:18 +00:00
# shared libraries will still be added to the Makefile, and their
# names will be collected in the Make variable SHAREDMODS. This is
# used to build modules as shared libraries. (They must be installed
# using "make sharedinstall".)
1994-01-02 00:26:09 +00:00
# NOTE: As a standard policy, as many modules as can be supported by a
# platform should be present. The distribution comes with all modules
# enabled that are supported by most platforms and don't require you
1995-04-10 11:37:18 +00:00
# to ftp sources from elsewhere.
1994-01-02 00:26:09 +00:00
# Some special rules to define PYTHONPATH.
# Edit the definitions below to indicate which options you are using.
# Don't add any whitespace or comments!
# Don't edit this (usually)
DESTLIB=$(prefix)/lib/python
1995-09-13 18:39:04 +00:00
# Site specific path insertions -- should begin with : if non-empty
SITEPATH=
# Standard path -- don't edit
DESTPATH=:$(DESTLIB)
# Standard enabled (tests are always available)
TESTPATH=:$(DESTLIB)/test
1994-09-12 10:42:20 +00:00
# Path for machine- or system-dependent modules (and shared libraries)
MACHDEPPATH=:$(DESTLIB)/$(MACHDEP)
1995-09-13 18:39:04 +00:00
COREPYTHONPATH=.$(SITEPATH)$(DESTPATH)$(TESTPATH)$(MACHDEPPATH)$(STDWINPATH)$(TKPATH)
PYTHONPATH=$(COREPYTHONPATH)
# The modules listed here can't be built as shared libraries for
# various reasons; therefore they are listed here instead of in the
# normal order.
1995-04-10 11:37:18 +00:00
# Some modules that are normally always on:
posix posixmodule.c # posix (UNIX) system calls
signal signalmodule.c # signal(2)
1995-04-10 11:37:18 +00:00
# The SGI specific GL module:
1994-10-20 22:01:38 +00:00
#gl glmodule.c -lgl -lX11 # Graphics Library -- SGI only
# Thread module -- works on selected systems only, e.g. SGI IRIX and
# on SunOS 5.x (SOLARIS) only.
# Note that you must have configured (and built!) Python with the
1995-04-10 11:37:18 +00:00
# --with-thread option passed to the configure script for this to work:
#thread threadmodule.c
1994-10-20 22:01:38 +00:00
# Uncommenting the following line tells makesetup that all following
1995-04-10 11:37:18 +00:00
# modules are to be built as shared libraries (see above for more
# detail):
1994-10-20 22:01:38 +00:00
#*noconfig*
1995-04-10 11:37:18 +00:00
# Modules that should always be present (non UNIX dependent):
1994-01-02 00:26:09 +00:00
array arraymodule.c # array objects
math mathmodule.c -lm # math library functions, e.g. sin()
parser parsermodule.c # raw interface to the Python parser
regex regexmodule.c regexpr.c # Regular expressions, GNU Emacs style
strop stropmodule.c # fast string operations implemented in C
struct structmodule.c # binary structure packing/unpacking
time timemodule.c # time operations and variables
1994-01-02 00:26:09 +00:00
1995-04-10 11:37:18 +00:00
# Modules with some UNIX dependencies -- on by default:
# (If you have a really backward UNIX, select and socket may not be
# supported...)
1994-01-02 00:26:09 +00:00
fcntl fcntlmodule.c # fcntl(2) and ioctl(2)
pwd pwdmodule.c # pwd(3)
grp grpmodule.c # grp(3)
crypt cryptmodule.c # -lcrypt # crypt(3); needs -lcrypt on some systems
select selectmodule.c # select(2); not on ancient System V
socket socketmodule.c # socket(2); not on ancient System V
1994-01-02 00:26:09 +00:00
# Some more UNIX dependent modules -- off by default, since these
1995-04-10 11:37:18 +00:00
# are not supported by all UNIX systems:
#dbm dbmmodule.c # dbm(3) may require -lndbm or similar
#nis nismodule.c # Sun yellow pages -- not everywhere
1994-09-12 10:42:20 +00:00
#termios termios.c # Steen Lumholt's termios module
# Multimedia modules -- on by default.
1995-04-10 11:37:18 +00:00
# These represent audio samples or images as strings:
1994-01-02 00:26:09 +00:00
audioop audioop.c # Operations on audio samples
imageop imageop.c # Operations on images
rgbimg rgbimgmodule.c # Read SGI RGB image files (but coded portably)
1994-01-02 00:26:09 +00:00
# The stdwin module provides a simple, portable (between X11 and Mac)
# windowing interface. You need to ftp the STDWIN library, e.g. from
1995-04-10 11:37:18 +00:00
# ftp://ftp.cwi.nl/pub/stdwin. (If you get it elsewhere, be sure to
# get version 1.0 or higher!) The STDWIN variable must point to the
# STDWIN toplevel directory.
1995-04-10 11:37:18 +00:00
# Uncomment and edit as needed:
#STDWIN=/ufs/guido/src/stdwin
1994-01-02 00:26:09 +00:00
1995-04-10 11:37:18 +00:00
# Uncomment these lines:
#STDWINPATH=:$(DESTLIB)/stdwin
1994-09-12 10:42:20 +00:00
#LIBTEXTEDIT=$(STDWIN)/$(MACHDEP)/Packs/textedit/libtextedit.a
#LIBX11STDWIN=$(STDWIN)/$(MACHDEP)/Ports/x11/libstdwin.a
#stdwin stdwinmodule.c -I$(STDWIN)/H $(LIBTEXTEDIT) $(LIBX11STDWIN) -lX11
1995-04-10 11:37:18 +00:00
# Use this instead of the last two lines above for alphanumeric stdwin:
#LIBALFASTDWIN=$(STDWIN)/$(MACHDEP)/Ports/alfa/libstdwin.a
1994-09-12 10:42:20 +00:00
#stdwin stdwinmodule.c -I$(STDWIN)/H $(LIBTEXTEDIT) $(LIBALFASTDWIN) -ltermcap
1994-01-02 00:26:09 +00:00
# The md5 module implements the RSA Data Security, Inc. MD5
# Message-Digest Algorithm, described in RFC 1321. The necessary files
# md5c.c and md5.h are included here.
md5 md5module.c md5c.c
1994-01-02 00:26:09 +00:00
# The mpz module interfaces to the GNU Multiple Precision library.
# You need to ftp the GNU MP library.
# The GMP variable must point to the GMP source directory.
# This was originally written and tested against GMP 1.2. I have
# compiled it against GMP 1.3.2 (the latest I believe) and it seems to
# work OK, but I haven't tested it thoroughly (lacking knowledge about
# it).
1994-01-02 00:26:09 +00:00
1994-10-06 16:12:06 +00:00
# A compatible MP library unencombered by the GPL also exists. It was
# posted to comp.sources.misc in volume 40 and is widely available from
# FTP archive sites. One URL for it is:
# ftp://gatekeeper.dec.com/.b/usenet/comp.sources.misc/volume40/fgmp/part01.Z
1994-01-02 00:26:09 +00:00
#GMP=/ufs/guido/src/gmp
#mpz mpzmodule.c -I$(GMP) $(GMP)/libgmp.a
1994-01-02 00:26:09 +00:00
# SGI IRIX specific modules -- off by default.
1994-10-20 22:01:38 +00:00
1995-04-10 11:37:18 +00:00
# These module work on any SGI machine:
1994-01-02 00:26:09 +00:00
# *** gl must be enabled higher up in this file ***
1994-10-20 22:01:38 +00:00
#fm fmmodule.c -lfm -lgl # Font Manager
#sgi sgimodule.c # sgi.nap() and a few more
# This module requires the header file
1995-04-10 11:37:18 +00:00
# /usr/people/4Dgifts/iristools/include/izoom.h:
1994-10-20 22:01:38 +00:00
#imgfile imgfile.c -limage -lgutil -lm # Image Processing Utilities
1995-04-10 11:37:18 +00:00
# These modules require the Multimedia Development Option (I think):
1994-10-20 22:01:38 +00:00
#al almodule.c -laudio # Audio Library
#cd cdmodule.c -lcdaudio -lds -lmediad # CD Audio Library
#cl clmodule.c -lcl -lawareaudio # Compression Library
#sv svmodule.c yuvconvert.c -lsvideo -lXext -lX11 # Starter Video
1994-01-02 00:26:09 +00:00
# The FORMS library, by Mark Overmars, implements user interface
# components such as dialogs and buttons using SGI's GL and FM
# libraries. You must ftp the FORMS library separately from
# ftp://ftp.cs.ruu.nl/pub/SGI/FORMS. It was tested with FORMS 2.2a.
# The FORMS variable must point to the FORMS subdirectory of the forms
1995-04-10 11:37:18 +00:00
# toplevel directory:
1994-01-02 00:26:09 +00:00
#FORMS=/ufs/guido/src/forms/FORMS
#fl flmodule.c -I$(FORMS) $(FORMS)/libforms.a -lfm -lgl
1994-01-02 00:26:09 +00:00
1995-04-10 11:37:18 +00:00
# SunOS specific modules -- off by default:
1994-01-02 00:26:09 +00:00
#sunaudiodev sunaudiodev.c
1994-01-02 00:26:09 +00:00
1995-04-10 11:37:18 +00:00
# George Neville-Neil's timing module:
#timing timingmodule.c
# Steen Lumholt's tkinter module.
#
# For use with plain Tk, use the first line.
#
# For use with extended Tk (i.e. if you have added extra widgets to
# the Tk library, such as the common "studButton" and "triButton"
# extensions), edit tkappinit.c, add appropriate -DWITH_... and
# libraries/objects to the second line, and use that.
#
# In all cases also enable the last line (TKPATH).
#
# See the section "The Tk interface" in ../README for more info.
# *** Use ONE of the following two lines, see previous comments ***
#tkinter tkintermodule.c -I/usr/local/include -L/usr/local/lib -ltk -ltcl -lX11
#tkinter tkintermodule.c tkappinit.c -DWITH_APPINIT -I/usr/local/include -L/usr/local/lib -ltk -ltcl -lX11
# *** ALWAYS use this line as well ***
#TKPATH=:$(DESTLIB)/tkinter
1995-04-10 11:37:18 +00:00
# Lance Ellinghaus's modules:
rotor rotormodule.c # enigma-inspired encryption
#syslog syslogmodule.c # syslog daemon interface
1995-07-26 17:31:41 +00:00
# Lance's curses module. This requires the System V version of
# curses, sometimes known as ncurses (e.g. on Linux, link with
# -lncurses instead of -lcurses; on SunOS 4.1.3, insert -I/usr/5include
# -L/usr/5lib before -lcurses).
1995-07-26 17:31:41 +00:00
#curses cursesmodule.c -lcurses -ltermcap
1995-04-10 11:37:18 +00:00
# Tommy Burnette's 'new' module (creates new empty objects of certain kinds):
#new newmodule.c
1995-04-10 11:37:18 +00:00
# John Redford's sybase module (requires sybase):
# (Unfortunately this code is orphaned. Read the source for documentation.)
#sybase sybasemodule.c
1995-01-12 11:29:01 +00:00
# Generic (SunOS / SVR4) dynamic loading module.
# This is not needed for dynamic loading of Python modules --
# it is a highly experimental and dangerous device for calling
1995-04-10 11:37:18 +00:00
# *arbitrary* C functions in *arbitrary* shared libraries:
#dl dlmodule.c
# Anthony Baxter's gdbm module (derived from Jack's dbm module)
1995-04-10 11:37:18 +00:00
# GNU dbm(3) will require -lgdbm:
#gdbm gdbmmodule.c -I/usr/local/include -L/usr/local/lib -lgdbm
1994-01-02 00:26:09 +00:00
1995-08-28 02:59:06 +00:00
# Berkeley DB interface.
#
# This requires the Berkeley DB code, see
# ftp://ftp.cs.berkeley.edu/pub/4bsd/db.1.85.tar.gz
#
# Edit the variables DB and DBPORT to point to the db top directory
# and the subdirectory of PORT where you built it.
1995-07-26 17:31:41 +00:00
#DB=/depot/sundry/src/db.1.85/
#DBPORT=$(DB)/PORT/sunos.5.2
1995-08-30 23:44:41 +00:00
#bsddb bsddbmodule.o -I$(DB)/include -I$(DBPORT) $(DBPORT)/libdb.a
# Andy Bensky's "environment" module (contains putenv())
#environment environment.c
# David Wayne Williams' soundex module
#soundex soundex.c
# Objective-C (incomplete!!!)
#objc.c
# Helper module for various ascii-encoders
binascii binasciimodule.c
1995-04-10 11:37:18 +00:00
# Example -- included for reference only:
# xx xxmodule.c