From 8c57f7b45e1b8e6325e80b54d508a153f5543265 Mon Sep 17 00:00:00 2001 From: Robert Maynard Date: Mon, 30 Jan 2023 10:34:55 -0500 Subject: Help: Clarify CMAKE_CUDA_RESOLVE_DEVICE_SYMBOLS behavior Fixes: #24373 --- Help/prop_tgt/CUDA_RESOLVE_DEVICE_SYMBOLS.rst | 9 +++++++-- Help/variable/CMAKE_CUDA_RESOLVE_DEVICE_SYMBOLS.rst | 4 +++- 2 files changed, 10 insertions(+), 3 deletions(-) diff --git a/Help/prop_tgt/CUDA_RESOLVE_DEVICE_SYMBOLS.rst b/Help/prop_tgt/CUDA_RESOLVE_DEVICE_SYMBOLS.rst index 819ce3e..58072e1 100644 --- a/Help/prop_tgt/CUDA_RESOLVE_DEVICE_SYMBOLS.rst +++ b/Help/prop_tgt/CUDA_RESOLVE_DEVICE_SYMBOLS.rst @@ -14,8 +14,13 @@ executable is generated, allowing for multiple static libraries to resolve device symbols at the same time when they are used by a shared library or executable. -By default static library targets have this property is disabled, -while shared, module, and executable targets have this property enabled. +If this property or :variable:`CMAKE_CUDA_RESOLVE_DEVICE_SYMBOLS` is unset, +static libraries are treated as if it is disabled while shared, module, +and executable targets behave as if it is on. + +If :variable:`CMAKE_CUDA_RESOLVE_DEVICE_SYMBOLS` has been defined, +this property is initialized to the value the variable and overriding +the default behavior. Note that device linking is not supported for :ref:`Object Libraries`. diff --git a/Help/variable/CMAKE_CUDA_RESOLVE_DEVICE_SYMBOLS.rst b/Help/variable/CMAKE_CUDA_RESOLVE_DEVICE_SYMBOLS.rst index 474baee..bd56911 100644 --- a/Help/variable/CMAKE_CUDA_RESOLVE_DEVICE_SYMBOLS.rst +++ b/Help/variable/CMAKE_CUDA_RESOLVE_DEVICE_SYMBOLS.rst @@ -4,5 +4,7 @@ CMAKE_CUDA_RESOLVE_DEVICE_SYMBOLS .. versionadded:: 3.16 Default value for :prop_tgt:`CUDA_RESOLVE_DEVICE_SYMBOLS` target -property. This variable is used to initialize the property on each target as +property when defined. By default this variable is not defined. + +This variable is used to initialize the property on each target as it is created. -- cgit v0.12