Patch from Kent Robotti adding a bunch of menuconfig help
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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"