bind/doc/meson.build

# Copyright (C) Internet Systems Consortium, Inc. ("ISC")
#
# SPDX-License-Identifier: MPL-2.0
#
# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0.  If a copy of the MPL was not distributed with this
# file, you can obtain one at https://mozilla.org/MPL/2.0/.
#
# See the COPYRIGHT file distributed with this work for additional
# information regarding copyright ownership.

# Manpages can be build without sphinx
subdir('man')

if not sphinx_build.found()
    subdir_done()
endif

subdir('arm')
subdir('dnssec-guide')
subdir('misc')
replace the build system with meson Meson is a modern build system that has seen a rise in adoption and some version of it is available in almost every platform supported. Compared to automake, meson has the following advantages: * Meson provides a significant boost to the build and configuration time by better exploiting parallelism. * Meson is subjectively considered to be better in readability. These merits alone justify experimenting with meson as a way of improving development time and ergonomics. However, there are some compromises to ensure the transition goes relatively smooth: * The system tests currently rely on various files within the source directory. Changing this requirement is a non-trivial task that can't be currently justified. Currently the last compiled build directory writes into the source tree which is in turn used by pytest. * The minimum version supported has been fixed at 0.61. Increasing this value will require choosing a baseline of distributions that can package with meson. On the contrary, there will likely be an attempt to decrease this value to ensure almost universal support for building BIND 9 with meson. 2024-04-16 15:13:53 +03:00			`# Copyright (C) Internet Systems Consortium, Inc. ("ISC")`
			`#`
			`# SPDX-License-Identifier: MPL-2.0`
			`#`
			`# This Source Code Form is subject to the terms of the Mozilla Public`
			`# License, v. 2.0. If a copy of the MPL was not distributed with this`
			`# file, you can obtain one at https://mozilla.org/MPL/2.0/.`
			`#`
			`# See the COPYRIGHT file distributed with this work for additional`
			`# information regarding copyright ownership.`

			`# Manpages can be build without sphinx`
			`subdir('man')`

			`if not sphinx_build.found()`
			`subdir_done()`
			`endif`

			`subdir('arm')`
			`subdir('dnssec-guide')`
Fix cross builds Commit 5c9b4f3163e05f64b97d04cba2c17ef59d682830 inadvertently broke cross builds by making Meson process the doc/misc/meson.build file even when sphinx-build is not found in PATH. The doc/misc/meson.build file defines targets that require a non-native executable, cfg_test, in order to be built. Fix by reverting to only processing the doc/misc/ subdirectory when sphinx-build is found in PATH and moving the relevant alias_target() method call so that the build targets depending on a non-native executable are only defined if sphinx-build is found in PATH. 2025-07-10 16:56:15 +02:00			`subdir('misc')`