1
0
mirror of https://github.com/Kitware/CMake.git synced 2025-10-22 16:07:49 +08:00

Help: Improve formatting and cross-references for DEPENDS_EXPLICIT_ONLY

This commit is contained in:
Craig Scott
2023-07-18 12:01:14 +10:00
parent 03208d9e18
commit 91336d061c
2 changed files with 10 additions and 4 deletions

View File

@@ -362,7 +362,7 @@ The options are:
.. versionadded:: 3.27 .. 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. required by the command and implicit dependencies are not required.
Without this option, if any target uses the output of the custom command, 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 Only the :ref:`Ninja Generators` actually use this information to remove
unnecessary implicit dependencies. 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 Examples: Generating Files
^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^

View File

@@ -3,9 +3,11 @@ CMAKE_ADD_CUSTOM_COMMAND_DEPENDS_EXPLICIT_ONLY
.. versionadded:: 3.27 .. 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`. :command:`add_custom_command`.
This variable affects the default behavior of the :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`` command. Setting this variable to ``ON`` is equivalent to using the
option in all uses of that command. ``DEPENDS_EXPLICIT_ONLY`` option in all uses of that command.
See also :variable:`CMAKE_OPTIMIZE_DEPENDENCIES`.