mirror of
https://github.com/mesonbuild/meson.git
synced 2026-11-06 05:16:42 +00:00
With the `cpp_importstd` option and the MSVC compiler, meson now builds the module with the arguments of the targets that matter to the compiler when it imports the module: the C runtime, the character set, the C++ standard, the exception and floating point options, the macros read by the standard library, and so on. This prevents reporting a C5050 warning, which would become an error if using `werror`. Arguments that do not matter, such as warnings, optimization and include directories, are ignored. A module is built for each different set of arguments, and shared by the targets that have the same one, so the files in the build directory are named `std.<id>.ifc`. The module is no longer built through a compiler cache, which cannot restore it.
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