From aa686a25939323e27054843f57ed1dffb10925e4 Mon Sep 17 00:00:00 2001 From: lns Date: Sun, 29 May 2022 00:27:10 +0200 Subject: Use Doxygen to generate the API documentation. * Integrated Doxygen documentation into Sphinx Signed-off-by: lns --- doc/Makefile | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) (limited to 'doc/Makefile') diff --git a/doc/Makefile b/doc/Makefile index 5394470d3..ccffc95f7 100644 --- a/doc/Makefile +++ b/doc/Makefile @@ -22,8 +22,8 @@ I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . .PHONY: help help: @echo "Please use \`make ' where is one of" - @echo " release to make standalone HTML files for ntop documentation release" - @echo " html to make standalone HTML files" + @echo " release to make standalone Doxygen/HTML files for ntop documentation release" + @echo " html to make standalone Doxygen/HTML files" @echo " dirhtml to make HTML files named index.html in directories" @echo " singlehtml to make a single large HTML file" @echo " pickle to make pickle files" @@ -50,12 +50,15 @@ help: .PHONY: clean clean: - rm -rf $(BUILDDIR)/* - cd doxygen; make clean + rm -rf $(BUILDDIR)/* api doxygen .PHONY: html html: - cd doxygen; make + @test -r Doxyfile.cfg || { \ + echo 'Doxyfile.cfg does not exist; Please run $(realpath ..)/autogen.sh or $(realpath ..)/configure first.'; \ + false; \ + } + doxygen Doxyfile.cfg $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html @echo @echo "Build finished. The HTML pages are in $(BUILDDIR)/html." -- cgit v1.2.3