From a024d75e150334330954bf7a6fdbe8cb02a82491 Mon Sep 17 00:00:00 2001 From: Eli Schwartz Date: Thu, 1 Sep 2022 00:59:41 -0400 Subject: backends: add a new "none" backend It can only be used for projects that don't have any rules at all, i.e. they are purely using Meson to: - configure files - run (script?) tests - install files that exist by the end of the setup stage This can be useful e.g. for Meson itself, a pure python project. --- docs/markdown/Builtin-options.md | 12 +++++++++++- docs/markdown/snippets/none-backend.md | 4 ++++ 2 files changed, 15 insertions(+), 1 deletion(-) create mode 100644 docs/markdown/snippets/none-backend.md (limited to 'docs') diff --git a/docs/markdown/Builtin-options.md b/docs/markdown/Builtin-options.md index f8e94a8..506eff8 100644 --- a/docs/markdown/Builtin-options.md +++ b/docs/markdown/Builtin-options.md @@ -75,7 +75,7 @@ machine](#specifying-options-per-machine) section for details. | Option | Default value | Description | Is per machine | Is per subproject | | -------------------------------------- | ------------- | ----------- | -------------- | ----------------- | | auto_features {enabled, disabled, auto} | auto | Override value of all 'auto' features | no | no | -| backend {ninja, vs,
vs2010, vs2012, vs2013, vs2015, vs2017, vs2019, vs2022, xcode} | ninja | Backend to use | no | no | +| backend {ninja, vs,
vs2010, vs2012, vs2013, vs2015, vs2017, vs2019, vs2022, xcode, none} | ninja | Backend to use | no | no | | buildtype {plain, debug,
debugoptimized, release, minsize, custom} | debug | Build type to use | no | no | | debug | true | Enable debug symbols and other information | no | no | | default_library {shared, static, both} | shared | Default library type | no | yes | @@ -95,6 +95,16 @@ machine](#specifying-options-per-machine) section for details. | wrap_mode {default, nofallback,
nodownload, forcefallback, nopromote} | default | Wrap mode to use | no | no | | force_fallback_for | [] | Force fallback for those dependencies | no | no | +#### Details for `backend` + +Several build file formats are supported as command runners to build the +configured project. Meson prefers ninja by default, but platform-specific +backends are also available for better IDE integration with native tooling: +Visual Studio for Windows, and xcode for macOS. It is also possible to +configure with no backend at all, which is an error if you have targets to +build, but for projects that need configuration + testing + installation allows +for a lighter automated build pipeline. + #### Details for `buildtype` For setting optimization levels and diff --git a/docs/markdown/snippets/none-backend.md b/docs/markdown/snippets/none-backend.md new file mode 100644 index 0000000..766430d --- /dev/null +++ b/docs/markdown/snippets/none-backend.md @@ -0,0 +1,4 @@ +## New "none" backend + +The `--backend=none` option has been added, to configure a project that has no +build rules, only install rules. This avoids depending on ninja. -- cgit v1.1