aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown
diff options
context:
space:
mode:
authorDaiki Ueno <dueno@redhat.com>2025-01-28 17:47:03 +0900
committerJussi Pakkanen <jpakkane@gmail.com>2025-01-28 19:40:05 +0200
commitb2456ad8bf6857b28c9dc6b5c22570bd43d6e1f0 (patch)
tree476f683fbe1497f38564ab3b9cb7a19d1f269bba /docs/markdown
parent8a9dea2e3745935d55201123288e529acede043e (diff)
downloadmeson-b2456ad8bf6857b28c9dc6b5c22570bd43d6e1f0.zip
meson-b2456ad8bf6857b28c9dc6b5c22570bd43d6e1f0.tar.gz
meson-b2456ad8bf6857b28c9dc6b5c22570bd43d6e1f0.tar.bz2
docs: clarify behavior of default_both_libraries option
Signed-off-by: Daiki Ueno <dueno@redhat.com>
Diffstat (limited to 'docs/markdown')
-rw-r--r--docs/markdown/Builtin-options.md15
1 files changed, 10 insertions, 5 deletions
diff --git a/docs/markdown/Builtin-options.md b/docs/markdown/Builtin-options.md
index d64cd85..ffbab47 100644
--- a/docs/markdown/Builtin-options.md
+++ b/docs/markdown/Builtin-options.md
@@ -183,11 +183,16 @@ fails.
#### Details for `default_both_libraries`
-Since `1.6.0`, you can select the default type of library selected when using
-a `both_libraries` object. This can be either 'shared' (default value, compatible
-with previous meson versions), 'static', or 'auto'. With auto, the value from
-`default_library` option is used, unless it is 'both', in which case 'shared'
-is used instead.
+Since `1.6.0`, you can specify the default type of library selected when using a
+`both_libraries` object with `default_both_libraries`. Note that, unlike
+`default_library`, this option does not affect how the library artifacts are
+built, but how they are internally linked to the dependent targets within the
+same project.
+
+The possible values of this option are 'shared' (default value, compatible with
+previous meson versions), 'static', and 'auto'. With auto, the value from the
+`default_library` option is used, unless it is 'both', in which case 'shared' is
+used instead.
When `default_both_libraries` is 'auto', passing a [[@both_libs]] dependency
in [[both_libraries]] will link the static dependency with the static lib,