meson.build: Check if Perl is required for building documentation

kjellahl · kjellahl · commit 0923202ee3a8 · 2021-08-18T09:02:57.000+02:00
New versions of mm-common use the Python scripts doc_postprocess.py
and doc_install.py instead of the Perl scripts doc-postprocess.pl and
doc-install.pl when documentation is built.
diff --git a/meson.build b/meson.build
@@ -161,7 +161,6 @@ if maintainer_mode and not mm_common_get.found()
   # subproject only if mm-common-get is required.
   mm_common_get = find_program('mm-common-get', required: true)
 endif
-perl = find_program('perl', required: build_documentation)
 doxygen = find_program('doxygen', required: build_documentation)
 dot = find_program('dot', required: build_documentation) # Used by Doxygen
 xsltproc = find_program('xsltproc', required: build_documentation)
@@ -172,6 +171,10 @@ doc_reference_py = script_dir / 'doc-reference.py'
 dist_changelog_py = script_dir / 'dist-changelog.py'
 dist_build_scripts_py = script_dir / 'dist-build-scripts.py'
 
+# xmlxx's own script files.
+xmlxx_script_dir = project_source_root / 'tools' / 'build_scripts'
+tutorial_custom_cmd_py = xmlxx_script_dir / 'tutorial-custom-cmd.py'
+
 if maintainer_mode
   # Copy files to untracked/build_scripts and untracked/docs.
   run_command(mm_common_get, '--force', script_dir,
@@ -189,9 +192,15 @@ sys.exit(os.path.isfile("@0@"))
   endif
 endif
 
-# xmlxx's own script files.
-xmlxx_script_dir = project_source_root / 'tools' / 'build_scripts'
-tutorial_custom_cmd_py = xmlxx_script_dir / 'tutorial-custom-cmd.py'
+# Check if perl is required and available.
+doc_perl_prop = run_command(
+  python3, doc_reference_py, 'get_script_property',
+  '', # MMDOCTOOLDIR is not used
+  'requires_perl')
+if not (doc_perl_prop.returncode() == 0 and doc_perl_prop.stdout() == 'false')
+  # Perl is required, if documentation shall be built.
+  perl = find_program('perl', required: build_documentation)
+endif
 
 # Add toolset version in builds done with Visual Studio 2017 or later
 msvc14x_toolset_ver = ''
diff --git a/untracked/README b/untracked/README
@@ -15,8 +15,8 @@ or the tarball is created with Meson.
 
 1. Files copied by mm-common-get
 --------------------------------
-untracked/docs/doc-install.pl
-               doc-postprocess.pl
+untracked/docs/doc_install.py or doc-install.pl
+               doc_postprocess.py or doc-postprocess.pl
                doxygen-extra.css
                tagfile-to-devhelp2.xsl
 untracked/build_scripts/dist-build-scripts.py
