summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorCliff Brake <cbrake@bec-systems.com>2010-09-13 14:15:35 -0400
committerCliff Brake <cbrake@bec-systems.com>2010-09-13 14:15:35 -0400
commit4ee358534793381d2e87b01781079a3354fd5c1c (patch)
tree729f8b0ce4bdbcd8a16f561fb68da0d66c3a3eb8 /docs
parentbeb17e26ee9b4bc0cf334c3b30560c6eb66b1299 (diff)
parenteda06ec3dde6169a46797f876a82499c4fff8f62 (diff)
downloadopenembedded-testing_2010-09-13.tar.gz
Merge branch 'org.openembedded.dev' into testing-nexttesting_2010-09-13
Diffstat (limited to 'docs')
-rw-r--r--docs/usermanual/chapters/common_use_cases.xml24
1 files changed, 24 insertions, 0 deletions
diff --git a/docs/usermanual/chapters/common_use_cases.xml b/docs/usermanual/chapters/common_use_cases.xml
index d86d0ca8d1..ef81b95fa9 100644
--- a/docs/usermanual/chapters/common_use_cases.xml
+++ b/docs/usermanual/chapters/common_use_cases.xml
@@ -94,6 +94,30 @@ SRCDATE = "20061014"
</listitem>
</itemizedlist></para>
+ <para>There are also some optional variables that can be defined:
+ <itemizedlist>
+ <listitem>
+ <para><command>SOC_FAMILY</command> describes a family of processors
+ that all share common features such as kernel versions,
+ bootloaders, etc. This is used to allow overrides for a whole
+ set of devices rather than per machine overrides being used.
+ The use of SOC_FAMILY as an override is currently a distribution
+ or local setting.
+ </para>
+ <para>
+ NOTE: SOC_FAMILY is different than MACHINE_CLASS in that
+ MACHINE_CLASS is intended to specify a grouping of devices
+ that may have different processors but share common features.
+ For example all OMAP3 devices can be described using the SOC_FAMILY
+ "omap3" and this value can be used in overrides to prevent
+ requiring multiple machine specific overrides. MACHINE_CLASS
+ might be used to describe a class of devices such as a cell
+ phone in which the processor may be different but the
+ features such as touchscreen, GPS, modem, etc are the same.
+ </para>
+ </listitem>
+ </itemizedlist></para>
+
<para>Next the kernel recipe needs to be added if it doesn't already exist.
</para>
</section>