Merge topic 'doc-frontend-variant'

f2262fab51 Help: Add documentation for CMAKE_<LANG>_COMPILER_FRONTEND_VARIANT
ffb54e2350 Help: Add more documentation for CMAKE_<LANG>_SIMULATE_ID

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !6621
This commit is contained in:
Brad King
2021-10-14 11:43:15 +00:00
committed by Kitware Robot
3 changed files with 24 additions and 1 deletions

View File

@@ -71,6 +71,7 @@ Variables that Provide Information
/variable/CMAKE_JOB_POOL_PRECOMPILE_HEADER
/variable/CMAKE_JOB_POOLS
/variable/CMAKE_LANG_COMPILER_AR
/variable/CMAKE_LANG_COMPILER_FRONTEND_VARIANT
/variable/CMAKE_LANG_COMPILER_RANLIB
/variable/CMAKE_LANG_LINK_LIBRARY_SUFFIX
/variable/CMAKE_LINK_LIBRARY_SUFFIX

View File

@@ -0,0 +1,18 @@
CMAKE_<LANG>_COMPILER_FRONTEND_VARIANT
--------------------------------------
.. versionadded:: 3.14
Identification string of the compiler frontend variant.
Some compilers have multiple, different frontends for accepting command
line options. (For example ``Clang`` originally only had a frontend
compatible with the ``GNU`` compiler but since its port to Windows
(``Clang-Cl``) it now also supports a frontend compatible with ``MSVC``.)
When CMake detects such a compiler it sets this
variable to what would have been the :variable:`CMAKE_<LANG>_COMPILER_ID` for
the compiler whose frontend it resembles.
.. note::
In other words, this variable describes what command line options
and language extensions the compiler frontend expects.

View File

@@ -1,9 +1,13 @@
CMAKE_<LANG>_SIMULATE_ID
------------------------
Identification string of "simulated" compiler.
Identification string of the "simulated" compiler.
Some compilers simulate other compilers to serve as drop-in
replacements. When CMake detects such a compiler it sets this
variable to what would have been the :variable:`CMAKE_<LANG>_COMPILER_ID` for
the simulated compiler.
.. note::
In other words, this variable describes the ABI compatibility
of the generated code.