From 856005aedb5fce2943ff7ff1616bcd547713163a Mon Sep 17 00:00:00 2001 From: Dylan Baker Date: Mon, 22 Sep 2025 11:25:56 -0700 Subject: docs: Not all dependencies use `prefer_static` when `static` is unset Cuda, for example, doesn't use `prefer_static`, and will always link statically unless the static value is explicitly set to `true`. This updates the documentation to reflect that. --- docs/yaml/functions/dependency.yaml | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) (limited to 'docs') diff --git a/docs/yaml/functions/dependency.yaml b/docs/yaml/functions/dependency.yaml index 9d4dfc6d0..c337769b6 100644 --- a/docs/yaml/functions/dependency.yaml +++ b/docs/yaml/functions/dependency.yaml @@ -174,11 +174,16 @@ kwargs: libraries instead of dynamic ones (note that this is not supported by all dependency backends) + Leaving this value unset will result in an implementation defined default + value. For most dependencies this means the value of the `prefer_static` + option, but some custom dependencies have their own method for determining + the most useful default option. + *Since 0.60.0* it also sets `default_library` option accordingly on the fallback subproject if it was not set explicitly in `default_options` keyword argument. - *Since 0.63.0* when the `prefer_static` option is set to `true` the default - value is `true` otherwise the default value is `false`. + *Since 0.63.0* when the `prefer_static` option is used to calculate the + default value. version: type: array[str] | str -- cgit v1.2.3