view doc/doxyhtml/module.mk @ 24895:088506eadb44 stable

Enable build of a reduced Doxygen version for compressed Qt help file. Currently a doxygen build is about 2 GB, certainly too much for any file distribution. Thus `make doxyqt` now creates a complete Doxygen build of about 70 MB without dot graphics and Javascript search tools. * doc/doxyhtml/Doxyfile.in: Update year. Build Javascipt search engine by default HTML generation. * doc/doxyhtml/DoxyfileQt.patch: A patch for Doxyfile.in to make the reduced build for compressed Qt help files. * doc/doxyhtml/module.mk: Add target `doxyqt` for reduced build in subfolder `doxyhtml/doxyqt`. Add new files to build system.
author Kai T. Ohlhus <k.ohlhus@gmail.com>
date Thu, 15 Mar 2018 15:01:03 +0100
parents 625784a8429c
children c435048c2796
line wrap: on
line source

# Generate README.md from README and replace first line by a Doxygen
# specific one.
%reldir%/pages/README.md: $(srcdir)/README
	$(MKDIR_P) $(@D)
	cat $< | $(SED) '1s/.*/notitle {#mainpage}/; 2s/.*/=======/' > $@

DOXYGEN_PAGES = \
  %reldir%/pages/macros.dox \
  %reldir%/pages/README.md

doxyqt: %reldir%/Doxyfile $(DOXYGEN_PAGES) | %reldir%/$(octave_dirstamp)
	cp %reldir%/Doxyfile %reldir%/DoxyfileQt
	cat $(srcdir)/%reldir%/DoxyfileQt.patch >> %reldir%/DoxyfileQt
	doxygen %reldir%/DoxyfileQt

doxyhtml: %reldir%/Doxyfile $(DOXYGEN_PAGES) | %reldir%/$(octave_dirstamp)
	doxygen %reldir%/Doxyfile

# This target is important for in source tree builds.
doxyhtml-maintainer-clean:
	$(RM) %reldir%/pages/README.md
	$(RM) -r `ls -d %reldir%/* 2>/dev/null | $(GREP) -v 'module\.mk\|Doxyfile\.in\|DoxyfileQt\.patch\|README\|pages$$'`

doc_EXTRA_DIST += \
  $(DOXYGEN_PAGES) \
  %reldir%/Doxyfile.in \
  %reldir%/DoxyfileQt.patch \
  %reldir%/README

DIRSTAMP_FILES += %reldir%/$(octave_dirstamp)