cp: FEATURE_CP_LONG_OPTIONS depends on LONG_OPTS
[oweals/busybox.git] / include / usage.h
index 53ae0a8ccb5fd6c0ddb5552dd919e615bcd35cfe..c7013de22ccbee4e8480dda99bb49cb45ca74aad 100644 (file)
 #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 bbsh_trivial_usage \
-       "[FILE]...\n" \
-       "or: bbsh -c command [args]..."
-#define bbsh_full_usage "\n\n" \
-       "The bbsh shell (command interpreter)"
 
 #define awk_trivial_usage \
        "[OPTIONS] [AWK_PROGRAM] [FILE]..."
 #define basename_trivial_usage \
        "FILE [SUFFIX]"
 #define basename_full_usage "\n\n" \
-       "Strip directory path and suffixes from FILE.\n" \
-       "If specified, also remove any trailing SUFFIX."
+       "Strip directory path and .SUFFIX from FILE\n"
 #define basename_example_usage \
        "$ basename /usr/local/bin/foo\n" \
        "foo\n" \
        "$ basename /foo/bar.txt .txt\n" \
        "bar"
 
+#define beep_trivial_usage \
+       "-f freq -l length -d delay -r repetitions -n"
+#define beep_full_usage "\n\n" \
+       "Options:" \
+     "\n       -f      Frequency in Hz" \
+     "\n       -l      Length in ms" \
+     "\n       -d      Delay in ms" \
+     "\n       -r      Repetitions" \
+     "\n       -n      Start new tone" \
+
 #define fbsplash_trivial_usage \
        "-s IMGFILE [-c] [-d DEV] [-i INIFILE] [-f CMD]"
 #define fbsplash_full_usage "\n\n" \
-       "Options:\n" \
+       "Options:" \
      "\n       -s      Image" \
      "\n       -c      Hide cursor" \
      "\n       -d      Framebuffer device (default /dev/fb0)" \
 #define brctl_trivial_usage \
        "COMMAND [BRIDGE [INTERFACE]]"
 #define brctl_full_usage "\n\n" \
-       "Manage ethernet bridges.\n" \
+       "Manage ethernet bridges\n" \
      "\nCommands:" \
        IF_FEATURE_BRCTL_SHOW( \
      "\n       show                    Show a list of bridges" \
      "\n       -r,--role=ROLE          security context" \
      "\n       -t,--type=TYPE" \
      "\n       -l,--range=RANGE" \
-     "\n       -R,--recursive          Recurse subdirectories" \
+     "\n       -R,--recursive          Recurse" \
        ) \
        IF_NOT_FEATURE_CHCON_LONG_OPTIONS( \
      "\n       -v      Verbose" \
      "\n       -r ROLE" \
      "\n       -t TYPE" \
      "\n       -l RNG" \
-     "\n       -R      Recurse subdirectories" \
+     "\n       -R      Recurse" \
        )
 
 #define chmod_trivial_usage \
        "Each MODE is one or more of the letters ugoa, one of the\n" \
        "symbols +-= and one or more of the letters rwxst\n" \
      "\nOptions:" \
