summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2020-04-17 13:44:30 (GMT)
committerBrad King <brad.king@kitware.com>2020-04-22 12:03:16 (GMT)
commite01990999a83fb08b0e46b3131501c01e3256944 (patch)
treecb89821b1aea1bbab3566897e12cb569aa0912dd /Help
parent8bc757c8f68d653526dce3f723950ccf221a4c6c (diff)
downloadCMake-e01990999a83fb08b0e46b3131501c01e3256944.zip
CMake-e01990999a83fb08b0e46b3131501c01e3256944.tar.gz
CMake-e01990999a83fb08b0e46b3131501c01e3256944.tar.bz2
Ninja: On Windows, select the compiler occurring first in PATH
On Windows, toolchains like MSVC require a set of environment variables to be configured for the compiler to work correctly. The scripts that prepare these environments typically put the compiler's directory ahead of others in the `PATH`. Teach the Ninja generators to use this as a heuristic to select the compiler when none is explicitly specified. This is not necessary with Makefile generators because each toolchain's environment comes with its own make tool variant, and the corresponding Makefile generator (e.g. "NMake Makefiles") automatically implies the matching compiler. Fixes: #20585
Diffstat (limited to 'Help')
-rw-r--r--Help/release/dev/ninja-compiler-PATH-windows.rst7
1 files changed, 7 insertions, 0 deletions
diff --git a/Help/release/dev/ninja-compiler-PATH-windows.rst b/Help/release/dev/ninja-compiler-PATH-windows.rst
new file mode 100644
index 0000000..cb33493
--- /dev/null
+++ b/Help/release/dev/ninja-compiler-PATH-windows.rst
@@ -0,0 +1,7 @@
+ninja-compiler-PATH-windows
+---------------------------
+
+* On Windows, the :generator:`Ninja` and :generator:`Ninja Multi-Config`
+ generators, when a compiler is not explicitly specified, now select
+ the first compiler (of any name) found in directories listed by the
+ ``PATH`` environment variable.