help text amendments

Signed-off-by: Jochen Frieling <j.frieling@pengutronix.de>
Signed-off-by: Michael Olbrich <m.olbrich@pengutronix.de>

15 files changed, 139 insertions, 52 deletions

diff --git a/rules/boost.in b/rules/boost.in
index a5f6e949a..970247c55 100644
--- a/rules/boost.in
+++ b/rules/boost.in
@@ -37,7 +37,7 @@ config BOOST_INST_NOMT_DBG
 	bool
 	prompt "Install binaries with debug functions"
 	help
-	  Install binaries with debugging functions.
+	  Installs binaries with debugging functions.
 
 config BOOST_INST_NOMT_RED
 	bool
@@ -57,7 +57,7 @@ config BOOST_INST_MT_RED
 	bool
 	select BOOST_THREAD
 	prompt "Install reduced binaries with multithread support"
-	default y 
+	default y
 	help
 	  Installs binaries with multithread support, needs thread library.
 
@@ -67,72 +67,72 @@ config BOOST_DATE_TIME
  	bool
  	prompt "date_time"
  	help
- 	  Boost date time library.
+	  Boost date time library
 
 config BOOST_FILESYSTEM
 	bool
 	prompt "filesystem"
 	help
-	  Boost filesystem library.
+	  Boost filesystem library
 
 config BOOST_GRAPH
 	bool
 	prompt "graph"
 	help
-	  Boost graph library.
+	  Boost graph library
 
 config BOOST_IOSTREAMS
 	bool
 	prompt "iostreams"
 	help
-	  Boost iostream library. 
+	  Boost iostream library
 
 config BOOST_PROGRAM_OPTIONS
 	bool
  	prompt "program options"
  	help
-	  Boost programm option parser
+	  Boost program option parser
 
 config BOOST_REGEX
 	bool
 	prompt "regex"
 	help
-	  Boost regex library.
+	  Boost regex library
 
 config BOOST_SERIALIZATION
  	bool
  	prompt "serialization"
  	help
- 	  Boost serialization library.
+	  Boost serialization library
 
 config BOOST_SIGNALS
  	bool
  	prompt "signals"
  	help
- 	  Boost signals library.
+	  Boost signals library
 
 config BOOST_TEST
  	bool
  	prompt "test"
  	help
- 	  Boost test framework.
+	  Boost test framework
 
 config BOOST_THREAD
 	bool
 	prompt "thread"
 	help
-	  Portable C++ multi-threading library.
+	  Portable C++ multi-threading library
 
 config BOOST_WAVE
 	bool
 	prompt "wave"
 	help
-	  Boost wave library.
+	  Boost wave library
 
 config BOOST_PYTHON
 	bool
 	prompt "python"
 	depends on BROKEN
 	help
-	  boost python support. (still broken)
+	  boost python support (still broken)
 endif
diff --git a/rules/diffutils.in b/rules/diffutils.in
index dbb245a03..3e1179753 100644
--- a/rules/diffutils.in
+++ b/rules/diffutils.in
@@ -4,6 +4,9 @@ menuconfig DIFFUTILS
 	select LIBC_RT if DIFFUTILS_DIFF
 	select GCCLIBS_GCC_S if DIFFUTILS_CMP
 	prompt "gnu diffutils                 "
+	help
+	  The GNU diffutils package, containing
+	  cmp, diff, diff3 and sdiff
 
 if DIFFUTILS
 
diff --git a/rules/flashbench.in b/rules/flashbench.in
index 7dd8cb432..8526fc20a 100644
--- a/rules/flashbench.in
+++ b/rules/flashbench.in
@@ -22,7 +22,7 @@ config FLASHBENCH_MAX_BUFSIZE
 	prompt "Maximum flashbench buffer size in megabytes"
 	default 64
 	help
-	  This is the maximum buffer size flashbench uses during operationg.
+	  This is the maximum buffer size flashbench uses during operation.
 	  The buffer gets allocated 4 times, so take that into account when
 	  choosing a buffer. The default is 64 MiB.
 
diff --git a/rules/hal.in b/rules/hal.in
index d60ca30d3..c321c7da9 100644
--- a/rules/hal.in
+++ b/rules/hal.in
@@ -20,5 +20,7 @@ if HAL
 config HAL_POLKIT
 	bool
 	prompt "policy kit support"
+	help
+	  Enable PolicyKit usage, which will also select ConsoleKit
 
 endif
