Document job partition string reordering

See bug 757

doc/man/man1/salloc.1

@@ -1066,7 +1066,10 @@ Request a specific partition for the resource allocation.  If not specified,
 the default behavior is to allow the slurm controller to select the default
 partition as designated by the system administrator. If the job can use more
 than one partition, specify their names in a comma separate list and the one
-offering earliest initiation will be used.
+offering earliest initiation will be used with no regard given to the partition
+name ordering (although higher priority partitions will be considered first).
+When the job is initiated, the name of the partition used will be placed first
+in the job record partition string.
 
 .TP
 \fB\-Q\fR, \fB\-\-quiet\fR

doc/man/man1/sbatch.1

@@ -1124,7 +1124,10 @@ Request a specific partition for the resource allocation.  If not specified,
 the default behavior is to allow the slurm controller to select the default
 partition as designated by the system administrator. If the job can use more
 than one partition, specify their names in a comma separate list and the one
-offering earliest initiation will be used.
+offering earliest initiation will be used with no regard given to the partition
+name ordering (although higher priority partitions will be considered first).
+When the job is initiated, the name of the partition used will be placed first
+in the job record partition string.
 
 .TP
 \fB\-\-priority\fR=<value>

doc/man/man1/srun.1

@@ -1225,7 +1225,10 @@ Request a specific partition for the resource allocation.  If not specified,
 the default behavior is to allow the slurm controller to select the default
 partition as designated by the system administrator. If the job can use more
 than one partition, specify their names in a comma separate list and the one
-offering earliest initiation will be used.
+offering earliest initiation will be used with no regard given to the partition
+name ordering (although higher priority partitions will be considered first).
+When the job is initiated, the name of the partition used will be placed first
+in the job record partition string.
 
 .TP
 \fB\-\-priority\fR=<value>