X-Git-Url: http://git.onelab.eu/?a=blobdiff_plain;f=doc%2FMakefile;h=508d3acc0bd682eac4b90a5fec61cdd768379fbe;hb=19d4a01ccf66af9e00914351b3eacd5fc880f988;hp=4a303c54adcce18d94fb7b50e9020334b2c872f6;hpb=a7c033397aba357a21336361f0b0f41df26866b1;p=plcapi.git diff --git a/doc/Makefile b/doc/Makefile index 4a303c54..508d3acc 100644 --- a/doc/Makefile +++ b/doc/Makefile @@ -4,17 +4,31 @@ # Mark Huang # Copyright (C) 2006 The Trustees of Princeton University # -# $Id$ -# all: PLCAPI.html +# XML - as opposed to SGML - requires an identifier - see +# http://www.docbook.org/tdg/en/html/appb.html +# and, openjade opens http connections when using the official URL +# as an identifier; this is slow, and sometimes fails and breaks the build + +# locating locally installed docbook43 dtd - fedora-specific +remote-docbook-43 = http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd +local-docbook-43 = $(wildcard /usr/share/sgml/docbook/xml-dtd-4.3*/docbookx.dtd) +docbook-43=$(if $(local-docbook-43),$(local-docbook-43),$(remote-docbook-43)) + +PLCAPI.xml: PLCAPI.xml.in + $(if $(local-docbook-43), \ + echo Using locally installed DTD $(local-docbook-43), \ + echo WARNING - could not locate local DTD - using remote $(remote-docbook-43)) + sed -e "s,@DOCBOOK-43@,$(docbook-43)," $< > $@ + .PLCAPI.xml.valid: Methods.xml API_SOURCES = ../PLC/__init__.py ../PLC/Methods/__init__.py Methods.xml: DocBook.py DocBookLocal.py $(API_SOURCES) - PYTHONPATH=.. DocBookLocal.py > $@ + PYTHONPATH=.. ./DocBookLocal.py > $@ # # Documentation