cmake: add supported platforms to cmake -E capabilties report

2 files changed, 12 insertions, 0 deletions

diff --git a/Help/manual/cmake.1.rst b/Help/manual/cmake.1.rst
index f416f86..55e01e1 100644
--- a/Help/manual/cmake.1.rst
+++ b/Help/manual/cmake.1.rst
@@ -575,6 +575,12 @@ Available commands are:
       ``true`` if the generator supports toolsets and ``false`` otherwise.
     ``platformSupport``
       ``true`` if the generator supports platforms and ``false`` otherwise.
+    ``supportedPlatforms``
+      .. versionadded:: 3.21
+
+      Optional member that may be present when the generator supports
+      platform specification via :variable:`CMAKE_GENERATOR_PLATFORM`
+      (``-A ...``).  The value is a list of platforms known to be supported.
     ``extraGenerators``
       A list of strings with all the extra generators compatible with
       the generator.
diff --git a/Help/release/dev/capabilties-generator-platforms.rst b/Help/release/dev/capabilties-generator-platforms.rst
new file mode 100644
index 0000000..5de2b67
--- /dev/null
+++ b/Help/release/dev/capabilties-generator-platforms.rst
@@ -0,0 +1,6 @@
+capabilties-generator-platforms
+-------------------------------
+
+* The :manual:`cmake(1)` ``-E capabilities`` output now contains for each
+  generator a ``supportedPlatforms`` field listing platform known to
+  be supported in :variable:`CMAKE_GENERATOR_PLATFORM`.