From c6266b5ab22b911ae7e0ca5077d0c04a23dabca9 Mon Sep 17 00:00:00 2001
From: Eric Fried <openstack@fried.cc>
Date: Mon, 4 Nov 2019 16:02:31 -0600
Subject: compute: autogenerate docs

$namespace = openstack.compute.v2

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.

Many of these were already being generated. Some were missing a few
sub-subcommands, so those are added.

Change-Id: I1aa4b2655bafd2f6a5d83b658742f65d180eb128
---
 doc/source/cli/command-objects/compute-agent.rst | 98 +-----------------------
 1 file changed, 2 insertions(+), 96 deletions(-)

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

diff --git a/doc/source/cli/command-objects/compute-agent.rst b/doc/source/cli/command-objects/compute-agent.rst
index e8317b48..89d74928 100644
--- a/doc/source/cli/command-objects/compute-agent.rst
+++ b/doc/source/cli/command-objects/compute-agent.rst
@@ -4,99 +4,5 @@ compute agent
 
 Compute v2
 
-compute agent create
---------------------
-
-Create compute agent
-
-.. program:: compute agent create
-.. code:: bash
-
-    openstack compute agent create
-        <os> <architecture> <version> <url> <md5hash>
-        <hypervisor>
-
-.. _compute_agent-create:
-.. describe:: <os>
-
-    Type of OS
-
-.. describe:: <architecture>
-
-    Type of architecture
-
-.. describe:: <version>
-
-    Version
-
-.. describe:: <url>
-
-    URL
-
-.. describe:: <md5hash>
-
-    MD5 hash
-
-.. describe:: <hypervisor>
-
-    Type of hypervisor
-
-compute agent delete
---------------------
-
-Delete compute agent(s)
-
-.. program:: compute agent delete
-.. code:: bash
-
-    openstack compute agent delete <id> [<id> ...]
-
-.. _compute_agent-delete:
-.. describe:: <id>
-
-    ID of agent(s) to delete
-
-compute agent list
-------------------
-
-List compute agents
-
-.. program:: compute agent list
-.. code:: bash
-
-    openstack compute agent list [--hypervisor <hypervisor>]
-
-.. option:: --hypervisor <hypervisor>
-
-    Type of hypervisor
-
-compute agent set
------------------
-
-Set compute agent properties
-
-.. program:: agent set
-.. code:: bash
-
-    openstack compute agent set
-        [--agent-version <version>]
-        [--url <url]
-        [--md5hash <md5hash>]
-        <id>
-
-.. _compute_agent-set:
-.. option:: --agent-version <version>
-
-    Version of the agent
-
-.. option:: --url <url>
-
-    URL of the agent
-
-.. option:: --md5hash <md5hash>
-
-    MD5 hash of the agent
-
-.. describe:: <id>
-
-    Agent to modify (ID only)
+.. autoprogram-cliff:: openstack.compute.v2
+   :command: compute agent *
-- 
cgit v1.2.1