diff options
| author | Brad King <brad.king@kitware.com> | 2017-10-13 18:27:20 (GMT) |
|---|---|---|
| committer | Brad King <brad.king@kitware.com> | 2017-10-13 18:32:15 (GMT) |
| commit | 22beb07f9871338c3cdc1ce47bf1da0433519547 (patch) | |
| tree | 8e862c98a0b6e99270e957dbf07243f1f5008e69 /Help | |
| parent | 2de0e0fdfaed1c10d3b38a8fb7ff86698a0308aa (diff) | |
| download | CMake-22beb07f9871338c3cdc1ce47bf1da0433519547.zip CMake-22beb07f9871338c3cdc1ce47bf1da0433519547.tar.gz CMake-22beb07f9871338c3cdc1ce47bf1da0433519547.tar.bz2 | |
Help: Clarify documentation of NO_SYSTEM_FROM_IMPORTED
This property is meant to be set on the consumers of imported targets,
not the imported targets themselves.
Fixes: #17348
Diffstat (limited to 'Help')
| -rw-r--r-- | Help/manual/cmake-buildsystem.7.rst | 3 | ||||
| -rw-r--r-- | Help/prop_tgt/NO_SYSTEM_FROM_IMPORTED.rst | 18 |
2 files changed, 13 insertions, 8 deletions
diff --git a/Help/manual/cmake-buildsystem.7.rst b/Help/manual/cmake-buildsystem.7.rst index 5cfe725..ae538ed 100644 --- a/Help/manual/cmake-buildsystem.7.rst +++ b/Help/manual/cmake-buildsystem.7.rst @@ -687,7 +687,8 @@ 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. +be controlled by setting the :prop_tgt:`NO_SYSTEM_FROM_IMPORTED` target +property on the *consumers* of imported targets. 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. diff --git a/Help/prop_tgt/NO_SYSTEM_FROM_IMPORTED.rst b/Help/prop_tgt/NO_SYSTEM_FROM_IMPORTED.rst index 070dd30..880343d 100644 --- a/Help/prop_tgt/NO_SYSTEM_FROM_IMPORTED.rst +++ b/Help/prop_tgt/NO_SYSTEM_FROM_IMPORTED.rst @@ -1,11 +1,15 @@ NO_SYSTEM_FROM_IMPORTED ----------------------- -Do not treat includes from IMPORTED target interfaces as SYSTEM. +Do not treat include directories from the interfaces of consumed +:ref:`imported targets` as ``SYSTEM``. -The contents of the INTERFACE_INCLUDE_DIRECTORIES of IMPORTED targets -are treated as SYSTEM includes by default. If this property is -enabled, the contents of the INTERFACE_INCLUDE_DIRECTORIES of IMPORTED -targets are not treated as system includes. This property is -initialized by the value of the variable CMAKE_NO_SYSTEM_FROM_IMPORTED -if it is set when a target is created. +The contents of the :prop_tgt:`INTERFACE_INCLUDE_DIRECTORIES` target property +of imported targets are treated as ``SYSTEM`` includes by default. If this +property is enabled on a target, compilation of sources in that target will +not treat the contents of the ``INTERFACE_INCLUDE_DIRECTORIES`` of consumed +imported targets as system includes. + +This property is initialized by the value of the +:variable:`CMAKE_NO_SYSTEM_FROM_IMPORTED` variable if it is set when a target +is created. |