mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-09-24 21:10:27 +00:00
dc8590962b
Original commit message from CVS: redo autobuilt docs system with fancy XInclude features
82 lines
2.5 KiB
Makefile
82 lines
2.5 KiB
Makefile
READMEXMLFILES = README.xml NEWS.xml TODO.xml AUTHORS.xml
|
|
READMEFILES = $(READMEXMLFILES) gst-python.ent
|
|
|
|
RELNOTESXMLFILES = RELNOTES.xml
|
|
RELNOTESFILES = $(RELNOTESXMLFILES) $(READMEXMLFILES) gst-python.ent
|
|
|
|
XMLFILES = $(READMEXMLFILES) $(RELNOTESXMLFILES)
|
|
XSLFILES = common.xsl full.xsl part.xsl html.xsl pdf.xsl
|
|
CSSFILES = gst-python.css
|
|
|
|
EXTRA_DIST = $(XMLFILES) $(XSLFILES) $(CSSFILES)
|
|
|
|
DOCS = README.txt README.html #gst-python.pdf
|
|
TOPDOCS = README.txt NEWS.txt TODO.txt AUTHORS.txt
|
|
RELNOTES = RELNOTES.txt
|
|
|
|
CLEANFILES = $(DOCS) $(TOPDOCS) $(RELNOTES) tmpbuildcatalog
|
|
|
|
if BUILD_DOCS
|
|
|
|
XMLTO = xmlto
|
|
XMLTOFLAGS = --skip-validation -o $(CURDIR)
|
|
XMLLINT = xmllint
|
|
XMLLINTFLAGS = --xinclude --noout --loaddtd --catalogs --postvalid
|
|
|
|
all: $(DOCS)
|
|
|
|
tmpbuildcatalog: gst-python.ent
|
|
xmlcatalog --noout --create $@
|
|
xmlcatalog --noout --add system `cd $(srcdir) && pwd`/gst-python.ent $(CURDIR)/gst-python.ent $@
|
|
xmlcatalog --noout --add system $(srcdir)/gst-python.ent $(CURDIR)/gst-python.ent $@
|
|
|
|
check: tmpbuildcatalog
|
|
for d in $(XMLFILES); do \
|
|
SGML_CATALOG_FILES=$$SGML_CATALOG_FILES\ $(CURDIR)/tmpbuildcatalog \
|
|
$(XMLLINT) $(XMLLINTFLAGS) $(srcdir)/$$d; \
|
|
done
|
|
|
|
dist-docs: $(TOPDOCS)
|
|
|
|
dist-hook: dist-docs
|
|
for d in $(TOPDOCS); do \
|
|
mv $$d ../`basename $$d .txt`; \
|
|
done
|
|
|
|
# full docs
|
|
|
|
# filter out xsl deps and make xslto flags
|
|
xmltoxslflags = $(foreach xsl,$(filter %xsl,$(filter-out $(1),$(2))),-m $(srcdir)/$(xsl))
|
|
FULLDEPS = common.xsl full.xsl tmpbuildcatalog
|
|
|
|
README.txt: $(READMEFILES) $(FULLDEPS)
|
|
XML_CATALOG_FILES=$$XML_CATALOG_FILES\ $(CURDIR)/tmpbuildcatalog \
|
|
$(XMLTO) $(XMLTOFLAGS) $(call xmltoxslflags,$<,$+) txt $<
|
|
|
|
README.html: $(READMEFILES) $(FULLDEPS) html.xsl
|
|
XML_CATALOG_FILES=$$XML_CATALOG_FILES\ $(CURDIR)/tmpbuildcatalog \
|
|
$(XMLTO) $(XMLTOFLAGS) $(call xmltoxslflags,$<,$+) xhtml-nochunks $<
|
|
|
|
README.pdf: $(READMEFILES) $(FULLDEPS) pdf.xsl
|
|
XML_CATALOG_FILES=$$XML_CATALOG_FILES\ $(CURDIR)/tmpbuildcatalog \
|
|
$(XMLTO) $(XMLTOFLAGS) $(call xmltoxslflags,$<,$+) pdf $<
|
|
|
|
# partial docs
|
|
|
|
PARTIALDEPS = gst-python.ent common.xsl part.xsl tmpbuildcatalog
|
|
|
|
RELNOTES.txt: $(RELNOTESFILES) $(PARTIALDEPS)
|
|
XML_CATALOG_FILES=$$XML_CATALOG_FILES\ $(CURDIR)/tmpbuildcatalog \
|
|
$(XMLTO) $(XMLTOFLAGS) $(call xmltoxslflags,$<,$+) txt $<
|
|
|
|
%.txt: %.xml $(PARTIALDEPS)
|
|
XML_CATALOG_FILES=$$XML_CATALOG_FILES\ $(CURDIR)/tmpbuildcatalog \
|
|
$(XMLTO) $(XMLTOFLAGS) $(call xmltoxslflags,$<,$+) txt $<
|
|
|
|
else
|
|
|
|
dist-hook:
|
|
@echo "Error: Doc building must be enabled for autogeneration of README, NEWS, TODO, and AUTHORS for distribution."
|
|
@false
|
|
|
|
endif
|