trim help texts a bit

function                                             old     new   delta
packed_usage                                       26709   26634     -75

Signed-off-by: Denys Vlasenko <vda.linux@googlemail.com>
This commit is contained in:
Denys Vlasenko 2009-08-27 20:38:17 +02:00
parent ca899efd6c
commit 691161a7a7

View File

@ -135,8 +135,7 @@
#define basename_trivial_usage \ #define basename_trivial_usage \
"FILE [SUFFIX]" "FILE [SUFFIX]"
#define basename_full_usage "\n\n" \ #define basename_full_usage "\n\n" \
"Strip directory path and suffixes from FILE.\n" \ "Strip directory path and .SUFFIX from FILE\n"
"If specified, also remove any trailing SUFFIX."
#define basename_example_usage \ #define basename_example_usage \
"$ basename /usr/local/bin/foo\n" \ "$ basename /usr/local/bin/foo\n" \
"foo\n" \ "foo\n" \
@ -171,7 +170,7 @@
#define brctl_trivial_usage \ #define brctl_trivial_usage \
"COMMAND [BRIDGE [INTERFACE]]" "COMMAND [BRIDGE [INTERFACE]]"
#define brctl_full_usage "\n\n" \ #define brctl_full_usage "\n\n" \
"Manage ethernet bridges.\n" \ "Manage ethernet bridges\n" \
"\nCommands:" \ "\nCommands:" \
IF_FEATURE_BRCTL_SHOW( \ IF_FEATURE_BRCTL_SHOW( \
"\n show Show a list of bridges" \ "\n show Show a list of bridges" \
@ -334,7 +333,7 @@
"\n -r,--role=ROLE security context" \ "\n -r,--role=ROLE security context" \
"\n -t,--type=TYPE" \ "\n -t,--type=TYPE" \
"\n -l,--range=RANGE" \ "\n -l,--range=RANGE" \
"\n -R,--recursive Recurse subdirectories" \ "\n -R,--recursive Recurse" \
) \ ) \
IF_NOT_FEATURE_CHCON_LONG_OPTIONS( \ IF_NOT_FEATURE_CHCON_LONG_OPTIONS( \
"\n -v Verbose" \ "\n -v Verbose" \
@ -345,7 +344,7 @@
"\n -r ROLE" \ "\n -r ROLE" \
"\n -t TYPE" \ "\n -t TYPE" \
"\n -l RNG" \ "\n -l RNG" \
"\n -R Recurse subdirectories" \ "\n -R Recurse" \
) )
#define chmod_trivial_usage \ #define chmod_trivial_usage \
@ -354,7 +353,7 @@
"Each MODE is one or more of the letters ugoa, one of the\n" \ "Each MODE is one or more of the letters ugoa, one of the\n" \
"symbols +-= and one or more of the letters rwxst\n" \ "symbols +-= and one or more of the letters rwxst\n" \
"\nOptions:" \ "\nOptions:" \
"\n -R Recurse directories" \ "\n -R Recurse" \
IF_DESKTOP( \ IF_DESKTOP( \
"\n -c List changed files" \ "\n -c List changed files" \
"\n -v List all files" \ "\n -v List all files" \
@ -375,7 +374,7 @@
#define chgrp_full_usage "\n\n" \ #define chgrp_full_usage "\n\n" \
"Change the group membership of each FILE to GROUP\n" \ "Change the group membership of each FILE to GROUP\n" \
"\nOptions:" \ "\nOptions:" \
"\n -R Recurse directories" \ "\n -R Recurse" \
"\n -h Affect symlinks instead of symlink targets" \ "\n -h Affect symlinks instead of symlink targets" \
"\n -L Traverse all symlinks to directories" \ "\n -L Traverse all symlinks to directories" \
"\n -H Traverse symlinks on command line only" \ "\n -H Traverse symlinks on command line only" \
@ -397,7 +396,7 @@
#define chown_full_usage "\n\n" \ #define chown_full_usage "\n\n" \
"Change the owner and/or group of each FILE to OWNER and/or GROUP\n" \ "Change the owner and/or group of each FILE to OWNER and/or GROUP\n" \
"\nOptions:" \ "\nOptions:" \
"\n -R Recurse directories" \ "\n -R Recurse" \
"\n -h Affect symlinks instead of symlink targets" \ "\n -h Affect symlinks instead of symlink targets" \
"\n -L Traverse all symlinks to directories" \ "\n -L Traverse all symlinks to directories" \
"\n -H Traverse symlinks on command line only" \ "\n -H Traverse symlinks on command line only" \
@ -558,7 +557,7 @@
"\n -p Preserve file attributes if possible" \ "\n -p Preserve file attributes if possible" \
"\n -f Force overwrite" \ "\n -f Force overwrite" \
"\n -i Prompt before overwrite" \ "\n -i Prompt before overwrite" \
"\n -R,-r Recurse directories" \ "\n -R,-r Recurse" \
"\n -l,-s Create (sym)links" \ "\n -l,-s Create (sym)links" \
#define cpio_trivial_usage \ #define cpio_trivial_usage \
@ -1071,7 +1070,7 @@
#define expand_trivial_usage \ #define expand_trivial_usage \
"[-i] [-t NUM] [FILE|-]" "[-i] [-t NUM] [FILE|-]"
#define expand_full_usage "\n\n" \ #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:" \ "\nOptions:" \
IF_FEATURE_EXPAND_LONG_OPTIONS( \ IF_FEATURE_EXPAND_LONG_OPTIONS( \
"\n -i,--initial Do not convert tabs after non blanks" \ "\n -i,--initial Do not convert tabs after non blanks" \
@ -1085,7 +1084,7 @@
#define expr_trivial_usage \ #define expr_trivial_usage \
"EXPRESSION" "EXPRESSION"
#define expr_full_usage "\n\n" \ #define expr_full_usage "\n\n" \
"Print the value of EXPRESSION to standard output.\n" \ "Print the value of EXPRESSION to standard output\n" \
"\n" \ "\n" \
"EXPRESSION may be:\n" \ "EXPRESSION may be:\n" \
" ARG1 | ARG2 ARG1 if it is neither null nor 0, otherwise ARG2\n" \ " ARG1 | ARG2 ARG1 if it is neither null nor 0, otherwise ARG2\n" \
@ -1126,7 +1125,7 @@
"\n -i Inetd mode" \ "\n -i Inetd mode" \
"\n -w Inetd 'wait' mode" \ "\n -w Inetd 'wait' mode" \
"\n -b ADDR Bind to specified address" \ "\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 false_trivial_usage \
"" ""
@ -1409,7 +1408,7 @@
#define getopt_trivial_usage \ #define getopt_trivial_usage \
"[OPTIONS]" "[OPTIONS]"
#define getopt_full_usage "\n\n" \ #define getopt_full_usage "\n\n" \
"Parse options\n" \ "Options:" \
IF_LONG_OPTS( \ IF_LONG_OPTS( \
"\n -a,--alternative Allow long options starting with single -" \ "\n -a,--alternative Allow long options starting with single -" \
"\n -l,--longoptions=longopts Long options to be recognized" \ "\n -l,--longoptions=longopts Long options to be recognized" \
@ -1488,7 +1487,7 @@
"\nOptions:" \ "\nOptions:" \
"\n -H Prefix output lines with filename where match was found" \ "\n -H Prefix output lines with filename where match was found" \
"\n -h Suppress the prefixing filename on output" \ "\n -h Suppress the prefixing filename on output" \
"\n -r Recurse subdirectories" \ "\n -r Recurse" \
"\n -i Ignore case distinctions" \ "\n -i Ignore case distinctions" \
"\n -l List names of files that match" \ "\n -l List names of files that match" \
"\n -L List names of files that do not match" \ "\n -L List names of files that do not match" \
@ -2196,7 +2195,7 @@
"[-a|k|s|u] [-C TTY]" "[-a|k|s|u] [-C TTY]"
#define kbd_mode_full_usage "\n\n" \ #define kbd_mode_full_usage "\n\n" \
"Report or set the keyboard mode\n" \ "Report or set the keyboard mode\n" \
"\nOptions set mode:" \ "\nOptions:" \
"\n -a Default (ASCII)" \ "\n -a Default (ASCII)" \
"\n -k Medium-raw (keyboard)" \ "\n -k Medium-raw (keyboard)" \
"\n -s Raw (scancode)" \ "\n -s Raw (scancode)" \
@ -2206,7 +2205,7 @@
#define kill_trivial_usage \ #define kill_trivial_usage \
"[-l] [-SIG] PID..." "[-l] [-SIG] PID..."
#define kill_full_usage "\n\n" \ #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:" \ "\nOptions:" \
"\n -l List all signal names and numbers" \ "\n -l List all signal names and numbers" \
/* "\n -s SIG Yet another way of specifying SIG" */ \ /* "\n -s SIG Yet another way of specifying SIG" */ \
@ -2224,7 +2223,7 @@
#define killall_trivial_usage \ #define killall_trivial_usage \
"[-l] [-q] [-SIG] process-name..." "[-l] [-q] [-SIG] process-name..."
#define killall_full_usage "\n\n" \ #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:" \ "\nOptions:" \
"\n -l List all signal names and numbers" \ "\n -l List all signal names and numbers" \
/* "\n -s SIG Yet another way of specifying SIG" */ \ /* "\n -s SIG Yet another way of specifying SIG" */ \
@ -2236,7 +2235,7 @@
#define killall5_trivial_usage \ #define killall5_trivial_usage \
"[-l] [-SIG] [-o PID]..." "[-l] [-SIG] [-o PID]..."
#define killall5_full_usage "\n\n" \ #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:" \ "\nOptions:" \
"\n -l List all signal names and numbers" \ "\n -l List all signal names and numbers" \
"\n -o PID Do not signal this PID" \ "\n -o PID Do not signal this PID" \
@ -2266,9 +2265,9 @@
"changed, and files can be manipulated in various ways.\n" \ "changed, and files can be manipulated in various ways.\n" \
"\nOptions:" \ "\nOptions:" \
"\n -E Quit once the end of a file is reached" \ "\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 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 -I Ignore case in all searches" \
"\n -~ Suppress ~s displayed past the end of the file" \ "\n -~ Suppress ~s displayed past the end of the file" \
@ -2548,7 +2547,7 @@
#define makemime_trivial_usage \ #define makemime_trivial_usage \
"[OPTIONS] [FILE]..." "[OPTIONS] [FILE]..."
#define makemime_full_usage "\n\n" \ #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" */ \ /* "Transfer encoding is base64, disposition is inline (not attachment)\n" */ \
"\nOptions:" \ "\nOptions:" \
"\n -o FILE Output. Default: stdout" \ "\n -o FILE Output. Default: stdout" \
@ -2603,7 +2602,7 @@
"[OPTIONS] [FILE]..." \ "[OPTIONS] [FILE]..." \
IF_FEATURE_MD5_SHA1_SUM_CHECK("\n or: sha1sum [OPTIONS] -c [FILE]") IF_FEATURE_MD5_SHA1_SUM_CHECK("\n or: sha1sum [OPTIONS] -c [FILE]")
#define sha1sum_full_usage "\n\n" \ #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" \ IF_FEATURE_MD5_SHA1_SUM_CHECK( "\n" \
"\nOptions:" \ "\nOptions:" \
"\n -c Check sums against given list" \ "\n -c Check sums against given list" \
@ -2615,7 +2614,7 @@
"[OPTIONS] [FILE]..." \ "[OPTIONS] [FILE]..." \
IF_FEATURE_MD5_SHA1_SUM_CHECK("\n or: sha256sum [OPTIONS] -c [FILE]") IF_FEATURE_MD5_SHA1_SUM_CHECK("\n or: sha256sum [OPTIONS] -c [FILE]")
#define sha256sum_full_usage "\n\n" \ #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" \ IF_FEATURE_MD5_SHA1_SUM_CHECK( "\n" \
"\nOptions:" \ "\nOptions:" \
"\n -c Check sums against given list" \ "\n -c Check sums against given list" \
@ -2627,7 +2626,7 @@
"[OPTIONS] [FILE]..." \ "[OPTIONS] [FILE]..." \
IF_FEATURE_MD5_SHA1_SUM_CHECK("\n or: sha512sum [OPTIONS] -c [FILE]") IF_FEATURE_MD5_SHA1_SUM_CHECK("\n or: sha512sum [OPTIONS] -c [FILE]")
#define sha512sum_full_usage "\n\n" \ #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" \ IF_FEATURE_MD5_SHA1_SUM_CHECK( "\n" \
"\nOptions:" \ "\nOptions:" \
"\n -c Check sums against given list" \ "\n -c Check sums against given list" \
@ -2692,8 +2691,8 @@
#define mkdir_full_usage "\n\n" \ #define mkdir_full_usage "\n\n" \
"Create DIRECTORY\n" \ "Create DIRECTORY\n" \
"\nOptions:" \ "\nOptions:" \
"\n -m Set permission mode (as in chmod), not rwxrwxrwx - umask" \ "\n -m Mode" \
"\n -p No error if existing, make parent directories as needed" \ "\n -p No error if exists; make parent directories as needed" \
IF_SELINUX( \ IF_SELINUX( \
"\n -Z Set security context" \ "\n -Z Set security context" \
) )
@ -2912,7 +2911,7 @@
#define mount_trivial_usage \ #define mount_trivial_usage \
"[flags] DEVICE NODE [-o OPT,OPT]" "[flags] DEVICE NODE [-o OPT,OPT]"
#define mount_full_usage "\n\n" \ #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:" \ "\nOptions:" \
"\n -a Mount all filesystems in fstab" \ "\n -a Mount all filesystems in fstab" \
IF_FEATURE_MOUNT_FAKE( \ IF_FEATURE_MOUNT_FAKE( \
@ -3014,7 +3013,7 @@
#define nameif_full_usage "\n\n" \ #define nameif_full_usage "\n\n" \
"Rename network interface while it in the down state\n" \ "Rename network interface while it in the down state\n" \
"\nOptions:" \ "\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 -s Use syslog (LOCAL0 facility)" \
"\n IFNAME MACADDR new_interface_name interface_mac_address" \ "\n IFNAME MACADDR new_interface_name interface_mac_address" \
@ -3368,7 +3367,7 @@
"\n -s Skip authorization" \ "\n -s Skip authorization" \
"\n -T Get messages with TOP instead with RETR" \ "\n -T Get messages with TOP instead with RETR" \
"\n -k Keep retrieved messages on the server" \ "\n -k Keep retrieved messages on the server" \
"\n -t timeout Set network timeout" \ "\n -t timeout Network timeout" \
IF_FEATURE_POPMAILDIR_DELIVERY( \ IF_FEATURE_POPMAILDIR_DELIVERY( \
"\n -F \"program arg1 arg2 ...\" Filter by program. May be multiple" \ "\n -F \"program arg1 arg2 ...\" Filter by program. May be multiple" \
"\n -M \"program arg1 arg2 ...\" Deliver by program" \ "\n -M \"program arg1 arg2 ...\" Deliver by program" \
@ -3391,7 +3390,7 @@
"\n -f Force power off (don't go through init)" \ "\n -f Force power off (don't go through init)" \
#define printenv_trivial_usage \ #define printenv_trivial_usage \
"[VARIABLES...]" "[VARIABLE...]"
#define printenv_full_usage "\n\n" \ #define printenv_full_usage "\n\n" \
"Print all or part of environment.\n" \ "Print all or part of environment.\n" \
"If no environment VARIABLE specified, print them all." "If no environment VARIABLE specified, print them all."
@ -3582,7 +3581,7 @@
"\n -i Ignore files that do not exist" \ "\n -i Ignore files that do not exist" \
"\n -f file File with list of files to process. Use - for stdin" \ "\n -f file File with list of files to process. Use - for stdin" \
"\n -e directory Directory to exclude" \ "\n -e directory Directory to exclude" \
"\n -R,-r Recurse directories" \ "\n -R,-r Recurse" \
"\n -n Don't change any file labels" \ "\n -n Don't change any file labels" \
"\n -o file Save list of files with incorrect context" \ "\n -o file Save list of files with incorrect context" \
"\n -v Verbose" \ "\n -v Verbose" \
@ -3607,7 +3606,7 @@
#define rmdir_trivial_usage \ #define rmdir_trivial_usage \
"[OPTIONS] DIRECTORY..." "[OPTIONS] DIRECTORY..."
#define rmdir_full_usage "\n\n" \ #define rmdir_full_usage "\n\n" \
"Remove the DIRECTORY, if it is empty.\n" \ "Remove the DIRECTORY, if it is empty\n" \
"\nOptions:" \ "\nOptions:" \
IF_FEATURE_RMDIR_LONG_OPTIONS( \ IF_FEATURE_RMDIR_LONG_OPTIONS( \
"\n -p|--parents Include parents" \ "\n -p|--parents Include parents" \
@ -3732,7 +3731,8 @@
#define runlevel_trivial_usage \ #define runlevel_trivial_usage \
"[utmp]" "[utmp]"
#define runlevel_full_usage "\n\n" \ #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" \ "If no utmp file exists or if no runlevel record can be found,\n" \
"print \"unknown\"" "print \"unknown\""
#define runlevel_example_usage \ #define runlevel_example_usage \
@ -4206,8 +4206,8 @@
#define svlogd_trivial_usage \ #define svlogd_trivial_usage \
"[-ttv] [-r c] [-R abc] [-l len] [-b buflen] dir..." "[-ttv] [-r c] [-R abc] [-l len] [-b buflen] dir..."
#define svlogd_full_usage "\n\n" \ #define svlogd_full_usage "\n\n" \
"Continuously read log data from standard input, optionally " \ "Continuously read log data from standard input, optionally\n" \
"filter log messages, and write the data to one or more automatically " \ "filter log messages, and write the data to one or more automatically\n" \
"rotated logs" \ "rotated logs" \
#define swapoff_trivial_usage \ #define swapoff_trivial_usage \
@ -4525,7 +4525,7 @@
#define tftpd_trivial_usage \ #define tftpd_trivial_usage \
"[-cr] [-u USER] [DIR]" "[-cr] [-u USER] [DIR]"
#define tftpd_full_usage "\n\n" \ #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" \ "\n" \
"tftpd should be used as an inetd service.\n" \ "tftpd should be used as an inetd service.\n" \
"tftpd's line for inetd.conf:\n" \ "tftpd's line for inetd.conf:\n" \
@ -4602,7 +4602,7 @@
"\n -v Verbose" \ "\n -v Verbose" \
"\n -m max_ttl Max time-to-live (max number of hops)" \ "\n -m max_ttl Max time-to-live (max number of hops)" \
"\n -p port# Base UDP port number used in probes" \ "\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 -q nqueries Number of probes per 'ttl' (default 3)" \
"\n -s src_addr IP address to use as the source address" \ "\n -s src_addr IP address to use as the source address" \
"\n -t tos Type-of-service in probe packets (default 0)" \ "\n -t tos Type-of-service in probe packets (default 0)" \
@ -4639,7 +4639,7 @@
#define tunctl_trivial_usage \ #define tunctl_trivial_usage \
"[-f device] ([-t name] | -d name)" IF_FEATURE_TUNCTL_UG(" [-u owner] [-g group] [-b]") "[-f device] ([-t name] | -d name)" IF_FEATURE_TUNCTL_UG(" [-u owner] [-g group] [-b]")
#define tunctl_full_usage "\n\n" \ #define tunctl_full_usage "\n\n" \
"Create or delete tun interfaces" \ "Create or delete tun interfaces\n" \
"\nOptions:" \ "\nOptions:" \
"\n -f name tun device (/dev/net/tun)" \ "\n -f name tun device (/dev/net/tun)" \
"\n -t name Create iface 'name'" \ "\n -t name Create iface 'name'" \
@ -4761,7 +4761,7 @@ IF_FEATURE_TUNCTL_UG( \
#define uname_trivial_usage \ #define uname_trivial_usage \
"[-amnrspv]" "[-amnrspv]"
#define uname_full_usage "\n\n" \ #define uname_full_usage "\n\n" \
"Print system information.\n" \ "Print system information\n" \
"\nOptions:" \ "\nOptions:" \
"\n -a Print all" \ "\n -a Print all" \
"\n -m The machine (hardware) type" \ "\n -m The machine (hardware) type" \
@ -4786,7 +4786,7 @@ IF_FEATURE_TUNCTL_UG( \
#define unexpand_trivial_usage \ #define unexpand_trivial_usage \
"[-f][-a][-t NUM] [FILE|-]" "[-f][-a][-t NUM] [FILE|-]"
#define unexpand_full_usage "\n\n" \ #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:" \ "\nOptions:" \
IF_FEATURE_UNEXPAND_LONG_OPTIONS( \ IF_FEATURE_UNEXPAND_LONG_OPTIONS( \
"\n -a,--all Convert all blanks" \ "\n -a,--all Convert all blanks" \