Tasking: Update CMAKE_TASKING_TOOLSET documentation

Clarify the relationship between the compiler version and
toolset/architecture.

Fixes: #24117
This commit is contained in:
Christoph Seitz
2022-11-07 12:12:02 +01:00
committed by Brad King
parent 7c52e9e951
commit beade1cb42

View File

@@ -8,12 +8,15 @@ Select the Tasking toolset which provides the compiler
Architecture compilers are provided by different toolchains with Architecture compilers are provided by different toolchains with
incompatible versioning schemes. Set this variable in a incompatible versioning schemes. Set this variable in a
:variable:`toolchain file <CMAKE_TOOLCHAIN_FILE>` so CMake can detect :variable:`toolchain file <CMAKE_TOOLCHAIN_FILE>` so CMake can detect
the compiler and version correctly. If no toolset is specified, the compiler features correctly. If no toolset is specified,
``Standalone`` is assumed. ``Standalone`` is assumed.
Projects that can be built with different architectures and/or toolsets must Due to the different versioning schemes, the compiler version
take :variable:`CMAKE_TASKING_TOOLSET` and (:variable:`CMAKE_<LANG>_COMPILER_VERSION`) depends on the toolset and
:variable:`CMAKE_<LANG>_COMPILER_ARCHITECTURE_ID` into account to qualify architecture in use. If projects can be built with multiple toolsets or
architectures, the specified :variable:`CMAKE_TASKING_TOOLSET` and the
automatically determined :variable:`CMAKE_<LANG>_COMPILER_ARCHITECTURE_ID`
must be taken into account when comparing against the
:variable:`CMAKE_<LANG>_COMPILER_VERSION`. :variable:`CMAKE_<LANG>_COMPILER_VERSION`.
``TriCore`` ``TriCore``