<p>Neels Hofmeyr has uploaded this change for <strong>review</strong>.</p><p><a href="https://gerrit.osmocom.org/12776">View Change</a></p><pre style="font-family: monospace,monospace; white-space: pre-wrap;">doxygen: allow manual 'make apidoc' even if --disable-doxygen<br><br>Even if ./configure --disable-doxygen was passed and doxygen builds are by<br>default skipped, provide a manual 'make apidoc' target that nevertheless<br>generates the API doc on the premise that a 'doxygen' program is available.<br><br>Especially since we do a two-pass doxygen build whenever any source file<br>changes, my guess is --disable-doxygen could be a common choice. It is then<br>cumbersome to have to ./configure just to get one doxygen build started.<br><br>Change-Id: If8d8dfb8365c8f28612b8ce2b8ddf88f74df9a90<br>---<br>M Makefile.am<br>1 file changed, 17 insertions(+), 8 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;">git pull ssh://gerrit.osmocom.org:29418/libosmocore refs/changes/76/12776/1</pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/Makefile.am b/Makefile.am</span><br><span>index 07fd666..ee3ad2e 100644</span><br><span>--- a/Makefile.am</span><br><span>+++ b/Makefile.am</span><br><span>@@ -24,19 +24,27 @@</span><br><span> </span><br><span> EXTRA_DIST = git-version-gen .version README.md osmo-release.mk osmo-release.sh</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-if HAVE_DOXYGEN</span><br><span style="color: hsl(120, 100%, 40%);">+HTML = \</span><br><span style="color: hsl(120, 100%, 40%);">+ $(top_builddir)/doc/core/html/index.html \</span><br><span style="color: hsl(120, 100%, 40%);">+ $(top_builddir)/doc/gsm/html/index.html \</span><br><span style="color: hsl(120, 100%, 40%);">+ $(top_builddir)/doc/vty/html/index.html \</span><br><span style="color: hsl(120, 100%, 40%);">+ $(top_builddir)/doc/codec/html/index.html \</span><br><span style="color: hsl(120, 100%, 40%);">+ $(top_builddir)/doc/coding/html/index.html \</span><br><span style="color: hsl(120, 100%, 40%);">+ $(top_builddir)/doc/ctrl/html/index.html \</span><br><span style="color: hsl(120, 100%, 40%);">+ $(top_builddir)/doc/gb/html/index.html</span><br><span> </span><br><span style="color: hsl(120, 100%, 40%);">+if HAVE_DOXYGEN</span><br><span> html_DATA = $(top_builddir)/doc/html.tar</span><br><span> </span><br><span> doc: $(html_DATA)</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-$(html_DATA): $(top_builddir)/doc/core/html/index.html \</span><br><span style="color: hsl(0, 100%, 40%);">- $(top_builddir)/doc/gsm/html/index.html \</span><br><span style="color: hsl(0, 100%, 40%);">- $(top_builddir)/doc/vty/html/index.html \</span><br><span style="color: hsl(0, 100%, 40%);">- $(top_builddir)/doc/codec/html/index.html \</span><br><span style="color: hsl(0, 100%, 40%);">- $(top_builddir)/doc/coding/html/index.html \</span><br><span style="color: hsl(0, 100%, 40%);">- $(top_builddir)/doc/ctrl/html/index.html \</span><br><span style="color: hsl(0, 100%, 40%);">- $(top_builddir)/doc/gb/html/index.html</span><br><span style="color: hsl(120, 100%, 40%);">+$(html_DATA): apidoc</span><br><span style="color: hsl(120, 100%, 40%);">+else</span><br><span style="color: hsl(120, 100%, 40%);">+DOXYGEN=doxygen</span><br><span style="color: hsl(120, 100%, 40%);">+endif</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+.PHONY: apidoc</span><br><span style="color: hsl(120, 100%, 40%);">+apidoc: $(HTML)</span><br><span> cd $(top_builddir)/doc && tar cf html.tar */html</span><br><span> </span><br><span> # Support doxygen cross references from each library to each other library:</span><br><span>@@ -193,6 +201,7 @@</span><br><span> rm -rf $(top_builddir)/doc/gb; mkdir -p $(top_builddir)/doc/gb</span><br><span> $(DOXYGEN) Doxyfile.gb</span><br><span> </span><br><span style="color: hsl(120, 100%, 40%);">+if HAVE_DOXYGEN</span><br><span> install-data-hook:</span><br><span> cd $(DESTDIR)$(htmldir) && tar xf html.tar && rm -f html.tar</span><br><span> </span><br><span></span><br></pre><p>To view, visit <a href="https://gerrit.osmocom.org/12776">change 12776</a>. To unsubscribe, or for help writing mail filters, visit <a href="https://gerrit.osmocom.org/settings">settings</a>.</p><div itemscope itemtype="http://schema.org/EmailMessage"><div itemscope itemprop="action" itemtype="http://schema.org/ViewAction"><link itemprop="url" href="https://gerrit.osmocom.org/12776"/><meta itemprop="name" content="View Change"/></div></div>
<div style="display:none"> Gerrit-Project: libosmocore </div>
<div style="display:none"> Gerrit-Branch: master </div>
<div style="display:none"> Gerrit-MessageType: newchange </div>
<div style="display:none"> Gerrit-Change-Id: If8d8dfb8365c8f28612b8ce2b8ddf88f74df9a90 </div>
<div style="display:none"> Gerrit-Change-Number: 12776 </div>
<div style="display:none"> Gerrit-PatchSet: 1 </div>
<div style="display:none"> Gerrit-Owner: Neels Hofmeyr <nhofmeyr@sysmocom.de> </div>