tweak usage texts
[platform/upstream/busybox.git] / include / usage.src.h
index 53ee794..38d6089 100644 (file)
 INSERT
 
 #define acpid_trivial_usage \
-       "[-d] [-c CONFDIR] [-l LOGFILE] [-e PROC_EVENT_FILE] [EVDEV_EVENT_FILE]..."
+       "[-d] [-c CONFDIR] [-l LOGFILE] [-a ACTIONFILE] [-M MAPFILE] [-e PROC_EVENT_FILE] [-p PIDFILE]"
 #define acpid_full_usage "\n\n" \
        "Listen to ACPI events and spawn specific helpers on event arrival\n" \
      "\nOptions:" \
-     "\n       -d      Don't daemonize, log to stderr" \
      "\n       -c DIR  Config directory [/etc/acpi]" \
+     "\n       -d      Don't daemonize, (implies -f)" \
      "\n       -e FILE /proc event file [/proc/acpi/event]" \
-     "\n       -l FILE Log file [/var/log/acpid]" \
+     "\n       -f      Run in foreground" \
+     "\n       -l FILE Log file [/var/log/acpid.log]" \
+     "\n       -p FILE Pid file [/var/run/acpid.pid]" \
+     "\n       -a FILE Action file [/etc/acpid.conf]" \
+     "\n       -M FILE Map file [/etc/acpi.map]" \
        IF_FEATURE_ACPID_COMPAT( \
      "\n\nAccept and ignore compatibility options -g -m -s -S -v" \
        )
 
 #define acpid_example_usage \
+       "Without -e option, acpid uses all /dev/input/event* files\n" \
+       "# acpid\n" \
        "# acpid -l /var/log/my-acpi-log\n" \
-       "# acpid -d /dev/input/event*\n"
+       "# acpid -e /proc/acpi/event\n"
 
 #define addgroup_trivial_usage \
        "[-g GID] " IF_FEATURE_ADDUSER_TO_GROUP("[USER] ") "GROUP"
@@ -95,7 +101,7 @@ INSERT
        "\n     -n              Don't resolve names" \
        "\n     -i IF           Network interface" \
        "\n     -D              Read <hwaddr> from given device" \
-       "\n     -A, -p AF       Protocol family" \
+       "\n     -A,-p AF        Protocol family" \
        "\n     -H HWTYPE       Hardware address type" \
 
 #define arping_trivial_usage \
@@ -115,19 +121,6 @@ INSERT
      "\n       -s SRC_IP       Sender IP address" \
      "\n       DST_IP          Target IP address" \
 
-#define sh_trivial_usage NOUSAGE_STR
-#define sh_full_usage ""
-#define ash_trivial_usage NOUSAGE_STR
-#define ash_full_usage ""
-#define hush_trivial_usage NOUSAGE_STR
-#define hush_full_usage ""
-#define lash_trivial_usage NOUSAGE_STR
-#define lash_full_usage ""
-#define msh_trivial_usage NOUSAGE_STR
-#define msh_full_usage ""
-#define bash_trivial_usage NOUSAGE_STR
-#define bash_full_usage ""
-
 #define awk_trivial_usage \
        "[OPTIONS] [AWK_PROGRAM] [FILE]..."
 #define awk_full_usage "\n\n" \
@@ -227,7 +220,7 @@ INSERT
      "\n       -F      Don't store or verify checksum" \
 
 #define unlzma_trivial_usage \
-       "[OPTIONS] [FILE]..."
+       "[-cf] [FILE]..."
 #define unlzma_full_usage "\n\n" \
        "Decompress FILE (or stdin)\n" \
      "\nOptions:" \
@@ -235,7 +228,7 @@ INSERT
      "\n       -f      Force" \
 
 #define lzma_trivial_usage \
-       "-d [OPTIONS] [FILE]..."
+       "-d [-cf] [FILE]..."
 #define lzma_full_usage "\n\n" \
        "Decompress FILE (or stdin)\n" \
      "\nOptions:" \
@@ -249,7 +242,7 @@ INSERT
        "Decompress to stdout"
 
 #define unxz_trivial_usage \
-       "[OPTIONS] [FILE]..."
+       "[-cf] [FILE]..."
 #define unxz_full_usage "\n\n" \
        "Decompress FILE (or stdin)\n" \
      "\nOptions:" \
@@ -257,7 +250,7 @@ INSERT
      "\n       -f      Force" \
 
 #define xz_trivial_usage \
-       "-d [OPTIONS] [FILE]..."
+       "-d [-cf] [FILE]..."
 #define xz_full_usage "\n\n" \
        "Decompress FILE (or stdin)\n" \
      "\nOptions:" \
@@ -434,7 +427,7 @@ INSERT
        "       [-/ DIR] [-n NICE] [-m BYTES] [-d BYTES] [-o N]\n" \
        "       [-p N] [-f BYTES] [-c BYTES] PROG ARGS"
 #define chpst_full_usage "\n\n" \
-       "Change the process state and run PROG\n" \
+       "Change the process state, run PROG\n" \
      "\nOptions:" \
      "\n       -u USER[:GRP]   Set uid and gid" \
      "\n       -U USER[:GRP]   Set $UID and $GID in environment" \
