Fine tune some of the helps commands

try and add some consistency with the show and delete commands.

replace 'show x' with 'display x'
change 'delete a y' with just 'delete y'

Change-Id: I47dfa8ee23ac5c41b355796415eb515155832f65

doc/source/command-objects/aggregate.rst

@@ -139,7 +139,7 @@ Set aggregate properties
 aggregate show
 --------------
 
-Show a specific aggregate
+Display aggregate details
 
 .. program aggregate show
 .. code:: bash
@@ -149,4 +149,4 @@ Show a specific aggregate
 
 .. describe:: <aggregate>
 
-    Aggregate to show (name or ID)
+    Aggregate to display (name or ID)

doc/source/command-objects/catalog.rst

@@ -7,6 +7,8 @@ Identity v2
 catalog list
 ------------
 
+List services in the service catalog
+
 .. code:: bash
 
     os catalog list
@@ -14,6 +16,8 @@ catalog list
 catalog show
 ------------
 
+Display service catalog details
+
 .. code:: bash
 
     os catalog show

doc/source/command-objects/consumer.rst

@@ -24,7 +24,7 @@ Create new consumer
 consumer delete
 ---------------
 
-Delete a consumer
+Delete consumer
 
 .. program:: consumer delete
 .. code:: bash

doc/source/command-objects/container.rst

@@ -92,7 +92,7 @@ Save container contents locally
 container show
 --------------
 
-Show container details
+Display container details
 
 .. program:: container show
 .. code:: bash

doc/source/command-objects/domain.rst

@@ -102,7 +102,7 @@ Set domain properties
 domain show
 -----------
 
-Show domain details
+Display domain details
 
 .. program:: domain show
 .. code:: bash

doc/source/command-objects/federation-protocol.rst

@@ -34,7 +34,7 @@ Create new federation protocol
 federation protocol delete
 --------------------------
 
-Delete a federation protocol
+Delete federation protocol
 
 .. program:: federation protocol delete
 .. code:: bash

doc/source/command-objects/flavor.rst

@@ -67,7 +67,7 @@ Create new flavor
 flavor delete
 -------------
 
-Delete a flavor
+Delete flavor
 
 .. program:: flavor delete
 .. code:: bash

doc/source/command-objects/identity-provider.rst

@@ -38,7 +38,7 @@ Create new identity provider
 identity provider delete
 ------------------------
 
-Delete an identity provider
+Delete identity provider
 
 .. program:: identity provider delete
 .. code:: bash

doc/source/command-objects/keypair.rst

@@ -30,7 +30,7 @@ Create new public key
 keypair delete
 --------------
 
-Delete a public key
+Delete public key
 
 .. program keypair delete
 .. code:: bash
@@ -55,7 +55,7 @@ List public key fingerprints
 keypair show
 ------------
 
-Show public key details
+Display public key details
 
 .. program keypair show
 .. code:: bash
@@ -70,4 +70,4 @@ Show public key details
 
 .. describe:: <key>
 
-    Public key to show
+    Public key to display

doc/source/command-objects/mapping.rst

@@ -30,7 +30,7 @@ Create new mapping
 mapping delete
 --------------
 
-Delete a mapping
+Delete mapping
 
 .. program:: mapping delete
 .. code:: bash

doc/source/command-objects/object.rst

@@ -122,7 +122,7 @@ Save object locally
 object show
 -----------
 
-Show object details
+Display object details
 
 .. program:: object show
 .. code:: bash

doc/source/command-objects/project.rst

@@ -149,6 +149,8 @@ Set project properties
 project show
 ------------
 
+Display project details
+
 .. program:: project show
 .. code:: bash
 
@@ -165,4 +167,4 @@ project show
 .. _project_show-project:
 .. describe:: <project>
 
-    Project to show (name or ID)
+    Project to display (name or ID)

doc/source/command-objects/region.rst

@@ -95,7 +95,7 @@ Set region properties
 .. _region_set-region-id:
 .. describe:: <region-id>
 
-    Region ID to modify
+    Region to modify
 
 region show
 -----------
@@ -111,4 +111,4 @@ Display region details
 .. _region_show-region-id:
 .. describe:: <region-id>
 
-    Region ID to display
+    Region to display

doc/source/command-objects/role.rst

@@ -142,7 +142,7 @@ Remove role from domain/project : user/group
 
 .. describe:: <role>
 
-    Role to remove from `<project>`:`<user>` (name or ID)
+    Role to remove (name or ID)
 
 role set
 --------
@@ -169,6 +169,8 @@ Set role properties
 role show
 ---------
 
