1
0
mirror of https://github.com/Kitware/CMake.git synced 2025-10-20 12:53:55 +08:00

Help: Global SPLIT_JOBS: reformat usages into a list.

This commit is contained in:
Bastien Montagne
2025-07-10 18:42:59 +02:00
parent 369c36503d
commit 44bf494fe6

View File

@@ -14,15 +14,18 @@ For instance:
set_property(GLOBAL PROPERTY JOB_POOLS two_jobs=2 ten_jobs=10)
Defined pools could be used globally by setting
:variable:`CMAKE_JOB_POOL_COMPILE` and :variable:`CMAKE_JOB_POOL_LINK`
or per target by setting the target properties
:prop_tgt:`JOB_POOL_COMPILE` and :prop_tgt:`JOB_POOL_LINK`.
:command:`Custom commands <add_custom_command>` and
:command:`custom targets <add_custom_target>` can specify pools using the
option ``JOB_POOL``.
Using a pool that is not defined by ``JOB_POOLS`` causes
an error by ninja at build time.
Defined pools can be used at different levels:
* Globally, by setting :variable:`CMAKE_JOB_POOL_COMPILE` and
:variable:`CMAKE_JOB_POOL_LINK`.
* Per target, by setting the target properties :prop_tgt:`JOB_POOL_COMPILE`
and :prop_tgt:`JOB_POOL_LINK`.
* :command:`Custom commands <add_custom_command>` and
:command:`custom targets <add_custom_target>` can specify pools using the
option ``JOB_POOL``.
Using a pool that is not defined by ``JOB_POOLS`` causes an error by ninja
at build time.
If not set, this property uses the value of the :variable:`CMAKE_JOB_POOLS`
variable.