[oe-commits] Richard Purdie : local.conf.sample: Cleanup and improve

[git version control]

Module: openembedded-core.git
Branch: master
Commit: a0ccb33ac5a2231c979c3369159f763dff1e0a2e
URL:    http://git.openembedded.org/?p=openembedded-core.git&a=commit;h=a0ccb33ac5a2231c979c3369159f763dff1e0a2e

Author: Richard Purdie <richard.purdie at linuxfoundation.org>
Date:   Fri Aug 12 13:44:43 2011 +0100

local.conf.sample: Cleanup and improve

local.conf is the first thing anyone new to the project sees. Over time it
has built up a ton cruft and isn't even accurate in places.

This patch:

* Moves things to local.conf.sample.extended if a new user is unlikely
  to need to immediately care about the options
* Reorders the file to be more intuitive to a new user
* Moves certain default values to default-distrovars.inc in cases where
  most users wouldn't want to change the value
* Adds large blocks of text to explain what an option does. There have
  been too many cases of a user not realising what some of these
  settings do and how they can use them to their advantage (like DL_DIR
  for example).

Signed-off-by: Richard Purdie <richard.purdie at linuxfoundation.org>

---

 meta/conf/distro/include/default-distrovars.inc |    6 +
 meta/conf/local.conf.sample                     |  328 ++++++++++++-----------
 meta/conf/local.conf.sample.extended            |  116 ++++++++
 3 files changed, 289 insertions(+), 161 deletions(-)

Diff:   http://git.openembedded.org/?p=openembedded-core.git/?a=commitdiff;h=a0ccb33ac5a2231c979c3369159f763dff1e0a2e