[gnome-continuous-yocto/gnomeostree-3.28-rocko: 7946/8267] kernel-dev: Added KMACHINE and MACHINE descriptions for using metadata

[Emmanuele Bassi <ebassi src gnome org>]

commit 6ca1a37dfb671681755d94ab4924c322931efec1
Author: Scott Rifenbark <srifenbark gmail com>
Date:   Thu Oct 5 07:13:55 2017 -0700

    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>

 documentation/kernel-dev/kernel-dev-advanced.xml |   16 ++++++++++------
 1 files changed, 10 insertions(+), 6 deletions(-)
---
diff --git a/documentation/kernel-dev/kernel-dev-advanced.xml 
b/documentation/kernel-dev/kernel-dev-advanced.xml
index 3f652d8..b5fea1c 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>