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@ |
| 120 | DEFS= @DEFS@ |
| 121 | LIBS= @LIBS@ |
| 122 | LIBM= @LIBM@ |
| 123 | LIBC= @LIBC@ |
| 124 | RANLIB= @RANLIB@ |
| 125 | MACHDEP= @MACHDEP@ |
| 126 | SO= @SO@ |
| 127 | LDSHARED= @LDSHARED@ |
| 128 | CCSHARED= @CCSHARED@ |
| 129 | LINKFORSHARED= @LINKFORSHARED@ |
Guido van Rossum | 9192267 | 1997-10-09 20:24:13 +0000 | [diff] [blame] | 130 | #@SET_CCC@ |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 131 | |
| 132 | # Install prefix for architecture-independent files |
| 133 | prefix= /usr/local |
| 134 | |
| 135 | # Install prefix for architecture-dependent files |
| 136 | exec_prefix= $(prefix) |
| 137 | |
| 138 | # === Fixed definitions === |
| 139 | |
Guido van Rossum | b0259bc | 1996-10-24 21:47:45 +0000 | [diff] [blame] | 140 | # Shell used by make (some versions default to the login shell, which is bad) |
| 141 | SHELL= /bin/sh |
| 142 | |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 143 | # Expanded directories |
| 144 | BINDIR= $(exec_installdir)/bin |
| 145 | LIBDIR= $(exec_prefix)/lib |
| 146 | MANDIR= $(installdir)/man |
| 147 | INCLUDEDIR= $(installdir)/include |
| 148 | SCRIPTDIR= $(prefix)/lib |
| 149 | |
| 150 | # Detailed destination directories |
| 151 | BINLIBDEST= $(LIBDIR)/python$(VERSION) |
| 152 | LIBDEST= $(SCRIPTDIR)/python$(VERSION) |
| 153 | INCLUDEPY= $(INCLUDEDIR)/python$(VERSION) |
Guido van Rossum | 474ba3b | 1997-10-05 03:01:28 +0000 | [diff] [blame] | 154 | EXECINCLUDEPY= $(exec_installdir)/include/python$(VERSION) |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 155 | LIBP= $(exec_installdir)/lib/python$(VERSION) |
Fred Drake | bfeb74d | 1997-10-04 04:56:40 +0000 | [diff] [blame] | 156 | DESTSHARED= $(BINLIBDEST)/site-packages |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 157 | |
| 158 | LIBPL= $(LIBP)/config |
| 159 | |
Guido van Rossum | bef03ae | 1997-07-19 22:52:43 +0000 | [diff] [blame] | 160 | PYTHONLIBS= $(LIBPL)/libpython$(VERSION).a |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 161 | |
| 162 | MAKESETUP= $(LIBPL)/makesetup |
| 163 | MAKEFILE= $(LIBPL)/Makefile |
| 164 | CONFIGC= $(LIBPL)/config.c |
| 165 | CONFIGCIN= $(LIBPL)/config.c.in |
| 166 | SETUP= $(LIBPL)/Setup |
| 167 | |
| 168 | SYSLIBS= $(LIBM) $(LIBC) |
| 169 | |
Guido van Rossum | bef03ae | 1997-07-19 22:52:43 +0000 | [diff] [blame] | 170 | ADDOBJS= $(LIBPL)/python.o config.o |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 171 | |
Fred Drake | bfeb74d | 1997-10-04 04:56:40 +0000 | [diff] [blame] | 172 | # Portable install script (configure doesn't always guess right) |
| 173 | INSTALL= $(LIBPL)/install-sh -c |
| 174 | # Shared libraries must be installed with executable mode on some systems; |
| 175 | # rather than figuring out exactly which, we always give them executable mode. |
| 176 | # Also, making them read-only seems to be a good idea... |
| 177 | INSTALL_SHARED= ${INSTALL} -m 555 |
| 178 | |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 179 | # === Fixed rules === |
| 180 | |
| 181 | # Default target. This builds shared libraries only |
| 182 | default: sharedmods |
| 183 | |
| 184 | # Build everything |
Guido van Rossum | 434882e | 1996-10-08 17:21:11 +0000 | [diff] [blame] | 185 | all: static sharedmods |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 186 | |
| 187 | # Build shared libraries from our extension modules |
| 188 | sharedmods: $(SHAREDMODS) |
| 189 | |
| 190 | # Build a static Python binary containing our extension modules |
Guido van Rossum | 434882e | 1996-10-08 17:21:11 +0000 | [diff] [blame] | 191 | static: $(TARGET) |
Guido van Rossum | bef03ae | 1997-07-19 22:52:43 +0000 | [diff] [blame] | 192 | $(TARGET): $(ADDOBJS) lib.a $(PYTHONLIBS) Makefile $(BASELIB) |
| 193 | $(CC) $(LDFLAGS) $(ADDOBJS) lib.a $(PYTHONLIBS) \ |
Guido van Rossum | 434882e | 1996-10-08 17:21:11 +0000 | [diff] [blame] | 194 | $(LINKPATH) $(BASELIB) $(MODLIBS) $(LIBS) $(SYSLIBS) \ |
| 195 | -o $(TARGET) |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 196 | |
Fred Drake | bfeb74d | 1997-10-04 04:56:40 +0000 | [diff] [blame] | 197 | install: sharedmods |
| 198 | if test ! -d $(DESTSHARED) ; then \ |
| 199 | mkdir $(DESTSHARED) ; else true ; fi |
| 200 | -for i in X $(SHAREDMODS); do \ |
| 201 | if test $$i != X; \ |
| 202 | then $(INSTALL_SHARED) $$i $(DESTSHARED)/$$i; \ |
| 203 | fi; \ |
| 204 | done |
| 205 | |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 206 | # Build the library containing our extension modules |
| 207 | lib.a: $(MODOBJS) |
| 208 | -rm -f lib.a |
| 209 | ar cr lib.a $(MODOBJS) |
Guido van Rossum | bef03ae | 1997-07-19 22:52:43 +0000 | [diff] [blame] | 210 | -$(RANLIB) lib.a |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 211 | |
| 212 | # This runs makesetup *twice* to use the BASESETUP definition from Setup |
| 213 | config.c Makefile: Makefile.pre Setup $(BASESETUP) $(MAKESETUP) |
| 214 | $(MAKESETUP) \ |
| 215 | -m Makefile.pre -c $(CONFIGCIN) Setup -n $(BASESETUP) $(SETUP) |
| 216 | $(MAKE) -f Makefile do-it-again |
| 217 | |
| 218 | # Internal target to run makesetup for the second time |
| 219 | do-it-again: |
| 220 | $(MAKESETUP) \ |
| 221 | -m Makefile.pre -c $(CONFIGCIN) Setup -n $(BASESETUP) $(SETUP) |
| 222 | |
| 223 | # Make config.o from the config.c created by makesetup |
| 224 | config.o: config.c |
| 225 | $(CC) $(CFLAGS) -c config.c |
| 226 | |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 227 | # Setup is copied from Setup.in *only* if it doesn't yet exist |
| 228 | Setup: |
| 229 | cp $(srcdir)/Setup.in Setup |
| 230 | |
| 231 | # Make the intermediate Makefile.pre from Makefile.pre.in |
| 232 | Makefile.pre: Makefile.pre.in sedscript |
| 233 | sed -f sedscript $(srcdir)/Makefile.pre.in >Makefile.pre |
| 234 | |
| 235 | # Shortcuts to make the sed arguments on one line |
| 236 | P=prefix |
| 237 | E=exec_prefix |
| 238 | H=Generated automatically from Makefile.pre.in by sedscript. |
| 239 | L=LINKFORSHARED |
| 240 | |
| 241 | # Make the sed script used to create Makefile.pre from Makefile.pre.in |
| 242 | sedscript: $(MAKEFILE) |
| 243 | sed -n \ |
| 244 | -e '1s/.*/1i\\/p' \ |
| 245 | -e '2s%.*%# $H%p' \ |
| 246 | -e '/^VERSION=/s/^VERSION=[ ]*\(.*\)/s%@VERSION[@]%\1%/p' \ |
| 247 | -e '/^CC=/s/^CC=[ ]*\(.*\)/s%@CC[@]%\1%/p' \ |
Guido van Rossum | 9192267 | 1997-10-09 20:24:13 +0000 | [diff] [blame] | 248 | -e '/^CCC=/s/^CCC=[ ]*\(.*\)/s%#@SET_CCC[@]%CCC=\1%/p' \ |
| 249 | -e '/^LINKCC=/s/^LINKCC=[ ]*\(.*\)/s%@LINKCC[@]%\1%/p' \ |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 250 | -e '/^OPT=/s/^OPT=[ ]*\(.*\)/s%@OPT[@]%\1%/p' \ |
| 251 | -e '/^LDFLAGS=/s/^LDFLAGS=[ ]*\(.*\)/s%@LDFLAGS[@]%\1%/p' \ |
| 252 | -e '/^DEFS=/s/^DEFS=[ ]*\(.*\)/s%@DEFS[@]%\1%/p' \ |
| 253 | -e '/^LIBS=/s/^LIBS=[ ]*\(.*\)/s%@LIBS[@]%\1%/p' \ |
| 254 | -e '/^LIBM=/s/^LIBM=[ ]*\(.*\)/s%@LIBM[@]%\1%/p' \ |
| 255 | -e '/^LIBC=/s/^LIBC=[ ]*\(.*\)/s%@LIBC[@]%\1%/p' \ |
| 256 | -e '/^RANLIB=/s/^RANLIB=[ ]*\(.*\)/s%@RANLIB[@]%\1%/p' \ |
| 257 | -e '/^MACHDEP=/s/^MACHDEP=[ ]*\(.*\)/s%@MACHDEP[@]%\1%/p' \ |
| 258 | -e '/^SO=/s/^SO=[ ]*\(.*\)/s%@SO[@]%\1%/p' \ |
| 259 | -e '/^LDSHARED=/s/^LDSHARED=[ ]*\(.*\)/s%@LDSHARED[@]%\1%/p' \ |
| 260 | -e '/^CCSHARED=/s/^CCSHARED=[ ]*\(.*\)/s%@CCSHARED[@]%\1%/p' \ |
| 261 | -e '/^$L=/s/^$L=[ ]*\(.*\)/s%@$L[@]%\1%/p' \ |
| 262 | -e '/^$P=/s/^$P=\(.*\)/s%^$P=.*%$P=\1%/p' \ |
| 263 | -e '/^$E=/s/^$E=\(.*\)/s%^$E=.*%$E=\1%/p' \ |
| 264 | $(MAKEFILE) >sedscript |
Guido van Rossum | 9192267 | 1997-10-09 20:24:13 +0000 | [diff] [blame] | 265 | echo "/^#@SET_CCC@/d" >>sedscript |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 266 | echo "/^installdir=/s%=.*%= $(installdir)%" >>sedscript |
| 267 | echo "/^exec_installdir=/s%=.*%=$(exec_installdir)%" >>sedscript |
| 268 | echo "/^srcdir=/s%=.*%= $(srcdir)%" >>sedscript |
| 269 | echo "/^VPATH=/s%=.*%= $(VPATH)%" >>sedscript |
| 270 | echo "/^LINKPATH=/s%=.*%= $(LINKPATH)%" >>sedscript |
| 271 | echo "/^BASELIB=/s%=.*%= $(BASELIB)%" >>sedscript |
| 272 | echo "/^BASESETUP=/s%=.*%= $(BASESETUP)%" >>sedscript |
| 273 | |
| 274 | # Bootstrap target |
Guido van Rossum | 43e6661 | 1996-10-10 19:12:47 +0000 | [diff] [blame] | 275 | boot: clobber |
Guido van Rossum | bec7484 | 1996-11-27 19:38:53 +0000 | [diff] [blame] | 276 | VERSION=`$(PYTHON) -c "import sys; print sys.version[:3]"`; \ |
| 277 | installdir=`$(PYTHON) -c "import sys; print sys.prefix"`; \ |
| 278 | exec_installdir=`$(PYTHON) -c "import sys; print sys.exec_prefix"`; \ |
Guido van Rossum | 946cf89 | 1996-09-11 12:15:07 +0000 | [diff] [blame] | 279 | $(MAKE) -f $(srcdir)/Makefile.pre.in VPATH=$(VPATH) srcdir=$(srcdir) \ |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 280 | VERSION=$$VERSION \ |
| 281 | installdir=$$installdir \ |
Guido van Rossum | 946cf89 | 1996-09-11 12:15:07 +0000 | [diff] [blame] | 282 | exec_installdir=$$exec_installdir \ |
| 283 | Makefile |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 284 | |
| 285 | # Handy target to remove intermediate files and backups |
| 286 | clean: |
| 287 | -rm -f *.o *~ |
| 288 | |
| 289 | # Handy target to remove everything that is easily regenerated |
| 290 | clobber: clean |
Guido van Rossum | bec7484 | 1996-11-27 19:38:53 +0000 | [diff] [blame] | 291 | -rm -f *.a tags TAGS config.c Makefile.pre $(TARGET) sedscript |
Guido van Rossum | 1631cbe | 1996-09-10 18:19:23 +0000 | [diff] [blame] | 292 | -rm -f *.so *.sl so_locations |
| 293 | |
| 294 | |
| 295 | # Handy target to remove everything you don't want to distribute |
| 296 | distclean: clobber |
| 297 | -rm -f Makefile Setup |