From 91336d061c87b2426bc503dca4f4a6db2d545fd7 Mon Sep 17 00:00:00 2001 From: Craig Scott Date: Tue, 18 Jul 2023 12:01:14 +1000 Subject: Help: Improve formatting and cross-references for DEPENDS_EXPLICIT_ONLY --- Help/command/add_custom_command.rst | 6 +++++- Help/variable/CMAKE_ADD_CUSTOM_COMMAND_DEPENDS_EXPLICIT_ONLY.rst | 8 +++++--- 2 files changed, 10 insertions(+), 4 deletions(-) diff --git a/Help/command/add_custom_command.rst b/Help/command/add_custom_command.rst index f1be309..9bc88d6 100644 --- a/Help/command/add_custom_command.rst +++ b/Help/command/add_custom_command.rst @@ -362,7 +362,7 @@ The options are: .. versionadded:: 3.27 - Indicate that the command's ``DEPENDS`` argument represents all files + Indicates that the command's ``DEPENDS`` argument represents all files required by the command and implicit dependencies are not required. Without this option, if any target uses the output of the custom command, @@ -376,6 +376,10 @@ The options are: Only the :ref:`Ninja Generators` actually use this information to remove unnecessary implicit dependencies. + See also the :prop_tgt:`OPTIMIZE_DEPENDENCIES` target property, which may + provide another way for reducing the impact of target dependencies in some + scenarios. + Examples: Generating Files ^^^^^^^^^^^^^^^^^^^^^^^^^^ diff --git a/Help/variable/CMAKE_ADD_CUSTOM_COMMAND_DEPENDS_EXPLICIT_ONLY.rst b/Help/variable/CMAKE_ADD_CUSTOM_COMMAND_DEPENDS_EXPLICIT_ONLY.rst index 9c9bd2c..b6a6233 100644 --- a/Help/variable/CMAKE_ADD_CUSTOM_COMMAND_DEPENDS_EXPLICIT_ONLY.rst +++ b/Help/variable/CMAKE_ADD_CUSTOM_COMMAND_DEPENDS_EXPLICIT_ONLY.rst @@ -3,9 +3,11 @@ CMAKE_ADD_CUSTOM_COMMAND_DEPENDS_EXPLICIT_ONLY .. versionadded:: 3.27 -Whether to enable DEPENDS_EXPLICIT_ONLY option by default in +Whether to enable the ``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. +command. Setting this variable to ``ON`` is equivalent to using the +``DEPENDS_EXPLICIT_ONLY`` option in all uses of that command. + +See also :variable:`CMAKE_OPTIMIZE_DEPENDENCIES`. -- cgit v0.12