* help texts h..i rounded off, some fixes

git-svn-id: https://svn.pengutronix.de/svn/ptxdist/trunks/ptxdist-trunk@7442 33e552b5-05e3-0310-8538-816dae2090ed

27 files changed, 163 insertions, 65 deletions

diff --git a/rules/host-cmake.in b/rules/host-cmake.in
index a37c434c5..beed40583 100644
--- a/rules/host-cmake.in
+++ b/rules/host-cmake.in
@@ -3,4 +3,7 @@ config HOST_CMAKE
         prompt "cmake 2.4.2"
 	select HOST_FAKEROOT
 	help
-		
+	  CMake is an open-source, cross-platfom
+	  build environment. It supports native
+	  build processes on Unix and Windows
+	  platforms under a variety of compilers.
diff --git a/rules/host-dbus.in b/rules/host-dbus.in
index 97d5af91b..95b041afb 100644
--- a/rules/host-dbus.in
+++ b/rules/host-dbus.in
@@ -1,4 +1,13 @@
 config HOST_DBUS
 	bool
 	select HOST_EXPAT
+	help
+	  D-Bus is a message bus system, a simple way
+	  for applications to talk to one another. In
+	  addition to interprocess communication, D-Bus
+	  helps coordinate process lifecycle; it makes
+	  it simple and reliable to code a "single
+	  instance" application or daemon, and to launch
+	  applications and daemons on demand when their
+	  services are needed.
 
diff --git a/rules/host-e2fsprogs.in b/rules/host-e2fsprogs.in
index a2f454072..fcbe0f950 100644
--- a/rules/host-e2fsprogs.in
+++ b/rules/host-e2fsprogs.in
@@ -2,7 +2,7 @@ menuconfig HOST_E2FSPROGS
 	bool
 	prompt "e2fsprogs               "
 	help
-	  Useful Hosttools for management of ext2 and ext3 filesystems
+	  Useful hosttools for management of ext2 and ext3 filesystems
 
 config HOST_E2FSPROGS_TUNE2FS
 	bool
diff --git a/rules/host-flex.in b/rules/host-flex.in
index 148f88fb4..f4a4a609f 100644
--- a/rules/host-flex.in
+++ b/rules/host-flex.in
@@ -3,5 +3,9 @@ config HOST_FLEX254
 	prompt "flex 2.5.4 [BROKEN]"
 	depends on BROKEN
 	help
-	  FIXME: This item needs to be documented
+	  Flex (The Fast Lexical Analyzer)
 
+	  Flex is a fast lexical analyser generator. It is
+	  a tool for generating programs that perform
+	  pattern-matching on text. Flex is a non-GNU free
+	  implementation of the well known Lex program.
diff --git a/rules/host-flex254.in b/rules/host-flex254.in
index 3c2f0ca8c..863a2d9d4 100644
--- a/rules/host-flex254.in
+++ b/rules/host-flex254.in
@@ -3,5 +3,12 @@ config HOST_FLEX254
 	depends on BROKEN
 	prompt "HOST_FLEX254 [BROKEN]"
 	help
-	  FIXME: This item needs to be documented
+	  Flex (The Fast Lexical Analyzer)
+
+	  Flex is a fast lexical analyser generator. It is
+	  a tool for generating programs that perform
+	  pattern-matching on text. Flex is a non-GNU free
+	  implementation of the well known Lex program.
+
+
 
diff --git a/rules/host-gconf.in b/rules/host-gconf.in
index cf4f7df2a..2dc5a4b0a 100644
--- a/rules/host-gconf.in
+++ b/rules/host-gconf.in
@@ -1,4 +1,8 @@
 config HOST_GCONF
 	bool
 	prompt "gconf"
