pass make distcheck
authorThomas Vander Stichele <thomasvs@xiph.org>
Thu, 5 Aug 2004 13:53:16 +0000 (13:53 +0000)
committerThomas Vander Stichele <thomasvs@xiph.org>
Thu, 5 Aug 2004 13:53:16 +0000 (13:53 +0000)
svn path=/trunk/vorbis/; revision=7483

ChangeLog
Makefile.am
doc/Makefile.am
doc/xml/a2-encapsulation_rtp.xml

index f3c26f7..9c2454a 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,13 @@
 2004-08-05  Thomas Vander Stichele  <thomas at apestaart dot org>
 
+       * Makefile.am:
+       * doc/Makefile.am:
+       * doc/xml/a2-encapsulation_rtp.xml:
+         first stab at fixing doc build and distcheck issues.
+         This makes libvorbis pass make distcheck if you have the tools.
+
+2004-08-05  Thomas Vander Stichele  <thomas at apestaart dot org>
+
        * autogen.sh:
          activate autoheader
        * configure.in:
index 524629b..08f46ef 100644 (file)
@@ -17,6 +17,7 @@ EXTRA_DIST = HACKING todo.txt macos macosx autogen.sh \
        vorbisenc-uninstalled.pc.in \
        vorbisfile-uninstalled.pc.in
 
+DISTCHECK_CONFIGURE_FLAGS = --enable-docs
 
 dist-hook:
        rm -rf `find $(distdir)/macos -name CVS`
index e726868..7007ddf 100644 (file)
@@ -4,28 +4,21 @@ SUBDIRS = vorbisfile vorbisenc
 
 docdir = $(datadir)/doc/$(PACKAGE)-$(VERSION)
 
-static_docs = components.png \
+### all of the static docs, commited to SVN and included as is
+static_docs = \
        draft-kerr-avt-vorbis-rtp-03.txt \
        eightphase.png \
        evenlsp.png \
-       floor1-1.png \
-       floor1-2.png \
-       floor1-3.png \
-       floor1-4.png \
        floor1_inverse_dB_table.html \
        floorval.png \
        fourphase.png \
        framing.html \
        helper.html \
-       hufftree-under.png \
-       hufftree.png \
        index.html \
        lspmap.png \
        oddlsp.png \
        oggstream.html \
        programming.html \
-       residue-pack.png \
-       residue2.png \
        squarepolar.png \
        stereo.html \
        stream.png \
@@ -37,20 +30,37 @@ static_docs = components.png \
        vorbisword2.png \
        wait.png \
        white-ogg.png \
+       white-xifish.png
+
+### FIXME: bits needed by the spec which lives in xml
+SPEC_PNG = \
+       components.png \
+       floor1-1.png \
+       floor1-2.png \
+       floor1-3.png \
+       floor1-4.png \
+       hufftree.png \
+       hufftree-under.png \
+       residue-pack.png \
+       residue2.png \
        white-xifish.png \
        window1.png \
        window2.png
+SPEC_PDF = xifish.pdf
+
+# FIXME: also needed here
+#      white-xifish.png 
 
 built_docs = Vorbis_I_spec.html Vorbis_I_spec.pdf
 
 # conditionally make the generated documentation
 if BUILD_DOCS
-doc_DATA = $(static_docs) $(built_docs)
+doc_DATA = $(static_docs) $(SPEC_PNG) $(built_docs)
 else
-doc_DATA = $(static_docs)
+doc_DATA = $(static_docs) $(SPEC_PNG)
 endif
 
-EXTRA_DIST = $(static_docs) $(built_docs)
+EXTRA_DIST = $(static_docs) $(doc_sources) $(SPEC_PNG) $(SPEC_PDF)
 
 doc_sources = xml/Vorbis_I_spec.xml \
        xml/01-introduction.xml \
@@ -70,23 +80,43 @@ doc_sources = xml/Vorbis_I_spec.xml \
        xml/spec-fo.xsl \
        xml/spec-html.xsl
 
-nobase_EXTRA_DIST = $(doc_sources)
-
 # these are expensive; only remove if we have to
-MAINTAINERCLEANFILES = $(built_docs)
+DISTCLEANFILES = $(built_docs)
 CLEANFILES = Vorbis_I_spec.fo spec.aux spec.log spec.out
 
+# rules for temporary build dir for spec
+BUILDDIR = build
+# how to copy images to build dir
+SPEC_PNG_BUILD = $(foreach file, $(SPEC_PNG), $(BUILDDIR)/$(file))
+SPEC_PDF_BUILD = $(foreach file, $(SPEC_PDF), $(BUILDDIR)/$(file))
+$(BUILDDIR)/%: $(srcdir)/%
+       @echo "Copying $< to $@"
+       @mkdir -p $(BUILDDIR)
+       @cp $< $@
+
+# how to copy the xml to build dir; cheat by only targeting the main one
+$(BUILDDIR)/Vorbis_I_spec.xml: $(doc_sources)
+       @mkdir -p $(BUILDDIR)
+       @for file in $(doc_sources); do cp $(srcdir)/$$file $(BUILDDIR); done
+# translate the draft rtp.txt to .xml in the BUILDDIR
+$(BUILDDIR)/draft-rtp.xml: draft-kerr-avt-vorbis-rtp-03.txt
+       cat $< | sed 's/\f//g' > $@
+# cat $< | sed 's/\f//g' | sed 's/</\&lt;/g' | sed 's/>/\&gt;/g' > $@
+
 # explicit rules for generating docs
-Vorbis_I_spec.html:
-       xsltproc --xinclude --output $@ $(srcdir)/xml/spec-html.xsl $(srcdir)/xml/Vorbis_I_spec.xml
+Vorbis_I_spec.html: $(SPEC_PNG_BUILD) $(BUILDDIR)/Vorbis_I_spec.xml
+       cd build; xsltproc --xinclude --output Vorbis_I_spec.html spec-html.xsl Vorbis_I_spec.xml && mv $@ ..
 
-Vorbis_I_spec.fo:
-       xsltproc --xinclude --output $@ $(srcdir)/xml/spec-fo.xsl $(srcdir)/xml/Vorbis_I_spec.xml
+Vorbis_I_spec.fo: $(BUILDDIR)/Vorbis_I_spec.xml
+       cd build; xsltproc --xinclude --output $@ spec-fo.xsl Vorbis_I_spec.xml && mv $@ ..
 
-Vorbis_I_spec.pdf: Vorbis_I_spec.fo
-       cp $< spec.fo # work around a passivetex bug
-       pdfxmltex --interaction nonstopmode spec.fo
-       pdfxmltex --interaction nonstopmode spec.fo
-       rm spec.fo
-       mv spec.pdf $@
+Vorbis_I_spec.pdf: Vorbis_I_spec.fo $(SPEC_PNG_BUILD) $(SPEC_PDF_BUILD)
+       cp $< build/spec.fo # work around a passivetex bug
+       cd build; pdfxmltex --interaction nonstopmode spec.fo
+       cd build; pdfxmltex --interaction nonstopmode spec.fo
+       rm build/spec.fo
+       mv build/spec.pdf $@
 
+# clean up build dir
+clean-local:
+       -$(RM) -r $(BUILDDIR)
index 5a762de..4d99934 100644 (file)
 <literallayout class="monospaced">
 <!-- this works with extensions implemented in Saxon and Xalan
 <textobject><textdata 
-fileref="../draft-kerr-avt-vorbis-rtp-03.txt"/></textobject> -->
+fileref="draft-rtp.xml"/></textobject> -->
 <!-- this works with xinclude, implemented in xsltproc -->
 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
-      href="../draft-kerr-avt-vorbis-rtp-03.txt" parse="text">
+      href="draft-rtp.xml" parse="text">
   <xi:fallback xmlns:xi="http://www.w3.org/2001/XInclude">
     <para>Please consult the internet draft <citetitle>RTP Payload Format for Vorbis Encoded
     Audio</citetitle> for description of how to embed Vorbis audio in an RTP stream.</para>