diff --git a/NEWS b/NEWS
index e4db47c3ab96370ae6361a2a89234c9ca2c8b1a5..fa4cfa310d62f3cdc105ab4f7e8ee165d0527d7a 100644
--- a/NEWS
+++ b/NEWS
@@ -14,7 +14,7 @@ documents those changes that are of interest to users and admins.
     better performance.
  -- fixed certain tests in test suite to not run with bluegene or front-end 
     systems
- -- removed addresses from slurm_step_layout_t
+ -- Removed addresses from slurm_step_layout_t
  -- Added new job field, "comment". Set by srun, salloc and sbatch. See 
     with "scontrol show job". Used in sched/wiki2.
 
diff --git a/doc/man/man5/slurm.conf.5 b/doc/man/man5/slurm.conf.5
index ccb0e37ea725a4134793bd4cfbcb83ebec80cabd..f161db80eff04f0b6670f335e93fa82143dbc623 100644
--- a/doc/man/man5/slurm.conf.5
+++ b/doc/man/man5/slurm.conf.5
@@ -558,11 +558,20 @@ Fully qualified pathname of the file system available to user jobs for
 temporary storage. This parameter is used in establishing a node's \fBTmpDisk\fR
 space. 
 The default value is "/tmp".
+
 .TP
 \fBTreeWidth\fR
 \fBSlurmd\fR daemons use a virtual tree network for communications.
 \fBTreeWidth\fR specifies the width of the tree (i.e. the fanout).
-The default value is 50.
+The default value is 50, meaning each slurmd daemon can communicate
+with up to 50 other slurmd daemons and over 2500 nodes can be contacted
+with two message hops.
+The default value will work well for most clusters.
+Optimaly system performance can typically be achieved if \fBTreeWidth\fR
+is set to the square root of the number of nodes in the cluster for
+systems having no more than 2500 nodes or the cube root for larger
+systems.
+
 .TP
 \fBUsePAM\fR
 If set to 1, PAM (Pluggable Authentication Modules for Linux) will be enabled.