summaryrefslogtreecommitdiffstats
path: root/Help/prop_tgt/SYSTEM.rst
diff options
context:
space:
mode:
authorDa Quexian <daquexian566@gmail.com>2022-06-01 08:36:59 (GMT)
committerDa Quexian <daquexian566@gmail.com>2022-06-15 16:25:27 (GMT)
commit69beee5314f70b3ddee8029f6ab3d684035005e5 (patch)
treed7d81758ec61f5eddb58cf41768a8e598b270b51 /Help/prop_tgt/SYSTEM.rst
parent85dc7c763a12366d49ac2dddc53f65d52d675c00 (diff)
downloadCMake-69beee5314f70b3ddee8029f6ab3d684035005e5.zip
CMake-69beee5314f70b3ddee8029f6ab3d684035005e5.tar.gz
CMake-69beee5314f70b3ddee8029f6ab3d684035005e5.tar.bz2
Add SYSTEM target property
If it is ON, treat INTERFACE_INCLUDE_DIRECTORIES as system include directories. Issue: #18040 Signed-off-by: Da Quexian <daquexian566@gmail.com>
Diffstat (limited to 'Help/prop_tgt/SYSTEM.rst')
-rw-r--r--Help/prop_tgt/SYSTEM.rst16
1 files changed, 16 insertions, 0 deletions
diff --git a/Help/prop_tgt/SYSTEM.rst b/Help/prop_tgt/SYSTEM.rst
new file mode 100644
index 0000000..2db6aed
--- /dev/null
+++ b/Help/prop_tgt/SYSTEM.rst
@@ -0,0 +1,16 @@
+SYSTEM
+------
+
+.. versionadded:: 3.25
+
+Specifies that a target is a ``SYSTEM`` library. This has the following effects:
+
+* Entries of :prop_tgt:`INTERFACE_INCLUDE_DIRECTORIES` are treated as ``SYSTEM``
+ include directories when compiling consumers.
+ Entries of :prop_tgt:`INTERFACE_SYSTEM_INCLUDE_DIRECTORIES` are not affected,
+ and will always be treated as ``SYSTEM`` include directories.
+
+For imported targets, this property has a default value `ON`, which means that their
+`INTERFACE_INCLUDE_DIRECTORIES` are treated as ``SYSTEM`` by default. If their
+`SYSTEM` property is `OFF`, then their `INTERFACE_INCLUDE_DIRECTORIES` will not be
+treated as ``SYSTEM``, regardless of the value of `IMPORTED_NO_SYSTEM` property.