Some textual improvements and corrections.

optimize/opt_config

@@ -15,8 +15,11 @@ MAKEFLAGS="-j3"
 #--- Default optimization mode
 #    This mode is overridden by definitions in opt_override;
 #    in this way, packages can be tuned independently.  For example,
-#    if you have trouble building a package in mode defOpt, add
+#    if you have trouble building a package in the mode set here, add
 #    the package to opt_override with a different mode.
+#
+#    Not set here combined modes of form defOpt_myMode.
+#    Combined modes of form modeA_modeB can be set here.
 DEF_OPT_MODE=O3pipe
 
 

optimize/opt_config.d/O3pipe

@@ -9,6 +9,8 @@
 #        - "unset" will cause the variable to be not set
 #          instead of just set to null.
 #
+# Use this as an example for cunstomized modes
+#
 #####
 
 CFLAGS_O3pipe="-O3 -pipe"

optimize/opt_config.d/O3pipe_march

@@ -9,6 +9,8 @@
 #        - "unset" will cause the variable to be not set
 #          instead of just set to null.
 #
+# Use this as an example for modeA_modeB combined modes
+#
 #####
 
 # Inherit optimizations from O3pipe

optimize/opt_config.d/defOpt_fPIC

@@ -1,11 +1,19 @@
+#
+#$Id$
+#
 #####
 #
 # MODE defOpt_fPIC configuration
 #
+# WARNING: Do not edit this mode unless you know what you are
+#          doing. It's required to build Zlib.
+#
 # Usage: - Apply optimization string to each variable
 #        - "unset" will cause the variable to be not set
 #          instead of just set to null.
 #
+# Use this as an example for defOpt_myMode combined modes
+#
 #####
 
 # Inherit optimizations from DEF_OPT_MODE

optimize/opt_config.d/noSymbols

@@ -9,11 +9,11 @@
 #        - "unset" will cause the variable to be not set
 #          instead of just set to null.
 #
-#####
-#
 # NOTE: If using this mode in DEF_OPT_MODE (alone or combined with
 #       other modes) please set STRIP=0 in common/config
 #
+#####
+
 CFLAGS_noSymbols="-s"
 CXXFLAGS_noSymbols=$CFLAGS_noSymbols
 LDFLAGS_noSymbols="-s"

optimize/optimize_functions

@@ -12,14 +12,16 @@ validate_opt_settings() {          # Show optimize setting and wait user agreeme
 
   echo -e "\t\t${RED}${BOLD}WARNING:${OFF}\n"
   echo -e "${BOLD}The use of build optimizations may be dangerous.\n"
-  echo -e "You should to know what you are doing and be sure that"
-  echo -e "the optimization settings listed below are what you want.\n"
+  echo -e "You should know what you are doing and be sure that the"
+  echo -e "optimization settings listed below are what you want.\n"
   echo -e "If there are build issues or the system doesn't work as"
   echo -e "expected, please rebuild without optimizations before"
   echo -e "asking for support.${OFF}\n"
 
   echo -e "MAKEFLAGS: ${L_arrow}${BOLD}${MAKEFLAGS}${OFF}${R_arrow}"
+  [[ "$MAKEFLAGS" != "unset" ]] && \
   echo -e "DejaGNU, Gettext, and Groff will not use MAKEFLAGS\n"
+
   echo -e "DEF_OPT_MODE: ${L_arrow}${BOLD}${DEF_OPT_MODE}${OFF}${R_arrow}\n"
 
   for OPT_VAR in $ACTIVE_OPT_VARS ; do