From b080922be6e9e67fee937ebdf44772beb58ffd74 Mon Sep 17 00:00:00 2001 From: Vito Gamberini Date: Wed, 28 Jan 2026 18:41:35 -0500 Subject: [PATCH] cmake-cxxmodules: Note config limitations Today, CMake doesn't support configuration-agnostic module maps. For CMakeConfig exports, this is irrelevant. For CPS, this may possibly cause friction with other build systems. Briefly note that we don't support this until we build a solution. --- Help/manual/cmake-cxxmodules.7.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/Help/manual/cmake-cxxmodules.7.rst b/Help/manual/cmake-cxxmodules.7.rst index 4787a900bf..f3e31c133c 100644 --- a/Help/manual/cmake-cxxmodules.7.rst +++ b/Help/manual/cmake-cxxmodules.7.rst @@ -126,6 +126,12 @@ For the :ref:`Visual Studio Generators`: - Use of modules provided by ``PRIVATE`` sources from ``PUBLIC`` module sources is not diagnosed. +Separately, as a design choice, CMake does not express configuration-agnostic +module maps for imported targets. The :prop_tgt:`IMPORTED_CXX_MODULES_` +target property is always tied to a specific configuration. This can lead to +some friction when importing/exporting targets from/to configuration-unaware +build systems. Future work will alleviate this restriction. + Usage =====