Help/install: Promote RUNTIME_DEPENDENCY_SET caveat to note

Amends the documentation update in commit 24b76eaa93 (Help: Improve
readability and accuracy of runtime deps-related content, 2021-07-03,
v3.21.0-rc3~16^2).

Until a new feature is (potentially) implemented offering projects more
flexibility in this regard, the semantics around installation of
internal build-tree dependencies should be clarified, as it has caused
confusion on multiple occasions.

Issue: #28048
This commit is contained in:
Tyler Yankee
2026-08-24 11:26:39 -04:00
parent 916316bb35
commit 9057de7baf
+5 -3
View File
@@ -1163,9 +1163,11 @@ Signatures
are installed in the ``RUNTIME`` destination and component on DLL platforms,
and in the ``LIBRARY`` destination and component on non-DLL platforms.
macOS frameworks are installed in the ``FRAMEWORK`` destination and component.
Targets built within the build tree will never be installed as runtime
dependencies, nor will their own dependencies, unless the targets themselves
are installed with :command:`install(TARGETS)`.
.. note::
Targets built within the build tree will never be installed as runtime
dependencies, nor will their own dependencies, unless the targets themselves
are installed with :command:`install(TARGETS)`.
The generated install script calls :command:`file(GET_RUNTIME_DEPENDENCIES)`
on the build-tree files to calculate the runtime dependencies. The build-tree