summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2021-10-14 11:43:15 (GMT)
committerKitware Robot <kwrobot@kitware.com>2021-10-14 11:43:38 (GMT)
commitc5a24cd52b9bd59d7c162448077a491bfa88cbf5 (patch)
tree2be4c0f237ee0163b9facd4fe6aee86107d9cc0d /Help
parent6bfe5f24da381bda4a7cfc334fe04bc7c7b73abc (diff)
parentf2262fab51d6d7625303bb2ba2a4c617046b3ca0 (diff)
downloadCMake-c5a24cd52b9bd59d7c162448077a491bfa88cbf5.zip
CMake-c5a24cd52b9bd59d7c162448077a491bfa88cbf5.tar.gz
CMake-c5a24cd52b9bd59d7c162448077a491bfa88cbf5.tar.bz2
Merge topic 'doc-frontend-variant' into release-3.22
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
Diffstat (limited to 'Help')
-rw-r--r--Help/manual/cmake-variables.7.rst1
-rw-r--r--Help/variable/CMAKE_LANG_COMPILER_FRONTEND_VARIANT.rst18
-rw-r--r--Help/variable/CMAKE_LANG_SIMULATE_ID.rst6
3 files changed, 24 insertions, 1 deletions
diff --git a/Help/manual/cmake-variables.7.rst b/Help/manual/cmake-variables.7.rst
index 17f04ab..a2103f7 100644
--- a/Help/manual/cmake-variables.7.rst
+++ b/Help/manual/cmake-variables.7.rst
@@ -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
diff --git a/Help/variable/CMAKE_LANG_COMPILER_FRONTEND_VARIANT.rst b/Help/variable/CMAKE_LANG_COMPILER_FRONTEND_VARIANT.rst
new file mode 100644
index 0000000..128b1fb
--- /dev/null
+++ b/Help/variable/CMAKE_LANG_COMPILER_FRONTEND_VARIANT.rst
@@ -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.
diff --git a/Help/variable/CMAKE_LANG_SIMULATE_ID.rst b/Help/variable/CMAKE_LANG_SIMULATE_ID.rst
index 15c87a1..3226352 100644
--- a/Help/variable/CMAKE_LANG_SIMULATE_ID.rst
+++ b/Help/variable/CMAKE_LANG_SIMULATE_ID.rst
@@ -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.