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

Merge topic 'vs-compile-batching' into release-3.24

Browse Source 
9a0a94fdaa VS: Add variable to to turn off Visual Studio compile batching
a7ebb73929 Help: Improve formatting in VS_NO_COMPILE_BATCHING docs

Acked-by: Kitware Robot <kwrobot@kitware.com>
Acked-by: buildbot <buildbot@kitware.com>
Merge-request: !7405
This commit is contained in:
Brad King
2022-06-23 13:23:48 +00:00
committed by Kitware Robot
parent 46305219eb 9a0a94fdaa
commit fd83847b14
6 changed files with 35 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
Help/manual/cmake-variables.7.rst
View File

@@ -516,6 +516,7 @@ Variables that Control the Build
/variable/CMAKE_VS_INCLUDE_INSTALL_TO_DEFAULT_BUILD
/variable/CMAKE_VS_INCLUDE_PACKAGE_TO_DEFAULT_BUILD
/variable/CMAKE_VS_JUST_MY_CODE_DEBUGGING
/variable/CMAKE_VS_NO_COMPILE_BATCHING
/variable/CMAKE_VS_SDK_EXCLUDE_DIRECTORIES
/variable/CMAKE_VS_SDK_EXECUTABLE_DIRECTORIES
/variable/CMAKE_VS_SDK_INCLUDE_DIRECTORIES

11
Help/prop_tgt/VS_NO_COMPILE_BATCHING.rst
View File

@@ -6,14 +6,17 @@ VS_NO_COMPILE_BATCHING
Turn off compile batching for the target. Usually MSBuild calls the compiler
with multiple c/cpp files and compiler starts subprocesses for each file to
make the build parallel. If you want compiler to be invoked with one file at
a time set VS_NO_COMPILE_BATCHING to ON. If this flag is set MSBuild will call
compiler with one c/cpp file at a time. Useful when you want to use tool that
replaces the compiler, for example some build caching tool.
a time set ``VS_NO_COMPILE_BATCHING`` to ON. If this flag is set MSBuild will
call compiler with one c/cpp file at a time. Useful when you want to use tool
that replaces the compiler, for example some build caching tool.
This property is initialized by the :variable:`CMAKE_VS_NO_COMPILE_BATCHING`
variable if it is set when a target is created.
Example
^^^^^^^
This shows setting the variable for the target foo.
This shows setting the property for the target ``foo``.
.. code-block:: cmake

9
Help/release/3.24.rst
View File

@@ -154,6 +154,11 @@ Variables
were added to enable build rules that verify all headers in header sets
can be used on their own.
* The :variable:`CMAKE_VS_NO_COMPILE_BATCHING` variable and corresponding
:prop_tgt:`VS_NO_COMPILE_BATCHING` target property were added to
tell :ref:`Visual Studio Generators` whether to disable compiler
parallelism and call the compiler with one source file at a time.
* The :variable:`CMAKE_WATCOM_RUNTIME_LIBRARY` variable and
:prop_tgt:`WATCOM_RUNTIME_LIBRARY` target property were introduced to
select the runtime library used by compilers targeting the Watcom ABI.
@@ -185,10 +190,6 @@ Properties
than one ``static void Main(string[])`` function signature is available
in a managed .NET project.
* The :prop_tgt:`VS_NO_COMPILE_BATCHING` target property was added to
tell :ref:`Visual Studio Generators` whether to disable compiler parallelism
and call the compiler with one source file at a time.
Modules
-------

20
Help/variable/CMAKE_VS_NO_COMPILE_BATCHING.rst Normal file
View File

@@ -0,0 +1,20 @@
CMAKE_VS_NO_COMPILE_BATCHING
----------------------------
.. versionadded:: 3.24
Turn off compile batching when using :ref:`Visual Studio Generators`.
This variable is used to initialize the :prop_tgt:`VS_NO_COMPILE_BATCHING`
property on all targets when they are created. See that target property for
additional information.
Example
^^^^^^^
This shows setting the property for the target ``foo`` using the variable.
.. code-block:: cmake
set(CMAKE_VS_NO_COMPILE_BATCHING ON)
add_library(foo SHARED foo.cpp)

1
Source/cmTarget.cxx
View File

@@ -583,6 +583,7 @@ cmTarget::cmTarget(std::string const& name, cmStateEnums::TargetType type,
initProp("Swift_LANGUAGE_VERSION");
initProp("Swift_MODULE_DIRECTORY");
initProp("VS_JUST_MY_CODE_DEBUGGING");
initProp("VS_NO_COMPILE_BATCHING");
initProp("DISABLE_PRECOMPILE_HEADERS");
initProp("UNITY_BUILD");
initProp("UNITY_BUILD_UNIQUE_ID");

2
Tests/RunCMake/VS10Project/VsNoCompileBatching.cmake
View File

@@ -2,8 +2,8 @@ enable_language(CXX)
add_library(foo foo.cpp)
set(CMAKE_VS_NO_COMPILE_BATCHING ON)
add_library(foo_NB foo.cpp)
set_property(TARGET foo_NB PROPERTY VS_NO_COMPILE_BATCHING ON)
add_library(foo_NB_OFF foo.cpp)
set_property(TARGET foo_NB_OFF PROPERTY VS_NO_COMPILE_BATCHING OFF)