@@ -457,17 +450,17 @@ INSERT
 #define setuidgid_trivial_usage \
        "USER PROG ARGS"
 #define setuidgid_full_usage "\n\n" \
-       "Set uid and gid to USER's uid and gid, removing all supplementary\n" \
-       "groups and run PROG"
+       "Set uid and gid to USER's uid and gid, drop supplementary group ids,\n" \
+       "run PROG"
 #define envuidgid_trivial_usage \
        "USER PROG ARGS"
 #define envuidgid_full_usage "\n\n" \
-       "Set $UID to USER's uid and $GID to USER's gid and run PROG"
+       "Set $UID to USER's uid and $GID to USER's gid, run PROG"
 #define envdir_trivial_usage \
        "DIR PROG ARGS"
 #define envdir_full_usage "\n\n" \
        "Set various environment variables as specified by files\n" \
-       "in the directory dir and run PROG"
+       "in the directory DIR, run PROG"
 #define softlimit_trivial_usage \
        "[-a BYTES] [-m BYTES] [-d BYTES] [-s BYTES] [-l BYTES]\n" \
        "       [-f BYTES] [-c BYTES] [-r BYTES] [-o N] [-p N] [-t N]\n" \
@@ -538,24 +531,49 @@ INSERT
 #define bbconfig_trivial_usage \
        ""
 #define bbconfig_full_usage "\n\n" \
-       "Print the config file which built busybox"
+       "Print the config file used by busybox build"
 
 #define chrt_trivial_usage \
-       "[OPTIONS] [PRIO] [PID | PROG ARGS]"
+       "[-prfom] [PRIO] [PID | PROG ARGS]"
 #define chrt_full_usage "\n\n" \
-       "Manipulate real-time attributes of a process\n" \
+       "Change scheduling priority and class for a process\n" \
      "\nOptions:" \
      "\n       -p      Operate on PID" \
-     "\n       -r      Set SCHED_RR scheduling" \
-     "\n       -f      Set SCHED_FIFO scheduling" \
-     "\n       -o      Set SCHED_OTHER scheduling" \
-     "\n       -m      Show min and max priorities" \
+     "\n       -r      Set SCHED_RR class" \
+     "\n       -f      Set SCHED_FIFO class" \
+     "\n       -o      Set SCHED_OTHER class" \
+     "\n       -m      Show min/max priorities" \
 
 #define chrt_example_usage \
        "$ chrt -r 4 sleep 900; x=$!\n" \
        "$ chrt -f -p 3 $x\n" \
        "You need CAP_SYS_NICE privileges to set scheduling attributes of a process"
 
+#define nice_trivial_usage \
+       "[-n ADJUST] [PROG ARGS]"
+#define nice_full_usage "\n\n" \
+       "Change scheduling priority, run PROG\n" \
+     "\nOptions:" \
+     "\n       -n ADJUST       Adjust priority by ADJUST" \
+
+#define renice_trivial_usage \
+       "{{-n INCREMENT} | PRIORITY} [[-p | -g | -u] ID...]"
+#define renice_full_usage "\n\n" \
+       "Change scheduling priority for a running process\n" \
+     "\nOptions:" \
+     "\n       -n      Adjust current nice value (smaller is faster)" \
+     "\n       -p      Process id(s) (default)" \
+     "\n       -g      Process group id(s)" \
+     "\n       -u      Process user name(s) and/or id(s)" \
+
+#define ionice_trivial_usage \
+       "[-c 1-3] [-n 0-7] [-p PID] [PROG]"
+#define ionice_full_usage "\n\n" \
+       "Change I/O priority and class\n" \
+     "\nOptions:" \
+     "\n       -c      Class. 1:realtime 2:best-effort 3:idle" \
+     "\n       -n      Priority" \
+
 #define cp_trivial_usage \
        "[OPTIONS] SOURCE DEST"
 #define cp_full_usage "\n\n" \
@@ -666,17 +684,6 @@ INSERT
      "\n       -S SALT" \
        ) \
 
-#define cttyhack_trivial_usage \
-       "PROG ARGS"
-#define cttyhack_full_usage "\n\n" \
-       "Give PROG a controlling tty if possible." \
-     "\nExample for /etc/inittab (for busybox init):" \
-     "\n       ::respawn:/bin/cttyhack /bin/sh" \
-     "\nGiving controlling tty to shell running with PID 1:" \
-     "\n       $ exec cttyhack sh" \
-     "\nStarting interactive shell from boot shell script:" \
-     "\n       setsid cttyhack sh" \
-
 #define cut_trivial_usage \
        "[OPTIONS] [FILE]..."
 #define cut_full_usage "\n\n" \
@@ -735,28 +742,6 @@ INSERT
        "$ date\n" \
        "Wed Apr 12 18:52:41 MDT 2000\n"
 
