1 #################################################################
2 # Makefile.in 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
,$(DOCBOOKDIR
)/%.xml
,$(wildcard */index.xml
))
11 MANPAGES
= $(wildcard $(MANPAGEDIR
)/*.?.xml
)
13 # Lists of files to process
14 LATEX_FIGURES
= xslt
/figures
/caution.pdf xslt
/figures
/important.pdf xslt
/figures
/note.pdf xslt
/figures
/tip.pdf xslt
/figures
/warning.pdf
15 MANPAGES_PLUCKER
= $(patsubst $(MANPAGEDIR
)/%.xml
,$(PLUCKERDIR
)/%.pdb
,$(MANPAGES
))
18 Makefile.settings
: Makefile.settings.in configure
19 @echo Makefile.settings not present
, trying to run configure...
22 configure
: configure.in
23 @echo configure not present
, trying to generate
28 @echo
"Supported make targets:"
29 @echo
" release - Build the docs needed for a Samba release"
30 @echo
" all - Build all docs that can be build using the utilities found by configure"
31 @echo
" everything - Build all of the above"
32 @echo
" pdf,tex,dvi,ps,manpages,txt,pearson,fo,htmlhelp - Build specific output format"
33 @echo
" html - Build multi-file HTML version of HOWTO Collection, Guide and Dev-Guide"
34 @echo
" html-single - Build single-file HTML version of HOWTO Collection, Guide and Dev-Guide"
35 @echo
" htmlman - Build HTML version of manpages"
36 @echo
" undocumented - Output list of undocumented smb.conf options"
37 @echo
" samples - Extract examples"
38 @echo
" files - Extract other files"
42 Samba-Guide
/index.xml
: $(subst Samba-Guide
/index.xml
,,$(wildcard Samba-Guide
/*.xml
))
43 Samba-HOWTO-Collection
/index.xml
: $(subst Samba-HOWTO-Collection
/index.xml
,,$(wildcard Samba-HOWTO-Collection
/*.xml
)) Samba-HOWTO-Collection-attributions.xml
44 Samba-Developers-Guide
/index.xml
: $(subst Samba-Developers-Guide
/index.xml
,,$(wildcard Samba-Developers-Guide
/*.xml
)) Samba-Developers-Guide-attributions.xml
48 everything
: manpages pdf html-single html htmlman txt ps fo htmlhelp pearson validate
49 release
: manpages htmlman html pdf
51 # Output format targets
52 pdf
: $(patsubst $(DOCBOOKDIR
)/%.xml
,$(PDFDIR
)/%.pdf
,$(MAIN_DOCS
))
53 dvi: $(patsubst $(DOCBOOKDIR
)/%.xml
,$(DVIDIR
)/%.
dvi,$(MAIN_DOCS
))
54 ps
: $(patsubst $(DOCBOOKDIR
)/%.xml
,$(PSDIR
)/%.ps
,$(MAIN_DOCS
))
55 txt
: $(patsubst $(DOCBOOKDIR
)/%.xml
,$(TXTDIR
)/%.txt
,$(MAIN_DOCS
))
56 txt-chunks
: $(patsubst $(DOCBOOKDIR
)/%.xml
,$(TXTDIR
)/%/,$(MAIN_DOCS
))
57 fo
: $(patsubst $(DOCBOOKDIR
)/%.xml
,$(FODIR
)/%.fo
,$(MAIN_DOCS
))
58 fo-pdf
: $(patsubst $(DOCBOOKDIR
)/%.xml
,$(FOPDFDIR
)/%.pdf
,$(MAIN_DOCS
))
59 tex: $(patsubst $(DOCBOOKDIR
)/%.xml
,%.
tex,$(MAIN_DOCS
))
60 manpages
: $(patsubst $(MANPAGEDIR
)/%.xml
,$(MANDIR
)/%,$(MANPAGES
))
61 pearson
: $(PEARSONDIR
)/Samba-HOWTO-Collection.xml
62 pearson-verify
: $(PEARSONDIR
)/Samba-HOWTO-Collection.report.html
63 plucker
: $(patsubst $(DOCBOOKDIR
)/%.xml
,$(PLUCKERDIR
)/%.pdb
,$(MAIN_DOCS
))
64 htmlman
: $(patsubst $(MANPAGEDIR
)/%.xml
,$(HTMLDIR
)/%.html
,$(MANPAGES
)) $(HTMLDIR
)/manpages.html
65 html-single
: $(patsubst $(DOCBOOKDIR
)/%.xml
,$(HTMLDIR
)/%.html
,$(MAIN_DOCS
))
66 html
: $(patsubst $(DOCBOOKDIR
)/%.xml
,$(HTMLDIR
)/%/index.html
,$(MAIN_DOCS
)) $(HTMLDIR
)/index.html
67 htmlhelp
: $(patsubst $(DOCBOOKDIR
)/%.xml
,$(HTMLHELPDIR
)/%,$(MAIN_DOCS
))
69 # Intermediate docbook docs
71 $(DOCBOOKDIR
)/%.xml
: %/index.xml xslt
/expand-sambadoc.xsl
73 $(XSLTPROC
) --stringparam latex.imagebasedir
"$*/" --stringparam noreference
1 --xinclude
--output
$@ xslt
/expand-sambadoc.xsl
$<
75 $(DOCBOOKDIR
)/%.xml
: $(MANPAGEDIR
)/%.xml xslt
/expand-sambadoc.xsl
77 $(XSLTPROC
) --xinclude
--stringparam latex.imagebasedir
"$*/" --stringparam noreference
1 --output
$@ xslt
/expand-sambadoc.xsl
$<
79 $(DOCBOOKDIR
)/manpages.xml
: $(MANPAGES
) xslt
/manpage-summary.xsl
81 echo
"<article><variablelist>" > $@
82 for I in
$(MANPAGES
); do
$(XSLTPROC
) xslt
/manpage-summary.xsl
$$I >> $@
; done
83 echo
"</variablelist></article>" >> $@
87 $(HTMLDIR
)/index.html
: htmldocs.html
91 $(HTMLDIR
)/%/index.html
: $(DOCBOOKDIR
)/%.xml
$(HTMLDIR
)/%/samba.css xslt
/html-chunk.xsl
93 $(XSLTPROC
) --stringparam base.
dir "$(HTMLDIR)/$*/" xslt
/html-chunk.xsl
$<
95 $(COPY_IMAGES
) html
$(DOCBOOKDIR
)/$*.xml
$* $(@D
)
97 # Single large HTML files
98 $(OUTPUTDIR
)/%/samba.css
: xslt
/html
/samba.css
102 $(HTMLDIR
)/%.html
: $(DOCBOOKDIR
)/%.xml
$(HTMLDIR
)/samba.css xslt
/html.xsl
103 mkdir
-p
$(@D
)/images
104 $(COPY_IMAGES
) html
$(DOCBOOKDIR
)/$*.xml
$* $(@D
)
105 $(XSLTPROC
) --output
$@ xslt
/html.xsl
$<
109 $(XSLTPROC
) --xinclude xslt
/generate-attributions.xsl
$*/index.xml
> $@
112 rm Makefile.settings settings.xsl config.status config.log configure
115 rm -rf
$(OUTPUTDIR
)/* $(DOCBOOKDIR
)
117 rm -f xslt
/figures
/*pdf
118 rm -f
$(SMBDOTCONFDOC
)/parameters.
*.xml
119 rm -f
$(patsubst $(DOCBOOKDIR
)/%.xml
,%.
*,$(MAIN_DOCS
))
122 $(TXTDIR
)/%.txt
: $(HTMLDIR
)/%.html
124 $(HTML2TEXT
) -nobs
-style pretty
-o
$@
$<
126 $(TXTDIR
)/%/: $(HTMLDIR
)/%/index.html
127 $(MAKE
) `echo $(HTMLDIR)/$*/*.html | $(PERL) -p -e 's|$(HTMLDIR)|$(TXTDIR)|g;s/\.html/\.txt/g;'`
130 %.
tex: $(DOCBOOKDIR
)/%.xml xslt
/latex.xsl
132 $(XSLTPROC
) --output
$@ xslt
/latex.xsl
$<
134 latexfigures
: $(LATEX_FIGURES
)
136 $(PDFDIR
)/%.pdf
: %.pdf
140 %.idx
: %.
tex latexfigures
147 %.pdf
: %.
tex %.ind latexfigures
148 $(MAKE
) $(shell $(XSLTPROC
) --stringparam prepend
"" --stringparam append
".png" --stringparam role latex xslt
/find-image-dependencies.xsl
$(DOCBOOKDIR
)/$*.xml
)
154 $(DVIDIR
)/%.
dvi: %.
dvi
159 $(MAKE
) $(shell $(XSLTPROC
) --stringparam prepend
"" --stringparam append
".eps" --stringparam role latex xslt
/find-image-dependencies.xsl
$(DOCBOOKDIR
)/$*.xml
)
166 $(PNGTOPNM
) $< |
$(PNMTOPS
) > $@
169 $(PSDIR
)/%.ps
: $(DVIDIR
)/%.
dvi
173 xslt
/figures
/%.pdf
: xslt
/figures
/%.eps
177 $(FODIR
)/%.fo
: $(DOCBOOKDIR
)/%.xml
179 $(XSLTPROC
) --output
$@ http
://docbook.sourceforge.net
/release
/xsl
/current
/fo
/docbook.xsl
$<
182 $(FOPDFDIR
)/%.pdf
: $(FODIR
)/%.fo
184 $(FOP
) -q
-d
$< -pdf
$@
186 $(HTMLHELPDIR
)/%: $(DOCBOOKDIR
)/%.xml
188 $(COPY_IMAGES
) html
$(DOCBOOKDIR
)/$*.xml
$* $@
189 $(XSLTPROC
) --stringparam htmlhelp.chm
$*.chm
--stringparam manifest.in.base.
dir "$@/" --stringparam base.
dir "$@/" http
://docbook.sourceforge.net
/release
/xsl
/current
/htmlhelp
/htmlhelp.xsl
$<
192 $(PLUCKERDIR
)/%.pdb
: $(HTMLDIR
)/%.html
194 $(PLUCKERBUILD
) -v
-M1
--stayonhost
--noimages
--zlib-compression
-H file
:$< -f
$* -p
$(PLUCKERDIR
)
197 $(MANPAGEDIR
)/smb.conf
.5.xml
: $(SMBDOTCONFDOC
)/parameters.
all.xml
$(SMBDOTCONFDOC
)/parameters.service.xml
$(SMBDOTCONFDOC
)/parameters.global.xml
199 $(SMBDOTCONFDOC
)/parameters.
all.xml
: $(shell find
$(SMBDOTCONFDOC
) -type f
-name
'*.xml' -mindepth
2 |
sort -t
/ -k3 | xargs
) $(SMBDOTCONFDOC
)/generate-file-list.sh
200 $(SMBDOTCONFDOC
)/generate-file-list.sh
$(SMBDOTCONFDOC
) > $@
202 $(SMBDOTCONFDOC
)/parameters.global.xml
: $(SMBDOTCONFDOC
)/parameters.
all.xml
$(SMBDOTCONFDOC
)/generate-context.xsl
203 $(XSLTPROC
) --xinclude
--param smb.context
"'G'" --output
$(SMBDOTCONFDOC
)/parameters.global.xml
$(SMBDOTCONFDOC
)/generate-context.xsl
$<
205 $(SMBDOTCONFDOC
)/parameters.service.xml
: $(SMBDOTCONFDOC
)/parameters.
all.xml
$(SMBDOTCONFDOC
)/generate-context.xsl
206 $(XSLTPROC
) --xinclude
--param smb.context
"'S'" --output
$(SMBDOTCONFDOC
)/parameters.service.xml
$(SMBDOTCONFDOC
)/generate-context.xsl
$<
208 $(MANDIR
)/%: $(DOCBOOKDIR
)/%.xml xslt
/man.xsl
210 $(XSLTPROC
) --output
$@ xslt
/man.xsl
$<
212 # Individual smb.conf parameters
213 smb.conf-chunks
: $(patsubst $(SMBDOTCONFDOC
)/%.xml
,$(HTMLDIR
)/smb.conf
/%.html
,$(wildcard $(SMBDOTCONFDOC
)/*/*.xml
))
215 $(HTMLDIR
)/smb.conf
/%.html
: $(SMBDOTCONFDOC
)/%.xml
217 $(XSLTPROC
) --output
$@ xslt
/smb.conf-html.xsl
$<
219 # Pearson compatible XML
221 $(PEARSONDIR
)/%.xml
: %/index.xml xslt
/pearson.xsl
223 $(XSLTPROC
) --xinclude
--output
$@ xslt
/sambadoc2pearson.xsl
$<
225 $(PEARSONDIR
)/%.report.html
: $(PEARSONDIR
)/%.xml
227 $(XMLLINT
) --valid
--noout
--htmlout
$< 2> $@
229 # Validation verification
231 $(VALIDATEDIR
)/%.report.html
: $(DOCBOOKDIR
)/%.xml
233 $(XMLLINT
) --valid
--noout
--htmlout
$< 2> $@
235 validate
: $(VALIDATEDIR
)/Samba-HOWTO-Collection.report.html
$(VALIDATEDIR
)/Samba-Developers-Guide.report.html
$(VALIDATEDIR
)/Samba-Guide.report.html
237 # Find undocumented parameters
239 undocumented
: $(SMBDOTCONFDOC
)/parameters.
all.xml scripts
/find_missing_doc.pl scripts
/find_missing_manpages.pl
240 @
$(PERL
) scripts
/find_missing_doc.pl
$(SRCDIR
)
241 @
$(PERL
) scripts
/find_missing_manpages.pl
$(SRCDIR
)
243 # Examples and the like
245 files
: $(HOWTODIR
)/index.xml xslt
/extract-smbfiles.xsl
246 $(XSLTPROC
) xslt
/extract-smbfiles.xsl
$< > /dev
/null
248 samples
: $(DOCBOOKDIR
)/Samba-HOWTO-Collection.xml xslt
/extract-examples.xsl scripts
/indent-smb.conf.pl
249 mkdir
-p
$(EXAMPLESDIR
)
250 $(XSLTPROC
) --xinclude xslt
/extract-examples.xsl
$< > /dev
/null
2> examples
/README
251 for I in examples
/*.conf
; do
{ .
/scripts
/indent-smb.conf.pl
< $$I > $$I.tmp
; mv
$$I.tmp
$$I; } done
255 mkdir
-p
$(ARCHIVEDIR
)
256 cp
$(PDFDIR
)/Samba-HOWTO-Collection.pdf
$(ARCHIVEDIR
)/TOSHARG-
`date +%Y%m%d%H%M%S`.pdf
257 cp
$(PDFDIR
)/Samba-Guide.pdf
$(ARCHIVEDIR
)/S3bE-
`date +%Y%m%d%H%M%S`.pdf
260 xslt
/html.xsl
: xslt
/html-common.xsl settings.xsl
261 xslt
/html-chunk.xsl
: xslt
/html-common.xsl settings.xsl
262 xslt
/latex.xsl
: settings.xsl
263 xslt
/expand-sambadoc.xsl
: settings.xsl
264 xslt
/generate-attributions.xsl
: