Browse Source

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 years ago
parent
commit
5f2bf6ecc6
1 changed files with 0 additions and 4 deletions
  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: