Normalize more help strings

Change-Id: I2b21bc904e35c1cc50da369d148e607fe3e8cf90

6 files changed, 35 insertions, 30 deletions

diff --git a/openstackclient/compute/v2/console.py b/openstackclient/compute/v2/console.py
index e1f84e23..8206f302 100644
--- a/openstackclient/compute/v2/console.py
+++ b/openstackclient/compute/v2/console.py
@@ -26,7 +26,7 @@ from openstackclient.common import utils
 
 
 class ShowConsoleLog(command.Command):
-    """Show console-log command"""
+    """Show server's console output"""
 
     log = logging.getLogger(__name__ + '.ShowConsoleLog')
 
@@ -35,7 +35,7 @@ class ShowConsoleLog(command.Command):
         parser.add_argument(
             'server',
             metavar='<server>',
-            help='Name or ID of server to display console log',
+            help='Server (name or ID)',
         )
         parser.add_argument(
             '--lines',
@@ -67,7 +67,7 @@ class ShowConsoleLog(command.Command):
 
 
 class ShowConsoleURL(show.ShowOne):
-    """Show console-url command"""
+    """Show server's remote console URL"""
 
     log = logging.getLogger(__name__ + '.ShowConsoleURL')
 
@@ -76,7 +76,7 @@ class ShowConsoleURL(show.ShowOne):
         parser.add_argument(
             'server',
             metavar='<server>',
-            help='Name or ID of server to display console log',
+            help='Server (name or ID)',
         )
         type_group = parser.add_mutually_exclusive_group()
         type_group.add_argument(
diff --git a/openstackclient/compute/v2/flavor.py b/openstackclient/compute/v2/flavor.py
index 73429796..6dd00b1b 100644
--- a/openstackclient/compute/v2/flavor.py
+++ b/openstackclient/compute/v2/flavor.py
@@ -26,7 +26,7 @@ from openstackclient.common import utils
 
 
 class CreateFlavor(show.ShowOne):
-    """Create flavor command"""
+    """Create new flavor"""
 
     log = logging.getLogger(__name__ + ".CreateFlavor")
 
@@ -35,7 +35,8 @@ class CreateFlavor(show.ShowOne):
         parser.add_argument(
             "name",
             metavar="<name>",
-            help="Name of the new flavor")
+            help="New flavor name",
+        )
         parser.add_argument(
             "--id",
             metavar="<id>",
@@ -84,12 +85,14 @@ class CreateFlavor(show.ShowOne):
             dest="public",
             action="store_true",
             default=True,
-            help="Flavor is accessible to the public (default)")
+            help="Flavor is accessible to other projects (default)",
+        )
         public_group.add_argument(
             "--private",
             dest="public",
             action="store_false",
-            help="Flavor is inaccessible to the public")
+            help="Flavor is inaccessible to other projects",
+        )
         return parser
 
     def take_action(self, parsed_args):
@@ -115,7 +118,7 @@ class CreateFlavor(show.ShowOne):
 
 
 class DeleteFlavor(command.Command):
-    """Delete flavor command"""
+    """Delete a flavor"""
 
     log = logging.getLogger(__name__ + ".DeleteFlavor")
 
@@ -124,7 +127,8 @@ class DeleteFlavor(command.Command):
         parser.add_argument(
             "flavor",
             metavar="<flavor>",
-            help="Name or ID of flavor to delete")
+            help="Flavor to delete (name or ID)",
+        )
         return parser
 
     def take_action(self, parsed_args):
@@ -137,7 +141,7 @@ class DeleteFlavor(command.Command):
 
 
 class ListFlavor(lister.Lister):
-    """List flavor command"""
+    """List flavors"""
 
     log = logging.getLogger(__name__ + ".ListFlavor")
 
@@ -164,7 +168,7 @@ class ListFlavor(lister.Lister):
 
 
 class ShowFlavor(show.ShowOne):
-    """Show flavor command"""
+    """Show flavor details"""
 
     log = logging.getLogger(__name__ + ".ShowFlavor")
 
@@ -173,7 +177,8 @@ class ShowFlavor(show.ShowOne):
         parser.add_argument(
             "flavor",
             metavar="<flavor>",
-            help="Name or ID of flavor to display")
+            help="Flavor to display (name or ID)",
+        )
         return parser
 
     def take_action(self, parsed_args):
diff --git a/openstackclient/compute/v2/floatingip.py b/openstackclient/compute/v2/floatingip.py
index 72b19c6c..658f0d5a 100644
--- a/openstackclient/compute/v2/floatingip.py
+++ b/openstackclient/compute/v2/floatingip.py
@@ -26,7 +26,7 @@ from openstackclient.common import utils
 
 
 class AddFloatingIP(command.Command):
-    """Add floating-ip command"""
+    """Add floating-ip to server"""
 
     log = logging.getLogger(__name__ + ".AddFloatingIP")
 
