doc: Added additional comments on placement targets and default placement.

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

diff --git a/doc/radosgw/config-ref.rst b/doc/radosgw/config-ref.rst
index ce8c0a9114c427ebdea9f7addb9d83b8e746479b..bf6cb674489500da91f5a7e35c4d99004dc7a5d8 100644 (file)
--- a/doc/radosgw/config-ref.rst
+++ b/doc/radosgw/config-ref.rst
@@ -412,25 +412,31 @@ required settings:
    gateway will log metadata and data operations (false by default).
 
 #. ``placement_targets``: A list of placement targets (optional). Each 
-   placement target contains a name (required) and a list of tags (optional).
+   placement target contains a name (required) for the placement target 
+   and a list of tags (optional) so that only users with the tag can use
+   the placement target (i.e., the user's ``placement_tags`` field in the 
+   user info). 
 
-#. ``default_placement``: The set of default placement pools for the object 
-   index and object data. Set to ``default-placement`` by default.
+#. ``default_placement``: The default placement target for the object 
+   index and object data. Set to ``default-placement`` by default. You 
+   may also set a per-user default placement in the user info for each 
+   user.
 
 To set a region, create a JSON object consisting of the required fields, save
 the object to a file (e.g., ``region.json``); then, execute the following
-command:: 
-
+command::
 
        sudo radosgw-admin region set --infile region.json
 
 Where ``region.json`` is the JSON file you created.
 
+
 .. important:: The ``default`` region ``is_master`` setting is ``true`` by
    default. If you create a new region and want to make it the master region,
    you must either set the ``default`` region ``is_master`` setting to 
    ``false``, or delete the ``default`` region.
 
+
 Finally, update the map. :: 
 
        sudo radosgw-admin region-map update