Files
cmake/Help/variable/CMAKE_LANG_USING_LINKER_MODE.rst
Peter Kokot 8aacf67b54 CMAKE_LANG_USING_LINKER_MODE: Fix typo and update docs
- s/FLAGS/FLAG
- Moved deprecation notice to top.
- Added "See Also" section to the CMAKE_LANG_LINK_MODE variable.
2025-08-11 03:48:26 +02:00

34 lines
1.1 KiB
ReStructuredText

CMAKE_<LANG>_USING_LINKER_MODE
------------------------------
.. 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.
.. versionadded:: 3.29
This variable 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 ``FLAG`` is expected or the variable not set when the compiler is
used as driver for the link step.