diff --git a/docs/shell.rst b/docs/shell.rst
index fb1ea7413..d19a75577 100644
--- a/docs/shell.rst
+++ b/docs/shell.rst
@@ -12,27 +12,33 @@ The :program:`keystone` shell utility
 The :program:`keystone` shell utility interacts with OpenStack Keystone API
 from the command line. It supports the entirety of the OpenStack Keystone API.
 
-First, you'll need an OpenStack Keystone account and an API key. You get this
-by using the `keystone-manage` command in OpenStack Keystone.
+First, you'll need an OpenStack Keystone account. You get this by using the 
+`keystone-manage` command in OpenStack Keystone.
 
 You'll need to provide :program:`keystone` with your OpenStack username and
-API key. You can do this with the :option:`--username`, :option:`--apikey`
-and :option:`--projectid` options, but it's easier to just set them as
-environment variables by setting two environment variables:
+password. You can do this with the :option:`--username`, :option:`--password`.
+You can optionally specify a :option:`--tenant_id` or :option:`--tenant_name`, 
+to scope your token to a specific tenant.  If you don't specify a tenant, you
+will be scoped to your default tenant if you have one.  Instead of using 
+options, it is easier to just set them as environment variables:
 
-.. envvar:: KEYSTONE_USERNAME
+.. envvar:: OS_USERNAME
 
     Your Keystone username.
 
-.. envvar:: KEYSTONE_API_KEY
+.. envvar:: OS_PASSWORD
 
-    Your API key.
+    Your Keystone password.
 
-.. envvar:: KEYSTONE_PROJECT_ID
+.. envvar:: OS_TENANT_NAME
 
-    Project for work.
+    Name of Keystone Tenant.
 
-.. envvar:: KEYSTONE_URL
+.. envvar:: OS_TENANT_ID
+
+    ID of Keystone Tenant.
+
+.. envvar:: OS_AUTH_URL
 
     The OpenStack API server URL.
 
@@ -42,10 +48,10 @@ environment variables by setting two environment variables:
 
 For example, in Bash you'd use::
 
-    export KEYSTONE_USERNAME=yourname
-    export KEYSTONE_API_KEY=yadayadayada
-    export KEYSTONE_PROJECT_ID=myproject
-    export KEYSTONE_URL=http://...
+    export OS_USERNAME=yourname
+    export OS_PASSWORD=yadayadayada
+    export OS_TENANT_NAME=myproject
+    export OS_AUTH_URL=http://example.com:5000/v2.0/
     export KEYSTONE_VERSION=2.0
 
 From there, all shell commands take the form::
diff --git a/keystoneclient/v2_0/client.py b/keystoneclient/v2_0/client.py
index c5e5545b9..403d57109 100644
--- a/keystoneclient/v2_0/client.py
+++ b/keystoneclient/v2_0/client.py
@@ -33,7 +33,9 @@ class Client(client.HTTPClient):
     :param string username: Username for authentication. (optional)
     :param string password: Password for authentication. (optional)
     :param string token: Token for authentication. (optional)
-    :param string project_id: Tenant/Project id. (optional)
+    :param string tenant_name: Tenant id. (optional)
+    :param string tenant_id: Tenant name. (optional)
+    :param string project_id: Converted to tenant name. (deprecated - to be removed in essex)
     :param string auth_url: Keystone service endpoint for authorization.
     :param string region_name: Name of a region to select when choosing an
                                endpoint from the service catalog.
@@ -49,7 +51,7 @@ class Client(client.HTTPClient):
         >>> from keystoneclient.v2_0 import client
         >>> keystone = client.Client(username=USER,
                                      password=PASS,
-                                     project_id=TENANT,
+                                     tenant_name=TENANT,
                                      auth_url=KEYSTONE_URL)
         >>> keystone.tenants.list()
         ...