build-package.mk 4.67 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12
# -----------------------------------------------------------------------------
#
# (c) 2009 The University of Glasgow
#
# This file is part of the GHC build system.
#
# To understand how the build system works and how to modify it, see
#      http://hackage.haskell.org/trac/ghc/wiki/Building/Architecture
#      http://hackage.haskell.org/trac/ghc/wiki/Building/Modifying
#
# -----------------------------------------------------------------------------

Ian Lynagh's avatar
Ian Lynagh committed
13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39

# Build a package with the stage-1 compiler, multiple ways.  A typical
# libraries/foo/ghc.mk will look like this:
#
# $(eval $(call build-package,libraries/base,dist-install))
#
# The package metadata is generated from the .cabal file and placed in
# package-data.mk.  It will look something like this:
#
# libraries/base_dist_MODULES = GHC.Base Data.Tuple ...
# libraries/base_dist_PACKAGE = base
# libraries/base_dist_VERSION = 4.0.0.0
# libraries/base_dist_HC_OPTS = -package ghc-prim-0.1.0.0 -XRank2Types ...
# libraries/base_dist_C_SRCS  = cbits/PrelIOUtils.c ...
# libraries/base_dist_S_SRCS  = cbits/foo.S ...
# libraries/base_dist_CC_OPTS = -Iinclude ...
# libraries/base_dist_LD_OPTS = -package ghc-prim-0.1.0.0

define build-package
# $1 = dir
# $2 = distdir
# $3 = GHC stage to use (0 == bootstrapping compiler)

ifeq "$$(findstring $3,0 1 2)" ""
$$(error $1/$2: stage argument to build-package should be 0, 1, or 2)
endif

40 41 42 43 44 45 46 47 48
$(call clean-target,$1,$2,$1/$2)

distclean : clean_$1_$2_config

maintainer-clean : distclean

.PHONY: clean_$1_$2_config
clean_$1_$2_config:
	"$$(RM)" $$(RM_OPTS) $1/config.log $1/config.status $1/include/Hs*Config.h
49
	"$$(RM)" $$(RM_OPTS_REC) $1/autom4te.cache
50 51 52 53 54 55 56 57 58 59 60 61

ifneq "$$($1_$2_NOT_NEEDED)" "YES"
$$(eval $$(call build-package-helper,$1,$2,$3))
endif
endef


define build-package-helper
# $1 = dir
# $2 = distdir
# $3 = GHC stage to use (0 == bootstrapping compiler)

Ian Lynagh's avatar
Ian Lynagh committed
62 63
# We don't install things compiled by stage 0, so no need to put them
# in the bindist.
64
ifneq "$$(BINDIST) $3" "YES 0"
Ian Lynagh's avatar
Ian Lynagh committed
65 66

$(call all-target,$1,all_$1_$2)
Ian Lynagh's avatar
Ian Lynagh committed
67 68 69 70 71
# This give us things like
#     all_libraries: all_libraries/base_dist-install
ifneq "$$($1_$2_GROUP)" ""
all_$$($1_$2_GROUP): all_$1_$2
endif
Ian Lynagh's avatar
Ian Lynagh committed
72

73 74 75 76 77 78 79 80
ifneq "$$(CHECKED_$1)" "YES"
CHECKED_$1 = YES
check_packages: check_$1
.PHONY: check_$1
check_$1: $$(GHC_CABAL_INPLACE)
	$$(GHC_CABAL_INPLACE) check $1
endif

Ian Lynagh's avatar
Ian Lynagh committed
81 82 83 84 85 86
# --- CONFIGURATION

ifneq "$$(NO_INCLUDE_PKGDATA)" "YES"
include $1/$2/package-data.mk
endif

87 88
$(call package-config,$1,$2,$3)

Ian Lynagh's avatar
Ian Lynagh committed
89 90 91 92 93 94 95 96 97 98 99
ifeq "$$($1_$2_DISABLE)" "YES"

ifeq "$$(DEBUG)" "YES"
$$(warning $1/$2 disabled)
endif

