#
# PostGIS documentation build Makefile
#
# Written by Mark Cave-Ayland
#
# NOTE: We don't use a standard PGXS Makefile here since the DOCS target
# only allows files to be stored within contrib/ and we currently
# store documentation under contrib/postgis due to the possibility
# that we could produce a large number of files (think chunked HTML)
#

XSLTPROC = @XSLTPROC@
XSLBASE = @XSLBASE@

XSLTPROC_COMMONOPTS = \
	--param section.autolabel 1 \
	--param section.label.includes.component.label 1 \
	--param chunk.section.depth 0 

XSLTPROC_HTMLOPTS = \
	--stringparam html.stylesheet style.css \

HTML_DOCBOOK_XSL=$(XSLBASE)/html/docbook.xsl 
CHUNK_HTML_DOCBOOK_XSL=$(XSLBASE)/html/chunk.xsl 

# Directories for documentation and man pages
PGSQL_DOCDIR=@PGSQL_DOCDIR@
PGSQL_MANDIR=@PGSQL_MANDIR@


# If XSLTPROC was not found during configure, we cannot
# build the documentation
ifdef XSLTPROC
all: html/postgis.html
else
all: requirements_not_met
endif

postgis-out.xml: postgis.xml introduction.xml installation.xml faq.xml using_postgis.xml performance_tips.xml reference.xml reporting.xml release_notes.xml ../Version.config
	cat $< | sed "s/@@LAST_RELEASE_VERSION@@/@POSTGIS_LIB_VERSION@/g" > $@

chunked-html: postgis-out.xml
	$(XSLTPROC) $(XSLTPROC_COMMONOPTS) $(XSLTPROC_HTMLOPTS) \
		--output html/ \
		--stringparam saxon.character.representation decimal \
		$(CHUNK_HTML_DOCBOOK_XSL) \
		$<

html/postgis.html: postgis-out.xml
	$(XSLTPROC) $(XSLTPROC_COMMONOPTS) $(XSLTPROC_HTMLOPTS) \
		--output html/postgis.html \
		$(HTML_DOCBOOK_XSL) \
		$<

clean:
	@rm -f \
		postgis-out.xml \
		postgis.aux \
		postgis.fo \
		postgis.pdf \
		postgis.out \
		postgis.log

maintainer-clean: clean
	@rm -f html/*.html

install: html/postgis.html man/shp2pgsql.1 man/pgsql2shp.1
	@mkdir -p $(PGSQL_DOCDIR)/postgis
	@mkdir -p $(PGSQL_MANDIR)/man1
	cp html/postgis.html $(PGSQL_DOCDIR)/postgis/postgis.html
	cp ../README.postgis $(PGSQL_DOCDIR)/postgis/README.postgis
	cp man/pgsql2shp.1 $(PGSQL_MANDIR)/man1/pgsql2shp.1
	cp man/shp2pgsql.1 $(PGSQL_MANDIR)/man1/shp2pgsql.1

uninstall:
	rm -f $(PGSQL_DOCDIR)/postgis/postgis.html
	rm -f $(PGSQL_DOCDIR)/postgis/README.postgis
	rm -f $(PGSQL_MANDIR)/man1/shp2pgsql.1
	rm -f $(PGSQL_MANDIR)/man1/pgsql2shp.1

requirements_not_met:
	@echo
	@echo "configure was unable to find 'xsltproc' which is required to build the documentation."
	@echo "To build the documentation, install xsltproc and then re-run configure. Alternatively "
	@echo "refer to online manual:"
	@echo
	@echo "  http://postgis.refractions.net/docs"
	@echo

.PHONY: html