From 44bf494fe644f4a24a5e624c8609ad24d7f85082 Mon Sep 17 00:00:00 2001
From: Bastien Montagne <bastien@blender.org>
Date: Thu, 10 Jul 2025 18:42:59 +0200
Subject: [PATCH] Help: Global SPLIT_JOBS: reformat usages into a list.

---
 Help/prop_gbl/JOB_POOLS.rst | 21 ++++++++++++---------
 1 file changed, 12 insertions(+), 9 deletions(-)

diff --git a/Help/prop_gbl/JOB_POOLS.rst b/Help/prop_gbl/JOB_POOLS.rst
index 5dfe6de33d..fffc2ae291 100644
--- a/Help/prop_gbl/JOB_POOLS.rst
+++ b/Help/prop_gbl/JOB_POOLS.rst
@@ -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.