From 7afb43f452ec1d323d702f719f05c57631fa0b22 Mon Sep 17 00:00:00 2001
From: Moe Jette <jette1@llnl.gov>
Date: Fri, 21 Jan 2011 16:07:11 +0000
Subject: [PATCH] Add some clarification with respect to task distribution when
 not all nodes have the same number of allocated CPUs.

---
 doc/man/man1/salloc.1 | 6 +++++-
 doc/man/man1/sbatch.1 | 6 +++++-
 doc/man/man1/srun.1   | 6 +++++-
 3 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/doc/man/man1/salloc.1 b/doc/man/man1/salloc.1
index 5eca517ebd7..eaa68c19ed1 100644
--- a/doc/man/man1/salloc.1
+++ b/doc/man/man1/salloc.1
@@ -477,7 +477,11 @@ round\-robin fashion). For example, consider an allocation of three
 nodes each with two cpus. A four\-task cyclic distribution request
 will distribute those tasks to the nodes with tasks one and four on
 the first node, task two on the second node, and task three on the
-third node. Cyclic distribution is the default behavior if the number
+third node. 
+Note that when SelectType is select/cons_res the same number of CPUs
+may not be allocated on each node. Distribution will be round\-robin
+among all the nodes with CPUs yet to be allocated.
+Cyclic distribution is the default behavior if the number
 of tasks is no larger than the number of allocated nodes.
 .TP
 .B plane
diff --git a/doc/man/man1/sbatch.1 b/doc/man/man1/sbatch.1
index 55948ec0d2a..4fcb3fd7393 100644
--- a/doc/man/man1/sbatch.1
+++ b/doc/man/man1/sbatch.1
@@ -536,7 +536,11 @@ round\-robin fashion). For example, consider an allocation of three
 nodes each with two cpus. A four\-task cyclic distribution request
 will distribute those tasks to the nodes with tasks one and four on
 the first node, task two on the second node, and task three on the
-third node. Cyclic distribution is the default behavior if the number
+third node. 
+Note that when SelectType is select/cons_res the same number of CPUs
+may not be allocated on each node. Distribution will be round\-robin
+among all the nodes with CPUs yet to be allocated.
+Cyclic distribution is the default behavior if the number
 of tasks is no larger than the number of allocated nodes.
 .TP
 .B plane
diff --git a/doc/man/man1/srun.1 b/doc/man/man1/srun.1
index d9b9d9edd33..e6ac541edc8 100644
--- a/doc/man/man1/srun.1
+++ b/doc/man/man1/srun.1
@@ -533,7 +533,11 @@ round\-robin fashion). For example, consider an allocation of three
 nodes each with two cpus. A four\-task cyclic distribution request
 will distribute those tasks to the nodes with tasks one and four on
 the first node, task two on the second node, and task three on the
-third node. Cyclic distribution is the default behavior if the number
+third node. 
+Note that when SelectType is select/cons_res the same number of CPUs
+may not be allocated on each node. Distribution will be round\-robin
+among all the nodes with CPUs yet to be allocated.
+Cyclic distribution is the default behavior if the number
 of tasks is no larger than the number of allocated nodes.
 .TP
 .B plane
-- 
GitLab