diff --git a/rules/inetutils.in b/rules/inetutils.in
index 3e665fd09..fa79dfdb5 100644
--- a/rules/inetutils.in
+++ b/rules/inetutils.in
@@ -34,6 +34,8 @@ config INETUTILS_INETD_STARTSCRIPT
 	bool
 	default y
 	prompt "install /etc/init.d/inetd"
+	help
+	  Install an init script for the network super daemon inetd
 
 endif
 
diff --git a/rules/initmethod.in b/rules/initmethod.in
index 4a29b8494..c7deb9ca7 100644
--- a/rules/initmethod.in
+++ b/rules/initmethod.in
@@ -3,6 +3,8 @@
 menuconfig INITMETHOD
 	bool  "init                          "
 	default y
+	help
+	  Choose the system startup init method here
 
 if INITMETHOD
 
diff --git a/rules/iproute2.in b/rules/iproute2.in
index 23f6533c2..08589ab9b 100644
--- a/rules/iproute2.in
+++ b/rules/iproute2.in
@@ -32,15 +32,21 @@ config IPROUTE2_ARPD
 config IPROUTE2_CTSTAT
 	bool
 	prompt "ctstat"
+	help
+	  The connection status utility. Maybe linked to lnstat.
 
 config IPROUTE2_GENL
 	bool
 	prompt "genl"
+	help
+	  Generic Netlink
 
 config IPROUTE2_IP
 	bool
 	depends on !BUSYBOX_IP || ALLYES
 	prompt "ip"
+	help
+	  The main tool. Well known as in "ip addr" or "ip route".
 
 comment "busybox' ip is selected"
 	depends on BUSYBOX_IP
@@ -48,49 +54,81 @@ comment "busybox' ip is selected"
 config IPROUTE2_IFCFG
 	bool
 	prompt "ifcfg"
+	help
+	  ifcfg is a script wrapping ip, written as replacement for
+	  ifconfig.
+	  Needs arping and rdisk programs from the iputils package.
 
 config IPROUTE2_IFSTAT
 	bool
 	prompt "ifstat"
+	help
+	  handy utility to read net interface statistics
 
 config IPROUTE2_LNSTAT
 	bool
 	prompt "lnstat"
+	help
+	  lnstat is a generalized and more feature-complete replacement
+	  for the old rtstat program. In addition to routing cache
+	  statistics, it supports any kind of statistics the linux
+	  kernel exports via a file in /proc/net/stat/.
 
 config IPROUTE2_NSTAT
 	bool
 	prompt "nstat"
+	help
+	  handy utility to read counters /proc/net/netstat and snmp
 
 config IPROUTE2_ROUTEF
 	bool
 	prompt "routef"
+	help
+	  Component of ip route for flushing the routing tables
 
 config IPROUTE2_ROUTEL
 	bool
 	prompt "routel"
+	help
+	  Component of ip route for listing the routing tables
 
 config IPROUTE2_RTACCT
 	bool
 	prompt "rtacct"
+	help
+	  Used to display the contents of /proc/net/rt_acct
 
 config IPROUTE2_RTMON
 	bool
 	prompt "rtmon"
+	help
+	  Route monitoring
 
 config IPROUTE2_RTPR
 	bool
 	prompt "rtpr"
+	help
+	  A tool to make the output of "ip -o" readable
 
 config IPROUTE2_RTSTAT
 	bool
 	prompt "rtstat"
+	help
+	  Route status utility, maybe linked to lnstat.
 
 config IPROUTE2_SS
 	bool
 	prompt "ss"
+	help
+	  ss is used to dump socket statistics. It allows showing
+	  information similar to netstat. It can display more TCP
+	  and state informations than other tools.
 
 config IPROUTE2_TC
 	bool
 	prompt "tc"
+	help
+	  In Quality Of Service (QOS) and Class Of Service (COS)
+	  scenarios used for traffic controlling
 
 endif
diff --git a/rules/irssi.in b/rules/irssi.in
index fed79d40b..9545a160d 100644
--- a/rules/irssi.in
+++ b/rules/irssi.in
@@ -17,5 +17,7 @@ if IRSSI
 config IRSSI_SSL
 	bool
 	prompt "support for SSL"
+	help
+	  Activate SSL support in Irssi using OpenSSL
 
 endif
diff --git a/rules/killproc.in b/rules/killproc.in
index 31135ec53..41000f4fd 100644
--- a/rules/killproc.in
+++ b/rules/killproc.in
@@ -3,25 +3,34 @@
 menuconfig KILLPROC
 	tristate "killproc                      "
 	help
