mirror/CMake
1
0
Fork 0
mirror of https://github.com/Kitware/CMake.git synced 2026-01-06 05:40:54 -06:00
Code Issues Packages Projects Releases Wiki Activity

Deprecate "extra" generators in favor of cmake-file-api(7)

Browse Source 
The "extra" generators were created in CMake's early years to provide
support for users of specific IDEs by directly generating their project
files alongside make or ninja files.  Nowadays the file-api provides a
more generic, maintainable, well-tested, and robust way for IDEs to view
CMake project build trees.  Deprecate the legacy "extra" generators to
encourage the corresponding IDEs to use the file-api.

Fixes: #19090
This commit is contained in:
Brad King
2023-02-15 10:38:45 -05:00
parent 37f068083b
commit ef5a4d964b
17 changed files with 75 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

3
Help/variable/CMAKE_EDIT_COMMAND.rst
View File

@@ -2,7 +2,8 @@ CMAKE_EDIT_COMMAND
------------------
Full path to :manual:`cmake-gui(1)` or :manual:`ccmake(1)`. Defined only for
:ref:`Makefile Generators` when not using an "extra" generator for an IDE.
:ref:`Makefile Generators` and :ref:`Ninja Generators` when not using any
:ref:`Extra Generators`.
This is the full path to the CMake executable that can graphically
edit the cache. For example, :manual:`cmake-gui(1)` or :manual:`ccmake(1)`.

6
Help/variable/CMAKE_EXTRA_GENERATOR.rst
View File

@@ -1,6 +1,12 @@
CMAKE_EXTRA_GENERATOR
---------------------
.. deprecated:: 3.27
Support for :ref:`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.
The extra generator used to build the project. See
:manual:`cmake-generators(7)`.