+Display role details
+
 .. program:: role show
 .. code:: bash
 
@@ -177,4 +179,4 @@ role show
 
 .. describe:: <role>
 
-    Role to show (name or ID)
+    Role to display (name or ID)

doc/source/command-objects/user.rst

@@ -191,6 +191,8 @@ Set user properties
 user show
 ---------
 
+Display user details
+
 .. program:: user show
 .. code:: bash
 
@@ -207,4 +209,4 @@ user show
 .. _user_show-user:
 .. describe:: <user>
 
-    User to show (name or ID)
+    User to display (name or ID)

openstackclient/compute/v2/aggregate.py

@@ -290,7 +290,7 @@ class SetAggregate(show.ShowOne):
 
 
 class ShowAggregate(show.ShowOne):
-    """Show a specific aggregate"""
+    """Display aggregate details"""
 
     log = logging.getLogger(__name__ + '.ShowAggregate')
 
@@ -299,7 +299,7 @@ class ShowAggregate(show.ShowOne):
         parser.add_argument(
             'aggregate',
             metavar='<aggregate>',
-            help='Aggregate to show (name or ID)',
+            help='Aggregate to display (name or ID)',
         )
         return parser
 

openstackclient/compute/v2/flavor.py

@@ -125,7 +125,7 @@ class CreateFlavor(show.ShowOne):
 
 
 class DeleteFlavor(command.Command):
-    """Delete a flavor"""
+    """Delete flavor"""
 
     log = logging.getLogger(__name__ + ".DeleteFlavor")
 

openstackclient/compute/v2/keypair.py

@@ -80,7 +80,7 @@ class CreateKeypair(show.ShowOne):
 
 
 class DeleteKeypair(command.Command):
-    """Delete a public key"""
+    """Delete public key"""
 
     log = logging.getLogger(__name__ + '.DeleteKeypair')
 
@@ -121,7 +121,7 @@ class ListKeypair(lister.Lister):
 
 
 class ShowKeypair(show.ShowOne):
-    """Show public key details"""
+    """Display public key details"""
 
     log = logging.getLogger(__name__ + '.ShowKeypair')
 
@@ -130,7 +130,7 @@ class ShowKeypair(show.ShowOne):
         parser.add_argument(
             'name',
             metavar='<key>',
-            help='Public key to show',
+            help='Public key to display',
         )
         parser.add_argument(
             '--public-key',

openstackclient/identity/v2_0/catalog.py

@@ -59,7 +59,7 @@ class ListCatalog(lister.Lister):
 
 
 class ShowCatalog(show.ShowOne):
-    """Show service catalog details"""
+    """Display service catalog details"""
 
     log = logging.getLogger(__name__ + '.ShowCatalog')
 

openstackclient/identity/v2_0/project.py

@@ -241,7 +241,7 @@ class SetProject(command.Command):
 
 
 class ShowProject(show.ShowOne):
-    """Show project details"""
+    """Display project details"""
 
     log = logging.getLogger(__name__ + '.ShowProject')
 
@@ -250,7 +250,7 @@ class ShowProject(show.ShowOne):
         parser.add_argument(
             'project',
             metavar='<project>',
-            help=_('Project to show (name or ID)'))
+            help=_('Project to display (name or ID)'))
         return parser
 
     def take_action(self, parsed_args):

openstackclient/identity/v2_0/role.py

