cmake/Help/prop_tgt/SYSTEM.rst

23 lines
931 B
ReStructuredText
Raw Normal View History

2022-11-16 20:14:03 +01:00
SYSTEM
------
.. versionadded:: 3.25
2023-05-23 16:38:00 +02:00
Specifies that a target is a system target. This has the following
2022-11-16 20:14:03 +01:00
effects:
* Entries of :prop_tgt:`INTERFACE_INCLUDE_DIRECTORIES` are treated as
2023-05-23 16:38:00 +02:00
system include directories when compiling consumers.
2022-11-16 20:14:03 +01:00
Entries of :prop_tgt:`INTERFACE_SYSTEM_INCLUDE_DIRECTORIES` are not
2023-05-23 16:38:00 +02:00
affected, and will always be treated as system include directories.
2022-11-16 20:14:03 +01:00
For imported targets, this property defaults to true, which means
that their :prop_tgt:`INTERFACE_INCLUDE_DIRECTORIES` are treated
2023-05-23 16:38:00 +02:00
as system directories by default. If their ``SYSTEM`` property is false,
2022-11-16 20:14:03 +01:00
then their :prop_tgt:`INTERFACE_INCLUDE_DIRECTORIES` will not be
2023-05-23 16:38:00 +02:00
treated as system. Use the :prop_tgt:`EXPORT_NO_SYSTEM` property to change
how a target's ``SYSTEM`` property is set when it is installed.
2022-11-16 20:14:03 +01:00
2023-05-23 16:38:00 +02:00
For non-imported targets, this target property is initialized from
the :prop_dir:`SYSTEM` directory property when the target is created.