ref-manual: Review comments from Paul Eggleton into the Migration section.

Minor adjustments such as creating alphabetized lists,
fixing a typo, eliminating a repeat, separating out the
recipes that were moved into a new section, etc.

(From yocto-docs rev: 34f73b62b4acdc6136b22916811cd9156b6422f5)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>

1 files changed, 86 insertions, 88 deletions

diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index 7ebc10a76d..83636a375b 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -361,97 +361,89 @@
         </para>
     </section>
 
-    <section id='migration-1.4-removals-and-renames'>
-        <title>Removals and Renames</title>
+    <section id='migration-1.4-recipes-moved'>
+        <title>Recipes Moved</title>
 
         <para>
-            The following list shows what has been removed or renamed:
+            The following recipes were moved from their previous locations 
+            because they are no longer used by anything in  
+            the OpenEmbedded-Core:
             <itemizedlist>
-                <listitem><para><emphasis><filename>mesa-dri</filename>:</emphasis>
-                    Renamed to <filename>mesa</filename>.
-                    </para></listitem>
-                <listitem><para><emphasis><filename>Gtk+ DirectFB</filename>:</emphasis>
-                    Removed support because upstream Gtk+ no longer supports it
-                    as of version 2.18.
-                    </para></listitem>
-                <listitem><para><emphasis><filename>linux-yocto 3.0 kernel</filename>:</emphasis>
-                    Removed with linux-yocto 3.8 kernel being added.
+                <listitem><para><emphasis><filename>clutter-box2d</filename>:</emphasis>
+                    Now resides in the <filename>meta-oe</filename> layer.
                     </para></listitem>
-                <listitem><para><emphasis><filename>mesa-xlib</filename>:</emphasis>
-                    Removed because it was no longer useful.
+                <listitem><para><emphasis><filename>evolution-data-server</filename>:</emphasis>
+                    Now resides in the <filename>meta-gnome</filename> layer.
                     </para></listitem>
-                <listitem><para><emphasis><filename>polkit</filename>:</emphasis>
-                    Removed from its previous location and now resides in the 
-                    <filename>meta-oe</filename> layer.
+                <listitem><para><emphasis><filename>gthumb</filename>:</emphasis>
+                    Now resides in the <filename>meta-gnome</filename> layer.
                     </para></listitem>
-                <listitem><para><emphasis><filename>libmusicbrainz</filename>:</emphasis>
-                    Removed from its previous location and now resides in the 
-                    <filename>meta-multimedia</filename> layer.
+                <listitem><para><emphasis><filename>gtkhtml2</filename>:</emphasis>
+                    Now resides in the <filename>meta-oe</filename> layer.
                     </para></listitem>
-                <listitem><para><emphasis><filename>zeroconf</filename>:</emphasis>
-                    Removed from its previous location and now resides in the 
-                    <filename>meta-networking</filename> layer.
+                <listitem><para><emphasis><filename>gupnp</filename>:</emphasis>
+                    Now resides in the <filename>meta-multimedia</filename> layer.
                     </para></listitem>
-                <listitem><para><emphasis><filename>web</filename>:</emphasis>
-                    Removed because it is not maintained.  Superseded by 
-                    <filename>web-webkit</filename>.
+                <listitem><para><emphasis><filename>gypsy</filename>:</emphasis>
+                    Now resides in the <filename>meta-oe</filename> layer.
                     </para></listitem>
-                <listitem><para><emphasis><filename>gtkhtml2</filename>:</emphasis>
-                    Removed from its previous location and now resides in the 
-                    <filename>meta-oe</filename> layer.
+                <listitem><para><emphasis><filename>libcanberra</filename>:</emphasis>
+                    Now resides in the <filename>meta-gnome</filename> layer.
                     </para></listitem>
-                <listitem><para><emphasis><filename>gtkhtml2</filename>:</emphasis>
-                    Removed from its previous location and now resides in the 
-                    <filename>meta-oe</filename> layer.
+                <listitem><para><emphasis><filename>libgdata</filename>:</emphasis>
+                    Now resides in the <filename>meta-gnome</filename> layer.
                     </para></listitem>
-                <listitem><para><emphasis><filename>clutter-box2d</filename>:</emphasis>
-                    Removed from its previous location and now resides in the 
-                    <filename>meta-oe</filename> layer.
+                <listitem><para><emphasis><filename>libmusicbrainz</filename>:</emphasis>
+                    Now resides in the <filename>meta-multimedia</filename> layer.
                     </para></listitem>
-                <listitem><para><emphasis><filename>orinoco-conf</filename>:</emphasis>
-                    Removed because it has become obsolete.
+                <listitem><para><emphasis><filename>metacity</filename>:</emphasis>
+                    Now resides in the <filename>meta-gnome</filename> layer.
                     </para></listitem>
-                <listitem><para><emphasis><filename>omatchbox-stroke</filename>:</emphasis>
-                    Removed because it was never more than a proof-of-concept.
+                <listitem><para><emphasis><filename>polkit</filename>:</emphasis>
+                    Now resides in the <filename>meta-oe</filename> layer.
                     </para></listitem>
-                <listitem><para><emphasis><filename>update-modules</filename>:</emphasis>
-                    Removed because it is no longer used.
-                    The kernel module <filename>postinstall</filename> and 
-                    <filename>postrm</filename> scripts can now do the same 
-                    task without the use of this script.
+                <listitem><para><emphasis><filename>zeroconf</filename>:</emphasis>
+                    Now resides in the <filename>meta-networking</filename> layer.
                     </para></listitem>
-                <listitem><para><emphasis><filename>zypper / libzypp / sat-solver</filename>:</emphasis>
-                    Removed and been functionally replaced with Smart 
-                    (<filename>python-smartpm</filename>) when RPM packaging 
-                    is used and package management is enabled on the target.
+            </itemizedlist>
+        </para>
+    </section>
+
+    <section id='migration-1.4-removals-and-renames'>
+        <title>Removals and Renames</title>
+
+        <para>
+            The following list shows what has been removed or renamed:
+            <itemizedlist>
+                <listitem><para><emphasis><filename>evieext</filename>:</emphasis>
+                    Removed because it has been removed from 
+                    <filename>xserver</filename> since 2008.
                     </para></listitem>
-                <listitem><para><emphasis><filename>libcanberra</filename>:</emphasis>
-                    Removed from its previous location and now resides in the 
-                    <filename>meta-gnome</filename> layer.
+                <listitem><para><emphasis>Gtk+ DirectFB:</emphasis>
+                    Removed support because upstream Gtk+ no longer supports it
+                    as of version 2.18.
                     </para></listitem>
-                <listitem><para><emphasis><filename>metacity</filename>:</emphasis>
-                    Removed from its previous location and now resides in the 
-                    <filename>meta-gnome</filename> layer.
+                <listitem><para><emphasis><filename>libxfontcache / xfontcacheproto</filename>:</emphasis>
+                    Removed because they were removed from the Xorg server in 2008.
                     </para></listitem>
-                <listitem><para><emphasis><filename>gupnp</filename>:</emphasis>
-                    Removed from its previous location and now resides in the 
-                    <filename>meta-multimedia</filename> layer.
+                <listitem><para><emphasis><filename>libxp / libxprintapputil / libxprintutil / printproto</filename>:</emphasis>
+                    Removed because the XPrint server was removed from 
+                    Xorg in 2008.
                     </para></listitem>
-                <listitem><para><emphasis><filename>libgdata</filename>:</emphasis>
-                    Removed from its previous location and now resides in the 
-                    <filename>meta-gnome</filename> layer.
+                <listitem><para><emphasis><filename>libxtrap / xtrapproto</filename>:</emphasis>
+                    Removed because their functionality was broken upstream.
                     </para></listitem>
-                <listitem><para><emphasis><filename>gthumb</filename>:</emphasis>
-                    Removed from its previous location and now resides in the 
-                    <filename>meta-gnome</filename> layer.
+                <listitem><para><emphasis>linux-yocto 3.0 kernel:</emphasis>
+                    Removed with linux-yocto 3.8 kernel being added.
+                    The linux-yocto 3.2 and linux-yocto 3.4 kernels remain
+                    as part of the release.
                     </para></listitem>
