Doc: Unify repeatable option comments

There are lots of "this option can be repeated" comments
in the doc, which are not consistent to other similar
docs.

This patch changes them to the following format:

"repeat option to do something"

Change-Id: I54e01053091c428bf87bb36bb95f73a0b80ab6e7

Author: Tang Chen

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

@@ -22,8 +22,8 @@ Create new identity provider
 
 .. option:: --remote-id <remote-id>
 
-    Remote IDs to associate with the Identity Provider (repeat to provide
-    multiple values)
+    Remote IDs to associate with the Identity Provider
+    (repeat option to provide multiple values)
 
 .. option:: --remote-id-file <file-name>
 
@@ -87,8 +87,8 @@ Set identity provider properties
 
 .. option:: --remote-id <remote-id>
 
-    Remote IDs to associate with the Identity Provider (repeat to provide
-    multiple values)
+    Remote IDs to associate with the Identity Provider
+    (repeat option to provide multiple values)
 
 .. option:: --remote-id-file <file-name>
 

doc/source/command-objects/network.rst

@@ -58,8 +58,9 @@ Create new network
 
 .. option:: --availability-zone-hint <availability-zone>
 
-    Availability Zone in which to create this network (requires the Network
-    Availability Zone extension, this option can be repeated).
+    Availability Zone in which to create this network
+    (requires the Network Availability Zone extension,
+    repeat option to set multiple availability zones)
 
     *Network version 2 only*
 

doc/source/command-objects/port.rst

@@ -33,7 +33,7 @@ Create new port
 
     Desired IP and/or subnet (name or ID) for this port:
     subnet=<subnet>,ip-address=<ip-address>
-    (this option can be repeated)
+    (repeat option to set multiple fixed IP addresses)
 
 .. option:: --device <device-id>
 
@@ -51,7 +51,7 @@ Create new port
 .. option:: --binding-profile <binding-profile>
 
     Custom data to be passed as binding:profile: <key>=<value>
-    (this option can be repeated)
+    (repeat option to set multiple binding:profile data)
 
 .. option:: --host <host-id>
 
@@ -137,7 +137,7 @@ Set port properties
 
     Desired IP and/or subnet (name or ID) for this port:
     subnet=<subnet>,ip-address=<ip-address>
-    (this option can be repeated)
+    (repeat option to set multiple fixed IP addresses)
 
 .. option:: --no-fixed-ip
 
@@ -159,7 +159,7 @@ Set port properties
 .. option:: --binding-profile <binding-profile>
 
     Custom data to be passed as binding:profile: <key>=<value>
-    (this option can be repeated)
+    (repeat option to set multiple binding:profile data)
 
 .. option:: --no-binding-profile
 

doc/source/command-objects/router.rst

@@ -86,8 +86,9 @@ Create new router
 
 .. option:: --availability-zone-hint <availability-zone>
 
-    Availability Zone in which to create this router (requires the Router
-    Availability Zone extension, this option can be repeated).
+    Availability Zone in which to create this router
+    (requires the Router Availability Zone extension,
+    repeat option to set multiple availability zones)
 
 .. _router_create-name:
 .. describe:: <name>
@@ -206,10 +207,10 @@ Set router properties
 
 .. option:: --route destination=<subnet>,gateway=<ip-address>
 
-    Routes associated with the router.
-    Repeat this option to set multiple routes.
-    destination: destination subnet (in CIDR notation).
-    gateway: nexthop IP address.
+    Routes associated with the router
+    destination: destination subnet (in CIDR notation)
+    gateway: nexthop IP address
+    (repeat option to set multiple routes)
 
 .. option:: --clear-routes
 

doc/source/command-objects/server.rst

@@ -90,19 +90,21 @@ Create a new server
 .. option:: --security-group <security-group-name>
 
     Security group to assign to this server (name or ID)
-    (repeat for multiple groups)
+    (repeat option to set multiple groups)
 
 .. option:: --key-name <key-name>
 
     Keypair to inject into this server (optional extension)
 
 .. option:: --property <key=value>
 
-    Set a property on this server (repeat for multiple values)
+    Set a property on this server
+    (repeat option to set multiple values)
 
 .. option:: --file <dest-filename=source-filename>
 
-    File to inject into image before boot (repeat for multiple files)
+    File to inject into image before boot
+    (repeat option to set multiple files)
 
 .. option:: --user-data <user-data>
 
@@ -569,8 +571,8 @@ Set server properties
 
 .. option:: --property <key=value>
 
-    Property to add/change for this server (repeat option to set
-    multiple properties)
+    Property to add/change for this server
+    (repeat option to set multiple properties)
 
 .. describe:: <server>
 
@@ -764,7 +766,8 @@ Unset server properties
 
 .. option:: --property <key>
 
-    Property key to remove from server (repeat to remove multiple values)
+    Property key to remove from server
+    (repeat option to remove multiple values)
 
 .. describe:: <server>
 

doc/source/command-objects/subnet-pool.rst

@@ -22,8 +22,8 @@ Create subnet pool
 
 .. option:: --pool-prefix <pool-prefix>
 