-
+	help
+	  GConf is a system for storing application
+	  preferences. It is intended for user
+	  preferences; not configuration of something
+	  like Apache, or arbitrary data storage.
diff --git a/rules/host-genext2fs.in b/rules/host-genext2fs.in
index d9cc54b6a..5963c92f2 100644
--- a/rules/host-genext2fs.in
+++ b/rules/host-genext2fs.in
@@ -4,13 +4,13 @@ config HOST_GENEXT2FS
 	help
 	  ext2 filesystem generator for embedded systems
  	  `genext2fs' is meant to generate an ext2 filesystem
- 	  as a normal (non-root) user. It doesn't require you 
-	  to mount the image file to copy files on it. It 
-	  doesn't even require you to be the superuser to 
+ 	  as a normal (non-root) user. It doesn't require you
+	  to mount the image file to copy files on it. It
+	  doesn't even require you to be the superuser to
 	  make device nodes.
- 
- 	  Warning ! `genext2fs' has been designed for embedded
- 	  systems. As such, it will generate a filesystem for 
-	  single-user usage: all files/directories/etc... 
-	  will belong to UID/GID 0
+
+ 	  Warning! 'genext2fs' has been designed for embedded
+ 	  systems. As such, it will generate a filesystem for
+	  single-user usage: all files/directories/etc.
+	  will belong to UID/GID 0.
 
diff --git a/rules/host-genpart.in b/rules/host-genpart.in
index 3c9e225b2..065fa3843 100644
--- a/rules/host-genpart.in
+++ b/rules/host-genpart.in
@@ -4,4 +4,4 @@ config HOST_GENPART
 	help
 	  Tool to generate a 16 byte partition table entry defined by
 	  command line arguments and dump it to stdout. No CHS magic is
-	  done, only lba entries are filled out.
+	  done, only LBA entries are filled out.
diff --git a/rules/host-gettext.in b/rules/host-gettext.in
index 8c7313244..376b8c257 100644
--- a/rules/host-gettext.in
+++ b/rules/host-gettext.in
@@ -11,5 +11,4 @@ config HOST_GETTEXT_LIBINTL
 	depends on HOST_GETTEXT
 	prompt "Install GNU libintl"
 	help
-	  FIXME: This item needs to be documented
-
+	  libintl is the GNU internationalization runtime library.
diff --git a/rules/host-gtk.in b/rules/host-gtk.in
index a5ce07c1e..85432a47c 100644
--- a/rules/host-gtk.in
+++ b/rules/host-gtk.in
@@ -17,10 +17,10 @@ menuconfig HOST_GTK
 #	select XORG_LIB_XRANDR if GTK_TARGET_X11_XRANDR
 
 	help
-	The GTK+ is a multi-platform toolkit for creating graphical
-	user interfaces. Offering a complete set of widgets, the GTK+
-	is suitable for projects ranging from small one-off tools to complete
-	application suites.
+	  The GTK+ is a multi-platform toolkit for creating graphical
+	  user interfaces. Offering a complete set of widgets, the GTK+
+	  is suitable for projects ranging from small one-off tools to complete
+	  application suites.
 
 #all_loaders="png,bmp,wbmp,gif,ico,ani,jpeg,pnm,ras,tiff,xpm,tga,pcx"
 
diff --git a/rules/host-libiconv.in b/rules/host-libiconv.in
index f266dd7d3..34d9f37a1 100644
--- a/rules/host-libiconv.in
+++ b/rules/host-libiconv.in
@@ -13,5 +13,5 @@ config HOST_LIBICONV_EXTRA_ENCODINGS
 	bool
 	prompt "build with support for extra encodings"
 	help
-	  provides support for a few extra encodings. see
-	  readme in source package for details
+	  provides support for a few extra encodings. See
+	  readme in source package for details.
diff --git a/rules/host-libxml2.in b/rules/host-libxml2.in
index 07a3d501e..213142d40 100644
--- a/rules/host-libxml2.in
+++ b/rules/host-libxml2.in
@@ -8,7 +8,14 @@ menuconfig HOST_LIBXML2
 	prompt "libxml2                     "
 	select HOST_ZLIB if HOST_LIBXML2_ZLIB
 	help
-	  FIXME: This item needs to be documented
+	  Libxml2 is a XML C parser and toolkit. XML itself is a
+	  metalanguage to design markup languages, i.e. text
+	  language where semantic and structure are added to the
+	  content using extra "markup" information enclosed
+	  between angle brackets. HTML is the most well-known
+	  markup language. Though the library is written in C a
+	  variety of language bindings make it available in other
+	  environments.
 
 config HOST_LIBXML2_C14N
 	bool
