summaryrefslogtreecommitdiffstats
path: root/Help/prop_tgt
diff options
context:
space:
mode:
authorDa Quexian <daquexian566@gmail.com>2022-06-22 12:18:06 (GMT)
committerBrad King <brad.king@kitware.com>2022-09-26 14:56:54 (GMT)
commit2eb30a7036214ec960f0666163ff44ef754f6afe (patch)
tree19f7bc19562409245f326da04371acbca8e9ea85 /Help/prop_tgt
parent80e4a155e0feddf1a02fb2701dff5ddbb427552a (diff)
downloadCMake-2eb30a7036214ec960f0666163ff44ef754f6afe.zip
CMake-2eb30a7036214ec960f0666163ff44ef754f6afe.tar.gz
CMake-2eb30a7036214ec960f0666163ff44ef754f6afe.tar.bz2
add_subdirectory: Add SYSTEM option
Fixes: #22401 Signed-off-by: Da Quexian <daquexian566@gmail.com>
Diffstat (limited to 'Help/prop_tgt')
-rw-r--r--Help/prop_tgt/SYSTEM.rst24
1 files changed, 15 insertions, 9 deletions
diff --git a/Help/prop_tgt/SYSTEM.rst b/Help/prop_tgt/SYSTEM.rst
index 2db6aed..a267738 100644
--- a/Help/prop_tgt/SYSTEM.rst
+++ b/Help/prop_tgt/SYSTEM.rst
@@ -3,14 +3,20 @@ SYSTEM
.. versionadded:: 3.25
-Specifies that a target is a ``SYSTEM`` library. This has the following effects:
+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.
+* 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.
+For imported targets, this property defaults to true, which means
+that their :prop_tgt:`INTERFACE_INCLUDE_DIRECTORIES` are treated
+as ``SYSTEM`` by default. If their ``SYSTEM`` property is false,
+then their :prop_tgt:`INTERFACE_INCLUDE_DIRECTORIES` will not be
+treated as ``SYSTEM``, regardless of the value of the
+:prop_tgt:`IMPORTED_NO_SYSTEM` property.
+
+This target property is initialized from the :prop_dir:`SYSTEM`
+directory property when the target is created.