-#define dc_trivial_usage \
-       "expression..."
-#define dc_full_usage "\n\n" \
-       "Tiny RPN calculator. Operations:\n" \
-       "+, add, -, sub, *, mul, /, div, %, mod, **, exp, and, or, not, eor,\n" \
-       "p - print top of the stack (without altering the stack),\n" \
-       "f - print entire stack, o - pop the value and set output radix\n" \
-       "(value must be 10 or 16).\n" \
-       "Examples: 'dc 2 2 add' -> 4, 'dc 8 8 * 2 2 + /' -> 16\n" \
-
-#define dc_example_usage \
-       "$ dc 2 2 + p\n" \
-       "4\n" \
-       "$ dc 8 8 \\* 2 2 + / p\n" \
-       "16\n" \
-       "$ dc 0 1 and p\n" \
-       "0\n" \
-       "$ dc 0 1 or p\n" \
-       "1\n" \
-       "$ echo 72 9 div 8 mul p | dc\n" \
-       "64\n"
-
 #define dd_trivial_usage \
        "[if=FILE] [of=FILE] " IF_FEATURE_DD_IBS_OBS("[ibs=N] [obs=N] ") "[bs=N] [count=N] [skip=N]\n" \
        "       [seek=N]" IF_FEATURE_DD_IBS_OBS(" [conv=notrunc|noerror|sync|fsync]")
@@ -931,7 +916,7 @@ INSERT
      "\n                       nameserver NORNAL_DNS_SERVER" \
 
 #define dos2unix_trivial_usage \
-       "[OPTIONS] [FILE]"
+       "[-ud] [FILE]"
 #define dos2unix_full_usage "\n\n" \
        "Convert FILE in-place from DOS to Unix format.\n" \
        "When no file is given, use stdin/stdout.\n" \
@@ -940,7 +925,7 @@ INSERT
      "\n       -d      unix2dos" \
 
 #define unix2dos_trivial_usage \
-       "[OPTIONS] [FILE]"
+       "[-ud] [FILE]"
 #define unix2dos_full_usage "\n\n" \
        "Convert FILE in-place from Unix to DOS format.\n" \
        "When no file is given, use stdin/stdout.\n" \
@@ -1299,7 +1284,7 @@ INSERT
 #define flock_trivial_usage \
        "[-sxun] FD|{FILE [-c] PROG ARGS}"
 #define flock_full_usage "\n\n" \
-       "[Un]lock file descriptor, or lock FILE and run PROG\n" \
+       "[Un]lock file descriptor, or lock FILE, run PROG\n" \
      "\nOptions:" \
      "\n       -s      Shared lock" \
      "\n       -x      Exclusive lock (default)" \
@@ -1316,7 +1301,7 @@ INSERT
      "\n       -w      Use WIDTH columns instead of 80" \
 
 #define free_trivial_usage \
-       ""
+       "" IF_DESKTOP("[-b/k/m/g]")
 #define free_full_usage "\n\n" \
        "Display the amount of free and used system memory"
 #define free_example_usage \
@@ -1421,8 +1406,7 @@ INSERT
        "Find processes which use FILEs or PORTs\n" \
      "\nOptions:" \
      "\n       -m      Find processes which use same fs as FILEs" \
-     "\n       -4      Search only IPv4 space" \
-     "\n       -6      Search only IPv6 space" \
+     "\n       -4,-6   Search only IPv4/IPv6 space" \
      "\n       -s      Don't display PIDs" \
      "\n       -k      Kill found processes" \
      "\n       -SIGNAL Signal to send (default: KILL)" \
@@ -1500,7 +1484,7 @@ INSERT
      "\n       -H HOST         Log HOST into the utmp file as the hostname" \
 
 #define gunzip_trivial_usage \
-       "[OPTIONS] [FILE]..."
+       "[-cft] [FILE]..."
 #define gunzip_full_usage "\n\n" \
        "Decompress FILEs (or stdin)\n" \
      "\nOptions:" \
@@ -1516,7 +1500,7 @@ INSERT
        "-rw-rw-r--    1 andersen andersen  1761280 Apr 14 17:47 /tmp/BusyBox-0.43.tar\n"
 
 #define gzip_trivial_usage \
-       "[OPTIONS] [FILE]..."
+       "[-cfd] [FILE]..."
 #define gzip_full_usage "\n\n" \
        "Compress FILEs (or stdin)\n" \
      "\nOptions:" \
@@ -1536,13 +1520,31 @@ INSERT
 #define halt_full_usage "\n\n" \
        "Halt the system\n" \
      "\nOptions:" \
-     "\n       -d      Delay interval for halting" \
-     "\n       -n      No call to sync()" \
-     "\n       -f      Force halt (don't go through init)" \
+     "\n       -d SEC  Delay interval" \
+     "\n       -n      Do not sync" \
+     "\n       -f      Force (don't go through init)" \
        IF_FEATURE_WTMP( \
      "\n       -w      Only write a wtmp record" \
        )
 