@@ -98,7 +105,8 @@ config HOST_LIBXML2_ICONV
 	depends on HOST_LIBXML2
 	prompt "ICONV support"
 	help
-	  Add ICONV support.
+	  Add ICONV support. The iconv program converts
+	  text from one encoding to another encoding.
 
 config HOST_LIBXML2_ISO8859X
 	bool
@@ -193,6 +201,9 @@ config HOST_LIBXML2_SAX1
 	prompt "SAX1 API"
 	help
 	  Enable the SAX1 API
+	  SAX is the Simple API for XML, originally a
+	  Java-only API. SAX was the first widely adopted
+	  API for XML in Java, and is a 'de facto' standard.
 
 config HOST_LIBXML2_SCHEMAS
 	bool
@@ -200,7 +211,8 @@ config HOST_LIBXML2_SCHEMAS
 	depends on HOST_LIBXML2
 	prompt "Relax-NG/Schema Support"
 	help
-	  Add Relay-NG and experimental Schemas support
+	  Add Relax-NG and experimental Schemas support.
+	  RELAX NG is a schema language for XML.
 
 config HOST_LIBXML2_SCHEMATRON
 	bool
@@ -210,6 +222,11 @@ config HOST_LIBXML2_SCHEMATRON
 	help
 	  Add Schematron support
 
+	  The Schematron differs in basic concept from
+	  other schema languages in that it not based
+	  on grammars but on finding tree patterns in
+	  the parsed document.
+
 config HOST_LIBXML2_THREADS
 	bool
 	default y
@@ -233,13 +250,21 @@ config HOST_LIBXML2_DOM
 	help
 	  Add the DOM tree manipulation API.
 
+	  The XML Document Object Model (XML DOM) defines
+	  a standard way for accessing and manipulating
+	  XML documents.
+	  The DOM presents an XML document as a tree-structure
+	  (a node tree), with the elements, attributes,
+	  and text defined as nodes.
+
 config HOST_LIBXML2_DTD
 	bool
 	default y
 	depends on HOST_LIBXML2
 	prompt "DTD Validation support"
 	help
-	  Add the DTD validation support
+	  Add the DTD (Document Type Definition)
+	  validation support
 
 config HOST_LIBXML2_WRITER
 	bool
@@ -255,7 +280,11 @@ config HOST_LIBXML2_XINCLUDE
 	depends on HOST_LIBXML2
 	prompt "XInclude"
 	help
-	  XInclude support.
+	  XInclude introduces a generic mechanism for merging
+	  XML documents (as represented by their information sets)
+	  for use by applications that need such a facility.
+	  The syntax leverages existing XML constructs - elements,
+	  attributes, and URI references.
 
 config HOST_LIBXML2_XPATH
 	bool
@@ -263,7 +292,9 @@ config HOST_LIBXML2_XPATH
 	depends on HOST_LIBXML2
 	prompt "XPATH support"
 	help
-	  XPATH support
+	  XPath is a language for addressing parts
+	  of an XML document, designed to be used
+	  by both XSLT and XPointer.
 
 config HOST_LIBXML2_XPTR
 	bool
@@ -271,7 +302,20 @@ config HOST_LIBXML2_XPTR
 	depends on HOST_LIBXML2
 	prompt "XPTR"
 	help
-	  XPointer support
+	  XML Pointer Language (XPointer) is a language to
+	  be used as the basis for a fragment identifier for
+	  any URI reference that locates a resource whose
+	  Internet media type is one of text/xml,
+	  application/xml, text/xml-external-parsed-entity,
+	  or application/xml-external-parsed-entity.
+
+	  XPointer, which is based on the XML Path Language
+	  (XPath), supports addressing into the internal
+	  structures of XML documents. It allows for
+	  examination of a hierarchical document structure
+	  and choice of its internal parts based on various
+	  properties, such as element types, attribute values,
+	  character content, and relative position.
 
 config HOST_LIBXML2_MODULES
 	bool
diff --git a/rules/host-libxslt.in b/rules/host-libxslt.in
index ebfd5a4c4..76de4ff78 100644
--- a/rules/host-libxslt.in
+++ b/rules/host-libxslt.in
@@ -49,6 +49,8 @@ config HOST_LIBXSLT_LIBEXSLT
 	prompt "libexslt"
 	default y if HOST_LIBXSLT
 	depends on HOST_LIBXSLT