@@ -235,7 +235,7 @@ class RemoveRole(command.Command):
         parser.add_argument(
             'role',
             metavar='<role>',
-            help=_('Role to remove from <project>:<user> (name or ID)'),
+            help=_('Role to remove (name or ID)'),
         )
         parser.add_argument(
             '--project',
@@ -267,7 +267,7 @@ class RemoveRole(command.Command):
 
 
 class ShowRole(show.ShowOne):
-    """Show single role"""
+    """Display role details"""
 
     log = logging.getLogger(__name__ + '.ShowRole')
 
@@ -276,7 +276,7 @@ class ShowRole(show.ShowOne):
         parser.add_argument(
             'role',
             metavar='<role>',
-            help=_('Role to show (name or ID)'),
+            help=_('Role to display (name or ID)'),
         )
         return parser
 

openstackclient/identity/v2_0/service.py

@@ -144,7 +144,7 @@ class ListService(lister.Lister):
 
 
 class ShowService(show.ShowOne):
-    """Show service details"""
+    """Display service details"""
 
     log = logging.getLogger(__name__ + '.ShowService')
 

openstackclient/identity/v2_0/user.py

@@ -349,7 +349,7 @@ class SetUser(command.Command):
 
 
 class ShowUser(show.ShowOne):
-    """Show user details"""
+    """Display user details"""
 
     log = logging.getLogger(__name__ + '.ShowUser')
 

openstackclient/identity/v3/consumer.py

@@ -51,7 +51,7 @@ class CreateConsumer(show.ShowOne):
 
 
 class DeleteConsumer(command.Command):
-    """Delete a consumer"""
+    """Delete consumer"""
 
     log = logging.getLogger(__name__ + '.DeleteConsumer')
 

openstackclient/identity/v3/domain.py

@@ -187,7 +187,7 @@ class SetDomain(command.Command):
 
 
 class ShowDomain(show.ShowOne):
-    """Show domain details"""
+    """Display domain details"""
 
     log = logging.getLogger(__name__ + '.ShowDomain')
 

openstackclient/identity/v3/federation_protocol.py

@@ -69,7 +69,7 @@ class CreateProtocol(show.ShowOne):
 
 
 class DeleteProtocol(command.Command):
-    """Delete a federation protocol"""
+    """Delete federation protocol"""
 
     log = logging.getLogger(__name__ + '.DeleteProtocol')
 

openstackclient/identity/v3/identity_provider.py

@@ -69,7 +69,7 @@ class CreateIdentityProvider(show.ShowOne):
 
 
 class DeleteIdentityProvider(command.Command):
-    """Delete an identity provider"""
+    """Delete identity provider"""
 
     log = logging.getLogger(__name__ + '.DeleteIdentityProvider')
 

openstackclient/identity/v3/mapping.py

@@ -112,7 +112,7 @@ class CreateMapping(show.ShowOne, _RulesReader):
 
 
 class DeleteMapping(command.Command):
-    """Delete a mapping"""
+    """Delete mapping"""
 
     log = logging.getLogger(__name__ + '.DeleteMapping')
 

openstackclient/identity/v3/project.py

@@ -298,7 +298,7 @@ class SetProject(command.Command):
 
 
 class ShowProject(show.ShowOne):
-    """Show project command"""
+    """Display project details"""
 
     log = logging.getLogger(__name__ + '.ShowProject')
 
@@ -307,7 +307,7 @@ class ShowProject(show.ShowOne):
         parser.add_argument(
             'project',
             metavar='<project>',
-            help='Name or ID of project to display',
+            help='Project to display (name or ID)',
         )
         parser.add_argument(
             '--domain',

openstackclient/identity/v3/region.py

@@ -138,7 +138,7 @@ class SetRegion(command.Command):
         parser.add_argument(
             'region',
             metavar='<region-id>',
-            help=_('Region ID to modify'),
+            help=_('Region to modify'),
         )
         parser.add_argument(
             '--parent-region',
@@ -188,7 +188,7 @@ class ShowRegion(show.ShowOne):
         parser.add_argument(
             'region',
             metavar='<region-id>',
-            help=_('Region ID to display'),
+            help=_('Region to display'),
         )
         return parser
 

openstackclient/identity/v3/role.py

@@ -467,7 +467,7 @@ class SetRole(command.Command):
 
 
 class ShowRole(show.ShowOne):
-    """Show single role"""
+    """Display role details"""
 
     log = logging.getLogger(__name__ + '.ShowRole')
 
@@ -476,7 +476,7 @@ class ShowRole(show.ShowOne):
         parser.add_argument(
             'role',
             metavar='<role>',
-            help='Role to show (name or ID)',
+            help='Role to display (name or ID)',
         )
         return parser
 

openstackclient/identity/v3/service.py

@@ -194,7 +194,7 @@ class SetService(command.Command):
 
 
 class ShowService(show.ShowOne):
-    """Show service details"""
+    """Display service details"""
 
     log = logging.getLogger(__name__ + '.ShowService')
 

openstackclient/identity/v3/user.py

@@ -422,7 +422,7 @@ class SetPasswordUser(command.Command):
 
 
 class ShowUser(show.ShowOne):
-    """Show user details"""
+    """Display user details"""
 
     log = logging.getLogger(__name__ + '.ShowUser')
 

openstackclient/object/v1/container.py

@@ -179,7 +179,7 @@ class SaveContainer(command.Command):
 
 
 class ShowContainer(show.ShowOne):
-    """Show container details"""
+    """Display container details"""
 
     log = logging.getLogger(__name__ + '.ShowContainer')
 

openstackclient/object/v1/object.py

@@ -222,7 +222,7 @@ class SaveObject(command.Command):
 
 
 class ShowObject(show.ShowOne):
-    """Show object details"""
+    """Display object details"""
 
     log = logging.getLogger(__name__ + '.ShowObject')