Update command descriptions

Several commands did not have descriptions or the descriptions
they had were insufficient. This adds mission descriptions
and fattens up those that were too lean.

Change-Id: I091ae70cdae5d3f72f273519d88873cb5392ba3b

glanceclient/v1/legacy_shell.py

@@ -249,6 +249,7 @@ def do_delete(gc, args):
 
 @utils.arg('id', metavar='<IMAGE_ID>', help='ID of image to describe.')
 def do_show(gc, args):
+    """DEPRECATED! Use image-show instead."""
     image = gc.images.get(args.id)
     print_image_formatted(gc, image)
     return SUCCESS

glanceclient/v1/shell.py

@@ -42,7 +42,7 @@ from glanceclient.v1.legacy_shell import *
 @utils.arg('--page-size', metavar='<SIZE>', default=None, type=int,
            help='Number of images to request in each paginated request.')
 def do_image_list(gc, args):
-    """List images."""
+    """List images you can access."""
     filter_keys = ['name', 'status', 'container_format', 'disk_format',
                'size_min', 'size_max']
     filter_items = [(key, getattr(args, key)) for key in filter_keys]
@@ -121,6 +121,7 @@ def do_image_show(gc, args):
            help=("Arbitrary property to associate with image. "
                  "May be used multiple times."))
 def do_image_create(gc, args):
+    """Create a new image."""
     # Filter out None values
     fields = dict(filter(lambda x: x[1] is not None, vars(args).items()))
 
@@ -191,6 +192,7 @@ def do_image_create(gc, args):
                  "not explicitly set in the update request. Otherwise, "
                  "those properties not referenced are preserved."))
 def do_image_update(gc, args):
+    """Update a specific image."""
     # Filter out None values
     fields = dict(filter(lambda x: x[1] is not None, vars(args).items()))
 
@@ -230,6 +232,7 @@ def do_image_delete(gc, args):
 @utils.arg('--tenant-id', metavar='<TENANT_ID>',
            help='Filter results by a tenant ID.')
 def do_member_list(gc, args):
+    """Describe sharing permissions by image or tenant."""
     if args.image_id and args.tenant_id:
         print 'Unable to filter members by both --image-id and --tenant-id.'
         sys.exit(1)
@@ -253,6 +256,7 @@ def do_member_list(gc, args):
 @utils.arg('--can-share', action='store_true', default=False,
            help='Allow the specified tenant to share this image.')
 def do_member_create(gc, args):
+    """Share a specific image with a tenant."""
     gc.image_members.create(args.image_id, args.tenant_id, args.can_share)
 
 
@@ -261,6 +265,7 @@ def do_member_create(gc, args):
 @utils.arg('tenant_id', metavar='<TENANT_ID>',
            help='Tenant to add as member')
 def do_member_delete(gc, args):
+    """Remove a shared image from a tenant."""
     if not options.dry_run:
         gc.image_members.delete(args.image_id, args.tenant_id)
     else:

glanceclient/v2/shell.py

@@ -20,7 +20,7 @@ from glanceclient import exc
 @utils.arg('--page-size', metavar='<SIZE>', default=None, type=int,
            help='Number of images to request in each paginated request.')
 def do_image_list(gc, args):
-    """List images."""
+    """List images you can access."""
     kwargs = {}
     if args.page_size is not None:
         kwargs['page_size'] = args.page_size