X-Git-Url: http://git.megacz.com/?p=ghc-hetmet.git;a=blobdiff_plain;f=rules%2Fhaddock.mk;h=5e5b2f25ac1fdc99235731e3d19f3f177f1eaca2;hp=74cb20713f87d2d73f374357401381d99c6e11a0;hb=0856ac59cfb455d32a3042317fdba0f5e85cab9c;hpb=34cc75e1a62638f2833815746ebce0a9114dc26b diff --git a/rules/haddock.mk b/rules/haddock.mk index 74cb207..5e5b2f2 100644 --- a/rules/haddock.mk +++ b/rules/haddock.mk @@ -1,15 +1,35 @@ +# ----------------------------------------------------------------------------- +# +# (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 +# +# ----------------------------------------------------------------------------- -define haddock # args: $1 = dir, $2 = distdir, $3 = way + +define haddock # args: $1 = dir, $2 = distdir ifneq "$$($1_$2_DO_HADDOCK)" "NO" ifeq "$$($$($1_PACKAGE)_HADDOCK_FILE)" "" $$($1_PACKAGE)_HADDOCK_FILE = $1/$2/doc/html/$$($1_PACKAGE)/$$($1_PACKAGE).haddock +ALL_HADDOCK_FILES += $$($$($1_PACKAGE)_HADDOCK_FILE) else $$(error Already got a haddock file for $$($1_PACKAGE)) endif -$(call all-target,$1_$2_haddock,$$($$($1_PACKAGE)_HADDOCK_FILE)) +haddock: $$($$($1_PACKAGE)_HADDOCK_FILE) + +ifeq "$$(HADDOCK_DOCS)" "YES" +$(call all-target,$1_$2_haddock,html_$1) +endif + +.PHONY: html_$1 +html_$1 : $$($$($1_PACKAGE)_HADDOCK_FILE) $$($1_PACKAGE)_HADDOCK_DEPS = $$(foreach n,$$($1_$2_DEP_NAMES),$$($$n_HADDOCK_FILE)) @@ -17,9 +37,12 @@ ifeq "$$(HSCOLOUR_SRCS)" "YES" $1_$2_HADDOCK_FLAGS += --hyperlink-source endif -$$($$($1_PACKAGE)_HADDOCK_FILE) : $$(MKDIRHIER) $(INPLACE_BIN)/haddock$(exeext) $$(GHC_CABAL_INPLACE) $$($1_$2_HS_SRCS) $$($$($1_PACKAGE)_HADDOCK_DEPS) - $$(MKDIRHIER) $$(dir $$@) - $$(GHC_CABAL_INPLACE) haddock $2 $1 --with-haddock=$$(TOP)/$(INPLACE_BIN)/haddock --with-ghc=$$(TOP)/$(INPLACE_BIN)/ghc-stage2 $$($1_$2_HADDOCK_FLAGS) $$($1_$2_HADDOCK_OPTS) +$$($$($1_PACKAGE)_HADDOCK_FILE) : $$(INPLACE_BIN)/haddock$$(exeext) $$(GHC_CABAL_INPLACE) $$($1_$2_HS_SRCS) $$($$($1_PACKAGE)_HADDOCK_DEPS) | $$$$(dir $$$$@)/. + "$$(GHC_CABAL_INPLACE)" haddock $2 $1 --with-haddock=$$(TOP)/$$(INPLACE_BIN)/haddock --with-ghc=$$(TOP)/$$(INPLACE_BIN)/ghc-stage2 $$($1_$2_HADDOCK_FLAGS) $$($1_$2_HADDOCK_OPTS) + +# Make the haddocking depend on the library .a file, to ensure +# that we wait until the library is fully build before we haddock it +$$($$($1_PACKAGE)_HADDOCK_FILE) : $$($1_$2_v_LIB) endif