summaryrefslogtreecommitdiff
path: root/doc/source/cli/command-objects/service.rst
diff options
context:
space:
mode:
authorEric Fried <openstack@fried.cc>2019-11-04 17:16:34 -0600
committerMonty Taylor <mordred@inaugust.com>2020-06-08 16:34:27 -0500
commit26878e7d53a531adb67c9ddde8fd6d3c3092ce34 (patch)
tree1ebf5ccc543312981f9861fb21e813959f82d2fd /doc/source/cli/command-objects/service.rst
parent00e88822e3fcb288d9fe8d019ee7d1bf8dd74630 (diff)
downloadpython-openstackclient-26878e7d53a531adb67c9ddde8fd6d3c3092ce34.tar.gz
identity: autogenerate docs
$namespace = openstack.identity.v{2|3} 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. Special things: - Some reorganization happened here. Certain subcommand names, such as `endpoint` and `project`, are shared by identify v2 and v3. Previously the hardcoded documents had them combined and interleaved. Attempting to preserve this with autoprogram-cliff would have required significant additional infrastructure. However, since most readers care completely about one and not at all about the other, we instead split the v2 and v3 versions of these commands into separate pages. In case links to the old pages exist in the wild, they are preserved, but moved (with redirects) to a hidden directory, and populated simply with links to the new version-specific generated documents. - The `federation domain` and `federation project` subcommands were previously absent from the docs. They are added. These are such small commands and they seem related, so they're put into a single document. - Some pages were already being generated but were listing operations individually instead of using wildcards (possibly because they were created before wildcarding was supported by cliff). These are changed to use wildcarding. (We want to do this wherever possible as it is more future-proof in the event that more operations are added to a subcommand later.) - The `service provider` document was incorrectly titled `identity provider`. Fixed. Change-Id: I2030f9fe370038c5908b6eb6bed9692a73fe5067
Diffstat (limited to 'doc/source/cli/command-objects/service.rst')
-rw-r--r--doc/source/cli/command-objects/service.rst143
1 files changed, 0 insertions, 143 deletions
diff --git a/doc/source/cli/command-objects/service.rst b/doc/source/cli/command-objects/service.rst
deleted file mode 100644
index a69c6950..00000000
--- a/doc/source/cli/command-objects/service.rst
+++ /dev/null
@@ -1,143 +0,0 @@
-=======
-service
-=======
-
-Identity v2, v3
-
-service create
---------------
-
-Create new service
-
-.. program:: service create
-.. code-block:: bash
-
- openstack service create
- [--name <name>]
- [--description <description>]
- [--enable | --disable]
- <type>
-
-.. option:: --name <name>
-
- New service name
-
-.. option:: --description <description>
-
- New service description
-
-.. option:: --enable
-
- Enable service (default)
-
- *Identity version 3 only*
-
-.. option:: --disable
-
- Disable service
-
- *Identity version 3 only*
-
-.. _service_create-type:
-.. describe:: <type>
-
- New service type (compute, image, identity, volume, etc)
-
-service delete
---------------
-
-Delete service(s)
-
-.. program:: service delete
-.. code-block:: bash
-
- openstack service delete
- <service> [<service> ...]
-
-.. _service_delete-service:
-.. describe:: <service>
-
- Service(s) to delete (type, name or ID)
-
-service list
-------------
-
-List services
-
-.. program:: service list
-.. code-block:: bash
-
- openstack service list
- [--long]
-
-.. option:: --long
-
- List additional fields in output
-
-Returns service fields ID, Name and Type. :option:`--long` adds Description
-and Enabled (*Identity version 3 only*) to the output.
-
-service set
------------
-
-Set service properties
-
-* Identity version 3 only*
-
-.. program:: service set
-.. code-block:: bash
-
- openstack service set
- [--type <type>]
- [--name <name>]
- [--description <description>]
- [--enable | --disable]
- <service>
-
-.. option:: --type <type>
-
- New service type (compute, image, identity, volume, etc)
-
-.. option:: --name <name>
-
- New service name
-
-.. option:: --description <description>
-
- New service description
-
-.. option:: --enable
-
- Enable service
-
-.. option:: --disable
-
- Disable service
-
-.. _service_set-service:
-.. describe:: <service>
-
- Service to modify (type, name or ID)
-
-service show
-------------
-
-Display service details
-
-.. program:: service show
-.. code-block:: bash
-
- openstack service show
- [--catalog]
- <service>
-
-.. option:: --catalog
-
- Show service catalog information
-
- *Identity version 2 only*
-
-.. _service_show-service:
-.. describe:: <service>
-
- Service to display (type, name or ID)