diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index d8e0d2b666..030c422c57 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -4833,10 +4833,10 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
         <glossentry id='var-PARALLEL_MAKE'><glossterm>PARALLEL_MAKE</glossterm>
             <glossdef>
                 <para>
-                    Extra options that are passed to the
-                    <filename>make</filename> command during the
-                    <filename>do_compile</filename> task in order to specify
-                    parallel compilation.
+                    Extra options passed to the <filename>make</filename>
+                    command during the <filename>do_compile</filename> task
+                    in order to specify parallel compilation on the local
+                    build host.
                     This variable is usually in the form
                     <filename>-j 4</filename>, where the number
                     represents the maximum number of parallel threads make can
@@ -4844,7 +4844,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
                 </para>
 
                 <para>
-                    If you development host supports multiple cores a good
+                    If your development host supports multiple cores, a good
                     rule of thumb is to set this variable to twice the number
                     of cores on the host.
                     If you do not set <filename>PARALLEL_MAKE</filename>, it