From ab60065f5a8f2eaf19bba946310ab712f48edcfd Mon Sep 17 00:00:00 2001
From: Brant Knudson <bknudson@us.ibm.com>
Date: Fri, 10 Oct 2014 18:55:59 -0500
Subject: [PATCH] Warn that keystone CLI is pending deprecation

The keystone CLI is pending deprecation so warn about it in the
developer docs.

DocImpact

Change-Id: Ibca9d4cd8d31a62ee1ec7f24671c8f0f01ca9f7f
---
 doc/source/man/keystone.rst | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/doc/source/man/keystone.rst b/doc/source/man/keystone.rst
index d96d89f7e..8bf979f58 100644
--- a/doc/source/man/keystone.rst
+++ b/doc/source/man/keystone.rst
@@ -1,6 +1,6 @@
-========================================
-:program:`keystone` command line utility
-========================================
+==============================================================
+:program:`keystone` command line utility (pending deprecation)
+==============================================================
 
 .. program:: keystone
 .. highlight:: bash
@@ -18,6 +18,14 @@ SYNOPSIS
 DESCRIPTION
 ===========
 
+.. WARNING::
+
+    The :program:`keystone` command line utility is pending deprecation. The
+    `OpenStackClient unified command line utility
+    <http://docs.openstack.org/developer/python-openstackclient/>`_ should be
+    used instead. The :program:`keystone` command line utility only supports V2
+    of the Identity API whereas the OSC program supports both V2 and V3.
+
 The :program:`keystone` command line utility interacts with services providing
 OpenStack Identity API (e.g. Keystone).