neutron: autogenerate docs

$namespace = openstack.network.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.

This one turned out to be quite involved, because we support both
neutron and nova-network. When running in a real cloud, the command
classes detect whether the neutron service is present, assume
nova-network if that service is not found, and only add parser options
relevant to the detected service. But the docs need to present both sets
of options. This was easy enough when they were hardcoded, but required
a bit of additional infrastructure for generated docs.

Change-Id: I426261eb1d86bcc68656aabd61f10b7f082da402

1 files changed, 2 insertions, 154 deletions

diff --git a/doc/source/cli/command-objects/network-qos-policy.rst b/doc/source/cli/command-objects/network-qos-policy.rst
index 2e86f8f3..af7a1040 100644
--- a/doc/source/cli/command-objects/network-qos-policy.rst
+++ b/doc/source/cli/command-objects/network-qos-policy.rst
@@ -7,157 +7,5 @@ network or a port.
 
 Network v2
 
-network qos policy create
--------------------------
-
-Create new Network QoS policy
-
-.. program:: network qos policy create
-.. code:: bash
-
-    openstack network qos policy create
-        [--description <description>]
-        [--share | --no-share]
-        [--project <project>]
-        [--project-domain <project-domain>]
-        [--default | --no-default]
-        <name>
-
-.. option:: --description <description>
-
-    Description of the QoS policy
-
-.. option:: --share
-
-    Make the QoS policy accessible by other projects
-
-.. option:: --no-share
-
-    Make the QoS policy not accessible by other projects (default)
-
-.. option:: --project <project>
-
-    Owner's project (name or ID)
-
-.. option:: --project-domain <project-domain>
-
-    Domain the project belongs to (name or ID).
-    This can be used in case collisions between project names exist.
-
-.. option:: --default
-
-    Set this as a default network QoS policy
-
-.. option:: --no-default
-
-    Set this as a non-default network QoS policy
-
-.. _network_qos_policy_create-name:
-.. describe:: <name>
-
-    New QoS policy specification name
-
-network qos policy delete
--------------------------
-
-Delete Network QoS policy
-
-.. program:: network qos policy delete
-.. code:: bash
-
-    openstack network qos policy delete
-         <qos-policy> [<qos-policy> ...]
-
-.. _network_qos_policy_delete-qos-policy:
-.. describe:: <qos-policy>
-
-    Network QoS policy(s) to delete (name or ID)
-
-network qos policy list
------------------------
-
-List Network QoS policies
-
-.. program:: network qos policy list
-.. code:: bash
-
-    openstack network qos policy list
-        [--project <project> [--project-domain <project-domain>]]
-        [--share | --no-share]
-
-.. option:: --project <project>
-
-    List qos policies according to their project (name or ID)
-
-.. option:: --project-domain <project-domain>
-
-    Domain the project belongs to (name or ID).
-    This can be used in case collisions between project names exist.
-
-.. option:: --share
-
-    List qos policies shared between projects
-
-.. option:: --no-share
-
-    List qos policies not shared between projects
-
-network qos policy set
-----------------------
-
-Set Network QoS policy properties
-
-.. program:: network qos policy set
-.. code:: bash
-
-    openstack network qos policy set
-        [--name <name>]
-        [--description <description>]
-        [--share | --no-share]
-        [--default | --no-default]
-        <qos-policy>
-
-.. option:: --name <name>
-
-    Name of the QoS policy
-
-.. option:: --description <description>
-
-    Description of the QoS policy
-
-.. option:: --share
-
-    Make the QoS policy accessible by other projects
-
-.. option:: --no-share
-
-    Make the QoS policy not accessible by other projects
-
-.. option:: --default
-
-    Set this as a default network QoS policy
-
-.. option:: --no-default
-
-    Set this as a non-default network QoS policy
-
-.. _network_qos_policy_set-qos-policy:
-.. describe:: <qos-policy>
-
-    Network QoS policy to modify (name or ID)
-
-network qos policy show
------------------------
-
-Display Network QoS policy details
-
-.. program:: network qos policy show
-.. code:: bash
-
-    openstack network qos policy show
-        <qos-policy>
-
-.. _network_qos_policy_show-qos-policy:
-.. describe:: <qos-policy>
-
-    Network QoS policy to display (name or ID)
+.. autoprogram-cliff:: openstack.network.v2
+   :command: network qos policy *