doc/doc-docbook/Makefile

   1 # Make file for Exim documentation from xfpt source.
   2
   3 notarget:;    @echo "** You must specify a target, in the form x.y, where x is 'filter', 'spec',"
   4               @echo "** or 'test', and y is 'xml', 'fo', 'ps', 'pdf', 'html', 'txt', or 'info'."
   5               @echo "** One other possible targets 'exim.8', 'spec.utf8'".
   6               exit 1
   7
   8
   9 ############################# EVERYTHING ###############################
  10 #
  11 # Generate all the documentation files...
  12 #
  13 ## removed info files as I cannot generate them -  spec.info filter.info
  14 ## removed html files as superseded by new website code
  15 everything:             spec.pdf        spec.ps         spec.txt \
  16                                 filter.pdf      filter.ps filter.txt \
  17                                 exim.8
  18
  19 ############################## MAN PAGE ################################
  20
  21 exim.8:       spec.xml x2man
  22               ./x2man
  23
  24 ########################################################################
  25
  26 # .PHONY doesn't work here, because it forces a rebuild of all dependent
  27 # targets, always. It sets the internal timestamp of its target to
  28 # now().
  29 # But it may happen that local_params does not change
  30 FORCE:
  31 local_params: FORCE GenLocalParams
  32         @set -e; \
  33         trap 'rm -f $$tmp' EXIT; \
  34         tmp=`mktemp`; \
  35         ./GenLocalParams $$tmp; \
  36         cmp -s $@ $$tmp || mv -f $$tmp $@
  37
  38 ############################### FILTER #################################
  39
  40 filter.xml:      local_params filter.xfpt
  41                  xfpt filter.xfpt
  42
  43 filter-pr.xml:   filter.xml Pre-xml
  44                  ./Pre-xml -bookinfo <filter.xml >filter-pr.xml
  45
  46 filter-txt.xml:  filter.xml Pre-xml
  47                  ./Pre-xml -ascii -html -quoteliteral <filter.xml >filter-txt.xml
  48
  49 filter-info.xml: filter.xml Pre-xml
  50                  ./Pre-xml -ascii -html <filter.xml >filter-info.xml
  51
  52 filter.fo:       filter-pr.xml MyStyle-filter-fo.xsl MyStyle-fo.xsl MyStyle.xsl
  53                  /bin/rm -rf filter.fo filter-pr.fo
  54                  xmlto -x MyStyle-filter-fo.xsl fo filter-pr.xml
  55                  /bin/mv -f filter-pr.fo filter.fo
  56
  57 # Do not use pdf2ps from the PDF version; better PS is generated directly.
  58
  59 ###
  60 ### PS/PDF generation using fop
  61 ###
  62
  63 fop-filter.ps:   filter.fo
  64                  fop filter.fo -ps filter-tmp.ps
  65                  mv filter-tmp.ps filter.ps
  66
  67 # Do not use ps2pdf from the PS version; better PDF is generated directly. It
  68 # contains cross links etc.
  69
  70 fop-filter.pdf:  filter.fo PageLabelPDF
  71                  fop filter.fo -pdf filter-tmp.pdf
  72                  ./PageLabelPDF 2 <filter-tmp.pdf >filter.pdf
  73
  74 ###
  75 ### PS/PDF generation using SDoP
  76 ###
  77
  78 sdop-filter.ps:  filter-pr.xml
  79                  sdop -o filter.ps filter-pr.xml
  80
  81 sdop-filter.pdf: filter.ps
  82                  ps2pdf filter.ps filter.pdf
  83
  84 ###
  85 ### PS/PDF default setting
  86 ###
  87
  88 filter.ps:  sdop-filter.ps
  89
  90 filter.pdf: sdop-filter.pdf
  91
  92 ###
  93 ###
  94
  95 filter.txt:   filter-txt.xml Tidytxt MyStyle-txt-html.xsl MyStyle-html.xsl \
  96                 MyStyle.xsl
  97               /bin/rm -rf filter-txt.html
  98               xmlto -x MyStyle-txt-html.xsl html-nochunks filter-txt.xml
  99               command -v w3m >/dev/null
 100               LC_ALL=C w3m -dump filter-txt.html | ./Tidytxt >filter.txt
 101               ./SanityTestText filter.txt
 102
 103 # I have not found a way of making docbook2texi write its output anywhere
 104 # other than the file name that it makes up. The --to-stdout option does not
 105 # work.
 106
 107 filter.info:  filter-info.xml
 108               docbook2texi filter-info.xml
 109               perl -ne 's/conceptindex/cindex/;s/optionindex/findex/;print;' \
 110                 <exim_filtering.texi | ./Tidytxt >filter.texinfo
 111               /bin/rm -rf exim_filtering.texi
 112               makeinfo -o filter.info filter.texinfo
 113
 114 ########################################################################
 115
 116
 117 ################################ SPEC ##################################
 118
 119 spec.xml:      spec.xfpt local_params
 120                xfpt spec.xfpt
 121
 122 spec-pr.xml:   spec.xml Pre-xml
 123                ./Pre-xml -optbreak <spec.xml >spec-pr.xml
 124
 125 spec-txt.xml:  spec.xml Pre-xml
 126                ./Pre-xml -ascii -html -noindex -quoteliteral \
 127                  <spec.xml >spec-txt.xml
 128
 129 spec-info.xml: spec.xml Pre-xml
 130                ./Pre-xml -ascii -html -noindex <spec.xml >spec-info.xml
 131
 132 spec.fo:       spec-pr.xml MyStyle-spec-fo.xsl MyStyle-fo.xsl MyStyle.xsl \
 133                MyTitleStyle.xsl
 134                /bin/rm -rf spec.fo spec-pr.fo
 135                xmlto -x MyStyle-spec-fo.xsl fo spec-pr.xml
 136                /bin/mv -f spec-pr.fo spec.fo
 137
 138 ###
 139 ### PS/PDF generation using fop
 140 ###
 141
 142 # Do not use pdf2ps from the PDF version; better PS is generated directly.
 143
 144 fop-spec.ps:  spec.fo
 145               FOP_OPTS=-Xmx512m fop spec.fo -ps spec-tmp.ps
 146               mv spec-tmp.ps spec.ps
 147
 148 # Do not use ps2pdf from the PS version; better PDF is generated directly. It
 149 # contains cross links etc. We post-process it to add page label information
 150 # so that the page identifiers shown by acroread are the correct page numbers.
 151
 152 fop-spec.pdf: spec.fo PageLabelPDF
 153               FOP_OPTS=-Xmx512m fop spec.fo -pdf spec-tmp.pdf
 154               ./PageLabelPDF 12 <spec-tmp.pdf >spec.pdf
 155
 156 ###
 157 ### PS/PDF generation using SDoP
 158 ###
 159
 160 sdop-spec.ps:  spec-pr.xml
 161                sdop -o spec.ps spec-pr.xml
 162
 163 sdop-spec.pdf: spec.ps
 164                ps2pdf spec.ps spec.pdf
 165
 166 ###
 167 ### PS/PDF default setting
 168 ###
 169
 170 spec.ps:  sdop-spec.ps
 171
 172 spec.pdf: sdop-spec.pdf
 173
 174 ###
 175 ###
 176
 177 spec-txt.html:     spec-txt.xml \
 178                 MyStyle-txt-html.xsl MyStyle-html.xsl MyStyle.xsl
 179               xmlto -x MyStyle-txt-html.xsl html-nochunks spec-txt.xml
 180
 181 spec.utf8:      spec-txt.html Tidytxt
 182                 @grep -iq 'LC_CTYPE=.*utf-\?8' local_params || { \
 183                         echo 'your current locale does not support UTF-8' >&2; \
 184                         false; }
 185                 command -v w3m >/dev/null
 186                 w3m -dump spec-txt.html | ./Tidytxt -utf8 >$@
 187
 188 spec.txt: spec-txt.html Tidytxt
 189               command -v w3m >/dev/null
 190               LC_ALL=C w3m -dump spec-txt.html | ./Tidytxt >$@
 191               ./SanityTestText spec.txt
 192
 193
 194 # I have not found a way of making docbook2texi write its output anywhere
 195 # other than the file name that it makes up. The --to-stdout option does not
 196 # work.
 197
 198 spec.info:    spec-info.xml
 199               docbook2texi spec-info.xml
 200               ./TidyInfo <the_exim_mta.texi >spec.texinfo
 201               /bin/rm -rf the_exim_mta.texi
 202               makeinfo -o spec.info --no-split spec.texinfo
 203
 204 ########################################################################
 205
 206
 207 ################################ TEST ##################################
 208
 209 # These targets (similar to the above)  are for running little tests.
 210
 211 test.xml:     test.xfpt
 212               xfpt test.xfpt
 213
 214 test-pr.xml:  test.xml Pre-xml
 215               ./Pre-xml <test.xml >test-pr.xml
 216
 217 test-html.xml: test.xml Pre-xml
 218               ./Pre-xml -html -oneindex <test.xml >test-html.xml
 219
 220 test-txt.xml: test.xml Pre-xml
 221               ./Pre-xml -ascii -html -noindex -quoteinfo \
 222                 <test.xml >test-txt.xml
 223
 224 test-info.xml: test.xml Pre-xml
 225               ./Pre-xml -ascii -html -noindex <test.xml >test-info.xml
 226
 227 test.fo:      test-pr.xml MyStyle-spec-fo.xsl MyStyle-fo.xsl MyStyle.xsl \
 228                 MyTitleStyle.xsl
 229               /bin/rm -rf test.fo test-pr.fo
 230               xmlto -x MyStyle-spec-fo.xsl fo test-pr.xml
 231               /bin/mv -f test-pr.fo test.fo
 232
 233 ###
 234 ### PS/PDF generation using fop
 235 ###
 236
 237 # Do not use pdf2ps from the PDF version; better PS is generated directly.
 238
 239 fop-test.ps:  test.fo
 240               fop test.fo -ps test-tmp.ps
 241               mv test-tmp.ps test.ps
 242
 243 # Do not use ps2pdf from the PS version; better PDF is generated directly. It
 244 # contains cross links etc.
 245
 246 fop-test.pdf: test.fo
 247               fop test.fo -pdf test-tmp.pdf
 248               mv test-tmp.pdf test.pdf
 249
 250 ###
 251 ### PS/PDF generation using SDoP
 252 ###
 253
 254 sdop-test.ps:  test-pr.xml
 255                sdop -o test.ps test-pr.xml
 256
 257 sdop-test.pdf: test.ps
 258                ps2pdf test.ps test.pdf
 259
 260 ###
 261 ### PS/PDF default setting
 262 ###
 263
 264 test.ps:  sdop-test.ps
 265
 266 test.pdf: sdop-test.pdf
 267
 268 ###
 269 ###
 270
 271
 272 test.txt:     test-txt.xml Tidytxt MyStyle-txt-html.xsl MyStyle-html.xsl \
 273                 MyStyle.xsl
 274               /bin/rm -rf test-txt.html
 275               xmlto -x MyStyle-txt-html.xsl html-nochunks test-txt.xml
 276               command -v w3m >/dev/null
 277               w3m -dump test-txt.html | Tidytxt >test.txt
 278
 279 # I have not found a way of making docbook2texi write its output anywhere
 280 # other than the file name that it makes up. The --to-stdout option does not
 281 # work.
 282
 283 test.info:    test-info.xml
 284               docbook2texi test-info.xml
 285               ./TidyInfo <short_title.texi >test.texinfo
 286               /bin/rm -rf short_title.texi
 287               makeinfo -o test.info test.texinfo
 288
 289 ########################################################################
 290
 291
 292 ############################## OS FIXUP ################################
 293
 294 # Yes, we've advanced so far in text processing that we now have to
 295 # hardcode in complete paths and so become dependent upon exactly where
 296 # files were installed for xsl:import.  Which of course varies by OS.
 297
 298 os-fixup:
 299         ./OS-Fixups
 300
 301 ########################################################################
 302
 303
 304 ################################ CLEAN #################################
 305
 306 clean:; /bin/rm -rf exim.8 \
 307               filter*.xml spec*.xml test*.xml \
 308               *.fo *.pdf *.ps \
 309               filter*.html spec*.html test*.html \
 310               filter*.txt spec*.txt test*.txt \
 311               *.info* *.texinfo *.texi
 312
 313 ########################################################################