diff options
Diffstat (limited to 'share/cmake-3.16/Help/variable/CMAKE_GENERATOR_INSTANCE.rst')
-rw-r--r-- | share/cmake-3.16/Help/variable/CMAKE_GENERATOR_INSTANCE.rst | 25 |
1 files changed, 25 insertions, 0 deletions
diff --git a/share/cmake-3.16/Help/variable/CMAKE_GENERATOR_INSTANCE.rst b/share/cmake-3.16/Help/variable/CMAKE_GENERATOR_INSTANCE.rst new file mode 100644 index 0000000..3657ed4 --- /dev/null +++ b/share/cmake-3.16/Help/variable/CMAKE_GENERATOR_INSTANCE.rst @@ -0,0 +1,25 @@ +CMAKE_GENERATOR_INSTANCE +------------------------ + +Generator-specific instance specification provided by user. + +Some CMake generators support selection of an instance of the native build +system when multiple instances are available. If the user specifies an +instance (e.g. by setting this cache entry or via the +:envvar:`CMAKE_GENERATOR_INSTANCE` environment variable), or after a default +instance is chosen when a build tree is first configured, the value will be +available in this variable. + +The value of this variable should never be modified by project code. +A toolchain file specified by the :variable:`CMAKE_TOOLCHAIN_FILE` +variable may initialize ``CMAKE_GENERATOR_INSTANCE`` as a cache entry. +Once a given build tree has been initialized with a particular value +for this variable, changing the value has undefined behavior. + +Instance specification is supported only on specific generators: + +* For the :generator:`Visual Studio 15 2017` generator (and above) + this specifies the absolute path to the VS installation directory + of the selected VS instance. + +See native build system documentation for allowed instance values. |