From e5099357c2b558148220e5cfeabbbcaa3d87ae42 Mon Sep 17 00:00:00 2001 From: Daniel Mensinger Date: Sat, 29 Dec 2018 22:57:27 +0100 Subject: Tests and docs --- docs/markdown/IDE-integration.md | 9 +++++++++ docs/markdown/snippets/introspect_buildoptions_no_bd.md | 11 +++++++++++ 2 files changed, 20 insertions(+) create mode 100644 docs/markdown/snippets/introspect_buildoptions_no_bd.md (limited to 'docs/markdown') diff --git a/docs/markdown/IDE-integration.md b/docs/markdown/IDE-integration.md index 5f0c0a6..e23b77a 100644 --- a/docs/markdown/IDE-integration.md +++ b/docs/markdown/IDE-integration.md @@ -70,6 +70,15 @@ The possible values for `section` are: To set the options, use the `meson configure` command. +It is also possible to get the default buildoptions without a build directory by providing the root `meson.build` instead of a build directory to `meson introspect --buildoptions`. + +Running `--buildoptions` without a build directory produces the same output as running +it with a freshly configured build directory. + +However, this behavior is not guaranteed if subprojects are present. Due to internal +limitations all subprojects are processed even if they are never used in a real meson run. +Because of this options for the subprojects can differ. + ## Tests Compilation and unit tests are done as usual by running the `ninja` and `ninja test` commands. A JSON formatted result log can be found in `workspace/project/builddir/meson-logs/testlog.json`. diff --git a/docs/markdown/snippets/introspect_buildoptions_no_bd.md b/docs/markdown/snippets/introspect_buildoptions_no_bd.md new file mode 100644 index 0000000..f008474 --- /dev/null +++ b/docs/markdown/snippets/introspect_buildoptions_no_bd.md @@ -0,0 +1,11 @@ +## `introspect --buildoptions` can now be used without configured build directory + +It is now possible to run `meson introspect --buildoptions /path/to/meson.build` +without a configured build directory. + +Running `--buildoptions` without a build directory produces the same output as running +it with a freshly configured build directory. + +However, this behavior is not guaranteed if subprojects are present. Due to internal +limitations all subprojects are processed even if they are never used in a real meson run. +Because of this options for the subprojects can differ. \ No newline at end of file -- cgit v1.1 From 98115bb26150866f5b44b744b4b4dbadd37117ba Mon Sep 17 00:00:00 2001 From: Daniel Mensinger Date: Tue, 1 Jan 2019 18:23:40 +0100 Subject: Updated doc [skip ci] --- docs/markdown/IDE-integration.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) (limited to 'docs/markdown') diff --git a/docs/markdown/IDE-integration.md b/docs/markdown/IDE-integration.md index e23b77a..c75392c 100644 --- a/docs/markdown/IDE-integration.md +++ b/docs/markdown/IDE-integration.md @@ -70,7 +70,9 @@ The possible values for `section` are: To set the options, use the `meson configure` command. -It is also possible to get the default buildoptions without a build directory by providing the root `meson.build` instead of a build directory to `meson introspect --buildoptions`. +Since Meson 0.50.0 it is also possible to get the default buildoptions +without a build directory by providing the root `meson.build` instead of a +build directory to `meson introspect --buildoptions`. Running `--buildoptions` without a build directory produces the same output as running it with a freshly configured build directory. -- cgit v1.1