summaryrefslogtreecommitdiff
path: root/Help/manual
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2023-02-16 16:43:58 +0000
committerKitware Robot <kwrobot@kitware.com>2023-02-16 11:44:05 -0500
commit51c79170720abc16981381c924e2c50b5ed45ecf (patch)
treeefd62eb97b4ba883e4a73cdf54beb4b52d17f0a0 /Help/manual
parent335110627d4487391e628645b1220a4da11378d5 (diff)
parentef5a4d964ba1743fd7c343f1a6194ff82936d014 (diff)
downloadcmake-51c79170720abc16981381c924e2c50b5ed45ecf.tar.gz
Merge topic 'deprecate-extra-generators'
ef5a4d964b Deprecate "extra" generators in favor of cmake-file-api(7) Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8211
Diffstat (limited to 'Help/manual')
-rw-r--r--Help/manual/cmake-generators.7.rst6
-rw-r--r--Help/manual/cmake.1.rst2
2 files changed, 7 insertions, 1 deletions
diff --git a/Help/manual/cmake-generators.7.rst b/Help/manual/cmake-generators.7.rst
index ed5bbbf6cb..9647f0d11d 100644
--- a/Help/manual/cmake-generators.7.rst
+++ b/Help/manual/cmake-generators.7.rst
@@ -107,6 +107,12 @@ Other Generators
Extra Generators
================
+.. deprecated:: 3.27
+
+ Support for "Extra Generators" is deprecated and will be removed from
+ a future version of CMake. IDEs may use the :manual:`cmake-file-api(7)`
+ to view CMake-generated project build trees.
+
Some of the `CMake Generators`_ listed in the :manual:`cmake(1)`
command-line tool :option:`--help <cmake --help>` output may have
variants that specify an extra generator for an auxiliary IDE tool.
diff --git a/Help/manual/cmake.1.rst b/Help/manual/cmake.1.rst
index b72979028c..a107c66b6f 100644
--- a/Help/manual/cmake.1.rst
+++ b/Help/manual/cmake.1.rst
@@ -781,7 +781,7 @@ Available commands are:
(:option:`-A ... <cmake -A>`). The value is a list of platforms known to
be supported.
``extraGenerators``
- A list of strings with all the extra generators compatible with
+ A list of strings with all the :ref:`Extra Generators` compatible with
the generator.
``fileApi``