(usage): Add one or two lines of descriptive text.

diff --git a/src/chgrp.c b/src/chgrp.c
index 8c77bd3607a82040a24b9fef5dfa62478ec4cb24..9b0dd8656c45b9af6cb916d12093fc185011c5f5 100644 (file)
--- a/src/chgrp.c
+++ b/src/chgrp.c
@@ -312,6 +312,7 @@ usage (status)
     {
       printf ("Usage: %s [OPTION]... GROUP FILE...\n", program_name);
       printf ("\
+Change the group membership of each FILE to GROUP.\n\
 \n\
   -c, --changes           like verbose but report only when a change is made\n\
   -f, --silent, --quiet   suppress most error messages\n\

diff --git a/src/chown.c b/src/chown.c
index 3fc9304888265a26634fbadb264fef966f98fef5..055b61840732c671451a3af58b5439ffbd776dde 100644 (file)
--- a/src/chown.c
+++ b/src/chown.c
@@ -302,6 +302,7 @@ Usage: %s [OPTION]... OWNER[.[GROUP]] FILE...\n\
 ",
              program_name, program_name);
       printf ("\
+Change the owner and/or group of each FILE to OWNER and/or GROUP.\n\
 \n\
   -c, --changes           be verbose whenever change occurs\n\
   -f, --silent, --quiet   suppress most error messages\n\

diff --git a/src/dd.c b/src/dd.c
index 6674bef4da9434a629e507d6a9a5fd4db2e5d51e..aa6513acf2898d3d4eba354faf4d53c941beb487 100644 (file)
--- a/src/dd.c
+++ b/src/dd.c
@@ -1092,6 +1092,7 @@ usage (status)
     {
       printf ("Usage: %s [OPTION]...\n", program_name);
       printf ("\
+Copy a file, converting and formatting according to the options.\n\
 \n\
   bs=BYTES        force ibs=BYTES and obs=BYTES\n\
   cbs=BYTES       convert BYTES bytes at a time\n\

diff --git a/src/df.c b/src/df.c
index 2d6f4d21a9ddd518f866e0042c445bcec0e8c9ef..00c5075fd72f9f6b25653b8e7e6da30b8740a340 100644 (file)
--- a/src/df.c
+++ b/src/df.c
@@ -518,6 +518,8 @@ usage (status)
     {
       printf ("Usage: %s [OPTION]... [FILE]...\n", program_name);
       printf ("\
+Show information about the filesystem on which each FILE resides,\n\
+or all filesystems by default.\n\
 \n\
   -a, --all                 include filesystems having 0 blocks\n\
   -i, --inodes              list inode information instead of block usage\n\
@@ -530,9 +532,7 @@ usage (status)
   -P, --portability         use the POSIX output format\n\
   -T, --print-type          print filesystem type\n\
       --help                display this help and exit\n\
-      --version             output version information and exit\n\
-\n\
-If no FILEs are given, list all currently mounted filesystems.\n");
+      --version             output version information and exit\n");
     }
   exit (status);
 }

diff --git a/src/du.c b/src/du.c
index c5022a6aa0affcc724bebded1a69b30e54e53c05..2f4398ba2c8f19956bdeb4f85d1f3dc794d4f8cf 100644 (file)
--- a/src/du.c
+++ b/src/du.c
@@ -267,8 +267,9 @@ usage (status, reason)
             program_name);
   else
     {
-      printf ("Usage: %s [OPTION]... [PATH]...\n", program_name);
+      printf ("Usage: %s [OPTION]... [FILE]...\n", program_name);
       printf ("\
+Summarize disk usage of each FILE, recursively for directories.\n\
 \n\
   -a, --all                write counts for all files, not just directories\n\
   -b, --bytes              print size in bytes\n\

diff --git a/src/install.c b/src/install.c
index f2315020bd790afe7a68f215d95e4f87a27a1744..c7d926fbb37a822dc7f7d5f7bc394704c33880bf 100644 (file)
--- a/src/install.c
+++ b/src/install.c
@@ -538,15 +538,18 @@ usage (status)
       printf ("\
 Usage: %s [OPTION]... SOURCE DEST           (1st format)\n\
   or:  %s [OPTION]... SOURCE... DIRECTORY   (2nd format)\n\
-  or:  %s [OPTION]... DIRECTORY...          (3nd format)\n\
+  or:  %s -d [OPTION]... DIRECTORY...       (3nd format)\n\
 ",
              program_name, program_name, program_name);
       printf ("\
+In first two formats, copy SOURCE to DEST or multiple SOURCE(s) to\n\
+DIRECTORY, while setting permission modes and owner/group.  In third\n\
+format, make all components of the given DIRECTORY(ies).\n\
 \n\
   -c                  (ignored)\n\
   -d, --directory     create [leading] directories, mandatory for 3rd format\n\
   -g, --group=GROUP   set group ownership, instead of process' current group\n\
-  -m, --mode=MODE     set permission mode (as in chmod), instead of 0755\n\
+  -m, --mode=MODE     set permission mode (as in chmod), instead of rw-r--r--\n\
   -o, --owner=OWNER   set ownership (super-user only)\n\
   -s, --strip         strip symbol tables, only for 1st and 2nd formats\n\
       --help          display this help and exit\n\

diff --git a/src/ln.c b/src/ln.c
index 404e9a3e623ea6b266baaf6d10cbd85c25ed2893..948cb14e0243dfde3d64972e0f288f386477557b 100644 (file)
--- a/src/ln.c
+++ b/src/ln.c
@@ -409,6 +409,8 @@ Usage: %s [OPTION]... SOURCE [DEST]\n\
 ",
              program_name, program_name);
       printf ("\
+Link SOURCE to DEST (. by default), or multiple SOURCE(s) to DIRECTORY.\n\
+Makes hard links by default, symbolic links with -s.\n\
 \n\
   -b, --backup                 make backups for removed files\n\
   -d, -F, --directory          hard link directories (super-user only)\n\
@@ -416,7 +418,7 @@ Usage: %s [OPTION]... SOURCE [DEST]\n\
   -n, --no-dereference         with --force, remove destination that is a\n\
                                  symlink to a directory\n\
   -i, --interactive            prompt whether to remove destinations\n\
-  -s, --symbolic               make symbolic links, instead of hard links\n\
+  -s, --symbolic               make symbolic links instead of hard links\n\
   -v, --verbose                print name of each file before linking\n\
   -S, --suffix=SUFFIX          override the usual backup suffix\n\
   -V, --version-control=WORD   override the usual version control\n\

diff --git a/src/ls.c b/src/ls.c
index ed289c3195c1780ff0999ae18b263a0370807c4d..90d92c5983c55331320e48526eac42c2c367db31 100644 (file)
--- a/src/ls.c
+++ b/src/ls.c
@@ -2556,8 +2556,10 @@ usage (status)
             program_name);
   else
     {
-      printf ("Usage: %s [OPTION]... [PATH]...\n", program_name);
+      printf ("Usage: %s [OPTION]... [FILE]...\n", program_name);
       printf ("\
+List information about the FILEs (the current directory by default).\n\
+Sort entries alphabetically if none of -cftuSUX nor --sort.\n\
 \n\
   -A, --almost-all           do not list implied . and ..\n\
   -a, --all                  do not hide entries starting with .\n\
@@ -2609,9 +2611,7 @@ usage (status)
   -7, --7bit                 allow only 7-bit ASCII characters to be printed\n\
   -8, --8bit                 allow 8-bit ISO 8859 characters to be printed\n\
       --help                 display this help and exit\n\
-      --version              output version information and exit\n\
-\n\
-Sort entries alphabetically if none of -cftuSUX nor --sort.\n");
+      --version              output version information and exit");
     }
   exit (status);
 }

diff --git a/src/mkdir.c b/src/mkdir.c
index 23932ae48fa5afd1e4aa46869bd0607dfd6df9f2..fe0c72fb25929d5887627a44806b8c49390220ef 100644 (file)
--- a/src/mkdir.c
+++ b/src/mkdir.c
@@ -148,9 +148,10 @@ usage (status)
     {
       printf ("Usage: %s [OPTION] DIRECTORY...\n", program_name);
       printf ("\
+Create the DIRECTORY(ies), if they do not already exist.\n\
 \n\
   -p, --parents     no error if existing, make parent directories as needed\n\
-  -m, --mode=MODE   set permission mode (as in chmod), not 0777 - umask\n\
+  -m, --mode=MODE   set permission mode (as in chmod), not rwxrwxrwx - umask\n\
       --help        display this help and exit\n\
       --version     output version information and exit\n");
     }

diff --git a/src/mkfifo.c b/src/mkfifo.c
index 5150668d613776583596ae7fac30f750f514d7d1..095abf4c0ee774cd51f6753df85cd3a4081f347e 100644 (file)
--- a/src/mkfifo.c
+++ b/src/mkfifo.c
@@ -131,8 +131,9 @@ usage (status)
             program_name);
   else
     {
-      printf ("Usage: %s [OPTION] PATH...\n", program_name);
+      printf ("Usage: %s [OPTION] NAME...\n", program_name);
       printf ("\
+Create named pipes (FIFOs) with the given NAMEs.\n\
 \n\
   -m, --mode=MODE   set permission mode (as in chmod), not 0666 - umask\n\
       --help        display this help and exit\n\

diff --git a/src/mknod.c b/src/mknod.c
index 13adf82946513fc627253c7feb8f6307d06f4da0..29ec39bdd0baf094c10e33edc33f631af1bf3059 100644 (file)
--- a/src/mknod.c
+++ b/src/mknod.c
@@ -240,8 +240,9 @@ usage (status)
             program_name);
   else
     {
-      printf ("Usage: %s [OPTION]... PATH TYPE [MAJOR MINOR]\n", program_name);
+      printf ("Usage: %s [OPTION]... NAME TYPE [MAJOR MINOR]\n", program_name);
       printf ("\
+Create the special file NAME of the given TYPE.\n\
 \n\
   -m, --mode=MODE   set permission mode (as in chmod), not 0666 - umask\n\
       --help        display this help and exit\n\

diff --git a/src/mv.c b/src/mv.c
index db43245bfdc347128407e4008ab29e0fbb9b5187..4e7fcb8b7d31e3cf6d162f176f693b2dc328dc1b 100644 (file)
--- a/src/mv.c
+++ b/src/mv.c
@@ -473,6 +473,7 @@ Usage: %s [OPTION]... SOURCE DEST\n\
 ",
              program_name, program_name);
       printf ("\
+Rename SOURCE to DEST, or move SOURCE(s) to DIRECTORY.\n\
 \n\
   -b, --backup                 make backup before removal\n\
   -f, --force                  remove existing destinations, never prompt\n\

diff --git a/src/rm.c b/src/rm.c
index 5f6e6d0aa2bdc4606008929a12c61055177cdca2..0ed221c322cea3175aa77fd3683db7686b6c2e18 100644 (file)
--- a/src/rm.c
+++ b/src/rm.c
@@ -528,8 +528,9 @@ usage (status)
             program_name);
   else
     {
-      printf ("Usage: %s [OPTION]... PATH...\n", program_name);
+      printf ("Usage: %s [OPTION]... FILE...\n", program_name);
       printf ("\
+Remove (unlink) the FILE(s).\n\
 \n\
   -d, --directory       unlink directory, even if non-empty (super-user only)\n\
   -f, --force           ignore nonexistent files, never prompt\n\

diff --git a/src/rmdir.c b/src/rmdir.c
index e17383f3a98fdd046ccd9a0a7af54e5a79c97392..17381555c67b75196b4c09b073ab68e2cf4a6ca8 100644 (file)
--- a/src/rmdir.c
+++ b/src/rmdir.c
@@ -148,6 +148,7 @@ usage (status)
     {
       printf ("Usage: %s [OPTION]... DIRECTORY...\n", program_name);
       printf ("\
+Remove the DIRECTORY(ies), if they are empty.\n\
 \n\
   -p, --parents   remove explicit parent directories if being emptied\n\
       --help      display this help and exit\n\

diff --git a/src/sync.c b/src/sync.c
index acdbcb0d6222e28815bc912bb967694ec90938ae..1c1a0b84aab471ae5bcf5bb0bd325d37a84a7824 100644 (file)
--- a/src/sync.c
+++ b/src/sync.c
@@ -40,6 +40,7 @@ usage (status)
     {
       printf ("Usage: %s [OPTION]\n", program_name);
       printf ("\
+Force changed blocks to disk, update the super block.\n\
 \n\
   --help      display this help and exit\n\
   --version   output version information and exit\n\

diff --git a/src/touch.c b/src/touch.c
index 06d69a9c17199e482f92376b46a8ee86bcfc5c01..f636632be9a4775019387533792c6557961f8828 100644 (file)
--- a/src/touch.c
+++ b/src/touch.c
@@ -378,6 +378,7 @@ usage (status)
     {
       printf ("Usage: %s [OPTION]... FILE...\n", program_name);
       printf ("\
+Update the access and modification times of each FILE to the current time.\n\
 \n\
   -a                     change only the access time\n\
   -c                     do not create any files\n\