merge: DOCS-524

Author: Sam Kleinman

source/reference/command/compact.txt

@@ -24,44 +24,51 @@ compact
    You may also specify one of the following options:
 
    - ``force: true`` 
+
+     .. versionchanged:: 2.2 :dbcommand:`compact` blocks activities only
+        for its database.
 
      To run on the primary node in a :term:`replica set`. Otherwise,
      the :dbcommand:`compact` command returns an error when invoked on
      a :term:`replica set` primary because the command blocks all other
      activity.
-     
-     .. versionchanged:: 2.2 :dbcommand:`compact` blocks activities only
-        for its database.
-
+    
    - ``paddingFactor: <factor>``
+
+     .. versionadded:: v2.2
 
      To specify a :term:`padding factor` ranging from 1.0 to 4.0 for
      the compacted documents. Default factor is 1.0, specifying no
      padding and the maximum padding factor is 4.0. If you do updates
      that increase the size of the documents, you will want some
-     padding, especially if you have several indexes for the collection.
+     padding, especially if you have several indexes for the
+     collection. To set the padding factor to ``1.1`` on a collection
+     named ``<collection>``, use the following operation:
 
-     .. versionadded:: v2.2
-
-   - ``paddingBytes: <bytes>`` 
+     .. code-block:: javascript
+   
+        db.runCommand ( { compact: '<collection>', paddingFactor: 1.1 } )
 
+   - ``paddingBytes: <bytes>`` 
+
+     .. versionadded:: 2.2
+
      To specify a padding as an absolute number of bytes. Specifying
      ``paddingBytes`` can be useful if your documents start small but
      then increase in size significantly. For example,if your documents
      are initially 40 bytes long and you grow them by 1KB, using
      ``paddingBytes: 1024`` might be reasonable since using
      ``paddingFactor: 4.0`` would only add 120 bytes (i.e. ``40 * (4.0 - 1)``)
-     of padding.
+     of padding. 
 
-     .. versionadded:: 2.2
-     
-     Using the following command, you can use the :dbcommand:`compact`
-     command with the ``paddingBytes`` options to configure``100``
-     bytes of padding by setting the ``paddingFactor`` to ``1.1``:
+     With the following command, you can use the ``paddingBytes``
+     option for the :dbcommand:`compact` command to set the padding
+     size to ``100`` bytes on the collection named by
+     ``<collection>``:
 
-      .. code-block:: javascript
+     .. code-block:: javascript
 
-         db.runCommand ( { compact: '<collection>', paddingBytes: 100, paddingFactor: 1.1 } )
+        db.runCommand ( { compact: '<collection>', paddingBytes: 100 } )
 
    .. warning::