Makefile 5.86 KB
Newer Older
1 2 3 4 5 6 7 8 9 10
#----------------------------------------------------------------------------
#
# Makefile
#	Postgres documentation makefile
#	Thomas Lockhart
#
# Copyright (c) 1994, Regents of the University of California
#
#
# IDENTIFICATION
11
#    $Header: /cvsroot/pgsql/doc/src/sgml/Makefile,v 1.51 2002/08/05 19:43:30 petere Exp $
12 13
#
#----------------------------------------------------------------------------
14

15 16
subdir = doc/src/sgml
top_builddir = ../../..
17
include $(top_builddir)/src/Makefile.global
18

19
.SECONDARY:
20
.NOTPARALLEL:
21

22 23
ifndef COLLATEINDEX
COLLATEINDEX = $(DOCBOOKSTYLE)/bin/collateindex.pl
24 25
endif

26 27 28
ifndef JADE
JADE = jade
endif
29
SGMLINCLUDE = -D $(srcdir) -D $(srcdir)/ref
30 31 32 33 34 35 36 37

ifndef NSGMLS
NSGMLS = nsgmls
endif

ifndef SGMLSPL
SGMLSPL = sgmlspl
endif
38

39 40 41
CONVERT = convert
EPSTOPDF = epstopdf

42

43 44
# docbook2man generates man pages from docbook refentry source code.

45 46
ifndef D2MDIR
# This is where the (patched) docbook2man perl scripts reside on hub.org.
47
D2MDIR= /home/users/t/thomas/d2x/docbook2man
48
endif
49 50
D2MSCRIPT= $(D2MDIR)/docbook2man-spec.pl

51
vpath %.sgml ./ref
52

53
ALLBOOKS = admin developer programmer reference tutorial user
54

