| CMP0132 |
| ------- |
| |
| .. versionadded:: 3.24 |
| |
| Do not set compiler environment variables on first run. |
| |
| Apart from when using the :generator:`Xcode` generator and some :ref:`Visual |
| Studio Generators`, CMake 3.23 and below will set environment variables like |
| :envvar:`CC`, :envvar:`CXX`, etc. when the corresponding language is enabled. |
| This only occurs on the very first time CMake is run in a build directory, |
| and the environment variables are only defined at configure time, not build |
| time. On subsequent CMake runs, these environment variables are not set, |
| opening up the opportunity for different behavior between the first and |
| subsequent CMake runs. CMake 3.24 and above prefer to not set these |
| environment variables when a language is enabled, even on the first run in |
| a build directory. |
| |
| The ``OLD`` behavior for this policy sets the relevant environment variable |
| on the first run when a language is enabled. The ``NEW`` behavior for this |
| policy does not set any such environment variables. |
| |
| .. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.24 |
| .. |WARNS_OR_DOES_NOT_WARN| replace:: does *not* warn |
| .. include:: include/STANDARD_ADVICE.rst |
| |
| .. include:: include/DEPRECATED.rst |
