1 #################################################################
2 # Makefile for Samba Documentation
4 # James Moore <jmoore@php.net>
5 # Gerald Carter <jerry@samba.org>
6 # Jelmer Vernooij <jelmer@samba.org>
7 include Makefile.settings
10 MAIN_DOCS
= $(patsubst %/index.xml
,%,$(wildcard */index.xml
))
11 MANPAGES3
= $(wildcard $(MANPAGEDIR3
)/*.?.xml
)
12 MANPAGES4
= $(wildcard $(MANPAGEDIR4
)/*.?.xml
)
14 # Lists of files to process
15 LATEX_FIGURES
= xslt
/figures
/caution.pdf xslt
/figures
/important.pdf xslt
/figures
/note.pdf xslt
/figures
/tip.pdf xslt
/figures
/warning.pdf
16 MANPAGES_PLUCKER
= $(patsubst $(MANPAGEDIR3
)/%.xml
,$(PLUCKERDIR
)/%.pdb
,$(MANPAGES3
))
18 DATETIME
:= $(shell date
+%Y
%m
%d
%H
%M
%S
)
21 Makefile.settings
: configure
22 @echo Makefile.settings not present
, trying to run configure...
25 configure
: configure.in
26 @echo configure not present
, trying to generate
31 @echo
"Supported make targets:"
32 @echo
" release - Build the docs needed for a Samba release"
33 @echo
" all - Build all docs that can be build using the utilities found by configure"
34 @echo
" everything - Build all of the above"
35 @echo
" pdf,tex,dvi,ps,manpages{3,4},txt,pearson,fo,htmlhelp - Build specific output format"
36 @echo
" html - Build multi-file HTML versions"
37 @echo
" html-single - Build single-file HTML versions"
38 @echo
" htmlman3 - Build HTML version of manpages"
39 @echo
" undocumented - Output list of undocumented smb.conf options"
40 @echo
" samples - Extract examples"
41 @echo
" files - Extract other files"
43 $(DOCBOOKDIR
)/Samba-Guide.xml
: $(filter-out Samba-Guide
/index.xml
,$(wildcard Samba-Guide
/*.xml
))
44 $(DOCBOOKDIR
)/Samba-HOWTO-Collection.xml
: $(filter-out Samba-HOWTO-Collection
/index.xml
,$(wildcard Samba-HOWTO-Collection
/*.xml
)) Samba-HOWTO-Collection-attributions.xml
45 Samba-HOWTO-Collection
/manpages.xml
: $(MANPAGEDIR3
)/smb.conf
.5.xml
46 $(DOCBOOKDIR
)/Samba3-Developers-Guide.xml
: $(filter-out Samba3-Developers-Guide
/index.xml
,$(wildcard Samba3-Developers-Guide
/*.xml
)) Samba3-Developers-Guide-attributions.xml
47 $(DOCBOOKDIR
)/Samba4-HOWTO.xml
: $(filter-out Samba4-HOWTO
/index.xml
,$(wildcard Samba4-HOWTO
/*.xml
)) Samba4-HOWTO-attributions.xml
51 everything
: manpages3 manpages4 pdf html-single html htmlman3 txt ps fo htmlhelp pearson
52 release
: manpages3 htmlman3 html pdf
54 # Output format targets
55 pdf
: $(patsubst %,$(PDFDIR
)/%.pdf
,$(MAIN_DOCS
))
56 dvi: $(patsubst %,$(DVIDIR
)/%.
dvi,$(MAIN_DOCS
))
57 ps
: $(patsubst %,$(PSDIR
)/%.ps
,$(MAIN_DOCS
))
58 txt
: $(patsubst %,$(TXTDIR
)/%.txt
,$(MAIN_DOCS
))
59 txt-chunks
: $(addsuffix -txt-chunks
,$(MAIN_DOCS
))
60 fo
: $(patsubst %,$(FODIR
)/%.fo
,$(MAIN_DOCS
))
61 fo-pdf
: $(patsubst %,$(FOPDFDIR
)/%.pdf
,$(MAIN_DOCS
))
62 tex: $(addsuffix .
tex,$(MAIN_DOCS
))
63 texi
: $(patsubst %,$(TEXINFODIR
)/%.texi
,$(MAIN_DOCS
))
64 texiinfo
: $(patsubst %,$(TEXINFODIR
)/%.
info,$(MAIN_DOCS
))
65 manpages3
: $(patsubst $(MANPAGEDIR3
)/%.xml
,$(OUTPUTDIR
)/manpages-3
/%,$(MANPAGES3
))
66 manpages4
: $(patsubst $(MANPAGEDIR4
)/%.xml
,$(OUTPUTDIR
)/manpages-4
/%,$(MANPAGES4
))
67 pearson
: $(PEARSONDIR
)/Samba-HOWTO-Collection.xml
68 pearson-verify
: $(PEARSONDIR
)/Samba-HOWTO-Collection.report.html
69 plucker
: $(patsubst %,$(PLUCKERDIR
)/%.pdb
,$(MAIN_DOCS
))
70 htmlman3
: $(patsubst $(MANPAGEDIR3
)/%.xml
,$(HTMLDIR
)/%.html
,$(MANPAGES3
)) $(HTMLDIR
)/manpages.html
71 html-single
: $(patsubst %,$(HTMLDIR
)/%.html
,$(MAIN_DOCS
))
72 html
: $(patsubst %,$(HTMLDIR
)/%/index.html
,$(MAIN_DOCS
)) $(HTMLDIR
)/index.html
73 htmlhelp
: $(addprefix $(HTMLHELPDIR
)/,$(MAIN_DOCS
))
74 validate
: $(addsuffix -validate
,$(MAIN_DOCS
))
76 # Intermediate docbook docs
78 $(DOCBOOKDIR
)/%.xml
: %/index.xml xslt
/expand-sambadoc.xsl
80 $(XSLTPROC
) --stringparam latex.imagebasedir
"$*/" --stringparam noreference
1 --xinclude
--output
$@ xslt
/expand-sambadoc.xsl
$<
82 $(DOCBOOKDIR
)/manpages-3
/%.xml
: $(MANPAGEDIR3
)/%.xml xslt
/expand-sambadoc.xsl
84 $(XSLTPROC
) --xinclude
--stringparam latex.imagebasedir
"$*/" --stringparam noreference
1 --output
$@ xslt
/expand-sambadoc.xsl
$<
86 $(DOCBOOKDIR
)/manpages-4
/%.xml
: $(MANPAGEDIR4
)/%.xml xslt
/expand-sambadoc.xsl
88 $(XSLTPROC
) --xinclude
--stringparam latex.imagebasedir
"$*/" --stringparam noreference
1 --output
$@ xslt
/expand-sambadoc.xsl
$<
90 $(DOCBOOKDIR
)/manpages.xml
: $(MANPAGES
) xslt
/manpage-summary.xsl
92 echo
"<article><variablelist>" > $@
93 $(XSLTPROC
) xslt
/manpage-summary.xsl
$(MANPAGES
) >> $@
94 echo
"</variablelist></article>" >> $@
98 $(HTMLDIR
)/index.html
: htmldocs.html
102 $(HTMLDIR
)/%/index.html
: $(DOCBOOKDIR
)/%.xml
$(HTMLDIR
)/%/samba.css xslt
/html-chunk.xsl
%-images-html-chunks
104 $(XSLTPROC
) --stringparam base.
dir "$(HTMLDIR)/$*/" xslt
/html-chunk.xsl
$<
106 # Single large HTML files
107 $(OUTPUTDIR
)/%/samba.css
: xslt
/html
/samba.css
111 $(patsubst %,$(HTMLDIR
)/%.html
,$(MAIN_DOCS
)): $(HTMLDIR
)/%.html
: %-images-html-single
113 $(HTMLDIR
)/%.html
: $(DOCBOOKDIR
)/%.xml
$(HTMLDIR
)/samba.css xslt
/html.xsl
114 $(XSLTPROC
) --output
$@ xslt
/html.xsl
$<
118 $(XSLTPROC
) --xinclude
-o
$@ xslt
/generate-attributions.xsl
$*/index.xml
121 $(TXTDIR
)/%.txt
: $(HTMLDIR
)/%.html
123 $(HTML2TEXT
) -nobs
-style pretty
-o
$@
$<
126 %.
tex: $(DOCBOOKDIR
)/%.xml xslt
/latex.xsl
128 $(XSLTPROC
) --output
$@ xslt
/latex.xsl
$<
130 latexfigures
: $(LATEX_FIGURES
)
133 $(PDFDIR
)/%.pdf
: %.pdf
137 %.idx
: %.
tex latexfigures
144 %.d
: $(DOCBOOKDIR
)/%.xml xslt
/generate-dependencies.xsl
147 --stringparam txtbasedir
"$(TXTDIR)/$*/" \
148 --stringparam target
"$*" \
149 -o
$@ xslt
/generate-dependencies.xsl
$<
150 @echo
"$*-images-latex-png: \$$(addsuffix .png, \$$($*-images-latex))" >> $@
151 @echo
" touch \$$@" >> $@
153 @echo
"$*-images-latex-eps: \$$(addsuffix .eps, \$$($*-images-latex))" >> $@
154 @echo
" touch \$$@" >> $@
156 @echo
"\$$(HTMLDIR)/%: $*/%" >> $@
157 @echo
" mkdir -p \$$(@D)" >> $@
158 @echo
" cp \$$< \$$@" >> $@
160 @echo
"\$$(HTMLDIR)/$*/%: $*/%" >> $@
161 @echo
" mkdir -p \$$(@D)" >> $@
162 @echo
" cp \$$< \$$@" >> $@
164 @echo
"\$$(HTMLHELPDIR)/$*/%: $*/%" >> $@
165 @echo
" mkdir -p \$$(@D)" >> $@
166 @echo
" cp \$$< \$$@" >> $@
168 @echo
"$*-images-html-single: \$$(addprefix \$$(HTMLDIR)/, \$$($*-images-html))" >> $@
169 @echo
" touch \$$@" >> $@
170 @echo
"$*-images-html-chunks: \$$(addprefix \$$(HTMLDIR)/$*/, \$$($*-images-html))" >> $@
171 @echo
" touch \$$@" >> $@
172 @echo
"$*-images-htmlhelp: \$$(addprefix \$$(HTMLHELPDIR)/$*/, \$$($*-images-html))" >> $@
173 @echo
" touch \$$@" >> $@
176 ifneq ($(MAKECMDGOALS
),clobber)
177 include $(addsuffix .d
,$(MAIN_DOCS
))
182 %.pdf
: %.
tex %.ind latexfigures
%-images-latex-png
184 $(THUMBPDF
) --quiet
$*.pdf
188 $(DVIDIR
)/%.
dvi: %.
dvi
192 %.
dvi: %.
tex %.idx
%-images-latex-eps
199 $(PNGTOPNM
) $< |
$(PNMTOPS
) > $@
202 $(PSDIR
)/%.ps
: $(DVIDIR
)/%.
dvi
206 xslt
/figures
/%.pdf
: xslt
/figures
/%.eps
210 $(FODIR
)/%.fo
: $(DOCBOOKDIR
)/%.xml
212 $(XSLTPROC
) --output
$@ xslt
/fo.xsl
$<
215 $(FOPDFDIR
)/%.pdf
: $(FODIR
)/%.fo
217 JAVA_OPTS
=-Xmx250m
$(FOP
) -q
-d
$< -pdf
$@
219 $(HTMLHELPDIR
)/%: $(DOCBOOKDIR
)/%.xml
%-images-htmlhelp
220 $(XSLTPROC
) --stringparam htmlhelp.chm
$*.chm \
221 --stringparam manifest.in.base.
dir "$@/" \
222 --stringparam base.
dir "$@/" \
223 http
://docbook.sourceforge.net
/release
/xsl
/current
/htmlhelp
/htmlhelp.xsl
$<
226 $(PLUCKERDIR
)/%.pdb
: $(HTMLDIR
)/%.html
228 $(PLUCKERBUILD
) -v
-V
2 --stayonhost
--zlib-compression
-f
$* -p
$(PLUCKERDIR
) file
:$<
231 $(TEXINFODIR
)/%.texi
: $(DOCBOOKDIR
)/%.xml
233 cd
$(@D
) && $(DB2TEXI
) $(shell pwd
)/$<
235 $(TEXINFODIR
)/%.
info: $(TEXINFODIR
)/%.texi
236 $(MAKEINFO
) --no-validate
--force -o
$@
"$<"
239 $(MANPAGEDIR3
)/smb.conf
.5.xml
: $(SMBDOTCONFDOC
)/parameters.
all.xml
$(SMBDOTCONFDOC
)/parameters.service.xml
$(SMBDOTCONFDOC
)/parameters.global.xml
241 $(SMBDOTCONFDOC
)/parameters.
all.xml
: $(shell find
$(SMBDOTCONFDOC
) -type f
-name
'*.xml' -mindepth
2 |
sort -t
/ -k3 | xargs
) $(SMBDOTCONFDOC
)/generate-file-list.sh
242 $(SMBDOTCONFDOC
)/generate-file-list.sh
$(SMBDOTCONFDOC
) > $@
244 $(SMBDOTCONFDOC
)/parameters.global.xml
: $(SMBDOTCONFDOC
)/parameters.
all.xml
$(SMBDOTCONFDOC
)/generate-context.xsl
245 $(XSLTPROC
) --xinclude
--param smb.context
"'G'" --output
$(SMBDOTCONFDOC
)/parameters.global.xml
$(SMBDOTCONFDOC
)/generate-context.xsl
$<
247 $(SMBDOTCONFDOC
)/parameters.service.xml
: $(SMBDOTCONFDOC
)/parameters.
all.xml
$(SMBDOTCONFDOC
)/generate-context.xsl
248 $(XSLTPROC
) --xinclude
--param smb.context
"'S'" --output
$(SMBDOTCONFDOC
)/parameters.service.xml
$(SMBDOTCONFDOC
)/generate-context.xsl
$<
250 $(OUTPUTDIR
)/%: $(DOCBOOKDIR
)/%.xml xslt
/man.xsl
252 $(XSLTPROC
) --output
$@ xslt
/man.xsl
$<
254 # Individual smb.conf parameters
255 smb.conf-chunks
: $(patsubst $(SMBDOTCONFDOC
)/%.xml
,$(HTMLDIR
)/smb.conf
/%.html
,$(wildcard $(SMBDOTCONFDOC
)/*/*.xml
))
257 $(HTMLDIR
)/smb.conf
/%.html
: $(SMBDOTCONFDOC
)/%.xml
259 $(XSLTPROC
) --output
$@ xslt
/smb.conf-html.xsl
$<
261 # Pearson compatible XML
262 $(PEARSONDIR
)/%.xml
: %/index.xml xslt
/pearson.xsl
264 $(XSLTPROC
) --xinclude
--output
$@ xslt
/sambadoc2pearson.xsl
$<
266 $(PEARSONDIR
)/%.report.html
: $(PEARSONDIR
)/%.xml
268 -$(XMLLINT
) --valid
--noout
$< 2> $@
270 # Validation verification
271 %-validate
: %/index.xml
272 cd
$(<D
) && $(XMLLINT
) --xinclude
--noent
--postvalid
--noout
$(<F
)
274 # Find undocumented parameters
275 undocumented
: $(SMBDOTCONFDOC
)/parameters.
all.xml scripts
/find_missing_doc.pl scripts
/find_missing_manpages.pl
276 @
$(PERL
) scripts
/find_missing_doc.pl
$(SRCDIR
)
277 @
$(PERL
) scripts
/find_missing_manpages.pl
$(SRCDIR
)
279 # Examples and the like
280 files
: Samba-HOWTO-Collection
/index.xml xslt
/extract-smbfiles.xsl
281 $(XSLTPROC
) xslt
/extract-smbfiles.xsl
$< > /dev
/null
283 samples
: $(DOCBOOKDIR
)/Samba-HOWTO-Collection.xml xslt
/extract-examples.xsl scripts
/indent-smb.conf.pl
284 mkdir
-p
$(EXAMPLESDIR
)
285 $(XSLTPROC
) --xinclude xslt
/extract-examples.xsl
$< > /dev
/null
2> examples
/README
286 for I in examples
/*.conf
; do
{ .
/scripts
/indent-smb.conf.pl
< $$I > $$I.tmp
; mv
$$I.tmp
$$I; } done
290 mkdir
-p
$(ARCHIVEDIR
)
291 cp
$(PDFDIR
)/Samba-HOWTO-Collection.pdf
$(ARCHIVEDIR
)/TOSHARG-
$(DATETIME
).pdf
292 cp
$(PDFDIR
)/Samba-Guide.pdf
$(ARCHIVEDIR
)/S3bE-
$(DATETIME
).pdf
295 xslt
/html.xsl
: xslt
/html-common.xsl settings.xsl
296 xslt
/html-chunk.xsl
: xslt
/html-common.xsl settings.xsl
297 xslt
/latex.xsl
: settings.xsl
298 xslt
/expand-sambadoc.xsl
: settings.xsl
299 xslt
/generate-attributions.xsl
:
304 rm Makefile.settings settings.xsl config.status config.log configure
307 rm -rf
$(OUTPUTDIR
)/* $(DOCBOOKDIR
)
309 rm -f xslt
/figures
/*pdf
310 rm -f
$(SMBDOTCONFDOC
)/parameters.
*.xml
311 rm -f
$(addsuffix .
*,$(MAIN_DOCS
))
313 # Always keep intermediate files if we can
315 .PHONY
: clean clobber archive release everything
all $(TARGETS
)