-	  Utilities for starting and stopping of programs.
+	  Utilities for starting and stopping of programs
+	  (Werner Fink's killproc package)
 
 config KILLPROC_CHECKPROC
 	bool
 	depends on KILLPROC
 	prompt "checkproc"
+	help
+	  Checks process(es) of the named program
 
 config KILLPROC_KILLPROC
 	bool
 	depends on KILLPROC
 	prompt "killproc"
+	help
+	  Kill all running processes of a named program
 
 config KILLPROC_STARTPROC
 	bool
 	depends on KILLPROC
 	prompt "startproc"
+	help
+	  Start process(es) of the named program
 
 config KILLPROC_USLEEP
 	bool
 	depends on KILLPROC
 	prompt "usleep"
+	help
+	  Sleep for the specified number of microseconds
 
diff --git a/rules/libcaca.in b/rules/libcaca.in
index eab1fa90c..e296341e2 100644
--- a/rules/libcaca.in
+++ b/rules/libcaca.in
@@ -35,6 +35,6 @@ config LIBCACA_X11
 config LIBCACA_CXX
 	bool "C++ bindings"
 	help
-	  select this, if you want to use libcaca from C++ progamms
+	  Select this if you want to use libcaca from C++ progams.
 
 endif
diff --git a/rules/links.in b/rules/links.in
index d1f20b695..a548931d4 100644
--- a/rules/links.in
+++ b/rules/links.in
@@ -23,18 +23,27 @@ if LINKS
 config LINKS_SSL
 	bool
 	prompt "support for SSL"
+	help
+	  Include support for Secure Socket Layer (SSL) transfers
 
 config LINKS_GPM
 	bool
 	prompt "support for GPM"
+	help
+	  Activate support for General Purpose Mouse (GPM) service
 
 config LINKS_PNG
 	bool
 	prompt "support for png"
+	help
+	  Activate support for Portable Network Graphics (PNG) image format
 
 config LINKS_JPEG
 	bool
 	prompt "support for jpeg"
+	help
+	  Activate support for Joint Photographic Experts Group (JPEG)
+	  image format
 
 config LINKS_FBCON
 	bool
@@ -42,6 +51,8 @@ config LINKS_FBCON
 	select LINKS_JPEG
 	select LINKS_GPM
 	prompt "support for fbcon"
+	help
+	  Activate support for Framebuffer Console mode
 
 config LINKS_TIFF
 	bool
diff --git a/rules/lsh.in b/rules/lsh.in
index 30c25f303..c744fa4bf 100644
--- a/rules/lsh.in
+++ b/rules/lsh.in
@@ -14,21 +14,23 @@ if LSH
 
 config LSH_EXECUV
 	bool
-	prompt "Install lsh-execuf"
+	prompt "Install lsh-execuv"
 	help
-	  FIXME: This item needs to be documented
+	  lsh-execuv is a utility program for the lsh server that
+	  securely executes a program as a different user.
 
 config LSH_LSHD
 	bool
 	prompt "Install lshd"
 	help
-	  FIXME: This item needs to be documented
+	  lshd is a server for the SSH-2 (secsh) protocol.
 
 config LSH_SFTPD
 	bool
 	prompt  "Install sftp-server"
 	help
-	  FIXME: This item needs to be documented
+	  Server for the sftp subsystem, see the --subsystems option
+	  to lshd.
 
 config LSH_MAKESEED
 	bool
diff --git a/rules/mtd-utils.in b/rules/mtd-utils.in
index 05ca078a8..45ab8e7ec 100644
--- a/rules/mtd-utils.in
+++ b/rules/mtd-utils.in
@@ -25,33 +25,33 @@ config MTD_UTILS_DOC_LOADBIOS
 	bool
 	prompt "doc_loadbios"
 	help
-	  Tool for DoC.
+	  Tool for DoC
 
 config MTD_UTILS_DOCFDISK
 	bool
 	prompt "docfdisk"
 	help
-	  Modify INFTL partition tables.
+	  Modify INFTL partition tables
 
 config MTD_UTILS_FLASH_ERASE
 	bool
 	prompt "flash_erase"
 	help
-	  erase parts of a MTD device
+	  Erase parts of a MTD device
 
 config MTD_UTILS_FLASH_ERASEALL
 	bool
 	prompt "flash_eraseall (deprecated)"
 	select MTD_UTILS_FLASH_ERASE
 	help
-	  ...use flash_erase instead
+	  Deprecated ... use flash_erase instead
 
 config MTD_UTILS_FLASH_LOCK
 	bool
 	prompt "flash_lock"
 	depends on !BUSYBOX_FLASH_LOCK || ALLYES
 	help
-	  This utility locks one or more sectors of flash device.
+	  This utility locks one or more sectors of a flash device.
 
 comment "busybox' flash_lock is selected!"
 	depends on BUSYBOX_FLASH_LOCK
@@ -60,20 +60,20 @@ config MTD_UTILS_FLASH_OTP_DUMP
 	bool
 	prompt "flash_otp_dump"
 	help
-	  Display one time programm data.
+	  Display one-time programmable data.
 
 config MTD_UTILS_FLASH_OTP_INFO
 	bool
 	prompt "flash_otp_info"
 	help
-	  Print info about one time program data.
+	  Print info about one-time programmable data.
 
 config MTD_UTILS_FLASH_UNLOCK
 	bool
 	prompt "flash_unlock"
 	depends on !BUSYBOX_FLASH_UNLOCK || ALLYES
 	help
-	  This utility unlock all sectors of flash device.
+	  This utility unlocks all sectors of a flash device.
 
 comment "busybox' flash_unlock is selected!"
 	depends on BUSYBOX_FLASH_UNLOCK
@@ -92,19 +92,20 @@ config MTD_UTILS_FTL_CHECK
 	bool
 	prompt "ftl_check"
 	help
-	  Utility to check an FTL partition
+	  Utility to check an FTL (Flash Translation Layer) partition
 
 config MTD_UTILS_FTL_FORMAT
 	bool
 	prompt "ftl_format"
 	help
-	  Utility to create an FTL partition in a memory region
+	  Utility to create an FTL (Flash Translation Layer) partition
+	  in a memory region
 
 config MTD_UTILS_JFFS2_DUMP
 	bool
 	prompt "jffs2_dump"
 	help
-	  This utility dumps the contents of a binary JFFS2 image
+	  This utility dumps the contents of a binary JFFS2 image.
 
 #config MTD_UTILS_JFFS2READER
 #	bool
@@ -151,8 +152,8 @@ config MTD_UTILS_NANDWRITE
 	prompt "nandwrite"
 	depends on !BUSYBOX_NANDWRITE || ALLYES
 	help
-	  This utility writes a binary image directly to a NAND flash
-	  chip or NAND chips contained in DoC devices. This is the
+	  This utility writes a binary image directly to NAND flash
+	  chips or NAND chips contained in DoC devices. This is the
 	  "inverse operation" of nanddump.
 
 comment "busybox' nandwrite is selected!"
@@ -162,13 +163,13 @@ config MTD_UTILS_NFTL_FORMAT
 	bool
 	prompt "nftl_format"
 	help
-	  Creating a NFTL/INFTL partition on an MTD device
+	  Creating an NFTL/INFTL partition on an MTD device
 
 config MTD_UTILS_NFTLDUMP
 	bool
 	prompt "nftldump"
 	help
-	  Dumping the content of NFTL partitions on a "Physical Disk"
+	  Dumping the contents of NFTL partitions on a "Physical Disk"
 
 config MTD_UTILS_MKJFFS2
 	bool
@@ -180,7 +181,7 @@ config MTD_UTILS_RECV_IMAGE
 	bool
 	prompt "recv_image"
 	help
-	  Receive an image via multicast.
+	  Receive an image via multicast
 
 config MTD_UTILS_RFDDUMP
 	bool
@@ -198,7 +199,7 @@ config MTD_UTILS_SERVE_IMAGE
 	bool
 	prompt "serve_image"
 	help
-	  Distribute flash image to network.
+	  Distribute flash image to network
 
 config MTD_UTILS_SUMTOOL
 	bool
@@ -222,7 +223,7 @@ config MTD_UTILS_UBIATTACH
 	prompt "ubiattach"
 	depends on !BUSYBOX_UBIATTACH || ALLYES
 	help
-	  Attach an ubi device to a mtd device
+	  Attach a UBI device to an MTD device
 
 comment "busybox' ubiattach is selected!"
 	depends on BUSYBOX_UBIATTACH
@@ -231,14 +232,14 @@ config MTD_UTILS_UBICRC32
 	bool
 	prompt "ubicrc32"
 	help
-	  UBI CRC2 file checksum
+	  UBI CRC32 file checksum
 
 config MTD_UTILS_UBIDETACH
 	bool
 	prompt "ubidetach"
 	depends on !BUSYBOX_UBIDETACH || ALLYES
 	help
-	  Detach an ubi device from a mtd device
+	  Detach a UBI device from an MTD device
 
 comment "busybox' ubidetach is selected!"
 	depends on BUSYBOX_UBIDETACH
@@ -248,14 +249,14 @@ config MTD_UTILS_UBIFORMAT
 	select GCCLIBS_GCC_S
 	prompt "ubiformat"
 	help
-	  format an mtd device
+	  Format an MTD device
 
 config MTD_UTILS_UBIMKVOL
 	bool
 	prompt "ubimkvol"
 	depends on !BUSYBOX_UBIMKVOL || ALLYES
 	help
-	  Creates a volume on a UBI device
+	  Creates a volume on a UBI device.
 
 comment "busybox' ubimkvol is selected!"
 	depends on BUSYBOX_UBIMKVOL
@@ -271,7 +272,7 @@ config MTD_UTILS_UBIRSVOL
 	prompt "ubirsvol"
 	depends on !BUSYBOX_UBIRSVOL || ALLYES
 	help
-	  Resize UBI volumes.
+	  Resize UBI volumes
 
 comment "busybox' ubirsvol is selected!"
 	depends on BUSYBOX_UBIRSVOL
@@ -280,13 +281,13 @@ config MTD_UTILS_UBINFO
 	bool
 	prompt "ubinfo"
 	help
-	  Provides infos on UBI volumes and devices
+	  Provides infos on UBI volumes and devices.
 
 config MTD_UTILS_UBINIZE
 	bool
 	prompt "ubinize"
 	help
-	  Creates UBI images. Probably more useful on host than on target
+	  Creates UBI images. Probably more useful on host than on target.
 
 config MTD_UTILS_UBIRMVOL
 	bool
@@ -318,7 +319,7 @@ config MTD_UTILS_MTDINFO
 	bool
 	prompt "mtdinfo"
 	help
-	  Print UBI specific information about mtd devices
+	  Print UBI specific information about MTD devices
 
 endif
 
diff --git a/rules/ncurses.in b/rules/ncurses.in
index a8c630e28..4dfb7f77a 100644
--- a/rules/ncurses.in
+++ b/rules/ncurses.in
@@ -43,7 +43,7 @@ config NCURSES_TERMCAP
 	bool "install minimal set of termcap data files"
 	default y
 	help
-		Installes the following termcap files:
+		Installs the following termcap files:
 		- xterm
 		- xterm-color
 		- xterm-xfree86
diff --git a/rules/ntp.in b/rules/ntp.in
index 91631ec85..0de5790c8 100644
--- a/rules/ntp.in
+++ b/rules/ntp.in
@@ -116,6 +116,7 @@ config NTP_SLEW_ALWAYS
 	help
 	  Slew the clock back into line by making gradual adjustments to the
 	  clock over a couple of minutes.
+	  (The slew rate of typical Unix kernels is limited to 0.5 ms/s.)
 
 config NTP_STEP_SLEW
 	bool
@@ -134,7 +135,8 @@ config NTP_HOURLY_TODR_SYNC
 	bool
 	prompt "sync TODR hourly"
 	help
-	  FIXME: This item needs to be documented
+	  If we should sync TODR hourly (the Solaris hardware clock).
+	  When unsure, say no here.
 
 config NTP_KERNEL_FLL_BUG
 	bool
@@ -146,13 +148,21 @@ config NTP_IRIG_SAWTOOTH
 	bool
 	prompt "enable the IRIG sawtooth filter"
 	help
-	  FIXME: This item needs to be documented
+	  The Sun kernel driver has a sawtooth modulation with
+	  amplitude over 5 ms peak-peak and period 5.5 s. The crafty
+	  IRIG driver uses a transverse filter to remove the
+	  modulation and something called a botttom-fisher to remove
+	  incidental positive spikes especially prevalent with Sun
+	  Blade 1000 and possibly other systems.
 
 config NTP_NIST
 	bool
 	prompt "enable the NIST lockclock scheme"
 	help
-	  FIXME: This item needs to be documented
+	  The NIST lockclock program synchronizes the local clock
+	  via a telephone modem and the NIST Automated Computer
+	  Time Service (ACTS), or the Digital Time Synchronization
+	  Service (DTSS), which runs on DCE machines.
 
 config NTP_CRYPTO
 	bool
@@ -164,7 +174,12 @@ config NTP_SNTP
 	bool
 	prompt "build SNTP"
 	help
-	  FIXME: This item needs to be documented
+	  Simple Network Time Protocol is a subset of the Network
+	  Time Protocol (NTP). SNTP can be used when the ultimate
+	  performance of a full NTP implementation based on
+	  RFC 1305 is neither needed nor justified.
+	  It is strongly recommended that SNTP be used only at
+	  the extremities of the synchronization subnet.
 
 config NTP_ARLIB
 	bool