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

Author: Eric Fried

doc/source/cli/command-objects/address-scope.rst

@@ -7,143 +7,5 @@ to a given project and may be shared between projects.
 
 Network v2
 
-address scope create
---------------------
-
-Create new address scope
-
-.. program:: address scope create
-.. code:: bash
-
-    openstack address scope create
-        [--project <project> [--project-domain <project-domain>]]
-        [--ip-version <ip-version>]
-        [--share | --no-share]
-        <name>
-
-.. 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:: --ip-version <ip-version>
-
-    IP version (4 or 6, default is 4)
-
-.. option:: --share
-
-    Share the address scope between projects
-
-.. option:: --no-share
-
-    Do not share the address scope between projects (default)
-
-.. _address_scope_create-name:
-.. describe:: <name>
-
-    New address scope name
-
-address scope delete
---------------------
-
-Delete address scope(s)
-
-.. program:: address scope delete
-.. code:: bash
-
-    openstack address scope delete
-        <address-scope> [<address-scope> ...]
-
-.. _address_scope_delete-address-scope:
-.. describe:: <address-scope>
-
-    Address scope(s) to delete (name or ID)
-
-address scope list
-------------------
-
-List address scopes
-
-.. program:: address scope list
-.. code:: bash
-
-    openstack address scope list
-        [--name <name>]
-        [--ip-version <ip-version>]
-        [--project <project> [--project-domain <project-domain>]]
-        [--share | --no-share]
-
-.. option:: --name <name>
-
-    List only address scopes of given name in output
-
-.. option:: --ip-version <ip-version>
-
-    List address scopes of given IP version networks (4 or 6)
-
-.. option:: --project <project>
-
-    List address scopes 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 address scopes shared between projects
-
-.. option:: --no-share
-
-    List address scopes not shared between projects
-
-address scope set
------------------
-
-Set address scope properties
-
-.. program:: address scope set
-.. code:: bash
-
-    openstack address scope set
-        [--name <name>]
-        [--share | --no-share]
-        <address-scope>
-
-.. option:: --name <name>
-
-    Set address scope name
-
-.. option:: --share
-
-    Share the address scope between projects
-
-.. option:: --no-share
-
-    Do not share the address scope between projects
-
-.. _address_scope_set-address-scope:
-.. describe:: <address-scope>
-
-    Address scope to modify (name or ID)
-
-address scope show
-------------------
-
-Display address scope details
-
-.. program:: address scope show
-.. code:: bash
-
-    openstack address scope show
-        <address-scope>
-
-.. _address_scope_show-address-scope:
-.. describe:: <address-scope>
-
-    Address scope to display (name or ID)
+.. autoprogram-cliff:: openstack.network.v2
+   :command: address scope *

doc/source/cli/command-objects/floating-ip-pool.rst

@@ -4,12 +4,5 @@ floating ip pool
 
 Network v2
 
-floating ip pool list
----------------------
-
-List pools of floating IP addresses
-
-.. program:: floating ip pool list
-.. code:: bash
-
-    openstack floating ip pool list
+.. autoprogram-cliff:: openstack.network.v2
+   :command: floating ip pool *

doc/source/cli/command-objects/floating-ip-port-forwarding.rst

@@ -4,170 +4,6 @@ floating ip port forwarding
 
 Network v2
 
-floating ip port forwarding create
-----------------------------------
+.. autoprogram-cliff:: openstack.network.v2
+   :command: floating ip port forwarding *
 
