summaryrefslogtreecommitdiff
path: root/share/cmake-3.17/Help/variable/CMAKE_VS_WINRT_BY_DEFAULT.rst
diff options
context:
space:
mode:
Diffstat (limited to 'share/cmake-3.17/Help/variable/CMAKE_VS_WINRT_BY_DEFAULT.rst')
-rw-r--r--share/cmake-3.17/Help/variable/CMAKE_VS_WINRT_BY_DEFAULT.rst18
1 files changed, 18 insertions, 0 deletions
diff --git a/share/cmake-3.17/Help/variable/CMAKE_VS_WINRT_BY_DEFAULT.rst b/share/cmake-3.17/Help/variable/CMAKE_VS_WINRT_BY_DEFAULT.rst
new file mode 100644
index 0000000..2eea424
--- /dev/null
+++ b/share/cmake-3.17/Help/variable/CMAKE_VS_WINRT_BY_DEFAULT.rst
@@ -0,0 +1,18 @@
+CMAKE_VS_WINRT_BY_DEFAULT
+-------------------------
+
+Inform :ref:`Visual Studio Generators` for VS 2010 and above that the
+target platform enables WinRT compilation by default and it needs to
+be explicitly disabled if ``/ZW`` or :prop_tgt:`VS_WINRT_COMPONENT` is
+omitted (as opposed to enabling it when either of those options is
+present)
+
+This makes cmake configuration consistent in terms of WinRT among
+platforms - if you did not enable the WinRT compilation explicitly, it
+will be disabled (by either not enabling it or explicitly disabling it)
+
+Note: WinRT compilation is always explicitly disabled for C language
+source files, even if it is expliclty enabled for a project
+
+This variable is meant to be set by a
+:variable:`toolchain file <CMAKE_TOOLCHAIN_FILE>` for such platforms.