From f5afea3421ea68899d3064b09184c29f30ce0588 Mon Sep 17 00:00:00 2001 From: Albrecht Schlosser Date: Thu, 7 Sep 2023 18:28:55 +0200 Subject: Update Doxyfile.in again, now using all defined doxygen tags The process to generate the docs now uses the full Doxyfile as given by `doxygen -u Doxyfile.in` with a specific doxygen version, in this commit version 1.8.14. There's only one addition: 'HTML_COLORSTYLE = TOGGLE' which has been added to doxygen in version 1.9.5. We're using it now to give the user the choice to select a "dark mode" or "light mode" theme if the docs are generated with doxygen 1.9.5 or later. Unknown doxygen tags are now filtered silently and logged in files documentation/Doxyfile_error.log and documentation/Doxybook_error.log, respectively. --- documentation/Makefile | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) (limited to 'documentation/Makefile') diff --git a/documentation/Makefile b/documentation/Makefile index 559b42719..c75dd567c 100644 --- a/documentation/Makefile +++ b/documentation/Makefile @@ -149,7 +149,7 @@ uninstall-linux uninstall-osx: Doxyfile: Doxyfile.in generated.dox copyright.dox echo "Generating Doxyfile ..." - $(DOXYDOC) -u -s - < $< 2>Doxyfile_error.log | \ + ./convert_doxyfile $(DOXYDOC) $< $@ Doxyfile_error.log sed -e's,@FLTK_VERSION@,$(FLTK_VERSION),' \ -e's,@GENERATE_HTML@,YES,' \ -e's,@GENERATE_LATEX@,NO,' \ @@ -158,10 +158,11 @@ Doxyfile: Doxyfile.in generated.dox copyright.dox -e's,@CMAKE_CURRENT_SOURCE_DIR@,.,' \ -e's,@CMAKE_CURRENT_BINARY_DIR@,,' \ -e's,@FLTK_SOURCE_DIR@,..,' \ - > $@ + -i $@ Doxybook: Doxyfile.in generated.dox copyright.dox echo "Generating Doxybook ..." + ./convert_doxyfile $(DOXYDOC) $< $@ Doxybook_error.log $(DOXYDOC) -u -s - < $< 2>Doxybook_error.log | \ sed -e's,@FLTK_VERSION@,$(FLTK_VERSION),' \ -e's,@GENERATE_HTML@,NO,' \ @@ -171,7 +172,7 @@ Doxybook: Doxyfile.in generated.dox copyright.dox -e's,@CMAKE_CURRENT_SOURCE_DIR@,.,' \ -e's,@CMAKE_CURRENT_BINARY_DIR@,,' \ -e's,@FLTK_SOURCE_DIR@,..,' \ - > $@ + -i $@ # The HTML files are generated using doxygen, and this needs # an installed doxygen version and may take some time, so this target -- cgit v1.2.3