Merge topic 'doc-LINK_LIBRARIES_ONLY_TARGETS' into release-3.23
95cdce829f Help: Fix typo and improve readability for LINK_LIBRARIES_ONLY_TARGETS
Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !7068
diff --git a/Help/prop_tgt/LINK_LIBRARIES_ONLY_TARGETS.rst b/Help/prop_tgt/LINK_LIBRARIES_ONLY_TARGETS.rst
index 78fbb02..a9af74d 100644
--- a/Help/prop_tgt/LINK_LIBRARIES_ONLY_TARGETS.rst
+++ b/Help/prop_tgt/LINK_LIBRARIES_ONLY_TARGETS.rst
@@ -20,17 +20,16 @@
target is created. The property may be explicitly enabled on an imported
target to check its link interface.
-For example, the following code:
+In the following example, CMake will halt with an error at configure time
+because ``miLib`` is not a target:
.. code-block:: cmake
set(CMAKE_LINK_LIBRARIES_ONLY_TARGETS ON)
- add_executable(myLib STATIC myLib.c)
+ add_library(myLib STATIC myLib.c)
add_executable(myExe myExe.c)
target_link_libraries(myExe PRIVATE miLib) # typo for myLib
-will produce a CMake-time error that ``miLib`` is not a target.
-
In order to link toolchain-provided libraries by name while still
enforcing ``LINK_LIBRARIES_ONLY_TARGETS``, use an
:ref:`imported <Imported Targets>`
