mirror of
https://github.com/Kitware/CMake.git
synced 2026-02-13 18:49:38 -06:00
ad3c2c0b03
Every policy's documentation has a paragraph on what version of CMake introduced it, how to set the policy, and whether CMake warns if the policy is not set. The wording of this paragraph has diverged across policies over time. Factor the paragraph out into a standard advice document included by every policy.
24 lines
839 B
ReStructuredText
24 lines
839 B
ReStructuredText
CMP0147
|
|
-------
|
|
|
|
.. versionadded:: 3.27
|
|
|
|
:ref:`Visual Studio Generators` build custom commands in parallel.
|
|
|
|
Visual Studio 15.8 (2017) and newer support building custom commands in
|
|
parallel. CMake 3.27 and above prefer to enable this behavior by adding
|
|
a ``BuildInParallel`` setting to custom commands in ``.vcxproj`` files.
|
|
This policy provides compatibility for projects that have not been updated
|
|
to expect this, e.g., because their custom commands were accidentally
|
|
relying on serial execution by MSBuild.
|
|
|
|
The ``OLD`` behavior for this policy is to not add ``BuildInParallel``.
|
|
The ``NEW`` behavior for this policy is to add ``BuildInParallel`` for
|
|
VS 15.8 and newer.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.27
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: does *not* warn
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|