diff options
| author | Craig Scott <craig.scott@crascit.com> | 2022-06-27 10:36:58 (GMT) |
|---|---|---|
| committer | Craig Scott <craig.scott@crascit.com> | 2022-07-03 04:34:41 (GMT) |
| commit | d185f7c0a8cac19edaea8d54c2a12b51a622731b (patch) | |
| tree | 96ab4b102d1d8a94536b0e09915d2911d3c505d5 /Help/variable/CMAKE_LANG_LINK_GROUP_USING_FEATURE.rst | |
| parent | 8c562ece28b7a13ddb734b8c51710ebafe9ac570 (diff) | |
| download | CMake-d185f7c0a8cac19edaea8d54c2a12b51a622731b.zip CMake-d185f7c0a8cac19edaea8d54c2a12b51a622731b.tar.gz CMake-d185f7c0a8cac19edaea8d54c2a12b51a622731b.tar.bz2 | |
Help: Rework $<LINK_LIBRARY>, $<LINK_GROUP> and related docs
These changes restructure the docs to improve readability and flow,
correct grammar and typos, and fix errors and inconsistencies in
some of the examples.
Fixes: #23684
Diffstat (limited to 'Help/variable/CMAKE_LANG_LINK_GROUP_USING_FEATURE.rst')
| -rw-r--r-- | Help/variable/CMAKE_LANG_LINK_GROUP_USING_FEATURE.rst | 27 |
1 files changed, 8 insertions, 19 deletions
diff --git a/Help/variable/CMAKE_LANG_LINK_GROUP_USING_FEATURE.rst b/Help/variable/CMAKE_LANG_LINK_GROUP_USING_FEATURE.rst index f2ef843..7c929d0 100644 --- a/Help/variable/CMAKE_LANG_LINK_GROUP_USING_FEATURE.rst +++ b/Help/variable/CMAKE_LANG_LINK_GROUP_USING_FEATURE.rst @@ -3,25 +3,14 @@ CMAKE_<LANG>_LINK_GROUP_USING_<FEATURE> .. versionadded:: 3.24 -This variable defines, for the specified ``<FEATURE>`` and the linker language -``<LANG>``, the expression expected by the linker when libraries are specified -using :genex:`LINK_GROUP` generator expression. +This variable defines how to link a group of libraries for the specified +``<FEATURE>`` when a :genex:`LINK_GROUP` generator expression is used and +the link language for the target is ``<LANG>``. +For this variable to have any effect, the associated +:variable:`CMAKE_<LANG>_LINK_GROUP_USING_<FEATURE>_SUPPORTED` variable +must be set to true. -.. note:: - - * Feature names can contain Latin letters, digits and undercores. - * Feature names defined in all uppercase are reserved to CMake. - -See also the associated variable -:variable:`CMAKE_<LANG>_LINK_GROUP_USING_<FEATURE>_SUPPORTED` and -:variable:`CMAKE_LINK_GROUP_USING_<FEATURE>` variable for the definition of -features independent from the link language. +The :variable:`CMAKE_LINK_GROUP_USING_<FEATURE>` variable should be defined +instead for features that are independent of the link language. .. include:: CMAKE_LINK_GROUP_USING_FEATURE.txt - -Predefined Features -^^^^^^^^^^^^^^^^^^^ - -CMake pre-defines some features of general interest: - -.. include:: LINK_GROUP_PREDEFINED_FEATURES.txt |