cmake/Help/release/dev/system-env-id.rst at master - cmake - SHS Gitea

mirrors/cmake

mirror of https://gitlab.kitware.com/cmake/cmake.git synced 2026-09-25 04:09:36 +03:00

Files

T

Aiden Woodruff fc3c71d11f cmake: Add cached environment id that triggers reconfigure when changed

The opaque `CMAKE_SYSTEM_ENVIRONMENT_ID` variable is cached during the
first invocation of `cmake` and is a user-defined hint about the state
of the environment. When the value changes, `cmake` either does nothing,
emits a warning (by default), or refreshes the cache as if by `--fresh`.
The action is controlled by the `CMAKE_SYSTEM_ENVIRONMENT_ACTION`
environment variable (which is not cached).

Implements: #28025

2026-08-24 15:06:35 -04:00

8 lines

344 B

ReStructuredText

Raw Permalink Blame History

 CMAKE_SYSTEM_ENVIRONMENT_ID
 ---------------------------
 * The :envvar:`CMAKE_SYSTEM_ENVIRONMENT_ID` environment variable was added to
   hint to :manual:`cmake(1)` when :cmake-option:`--fresh` may be necessary,
   along with :envvar:`CMAKE_SYSTEM_ENVIRONMENT_ACTION` to control what happens
   when :envvar:`CMAKE_SYSTEM_ENVIRONMENT_ID` changes.