[gnome-continuous-yocto/gnomeostree-3.28-rocko: 3627/8267] ref-manual: Added KERNEL_IMAGE_BASE_NAME change to 2.2 migration

[Emmanuele Bassi <ebassi src gnome org>]

commit 4775af4650f389e0a294e88acde04827946c0931
Author: Scott Rifenbark <srifenbark gmail com>
Date:   Mon Nov 28 15:22:45 2016 -0800

    ref-manual: Added KERNEL_IMAGE_BASE_NAME change to 2.2 migration
    
    The fact that the OpenEmbedded build system can now build
    multiple image types caused the KERNEL_IMAGE_BASE_NAME variable
    to have the KERNEL_IMAGETYPE portion removed.  This could cause
    existing recipes that use the KERNEL_IMAGE_BASE_NAME variable
    directly issues.  I added a section indicating that the user
    should address those recipes to avoid problems.
    
    (From yocto-docs rev: c433fca3840440c14bb364a51afc5c3c2bfc7c88)
    
    Signed-off-by: Scott Rifenbark <srifenbark gmail com>
    Signed-off-by: Richard Purdie <richard purdie linuxfoundation org>

 documentation/ref-manual/migration.xml |   21 +++++++++++++++++++++
 1 files changed, 21 insertions(+), 0 deletions(-)
---
diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index f9e418c..2bdb542 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -3620,6 +3620,27 @@ $ runqemu qemux86-64 tmp/deploy/images/qemux86-64/core-image-minimal-qemux86-64.
         </para>
     </section>
 
+    <section id='migration-2.2-kernel-image-base-name-no-longer-uses-kernel-imagetype'>
+        <title><filename>KERNEL_IMAGE_BASE_NAME</filename> no Longer Uses 
<filename>KERNEL_IMAGETYPE</filename></title>
+
+        <para>
+            The
+            <link linkend='var-KERNEL_IMAGE_BASE_NAME'><filename>KERNEL_IMAGE_BASE_NAME</filename></link>
+            variable no longer uses the
+            <link linkend='var-KERNEL_IMAGETYPE'><filename>KERNEL_IMAGETYPE</filename></link>
+            variable to create the image's base name.
+            Because the OpenEmbedded build system can now build multiple kernel
+            image types, this part of the kernel image base name as been
+            removed leaving only the following:
+            <literallayout class='monospaced'>
+     KERNEL_IMAGE_BASE_NAME ?= "${PKGE}-${PKGV}-${PKGR}-${MACHINE}-${DATETIME}
+            </literallayout>
+            If you have recipes or classes that use
+            <filename>KERNEL_IMAGE_BASE_NAME</filename> directly, you might
+            need to update the references to ensure they continue to work.
+        </para>
+    </section>
+
     <section id='migration-2.2-bitbake-changes'>
         <title>BitBake Changes</title>