1 # $Cambridge: exim/doc/doc-docbook/Makefile,v 1.14 2010/05/28 15:38:18 nm4 Exp $
3 # Make file for Exim documentation from xfpt source.
5 notarget
:; @echo
"** You must specify a target, in the form x.y, where x is 'filter', 'spec',"
6 @echo
"** or 'test', and y is 'xml', 'fo', 'ps', 'pdf', 'html', 'txt', or 'info'."
7 @echo
"** One other possible target is 'exim.8'".
11 ############################# EVERYTHING ###############################
13 # Generate all the documentation files...
15 ## removed info files as I cannot generate them - spec.info filter.info
16 ## removed html files as superceded by new website code
17 everything
: spec.pdf spec.ps spec.txt \
18 filter.pdf
filter.ps
filter.txt \
21 ############################## MAN PAGE ################################
23 exim
.8: spec.xml x2man
26 ########################################################################
29 ############################### FILTER #################################
31 filter.xml
: filter.xfpt
34 filter-pr.xml
: filter.xml Pre-xml
35 .
/Pre-xml
-bookinfo
<filter.xml
>filter-pr.xml
37 filter-txt.xml
: filter.xml Pre-xml
38 .
/Pre-xml
-ascii
-html
-quoteliteral
<filter.xml
>filter-txt.xml
40 filter-info.xml
: filter.xml Pre-xml
41 .
/Pre-xml
-ascii
-html
<filter.xml
>filter-info.xml
43 filter.fo
: filter-pr.xml MyStyle-filter-fo.xsl MyStyle-fo.xsl MyStyle.xsl
44 /bin
/rm -rf
filter.fo filter-pr.fo
45 xmlto
-x MyStyle-filter-fo.xsl fo filter-pr.xml
46 /bin
/mv
-f filter-pr.fo
filter.fo
48 # Do not use pdf2ps from the PDF version; better PS is generated directly.
51 ### PS/PDF generation using fop
54 fop-filter.ps
: filter.fo
55 fop
filter.fo
-ps filter-tmp.ps
56 mv filter-tmp.ps
filter.ps
58 # Do not use ps2pdf from the PS version; better PDF is generated directly. It
59 # contains cross links etc.
61 fop-filter.pdf
: filter.fo PageLabelPDF
62 fop
filter.fo
-pdf filter-tmp.pdf
63 .
/PageLabelPDF
2 <filter-tmp.pdf
>filter.pdf
66 ### PS/PDF generation using SDoP
69 sdop-filter.ps
: filter-pr.xml
70 sdop
-o
filter.ps filter-pr.xml
72 sdop-filter.pdf
: filter.ps
73 ps2pdf
filter.ps
filter.pdf
76 ### PS/PDF default setting
79 filter.ps
: sdop-filter.ps
81 filter.pdf
: sdop-filter.pdf
86 filter.txt
: filter-txt.xml Tidytxt MyStyle-txt-html.xsl MyStyle-html.xsl \
88 /bin
/rm -rf filter-txt.html
89 xmlto
-x MyStyle-txt-html.xsl html-nochunks filter-txt.xml
90 w3m
-dump filter-txt.html | .
/Tidytxt
>filter.txt
91 .
/SanityTestText
filter.txt
93 # I have not found a way of making docbook2texi write its output anywhere
94 # other than the file name that it makes up. The --to-stdout option does not
97 filter.
info: filter-info.xml
98 docbook2texi filter-info.xml
99 perl
-ne
's/conceptindex/cindex/;s/optionindex/findex/;print;' \
100 <exim_filtering.texi | .
/Tidytxt
>filter.texinfo
101 /bin
/rm -rf exim_filtering.texi
102 makeinfo -o
filter.
info filter.texinfo
104 ########################################################################
107 ################################ SPEC ##################################
112 spec-pr.xml
: spec.xml Pre-xml
113 .
/Pre-xml
-optbreak
<spec.xml
>spec-pr.xml
115 spec-txt.xml
: spec.xml Pre-xml
116 .
/Pre-xml
-ascii
-html
-noindex
-quoteliteral \
117 <spec.xml
>spec-txt.xml
119 spec-info.xml
: spec.xml Pre-xml
120 .
/Pre-xml
-ascii
-html
-noindex
<spec.xml
>spec-info.xml
122 spec.fo
: spec-pr.xml MyStyle-spec-fo.xsl MyStyle-fo.xsl MyStyle.xsl \
124 /bin
/rm -rf spec.fo spec-pr.fo
125 xmlto
-x MyStyle-spec-fo.xsl fo spec-pr.xml
126 /bin
/mv
-f spec-pr.fo spec.fo
129 ### PS/PDF generation using fop
132 # Do not use pdf2ps from the PDF version; better PS is generated directly.
135 FOP_OPTS
=-Xmx512m fop spec.fo
-ps spec-tmp.ps
136 mv spec-tmp.ps spec.ps
138 # Do not use ps2pdf from the PS version; better PDF is generated directly. It
139 # contains cross links etc. We post-process it to add page label information
140 # so that the page identifiers shown by acroread are the correct page numbers.
142 fop-spec.pdf
: spec.fo PageLabelPDF
143 FOP_OPTS
=-Xmx512m fop spec.fo
-pdf spec-tmp.pdf
144 .
/PageLabelPDF
12 <spec-tmp.pdf
>spec.pdf
147 ### PS/PDF generation using SDoP
150 sdop-spec.ps
: spec-pr.xml
151 sdop
-o spec.ps spec-pr.xml
153 sdop-spec.pdf
: spec.ps
154 ps2pdf spec.ps spec.pdf
157 ### PS/PDF default setting
160 spec.ps
: sdop-spec.ps
162 spec.pdf
: sdop-spec.pdf
167 spec.txt
: spec-txt.xml Tidytxt MyStyle-txt-html.xsl MyStyle-html.xsl \
169 /bin
/rm -rf spec-txt.html
170 xmlto
-x MyStyle-txt-html.xsl html-nochunks spec-txt.xml
171 w3m
-dump spec-txt.html | .
/Tidytxt
>spec.txt
172 .
/SanityTestText spec.txt
174 # I have not found a way of making docbook2texi write its output anywhere
175 # other than the file name that it makes up. The --to-stdout option does not
178 spec.
info: spec-info.xml
179 docbook2texi spec-info.xml
180 .
/TidyInfo
<the_exim_mta.texi
>spec.texinfo
181 /bin
/rm -rf the_exim_mta.texi
182 makeinfo -o spec.
info --no-split spec.texinfo
184 ########################################################################
187 ################################ TEST ##################################
189 # These targets (similar to the above) are for running little tests.
194 test-pr.xml
: test.xml Pre-xml
195 .
/Pre-xml
<test.xml
>test-pr.xml
197 test-html.xml
: test.xml Pre-xml
198 .
/Pre-xml
-html
-oneindex
<test.xml
>test-html.xml
200 test-txt.xml
: test.xml Pre-xml
201 .
/Pre-xml
-ascii
-html
-noindex
-quoteinfo \
202 <test.xml
>test-txt.xml
204 test-info.xml
: test.xml Pre-xml
205 .
/Pre-xml
-ascii
-html
-noindex
<test.xml
>test-info.xml
207 test.fo
: test-pr.xml MyStyle-spec-fo.xsl MyStyle-fo.xsl MyStyle.xsl \
209 /bin
/rm -rf
test.fo test-pr.fo
210 xmlto
-x MyStyle-spec-fo.xsl fo test-pr.xml
211 /bin
/mv
-f test-pr.fo
test.fo
214 ### PS/PDF generation using fop
217 # Do not use pdf2ps from the PDF version; better PS is generated directly.
220 fop
test.fo
-ps test-tmp.ps
221 mv test-tmp.ps
test.ps
223 # Do not use ps2pdf from the PS version; better PDF is generated directly. It
224 # contains cross links etc.
226 fop-test.pdf
: test.fo
227 fop
test.fo
-pdf test-tmp.pdf
228 mv test-tmp.pdf
test.pdf
231 ### PS/PDF generation using SDoP
234 sdop-test.ps
: test-pr.xml
235 sdop
-o
test.ps test-pr.xml
237 sdop-test.pdf
: test.ps
238 ps2pdf
test.ps
test.pdf
241 ### PS/PDF default setting
244 test.ps
: sdop-test.ps
246 test.pdf
: sdop-test.pdf
252 test.txt
: test-txt.xml Tidytxt MyStyle-txt-html.xsl MyStyle-html.xsl \
254 /bin
/rm -rf test-txt.html
255 xmlto
-x MyStyle-txt-html.xsl html-nochunks test-txt.xml
256 w3m
-dump test-txt.html | Tidytxt
>test.txt
258 # I have not found a way of making docbook2texi write its output anywhere
259 # other than the file name that it makes up. The --to-stdout option does not
262 test.
info: test-info.xml
263 docbook2texi test-info.xml
264 .
/TidyInfo
<short_title.texi
>test.texinfo
265 /bin
/rm -rf short_title.texi
266 makeinfo -o
test.
info test.texinfo
268 ########################################################################
271 ############################## OS FIXUP ################################
273 # Yes, we've advanced so far in text processing that we now have to
274 # hardcode in complete paths and so become dependent upon exactly where
275 # files were installed for xsl:import. Which of course varies by OS.
280 ########################################################################
283 ################################ CLEAN #################################
285 clean:; /bin
/rm -rf exim
.8 \
286 filter*.xml spec
*.xml
test*.xml \
287 *.fo
*.html
*.pdf
*.ps \
288 filter*.txt spec
*.txt
test*.txt \
289 *.
info* *.texinfo
*.texi
291 ########################################################################