diff --git a/NEWS b/NEWS
index 127e1432f2db5635b4c3cdaa9296cbad98726fb1..fb274fb7333cdf2a93017526ae0132f5262cb366 100644
--- a/NEWS
+++ b/NEWS
@@ -11,6 +11,7 @@ documents those changes that are of interest to users and administrators.
     requeue the job but leave it in a cancelled state.
  -- capmc_resume (Cray resume node script) - Do not disable changing a node's
     active features if SyscfgPath is configured in the knl.conf file.
+ -- Improve the srun documentation for the --resv-ports option.
  -- burst_buffer/cray - Fix parsing for discontinuous allocated nodes. A job
     allocation of "20,22" must be expressed as "20\n22".
 
diff --git a/doc/man/man1/srun.1 b/doc/man/man1/srun.1
index a60c06fc2bb94ea02161df3b22616a927326b458..142f4d5d4afb1b724f1ab3132c8939bfd017cfec 100644
--- a/doc/man/man1/srun.1
+++ b/doc/man/man1/srun.1
@@ -1782,12 +1782,13 @@ This is only supported with some system configurations and will otherwise be
 silently ignored. This option applies to job allocations.
 
 .TP
-\fB\-\-resv\-ports\fR
+\fB\-\-resv\-ports\fR[=\fIcount\fR]
 Reserve communication ports for this job. Users can specify the number
 of port they want to reserve. The parameter MpiParams=ports=12000-12999
-must be specified in \fIslurm.conf\fR. If not specified the default reserve
-number of ports equal to the number of tasks. If the number of reserved ports
-is zero no ports is reserved.
+must be specified in \fIslurm.conf\fR. If not specified and Slurm's OpenMPI
+plugin is used, then by default the number of reserved equal to the highest
+number of tasks on any node in the job step allocation.
+If the number of reserved ports is zero then no ports is reserved.
 Used for OpenMPI. This option applies to job and step allocations.
 
 .TP
diff --git a/doc/man/man1/sview.1 b/doc/man/man1/sview.1
index 2522b6a21a41799d32a44351c61f46271225e446..69032c3dfb659992564f97426a4cb457bee00f04 100644
--- a/doc/man/man1/sview.1
+++ b/doc/man/man1/sview.1
@@ -55,6 +55,9 @@ not visible by scrolling down the window.
 The gtk2\-engines\-qtcurve theme does seem to have particularly good
 scalability.
 
+Newer gtk3 themes do not allow the background colors used for the node map
+to be displayed.
+
 On systems with the topology/tree plugin configured, the sview command will
 attempt to display the nodes on each switch on a separate line.
 Change the sview configuration for optimal viewing by selecting "Options" then