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
  43 INSTALL_HTML_DOC_DIRS += $1/$2
  44 else
  45 html_$1 :
  46         @echo "*** HTML documentation is disabled; BUILD_DOCBOOK_HTML = NO"
  47         @exit 1
  48 endif
  49
  50 .PHONY: ps_$1
  51 ifeq "$$(BUILD_DOCBOOK_PS)" "YES"
  52 $(call all-target,$1,ps_$1)
  53
  54 ps_$1 : $1/$2.ps
  55
  56 $1/$2.ps: $$($1_DOCBOOK_SOURCES)
  57         "$$(DBLATEX)" $$(DBLATEX_OPTS) $1/$2.xml --ps -o $$@
  58
  59 INSTALL_DOCS += $1/$2.ps
  60 else
  61 ps_$1 :
  62         @echo "*** PS documentation is disabled; BUILD_DOCBOOK_PS = NO"
  63         @exit 1
  64 endif
  65
  66 ifeq "$$(BUILD_DOCBOOK_PDF)" "YES"
  67 $(call all-target,$1,pdf_$1)
  68
  69 .PHONY: pdf_$1
  70 pdf_$1 : $1/$2.pdf
  71
  72 $1/$2.pdf: $$($1_DOCBOOK_SOURCES)
  73         "$$(DBLATEX)" $$(DBLATEX_OPTS) $1/$2.xml --pdf -o $$@
  74
  75 INSTALL_DOCS += $1/$2.pdf
  76 else
  77 pdf_$1 :
  78         @echo "*** PDF documentation is disabled; BUILD_DOCBOOK_PDF = NO"
  79         @exit 1
  80 endif
  81
  82 endef
  83