浏览代码

Help: Improve formatting and cross-references for DEPENDS_EXPLICIT_ONLY

Craig Scott 2 年之前
父节点
当前提交
91336d061c

+ 5 - 1
Help/command/add_custom_command.rst

@@ -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
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 

+ 5 - 3
Help/variable/CMAKE_ADD_CUSTOM_COMMAND_DEPENDS_EXPLICIT_ONLY.rst

@@ -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``
-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`.