+#define poweroff_trivial_usage \
+       "[-d DELAY] [-n] [-f]"
+#define poweroff_full_usage "\n\n" \
+       "Halt and shut off power\n" \
+     "\nOptions:" \
+     "\n       -d SEC  Delay interval" \
+     "\n       -n      Do not sync" \
+     "\n       -f      Force (don't go through init)" \
+
+#define reboot_trivial_usage \
+       "[-d DELAY] [-n] [-f]"
+#define reboot_full_usage "\n\n" \
+       "Reboot the system\n" \
+     "\nOptions:" \
+     "\n       -d SEC  Delay interval" \
+     "\n       -n      Do not sync" \
+     "\n       -f      Force (don't go through init)" \
+
 #define hdparm_trivial_usage \
        "[OPTIONS] [DEVICE]"
 #define hdparm_full_usage "\n\n" \
@@ -1700,7 +1702,7 @@ INSERT
      "\n       -i              Inetd mode" \
      "\n       -f              Don't daemonize" \
      "\n       -v[v]           Verbose" \
-     "\n       -p [IP:]PORT    Bind to ip:port (default *:80)" \
+     "\n       -p [IP:]PORT    Bind to IP:PORT (default *:80)" \
        IF_FEATURE_HTTPD_SETUID( \
      "\n       -u USER[:GRP]   Set uid/gid after binding to port") \
        IF_FEATURE_HTTPD_BASIC_AUTH( \
@@ -1737,13 +1739,13 @@ INSERT
        "Print information about USER or the current user\n" \
      "\nOptions:" \
        IF_SELINUX( \
-     "\n       -Z      Print the security context" \
+     "\n       -Z      Security context" \
        ) \
-     "\n       -u      Print user ID" \
-     "\n       -g      Print group ID" \
-     "\n       -G      Print supplementary group IDs" \
-     "\n       -n      Print name instead of a number" \
-     "\n       -r      Print real user ID instead of effective ID" \
+     "\n       -u      User ID" \
+     "\n       -g      Group ID" \
+     "\n       -G      Supplementary group IDs" \
+     "\n       -n      Print names instead of numbers" \
+     "\n       -r      Print real ID instead of effective ID" \
 
 #define id_example_usage \
        "$ id\n" \
@@ -1775,10 +1777,10 @@ INSERT
 #define ifenslave_full_usage "\n\n" \
        "Configure network interfaces for parallel routing\n" \
      "\nOptions:" \
-     "\n       -c, --change-active     Change active slave" \
-     "\n       -d, --detach            Remove slave interface from bonding device" \
-     "\n       -f, --force             Force, even if interface is not Ethernet" \
-/*   "\n       -r, --receive-slave     Create a receive-only slave" */
+     "\n       -c,--change-active      Change active slave" \
+     "\n       -d,--detach             Remove slave interface from bonding device" \
+     "\n       -f,--force              Force, even if interface is not Ethernet" \
+/*   "\n       -r,--receive-slave      Create a receive-only slave" */
 
 #define ifenslave_example_usage \
        "To create a bond device, simply follow these three steps:\n" \
@@ -1823,7 +1825,7 @@ INSERT
      "\n       -k              Kill running daemon" \
 
 #define ifup_trivial_usage \
-       "[-ain"IF_FEATURE_IFUPDOWN_MAPPING("m")"vf] IFACE..."
+       "[-an"IF_FEATURE_IFUPDOWN_MAPPING("m")"vf] [-i FILE] IFACE..."
 #define ifup_full_usage "\n\n" \
        "Options:" \
      "\n       -a      De/configure all interfaces automatically" \
@@ -1837,7 +1839,7 @@ INSERT
      "\n       -f      Force de/configuration" \
 
 #define ifdown_trivial_usage \
-       "[-ain"IF_FEATURE_IFUPDOWN_MAPPING("m")"vf] ifaces..."
+       "[-an"IF_FEATURE_IFUPDOWN_MAPPING("m")"vf] [-i FILE] IFACE..."
 #define ifdown_full_usage "\n\n" \
        "Options:" \
      "\n       -a      De/configure all interfaces automatically" \
@@ -2038,14 +2040,6 @@ INSERT
      "\n       -Z      Set security context" \
        )
 
-#define ionice_trivial_usage \
-       "[-c 1-3] [-n 0-7] [-p PID] [PROG]"
-#define ionice_full_usage "\n\n" \
-       "Change I/O scheduling class and priority\n" \
-     "\nOptions:" \
-     "\n       -c      Class. 1:realtime 2:best-effort 3:idle" \
-     "\n       -n      Priority" \
-
 /* would need to make the " | " optional depending on more than one selected: */
 #define ip_trivial_usage \
        "[OPTIONS] {" \
@@ -2332,7 +2326,7 @@ INSERT
        "root\n"
 
 #define logread_trivial_usage \
-       "[OPTIONS]"
+       "[-f]"
 #define logread_full_usage "\n\n" \
        "Show messages in syslogd's circular buffer\n" \
      "\nOptions:" \
@@ -2549,7 +2543,7 @@ INSERT
      "\nOther options are silently ignored" \
 
 #define man_trivial_usage \
-       "[OPTIONS] [MANPAGE]..."
+       "[-aw] [MANPAGE]..."
 #define man_full_usage "\n\n" \
        "Format and display manual page\n" \
      "\nOptions:" \
@@ -2566,8 +2560,8 @@ INSERT
      "\n       -V      Verify file context on disk matches defaults" \
 
 #define md5sum_trivial_usage \