# A package is disabled when we want to bring its package-data.mk file
# up-to-date first, or due to other build dependencies.

$(call all-target,$1_$2,$1/$2/package-data.mk)

100
ifneq "$$(BINDIST)" "YES"
Ian Lynagh's avatar
Ian Lynagh committed
101 102
# We have a rule for package-data.mk only when the package is
# disabled, because we want the build to fail if we haven't run phase 0.
103
$(call build-package-data,$1,$2,$3)
Ian Lynagh's avatar
Ian Lynagh committed
104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133
endif

else

ifneq "$$(NO_INCLUDE_PKGDATA)" "YES"
ifeq "$$($1_$2_VERSION)" ""
$$(error phase ordering error: $1/$2 is enabled, but $1/$2/package-data.mk does not exist)
endif
endif

# Sometimes we need to modify the automatically-generated package-data.mk
# bindings in a special way for the GHC build system, so allow that here:
$($1_PACKAGE_MAGIC)

# Bootstrapping libs are only built one way
ifeq "$3" "0"
$1_$2_WAYS = v
else
$1_$2_WAYS = $$(GhcLibWays)
endif

$(call hs-sources,$1,$2)
$(call c-sources,$1,$2)
$(call includes-sources,$1,$2)

# --- DEPENDENCIES

# We must use a different dependency file if $(GhcLibWays) changes, so
# encode the ways into the name of the file.
$1_$2_WAYS_DASHED = $$(subst $$(space),,$$(patsubst %,-%,$$(strip $$($1_$2_WAYS))))
Ian Lynagh's avatar
Ian Lynagh committed
134
$1_$2_depfile_base = $1/$2/build/.depend$$($1_$2_WAYS_DASHED)
Ian Lynagh's avatar
Ian Lynagh committed
135

136
$(call build-dependencies,$1,$2,$3)
Ian Lynagh's avatar
Ian Lynagh committed
137 138 139 140 141 142 143 144 145 146 147 148

# --- BUILDING

# We don't bother splitting the bootstrap packages (built with stage 0)
ifeq "$$($1_$2_SplitObjs)" ""
ifeq "$$(SplitObjs) $3" "YES 1"
$1_$2_SplitObjs = YES
else
$1_$2_SplitObjs = NO
endif
endif

149
# C and S files are possibly built the "dyn" way.
150
ifeq "$$(BuildSharedLibs)" "YES"
151 152 153
$(call c-objs,$1,$2,dyn)
$(call c-suffix-rules,$1,$2,dyn,YES)
endif
Ian Lynagh's avatar
Ian Lynagh committed
154 155

# Now generate all the build rules for each way in this directory:
156 157 158 159 160 161 162
$$(foreach way,$$($1_$2_WAYS),$$(eval \
    $$(call c-objs,$1,$2,$$(way)) \
	$$(call c-suffix-rules,$1,$2,$$(way),YES) \
    $$(call cmm-objs,$1,$2,$$(way)) \
    $$(call cmm-suffix-rules,$1,$2,$$(way)) \
    $$(call build-package-way,$1,$2,$$(way),$3) \
  ))
Ian Lynagh's avatar
Ian Lynagh committed
163

164
ifneq "$$($1_$2_HADDOCK_ME)" "NO"
Ian Lynagh's avatar
Ian Lynagh committed
165
$(call haddock,$1,$2)
166
endif
Ian Lynagh's avatar
Ian Lynagh committed
167 168 169 170

endif # package-data.mk exists

# Don't put bootstrapping packages in the bindist
Ian Lynagh's avatar
Ian Lynagh committed
171
ifneq "$3" "0"
172
BINDIST_EXTRAS += $1/*.cabal $$(wildcard $1/*.buildinfo) $1/$2/setup-config $1/LICENSE
Ian Lynagh's avatar
Ian Lynagh committed
173 174 175 176 177 178 179
BINDIST_EXTRAS += $$($1_$2_INSTALL_INCLUDES_SRCS)
endif

endif

endef