summaryrefslogtreecommitdiff
path: root/doc/doc-docbook/Makefile
diff options
context:
space:
mode:
authorHeiko Schlittermann (HS12) <hs@schlittermann.de>2015-05-10 16:01:44 +0200
committerHeiko Schlittermann (HS12) <hs@schlittermann.de>2015-05-10 16:29:03 +0200
commit263c04a6b6ad8a18c9cdb7da847b695f0a8d6787 (patch)
tree47bc72014cf1fec21e0a96eb54411f5a0d4fe2a3 /doc/doc-docbook/Makefile
parentd2a2c69b7b97d080d63dfb434584d98eb3228332 (diff)
Docs: Make build unicode resistant
Force LC_ALL=C for spec.txt. Add an additional build target: spec.utf8.
Diffstat (limited to 'doc/doc-docbook/Makefile')
-rw-r--r--doc/doc-docbook/Makefile40
1 files changed, 28 insertions, 12 deletions
diff --git a/doc/doc-docbook/Makefile b/doc/doc-docbook/Makefile
index 14bea8e6b..f456f80c9 100644
--- a/doc/doc-docbook/Makefile
+++ b/doc/doc-docbook/Makefile
@@ -2,7 +2,7 @@
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
@@ -23,9 +23,17 @@ exim.8: spec.xml x2man
########################################################################
-.PHONY: local_params
-local_params:
- ./GenLocalParams $@
+# .PHONY doesn't work here, because it forces a rebuild of all dependend
+# 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 $$tmp $@
############################### FILTER #################################
@@ -88,7 +96,7 @@ 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
+ 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
@@ -107,8 +115,8 @@ filter.info: filter-info.xml
################################ SPEC ##################################
-spec.xml: local_params spec.xfpt
- xfpt spec.xfpt
+spec.xml: spec.xfpt local_params
+ xfpt $<
spec-pr.xml: spec.xml Pre-xml
./Pre-xml -optbreak <spec.xml >spec-pr.xml
@@ -165,13 +173,21 @@ 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
- xmlto -x MyStyle-txt-html.xsl html-nochunks spec-txt.xml
- w3m -dump spec-txt.html | ./Tidytxt >spec.txt
+spec-txt.html: spec-txt.xml \
+ MyStyle-txt-html.xsl MyStyle-html.xsl MyStyle.xsl
+ xmlto -x MyStyle-txt-html.xsl html-nochunks $<
+
+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; }
+ w3m -dump $< | ./Tidytxt -utf8 >$@
+
+spec.txt: spec-txt.html Tidytxt
+ LC_ALL=C w3m -dump $< | ./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.