docs infrastructure notes

[users/heiko/exim.git] / doc / doc-docbook / Makefile

diff --git a/doc/doc-docbook/Makefile b/doc/doc-docbook/Makefile
index ee97257b64d98915a0ceef7a9bbe7ae86a4ddb89..bc7a9b0ae73e98e8df68e0934c5119a5b78833c2 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
+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 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
 everything:            spec.pdf        spec.ps         spec.txt \
                                filter.pdf      filter.ps filter.txt \
                                exim.8


@@ -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 #################################
 


@@ -117,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


@@ -176,18 +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; }
                command -v w3m >/dev/null
 
 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 $< | ./Tidytxt -utf8 >$@
+               w3m -dump spec-txt.html | ./Tidytxt -utf8 >$@

 
 spec.txt: spec-txt.html Tidytxt
              command -v w3m >/dev/null
 
 spec.txt: spec-txt.html Tidytxt
              command -v w3m >/dev/null

-             LC_ALL=C w3m -dump $< | ./Tidytxt >$@
+             LC_ALL=C w3m -dump spec-txt.html | ./Tidytxt >$@

              ./SanityTestText spec.txt
 
 
              ./SanityTestText spec.txt