-Create floating IP Port Forwarding
-
-.. program:: floating ip port forwarding create
-.. code:: bash
-
-    openstack floating ip port forwarding create
-        --internal-ip-address <internal-ip-address>
-        --port <port>
-        --internal-protocol-port <port-number>
-        --external-protocol-port <port-number>
-        --protocol <protocol>
-        <floating-ip>
-
-
-.. describe:: --internal-ip-address <internal-ip-address>
-
-    The fixed IPv4 address of the network port associated
-    to the floating IP port forwarding
-
-.. describe:: --port <port>
-
-    The name or ID of the network port associated to the
-    floating IP port forwarding
-
-.. describe:: --internal-protocol-port <port-number>
-
-    The protocol port number of the network port fixed
-    IPv4 address associated to the floating IP port
-    forwarding
-
-.. describe:: --external-protocol-port <port-number>
-
-    The protocol port number of the port forwarding's
-    floating IP address
-
-.. describe:: --protocol <protocol>
-
-    The protocol used in the floating IP port forwarding,
-    for instance: TCP, UDP
-
-.. describe:: <floating-ip>
-
-    Floating IP that the port forwarding belongs to (IP
-    address or ID)
-
-floating ip port forwarding delete
-----------------------------------
-
-Delete floating IP Port Forwarding(s)
-
-.. program:: floating ip port forwarding delete
-.. code:: bash
-
-    openstack floating ip port forwarding delete <floating-ip>
-    <port-forwarding-id> [<port-forwarding-id> ...]
-
-.. describe:: <floating-ip>
-
-    Floating IP that the port forwarding belongs to (IP
-    address or ID)
-
-.. describe:: <port-forwarding-id>
-
-    The ID of the floating IP port forwarding
-
-floating ip port forwarding list
---------------------------------
-
-List floating IP Port Forwarding(s)
-
-.. program:: floating ip port forwarding list
-.. code:: bash
-
-    openstack floating ip port forwarding list
-    [--port <port>]
-    [--external-protocol-port <port-number>]
-    [--protocol protocol]
-    <floating-ip>
-
-.. option:: --port <port>
-
-    The ID of the network port associated to the floating
-    IP port forwarding
-
-.. option:: --protocol <protocol>
-
-    The IP protocol used in the floating IP port
-    forwarding
-
-.. describe:: <floating-ip>
-
-    Floating IP that the port forwarding belongs to (IP
-    address or ID)
-
-floating ip port forwarding set
--------------------------------
-
-Set floating IP Port Forwarding properties
-
-.. program:: floating ip port forwarding set
-.. code:: bash
-
-    openstack floating ip port forwarding set
-    [--port <port>]
-    [--internal-ip-address <internal-ip-address>]
-    [--internal-protocol-port <port-number>]
-    [--external-protocol-port <port-number>]
-    [--protocol <protocol>]
-    <floating-ip>
-    <port-forwarding-id>
-
-.. option:: --port <port>
-
-    The ID of the network port associated to the floating
-    IP port forwarding
-
-.. option:: --internal-ip-address <internal-ip-address>
-
-    The fixed IPv4 address of the network port associated
-    to the floating IP port forwarding
-
-.. option:: --internal-protocol-port <port-number>
-
-    The TCP/UDP/other protocol port number of the network
-    port fixed IPv4 address associated to the floating IP
-    port forwarding
-
-.. option:: --external-protocol-port <port-number>
-
-    The TCP/UDP/other protocol port number of the port
-    forwarding's floating IP address
-
-.. option:: --protocol <protocol>
-
-    The IP protocol used in the floating IP port
-    forwarding
-
-.. describe:: <floating-ip>
-
-    Floating IP that the port forwarding belongs to (IP
-    address or ID)
-
-.. describe:: <port-forwarding-id>
-
-    The ID of the floating IP port forwarding
-
-floating ip port forwarding show
---------------------------------
-
-Display floating IP Port Forwarding details
-
-.. program:: floating ip port forwarding show
-.. code:: bash
-
-    openstack floating ip show <floating-ip> <port-forwarding-id>
-
-.. describe:: <floating-ip>
-
-    Floating IP that the port forwarding belongs to (IP
-    address or ID)
-
-.. describe:: <port-forwarding-id>
-
-    The ID of the floating IP port forwarding