summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2015-01-23 15:50:31 (GMT)
committerCMake Topic Stage <kwrobot@kitware.com>2015-01-23 15:50:31 (GMT)
commit154bf8da991a6cbc82e5ef89979549b10d19f561 (patch)
treedc4b59001104176963bb10836f8191bbce768bb4 /Help
parent103f77e5122edf60b51e5c49af9231b657eed300 (diff)
parent85857e6d1c1859bdc8ab4206e0329e846b6ef020 (diff)
downloadCMake-154bf8da991a6cbc82e5ef89979549b10d19f561.zip
CMake-154bf8da991a6cbc82e5ef89979549b10d19f561.tar.gz
CMake-154bf8da991a6cbc82e5ef89979549b10d19f561.tar.bz2
Merge topic 'INTERFACE_SYSTEM_INCLUDE_DIRECTORIES-update'
85857e6d Help: Clarify INTERFACE_SYSTEM_INCLUDE_DIRECTORIES documentation. ee38062b IncludeDirectories: Respect SYSTEM flag when using CONFIG genex.
Diffstat (limited to 'Help')
-rw-r--r--Help/prop_tgt/INTERFACE_SYSTEM_INCLUDE_DIRECTORIES.rst11
1 files changed, 9 insertions, 2 deletions
diff --git a/Help/prop_tgt/INTERFACE_SYSTEM_INCLUDE_DIRECTORIES.rst b/Help/prop_tgt/INTERFACE_SYSTEM_INCLUDE_DIRECTORIES.rst
index b54b6c1..a0a97ad 100644
--- a/Help/prop_tgt/INTERFACE_SYSTEM_INCLUDE_DIRECTORIES.rst
+++ b/Help/prop_tgt/INTERFACE_SYSTEM_INCLUDE_DIRECTORIES.rst
@@ -7,8 +7,15 @@ Targets may populate this property to publish the include directories
which contain system headers, and therefore should not result in
compiler warnings. The :command:`target_include_directories(SYSTEM)`
command signature populates this property with values given to the
-``PUBLIC`` and ``INTERFACE`` keywords. Projects may also get and set the
-property directly.
+``PUBLIC`` and ``INTERFACE`` keywords.
+
+Projects may also get and set the property directly, but must be aware that
+adding directories to this property does not make those directories used
+during compilation. Adding directories to this property marks directories
+as ``SYSTEM`` which otherwise would be used in a non-``SYSTEM`` manner. This
+can appear similar to 'duplication', so prefer the
+high-level :command:`target_include_directories(SYSTEM)` command and avoid
+setting the property by low-level means.
When target dependencies are specified using :command:`target_link_libraries`,
CMake will read this property from all target dependencies to mark the