ee22d6f1985445a9f01502da89c12090d4076fa3
[platform/upstream/cmake.git] / Help / prop_tgt / IMPORTED_NO_SYSTEM.rst
1 IMPORTED_NO_SYSTEM
2 ------------------
3
4 .. versionadded:: 3.23
5
6 Specifies that an :ref:`Imported Target <Imported Targets>` is not
7 a ``SYSTEM`` library.  This has the following effects:
8
9 * Entries of :prop_tgt:`INTERFACE_INCLUDE_DIRECTORIES` are not treated
10   as ``SYSTEM`` include directories when compiling consumers, as they
11   would be by default.   Entries of
12   :prop_tgt:`INTERFACE_SYSTEM_INCLUDE_DIRECTORIES` are not affected,
13   and will always be treated as ``SYSTEM`` include directories.
14
15 This property can also be enabled on a non-imported target.  Doing so does
16 not affect the build system, but does tell the :command:`install(EXPORT)` and
17 :command:`export` commands to enable it on the imported targets they generate.
18
19 See the :prop_tgt:`NO_SYSTEM_FROM_IMPORTED` target property to set this
20 behavior on the target consuming the include directories rather than
21 providing them.