ref-manual: Updated the SOURCE_MIRROR_FETCH variable description.

Did a significant re-write on this description as I had the
meaning pretty far off.

(From yocto-docs rev: 6bcc63ac83f0aeb3d3d06db33c7a8f010c737312)

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

diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index ca926db1b2bffcb509a1ef537b99a17f6a7a430a..55bbc2bcd4804acc33f8ddf01298f36768ec465e 100644 (file)
--- 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>