admin/Doxyfile.am

   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: