From d08101eef65a2cab8151fe4c3d33050694740a49 Mon Sep 17 00:00:00 2001
From: Angus Salkeld <asalkeld@redhat.com>
Date: Fri, 1 Nov 2013 21:55:53 +1100
Subject: [PATCH] Add a man page for heat-manage

Change-Id: I9b3d6b3b227ca2a2a2786837b941fdc420d3b2b6
Closes-bug: #1189651
---
 doc/source/man/heat-manage.rst | 55 ++++++++++++++++++++++++++++++++++
 doc/source/man/index.rst       |  1 +
 2 files changed, 56 insertions(+)
 create mode 100644 doc/source/man/heat-manage.rst

diff --git a/doc/source/man/heat-manage.rst b/doc/source/man/heat-manage.rst
new file mode 100644
index 0000000000..06fb6b294b
--- /dev/null
+++ b/doc/source/man/heat-manage.rst
@@ -0,0 +1,55 @@
+===========
+heat-manage
+===========
+
+.. program:: heat-manage
+
+SYNOPSIS
+========
+``heat-manage <action> [options]``
+
+DESCRIPTION
+===========
+heat-manage helps manage heat specific database operations.
+
+
+OPTIONS
+=======
+
+The standard pattern for executing a heat-manage command is:
+``heat-manage <command> [<args>]``
+
+Run with -h to see a list of available commands:
+``heat-manage -h``
+
+Commands are db_version, db_sync and purge_deleted. Detailed descriptions are below.
+
+
+Heat Db version
+~~~~~~~~~~~~~~~
+
+``heat-manage db_version``
+
+    Print out the db schema revision.
+
+``heat-manage db_sync``
+
+    Sync the database up to the most recent version.
+
+``heat-manage purge_deleted [-g {days,hours,minutes,seconds}] [age]``
+
+    Purge db entries marked as deleted and older than [age].
+
+
+FILES
+=====
+
+The /etc/heat/heat.conf file contains global options which can be
+used to configure some aspects of heat-manage, for example the DB
+connection and logging.
+
+BUGS
+====
+
+* Heat issues are tracked in Launchpad so you can view or report bugs here
+  `OpenStack Heat Bugs <https://bugs.launchpad.net/heat>`__
diff --git a/doc/source/man/index.rst b/doc/source/man/index.rst
index 9de280134f..1e82990c94 100644
--- a/doc/source/man/index.rst
+++ b/doc/source/man/index.rst
@@ -21,5 +21,6 @@ Heat utilities
 .. toctree::
    :maxdepth: 2
 
+   heat-manage
    heat-db-setup
    heat-keystone-setup