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

History

Dylan Baker cbca191948 interpreter: Handle BuildTarget.vala_args as Files in the interpreter Way back in Meson 0.25, support was added to `vala_args` for Files. Strangely, this was never added to any other language, though it's been discussed before. For type safety, it makes more sense to handle this in the interpreter level, and pass only strings into the build IR. This is accomplished by adding a `depend_files` field to the `BuildTarget` class (which is not exposed to the user), and adding the depend files into that field, while converting the arguments to relative string paths. This ensures both the proper build dependencies happen, as well as that the arguments are always strings.		1 year ago
..
extensions	Fix typos in docs	2 years ago
markdown	Add env kwarg in generator.process()	1 year ago
refman	docs: refman: add vim syntax file generator	1 year ago
theme/extra	modules/wayland: Add unstable_wayland module	3 years ago
yaml	interpreter: Handle BuildTarget.vala_args as Files in the interpreter	1 year 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	docs: Initial reference manual generator	3 years ago
genrelnotes.py	doc: Add date in release notes	2 years ago
jsonvalidator.py	docs: refman: Add `arg_flattening` support	3 years ago
meson.build	docs: mention additional python modules needed for building	2 years ago
meson_options.txt	docs: add option to skip building HTML docs	2 years ago
sitemap.txt	Whoopsie, forgot to create the release notes.	1 year 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