mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-06 13:51:33 -06:00
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
17 lines
634 B
ReStructuredText
17 lines
634 B
ReStructuredText
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)`.
|
|
|
|
When using the Eclipse, CodeBlocks, CodeLite, Kate or Sublime generators, CMake
|
|
generates Makefiles (:variable:`CMAKE_GENERATOR`) and additionally project
|
|
files for the respective IDE. This IDE project file generator is stored in
|
|
``CMAKE_EXTRA_GENERATOR`` (e.g. ``Eclipse CDT4``).
|