[gnome-continuous-yocto/gnomeostree-3.28-rocko: 7/8267] ref-manual: Applied 2.1 Migration section review edits.

[Emmanuele Bassi <ebassi src gnome org>]

commit d4c4b2f7b80cf8d99a68b9a6245e54e0931c3efa
Author: Scott Rifenbark <srifenbark gmail com>
Date:   Tue Apr 19 09:51:28 2016 -0700

    ref-manual: Applied 2.1 Migration section review edits.
    
    (From yocto-docs rev: d641e8404d13aa96f23c537045d1ce165a0fe119)
    
    Signed-off-by: Scott Rifenbark <srifenbark gmail com>
    Signed-off-by: Richard Purdie <richard purdie linuxfoundation org>

 documentation/ref-manual/migration.xml |   16 ++++++++++++++++
 1 files changed, 16 insertions(+), 0 deletions(-)
---
diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index beb76e8..f3159fa 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -3058,6 +3058,10 @@
             <ulink url='&YOCTO_DOCS_SDK_URL;#sdk-extensible'>extensible SDK</ulink>.
             For information on these SDKs and how to build and use them, see the
             <ulink url='&YOCTO_DOCS_SDK_URL;#sdk-intro'>Yocto Project Software Development Kit (SDK) 
Developer's Guide</ulink>.
+            <note>
+                The Yocto Project Eclipse IDE Plug-in is still supported and
+                is not affected by this change.
+            </note>
         </para>
     </section>
 
@@ -3278,6 +3282,18 @@
                     <filename>uvesafb</filename>, you can
                     simply add <filename>v86d</filename> to your image.
                     </para></listitem>
+                <listitem><para>
+                     Build sysroot paths are now removed from debug symbol
+                     files.
+                     Removing these paths means that remote GDB using an
+                     unstripped build system sysroot will no longer work
+                     (although this was never documented to work).
+                     The supported method to accomplish something similar is
+                     to set <filename>IMAGE_GEN_DEBUGFS</filename> to "1",
+                     which will generate a companion debug image
+                     containing unstripped binaries and associated debug
+                     sources alongside the image.
+                     </para></listitem>
             </itemizedlist>
         </para>
     </section>