diff --git a/doc/man/man1/salloc.1 b/doc/man/man1/salloc.1
index 64d94ceabc14dada2ec92ddca789bee44e783f29..540302d75174acef0492f3531753aaff29908e36 100644
--- a/doc/man/man1/salloc.1
+++ b/doc/man/man1/salloc.1
@@ -1202,9 +1202,18 @@ This option has been replaced by \fB\-\-immediate\fR=<\fIseconds\fR>.
 
 .TP
 \fB\-w\fR, \fB\-\-nodelist\fR=<\fInode name list\fR>
-Request a specific list of node names.  The list may be specified as a
-comma\-separated list of node names, or a range of node names
-(e.g. mynode[1\-5,7,...]).  Duplicate node names in the list will be ignored.
+Request a specific list of hosts.
+Unless constrained by the maximum node count, the job will contain
+\fIall\fR of these hosts.
+The list may be specified as a comma\-separated list of hosts, a range of hosts
+(host[1\-5,7,...] for example), or a filename.
+The host list will be assumed to be a filename if it contains a "/" character.
+If you specify a maximum node count and the host list contains more nodes, the
+extra node names will be silently ignored.
+If you specify a minimum node or processor count larger than can be satisfied
+by the supplied host list, additional resources will be allocated on other
+nodes as needed.
+Duplicate node names in the list will be ignored.
 The order of the node names in the list is not important; the node names
 will be sorted by SLURM.
 
diff --git a/doc/man/man1/sbatch.1 b/doc/man/man1/sbatch.1
index c515a03f65f97af8b37e0dac0f20e3b2590102b3..76525c349e7968321cc939bb1c74ea5d1c504320 100644
--- a/doc/man/man1/sbatch.1
+++ b/doc/man/man1/sbatch.1
@@ -1359,9 +1359,18 @@ errors will be displayed.
 
 .TP
 \fB\-w\fR, \fB\-\-nodelist\fR=<\fInode name list\fR>
-Request a specific list of node names.  The list may be specified as a
-comma\-separated list of node names, or a range of node names
-(e.g. mynode[1\-5,7,...]).  Duplicate node names in the list will be ignored.
+Request a specific list of hosts.
+Unless constrained by the maximum node count, the job will contain
+\fIall\fR of these hosts.
+The list may be specified as a comma\-separated list of hosts, a range of hosts
+(host[1\-5,7,...] for example), or a filename.
+The host list will be assumed to be a filename if it contains a "/" character.
+If you specify a maximum node count and the host list contains more nodes, the
+extra node names will be silently ignored.
+If you specify a minimum node or processor count larger than can be satisfied
+by the supplied host list, additional resources will be allocated on other
+nodes as needed.
+Duplicate node names in the list will be ignored.
 The order of the node names in the list is not important; the node names
 will be sorted by SLURM.
 
diff --git a/doc/man/man1/srun.1 b/doc/man/man1/srun.1
index a009cea830930f4b172c26394e344210517e8eb8..c8f9e0c0e8a92cd5e12d51cac091dd0bc4a9659d 100644
--- a/doc/man/man1/srun.1
+++ b/doc/man/man1/srun.1
@@ -1573,13 +1573,17 @@ exits with a non\-zero exit code.
 
 .TP
 \fB\-w\fR, \fB\-\-nodelist\fR=<\fIhost1,host2,...\fR or \fIfilename\fR>
-Request a specific list of hosts. The job will contain \fIat least\fR
-these hosts. The list may be specified as a comma\-separated list of
-hosts, a range of hosts (host[1\-5,7,...] for example), or a filename.
-The host list will be assumed to be a filename if it contains a "/"
-character. If you specify a max node count (\-N1\-2) if there are more
-than 2 hosts in the file only the first 2 nodes will be used in the
-request list.
+Request a specific list of hosts.
+Unless constrained by the maximum node count, the job will contain
+\fIall\fR of these hosts.
+The list may be specified as a comma\-separated list of hosts, a range of hosts
+(host[1\-5,7,...] for example), or a filename.
+The host list will be assumed to be a filename if it contains a "/" character.
+If you specify a maximum node count and the host list contains more nodes, the
+extra node names will be silently ignored.
+If you specify a minimum node or processor count larger than can be satisfied
+by the supplied host list, additional resources will be allocated on other
+nodes as needed.
 Rather than repeating a host name multiple times, an asterisk and
 a repitition count may be appended to a host name. For example
 "host1,host1" and "host1*2" are equivalent.