diff options
Diffstat (limited to 'DOCS/xml/Makefile')
-rw-r--r-- | DOCS/xml/Makefile | 76 |
1 files changed, 76 insertions, 0 deletions
diff --git a/DOCS/xml/Makefile b/DOCS/xml/Makefile new file mode 100644 index 0000000000..b6b8492552 --- /dev/null +++ b/DOCS/xml/Makefile @@ -0,0 +1,76 @@ +# Makefile for generating the HTML documentation + +#####[ Configuration ]################################################## + +# The xsltproc program. +XSLTPROC = xsltproc + +# The xmllint program. +XMLLINT = xmllint + +# A colon separated list of catalog entry files. +# Without this properly set up, xmllint and xsltproc might be unable +# to find the DTDs for the system identifiers specified in the XML files. +# If the SGML_CATALOG_FILES environment variable is not set, list one +# or more catalogs here. +# +# on debian (potato?) systems, maybe others +#SGML_CATALOG_FILES ?= /etc/sgml/catalog +# +# on Mandrake (9.0?) systems, maybe others +SGML_CATALOG_FILES ?= /usr/share/sgml/docbook/xml-dtd-4.1.2/xmlcatalog +#SGML_CATALOG_FILES ?= /usr/share/apps/ksgmltools2/customization/en/catalog + +# Full path of the "chunker" DocBook XSL stylesheet used to generate +# the HTML files. +# +# on debian (potato?) +#CHUNK_XSL = /usr/share/sgml/docbook/stylesheet/xsl/nwalsh/html/chunk.xsl +# +# on Mandrake (9.0?) systems, maybe others +CHUNK_XSL = /usr/share/sgml/docbook/yelp/docbook/html/chunk.xsl + +# List of subdirectories to be processed. +SUBDIRS = en + +#####[ End of configuration ]########################################### + +export CHUNK_XSL SGML_CATALOG_FILES XMLLINT XSLTPROC + +.PHONY: no-target +no-target: + @echo "What to make?" + @echo + @echo "Targets" + @echo "*******" + @echo "all : Build everything (same as build-html for now)." + @echo "build-html: Build HTML documentation." + @echo "clean-html: Purge the 'HTML' directory." + @echo "distclean : Remove ALL generated files." + +.PHONY: all +all: build-html + +.PHONY: build-html +build-html: + test -d HTML || mkdir HTML + for d in $(SUBDIRS); do\ + test -f $$d/Makefile &&\ + (test -d HTML/$$d || mkdir HTML/$$d) &&\ + if $(MAKE) HTMLDIR=../../HTML/$$d -C $$d; then :; else exit 1; fi;\ + done + +.PHONY: test +test: + @if command -v $(XSLTPROC) >/dev/null; then :; else exit 1; fi + @if command -v $(XMLLINT) >/dev/null; then :; else exit 1; fi + @test -f $(CHUNK_XSL) || (echo "file not found: $(CHUNK_XSL)"; exit 1) + @echo "All tests passed." + +.PHONY: clean-html +clean-html: + -rm -rf ../HTML + +.PHONY: distclean +distclean: clean-html + -rm -f html.xsl |