496ec6036f
Run the `Utilities/Sphinx/update_versions.py` script to add initial markup to every top-level document and find module. Issue: #19715
23 lines
820 B
ReStructuredText
23 lines
820 B
ReStructuredText
CMAKE_UNITY_BUILD
|
|
-----------------
|
|
|
|
.. versionadded:: 3.16
|
|
|
|
This variable is used to initialize the :prop_tgt:`UNITY_BUILD`
|
|
property of targets when they are created. Setting it to true
|
|
enables batch compilation of multiple sources within each target.
|
|
This feature is known as a *Unity* or *Jumbo* build.
|
|
|
|
Projects should not set this variable, it is intended as a developer
|
|
control to be set on the :manual:`cmake(1)` command line or other
|
|
equivalent methods. The developer must have the ability to enable or
|
|
disable unity builds according to the capabilities of their own machine
|
|
and compiler.
|
|
|
|
By default, this variable is not set, which will result in unity builds
|
|
being disabled.
|
|
|
|
.. note::
|
|
This option currently does not work well in combination with
|
|
the :variable:`CMAKE_EXPORT_COMPILE_COMMANDS` variable.
|