]> git.stg.codes - stg.git/blob - doc/xslt/tools/make/Makefile.DocBook
Adjusted XML RPC documentation.
[stg.git] / doc / xslt / tools / make / Makefile.DocBook
1 # $Source$
2 # $Author: xmldoc $
3 # $Date: 2008-03-03 01:20:29 -0800 (Mon, 03 Mar 2008) $
4 # $Revision: 7787 $
5 # vim: number
6 #
7 # -----------------------------------------------------------------
8 #  ** Makefile.DocBook -- generate output from DocBook sources **
9 # -----------------------------------------------------------------
10 #
11 #   This file is part of the DocBook Project XSL Stylesheet
12 #   distribution.
13 #
14 #   See http://docbook.sourceforge.net/release/xsl/current/
15 #   for copyright and other information.
16
17 # DOCBOOK_OUTPUT_FORMATS is the default set of targets (output
18 # formats) that get built when you type "make" without any targets
19 # explicitly specified. To generate a different set of output
20 # formats, change the value of DOCBOOK_OUTPUT_FORMATS here or set
21 # it in your environment; for example:
22 #
23 #   set DOCBOOK_OUTPUT_FORMATS="html pdf"; export DOCBOOK_OUTPUT_FORMATS
24 #
25 # Of course by explicitly specifying particular targets when you
26 # invoke "make", you can always override generation of the default
27 # set of targets; for example:
28 #
29 #   make html txt
30 #
31 # That would generate just HTML (unchunked) and plain-text output.
32 #
33 DOCBOOK_OUTPUT_FORMATS ?= xml man man-pdf chunk txt pdf
34
35 # If you want XHTML output instead of HTML, set HTML_OR_XHTML to
36 # 'xhtml' or just specify 'xhtml" in DOCBOOK_OUTPUT_FORMATS.
37 ifeq ($(findstring xhtml,$(DOCBOOK_OUTPUT_FORMATS)),)
38 HTML_OR_XHTML ?= html
39 else
40 HTML_OR_XHTML ?= xhtml
41 endif
42
43 # if your source is in asciidoc instead of DocBook, set
44 # ASCII_OR_DOCBOOK to "ascii"
45 ASCII_OR_DOCBOOK ?= docbook
46
47 # -----------------------------------------------------------------
48 #                *** TOOLS and other DEPENDENCIES ***
49 # -----------------------------------------------------------------
50 # we use rmdir(1) to remove dirs we create for chunked HTML output
51 RMDIR = rmdir
52 # "-p" causes empty parent dirs to be deleted as well
53 RMDIR_FLAGS = --ignore-fail-on-non-empty -p
54
55 # possible values for PDF_MAKER are:
56 #   dblatex|fop|xep|xmlroff|passivetex
57 PDF_MAKER = dblatex
58
59 # possible values for TXT_MAKER are:
60 #   links|lynx|w3m|w3mmee
61 TXT_MAKER = links
62 TXT_MAKER_FLAGS = -dump
63
64 # xsl
65 XSLT = xsltproc
66 XSLT_FLAGS = --xinclude
67
68 # http://dblatex.sourceforge.net/
69 DBLATEX = dblatex
70 DBLATEX_FLAGS = -b pdftex
71
72 FOP = fop
73 FOP_FLAGS =
74
75 XEP = xep
76 XEP_FLAGS =
77
78 # http://xmlroff.sourceforge.net/
79 XMLROFF = xmlroff
80 XMLROFF_FLAGS =
81
82 PDFTEX = pdftex
83 PDFTEX_FLAGS =
84
85 # used by PassiveTeX
86 PDFXMLTEX = pdfxmltex
87
88 # http://docbook2x.sourceforge.net/
89 DB2X_XSLTPROC = db2x_xsltproc
90 DB2X_XSLTPROC_FLAGS = 
91 DB2X_TEXIXML = db2x_texixml
92 DB2X_TEXIXML_FLAGS = 
93
94 # we call the man(1) command to generate "foo.N.pdf" and
95 # "foo.N.txt" output (see "man-pdf" & "man-txt" targets)
96 MAN = man
97 MAN_FLAGS =
98
99 # The "ps2pdf" command is part of GhostSript (gs) distro.
100 # It is just a wrapper script around gs that does this:
101 #
102 #   gs -dCompatibilityLevel=1.2 -q -dNOPAUSE -dBATCH -sDEVICE=pdfwrite \
103 #     "-sOutputFile=$outfile" -dCompatibilityLevel=1.2 -c .setpdfwrite -f "$infile"
104 #
105 # Where, for example: $outfile = foo.pdf and $infile = foo.1
106 PS2PDF = ps2pdf
107 PS2PDF_FLAGS =
108
109 # asciidoc is used to generate DocBook XML from asciidoc source
110 ASCIIDOC=asciidoc
111 ASCIIDOCFLAGS=
112
113 # asciidoc source seems to have DOS line endings, so we use
114 # DOS2UNIX to be able to grep them correctly
115 DOS2UNIX=dos2unix
116 DOS2UNIXFLAGS=
117
118 # The "col" command is needed for stripping backspaces and
119 # underscores from man(1) output to get pure plain-text
120 COL = col
121 COL_FLAGS =
122
123 # The "expand" command is needed for expanding tabs from files
124 # generated from "man foo.1 | col -b" output
125 # output to get pure plain-text
126 EXPAND = expand
127 EXPAND_FLAGS =
128
129 # value of DOCBOOK_XSL should either be the canonical
130 # (docbook.sourceforge.net) URL for the DocBook Project XSL
131 # stylesheets OR it can be a local system path
132 DOCBOOK_XSL = http://docbook.sourceforge.net/release/xsl/current
133
134 # -----------------------------------------------------------------
135 #       names of some DIRECTORIES and FILES we need
136 # -----------------------------------------------------------------
137 # We create a tmp directory once per make invocation; it's needed
138 # for holding a temporary copy of the custom DBLaTeX stylesheet
139 # (because dblatex currently can't read a stylesheet from stdin)
140 TMP ?= /tmp
141 TMPNUM := $(shell echo $$$$)
142 DOCBOOK_TMP := $(TMP)/docbook-make-$(TMPNUM)
143
144 # MAN_MANIFEST_EXT is file extension added to individual manifest
145 # files
146 MAN_MANIFEST_EXT = manifest_man
147
148 # HTML_MANIFEST_EXT is file extension added to HTML manifest files
149 HTML_MANIFEST_EXT = manifest_html
150
151 # BASEDIR_SUFFIX is a what you need to set if you want a suffix
152 # added to the end of each "base.dir" we create while generating
153 # chunked HTML output
154 #BASEDIR_SUFFIX = -html
155 #BASEDIR_SUFFIX = _html
156 BASEDIR_SUFFIX = 
157
158 # -----------------------------------------------------------------
159 #                        assorted OPTIONS
160 # -----------------------------------------------------------------
161 # HTML_STYLESHEET -> $html.stylesheet stylesheet param
162 # http://docbook.sourceforge.net/snapshots/xsl/doc/html/html.stylesheet.html
163 HTML_STYLESHEET = style.css
164 # HTML_IMAGES -> $admon.graphics.path
165 # http://docbook.sourceforge.net/snapshots/xsl/doc/html/admon.graphics.path.html
166 HTML_IMAGES = images/
167 # HTML_IMAGES_EXT -> $admon.graphics.extension
168 # http://docbook.sourceforge.net/snapshots/xsl/doc/html/admon.graphics.extension.html
169 HTML_IMAGES_EXT = .png
170
171 # use these to set params on the command-line
172 # format is, e.g., HTML_PARAMS="--stringparam variablelist.as.table 1..."
173 FO_PARAMS =
174 HTML_PARAMS =
175 MAN_PARAMS =
176
177 # DBX_PARAMS is for dblatex(1); format uses "-p":
178 # DBX_PARAMS="-p doc.publisher.show 1 -p term.breakline 1...
179 DBX_PARAMS=
180
181 # What file extension do you use for DocBook source files?
182 DOCBOOK_FILE_EXTENSION = .xml
183
184 # -----------------------------------------------------------------
185 #       make(1) functions for building file lists
186 # -----------------------------------------------------------------
187 #
188 #    the values of the following are used for determing what needs
189 #    to be built and/or cleaned up
190
191 ifeq ($(ASCII_OR_DOCBOOK),docbook)
192 SOURCE_FILES_DBK = $(wildcard *$(DOCBOOK_FILE_EXTENSION))
193 else
194 SOURCE_FILES_DBK = $(foreach base,$(basename $(wildcard *.txt)),$(base)$(DOCBOOK_FILE_EXTENSION))
195 endif
196
197 FILES_FO   = $(foreach base,$(basename $(SOURCE_FILES_DBK)),$(base).fo)
198 FILES_TXT  = $(foreach base,$(basename $(SOURCE_FILES_DBK)),$(base).out.txt)
199 FILES_PDF  = $(foreach base,$(basename $(SOURCE_FILES_DBK)),$(base).pdf)
200 FILES_LOG  = $(foreach base,$(basename $(SOURCE_FILES_DBK)),$(base).log)
201 FILES_OUT  = $(foreach base,$(basename $(SOURCE_FILES_DBK)),$(base).out)
202 FILES_AUX  = $(foreach base,$(basename $(SOURCE_FILES_DBK)),$(base).aux)
203 FILES_HTML = $(foreach base,$(basename $(SOURCE_FILES_DBK)),$(base).html)
204 FILES_INFO = $(foreach base,$(basename $(SOURCE_FILES_DBK)),$(base).info)
205 DIRS_CHUNK = $(foreach base,$(basename $(SOURCE_FILES_DBK)),$(base)$(BASEDIR_SUFFIX))
206 LISTS_HTML = $(foreach base,$(basename $(SOURCE_FILES_DBK)),$(base).$(HTML_MANIFEST_EXT))
207 LISTS_MAN  = $(foreach base,$(basename $(SOURCE_FILES_DBK)),$(base).$(MAN_MANIFEST_EXT))
208 FILES_CHNK = $(shell for manifest in $(LISTS_HTML); do if [ -f "$$manifest" ]; then cat $$manifest; fi done)
209 FILES_MAN  = $(shell for manifest in $(LISTS_MAN);  do if [ -f "$$manifest" ]; then cat $$manifest; fi done)
210 FILES_MANP = $(foreach base,$(FILES_MAN),$(base).man.pdf)
211 FILES_MANT = $(foreach base,$(FILES_MAN),$(base).out.txt)
212 DIRS_MAN   = $(shell for file in $(FILES_MAN); do dirname $$file; done | uniq)
213
214 # -----------------------------------------------------------------
215 #   ** stylesheet for testing whether a file has a refentry
216 # -----------------------------------------------------------------
217 REFENTRY_CHECK := <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" \
218                 version="1.0" \
219                 xmlns:db="http://docbook.org/ns/docbook" \
220                 > \
221   <xsl:output method="text"/> \
222   <xsl:template match="/"> \
223     <xsl:if test="//refentry|//db:refentry"> \
224       <xsl:text>true</xsl:text> \
225     </xsl:if> \
226   </xsl:template> \
227 </xsl:stylesheet>
228
229 # -----------------------------------------------------------------
230 #             ** Stylesheet Customization Layers ** 
231 # -----------------------------------------------------------------
232 #
233 # for DBLaTeX
234 DBX_CUSTOM := <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" \
235                  version="1.0"> \
236   <xsl:param name="co.linkends.show">0</xsl:param> \
237   <xsl:param name="callout.markup.circled">1</xsl:param> \
238   <xsl:param name="callout.linkends.hot">0</xsl:param> \
239   <xsl:param name="doc.publisher.show">1</xsl:param> \
240   <xsl:param name="term.breakline">1</xsl:param> \
241   <xsl:param name="doc.alignment">left</xsl:param> \
242   <xsl:param name="newtbl.use">1</xsl:param> \
243   <xsl:param name="latex.hyperparam"/> \
244   <xsl:param name="latex.style">docbook</xsl:param> \
245   <xsl:param name="latex.biblio.output">all</xsl:param> \
246   <xsl:param name="latex.bibfiles">""</xsl:param> \
247   <xsl:param name="latex.bibwidelabel">WIDELABEL</xsl:param> \
248   <xsl:param name="latex.output.revhistory">0</xsl:param> \
249   <xsl:param name="latex.figure.position">[htbp]</xsl:param> \
250   <xsl:param name="latex.figure.boxed">0</xsl:param> \
251   <xsl:param name="latex.babel.use">1</xsl:param> \
252   <xsl:param name="latex.babel.language"></xsl:param> \
253   <xsl:param name="latex.class.options">twoside</xsl:param> \
254   <xsl:param name="biblioentry.item.separator">, </xsl:param> \
255   <xsl:param name="refentry.xref.manvolnum">1</xsl:param> \
256   <xsl:param name="refsynopsis.title">Synopsis</xsl:param> \
257   <xsl:param name="refnamediv.title"></xsl:param> \
258   <xsl:param name="funcsynopsis.style">ansi</xsl:param> \
259   <xsl:param name="funcsynopsis.decoration">1</xsl:param> \
260   <xsl:param name="function.parens">0</xsl:param> \
261   <xsl:param name="classsynopsis.default.language">java</xsl:param> \
262   <xsl:param name="show.comments">0</xsl:param> \
263 </xsl:stylesheet>
264
265 # for FO output
266 FO_CUSTOM := <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" \
267                 xmlns:fo="http://www.w3.org/1999/XSL/Format" \
268                 version="1.0"> \
269   <xsl:import href="$(DOCBOOK_XSL)/fo/docbook.xsl"/> \
270   <xsl:param name="$(PDF_MAKER).extensions">1</xsl:param> \
271   <xsl:param name="paper.type">A4</xsl:param> \
272   <xsl:param name="draft.watermark.image"></xsl:param> \
273   <xsl:param name="hyphenation">false</xsl:param> \
274   <xsl:param name="hyphenate.verbatim">1</xsl:param> \
275   <xsl:param name="alignment">left</xsl:param> \
276   <xsl:param name="refentry.generate.name">1</xsl:param> \
277   <xsl:param name="refentry.generate.title">0</xsl:param> \
278   <xsl:param name="refentry.pagebreak">1</xsl:param> \
279   <xsl:param name="shade.verbatim">1</xsl:param> \
280   <xsl:param name="variablelist.as.blocks">1</xsl:param> \
281   <xsl:param name="ulink.show">1</xsl:param> \
282   <xsl:param name="ulink.footnotes">1</xsl:param> \
283   <xsl:param name="index.on.type">1</xsl:param> \
284   <xsl:attribute-set name="xref.properties"> \
285     <xsl:attribute name="color">blue</xsl:attribute> \
286   </xsl:attribute-set> \
287   <xsl:attribute-set name="shade.verbatim.style"> \
288     <xsl:attribute name="background-color">\#E0E0E0</xsl:attribute> \
289     <xsl:attribute name="padding-left">4pt</xsl:attribute> \
290     <xsl:attribute name="padding-right">4pt</xsl:attribute> \
291     <xsl:attribute name="padding-top">4pt</xsl:attribute> \
292     <xsl:attribute name="padding-bottom">4pt</xsl:attribute> \
293   </xsl:attribute-set> \
294   <xsl:attribute-set name="section.title.level1.properties"> \
295     <xsl:attribute name="font-size"> \
296       <xsl:value-of select="$$body.font.master * 1.5"></xsl:value-of> \
297       <xsl:text>pt</xsl:text> \
298     </xsl:attribute> \
299   </xsl:attribute-set> \
300   <xsl:attribute-set name="section.title.level2.properties"> \
301     <xsl:attribute name="font-size"> \
302       <xsl:value-of select="$$body.font.master * 1.3"></xsl:value-of> \
303       <xsl:text>pt</xsl:text> \
304     </xsl:attribute> \
305   </xsl:attribute-set> \
306   <xsl:attribute-set name="section.title.level3.properties"> \
307     <xsl:attribute name="font-size"> \
308       <xsl:value-of select="$$body.font.master * 1.1"></xsl:value-of> \
309       <xsl:text>pt</xsl:text> \
310     </xsl:attribute> \
311   </xsl:attribute-set> \
312   <xsl:attribute-set name="section.title.level4.properties"> \
313     <xsl:attribute name="font-size"> \
314       <xsl:value-of select="$$body.font.master"></xsl:value-of> \
315       <xsl:text>pt</xsl:text> \
316     </xsl:attribute> \
317   </xsl:attribute-set> \
318   <xsl:attribute-set name="component.title.properties"> \
319     <xsl:attribute name="font-size"> \
320       <xsl:value-of select="$$body.font.master * 1.5"></xsl:value-of> \
321       <xsl:text>pt</xsl:text> \
322     </xsl:attribute> \
323   </xsl:attribute-set> \
324   <xsl:attribute-set name="monospace.verbatim.properties"> \
325     <xsl:attribute name="wrap-option">wrap</xsl:attribute> \
326     <xsl:attribute name="hyphenation-character">\</xsl:attribute> \
327     <xsl:attribute name="font-size"> \
328       <xsl:value-of select="$$body.font.master * 0.8"></xsl:value-of> \
329       <xsl:text>pt</xsl:text> \
330     </xsl:attribute> \
331   </xsl:attribute-set> \
332 </xsl:stylesheet>
333
334 # for single-file (X)HTML outpout
335 HTML_CUSTOM := <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" \
336                 version="1.0"> \
337   <xsl:import href="$(DOCBOOK_XSL)/$(HTML_OR_XHTML)/docbook.xsl"/> \
338   <xsl:param name="gentext.custom">local.l10n.xml</xsl:param> \
339   <xsl:param name="local.l10n.xml" select="document($$gentext.custom)"/> \
340   <xsl:param name="refentry.generate.name">1</xsl:param> \
341   <xsl:param name="refentry.generate.title">0</xsl:param> \
342   <xsl:param name="root.filename"></xsl:param> \
343   <xsl:param name="variablelist.as.table">0</xsl:param> \
344   <xsl:param name="html.stylesheet">$(HTML_STYLESHEET)</xsl:param> \
345   <xsl:param name="admon.graphics">0</xsl:param> \
346   <xsl:param name="index.on.type">1</xsl:param> \
347 </xsl:stylesheet>
348
349 # for chunked (X)HTML output
350 CHNK_CUSTOM := <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" \
351                 version="1.0"> \
352   <xsl:import href="$(DOCBOOK_XSL)/$(HTML_OR_XHTML)/chunk.xsl"/> \
353   <xsl:param name="refentry.generate.name">0</xsl:param> \
354   <xsl:param name="refentry.generate.title">1</xsl:param> \
355   <xsl:param name="variablelist.as.table">0</xsl:param> \
356   <xsl:param name="html.stylesheet">$(HTML_STYLESHEET)</xsl:param> \
357   <xsl:param name="admon.graphics">1</xsl:param> \
358   <xsl:param name="admon.graphics.path">$(HTML_IMAGES)</xsl:param> \
359   <xsl:param name="admon.graphics.extension">$(HTML_IMAGES_EXT)</xsl:param> \
360   <xsl:param name="root.filename"></xsl:param> \
361   <xsl:param name="generate.manifest">1</xsl:param> \
362   <xsl:param name="use.id.as.filename">1</xsl:param> \
363   <xsl:param name="chunker.output.indent">yes</xsl:param> \
364   <xsl:param name="index.on.type">1</xsl:param> \
365 </xsl:stylesheet>
366
367 # for man-page output
368 MAN_CUSTOM := <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" \
369                 version="1.0"> \
370   <xsl:import href="$(DOCBOOK_XSL)/manpages/docbook.xsl"/> \
371   <xsl:param name="man.output.manifest.enabled" select="1"/> \
372   <xsl:param name="man.output.in.separate.dir" select="1"/> \
373   <xsl:param name="man.output.base.dir">man/</xsl:param> \
374   <xsl:param name="man.output.subdirs.enabled" select="1"/> \
375 </xsl:stylesheet>
376
377 # -----------------------------------------------------------------
378 #                  ** TARGETS START HERE ** 
379 # -----------------------------------------------------------------
380 #  prevents make from deleting, e.g. foo.1, after making foo.1.pdf
381 #  and foo.1.txt from it.
382 .PRECIOUS: %.1 %.2 %.3 %.4 %.5 %.6 %.7 %.8 %.9
383
384 docbook: $(DOCBOOK_OUTPUT_FORMATS)
385
386 xml: $(SOURCE_FILES_DBK)
387
388 man: $(LISTS_MAN)
389
390 # we can generate PDFs from man pages
391 man-pdf: man
392         $(MAKE) $(FILES_MANP)
393
394 # we can generate plain text from man pages
395 man-txt: man
396         $(MAKE) $(FILES_MANT)
397
398 html: $(FILES_HTML)
399
400 chunk: $(LISTS_HTML)
401
402 txt: $(FILES_TXT)
403
404 pdf: $(FILES_PDF)
405
406 info: $(FILES_INFO)
407
408 # use the "debug" target to echo variables, etc., to
409 # test/troubleshoot changes you make to this makefile
410 debug:
411         echo $(wildcard *$(DOCBOOK_FILE_EXTENSION))
412         echo $(ASCII_OR_DOCBOOK)
413         echo $(SOURCE_FILES_DBK)
414
415 # -----------------------------------------------------------------
416 #     pattern rule to make DocBook refentry from asciidoc source
417 # -----------------------------------------------------------------
418 %.1$(DOCBOOK_FILE_EXTENSION): %.1.txt
419         $(ASCIIDOC) $(ASCIIDOCFLAGS) -d manpage -b docbook $<
420
421 %.2$(DOCBOOK_FILE_EXTENSION): %.2.txt
422         $(ASCIIDOC) $(ASCIIDOCFLAGS) -d manpage -b docbook $<
423
424 %.3$(DOCBOOK_FILE_EXTENSION): %.3.txt
425         $(ASCIIDOC) $(ASCIIDOCFLAGS) -d manpage -b docbook $<
426
427 %.4$(DOCBOOK_FILE_EXTENSION): %.4.txt
428         $(ASCIIDOC) $(ASCIIDOCFLAGS) -d manpage -b docbook $<
429
430 %.5$(DOCBOOK_FILE_EXTENSION): %.5.txt
431         $(ASCIIDOC) $(ASCIIDOCFLAGS) -d manpage -b docbook $<
432
433 %.6$(DOCBOOK_FILE_EXTENSION): %.6.txt
434         $(ASCIIDOC) $(ASCIIDOCFLAGS) -d manpage -b docbook $<
435
436 %.7$(DOCBOOK_FILE_EXTENSION): %.7.txt
437         $(ASCIIDOC) $(ASCIIDOCFLAGS) -d manpage -b docbook $<
438
439 %.8$(DOCBOOK_FILE_EXTENSION): %.8.txt
440         $(ASCIIDOC) $(ASCIIDOCFLAGS) -d manpage -b docbook $<
441
442 %.9$(DOCBOOK_FILE_EXTENSION): %.9.txt
443         $(ASCIIDOC) $(ASCIIDOCFLAGS) -d manpage -b docbook $<
444
445 # -----------------------------------------------------------------
446 #     pattern rule to make DocBook article from asciidoc source
447 # -----------------------------------------------------------------
448 %$(DOCBOOK_FILE_EXTENSION): %.txt
449         export LINECOUNT1=$$(cat $< | $(DOS2UNIX) $(DOS2UNIXFLAGS) | egrep "^=+$$" | wc -l); \
450         export LINECOUNT2=$$(cat $< | $(DOS2UNIX) $(DOS2UNIXFLAGS) | egrep "^= $$" | wc -l); \
451         if [[ $$LINECOUNT1 > 1 || $$LINECOUNT2 > 1 ]]; then \
452         $(ASCIIDOC) $(ASCIIDOCFLAGS) -d book -b docbook $<; \
453         else \
454         $(ASCIIDOC) $(ASCIIDOCFLAGS) -b docbook $<; \
455         fi
456
457 # -----------------------------------------------------------------
458 #     pattern rule for making (X)HTML and plain-text output
459 # -----------------------------------------------------------------
460 %.html: %$(DOCBOOK_FILE_EXTENSION)
461         @echo '$(HTML_CUSTOM)' | $(XSLT) $(XSLT_FLAGS) $(HTML_PARAMS) - $< > $@
462
463 %.out.txt: %.html
464         $(TXT_MAKER) $(TXT_MAKER_FLAGS) ./$< \
465           | sed "s/^\(\s\+[0-9]\+\. \)file:\/\/.\+$$/\\1(local)/g" \
466           | egrep -v '^ file:///.+$$' \
467           > $@
468 # if DOCBOOK_OUTPUT_FORMATS does not contain "html", then we need
469 # to remove the "intermediate" HTML files we used for generating
470 # plain-text output
471 ifeq ($(findstring html,$(DOCBOOK_OUTPUT_FORMATS)),)
472         $(RM) $<
473 endif
474
475 # -----------------------------------------------------------------
476 #     pattern rule for making chunked (X)HTML pages
477 # -----------------------------------------------------------------
478 %.$(HTML_MANIFEST_EXT): %$(DOCBOOK_FILE_EXTENSION)
479         @echo '$(CHNK_CUSTOM)' | $(XSLT) $(XSLT_FLAGS) $(HTML_PARAMS) \
480         --stringparam manifest $@  \
481         --stringparam base.dir $(basename $@)$(BASEDIR_SUFFIX)/  \
482         - $< 
483
484 # -----------------------------------------------------------------
485 #     pattern rules for making FO and PDF stuff
486 # -----------------------------------------------------------------
487 %.fo: %$(DOCBOOK_FILE_EXTENSION)
488         @echo '$(FO_CUSTOM)' \
489           | $(XSLT) $(XSLT_FLAGS) $(FO_PARAMS) - $< > $@
490
491 ifeq ($(PDF_MAKER),dblatex)
492 %.pdf: %$(DOCBOOK_FILE_EXTENSION)
493         mkdir -p $(DOCBOOK_TMP)
494         echo '$(DBX_CUSTOM)' > $(DOCBOOK_TMP)/dblatex.xsl
495         -$(DBLATEX) $(DBLATEX_FLAGS)\
496           -p $(DOCBOOK_TMP)/dblatex.xsl \
497           -o $@ \
498           $<
499         $(RM) -r $(DOCBOOK_TMP)
500 endif
501
502 %.pdf: %.fo
503 ifeq ($(PDF_MAKER),)
504         $(error No PDF_MAKER specified. Cannot make pdf)
505 else
506 ifeq ($(PDF_MAKER),xep)
507         $(XEP) $(XEP_FLAGS) $< $@
508 else
509 ifeq ($(PDF_MAKER),fop)
510         $(FOP) $(FOP_FLAGS) $< $@
511 else
512 ifeq ($(PDF_MAKER),xmlroff)
513         $(XMLROFF) $(XMLROFF_FLAGS) $< -o $@
514 else
515 ifeq ($(PDF_MAKER),passivetex)
516         $(PDFTEX) $(PDFTEX_FLAGS) &$(PDFXMLTEX) $<
517         @if [ `egrep Rerun $(basename $@).log | wc -l` -gt 0 ]; then \
518                 $(PDFTEX) $(PDFTEX_FLAGS) &$(PDFXMLTEX) $< ; \
519         fi
520         @if [ `egrep Rerun $(basename $@).log | wc -l` -gt 0 ]; then \
521                 $(PDFTEX) $(PDFTEX_FLAGS) &$(PDFXMLTEX) $< ; \
522         fi
523         $(RM) $(basename $@).log
524         $(RM) $(basename $@).aux
525         $(RM) $(basename $@).out
526 else
527         $(error I do not know how to make a PDF using "$(PDF_MAKER)")
528 endif
529 endif
530 endif
531 endif
532 endif
533
534 # -----------------------------------------------------------------
535 #     pattern rules for making TeXinfo stuff
536 # -----------------------------------------------------------------
537 %.txml: %$(DOCBOOK_FILE_EXTENSION)
538         $(DB2X_XSLTPROC) $(DB2X_XSLTPROC_FLAGS) -s texi -o $@ $<
539
540 %.texi: %.txml
541         $(DB2X_TEXIXML) $(DB2X_TEXIXML_FLAGS) $<
542
543 # the following is actually a built-in rule, but it's redefined
544 # here just for the sake of clarity
545 %.info: %.texi
546         $(MAKEINFO) $(MAKEINFO_FLAGS) $< -o $@
547
548 # -----------------------------------------------------------------
549 #     pattern rule for making man pages
550 # -----------------------------------------------------------------
551 %.$(MAN_MANIFEST_EXT): %$(DOCBOOK_FILE_EXTENSION)
552         @if [ "$(strip $(shell echo '$(REFENTRY_CHECK)' | $(XSLT) $(XSLT_FLAGS) - $<))" != "true" ]; then \
553           touch $@; \
554         else \
555           echo '$(MAN_CUSTOM)' \
556           | $(XSLT) $(XSLT_FLAGS) $(MAN_PARAMS) \
557             --stringparam man.output.manifest.filename $@ \
558             - $<; \
559         fi
560
561 # -----------------------------------------------------------------
562 #  pattern rule for enabling direct "make foo.1" to work
563 # -----------------------------------------------------------------
564
565 %.1 %.2 %.3 %.4 %.5 %.6 %.7: %.xml
566         $(MAKE) $(basename $<).$(MAN_MANIFEST_EXT)
567
568 # -----------------------------------------------------------------
569 #  pattern rules for making Postscript/PDF output from man pages
570 # -----------------------------------------------------------------
571 %.1.man.ps: %.1
572         $(MAN) -l $(MAN_FLAGS) -Tps $< > $@
573
574 %.2.man.ps: %.2
575         $(MAN) -l $(MAN_FLAGS) -Tps $< > $@
576
577 %.3.man.ps: %.3
578         $(MAN) -l $(MAN_FLAGS) -Tps $< > $@
579
580 %.4.man.ps: %.4
581         $(MAN) -l $(MAN_FLAGS) -Tps $< > $@
582
583 %.5.man.ps: %.5
584         $(MAN) -l $(MAN_FLAGS) -Tps $< > $@
585
586 %.6.man.ps: %.6
587         $(MAN) -l $(MAN_FLAGS) -Tps $< > $@
588
589 %.7.man.ps: %.7
590         $(MAN) -l $(MAN_FLAGS) -Tps $< > $@
591
592 %.8.man.ps: %.8
593         $(MAN) -l $(MAN_FLAGS) -Tps $< > $@
594
595 %.9.man.ps: %.9
596         $(MAN) -l $(MAN_FLAGS) -Tps $< > $@
597
598 # -----------------------------------------------------------------
599 #  pattern rule for converting Postscript to PDF
600 # -----------------------------------------------------------------
601 %.pdf: %.ps
602         $(PS2PDF) $(PS2PDF_FLAGS) $<
603
604 # -----------------------------------------------------------------
605 #  pattern rules for making plain-text output from man pages
606 # -----------------------------------------------------------------
607 %.1.out.txt: %.1
608         $(MAN) -l $(MAN_FLAGS) -Tascii $< | $(COL) -b $(COL_FLAGS) | $(EXPAND) $(EXPAND_FLAGS) > $@
609
610 %.2.out.txt: %.2
611         $(MAN) -l $(MAN_FLAGS) -Tascii $< | $(COL) -b $(COL_FLAGS) | $(EXPAND) $(EXPAND_FLAGS) > $@
612
613 %.3.out.txt: %.3
614         $(MAN) -l $(MAN_FLAGS) -Tascii $< | $(COL) -b $(COL_FLAGS) | $(EXPAND) $(EXPAND_FLAGS) > $@
615
616 %.4.out.txt: %.4
617         $(MAN) -l $(MAN_FLAGS) -Tascii $< | $(COL) -b $(COL_FLAGS) | $(EXPAND) $(EXPAND_FLAGS) > $@
618
619 %.5.out.txt: %.5
620         $(MAN) -l $(MAN_FLAGS) -Tascii $< | $(COL) -b $(COL_FLAGS) | $(EXPAND) $(EXPAND_FLAGS) > $@
621
622 %.6.out.txt: %.6
623         $(MAN) -l $(MAN_FLAGS) -Tascii $< | $(COL) -b $(COL_FLAGS) | $(EXPAND) $(EXPAND_FLAGS) > $@
624
625 %.7.out.txt: %.7
626         $(MAN) -l $(MAN_FLAGS) -Tascii $< | $(COL) -b $(COL_FLAGS) | $(EXPAND) $(EXPAND_FLAGS) > $@
627
628 %.8.out.txt: %.8
629         $(MAN) -l $(MAN_FLAGS) -Tascii $< | $(COL) -b $(COL_FLAGS) | $(EXPAND) $(EXPAND_FLAGS) > $@
630
631 %.9.out.txt: %.9
632         $(MAN) -l $(MAN_FLAGS) -Tascii $< | $(COL) -b $(COL_FLAGS) | $(EXPAND) $(EXPAND_FLAGS) > $@
633
634 # -----------------------------------------------------------------
635 #   target(s) for cleaning up the mess
636 # -----------------------------------------------------------------
637 clean:
638 ifneq ($(FILES_TXT),)
639         $(RM) $(FILES_TXT)
640 endif
641 ifneq ($(FILES_PDF),)
642         $(RM) $(FILES_PDF)
643 endif
644 ifneq ($(FILES_FO),)
645         $(RM) $(FILES_FO)
646 endif
647 ifneq ($(FILES_LOG),)
648         $(RM) $(FILES_LOG)
649 endif
650 ifneq ($(FILES_OUT),)
651         $(RM) $(FILES_OUT)
652 endif
653 ifneq ($(FILES_AUX),)
654         $(RM) $(FILES_AUX)
655 endif
656 ifneq ($(FILES_HTML),)
657         $(RM) $(FILES_HTML)
658 endif
659 ifneq ($(FILES_CHNK),)
660         $(RM) $(FILES_CHNK)
661 endif
662 ifneq ($(FILES_MAN),)
663         $(RM) $(FILES_MAN)
664 endif
665 ifneq ($(FILES_MANT),)
666         $(RM) $(FILES_MANT)
667 endif
668 ifneq ($(FILES_MANP),)
669         $(RM) $(FILES_MANP)
670 endif
671 ifneq ($(FILES_INFO),)
672         $(RM) $(FILES_INFO)
673 endif
674 ifneq ($(DIRS_CHUNK),)
675         for dir in $(DIRS_CHUNK); do \
676           if [ -d "$$dir" ]; then \
677             $(RMDIR) $(RMDIR_FLAGS) $$dir; \
678           fi \
679         done
680 endif
681 ifneq ($(DIRS_MAN),)
682 ifneq ($(DIRS_MAN),.)
683         for dir in $(DIRS_MAN); do \
684           if [ -d "$$dir" ]; then \
685             $(RMDIR) $(RMDIR_FLAGS) $$dir; \
686           fi \
687         done
688 endif
689 endif
690 ifneq ($(LISTS_MAN),)
691         $(RM) $(LISTS_MAN)
692 endif
693 ifneq ($(LISTS_HTML),)
694         $(RM) $(LISTS_HTML)
695 endif
696 ifneq ($(ASCII_OR_DOCBOOK),docbook)
697         $(RM) -i $(SOURCE_FILES_DBK)
698 endif