Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 1 | # Universal Unix Makefile for Python extensions |
| 2 | # ============================================= |
| 3 | |
| 4 | # Short Instructions |
| 5 | # ------------------ |
| 6 | |
Guido van Rossum | bef03ae | 1997-07-19 22:52:43 +0000 | [diff] [blame] | 7 | # 1. Build and install Python (1.5 or newer). |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 8 | # 2. "make -f Makefile.pre.in boot" |
| 9 | # 3. "make" |
| 10 | # You should now have a shared library. |
| 11 | |
| 12 | # Long Instructions |
| 13 | # ----------------- |
| 14 | |
Guido van Rossum | bef03ae | 1997-07-19 22:52:43 +0000 | [diff] [blame] | 15 | # Build *and install* the basic Python 1.5 distribution. See the |
| 16 | # Python README for instructions. (This version of Makefile.pre.in |
| 17 | # only withs with Python 1.5, alpha 3 or newer.) |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 18 | |
| 19 | # Create a file Setup.in for your extension. This file follows the |
| 20 | # format of the Modules/Setup.in file; see the instructions there. |
| 21 | # For a simple module called "spam" on file "spammodule.c", it can |
| 22 | # contain a single line: |
| 23 | # spam spammodule.c |
| 24 | # You can build as many modules as you want in the same directory -- |
| 25 | # just have a separate line for each of them in the Setup.in file. |
| 26 | |
| 27 | # If you want to build your extension as a shared library, insert a |
| 28 | # line containing just the string |
| 29 | # *shared* |
| 30 | # at the top of your Setup.in file. |
| 31 | |
| 32 | # Note that the build process copies Setup.in to Setup, and then works |
| 33 | # with Setup. It doesn't overwrite Setup when Setup.in is changed, so |
| 34 | # while you're in the process of debugging your Setup.in file, you may |
| 35 | # want to edit Setup instead, and copy it back to Setup.in later. |
| 36 | # (All this is done so you can distribute your extension easily and |
| 37 | # someone else can select the modules they actually want to build by |
| 38 | # commenting out lines in the Setup file, without editing the |
| 39 | # original. Editing Setup is also used to specify nonstandard |
| 40 | # locations for include or library files.) |
| 41 | |
| 42 | # Copy this file (Misc/Makefile.pre.in) to the directory containing |
| 43 | # your extension. |
| 44 | |
| 45 | # Run "make -f Makefile.pre.in boot". This creates Makefile |
| 46 | # (producing Makefile.pre and sedscript as intermediate files) and |
| 47 | # config.c, incorporating the values for sys.prefix, sys.exec_prefix |
| 48 | # and sys.version from the installed Python binary. For this to work, |
| 49 | # the python binary must be on your path. If this fails, try |
Guido van Rossum | bef03ae | 1997-07-19 22:52:43 +0000 | [diff] [blame] | 50 | # make -f Makefile.pre.in Makefile VERSION=1.5 installdir=<prefix> |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 51 | # where <prefix> is the prefix used to install Python for installdir |
| 52 | # (and possibly similar for exec_installdir=<exec_prefix>). |
| 53 | |
Guido van Rossum | bec7484 | 1996-11-27 19:38:53 +0000 | [diff] [blame] | 54 | # Note: "make boot" implies "make clobber" -- it assumes that when you |
| 55 | # bootstrap you may have changed platforms so it removes all previous |
| 56 | # output files. |
| 57 | |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 58 | # If you are building your extension as a shared library (your |
| 59 | # Setup.in file starts with *shared*), run "make" or "make sharedmods" |
| 60 | # to build the shared library files. If you are building a statically |
| 61 | # linked Python binary (the only solution of your platform doesn't |
| 62 | # support shared libraries, and sometimes handy if you want to |
| 63 | # distribute or install the resulting Python binary), run "make |
| 64 | # python". |
| 65 | |
| 66 | # Note: Each time you edit Makefile.pre.in or Setup, you must run |
| 67 | # "make Makefile" before running "make". |
| 68 | |
| 69 | # Hint: if you want to use VPATH, you can start in an empty |
| 70 | # subdirectory and say (e.g.): |
| 71 | # make -f ../Makefile.pre.in boot srcdir=.. VPATH=.. |
| 72 | |
| 73 | |
| 74 | # === Bootstrap variables (edited through "make boot") === |
| 75 | |
| 76 | # The prefix used by "make inclinstall libainstall" of core python |
| 77 | installdir= /usr/local |
| 78 | |
| 79 | # The exec_prefix used by the same |
| 80 | exec_installdir=$(installdir) |
| 81 | |
| 82 | # Source directory and VPATH in case you want to use VPATH. |
| 83 | # (You will have to edit these two lines yourself -- there is no |
| 84 | # automatic support as the Makefile is not generated by |
| 85 | # config.status.) |
| 86 | srcdir= . |
| 87 | VPATH= . |
| 88 | |
| 89 | # === Variables that you may want to customize (rarely) === |
| 90 | |
Guido van Rossum | 434882e | 1996-10-08 17:21:11 +0000 | [diff] [blame] | 91 | # (Static) build target |
| 92 | TARGET= python |
| 93 | |
Guido van Rossum | bec7484 | 1996-11-27 19:38:53 +0000 | [diff] [blame] | 94 | # Installed python binary (used only by boot target) |
| 95 | PYTHON= python |
| 96 | |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 97 | # Add more -I and -D options here |
Guido van Rossum | 474ba3b | 1997-10-05 03:01:28 +0000 | [diff] [blame] | 98 | CFLAGS= $(OPT) -I$(INCLUDEPY) -I$(EXECINCLUDEPY) $(DEFS) |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 99 | |
| 100 | # These two variables can be set in Setup to merge extensions. |
| 101 | # See example[23]. |
| 102 | BASELIB= |
| 103 | BASESETUP= |
| 104 | |
| 105 | # === Variables set by makesetup === |
| 106 | |
| 107 | MODOBJS= _MODOBJS_ |
| 108 | MODLIBS= _MODLIBS_ |
| 109 | |
| 110 | # === Definitions added by makesetup === |
| 111 | |
| 112 | # === Variables from configure (through sedscript) === |
| 113 | |
| 114 | VERSION= @VERSION@ |
| 115 | CC= @CC@ |
Guido van Rossum | 9192267 | 1997-10-09 20:24:13 +0000 | [diff] [blame] | 116 | LINKCC= @LINKCC@ |
| 117 | SGI_ABI= @SGI_ABI@ |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 118 | OPT= @OPT@ |
| 119 | LDFLAGS= @LDFLAGS@ |
Guido van Rossum | 38d3fe0 | 1998-03-11 17:49:55 +0000 | [diff] [blame] | 120 | LDLAST= @LDLAST@ |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 121 | DEFS= @DEFS@ |
| 122 | LIBS= @LIBS@ |
| 123 | LIBM= @LIBM@ |
| 124 | LIBC= @LIBC@ |
| 125 | RANLIB= @RANLIB@ |
| 126 | MACHDEP= @MACHDEP@ |
| 127 | SO= @SO@ |
| 128 | LDSHARED= @LDSHARED@ |
| 129 | CCSHARED= @CCSHARED@ |
| 130 | LINKFORSHARED= @LINKFORSHARED@ |
Guido van Rossum | 9192267 | 1997-10-09 20:24:13 +0000 | [diff] [blame] | 131 | #@SET_CCC@ |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 132 | |
| 133 | # Install prefix for architecture-independent files |
| 134 | prefix= /usr/local |
| 135 | |
| 136 | # Install prefix for architecture-dependent files |
| 137 | exec_prefix= $(prefix) |
| 138 | |
Guido van Rossum | cc8e1a4 | 1998-04-30 13:34:12 +0000 | [diff] [blame] | 139 | # Uncomment the following two lines for AIX |
| 140 | #LINKCC= $(LIBPL)/makexp_aix $(LIBPL)/python.exp "" $(LIBRARY); $(PURIFY) $(CC) |
| 141 | #LDSHARED= $(LIBPL)/ld_so_aix $(CC) -bI:$(LIBPL)/python.exp |
| 142 | |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 143 | # === Fixed definitions === |
| 144 | |
Guido van Rossum | b0259bc | 1996-10-24 21:47:45 +0000 | [diff] [blame] | 145 | # Shell used by make (some versions default to the login shell, which is bad) |
| 146 | SHELL= /bin/sh |
| 147 | |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 148 | # Expanded directories |
| 149 | BINDIR= $(exec_installdir)/bin |
| 150 | LIBDIR= $(exec_prefix)/lib |
| 151 | MANDIR= $(installdir)/man |
| 152 | INCLUDEDIR= $(installdir)/include |
| 153 | SCRIPTDIR= $(prefix)/lib |
| 154 | |
| 155 | # Detailed destination directories |
| 156 | BINLIBDEST= $(LIBDIR)/python$(VERSION) |
| 157 | LIBDEST= $(SCRIPTDIR)/python$(VERSION) |
| 158 | INCLUDEPY= $(INCLUDEDIR)/python$(VERSION) |
Guido van Rossum | 474ba3b | 1997-10-05 03:01:28 +0000 | [diff] [blame] | 159 | EXECINCLUDEPY= $(exec_installdir)/include/python$(VERSION) |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 160 | LIBP= $(exec_installdir)/lib/python$(VERSION) |
Fred Drake | bfeb74d | 1997-10-04 04:56:40 +0000 | [diff] [blame] | 161 | DESTSHARED= $(BINLIBDEST)/site-packages |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 162 | |
| 163 | LIBPL= $(LIBP)/config |
| 164 | |
Guido van Rossum | bef03ae | 1997-07-19 22:52:43 +0000 | [diff] [blame] | 165 | PYTHONLIBS= $(LIBPL)/libpython$(VERSION).a |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 166 | |
| 167 | MAKESETUP= $(LIBPL)/makesetup |
| 168 | MAKEFILE= $(LIBPL)/Makefile |
| 169 | CONFIGC= $(LIBPL)/config.c |
| 170 | CONFIGCIN= $(LIBPL)/config.c.in |
| 171 | SETUP= $(LIBPL)/Setup |
| 172 | |
| 173 | SYSLIBS= $(LIBM) $(LIBC) |
| 174 | |
Guido van Rossum | bef03ae | 1997-07-19 22:52:43 +0000 | [diff] [blame] | 175 | ADDOBJS= $(LIBPL)/python.o config.o |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 176 | |
Fred Drake | bfeb74d | 1997-10-04 04:56:40 +0000 | [diff] [blame] | 177 | # Portable install script (configure doesn't always guess right) |
| 178 | INSTALL= $(LIBPL)/install-sh -c |
| 179 | # Shared libraries must be installed with executable mode on some systems; |
| 180 | # rather than figuring out exactly which, we always give them executable mode. |
| 181 | # Also, making them read-only seems to be a good idea... |
| 182 | INSTALL_SHARED= ${INSTALL} -m 555 |
| 183 | |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 184 | # === Fixed rules === |
| 185 | |
| 186 | # Default target. This builds shared libraries only |
| 187 | default: sharedmods |
| 188 | |
| 189 | # Build everything |
Guido van Rossum | 434882e | 1996-10-08 17:21:11 +0000 | [diff] [blame] | 190 | all: static sharedmods |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 191 | |
| 192 | # Build shared libraries from our extension modules |
| 193 | sharedmods: $(SHAREDMODS) |
| 194 | |
| 195 | # Build a static Python binary containing our extension modules |
Guido van Rossum | 434882e | 1996-10-08 17:21:11 +0000 | [diff] [blame] | 196 | static: $(TARGET) |
Guido van Rossum | bef03ae | 1997-07-19 22:52:43 +0000 | [diff] [blame] | 197 | $(TARGET): $(ADDOBJS) lib.a $(PYTHONLIBS) Makefile $(BASELIB) |
Guido van Rossum | 38d3fe0 | 1998-03-11 17:49:55 +0000 | [diff] [blame] | 198 | $(LINKCC) $(LDFLAGS) $(LINKFORSHARED) \ |
| 199 | $(ADDOBJS) lib.a $(PYTHONLIBS) \ |
Guido van Rossum | 434882e | 1996-10-08 17:21:11 +0000 | [diff] [blame] | 200 | $(LINKPATH) $(BASELIB) $(MODLIBS) $(LIBS) $(SYSLIBS) \ |
Guido van Rossum | 38d3fe0 | 1998-03-11 17:49:55 +0000 | [diff] [blame] | 201 | -o $(TARGET) $(LDLAST) |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 202 | |
Fred Drake | bfeb74d | 1997-10-04 04:56:40 +0000 | [diff] [blame] | 203 | install: sharedmods |
| 204 | if test ! -d $(DESTSHARED) ; then \ |
| 205 | mkdir $(DESTSHARED) ; else true ; fi |
| 206 | -for i in X $(SHAREDMODS); do \ |
| 207 | if test $$i != X; \ |
| 208 | then $(INSTALL_SHARED) $$i $(DESTSHARED)/$$i; \ |
| 209 | fi; \ |
| 210 | done |
| 211 | |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 212 | # Build the library containing our extension modules |
| 213 | lib.a: $(MODOBJS) |
| 214 | -rm -f lib.a |
| 215 | ar cr lib.a $(MODOBJS) |
Guido van Rossum | bef03ae | 1997-07-19 22:52:43 +0000 | [diff] [blame] | 216 | -$(RANLIB) lib.a |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 217 | |
| 218 | # This runs makesetup *twice* to use the BASESETUP definition from Setup |
| 219 | config.c Makefile: Makefile.pre Setup $(BASESETUP) $(MAKESETUP) |
| 220 | $(MAKESETUP) \ |
| 221 | -m Makefile.pre -c $(CONFIGCIN) Setup -n $(BASESETUP) $(SETUP) |
| 222 | $(MAKE) -f Makefile do-it-again |
| 223 | |
| 224 | # Internal target to run makesetup for the second time |
| 225 | do-it-again: |
| 226 | $(MAKESETUP) \ |
| 227 | -m Makefile.pre -c $(CONFIGCIN) Setup -n $(BASESETUP) $(SETUP) |
| 228 | |
| 229 | # Make config.o from the config.c created by makesetup |
| 230 | config.o: config.c |
| 231 | $(CC) $(CFLAGS) -c config.c |
| 232 | |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 233 | # Setup is copied from Setup.in *only* if it doesn't yet exist |
| 234 | Setup: |
| 235 | cp $(srcdir)/Setup.in Setup |
| 236 | |
| 237 | # Make the intermediate Makefile.pre from Makefile.pre.in |
| 238 | Makefile.pre: Makefile.pre.in sedscript |
| 239 | sed -f sedscript $(srcdir)/Makefile.pre.in >Makefile.pre |
| 240 | |
| 241 | # Shortcuts to make the sed arguments on one line |
| 242 | P=prefix |
| 243 | E=exec_prefix |
| 244 | H=Generated automatically from Makefile.pre.in by sedscript. |
| 245 | L=LINKFORSHARED |
| 246 | |
| 247 | # Make the sed script used to create Makefile.pre from Makefile.pre.in |
| 248 | sedscript: $(MAKEFILE) |
| 249 | sed -n \ |
| 250 | -e '1s/.*/1i\\/p' \ |
| 251 | -e '2s%.*%# $H%p' \ |
| 252 | -e '/^VERSION=/s/^VERSION=[ ]*\(.*\)/s%@VERSION[@]%\1%/p' \ |
| 253 | -e '/^CC=/s/^CC=[ ]*\(.*\)/s%@CC[@]%\1%/p' \ |
Guido van Rossum | 9192267 | 1997-10-09 20:24:13 +0000 | [diff] [blame] | 254 | -e '/^CCC=/s/^CCC=[ ]*\(.*\)/s%#@SET_CCC[@]%CCC=\1%/p' \ |
| 255 | -e '/^LINKCC=/s/^LINKCC=[ ]*\(.*\)/s%@LINKCC[@]%\1%/p' \ |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 256 | -e '/^OPT=/s/^OPT=[ ]*\(.*\)/s%@OPT[@]%\1%/p' \ |
| 257 | -e '/^LDFLAGS=/s/^LDFLAGS=[ ]*\(.*\)/s%@LDFLAGS[@]%\1%/p' \ |
Guido van Rossum | 750c8ce | 1998-05-20 15:53:22 +0000 | [diff] [blame] | 258 | -e '/^LDLAST=/s/^LDLAST=[ ]*\(.*\)/s%@LDLAST[@]%\1%/p' \ |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 259 | -e '/^DEFS=/s/^DEFS=[ ]*\(.*\)/s%@DEFS[@]%\1%/p' \ |
| 260 | -e '/^LIBS=/s/^LIBS=[ ]*\(.*\)/s%@LIBS[@]%\1%/p' \ |
| 261 | -e '/^LIBM=/s/^LIBM=[ ]*\(.*\)/s%@LIBM[@]%\1%/p' \ |
| 262 | -e '/^LIBC=/s/^LIBC=[ ]*\(.*\)/s%@LIBC[@]%\1%/p' \ |
| 263 | -e '/^RANLIB=/s/^RANLIB=[ ]*\(.*\)/s%@RANLIB[@]%\1%/p' \ |
| 264 | -e '/^MACHDEP=/s/^MACHDEP=[ ]*\(.*\)/s%@MACHDEP[@]%\1%/p' \ |
| 265 | -e '/^SO=/s/^SO=[ ]*\(.*\)/s%@SO[@]%\1%/p' \ |
| 266 | -e '/^LDSHARED=/s/^LDSHARED=[ ]*\(.*\)/s%@LDSHARED[@]%\1%/p' \ |
| 267 | -e '/^CCSHARED=/s/^CCSHARED=[ ]*\(.*\)/s%@CCSHARED[@]%\1%/p' \ |
Guido van Rossum | 795a4bc | 1998-06-08 21:22:12 +0000 | [diff] [blame] | 268 | -e '/^SGI_ABI=/s/^SGI_ABI=[ ]*\(.*\)/s%@SGI_ABI[@]%\1%/p' \ |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 269 | -e '/^$L=/s/^$L=[ ]*\(.*\)/s%@$L[@]%\1%/p' \ |
| 270 | -e '/^$P=/s/^$P=\(.*\)/s%^$P=.*%$P=\1%/p' \ |
| 271 | -e '/^$E=/s/^$E=\(.*\)/s%^$E=.*%$E=\1%/p' \ |
| 272 | $(MAKEFILE) >sedscript |
Guido van Rossum | 9192267 | 1997-10-09 20:24:13 +0000 | [diff] [blame] | 273 | echo "/^#@SET_CCC@/d" >>sedscript |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 274 | echo "/^installdir=/s%=.*%= $(installdir)%" >>sedscript |
| 275 | echo "/^exec_installdir=/s%=.*%=$(exec_installdir)%" >>sedscript |
| 276 | echo "/^srcdir=/s%=.*%= $(srcdir)%" >>sedscript |
| 277 | echo "/^VPATH=/s%=.*%= $(VPATH)%" >>sedscript |
| 278 | echo "/^LINKPATH=/s%=.*%= $(LINKPATH)%" >>sedscript |
| 279 | echo "/^BASELIB=/s%=.*%= $(BASELIB)%" >>sedscript |
| 280 | echo "/^BASESETUP=/s%=.*%= $(BASESETUP)%" >>sedscript |
| 281 | |
| 282 | # Bootstrap target |
Guido van Rossum | 43e6661 | 1996-10-10 19:12:47 +0000 | [diff] [blame] | 283 | boot: clobber |
Guido van Rossum | bec7484 | 1996-11-27 19:38:53 +0000 | [diff] [blame] | 284 | VERSION=`$(PYTHON) -c "import sys; print sys.version[:3]"`; \ |
| 285 | installdir=`$(PYTHON) -c "import sys; print sys.prefix"`; \ |
| 286 | exec_installdir=`$(PYTHON) -c "import sys; print sys.exec_prefix"`; \ |
Guido van Rossum | 946cf89 | 1996-09-11 12:15:07 +0000 | [diff] [blame] | 287 | $(MAKE) -f $(srcdir)/Makefile.pre.in VPATH=$(VPATH) srcdir=$(srcdir) \ |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 288 | VERSION=$$VERSION \ |
| 289 | installdir=$$installdir \ |
Guido van Rossum | 946cf89 | 1996-09-11 12:15:07 +0000 | [diff] [blame] | 290 | exec_installdir=$$exec_installdir \ |
| 291 | Makefile |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 292 | |
| 293 | # Handy target to remove intermediate files and backups |
| 294 | clean: |
| 295 | -rm -f *.o *~ |
| 296 | |
| 297 | # Handy target to remove everything that is easily regenerated |
| 298 | clobber: clean |
Guido van Rossum | bec7484 | 1996-11-27 19:38:53 +0000 | [diff] [blame] | 299 | -rm -f *.a tags TAGS config.c Makefile.pre $(TARGET) sedscript |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 300 | -rm -f *.so *.sl so_locations |
| 301 | |
| 302 | |
| 303 | # Handy target to remove everything you don't want to distribute |
| 304 | distclean: clobber |
| 305 | -rm -f Makefile Setup |