mk/package.mk

   1 # -----------------------------------------------------------------------------
   2 # $Id: package.mk,v 1.55 2005/05/13 10:05:33 krasimir Exp $
   3
   4 ifneq "$(PACKAGE)" ""
   5
   6 # -----------------------------------------------------------------------------
   7 # Directory layouts, installation etc.
   8
   9 # Here Windows & Unix differ.  On Windows, the value of $(prefix) is known
  10 # to the compiler, and spliced into package.conf in place of $topdir at
  11 # runtime.
  12 #
  13 # On Unix, we only use absolute paths in package.conf.
  14 #
  15
  16 ifeq "$(Windows)" "YES"
  17
  18 PKG_LIBDIR  = $$topdir
  19 PKG_DATADIR = $$topdir
  20
  21 else
  22
  23 PKG_LIBDIR  = $(libdir)
  24 PKG_DATADIR = $(datadir)
  25
  26 endif # Unix
  27
  28 IMPORT_DIR_INSTALLED = $(PKG_LIBDIR)/imports
  29 IMPORT_DIR_INPLACE   = $(FPTOOLS_TOP_ABS)/libraries/$(PACKAGE)
  30
  31 INCLUDE_DIR_INSTALLED = $(PKG_LIBDIR)/include
  32 INCLUDE_DIR_INPLACE   = $(FPTOOLS_TOP_ABS)/libraries/$(PACKAGE)/include
  33
  34 LIB_DIR_INSTALLED    = $(PKG_LIBDIR)
  35 LIB_DIR_INPLACE      = $(FPTOOLS_TOP_ABS)/libraries/$(PACKAGE)
  36
  37 DATA_DIR_INSTALLED   = $(PKG_DATADIR)
  38 DATA_DIR_INPLACE     = $(FPTOOLS_TOP_ABS)/libraries/$(PACKAGE)
  39
  40 HTML_DIR_INPLACE     = $(FPTOOLS_TOP_ABS)/libraries/$(PACKAGE)/html
  41 HTML_DIR_INSTALLED   = $(PKG_DATADIR)/html/libraries/$(PACKAGE)
  42
  43 HADDOCK_IFACE_INPLACE   = $(HTML_DIR_INPLACE)/$(PACKAGE).haddock
  44 HADDOCK_IFACE_INSTALLED = $(HTML_DIR_INSTALLED)/$(PACKAGE).haddock
  45
  46 # -----------------------------------------------------------------------------
  47 # Build the package configuration file and tell the compiler about it.
  48
  49 # We want to build two versions of the package configuration: one for use
  50 # in the
  51
  52 ifeq "$(way)" ""
  53
  54 PACKAGE_CPP_OPTS += -I$(GHC_INCLUDE_DIR) -Iinclude
  55
  56 PACKAGE_CPP_OPTS += -DPACKAGE=${PACKAGE}
  57 PACKAGE_CPP_OPTS += -DVERSION=${VERSION}
  58
  59 PACKAGE_CPP_OPTS += -DPKG_LIBDIR='"$(PKG_LIBDIR)"'
  60 PACKAGE_CPP_OPTS += -DPKG_DATADIR='"$(PKG_DATADIR)"'
  61
  62 package.conf.inplace   : package.conf.in
  63         $(CPP) $(RAWCPP_FLAGS) -P \
  64                 -DIMPORT_DIR='"$(IMPORT_DIR_INPLACE)"' \
  65                 -DLIB_DIR='"$(LIB_DIR_INPLACE)"' \
  66                 -DINCLUDE_DIR='"$(INCLUDE_DIR_INPLACE)"' \
  67                 -DDATA_DIR='"$(DATA_DIR_INPLACE)"' \
  68                 -DHTML_DIR='"$(HTML_DIR_INPLACE)"' \
  69                 -DHADDOCK_IFACE='"$(HADDOCK_IFACE_INPLACE)"' \
  70                 -DFPTOOLS_TOP_ABS='"${FPTOOLS_TOP_ABS}"' \
  71                 -x c $(PACKAGE_CPP_OPTS) $< | \
  72         grep -v '^#pragma GCC' | \
  73         sed -e 's/""//g' -e 's/:[       ]*,/: /g' >$@
  74
  75 install::
  76         $(CPP) $(RAWCPP_FLAGS) -P -DINSTALLING \
  77                -DIMPORT_DIR='"$(IMPORT_DIR_INSTALLED)"' \
  78                -DLIB_DIR='"$(LIB_DIR_INSTALLED)"' \
  79                -DINCLUDE_DIR='"$(INCLUDE_DIR_INSTALLED)"' \
  80                -DDATA_DIR='"$(DATA_DIR_INSTALLED)"' \
  81                -DHTML_DIR='"$(HTML_DIR_INSTALLED)"' \
  82                -DHADDOCK_IFACE='"$(HADDOCK_IFACE_INSTALLED)"' \
  83                -I../includes \
  84                -x c $(PACKAGE_CPP_OPTS) package.conf.in \
  85             | grep -v '^#pragma GCC' \
  86             | sed -e 's/""//g' -e 's/:[   ]*,/: /g' \
  87             | $(GHC_PKG_PROG) --global-conf $(DESTDIR)$(libdir)/package.conf update - --force
  88
  89 # we could be more accurate here and add a dependency on
  90 # driver/package.conf, but that doesn't work too well because of
  91 # make's limited accuracy with modification times: when doing 'make
  92 # boot' in multiple packages, make won't detect that the package
  93 # configuration needs updating if it was updated already in the last
  94 # second.
  95 #
  96 # The stamp file goes in $(GHC_DRIVER_DIR), so that if someone happens
  97 # to 'make clean' in ghc without cleaning in libraries too, the packages
  98 # will be correctly re-installed.
  99 #
 100
 101 STAMP_PKG_CONF = $(GHC_DRIVER_DIR)/stamp-pkg-conf-$(PACKAGE)
 102 CLEAN_FILES += $(STAMP_PKG_CONF)
 103
 104 ifneq "$(BootingFromHc)" "YES"
 105 boot all :: $(STAMP_PKG_CONF)
 106 endif
 107
 108 $(STAMP_PKG_CONF) : package.conf.inplace
 109         $(GHC_PKG_INPLACE) update - --force-files <package.conf.inplace
 110         @touch $(STAMP_PKG_CONF)
 111
 112 CLEAN_FILES += package.conf.inplace
 113
 114 endif # $(way) == ""
 115
 116 # -----------------------------------------------------------------------------
 117 # Building the static library libHS<pkg>.a
 118
 119 SRC_HSC2HS_OPTS += -I.
 120
 121 ifneq "$(NO_SET_HC)" "YES"
 122 HC = $(GHC_INPLACE)
 123 endif
 124 IGNORE_PACKAGE_FLAG = -package-name  $(PACKAGE)-$(VERSION)
 125
 126 ifeq "$(NON_HS_PACKAGE)" ""
 127 SRC_HC_OPTS     += $(IGNORE_PACKAGE_FLAG)
 128 SRC_HC_OPTS     += $(GhcLibHcOpts)
 129 SRC_HC_OPTS     += $(patsubst %, -package %, $(PACKAGE_DEPS))
 130 endif
 131
 132 #       -fgenerics switches on generation of support code for
 133 #               derivable type classes.  This is now off by default,
 134 #               but we switch it on for the libraries so that we generate
 135 #               the code in case someone importing wants it.
 136 ifeq "$(NON_HS_PACKAGE)" ""
 137 SRC_HC_OPTS     += -fgenerics
 138 endif
 139
 140 ifndef LIBRARY
 141 ifeq "$(_way:%_dyn=YES)" "YES"
 142 LIBRARY         = libHS$(PACKAGE)$(_way:%_dyn=%)-ghc$(ProjectVersion)$(soext)
 143 else
 144 LIBRARY         = libHS$(PACKAGE)$(_way).a
 145 endif
 146 endif
 147
 148 ifeq "$(WAYS)" ""
 149 WAYS = $(GhcLibWays)
 150 endif
 151
 152 all :: $(LIBRARY)
 153
 154 # POSSIBLE alternative version using --make:
 155 #
 156 # lib : $(HS_SRCS)
 157 #       $(GHC_INPLACE) $(HC_OPTS) --make $(HS_SRCS)
 158 #
 159 # $(LIBNAME) : lib
 160 #       $(RM) $@
 161 #       $(AR) $(AR_OPTS) $@ $(HS_OBJS)
 162 #       $(RANLIB) $@
 163 #
 164 # %.o : %.hs
 165 #       $(GHC_INPLACE) $(HC_OPTS) --make $<
 166 # %.o : %.lhs
 167 #       $(GHC_INPLACE) $(HC_OPTS) --make $<
 168
 169 # -----------------------------------------------------------------------------
 170 # Installation; need to install .hi files as well as libraries
 171
 172 ifeq "$(DLLized)" "YES"
 173 INSTALL_PROGS += $(DLL_NAME)
 174 INSTALL_LIBS += $(patsubst %.a,%_imp.a, $(LIBRARY))
 175 endif
 176
 177 # The interface files are put inside the $(libdir), since they
 178 # might (potentially) be platform specific..
 179
 180 ifeq "$(HIERARCHICAL_LIB)" "YES"
 181 ifacedir = $(libdir)/imports
 182 else
 183 ifacedir = $(libdir)/hslibs-imports/$(PACKAGE)
 184 endif
 185
 186 # If the lib consists of a hierachy of modules, we must retain the directory
 187 # structure when we install the interfaces.
 188 ifeq "$(HIERARCHICAL_LIB)" "YES"
 189 INSTALL_IFACES_WITH_DIRS += $(HS_IFACES)
 190 ifneq "$(ALL_DIRS)" ""
 191 install ::
 192         @for i in $(ALL_DIRS); do \
 193                 $(INSTALL_DIR) $(ifacedir)/$$i; \
 194         done
 195 endif
 196 else
 197 INSTALL_IFACES += $(HS_IFACES)
 198 endif
 199
 200 # -----------------------------------------------------------------------------
 201 # Dependencies
 202
 203 MKDEPENDHS = $(GHC_INPLACE)
 204
 205 SRC_MKDEPENDC_OPTS += $(addprefix -I,$(ALL_DIRS))
 206 SRC_MKDEPENDC_OPTS += -I$(GHC_INCLUDE_DIR)
 207
 208 endif # $(PACKAGE) != ""
 209
 210 #--------------------------------------------------------------
 211 # Installation
 212
 213 ifneq "$(NO_INSTALL_LIBRARY)" "YES"
 214 INSTALL_LIBS  += $(LIBRARY) $(GHCI_LIBRARY)
 215 endif
 216
 217 #--------------------------------------------------------------
 218 # Building dynamically-linkable libraries for GHCi
 219 #
 220 # Build $(GHCI_LIBRARY) whenever we build $(LIBRARY)
 221 #
 222 # Why?  GHCi can only link .o files (at the moment), not .a files
 223 # so we have to build libFoo.o as well as libFoo.a
 224 #
 225 # Furthermore, GHCi currently never loads
 226 # profiling libraries (or other non-std ways)
 227
 228 ifneq "$(LIBRARY)" ""
 229
 230 ifeq "$(way)" ""
 231 ifeq "$(GhcWithInterpreter)" "YES"
 232
 233 ifndef GHCI_LIBRARY
 234 GHCI_LIBRARY = $(patsubst lib%.a,%.o,$(LIBRARY))
 235 endif
 236
 237 CLEAN_FILES  += $(GHCI_LIBRARY)
 238
 239 all :: $(GHCI_LIBRARY)
 240
 241 ifneq "$(DONT_WANT_STD_GHCI_LIB_RULE)" "YES"
 242 # If you don't want to build GHCI_LIBRARY the 'standard' way,
 243 # set DONT_WANT_STD_GHCI_LIB_RULE to YES. The Prelude and
 244 # hslibs/Win32 uses this 'feature', which will go away soon
 245 # when we can use a "fixed" ld.
 246 #
 247 $(GHCI_LIBRARY) : $(LIBOBJS)
 248         $(LD) -r $(LD_X) -o $@ $(STUBOBJS) $(LIBOBJS)
 249
 250 endif # DONT_WANT_STD_GHCI_LIB_RULE
 251 endif # GhcWithInterpreter
 252 endif # way
 253 endif # $(LIBRARY) /= ""
 254
 255 # -----------------------------------------------------------------------------
 256 # Doc building with Haddock
 257
 258 ifneq "$(PACKAGE)" ""
 259 ifeq "$(HADDOCK_DOCS)" "YES"
 260
 261 HS_PPS = $(addsuffix .raw-hs, $(basename $(filter-out $(EXCLUDED_HADDOCK_SRCS), $(HS_SRCS)))) $(EXTRA_HADDOCK_SRCS)
 262
 263 HTML_DIR = ../html-docs/$(PACKAGE)
 264 HTML_DOC = $(HTML_DIR)/haddock.css $(HTML_DIR)/haddock.js
 265
 266 ifneq "$(HS_PPS)" ""
 267
 268 CLEAN_FILES += $(HS_PPS) $(addsuffix .tmp, $(HS_SRCS))
 269
 270 ifeq "$(HADDOCK)" ""
 271 html ::
 272         @echo Haddock must be installed in order to build HTML library documentation.
 273         @echo Please install Haddock and re-configure.
 274         @exit 1
 275 endif
 276
 277 html :: $(HTML_DOC)
 278
 279 extraclean ::
 280         $(RM) -rf $(HTML_DIR)
 281
 282 $(HTML_DOC) : $(HS_PPS)
 283         @$(INSTALL_DIR) $(HTML_DIR)
 284         $(HADDOCK) $(HADDOCK_OPTS) -h -o $(HTML_DIR) $(HS_PPS) \
 285                 --package=$(PACKAGE) \
 286                 --dump-interface=$(PACKAGE).haddock \
 287                 --use-index=../doc-index.html --use-contents=../index.html \
 288                 --source-module=$(PackageSourceURL) \
 289                 $(foreach pkg, $(PACKAGE_DEPS), \
 290                    --read-interface=../$(pkg),../$(pkg)/$(pkg).haddock)
 291
 292 CLEAN_FILES += $(PACKAGE).haddock
 293
 294 %.raw-hs : %.lhs
 295         $(HC) $(HC_OPTS) -D__HADDOCK__ -E $< -o $@
 296
 297 %.raw-hs : %.hs
 298         $(HC) $(HC_OPTS) -D__HADDOCK__ -E $< -o $@
 299
 300 HTML_INSTALL_DIR = $(DESTDIR)$(htmldir)/libraries/html/$(PACKAGE)
 301
 302 install-docs :: $(HTML_DOC)
 303         @$(INSTALL_DIR) $(HTML_INSTALL_DIR)
 304         for i in $(HTML_DIR)/*; do \
 305           echo $(INSTALL_DATA) $(INSTALL_OPTS) $$i $(HTML_INSTALL_DIR); \
 306           $(INSTALL_DATA) $(INSTALL_OPTS) $$i $(HTML_INSTALL_DIR); \
 307         done; \
 308         $(INSTALL_DATA) $(INSTALL_OPTS) $(PACKAGE).haddock $(HTML_INSTALL_DIR); \
 309
 310 endif # HS_PPS
 311 endif # HADDOCK_DOCS
 312 endif # $(PACKAGE) /= ""
 313
 314 # -----------------------------------------------------------------------------
 315