1 files changed, 14 insertions, 14 deletions

diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index ca926db1b2..55bbc2bcd4 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -9597,26 +9597,26 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
             </info>
             <glossdef>
                 <para>
-                    When you are creating a source mirror, setting
+                    When you are fetching files to create a mirror of sources
+                    (i.e. creating a source mirror), setting
                     <filename>SOURCE_MIRROR_FETCH</filename> to "1" in your
                     <filename>local.conf</filename> configuration file ensures
                     the source for all recipes are fetched regardless of
-                    whether or not source is marked for exclusion.
-                    <note>
-                        When source files are incompatible with the currently
-                        configured
-                        <link linkend='var-MACHINE'><filename>MACHINE</filename></link>
-                        via the
-                        <link linkend='var-COMPATIBLE_MACHINE'><filename>COMPATIBLE_MACHINE</filename></link>
-                        variable and via the
-                        <link linkend='var-COMPATIBLE_HOST'><filename>COMPATIBLE_HOST</filename></link>
-                        variable, they are marked for exclusion.
-                    </note>
-
+                    whether or not a recipe is compatible with the
+                    configuration.
+                    A recipe is considered incompatible with the currently
+                    configured machine when either or both the
+                    <link linkend='var-COMPATIBLE_MACHINE'><filename>COMPATIBLE_MACHINE</filename></link>
+                    variable and
+                    <link linkend='var-COMPATIBLE_HOST'><filename>COMPATIBLE_HOST</filename></link>
+                    variables specify compatibility with a machine other
+                    than that of the current machine or host.
                     <note><title>Warning</title>
                         Do not set the
                         <filename>SOURCE_MIRROR_FETCH</filename> variable
-                        during a normal build.
+                        unless you are creating a source mirror.
+                        In other words, do not set the variable during a
+                        normal build.
                     </note>
                 </para>
             </glossdef>