diff options
author | Eli Schwartz <eschwartz@archlinux.org> | 2022-09-01 00:59:41 -0400 |
---|---|---|
committer | Eli Schwartz <eschwartz@archlinux.org> | 2023-03-20 17:22:50 -0400 |
commit | a024d75e150334330954bf7a6fdbe8cb02a82491 (patch) | |
tree | 0504f3471f335d79d994d9f68028233f95f38bb5 /docs | |
parent | 2a0b80eb679f27402035faa93b3b6b16f5839724 (diff) | |
download | meson-a024d75e150334330954bf7a6fdbe8cb02a82491.zip meson-a024d75e150334330954bf7a6fdbe8cb02a82491.tar.gz meson-a024d75e150334330954bf7a6fdbe8cb02a82491.tar.bz2 |
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.
Diffstat (limited to 'docs')
-rw-r--r-- | docs/markdown/Builtin-options.md | 12 | ||||
-rw-r--r-- | docs/markdown/snippets/none-backend.md | 4 |
2 files changed, 15 insertions, 1 deletions
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,<br>vs2010, vs2012, vs2013, vs2015, vs2017, vs2019, vs2022, xcode} | ninja | Backend to use | no | no | +| backend {ninja, vs,<br>vs2010, vs2012, vs2013, vs2015, vs2017, vs2019, vs2022, xcode, none} | ninja | Backend to use | no | no | | buildtype {plain, debug,<br>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,<br>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` <a name="build-type-options"></a> 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. |