瀏覽代碼

Help: Drop misleading add_custom_command "makefile terms" explanation

The "In makefile terms" explanation is left from very early days of
CMake to help developers migrating from hand-written makefiles.
These days it is often misinterpreted, particularly in the context
of multiple `add_custom_command` calls, to mean that we generate a
single Makefile containing rules for all custom commands.  This
leads to an incorrect mental model of the expressed build system.
The actual generated build system may spread the rules across multiple
targets that do not see the each other's file-level rules, which makes
target-level dependencies important too.
Brad King 2 年之前
父節點
當前提交
5f2bf6ecc6
共有 1 個文件被更改,包括 0 次插入4 次删除
  1. 0 4
      Help/command/add_custom_command.rst

+ 0 - 4
Help/command/add_custom_command.rst

@@ -35,10 +35,6 @@ Do not list the output in more than one independent target that
 may build in parallel or the two instances of the rule may conflict
 (instead use the :command:`add_custom_target` command to drive the
 command and make the other targets depend on that one).
-In makefile terms this creates a new target in the following form::
-
-  OUTPUT: MAIN_DEPENDENCY DEPENDS
-          COMMAND
 
 The options are: