1 files changed, 16 insertions, 12 deletions

diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index 1b3b9d99dc..9915c3ce02 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -595,16 +595,15 @@
         <para>
             The OpenEmbedded build system now has some additional requirements
             on the host system:
-            <literallayout class='monospaced'>
-     Python 2.7.3+
-
-     tar 1.24+
-
-     git 1.7.5+
-
-     Patched version of make if you are using make version 3.82.  Most
-        distributions that provide make 3.82 have now done this.
-            </literallayout>
+            <itemizedlist>
+                <listitem><para>Python 2.7.3+</para></listitem>
+                <listitem><para>Tar 1.24+</para></listitem>
+                <listitem><para>Git 1.7.5+</para></listitem>
+                <listitem><para>Patched version of Make if you are using 
+                    3.82.
+                    Most distributions that provide Make 3.82 use the patched
+                    version.</para></listitem>
+            </itemizedlist>
             If the Linux distribution you are using on your build host
             does not provide packages for these, you can install and use
             the Buildtools tarball, which provides an SDK-like environment
@@ -733,7 +732,12 @@
                 <listitem><para>
                     The <filename>pkgdata</filename> directory produced as
                     part of the packaging process has been collapsed into a
-                    single machine-specific directory.</para></listitem>
+                    single machine-specific directory.
+                    These directories are located under 
+                    <filename>sysroots</filename> and use a machine-specific
+                    name (i.e. 
+                    <filename>tmp/sysroots/&lt;machine&gt;/pkgdata</filename>).
+                    </para></listitem>
             </itemizedlist>
         </para>
     </section>
@@ -778,7 +782,7 @@
                     Valid <filename>IMAGE_FEATURES</filename> are drawn from
                     <link linkend='var-PACKAGE_GROUP'><filename>PACKAGE_GROUP</filename></link>
                     definitions,
-                    <link linkend='var-COMPLEMENTARY_GLOBS'><filename>COMPLEMENTARY_GLOBS</filename></link>
+                    <link linkend='var-COMPLEMENTARY_GLOB'><filename>COMPLEMENTARY_GLOB</filename></link>
                     and a new 'validitems' varflag on
                     <filename>IMAGE_FEATURES</filename>.
                     This change allows additional features to be added if they