[cmake-developers] [CMake 0014424]: Vague ADD_DEPENDENCIES() Description

[Mantis Bug Tracker]

The following issue has been SUBMITTED. 
====================================================================== 
http://www.cmake.org/Bug/view.php?id=14424 
====================================================================== 
Reported By:                Rob Stewart
Assigned To:                
====================================================================== 
Project:                    CMake
Issue ID:                   14424
Category:                   Documentation
Reproducibility:            N/A
Severity:                   text
Priority:                   normal
Status:                     new
====================================================================== 
Date Submitted:             2013-09-19 13:24 EDT
Last Modified:              2013-09-19 13:24 EDT
====================================================================== 
Summary:                    Vague ADD_DEPENDENCIES() Description
Description: 
The current description doesn't clarify the direction of the dependencies being
specified.  I suggest the following wording, assuming I understand the command
correctly:

add_dependencies: Add a dependency between top-level targets.

  add_dependencies(target-name depend-target1
                   depend-target2 ...)

Makes target-name depend on the other listed targets, so it must build before
the others.  All of the targets must be top-level targets, which means they all
must have been created by ADD_EXECUTABLE, ADD_LIBRARY, or ADD_CUSTOM_TARGET.

Dependencies added to an IMPORTED target are followed transitively in its place
since the target itself does not build. See the DEPENDS option of
ADD_CUSTOM_TARGET and ADD_CUSTOM_COMMAND for adding file-level dependencies in
custom rules. See the OBJECT_DEPENDS option in SET_SOURCE_FILES_PROPERTIES to
add file-level dependencies to object files.
====================================================================== 

Issue History 
Date Modified    Username       Field                    Change               
====================================================================== 
2013-09-19 13:24 Rob Stewart    New Issue                                    
======================================================================