X-Git-Url: https://vcs.fsf.org/?p=exim.git;a=blobdiff_plain;f=doc%2Fdoc-docbook%2FMakefile;h=97f30f1e1ae92f90ecf6049f7acb5f03942a8795;hp=07eb322fa3003e7778fa17b1bdc106ffacf34a33;hb=1e1ddfac79fbcd052f199500a6493c7f79cb8462;hpb=2aee48d6f2a6526fffe18cd619fde9693f400034 diff --git a/doc/doc-docbook/Makefile b/doc/doc-docbook/Makefile index 07eb322fa..97f30f1e1 100644 --- a/doc/doc-docbook/Makefile +++ b/doc/doc-docbook/Makefile @@ -1,8 +1,10 @@ # Make file for Exim documentation from xfpt source. +# Copyright (c) The Exim Maintainers 2020 +export LC_ALL=C 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'". + @echo "** One other possible targets 'exim.8', 'spec.utf8'". exit 1 @@ -11,7 +13,7 @@ notarget:; @echo "** You must specify a target, in the form x.y, where x is ' # 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 +## removed html files as superseded by new website code everything: spec.pdf spec.ps spec.txt \ filter.pdf filter.ps filter.txt \ exim.8 @@ -23,18 +25,17 @@ 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 >> $@ - +# .PHONY doesn't work here, because it forces a rebuild of all dependent +# targets, always. It sets the internal timestamp of its target to +# now(). +# But it may happen that local_params does not change +FORCE: +local_params: FORCE GenLocalParams + @set -e; \ + trap 'rm -f $$tmp' EXIT; \ + tmp=`mktemp`; \ + ./GenLocalParams $$tmp; \ + cmp -s $@ $$tmp || mv -f $$tmp $@ ############################### FILTER ################################# @@ -97,7 +98,8 @@ 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 + command -v w3m >/dev/null + LC_ALL=C w3m -dump filter-txt.html | ./Tidytxt >filter.txt ./SanityTestText filter.txt # I have not found a way of making docbook2texi write its output anywhere @@ -116,7 +118,7 @@ filter.info: filter-info.xml ################################ SPEC ################################## -spec.xml: local_params spec.xfpt +spec.xml: spec.xfpt local_params xfpt spec.xfpt spec-pr.xml: spec.xml Pre-xml @@ -174,13 +176,23 @@ spec.pdf: sdop-spec.pdf ### ### -spec.txt: spec-txt.xml Tidytxt MyStyle-txt-html.xsl MyStyle-html.xsl \ - MyStyle.xsl - /bin/rm -rf spec-txt.html +spec-txt.html: spec-txt.xml \ + MyStyle-txt-html.xsl MyStyle-html.xsl MyStyle.xsl xmlto -x MyStyle-txt-html.xsl html-nochunks spec-txt.xml - w3m -dump spec-txt.html | ./Tidytxt >spec.txt + +spec.utf8: spec-txt.html Tidytxt + @grep -iq 'LC_CTYPE=.*utf-\?8' local_params || { \ + echo 'your current locale does not support UTF-8' >&2; \ + false; } + command -v w3m >/dev/null + w3m -dump spec-txt.html | ./Tidytxt -utf8 >$@ + +spec.txt: spec-txt.html Tidytxt + command -v w3m >/dev/null + LC_ALL=C w3m -dump spec-txt.html | ./Tidytxt >$@ ./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 # work. @@ -263,6 +275,7 @@ 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 + command -v w3m >/dev/null w3m -dump test-txt.html | Tidytxt >test.txt # I have not found a way of making docbook2texi write its output anywhere