concurrent, unique, timeout have now been split off from base
[ghc.git] / libraries / Makefile
1
2 # To do a fresh build:
3 #
4 # make clean
5 # make boot
6 # make
7 #
8 # To rebuild a particular library <package>:
9 #
10 # make clean.library.<package>
11 # make make.library.<package>
12 #
13 # or the following is equivalent:
14 #
15 # make remake.library.<package>
16 #
17 # To add a new library to the tree, do
18 #
19 # darcs get http://darcs.haskell.org/packages/foo
20 # [ -e foo/configure.ac ] && ( cd foo && autoreconf )
21 # make make.library.foo
22
23 .PHONY: default_target show
24
25 default_target: all
26
27 show:
28 @echo '$(VALUE)="$($(VALUE))"'
29
30 # make doesn't give us an easy way to get the libraries built in
31 # dependency order the first time, but not rebuild base (for example)
32 # when we want to rebuild another library later.
33 # So for now we just don't do anything in parallel in here.
34 .NOTPARALLEL:
35
36 # Ideally we'd just include something to give us variables
37 # for paths and arguments to tools etc, and those set in mk/build.mk.
38 TOP=..
39 include $(TOP)/mk/boilerplate.mk
40 include $(TOP)/mk/cabal-flags.mk
41
42 # Any libraries listed here should also be in ../packages
43
44 SUBDIRS = ghc-prim $(INTEGER_LIBRARY) base concurrent unique timeout st getopt base3-compat array packedstring
45 SUBDIRS += containers bytestring old-locale old-time filepath
46 ifeq "$(GhcLibsWithUnix)" "YES"
47 SUBDIRS += unix
48 endif
49 ifeq "$(Windows)" "YES"
50 SUBDIRS += $(wildcard Win32)
51 endif
52 SUBDIRS += directory process pretty hpc template-haskell editline Cabal random haskell98
53
54 # Set GhcBootLibs=YES from the command line to work with just the libraries
55 # needed to bootstrap GHC.
56 ifneq "$(GhcBootLibs)" "YES"
57 SUBDIRS += $(wildcard regex-base)
58 SUBDIRS += $(wildcard regex-posix)
59 SUBDIRS += $(wildcard regex-compat)
60 SUBDIRS += $(wildcard parsec)
61 SUBDIRS += $(wildcard haskell-src)
62 SUBDIRS += $(wildcard html)
63 SUBDIRS += $(wildcard network)
64 SUBDIRS += $(wildcard QuickCheck)
65 SUBDIRS += $(wildcard HUnit)
66 SUBDIRS += $(wildcard mtl)
67 SUBDIRS += $(wildcard time)
68 SUBDIRS += $(wildcard stm)
69 SUBDIRS += $(wildcard xhtml)
70 SUBDIRS += $(wildcard parallel)
71 ifneq "$(wildcard dph)" ""
72 SUBDIRS += dph/dph-base
73 SUBDIRS += dph/dph-prim-interface
74 SUBDIRS += dph/dph-prim-seq
75 SUBDIRS += dph/dph-prim-par
76 SUBDIRS += dph/dph-seq
77 SUBDIRS += dph/dph-par
78 endif
79 endif
80
81 # -----------------------------------------------------------------------------
82
83 empty=
84 space=$(empty) $(empty)
85
86 # -----------------------------------------------------------------------------
87
88 ifeq "$(ghc_ge_609)" "YES"
89 GhcLibHcOpts += -fno-warn-deprecated-flags
90 endif
91
92 ifeq "$(RelocatableBuild)" "YES"
93 # On Windows we want to make moveable bindists, but we need to tell
94 # ghc-pkg where the haddock docs are. Therefore we completely ignore
95 # where the user tells us to put the haddock documentation and put it
96 # somewhere whose relative location we know. When installing we need
97 # to give Cabal a real path, though.
98 iprefix = $$topdir
99 ibindir = $$topdir
100 ilibdir = $$topdir
101 ilibexecdir = $$topdir
102 idynlibdir = $$topdir
103 idatadir = $$topdir
104 idocdir = $$topdir/doc/libraries/$$pkg
105 ihaddockdir = $$topdir/doc/libraries/$$pkg
106 ihtmldir = $$httptopdir/doc/libraries/$$pkg
107 html_installed_root = $(prefix)/doc/libraries
108 else
109 # On non-Windows we can just give absolute paths all the time, and
110 # thus obey the htmldir that we are given.
111 iprefix = $(prefix)
112 ibindir = $(bindir)
113 ilibdir = $(libdir)
114 ilibexecdir = $(libexecdir)
115 idynlibdir = $(dynlibdir)
116 idatadir = $(datadir)
117 idocdir = $(docdir)/libraries/$$pkg
118 ihaddockdir = $(htmldir)/libraries/$$pkg
119 ihtmldir = $(htmldir)/libraries/$$pkg
120 html_installed_root = $(htmldir)/libraries
121 endif
122
123 IFBUILDABLE=ifBuildable/ifBuildable $(FPTOOLS_TOP_ABS)/packages
124
125 ifneq "$(DOING_BIN_DIST)" "YES"
126
127 CONFIGURE_OPTS =
128 CONFIGURE_STAMP_EXTRAS :=
129
130 ifneq "$(findstring $(space)p$(space), $(space)$(GhcLibWays)$(space))" ""
131 CONFIGURE_OPTS += --enable-library-profiling
132 CONFIGURE_STAMP_EXTRAS := $(CONFIGURE_STAMP_EXTRAS)-profiling
133 endif
134
135 ifeq "$(BuildSharedLibs)" "YES"
136 CONFIGURE_OPTS += --enable-shared
137 CONFIGURE_STAMP_EXTRAS := $(CONFIGURE_STAMP_EXTRAS)-shared
138 endif
139
140 ifeq "$(SplitObjs)" "YES"
141 CONFIGURE_OPTS += --enable-split-objs
142 CONFIGURE_STAMP_EXTRAS := $(CONFIGURE_STAMP_EXTRAS)-splitting
143 endif
144
145 .PHONY: subdirs
146
147 subdirs:
148 @echo $(SUBDIRS)
149
150 HERE_ABS=$(FPTOOLS_TOP_ABS)/libraries
151
152 CABAL_GHC_FLAGS = -Wall
153 ifeq "$(ghc_ge_605)" "NO"
154 CABAL_GHC_FLAGS += -cpp
155 endif
156
157 # Euch, hideous hack:
158 CABAL_VERSION = $(shell grep "^Version:" Cabal/Cabal.cabal | sed -e "s/^Version: //" -e 's/\./,/g')
159
160 BOOTSTRAPPING_FLAGS = $(CABAL_GHC_FLAGS) -DCABAL_VERSION=$(CABAL_VERSION) -odir $(HERE_ABS)/bootstrapping -hidir $(HERE_ABS)/bootstrapping -i$(HERE_ABS)/Cabal -i$(HERE_ABS)/filepath -i$(HERE_ABS)/hpc
161
162 .PHONY: boot
163
164 boot: ifBuildable/ifBuildable cabal-bin bootstrapping.conf
165
166 cabal-bin: cabal-bin.hs
167 mkdir bootstrapping
168 $(GHC) $(BOOTSTRAPPING_FLAGS) --make cabal-bin -o cabal-bin
169
170 bootstrapping.conf: cabal-bin
171 echo "[]" > $@.tmp
172 -cd filepath && $(CABAL) clean --distpref=dist-bootstrapping
173 cd filepath && $(CABAL) configure --distpref=dist-bootstrapping --with-compiler=$(GHC) --with-hc-pkg=$(GHC_PKG) --package-db=$(HERE_ABS)/$@.tmp
174 cd filepath && $(CABAL) build --distpref=dist-bootstrapping
175 cd filepath && $(CABAL) install --distpref=dist-bootstrapping --inplace
176 -cd Cabal && $(CABAL) clean --distpref=dist-bootstrapping
177 cd Cabal && $(CABAL) configure --distpref=dist-bootstrapping --with-compiler=$(GHC) --with-hc-pkg=$(GHC_PKG) --package-db=$(HERE_ABS)/$@.tmp
178 cd Cabal && $(CABAL) build --distpref=dist-bootstrapping
179 cd Cabal && $(CABAL) install --distpref=dist-bootstrapping --inplace
180 -cd hpc && $(CABAL) clean --distpref=dist-bootstrapping
181 cd hpc && $(CABAL) configure --distpref=dist-bootstrapping --with-compiler=$(GHC) --with-hc-pkg=$(GHC_PKG) --package-db=$(HERE_ABS)/$@.tmp
182 cd hpc && $(CABAL) build --distpref=dist-bootstrapping
183 cd hpc && $(CABAL) install --distpref=dist-bootstrapping --inplace
184 mv $@.tmp $@
185
186 ifBuildable/ifBuildable: ifBuildable.hs
187 -$(RM) -rf ifBuildable
188 mkdir ifBuildable
189 $(CP) ifBuildable.hs ifBuildable/
190 ifeq "$(stage)" "2"
191 cd ifBuildable && ../$(HC) -Wall --make ifBuildable -o ifBuildable
192 else
193 cd ifBuildable && $(GHC) -Wall --make ifBuildable -o ifBuildable
194 endif
195
196 .PHONY: all build configure
197
198 all: build
199
200 ifeq "$(HADDOCK_DOCS)" "YES"
201 all: doc
202 endif
203
204 .PHONY: rebuild.library.%
205 .PHONY: remake.library.%
206
207 $(foreach SUBDIR,$(SUBDIRS),rebuild.library.$(SUBDIR)):\
208 rebuild.library.%: clean.library.% build.library.%
209
210 $(foreach SUBDIR,$(SUBDIRS),remake.library.$(SUBDIR)):\
211 remake.library.%: clean.library.% make.library.%
212
213 # NB. we're depending on make chasing dependencies from left to right here.
214 # This bit goes wrong with 'make -j'.
215 build: $(foreach SUBDIR,$(SUBDIRS),make.library.$(SUBDIR))
216
217 configure: $(foreach SUBDIR,$(SUBDIRS), \
218 stamp/configure.library.build$(CONFIGURE_STAMP_EXTRAS).$(SUBDIR))
219
220 .PHONY: build.library.%
221 .PHONY: make.library.%
222
223 # We should depend on %/%.cabal here (and in other rules), but make
224 # makes that difficult.
225
226 ALL_CONFIGURE_FLAGS = \
227 $(INSTALL_DIRS_CONFIGURE_FLAGS) \
228 $(USE_STAGE1_CONFIGURE_FLAGS) \
229 $(COMMON_CONFIGURE_FLAGS) \
230 --haddock-options="--use-contents=../index.html \
231 --use-index=../doc-index.html" \
232 $(CONFIGURE_OPTS)
233
234 stamp/configure.library.build$(CONFIGURE_STAMP_EXTRAS).dph/dph-par: \
235 dph/dph-par
236
237 stamp/configure.library.build$(CONFIGURE_STAMP_EXTRAS).dph/dph-seq: \
238 dph/dph-seq
239
240 dph/%:
241 $(MAKE) -C dph $*
242
243 $(foreach SUBDIR,$(SUBDIRS), \
244 stamp/configure.library.build$(CONFIGURE_STAMP_EXTRAS).$(SUBDIR)): \
245 stamp/configure.library.build$(CONFIGURE_STAMP_EXTRAS).%: cabal-bin \
246 bootstrapping.conf
247 -$(RM) -f stamp/configure.library.*.$* $*/unbuildable
248 $(MKDIRHIER) `dirname $@`
249 ( cd $* && $(CABAL) configure $(ALL_CONFIGURE_FLAGS) ) \
250 && touch $@ || touch $*/unbuildable
251 # We don't touch $@ if configure failed as we would prefer to try
252 # configuring it next time round, rather than assuming it'll still fail.
253 # This is particularly important for bootlibs, where failure means the
254 # build dies!
255
256 # Build the library using 'make'
257 # We re-run 'setup makefile' each time, just in case any preprocessing
258 # needs to be done. However, we're careful not to overwrite GNUmakefile
259 # if it hasn't changed, so that dependency-generation isn't forced
260 # every time.
261 $(foreach SUBDIR,$(SUBDIRS),make.library.$(SUBDIR)):\
262 make.library.%: stamp/configure.library.build$(CONFIGURE_STAMP_EXTRAS).% \
263 cabal-bin ifBuildable/ifBuildable bootstrapping.conf
264 if $(IFBUILDABLE) $*; then \
265 cd $* && \
266 cmp -s $(MAKEFILE_LOCAL) Makefile.local || cp $(MAKEFILE_LOCAL) .; \
267 mv GNUmakefile GNUmakefile.tmp; \
268 $(CABAL) makefile -f GNUmakefile; \
269 cmp -s GNUmakefile GNUmakefile.tmp && mv GNUmakefile.tmp GNUmakefile; \
270 $(MAKE) $(MFLAGS) && \
271 $(CABAL) register --inplace; \
272 fi
273
274 MAKEFILE_LOCAL = $(FPTOOLS_TOP_ABS)/libraries/Makefile.local
275
276 # Build the library using 'setup build' (not the default)
277 $(foreach SUBDIR,$(SUBDIRS),build.library.$(SUBDIR)):\
278 build.library.%: stamp/configure.library.build$(CONFIGURE_STAMP_EXTRAS).% \
279 cabal-bin ifBuildable/ifBuildable bootstrapping.conf
280 if $(IFBUILDABLE) $*; then \
281 cd $* && \
282 $(CABAL) build $(BUILD_FLAGS); \
283 $(CABAL) register --inplace; \
284 fi
285
286 .PHONY: doc html
287
288 html: doc
289
290 # No docs for compat libraries for now.
291 DOC_SUBDIRS = $(filter-out %-compat, $(SUBDIRS))
292
293 doc: $(foreach SUBDIR,$(DOC_SUBDIRS),doc.library.$(SUBDIR))
294 sh gen_contents_index --inplace
295
296 # Making hyperlinked source only works if we have hscolour
297 ifneq "$(HSCOLOUR)" ""
298 CABAL_HADDOCK_FLAGS=--hyperlink-source
299 endif
300
301 $(foreach SUBDIR,$(DOC_SUBDIRS),doc.library.$(SUBDIR)):\
302 doc.library.%: stamp/configure.library.build$(CONFIGURE_STAMP_EXTRAS).% \
303 cabal-bin ifBuildable/ifBuildable bootstrapping.conf
304 if $(IFBUILDABLE) $*; then \
305 cd $* && $(CABAL) haddock --html-location='../$$pkg' \
306 $(CABAL_HADDOCK_FLAGS); \
307 fi
308 ifneq "$(HSCOLOUR)" ""
309 # We use */src rather than $*/src due to the $(INTEGER_LIBRARY)/integer
310 # mismatch
311 # XXX We also need to check that the directory exists, as e.g. dph disables
312 # haddock, so the directory doesn't get made. We should remove this once
313 # we can always haddock everything.
314 if $(IFBUILDABLE) $* && [ -d $*/dist/doc/html/*/src/ ]; then cp hscolour.css $*/dist/doc/html/*/src/; fi
315 endif
316
317 .PHONY: distclean clean clean.library.%
318
319 distclean: clean
320
321 clean: $(foreach SUBDIR,$(SUBDIRS),clean.library.$(SUBDIR))
322 -cd filepath && $(CABAL) clean --distpref=dist-bootstrapping
323 -cd Cabal && $(CABAL) clean --distpref=dist-bootstrapping
324 -cd hpc && $(CABAL) clean --distpref=dist-bootstrapping
325 $(RM) -rf bootstrapping
326 $(RM) -f bootstrapping.conf bootstrapping.conf.old
327 $(RM) -f bootstrapping.conf.tmp bootstrapping.conf.tmp.old
328 $(RM) -f cabal-bin cabal-bin.exe
329 $(RM) -rf ifBuildable
330 $(RM) -f libraries.txt index.html doc-index.html doc-index*.html
331 $(RM) -f haddock* *.gif
332 $(RM) -rf stamp/*
333 ifneq "$(wildcard dph)" ""
334 $(MAKE) -C dph clean
335 endif
336
337 distclean:
338 $(RM) $(foreach lib, $(SUBDIRS), $(lib)/.depend $(lib)/.depend.bak)
339
340 $(foreach SUBDIR,$(SUBDIRS),clean.library.$(SUBDIR)): \
341 clean.library.%:
342 $(RM) -f stamp/configure.library.*.$* $*/unbuildable
343 -cd $* && $(CABAL) clean
344 $(RM) -f $*/Setup $*/Setup.exe $*/Setup.hi $*/Setup.o
345 $(RM) $*/GNUmakefile $*/Makefile.local
346 endif
347
348 # -----------------------------------------------------------------------------
349
350 .PHONY: install install-docs install.library.%
351
352 install: $(foreach SUBDIR,$(SUBDIRS),install.library.$(SUBDIR))
353 ifeq "$(HADDOCK_DOCS)" "YES"
354 $(INSTALL_DIR) $(DESTDIR)$(html_installed_root)
355 $(INSTALL_DATA) index.html doc-index*.html $(DESTDIR)$(html_installed_root)
356 $(INSTALL_SCRIPT) gen_contents_index $(DESTDIR)$(html_installed_root)
357 # Hacks:
358 $(INSTALL_DATA) base/dist/doc/html/*/*.css $(DESTDIR)$(html_installed_root)
359 $(INSTALL_DATA) base/dist/doc/html/*/*.js $(DESTDIR)$(html_installed_root)
360 $(INSTALL_DATA) base/dist/doc/html/*/*.gif $(DESTDIR)$(html_installed_root)
361 endif
362
363 # Cabal doesn't let us ask to install docs only, so do nothing here
364 install-docs:
365 @:
366
367 # Ideally this would depend on a stamp/build.library.%, but if it does
368 # then we can't change the libraries and then just rerun make.
369 # Thus if you install without building then it will just break.
370
371 # prefix and (on Windows) htmldir use $topdir when configuring, so we
372 # need to tell installPackage the real path to use when installing.
373
374 # We also need to pass all the other directories in, as they can be
375 # overridden when installing a bindist.
376
377 $(foreach SUBDIR,$(SUBDIRS),install.library.$(SUBDIR)): \
378 install.library.%: ifBuildable/ifBuildable
379 if $(IFBUILDABLE) $*; then \
380 cd $* && \
381 $(INSTALL_PACKAGE) install '$(DESTDIR)$(bindir)/ghc-pkg' '$(DESTDIR)$(datadir)/package.conf' '$(DESTDIR)' '$(prefix)' '$(iprefix)' '$(ibindir)' '$(ilibdir)' '$(ilibexecdir)' '$(idynlibdir)' '$(idatadir)' '$(idocdir)' '$(ihtmldir)' '$(ihaddockdir)' ; \
382 fi
383
384 .PHONY: binary-dist binary-dist.library.%
385
386 BIN_DIST_LIBDIR=$(BIN_DIST_DIR)/libraries
387
388 BINDIST_EXTRAS += ifBuildable/ifBuildable
389 binary-dist: $(foreach SUBDIR,$(SUBDIRS),binary-dist.library.$(SUBDIR))
390 echo $(WHERE_AM_I)/Makefile >> $(BIN_DIST_LIST)
391 # XXX This needs to be changed: This ifBuildable is built with the
392 # bootstrapping compiler, so isn't OS X friendly. It should be made into
393 # a Cabal package if we keep it. However, once we drop extralibs we can
394 # probably remove it anyway.
395 echo $(WHERE_AM_I)/ifBuildable/ifBuildable >> $(BIN_DIST_LIST)
396 ifeq "$(HADDOCK_DOCS)" "YES"
397 for FILE in gen_contents_index index.html doc-index*.html; do echo $(WHERE_AM_I)/$$FILE >> $(BIN_DIST_LIST); done
398 endif
399
400 $(foreach SUBDIR,$(SUBDIRS),binary-dist.library.$(SUBDIR)): \
401 binary-dist.library.%:
402 if $(IFBUILDABLE) $*; then \
403 $(MAKE) -C $* -f Makefile.local binary-dist BINDIST_EXTRAS="$*.cabal LICENSE $*.buildinfo unbuildable" WHERE_AM_I=$(WHERE_AM_I)/$*; \
404 fi
405
406 # Ignore some doc targets that we don't support
407 # The root recurses into us when these targets are made
408 .PHONY: html-no-chunks chm HxS fo dvi ps pdf
409 html-no-chunks chm HxS fo dvi ps pdf:
410 @:
411