From e5920a2dc05c4bec0ce4669f4eb39119436be691 Mon Sep 17 00:00:00 2001 From: Eric Andersen Date: Thu, 3 Jul 2003 10:00:15 +0000 Subject: Patch from Kent Robotti adding a bunch of menuconfig help --- archival/Config.in | 39 +++++++---- console-tools/Config.in | 26 ++++--- coreutils/Config.in | 183 ++++++++++++++++++++++++++++-------------------- shell/Config.in | 40 ++++++----- util-linux/Config.in | 2 +- 5 files changed, 172 insertions(+), 118 deletions(-) diff --git a/archival/Config.in b/archival/Config.in index cc65b6d..fddcff4 100644 --- a/archival/Config.in +++ b/archival/Config.in @@ -120,20 +120,25 @@ config CONFIG_GUNZIP bool "gunzip" default n help - Please submit a patch to add help text for this item. + gunzip is used to decompress archives created by gzip. + You can use the `-t' option to test the integrity of + an archive, without decompressing it. config CONFIG_FEATURE_GUNZIP_UNCOMPRESS bool " Uncompress support" default n depends on CONFIG_GUNZIP help - Please submit a patch to add help text for this item. + If you want gunzip to have the ability to decompress + archives created by the program compress (not much + used anymore). config CONFIG_GZIP bool "gzip" default n help - Please submit a patch to add help text for this item. + gzip is used to compress files. + It's probably the most used UNIX compression program. config CONFIG_RPM2CPIO bool "rpm2cpio" @@ -151,36 +156,41 @@ config CONFIG_TAR bool "tar" default n help - tar has at least 512 bytes of overheads for every stored file. - Please submit a patch to add help text for this item. + tar is an archiving program. It's commonly used with gzip to + create compressed archives. It's probably the most used + UNIX archive program. config CONFIG_FEATURE_TAR_CREATE bool " Enable archive creation" default y depends on CONFIG_TAR help - Please submit a patch to add help text for this item. + If you enable this option you'll be able to create + tar archives using the `-c' option. config CONFIG_FEATURE_TAR_BZIP2 bool " Enable -j option to handle .tar.bz2 files" default n depends on CONFIG_TAR help - Please submit a patch to add help text for this item. + If you enable this option you'll be able to extract + archives compressed with bzip2. config CONFIG_FEATURE_TAR_EXCLUDE bool " Enable -X and --exclude options (exclude files)" default n depends on CONFIG_TAR help - Please submit a patch to add help text for this item. + If you enable this option you'll be able to specify + a list of files to exclude from an archive. config CONFIG_FEATURE_TAR_GZIP bool " Enable -z option" default y depends on CONFIG_TAR help - Please submit a patch to add help text for this item. + If you enable this option tar will be able to call gzip, + when creating or extracting tar gziped archives. config CONFIG_FEATURE_TAR_OLDGNU_COMPATABILITY bool " Enable support for old tar header format" @@ -196,7 +206,7 @@ config CONFIG_FEATURE_TAR_GNU_EXTENSIONS default y depends on CONFIG_TAR help - With this option usybox supports the GNU long filename + With this option busybox supports the GNU long filename and linkanmes. config CONFIG_FEATURE_UNARCHIVE_TAPE @@ -210,12 +220,17 @@ config CONFIG_UNCOMPRESS bool "uncompress" default n help - Please submit a patch to add help text for this item. + uncompress is used to decompress archives created by compress. + Not much used anymore, replaced by gzip/gunzip. config CONFIG_UNZIP bool "unzip" default n help - Please submit a patch to add help text for this item. + unzip will list or extract files from a ZIP archive, + commonly found on DOS/WIN systems. The default behavior + (with no options) is to extract the archive into the + current directory. Use the `-d' option to extract to a + directory of your choice. endmenu diff --git a/console-tools/Config.in b/console-tools/Config.in index f10bf75..7191db4 100644 --- a/console-tools/Config.in +++ b/console-tools/Config.in @@ -9,60 +9,66 @@ config CONFIG_CHVT bool "chvt" default n help - Please submit a patch to add help text for this item. + This program is used to change to another terminal. + Example: chvt 4 (change to terminal /dev/tty4) config CONFIG_CLEAR bool "clear" default n help - Please submit a patch to add help text for this item. + This program clears the terminal screen. config CONFIG_DEALLOCVT bool "deallocvt" default n help - Please submit a patch to add help text for this item. + This program deallocates unused virtual consoles. config CONFIG_DUMPKMAP bool "dumpkmap" default n help - Please submit a patch to add help text for this item. + This program dumps the kernel's keyboard translation table to + stdout, in binary format. You can then use loadkmap to load it. config CONFIG_LOADACM bool "loadacm" default n help - Please submit a patch to add help text for this item. + This program loads an acm from standard input. config CONFIG_LOADFONT bool "loadfont" default n help - Please submit a patch to add help text for this item. + This program loads a console font from standard input. config CONFIG_LOADKMAP bool "loadkmap" default n help - Please submit a patch to add help text for this item. + This program loads a keyboard translation table from + standard input. config CONFIG_OPENVT bool "openvt" default n help - Please submit a patch to add help text for this item. + This program is used to start a command on an unused + virtual terminal. config CONFIG_RESET bool "reset" default n help - Please submit a patch to add help text for this item. + This program is used to reset the terminal screen, if it + gets messed up. config CONFIG_SETKEYCODES bool "setkeycodes" default n help - Please submit a patch to add help text for this item. + This program loads entries into the kernel's scancode-to-keycode + map, allowing unusual keyboards to generate usable keycodes. endmenu diff --git a/coreutils/Config.in b/coreutils/Config.in index 4044582..d2c3c64 100644 --- a/coreutils/Config.in +++ b/coreutils/Config.in @@ -17,7 +17,7 @@ config CONFIG_CAL bool "cal" default n help - Please submit a patch to add help text for this item. + cal is used to display a montly calender. config CONFIG_CAT bool "cat" @@ -30,43 +30,47 @@ config CONFIG_CHGRP bool "chgrp" default n help - Please submit a patch to add help text for this item. + chgrp is used to change the group owership of files. config CONFIG_CHMOD bool "chmod" default n help - Please submit a patch to add help text for this item. + chmod is used to change the access permission of files. config CONFIG_CHOWN bool "chown" default n help - Please submit a patch to add help text for this item. + chown is used too change the user and/or group ownership + of files. config CONFIG_CHROOT bool "chroot" default n help - Please submit a patch to add help text for this item. + chroot is used to change the root directory and run a command. + The default command is `/bin/sh'. config CONFIG_CMP bool "cmp" default n help - Please submit a patch to add help text for this item. + cmp is used to compare two files and returns the result + to standard output. config CONFIG_CP bool "cp" default n help - Please submit a patch to add help text for this item. + cp is used to copy files and directories. config CONFIG_CUT bool "cut" default n help - Please submit a patch to add help text for this item. + cut is used to print selected parts of lines from + each file to stdout. if CONFIG_WATCH config CONFIG_DATE @@ -79,7 +83,8 @@ if !CONFIG_WATCH bool "date" default n help - Please submit a patch to add help text for this item. + date is used to set the system date or display the + current time in the given format. endif config CONFIG_FEATURE_DATE_ISOFMT @@ -93,25 +98,30 @@ config CONFIG_DD bool "dd" default n help - Please submit a patch to add help text for this item. + dd copies a file (from standard input to standard output, + by default) using specific input and output blocksizes, + while optionally performing conversions on it. config CONFIG_DF bool "df" default n help - Please submit a patch to add help text for this item. + df reports the amount of disk space used and available + on filesystems. config CONFIG_DIRNAME bool "dirname" default n help - Please submit a patch to add help text for this item. + dirname is used to strip a non directory suffix from + a file name. config CONFIG_DOS2UNIX bool "dos2unix/unix2dos" default n help - Please submit a patch to add help text for this item. + dos2unix is uses to convert a text file from DOS format to + UNIX format, and vice versa. config CONFIG_UNIX2DOS bool @@ -122,39 +132,43 @@ config CONFIG_DU bool "du (default blocksize of 512 bytes)" default n help - Please submit a patch to add help text for this item. + du is used to report the amount of disk space used + for specified files. config CONFIG_FEATURE_DU_DEFALT_BLOCKSIZE_1K bool " Use a default blocksize of 1024 bytes (1K)" default y depends on CONFIG_DU help - Please submit a patch to add help text for this item. + Use a blocksize of (1K) instead of the default 512b. config CONFIG_ECHO bool "echo (basic SUSv3 version taking no options" default n help - Please submit a patch to add help text for this item. + echo is used to print a specified string to stdout. config CONFIG_FEATURE_FANCY_ECHO bool " Enable echo options (-n and -e)" default y depends on CONFIG_ECHO help - Please submit a patch to add help text for this item. + This adds options (-n and -e) to echo. config CONFIG_ENV bool "env" default n help - Please submit a patch to add help text for this item. + env is used to set an environment variable and run + a command, without options it displays the current + environment. config CONFIG_EXPR bool "expr" default n help - Please submit a patch to add help text for this item. + expr is used to calculate numbers and print the result + to standard output. if CONFIG_HUSH || CONFIG_LASH || CONFIG_MSH config CONFIG_FALSE @@ -167,7 +181,7 @@ if !CONFIG_HUSH && !CONFIG_LASH && !CONFIG_MSH bool "false" default n help - Please submit a patch to add help text for this item. + false returns an exit code of FALSE (1). endif config CONFIG_FOLD @@ -180,147 +194,152 @@ config CONFIG_HEAD bool "head" default n help - Please submit a patch to add help text for this item. + head is used to print the first specified number of lines + from files. config CONFIG_FEATURE_FANCY_HEAD bool " Enable head options (-c, -q, and -v)" default n depends on CONFIG_HEAD help - Please submit a patch to add help text for this item. + This enables the head options (-c, -q, and -v). config CONFIG_HOSTID bool "hostid" default n help - Please submit a patch to add help text for this item. + hostid prints the numeric identifier (in hexadecimal) for + the current host. config CONFIG_ID bool "id" default n help - Please submit a patch to add help text for this item. + id displays the current user and group ID names. config CONFIG_LENGTH bool "length" default n help - Please submit a patch to add help text for this item. + length is used to print out the length of a specified string. config CONFIG_LN bool "ln" default n help - Please submit a patch to add help text for this item. + ln is used to create hard or soft links between files. config CONFIG_LOGNAME bool "logname" default n help - Please submit a patch to add help text for this item. + logname is used to print the current user's login name. config CONFIG_LS bool "ls" default n help - Please submit a patch to add help text for this item. + ls is used to list the contents of directories. config CONFIG_FEATURE_LS_FILETYPES bool " Enable filetyping options (-p and -F)" default y depends on CONFIG_LS help - Please submit a patch to add help text for this item. + Enable the ls options (-p and -F). config CONFIG_FEATURE_LS_FOLLOWLINKS bool " Enable symlinks dereferencing (-L)" default y depends on CONFIG_LS help - Please submit a patch to add help text for this item. + Enable the ls option (-L). config CONFIG_FEATURE_LS_RECURSIVE bool " Enable recursion (-R)" default y depends on CONFIG_LS help - Please submit a patch to add help text for this item. + Enable the ls option (-R). config CONFIG_FEATURE_LS_SORTFILES bool " Sort the file names" default y depends on CONFIG_LS help - Please submit a patch to add help text for this item. + Allow ls to sort file names alphabetically. config CONFIG_FEATURE_LS_TIMESTAMPS bool " Show file timestamps" default y depends on CONFIG_LS help - Please submit a patch to add help text for this item. + Allow ls to display timestamps for files. config CONFIG_FEATURE_LS_USERNAME bool " Show username/groupnames" default y depends on CONFIG_LS help - Please submit a patch to add help text for this item. + Allow ls to display username/groupname for files. config CONFIG_FEATURE_LS_COLOR bool " Use color to identify file types" default y depends on CONFIG_LS help - Please submit a patch to add help text for this item. + Allow ls to use color when displaying files. config CONFIG_MD5SUM bool "md5sum" default n help - Please submit a patch to add help text for this item. + md5sum is used to print or check MD5 checksums. config CONFIG_MKDIR bool "mkdir" default n help - Please submit a patch to add help text for this item. + mkdir is used to create directories with the specified names. config CONFIG_MKFIFO bool "mkfifo" default n help - Please submit a patch to add help text for this item. + mkfifo is used to create FIFOs (named pipes). + The `mknod' program can also create FIFOs. config CONFIG_MKNOD bool "mknod" default n help - Please submit a patch to add help text for this item. + mknod is used to create FIFOs or block/character special + files with the specified names. config CONFIG_MV bool "mv" default n help - Please submit a patch to add help text for this item. + mv is used to move or rename files or directories. config CONFIG_OD bool "od" default n help - Please submit a patch to add help text for this item. + od is used to dump binary files in octal and other formats. config CONFIG_PRINTF bool "printf" default n help - Please submit a patch to add help text for this item. + printf is used to format and print specified strings. + It's similar to `echo' except it has more options. config CONFIG_PWD bool "pwd" default n help - Please submit a patch to add help text for this item. + pwd is used to print the current directory. config CONFIG_REALPATH bool "realpath" @@ -333,13 +352,13 @@ config CONFIG_RM bool "rm" default n help - Please submit a patch to add help text for this item. + rm is used to remove files or directories. config CONFIG_RMDIR bool "rmdir" default n help - Please submit a patch to add help text for this item. + rmdir is used to remove empty directories. config CONFIG_SHA1SUM bool "sha1sum" @@ -358,72 +377,76 @@ config CONFIG_SLEEP bool "sleep (single integer arg with no suffix)" default n help - Please submit a patch to add help text for this item. + sleep is used to pause for a specified number of seconds, config CONFIG_FEATURE_FANCY_SLEEP bool " Enable multiple integer args and optional time suffixes" default n depends on CONFIG_SLEEP help - Please submit a patch to add help text for this item. + Allow sleep to pause for specified minutes, hours, and days. config CONFIG_SORT bool "sort" default n help - Please submit a patch to add help text for this item. + sort is used to sort lines of text in specified files. config CONFIG_FEATURE_SORT_REVERSE bool " Enable reverse sort" default y depends on CONFIG_SORT help - Please submit a patch to add help text for this item. + Enable the `-r' option that allows sort to sort lines of + text in reverse. config CONFIG_FEATURE_SORT_UNIQUE bool " Enable unique sort" default y depends on CONFIG_SORT help - Please submit a patch to add help text for this item. + Enable the `-u' option that allows sort to only sort lines + that are uniq. config CONFIG_STTY bool "stty" default n help - Please submit a patch to add help text for this item. + stty is used to change and print terminal line settings. config CONFIG_SYNC bool "sync" default n help - Please submit a patch to add help text for this item. + sync is used to flush filesystem buffers. config CONFIG_TAIL bool "tail" default n help - Please submit a patch to add help text for this item. + tail is used to print the last specified number of lines + from files. config CONFIG_FEATURE_FANCY_TAIL bool " Enable extra tail options (-c, -q, -s, and -v)" default y depends on CONFIG_TAIL help - Please submit a patch to add help text for this item. + Enable tail options (-c, -q, -s, and -v). config CONFIG_TEE bool "tee" default n help - Please submit a patch to add help text for this item. + tee is used to read from standard input and write + to standard output and files. config CONFIG_FEATURE_TEE_USE_BLOCK_IO bool " Enable block i/o (larger/faster) instead of byte i/o." default n depends on CONFIG_TEE help - Please submit a patch to add help text for this item. + Enable this option for a faster tee, at expense of size. if CONFIG_ASH || CONFIG_HUSH || CONFIG_LASH || CONFIG_MSH config CONFIG_TEST @@ -436,20 +459,24 @@ if !CONFIG_ASH && !CONFIG_HUSH && !CONFIG_LASH && !CONFIG_MSH bool "test" default n help - Please submit a patch to add help text for this item. + test is used to check file types and compare values, + returning an appropriate exit code. The shells (ash + and bash have test builtin). endif config CONFIG_TOUCH bool "touch" default n help - Please submit a patch to add help text for this item. + touch is used to create or change the access and/or + modification timestamp of specified files. config CONFIG_TR bool "tr" default n help - Please submit a patch to add help text for this item. + tr is used to squeeze, and/or delete characters from standard + input, writing to standard output. if CONFIG_HUSH || CONFIG_LASH || CONFIG_MSH config CONFIG_TRUE @@ -462,75 +489,80 @@ if !CONFIG_HUSH && !CONFIG_LASH && !CONFIG_MSH bool "true" default n help - Please submit a patch to add help text for this item. + true returns an exit code of TRUE (0). + endif config CONFIG_TTY bool "tty" default n help - Please submit a patch to add help text for this item. + tty is used to print the name of the current terminal to + standard output. config CONFIG_UNAME bool "uname" default n help - Please submit a patch to add help text for this item. + uname is used to print system information. config CONFIG_UNIQ bool "uniq" default n help - Please submit a patch to add help text for this item. + uniq is used to remove duplicate lines from a sorted file. config CONFIG_USLEEP bool "usleep" default n help - Please submit a patch to add help text for this item. + usleep is used to pause for a specified number of microseconds. config CONFIG_UUDECODE bool "uudecode" default n help - Please submit a patch to add help text for this item. + uudecode is used to decode a uuencoded file. config CONFIG_UUENCODE bool "uuencode" default n help - Please submit a patch to add help text for this item. + uuencode is used to uuencode a file. config CONFIG_WATCH bool "watch" default n help - Please submit a patch to add help text for this item. + watch is used to execute a program periodically, showing + output to the screen. config CONFIG_WC bool "wc" default n help - Please submit a patch to add help text for this item. + wc is used to print the number of bytes, words, and lines, + in specified files. config CONFIG_WHO bool "who" default n help - Please submit a patch to add help text for this item. + who is used to show who is logged on. config CONFIG_WHOAMI bool "whoami" default n help - Please submit a patch to add help text for this item. + whoami is used to print the username of the current + user id (same as id -un). config CONFIG_YES bool "yes" default n help - Please submit a patch to add help text for this item. - + yes is used to repeatedly output a specific string, or + the default string `y'. comment "Common options for cp and mv" depends on CONFIG_CP || CONFIG_MV @@ -540,7 +572,7 @@ config CONFIG_FEATURE_PRESERVE_HARDLINKS default n depends on CONFIG_CP || CONFIG_MV help - Please submit a patch to add help text for this item. + Allow cp and mv to preserve hard links. comment "Common options for ls and more" depends on CONFIG_LS || CONFIG_MORE @@ -550,8 +582,7 @@ config CONFIG_FEATURE_AUTOWIDTH default n depends on CONFIG_LS || CONFIG_MORE help - Please submit a patch to add help text for this item. - + Allow ls and more to calculate terminal and column widths. comment "Common options for df, du, ls" depends on CONFIG_DF || CONFIG_DU || CONFIG_LS @@ -561,6 +592,6 @@ config CONFIG_FEATURE_HUMAN_READABLE default n depends on CONFIG_DF || CONFIG_DU || CONFIG_LS help - Please submit a patch to add help text for this item. + Allow df, du, and ls to have human readable output. endmenu diff --git a/shell/Config.in b/shell/Config.in index b643c8f..8373a80 100644 --- a/shell/Config.in +++ b/shell/Config.in @@ -9,7 +9,8 @@ choice prompt "Choose your default shell" default "none" help - Please submit a patch to add help text for this item. + Choose a shell. The ash shell is the most bash compatible + and full featured. config CONFIG_FEATURE_SH_IS_ASH bool "ash" @@ -40,7 +41,7 @@ config CONFIG_ASH bool "ash" default y help - Please submit a patch to add help text for this item. + Make sh a link to ash. endif comment "Ash Shell Options" @@ -51,28 +52,28 @@ config CONFIG_ASH_JOB_CONTROL default y depends on CONFIG_ASH help - Please submit a patch to add help text for this item. + Enable job control in the ash shell. config CONFIG_ASH_ALIAS bool " Enable alias support" default y depends on CONFIG_ASH help - Please submit a patch to add help text for this item. + Enable alias support in the ash shell. config CONFIG_ASH_MATH_SUPPORT bool " Enable Posix math support" default y depends on CONFIG_ASH help - Please submit a patch to add help text for this item. + Enable math support in the ash shell. config CONFIG_ASH_GETOPTS bool " Enable getopt builtin to parse positional parameters" default n depends on CONFIG_ASH help - Please submit a patch to add help text for this item. + Enable builtin getopt in the ash shell. config CONFIG_ASH_CMDCMD bool " Enable cmdcmd to override shell builtins" @@ -86,15 +87,14 @@ config CONFIG_ASH_MAIL default y depends on CONFIG_ASH help - Please submit a patch to add help text for this item. + Enable "check for new mail" in the ash shell. config CONFIG_ASH_OPTIMIZE_FOR_SIZE bool " Optimize for size instead of speed" default y depends on CONFIG_ASH help - Please submit a patch to add help text for this item. - + Compile ash for reduced size at price of speed. if CONFIG_FEATURE_SH_IS_HUSH config CONFIG_HUSH @@ -108,7 +108,7 @@ config CONFIG_HUSH bool "hush" default n help - Please submit a patch to add help text for this item. + Make sh a link to hush. endif if CONFIG_FEATURE_SH_IS_LASH @@ -123,7 +123,7 @@ config CONFIG_LASH bool "lash" default n help - Please submit a patch to add help text for this item. + Make sh a link to lash. endif if CONFIG_FEATURE_SH_IS_MSH @@ -138,7 +138,7 @@ config CONFIG_MSH bool "msh" default n help - Please submit a patch to add help text for this item. + Make sh a link to msh. endif @@ -150,49 +150,51 @@ config CONFIG_FEATURE_COMMAND_EDITING default n depends on CONFIG_MSH || CONFIG_LASH || CONFIG_HUSH || CONFIG_ASH help - Please submit a patch to add help text for this item. + Enable command editing in shell. config CONFIG_FEATURE_COMMAND_SAVEHISTORY bool " history saving" default n depends on CONFIG_ASH help - Please submit a patch to add help text for this item. + Enable history saving in ash shell. config CONFIG_FEATURE_COMMAND_TAB_COMPLETION bool "tab completion" default n depends on CONFIG_MSH || CONFIG_LASH || CONFIG_HUSH || CONFIG_ASH help - Please submit a patch to add help text for this item. + Enable tab completion in shell. config CONFIG_FEATURE_COMMAND_USERNAME_COMPLETION bool "username completion" default n depends on CONFIG_MSH || CONFIG_LASH || CONFIG_HUSH || CONFIG_ASH help - Please submit a patch to add help text for this item. + Enable username completion in shell. config CONFIG_FEATURE_COMMAND_HISTORY int "history size" default 15 depends on CONFIG_MSH || CONFIG_LASH || CONFIG_HUSH || CONFIG_ASH help - Please submit a patch to add help text for this item. + Specify command history size in shell. config CONFIG_FEATURE_SH_STANDALONE_SHELL bool "Standalone shell" default n depends on CONFIG_MSH || CONFIG_LASH || CONFIG_HUSH || CONFIG_ASH help - Please submit a patch to add help text for this item. + Have all the busybox commands built into the shell, creating + a standalone shell. config CONFIG_FEATURE_SH_APPLETS_ALWAYS_WIN bool "Standalone shell -- applets always win" default n depends on CONFIG_MSH || CONFIG_LASH || CONFIG_HUSH || CONFIG_ASH help - Please submit a patch to add help text for this item. + Use a command builtin to the shell over one with the same name, + that may be on the system. config CONFIG_FEATURE_SH_FANCY_PROMPT bool "Fancy shell prompts" diff --git a/util-linux/Config.in b/util-linux/Config.in index be56020..d2e8272 100644 --- a/util-linux/Config.in +++ b/util-linux/Config.in @@ -298,7 +298,7 @@ config CONFIG_NFSMOUNT default n depends on CONFIG_MOUNT help - Please submit a patch to add help text for this item. + Enable mounting of NFS file systems. config CONFIG_UMOUNT bool "umount" -- cgit v1.1