blkpr: grammarize the description of the tool and its options

Signed-off-by: Benno Schulenberg <bensberg@telfort.nl>

diff --git a/sys-utils/blkpr.8.adoc b/sys-utils/blkpr.8.adoc
index 0f71bd0f0dde0b6915a2a4c214c6ef30dba7a5d0..db2b8a0a96ede6d0bd3d154effb3b4ff32dc2b86 100644 (file)
--- 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 7f88eba50cdc35a6fd5f7faeae242f83b11785a2..03ca9f7e5fd1e97851aa588d306bfdce88ca9a8a 100644 (file)
--- 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)"));