Revised the comments in config files.

CLFS/config

@@ -7,7 +7,7 @@
 #####
 declare -r FTP=ftp://ftp.linuxfromscratch.org/pub/lfs/conglomeration
 
-#--- Which target architecture,
+#--- Which target architecture you want to build for,
 #    used to select proper book and set TARGETS
 #--------------------------------
 TARGET32=""
@@ -36,17 +36,19 @@ TARGET=
 # ARCH=sparc64 ; TARGET="sparc64-unknown-linux-gnu"   ; TARGET32="sparcv9-unknown-linux-gnu"
 # ARCH=ppc64   ; TARGET="powerpc64-unknown-linux-gnu" ; TARGET32="powerpc-unknown-linux-gnu"
 
-#--- Create a minimal boot system chroot/boot
+#--- What build method should be used chroot/boot
 #    NOTE: not all combinations are 'bootable' yet.
 METHOD=chroot
 
 #--- Location of fstab file (if empty, a template is created)
 FSTAB=
 
-#--- Location of kernel config file (if the kernel is to be compiled)
+#--- Fully qualified path to a kernel config file
+# If no config file is  specified the kernel is NOT compiled
 CONFIG=
 
-#--- Location of boot-kernel config file (if METHOD=boot)
+#--- If METHOD=boot, location of boot-kernel config file
+#    NOTE: this setting is required
 BOOT_CONFIG=
 
 #--- Book's sources directory
@@ -56,7 +58,7 @@ BOOK=
 #==== INTERNAL VARIABLES ====
 # Don't edit it unless you know what you are doing
 
-#--- Files that will be copied to $JHALFSDIR
+#--- Extra files that need be copied to $JHALFSDIR
 FILES="patcheslist.xsl  packageslist.xsl"
 
 #--- Default stylesheet
@@ -64,6 +66,8 @@ XSL=clfs.xsl
 
 #--- Book version
 LFSVRS=development
+
+#--- Name of the makefile
 MKFILE=$JHALFSDIR/Makefile
 
 #--- FTP/HTTP mirror used as fallback (full path)

HLFS/config

@@ -10,13 +10,13 @@ declare -r FTP=ftp://ftp.linuxfromscratch.org/pub/lfs/conglomeration
 #--- Which library model to use uclibc/glibc
 MODEL=glibc
 
-#--- The host system has grsecurity options enabled 0(no)/1(yes)
+#--- The host system has grsecurity options enabled? 0(no)/1(yes)
 GRSECURITY_HOST=0
 
 #--- Location of fstab file (if empty, a template is created)
 FSTAB=
 
-#--- Fully qualified path to a kernel config file 
+#--- Fully qualified path to a kernel config file
 # If no config file is  specified the kernel is NOT compiled
 CONFIG=
 
@@ -27,7 +27,7 @@ BOOK=
 #==== INTERNAL VARIABLES ====
 # Don't edit it unless you know what you are doing
 
-#--- Files that will be copied to $JHAHLFSDIR
+#--- Extra files that need be copied to $JHALFSDIR
 FILES="patcheslist.xsl"
 
 #--- Default stylesheet
@@ -35,6 +35,8 @@ XSL=hlfs.xsl
 
 #--- Book version
 LFSVRS=development
+
+#--- Name of the makefile
 MKFILE=$JHALFSDIR/Makefile
 
 #--- FTP/HTTP mirror used as fallback (full path)

LFS/config

@@ -10,7 +10,8 @@ declare -r FTP=ftp://ftp.linuxfromscratch.org/pub/lfs/conglomeration
 #--- Location of fstab file (if empty, a template is created)
 FSTAB=
 
-#--- Location of kernel config file (if the kernel is to be compiled)
+#--- Fully qualified path to a kernel config file
+# If no config file is  specified the kernel is NOT compiled
 CONFIG=
 
 #--- Book's sources directory
@@ -20,7 +21,7 @@ BOOK=
 #==== INTERNAL VARIABLES ====
 # Don't edit it unless you know what you are doing
 
-#--- Files that will be copied to $JHALFSDIR
+#--- Extra files that need be copied to $JHALFSDIR
 FILES=""
 
 #--- Default stylesheet

common/config

@@ -13,20 +13,26 @@ declare -r HTTP=http://ftp.lfs-matrix.net/pub/lfs/conglomeration
 BUILDDIR=/mnt/SourceFiles
 
 #--- The local repository for packages/file
-#    Any downloaded files will be archived here
+#    Any missing file will be downloaded and archived here,
+#    if the user has the right priviledges.
 SRC_ARCHIVE=
 
 #--- Download the source packages 0(no)/1(yes)
 HPKG=0
 
 #--- Run the makefile at the end  0(no)/1(yes)
+#    In BLFS the Makefile can't be run automatically
 RUNMAKE=0
 
 #--- Run test suites  [0-3]
 #  0 = none
 #  1 = only chapter06 Glibc, GCC and Binutils testsuites
+#      (in BLFS, run the package testsuite, if any)
 #  2 = all chapter06 testsuites
+#      (in BLFS, alias to 1)
 #  3 = all chapter05 and chapter06 testsuites
+#      (in BLFS, alias to 1)
+#      (in CLFS, alias to 2)
 TEST=1
 
 #--- Run the stripping phases  0(no)/1(yes)
@@ -41,16 +47,17 @@ TIMEZONE=America/Toronto
 #--- install the optional vim-lang package  0(no)/1(yes)
 VIMLANG=1
 
-#--- Language information, /etc/profile  see <locale -a> for values
+#--- Language information in /etc/profile  See <locale -a> for values
-LC_ALL=$LC_ALL
 LANG=$LANG
+LC_ALL=$LC_ALL (not used in LFS)
 
 #--- Include the keymap in the kernel if defined. Path to the
 #    keymap file relative to /usr/share/kbd/keymaps/
 #    (e.g., i386/qwerty/us.map.gz) or "none"
+#    Not used in LFS
 KEYMAP=none
 
-#=== Variables needed by ICA ===
+#=== Variables needed by ICA (Not implemented yet :-/)===
 #--- Run ICA testing 0/1  0(no)/1(yes)
 RUN_ICA=0