[PATCH 09/14] blkpr: grammarize the description of the tool and its options
Benno Schulenberg <[email protected]>
| Newsgroups | org.kernel.vger.util-linux |
|---|---|
| Message-ID | <[email protected]> |
Signed-off-by: Benno Schulenberg <[email protected]> --- 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