diff --git a/doc/rados/configuration/ms-ref.rst b/doc/rados/configuration/ms-ref.rst
index 9777abb1a6b..d0b1b172d7f 100644
--- a/doc/rados/configuration/ms-ref.rst
+++ b/doc/rados/configuration/ms-ref.rst
@@ -13,7 +13,7 @@
 
 ``ms initial backoff``
 
-:Description: 
+:Description: The initial time to wait before reconnecting on a fault.
 :Type: Double
 :Required: No
 :Default: ``.2``
@@ -21,7 +21,7 @@
 
 ``ms max backoff``
 
-:Description: 
+:Description: The maximum time to wait before reconnecting on a fault.
 :Type: Double
 :Required: No
 :Default: ``15.0``
@@ -37,7 +37,7 @@
 
 ``ms die on bad msg``
 
-:Description: 
+:Description: Debug option; do not configure.
 :Type: Boolean
 :Required: No
 :Default: ``false``
@@ -53,7 +53,7 @@
 
 ``ms bind ipv6``
 
-:Description: 
+:Description: Enable if you want your daemons to bind to IPv6 address instead of IPv4 ones. (Not required if you specify a daemon or cluster IP.)
 :Type: Boolean
 :Required: No
 :Default: ``false``
@@ -61,7 +61,7 @@
 
 ``ms rwthread stack bytes``
 
-:Description: 
+:Description: Debug option for stack size; do not configure.
 :Type: 64-bit Unsigned Integer
 :Required: No
 :Default: ``1024 << 10``
@@ -69,7 +69,7 @@
 
 ``ms tcp read timeout``
 
-:Description: 
+:Description: Controls how long (in seconds) the messenger will wait before closing an idle connection.
 :Type: 64-bit Unsigned Integer
 :Required: No
 :Default: ``900``
@@ -77,7 +77,7 @@
 
 ``ms inject socket failures``
 
-:Description: 
+:Description: Debug option; do not configure.
 :Type: 64-bit Unsigned Integer
 :Required: No
 :Default: ``0``