diff options
| author | Neels Hofmeyr <neels@hofmeyr.de> | 2019-02-01 05:56:09 +0100 |
|---|---|---|
| committer | Neels Hofmeyr <nhofmeyr@sysmocom.de> | 2019-02-04 16:43:57 +0000 |
| commit | 44c15b7a8fadff949e79be0b843ec9caca61901c (patch) | |
| tree | 7da4bc2b7096843e40921fd6fca4e946678285cb | |
| parent | 375bf6dcc503626af4c6f7fc36828008b7eb874e (diff) | |
doxygen: allow manual 'make apidoc' even if --disable-doxygen
Even if ./configure --disable-doxygen was passed and doxygen builds are by
default skipped, provide a manual 'make apidoc' target that nevertheless
generates the API doc on the premise that a 'doxygen' program is available.
Especially since we do a two-pass doxygen build whenever any source file
changes, my guess is --disable-doxygen could be a common choice. It is then
cumbersome to have to ./configure just to get one doxygen build started.
Change-Id: If8d8dfb8365c8f28612b8ce2b8ddf88f74df9a90
| -rw-r--r-- | Makefile.am | 25 |
1 files changed, 17 insertions, 8 deletions
diff --git a/Makefile.am b/Makefile.am index 8fe5f57c..332ce653 100644 --- a/Makefile.am +++ b/Makefile.am @@ -24,19 +24,27 @@ dist-hook: EXTRA_DIST = git-version-gen .version README.md osmo-release.mk osmo-release.sh -if HAVE_DOXYGEN +HTML = \ + $(top_builddir)/doc/core/html/index.html \ + $(top_builddir)/doc/gsm/html/index.html \ + $(top_builddir)/doc/vty/html/index.html \ + $(top_builddir)/doc/codec/html/index.html \ + $(top_builddir)/doc/coding/html/index.html \ + $(top_builddir)/doc/ctrl/html/index.html \ + $(top_builddir)/doc/gb/html/index.html +if HAVE_DOXYGEN html_DATA = $(top_builddir)/doc/html.tar doc: $(html_DATA) -$(html_DATA): $(top_builddir)/doc/core/html/index.html \ - $(top_builddir)/doc/gsm/html/index.html \ - $(top_builddir)/doc/vty/html/index.html \ - $(top_builddir)/doc/codec/html/index.html \ - $(top_builddir)/doc/coding/html/index.html \ - $(top_builddir)/doc/ctrl/html/index.html \ - $(top_builddir)/doc/gb/html/index.html +$(html_DATA): apidoc +else +DOXYGEN=doxygen +endif + +.PHONY: apidoc +apidoc: $(HTML) cd $(top_builddir)/doc && tar cf html.tar */html # Support doxygen cross references from each library to each other library: @@ -193,6 +201,7 @@ $(top_builddir)/doc/gb/html/index.html: $(top_builddir)/doc/libosmogb.tag.prep \ rm -rf $(top_builddir)/doc/gb; mkdir -p $(top_builddir)/doc/gb $(DOXYGEN) Doxyfile.gb +if HAVE_DOXYGEN install-data-hook: cd $(DESTDIR)$(htmldir) && tar xf html.tar && rm -f html.tar |