Help/variable/CMAKE_LINK_GROUP_USING_FEATURE.rst


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

CMAKE_LINK_GROUP_USING_<FEATURE>
--------------------------------

.. versionadded:: 3.24

This variable defines, for the specified ``<FEATURE>``, the expression expected
by the linker when libraries are specified using :genex:`LINK_GROUP` generator
expression.

.. 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_LINK_GROUP_USING_<FEATURE>_SUPPORTED` and
:variable:`CMAKE_<LANG>_LINK_GROUP_USING_<FEATURE>` variable for the definition
of features dependent from the link language.

This variable will be used by :genex:`LINK_GROUP` generator expression if,
for the linker language, the variable
:variable:`CMAKE_<LANG>_LINK_GROUP_USING_<FEATURE>_SUPPORTED` is not defined
and the variable :variable:`CMAKE_LINK_GROUP_USING_<FEATURE>_SUPPORTED` is
``TRUE``..

.. include:: CMAKE_LINK_GROUP_USING_FEATURE.txt

Predefined Features
^^^^^^^^^^^^^^^^^^^

CMake pre-defines some features of general interest:

.. include:: LINK_GROUP_PREDEFINED_FEATURES.txt