+	help
+	  EXSLT is a community initiative to provide extensions to XSLT.
 
 config HOST_LIBXSLT_XSLTPROC
 	bool
diff --git a/rules/host-pelts.in b/rules/host-pelts.in
index 9f97f77e7..d8d406c84 100644
--- a/rules/host-pelts.in
+++ b/rules/host-pelts.in
@@ -3,4 +3,4 @@ config HOST_PELTS
 	prompt "pelts"
 	help
 	  Pengutronix Embedded Linux Test Suite
-	
+
diff --git a/rules/host-python24.in b/rules/host-python24.in
index d242a905b..f422f7f19 100644
--- a/rules/host-python24.in
+++ b/rules/host-python24.in
@@ -1,4 +1,6 @@
 config HOST_PYTHON24
 	bool
 	prompt "Python 2.4"
-
+	help
+	  Python is an interpreted, interactive,
+	  object-oriented, extensible programming language.
diff --git a/rules/host-util-linux.in b/rules/host-util-linux.in
index 90bec611c..be9c15d23 100644
--- a/rules/host-util-linux.in
+++ b/rules/host-util-linux.in
@@ -7,18 +7,18 @@ config HOST_UTIL_LINUX_FDISK
 	prompt "fdisk"
 	depends on HOST_UTIL_LINUX
 	help
-	  FIXME: This item needs to be documented
+	  fdisk - Partition table manipulator for Linux
 
 config HOST_UTIL_LINUX_CFDISK
 	bool
 	prompt "cfdisk"
 	depends on HOST_UTIL_LINUX
 	help
-	  FIXME: This item needs to be documented
+	  cfdisk - Curses based disk partition table manipulator
 
 config HOST_UTIL_LINUX_SFDISK
 	bool
 	prompt "sfdisk"
 	depends on HOST_UTIL_LINUX
 	help
-	  FIXME: This item needs to be documented
+	  sfdisk - Partition table manipulator for Linux
diff --git a/rules/hpanel.in b/rules/hpanel.in
index b2f3a2f80..ab23dec62 100644
--- a/rules/hpanel.in
+++ b/rules/hpanel.in
@@ -5,7 +5,7 @@ config HPANEL
 	select XORG_LIB_XPM
 	prompt "hpanel"
 	help
-	  hpaenl is a small panel that lists your windows 
-	  and allows you to switch workspaces. works with
-	  pekwm
+	  hpanel is a small panel that lists your windows 
+	  and allows you to switch workspaces. Works with
+	  pekwm.
 
diff --git a/rules/hrtimers-support.in b/rules/hrtimers-support.in
index dc87c6365..7ffe84550 100644
--- a/rules/hrtimers-support.in
+++ b/rules/hrtimers-support.in
@@ -1,7 +1,7 @@
 config HRTIMERS_SUPPORT
 	bool
 	depends on BROKEN
-	# probably not needed any more with > glibc-2.5
+	# probably not needed anymore with > glibc-2.5
 	prompt "hrtimers-support"
 	help
 	  This is the support library for the High Resolution Timer
diff --git a/rules/i855resolution.in b/rules/i855resolution.in
index ba848c22d..c1718f94f 100644
--- a/rules/i855resolution.in
+++ b/rules/i855resolution.in
@@ -2,5 +2,5 @@ config I855RESOLUTION
 	bool
 	prompt "i855resolution"
 	help
-	  FIXME
+	  This tool is a patch/hack to add modes to the video bios.
 
diff --git a/rules/i915resolution.in b/rules/i915resolution.in
index eba5e6a42..f67f3842c 100644
--- a/rules/i915resolution.in
+++ b/rules/i915resolution.in
@@ -2,5 +2,5 @@ config I915RESOLUTION
 	bool
 	prompt "i915resolution"
 	help
-	  FIXME
+	  This tool is a patch/hack to add modes to the video bios.
 
diff --git a/rules/ifplugd.in b/rules/ifplugd.in
index 17c3e9556..82cb652c3 100644
--- a/rules/ifplugd.in
+++ b/rules/ifplugd.in
@@ -5,7 +5,7 @@ menuconfig IFPLUGD
 	help
 	  ifplugd is a Linux daemon which will automatically configure your
 	  ethernet device when a cable is plugged in and automatically
