[PATCH try #1] Kconfig: cleanup usr/Kconfig help descriptions

[PATCH try #1] Kconfig: cleanup usr/Kconfig help descriptions

[Nick Andrew]

Modify the help descriptions of usr/Kconfig for clarity, accuracy and consistency.

This patch mostly clarifies what INITRAMFS_SOURCE does, i.e. optionally
build a CPIO archive of the initial root filesystem (initramfs) and
compress it and link it into the kernel.  Note that usually the initramfs
is separate, and loaded by a bootloader (and I give a list of the common
ones, for clarity).

Correct the filename of gen_init_cpio.c and clarify that any filenames
specified contain lists of directives for the archive builder, rather than
files to be added directly into the archive.

Improve grammar on INITRAMFS_ROOT_UID and INITRAMFS_ROOT_GID and
use consistent terminology.

Signed-off-by: Nick Andrew <nick@nick-andrew.net>
---
I think I might be starting to get the hang of this :-)


 usr/Kconfig |   51 +++++++++++++++++++++++++++++++++------------------
 1 files changed, 33 insertions(+), 18 deletions(-)


diff --git a/usr/Kconfig b/usr/Kconfig
index 86cecb5..0ad8713 100644
--- a/usr/Kconfig
+++ b/usr/Kconfig
@@ -6,41 +6,56 @@ config INITRAMFS_SOURCE
 	string "Initramfs source file(s)"
 	default ""
 	help
-	  This can be either a single cpio archive with a .cpio suffix or a
-	  space-separated list of directories and files for building the
-	  initramfs image.  A cpio archive should contain a filesystem archive
-	  to be used as an initramfs image.  Directories should contain a
-	  filesystem layout to be included in the initramfs image.  Files
-	  should contain entries according to the format described by the
-	  "usr/gen_init_cpio" program in the kernel tree.
+	  Specify the contents of an early userspace image to be linked
+	  into the kernel image.
+
+	  A booting kernel usually obtains an initramfs image from a
+	  bootloader (e.g. loadlin, lilo or grub). Alternately one can
+	  be built and linked into the kernel image using this option.
+
+	  You can specify either a single cpio archive filename with a .cpio
+	  suffix or a space-separated list of directories and files for
+	  building the initramfs image. The result will be a compressed
+	  cpio archive containing a filesystem layout which will be
+	  used as an initramfs image by the booting kernel.
+
+	  A cpio archive should contain a filesystem layout which will
+	  become the initramfs image.
+
+	  Directories should contain a filesystem layout to be included
+	  into the initramfs image.
+
+	  Files should contain a list of directives according to the
+	  format described by the <file:usr/gen_init_cpio.c> program in
+	  the kernel tree.
 
 	  When multiple directories and files are specified then the
 	  initramfs image will be the aggregate of all of them.
 
 	  See <file:Documentation/early-userspace/README> for more details.
 
-	  If you are not sure, leave it blank.
+	  If unsure, leave it blank.
 
 config INITRAMFS_ROOT_UID
 	int "User ID to map to 0 (user root)"
 	depends on INITRAMFS_SOURCE!=""
 	default "0"
 	help
-	  This setting is only meaningful if the INITRAMFS_SOURCE is
-	  contains a directory.  Setting this user ID (UID) to something
-	  other than "0" will cause all files owned by that UID to be
-	  owned by user root in the initial ramdisk image.
+	  This setting is only meaningful if INITRAMFS_SOURCE contains
+	  a directory.	Setting this user ID (UID) to something other
+	  than "0" will cause all files owned by that UID in the source
+	  directories to be owned by user root in the initramfs image.
 
-	  If you are not sure, leave it set to "0".
+	  If unsure, leave it set to "0".
 
 config INITRAMFS_ROOT_GID
 	int "Group ID to map to 0 (group root)"
 	depends on INITRAMFS_SOURCE!=""
 	default "0"
 	help
-	  This setting is only meaningful if the INITRAMFS_SOURCE is
-	  contains a directory.  Setting this group ID (GID) to something
-	  other than "0" will cause all files owned by that GID to be
-	  owned by group root in the initial ramdisk image.
+	  This setting is only meaningful if INITRAMFS_SOURCE contains
+	  a directory.	Setting this group ID (GID) to something other
+	  than "0" will cause all files owned by that GID in the source
+	  directories to be owned by group root in the initramfs image.
 
-	  If you are not sure, leave it set to "0".
+	  If unsure, leave it set to "0".