diff --git a/doc/man/man5/burst_buffer.conf.5 b/doc/man/man5/burst_buffer.conf.5
index 90f8e94fc7..efd76aa999 100644
--- a/doc/man/man5/burst_buffer.conf.5
+++ b/doc/man/man5/burst_buffer.conf.5
@@ -31,18 +31,18 @@ The configuration parameters available include:
 \fBAllowUsers\fR
 Comma separated list of user names and/or IDs permitted to use burst buffers.
 The options \fBAllowUsers\fR and \fBDenyUsers\fR can not both be specified.
-By default all users are permitted to use burst buffers.
+By default all users are permitted to use burst buffers.  Possible future
+future enhancement for generic plugin.
 
-.\" Possible future enhancement for generic plugin
-.\" .TP
-.\" \fBAltPool\fR
-.\" The AltPool value consists of a comma separated list of alternate pools of
-.\" resources, each of which includes a name separated by a colon and a numeric
-.\" value.
-.\" The numeric value can include a suffix of "k", "m", "g", "t" and "p" which
-.\" multiplies the numeric value by 1,024, 1,048,576, 1,073,741,824 etc.
-.\" The numeric value is a 64-bit value.
-.\" for example, "AltPool=test:20g,small:4g
+.TP
+\fBAltPool\fR
+The AltPool value consists of a comma separated list of alternate pools of
+resources, each of which includes a name separated by a colon and a numeric
+value.
+The numeric value can include a suffix of "k", "m", "g", "t" and "p" which
+multiplies the numeric value by 1,024, 1,048,576, 1,073,741,824 etc.
+The numeric value is a 64-bit value.
+for example, "AltPool=test:20g,small:4g
 
 .TP
 \fBCreateBuffer\fR
@@ -206,8 +206,8 @@ By default there is a 5 second timeout for the validation operations.
 AllowUsers=alan,brenda
 .br
 PrivateData=true
-.\" .br
-.\" Gres=nodes:10,other:20
+.br
+Gres=nodes:10,other:20
 .br
 #
 .br