1 files changed, 43 insertions, 47 deletions

diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index b0e8eae1e0..dcfcb168c3 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -4742,7 +4742,7 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
             (in seconds) and BitBake's server stays resident for that
             amount of time between invocations.
             The <filename>oe-init-build-env-memres</filename> script has been
-            removed which means a separate environment setup script is no longer
+            removed since a separate environment setup script is no longer
             needed.
         </para>
     </section>
@@ -4759,7 +4759,7 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
                     <itemizedlist>
                         <listitem><para>
                             The main "python3" package now brings in all of the
-                            standard Python 3 distributions rather than a subset.
+                            standard Python 3 distribution rather than a subset.
                             This behavior matches what is expected based on
                             traditional Linux distributions.
                             If you wish to install a subset of Python 3, specify
@@ -4779,7 +4779,7 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
                     </para></listitem>
                 <listitem><para>
                     <emphasis><filename>binutils</filename>:</emphasis>
-                    The <filename>libbfd</filename> package is now packaged in
+                    The <filename>libbfd</filename> library is now packaged in
                     a separate "libbfd" package.
                     This packaging saves space when certain tools
                     (e.g. <filename>perf</filename>) are installed.
@@ -4791,7 +4791,7 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
                     <emphasis><filename>util-linux</filename> Changes:</emphasis>
                     <itemizedlist>
                         <listitem><para>
-                            The <filename>su</filename> package is now packaged
+                            The <filename>su</filename> program is now packaged
                             in a separate "util-linux-su" package, which is only
                             built when "pam" is listed in the
                             <link linkend='var-DISTRO_FEATURES'><filename>DISTRO_FEATURES</filename></link>
@@ -4803,12 +4803,12 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
                             The main <filename>util-linux</filename> package has
                             runtime dependencies (i.e.
                             <link linkend='var-RDEPENDS'><filename>RDEPENDS</filename></link>)
-                            on the <filename>util-linux</filename> package when
-                            "pam" is in
+                            on the <filename>util-linux-su</filename> package
+                            when "pam" is in
                             <link linkend='var-DISTRO_FEATURES'><filename>DISTRO_FEATURES</filename></link>.
                             </para></listitem>
                         <listitem><para>
-                            The <filename>switch_root</filename> package is now
+                            The <filename>switch_root</filename> program is now
                             packaged in a separate "util-linux-switch-root"
                             package for small initramfs images that do not need
                             the whole <filename>util-linux</filename> package or
@@ -4817,21 +4817,21 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
                             The main <filename>util-linux</filename> package has
                             a recommended runtime dependency (i.e.
                             <link linkend='var-RRECOMMENDS'><filename>RRECOMMENDS</filename></link>)
-                            on the <filename>switch_root</filename> package.
+                            on the <filename>util-linux-switch-root</filename> package.
                             </para></listitem>
                         <listitem><para>
-                            The <filename>ionice</filename> package is now
+                            The <filename>ionice</filename> program is now
                             packaged in a separate "util-linux-ionice" package.
                             The main <filename>util-linux</filename> package has
                             a recommended runtime dependency (i.e.
                             <link linkend='var-RRECOMMENDS'><filename>RRECOMMENDS</filename></link>)
-                            on the <filename>ionice</filename> package.
+                            on the <filename>util-linux-ionice</filename> package.
                             </para></listitem>
                     </itemizedlist>
                     </para></listitem>
                 <listitem><para>
                     <emphasis><filename>initscripts</filename>:</emphasis>
-                    The <filename>sushell</filename> package is now packaged in
+                    The <filename>sushell</filename> program is now packaged in
                     a separate "initscripts-sushell" package.
                     This packaging change allows systems to pull
                     <filename>sushell</filename> in when
@@ -4859,7 +4859,7 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
                     large and is not required.
                     </para></listitem>
                 <listitem><para>
-                    <emphasis><filename>Go Standard Runtime</filename>:</emphasis>
+                    <emphasis>Go Standard Runtime:</emphasis>
                     The Go standard runtime has been split out from the main
                     <filename>go</filename> recipe into a separate
                     <filename>go-runtime</filename> recipe.
@@ -4880,18 +4880,17 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
                     </para></listitem>
                 <listitem><para>
                     <emphasis><filename>autogen-native</filename>:</emphasis>
-                    No longer required by Grub, <filename>oe-core</filename>, or
-                    <filename>meta-oe</filename>.
+                    No longer required by Grub, oe-core, or meta-oe.
                     </para></listitem>
                 <listitem><para>
                     <emphasis><filename>bdwgc</filename>:</emphasis>
                     Nothing in OpenEmbedded-Core requires this recipe.
-                    It has moved to <filename>meta-oe</filename>
+                    It has moved to meta-oe.
                     </para></listitem>
                 <listitem><para>
                     <emphasis><filename>byacc</filename>:</emphasis>
                     This recipe was only needed by rpm 5.x and has moved to
-                    <filename>meta-oe</filename>.
+                    meta-oe.
                     </para></listitem>
                 <listitem><para>
                     <emphasis><filename>gcc (5.4)</filename>:</emphasis>
@@ -4911,32 +4910,32 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
                     This recipe was only needed by
                     <filename>autogen-native</filename> and
                     <filename>remake</filename>.
-                    It is no longer needed by either of these programs.
+                    The recipe is no longer needed by either of these programs.
                     </para></listitem>
                 <listitem><para>
                     <emphasis><filename>libclass-isa-perl</filename>:</emphasis>
