From: Benno Schulenberg <bensberg@telfort.nl>
Date: Sun, 9 Feb 2025 08:23:25 +0000 (+0100)
Subject: blkpr: grammarize the description of the tool and its options
X-Git-Tag: v2.42-start~51^2~5
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=7722cde3d694cb0b3f51931a96e907a23e9b4da0;p=thirdparty%2Futil-linux.git

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 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)"));