-	  unconfigure it if the cable is pulled.
+	  unconfigure it once the cable is pulled.
 
 config IFPLUGD_STATUS
 	bool
diff --git a/rules/images.in b/rules/images.in
index 242e88d45..f7a09af6e 100644
--- a/rules/images.in
+++ b/rules/images.in
@@ -18,8 +18,8 @@ config IMAGE_HD
 	  General
 	  -------
 
-	  Build a harddisk root image. The image will contain a partition table
-	  which you can define with the following entries. Note that the resulting
+	  Build a harddisk root image. The image will contain a partition
+	  table defined by the following entries. Note that the resulting
 	  partition table does not have CHS entries but only LBA entries, so
 	  you need to switch your (x86-) Bios to LBA. Also note that fdisk will
 	  complain about inconsistent CHS/LBA entries. You can ignore these warnings.
diff --git a/rules/inetutils.in b/rules/inetutils.in
index 767e5ec64..05c4949f3 100644
--- a/rules/inetutils.in
+++ b/rules/inetutils.in
@@ -2,7 +2,14 @@ menuconfig INETUTILS
 	bool
 	prompt "inetutils           "
 	help
-	  FIXME: This item needs to be documented
+	  Inetutils is a collection of common network programs. It includes:
+	  * An ftp client and server.
+	  * A telnet client and server.
+	  * An rsh client and server.
+	  * An rlogin client and server.
+	  * A tftp client and server.
+	  * And much more... 
+	  These are improved versions of programs originally from BSD.
 
 comment "build options   ---"
 	depends on INETUTILS
@@ -35,21 +42,26 @@ config INETUTILS_RCP
 	prompt "rcp"
 	depends on INETUTILS
 	help
-	  FIXME: This item needs to be documented
+	  Rcp copies files between machines.
 
 config INETUTILS_RLOGIND
 	bool
 	prompt "rlogind"
 	depends on INETUTILS
 	help
-	  FIXME: This item needs to be documented
+	  Rlogind is the server for the program. The server provides a remote
+	  login facility with authentication based on privileged port numbers
+	  from trusted hosts.
 
 config INETUTILS_RSH
 	bool
 	prompt "rsh"
 	depends on INETUTILS
 	help
-	  FIXME: This item needs to be documented
+	  rsh - remote shell
+	  Rsh copies its standard input to the remote command, the standard
+	  output of the remote command to its standard output, and the
+	  standard error of the remote command to its standard error.
 
 config INETUTILS_RSHD
 	bool
@@ -57,22 +69,27 @@ config INETUTILS_RSHD
 	depends on INETUTILS
 	select INETUTILS_INETD
 	help
-	  FIXME: This item needs to be documented
+	  Rshd is the server for the program. The server provides remote
+	  execution facilities with authentication based on privileged
+	  port numbers from trusted hosts.
 
 config INETUTILS_SYSLOGD
 	bool
 	prompt "syslogd"
 	depends on INETUTILS
 	help
-	  FIXME: This item needs to be documented
+	  Sysklogd provides two system utilities which provide support
+	  for system logging and kernel message trapping. Support of both
+	  internet and unix domain sockets enables this utility package
+	  to support both local and remote logging.
 
 config INETUTILS_TFTPD
 	bool
 	prompt "tftpd"
 	depends on INETUTILS
 	help
-	  TFTPD is a ftp daemon to be used for diskless clients. Most bootloader
-	  using the Trivisal File Transfer Protocol to load their OS image. Note:
+	  TFTPD is a ftp daemon to be used for diskless clients. Most bootloaders
+	  use the Trivial File Transfer Protocol to load their OS image. Note:
 	  There is no authentication!
 
 comment "runtime options  ---"
@@ -131,3 +148,4 @@ config INETUTILS_TFTPD_STRING
 	  Note: This tftp daemon can be started on demand from inetd only. You
 	  must enable one of the two possible inet daemons: There is one
 	  embedded in busybox and one in this packet.
