blob: 56ec0bba3a6e5b282e153212b25ae8844bf708fc (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
mydir=doc
BUILDTOP=$(REL)..
SPHINX_BUILD=sphinx-build
DOXYGEN=doxygen
docsrc=$(top_srcdir)/../doc
localstatedir=@localstatedir@
sysconfdir=@sysconfdir@
DEFCCNAME=@DEFCCNAME@
DEFKTNAME=@DEFKTNAME@
DEFCKTNAME=@DEFCKTNAME@
RST_SOURCES= _static \
_templates \
conf.py \
index.rst \
admin \
appdev \
basic \
build \
plugindev \
user \
about.rst \
build_this.rst \
mitK5defaults.rst \
mitK5features.rst \
mitK5license.rst \
notice.rst \
resources.rst
PDFDIR=$(docsrc)/pdf
PDFDOCS= admin appdev basic build plugindev user
LATEXOPTS=
# Create HTML documentation in $(docsrc)/html suitable for a
# release tarball or the web site (that is, without substitutions for
# configured paths). This can be done in an unconfigured source tree
# with:
# make -f Makefile.in srcdir=. top_srcdir=.. PYTHON=python html
# make -f Makefile.in clean
html: composite
rm -rf $(docsrc)/html
$(SPHINX_BUILD) -q rst_composite $(docsrc)/html
# Create HTML documentation in html_subst suitable for
# installation by an OS package, with substitutions for configured
# paths.
substhtml: composite paths.py
rm -rf html_subst
cp paths.py rst_composite
$(SPHINX_BUILD) -t pathsubs -q rst_composite html_subst
# Create an ASCII (okay, UTF-8) version of the NOTICE file
notice.txt: $(docsrc)/conf.py $(docsrc)/notice.rst
$(SPHINX_BUILD) -b text -t notice -q $(docsrc) .
NOTICE: notice.txt
cp notice.txt $(top_srcdir)/../NOTICE
$(PDFDIR): composite
$(SPHINX_BUILD) -b latex -q rst_composite $(PDFDIR)
# sphinx-build generates a gmake-specific Makefile that we don't use
mv $(PDFDIR)/Makefile $(PDFDIR)/GMakefile
# Not pretty. Can't use a suffix rule .tex.pdf without a Makefile in
# $(PDFDIR) because pdflatex looks for include files in the current
# working directory. The sphinx-build Makefile is quite conservative
# and runs pdflatex five times; we can be slightly less conservative.
pdf: $(PDFDIR)
(cd $(PDFDIR) && \
for i in $(PDFDOCS); do \
texfile=`echo $${i}.tex` && \
idxfile=`echo $${i}.idx` && \
pdflatex $(LATEXOPTS) $$texfile && \
pdflatex $(LATEXOPTS) $$texfile && \
makeindex -s python.ist $$idxfile || true; \
pdflatex $(LATEXOPTS) $$texfile && \
pdflatex $(LATEXOPTS) $$texfile; done && \
rm -f *.dvi *.log *.ind *.aux *.toc *.syn *.idx *.out *.ilg *.pla \
)
# Use doxygen to generate API documentation, translate it into RST
# format, and then create a composite of $(docsrc)'s RST and the
# generated files in rst_composite. Used by the html and substhtml targets.
composite: Doxyfile $(docsrc)/version.py
rm -rf doxy rst_apiref rst_composite
$(DOXYGEN)
cwd=`pwd`; cd $(docsrc)/tools && \
$(PYTHON) doxy.py -i $$cwd/doxy/xml -o $$cwd/rst_apiref
mkdir -p rst_composite
do_subdirs="$(RST_SOURCES)" ; \
for i in $$do_subdirs; do \
cp -r $(docsrc)/$$i rst_composite; \
done
cp rst_apiref/*.rst rst_composite/appdev/refs/api
cp rst_apiref/types/*.rst rst_composite/appdev/refs/types
cp rst_apiref/macros/*.rst rst_composite/appdev/refs/macros
cp $(docsrc)/version.py rst_composite
Doxyfile: $(srcdir)/Doxyfile.in
sed -e 's|@SRC@|$(top_srcdir)|g' \
-e 's|@DOC@|$(top_srcdir)/../doc|g' $(srcdir)/Doxyfile.in > $@
paths.py:
rm -f $@
echo 'bindir = "``$(CLIENT_BINDIR)``"' > $@
echo 'sbindir = "``$(SERVER_BINDIR)``"' >> $@
echo 'libdir = "``$(KRB5_LIBDIR)``"' >> $@
echo 'localstatedir = "``$(localstatedir)``"' >> $@
echo 'sysconfdir = "``$(sysconfdir)``"' >> $@
echo 'ccache = "``$(DEFCCNAME)``"' >> $@
echo 'keytab = "``$(DEFKTNAME)``"' >> $@
echo 'ckeytab = "``$(DEFCKTNAME)``"' >> $@
# Dummy rule that man/Makefile can invoke
version.py: $(docsrc)/version.py
$(docsrc)/version.py: $(top_srcdir)/patchlevel.h $(srcdir)/version.py.in
$(RM) $@
$(CC) -E -I$(top_srcdir) - < $(srcdir)/version.py.in > $@
clean::
rm -rf doxy rst_apiref rst_composite rst_notice html_subst \
Doxyfile paths.py $(docsrc)/version.py notice.txt \
$(docsrc)/html/.doctrees $(docsrc)/pdf/.doctrees
|