Add documentation for SPV file format.

[pspp] / doc / automake.mk

diff --git a/doc/automake.mk b/doc/automake.mk
index 67c2d83c8fe91d7e4a21ecd6b510fb73c414763c..28866ca2e9196eb46143842cb7b1d3a95ba24483 100644 (file)
--- a/doc/automake.mk
+++ b/doc/automake.mk
@@ -1,12 +1,11 @@
 ## Process this file with automake to produce Makefile.in  -*- makefile -*-
 
-info_TEXINFOS = doc/pspp.texinfo doc/pspp-dev.texinfo
+info_TEXINFOS = doc/pspp.texi doc/pspp-dev.texi
 
 doc_pspp_TEXINFOS = doc/version.texi \
        doc/bugs.texi \
        doc/command-index.texi \
        doc/concept-index.texi \
-       doc/configuring.texi \
        doc/data-io.texi \
        doc/data-selection.texi \
        doc/expressions.texi \
@@ -19,10 +18,14 @@ doc_pspp_TEXINFOS = doc/version.texi \
        doc/invoking.texi \
        doc/language.texi \
        doc/license.texi \
+       doc/pspp-convert.texi \
+       doc/pspp-dump-sav.texi \
        doc/ni.texi \
        doc/not-implemented.texi \
        doc/statistics.texi \
        doc/transformation.texi \
+       doc/tutorial.texi \
+       doc/tut.texi \
        doc/regression.texi \
        doc/utilities.texi \
        doc/variables.texi \
@@ -36,24 +39,75 @@ doc_pspp_dev_TEXINFOS = doc/version-dev.texi \
        doc/dev/i18n.texi \
        doc/dev/output.texi \
        doc/dev/system-file-format.texi \
+       doc/dev/pc+-file-format.texi \
        doc/dev/portable-file-format.texi \
+       doc/dev/spv-file-format.texi \
+       doc/dev/encrypted-file-wrappers.texi \
        doc/dev/q2c.texi
 
-EXTRA_DIST += doc/pspp.man \
-       doc/get-commands.pl
+if HAVE_DOT
+$(PDFS): doc/dev/spv-structure.pdf
+$(srcdir)/doc/dev/spv-structure.pdf: doc/dev/spv-structure.gv
+       dot -Tpdf < $< > $@
 
-doc/ni.texi: $(top_srcdir)/src/language/command.def doc/get-commands.pl
+$(DVIS): doc/dev/spv-structure.eps
+$(srcdir)/doc/dev/spv-structure.eps: doc/dev/spv-structure.gv
+       dot -Teps < $< > $@
+endif
+EXTRA_DIST += \
+       doc/dev/spv-structure.gv \
+       doc/dev/spv-structure.pdf \
+       doc/dev/spv-structure.eps
+
+dist_man_MANS += doc/pspp.1 \
+                 doc/psppire.1
+
+EXTRA_DIST += doc/get-commands.pl doc/help-pages-list
+
+$(srcdir)/doc/ni.texi: $(top_srcdir)/src/language/command.def doc/get-commands.pl
        @$(MKDIR_P)  doc
-       @PERL@ $(top_srcdir)/doc/get-commands.pl $(top_srcdir)/src/language/command.def > $@
+       $(AM_V_GEN)$(PERL) $(top_srcdir)/doc/get-commands.pl $(top_srcdir)/src/language/command.def > $@
 
-doc/pspp.xml: doc/pspp.texinfo $(doc_pspp_TEXINFOS)
+$(srcdir)/doc/tut.texi:
+       @$(MKDIR_P) doc
+       $(AM_V_GEN)echo "@set example-dir $(examplesdir)" > $@
+
+
+# The SED and AWK filters in this rule, are to work-around some nasty bugs in 
+# makeinfo version 4.13, which produces broken docbook xml.  These workarounds 
+# are rather horrible and must be removed asap.
+$(srcdir)/doc/pspp.xml: doc/pspp.texi $(doc_pspp_TEXINFOS) $(top_srcdir)/doc/help-pages-list
        @$(MKDIR_P)  doc
-       $(MAKEINFO) --docbook -I $(top_srcdir) $< -o $@
-       $(SED) -i -e 's/Time-&-Date/Time-\&amp;-Date/g' $@
+       $(AM_V_GEN)$(MAKEINFO) $(AM_MAKEINFOFLAGS) --docbook -I $(top_srcdir) \
+               $(top_srcdir)/doc/pspp.texi -o - \
+               | $(SED) -e 's/Time-&-Date/Time-\&amp;-Date/g' \
+               -e 's/&ldquo;/\&#8220;/g' \
+               -e 's/&rdquo;/\&#8221;/g' \
+               -e 's/&lsquo;/\&#8216;/g' \
+               -e 's/&rsquo;/\&#8217;/g' \
+               -e 's/&mdash;/\&#8212;/g' \
+               -e 's/&ndash;/\&#8242;/g' \
+                -e 's/&eacute;/\&#0233;/g' \
+               -e 's/&copy;/\&#0169;/g' \
+               -e 's/&minus;/\&#8722;/g' \
+               -e 's/&hellip;/\&#8230;/g' \
+               -e 's/&bull;/\&#2022;/g' \
+               -e 's/&period;/./g' \
+               -e 's%\(<figure [^>]*\)>%\1/>%g' \
+        | $(AWK) '/<para>.*<table.*>.*<\/para>/{x=sub("</para>",""); print; s=1;next}/<\/table>/{print; if (s==1) print "</para>"; s=0; next}1' \
+       > $@,tmp
+       $(AM_V_at)$(XMLLINT) --output /dev/null $@,tmp
+       $(AM_V_at)cat $(top_srcdir)/doc/help-pages-list | while read node ; do \
+        $(XMLLINT) --xpath "$$node" $@,tmp > /dev/null; \
+        if test $$? -ne 0 ; then  echo "$$node does not appear in $@" ; exit 1; fi ; \
+        done 
+       mv $@,tmp $@
 
 docbookdir = $(docdir)
-docbook_DATA = doc/pspp.xml
+dist_docbook_DATA = doc/pspp.xml
 
 
-EXTRA_DIST += doc/OChangeLog
 CLEANFILES += pspp-dev.dvi $(docbook_DATA)
+
+doc: $(INFO_DEPS) $(DVIS) $(PDFS) $(PSS) $(HTMLS) $(dist_docbook_DATA)
+.PHONY: doc