From 0d94a76d956c0322e9c4607fb5ce824f7653f038 Mon Sep 17 00:00:00 2001
From: Steve Martinelli <s.martinelli@gmail.com>
Date: Thu, 17 Aug 2017 12:17:39 -0400
Subject: auto-generate docs for v3 identity resources

skipped shared v2/v3 identity resources.

Change-Id: I9e1fb5dee5506780fd79a0cbfbde059d0ccd1489
---
 doc/source/cli/command-objects/region.rst | 108 ++++--------------------------
 1 file changed, 13 insertions(+), 95 deletions(-)

(limited to 'doc/source/cli/command-objects/region.rst')

diff --git a/doc/source/cli/command-objects/region.rst b/doc/source/cli/command-objects/region.rst
index d2c63c1b..58cc341f 100644
--- a/doc/source/cli/command-objects/region.rst
+++ b/doc/source/cli/command-objects/region.rst
@@ -2,103 +2,21 @@
 region
 ======
 
-Identity v3
+A **region** is a general division of an OpenStack deployment. You can associate
+zero or more sub-regions with a region to create a tree-like structured
+hierarchy. Applies to Identity v3.
 
-region create
--------------
+.. autoprogram-cliff:: openstack.identity.v3
+   :command: region create
 
-Create new region
+.. autoprogram-cliff:: openstack.identity.v3
+   :command: region delete
 
-.. program:: region create
-.. code:: bash
+.. autoprogram-cliff:: openstack.identity.v3
+   :command: region list
 
-    openstack region create
-        [--parent-region <region-id>]
-        [--description <description>]
-        <region-id>
+.. autoprogram-cliff:: openstack.identity.v3
+   :command: region set
 
-.. option:: --parent-region <region-id>
-
-    Parent region ID
-
-.. option:: --description <description>
-
-    New region description
-
-.. _region_create-region-id:
-.. describe:: <region-id>
-
-    New region ID
-
-region delete
--------------
-
-Delete region(s)
-
-.. program:: region delete
-.. code:: bash
-
-    openstack region delete
-        <region-id> [<region-id> ...]
-
-.. _region_delete-region-id:
-.. describe:: <region-id>
-
-    Region ID(s) to delete
-
-region list
------------
-
-List regions
-
-.. program:: region list
-.. code:: bash
-
-    openstack region list
-        [--parent-region <region-id>]
-
-.. option:: --parent-region <region-id>
-
-    Filter by parent region ID
-
-region set
-----------
-
-Set region properties
-
-.. program:: region set
-.. code:: bash
-
-    openstack region set
-        [--parent-region <region-id>]
-        [--description <description>]
-        <region-id>
-
-.. option:: --parent-region <region-id>
-
-    New parent region ID
-
-.. option:: --description <description>
-
-    New region description
-
-.. _region_set-region-id:
-.. describe:: <region-id>
-
-    Region to modify
-
-region show
------------
-
-Display region details
-
-.. program:: region show
-.. code:: bash
-
-    openstack region show
-        <region-id>
-
-.. _region_show-region-id:
-.. describe:: <region-id>
-
-    Region to display
+.. autoprogram-cliff:: openstack.identity.v3
+   :command: region show
-- 
cgit v1.2.1