55
ALLSGML := $(wildcard $(srcdir)/*.sgml $(srcdir)/ref/*.sgml) bookindex.sgml setindex.sgml
56

57 58 59
ifdef DOCBOOKSTYLE
CATALOG = -c $(DOCBOOKSTYLE)/catalog
endif
60

61 62 63 64 65
# Enable draft mode during development
ifneq (,$(findstring devel, $(VERSION)))
JADEFLAGS += -V draft-mode
endif

66

67 68 69
##
## Man pages
##
70

71
.PHONY: man
72

73
DEFAULTSECTION := $(sqlmansect_dummy)
74

75 76
man: $(ALLSGML)
	$(NSGMLS) $(NSGMLS_FLAGS) $(srcdir)/book-decl.sgml $(srcdir)/reference.sgml \
77
	  | $(SGMLSPL) $(D2MSCRIPT) --lowercase --section $(DEFAULTSECTION) --date "`date '+%Y-%m-%d'`"
78 79
# One more time, to resolve cross-references
	$(NSGMLS) $(NSGMLS_FLAGS) $(srcdir)/book-decl.sgml $(srcdir)/reference.sgml \
80
	  | $(SGMLSPL) $(D2MSCRIPT) --lowercase --section $(DEFAULTSECTION) --date "`date '+%Y-%m-%d'`"
81 82 83
	$(mkinstalldirs) man1 man$(DEFAULTSECTION)
	mv *.1 man1/
	mv *.$(DEFAULTSECTION) man$(DEFAULTSECTION)/
84

85 86 87 88 89

##
## HTML
##

90
JADE.html = $(JADE) $(JADEFLAGS) $(SGMLINCLUDE) $(CATALOG) -d stylesheet.dsl -i output-html -t sgml
91

92
postgres.html: postgres.sgml $(ALLSGML) stylesheet.dsl
93
	@rm -f *.html
94
	$(JADE.html) $<
95
	ln -sf index.html $@
96

97
$(addsuffix .html, $(ALLBOOKS)): %.html: %.sgml $(ALLSGML) stylesheet.dsl
98
	@rm -f *.html
99
	$(JADE.html) book-decl.sgml $<
100 101 102
	ln -sf index.html $@

programmer.html: catalogs.gif connections.gif
103
postgres.html: catalogs.gif connections.gif
104

105

106
COLLATEINDEX := $(PERL) $(COLLATEINDEX) -f -g -t 'Index'
107 108 109 110

ifeq (,$(wildcard HTML.index))
bookindex.sgml:
	$(COLLATEINDEX) -o $@ -N
111

112 113 114 115 116
setindex.sgml:
	$(COLLATEINDEX) -x -o $@ -N
else
bookindex.sgml: HTML.index
	$(COLLATEINDEX) -i 'bookindex' -o $@ $<
117

118 119 120 121
setindex.sgml: HTML.index
	$(COLLATEINDEX) -i 'setindex' -x -o $@ $<
endif

122

123 124 125
##
## Print
##
126

127
# RTF to allow minor editing for hardcopy
128
$(addsuffix .rtf, $(ALLBOOKS)): %.rtf: %.sgml $(ALLSGML) stylesheet.dsl
129
	$(JADE) $(JADEFLAGS) $(SGMLINCLUDE) $(CATALOG) -d stylesheet.dsl -t rtf -V rtf-backend -i output-print book-decl.sgml $<
130

131 132 133 134 135
# TeX
# Regular TeX and pdfTeX have slightly differing requirements, so we
# need to distinguish the path we're taking.

$(addsuffix .tex-ps, $(ALLBOOKS)): %.tex-ps: %.sgml $(ALLSGML) stylesheet.dsl
136
	$(JADE) $(JADEFLAGS) $(SGMLINCLUDE) $(CATALOG) -d stylesheet.dsl -t tex -V tex-backend -i output-print -V texdvi-output -o $@ book-decl.sgml $<
137

138 139 140
programmer.tex-ps: catalogs.eps connections.eps

$(addsuffix .tex-pdf, $(ALLBOOKS)): %.tex-pdf: %.sgml $(ALLSGML) stylesheet.dsl
141
	$(JADE) $(JADEFLAGS) $(SGMLINCLUDE) $(CATALOG) -d stylesheet.dsl -t tex -V tex-backend -i output-print -V texpdf-output -o $@ book-decl.sgml $<
142 143 144 145

programmer.tex-pdf: catalogs.pdf connections.pdf

%.dvi: %.tex-ps
Peter Eisentraut's avatar
Peter Eisentraut committed
146
	@rm -f $*.aux $*.log
147 148
	jadetex $<
	jadetex $<
149
	jadetex $<
150 151 152 153 154

# Postscript from TeX
%.ps: %.dvi
	dvips -o $@ $<

155
%.pdf: %.tex-pdf
Peter Eisentraut's avatar
Peter Eisentraut committed
156
	@rm -f $*.aux $*.log $*.out
157 158 159 160 161
	pdfjadetex $<
	pdfjadetex $<
	pdfjadetex $<


162 163 164 165
# This generates an XML version of the flow-object tree.  It's useful
# for debugging DSSSL code, and possibly to interface to some other
# tools that can make use of this.
$(addsuffix .fot, $(ALLBOOKS)): %.fot: %.sgml $(ALLSGML) stylesheet.dsl
166
	$(JADE) $(JADEFLAGS) $(SGMLINCLUDE) $(CATALOG) -d stylesheet.dsl -t fot -i output-print -o $@ book-decl.sgml $<
167 168


169 170 171
# Graphics

%.gif:
172
	cp $(srcdir)/../graphics/$@ .
173

174 175 176 177 178 179
%.eps: %.gif
	$(CONVERT) $< eps:$@

%.pdf: %.eps
	$(EPSTOPDF) $<

180

181 182 183
##
## Semi-automatic generation of some text files.
##
184

185
JADE.text = $(JADE) $(JADEFLAGS) $(SGMLINCLUDE) $(CATALOG) -d stylesheet.dsl -i output-text -t sgml
186

187
INSTALL HISTORY regress_README: % : %.html
188
	@echo "|";\
189 190
	 echo "| You should now take '$<', save it as a text file in Netscape,";\
	 echo "| and put it in place of the existing '$@' file.";\
191 192
	 echo "|"

193 194
INSTALL.html: standalone-install.sgml installation.sgml
	$(JADE.text) -V nochunks $+ >$@
195

196 197 198 199 200
HISTORY.html: release.sgml
	( echo '<!doctype appendix PUBLIC "-//OASIS//DTD DocBook V3.1//EN">'; \
	  cat $< ) >tempfile_HISTORY.sgml
	$(JADE.text) -V nochunks tempfile_HISTORY.sgml >$@
	rm tempfile_HISTORY.sgml
201

202 203 204 205 206 207 208
regress_README.html: regress.sgml
	( echo '<!doctype chapter PUBLIC "-//OASIS//DTD DocBook V3.1//EN" ['; \
	  echo '<!entity % standalone-ignore "IGNORE"> ]>'; \
	  cat $< ) >tempfile_regress_README.sgml
	$(JADE.text) -V nochunks tempfile_regress_README.sgml >$@
	rm tempfile_regress_README.sgml

209 210 211 212 213

##
## Check
##

214
check: $(addprefix check-, $(ALLBOOKS)) check-postgres
215 216

# Quick syntax check without style processing
217
$(addprefix check-, $(ALLBOOKS)): check-%: %.sgml bookindex.sgml
218 219
	$(NSGMLS) $(SGMLINCLUDE) -s book-decl.sgml $<

220
check-postgres: postgres.sgml setindex.sgml
221 222 223 224 225 226 227 228 229
	$(NSGMLS) $(SGMLINCLUDE) -s $<


##
## Clean
##

clean distclean maintainer-clean:
# HTML
230
	rm -f HTML.manifest *.html *.gif
231
# man
232
	rm -rf *.1 *.$(DEFAULTSECTION) man1 man$(DEFAULTSECTION) manpage.refs manpage.links manpage.log
233
# print
234
	rm -f *.rtf *.tex-ps *.tex-pdf *.dvi *.aux *.log *.ps *.pdf *.out *.eps *.fot
235 236
# index
	rm -f HTML.index bookindex.sgml setindex.sgml