From 4c0f3bfa89dfc9f207c4f6d6dc6ded85b86fee87 Mon Sep 17 00:00:00 2001
From: Eric Fried <openstack@fried.cc>
Date: Tue, 29 Oct 2019 16:22:18 -0500
Subject: common: autogenerate docs

$namespace = openstack.common

The subcommand documents for $namespace were hardcoded and thus prone to
drift over time. This commit removes the hardcoded content and uses the
autoprogram-cliff directive to generate them automatically from the
subcommand configuration classes.

This incorporates a correction to `openstack versions show`: The command
`openstack versions show --help` showed a copy/paste error, using
<region-name> for the metavar for both --service and --status. Fix.

Change-Id: I7658fed40d71f4c20ee27908ade433534657cfe5
Co-Authored-By: Pierre Prinetti <pierreprinetti@redhat.com>
Co-Authored-By: Matt Riedemann <mriedem.os@gmail.com>
---
 doc/source/cli/command-objects/extension.rst | 52 ++--------------------------
 1 file changed, 2 insertions(+), 50 deletions(-)

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

diff --git a/doc/source/cli/command-objects/extension.rst b/doc/source/cli/command-objects/extension.rst
index 36cf418b..1002a5ff 100644
--- a/doc/source/cli/command-objects/extension.rst
+++ b/doc/source/cli/command-objects/extension.rst
@@ -5,54 +5,6 @@ extension
 Many OpenStack server APIs include API extensions that enable
 additional functionality.
 
-extension list
---------------
 
-List API extensions
-
-.. program:: extension list
-.. code:: bash
-
-    openstack extension list
-        [--compute]
-        [--identity]
-        [--network]
-        [--volume]
-        [--long]
-
-.. option:: --compute
-
-    List extensions for the Compute API
-
-.. option:: --identity
-
-    List extensions for the Identity API
-
-.. option:: --network
-
-    List extensions for the Network API
-
-.. option:: --volume
-
-    List extensions for the Block Storage API
-
-.. option:: --long
-
-    List additional fields in output
-
-extension show
---------------
-
-Show API extension
-
-.. program:: extension show
-.. code:: bash
-
-    openstack extension show
-        <extension>
-
-.. _extension_show:
-.. describe:: <extension>
-
-   Extension to display. Currently, only network extensions are supported.
-   (Name or Alias)
+.. autoprogram-cliff:: openstack.common
+   :command: extension *
-- 
cgit v1.2.1