-       "[OPTIONS] [FILE]..." \
-       IF_FEATURE_MD5_SHA1_SUM_CHECK("\n   or: md5sum [OPTIONS] -c [FILE]")
+       "[FILE]..." \
+       IF_FEATURE_MD5_SHA1_SUM_CHECK("\n   or: md5sum -c [-sw] [FILE]")
 #define md5sum_full_usage "\n\n" \
        "Print" IF_FEATURE_MD5_SHA1_SUM_CHECK(" or check") " MD5 checksums" \
        IF_FEATURE_MD5_SHA1_SUM_CHECK( "\n" \
@@ -2588,8 +2582,8 @@ INSERT
        "^D\n"
 
 #define sha1sum_trivial_usage \
-       "[OPTIONS] [FILE]..." \
-       IF_FEATURE_MD5_SHA1_SUM_CHECK("\n   or: sha1sum [OPTIONS] -c [FILE]")
+       "[FILE]..." \
+       IF_FEATURE_MD5_SHA1_SUM_CHECK("\n   or: sha1sum -c [-sw] [FILE]")
 #define sha1sum_full_usage "\n\n" \
        "Print" IF_FEATURE_MD5_SHA1_SUM_CHECK(" or check") " SHA1 checksums" \
        IF_FEATURE_MD5_SHA1_SUM_CHECK( "\n" \
@@ -2600,8 +2594,8 @@ INSERT
        )
 
 #define sha256sum_trivial_usage \
-       "[OPTIONS] [FILE]..." \
-       IF_FEATURE_MD5_SHA1_SUM_CHECK("\n   or: sha256sum [OPTIONS] -c [FILE]")
+       "[FILE]..." \
+       IF_FEATURE_MD5_SHA1_SUM_CHECK("\n   or: sha256sum -c [-sw] [FILE]")
 #define sha256sum_full_usage "\n\n" \
        "Print" IF_FEATURE_MD5_SHA1_SUM_CHECK(" or check") " SHA256 checksums" \
        IF_FEATURE_MD5_SHA1_SUM_CHECK( "\n" \
@@ -2612,8 +2606,8 @@ INSERT
        )
 
 #define sha512sum_trivial_usage \
-       "[OPTIONS] [FILE]..." \
-       IF_FEATURE_MD5_SHA1_SUM_CHECK("\n   or: sha512sum [OPTIONS] -c [FILE]")
+       "[FILE]..." \
+       IF_FEATURE_MD5_SHA1_SUM_CHECK("\n   or: sha512sum -c [-sw] [FILE]")
 #define sha512sum_full_usage "\n\n" \
        "Print" IF_FEATURE_MD5_SHA1_SUM_CHECK(" or check") " SHA512 checksums" \
        IF_FEATURE_MD5_SHA1_SUM_CHECK( "\n" \
@@ -2680,7 +2674,7 @@ INSERT
 #define mkdir_full_usage "\n\n" \
        "Create DIRECTORY\n" \
      "\nOptions:" \
-     "\n       -m      Mode" \
+     "\n       -m MODE Mode" \
      "\n       -p      No error if exists; make parent directories as needed" \
        IF_SELINUX( \
      "\n       -Z      Set security context" \
@@ -2695,9 +2689,9 @@ INSERT
        "$ mkdir -p /tmp/foo/bar/baz\n"
 
 #define mkfifo_trivial_usage \
-       "[OPTIONS] name"
+       "[-m MODE] " IF_SELINUX("[-Z] ") "NAME"
 #define mkfifo_full_usage "\n\n" \
-       "Create named pipe (identical to 'mknod name p')\n" \
+       "Create named pipe\n" \
      "\nOptions:" \
      "\n       -m MODE Mode (default a=rw)" \
        IF_SELINUX( \
@@ -2779,25 +2773,25 @@ INSERT
      "\n       -n LBL  Volume label" \
 
 #define mknod_trivial_usage \
-       "[OPTIONS] NAME TYPE MAJOR MINOR"
+       "[-m MODE] " IF_SELINUX("[-Z] ") "NAME TYPE MAJOR MINOR"
 #define mknod_full_usage "\n\n" \
        "Create a special file (block, character, or pipe)\n" \
      "\nOptions:" \
-     "\n       -m      Create the special file using the specified mode (default a=rw)" \
-     "\nTYPEs include:" \
-     "\n       b:      Make a block device" \
-     "\n       c or u: Make a character device" \
-     "\n       p:      Make a named pipe (MAJOR and MINOR are ignored)" \
+     "\n       -m MODE Creation mode (default a=rw)" \
        IF_SELINUX( \
      "\n       -Z      Set security context" \
-       )
+       ) \
+     "\nTYPEs:" \
+     "\n       b       Block device" \
+     "\n       c or u  Character device" \
+     "\n       p       Named pipe (MAJOR and MINOR are ignored)" \
 
 #define mknod_example_usage \
        "$ mknod /dev/fd0 b 2 0\n" \
        "$ mknod -m 644 /tmp/pipe p\n"
 
 #define mkswap_trivial_usage \
-       "[OPTIONS] BLOCKDEV [KBYTES]"
+       "[-L LBL] BLOCKDEV [KBYTES]"
 #define mkswap_full_usage "\n\n" \
        "Prepare BLOCKDEV to be used as swap partition\n" \
      "\nOptions:" \
@@ -2919,8 +2913,8 @@ INSERT
        "setpart tell unload unlock weof wset" \
 
 #define mv_trivial_usage \
-       "[OPTIONS] SOURCE DEST\n" \
-       "or: mv [OPTIONS] SOURCE... DIRECTORY"
+       "[-fi] SOURCE DEST\n" \
+       "or: mv [-fi] SOURCE... DIRECTORY"
 #define mv_full_usage "\n\n" \
        "Rename SOURCE to DEST, or move SOURCE(s) to DIRECTORY\n" \
      "\nOptions:" \
@@ -2965,13 +2959,6 @@ INSERT
      "\n       -p      Display PID/Program name for sockets" \
        )
 
-#define nice_trivial_usage \
-       "[-n ADJUST] [PROG ARGS]"
-#define nice_full_usage "\n\n" \
-       "Run PROG with modified scheduling priority\n" \
-     "\nOptions:" \
-     "\n       -n ADJUST       Adjust priority by ADJUST" \
-
 #define nmeter_trivial_usage \
        "format_string"
 #define nmeter_full_usage "\n\n" \
@@ -3025,9 +3012,7 @@ INSERT
      "\n       -d      Verbose" \
      "\n       -n      Do not daemonize" \
      "\n       -q      Quit after clock is set" \
-/* -N exists for mostly compat reasons, thus not essential to inform */ \
-/* the user that it exists: user may use nice as well */ \
-/*   "\n       -N      Run at high priority" */ \
+     "\n       -N      Run at high priority" \
      "\n       -w      Do not set time (only query peers), implies -n" \
      "\n       -l      Run as server on port 123" \
      "\n       -S PROG Run PROG after stepping time, stratum change, and every 11 mins" \
@@ -3064,7 +3049,7 @@ INSERT
        "Change USER's password. If no USER is specified,\n" \
        "changes the password for the current user.\n" \
      "\nOptions:" \
-     "\n       -a      Algorithm to use for password (des, md5)" /* ", sha1)" */ \
+     "\n       -a ALG  Algorithm to use for password (des, md5)" /* ", sha1)" */ \
      "\n       -d      Delete password for the account" \
      "\n       -l      Lock (disable) account" \
      "\n       -u      Unlock (re-enable) account" \
@@ -3131,10 +3116,12 @@ INSERT
        "List PIDs of all processes with names that match NAMEs" \
        USAGE_PIDOF \
        IF_FEATURE_PIDOF_SINGLE( \
-     "\n       -s      Show only one PID") \
+     "\n       -s      Show only one PID" \
+       ) \
        IF_FEATURE_PIDOF_OMIT( \
      "\n       -o PID  Omit given pid" \
-     "\n               Use %PPID to omit pid of pidof's parent") \
+     "\n               Use %PPID to omit pid of pidof's parent" \
+       ) \
 
 #define pidof_example_usage \
        "$ pidof init\n" \
@@ -3159,7 +3146,7 @@ INSERT
 #define ping_full_usage "\n\n" \
        "Send ICMP ECHO_REQUEST packets to network hosts\n" \
      "\nOptions:" \
-     "\n       -4, -6          Force IP or IPv6 name resolution" \
+     "\n       -4,-6           Force IP or IPv6 name resolution" \
      "\n       -c CNT          Send only CNT pings" \
      "\n       -s SIZE         Send SIZE data bytes in packets (default:56)" \
      "\n       -I IFACE/IP     Use interface or IP address as source" \
@@ -3254,15 +3241,6 @@ INSERT
        "$ popmaildir -k ~/Maildir -- nc pop.drvv.ru 110 [<password_file]\n" \
        "$ popmaildir ~/Maildir -- openssl s_client -quiet -connect pop.gmail.com:995 [<password_file]\n"
 
-#define poweroff_trivial_usage \
-       "[-d DELAY] [-n] [-f]"
-#define poweroff_full_usage "\n\n" \
-       "Halt and shut off power\n" \
-     "\nOptions:" \
-     "\n       -d      Delay interval for halting" \
-     "\n       -n      Do not sync" \
-     "\n       -f      Force power off (don't go through init)" \
-
 #define printenv_trivial_usage \
        "[VARIABLE]..."
 #define printenv_full_usage "\n\n" \
@@ -3405,15 +3383,6 @@ INSERT
 #define realpath_full_usage "\n\n" \
        "Return the absolute pathnames of given FILE"
 
-#define reboot_trivial_usage \
-       "[-d DELAY] [-n] [-f]"
-#define reboot_full_usage "\n\n" \
-       "Reboot the system\n" \
-     "\nOptions:" \
-     "\n       -d      Delay interval for rebooting" \
-     "\n       -n      No call to sync()" \
-     "\n       -f      Force reboot (don't go through init)" \
-
 #define reformime_trivial_usage \
        "[OPTIONS] [FILE]..."
 #define reformime_full_usage "\n\n" \
@@ -3425,16 +3394,6 @@ INSERT
      "\n" \
      "\nOther options are silently ignored" \
 
-#define renice_trivial_usage \
-       "{{-n INCREMENT} | PRIORITY} [[-p | -g | -u] ID...]"
-#define renice_full_usage "\n\n" \
-       "Change priority of running processes\n" \
-     "\nOptions:" \
-     "\n       -n      Adjust current nice value (smaller is faster)" \
-     "\n       -p      Process id(s) (default)" \
-     "\n       -g      Process group id(s)" \
-     "\n       -u      Process user name(s) and/or id(s)" \
-
 #define scriptreplay_trivial_usage \
        "timingfile [typescript [divisor]]"
 #define scriptreplay_full_usage "\n\n" \
@@ -3479,7 +3438,7 @@ INSERT
      "\n               wimax, wwan, gps, fm" \
 
 #define rm_trivial_usage \
-       "[OPTIONS] FILE..."
+       "[-irf] FILE..."
 #define rm_full_usage "\n\n" \
        "Remove (unlink) FILEs\n" \
      "\nOptions:" \
@@ -3507,12 +3466,12 @@ INSERT
        "# rmdir /tmp/foo\n"
 
 #define rmmod_trivial_usage \
-       "[OPTIONS] [MODULE]..."
+       "[-wfa] [MODULE]..."
 #define rmmod_full_usage "\n\n" \
-       "Unload the specified kernel modules from the kernel\n" \
+       "Unload kernel modules\n" \
      "\nOptions:" \
      "\n       -w      Wait until the module is no longer used" \
-     "\n       -f      Force unloading" \
+     "\n       -f      Force unload" \
      "\n       -a      Remove all unused modules (recursively)" \
 
 #define rmmod_example_usage \
@@ -3897,9 +3856,9 @@ INSERT
        "[OPTIONS] [INPUT [PREFIX]]"
 #define split_full_usage "\n\n" \
        "Options:" \
-     "\n       -b n[k|m]       Split by bytes" \
-     "\n       -l n            Split by lines" \
-     "\n       -a n            Use n letters as suffix" \
+     "\n       -b N[k|m]       Split by N (kilo|mega)bytes" \
+     "\n       -l N            Split by N lines" \
+     "\n       -a N            Use N letters as suffix" \
 
 #define split_example_usage \
        "$ split TODO foo\n" \
@@ -4128,7 +4087,7 @@ INSERT
        "Write all buffered blocks to disk"
 
 #define fsync_trivial_usage \
-       "[OPTIONS] FILE..."
+       "[-d] FILE..."
 #define fsync_full_usage "\n\n" \
        "Write files' buffered blocks to disk\n" \
      "\nOptions:" \
@@ -4204,7 +4163,7 @@ INSERT
        "pid 1's current affinity mask: 3\n"
 
 #define tee_trivial_usage \
-       "[OPTIONS] [FILE]..."
+       "[-ai] [FILE]..."
 #define tee_full_usage "\n\n" \
        "Copy stdin to each FILE, and also to stdout\n" \
      "\nOptions:" \
@@ -4365,7 +4324,7 @@ INSERT
      "\n       -u      Access files as USER" \
 
 #define time_trivial_usage \
-       "[OPTIONS] PROG ARGS"
+       "[-v] PROG ARGS"
 #define time_full_usage "\n\n" \
        "Run PROG, display resource usage when it exits\n" \
      "\nOptions:" \
@@ -4421,7 +4380,7 @@ INSERT
        "Trace the route to HOST\n" \
      "\nOptions:" \
        IF_TRACEROUTE6( \
-     "\n       -4, -6  Force IP or IPv6 name resolution" \
+     "\n       -4,-6   Force IP or IPv6 name resolution" \
        ) \
      "\n       -F      Set the don't fragment bit" \
      "\n       -I      Use ICMP ECHO instead of UDP datagrams" \
@@ -4501,20 +4460,13 @@ INSERT
        "# tunctl\n" \
        "# tunctl -d tun0\n"
 
-#define tune2fs_trivial_usage \
-/*     "[-c max-mounts-count] [-e errors-behavior] [-g group] " */ \
-/*     "[-i interval[d|m|w]] [-j] [-J journal-options] [-l] [-s sparse-flag] " */ \
-/*     "[-m reserved-blocks-percent] [-o [^]mount-options[,...]] " */ \
-/*     "[-r reserved-blocks-count] [-u user] [-C mount-count] " */ \
-       "[-L LABEL] " \
-/*     "[-M last-mounted-dir] [-O [^]feature[,...]] " */ \
-/*     "[-T last-check-time] [-U UUID] " */ \
-       "BLOCKDEV"
-#define tune2fs_full_usage "\n\n" \
-       "Adjust filesystem options on ext[23] filesystems"
-
+#if defined CONFIG_UDHCP_DEBUG && CONFIG_UDHCP_DEBUG >= 1
+# define IF_UDHCP_VERBOSE(...) __VA_ARGS__
+#else
+# define IF_UDHCP_VERBOSE(...)
+#endif
 #define udhcpc_trivial_usage \