-    Set subnet pool prefixes (in CIDR notation).
-    Repeat this option to set multiple prefixes.
+    Set subnet pool prefixes (in CIDR notation)
+    (repeat option to set multiple prefixes)
 
 .. option:: --default-prefix-length <default-prefix-length>
 
@@ -104,8 +104,8 @@ Set subnet pool properties
 
 .. option:: --pool-prefix <pool-prefix>
 
-    Set subnet pool prefixes (in CIDR notation).
-    Repeat this option to set multiple prefixes.
+    Set subnet pool prefixes (in CIDR notation)
+    (repeat option to set multiple prefixes)
 
 .. option:: --default-prefix-length <default-prefix-length>
 

doc/source/command-objects/subnet.rst

@@ -56,7 +56,8 @@ Create new subnet
 .. option:: --allocation-pool start=<ip-address>,end=<ip-address>
 
     Allocation pool IP addresses for this subnet e.g.:
-    ``start=192.168.199.2,end=192.168.199.254`` (This option can be repeated)
+    ``start=192.168.199.2,end=192.168.199.254``
+    (repeat option to add multiple IP addresses)
 
 .. option:: --dhcp
 
@@ -68,7 +69,7 @@ Create new subnet
 
 .. option:: --dns-nameserver <dns-nameserver>
 
-     DNS name server for this subnet (This option can be repeated)
+     DNS server for this subnet (repeat option to set multiple DNS servers)
 
 .. option:: --gateway <gateway>
 
@@ -85,7 +86,7 @@ Create new subnet
      ``destination=10.10.0.0/16,gateway=192.168.71.254``
      destination: destination subnet (in CIDR notation)
      gateway: nexthop IP address
-     (This option can be repeated)
+     (repeat option to add multiple routes)
 
 .. option:: --ip-version {4,6}
 
@@ -162,7 +163,8 @@ Set subnet properties
 .. option:: --allocation-pool start=<ip-address>,end=<ip-address>
 
     Allocation pool IP addresses for this subnet e.g.:
-    ``start=192.168.199.2,end=192.168.199.254`` (This option can be repeated)
+    ``start=192.168.199.2,end=192.168.199.254``
+    (repeat option to add multiple IP addresses)
 
 .. option:: --dhcp
 
@@ -174,7 +176,7 @@ Set subnet properties
 
 .. option:: --dns-nameserver <dns-nameserver>
 
-     DNS name server for this subnet (This option can be repeated)
+     DNS server for this subnet (repeat option to set multiple DNS servers)
 
 .. option:: --gateway <gateway>
 
@@ -189,7 +191,7 @@ Set subnet properties
      ``destination=10.10.0.0/16,gateway=192.168.71.254``
      destination: destination subnet (in CIDR notation)
      gateway: nexthop IP address
-     (This option can be repeated)
+     (repeat option to add multiple routes)
 
 .. option:: --name
 

doc/source/command-objects/trust.rst

@@ -29,7 +29,7 @@ Create new trust
 
 .. option:: --role <role>
 
-    Roles to authorize (name or ID) (repeat to set multiple values) (required)
+    Roles to authorize (name or ID) (repeat option to set multiple values, required)
 
 .. option:: --impersonate
 

openstackclient/compute/v2/server.py

@@ -293,7 +293,7 @@ def get_parser(self, prog_name):
             action='append',
             default=[],
             help=_('Security group to assign to this server (name or ID) '
-                   '(repeat for multiple groups)'),
+                   '(repeat option to set multiple groups)'),
         )
         parser.add_argument(
             '--key-name',
@@ -305,15 +305,15 @@ def get_parser(self, prog_name):
             metavar='<key=value>',
             action=parseractions.KeyValueAction,
             help=_('Set a property on this server '
-                   '(repeat for multiple values)'),
+                   '(repeat option to set multiple values)'),
         )
         parser.add_argument(
             '--file',
             metavar='<dest-filename=source-filename>',
             action='append',
             default=[],
             help=_('File to inject into image before boot '
-                   '(repeat for multiple files)'),
+                   '(repeat option to set multiple files)'),
         )
         parser.add_argument(
             '--user-data',
@@ -1738,7 +1738,7 @@ def get_parser(self, prog_name):
             action='append',
             default=[],
             help=_('Property key to remove from server '
-                   '(repeat to remove multiple values)'),
+                   '(repeat option to remove multiple values)'),
         )
         return parser
 

openstackclient/identity/v3/identity_provider.py

@@ -35,7 +35,7 @@ def get_parser(self, prog_name):
             metavar='<remote-id>',
             action='append',
             help='Remote IDs to associate with the Identity Provider '
-                 '(repeat to provide multiple values)'
+                 '(repeat option to provide multiple values)'
         )
         identity_remote_id_provider.add_argument(
             '--remote-id-file',
@@ -139,7 +139,7 @@ def get_parser(self, prog_name):
             metavar='<remote-id>',
             action='append',
             help='Remote IDs to associate with the Identity Provider '
-                 '(repeat to provide multiple values)'
+                 '(repeat option to provide multiple values)'
         )
         identity_remote_id_provider.add_argument(
             '--remote-id-file',