X-Git-Url: https://git.exim.org/users/jgh/exim.git/blobdiff_plain/4aa45c318ef507a75ea0aa97e0241b866b966b24..8a06eed269a9756cc11cdbdb318f7272b9fa56c4:/doc/doc-docbook/Makefile diff --git a/doc/doc-docbook/Makefile b/doc/doc-docbook/Makefile index 875f4d9f6..07eb322fa 100644 --- a/doc/doc-docbook/Makefile +++ b/doc/doc-docbook/Makefile @@ -1,5 +1,3 @@ -# $Cambridge: exim/doc/doc-docbook/Makefile,v 1.10 2007/04/17 13:06:09 ph10 Exp $ - # Make file for Exim documentation from xfpt source. notarget:; @echo "** You must specify a target, in the form x.y, where x is 'filter', 'spec'," @@ -8,6 +6,16 @@ notarget:; @echo "** You must specify a target, in the form x.y, where x is ' exit 1 +############################# EVERYTHING ############################### +# +# Generate all the documentation files... +# +## removed info files as I cannot generate them - spec.info filter.info +## removed html files as superceded by new website code +everything: spec.pdf spec.ps spec.txt \ + filter.pdf filter.ps filter.txt \ + exim.8 + ############################## MAN PAGE ################################ exim.8: spec.xml x2man @@ -15,18 +23,27 @@ exim.8: spec.xml x2man ######################################################################## +.PHONY: local_params +local_params: + echo .macro version > $@ + echo $(EXIM_VER) >> $@ + echo .endmacro >> $@ + echo .macro fulldate >> $@ + date "+%d %b %Y" >> $@ + echo .endmacro >> $@ + echo .macro year >> $@ + date "+%Y" >> $@ + echo .endmacro >> $@ + ############################### FILTER ################################# -filter.xml: filter.xfpt +filter.xml: local_params filter.xfpt xfpt filter.xfpt filter-pr.xml: filter.xml Pre-xml ./Pre-xml -bookinfo filter-pr.xml -filter-html.xml: filter.xml Pre-xml - ./Pre-xml -html filter-html.xml - filter-txt.xml: filter.xml Pre-xml ./Pre-xml -ascii -html -quoteliteral filter-txt.xml @@ -76,18 +93,12 @@ filter.pdf: sdop-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 | ./Tidytxt >filter.txt + ./SanityTestText 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 @@ -96,7 +107,7 @@ filter.txt: filter-txt.xml Tidytxt MyStyle-txt-html.xsl MyStyle-html.xsl \ filter.info: filter-info.xml docbook2texi filter-info.xml perl -ne 's/conceptindex/cindex/;s/optionindex/findex/;print;' \ - filter.texinfo + filter.texinfo /bin/rm -rf exim_filtering.texi makeinfo -o filter.info filter.texinfo @@ -105,16 +116,12 @@ filter.info: filter-info.xml ################################ SPEC ################################## -spec.xml: spec.xfpt +spec.xml: local_params spec.xfpt xfpt spec.xfpt spec-pr.xml: spec.xml Pre-xml ./Pre-xml -optbreak spec-pr.xml -spec-html.xml: spec.xml Pre-xml - ./Pre-xml -html -oneindex \ - spec-html.xml - spec-txt.xml: spec.xml Pre-xml ./Pre-xml -ascii -html -noindex -quoteliteral \ spec-txt.xml @@ -167,17 +174,12 @@ spec.pdf: sdop-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 + ./SanityTestText 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 @@ -187,7 +189,7 @@ spec.info: spec-info.xml docbook2texi spec-info.xml ./TidyInfo spec.texinfo /bin/rm -rf the_exim_mta.texi - makeinfo -o spec.info spec.texinfo + makeinfo -o spec.info --no-split spec.texinfo ######################################################################## @@ -257,12 +259,6 @@ test.pdf: sdop-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 @@ -282,11 +278,24 @@ test.info: test-info.xml ######################################################################## +############################## OS FIXUP ################################ + +# Yes, we've advanced so far in text processing that we now have to +# hardcode in complete paths and so become dependent upon exactly where +# files were installed for xsl:import. Which of course varies by OS. + +os-fixup: + ./OS-Fixups + +######################################################################## + + ################################ CLEAN ################################# clean:; /bin/rm -rf exim.8 \ filter*.xml spec*.xml test*.xml \ - *.fo *.html *.pdf *.ps \ + *.fo *.pdf *.ps \ + filter*.html spec*.html test*.html \ filter*.txt spec*.txt test*.txt \ *.info* *.texinfo *.texi