diff options
| author | Brad King <brad.king@kitware.com> | 2023-02-20 13:34:08 (GMT) |
|---|---|---|
| committer | Kitware Robot <kwrobot@kitware.com> | 2023-02-20 13:34:34 (GMT) |
| commit | d18806e67336d96a9a22b860246de3f1c518ce40 (patch) | |
| tree | c734e10d0aaedf072173e449d56fa37d100c2cd8 /Help | |
| parent | 20cb716e4f8061441599c3972a036e91e62b9af0 (diff) | |
| parent | ea2a05f402d2e1090d8d1e92e67c08ac1e5af66a (diff) | |
| download | CMake-d18806e67336d96a9a22b860246de3f1c518ce40.zip CMake-d18806e67336d96a9a22b860246de3f1c518ce40.tar.gz CMake-d18806e67336d96a9a22b860246de3f1c518ce40.tar.bz2 | |
Merge topic 'ninja-custom-command-depends'
ea2a05f402 Add variable CMAKE_ADD_CUSTOM_COMMAND_DEPENDS_EXPLICIT_ONLY
Acked-by: Kitware Robot <kwrobot@kitware.com>
Acked-by: buildbot <buildbot@kitware.com>
Merge-request: !8220
Diffstat (limited to 'Help')
| -rw-r--r-- | Help/command/add_custom_command.rst | 3 | ||||
| -rw-r--r-- | Help/manual/cmake-variables.7.rst | 1 | ||||
| -rw-r--r-- | Help/release/dev/ninja-custom-command-depends.rst | 4 | ||||
| -rw-r--r-- | Help/variable/CMAKE_ADD_CUSTOM_COMMAND_DEPENDS_EXPLICIT_ONLY.rst | 11 |
4 files changed, 19 insertions, 0 deletions
diff --git a/Help/command/add_custom_command.rst b/Help/command/add_custom_command.rst index 2cf88fc..1ccd434 100644 --- a/Help/command/add_custom_command.rst +++ b/Help/command/add_custom_command.rst @@ -370,6 +370,9 @@ The options are: the custom command in case this custom command requires files implicitly created by those targets. + This option can be enabled on all custom commands by setting + :variable:`CMAKE_ADD_CUSTOM_COMMAND_DEPENDS_EXPLICIT_ONLY` to ``ON``. + Only the :ref:`Ninja Generators` actually use this information to remove unnecessary implicit dependencies. diff --git a/Help/manual/cmake-variables.7.rst b/Help/manual/cmake-variables.7.rst index 8564e7c..0ba8363 100644 --- a/Help/manual/cmake-variables.7.rst +++ b/Help/manual/cmake-variables.7.rst @@ -166,6 +166,7 @@ Variables that Change Behavior /variable/BUILD_SHARED_LIBS /variable/CMAKE_ABSOLUTE_DESTINATION_FILES + /variable/CMAKE_ADD_CUSTOM_COMMAND_DEPENDS_EXPLICIT_ONLY /variable/CMAKE_APPBUNDLE_PATH /variable/CMAKE_AUTOMOC_RELAXED_MODE /variable/CMAKE_BACKWARDS_COMPATIBILITY diff --git a/Help/release/dev/ninja-custom-command-depends.rst b/Help/release/dev/ninja-custom-command-depends.rst index 10c68cf..0b7840c 100644 --- a/Help/release/dev/ninja-custom-command-depends.rst +++ b/Help/release/dev/ninja-custom-command-depends.rst @@ -5,3 +5,7 @@ ninja-custom-command-depends ``DEPENDS_EXPLICIT_ONLY`` option to tell the :ref:`Ninja Generators` not to add any dependencies implied by the target to which it is attached. + +* The :variable:`CMAKE_ADD_CUSTOM_COMMAND_DEPENDS_EXPLICIT_ONLY` variable can + be set to enable ``DEPENDS_EXPLICIT_ONLY`` in all uses of + :command:`add_custom_command` command. diff --git a/Help/variable/CMAKE_ADD_CUSTOM_COMMAND_DEPENDS_EXPLICIT_ONLY.rst b/Help/variable/CMAKE_ADD_CUSTOM_COMMAND_DEPENDS_EXPLICIT_ONLY.rst new file mode 100644 index 0000000..9c9bd2c --- /dev/null +++ b/Help/variable/CMAKE_ADD_CUSTOM_COMMAND_DEPENDS_EXPLICIT_ONLY.rst @@ -0,0 +1,11 @@ +CMAKE_ADD_CUSTOM_COMMAND_DEPENDS_EXPLICIT_ONLY +---------------------------------------------- + +.. versionadded:: 3.27 + +Whether to enable DEPENDS_EXPLICIT_ONLY option by default in +:command:`add_custom_command`. + +This variable affects the default behavior of the :command:`add_custom_command` +command. Setting this variable to ``ON`` is equivalent to using the ``DEPENDS_EXPLICIT_ONLY`` +option in all uses of that command. |