local.conf.sample: update it a bit

1 files changed, 12 insertions, 9 deletions

diff --git a/conf/local.conf.sample b/conf/local.conf.sample
index 52bd88a4e9..df00fbae37 100644
--- a/conf/local.conf.sample
+++ b/conf/local.conf.sample
@@ -55,8 +55,9 @@ PREFERRED_PROVIDERS += " virtual/${TARGET_PREFIX}g++:gcc-cross"
 # TMPDIR = /usr/local/projects/oetmp
 
 # Uncomment this to specify a machine to build for. See the conf directory
-# for machines currently known to OpenEmbedded.
-# MACHINE = "collie"
+# for machines currently known to OpenEmbedded. This will automatically take care
+# of TARGET_ARCH
+# MACHINE = "c7x0"
 
 # Use this to specify the target architecture. Note that this is only
 # needed when building for a machine not known to OpenEmbedded. Better use
@@ -66,25 +67,26 @@ PREFERRED_PROVIDERS += " virtual/${TARGET_PREFIX}g++:gcc-cross"
 # Use this to specify the target operating system.  The default is "linux",
 # for a normal linux system with glibc. Set this to "linux-uclibc" if you want
 # to build a uclibc based system.
+# Normally the DISTRO of your choosing will take care of this 
 # TARGET_OS = "linux"
 # TARGET_OS = "linux-uclibc"
 
 # Uncomment this to select a distribution policy. See the conf directory
 # for distributions currently known to OpenEmbedded.
-# Although they no longer contain version number in the (file-)name
-# familiar-unstable and openzaurus-unstable are so called "versioned"
-# distros, i.e. they explicitely select specific versions of various
-# packages.
+# Although it no longer contain version number in the (file-)name
+# openzaurus-unstable is a so called "versioned"  distro, i.e. they 
+# explicitely select specific versions of various packages.
 # Stay away from unversioned distros unless you really know what you are doing
 # DISTRO = "generic"
 
-# So far, angstrom.conf and familiar.conf set ENABLE_BINARY_LOCALE_GENERATION
+# So far, angstrom.conf sets ENABLE_BINARY_LOCALE_GENERATION
 # to generate binary locale packages at build time using qemu-native and
 # thereby guarantee i18n support on all devices. If your build breaks on 
 # qemu-native consider disabling ENABLE_BINARY_LOCALE_GENERATION (note that
 # this breaks i18n on devices with less than 128MB RAM) or installing
 # a working third-party qemu (e.g. provided by your distribution) and
-# adding qemu-native to ASSUME_PROVIDED
+# adding qemu-native to ASSUME_PROVIDED. Caveat emptor, since third-party
+# qemus lack patches needed to work with various OE targets.
 # ENABLE_BINARY_LOCALE_GENERATION = "0"
 # ASSUME_PROVIDED += "qemu-native"
 
@@ -108,7 +110,8 @@ IMAGE_FSTYPES = "jffs2 tar"
 # BBDEBUG = "yes"
 
 # Uncomment these two if you want BitBake to build images useful for debugging. 
-# Note that INHIBIT_PACKAGE_STRIP needs a package format to be defined
+# Note that INHIBIT_PACKAGE_STRIP needs a package format to be defined.
+# Also note that OE now produces -dbg packages which contain debugging symbols.
 # DEBUG_BUILD = "1"
 # INHIBIT_PACKAGE_STRIP = "1"