summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
Diffstat (limited to 'Help')
-rw-r--r--Help/manual/OPTIONS_BUILD.txt4
-rw-r--r--Help/manual/cmake-generator-expressions.7.rst11
-rw-r--r--Help/manual/cmake.1.rst14
-rw-r--r--Help/release/dev/FetchContent-exclude-from-all.rst7
-rw-r--r--Help/release/dev/genexp-no-eval.rst5
-rw-r--r--Help/release/dev/orangec-compiler.rst5
-rw-r--r--Help/variable/CMAKE_LANG_COMPILER_ID.rst2
7 files changed, 48 insertions, 0 deletions
diff --git a/Help/manual/OPTIONS_BUILD.txt b/Help/manual/OPTIONS_BUILD.txt
index 94adac8..fb1e7d4 100644
--- a/Help/manual/OPTIONS_BUILD.txt
+++ b/Help/manual/OPTIONS_BUILD.txt
@@ -105,11 +105,15 @@
.. option:: --toolchain <path-to-file>
+ .. versionadded:: 3.21
+
Specify the cross compiling toolchain file, equivalent to setting
:variable:`CMAKE_TOOLCHAIN_FILE` variable.
.. option:: --install-prefix <directory>
+ .. versionadded:: 3.21
+
Specify the installation directory, used by the
:variable:`CMAKE_INSTALL_PREFIX` variable. Must be an absolute path.
diff --git a/Help/manual/cmake-generator-expressions.7.rst b/Help/manual/cmake-generator-expressions.7.rst
index 86ae0a4..00d1aa4 100644
--- a/Help/manual/cmake-generator-expressions.7.rst
+++ b/Help/manual/cmake-generator-expressions.7.rst
@@ -195,6 +195,12 @@ Two forms of conditional generator expressions are supported:
if ``condition`` is ``0``. Any other value for ``condition`` results in an
error.
+ .. versionadded:: 3.28
+
+ This generator expression short-circuits such that generator expressions in
+ ``false_string`` will not evaluate when ``condition`` is ``1``, and generator
+ expressions in ``true_string`` will not evaluate when condition is ``0``.
+
Typically, the ``condition`` is itself a generator expression. For instance,
the following expression expands to ``DEBUG_MODE`` when the ``Debug``
configuration is used, and the empty string for all other configurations:
@@ -252,6 +258,11 @@ The common boolean logic operators are supported:
``condition`` must be ``0`` or ``1``. The result of the expression is
``0`` if ``condition`` is ``1``, else ``1``.
+ .. versionadded:: 3.28
+
+ Logical operators short-circuit such that generator expressions in the
+ arguments list will not be evaluated once a return value can be determined.
+
.. _`Comparison Expressions`:
Primary Comparison Expressions
diff --git a/Help/manual/cmake.1.rst b/Help/manual/cmake.1.rst
index b5848f7..5223acb 100644
--- a/Help/manual/cmake.1.rst
+++ b/Help/manual/cmake.1.rst
@@ -309,6 +309,8 @@ Options
.. option:: --debug-find
+ .. versionadded:: 3.17
+
Put cmake find commands in a debug mode.
Print extra find call information during the cmake run to standard
@@ -318,6 +320,8 @@ Options
.. option:: --debug-find-pkg=<pkg>[,...]
+ .. versionadded:: 3.23
+
Put cmake find commands in a debug mode when running under calls
to :command:`find_package(\<pkg\>) <find_package>`, where ``<pkg>``
is an entry in the given comma-separated list of case-sensitive package
@@ -328,6 +332,8 @@ Options
.. option:: --debug-find-var=<var>[,...]
+ .. versionadded:: 3.23
+
Put cmake find commands in a debug mode when called with ``<var>``
as the result variable, where ``<var>`` is an entry in the given
comma-separated list.
@@ -349,6 +355,8 @@ Options
.. option:: --trace-format=<format>
+ .. versionadded:: 3.17
+
Put cmake in trace mode and sets the trace output format.
``<format>`` can be one of the following values.
@@ -471,12 +479,16 @@ Options
.. option:: --compile-no-warning-as-error
+ .. versionadded:: 3.24
+
Ignore target property :prop_tgt:`COMPILE_WARNING_AS_ERROR` and variable
:variable:`CMAKE_COMPILE_WARNING_AS_ERROR`, preventing warnings from being
treated as errors on compile.
.. option:: --profiling-output=<path>
+ .. versionadded:: 3.18
+
Used in conjunction with
:option:`--profiling-format <cmake --profiling-format>` to output to a
given path.
@@ -1325,6 +1337,8 @@ autoconf-based projects (via ``share/aclocal/cmake.m4``).
Run a Workflow Preset
=====================
+.. versionadded:: 3.25
+
.. program:: cmake
:manual:`CMake Presets <cmake-presets(7)>` provides a way to execute multiple
diff --git a/Help/release/dev/FetchContent-exclude-from-all.rst b/Help/release/dev/FetchContent-exclude-from-all.rst
new file mode 100644
index 0000000..267ce72
--- /dev/null
+++ b/Help/release/dev/FetchContent-exclude-from-all.rst
@@ -0,0 +1,7 @@
+FetchContent-exclude-from-all
+-----------------------------
+
+* The :module:`FetchContent` module's :command:`FetchContent_Declare` command
+ gained an ``EXCLUDE_FROM_ALL`` option, which propagates through to the
+ :command:`add_subdirectory` call made by
+ :command:`FetchContent_MakeAvailable` for the dependency.
diff --git a/Help/release/dev/genexp-no-eval.rst b/Help/release/dev/genexp-no-eval.rst
new file mode 100644
index 0000000..42ff1aa
--- /dev/null
+++ b/Help/release/dev/genexp-no-eval.rst
@@ -0,0 +1,5 @@
+genexp-no-eval
+--------------
+
+* :manual:`generator expressions <cmake-generator-expressions(7)>`
+ short-circuit to avoid unnecessary evaluation of parameters.
diff --git a/Help/release/dev/orangec-compiler.rst b/Help/release/dev/orangec-compiler.rst
new file mode 100644
index 0000000..9068699
--- /dev/null
+++ b/Help/release/dev/orangec-compiler.rst
@@ -0,0 +1,5 @@
+orangec-compiler
+----------------
+
+* The OrangeC compiler is now supported with
+ :variable:`compiler id <CMAKE_<LANG>_COMPILER_ID>` ``OrangeC``.
diff --git a/Help/variable/CMAKE_LANG_COMPILER_ID.rst b/Help/variable/CMAKE_LANG_COMPILER_ID.rst
index c89b3ab..6893eea 100644
--- a/Help/variable/CMAKE_LANG_COMPILER_ID.rst
+++ b/Help/variable/CMAKE_LANG_COMPILER_ID.rst
@@ -35,6 +35,7 @@ Value Name
``MSVC`` `Microsoft Visual Studio`_
``NVHPC`` `NVIDIA HPC Compiler`_
``NVIDIA`` `NVIDIA CUDA Compiler`_
+``OrangeC`` `OrangeC Compiler`_
``OpenWatcom`` `Open Watcom`_
``PGI`` The Portland Group
``PathScale`` PathScale
@@ -63,6 +64,7 @@ languages.
.. _NVIDIA HPC Compiler: https://developer.nvidia.com/hpc-compilers
.. _NVIDIA CUDA Compiler: https://developer.nvidia.com/cuda-llvm-compiler
.. _Open Watcom: https://open-watcom.github.io
+.. _OrangeC Compiler: https://github.com/LADSoft/OrangeC
.. _Small Device C Compiler: https://sdcc.sourceforge.net
.. _Tiny C Compiler: https://bellard.org/tcc
.. _Tasking Compiler Toolsets: https://www.tasking.com