summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKjell Ahlstedt <kjellahlstedt@gmail.com>2020-06-29 15:44:02 +0200
committerKjell Ahlstedt <kjellahlstedt@gmail.com>2020-06-29 15:44:02 +0200
commitdb75c985f7f9659613d31f9b97ca4b7d00b5d64b (patch)
treedcda840f656f5447a246914d272831baca6f7523
parenta7504766aa2d0c714729df6992237c383f02fd31 (diff)
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.build14
2 files changed, 8 insertions, 8 deletions
diff --git a/docs/reference/Doxyfile.in b/docs/reference/Doxyfile.in
index ce05665..f35f5a0 100644
--- a/docs/reference/Doxyfile.in
+++ b/docs/reference/Doxyfile.in
@@ -304,12 +304,10 @@ GENERATE_TAGFILE = "reference/@CAIROMM_MODULE_NAME@.tag"
ALLEXTERNALS = NO
EXTERNAL_GROUPS = NO
EXTERNAL_PAGES = YES
-PERL_PATH = @PERL@
#---------------------------------------------------------------------------
# Configuration options related to the dot tool
#---------------------------------------------------------------------------
CLASS_DIAGRAMS = NO
-MSCGEN_PATH =
DIA_PATH =
HIDE_UNDOC_RELATIONS = NO
HAVE_DOT = YES
diff --git a/docs/reference/meson.build b/docs/reference/meson.build
index ad74f33..c0fa34a 100644
--- a/docs/reference/meson.build
+++ b/docs/reference/meson.build
@@ -1,8 +1,8 @@
# docs/reference
# Input: project_build_root, project_source_root, cairomm_pcname,
-# perl, build_documentation, source_h_files,
-# install_datadir, python3, doc_reference_py
+# build_documentation, source_h_files, install_datadir, python3,
+# doc_reference_py
# Output: install_docdir, install_devhelpdir, book_name
# There are no built source files in cairomm.
@@ -25,10 +25,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 +48,6 @@ doc_conf_data.set('abs_top_builddir', project_build_root)
doc_conf_data.set('abs_top_srcdir', project_source_root)
doc_conf_data.set('CAIROMM_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',