The Meson Build System http://mesonbuild.com/

History

Patrick Steinhardt 43ea11ea49 compilers: convert `b_sanitize` to a free-form array option In the preceding commit we have started to perform compiler checks for the value of `b_sanitize`, which allows us to detect sanitizers that aren't supported by the compiler toolchain. But we haven't yet loosened the option itself to accept arbitrary values, so until now it's still only possible to pass sanitizer combinations known by Meson, which is quite restrictive. Lift that restriction by adapting the `b_sanitize` option to become a free-form array. Like this, users can pass whatever combination of comma-separated sanitizers to Meson, which will then figure out whether that combination is supported via the compiler checks. This lifts a couple of restrictions and makes the supporting infrastructure way more future proof. A couple of notes regarding backwards compatibility: - All previous values of `b_sanitize` will remain valid as the syntax for free-form array values and valid combo choices is the same. We also treat 'none' specially so that we know to convert it into an empty array. - Even though the option has been converted into a free-form array, callers of `get_option('b_sanitize')` continue to get a string as value. We may eventually want to introduce a kwarg to alter this behaviour, but for now it is expected to be good enough for most use cases. Fixes #8283 Fixes #7761 Fixes #5154 Fixes #1582 Co-authored-by: Dylan Baker <dylan@pnwbakers.com> Signed-off-by: Patrick Steinhardt <ps@pks.im>		2 weeks ago
..
extensions	Fix typos in docs	2 years ago
markdown	compilers: convert `b_sanitize` to a free-form array option	2 weeks ago
refman	Fix typos	6 months ago
theme/extra	modules/wayland: Add unstable_wayland module	3 years ago
yaml	allow to compare multiple version with version_compare	2 months ago
.editorconfig	compilers/d: Add b_ndebug support	5 years ago
README.md	docs: mention additional python modules needed for building	2 years ago
genrefman.py	Use SPDX-License-Identifier consistently	1 year ago
genrelnotes.py	Use SPDX-License-Identifier consistently	1 year ago
jsonvalidator.py	Use SPDX-License-Identifier consistently	1 year ago
meson.build	docs: do not require aiohttp to build	2 months ago
meson_options.txt	docs: add option to skip building HTML docs	2 years ago
sitemap.txt	docs: provide details about how to fund Meson development	3 weeks ago
validatelinks.py	docs: Add a test to validate URLs in markdown/Users.md	2 months ago

README.md

Meson Documentation

Build dependencies

Meson uses itself and hotdoc for generating documentation.

Minimum required version of hotdoc is 0.8.9.

Instructions on how to install hotdoc are here.

Our custom hotdoc extensions require:

Building the documentation

From the Meson repository root dir:

$ cd docs/
$ meson setup built_docs/
$ ninja -C built_docs/

Now you should be able to open the documentation locally

built_docs/Meson documentation-doc/html/index.html

Upload

Meson uses the git-upload hotdoc plugin which basically removes the html pages and replaces with the new content.

You can simply run:

$ ninja -C built_docs/ upload