Add heat-keystone-setup man page

Change-Id: I314ce01d35d65e3b50b72d2abaf51710b8461da7
Fixes: Bug #1153693

diff --git a/doc/source/conf.py b/doc/source/conf.py
index 04dab029587b332da461b79a109e35fd8ebe863a..7f976bdab3bf438a5b0400c437c9caa259d3f2d6 100644 (file)
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -240,6 +240,9 @@ man_pages = [
     ('man/heat-engine', 'heat-engine',
     u'Service which performs the actions from the API calls made by the user',
     [u'Heat Developers'], 1),
+    ('man/heat-keystone-setup', 'heat-keystone-setup',
+    u'Script which sets up keystone for usage by Heat',
+    [u'Heat Developers'], 1),
     ('man/heat-watch', 'heat-watch',
     u'Command line utility to run heat watch actions over the CloudWatch API',
     [u'Heat Developers'], 1),

diff --git a/doc/source/man/heat-keystone-setup.rst b/doc/source/man/heat-keystone-setup.rst
new file mode 100644 (file)
index 0000000..b661faf
--- /dev/null
+++ b/doc/source/man/heat-keystone-setup.rst
@@ -0,0 +1,27 @@
+========
+heat-keystone-setup
+========
+
+.. program:: heat-keystone-setup
+
+
+SYNOPSIS
+========
+
+``heat-keystone-setup``
+
+
+DESCRIPTION
+===========
+The heat-keystone-setup tool configures keystone for use with Heat.  This script requires admin keystone credentials to be available in the shell environment and write access to /etc/keystone.
+
+Distributions may provide other tools to setup keystone for use with Heat, so check the distro documenation first.
+
+EXAMPLES
+========
+
+  heat-keystone-setup
+
+BUGS
+====
+Heat bugs are managed through Launchpad <https://launchpad.net/heat>