1
1
## generate API documentation with doxygen
3
@if test "$(subdir)" != "."; then \
4
$(mkinstalldirs) $(top_builddir)/apidocs/$(subdir) ;\
5
if test ! -x $(top_builddir)/apidocs/common; then \
6
if test -d $(top_srcdir)/doc/common; then \
7
common_dir=`cd $(top_srcdir)/doc/common && pwd` ;\
9
common_dir=$(kde_libs_htmldir)/en/common ;\
11
$(LN_S) $$common_dir $(top_builddir)/apidocs/common; \
13
cp $(top_srcdir)/admin/Doxyfile.global Doxyfile; \
14
echo "PROJECT_NAME = \"$(subdir) Library\"" >> Doxyfile; \
15
echo "PROJECT_NUMBER = \"Version $(VERSION)\"" >> Doxyfile; \
16
echo "INPUT = $(srcdir)" >> Doxyfile; \
17
echo "IMAGE_PATH = $(top_srcdir)/doc/api" >> Doxyfile ;\
18
echo "OUTPUT_DIRECTORY = $(top_builddir)/apidocs" >> Doxyfile; \
19
echo "HTML_OUTPUT = $(subdir)/html" >> Doxyfile; \
20
echo "HTML_HEADER = $(top_builddir)/apidocs/common/header.html" >> Doxyfile;\
21
echo "HTML_FOOTER = $(top_builddir)/apidocs/common/footer.html" >> Doxyfile;\
22
echo "HTML_STYLESHEET = $(top_builddir)/apidocs/common/doxygen.css" >> Doxyfile;\
23
echo "LATEX_OUTPUT = $(subdir)/latex" >> Doxyfile; \
24
echo "RTF_OUTPUT = $(subdir)/rtf" >> Doxyfile; \
25
echo "MAN_OUTPUT = $(subdir)/man" >> Doxyfile; \
26
echo "GENERATE_HTML = $(GENERATE_FLAG)" >> Doxyfile ;\
27
echo "GENERATE_MAN = $(GENERATE_FLAG)" >> Doxyfile ;\
28
echo "GENERATE_LATEX = $(GENERATE_FLAG)" >> Doxyfile ;\
29
if test -n "$(DOXYGEN_EXCLUDE)"; then \
32
for item in `echo "$(DOXYGEN_EXCLUDE)"`; do \
33
if test -d "$(srcdir)/$$item"; then \
34
dirs="$$dirs $(srcdir)/$$item/" ;\
36
patterns="$$patterns $$item" ;\
39
echo "EXCLUDE_PATTERNS += $$patterns" >> Doxyfile; \
40
echo "EXCLUDE += $$dirs" >> Doxyfile ;\
42
echo "TAGFILES = \\" >> Doxyfile; \
43
tags='$(DOXYGEN_REFERENCES) qt'; for tag in $$tags; do \
46
if test -f $(top_builddir)/apidocs/$$tag/$$tag.tag; then \
47
tagpath="$(top_builddir)/apidocs/$$tag/$$tag.tag" ;\
49
tagpath=`ls -1 $(kde_htmldir)/en/*-apidocs/$$tag/$$tag.tag 2> /dev/null` ;\
50
if test -n "$$tagpath"; then \
51
path=`echo $$tagpath | sed -e "s,.*/\([^/]*-apidocs\)/$$tag/$$tag.tag,../../../\1/$$tag,"` ;\
54
if test "$$tag" = qt; then \
55
echo $$tagpath=$(QTDOCDIR) >> Doxyfile ;\
56
else if test -n "$$tagpath"; then \
57
echo "$$tagpath=$$path/html \\" >> Doxyfile ;\
61
echo "GENERATE_TAGFILE = $(top_builddir)/apidocs/$(subdir)/`basename $(subdir)`.tag" >> Doxyfile ;\
62
echo "IGNORE_PREFIX = K" >> Doxyfile ;\
63
echo "HAVE_DOT = $(KDE_HAVE_DOT)" >> Doxyfile ;\
64
$(DOXYGEN) Doxyfile ;\
3
@if test \! -d "$(top_srcdir)/doc/common/" && test -z "$$ADMIN" ; then \
4
export DOXDATA=$(kde_libs_htmldir)/en/common ; \
6
test -d $(top_builddir)/apidocs || \
7
( cd $(top_builddir) && sh $(top_srcdir)/admin/doxygen.sh \
8
--no-modulename --installdir=$(kde_libs_htmldir)/en \
9
--no-recurse $(top_srcdir) . ) ; \
10
cd $(top_builddir) && sh $(top_srcdir)/admin/doxygen.sh \
11
--recurse --no-modulename --installdir=$(kde_libs_htmldir)/en \
12
$(top_srcdir) $(subdir)
14
apidox-am-toplevel-yes:
15
@if test \! -d "$(top_srcdir)/doc/common/" && test -z "$$ADMIN" ; then \
16
export DOXDATA=$(kde_libs_htmldir)/en/common ; \
18
cd $(top_builddir) && sh $(top_srcdir)/admin/doxygen.sh \
19
--no-modulename --installdir=$(kde_libs_htmldir)/en \
22
## Don't generate API documentation without doxygen
25
apidox-am-toplevel-no:
29
@if test "$(subdir)" != "."; then \
30
$(MAKE) apidox-am-@KDE_HAS_DOXYGEN@ ;\
32
$(MAKE) apidox-am-toplevel-@KDE_HAS_DOXYGEN@ ;\
69
37
install-data-local: install-apidox
71
39
## install API documentation
83
51
$(INSTALL_DATA) $(top_builddir)/apidocs/$(subdir)/html/$$file $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs/$(subdir)/html; \
86
rm -f $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs/common; \
87
$(LN_S) $(kde_libs_htmldir)/en/common $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs/common; \
89
55
if test -d $(top_builddir)/apidocs; then \
90
56
$(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs ;\
91
57
list=`cd $(top_builddir)/apidocs && ls -1`; \
92
58
echo "installing $(top_builddir)/apidocs/$$file" ;\
59
echo "target directory $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs" ; \
93
60
for file in $$list; do \
94
61
if test -f $(top_builddir)/apidocs/$$file; then \
95
62
$(INSTALL_DATA) $(top_builddir)/apidocs/$$file $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs; \
115
@if test "$(subdir)" != "."; then \
116
$(MAKE) apidox-am-@KDE_HAS_DOXYGEN@ ;\
118
$(MAKE) apidox-am-toplevel-@KDE_HAS_DOXYGEN@ ;\
81
install-apidox-recurse: install-apidox
120
82
@set fnord $(MAKEFLAGS); amf=$$2; if test -n '$(SUBDIRS)'; then \
121
83
list='$(SUBDIRS)'; \
122
84
for subdir in $$list; do \
123
if grep '^include .*Doxyfile.am' $(srcdir)/$$subdir/Makefile.am; then \
124
echo "Making apidox in $$subdir"; \
125
if test "$$subdir" != "."; then \
126
(cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) GENERATE_FLAG=no apidox) || exit 1; \
129
for subdir in $$list; do \
130
if grep '^include .*Doxyfile.am' $(srcdir)/$$subdir/Makefile.am; then \
131
echo "Making apidox in $$subdir"; \
132
if test "$$subdir" != "."; then \
133
(cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) GENERATE_FLAG=yes apidox) || exit 1; \
85
if grep '^include .*Doxyfile.am' $(srcdir)/$$subdir/Makefile.am > /dev/null ; then \
86
echo "Installing apidox from $$subdir"; \
87
if test "$$subdir" != "."; then \
88
(cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) GENERATE_FLAG=no install-apidox-recurse) || exit 1; \
138
apidox-am-toplevel-no:
139
apidox-am-toplevel-yes:
140
@echo "*** Creating API documentation main page"; \
141
cp $(top_srcdir)/admin/Doxyfile.global Doxyfile; \
142
echo "PROJECT_NAME = \"$(DOXYGEN_PROJECT_NAME)\"" >> Doxyfile ; \
143
echo "PROJECT_NUMBER = \"$(DOXYGEN_PROJECT_NUMBER)\"" >> Doxyfile ; \
144
echo "INPUT = $(top_srcdir)" >> Doxyfile ; \
145
echo "OUTPUT_DIRECTORY = $(top_builddir)/apidocs" >> Doxyfile ; \
146
echo "FILE_PATTERNS = *.dox" >> Doxyfile ; \
147
echo "RECURSIVE = NO" >> Doxyfile ; \
148
echo "SOURCE_BROWSER = NO" >> Doxyfile ; \
149
echo "ALPHABETICAL_INDEX = NO" >> Doxyfile ; \
150
echo "HTML_OUTPUT = ." >> Doxyfile ; \
151
echo "HTML_HEADER = apidocs/common/mainheader.html" >> Doxyfile ; \
152
echo "HTML_FOOTER = apidocs/common/mainfooter.html" >> Doxyfile ; \
153
echo "HTML_STYLESHEET = apidocs/common/doxygen.css" >> Doxyfile ; \
154
echo "GENERATE_LATEX = NO" >> Doxyfile ; \
155
echo "GENERATE_RTF = NO" >> Doxyfile ; \
156
echo "GENERATE_MAN = NO" >> Doxyfile ; \
157
echo "GENERATE_XML = NO" >> Doxyfile ; \
158
echo "GENERATE_AUTOGEN_DEF = NO" >> Doxyfile ; \
159
echo "ENABLE_PREPROCESSING = NO" >> Doxyfile ; \
160
echo "CLASS_DIAGRAMS = NO" >> Doxyfile ; \
161
echo "HAVE_DOT = NO" >> Doxyfile ; \
162
echo "GENERATE_HTML = YES" >> Doxyfile ;\
163
$(mkinstalldirs) $(top_builddir)/apidocs ; \
164
rm -f $(top_builddir)/apidocs/common ; \
165
if test -d $(top_srcdir)/doc/common; then \
166
common_dir=`cd $(top_srcdir)/doc/common && pwd` ;\
168
common_dir=$(kde_libs_htmldir)/en/common ;\
170
$(LN_S) $$common_dir $(top_builddir)/apidocs/common ;\
174
95
.PHONY: apidox-am-yes apidox-am-no install-data-local install-apidox install-apidox uninstall-local uninstall-apidox uninstall-apidox apidox apidox-am-toplevel-no apidox-am-toplevel-yes