summaryrefslogtreecommitdiffstats
path: root/Help/prop_tgt/IMPORTED_NO_SYSTEM.rst
blob: c8ec8b5c4857a88ba4956fe3912f44bdf513164b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
IMPORTED_NO_SYSTEM
------------------

.. versionadded:: 3.23

.. deprecated:: 3.25

  ``IMPORTED_NO_SYSTEM`` is deprecated. Please use the following alternatives
  instead:

  * 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
  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.

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
the one *providing* them.