2 files changed, 84 insertions, 1 deletions
diff --git a/doc/source/command-objects/consumer.rst b/doc/source/command-objects/consumer.rst
new file mode 100644
index 00000000..59ace845
--- /dev/null
+++ b/doc/source/command-objects/consumer.rst
@@ -0,0 +1,83 @@
+========
+consumer
+========
+
+Identity v3
+
+`Requires: OS-OAUTH1 extension`
+
+consumer create
+---------------
+
+Create new consumer
+
+.. program:: consumer create
+.. code:: bash
+
+    os consumer create
+        [--description <description>]
+
+.. option:: --description <description>
+
+    New consumer description
+
+consumer delete
+---------------
+
+Delete a consumer
+
+.. program:: consumer delete
+.. code:: bash
+
+    os consumer delete
+        <consumer>
+
+.. describe:: <consumer>
+
+    Consumer to delete
+
+consumer list
+-------------
+
+List consumers
+
+.. program:: consumer list
+.. code:: bash
+
+    os consumer list
+
+consumer set
+------------
+
+Set consumer properties
+
+.. program:: consumer set
+.. code:: bash
+
+    os consumer set
+        [--description <description>]
+        <consumer>
+
+.. option:: --description <description>
+
+    New consumer description
+
+.. describe:: <consumer>
+
+    Consumer to modify
+
+consumer show
+-------------
+
+Display consumer details
+
+.. program:: consumer show
+.. code:: bash
+
+    os consumer show
+        <consumer>
+
+.. _consumer_show-consumer:
+.. describe:: <consumer>
+
+    Consumer to display
diff --git a/doc/source/commands.rst b/doc/source/commands.rst
index 01175bd7..a8bffa36 100644
--- a/doc/source/commands.rst
+++ b/doc/source/commands.rst
@@ -76,7 +76,7 @@ referring to both Compute and Volume quotas.
 * ``catalog``: (**Identity**) service catalog
 * ``console log``: (**Compute**) server console text dump
 * ``console url``: (**Compute**) server remote console URL
-* ``consumer``: Identity - OAuth-based delegatee
+* ``consumer``: (**Identity**) OAuth-based delegatee
 * ``container``: (**Object Store**) a grouping of objects
 * ``credentials``: (**Identity**) specific to identity providers
 * ``domain``: (**Identity**) a grouping of projects