@@ -40,7 +40,7 @@ class AddFloatingIP(command.Command):
         parser.add_argument(
             "server",
             metavar="<server>",
-            help="Name of the server to receive the IP address",
+            help="Server to receive the IP address (name or ID)",
         )
         return parser
 
@@ -56,7 +56,7 @@ class AddFloatingIP(command.Command):
 
 
 class CreateFloatingIP(show.ShowOne):
-    """Create floating-ip command"""
+    """Create new floating-ip"""
 
     log = logging.getLogger(__name__ + '.CreateFloatingIP')
 
@@ -80,7 +80,7 @@ class CreateFloatingIP(show.ShowOne):
 
 
 class DeleteFloatingIP(command.Command):
-    """Delete floating-ip command"""
+    """Delete a floating-ip"""
 
     log = logging.getLogger(__name__ + '.DeleteFloatingIP')
 
@@ -107,7 +107,7 @@ class DeleteFloatingIP(command.Command):
 
 
 class ListFloatingIP(lister.Lister):
-    """List floating-ip command"""
+    """List floating-ips"""
 
     log = logging.getLogger(__name__ + '.ListFloatingIP')
 
@@ -127,7 +127,7 @@ class ListFloatingIP(lister.Lister):
 
 
 class RemoveFloatingIP(command.Command):
-    """Remove floating-ip command"""
+    """Remove floating-ip from server"""
 
     log = logging.getLogger(__name__ + ".RemoveFloatingIP")
 
@@ -141,7 +141,7 @@ class RemoveFloatingIP(command.Command):
         parser.add_argument(
             "server",
             metavar="<server>",
-            help="Name of the server to remove the IP address from",
+            help="Server to remove the IP address from (name or ID)",
         )
         return parser
 
diff --git a/openstackclient/compute/v2/floatingippool.py b/openstackclient/compute/v2/floatingippool.py
index d5e8d0dd..db1c9f0f 100644
--- a/openstackclient/compute/v2/floatingippool.py
+++ b/openstackclient/compute/v2/floatingippool.py
@@ -23,7 +23,7 @@ from openstackclient.common import utils
 
 
 class ListFloatingIPPool(lister.Lister):
-    """List floating-ip-pool command"""
+    """List floating-ip-pools"""
 
     log = logging.getLogger(__name__ + '.ListFloatingIPPool')
 
diff --git a/openstackclient/compute/v2/hypervisor.py b/openstackclient/compute/v2/hypervisor.py
index 334987e2..e01258d1 100644
--- a/openstackclient/compute/v2/hypervisor.py
+++ b/openstackclient/compute/v2/hypervisor.py
@@ -25,7 +25,7 @@ from openstackclient.common import utils
 
 
 class ListHypervisor(lister.Lister):
-    """List hypervisor command"""
+    """List hypervisors"""
 
     log = logging.getLogger(__name__ + ".ListHypervisor")
 
@@ -33,9 +33,9 @@ class ListHypervisor(lister.Lister):
         parser = super(ListHypervisor, self).get_parser(prog_name)
         parser.add_argument(
             "--matching",
-            metavar="<hostname>",
-            help="List hypervisors with hostnames matching the given"
-                 " substring")
+            metavar="<hostname-str>",
+            help="Filter hypervisors using <hostname-str> substring",
+        )
         return parser
 
     def take_action(self, parsed_args):
@@ -58,7 +58,7 @@ class ListHypervisor(lister.Lister):
 
 
 class ShowHypervisor(show.ShowOne):
-    """Show hypervisor command"""
+    """Show hypervisor details"""
 
     log = logging.getLogger(__name__ + ".ShowHypervisor")
 
diff --git a/openstackclient/compute/v2/keypair.py b/openstackclient/compute/v2/keypair.py
index 972443a4..74cf4372 100644
--- a/openstackclient/compute/v2/keypair.py
+++ b/openstackclient/compute/v2/keypair.py
@@ -29,7 +29,7 @@ from openstackclient.common import utils
 
 
 class CreateKeypair(show.ShowOne):
-    """Create keypair command"""
+    """Create new keypair"""
 
     log = logging.getLogger(__name__ + '.CreateKeypair')
 
@@ -79,7 +79,7 @@ class CreateKeypair(show.ShowOne):
 
 
 class DeleteKeypair(command.Command):
-    """Delete keypair command"""
+    """Delete a keypair"""
 
     log = logging.getLogger(__name__ + '.DeleteKeypair')
 
@@ -100,7 +100,7 @@ class DeleteKeypair(command.Command):
 
 
 class ListKeypair(lister.Lister):
-    """List keypair command"""
+    """List keypairs"""
 
     log = logging.getLogger(__name__ + ".ListKeypair")
 
@@ -120,7 +120,7 @@ class ListKeypair(lister.Lister):
 
 
 class ShowKeypair(show.ShowOne):
-    """Show keypair command"""
+    """Show keypair details"""
 
     log = logging.getLogger(__name__ + '.ShowKeypair')