Misc/Makefile.pre.in

   1 # Universal Unix Makefile for Python extensions
   2 # =============================================
   3
   4 # Short Instructions
   5 # ------------------
   6
   7 # 1. Build and install Python (1.5 or newer).
   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
  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.)
  18
  19 # Create a file Setup.in for your extension.  This file follows the
  20 # format of the Modules/Setup.dist 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
  50 #   make -f Makefile.pre.in Makefile VERSION=1.5 installdir=<prefix>
  51 # where <prefix> is the prefix used to install Python for installdir
  52 # (and possibly similar for exec_installdir=<exec_prefix>).
  53
  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
  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
  91 # (Static) build target
  92 TARGET=         python
  93
  94 # Installed python binary (used only by boot target)
  95 PYTHON=         python
  96
  97 # Add more -I and -D options here
  98 CFLAGS=         $(OPT)
  99 CPPFLAGS=       -I$(INCLUDEPY) -I$(EXECINCLUDEPY) $(DEFS)
 100
 101 # These two variables can be set in Setup to merge extensions.
 102 # See example[23].
 103 BASELIB=
 104 BASESETUP=
 105
 106 # === Variables set by makesetup ===
 107
 108 MODOBJS=        _MODOBJS_
 109 MODLIBS=        _MODLIBS_
 110
 111 # === Definitions added by makesetup ===
 112
 113 # === Variables from configure (through sedscript) ===
 114
 115 VERSION=        @VERSION@
 116 CC=             @CC@
 117 LINKCC=         @LINKCC@
 118 SGI_ABI=        @SGI_ABI@
 119 OPT=            @OPT@
 120 LDFLAGS=        @LDFLAGS@
 121 LDLAST=         @LDLAST@
 122 DEFS=           @DEFS@
 123 LIBS=           @LIBS@
 124 LIBM=           @LIBM@
 125 LIBC=           @LIBC@
 126 RANLIB=         @RANLIB@
 127 MACHDEP=        @MACHDEP@
 128 SO=             @SO@
 129 LDSHARED=       @LDSHARED@
 130 CCSHARED=       @CCSHARED@
 131 LINKFORSHARED=  @LINKFORSHARED@
 132 CXX=            @CXX@
 133
 134 # Install prefix for architecture-independent files
 135 prefix=         /usr/local
 136
 137 # Install prefix for architecture-dependent files
 138 exec_prefix=    $(prefix)
 139
 140 # Uncomment the following two lines for AIX
 141 #LINKCC=        $(LIBPL)/makexp_aix $(LIBPL)/python.exp "" $(LIBRARY); $(PURIFY) $(CC)
 142 #LDSHARED=      $(LIBPL)/ld_so_aix $(CC) -bI:$(LIBPL)/python.exp
 143
 144 # === Fixed definitions ===
 145
 146 # Shell used by make (some versions default to the login shell, which is bad)
 147 SHELL=          /bin/sh
 148
 149 # Expanded directories
 150 BINDIR=         $(exec_installdir)/bin
 151 LIBDIR=         $(exec_prefix)/lib
 152 MANDIR=         $(installdir)/man
 153 INCLUDEDIR=     $(installdir)/include
 154 SCRIPTDIR=      $(prefix)/lib
 155
 156 # Detailed destination directories
 157 BINLIBDEST=     $(LIBDIR)/python$(VERSION)
 158 LIBDEST=        $(SCRIPTDIR)/python$(VERSION)
 159 INCLUDEPY=      $(INCLUDEDIR)/python$(VERSION)
 160 EXECINCLUDEPY=  $(exec_installdir)/include/python$(VERSION)
 161 LIBP=           $(exec_installdir)/lib/python$(VERSION)
 162 DESTSHARED=     $(BINLIBDEST)/site-packages
 163
 164 LIBPL=          $(LIBP)/config
 165
 166 PYTHONLIBS=     $(LIBPL)/libpython$(VERSION).a
 167
 168 MAKESETUP=      $(LIBPL)/makesetup
 169 MAKEFILE=       $(LIBPL)/Makefile
 170 CONFIGC=        $(LIBPL)/config.c
 171 CONFIGCIN=      $(LIBPL)/config.c.in
 172 SETUP=          $(LIBPL)/Setup.config $(LIBPL)/Setup.local $(LIBPL)/Setup
 173
 174 SYSLIBS=        $(LIBM) $(LIBC)
 175
 176 ADDOBJS=        $(LIBPL)/python.o config.o
 177
 178 # Portable install script (configure doesn't always guess right)
 179 INSTALL=        $(LIBPL)/install-sh -c
 180 # Shared libraries must be installed with executable mode on some systems;
 181 # rather than figuring out exactly which, we always give them executable mode.
 182 # Also, making them read-only seems to be a good idea...
 183 INSTALL_SHARED= ${INSTALL} -m 555
 184
 185 # === Fixed rules ===
 186
 187 # Default target.  This builds shared libraries only
 188 default:        sharedmods
 189
 190 # Build everything
 191 all:            static sharedmods
 192
 193 # Build shared libraries from our extension modules
 194 sharedmods:     $(SHAREDMODS)
 195
 196 # Build a static Python binary containing our extension modules
 197 static:         $(TARGET)
 198 $(TARGET):      $(ADDOBJS) lib.a $(PYTHONLIBS) Makefile $(BASELIB)
 199                 $(LINKCC) $(LDFLAGS) $(LINKFORSHARED) \
 200                  $(ADDOBJS) lib.a $(PYTHONLIBS) \
 201                  $(LINKPATH) $(BASELIB) $(MODLIBS) $(LIBS) $(SYSLIBS) \
 202                  -o $(TARGET) $(LDLAST)
 203
 204 install:        sharedmods
 205                 if test ! -d $(DESTSHARED) ; then \
 206                         mkdir $(DESTSHARED) ; else true ; fi
 207                 -for i in X $(SHAREDMODS); do \
 208                         if test $$i != X; \
 209                         then $(INSTALL_SHARED) $$i $(DESTSHARED)/$$i; \
 210                         fi; \
 211                 done
 212
 213 # Build the library containing our extension modules
 214 lib.a:          $(MODOBJS)
 215                 -rm -f lib.a
 216                 ar cr lib.a $(MODOBJS)
 217                 -$(RANLIB) lib.a
 218
 219 # This runs makesetup *twice* to use the BASESETUP definition from Setup
 220 config.c Makefile:      Makefile.pre Setup $(BASESETUP) $(MAKESETUP)
 221                 $(MAKESETUP) \
 222                  -m Makefile.pre -c $(CONFIGCIN) Setup -n $(BASESETUP) $(SETUP)
 223                 $(MAKE) -f Makefile do-it-again
 224
 225 # Internal target to run makesetup for the second time
 226 do-it-again:
 227                 $(MAKESETUP) \
 228                  -m Makefile.pre -c $(CONFIGCIN) Setup -n $(BASESETUP) $(SETUP)
 229
 230 # Make config.o from the config.c created by makesetup
 231 config.o:       config.c
 232                 $(CC) $(CFLAGS) $(CPPFLAGS) -c config.c
 233
 234 # Setup is copied from Setup.in *only* if it doesn't yet exist
 235 Setup:
 236                 cp $(srcdir)/Setup.in Setup
 237
 238 # Make the intermediate Makefile.pre from Makefile.pre.in
 239 Makefile.pre: Makefile.pre.in sedscript
 240                 sed -f sedscript $(srcdir)/Makefile.pre.in >Makefile.pre
 241
 242 # Shortcuts to make the sed arguments on one line
 243 P=prefix
 244 E=exec_prefix
 245 H=Generated automatically from Makefile.pre.in by sedscript.
 246 L=LINKFORSHARED
 247
 248 # Make the sed script used to create Makefile.pre from Makefile.pre.in
 249 sedscript:      $(MAKEFILE)
 250         sed -n \
 251          -e '1s/.*/1i\\/p' \
 252          -e '2s%.*%# $H%p' \
 253          -e '/^VERSION=/s/^VERSION=[    ]*\(.*\)/s%@VERSION[@]%\1%/p' \
 254          -e '/^CC=/s/^CC=[      ]*\(.*\)/s%@CC[@]%\1%/p' \
 255          -e '/^CXX=/s/^CXX=[    ]*\(.*\)/s%@CXX[@]%\1%/p' \
 256          -e '/^LINKCC=/s/^LINKCC=[      ]*\(.*\)/s%@LINKCC[@]%\1%/p' \
 257          -e '/^OPT=/s/^OPT=[    ]*\(.*\)/s%@OPT[@]%\1%/p' \
 258          -e '/^LDFLAGS=/s/^LDFLAGS=[    ]*\(.*\)/s%@LDFLAGS[@]%\1%/p' \
 259          -e '/^LDLAST=/s/^LDLAST=[      ]*\(.*\)/s%@LDLAST[@]%\1%/p' \
 260          -e '/^DEFS=/s/^DEFS=[  ]*\(.*\)/s%@DEFS[@]%\1%/p' \
 261          -e '/^LIBS=/s/^LIBS=[  ]*\(.*\)/s%@LIBS[@]%\1%/p' \
 262          -e '/^LIBM=/s/^LIBM=[  ]*\(.*\)/s%@LIBM[@]%\1%/p' \
 263          -e '/^LIBC=/s/^LIBC=[  ]*\(.*\)/s%@LIBC[@]%\1%/p' \
 264          -e '/^RANLIB=/s/^RANLIB=[      ]*\(.*\)/s%@RANLIB[@]%\1%/p' \
 265          -e '/^MACHDEP=/s/^MACHDEP=[    ]*\(.*\)/s%@MACHDEP[@]%\1%/p' \
 266          -e '/^SO=/s/^SO=[      ]*\(.*\)/s%@SO[@]%\1%/p' \
 267          -e '/^LDSHARED=/s/^LDSHARED=[  ]*\(.*\)/s%@LDSHARED[@]%\1%/p' \
 268          -e '/^CCSHARED=/s/^CCSHARED=[  ]*\(.*\)/s%@CCSHARED[@]%\1%/p' \
 269          -e '/^SGI_ABI=/s/^SGI_ABI=[    ]*\(.*\)/s%@SGI_ABI[@]%\1%/p' \
 270          -e '/^$L=/s/^$L=[      ]*\(.*\)/s%@$L[@]%\1%/p' \
 271          -e '/^$P=/s/^$P=\(.*\)/s%^$P=.*%$P=\1%/p' \
 272          -e '/^$E=/s/^$E=\(.*\)/s%^$E=.*%$E=\1%/p' \
 273          $(MAKEFILE) >sedscript
 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
 283 boot:   clobber
 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"`; \
 287         $(MAKE) -f $(srcdir)/Makefile.pre.in VPATH=$(VPATH) srcdir=$(srcdir) \
 288                 VERSION=$$VERSION \
 289                 installdir=$$installdir \
 290                 exec_installdir=$$exec_installdir \
 291                 Makefile
 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
 299                 -rm -f *.a tags TAGS config.c Makefile.pre $(TARGET) sedscript
 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