textual: add a docstring to most of the utilities

This adds a concise description of a tool to its usage text.

A first form of this patch was proposed by Steven Honeyman
(see http://www.spinics.net/lists/util-linux-ng/msg09994.html).

Signed-off-by: Benno Schulenberg <bensberg@justemail.net>

diff --git a/disk-utils/addpart.c b/disk-utils/addpart.c
index c0f25a539e26750621d980b06b0d34dc10aebdb0..73fd1ff4e60962c9b2d0709587d151654fcc645c 100644 (file)
--- a/disk-utils/addpart.c
+++ b/disk-utils/addpart.c
@@ -13,6 +13,10 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
        fputs(USAGE_HEADER, out);
        fprintf(out, _(" %s <disk device> <partition number> <start> <length>\n"),
                program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Tell the kernel about the existence of a specified partition.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(USAGE_HELP, out);
        fputs(USAGE_VERSION, out);

diff --git a/disk-utils/cfdisk.c b/disk-utils/cfdisk.c
index 324f56bbf5d881aadbd2058fa56e4363b2e1fb67..60a9535243641c91462661aa1683dac666244469 100644 (file)
--- a/disk-utils/cfdisk.c
+++ b/disk-utils/cfdisk.c
@@ -2163,10 +2163,12 @@ static int ui_run(struct cfdisk *cf)
 static void __attribute__ ((__noreturn__)) usage(FILE *out)
 {
        fputs(USAGE_HEADER, out);
-
        fprintf(out,
              _(" %1$s [options] <disk>\n"), program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Display or manipulate a disk partition table.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -L --color[=<when>]     colorize output (auto, always or never)\n"), out);
        fputs(_(" -z --zero               start with zeroed partition table\n"), out);

diff --git a/disk-utils/delpart.c b/disk-utils/delpart.c
index e940e3bed4d1f2d78dd540d19c883e40e7e7be1a..efa7a70ef5ebaf9777c31426e9a6ae88bba180fb 100644 (file)
--- a/disk-utils/delpart.c
+++ b/disk-utils/delpart.c
@@ -13,6 +13,10 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
        fputs(USAGE_HEADER, out);
        fprintf(out, _(" %s <disk device> <partition number>\n"),
                program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Tell the kernel to forget about a specified partition.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(USAGE_HELP, out);
        fputs(USAGE_VERSION, out);

diff --git a/disk-utils/fdformat.c b/disk-utils/fdformat.c
index c6a98e10fe7098d906f40242b913c7a196274491..ad9a86367842a876edb1703606bec343902396df 100644 (file)
--- a/disk-utils/fdformat.c
+++ b/disk-utils/fdformat.c
@@ -143,6 +143,9 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
        fprintf(out, _(" %s [options] <device>\n"),
                program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Do a low-level formatting of a floppy disk.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -f, --from <N>    start at the track N (default 0)\n"), out);
        fputs(_(" -t, --to <N>      stop at the track N\n"), out);

diff --git a/disk-utils/fdisk.c b/disk-utils/fdisk.c
index cf86281bb6b0a226bbbf5d1c5f43cc398c4a783e..9c3e1033583ba8cd953ff0a1711058dc753e24d9 100644 (file)
--- a/disk-utils/fdisk.c
+++ b/disk-utils/fdisk.c
@@ -636,6 +636,9 @@ static void __attribute__ ((__noreturn__)) usage(FILE *out)
                " %1$s [options] -l [<disk>] list partition table(s)\n"),
               program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Display or manipulate a disk partition table.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -b, --sector-size <size>      physical and logical sector size\n"), out);
        fputs(_(" -c, --compatibility[=<mode>]  mode is 'dos' or 'nondos' (default)\n"), out);

diff --git a/disk-utils/fsck.c b/disk-utils/fsck.c
index a0f9db1d58199b1450097da4ec1bb40f6e0ec567..535184e811b89f560bc4f5e7799e69ffc01a9e01 100644 (file)
--- a/disk-utils/fsck.c
+++ b/disk-utils/fsck.c
@@ -1355,6 +1355,9 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
        fprintf(out, _(" %s [options] -- [fs-options] [<filesystem> ...]\n"),
                         program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Check and repair a Linux filesystem.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -A         check all filesystems\n"), out);
        fputs(_(" -C [<fd>]  display progress bar; file descriptor is for GUIs\n"), out);

diff --git a/disk-utils/fsck.cramfs.c b/disk-utils/fsck.cramfs.c
index 0a1c6f27becf3c46a11d0684a735c26a62cd4196..6b4b69e926de097e2eab7f9c1fe9413e7cd67a60 100644 (file)
--- a/disk-utils/fsck.cramfs.c
+++ b/disk-utils/fsck.cramfs.c
@@ -106,6 +106,10 @@ static void __attribute__((__noreturn__)) usage(int status)
        fputs(USAGE_HEADER, stream);
        fprintf(stream,
                _(" %s [options] <file>\n"), program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, stream);
+       fputs(_("Check and repair a compressed ROM filesystem.\n"), stream);
+
        fputs(USAGE_OPTIONS, stream);
        fputs(_(" -a                       for compatibility only, ignored\n"), stream);
        fputs(_(" -v, --verbose            be more verbose\n"), stream);

diff --git a/disk-utils/fsck.minix.c b/disk-utils/fsck.minix.c
index c0ed0177dbc791d4d65265a0f718983837eb23d5..9d47548848eb43c922969ad62019208b278b11f8 100644 (file)
--- a/disk-utils/fsck.minix.c
+++ b/disk-utils/fsck.minix.c
@@ -193,6 +193,10 @@ usage(void) {
        fputs(USAGE_HEADER, stderr);
        fprintf(stderr,
                _(" %s [options] <device>\n"), program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, stderr);
+       fputs(_("Check the consistency of a Minix filesystem.\n"), stderr);
+
        fputs(USAGE_OPTIONS, stderr);
        fputs(_(" -l  list all filenames\n"), stderr);
        fputs(_(" -a  automatic repair\n"), stderr);

diff --git a/disk-utils/isosize.c b/disk-utils/isosize.c
index 5030a50b109a070268d70e9dd5de291849b7a888..43569ae71058a1ce2f437867690d9895b89952ad 100644 (file)
--- a/disk-utils/isosize.c
+++ b/disk-utils/isosize.c
@@ -169,6 +169,10 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
        fprintf(out,
                _(" %s [options] <iso9660_image_file>\n"),
                program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Show the length of an ISO-9660 filesystem.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -d, --divisor=<number>  divide the amount of bytes by <number>\n"), out);
        fputs(_(" -x, --sectors           show sector count and size\n"), out);

diff --git a/disk-utils/mkfs.bfs.c b/disk-utils/mkfs.bfs.c
index c2c23897286573068c2db833aeaf7f583b62d01f..98e4b050c928e45271662372159bce17ab7ca895 100644 (file)
--- a/disk-utils/mkfs.bfs.c
+++ b/disk-utils/mkfs.bfs.c
@@ -72,6 +72,10 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
        fprintf(out,
                _("Usage: %s [options] device [block-count]\n"),
                program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Make an SCO bfs filesystem.\n"), out);
+
        fprintf(out, _("\nOptions:\n"
                       " -N, --inodes=NUM    specify desired number of inodes\n"
                       " -V, --vname=NAME    specify volume name\n"

diff --git a/disk-utils/mkfs.c b/disk-utils/mkfs.c
index 8ad6065316e2a28804c3609baf6229a9e85f2674..08c4ef0b0b26486eee80ace2a19bee5d0e5c8c52 100644 (file)
--- a/disk-utils/mkfs.c
+++ b/disk-utils/mkfs.c
@@ -47,6 +47,10 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
        fputs(USAGE_HEADER, out);
        fprintf(out, _(" %s [options] [-t <type>] [fs-options] <device> [<size>]\n"),
                     program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Make a Linux filesystem.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fprintf(out, _(" -t, --type=<type>  filesystem type; when unspecified, ext2 is used\n"));
        fprintf(out, _("     fs-options     parameters for the real filesystem builder\n"));

diff --git a/disk-utils/mkswap.c b/disk-utils/mkswap.c
index d34e2fd351fd295f7ce2c42297f90084faea83cf..b22c73fffac1e9efddf850dec699dca75d1ceab7 100644 (file)
--- a/disk-utils/mkswap.c
+++ b/disk-utils/mkswap.c
@@ -149,6 +149,9 @@ static void __attribute__ ((__noreturn__)) usage(FILE *out)
                  " %s [options] device [size]\n"),
                program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Set up a Linux swap area.\n"), out);
+
        fprintf(out, _(
                "\nOptions:\n"
                " -c, --check               check bad blocks before creating the swap area\n"

diff --git a/disk-utils/partx.c b/disk-utils/partx.c
index bf5a4abf7eb8055cea2bea7c83a587c00ca4e0d9..00c263173f815b212ccf74e0dee22d43f323443b 100644 (file)
--- a/disk-utils/partx.c
+++ b/disk-utils/partx.c
@@ -713,6 +713,9 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
              _(" %s [-a|-d|-s|-u] [--nr <n:m> | <partition>] <disk>\n"),
                program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Tell the kernel about the presence and numbering of partitions.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -a, --add            add specified partitions or all of them\n"), out);
        fputs(_(" -d, --delete         delete specified partitions or all of them\n"), out);

diff --git a/disk-utils/raw.c b/disk-utils/raw.c
index 2adbf00bb73efeb9ee8801088733e95f523bc67f..cc6690145e3fe7fd1f3d0226eb1182e6705c92d1 100644 (file)
--- a/disk-utils/raw.c
+++ b/disk-utils/raw.c
@@ -54,6 +54,10 @@ static void __attribute__ ((__noreturn__)) usage(int err)
                  " %1$s -q %2$srawN\n"
                  " %1$s -qa\n"), program_invocation_short_name,
                _PATH_RAWDEVDIR);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Bind a raw character device to a block device.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -q, --query    set query mode\n"), out);
        fputs(_(" -a, --all      query all raw devices\n"), out);

diff --git a/disk-utils/resizepart.c b/disk-utils/resizepart.c
index 765e3a40679570ff91ea1f7efc86a1d83babc400..9a6235b5dc269eeef731eb64230f290629ba87d0 100644 (file)
--- a/disk-utils/resizepart.c
+++ b/disk-utils/resizepart.c
@@ -18,6 +18,10 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
        fputs(USAGE_HEADER, out);
        fprintf(out, _(" %s <disk device> <partition number> <length>\n"),
                program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Tell the kernel about the new size of a partition.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(USAGE_HELP, out);
        fputs(USAGE_VERSION, out);

diff --git a/disk-utils/sfdisk.c b/disk-utils/sfdisk.c
index 73a1331ede2d09ce9e6a2fcd24c97723b8d6d112..499dd8f640d5d1067280b2dcc910c11bedfc4731 100644 (file)
--- a/disk-utils/sfdisk.c
+++ b/disk-utils/sfdisk.c
@@ -1310,6 +1310,9 @@ static void __attribute__ ((__noreturn__)) usage(FILE *out)
              _(" %1$s [options] <dev> [[-N] <part>]\n"
                " %1$s [options] <command>\n"), program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Display or manipulate a disk partition table.\n"), out);
+
        fputs(_("\nCommands:\n"), out);
        fputs(_(" -a, --activate <dev> [<part> ...] list or set bootable MBR partitions\n"), out);
        fputs(_(" -d, --dump <dev>                  dump partition table (usable for later input)\n"), out);

diff --git a/disk-utils/swaplabel.c b/disk-utils/swaplabel.c
index a7498a4f178954a5c81c112e0bd8e925f3e37d70..89be2aed6777c785a02f1f583fb43917a07cae53 100644 (file)
--- a/disk-utils/swaplabel.c
+++ b/disk-utils/swaplabel.c
@@ -116,6 +116,10 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
        fputs(USAGE_HEADER, out);
        fprintf(out, _(" %s [options] <device>\n"),
                program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Display or change the label or UUID of a swap area.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -L, --label <label> specify a new label\n"
                " -U, --uuid <uuid>   specify a new uuid\n"), out);

diff --git a/login-utils/chfn.c b/login-utils/chfn.c
index 2f1b70dc773c595d82e82158920126b8cb887278..ac0a3cbde29585049b6d48fab1fcf923c53bcb5f 100644 (file)
--- a/login-utils/chfn.c
+++ b/login-utils/chfn.c
@@ -89,6 +89,10 @@ static void __attribute__((__noreturn__)) usage(FILE *fp)
 {
        fputs(USAGE_HEADER, fp);
        fprintf(fp, _(" %s [options] [<username>]\n"), program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, fp);
+       fputs(_("Change your finger information.\n"), fp);
+
        fputs(USAGE_OPTIONS, fp);
        fputs(_(" -f, --full-name <full-name>  real name\n"), fp);
        fputs(_(" -o, --office <office>        office number\n"), fp);

diff --git a/login-utils/chsh.c b/login-utils/chsh.c
index 51f575d655687eac9f6ea125fa1ed37a5cd27407..f4455d7e2cc31a5dd6521f724eca150e9fe20afc 100644 (file)
--- a/login-utils/chsh.c
+++ b/login-utils/chsh.c
@@ -68,6 +68,10 @@ static void __attribute__((__noreturn__)) usage (FILE *fp)
 {
        fputs(USAGE_HEADER, fp);
        fprintf(fp, _(" %s [options] [<username>]\n"), program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, fp);
+       fputs(_("Change your login shell.\n"), fp);
+
        fputs(USAGE_OPTIONS, fp);
        fputs(_(" -s, --shell <shell>  specify login shell\n"), fp);
        fputs(_(" -l, --list-shells    print list of shells and exit\n"), fp);

diff --git a/login-utils/last.c b/login-utils/last.c
index bf2c2da3297d3e5e5adf3e8792b524167bdde13b..e646cabf59615c26f4bd00fde1ddf9683c85c97f 100644 (file)
--- a/login-utils/last.c
+++ b/login-utils/last.c
@@ -555,6 +555,9 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
        fprintf(out, _(
                " %s [options] [<username>...] [<tty>...]\n"), program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Show a listing of last logged in users.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -<number>            how many lines to show\n"), out);
        fputs(_(" -a, --hostlast       display hostnames in the last column\n"), out);

diff --git a/login-utils/login.c b/login-utils/login.c
index f07358fae6eb3888549387a8cfed03c10ccc6674..8772068c7ea5aee3154d2c2d3fe663bcfc16881f 100644 (file)
--- a/login-utils/login.c
+++ b/login-utils/login.c
@@ -1190,6 +1190,8 @@ int main(int argc, char **argv)
                case '?':
                default:
                        fprintf(stderr, _("Usage: login [-p] [-h <host>] [-H] [[-f] <username>]\n"));
+                       fputs(USAGE_SEPARATOR, stderr);
+                       fputs(_("Begin a session on the system.\n"), stderr);
                        exit(EXIT_FAILURE);
                }
        argc -= optind;

diff --git a/login-utils/lslogins.c b/login-utils/lslogins.c
index 0e99529a98f77a0669ba94d5e3a21d6a9cfc5420..ef7096aec8b7a7f531cd9d8d12f918c78805c545 100644 (file)
--- a/login-utils/lslogins.c
+++ b/login-utils/lslogins.c
@@ -1204,6 +1204,9 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
        fputs(USAGE_HEADER, out);
        fprintf(out, _(" %s [options]\n"), program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Display information about known users in the system.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -a, --acc-expiration     display info about passwords expiration\n"), out);
        fputs(_(" -c, --colon-separate     display data in a format similar to /etc/passwd\n"), out);

diff --git a/login-utils/newgrp.c b/login-utils/newgrp.c
index b1134e941c922dd5a0b5ae48e98a6d6f6b4b613c..e674a4feb4f25b472919800004e3708febcf8619 100644 (file)
--- a/login-utils/newgrp.c
+++ b/login-utils/newgrp.c
@@ -164,6 +164,10 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
 {
        fprintf(out, USAGE_HEADER);
        fprintf(out, _(" %s <group>\n"), program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Log in to a new group.\n"), out);
+
        fprintf(out, USAGE_OPTIONS);
        fprintf(out, USAGE_HELP);
        fprintf(out, USAGE_VERSION);

diff --git a/login-utils/nologin.c b/login-utils/nologin.c
index a4fb82db620a6cd036bebf8d1435218cb65e9dac..3be50ca1219a3da48c4cb18dded9a72162284552 100644 (file)
--- a/login-utils/nologin.c
+++ b/login-utils/nologin.c
@@ -21,10 +21,12 @@
 static void __attribute__((__noreturn__)) usage(FILE *out)
 {
        fputs(USAGE_HEADER, out);
-
        fprintf(out,
                _(" %s [options]\n"), program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Politely refuse a login.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(USAGE_HELP, out);
        fputs(USAGE_VERSION, out);

diff --git a/login-utils/sulogin.c b/login-utils/sulogin.c
index f0e88a411dbd76390cb15df38c4d79aa9e7ede8c..f4d68c4888cc0d17e0bd6c8e2d491c8207034f63 100644 (file)
--- a/login-utils/sulogin.c
+++ b/login-utils/sulogin.c
@@ -821,6 +821,9 @@ static void usage(FILE *out)
        fprintf(out, _(
                " %s [options] [tty device]\n"), program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Single-user login.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -p, --login-shell        start a login shell\n"
                " -t, --timeout <seconds>  max time to wait for a password (default: no limit)\n"

diff --git a/login-utils/utmpdump.c b/login-utils/utmpdump.c
index e1fefc63e4bfc54eeb54b4182923f9e17b145aae..79bdf33a824175ee203a299c544ae18d8c168647 100644 (file)
--- a/login-utils/utmpdump.c
+++ b/login-utils/utmpdump.c
@@ -297,6 +297,9 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
        fprintf(out,
                _(" %s [options] [filename]\n"), program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Dump UTMP and WTMP files in raw format.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -f, --follow         output appended data as the file grows\n"), out);
        fputs(_(" -r, --reverse        write back dumped data into utmp file\n"), out);

diff --git a/login-utils/vipw.c b/login-utils/vipw.c
index ca90f65fc4516b708dddce51aeb3e8cfa9819d35..668f4d8c4a4651b743e17bb776f70e70d998131c 100644 (file)
--- a/login-utils/vipw.c
+++ b/login-utils/vipw.c
@@ -297,6 +297,10 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
 {
        fputs(USAGE_HEADER, out);
        fprintf(out, " %s\n", program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Edit the password or group file.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(USAGE_HELP, out);
        fputs(USAGE_VERSION, out);

diff --git a/misc-utils/findfs.c b/misc-utils/findfs.c
index 59f9ce072032900402536d1d28a599046339104b..e260541a8bcccba90ddf13754e4fa646ce0dc1df 100644 (file)
--- a/misc-utils/findfs.c
+++ b/misc-utils/findfs.c
@@ -27,6 +27,10 @@ static void __attribute__((__noreturn__)) usage(int rc)
        fputs(USAGE_HEADER, out);
        fprintf(out, _(" %s [options] {LABEL,UUID,PARTUUID,PARTLABEL}=<value>\n"),
                program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Find a filesystem by label or UUID.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(USAGE_HELP, out);
        fputs(USAGE_VERSION, out);

diff --git a/misc-utils/findmnt.c b/misc-utils/findmnt.c
index 75099d94dbc70e2f2409a76fe9a007e02ea5e2e3..153ea453a76163684ecb7392e71c46d7c8c114af 100644 (file)
--- a/misc-utils/findmnt.c
+++ b/misc-utils/findmnt.c
@@ -1176,6 +1176,9 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
        " %1$s [options] [--source <device>] [--target <mountpoint>]\n"),
                program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Find a (mounted) filesystem.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -s, --fstab            search in static table of filesystems\n"), out);
        fputs(_(" -m, --mtab             search in table of mounted filesystems\n"), out);

diff --git a/misc-utils/getopt.c b/misc-utils/getopt.c
index 85cac32a1e60a6a6c6a0adfc90748e952bb4c931..c166fd756e091edbc2809adee0689b821e6dd448 100644 (file)
--- a/misc-utils/getopt.c
+++ b/misc-utils/getopt.c
@@ -319,6 +319,9 @@ static void __attribute__ ((__noreturn__)) print_help(void)
                " %1$s [options] -o|--options <optstring> [options] [--] <parameters>\n"),
                program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, stderr);
+       fputs(_("Parse command options.\n"), stderr);
+
        fputs(USAGE_OPTIONS, stderr);
        fputs(_(" -a, --alternative             allow long options starting with single -\n"), stderr);
        fputs(_(" -l, --longoptions <longopts>  the long options to be recognized\n"), stderr);

diff --git a/misc-utils/kill.c b/misc-utils/kill.c
index f8cb7dd47aa9876b3aaf8b8861e61c10beb8a052..01730dbc5328598b0f1d643479db7165ca227e3a 100644 (file)
--- a/misc-utils/kill.c
+++ b/misc-utils/kill.c
@@ -305,6 +305,9 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
        fputs(USAGE_HEADER, out);
        fprintf(out, _(" %s [options] <pid>|<name>...\n"), program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Forcibly terminate a process.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -a, --all              do not restrict the name-to-pid conversion to processes\n"
                "                          with the same uid as the present process\n"), out);

diff --git a/misc-utils/logger.c b/misc-utils/logger.c
index 2994dc0e371cdaca56fb6620b5399809c2ab1630..35caf9d9d7c812aff8cfd213f7c0188b8779a88f 100644 (file)
--- a/misc-utils/logger.c
+++ b/misc-utils/logger.c
@@ -510,6 +510,9 @@ static void __attribute__ ((__noreturn__)) usage(FILE *out)
        fputs(USAGE_HEADER, out);
        fprintf(out, _(" %s [options] [<message>]\n"), program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Enter messages into the system log.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -i, --id[=<id>]       log <id> (default is PID)\n"), out);
        fputs(_(" -f, --file <file>     log the contents of this file\n"), out);

diff --git a/misc-utils/look.c b/misc-utils/look.c
index 51938f20b025b303b4c484d705852d127918c87d..50bc4f47d1752675c6da4757ff8d78d32ecf03e6 100644 (file)
--- a/misc-utils/look.c
+++ b/misc-utils/look.c
@@ -366,6 +366,10 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
        fputs(USAGE_HEADER, out);
        fprintf(out,
              _(" %s [options] string [file]\n"), program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Display lines beginning with a specified string.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -a, --alternative      use alternative dictionary\n"
                " -d, --alphanum         compare only alphanumeric characters\n"

diff --git a/misc-utils/lsblk.c b/misc-utils/lsblk.c
index e29901ff257ba783bff37fa95fadd1e123b18b75..8a38b9e99650bab848968028d18cc2905aed94a7 100644 (file)
--- a/misc-utils/lsblk.c
+++ b/misc-utils/lsblk.c
@@ -1523,6 +1523,10 @@ static void __attribute__((__noreturn__)) help(FILE *out)
 
        fputs(USAGE_HEADER, out);
        fprintf(out, _(" %s [options] [<device> ...]\n"), program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("List information about block devices.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -a, --all            print all devices\n"), out);
        fputs(_(" -b, --bytes          print SIZE in bytes rather than in human readable format\n"), out);

diff --git a/misc-utils/lslocks.c b/misc-utils/lslocks.c
index 83d7b903388a7a4a5bed040e062eef6dcf3bf2f7..045186a14a80de59de2d455c15d0b7c513bd64dd 100644 (file)
--- a/misc-utils/lslocks.c
+++ b/misc-utils/lslocks.c
@@ -506,6 +506,9 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
        fprintf(out,
                _(" %s [options]\n"), program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("List local system locks.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -p, --pid <pid>        process id\n"
                " -o, --output <list>    define which output columns to use\n"

diff --git a/misc-utils/mcookie.c b/misc-utils/mcookie.c
index c370c2ae8089d4a847d1f988f9727664cb2354d7..ee8ec38ba71421cd22947509cb26c9dbac8e7014 100644 (file)
--- a/misc-utils/mcookie.c
+++ b/misc-utils/mcookie.c
@@ -81,6 +81,9 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
        fputs(USAGE_HEADER, out);
        fprintf(out, _(" %s [options]\n"), program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Generate magic cookies for xauth.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -f, --file <file>     use file as a cookie seed\n"), out);
        fputs(_(" -m, --max-size <num>  limit how much is read from seed files\n"), out);

diff --git a/misc-utils/namei.c b/misc-utils/namei.c
index ff58c9b4fa9ff1ea96ba0f603fafcd8db41ef15f..3af0380d16882947c5b5aa3ac9d770bf2f4404d6 100644 (file)
--- a/misc-utils/namei.c
+++ b/misc-utils/namei.c
@@ -427,6 +427,10 @@ static void usage(int rc)
        fputs(USAGE_HEADER, out);
        fprintf(out,
              _(" %s [options] <pathname>...\n"), p);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Follow a pathname until a terminal point is found.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -h, --help          displays this help text\n"
                " -V, --version       output version information and exit\n"

diff --git a/misc-utils/rename.c b/misc-utils/rename.c
index 1bb23cd6326c1378bdbadccd1574d02abae51186..5ecf86c443cf88afb403b67de4be77e7c36eccf3 100644 (file)
--- a/misc-utils/rename.c
+++ b/misc-utils/rename.c
@@ -116,6 +116,10 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
        fprintf(out,
              _(" %s [options] <expression> <replacement> <file>...\n"),
                program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Rename files.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -v, --verbose    explain what is being done\n"), out);
        fputs(_(" -s, --symlink    act on the target of symlinks\n"), out);

diff --git a/misc-utils/uuidd.c b/misc-utils/uuidd.c
index 55aac3534d3a6104c5f0553dfe6785e95d622bc8..1cbdeef20f0939d8f10f13a86a9769a2f258e4a1 100644 (file)
--- a/misc-utils/uuidd.c
+++ b/misc-utils/uuidd.c
@@ -72,6 +72,9 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
        fprintf(out,
              _(" %s [options]\n"), program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("A daemon for generating UUIDs.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -p, --pid <path>        path to pid file\n"
                " -s, --socket <path>     path to socket\n"

diff --git a/misc-utils/uuidgen.c b/misc-utils/uuidgen.c
index 48c6562fd499eb802b035de4dd3769e41f52d1b0..54c5773aa7e206d3f66b1bfec4e42f3dad50c9a6 100644 (file)
--- a/misc-utils/uuidgen.c
+++ b/misc-utils/uuidgen.c
@@ -32,6 +32,9 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
        fprintf(out,
              _(" %s [options]\n"), program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Create a new UUID value.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -r, --random     generate random-based uuid\n"
                " -t, --time       generate time-based uuid\n"

diff --git a/misc-utils/whereis.c b/misc-utils/whereis.c
index 5ae6de1e5928ceb4680bd12c3ab65b7a986812d4..da809a1582b4ceff0549c58be2dfee362dc71857 100644 (file)
--- a/misc-utils/whereis.c
+++ b/misc-utils/whereis.c
@@ -187,6 +187,9 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
        fputs(USAGE_HEADER, out);
        fprintf(out, _(" %s [options] <file>\n"), program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Locate the binary, source, and manual-page files for a command.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -b         search only for binaries\n"), out);
        fputs(_(" -B <dirs>  define binaries lookup path\n"), out);

diff --git a/misc-utils/wipefs.c b/misc-utils/wipefs.c
index 70c3f238b310491877e95438e96366c656b089aa..0daa87ae9445fbfc0b74d25899834b3fb4e4d579 100644 (file)
--- a/misc-utils/wipefs.c
+++ b/misc-utils/wipefs.c
@@ -451,6 +451,10 @@ usage(FILE *out)
        fputs(USAGE_HEADER, out);
        fprintf(out,
              _(" %s [options] <device>\n"), program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Wipe signatures from a device.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -a, --all           wipe all magic strings (BE CAREFUL!)\n"
                " -b, --backup        create a signature backup in $HOME\n"

diff --git a/schedutils/chrt.c b/schedutils/chrt.c
index 7988b2a0385034579e20489becc6403b3699c124..fe4c179cbded4a6bee4e5aa13ccb43c8a221b481 100644 (file)
--- a/schedutils/chrt.c
+++ b/schedutils/chrt.c
@@ -57,8 +57,8 @@ static void __attribute__((__noreturn__)) show_usage(int rc)
 {
        FILE *out = rc == EXIT_SUCCESS ? stdout : stderr;
 
+       fputs(_("Show or change the real-time scheduling attributes of a process.\n"), out);
        fprintf(out, _(
-       "\nchrt - manipulate real-time attributes of a process\n"
        "\nSet policy:\n"
        "  chrt [options] [<policy>] <priority> [-p <pid> | <command> [<arg>...]]\n"
        "\nGet policy:\n"

diff --git a/schedutils/ionice.c b/schedutils/ionice.c
index fa43e4874c8e43e0b25a7c103a2ed12f69e3d86c..fb5d04a8b04f603f2b13a07dfc9097e73f68f74b 100644 (file)
--- a/schedutils/ionice.c
+++ b/schedutils/ionice.c
@@ -108,6 +108,9 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
                        " %1$s [options] -u <uid>...\n"
                        " %1$s [options] <command>\n"), program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Show or change the I/O-scheduling class and priority of a process.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -c, --class <class>    name or number of scheduling class,\n"
                "                          0: none, 1: realtime, 2: best-effort, 3: idle\n"), out);

diff --git a/schedutils/taskset.c b/schedutils/taskset.c
index 1bf1291cdd0742b8d0752b2394f05ba3be85cec4..d6b21e45c0397d9c834a976ca6e771331b2e5cb1 100644 (file)
--- a/schedutils/taskset.c
+++ b/schedutils/taskset.c
@@ -51,6 +51,10 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
                _("Usage: %s [options] [mask | cpu-list] [pid|cmd [args...]]\n\n"),
                program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Show or change the CPU affinity of a process.\n"), out);
+       fputs(USAGE_SEPARATOR, out);
+
        fprintf(out, _(
                "Options:\n"
                " -a, --all-tasks         operate on all the tasks (threads) for a given pid\n"

diff --git a/sys-utils/blkdiscard.c b/sys-utils/blkdiscard.c
index 6075d868457532dd6cd77045e98f9f9402e1a02d..e33f9b9d6fc4f621428fcd73e75486d58f79f70c 100644 (file)
--- a/sys-utils/blkdiscard.c
+++ b/sys-utils/blkdiscard.c
@@ -61,6 +61,10 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
        fputs(USAGE_HEADER, out);
        fprintf(out,
              _(" %s [options] <device>\n"), program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Discard the content of sectors on a device.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -o, --offset <num>  offset in bytes to discard from\n"
                " -l, --length <num>  length of bytes to discard from the offset\n"

diff --git a/sys-utils/chcpu.c b/sys-utils/chcpu.c
index aba9d6bc84726f3c1df9cadaf64d25fc15c97baf..428fdc2710ed5784a0d78ae75e6778996a822b00 100644 (file)
--- a/sys-utils/chcpu.c
+++ b/sys-utils/chcpu.c
@@ -238,6 +238,9 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
                "\nUsage:\n"
                " %s [options]\n"), program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Configure CPUs in a multi-processor system.\n"), out);
+
        puts(_( "\nOptions:\n"
                "  -h, --help                    print this help\n"
                "  -e, --enable <cpu-list>       enable cpus\n"

diff --git a/sys-utils/ctrlaltdel.c b/sys-utils/ctrlaltdel.c
index 863632fc3c79838b2e93e164c99c410646242c28..8f646e5ac6df9a6cd6a405d20446dd9f65724d19 100644 (file)
--- a/sys-utils/ctrlaltdel.c
+++ b/sys-utils/ctrlaltdel.c
@@ -19,6 +19,10 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
 {
        fprintf(out, USAGE_HEADER);
        fprintf(out, _(" %s hard|soft\n"), program_invocation_short_name);
+
+       fprintf(out, USAGE_SEPARATOR);
+       fprintf(out, "Set the function of the Ctrl-Alt-Del combination.\n");
+
        fprintf(out, USAGE_OPTIONS);
        fprintf(out, USAGE_HELP);
        fprintf(out, USAGE_VERSION);

diff --git a/sys-utils/dmesg.c b/sys-utils/dmesg.c
index c6152d49ad90127e1ab2963497c666dd80ead1e1..267e546d6fc2a264f0af45f0b80349efdab99a44 100644 (file)
--- a/sys-utils/dmesg.c
+++ b/sys-utils/dmesg.c
@@ -261,6 +261,10 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
 
        fputs(USAGE_HEADER, out);
        fprintf(out, _(" %s [options]\n"), program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Display or control the kernel ring buffer.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -C, --clear                 clear the kernel ring buffer\n"), out);
        fputs(_(" -c, --read-clear            read and clear all messages\n"), out);

diff --git a/sys-utils/eject.c b/sys-utils/eject.c
index a816b208f433e4f7e16b780f71606708af9c7667..2114780a38b693185208951c779a3d79b7507a4d 100644 (file)
--- a/sys-utils/eject.c
+++ b/sys-utils/eject.c
@@ -130,10 +130,12 @@ static inline void info(const char *fmt, ...)
 static void __attribute__ ((__noreturn__)) usage(FILE * out)
 {
        fputs(USAGE_HEADER, out);
-
        fprintf(out,
                _(" %s [options] [<device>|<mountpoint>]\n"), program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Eject removable media.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -a, --auto <on|off>         turn auto-eject feature on or off\n"
                " -c, --changerslot <slot>    switch discs on a CD-ROM changer\n"

diff --git a/sys-utils/fallocate.c b/sys-utils/fallocate.c
index 0e06524b8c5837a63230dc047233c657c50c1d7c..0e4eb4971c42b77b25200fe5dab59396b061b82a 100644 (file)
--- a/sys-utils/fallocate.c
+++ b/sys-utils/fallocate.c
@@ -76,8 +76,11 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
        fputs(USAGE_HEADER, out);
        fprintf(out,
              _(" %s [options] <filename>\n"), program_invocation_short_name);
-       fputs(USAGE_OPTIONS, out);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Preallocate space to, or deallocate space from a file.\n"), out);
+
+       fputs(USAGE_OPTIONS, out);
        fputs(_(" -c, --collapse-range remove a range from the file\n"), out);
        fputs(_(" -d, --dig-holes      detect zeroes and replace with holes\n"), out);
        fputs(_(" -l, --length <num>   length for range operations, in bytes\n"), out);

diff --git a/sys-utils/flock.c b/sys-utils/flock.c
index 2550a5be7504ee699e05e68f4a6b3eadc715fa4d..38281551b184e1788acf8724978264b3598aaa26 100644 (file)
--- a/sys-utils/flock.c
+++ b/sys-utils/flock.c
@@ -53,6 +53,10 @@ static void __attribute__((__noreturn__)) usage(int ex)
                  " %1$s [options] <file>|<directory> -c <command>\n"
                  " %1$s [options] <file descriptor number>\n"),
                program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, stderr);
+       fputs(_("Manage file locks from shell scripts.\n"), stderr);
+
        fputs(USAGE_OPTIONS, stderr);
        fputs(_(  " -s, --shared             get a shared lock\n"), stderr);
        fputs(_(  " -x, --exclusive          get an exclusive lock (default)\n"), stderr);

diff --git a/sys-utils/fsfreeze.c b/sys-utils/fsfreeze.c
index 961f8c1f9973c668e700c266dc998ec2e292264b..d8b0a684cd0cbb2087ff34a38862b0f9156f3ee1 100644 (file)
--- a/sys-utils/fsfreeze.c
+++ b/sys-utils/fsfreeze.c
@@ -48,6 +48,10 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
        fprintf(out, USAGE_HEADER);
        fprintf(out,
              _(" %s [options] <mountpoint>\n"), program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Suspend access to a filesystem (ext3/4, ReiserFS, JFS, XFS).\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -f, --freeze      freeze the filesystem\n"), out);
        fputs(_(" -u, --unfreeze    unfreeze the filesystem\n"), out);

diff --git a/sys-utils/fstrim.c b/sys-utils/fstrim.c
index b18cdb263c57686d921d04891814481cc971a0a3..fca74825fc140d9617eb19c5c668be16682796eb 100644 (file)
--- a/sys-utils/fstrim.c
+++ b/sys-utils/fstrim.c
@@ -228,6 +228,10 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
        fputs(USAGE_HEADER, out);
        fprintf(out,
              _(" %s [options] <mount point>\n"), program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Discard unused blocks on a mounted filesystem.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -a, --all           trim all mounted filesystems that are supported\n"), out);
        fputs(_(" -o, --offset <num>  the offset in bytes to start discarding from\n"), out);

diff --git a/sys-utils/hwclock.c b/sys-utils/hwclock.c
index 008b20abedce2ea6b7401d28963db50b7cd36f98..c236b03bf39a41ceb41e6c8551d2bc267d39a0b3 100644 (file)
--- a/sys-utils/hwclock.c
+++ b/sys-utils/hwclock.c
@@ -1566,6 +1566,9 @@ static void usage(const char *fmt, ...)
        fputs(USAGE_HEADER, usageto);
        fputs(_(" hwclock [function] [option...]\n"), usageto);
 
+       fputs(USAGE_SEPARATOR, usageto);
+       fputs(_("Query or set the hardware clock.\n"), usageto);
+
        fputs(_("\nFunctions:\n"), usageto);
        fputs(_(" -h, --help           show this help text and exit\n"
                " -r, --show           read hardware clock and print result\n"

diff --git a/sys-utils/ipcmk.c b/sys-utils/ipcmk.c
index 3ff021e9430d815a2ae457a5b7c54af7f6023e0c..eae49354680d83bc1e8cb7dd81ac59653fa65caf 100644 (file)
--- a/sys-utils/ipcmk.c
+++ b/sys-utils/ipcmk.c
@@ -64,8 +64,11 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
 {
        fprintf(out, USAGE_HEADER);
        fprintf(out, _(" %s [options]\n"), program_invocation_short_name);
-       fprintf(out, USAGE_OPTIONS);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Create various IPC resources.\n"), out);
+
+       fputs(USAGE_OPTIONS, out);
        fputs(_(" -M, --shmem <size>       create shared memory segment of size <size>\n"), out);
        fputs(_(" -S, --semaphore <nsems>  create semaphore array with <nsems> elements\n"), out);
        fputs(_(" -Q, --queue              create message queue\n"), out);

diff --git a/sys-utils/ipcrm.c b/sys-utils/ipcrm.c
index 5fe3df849f27b7dbe2185821906b325a030d6f03..6702631997b383a64283de95ef0553433eb4fe86 100644 (file)
--- a/sys-utils/ipcrm.c
+++ b/sys-utils/ipcrm.c
@@ -49,7 +49,11 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
        fprintf(out, USAGE_HEADER);
        fprintf(out, " %s [options]\n", program_invocation_short_name);
        fprintf(out, " %s shm|msg|sem <id>...\n", program_invocation_short_name);
-       fprintf(out, USAGE_OPTIONS);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Remove certain IPC resources.\n"), out);
+
+       fputs(USAGE_OPTIONS, out);
        fputs(_(" -m, --shmem-id <id>        remove shared memory segment by id\n"), out);
        fputs(_(" -M, --shmem-key <key>      remove shared memory segment by key\n"), out);
        fputs(_(" -q, --queue-id <id>        remove message queue by id\n"), out);

diff --git a/sys-utils/ipcs.c b/sys-utils/ipcs.c
index a2d7f12ad4f08d1f2f827eee2bc3db768f06f009..3bfba0a7b7320f6d8f1594c8c51890eb86edead8 100644 (file)
--- a/sys-utils/ipcs.c
+++ b/sys-utils/ipcs.c
@@ -52,7 +52,11 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
        fprintf(out, USAGE_HEADER);
        fprintf(out, " %s [resource ...] [output-format]\n", program_invocation_short_name);
        fprintf(out, " %s [resource] -i <id>\n", program_invocation_short_name);
-       fprintf(out, USAGE_OPTIONS);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Show information on IPC facilities.\n"), out);
+
+       fputs(USAGE_OPTIONS, out);
        fputs(_(" -i, --id <id>  print details on resource identified by <id>\n"), out);
        fprintf(out, USAGE_HELP);
        fprintf(out, USAGE_VERSION);

diff --git a/sys-utils/ldattach.c b/sys-utils/ldattach.c
index 853a3ede751e2f225a984b003742caabb2d3feaf..33c7aa289e5c32f9e626aac3992cba4515ce14b9 100644 (file)
--- a/sys-utils/ldattach.c
+++ b/sys-utils/ldattach.c
@@ -193,8 +193,11 @@ static void __attribute__ ((__noreturn__)) usage(int exitcode)
 
        fputs(USAGE_HEADER, out);
        fprintf(out, _(" %s [options] <ldisc> <device>\n"), program_invocation_short_name);
-       fputs(USAGE_OPTIONS, out);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Attach a line discipline to a serial line.\n"), out);
+
+       fputs(USAGE_OPTIONS, out);
        fputs(_(" -d, --debug             print verbose messages to stderr\n"), out);
        fputs(_(" -s, --speed <value>     set serial line speed\n"), out);
        fputs(_(" -c, --intro-command <string> intro sent before ldattach\n"), out);

diff --git a/sys-utils/losetup.c b/sys-utils/losetup.c
index 95e99bb8c6eb73c7da8a8d491663afedf3804e00..29084eab21f0a8ba0418ae56ad54bb1860716a74 100644 (file)
--- a/sys-utils/losetup.c
+++ b/sys-utils/losetup.c
@@ -368,6 +368,9 @@ static void usage(FILE *out)
                " %1$s [options] -f | <loopdev> <file>\n"),
                program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Set up and control loop devices.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -a, --all                     list all used devices\n"), out);
        fputs(_(" -d, --detach <loopdev>...     detach one or more devices\n"), out);

diff --git a/sys-utils/lscpu.c b/sys-utils/lscpu.c
index 2a5032517f1d18130db8a2b972ff40f3ba4b9a05..9b3adbcd589cf649762931cb49a32d92d432fccc 100644 (file)
--- a/sys-utils/lscpu.c
+++ b/sys-utils/lscpu.c
@@ -1629,6 +1629,9 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
        fputs(USAGE_HEADER, out);
        fprintf(out, _(" %s [options]\n"), program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Display information about the CPU architecture.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -a, --all               print both online and offline CPUs (default for -e)\n"), out);
        fputs(_(" -b, --online            print online CPUs only (default for -p)\n"), out);

diff --git a/sys-utils/mount.c b/sys-utils/mount.c
index 14a5e5c798f1bcafb54e3dcc6f4570f77ad996cd..141098548dc7f687cb9f9d32c5cd53367d6c16d9 100644 (file)
--- a/sys-utils/mount.c
+++ b/sys-utils/mount.c
@@ -718,6 +718,9 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
                " %1$s <operation> <mountpoint> [<target>]\n"),
                program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Mount a filesystem.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fprintf(out, _(
        " -a, --all               mount all filesystems mentioned in fstab\n"

diff --git a/sys-utils/mountpoint.c b/sys-utils/mountpoint.c
index 0aaa290fea5e8c9f154bb2f31b1c588c4bd1a0ca..a43bfd6dd1e60a32aa219ca257c914511d4c6c9c 100644 (file)
--- a/sys-utils/mountpoint.c
+++ b/sys-utils/mountpoint.c
@@ -118,6 +118,9 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
              _(" %1$s [-qd] /path/to/directory\n"
                " %1$s -x /dev/device\n"), program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Check whether a directory or file is a mountpoint.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -q, --quiet        quiet mode - don't print anything\n"
                " -d, --fs-devno     print maj:min device number of the filesystem\n"

diff --git a/sys-utils/nsenter.c b/sys-utils/nsenter.c
index c54d63f9d5e64f6dd821d183ade6dd30366d33d0..e00a3e47273b9db4dc6d7e3e694e125a1f018faf 100644 (file)
--- a/sys-utils/nsenter.c
+++ b/sys-utils/nsenter.c
@@ -65,6 +65,9 @@ static void usage(int status)
        fprintf(out, _(" %s [options] <program> [<argument>...]\n"),
                program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Run a program with namespaces of other processes.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -t, --target <pid>     target process to get namespaces from\n"), out);
        fputs(_(" -m, --mount[=<file>]   enter mount namespace\n"), out);

diff --git a/sys-utils/pivot_root.c b/sys-utils/pivot_root.c
index 31ceabb787c69b743b6081e34b48cdcffe98d5ef..a7b28bf09e9ead318056de0e7ac56b5b6fa95ccf 100644 (file)
--- a/sys-utils/pivot_root.c
+++ b/sys-utils/pivot_root.c
@@ -32,6 +32,10 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
        fprintf(out, USAGE_HEADER);
        fprintf(out, _(" %s [options] new_root put_old\n"),
                program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Change the root filesystem.\n"), out);
+
        fprintf(out, USAGE_OPTIONS);
        fprintf(out, USAGE_HELP);
        fprintf(out, USAGE_VERSION);

diff --git a/sys-utils/prlimit.c b/sys-utils/prlimit.c
index 8d0a1100b4d46354978ac69e3c0e646a39abe4d3..ddab76e23025c7aeb1617804aaec95818fff174e 100644 (file)
--- a/sys-utils/prlimit.c
+++ b/sys-utils/prlimit.c
@@ -162,6 +162,9 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
        fprintf(out,
                _(" %s [options] COMMAND\n"), program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Show or change the resource limits of a process.\n"), out);
+
        fputs(_("\nGeneral Options:\n"), out);
        fputs(_(" -p, --pid <pid>        process id\n"
                " -o, --output <list>    define which output columns to use\n"

diff --git a/sys-utils/readprofile.c b/sys-utils/readprofile.c
index 79de7c2e24c6976a2948dc03c801a550a6792cd0..eb6b8ec88ca0b879cfb7abc50f00efa25f52afb1 100644 (file)
--- a/sys-utils/readprofile.c
+++ b/sys-utils/readprofile.c
@@ -102,8 +102,11 @@ static void __attribute__ ((__noreturn__))
 {
        fputs(USAGE_HEADER, out);
        fprintf(out, _(" %s [options]\n"), program_invocation_short_name);
-       fputs(USAGE_OPTIONS, out);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Display kernel profiling information.\n"), out);
+
+       fputs(USAGE_OPTIONS, out);
        fprintf(out,
              _(" -m, --mapfile <mapfile>   (defaults: \"%s\" and\n"), defaultmap);
        fprintf(out,

diff --git a/sys-utils/renice.c b/sys-utils/renice.c
index c96e39ad1f9fdc8d5881525fbec9b0baf99a1780..656a111dad42e09f5a4eb8689e2a043a07dc6f5e 100644 (file)
--- a/sys-utils/renice.c
+++ b/sys-utils/renice.c
@@ -62,6 +62,10 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
                " %1$s [-n] <priority>  -g|--pgrp <pgid>...\n"
                " %1$s [-n] <priority>  -u|--user <user>...\n"),
                program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Alter the priority of running processes.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -n, --priority <num>   specify the nice increment value\n"), out);
        fputs(_(" -p, --pid <id>         interpret argument as process ID (default)\n"), out);

diff --git a/sys-utils/rtcwake.c b/sys-utils/rtcwake.c
index e1cd41d3a174409b184e5741cbbc14d2f18e142c..35ca7e893831b1c056e70a555a9c3c452258153f 100644 (file)
--- a/sys-utils/rtcwake.c
+++ b/sys-utils/rtcwake.c
@@ -71,6 +71,9 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
        fprintf(out,
              _(" %s [options]\n"), program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Enter a system sleep state until a specified wakeup time.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -a, --auto               reads the clock mode from adjust file (default)\n"), out);
        fprintf(out,

diff --git a/sys-utils/setarch.c b/sys-utils/setarch.c
index ed2a6a64cb361e3846a721983f580e3242dc34f3..09430380a9c9ddd448d110c65cc59a74f59a0485 100644 (file)
--- a/sys-utils/setarch.c
+++ b/sys-utils/setarch.c
@@ -94,6 +94,10 @@ static void __attribute__((__noreturn__)) show_help(void)
        printf(_(" %s%s [options] [program [program arguments]]\n"),
               program_invocation_short_name,
               !strcmp(program_invocation_short_name, "setarch") ? " <arch>" : "");
+
+       fputs(USAGE_SEPARATOR, stdout);
+       fputs(_("Change the reported architecture and set personality flags.\n"), stdout);
+
        fputs(USAGE_OPTIONS, stdout);
        fputs(_(" -v, --verbose            says what options are being switched on\n"), stdout);
        fputs(_(" -R, --addr-no-randomize  disables randomization of the virtual address space\n"), stdout);

diff --git a/sys-utils/setpriv.c b/sys-utils/setpriv.c
index 06d9fe4299643e8727a41e833bac91704577d79e..1630122230e8ddc2a5bc91669ddea0cb7261feff 100644 (file)
--- a/sys-utils/setpriv.c
+++ b/sys-utils/setpriv.c
@@ -93,6 +93,9 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
        fprintf(out, _(" %s [options] <program> [<argument>...]\n"),
                program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Run a program with different privilege settings.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -d, --dump               show current state (and do not exec anything)\n"), out);
        fputs(_(" --nnp, --no-new-privs    disallow granting new privileges\n"), out);

diff --git a/sys-utils/setsid.c b/sys-utils/setsid.c
index 782de82b5d21caace57efda075e384811d8d1df0..adc34ecb383e90fe4dc6286ce49b8d2cb911e4bd 100644 (file)
--- a/sys-utils/setsid.c
+++ b/sys-utils/setsid.c
@@ -32,6 +32,9 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
                " %s [options] <program> [arguments ...]\n"),
                program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Run a program in a new session.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -c, --ctty     set the controlling terminal to the current one\n"), out);
        fputs(_(" -w, --wait     wait program to exit, and use the same return\n"), out);

diff --git a/sys-utils/swapoff.c b/sys-utils/swapoff.c
index b725462eb1bf68aa864bca3bda527cf794dbeab2..168d10f3f45f6ce0910820ef890d3be12a3acb70 100644 (file)
--- a/sys-utils/swapoff.c
+++ b/sys-utils/swapoff.c
@@ -116,9 +116,11 @@ static int swapoff_by(const char *name, const char *value, int quiet)
 static void __attribute__ ((__noreturn__)) usage(FILE * out)
 {
        fputs(USAGE_HEADER, out);
-
        fprintf(out, _(" %s [options] [<spec>]\n"), program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Disable devices and files for paging and swapping.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -a, --all              disable all swaps from /proc/swaps\n"
                " -v, --verbose          verbose mode\n"), out);

diff --git a/sys-utils/swapon.c b/sys-utils/swapon.c
index a45760766a22deeca29d2de15edf651b7f438409..8a3a21739d1034148e732f95d9f417cd7aa92c60 100644 (file)
--- a/sys-utils/swapon.c
+++ b/sys-utils/swapon.c
@@ -724,9 +724,11 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
 {
        size_t i;
        fputs(USAGE_HEADER, out);
-
        fprintf(out, _(" %s [options] [<spec>]\n"), program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Enable devices and files for paging and swapping.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -a, --all                enable all swaps from /etc/fstab\n"), out);
        fputs(_(" -d, --discard[=<policy>] enable swap discards, if supported by device\n"), out);

diff --git a/sys-utils/switch_root.c b/sys-utils/switch_root.c
index 534d44ac70b4441d819c8f9fb63b9ffef6b895d9..be23fd809e1b3045a52188bcf2c1e9a3ff716cec 100644 (file)
--- a/sys-utils/switch_root.c
+++ b/sys-utils/switch_root.c
@@ -200,6 +200,10 @@ static void __attribute__((__noreturn__)) usage(FILE *output)
        fputs(USAGE_HEADER, output);
        fprintf(output, _(" %s [options] <newrootdir> <init> <args to init>\n"),
                program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, output);
+       fputs(_("Switch to another filesystem as the root of the mount tree.\n"), output);
+
        fputs(USAGE_OPTIONS, output);
        fputs(USAGE_HELP, output);
        fputs(USAGE_VERSION, output);

diff --git a/sys-utils/tunelp.c b/sys-utils/tunelp.c
index 08cef5c374e76401659e35dc92b5180a8613ea21..b132d7aafa4487a7f3fd685586a3a29bad65f29f 100644 (file)
--- a/sys-utils/tunelp.c
+++ b/sys-utils/tunelp.c
@@ -88,6 +88,9 @@ static void __attribute__((__noreturn__)) print_usage(FILE *out)
        fputs(USAGE_HEADER, out);
        fprintf(out, _(" %s [options] <device>\n"), program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Set various parameters for the line printer.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -i, --irq <num>              specify parallel port irq\n"), out);
        fputs(_(" -t, --time <ms>              driver wait time in milliseconds\n"), out);

diff --git a/sys-utils/umount.c b/sys-utils/umount.c
index 8bc6655ea416041aaed5d511f33660edf93bccad..464c4c87f4dbc34bf302ff955ec9158d80b271b2 100644 (file)
--- a/sys-utils/umount.c
+++ b/sys-utils/umount.c
@@ -78,6 +78,9 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
                " %1$s [options] <source> | <directory>\n"),
                program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Unmount filesystems.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -a, --all               unmount all filesystems\n"), out);
        fputs(_(" -A, --all-targets       unmount all mountpoints for the given device in the\n"

diff --git a/sys-utils/unshare.c b/sys-utils/unshare.c
index 933f621524a439ae0b0febb98d7ccebb2e1840c5..fccdba2f659361db13482d77814efb06d0702a37 100644 (file)
--- a/sys-utils/unshare.c
+++ b/sys-utils/unshare.c
@@ -63,6 +63,9 @@ static void usage(int status)
        fprintf(out, _(" %s [options] <program> [<argument>...]\n"),
                program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Run a program with some namespaces unshared from the parent.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -m, --mount               unshare mounts namespace\n"), out);
        fputs(_(" -u, --uts                 unshare UTS namespace (hostname etc)\n"), out);

diff --git a/sys-utils/wdctl.c b/sys-utils/wdctl.c
index 0628c8ecaecb6d46dbcee49e511d74c985fe0e8e..095d8ed430f13f188e90f7e78f98ab8cc581ac06 100644 (file)
--- a/sys-utils/wdctl.c
+++ b/sys-utils/wdctl.c
@@ -173,8 +173,10 @@ static void usage(FILE *out)
        fprintf(out,
              _(" %s [options] [<device> ...]\n"), program_invocation_short_name);
 
-       fputs(USAGE_OPTIONS, out);
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Show the status of the hardware watchdog.\n"), out);
 
+       fputs(USAGE_OPTIONS, out);
        fputs(_(" -f, --flags <list>     print selected flags only\n"
                " -F, --noflags          don't print information about flags\n"
                " -I, --noident          don't print watchdog identity information\n"

diff --git a/sys-utils/zramctl.c b/sys-utils/zramctl.c
index 786be06287e8b53ee9e1c269de0b6eb943acfbf3..4abc587a78003e001c7bafde04de6c3cffd748e7 100644 (file)
--- a/sys-utils/zramctl.c
+++ b/sys-utils/zramctl.c
@@ -378,6 +378,9 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
                        " %1$s [options] -f | <device> -s <size>\n"),
                        program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Set up and control zram devices.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -a, --algorithm lzo|lz4   compression algorithm to use\n"), out);
        fputs(_(" -b, --bytes               print sizes in bytes rather than in human readable format\n"), out);

diff --git a/term-utils/agetty.c b/term-utils/agetty.c
index 9871a3685563e859de567395c29992972f8b0cf6..2ac0644dfe96686952312279210992fbd9285f62 100644 (file)
--- a/term-utils/agetty.c
+++ b/term-utils/agetty.c
@@ -1982,6 +1982,10 @@ static void __attribute__ ((__noreturn__)) usage(FILE *out)
        fputs(USAGE_HEADER, out);
        fprintf(out, _(" %1$s [options] <line> [<baud_rate>,...] [<termtype>]\n"
                       " %1$s [options] <baud_rate>,... <line> [<termtype>]\n"), program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Open a terminal and set its mode.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -8, --8bits                assume 8-bit tty\n"), out);
        fputs(_(" -a, --autologin <user>     login the specified user automatically\n"), out);

diff --git a/term-utils/mesg.c b/term-utils/mesg.c
index 12e4e0e8ca213ef8a5a1a955be7c38b5b60871fd..a3892871cf317eff9191d4083784e361c8ee7cc8 100644 (file)
--- a/term-utils/mesg.c
+++ b/term-utils/mesg.c
@@ -73,6 +73,10 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
         * which means they can be translated.  */
        fprintf(out,
              _(" %s [options] [y | n]\n"), program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Control write access of other users to your terminal.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -v, --verbose  explain what is being done\n"), out);
        fputs(USAGE_HELP, out);

diff --git a/term-utils/script.c b/term-utils/script.c
index 78d7a3049f28d2ee6fb053795a73369a1a4b3097..548334cbc23a25bbff5729151bcd559123eeedc0 100644 (file)
--- a/term-utils/script.c
+++ b/term-utils/script.c
@@ -143,6 +143,9 @@ usage(FILE *out)
        fprintf(out,
              _(" %s [options] [file]\n"), program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Make a typescript of a terminal session.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -a, --append            append the output\n"
                " -c, --command <command> run command rather than interactive shell\n"

diff --git a/term-utils/scriptreplay.c b/term-utils/scriptreplay.c
index fb5ded31ed75e1610fe4da76af5a0558611952b5..17246633965cd78fcea82d2bcdca428d17249725 100644 (file)
--- a/term-utils/scriptreplay.c
+++ b/term-utils/scriptreplay.c
@@ -42,6 +42,9 @@ usage(FILE *out)
              _(" %s [-t] timingfile [typescript] [divisor]\n"),
              program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Play back terminal typescripts, using timing information.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -t, --timing <file>     script timing output file\n"
                " -s, --typescript <file> script terminal session output file\n"

diff --git a/term-utils/setterm.c b/term-utils/setterm.c
index fefb0a9d1c797b97a2b4b8d1b627cc37d96f00f8..76fedbae4fa392463a84319dadd5d85817a29499 100644 (file)
--- a/term-utils/setterm.c
+++ b/term-utils/setterm.c
@@ -402,6 +402,10 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
        fputs(USAGE_HEADER, out);
        fprintf(out,
              _(" %s [options]\n"), program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Set the attributes of a terminal.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" --term          <terminal_name>   override TERM environment variable\n"), out);
        fputs(_(" --reset                           reset terminal to power-on state\n"), out);

diff --git a/term-utils/wall.c b/term-utils/wall.c
index 598e9f28c59f2ba79ffd0954f80bd28f2f6f9f38..387594ceff1286f8609565f69464f46e2bb1fec5 100644 (file)
--- a/term-utils/wall.c
+++ b/term-utils/wall.c
@@ -81,6 +81,10 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
        fputs(USAGE_HEADER, out);
        fprintf(out,
              _(" %s [options] [<file> | <message>]\n"), program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Write a message to all users.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -n, --nobanner          do not print banner, works only for root\n"), out);
        fputs(_(" -t, --timeout <timeout> write timeout in seconds\n"), out);

diff --git a/term-utils/write.c b/term-utils/write.c
index ca40354f723387172d88da61a07fde218eebefbf..238040be2a0b3ba32bf853bbb9cd6940f50505dd 100644 (file)
--- a/term-utils/write.c
+++ b/term-utils/write.c
@@ -82,6 +82,9 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
              _(" %s [options] <user> [<ttyname>]\n"),
              program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Send a message to another user.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(USAGE_HELP, out);
        fputs(USAGE_VERSION, out);

diff --git a/text-utils/col.c b/text-utils/col.c
index 1218f251a37406672157db800e4fc95cc5e02121..53f0556d3e26cd84c4463b4e11db40ab444685a6 100644 (file)
--- a/text-utils/col.c
+++ b/text-utils/col.c
@@ -130,6 +130,9 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
                "\nUsage:\n"
                " %s [options]\n"), program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Filter out reverse line feeds.\n"), out);
+
        fprintf(out, _(
                "\nOptions:\n"
                " -b, --no-backspaces    do not output backspaces\n"

diff --git a/text-utils/colcrt.c b/text-utils/colcrt.c
index c39c8b6f1ee3bc041eb4a9509cca91b3e6c760de..31ce52af973c3730e1808aa6508e5fe92f408143 100644 (file)
--- a/text-utils/colcrt.c
+++ b/text-utils/colcrt.c
@@ -313,6 +313,10 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
                _("\nUsage:\n"
                  " %s [options] [file ...]\n"), program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Filter nroff output for CRT previewing.\n"), out);
+
+       fputs(USAGE_OPTIONS, out);
        fprintf(out,
                _(" -,  --no-underlining  suppress all underlining\n"
                  " -2, --half-lines      print all half-lines\n"

diff --git a/text-utils/colrm.c b/text-utils/colrm.c
index 4264fe6b029cf4e21f2a6a157e7c81c64cae339c..431eae0d2fec371b93aad6228dcf6ad21982d57c 100644 (file)
--- a/text-utils/colrm.c
+++ b/text-utils/colrm.c
@@ -59,6 +59,10 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
        fprintf(out, _("\nUsage:\n"
                       " %s [startcol [endcol]]\n"),
                       program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Filter out the specified columns.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(USAGE_HELP, out);
        fputs(USAGE_VERSION, out);

diff --git a/text-utils/column.c b/text-utils/column.c
index e583dbafb90ae1c6fff61bf8120a4718bf42d5ab..60d12312337bbbd9fa96347bf8d5d587a6f3611f 100644 (file)
--- a/text-utils/column.c
+++ b/text-utils/column.c
@@ -90,6 +90,10 @@ static void __attribute__((__noreturn__)) usage(int rc)
 
        fputs(USAGE_HEADER, out);
        fprintf(out, _(" %s [options] [<file>...]\n"), program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Columnate lists.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -c, --columns <width>    width of output in number of characters\n"), out);
        fputs(_(" -t, --table              create a table\n"), out);

diff --git a/text-utils/hexdump.c b/text-utils/hexdump.c
index afae334722de07f00f84289b58a48444e55a6729..9ee5cb7c9d8e7c1bb0a174082edcf449b439412a 100644 (file)
--- a/text-utils/hexdump.c
+++ b/text-utils/hexdump.c
@@ -153,6 +153,10 @@ void __attribute__((__noreturn__)) usage(FILE *out)
 {
        fputs(USAGE_HEADER, out);
        fprintf(out, _(" %s [options] <file>...\n"), program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Display file contents in hexadecimal, decimal, octal, or ascii.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -b, --one-byte-octal      one-byte octal display\n"), out);
        fputs(_(" -c, --one-byte-char       one-byte character display\n"), out);

diff --git a/text-utils/line.c b/text-utils/line.c
index 80daa3476235386932b4c05f40be76c3899b99f2..9384b5c6c1f26a2986353f5938f0b4006ddfe456 100644 (file)
--- a/text-utils/line.c
+++ b/text-utils/line.c
@@ -28,6 +28,10 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
 {
        fputs(USAGE_HEADER, out);
        fprintf(out, _(" %s [options]\n"), program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Read one line.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(USAGE_HELP, out);
        fputs(USAGE_VERSION, out);

diff --git a/text-utils/more.c b/text-utils/more.c
index 5c484575bdf50f9195ed0cdcca899de597152025..74148a7abb45b705c21e215ada54975c995af8f3 100644 (file)
--- a/text-utils/more.c
+++ b/text-utils/more.c
@@ -317,6 +317,10 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
 {
        fputs(USAGE_HEADER, out);
        fprintf(out, _(" %s [options] <file>...\n"), program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("A file perusal filter for CRT viewing.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -d          display help instead of ringing bell\n"), out);
        fputs(_(" -f          count logical rather than screen lines\n"), out);

diff --git a/text-utils/pg.c b/text-utils/pg.c
index 9ada00c2691efcef886529e3772e4770a81c4812..998010ad2f64aff6470435cbb410f636d6147b0a 100644 (file)
--- a/text-utils/pg.c
+++ b/text-utils/pg.c
@@ -222,6 +222,10 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
        fprintf(out,
                _(" %s [options] [+line] [+/pattern/] [files]\n"),
                program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Browse pagewise through text files.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -number      lines per page\n"), out);
        fputs(_(" -c           clear screen before displaying\n"), out);

diff --git a/text-utils/rev.c b/text-utils/rev.c
index bda31d2d88d44c3898bb6bc4f625adbd0ceb334e..cb384824138323a90dcdd0ba6cce720a5461792d 100644 (file)
--- a/text-utils/rev.c
+++ b/text-utils/rev.c
@@ -76,6 +76,10 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
 {
        fprintf(out, _("Usage: %s [options] [file ...]\n"),
                program_invocation_short_name);
+
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Reverse lines characterwise.\n"), out);
+
        fputs(USAGE_OPTIONS, out);
        fputs(USAGE_HELP, out);
        fputs(USAGE_VERSION, out);

diff --git a/text-utils/tailf.c b/text-utils/tailf.c
index bd38da274c5a4737dc6a78165ceb7b2d90e0184f..cf22a1e5f17f133a51f230efdaf567474c556db9 100644 (file)
--- a/text-utils/tailf.c
+++ b/text-utils/tailf.c
@@ -198,6 +198,9 @@ static void __attribute__ ((__noreturn__)) usage(FILE *out)
                  " %s [option] file\n"),
                program_invocation_short_name);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Follow the growth of a log file.\n"), out);
+
        fprintf(out, _(
                "\nOptions:\n"
                " -n, --lines NUMBER  output the last NUMBER lines\n"

diff --git a/text-utils/ul.c b/text-utils/ul.c
index 20a05514a988e5cef14d411dcb1c03ee31a07efe..30cad791dd3f35874e18e1e89ce891fda709500f 100644 (file)
--- a/text-utils/ul.c
+++ b/text-utils/ul.c
@@ -134,8 +134,11 @@ usage(FILE *out)
 {
        fputs(USAGE_HEADER, out);
        fprintf(out, _(" %s [options] [<file> ...]\n"), program_invocation_short_name);
-       fputs(USAGE_OPTIONS, out);
 
+       fputs(USAGE_SEPARATOR, out);
+       fputs(_("Do underlining.\n"), out);
+
+       fputs(USAGE_OPTIONS, out);
        fputs(_(" -t, -T, --terminal TERMINAL  override the TERM environment variable\n"), out);
        fputs(_(" -i, --indicated              underlining is indicated via a separate line\n"), out);
        fputs(USAGE_SEPARATOR, out);