git://git.exim.org
/
exim.git
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
raw
|
inline
| side by side
Docs: tidying
[exim.git]
/
doc
/
doc-docbook
/
Makefile
diff --git
a/doc/doc-docbook/Makefile
b/doc/doc-docbook/Makefile
index f456f80c929c08bb75d69143bb8b9d89c80d3fed..fb3db4b968134cc7f23a7d97bf1be42352e64147 100644
(file)
--- a/
doc/doc-docbook/Makefile
+++ b/
doc/doc-docbook/Makefile
@@
-1,17
+1,21
@@
# Make file for Exim documentation from xfpt source.
# Make file for Exim documentation from xfpt source.
+# Copyright (c) The Exim Maintainers 2020 - 2021
+export LC_ALL=C
notarget:; @echo "** You must specify a target, in the form x.y, where x is 'filter', 'spec',"
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 "** or 'test', and y is 'xml', 'fo', 'ps', 'pdf', 'txt', or 'info'."
@echo "** One other possible targets 'exim.8', 'spec.utf8'".
exit 1
@echo "** One other possible targets 'exim.8', 'spec.utf8'".
exit 1
+# html used to be supported, but is not here since 50023e0551 (2010).
+# The website build script seems to handle it.
############################# EVERYTHING ###############################
#
# Generate all the documentation files...
#
## removed info files as I cannot generate them - spec.info filter.info
############################# EVERYTHING ###############################
#
# Generate all the documentation files...
#
## removed info files as I cannot generate them - spec.info filter.info
-## removed html files as super
c
eded by new website code
+## removed html files as super
s
eded by new website code
everything: spec.pdf spec.ps spec.txt \
filter.pdf filter.ps filter.txt \
exim.8
everything: spec.pdf spec.ps spec.txt \
filter.pdf filter.ps filter.txt \
exim.8
@@
-23,7
+27,7
@@
exim.8: spec.xml x2man
########################################################################
########################################################################
-# .PHONY doesn't work here, because it forces a rebuild of all dependen
d
+# .PHONY doesn't work here, because it forces a rebuild of all dependen
t
# targets, always. It sets the internal timestamp of its target to
# now().
# But it may happen that local_params does not change
# targets, always. It sets the internal timestamp of its target to
# now().
# But it may happen that local_params does not change
@@
-33,7
+37,7
@@
local_params: FORCE GenLocalParams
trap 'rm -f $$tmp' EXIT; \
tmp=`mktemp`; \
./GenLocalParams $$tmp; \
trap 'rm -f $$tmp' EXIT; \
tmp=`mktemp`; \
./GenLocalParams $$tmp; \
- cmp -s $@ $$tmp || mv $$tmp $@
+ cmp -s $@ $$tmp || mv
-f
$$tmp $@
############################### FILTER #################################
############################### FILTER #################################
@@
-96,6
+100,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
MyStyle.xsl
/bin/rm -rf filter-txt.html
xmlto -x MyStyle-txt-html.xsl html-nochunks filter-txt.xml
+ command -v w3m >/dev/null
LC_ALL=C w3m -dump filter-txt.html | ./Tidytxt >filter.txt
./SanityTestText filter.txt
LC_ALL=C w3m -dump filter-txt.html | ./Tidytxt >filter.txt
./SanityTestText filter.txt
@@
-116,7
+121,7
@@
filter.info: filter-info.xml
################################ SPEC ##################################
spec.xml: spec.xfpt local_params
################################ SPEC ##################################
spec.xml: spec.xfpt local_params
- xfpt
$<
+ xfpt
spec.xfpt
spec-pr.xml: spec.xml Pre-xml
./Pre-xml -optbreak <spec.xml >spec-pr.xml
spec-pr.xml: spec.xml Pre-xml
./Pre-xml -optbreak <spec.xml >spec-pr.xml
@@
-175,16
+180,18
@@
spec.pdf: sdop-spec.pdf
spec-txt.html: spec-txt.xml \
MyStyle-txt-html.xsl MyStyle-html.xsl MyStyle.xsl
spec-txt.html: spec-txt.xml \
MyStyle-txt-html.xsl MyStyle-html.xsl MyStyle.xsl
- xmlto -x MyStyle-txt-html.xsl html-nochunks
$<
+ xmlto -x MyStyle-txt-html.xsl html-nochunks
spec-txt.xml
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; }
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 >$@
+ command -v w3m >/dev/null
+ w3m -dump spec-txt.html | ./Tidytxt -utf8 >$@
spec.txt: spec-txt.html Tidytxt
spec.txt: spec-txt.html Tidytxt
- LC_ALL=C w3m -dump $< | ./Tidytxt >$@
+ command -v w3m >/dev/null
+ LC_ALL=C w3m -dump spec-txt.html | ./Tidytxt >$@
./SanityTestText spec.txt
./SanityTestText spec.txt
@@
-270,6
+277,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
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
w3m -dump test-txt.html | Tidytxt >test.txt
# I have not found a way of making docbook2texi write its output anywhere