joachim99@14
|
1 ## generate API documentation with doxygen
|
joachim99@14
|
2 apidox-am-yes:
|
joachim99@14
|
3 @if test "$(subdir)" != "."; then \
|
joachim99@14
|
4 $(mkinstalldirs) $(top_builddir)/apidocs/$(subdir) ;\
|
joachim99@14
|
5 if test ! -x $(top_builddir)/apidocs/common; then \
|
joachim99@14
|
6 if test -d $(top_srcdir)/doc/common; then \
|
joachim99@14
|
7 common_dir=`cd $(top_srcdir)/doc/common && pwd` ;\
|
joachim99@14
|
8 else \
|
joachim99@14
|
9 common_dir=$(kde_libs_htmldir)/en/common ;\
|
joachim99@14
|
10 fi ;\
|
joachim99@14
|
11 $(LN_S) $$common_dir $(top_builddir)/apidocs/common; \
|
joachim99@14
|
12 fi ;\
|
joachim99@14
|
13 cp $(top_srcdir)/admin/Doxyfile.global Doxyfile; \
|
joachim99@14
|
14 echo "PROJECT_NAME = \"$(subdir) Library\"" >> Doxyfile; \
|
joachim99@14
|
15 echo "PROJECT_NUMBER = \"Version $(VERSION)\"" >> Doxyfile; \
|
joachim99@14
|
16 echo "INPUT = $(srcdir)" >> Doxyfile; \
|
joachim99@14
|
17 echo "IMAGE_PATH = $(top_srcdir)/doc/api" >> Doxyfile ;\
|
joachim99@14
|
18 echo "OUTPUT_DIRECTORY = $(top_builddir)/apidocs" >> Doxyfile; \
|
joachim99@14
|
19 echo "HTML_OUTPUT = $(subdir)/html" >> Doxyfile; \
|
joachim99@14
|
20 echo "LATEX_OUTPUT = $(subdir)/latex" >> Doxyfile; \
|
joachim99@14
|
21 echo "RTF_OUTPUT = $(subdir)/rtf" >> Doxyfile; \
|
joachim99@14
|
22 echo "MAN_OUTPUT = $(subdir)/man" >> Doxyfile; \
|
joachim99@14
|
23 echo "GENERATE_HTML = $(GENERATE_FLAG)" >> Doxyfile ;\
|
joachim99@14
|
24 echo "GENERATE_MAN = $(GENERATE_FLAG)" >> Doxyfile ;\
|
joachim99@14
|
25 echo "GENERATE_LATEX = $(GENERATE_FLAG)" >> Doxyfile ;\
|
joachim99@14
|
26 if test -n "$(DOXYGEN_EXCLUDE)"; then \
|
joachim99@14
|
27 echo "EXCLUDE_PATTERNS += $(DOXYGEN_EXCLUDE)" >> Doxyfile; \
|
joachim99@14
|
28 fi ;\
|
joachim99@14
|
29 echo "TAGFILES = \\" >> Doxyfile; \
|
joachim99@14
|
30 tags='$(DOXYGEN_REFERENCES) qt'; for tag in $$tags; do \
|
joachim99@14
|
31 tagpath= ;\
|
joachim99@14
|
32 path="../../$$tag" ;\
|
joachim99@14
|
33 if test -f $(top_builddir)/apidocs/$$tag/$$tag.tag; then \
|
joachim99@14
|
34 tagpath="$(top_builddir)/apidocs/$$tag/$$tag.tag" ;\
|
joachim99@14
|
35 else \
|
joachim99@14
|
36 tagpath=`ls -1 $(kde_htmldir)/en/*-apidocs/$$tag/$$tag.tag 2> /dev/null` ;\
|
joachim99@14
|
37 if test -n "$$tagpath"; then \
|
joachim99@14
|
38 path=`echo $$tagpath | sed -e "s,.*/\([^/]*-apidocs\)/$$tag/$$tag.tag,../../../\1/$$tag,"` ;\
|
joachim99@14
|
39 fi ;\
|
joachim99@14
|
40 fi ;\
|
joachim99@14
|
41 if test "$$tag" = qt; then \
|
joachim99@14
|
42 echo $$tagpath=$(QTDOCDIR) >> Doxyfile ;\
|
joachim99@14
|
43 else if test -n "$$tagpath"; then \
|
joachim99@14
|
44 echo "$$tagpath=$$path/html \\" >> Doxyfile ;\
|
joachim99@14
|
45 fi ;\
|
joachim99@14
|
46 fi ;\
|
joachim99@14
|
47 done ;\
|
joachim99@14
|
48 echo "GENERATE_TAGFILE = $(top_builddir)/apidocs/$(subdir)/$(subdir).tag" >> Doxyfile ;\
|
joachim99@14
|
49 echo "IGNORE_PREFIX = K" >> Doxyfile ;\
|
joachim99@14
|
50 echo "HAVE_DOT = $(KDE_HAVE_DOT)" >> Doxyfile ;\
|
joachim99@14
|
51 $(DOXYGEN) Doxyfile ;\
|
joachim99@14
|
52 fi
|
joachim99@14
|
53
|
joachim99@14
|
54 apidox-am-no:
|
joachim99@14
|
55
|
joachim99@14
|
56 install-data-local: install-apidox
|
joachim99@14
|
57
|
joachim99@14
|
58 ## install API documentation
|
joachim99@14
|
59 install-apidox:
|
joachim99@14
|
60 @if test "$(subdir)" != "."; then \
|
joachim99@14
|
61 $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs/$(subdir)/html ; \
|
joachim99@14
|
62 if test -f $(top_builddir)/apidocs/$(subdir)/$(subdir).tag; then \
|
joachim99@14
|
63 echo $(INSTALL_DATA) $(top_builddir)/apidocs/$(subdir)/$(subdir).tag $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs/$(subdir); \
|
joachim99@14
|
64 $(INSTALL_DATA) $(top_builddir)/apidocs/$(subdir)/$(subdir).tag $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs/$(subdir); \
|
joachim99@14
|
65 fi; \
|
joachim99@14
|
66 if test -d $(top_builddir)/apidocs/$(subdir)/html; then \
|
joachim99@14
|
67 list=`ls $(top_builddir)/apidocs/$(subdir)/html`; \
|
joachim99@14
|
68 for file in $$list; do \
|
joachim99@14
|
69 echo $(INSTALL_DATA) $(top_builddir)/apidocs/$(subdir)/html/$$file $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs/$(subdir)/html; \
|
joachim99@14
|
70 $(INSTALL_DATA) $(top_builddir)/apidocs/$(subdir)/html/$$file $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs/$(subdir)/html; \
|
joachim99@14
|
71 done; \
|
joachim99@14
|
72 fi; \
|
joachim99@14
|
73 rm -f $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs/common; \
|
joachim99@14
|
74 $(LN_S) $(kde_libs_htmldir)/en/common $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs/common; \
|
joachim99@14
|
75 else\
|
joachim99@14
|
76 if test -d $(top_builddir)/apidocs; then \
|
joachim99@14
|
77 $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs ;\
|
joachim99@14
|
78 list=`cd $(top_builddir)/apidocs && ls -1`; \
|
joachim99@14
|
79 for file in $$list; do \
|
joachim99@14
|
80 if test -f $(top_builddir)/apidocs/$$file; then \
|
joachim99@14
|
81 echo $(INSTALL_DATA) $(top_builddir)/apidocs/$$file $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs; \
|
joachim99@14
|
82 $(INSTALL_DATA) $(top_builddir)/apidocs/$$file $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs; \
|
joachim99@14
|
83 fi; \
|
joachim99@14
|
84 done ; fi; \
|
joachim99@14
|
85 fi
|
joachim99@14
|
86
|
joachim99@14
|
87 uninstall-local: uninstall-apidox
|
joachim99@14
|
88
|
joachim99@14
|
89 ## uninstall API documentation
|
joachim99@14
|
90 uninstall-apidox:
|
joachim99@14
|
91 @if test "$(subdir)" != "."; then \
|
joachim99@14
|
92 if test -d $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs/$(subdir); then \
|
joachim99@14
|
93 rm -rfv $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs/$(subdir); \
|
joachim99@14
|
94 fi\
|
joachim99@14
|
95 else\
|
joachim99@14
|
96 if test -d $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs; then \
|
joachim99@14
|
97 rm -rfv $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs; \
|
joachim99@14
|
98 fi\
|
joachim99@14
|
99 fi
|
joachim99@14
|
100
|
joachim99@14
|
101 apidox:
|
joachim99@14
|
102 @if test "$(subdir)" != "."; then \
|
joachim99@14
|
103 $(MAKE) apidox-am-@KDE_HAS_DOXYGEN@ ;\
|
joachim99@14
|
104 else \
|
joachim99@14
|
105 $(MAKE) apidox-am-toplevel-@KDE_HAS_DOXYGEN@ ;\
|
joachim99@14
|
106 fi
|
joachim99@14
|
107 @set fnord $(MAKEFLAGS); amf=$$2; if test -n '$(SUBDIRS)'; then \
|
joachim99@14
|
108 list='$(SUBDIRS)'; \
|
joachim99@14
|
109 for subdir in $$list; do \
|
joachim99@14
|
110 if grep '^include .*Doxyfile.am' $(srcdir)/$$subdir/Makefile.am; then \
|
joachim99@14
|
111 echo "Making apidox in $$subdir"; \
|
joachim99@14
|
112 if test "$$subdir" != "."; then \
|
joachim99@14
|
113 (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) GENERATE_FLAG=no apidox) || exit 1; \
|
joachim99@14
|
114 fi ; fi ;\
|
joachim99@14
|
115 done; \
|
joachim99@14
|
116 for subdir in $$list; do \
|
joachim99@14
|
117 if grep '^include .*Doxyfile.am' $(srcdir)/$$subdir/Makefile.am; then \
|
joachim99@14
|
118 echo "Making apidox in $$subdir"; \
|
joachim99@14
|
119 if test "$$subdir" != "."; then \
|
joachim99@14
|
120 (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) GENERATE_FLAG=yes apidox) || exit 1; \
|
joachim99@14
|
121 fi ; fi ;\
|
joachim99@14
|
122 done; \
|
joachim99@14
|
123 fi
|
joachim99@14
|
124
|
joachim99@14
|
125 apidox-am-toplevel-no:
|
joachim99@14
|
126 apidox-am-toplevel-yes:
|
joachim99@14
|
127 @echo "*** Creating API documentation main page"; \
|
joachim99@14
|
128 cp $(top_srcdir)/admin/Doxyfile.global Doxyfile; \
|
joachim99@14
|
129 echo "PROJECT_NAME = $(DOXYGEN_PROJECT_NAME)" >> Doxyfile ; \
|
joachim99@14
|
130 echo "PROJECT_NUMBER = $(DOXYGEN_PROJECT_NUMBER)" >> Doxyfile ; \
|
joachim99@14
|
131 echo "INPUT = $(top_srcdir)" >> Doxyfile ; \
|
joachim99@14
|
132 echo "OUTPUT_DIRECTORY = $(top_builddir)/apidocs" >> Doxyfile ; \
|
joachim99@14
|
133 echo "FILE_PATTERNS = *.dox" >> Doxyfile ; \
|
joachim99@14
|
134 echo "RECURSIVE = NO" >> Doxyfile ; \
|
joachim99@14
|
135 echo "SOURCE_BROWSER = NO" >> Doxyfile ; \
|
joachim99@14
|
136 echo "ALPHABETICAL_INDEX = NO" >> Doxyfile ; \
|
joachim99@14
|
137 echo "HTML_OUTPUT = ." >> Doxyfile ; \
|
joachim99@14
|
138 echo "HTML_HEADER = apidocs/common/mainheader.html" >> Doxyfile ; \
|
joachim99@14
|
139 echo "HTML_FOOTER = apidocs/common/mainfooter.html" >> Doxyfile ; \
|
joachim99@14
|
140 echo "HTML_STYLESHEET = apidocs/common/doxygen.css" >> Doxyfile ; \
|
joachim99@14
|
141 echo "GENERATE_LATEX = NO" >> Doxyfile ; \
|
joachim99@14
|
142 echo "GENERATE_RTF = NO" >> Doxyfile ; \
|
joachim99@14
|
143 echo "GENERATE_MAN = NO" >> Doxyfile ; \
|
joachim99@14
|
144 echo "GENERATE_XML = NO" >> Doxyfile ; \
|
joachim99@14
|
145 echo "GENERATE_AUTOGEN_DEF = NO" >> Doxyfile ; \
|
joachim99@14
|
146 echo "ENABLE_PREPROCESSING = NO" >> Doxyfile ; \
|
joachim99@14
|
147 echo "CLASS_DIAGRAMS = NO" >> Doxyfile ; \
|
joachim99@14
|
148 echo "HAVE_DOT = NO" >> Doxyfile ; \
|
joachim99@14
|
149 echo "GENERATE_HTML = YES" >> Doxyfile ;\
|
joachim99@14
|
150 $(mkinstalldirs) $(top_builddir)/apidocs ; \
|
joachim99@14
|
151 rm -f $(top_builddir)/apidocs/common ; \
|
joachim99@14
|
152 if test -d $(top_srcdir)/doc/common; then \
|
joachim99@14
|
153 common_dir=`cd $(top_srcdir)/doc/common && pwd` ;\
|
joachim99@14
|
154 else \
|
joachim99@14
|
155 common_dir=$(kde_libs_htmldir)/en/common ;\
|
joachim99@14
|
156 fi ;\
|
joachim99@14
|
157 $(LN_S) $$common_dir $(top_builddir)/apidocs/common ;\
|
joachim99@14
|
158 doxygen Doxyfile; \
|
joachim99@14
|
159 rm -f Doxyfile
|
joachim99@14
|
160
|
joachim99@14
|
161 # Local Variables:
|
joachim99@14
|
162 # mode: makefile
|
joachim99@14
|
163 # End:
|