diff options
| author | Brad King <brad.king@kitware.com> | 2015-01-23 15:50:31 (GMT) |
|---|---|---|
| committer | CMake Topic Stage <kwrobot@kitware.com> | 2015-01-23 15:50:31 (GMT) |
| commit | 154bf8da991a6cbc82e5ef89979549b10d19f561 (patch) | |
| tree | dc4b59001104176963bb10836f8191bbce768bb4 /Help | |
| parent | 103f77e5122edf60b51e5c49af9231b657eed300 (diff) | |
| parent | 85857e6d1c1859bdc8ab4206e0329e846b6ef020 (diff) | |
| download | CMake-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.rst | 11 |
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 |