aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorJussi Pakkanen <jpakkane@gmail.com>2019-01-01 19:27:41 +0200
committerGitHub <noreply@github.com>2019-01-01 19:27:41 +0200
commit8c9fcb1feac8ef7e4064ede9035f76ad53dc8e09 (patch)
tree5fc28dbf7d81db0ba1072ffe32737ff9138d1bb6 /docs
parent739341ec045a42892b454f59f76515f73c2a8759 (diff)
parent98115bb26150866f5b44b744b4b4dbadd37117ba (diff)
downloadmeson-8c9fcb1feac8ef7e4064ede9035f76ad53dc8e09.zip
meson-8c9fcb1feac8ef7e4064ede9035f76ad53dc8e09.tar.gz
meson-8c9fcb1feac8ef7e4064ede9035f76ad53dc8e09.tar.bz2
Merge pull request #4564 from mensinda/introBuildOpts
mintro: Introspect --buildoptions without a build directory
Diffstat (limited to 'docs')
-rw-r--r--docs/markdown/IDE-integration.md11
-rw-r--r--docs/markdown/snippets/introspect_buildoptions_no_bd.md11
2 files changed, 22 insertions, 0 deletions
diff --git a/docs/markdown/IDE-integration.md b/docs/markdown/IDE-integration.md
index 5f0c0a6..c75392c 100644
--- a/docs/markdown/IDE-integration.md
+++ b/docs/markdown/IDE-integration.md
@@ -70,6 +70,17 @@ The possible values for `section` are:
To set the options, use the `meson configure` command.
+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.
+
+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