Commit dc859096 authored by David I. Lehn's avatar David I. Lehn

redo autobuilt docs system with fancy XInclude features

Original commit message from CVS:
redo autobuilt docs system with fancy XInclude features
parent 0eeb0117
......@@ -11,7 +11,11 @@
* README, AUTHORS, NEWS, TODO: removed (generated from docs/*)
* docs/.cvsignore: add generated files
* .cvsignore, docs/.cvsignore: add generated files
* docs/{AUTHORS.xml, NEWS.xml, README.xml, RELNOTES.xml, TODO.xml,
gst-python.ent.in, common.xsl, full.xsl, part.xsl, Makefile.am}: redo
autobuilt docs system with fancy XInclude features
2003-06-26 David I. Lehn <dlehn@users.sourceforge.net>
......
<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
<!ENTITY % ents SYSTEM "gst-python.ent">
%ents;
]>
<article id="gst-python-authors">
<!--=====================================================================-->
<articleinfo>
<title>Gst-Python &version; Authors</title>
<copyright><year>2003</year><holder>David I. Lehn</holder></copyright>
<pubdate>&pubdate;</pubdate>
<authorgroup>
<author>
<firstname>David</firstname>
<othername role="mi">I.</othername>
<surname>Lehn</surname>
<email>dlehn@users.sourceforge.net</email>
</author>
</authorgroup>
</articleinfo>
<!--=====================================================================-->
<section id="authors">
<title>Authors</title>
<para>
Please feel free to contact the developers. They hang out on IRC (<ulink url="http://gstreamer.net/dev/"/>) and the mailing lists (<ulink url="http://gstreamer.net/contact/lists.php"/>).
</para>
<!--=================-->
<section id="maintainer">
<title>Maintainer</title>
<itemizedlist>
<listitem><para>David I. Lehn <email>dlehn@users.sourceforge.net</email></para></listitem>
</itemizedlist>
</section>
<!--=================-->
<section id="contributions">
<title>Contributions</title>
<para>
Patches, suggestions, and other help:
</para>
<itemizedlist>
<listitem><para>Kenichi Sato <email>ksato at users.sourceforge.net</email>: misc patches</para></listitem>
<listitem><para>Thomas Vander Stichele <email>thomas at apestaart.org</email>: misc patches, build framework patches, Red Hat support</para></listitem>
</itemizedlist>
<para>
Much of the framework for gst-python stolen from the excellent gtk and gconf bindings by:
</para>
<itemizedlist>
<listitem><para>James Henstridge <email>james at daa.com.au</email></para></listitem>
<listitem><para>Johan Dahlin <email>jdahlin at telia.com</email></para></listitem>
<listitem><para>Matt Wilson <email>msw at redhat.com</email></para></listitem>
<listitem><para>and many more...</para></listitem>
</itemizedlist>
</section>
<!--=================-->
<section id="gstreamer-team">
<title>GStreamer Team</title>
<para>
And of course, none of this would be possible without the extreme hacker mojo
of the whole GStreamer crew!
</para>
</section>
<!--=================-->
</section>
<!--=====================================================================-->
</article>
XMLFILES = gst-python.xml
XSLFILES = common.xsl html.xsl
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
DOCS = gst-python.txt gst-python.html
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)
gst-python.txt: gst-python.xml
xmlto txt $<
# cp gst-python.txt $(top_builddir)/../README
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 $@
gst-python.html: gst-python.xml common.xsl html.xsl
xmlto -m common.xsl -m html.xsl xhtml-nochunks $<
check: tmpbuildcatalog
for d in $(XMLFILES); do \
SGML_CATALOG_FILES=$$SGML_CATALOG_FILES\ $(CURDIR)/tmpbuildcatalog \
$(XMLLINT) $(XMLLINTFLAGS) $(srcdir)/$$d; \
done
gst-python.pdf: gst-python.xml common.xsl pdf.xsl
xmlto -m common.xsl -m pdf.xsl pdf $<
dist-docs: $(TOPDOCS)
CLEANFILES = $(DOCS)
dist-hook: dist-docs
for d in $(TOPDOCS); do \
mv $$d ../`basename $$d .txt`; \
done
EXTRA_DIST = $(XMLFILES) $(XSLFILES) $(CSSFILES)
# 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
<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
<!ENTITY % ents SYSTEM "gst-python.ent">
%ents;
]>
<article id="gst-python-news">
<!--=====================================================================-->
<articleinfo>
<title>Gst-Python &version; News</title>
<copyright><year>2003</year><holder>David I. Lehn</holder></copyright>
<pubdate>&pubdate;</pubdate>
<authorgroup>
<author>
<firstname>David</firstname>
<othername role="mi">I.</othername>
<surname>Lehn</surname>
<email>dlehn@users.sourceforge.net</email>
</author>
</authorgroup>
</articleinfo>
<!--=====================================================================-->
<section id="news">
<title>News</title>
<section role="notintoc" id="release-0.1.0">
<title>2003-07-09 - 0.1.0 - David I. Lehn <email>dlehn@users.sourceforge.net</email></title>
<para>
<itemizedlist>
<listitem><para>First release</para></listitem>
</itemizedlist>
</para>
</section>
</section>
<!--=====================================================================-->
</article>
This diff is collapsed.
<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
<!ENTITY % local.common.attrib "xml:base CDATA #IMPLIED">
<!ENTITY % ents SYSTEM "gst-python.ent">
%ents;
]>
<article id="gst-python-release-notes">
<!--=====================================================================-->
<articleinfo>
<title>Gst-Python &version; Release Notes</title>
</articleinfo>
<!--=====================================================================-->
<xi:include href="NEWS.xml#release-&version;" xmlns:xi="http://www.w3.org/2001/XInclude"/>
<!--=====================================================================-->
<para><ulink url="http://www.gstreamer.net/bindings/python/"/></para>
<!--=====================================================================-->
</article>
<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
<!ENTITY % ents SYSTEM "gst-python.ent">
%ents;
]>
<article id="gst-python-todo">
<!--=====================================================================-->
<articleinfo>
<title>Gst-Python &version; ToDo</title>
<copyright><year>2003</year><holder>David I. Lehn</holder></copyright>
<pubdate>&pubdate;</pubdate>
<authorgroup>
<author>
<firstname>David</firstname>
<othername role="mi">I.</othername>
<surname>Lehn</surname>
<email>dlehn@users.sourceforge.net</email>
</author>
</authorgroup>
</articleinfo>
<!--=====================================================================-->
<section id="todo">
<title>ToDo</title>
<itemizedlist>
<listitem><para>handle more of the functions that need manual wrapping code</para></listitem>
<listitem><para>add check that pygtk built with <parameter class="command">--enable-thread</parameter></para></listitem>
<listitem><para>improve Python gstreamer.Element creation</para>
<itemizedlist>
<listitem><para>perhaps drop <function>_set_foo_function</function>() calls in favor of object methods</para></listitem>
<listitem><para>sane buffer handling with buffer type or Numeric?</para></listitem>
</itemizedlist>
</listitem>
<listitem><para>docs</para>
<itemizedlist>
<listitem><para>API ref</para></listitem>
<listitem><para>manual</para></listitem>
<listitem><para>tutorial</para></listitem>
</itemizedlist>
</listitem>
<listitem><para>more examples</para></listitem>
<listitem><para>convert build system to distutils</para></listitem>
<listitem><para>wrap other GStreamer helper libs</para></listitem>
<listitem><para>add some standard widgets</para>
<itemizedlist>
<listitem><para>gtk video widget (similar to widget gst-player is using)</para></listitem>
</itemizedlist>
</listitem>
<listitem><para>testsuite</para></listitem>
</itemizedlist>
</section>
<!--=====================================================================-->
</article>
<?xml version='1.0'?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
version='1.0'>
<xsl:param name="section.autolabel" select="1"/>
<xsl:param name="section.label.includes.component.label" select="1"/>
<xsl:param name="use.id.as.filename" select="1"/>
</xsl:stylesheet>
<?xml version='1.0'?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
version='1.0'>
<xsl:param name="section.autolabel" select="1"/>
<xsl:template match="section[@role = 'notintoc']" mode="toc"/>
</xsl:stylesheet>
<!ENTITY version "@VERSION@">
<!ENTITY pubdate "June 28, 2003">
<?xml version='1.0'?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
version='1.0'>
<xsl:param name="section.autolabel" select="0"/>
<xsl:param name="generate.toc">
article nop
</xsl:param>
</xsl:stylesheet>
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment