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 <[email protected]>
Merge-request: !6621

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

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.

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.