target_link_libraries: Update usage requirements documentation

Re-word the documentation to make clear that CMake integrates usage
requirements during generation and not synchronously during
configuration or execution of target_link_libraries.
This commit is contained in:
Brad King 2013-04-30 09:09:23 -04:00
parent 78185f598c
commit 2618e0257e
1 changed files with 11 additions and 8 deletions

View File

@ -97,14 +97,17 @@ public:
"Calls to other signatures of this command may set the property " "Calls to other signatures of this command may set the property "
"making any libraries linked exclusively by this signature private." "making any libraries linked exclusively by this signature private."
"\n" "\n"
"Target usage requirements are also consumed by this command. If the " "CMake will also propagate \"usage requirements\" from linked library "
"<target> is linked to another target which has " "targets. "
"a populated INTERFACE_INCLUDE_DIRECTORIES, the content of it is " "Usage requirements affect compilation of sources in the <target>. "
"appended to the INCLUDE_DIRECTORIES of <target>. Similarly, the " "They are specified by properties defined on linked targets. "
"INTERFACE_COMPILE_DEFINITONS of a dependee are added to the " "During generation of the build system, CMake integrates "
"COMPILE_DEFINITONS of <target>, and the " "usage requirement property values with the corresponding "
"INTERFACE_POSITION_INDEPENDENT_CODE property is used to determine the " "build properties for <target>:\n"
"POSITION_INDEPENDENT_CODE property of <target>." " INTERFACE_COMPILE_DEFINITONS: Appends to COMPILE_DEFINITONS\n"
" INTERFACE_INCLUDE_DIRECTORIES: Appends to INCLUDE_DIRECTORIES\n"
" INTERFACE_POSITION_INDEPENDENT_CODE: Sets POSITION_INDEPENDENT_CODE\n"
" or checked for consistency with existing value\n"
"\n" "\n"
" target_link_libraries(<target> LINK_INTERFACE_LIBRARIES\n" " target_link_libraries(<target> LINK_INTERFACE_LIBRARIES\n"
" [[debug|optimized|general] <lib>] ...)\n" " [[debug|optimized|general] <lib>] ...)\n"