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

History

Dylan Baker c708c52ca2 linkers: Update the linker names to be more consistent This makes two basic changes, 1 it moves the name of the linker into the linker class, this should reduce the number of errors and typos, and ensure that a linker always has one name. This then renames the linkers to have more consistent names. Posix/gnu linkers are called ld.<name>: ld.gold, ld.lld, ld.solaris. Apple linkers are renamed ld64.		5 years ago
..
markdown	linkers: Update the linker names to be more consistent	5 years ago
theme/extra	docs: Fix link to SourceSet module in the navbar [skip ci]	5 years ago
.editorconfig	editorconfig: Use tabs for sitemap.txt [skip ci]	6 years ago
README.md	Update Meson docs README [skip ci]	6 years ago
genrelnotes.py	Update Python2 syntax to Python3 syntax in genrelnotes.py	5 years ago
meson.build	Upgrade to newest hotdoc. [skip ci]	6 years ago
sitemap.txt	Prepare new release.	5 years ago

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.

From the Meson repository root dir:

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

Now you should be able to open the documentation locally

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

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

Commits that only change documentation should have [skip ci] in their commit message, so CI is not run (it is quite slow). For example:

A commit message [skip ci]