Merge topic 'doc-ide-compiler-selection'

90e2a33dba Help/CMAKE_LANG_COMPILER: Document Visual Studio, Xcode, GHS generators quirks

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !12296
This commit is contained in:
Brad King
2026-07-22 09:52:31 -04:00
committed by Kitware Robot
+11 -3
View File
@@ -3,13 +3,21 @@ CMAKE_<LANG>_COMPILER
The full path to the compiler for ``LANG``.
This is the command that will be used as the ``<LANG>`` compiler. Once
set, you can not change this variable.
This is the command that will be used as the ``<LANG>`` compiler.
Once set, you can not change this variable.
.. note::
With :ref:`IDE Build Tool Generators`, including
:ref:`Visual Studio Generators` and :generator:`Xcode`, this variable is
computed automatically and should not be set. Instead, specify a toolset
using :option:`cmake -T`.
Usage
^^^^^
This variable can be set by the user during the first time a build tree is configured.
With :ref:`Command-Line Build Tool Generators` this variable can be
set by the user during the first time a build tree is configured.
If a non-full path value is supplied then CMake will resolve the full path of
the compiler.