Help: Mention that CMAKE_TOOLCHAIN_FILE cannot be changed

This commit is contained in:
Aiden Woodruff
2026-08-25 09:38:59 -04:00
parent cb89e8d15f
commit c9868a61be
+8 -1
View File
@@ -6,7 +6,14 @@ Path to toolchain file supplied to :manual:`cmake(1)`.
This variable is specified on the command line when cross-compiling with CMake.
It is the path to a file which is read early in the CMake run and which
specifies locations for compilers and toolchain utilities, and other target
platform and compiler related information.
platform and compiler related information. Therefore it may not be changed by
project code. Attempting to reconfigure with a new value will not use the new
value.
.. versionchanged:: 4.5
Attempting to reconfigure with a different value will cause CMake to first
emit a message and reset the cache (as if by :cmake-option:`--fresh`).
Relative paths are allowed and are interpreted first as relative to the
build directory, and if not found, relative to the source directory.