diff options
Diffstat (limited to 'Help/prop_tgt/IMPORTED_NO_SYSTEM.rst')
| -rw-r--r-- | Help/prop_tgt/IMPORTED_NO_SYSTEM.rst | 28 |
1 files changed, 16 insertions, 12 deletions
diff --git a/Help/prop_tgt/IMPORTED_NO_SYSTEM.rst b/Help/prop_tgt/IMPORTED_NO_SYSTEM.rst index 913d9f2..c8ec8b5 100644 --- a/Help/prop_tgt/IMPORTED_NO_SYSTEM.rst +++ b/Help/prop_tgt/IMPORTED_NO_SYSTEM.rst @@ -5,27 +5,31 @@ IMPORTED_NO_SYSTEM .. deprecated:: 3.25 - ``IMPORTED_NO_SYSTEM`` is deprecated. Set :prop_tgt:`SYSTEM` to `OFF` - instead if you don't want target's include directories to be ``SYSTEM`` - when compiling consumers. Set :prop_tgt:`EXPORT_NO_SYSTEM` to `ON` instead - if you don't want the include directories of the imported target generated - by :command:`install(EXPORT)` and :command:`export` commands to be - ``SYSTEM`` when compiling consumers. + ``IMPORTED_NO_SYSTEM`` is deprecated. Please use the following alternatives + instead: -Specifies that an :ref:`Imported Target <Imported Targets>` is not -a ``SYSTEM`` library. This has the following effects: + * Set :prop_tgt:`SYSTEM` to false if you don't want a target's include + directories to be treated as system directories when compiling consumers. + * Set :prop_tgt:`EXPORT_NO_SYSTEM` to true if you don't want the include + directories of the imported target generated by :command:`install(EXPORT)` + and :command:`export` commands to be treated as system directories when + compiling consumers. + +Setting ``IMPORTED_NO_SYSTEM`` to true on an +:ref:`imported target <Imported Targets>` specifies that it is not a +system target. This has the following effects: * Entries of :prop_tgt:`INTERFACE_INCLUDE_DIRECTORIES` are not treated - as ``SYSTEM`` include directories when compiling consumers (regardless of + as system include directories when compiling consumers (regardless of the value of the consumed target's :prop_tgt:`SYSTEM` property), as they would be by default. Entries of :prop_tgt:`INTERFACE_SYSTEM_INCLUDE_DIRECTORIES` are not affected, - and will always be treated as ``SYSTEM`` include directories. + and will always be treated as system include directories. This property can also be enabled on a non-imported target. Doing so does not affect the build system, but does tell the :command:`install(EXPORT)` and :command:`export` commands to enable it on the imported targets they generate. See the :prop_tgt:`NO_SYSTEM_FROM_IMPORTED` target property to set this -behavior on the target consuming the include directories rather than -providing them. +behavior on the target *consuming* the include directories rather than +the one *providing* them. |