From: Scott Rifenbark <srifenbark@gmail.com>
Date: Thu, 5 Oct 2017 14:13:55 +0000 (-0700)
Subject: kernel-dev: Added KMACHINE and MACHINE descriptions for using metadata
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=6ca1a37dfb671681755d94ab4924c322931efec1;p=thirdparty%2Fopenembedded%2Fopenembedded-core-contrib.git

kernel-dev: Added KMACHINE and MACHINE descriptions for using metadata

Needed to remove an old example that was showing how two BSPs could
share the same KMACHINE value.  I replaced it with corei7-based
machines.  Also noted that KMACHINE is for kernel mapping only
whereas MACHINE is for the layer's BSP machine type.

(From yocto-docs rev: c1dad2815b6fd1ed78e0dce0fecb422f342eaf14)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
---

diff --git a/documentation/kernel-dev/kernel-dev-advanced.xml b/documentation/kernel-dev/kernel-dev-advanced.xml
index 3f652d8bbdb..b5fea1c6dd5 100644
--- a/documentation/kernel-dev/kernel-dev-advanced.xml
+++ b/documentation/kernel-dev/kernel-dev-advanced.xml
@@ -74,12 +74,16 @@
     <para>
         Multiple BSPs can reuse the same <filename>KMACHINE</filename>
         name if they are built using the same BSP description.
-        The "ep108-zynqmp" and "qemuzynqmp" BSP combination
-        in the <filename>meta-xilinx</filename>
-        layer is a good example of two BSPs using the same
-        <filename>KMACHINE</filename> value (i.e. "zynqmp").
-        See the <link linkend='bsp-descriptions'>BSP Descriptions</link> section
-        for more information.
+        Multiple Corei7-based BSPs could share the same "intel-corei7-64"
+        value for <filename>KMACHINE</filename>.
+        It is important to realize that <filename>KMACHINE</filename> is
+        just for kernel mapping, while
+        <ulink url='&YOCTO_DOCS_REF_URL;#var-MACHINE'><filename>MACHINE</filename></ulink>
+        is the machine type within a BSP Layer.
+        Even with this distinction, however, these two variables can hold
+        the same value.
+        See the <link linkend='bsp-descriptions'>BSP Descriptions</link>
+        section for more information.
     </para>
 
     <para>