summaryrefslogtreecommitdiffstats
path: root/Help/policy/CMP0155.rst
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2023-11-01 17:47:57 (GMT)
committerKitware Robot <kwrobot@kitware.com>2023-11-01 17:48:14 (GMT)
commit59c3ce4c838c0ff8614f0091033183c336f874d6 (patch)
tree5f10e551d340214d330d814ee64400f99f50739c /Help/policy/CMP0155.rst
parent8b95e3ff434948541fcbaeaa03e1137eda846abe (diff)
parent1f507580a13b2883a016cab2f18cf3d6f868d269 (diff)
downloadCMake-59c3ce4c838c0ff8614f0091033183c336f874d6.zip
CMake-59c3ce4c838c0ff8614f0091033183c336f874d6.tar.gz
CMake-59c3ce4c838c0ff8614f0091033183c336f874d6.tar.bz2
Merge topic 'cxxmodules-cmp0155-graceful-fallback-without-scanner' into release-3.28
1f507580a1 cmGlobalGenerator: give context about module queries 889aa0354a CMP0155: ignore scanning for sources if no scanner is available Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !8925
Diffstat (limited to 'Help/policy/CMP0155.rst')
-rw-r--r--Help/policy/CMP0155.rst6
1 files changed, 4 insertions, 2 deletions
diff --git a/Help/policy/CMP0155.rst b/Help/policy/CMP0155.rst
index 2dafadf..8b741cb 100644
--- a/Help/policy/CMP0155.rst
+++ b/Help/policy/CMP0155.rst
@@ -3,7 +3,8 @@ CMP0155
.. versionadded:: 3.28
-C++ sources in targets with at least C++20 are scanned for imports.
+C++ sources in targets with at least C++20 are scanned for imports
+when supported.
CMake 3.27 and below assume that C++ sources do not ``import`` modules.
CMake 3.28 and above prefer to assume that C++ sources in targets using C++20
@@ -16,7 +17,8 @@ support.
The ``OLD`` behavior for this policy is to assume that C++ 20 and newer
sources do not import modules. The ``NEW`` behavior for this policy is to
-assume that C++ 20 and newer files may import modules, and need to be scanned.
+assume that C++ 20 and newer files may import modules if the compiler
+understands how to scan for their dependencies, and need to be scanned.
This policy was introduced in CMake version 3.28. Use the
:command:`cmake_policy` command to set it to ``OLD`` or ``NEW`` explicitly.