diff options
| author | Brad King <brad.king@kitware.com> | 2022-12-06 00:42:06 (GMT) |
|---|---|---|
| committer | Brad King <brad.king@kitware.com> | 2022-12-06 00:42:06 (GMT) |
| commit | b15b9cf286ef1b878103cf9be8cf8ae32347ee35 (patch) | |
| tree | 350c7c3553893ec8d91c95ea746af364599e302e | |
| parent | 60fc165dcb9211ed0dda20ee2887414f339c5d9a (diff) | |
| download | CMake-b15b9cf286ef1b878103cf9be8cf8ae32347ee35.zip CMake-b15b9cf286ef1b878103cf9be8cf8ae32347ee35.tar.gz CMake-b15b9cf286ef1b878103cf9be8cf8ae32347ee35.tar.bz2 | |
Help: Clarify SYSTEM property default for imported targets
The `SYSTEM` directory property does not affect imported targets.
Fixes: #24219
| -rw-r--r-- | Help/command/add_subdirectory.rst | 6 | ||||
| -rw-r--r-- | Help/prop_dir/SYSTEM.rst | 4 | ||||
| -rw-r--r-- | Help/prop_tgt/SYSTEM.rst | 4 |
3 files changed, 7 insertions, 7 deletions
diff --git a/Help/command/add_subdirectory.rst b/Help/command/add_subdirectory.rst index 13cae10..8640eeb 100644 --- a/Help/command/add_subdirectory.rst +++ b/Help/command/add_subdirectory.rst @@ -36,7 +36,7 @@ the dependency. If the ``SYSTEM`` argument is provided, the :prop_dir:`SYSTEM` directory property of the subdirectory will be set to true. This property is -used to initialize the :prop_tgt:`SYSTEM` property of each target -created in that subdirectory. The include directories of targets with -:prop_tgt:`SYSTEM` set to true will be treated as ``SYSTEM`` when +used to initialize the :prop_tgt:`SYSTEM` property of each non-imported +target created in that subdirectory. The include directories of targets +with :prop_tgt:`SYSTEM` set to true will be treated as ``SYSTEM`` when compiling consumers. diff --git a/Help/prop_dir/SYSTEM.rst b/Help/prop_dir/SYSTEM.rst index 4f923b7..ad4ace1 100644 --- a/Help/prop_dir/SYSTEM.rst +++ b/Help/prop_dir/SYSTEM.rst @@ -4,7 +4,7 @@ SYSTEM .. versionadded:: 3.25 This directory property is used to initialize the :prop_tgt:`SYSTEM` -target property for targets created in that directory. It is set to -true by :command:`add_subdirectory` and +target property for non-imported targets created in that directory. +It is set to true by :command:`add_subdirectory` and :command:`FetchContent_Declare` when the ``SYSTEM`` option is given as an argument to those commands. diff --git a/Help/prop_tgt/SYSTEM.rst b/Help/prop_tgt/SYSTEM.rst index a267738..6399d24 100644 --- a/Help/prop_tgt/SYSTEM.rst +++ b/Help/prop_tgt/SYSTEM.rst @@ -18,5 +18,5 @@ 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. +For non-imported targets, this target property is initialized from +the :prop_dir:`SYSTEM` directory property when the target is created. |