| 1 | ## generate API documentation with doxygen
|
|---|
| 2 | apidox-am-yes:
|
|---|
| 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` ;\
|
|---|
| 8 | else \
|
|---|
| 9 | common_dir=$(kde_libs_htmldir)/en/common ;\
|
|---|
| 10 | fi ;\
|
|---|
| 11 | $(LN_S) $$common_dir $(top_builddir)/apidocs/common; \
|
|---|
| 12 | fi ;\
|
|---|
| 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 \
|
|---|
| 30 | patterns= ;\
|
|---|
| 31 | dirs= ;\
|
|---|
| 32 | for item in `echo "$(DOXYGEN_EXCLUDE)"`; do \
|
|---|
| 33 | if test -d "$(srcdir)/$$item"; then \
|
|---|
| 34 | dirs="$$dirs $(srcdir)/$$item/" ;\
|
|---|
| 35 | else \
|
|---|
| 36 | patterns="$$patterns $$item" ;\
|
|---|
| 37 | fi ;\
|
|---|
| 38 | done ;\
|
|---|
| 39 | echo "EXCLUDE_PATTERNS += $$patterns" >> Doxyfile; \
|
|---|
| 40 | echo "EXCLUDE += $$dirs" >> Doxyfile ;\
|
|---|
| 41 | fi ;\
|
|---|
| 42 | echo "TAGFILES = \\" >> Doxyfile; \
|
|---|
| 43 | tags='$(DOXYGEN_REFERENCES) qt'; for tag in $$tags; do \
|
|---|
| 44 | tagpath= ;\
|
|---|
| 45 | path="../../$$tag" ;\
|
|---|
| 46 | if test -f $(top_builddir)/apidocs/$$tag/$$tag.tag; then \
|
|---|
| 47 | tagpath="$(top_builddir)/apidocs/$$tag/$$tag.tag" ;\
|
|---|
| 48 | else \
|
|---|
| 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,"` ;\
|
|---|
| 52 | fi ;\
|
|---|
| 53 | fi ;\
|
|---|
| 54 | if test "$$tag" = qt; then \
|
|---|
| 55 | echo $$tagpath=$(QTDOCDIR) >> Doxyfile ;\
|
|---|
| 56 | else if test -n "$$tagpath"; then \
|
|---|
| 57 | echo "$$tagpath=$$path/html \\" >> Doxyfile ;\
|
|---|
| 58 | fi ;\
|
|---|
| 59 | fi ;\
|
|---|
| 60 | done ;\
|
|---|
| 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 ;\
|
|---|
| 65 | fi
|
|---|
| 66 |
|
|---|
| 67 | apidox-am-no:
|
|---|
| 68 |
|
|---|
| 69 | install-data-local: install-apidox
|
|---|
| 70 |
|
|---|
| 71 | ## install API documentation
|
|---|
| 72 | install-apidox:
|
|---|
| 73 | @if test "$(subdir)" != "."; then \
|
|---|
| 74 | $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs/$(subdir)/html ; \
|
|---|
| 75 | if test -f $(top_builddir)/apidocs/$(subdir)/$(subdir).tag; then \
|
|---|
| 76 | echo $(INSTALL_DATA) $(top_builddir)/apidocs/$(subdir)/$(subdir).tag $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs/$(subdir); \
|
|---|
| 77 | $(INSTALL_DATA) $(top_builddir)/apidocs/$(subdir)/$(subdir).tag $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs/$(subdir); \
|
|---|
| 78 | fi; \
|
|---|
| 79 | if test -d $(top_builddir)/apidocs/$(subdir)/html; then \
|
|---|
| 80 | list=`ls $(top_builddir)/apidocs/$(subdir)/html`; \
|
|---|
| 81 | echo "installing $(top_builddir)/apidocs/$(subdir)/html" ;\
|
|---|
| 82 | for file in $$list; do \
|
|---|
| 83 | $(INSTALL_DATA) $(top_builddir)/apidocs/$(subdir)/html/$$file $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs/$(subdir)/html; \
|
|---|
| 84 | done; \
|
|---|
| 85 | fi; \
|
|---|
| 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; \
|
|---|
| 88 | else\
|
|---|
| 89 | if test -d $(top_builddir)/apidocs; then \
|
|---|
| 90 | $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs ;\
|
|---|
| 91 | list=`cd $(top_builddir)/apidocs && ls -1`; \
|
|---|
| 92 | echo "installing $(top_builddir)/apidocs/$$file" ;\
|
|---|
| 93 | for file in $$list; do \
|
|---|
| 94 | if test -f $(top_builddir)/apidocs/$$file; then \
|
|---|
| 95 | $(INSTALL_DATA) $(top_builddir)/apidocs/$$file $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs; \
|
|---|
| 96 | fi; \
|
|---|
| 97 | done ; fi; \
|
|---|
| 98 | fi
|
|---|
| 99 |
|
|---|
| 100 | uninstall-local: uninstall-apidox
|
|---|
| 101 |
|
|---|
| 102 | ## uninstall API documentation
|
|---|
| 103 | uninstall-apidox:
|
|---|
| 104 | @if test "$(subdir)" != "."; then \
|
|---|
| 105 | if test -d $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs/$(subdir); then \
|
|---|
| 106 | rm -rfv $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs/$(subdir); \
|
|---|
| 107 | fi\
|
|---|
| 108 | else\
|
|---|
| 109 | if test -d $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs; then \
|
|---|
| 110 | rm -rfv $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs; \
|
|---|
| 111 | fi\
|
|---|
| 112 | fi
|
|---|
| 113 |
|
|---|
| 114 | apidox:
|
|---|
| 115 | @if test "$(subdir)" != "."; then \
|
|---|
| 116 | $(MAKE) apidox-am-@KDE_HAS_DOXYGEN@ ;\
|
|---|
| 117 | else \
|
|---|
| 118 | $(MAKE) apidox-am-toplevel-@KDE_HAS_DOXYGEN@ ;\
|
|---|
| 119 | fi
|
|---|
| 120 | @set fnord $(MAKEFLAGS); amf=$$2; if test -n '$(SUBDIRS)'; then \
|
|---|
| 121 | list='$(SUBDIRS)'; \
|
|---|
| 122 | 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; \
|
|---|
| 127 | fi ; fi ;\
|
|---|
| 128 | done; \
|
|---|
| 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; \
|
|---|
| 134 | fi ; fi ;\
|
|---|
| 135 | done; \
|
|---|
| 136 | fi
|
|---|
| 137 |
|
|---|
| 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` ;\
|
|---|
| 167 | else \
|
|---|
| 168 | common_dir=$(kde_libs_htmldir)/en/common ;\
|
|---|
| 169 | fi ;\
|
|---|
| 170 | $(LN_S) $$common_dir $(top_builddir)/apidocs/common ;\
|
|---|
| 171 | doxygen Doxyfile; \
|
|---|
| 172 | rm -f Doxyfile
|
|---|
| 173 |
|
|---|
| 174 | .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
|
|---|
| 175 |
|
|---|
| 176 |
|
|---|
| 177 | # Local Variables:
|
|---|
| 178 | # mode: makefile
|
|---|
| 179 | # End:
|
|---|