dev-manual, ref-manual: Updated 1.7 migration section with review comments

Applied the second round of review edits from Paul Eggleton.
Minor fixes.

(From yocto-docs rev: 2c7c45c8f09b724e92e8b59fe47834226b44b4fb)

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

2 files changed, 6 insertions, 5 deletions

diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index dd8c3e00cc..f8bd852ad8 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -1759,7 +1759,7 @@
 
         <para>
             Some of the core recipes that package binary configuration scripts
-            now disable the scripts instead due to the
+            now disable the scripts due to the
             scripts previously requiring error-prone path substitution.
             Software that links against these libraries using these scripts
             should use the much more robust <filename>pkg-config</filename>
diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml
index 1b01ef61c9..496425a5a9 100644
--- a/documentation/ref-manual/ref-classes.xml
+++ b/documentation/ref-manual/ref-classes.xml
@@ -103,11 +103,11 @@
 
     <para>
         By default, the <filename>autotools</filename> class supports
-        out-of-tree builds
+        using out-of-tree builds
         (<link linkend='var-B'><filename>B</filename></link> <filename>!=</filename>
         <link linkend='var-S'><filename>S</filename></link>).
-        If your recipes do not support out-of-tree builds, you should
-        have them inherit the
+        If the software being built by a recipe does not support
+        using out-of-tree builds, you should have the recipe inherit the
         <link linkend='ref-classes-autotools-brokensep'><filename>autotools-brokensep</filename></link>
         class.
     </para>
@@ -116,7 +116,8 @@
         It's useful to have some idea of how the tasks defined by this class work
         and what they do behind the scenes.
         <itemizedlist>
-            <listitem><para><link linkend='ref-tasks-configure'><filename>do_configure</filename></link> &dash; Regenerates the
+            <listitem><para><link linkend='ref-tasks-configure'><filename>do_configure</filename></link> &dash;
+                Regenerates the
                 configure script (using <filename>autoreconf</filename>) and then launches it
                 with a standard set of arguments used during cross-compilation.
                 You can pass additional parameters to <filename>configure</filename> through the