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

Author: Eric Fried

doc/source/cli/command-objects/aggregate.rst

@@ -7,180 +7,5 @@ criteria.
 
 Compute v2
 
-aggregate add host
-------------------
-
-Add host to aggregate
-
-.. program:: aggregate add host
-.. code:: bash
-
-    openstack aggregate add host
-        <aggregate>
-        <host>
-
-.. _aggregate_add_host-aggregate:
-.. describe:: <aggregate>
-
-    Aggregate (name or ID)
-
-.. _aggregate_add_host-host:
-.. describe:: <host>
-
-    Host to add to :ref:`\<aggregate\> <aggregate_add_host-aggregate>`
-
-aggregate create
-----------------
-
-Create a new aggregate
-
-.. program:: aggregate create
-.. code:: bash
-
-    openstack aggregate create
-        [--zone <availability-zone>]
-        [--property <key=value> [...] ]
-        <name>
-
-.. option:: --zone <availability-zone>
-
-    Availability zone name
-
-.. option:: --property <key=value>
-
-    Property to add to this aggregate (repeat option to set multiple properties)
-
-.. _aggregate_create-name:
-.. describe:: <name>
-
-    New aggregate name
-
-aggregate delete
-----------------
-
-Delete existing aggregate(s)
-
-.. program:: aggregate delete
-.. code:: bash
-
-    openstack aggregate delete
-        <aggregate> [<aggregate> ...]
-
-.. _aggregate_delete-aggregate:
-.. describe:: <aggregate>
-
-    Aggregate(s) to delete (name or ID)
-
-aggregate list
---------------
-
-List all aggregates
-
-.. program:: aggregate list
-.. code:: bash
-
-    openstack aggregate list
-        [--long]
-
-.. option:: --long
-
-    List additional fields in output
-
-aggregate remove host
----------------------
-
-Remove host from aggregate
-
-.. program:: aggregate remove host
-.. code:: bash
-
-    openstack aggregate remove host
-        <aggregate>
-        <host>
-
-.. _aggregate_remove_host-aggregate:
-.. describe:: <aggregate>
-
-    Aggregate (name or ID)
-
-.. _aggregate_remove_host-host:
-.. describe:: <host>
-
-    Host to remove from :ref:`\<aggregate\> <aggregate_remove_host-aggregate>`
-
-aggregate set
--------------
-
-Set aggregate properties
-
-.. program:: aggregate set
-.. code:: bash
-
-    openstack aggregate set
-        [--name <new-name>]
-        [--zone <availability-zone>]
-        [--property <key=value> [...] ]
-        [--no-property]
-        <aggregate>
-
-.. option:: --name <name>
-
-    Set aggregate name
-
-.. option:: --zone <availability-zone>
-
-    Set availability zone name
-
-.. option:: --property <key=value>
-
-    Property to set on :ref:`\<aggregate\> <aggregate_set-aggregate>`
-    (repeat option to set multiple properties)
-
-.. option:: --no-property
-
-    Remove all properties from :ref:`\<aggregate\> <aggregate_set-aggregate>`
-    (specify both :option:`--property` and :option:`--no-property` to
-    overwrite the current properties)
-
-.. _aggregate_set-aggregate:
-.. describe:: <aggregate>
-
-    Aggregate to modify (name or ID)
-
-aggregate show
---------------
-
-Display aggregate details
-
-.. program:: aggregate show
-.. code:: bash
-
-    openstack aggregate show
-        <aggregate>
-
-.. _aggregate_show-aggregate:
-.. describe:: <aggregate>
-
-    Aggregate to display (name or ID)
-
-aggregate unset
----------------
-
-Unset aggregate properties
-
-.. program:: aggregate unset
-.. code-block:: bash
-
-    openstack aggregate unset
-        [--property <key> [...] ]
-        <aggregate>
-
-.. option:: --property <key>
-
-    Property to remove from :ref:`\<aggregate\> <aggregate_unset-aggregate>`
-    (repeat option to remove multiple properties)
-
-.. _aggregate_unset-aggregate:
-.. describe:: <aggregate>
-
-    Aggregate to modify (name or ID)
+.. autoprogram-cliff:: openstack.compute.v2
+   :command: aggregate *

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 *

doc/source/cli/command-objects/compute-service.rst

@@ -4,94 +4,5 @@ compute service
 
 Compute v2
 
-compute service delete
-----------------------
-
-Delete compute service(s)
-
-.. program:: compute service delete
-.. code:: bash
-
-    openstack compute service delete
-        <service> [<service> ...]
-
-.. _compute_service_delete-service:
-.. describe:: <service>
-
-    Compute service(s) to delete (ID only). If using
-    ``--os-compute-api-version`` 2.53 or greater, the ID is a UUID which can
-    be retrieved by listing compute services using the same 2.53+ microversion.
-
-compute service list
---------------------
-
-List compute services
-
-Using ``--os-compute-api-version`` 2.53 or greater will return the ID as a
-UUID value which can be used to uniquely identify the service in a multi-cell
-deployment.
-
-.. program:: compute service list
-.. code:: bash
-
-    openstack compute service list
-        [--host <host>]
-        [--service <service>]
-        [--long]
-
-.. option:: --host <host>
-
-    List services on specified host (name only)
-
-.. option:: --service <service>
-
-    List only specified service binaries (name only). For example,
-    ``nova-compute``, ``nova-conductor``, etc.
-
-.. option:: --long
-
-    List additional fields in output
-
-compute service set
--------------------
-
-Set compute service properties
-
-.. program:: compute service set
-.. code:: bash
-
-    openstack compute service set
-        [--enable | --disable]
-        [--disable-reason <reason>]
-        [--up | --down]
-        <host> <service>
-
-.. option:: --enable
-
-    Enable service
-
-.. option:: --disable
-
-    Disable service
-
-.. option:: --disable-reason <reason>
-
-    Reason for disabling the service (in quotes). Should be used with :option:`--disable` option.
-
-.. option:: --up
-
-    Force up service. Requires ``--os-compute-api-version`` 2.11 or greater.
-
-.. option:: --down
-
-    Force down service. . Requires ``--os-compute-api-version`` 2.11 or
-    greater.
-
-.. _compute_service_set-host:
-.. describe:: <host>
-
-    Name of host
-
-.. describe:: <service>
-
-    Name of service (Binary name), for example ``nova-compute``
+.. autoprogram-cliff:: openstack.compute.v2
+   :command: compute service *