X-Git-Url: http://git.onelab.eu/?a=blobdiff_plain;f=doc%2FMakefile;h=f3a8cb7f869c720fe5bcab18014f64879d648ea8;hb=d48149e2b753c4ae146dc391883b2389b52b4f73;hp=4a303c54adcce18d94fb7b50e9020334b2c872f6;hpb=a7c033397aba357a21336361f0b0f41df26866b1;p=plcapi.git diff --git a/doc/Makefile b/doc/Makefile index 4a303c5..f3a8cb7 100644 --- a/doc/Makefile +++ b/doc/Makefile @@ -5,16 +5,33 @@ # Copyright (C) 2006 The Trustees of Princeton University # # $Id$ +# $URL$ # 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