CMake/Help/variable/CMAKE_LANG_USING_LINKER_MODE.rst
Marc Chevrier 3d2709c1ae Linker configuration: rely now on CMAKE_<LANG>_LINK_MODE variable.
CMake now provides the CMAKE_<LANG>_LINK_MODE variable which specify how
the link step is done. So, the CMAKE_<LANG>_USING_LINKER_MODE variable
is no longer needed.
2025-01-26 14:45:21 +01:00

33 lines
1.1 KiB
ReStructuredText

CMAKE_<LANG>_USING_LINKER_MODE
------------------------------
.. versionadded:: 3.29
This controls how the value of the :variable:`CMAKE_<LANG>_USING_LINKER_<TYPE>`
variable should be interpreted. The supported linker mode values are:
``FLAG``
:variable:`CMAKE_<LANG>_USING_LINKER_<TYPE>` holds a
:ref:`semicolon-separated list <CMake Language Lists>` of flags to be passed
to the compiler frontend. This is also the default behavior if
``CMAKE_<LANG>_USING_LINKER_MODE`` is not set.
``TOOL``
:variable:`CMAKE_<LANG>_USING_LINKER_<TYPE>` holds the path to the linker
tool.
.. warning::
The variable must be set accordingly to how CMake manage the link step:
* value ``TOOL`` is expected and required when the linker is used directly
for the link step.
* value ``FLAGS`` is expected or the variable not set when the compiler is
used as driver for the link step.
.. deprecated:: 4.0
This variable is no longer used. The type of information stored in the
:variable:`CMAKE_<LANG>_USING_LINKER_<TYPE>` variable is determined by the
:variable:`CMAKE_<LANG>_LINK_MODE` variable.