From: Zac Dover Date: Thu, 2 Mar 2023 18:04:30 +0000 (+1000) Subject: doc/radosgw: format admonitions X-Git-Tag: v16.2.13~145^2 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=2daa10cf851286c6bfcbc29a3b9aa99ba83590fc;p=ceph.git doc/radosgw: format admonitions Break up the text of two similar admonitions into three paragraphs (in each of the two instances). This makes the content of the admonition much easier to read at a glance. Signed-off-by: Zac Dover (cherry picked from commit 4db68f5711f48b190f0135a3a7a6df8dfcf5abfa) --- diff --git a/doc/radosgw/multisite.rst b/doc/radosgw/multisite.rst index 66a9f9182745..4746df4a95a9 100644 --- a/doc/radosgw/multisite.rst +++ b/doc/radosgw/multisite.rst @@ -159,7 +159,11 @@ realm enforces a globally unique namespace within itself. radosgw-admin realm create --rgw-realm=movies --default - .. note:: If you intend the cluster to have a single realm, specify the ``--default`` flag. If ``--default`` is specified, ``radosgw-admin`` uses this realm by default. If ``--default`` is not specified, you must specify either the ``--rgw-realm`` flag or the ``--realm-id`` flag to identify the realm when adding zonegroups and zones. + .. note:: If you intend the cluster to have a single realm, specify the ``--default`` flag. + + If ``--default`` is specified, ``radosgw-admin`` uses this realm by default. + + If ``--default`` is not specified, you must specify either the ``--rgw-realm`` flag or the ``--realm-id`` flag to identify the realm when adding zonegroups and zones. #. After the realm has been created, ``radosgw-admin`` echoes back the realm configuration. For example: @@ -195,7 +199,11 @@ for the realm. radosgw-admin zonegroup create --rgw-zonegroup=us --endpoints=http://rgw1:80 --rgw-realm=movies --master --default - .. note:: If the realm will have only a single zonegroup, specify the ``--default`` flag. If ``--default`` is specified, ``radosgw-admin`` uses this zonegroup by default when adding new zones. If ``--default`` is not specified, you must use either the ``--rgw-zonegroup`` flag or the ``--zonegroup-id`` flag to identify the zonegroup when adding or modifying zones. + .. note:: If the realm will have only a single zonegroup, specify the ``--default`` flag. + + If ``--default`` is specified, ``radosgw-admin`` uses this zonegroup by default when adding new zones. + + If ``--default`` is not specified, you must use either the ``--rgw-zonegroup`` flag or the ``--zonegroup-id`` flag to identify the zonegroup when adding or modifying zones. #. After creating the master zonegroup, ``radosgw-admin`` echoes back the zonegroup configuration. For example: