Install all the files that comprise the new DocBook way of making the

documentation.

1 files changed, 177 insertions, 0 deletions

diff --git a/doc/doc-docbook/Makefile b/doc/doc-docbook/Makefile
new file mode 100644
index 000000000..802f74085
--- /dev/null
+++ b/doc/doc-docbook/Makefile
@@ -0,0 +1,177 @@
+# $Cambridge: exim/doc/doc-docbook/Makefile,v 1.1 2005/06/16 10:32:31 ph10 Exp $
+
+# Make file for Exim documentation from Asciidoc source.
+
+notarget:;    @echo "** You must specify a target, in the form x.y, where x is 'filter', 'spec',"
+	      @echo "** or 'test', and y is 'xml', 'fo', 'ps', 'pdf', 'html', 'txt', or 'info'."
+	      @echo "** One other possible target is 'exim.8'".
+	      exit 1
+
+
+############################## MAN PAGE ################################
+
+exim.8: spec.xml
+	      ./x2man
+
+########################################################################
+
+
+############################### FILTER #################################
+
+filter.xml:   filter.ascd MyAsciidoc.conf
+	      asciidoc -d book -b docbook -f MyAsciidoc.conf filter.ascd
+
+filter-fo.xml: filter.xml Pre-xml
+	      Pre-xml -bookinfo <filter.xml >filter-fo.xml
+
+filter-html.xml: filter.xml Pre-xml
+	      Pre-xml <filter.xml >filter-html.xml
+
+filter-txt.xml: filter.xml Pre-xml
+	      Pre-xml -ascii <filter.xml >filter-txt.xml
+
+filter.fo:    filter-fo.xml MyStyle-filter-fo.xsl MyStyle-fo.xsl MyStyle.xsl
+	      /bin/rm -rf filter.fo filter-fo.fo
+	      xmlto -x MyStyle-filter-fo.xsl fo filter-fo.xml
+	      /bin/mv -f filter-fo.fo filter.fo
+
+filter.ps:    filter.fo
+	      fop filter.fo -ps filter.ps
+
+filter.pdf:   filter.fo
+	      fop filter.fo -pdf filter.pdf
+
+filter.html:  filter-html.xml TidyHTML-filter MyStyle-nochunk-html.xsl MyStyle-html.xsl MyStyle.xsl
+	      /bin/rm -rf filter.html filter-html.html
+	      xmlto -x MyStyle-nochunk-html.xsl html-nochunks filter-html.xml
+	      /bin/mv -f filter-html.html filter.html
+	       ./TidyHTML-filter
+
+filter.txt:   filter-txt.xml Tidytxt MyStyle-txt-html.xsl MyStyle-html.xsl MyStyle.xsl
+	      /bin/rm -rf filter-txt.html
+	      xmlto -x MyStyle-txt-html.xsl html-nochunks filter-txt.xml
+	      w3m -dump filter-txt.html >filter.txt
+
+# I have not found a way of making docbook2texi write its output anywhere
+# other than the file name that it makes up. The --to-stdout option does not
+# work.
+
+filter.info:  filter-txt.xml
+	      docbook2texi filter-txt.xml
+	      perl -ne 's/conceptindex/cindex/;s/optionindex/findex/;print;' \
+		<exim_filtering.texi | Tidytxt >filter.texinfo
+	      /bin/rm -rf exim_filtering.texi
+	      makeinfo -o filter.info filter.texinfo
+
+########################################################################
+
+
+################################ SPEC ##################################
+
+spec.xml:     spec.ascd MyAsciidoc.conf
+	      asciidoc -d book -b docbook -f MyAsciidoc.conf spec.ascd
+
+spec-fo.xml:  spec.xml Pre-xml
+	      Pre-xml <spec.xml >spec-fo.xml
+
+spec-html.xml: spec.xml Pre-xml
+	      Pre-xml -abstract -oneindex <spec.xml >spec-html.xml
+
+spec-txt.xml: spec.xml Pre-xml
+	      Pre-xml -abstract -ascii -noindex <spec.xml >spec-txt.xml
+
+spec.fo:      spec-fo.xml MyStyle-spec-fo.xsl MyStyle-fo.xsl MyStyle.xsl MyTitleStyle.xsl
+	      /bin/rm -rf spec.fo spec-fo.fo
+	      xmlto -x MyStyle-spec-fo.xsl fo spec-fo.xml
+	      /bin/mv -f spec-fo.fo spec.fo
+
+spec.ps:      spec.fo
+	      FOP_OPTS=-Xmx512m fop spec.fo -ps spec.ps
+
+spec.pdf:     spec.fo
+	      FOP_OPTS=-Xmx512m fop spec.fo -pdf spec.pdf
+
+spec.html:    spec-html.xml TidyHTML-spec MyStyle-chunk-html.xsl MyStyle-html.xsl MyStyle.xsl
+	      /bin/rm -rf spec.html
+	      xmlto -x MyStyle-chunk-html.xsl -o spec.html html spec-html.xml
+	      ./TidyHTML-spec
+
+spec.txt:     spec-txt.xml Tidytxt MyStyle-txt-html.xsl MyStyle-html.xsl MyStyle.xsl
+	      /bin/rm -rf spec-txt.html
+	      xmlto -x MyStyle-txt-html.xsl html-nochunks spec-txt.xml
+	      w3m -dump spec-txt.html | Tidytxt >spec.txt
+
+# I have not found a way of making docbook2texi write its output anywhere
+# other than the file name that it makes up. The --to-stdout option does not
+# work.
+
+spec.info:    spec-txt.xml
+	      docbook2texi spec-txt.xml
+	      perl -ne 's/conceptindex/cindex/;s/optionindex/findex/;print;' \
+		<the_exim_mta.texi >spec.texinfo
+	      /bin/rm -rf the_exim_mta.texi
+	      makeinfo -o spec.info spec.texinfo
+
+########################################################################
+
+
+################################ TEST ##################################
+
+# These targets (similar to the above)  are for running little tests.
+
+test.xml:     test.ascd MyAsciidoc.conf
+	      asciidoc -d book -b docbook -f MyAsciidoc.conf test.ascd
+
+test-fo.xml:  test.xml Pre-xml
+	      ./Pre-xml <test.xml >test-fo.xml
+
+test-html.xml: test.xml Pre-xml
+	      ./Pre-xml -abstract -oneindex <test.xml >test-html.xml
+
+test-txt.xml: test.xml Pre-xml
+	      ./Pre-xml -abstract -ascii -noindex <test.xml >test-txt.xml
+
+test.fo:      test-fo.xml MyStyle-spec-fo.xsl MyStyle-fo.xsl MyStyle.xsl MyTitleStyle.xsl
+	      /bin/rm -rf test.fo test-fo.fo
+	      xmlto -x MyStyle-spec-fo.xsl fo test-fo.xml
+	      /bin/mv -f test-fo.fo test.fo
+
+test.ps:      test.fo
+	      fop test.fo -ps test.ps
+
+test.pdf:     test.fo
+	      fop test.fo -pdf test.pdf
+
+test.html:    test-html.xml MyStyle-nochunk-html.xsl MyStyle-html.xsl MyStyle.xsl
+	      /bin/rm -rf test.html test-html.html
+	      xmlto -x MyStyle-nochunk-html.xsl html-nochunks test-html.xml
+	      /bin/mv -f test-html.html test.html
+
+test.txt:     test-txt.xml Tidytxt MyStyle-txt-html.xsl MyStyle-html.xsl MyStyle.xsl
+	      /bin/rm -rf test-txt.html
+	      xmlto -x MyStyle-txt-html.xsl html-nochunks test-txt.xml
+	      w3m -dump test-txt.html | Tidytxt >test.txt
+
+# I have not found a way of making docbook2texi write its output anywhere
+# other than the file name that it makes up. The --to-stdout option does not
+# work.
+
+test.info:    test-txt.xml
+	      docbook2texi test-txt.xml
+	      perl -ne 's/conceptindex/cindex/;s/optionindex/findex/;print;' \
+		<short_title.texi >test.texinfo
+	      /bin/rm -rf short_title.texi
+	      makeinfo -o test.info test.texinfo
+
+########################################################################
+
+
+################################ CLEAN #################################
+
+clean:; /bin/rm -rf exim.8 \
+	      filter*.xml spec*.xml test*.xml \
+	      *.fo *.html *.pdf *.ps \
+	      filter*.txt spec*.txt test*.txt \
+	      *.info* *.texinfo *.texi
+
+########################################################################