layout tweak
[exim.git] / doc / doc-docbook / Makefile
1 # $Cambridge: exim/doc/doc-docbook/Makefile,v 1.12 2007/12/01 15:53:55 nm4 Exp $
2
3 # Make file for Exim documentation from xfpt source.
4
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'".
8               exit 1
9
10
11 ############################# EVERYTHING ###############################
12 #
13 # Generate all the documentation files...
14 #
15 everything:             spec.pdf        spec.ps         spec.html       spec.info       spec.txt \
16                                 filter.pdf      filter.ps       filter.html filter.info filter.txt \
17                                 exim.8
18
19 ############################## MAN PAGE ################################
20
21 exim.8:       spec.xml x2man
22               ./x2man
23
24 ########################################################################
25
26
27 ############################### FILTER #################################
28
29 filter.xml:      filter.xfpt
30                  xfpt filter.xfpt
31
32 filter-pr.xml:   filter.xml Pre-xml
33                  ./Pre-xml -bookinfo <filter.xml >filter-pr.xml
34
35 filter-html.xml: filter.xml Pre-xml
36                  ./Pre-xml -html <filter.xml >filter-html.xml
37
38 filter-txt.xml:  filter.xml Pre-xml
39                  ./Pre-xml -ascii -html -quoteliteral <filter.xml >filter-txt.xml
40
41 filter-info.xml: filter.xml Pre-xml
42                  ./Pre-xml -ascii -html <filter.xml >filter-info.xml
43
44 filter.fo:       filter-pr.xml MyStyle-filter-fo.xsl MyStyle-fo.xsl MyStyle.xsl
45                  /bin/rm -rf filter.fo filter-pr.fo
46                  xmlto -x MyStyle-filter-fo.xsl fo filter-pr.xml
47                  /bin/mv -f filter-pr.fo filter.fo
48
49 # Do not use pdf2ps from the PDF version; better PS is generated directly.
50
51 ###
52 ### PS/PDF generation using fop
53 ###
54
55 fop-filter.ps:   filter.fo
56                  fop filter.fo -ps filter-tmp.ps
57                  mv filter-tmp.ps filter.ps
58
59 # Do not use ps2pdf from the PS version; better PDF is generated directly. It
60 # contains cross links etc.
61
62 fop-filter.pdf:  filter.fo PageLabelPDF
63                  fop filter.fo -pdf filter-tmp.pdf
64                  ./PageLabelPDF 2 <filter-tmp.pdf >filter.pdf
65
66 ###
67 ### PS/PDF generation using SDoP
68 ###
69
70 sdop-filter.ps:  filter-pr.xml
71                  sdop -o filter.ps filter-pr.xml
72
73 sdop-filter.pdf: filter.ps
74                  ps2pdf filter.ps filter.pdf
75
76 ###
77 ### PS/PDF default setting
78 ###
79
80 filter.ps:  sdop-filter.ps
81
82 filter.pdf: sdop-filter.pdf
83
84 ###
85 ###
86
87 filter.html:  filter-html.xml TidyHTML-filter MyStyle-nochunk-html.xsl \
88                 MyStyle-html.xsl MyStyle.xsl
89               /bin/rm -rf filter.html filter-html.html
90               xmlto -x MyStyle-nochunk-html.xsl html-nochunks filter-html.xml
91               /bin/mv -f filter-html.html filter.html
92               ./TidyHTML-filter
93
94 filter.txt:   filter-txt.xml Tidytxt MyStyle-txt-html.xsl MyStyle-html.xsl \
95                 MyStyle.xsl
96               /bin/rm -rf filter-txt.html
97               xmlto -x MyStyle-txt-html.xsl html-nochunks filter-txt.xml
98               w3m -dump filter-txt.html | ./Tidytxt >filter.txt
99
100 # I have not found a way of making docbook2texi write its output anywhere
101 # other than the file name that it makes up. The --to-stdout option does not
102 # work.
103
104 filter.info:  filter-info.xml
105               docbook2texi filter-info.xml
106               perl -ne 's/conceptindex/cindex/;s/optionindex/findex/;print;' \
107                 <exim_filtering.texi | ./Tidytxt >filter.texinfo
108               /bin/rm -rf exim_filtering.texi
109               makeinfo -o filter.info filter.texinfo
110
111 ########################################################################
112
113
114 ################################ SPEC ##################################
115
116 spec.xml:      spec.xfpt
117                xfpt spec.xfpt
118
119 spec-pr.xml:   spec.xml Pre-xml
120                ./Pre-xml -optbreak <spec.xml >spec-pr.xml
121
122 spec-html.xml: spec.xml Pre-xml
123                ./Pre-xml -html -oneindex \
124                  <spec.xml >spec-html.xml
125
126 spec-txt.xml:  spec.xml Pre-xml
127                ./Pre-xml -ascii -html -noindex -quoteliteral \
128                  <spec.xml >spec-txt.xml
129
130 spec-info.xml: spec.xml Pre-xml
131                ./Pre-xml -ascii -html -noindex <spec.xml >spec-info.xml
132
133 spec.fo:       spec-pr.xml MyStyle-spec-fo.xsl MyStyle-fo.xsl MyStyle.xsl \
134                MyTitleStyle.xsl
135                /bin/rm -rf spec.fo spec-pr.fo
136                xmlto -x MyStyle-spec-fo.xsl fo spec-pr.xml
137                /bin/mv -f spec-pr.fo spec.fo
138
139 ###
140 ### PS/PDF generation using fop
141 ###
142
143 # Do not use pdf2ps from the PDF version; better PS is generated directly.
144
145 fop-spec.ps:  spec.fo
146               FOP_OPTS=-Xmx512m fop spec.fo -ps spec-tmp.ps
147               mv spec-tmp.ps spec.ps
148
149 # Do not use ps2pdf from the PS version; better PDF is generated directly. It
150 # contains cross links etc. We post-process it to add page label information
151 # so that the page identifiers shown by acroread are the correct page numbers.
152
153 fop-spec.pdf: spec.fo PageLabelPDF
154               FOP_OPTS=-Xmx512m fop spec.fo -pdf spec-tmp.pdf
155               ./PageLabelPDF 12 <spec-tmp.pdf >spec.pdf
156
157 ###
158 ### PS/PDF generation using SDoP
159 ###
160
161 sdop-spec.ps:  spec-pr.xml
162                sdop -o spec.ps spec-pr.xml
163
164 sdop-spec.pdf: spec.ps
165                ps2pdf spec.ps spec.pdf
166
167 ###
168 ### PS/PDF default setting
169 ###
170
171 spec.ps:  sdop-spec.ps
172
173 spec.pdf: sdop-spec.pdf
174
175 ###
176 ###
177
178 spec.html:    spec-html.xml TidyHTML-spec MyStyle-chunk-html.xsl \
179                 MyStyle-html.xsl MyStyle.xsl
180               /bin/rm -rf spec_html
181               xmlto -x MyStyle-chunk-html.xsl -o spec_html html spec-html.xml
182               ./TidyHTML-spec
183
184 spec.txt:     spec-txt.xml Tidytxt MyStyle-txt-html.xsl MyStyle-html.xsl \
185                 MyStyle.xsl
186               /bin/rm -rf spec-txt.html
187               xmlto -x MyStyle-txt-html.xsl html-nochunks spec-txt.xml
188               w3m -dump spec-txt.html | ./Tidytxt >spec.txt
189
190 # I have not found a way of making docbook2texi write its output anywhere
191 # other than the file name that it makes up. The --to-stdout option does not
192 # work.
193
194 spec.info:    spec-info.xml
195               docbook2texi spec-info.xml
196               ./TidyInfo <the_exim_mta.texi >spec.texinfo
197               /bin/rm -rf the_exim_mta.texi
198               makeinfo -o spec.info --no-split spec.texinfo
199
200 ########################################################################
201
202
203 ################################ TEST ##################################
204
205 # These targets (similar to the above)  are for running little tests.
206
207 test.xml:     test.xfpt
208               xfpt test.xfpt
209
210 test-pr.xml:  test.xml Pre-xml
211               ./Pre-xml <test.xml >test-pr.xml
212
213 test-html.xml: test.xml Pre-xml
214               ./Pre-xml -html -oneindex <test.xml >test-html.xml
215
216 test-txt.xml: test.xml Pre-xml
217               ./Pre-xml -ascii -html -noindex -quoteinfo \
218                 <test.xml >test-txt.xml
219
220 test-info.xml: test.xml Pre-xml
221               ./Pre-xml -ascii -html -noindex <test.xml >test-info.xml
222
223 test.fo:      test-pr.xml MyStyle-spec-fo.xsl MyStyle-fo.xsl MyStyle.xsl \
224                 MyTitleStyle.xsl
225               /bin/rm -rf test.fo test-pr.fo
226               xmlto -x MyStyle-spec-fo.xsl fo test-pr.xml
227               /bin/mv -f test-pr.fo test.fo
228
229 ###
230 ### PS/PDF generation using fop
231 ###
232
233 # Do not use pdf2ps from the PDF version; better PS is generated directly.
234
235 fop-test.ps:  test.fo
236               fop test.fo -ps test-tmp.ps
237               mv test-tmp.ps test.ps
238
239 # Do not use ps2pdf from the PS version; better PDF is generated directly. It
240 # contains cross links etc.
241
242 fop-test.pdf: test.fo
243               fop test.fo -pdf test-tmp.pdf
244               mv test-tmp.pdf test.pdf
245
246 ###
247 ### PS/PDF generation using SDoP
248 ###
249
250 sdop-test.ps:  test-pr.xml
251                sdop -o test.ps test-pr.xml
252
253 sdop-test.pdf: test.ps
254                ps2pdf test.ps test.pdf
255
256 ###
257 ### PS/PDF default setting
258 ###
259
260 test.ps:  sdop-test.ps
261
262 test.pdf: sdop-test.pdf
263
264 ###
265 ###
266
267
268 test.html:    test-html.xml MyStyle-nochunk-html.xsl MyStyle-html.xsl \
269                 MyStyle.xsl
270               /bin/rm -rf test.html test-html.html
271               xmlto -x MyStyle-nochunk-html.xsl html-nochunks test-html.xml
272               /bin/mv -f test-html.html test.html
273
274 test.txt:     test-txt.xml Tidytxt MyStyle-txt-html.xsl MyStyle-html.xsl \
275                 MyStyle.xsl
276               /bin/rm -rf test-txt.html
277               xmlto -x MyStyle-txt-html.xsl html-nochunks test-txt.xml
278               w3m -dump test-txt.html | Tidytxt >test.txt
279
280 # I have not found a way of making docbook2texi write its output anywhere
281 # other than the file name that it makes up. The --to-stdout option does not
282 # work.
283
284 test.info:    test-info.xml
285               docbook2texi test-info.xml
286               ./TidyInfo <short_title.texi >test.texinfo
287               /bin/rm -rf short_title.texi
288               makeinfo -o test.info test.texinfo
289
290 ########################################################################
291
292
293 ################################ CLEAN #################################
294
295 clean:; /bin/rm -rf exim.8 \
296               filter*.xml spec*.xml test*.xml \
297               *.fo *.html *.pdf *.ps \
298               filter*.txt spec*.txt test*.txt \
299               *.info* *.texinfo *.texi
300
301 ########################################################################