rules/docbook.mk

   1 # -----------------------------------------------------------------------------
   2 #
   3 # (c) 2009 The University of Glasgow
   4 #
   5 # This file is part of the GHC build system.
   6 #
   7 # To understand how the build system works and how to modify it, see
   8 #      http://hackage.haskell.org/trac/ghc/wiki/Building/Architecture
   9 #      http://hackage.haskell.org/trac/ghc/wiki/Building/Modifying
  10 #
  11 # -----------------------------------------------------------------------------
  12
  13
  14 # Build docbook docs
  15
  16 define docbook
  17 # $1 = dir
  18 # $2 = docname
  19
  20 $(call clean-target,$1,docbook,$1/$2 $1/$2.pdf $1/$2.ps)
  21
  22 # empty "all_$1" target just in case we're not building docs at all
  23 $(call all-target,$1,)
  24
  25 .PHONY: html_$1
  26
  27 ifeq "$$(BUILD_DOCBOOK_HTML)" "YES"
  28 $(call all-target,$1,html_$1)
  29
  30 html_$1 : $1/$2/index.html
  31
  32 $1/$2/index.html: $$($1_DOCBOOK_SOURCES)
  33         "$$(RM)" $$(RM_OPTS) -r $$(dir $$@)
  34         "$$(XSLTPROC)" --stringparam base.dir $$(dir $$@) \
  35                        --stringparam use.id.as.filename 1 \
  36                        --stringparam html.stylesheet fptools.css \
  37                        --nonet \
  38                        $$(XSLTPROC_LABEL_OPTS) $$(XSLTPROC_OPTS) \
  39                        $$(XSLTPROC_HTML_STYLESHEET) \
  40                        $1/$2.xml
  41         cp mk/fptools.css $$(dir $$@)
  42 else
  43 html_$1 :
  44         @echo "*** HTML documentation is disabled; BUILD_DOCBOOK_HTML = NO"
  45         @exit 1
  46 endif
  47
  48 .PHONY: ps_$1
  49 ifeq "$$(BUILD_DOCBOOK_PS)" "YES"
  50 $(call all-target,$1,ps_$1)
  51
  52 ps_$1 : $1/$2.ps
  53
  54 $1/$2.ps: $$($1_DOCBOOK_SOURCES)
  55         "$$(DBLATEX)" $$(DBLATEX_OPTS) $1/$2.xml --ps -o $$@
  56 else
  57 ps_$1 :
  58         @echo "*** PS documentation is disabled; BUILD_DOCBOOK_PS = NO"
  59         @exit 1
  60 endif
  61
  62 ifeq "$$(BUILD_DOCBOOK_PDF)" "YES"
  63 $(call all-target,$1,pdf_$1)
  64
  65 .PHONY: pdf_$1
  66 pdf_$1 : $1/$2.pdf
  67
  68 $1/$2.pdf: $$($1_DOCBOOK_SOURCES)
  69         "$$(DBLATEX)" $$(DBLATEX_OPTS) $1/$2.xml --pdf -o $$@
  70 else
  71 pdf_$1 :
  72         @echo "*** PDF documentation is disabled; BUILD_DOCBOOK_PDF = NO"
  73         @exit 1
  74 endif
  75
  76 endef
  77