reorganize existing documentation according to the new standard layout

Move existing content around based on the doc-migration specification.

Replace :doc: markup with :ref: to have sphinx keep track of where the
files move and generate valid hyperlinks.

Add a few toctrees and index pages for the new directories.

Depends-On: Ia750cb049c0f53a234ea70ce1f2bbbb7a2aa9454
Change-Id: I253ee8f89d3ec40e39310c18bb87ed1d3d5de330
Signed-off-by: Doug Hellmann <doug@doughellmann.com>

1 files changed, 269 insertions, 0 deletions

diff --git a/doc/source/cli/command-objects/subnet-pool.rst b/doc/source/cli/command-objects/subnet-pool.rst
new file mode 100644
index 00000000..3a60974a
--- /dev/null
+++ b/doc/source/cli/command-objects/subnet-pool.rst
@@ -0,0 +1,269 @@
+===========
+subnet pool
+===========
+
+A **subnet pool** contains a collection of prefixes in CIDR notation
+that are available for IP address allocation.
+
+Network v2
+
+subnet pool create
+------------------
+
+Create subnet pool
+
+.. program:: subnet pool create
+.. code:: bash
+
+    openstack subnet pool create
+        [--default-prefix-length <default-prefix-length>]
+        [--min-prefix-length <min-prefix-length>]
+        [--max-prefix-length <max-prefix-length>]
+        [--description <description>]
+        [--project <project> [--project-domain <project-domain>]]
+        [--address-scope <address-scope>]
+        [--default | --no-default]
+        [--share | --no-share]
+        [--default-quota <num-ip-addresses>]
+        --pool-prefix <pool-prefix> [...]
+        <name>
+
+.. option:: --default-prefix-length <default-prefix-length>
+
+    Set subnet pool default prefix length
+
+.. option:: --min-prefix-length <min-prefix-length>
+
+    Set subnet pool minimum prefix length
+
+.. option:: --max-prefix-length <max-prefix-length>
+
+    Set subnet pool maximum prefix length
+
+.. option:: --description <description>
+
+    Set subnet pool description
+
+.. 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:: --address-scope <address-scope>
+
+    Set address scope associated with the subnet pool (name or ID),
+    prefixes must be unique across address scopes
+
+.. option:: --default
+
+    Set this as a default subnet pool
+
+.. option:: --no-default
+
+    Set this as a non-default subnet pool
+
+.. option:: --share
+
+    Set this subnet pool as shared
+
+.. option:: --no-share
+
+    Set this subnet pool as not shared
+
+.. option:: --default-quota <num-ip-addresses>
+
+    Set default quota for subnet pool as the number of
+    IP addresses allowed in a subnet
+
+.. option:: --pool-prefix <pool-prefix>
+
+    Set subnet pool prefixes (in CIDR notation)
+    (repeat option to set multiple prefixes)
+
+.. _subnet_pool_create-name:
+.. describe:: <name>
+
+    Name of the new subnet pool
+
+subnet pool delete
+------------------
+
+Delete subnet pool(s)
+
+.. program:: subnet pool delete
+.. code:: bash
+
+    openstack subnet pool delete
+        <subnet-pool> [<subnet-pool> ...]
+
+.. _subnet_pool_delete-subnet-pool:
+.. describe:: <subnet-pool>
+
+    Subnet pool(s) to delete (name or ID)
+
+subnet pool list
+----------------
+
+List subnet pools
+
+.. program:: subnet pool list
+.. code:: bash
+
+    openstack subnet pool list
+        [--long]
+        [--share | --no-share]
+        [--default | --no-default]
+        [--project <project> [--project-domain <project-domain>]]
+        [--name <name>]
+        [--address-scope <address-scope>]
+
+.. option:: --long
+
+    List additional fields in output
+
+.. option:: --share
+
+    List subnet pools shared between projects
+
+.. option:: --no-share
+
+    List subnet pools not shared between projects
+
+.. option:: --default
+
+    List subnet pools used as the default external subnet pool
+
+.. option:: --no-default
+
+    List subnet pools not used as the default external subnet pool
+
+.. option:: --project <project>
+
+    List subnet pools 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:: --name <name>
+
+    List only subnet pools of given name in output
+
+.. option:: --address-scope <address-scope>
+
+    List only subnet pools of given address scope in output (name or ID)
+
+subnet pool set
+---------------
+
+Set subnet pool properties
+
+.. program:: subnet pool set
+.. code:: bash
+
+    openstack subnet pool set
+        [--name <name>]
+        [--pool-prefix <pool-prefix> [...]]
+        [--default-prefix-length <default-prefix-length>]
+        [--min-prefix-length <min-prefix-length>]
+        [--max-prefix-length <max-prefix-length>]
+        [--address-scope <address-scope> | --no-address-scope]
+        [--default | --no-default]
+        [--description <description>]
+        [--default-quota <num-ip-addresses>]
+        <subnet-pool>
+
+.. option:: --name <name>
+
+    Set subnet pool name
+
+.. option:: --pool-prefix <pool-prefix>
+
+    Set subnet pool prefixes (in CIDR notation)
+    (repeat option to set multiple prefixes)
+
+.. option:: --default-prefix-length <default-prefix-length>
+
+    Set subnet pool default prefix length
+
+.. option:: --min-prefix-length <min-prefix-length>
+
+    Set subnet pool minimum prefix length
+
+.. option:: --max-prefix-length <max-prefix-length>
+
+    Set subnet pool maximum prefix length
+
+.. option:: --address-scope <address-scope>
+
+    Set address scope associated with the subnet pool (name or ID),
+    prefixes must be unique across address scopes
+
+.. option:: --no-address-scope
+
+    Remove address scope associated with the subnet pool
+
+.. option:: --default
+
+    Set this as a default subnet pool
+
+.. option:: --no-default
+
+    Set this as a non-default subnet pool
+
+.. option:: --description <description>
+
+    Set subnet pool description
+
+.. option:: --default-quota <num-ip-addresses>
+
+    Set default quota for subnet pool as the number of
+    IP addresses allowed in a subnet
+
+.. _subnet_pool_set-subnet-pool:
+.. describe:: <subnet-pool>
+
+    Subnet pool to modify (name or ID)
+
+subnet pool show
+----------------
+
+Display subnet pool details
+
+.. program:: subnet pool show
+.. code:: bash
+
+    openstack subnet pool show
+        <subnet-pool>
+
+.. _subnet_pool_show-subnet-pool:
+.. describe:: <subnet-pool>
+
+    Subnet pool to display (name or ID)
+
+subnet pool unset
+-----------------
+
+Unset subnet pool properties
+
+.. program:: subnet pool unset
+.. code:: bash
+
+    openstack subnet pool unset
+        [--pool-prefix <pool-prefix> [...]]
+        <subnet-pool>
+
+.. option:: --pool-prefix <pool-prefix>
+
+    Remove subnet pool prefixes (in CIDR notation).
+    (repeat option to unset multiple prefixes).
+
+.. _subnet_pool_unset-subnet-pool:
+.. describe:: <subnet-pool>
+
+    Subnet pool to modify (name or ID)