-                <listitem><para><emphasis><filename>mutter</filename>:</emphasis>
-                    Removed because nothing ever uses it and the recipe is 
-                    very old.
+                <listitem><para><emphasis><filename>lsbsetup</filename>:</emphasis>
+                    Removed with functionality now provided by 
+                    <filename>lsbtest</filename>.
                     </para></listitem>
-                <listitem><para><emphasis><filename>gypsy</filename>:</emphasis>
-                    Removed from its previous location and now resides in the 
-                    <filename>meta-oe</filename> layer.
+                <listitem><para><emphasis><filename>matchbox-stroke</filename>:</emphasis>
+                    Removed because it was never more than a proof-of-concept.
                     </para></listitem>
                 <listitem><para><emphasis><filename>matchbox-wm-2 / matchbox-theme-sato-2</filename>:</emphasis>
                     Removed because they are not maintained.
@@ -459,37 +451,43 @@
                     <filename>matchbox-theme-sato</filename> are still 
                     provided.
                     </para></listitem>
-                <listitem><para><emphasis><filename>lsbsetup</filename>:</emphasis>
-                    Removed with functionality now provided by 
-                    <filename>lsbtest</filename>.
+                <listitem><para><emphasis><filename>mesa-dri</filename>:</emphasis>
+                    Renamed to <filename>mesa</filename>.
                     </para></listitem>
-                <listitem><para><emphasis><filename>evolution-data-server</filename>:</emphasis>
-                    Removed from its previous location and now resides in the 
-                    <filename>meta-gnome</filename> layer.
+                <listitem><para><emphasis><filename>mesa-xlib</filename>:</emphasis>
+                    Removed because it was no longer useful.
+                    </para></listitem>
+                <listitem><para><emphasis><filename>mutter</filename>:</emphasis>
+                    Removed because nothing ever uses it and the recipe is 
+                    very old.
+                    </para></listitem>
+                <listitem><para><emphasis><filename>orinoco-conf</filename>:</emphasis>
+                    Removed because it has become obsolete.
+                    </para></listitem>
+                <listitem><para><emphasis><filename>update-modules</filename>:</emphasis>
+                    Removed because it is no longer used.
+                    The kernel module <filename>postinstall</filename> and 
+                    <filename>postrm</filename> scripts can now do the same 
+                    task without the use of this script.
+                    </para></listitem>
+                <listitem><para><emphasis><filename>web</filename>:</emphasis>
+                    Removed because it is not maintained.  Superseded by 
+                    <filename>web-webkit</filename>.
                     </para></listitem>
                 <listitem><para><emphasis><filename>xf86bigfontproto</filename>:</emphasis>
                     Removed because upstream it has been disabled by default 
                     since 2007.
                     Nothing uses <filename>xf86bigfontproto</filename>.
                     </para></listitem>
-                <listitem><para><emphasis><filename>evieext</filename>:</emphasis>
-                    Removed because it has been removed from 
-                    <filename>xserver</filename> since 2008.
-                    </para></listitem>
                 <listitem><para><emphasis><filename>xf86rushproto</filename>:</emphasis>
                     Removed because its dependency in 
                     <filename>xserver</filename> was spurious and it was
                     removed in 2005.
                     </para></listitem>
-                <listitem><para><emphasis><filename>libxfontcache / xfontcacheproto</filename>:</emphasis>
-                    Removed because they were removed from the Xorg server in 2008.
-                    </para></listitem>
-                <listitem><para><emphasis><filename>libxp / libxprintapputil / libxprintutil / printproto</filename>:</emphasis>
-                    Removed because the XPrint server was removed from 
-                    Xorg in 2008.
-                    </para></listitem>
-                <listitem><para><emphasis><filename>libxtrap / xtrapproto</filename>:</emphasis>
-                    Removed because their functionality was broken upstream.
+                <listitem><para><emphasis><filename>zypper / libzypp / sat-solver</filename>:</emphasis>
+                    Removed and been functionally replaced with Smart 
+                    (<filename>python-smartpm</filename>) when RPM packaging 
+                    is used and package management is enabled on the target.
                     </para></listitem>
             </itemizedlist>
         </para>