doc: Minor updates for usage.

Signed-off-by: John Wilkins <john.wilkins@inktank.com>

diff --git a/doc/rados/configuration/general-config-ref.rst b/doc/rados/configuration/general-config-ref.rst
index 56b93a82166676b6aa10e9268d5e1e433fe26800..abc42c578c4d71c906e5a63e5a3123eea77276ab 100644 (file)
--- a/doc/rados/configuration/general-config-ref.rst
+++ b/doc/rados/configuration/general-config-ref.rst
@@ -3,19 +3,18 @@
 ==========================
 
 
-
 ``fsid``
 
 :Description: The filesystem ID. One per cluster.
 :Type: UUID
 :Required: No. 
-:Default: N/A. Generated if not specified.
+:Default: N/A. Usually generated by deployment tools.
 
 
 ``admin socket``
 
-:Description: The socket for executing administrative commands irrespective 
-              of whether Ceph monitors have established a quorum.
+:Description: The socket for executing administrative commands on a daemon, 
+              irrespective of whether Ceph Monitors have established a quorum.
 
 :Type: String
 :Required: No
@@ -29,7 +28,8 @@
 
 :Type: String
 :Required: No
-:Default: N/A. The default path is ``/var/run/$cluster/$name.pid``. The PID file is generated upon start-up. 
+:Default: N/A. The default path is ``/var/run/$cluster/$name.pid``. The 
+          PID file is generated upon start-up. 
 
 
 ``chdir``
@@ -44,15 +44,16 @@
 
 ``max open files``
 
-:Description: If set, when the Ceph service starts, Ceph sets the 
-              ``max open fds`` at the OS level (i.e., the max # of file 
-              descriptors). It helps prevents OSDs from running out of 
-              file descriptors.
+:Description: If set, when the :term:`Ceph Storage Cluster` starts, Ceph sets 
+              the  ``max open fds`` at the OS level (i.e., the max # of file 
+              descriptors). It helps prevents Ceph OSD Daemons from running out
+              of file descriptors.
 
 :Type: 64-bit Integer
 :Required: No
 :Default: ``0``
 
+
 ``fatal signal handlers``
 
 :Description: If set, we will install signal handlers for SEGV, ABRT, BUS, ILL,