diff --git a/keystoneclient/shell.py b/keystoneclient/shell.py
index 1c6c85623..1c3427370 100644
--- a/keystoneclient/shell.py
+++ b/keystoneclient/shell.py
@@ -15,10 +15,10 @@
 #    under the License.
 
 """
-DEPRECATED: Command-line interface to the OpenStack Identity API.
+Pending deprecation: Command-line interface to the OpenStack Identity API.
 
-For a CLI, use python-openstackclient instead. For a Python library, continue
-using python-keystoneclient.
+This CLI is pending deprecation in favor of python-openstackclient. For a
+Python library, continue using python-keystoneclient.
 
 """