+
diff --git a/rules/initng.in b/rules/initng.in
index 52a4fbbf7..2b1b2eb49 100644
--- a/rules/initng.in
+++ b/rules/initng.in
@@ -5,7 +5,7 @@ menuconfig INITNG
 	select GLIBC_DL
 	prompt "initng              "
 	help
-	  Initng is a full replacement of the old and in many ways 
+	  Initng is a full replacement of the old and in many ways
 	  deprecated sysvinit tool. It is designed with speed in mind, doing
 	  as much as possible asynchronously. In other words: It will boot
 	  your system faster, give you more control over the boot process,
@@ -57,7 +57,7 @@ config INITNG_ALSO
 config INITNG_BASH_LAUNCHER
 	bool
 	depends on INITNG
-	prompt "Bash Launcer Plugin"
+	prompt "Bash Launcher Plugin"
 	help
 	  FIXME
 
@@ -141,7 +141,7 @@ config INITNG_FIND
 
 config INITNG_FMON
 	bool
-	depends on INITNG 
+	depends on INITNG
 	depends on ARCH_X86 || ARCH_PPC
 	prompt "File Monitoring Plugin"
 	help
diff --git a/rules/iproute2.in b/rules/iproute2.in
index 00c967f87..a143e7908 100644
--- a/rules/iproute2.in
+++ b/rules/iproute2.in
@@ -3,5 +3,7 @@ config IPROUTE2
 	prompt "iproute2"
 	select DB44
 	help
-	  FIXME
+	  Iproute2 is a collection of utilities for
+	  controlling TCP/IP networking and traffic
+	  control in Linux.
 
diff --git a/rules/iptables.in b/rules/iptables.in
index 50fd2a33b..6a3b46c53 100644
--- a/rules/iptables.in
+++ b/rules/iptables.in
@@ -4,10 +4,10 @@ menuconfig IPTABLES
 	prompt "iptables            "
 	bool
 	help
-	  Iptables  is used to set up, maintain, and inspect the 
-	  tables of IP packet filter rules in the Linux kernel.  
-	  Several different tables may be defined.  Each table 
-	  contains a number of built-in chains and may also 
+	  Iptables  is used to set up, maintain, and inspect the
+	  tables of IP packet filter rules in the Linux kernel.
+	  Several different tables may be defined.  Each table
+	  contains a number of built-in chains and may also
 	  contain user-defined chains.
 
 config IPTABLES_INSTALL_IP6TABLES
@@ -19,7 +19,7 @@ config IPTABLES_INSTALL_IP6TABLES
 
 config IPTABLES_INSTALL_IPTABLES
 	bool
-	prompt "install iptables"	
+	prompt "install iptables"
 	depends on IPTABLES
 	help
 	  install the IPv4 Version of iptables
@@ -29,14 +29,18 @@ config IPTABLES_INSTALL_IPTABLES_RESTORE
 	prompt "install iptables-restore"
 	depends on IPTABLES
 	help
-	  FIXME: This item needs to be documented
+	  The iptables-restore command is used to restore
+	  the iptables rule-set that was saved with the
+	  iptables-save command.
 
 config IPTABLES_INSTALL_IPTABLES_SAVE
 	bool
 	prompt "install iptables-save"
 	depends on IPTABLES
 	help
-	  FIXME: This item needs to be documented
+	  The iptables-save command is a tool to save
+	  the current rule-set into a file that
+	  iptables-restore can use.
 
 comment "----------------------------------"
 	depends on IPTABLES
diff --git a/rules/xcursor-transparent-theme.in b/rules/xcursor-transparent-theme.in
index 57a9caa12..b5e4bfaf4 100644
--- a/rules/xcursor-transparent-theme.in
+++ b/rules/xcursor-transparent-theme.in
@@ -3,7 +3,7 @@ config XCURSOR_TRANSPARENT_THEME
 	depends on XORG_CURSOR
 	prompt "xcursor transparent theme"
 	help
-	  This package contains a totally transparent X11 Cursor
+	  This package contains a totally transparent X11 cursor
 	  theme. Using the theme provides an effective and flexible
-	  way to hide the X11 Cursor. This kind of behaviour maybe
-	  required on Handheld computers running the X Window System.
+	  way to hide the X11 cursor. This kind of behaviour may be
+	  required on handheld computers running the X Window System.