-     "\n       -R      Recurse directories" \
+     "\n       -R      Recurse" \
        IF_DESKTOP( \
      "\n       -c      List changed files" \
      "\n       -v      List all files" \
 #define chgrp_full_usage "\n\n" \
        "Change the group membership of each FILE to GROUP\n" \
      "\nOptions:" \
-     "\n       -R      Recurse directories" \
+     "\n       -R      Recurse" \
      "\n       -h      Affect symlinks instead of symlink targets" \
      "\n       -L      Traverse all symlinks to directories" \
      "\n       -H      Traverse symlinks on command line only" \
 #define chown_full_usage "\n\n" \
        "Change the owner and/or group of each FILE to OWNER and/or GROUP\n" \
      "\nOptions:" \
-     "\n       -R      Recurse directories" \
+     "\n       -R      Recurse" \
      "\n       -h      Affect symlinks instead of symlink targets" \
      "\n       -L      Traverse all symlinks to directories" \
      "\n       -H      Traverse symlinks on command line only" \
      "\n       -p      Preserve file attributes if possible" \
      "\n       -f      Force overwrite" \
      "\n       -i      Prompt before overwrite" \
-     "\n       -R,-r   Recurse directories" \
+     "\n       -R,-r   Recurse" \
      "\n       -l,-s   Create (sym)links" \
 
 #define cpio_trivial_usage \
 #define date_full_usage "\n\n" \
        "Display time (using +FMT), or set time\n" \
      "\nOptions:" \
+     "\n       [-s] TIME       Set time to TIME" \
      "\n       -u              Work in UTC (don't convert to local time)" \
      "\n       -R              Output RFC-822 compliant date string" \
        IF_FEATURE_DATE_ISOFMT( \
      "\n                       'hours', 'minutes', or 'seconds' for date and" \
      "\n                       time to the indicated precision" \
        ) \
-     "\n       -d TIME         Display TIME, not 'now'" \
      "\n       -r FILE         Display last modification time of FILE" \
-     "\n       [-s] TIME       Set time to TIME" \
+     "\n       -d TIME         Display TIME, not 'now'" \
        IF_FEATURE_DATE_ISOFMT( \
-     "\n       -D FMT          Use FMT for str->date conversion" \
+     "\n       -D FMT          Use FMT for -d TIME conversion" \
        ) \
      "\n" \
      "\nRecognized formats for TIME:" \
      "\n       hh:mm[:ss]" \
      "\n       [YYYY.]MM.DD-hh:mm[:ss]" \
      "\n       YYYY-MM-DD hh:mm[:ss]" \
-     "\n       MMDDhhmm[[YY]YY][.ss]" \
+     "\n       [[[[[YY]YY]MM]DD]hh]mm[.ss]" \
 
 #define date_example_usage \
        "$ date\n" \
 #define expand_trivial_usage \
        "[-i] [-t NUM] [FILE|-]"
 #define expand_full_usage "\n\n" \
-       "Convert tabs to spaces, writing to standard output.\n" \
+       "Convert tabs to spaces, writing to standard output\n" \
      "\nOptions:" \
        IF_FEATURE_EXPAND_LONG_OPTIONS( \
      "\n       -i,--initial    Do not convert tabs after non blanks" \
 #define expr_trivial_usage \
        "EXPRESSION"
 #define expr_full_usage "\n\n" \
-       "Print the value of EXPRESSION to standard output.\n" \
-       "\n" \
+       "Print the value of EXPRESSION to standard output\n" \
+    "\n" \
        "EXPRESSION may be:\n" \
        "       ARG1 | ARG2     ARG1 if it is neither null nor 0, otherwise ARG2\n" \
        "       ARG1 & ARG2     ARG1 if neither argument is null or 0, otherwise 0\n" \
      "\n       -i      Inetd mode" \
      "\n       -w      Inetd 'wait' mode" \
      "\n       -b ADDR Bind to specified address" \
-     "\n       STRING  Ident answer string (default is 'nobody')" \
+     "\n       STRING  Ident answer string (default: nobody)" \
 
 #define false_trivial_usage \
        ""
 #define ftpd_trivial_usage \
        "[-wvS] [-t N] [-T N] [DIR]"
 #define ftpd_full_usage "\n\n" \
-       "FTP server\n" \
+       "Anonymous FTP server\n" \
        "\n" \
        "ftpd should be used as an inetd service.\n" \
        "ftpd's line for inetd.conf:\n" \
 #define getopt_trivial_usage \
        "[OPTIONS]"
 #define getopt_full_usage "\n\n" \
-       "Parse options\n" \
+       "Options:" \
        IF_LONG_OPTS( \
      "\n       -a,--alternative                Allow long options starting with single -" \
      "\n       -l,--longoptions=longopts       Long options to be recognized" \
      "\n       -m              Get baud rate from modem's CONNECT status message" \
      "\n       -w              Wait for a CR or LF before sending /etc/issue" \
      "\n       -n              Do not prompt the user for a login name" \
-     "\n       -f issue_file   Display issue_file instead of /etc/issue" \
-     "\n       -l login_app    Invoke login_app instead of /bin/login" \
-     "\n       -t timeout      Terminate after timeout if no username is read" \
-     "\n       -I initstring   Init string to send before anything else" \
-     "\n       -H login_host   Log login_host into the utmp file as the hostname" \
+     "\n       -f ISSUE_FILE   Display ISSUE_FILE instead of /etc/issue" \
+     "\n       -l LOGIN        Invoke LOGIN instead of /bin/login" \
+     "\n       -t SEC          Terminate after SEC if no username is read" \
+     "\n       -I INITSTR      Send INITSTR before anything else" \
+     "\n       -H HOST         Log HOST into the utmp file as the hostname" \
 
 #define grep_trivial_usage \
        "[-HhrilLnqvso" \
      "\nOptions:" \
      "\n       -H      Prefix output lines with filename where match was found" \
      "\n       -h      Suppress the prefixing filename on output" \
-     "\n       -r      Recurse subdirectories" \
+     "\n       -r      Recurse" \
      "\n       -i      Ignore case distinctions" \
      "\n       -l      List names of files that match" \
      "\n       -L      List names of files that do not match" \
 #define ifplugd_trivial_usage \
        "[OPTIONS]"
 #define ifplugd_full_usage "\n\n" \
-       "Network interface plug detection daemon.\n\n" \
-       "Options:\n" \
+       "Network interface plug detection daemon\n" \
+     "\nOptions:" \
      "\n       -n              Do not daemonize" \
      "\n       -s              Do not log to syslog" \
      "\n       -i IFACE        Interface" \
      "\n       a       File is accessed" \
      "\n       c       File is modified" \
      "\n       e       Metadata changed" \
-     "\n       w       Writtable file is closed" \
-     "\n       0       Unwrittable file is closed" \
+     "\n       w       Writable file is closed" \
+     "\n       0       Unwritable file is closed" \
      "\n       r       File is opened" \
      "\n       D       File is deleted" \
      "\n       M       File is moved" \
        "[-a|k|s|u] [-C TTY]"
 #define kbd_mode_full_usage "\n\n" \
        "Report or set the keyboard mode\n" \
-     "\nOptions set mode:" \
+     "\nOptions:" \
      "\n       -a      Default (ASCII)" \
      "\n       -k      Medium-raw (keyboard)" \
      "\n       -s      Raw (scancode)" \
 #define kill_trivial_usage \
        "[-l] [-SIG] PID..."
 #define kill_full_usage "\n\n" \
-       "Send a signal (default is TERM) to given PIDs\n" \
+       "Send a signal (default: TERM) to given PIDs\n" \
      "\nOptions:" \
      "\n       -l      List all signal names and numbers" \
 /*   "\n       -s SIG  Yet another way of specifying SIG" */ \
 #define killall_trivial_usage \
        "[-l] [-q] [-SIG] process-name..."
 #define killall_full_usage "\n\n" \
-       "Send a signal (default is TERM) to given processes\n" \
+       "Send a signal (default: TERM) to given processes\n" \
      "\nOptions:" \
      "\n       -l      List all signal names and numbers" \
 /*   "\n       -s SIG  Yet another way of specifying SIG" */ \
 #define killall5_trivial_usage \
        "[-l] [-SIG] [-o PID]..."
 #define killall5_full_usage "\n\n" \
-       "Send a signal (default is TERM) to all processes outside current session\n" \
+       "Send a signal (default: TERM) to all processes outside current session\n" \
      "\nOptions:" \
      "\n       -l      List all signal names and numbers" \
      "\n       -o PID  Do not signal this PID" \
        "changed, and files can be manipulated in various ways.\n" \
      "\nOptions:" \
      "\n       -E      Quit once the end of a file is reached" \
-     "\n       -M,-m   Display a status line containing the line numbers" \
+     "\n       -M,-m   Display status line with line numbers" \
      "\n               and percentage through the file" \
-     "\n       -N      Prefix line numbers to each line" \
+     "\n       -N      Prefix line number to each line" \
      "\n       -I      Ignore case in all searches" \
      "\n       -~      Suppress ~s displayed past the end of the file" \
 
        "       linux64         Set 64bit uname emulation" \
 
 #define ln_trivial_usage \
-       "[OPTIONS] TARGET... LINK_NAME|DIRECTORY"
+       "[OPTIONS] TARGET... LINK|DIRECTORY"
 #define ln_full_usage "\n\n" \
-       "Create a link named LINK_NAME or DIRECTORY to the specified TARGET.\n" \
-       "Use '--' to indicate that all following arguments are non-options.\n" \
+       "Create a link LINK or DIRECTORY/TARGET to the specified TARGET(s)\n" \
      "\nOptions:" \
      "\n       -s      Make symlinks instead of hardlinks" \
      "\n       -f      Remove existing destination files" \
 #define makemime_trivial_usage \
        "[OPTIONS] [FILE]..."
 #define makemime_full_usage "\n\n" \
-       "Create multipart MIME-encoded message from FILEs.\n" \
+       "Create multipart MIME-encoded message from FILEs\n" \
 /*     "Transfer encoding is base64, disposition is inline (not attachment)\n" */ \
      "\nOptions:" \
      "\n       -o FILE Output. Default: stdout" \
        "[OPTIONS] [FILE]..." \
        IF_FEATURE_MD5_SHA1_SUM_CHECK("\n   or: sha1sum [OPTIONS] -c [FILE]")
 #define sha1sum_full_usage "\n\n" \
-       "Print" IF_FEATURE_MD5_SHA1_SUM_CHECK(" or check") " SHA1 checksums." \
+       "Print" IF_FEATURE_MD5_SHA1_SUM_CHECK(" or check") " SHA1 checksums" \
        IF_FEATURE_MD5_SHA1_SUM_CHECK( "\n" \
      "\nOptions:" \
      "\n       -c      Check sums against given list" \
        "[OPTIONS] [FILE]..." \
        IF_FEATURE_MD5_SHA1_SUM_CHECK("\n   or: sha256sum [OPTIONS] -c [FILE]")
 #define sha256sum_full_usage "\n\n" \
-       "Print" IF_FEATURE_MD5_SHA1_SUM_CHECK(" or check") " SHA1 checksums." \
+       "Print" IF_FEATURE_MD5_SHA1_SUM_CHECK(" or check") " SHA256 checksums" \
        IF_FEATURE_MD5_SHA1_SUM_CHECK( "\n" \
      "\nOptions:" \
      "\n       -c      Check sums against given list" \
        "[OPTIONS] [FILE]..." \
        IF_FEATURE_MD5_SHA1_SUM_CHECK("\n   or: sha512sum [OPTIONS] -c [FILE]")
 #define sha512sum_full_usage "\n\n" \
-       "Print" IF_FEATURE_MD5_SHA1_SUM_CHECK(" or check") " SHA1 checksums." \
+       "Print" IF_FEATURE_MD5_SHA1_SUM_CHECK(" or check") " SHA512 checksums" \
        IF_FEATURE_MD5_SHA1_SUM_CHECK( "\n" \
      "\nOptions:" \
      "\n       -c      Check sums against given list" \
 #define mkdir_full_usage "\n\n" \
        "Create DIRECTORY\n" \
      "\nOptions:" \
-     "\n       -m      Set permission mode (as in chmod), not rwxrwxrwx - umask" \
-     "\n       -p      No error if existing, make parent directories as needed" \
+     "\n       -m      Mode" \
+     "\n       -p      No error if exists; make parent directories as needed" \
        IF_SELINUX( \
      "\n       -Z      Set security context" \
        )
        "-rw-------    1 andersen andersen        0 Apr 25 17:10 /tmp/temp.mWiLjM\n"
 
 #define modprobe_trivial_usage \
-       "[-knqrsv] MODULE [symbol=value...]"
+       IF_MODPROBE_SMALL("[-qfwrsv] MODULE [symbol=value...]") \
+       IF_NOT_MODPROBE_SMALL("[-" \
+               IF_FEATURE_2_4_MODULES("k")"nqrsv" \
+               IF_FEATURE_MODPROBE_BLACKLIST("b")"] MODULE [symbol=value...]")
 #define modprobe_full_usage "\n\n" \
        "Options:" \
+       IF_MODPROBE_SMALL( \
+     "\n       -q      Quiet" \
+     "\n       -f      Force" \
+     "\n       -w      Wait for unload" \
+     "\n       -r      Remove module (stacks) or do autoclean" \
+     "\n       -s      Report via syslog instead of stderr" \
+     "\n       -v      Verbose" \
+       ) \
+       IF_NOT_MODPROBE_SMALL( \
        IF_FEATURE_2_4_MODULES( \
      "\n       -k      Make module autoclean-able" \
        ) \
      "\n       -v      Verbose" \
        IF_FEATURE_MODPROBE_BLACKLIST( \
      "\n       -b      Apply blacklist to module names too" \
-        )
+       ) \
+       )
 
 #define modprobe_notes_usage \
 "modprobe can (un)load a stack of modules, passing each module options (when\n" \
 #define mount_trivial_usage \
        "[flags] DEVICE NODE [-o OPT,OPT]"
 #define mount_full_usage "\n\n" \
-       "Mount a filesystem. Filesystem autodetection requires /proc be mounted.\n" \
+       "Mount a filesystem. Filesystem autodetection requires /proc.\n" \
      "\nOptions:" \
      "\n       -a              Mount all filesystems in fstab" \
        IF_FEATURE_MOUNT_FAKE( \
 #define nameif_full_usage "\n\n" \
        "Rename network interface while it in the down state\n" \
      "\nOptions:" \
-     "\n       -c FILE         Use configuration file (default is /etc/mactab)" \
+     "\n       -c FILE         Use configuration file (default: /etc/mactab)" \
      "\n       -s              Use syslog (LOCAL0 facility)" \
      "\n       IFNAME MACADDR  new_interface_name interface_mac_address" \
 
 #define chpasswd_trivial_usage \
        IF_LONG_OPTS("[--md5|--encrypted]") IF_NOT_LONG_OPTS("[-m|-e]")
 #define chpasswd_full_usage "\n\n" \
-       "Read user:password information from stdin " \
-       "and update /etc/passwd accordingly.\n" \
+       "Read user:password from stdin and update /etc/passwd\n" \
      "\nOptions:" \
        IF_LONG_OPTS( \
      "\n       -e,--encrypted  Supplied passwords are in encrypted form" \
        )
 
 #define patch_trivial_usage \
-       "[-p NUM] [-i DIFF] [-R]"
+       "[-p NUM] [-i DIFF] [-R] [-N]"
 #define patch_full_usage "\n\n" \
        "       -p NUM  Strip NUM leading components from file names" \
      "\n       -i DIFF Read DIFF instead of stdin" \
      "\n       -R      Reverse patch" \
+     "\n       -N      Ignore already applied patches" \
 
 #define patch_example_usage \
        "$ patch -p1 < example.diff\n" \
      "\n       -s              Skip authorization" \
      "\n       -T              Get messages with TOP instead with RETR" \
      "\n       -k              Keep retrieved messages on the server" \
-     "\n       -t timeout      Set network timeout" \
-     IF_FEATURE_POPMAILDIR_DELIVERY( \
+     "\n       -t timeout      Network timeout" \
+       IF_FEATURE_POPMAILDIR_DELIVERY( \
      "\n       -F \"program arg1 arg2 ...\"    Filter by program. May be multiple" \
      "\n       -M \"program arg1 arg2 ...\"    Deliver by program" \
-     ) \
+       ) \
      "\n       -R size         Remove old messages on the server >= size (in bytes). Ignored" \
      "\n       -Z N1-N2        Remove messages from N1 to N2 (dangerous). Ignored" \
      "\n       -L size         Do not retrieve new messages >= size (in bytes). Ignored" \
      "\n       -f      Force power off (don't go through init)" \
 
 #define printenv_trivial_usage \
-       "[VARIABLES...]"
+       "[VARIABLE...]"
 #define printenv_full_usage "\n\n" \
        "Print all or part of environment.\n" \
        "If no environment VARIABLE specified, print them all."
        "Report process status\n" \
      "\nOptions:" \
      "\n       -o col1,col2=header     Select columns for display" \
+       IF_FEATURE_SHOW_THREADS( \
+     "\n       -T                      Show threads" \
+       )
 
 #else /* !ENABLE_DESKTOP */
 
      "\n       -i              Ignore files that do not exist" \
      "\n       -f file         File with list of files to process. Use - for stdin" \
      "\n       -e directory    Directory to exclude" \
-     "\n       -R,-r           Recurse directories" \
+     "\n       -R,-r           Recurse" \
      "\n       -n              Don't change any file labels" \
      "\n       -o file         Save list of files with incorrect context" \
      "\n       -v              Verbose" \
 #define rmdir_trivial_usage \
        "[OPTIONS] DIRECTORY..."
 #define rmdir_full_usage "\n\n" \
-       "Remove the DIRECTORY, if it is empty.\n" \
+       "Remove the DIRECTORY, if it is empty\n" \
      "\nOptions:" \
-     IF_FEATURE_RMDIR_LONG_OPTIONS( \
+       IF_FEATURE_RMDIR_LONG_OPTIONS( \
      "\n       -p|--parents    Include parents" \
-     "\n       -ignore-fail-on-non-empty" \
-     ) \
-     IF_NOT_FEATURE_RMDIR_LONG_OPTIONS( \
+     "\n       --ignore-fail-on-non-empty" \
+       ) \
+       IF_NOT_FEATURE_RMDIR_LONG_OPTIONS( \
      "\n       -p      Include parents" \
-     )
+       )
 
 #define rmdir_example_usage \
        "# rmdir /tmp/foo\n"
 #define runlevel_trivial_usage \
        "[utmp]"
 #define runlevel_full_usage "\n\n" \
-       "Find the current and previous system runlevel.\n\n" \
+       "Find the current and previous system runlevel\n" \
+       "\n" \
        "If no utmp file exists or if no runlevel record can be found,\n" \
        "print \"unknown\""
 #define runlevel_example_usage \
      "\n       -l      Log changes in file labels to syslog" \
      "\n       -n      Don't change any file labels" \
      "\n       -q      Suppress warnings" \
-     "\n       -r dir  Use an altenate root path" \
+     "\n       -r dir  Use an alternate root path" \
      "\n       -e dir  Exclude directory" \
      "\n       -F      Force reset of context to match file_context for customizable files" \
      "\n       -o file Save list of files with incorrect context" \
        "and will not be affected by keyboard signals (Ctrl-C etc).\n" \
        "See setsid(2) for details." \
 
-#define lash_trivial_usage \
-       "[FILE]...\n" \
-       "or: sh -c command [args]..."
-#define lash_full_usage "\n\n" \
-       "lash is deprecated, please use hush"
-
 #define last_trivial_usage \
        ""IF_FEATURE_LAST_FANCY("[-HW] [-f file]")
 #define last_full_usage "\n\n" \
 #define svlogd_trivial_usage \
        "[-ttv] [-r c] [-R abc] [-l len] [-b buflen] dir..."
 #define svlogd_full_usage "\n\n" \
-       "Continuously read log data from standard input, optionally " \
-       "filter log messages, and write the data to one or more automatically " \
+       "Continuously read log data from standard input, optionally\n" \
+       "filter log messages, and write the data to one or more automatically\n" \
        "rotated logs" \
 
 #define swapoff_trivial_usage \
        IF_NOT_FEATURE_TELNETD_STANDALONE(" via inetd") "\n" \
      "\nOptions:" \
      "\n       -l LOGIN        Exec LOGIN on connect" \
-     "\n       -f issue_file   Display issue_file instead of /etc/issue" \
+     "\n       -f ISSUE_FILE   Display ISSUE_FILE instead of /etc/issue" \
      "\n       -K              Close connection as soon as login exits" \
      "\n                       (normally wait until all programs close slave pty)" \
        IF_FEATURE_TELNETD_STANDALONE( \
      "\n       -p PORT         Port to listen on" \
-     "\n       -b ADDR         Address to bind to" \
+     "\n       -b ADDR[:PORT]  Address to bind to" \
      "\n       -F              Run in foreground" \
-     "\n       -i              Run as inetd subservice" \
+     "\n       -i              Run as inetd service" \
+       IF_FEATURE_TELNETD_INETD_WAIT( \
+     "\n       -w SEC          Run as inetd service in wait mode, linger time SEC" \
+     "\n       -S              Log to syslog (implied by -i or without -F and -w)" \
+       ) \
        )
 
 /* "test --help" does not print help (POSIX compat), only "[ --help" does.
 #define tftpd_trivial_usage \
        "[-cr] [-u USER] [DIR]"
 #define tftpd_full_usage "\n\n" \
-       "Transfer a file on tftp client's request.\n" \
+       "Transfer a file on tftp client's request\n" \
        "\n" \
        "tftpd should be used as an inetd service.\n" \
        "tftpd's line for inetd.conf:\n" \
        "Defaults: SECS: 10, SIG: TERM." \
 
 #define top_trivial_usage \
-       "[-b] [-nCOUNT] [-dSECONDS]"
+       "[-b] [-nCOUNT] [-dSECONDS]" IF_FEATURE_TOPMEM(" [-m]")
 #define top_full_usage "\n\n" \
        "Provide a view of process activity in real time.\n" \
        "Read the status of all processes from /proc each SECONDS\n" \
        "and show the status for however many processes will fit on the screen." \
 
 #define touch_trivial_usage \
-       "[-c] FILE [FILE]..."
+       "[-c] [-d DATE] FILE [FILE]..."
 #define touch_full_usage "\n\n" \
        "Update the last-modified date on the given FILE[s]\n" \
      "\nOptions:" \
-     "\n       -c      Do not create any files" \
+     "\n       -c      Do not create files" \
+     "\n       -d DT   Date/time to use" \
 
 #define touch_example_usage \
        "$ ls -l /tmp/foo\n" \
      "\n       -v      Verbose" \
      "\n       -m max_ttl      Max time-to-live (max number of hops)" \
      "\n       -p port#        Base UDP port number used in probes" \
-     "\n                       (default is 33434)" \
+     "\n                       (default 33434)" \
      "\n       -q nqueries     Number of probes per 'ttl' (default 3)" \
      "\n       -s src_addr     IP address to use as the source address" \
      "\n       -t tos          Type-of-service in probe packets (default 0)" \
 #define tunctl_trivial_usage \
        "[-f device] ([-t name] | -d name)" IF_FEATURE_TUNCTL_UG(" [-u owner] [-g group] [-b]")
 #define tunctl_full_usage "\n\n" \
-       "Create or delete tun interfaces" \
+       "Create or delete tun interfaces\n" \
      "\nOptions:" \
      "\n       -f name         tun device (/dev/net/tun)" \
      "\n       -t name         Create iface 'name'" \
@@ -4758,7 +4779,7 @@ IF_FEATURE_TUNCTL_UG( \
 #define uname_trivial_usage \
        "[-amnrspv]"
 #define uname_full_usage "\n\n" \
-       "Print system information.\n" \
+       "Print system information\n" \
      "\nOptions:" \
      "\n       -a      Print all" \
      "\n       -m      The machine (hardware) type" \
@@ -4783,7 +4804,7 @@ IF_FEATURE_TUNCTL_UG( \
 #define unexpand_trivial_usage \
        "[-f][-a][-t NUM] [FILE|-]"
 #define unexpand_full_usage "\n\n" \
-       "Convert spaces to tabs, writing to standard output.\n" \
+       "Convert spaces to tabs, writing to standard output\n" \
      "\nOptions:" \
        IF_FEATURE_UNEXPAND_LONG_OPTIONS( \
      "\n       -a,--all        Convert all blanks" \
@@ -4900,6 +4921,11 @@ IF_FEATURE_TUNCTL_UG( \
      "\nOptions:" \
      "\n       -a      Lock all VTs" \
 
+#define volname_trivial_usage \
+       "[DEVICE]"
+#define volname_full_usage "\n\n" \
+       "Show CD volume name of the DEVICE (default /dev/cdrom)"
+
 #define watch_trivial_usage \
        "[-n seconds] [-t] PROG [ARGS]"
 #define watch_full_usage "\n\n" \