summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--Help/command/install.rst2
-rw-r--r--Help/envvar/DESTDIR.rst2
-rw-r--r--Help/generator/Ninja Multi-Config.rst4
-rw-r--r--Help/guide/user-interaction/index.rst8
-rw-r--r--Help/manual/cmake-presets.7.rst16
-rw-r--r--Help/manual/cmake.1.rst42
-rw-r--r--Help/release/dev/cmake-E-env-modify.rst4
-rw-r--r--Help/variable/CMAKE_BINARY_DIR.rst2
-rw-r--r--Help/variable/CMAKE_CURRENT_BINARY_DIR.rst2
-rw-r--r--Help/variable/CMAKE_CURRENT_SOURCE_DIR.rst2
-rw-r--r--Help/variable/CMAKE_INSTALL_PREFIX.rst4
-rw-r--r--Help/variable/CMAKE_SCRIPT_MODE_FILE.rst4
-rw-r--r--Help/variable/CMAKE_SOURCE_DIR.rst2
-rw-r--r--Source/CMakeVersion.cmake2
14 files changed, 65 insertions, 31 deletions
diff --git a/Help/command/install.rst b/Help/command/install.rst
index 45da99b..feff436 100644
--- a/Help/command/install.rst
+++ b/Help/command/install.rst
@@ -968,7 +968,7 @@ Generated Installation Script
The ``install()`` command generates a file, ``cmake_install.cmake``, inside
the build directory, which is used internally by the generated install target
and by CPack. You can also invoke this script manually with
-:option:`cmake -P <cmake_P -P>`. This script accepts several variables:
+:option:`cmake -P`. This script accepts several variables:
``COMPONENT``
Set this variable to install only a single CPack component as opposed to all
diff --git a/Help/envvar/DESTDIR.rst b/Help/envvar/DESTDIR.rst
index 414db12..dec8430 100644
--- a/Help/envvar/DESTDIR.rst
+++ b/Help/envvar/DESTDIR.rst
@@ -22,7 +22,7 @@ See the :variable:`CMAKE_INSTALL_PREFIX` variable to control the
installation prefix when configuring a build tree. Or, when using
the :manual:`cmake(1)` command-line tool's :option:`--install <cmake --install>`
mode, one may specify a different prefix using the
-:option:`--prefix <cmake --prefix>` option.
+:option:`--prefix <cmake--install --prefix>` option.
.. note::
diff --git a/Help/generator/Ninja Multi-Config.rst b/Help/generator/Ninja Multi-Config.rst
index ae075ed..2cf823a 100644
--- a/Help/generator/Ninja Multi-Config.rst
+++ b/Help/generator/Ninja Multi-Config.rst
@@ -20,8 +20,8 @@ are intended to be run with ``ninja -f build-<Config>.ninja``. A
:variable:`CMAKE_CONFIGURATION_TYPES`.
``cmake --build . --config <Config>`` will always use ``build-<Config>.ninja``
-to build. If no :option:`--config <cmake --config>` argument is specified,
-:option:`cmake --build .<cmake --build>` will use ``build.ninja``.
+to build. If no :option:`--config <cmake--build --config>` argument is
+specified, :option:`cmake --build . <cmake --build>` will use ``build.ninja``.
Each ``build-<Config>.ninja`` file contains ``<target>`` targets as well as
``<target>:<Config>`` targets, where ``<Config>`` is the same as the
diff --git a/Help/guide/user-interaction/index.rst b/Help/guide/user-interaction/index.rst
index 9cc5816..3355992 100644
--- a/Help/guide/user-interaction/index.rst
+++ b/Help/guide/user-interaction/index.rst
@@ -511,7 +511,7 @@ command associated with the
the build tool configured by the user.
The :option:`--build <cmake --build>` mode also accepts
-the parameter :option:`--target <cmake --target>` to
+the parameter :option:`--target <cmake--build --target>` to
specify a particular target to build, for example a
particular library, executable or custom target, or a
particular special target like ``install``:
@@ -521,7 +521,7 @@ particular special target like ``install``:
$ cmake --build . --target myexe
The :option:`--build <cmake --build>` mode also accepts a
-:option:`--config <cmake --config>` parameter
+:option:`--config <cmake--build --config>` parameter
in the case of multi-config generators to specify which
particular configuration to build:
@@ -529,13 +529,13 @@ particular configuration to build:
$ cmake --build . --target myexe --config Release
-The :option:`--config <cmake --config>` option has no
+The :option:`--config <cmake--build --config>` option has no
effect if the generator generates a buildsystem specific
to a configuration which is chosen when invoking cmake
with the :variable:`CMAKE_BUILD_TYPE` variable.
Some buildsystems omit details of command lines invoked
-during the build. The :option:`-verbose <cmake --verbose>`
+during the build. The :option:`--verbose <cmake--build --verbose>`
flag can be used to cause those command lines to be shown:
.. code-block:: console
diff --git a/Help/manual/cmake-presets.7.rst b/Help/manual/cmake-presets.7.rst
index 93f929e..eb3e460 100644
--- a/Help/manual/cmake-presets.7.rst
+++ b/Help/manual/cmake-presets.7.rst
@@ -460,21 +460,21 @@ that may contain the following fields:
``jobs``
An optional integer. Equivalent to passing
- :option:`--parallel <cmake --parallel>` or ``-j`` on the command line.
+ :option:`--parallel <cmake--build --parallel>` or ``-j`` on the command line.
``targets``
An optional string or array of strings. Equivalent to passing
- :option:`--target <cmake --target>` or ``-t`` on the command line.
+ :option:`--target <cmake--build --target>` or ``-t`` on the command line.
Vendors may ignore the targets property or hide build presets that
explicitly specify targets. This field supports macro expansion.
``configuration``
- An optional string. Equivalent to passing :option:`--config <cmake --config>`
- on the command line.
+ An optional string. Equivalent to passing
+ :option:`--config <cmake--build --config>` on the command line.
``cleanFirst``
An optional bool. If true, equivalent to passing
- :option:`--clean-first <cmake --clean-first>` on the command line.
+ :option:`--clean-first <cmake--build --clean-first>` on the command line.
``resolvePackageReferences``
An optional string that specifies the package resolve mode. This is
@@ -498,7 +498,7 @@ that may contain the following fields:
.. note::
The command line parameter
- :option:`--resolve-package-references <cmake --resolve-package-references>`
+ :option:`--resolve-package-references <cmake--build --resolve-package-references>`
will take priority over this setting. If the command line parameter is not
provided and this setting is not specified, an environment-specific cache
variable will be evaluated to decide, if package restoration should be
@@ -512,7 +512,7 @@ that may contain the following fields:
``verbose``
An optional bool. If true, equivalent to passing
- :option:`--verbose <cmake --verbose>` on the command line.
+ :option:`--verbose <cmake--build --verbose>` on the command line.
``nativeToolOptions``
An optional array of strings. Equivalent to passing options after ``--``
@@ -981,6 +981,8 @@ fields:
``vendorName``
An optional string representing the vendor name.
+.. _`Workflow Preset`:
+
Workflow Preset
^^^^^^^^^^^^^^^
diff --git a/Help/manual/cmake.1.rst b/Help/manual/cmake.1.rst
index 868dac4..d22317e 100644
--- a/Help/manual/cmake.1.rst
+++ b/Help/manual/cmake.1.rst
@@ -516,6 +516,8 @@ Options
Build a Project
===============
+.. program:: cmake
+
CMake provides a command-line signature to build an already-generated
project binary tree:
@@ -532,6 +534,8 @@ following options:
Project binary directory to be built. This is required (unless a preset
is specified) and must be first.
+.. program:: cmake--build
+
.. option:: --preset <preset>, --preset=<preset>
Use a build preset to specify build options. The project binary directory
@@ -567,7 +571,7 @@ following options:
.. option:: --clean-first
Build target ``clean`` first, then build.
- (To clean only, use :option:`--target clean <cmake --target>`.)
+ (To clean only, use :option:`--target clean <cmake--build --target>`.)
.. option:: --resolve-package-references=<value>
@@ -616,6 +620,8 @@ Run :option:`cmake --build` with no options for quick help.
Install a Project
=================
+.. program:: cmake
+
CMake provides a command-line signature to install an already-generated
project binary tree:
@@ -631,6 +637,8 @@ The options are:
Project binary directory to install. This is required and must be first.
+.. program:: cmake--install
+
.. option:: --config <cfg>
For multi-configuration generators, choose configuration ``<cfg>``.
@@ -662,6 +670,8 @@ Run :option:`cmake --install` with no options for quick help.
Open a Project
==============
+.. program:: cmake
+
.. code-block:: shell
cmake --open <dir>
@@ -675,16 +685,20 @@ supported by some generators.
Run a Script
============
-.. program:: cmake_P
+.. program:: cmake
.. code-block:: shell
cmake [-D <var>=<value>]... -P <cmake-script-file> [-- <unparsed-options>...]
+.. program:: cmake-P
+
.. option:: -D <var>=<value>
Define a variable for script mode.
+.. program:: cmake
+
.. option:: -P <cmake-script-file>
Process the given cmake file as a script written in the CMake
@@ -702,7 +716,7 @@ script (including the ``--`` itself).
Run a Command-Line Tool
=======================
-.. program:: cmake_E
+.. program:: cmake
CMake provides builtin command-line tools through the signature
@@ -714,6 +728,8 @@ CMake provides builtin command-line tools through the signature
Run ``cmake -E`` or ``cmake -E help`` for a summary of commands.
+.. program:: cmake-E
+
Available commands are:
.. option:: capabilities
@@ -1169,6 +1185,8 @@ The following ``cmake -E`` commands are available only on Windows:
Run the Find-Package Tool
=========================
+.. program:: cmake--find-package
+
CMake provides a pkg-config like helper for Makefile-based projects:
.. code-block:: shell
@@ -1189,9 +1207,23 @@ autoconf-based projects (via ``share/aclocal/cmake.m4``).
Run a Workflow Preset
=====================
+.. program:: cmake
+
:manual:`CMake Presets <cmake-presets(7)>` provides a way to execute multiple
build steps in order:
+.. code-block:: shell
+
+ cmake --workflow [<options>]
+
+The options are:
+
+.. option:: --workflow
+
+ Select a :ref:`Workflow Preset` using one of the following options.
+
+.. program:: cmake--workflow
+
.. option:: --preset <preset>, --preset=<preset>
Use a workflow preset to specify a workflow. The project binary directory
@@ -1207,6 +1239,8 @@ build steps in order:
View Help
=========
+.. program:: cmake
+
To print selected pages from the CMake documentation, use
.. code-block:: shell
@@ -1215,8 +1249,6 @@ To print selected pages from the CMake documentation, use
with one of the following options:
-.. program:: cmake
-
.. include:: OPTIONS_HELP.txt
To view the presets available for a project, use
diff --git a/Help/release/dev/cmake-E-env-modify.rst b/Help/release/dev/cmake-E-env-modify.rst
index ea4a622..08f1fb5 100644
--- a/Help/release/dev/cmake-E-env-modify.rst
+++ b/Help/release/dev/cmake-E-env-modify.rst
@@ -1,5 +1,5 @@
cmake-E-env-modify
------------------
-* A new ``--modify`` flag was added to :option:`cmake -E env <cmake_E env>` to support :prop_test:`ENVIRONMENT_MODIFICATION`
- operations.
+* A new ``--modify`` flag was added to :option:`cmake -E env <cmake-E env>` to
+ support :prop_test:`ENVIRONMENT_MODIFICATION` operations.
diff --git a/Help/variable/CMAKE_BINARY_DIR.rst b/Help/variable/CMAKE_BINARY_DIR.rst
index f9c7689..e601eb8 100644
--- a/Help/variable/CMAKE_BINARY_DIR.rst
+++ b/Help/variable/CMAKE_BINARY_DIR.rst
@@ -7,7 +7,7 @@ This is the full path to the top level of the current CMake build
tree. For an in-source build, this would be the same as
:variable:`CMAKE_SOURCE_DIR`.
-When run in :option:`-P <cmake_P -P>` script mode, CMake sets the variables
+When run in :option:`cmake -P` script mode, CMake sets the variables
:variable:`CMAKE_BINARY_DIR`, :variable:`CMAKE_SOURCE_DIR`,
:variable:`CMAKE_CURRENT_BINARY_DIR` and
:variable:`CMAKE_CURRENT_SOURCE_DIR` to the current working directory.
diff --git a/Help/variable/CMAKE_CURRENT_BINARY_DIR.rst b/Help/variable/CMAKE_CURRENT_BINARY_DIR.rst
index 6f82dcc..15f81d2 100644
--- a/Help/variable/CMAKE_CURRENT_BINARY_DIR.rst
+++ b/Help/variable/CMAKE_CURRENT_BINARY_DIR.rst
@@ -9,7 +9,7 @@ create a binary directory in the build tree, and as it is being
processed this variable will be set. For in-source builds this is the
current source directory being processed.
-When run in :option:`-P <cmake_P -P>` script mode, CMake sets the variables
+When run in :option:`cmake -P` script mode, CMake sets the variables
:variable:`CMAKE_BINARY_DIR`, :variable:`CMAKE_SOURCE_DIR`,
:variable:`CMAKE_CURRENT_BINARY_DIR` and
:variable:`CMAKE_CURRENT_SOURCE_DIR` to the current working directory.
diff --git a/Help/variable/CMAKE_CURRENT_SOURCE_DIR.rst b/Help/variable/CMAKE_CURRENT_SOURCE_DIR.rst
index 0678f99..5b86026 100644
--- a/Help/variable/CMAKE_CURRENT_SOURCE_DIR.rst
+++ b/Help/variable/CMAKE_CURRENT_SOURCE_DIR.rst
@@ -6,7 +6,7 @@ The path to the source directory currently being processed.
This is the full path to the source directory that is currently being
processed by cmake.
-When run in :option:`-P <cmake_P -P>` script mode, CMake sets the variables
+When run in :option:`cmake -P` script mode, CMake sets the variables
:variable:`CMAKE_BINARY_DIR`, :variable:`CMAKE_SOURCE_DIR`,
:variable:`CMAKE_CURRENT_BINARY_DIR` and
:variable:`CMAKE_CURRENT_SOURCE_DIR` to the current working directory.
diff --git a/Help/variable/CMAKE_INSTALL_PREFIX.rst b/Help/variable/CMAKE_INSTALL_PREFIX.rst
index 1636739..c76727e 100644
--- a/Help/variable/CMAKE_INSTALL_PREFIX.rst
+++ b/Help/variable/CMAKE_INSTALL_PREFIX.rst
@@ -27,8 +27,8 @@ first :command:`project` invocation.
The ``CMAKE_INSTALL_PREFIX`` may be defined when configuring a build tree
to set its installation prefix. Or, when using the :manual:`cmake(1)`
-command-line tool's :option:`--install <cmake --install>` mode, one may
-specify a different prefix using the :option:`--prefix <cmake --prefix>`
+command-line tool's :option:`--install <cmake --install>` mode, one may specify
+a different prefix using the :option:`--prefix <cmake--install --prefix>`
option:
.. code-block:: shell
diff --git a/Help/variable/CMAKE_SCRIPT_MODE_FILE.rst b/Help/variable/CMAKE_SCRIPT_MODE_FILE.rst
index 104f4ac..313fb4e 100644
--- a/Help/variable/CMAKE_SCRIPT_MODE_FILE.rst
+++ b/Help/variable/CMAKE_SCRIPT_MODE_FILE.rst
@@ -1,9 +1,9 @@
CMAKE_SCRIPT_MODE_FILE
----------------------
-Full path to the :option:`cmake -P <cmake_P -P>` script file currently being
+Full path to the :option:`cmake -P` script file currently being
processed.
-When run in :option:`cmake -P <cmake_P -P>` script mode, CMake sets this variable to
+When run in :option:`cmake -P` script mode, CMake sets this variable to
the full path of the script file. When run to configure a ``CMakeLists.txt``
file, this variable is not set.
diff --git a/Help/variable/CMAKE_SOURCE_DIR.rst b/Help/variable/CMAKE_SOURCE_DIR.rst
index 32e6e90..7210f75 100644
--- a/Help/variable/CMAKE_SOURCE_DIR.rst
+++ b/Help/variable/CMAKE_SOURCE_DIR.rst
@@ -7,7 +7,7 @@ This is the full path to the top level of the current CMake source
tree. For an in-source build, this would be the same as
:variable:`CMAKE_BINARY_DIR`.
-When run in :option:`-P <cmake_P -P>` script mode, CMake sets the variables
+When run in :option:`cmake -P` script mode, CMake sets the variables
:variable:`CMAKE_BINARY_DIR`, :variable:`CMAKE_SOURCE_DIR`,
:variable:`CMAKE_CURRENT_BINARY_DIR` and
:variable:`CMAKE_CURRENT_SOURCE_DIR` to the current working directory.
diff --git a/Source/CMakeVersion.cmake b/Source/CMakeVersion.cmake
index e76577e..51d6be4 100644
--- a/Source/CMakeVersion.cmake
+++ b/Source/CMakeVersion.cmake
@@ -1,7 +1,7 @@
# CMake version number components.
set(CMake_VERSION_MAJOR 3)
set(CMake_VERSION_MINOR 24)
-set(CMake_VERSION_PATCH 20221005)
+set(CMake_VERSION_PATCH 20221006)
#set(CMake_VERSION_RC 0)
set(CMake_VERSION_IS_DIRTY 0)