Help/prop_tgt/SYSTEM.rst

   1 SYSTEM
   2 ------
   3
   4 .. versionadded:: 3.25
   5
   6 Specifies that a target is a ``SYSTEM`` library.  This has the following
   7 effects:
   8
   9 * Entries of :prop_tgt:`INTERFACE_INCLUDE_DIRECTORIES` are treated as
  10   ``SYSTEM`` include directories when compiling consumers.
  11   Entries of :prop_tgt:`INTERFACE_SYSTEM_INCLUDE_DIRECTORIES` are not
  12   affected, and will always be treated as ``SYSTEM`` include directories.
  13
  14 For imported targets, this property defaults to true, which means
  15 that their :prop_tgt:`INTERFACE_INCLUDE_DIRECTORIES` are treated
  16 as ``SYSTEM`` by default. If their ``SYSTEM`` property is false,
  17 then their :prop_tgt:`INTERFACE_INCLUDE_DIRECTORIES` will not be
  18 treated as ``SYSTEM``, regardless of the value of the
  19 :prop_tgt:`IMPORTED_NO_SYSTEM` property.
  20
  21 This target property is initialized from the :prop_dir:`SYSTEM`
  22 directory property when the target is created.