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.
This commit is contained in:
Peter Kokot
2025-08-11 03:18:00 +02:00
parent 45b8ebbafd
commit 8aacf67b54
2 changed files with 15 additions and 9 deletions

View File

@@ -12,3 +12,8 @@ Defines how the link step is done. The possible values are:
The linker is used directly for the link step.
This variable is read-only. Setting it is undefined behavior.
See Also
^^^^^^^^
* The :variable:`CMAKE_<LANG>_USING_LINKER_<TYPE>` variable.

View File

@@ -1,10 +1,17 @@
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 controls how the value of the :variable:`CMAKE_<LANG>_USING_LINKER_<TYPE>`
variable should be interpreted. The supported linker mode values are:
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
@@ -22,11 +29,5 @@ variable should be interpreted. The supported linker mode values are:
* 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
* value ``FLAG`` 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.