summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKjell Ahlstedt <kjellahlstedt@gmail.com>2020-06-29 15:06:25 +0200
committerKjell Ahlstedt <kjellahlstedt@gmail.com>2020-06-29 15:06:25 +0200
commitaf5e66e0240581a2f712ee907796b3aa8b4d33d6 (patch)
treefecf28e86066b40400fbe39d11d5e0dfb0d0bf91
parent4765f0fc824c805b7394cba3cbe43bda8c424f44 (diff)
downloadglibmm-af5e66e0240581a2f712ee907796b3aa8b4d33d6.tar.gz
docs/reference/: Update for Doxygen >= 1.8.16
* docs/reference/meson.build: Doxygen 1.8.16 and later does not store tag file names in the html files. This requires changes in meson.build and in doc-install.pl (in mm-common). Otherwise references to other modules won't be updated in the html files when they are installed. * docs/reference/Doxyfile.in: Remove PERL_PATH and MSCGEN_PATH. Doxygen since version 1.8.0 does not use them.
-rw-r--r--docs/reference/Doxyfile.in2
-rw-r--r--docs/reference/meson.build15
2 files changed, 8 insertions, 9 deletions
diff --git a/docs/reference/Doxyfile.in b/docs/reference/Doxyfile.in
index 51dec039..10145909 100644
--- a/docs/reference/Doxyfile.in
+++ b/docs/reference/Doxyfile.in
@@ -323,12 +323,10 @@ GENERATE_TAGFILE = "reference/@GLIBMM_MODULE_NAME@.tag"
ALLEXTERNALS = NO
EXTERNAL_GROUPS = NO
EXTERNAL_PAGES = YES
-PERL_PATH = @PERL@
#---------------------------------------------------------------------------
# Configuration options related to the dot tool
#---------------------------------------------------------------------------
CLASS_DIAGRAMS = YES
-MSCGEN_PATH =
DIA_PATH =
HIDE_UNDOC_RELATIONS = NO
HAVE_DOT = YES
diff --git a/docs/reference/meson.build b/docs/reference/meson.build
index e9582df6..9590e26a 100644
--- a/docs/reference/meson.build
+++ b/docs/reference/meson.build
@@ -1,10 +1,9 @@
# docs/reference
# Input: built_files_root, project_source_root, glibmm_pcname, giomm_pcname,
-# perl, glibmm_hg_ccg_basenames, giomm_hg_ccg_basenames,
+# glibmm_hg_ccg_basenames, giomm_hg_ccg_basenames, build_documentation,
# glibmm_extra_h_files, giomm_extra_h_files, glibmm_built_h_file_targets,
-# giomm_built_h_file_targets, install_datadir, python3, doc_reference_py,
-# build_documentation
+# giomm_built_h_file_targets, install_datadir, python3, doc_reference_py
# Output: install_docdir, install_devhelpdir
tag_file_modules = [
@@ -25,10 +24,13 @@ foreach module : tag_file_modules
htmlrefdir = htmlrefpub
endif
doxygen_tagfiles += ' "' + doxytagfile + '=' + htmlrefpub + '"'
- if not htmlrefdir.endswith('/')
- htmlrefdir += '/'
- endif
+
+ # Doxygen <= 1.8.15
docinstall_flags += ['-l', doxytagfile.split('/')[-1] + '@' + htmlrefdir]
+ if htmlrefpub != htmlrefdir
+ # Doxygen >= 1.8.16
+ docinstall_flags += ['-l', 's@' + htmlrefpub + '@' + htmlrefdir]
+ endif
endif
endforeach
@@ -45,7 +47,6 @@ doc_conf_data.set('abs_top_builddir', built_files_root)
doc_conf_data.set('abs_top_srcdir', project_source_root)
doc_conf_data.set('GLIBMM_MODULE_NAME', book_name)
doc_conf_data.set('DOXYGEN_TAGFILES', doxygen_tagfiles)
-doc_conf_data.set('PERL', perl.found() ? perl.path() : '')
configure_file(
input: 'Doxyfile.in',