-       "[-fbnqvoCR] [-i IFACE] [-r IP] [-s PROG] [-p PIDFILE]\n" \
+       "[-fbnq"IF_UDHCP_VERBOSE("v")"oCR] [-i IFACE] [-r IP] [-s PROG] [-p PIDFILE]\n" \
        "       [-H HOSTNAME] [-c CID] [-V VENDOR] [-O DHCP_OPT]..." IF_FEATURE_UDHCP_PORT(" [-P N]")
 #define udhcpc_full_usage "\n" \
        IF_LONG_OPTS( \
@@ -4547,6 +4499,9 @@ INSERT
      "\n       -V,--vendorclass VENDOR Vendor identifier (default 'udhcp VERSION')" \
      "\n       -c,--clientid CLIENTID  Client identifier (default own MAC)" \
      "\n       -C,--clientid-none      Don't send client identifier" \
+       IF_UDHCP_VERBOSE( \
+     "\n       -v                      Verbose" \
+       ) \
        ) \
        IF_NOT_LONG_OPTS( \
      "\n       -i IFACE        Interface to use (default eth0)" \
@@ -4578,10 +4533,13 @@ INSERT
      "\n       -V VENDOR       Vendor identifier (default 'udhcp VERSION')" \
      "\n       -c CLIENTID     Client identifier (default own MAC)" \
      "\n       -C              Don't send client identifier" \
-       )
+       IF_UDHCP_VERBOSE( \
+     "\n       -v              Verbose" \
+       ) \
+       ) \
 
 #define udhcpd_trivial_usage \
-       "[-fS]" IF_FEATURE_UDHCP_PORT(" [-P N]") " [configfile]" \
+       "[-fS]" IF_FEATURE_UDHCP_PORT(" [-P N]") " [CONFFILE]" \
 
 #define udhcpd_full_usage "\n\n" \
        "DHCP server\n" \
@@ -4745,13 +4703,15 @@ INSERT
        "Edit FILE\n" \
      "\nOptions:" \
        IF_FEATURE_VI_COLON( \
-     "\n       -c      Initial command to run ($EXINIT also available)") \
+     "\n       -c      Initial command to run ($EXINIT also available)" \
+       ) \
        IF_FEATURE_VI_READONLY( \
-     "\n       -R      Read-only") \
+     "\n       -R      Read-only" \
+       ) \
      "\n       -H      Short help regarding available features" \
 
 #define vlock_trivial_usage \
-       "[OPTIONS]"
+       "[-a]"
 #define vlock_full_usage "\n\n" \
        "Lock a virtual terminal. A password is required to unlock.\n" \
      "\nOptions:" \
@@ -4795,29 +4755,16 @@ INSERT
      "\n" \
      "\nUse 500ms to specify period in milliseconds" \
 
-#define wc_trivial_usage \
-       "[OPTIONS] [FILE]..."
-#define wc_full_usage "\n\n" \
-       "Print line, word, and byte counts for each FILE (or stdin),\n" \
-       "and a total line if more than one FILE is specified\n" \
-     "\nOptions:" \
-     "\n       -c      Print the byte counts" \
-     "\n       -l      Print the newline counts" \
-     "\n       -L      Print the length of the longest line" \
-     "\n       -w      Print the word counts" \
-
-#define wc_example_usage \
-       "$ wc /etc/passwd\n" \
-       "     31      46    1365 /etc/passwd\n"
-
 #define wget_trivial_usage \
        IF_FEATURE_WGET_LONG_OPTIONS( \
        "[-c|--continue] [-s|--spider] [-q|--quiet] [-O|--output-document FILE]\n" \
        "       [--header 'header: value'] [-Y|--proxy on/off] [-P DIR]\n" \
-       "       [--no-check-certificate] [-U|--user-agent AGENT] URL" \
+       "       [--no-check-certificate] [-U|--user-agent AGENT]" \
+                       IF_FEATURE_WGET_TIMEOUT("[-T SEC] ") " URL" \
        ) \
        IF_NOT_FEATURE_WGET_LONG_OPTIONS( \
-       "[-csq] [-O FILE] [-Y on/off] [-P DIR] [-U AGENT] URL" \
+       "[-csq] [-O FILE] [-Y on/off] [-P DIR] [-U AGENT]" \
+                       IF_FEATURE_WGET_TIMEOUT("[-T SEC] ") " URL" \
        )
 #define wget_full_usage "\n\n" \
        "Retrieve files via HTTP or FTP\n" \
@@ -4825,7 +4772,10 @@ INSERT
      "\n       -s      Spider mode - only check file existence" \
      "\n       -c      Continue retrieval of aborted transfer" \
      "\n       -q      Quiet" \
-     "\n       -P      Set directory prefix to DIR" \
+     "\n       -P DIR  Save to DIR (default .)" \
+       IF_FEATURE_WGET_TIMEOUT( \
+     "\n       -T SEC  Network read timeout is SEC seconds" \
+       ) \
      "\n       -O FILE Save to FILE ('-' for stdout)" \
      "\n       -U STR  Use STR for User-Agent header" \
      "\n       -Y      Use proxy ('on' or 'off')" \