From ef17e29389f6712c34117944e0bd83bf46b8d7a0 Mon Sep 17 00:00:00 2001 From: Stephen Kelly Date: Sun, 9 Feb 2014 11:55:12 +0100 Subject: [PATCH] Help: Document SYSTEM treatment of IMPORTED target INTERFACE_INCLUDE_DIRS Document how the behavior can be controlled. --- Help/manual/cmake-buildsystem.7.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/Help/manual/cmake-buildsystem.7.rst b/Help/manual/cmake-buildsystem.7.rst index 91a9b2f9ba..04837b4be5 100644 --- a/Help/manual/cmake-buildsystem.7.rst +++ b/Help/manual/cmake-buildsystem.7.rst @@ -602,6 +602,14 @@ This is equivalent to appending ``${CMAKE_INSTALL_PREFIX}/include`` to the :prop_tgt:`INTERFACE_INCLUDE_DIRECTORIES` of each of the installed :prop_tgt:`IMPORTED` targets when generated by :command:`install(EXPORT)`. +When the :prop_tgt:`INTERFACE_INCLUDE_DIRECTORIES` of an +:ref:`imported target ` is consumed, the entries in the +property are treated as ``SYSTEM`` include directories, as if they were +listed in the :prop_tgt:`INTERFACE_SYSTEM_INCLUDE_DIRECTORIES` of the +dependency. This can result in omission of compiler warnings for headers +found in those directories. This behavior for :ref:`imported targets` may +be controlled with the :prop_tgt:`NO_SYSTEM_FROM_IMPORTED` target property. + If a binary target is linked transitively to a Mac OX framework, the ``Headers`` directory of the framework is also treated as a usage requirement. This has the same effect as passing the framework directory as an include