From bc8f0699289699bf4095ea0dbe6fd5c9dd092ba7 Mon Sep 17 00:00:00 2001
From: Steven Dake <sdake@redhat.com>
Date: Thu, 14 Mar 2013 15:03:55 -0700
Subject: [PATCH] Add heat-keystone-setup man page

Change-Id: I314ce01d35d65e3b50b72d2abaf51710b8461da7
Fixes: Bug #1153693
---
 doc/source/conf.py                     |  3 +++
 doc/source/man/heat-keystone-setup.rst | 27 ++++++++++++++++++++++++++
 2 files changed, 30 insertions(+)
 create mode 100644 doc/source/man/heat-keystone-setup.rst

diff --git a/doc/source/conf.py b/doc/source/conf.py
index 04dab02958..7f976bdab3 100644
--- 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
index 0000000000..b661faf212
--- /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>