[PATCH 09/14] blkpr: grammarize the description of the tool and its options

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Signed-off-by: Benno Schulenberg <bensberg@xxxxxxxxxx>
---
 sys-utils/blkpr.8.adoc |  9 +++++----
 sys-utils/blkpr.c      | 14 +++++++-------
 2 files changed, 12 insertions(+), 11 deletions(-)

diff --git a/sys-utils/blkpr.8.adoc b/sys-utils/blkpr.8.adoc
index 0f71bd0f0..db2b8a0a9 100644
--- a/sys-utils/blkpr.8.adoc
+++ b/sys-utils/blkpr.8.adoc
@@ -8,7 +8,7 @@
 
 == NAME
 
-blkpr - run persistent reservations command on a device
+blkpr - run a persistent-reservations command on a device
 
 == SYNOPSIS
 
@@ -16,15 +16,16 @@ blkpr - run persistent reservations command on a device
 
 == DESCRIPTION
 
-*blkpr* is used to run persistent reservations command on device that supports Persistent Reservations feature.
+*blkpr* is used to run a persistent-reservations command on a device
+that supports the Persistent Reservations feature.
 
 The _device_ argument is the pathname of the block device.
 
 == OPTIONS
 
 *-c*, *--command* _command_::
-The command of persistent reservations, supported commands are *register*, *reserve*, *release*, *preempt*,
-*preempt-abort*, and *clear*.
+The command for managing persistent reservations. Supported commands are:
+*register*, *reserve*, *release*, *preempt*, *preempt-abort*, and *clear*.
 
 *-k*, *--key* _key_::
 The key the command should operate on.
diff --git a/sys-utils/blkpr.c b/sys-utils/blkpr.c
index 7f88eba50..03ca9f7e5 100644
--- a/sys-utils/blkpr.c
+++ b/sys-utils/blkpr.c
@@ -213,12 +213,12 @@ static void __attribute__((__noreturn__)) usage(void)
 	      _(" %s [options] <device>\n"), program_invocation_short_name);
 
 	fputs(USAGE_SEPARATOR, out);
-	fputs(_("Persistent reservations on a device.\n"), out);
+	fputs(_("Manage persistent reservations on a device.\n"), out);
 
 	fputs(USAGE_OPTIONS, out);
-	fputs(_(" -c, --command <cmd>      command of persistent reservations\n"), out);
-	fputs(_(" -k, --key <num>          key to operate\n"), out);
-	fputs(_(" -K, --oldkey <num>       old key to operate\n"), out);
+	fputs(_(" -c, --command <cmd>      command for persistent reservations\n"), out);
+	fputs(_(" -k, --key <num>          key to operate on\n"), out);
+	fputs(_(" -K, --oldkey <num>       old key to operate on\n"), out);
 	fputs(_(" -f, --flag <flag>        command flag\n"), out);
 	fputs(_(" -t, --type <type>        command type\n"), out);
 
@@ -227,13 +227,13 @@ static void __attribute__((__noreturn__)) usage(void)
 
 	fputs(USAGE_ARGUMENTS, out);
 
-	fputs(_(" <cmd> is an command, available command:\n"), out);
+	fputs(_(" <cmd> is a command; available commands are:\n"), out);
 	print_pr_command(out);
 
-	fputs(_(" <flag> is a command flag, available flags:\n"), out);
+	fputs(_(" <flag> is a command flag; available flags are:\n"), out);
 	print_pr_flag(out);
 
-	fputs(_(" <type> is a command type, available types:\n"), out);
+	fputs(_(" <type> is a command type; available types are:\n"), out);
 	print_pr_type(out);
 
 	fprintf(out, USAGE_MAN_TAIL("blkpr(8)"));
-- 
2.48.1





[Index of Archives]     [Netdev]     [Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux