summaryrefslogtreecommitdiff
path: root/share/cmake-3.22/Help/variable/CMAKE_DEFAULT_CONFIGS.rst
diff options
context:
space:
mode:
Diffstat (limited to 'share/cmake-3.22/Help/variable/CMAKE_DEFAULT_CONFIGS.rst')
-rw-r--r--share/cmake-3.22/Help/variable/CMAKE_DEFAULT_CONFIGS.rst21
1 files changed, 21 insertions, 0 deletions
diff --git a/share/cmake-3.22/Help/variable/CMAKE_DEFAULT_CONFIGS.rst b/share/cmake-3.22/Help/variable/CMAKE_DEFAULT_CONFIGS.rst
new file mode 100644
index 0000000..65a5f0d
--- /dev/null
+++ b/share/cmake-3.22/Help/variable/CMAKE_DEFAULT_CONFIGS.rst
@@ -0,0 +1,21 @@
+CMAKE_DEFAULT_CONFIGS
+---------------------
+
+.. versionadded:: 3.17
+
+Specifies a :ref:`semicolon-separated list <CMake Language Lists>` of configurations
+to build for a target in ``build.ninja`` if no ``:<Config>`` suffix is specified in
+the :generator:`Ninja Multi-Config` generator. If it is set to ``all``, all
+configurations from :variable:`CMAKE_CROSS_CONFIGS` are used. If it is not
+specified, it defaults to :variable:`CMAKE_DEFAULT_BUILD_TYPE`.
+
+For example, if you set :variable:`CMAKE_DEFAULT_BUILD_TYPE` to ``Release``,
+but set :variable:`CMAKE_DEFAULT_CONFIGS` to ``Debug`` or ``all``, all
+``<target>`` aliases in ``build.ninja`` will resolve to ``<target>:Debug`` or
+``<target>:all``, but custom commands will still use the ``Release``
+configuration.
+
+The value of this variable must be a subset of :variable:`CMAKE_CROSS_CONFIGS`
+or be the same as :variable:`CMAKE_DEFAULT_BUILD_TYPE`. It must not be
+specified if :variable:`CMAKE_DEFAULT_BUILD_TYPE` or
+:variable:`CMAKE_CROSS_CONFIGS` is not used.