-                    This recipe was previously needed for LSB 4, which no longer
-                    requires the recipe.
+                    This recipe was previously needed for LSB 4, no longer
+                    needed.
                     </para></listitem>
                 <listitem><para>
                     <emphasis><filename>libdumpvalue-perl</filename>:</emphasis>
-                    This recipe was previously needed for LSB 4, which no longer
-                    requires the recipe.
+                    This recipe was previously needed for LSB 4, no longer
+                    needed.
                     </para></listitem>
                 <listitem><para>
                     <emphasis><filename>libenv-perl</filename>:</emphasis>
-                    This recipe was previously needed for LSB 4, which no longer
-                    requires the recipe.
+                    This recipe was previously needed for LSB 4, no longer
+                    needed.
                     </para></listitem>
                 <listitem><para>
                     <emphasis><filename>libfile-checktree-perl</filename>:</emphasis>
-                    This recipe was previously needed for LSB 4, which no longer
-                    requires the recipe.
+                    This recipe was previously needed for LSB 4, no longer
+                    needed.
                     </para></listitem>
                 <listitem><para>
                     <emphasis><filename>libi18n-collate-perl</filename>:</emphasis>
-                    This recipe was previously needed for LSB 4, which no longer
-                    requires the recipe.
+                    This recipe was previously needed for LSB 4, no longer
+                    needed.
                     </para></listitem>
                 <listitem><para>
                     <emphasis><filename>libiconv</filename>:</emphasis>
@@ -4955,8 +4954,8 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
                     </para></listitem>
                 <listitem><para>
                     <emphasis><filename>libpod-plainer-perl</filename>:</emphasis>
-                    This recipe was previously needed for LSB 4, which no longer
-                    requires the recipe.
+                    This recipe was previously needed for LSB 4, no longer
+                    needed.
                     </para></listitem>
                 <listitem><para>
                     <emphasis><filename>linux-yocto (4.1)</filename>:</emphasis>
@@ -4969,11 +4968,13 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
                     </para></listitem>
                 <listitem><para>
                     <emphasis><filename>mesa (git version only)</filename>:</emphasis>
-                    This recipe is stale with respect to the release version.
+                    The git version recipe was stale with respect to the release
+                    version.
                     </para></listitem>
                 <listitem><para>
                     <emphasis><filename>ofono (git version only)</filename>:</emphasis>
-                    This recipe is stale with respect to the release version.
+                    The git version recipe was stale with respect to the release
+                    version.
                     </para></listitem>
                 <listitem><para>
                     <emphasis><filename>portmap</filename>:</emphasis>
@@ -5041,7 +5042,7 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
         <title>Kernel Device Tree Move</title>
 
         <para>
-            Kernel Device Tree support is easy to enable in a kernel
+            Kernel Device Tree support is now easier to enable in a kernel
             recipe.
             The Device Tree code has moved to a
             <filename>kernel-devicetree</filename> class.
@@ -5074,11 +5075,6 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
                 <listitem><para>
                     The "unsafe-references-in-scripts" QA check has been
                     removed.
-                    Previously, this check ensured
-                    that the backslash character (i.e.
-                    <filename>/</filename>) and <filename>/usr</filename>
-                    could be on different filesystems and that
-                    <filename>/usr</filename> is no longer actively supported.
                     </para></listitem>
                 <listitem><para>
                     If you refer to <filename>${COREBASE}/LICENSE</filename>
@@ -5164,7 +5160,6 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
                     one commit per subdirectory in the repository in order to
                     make it easier to see the changes for a particular
                     subdirectory.
-                    Now Git can filter these changes itself when viewed.
                     To view a particular change, specify that subdirectory as
                     the last parameter on the <filename>git show</filename>
                     or <filename>git diff</filename> commands.
@@ -5179,8 +5174,7 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
                     </para></listitem>
                 <listitem><para>
                     BitBake fires multiple "BuildStarted" events when
-                    <filename>multiconfig</filename> is enabled.
-                    This is limited to one per configuration.
+                    multiconfig is enabled (one per configuration).
                     For more information, see the
                     "<ulink url='&YOCTO_DOCS_BB_URL;#events'>Events</ulink>"
                     in the BitBake User Manual.
@@ -5222,19 +5216,21 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
                     However, the default is still 1.0.x through the
                     <link linkend='var-PREFERRED_VERSION'><filename>PREFERRED_VERSION</filename></link>
                     variable.
-                    This change is due to the remaining compatibility issues
-                    with other software.
+                    This preference is set is due to the remaining compatibility
+                    issues with other software.
                     The
                     <link linkend='var-PROVIDES'><filename>PROVIDES</filename></link>
-                    variable includes "openssl10" as a marker for recipes that
-                    still depend on OpenSSL 1.0.
+                    variable  in the openssl 1.0 recipe now includes "openssl10"
+                    as a marker that can be used in
+                    <link linkend='var-DEPENDS'><filename>DEPENDS</filename></link>
+                    within recipes that build software that still depend on
+                    OpenSSL 1.0.
                     </para></listitem>
                 <listitem><para>
                     To ensure consistent behavior, BitBake's "-r" and "-R"
                     options (i.e. prefile and postfile), which are used to
-                    <filename>read</filename> or <filename>post-read</filename>
-                    additional configuration files from the command line, now
-                    only affect the current BitBake command.
+                    read or post-read additional configuration files from the
+                    command line, now only affect the current BitBake command.
                     Before this change these options would "stick" for
                     future executions.
                     <note>