From: Scott Rifenbark <srifenbark@gmail.com>
Date: Thu, 14 Jul 2016 19:54:34 +0000 (-0700)
Subject: ref-manual: Added review changes to BBCLASSEXTEND description
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=bdf9003cfbbd2c101d047299ee38161ab07f7be4;p=thirdparty%2Fopenembedded%2Fopenembedded-core-contrib.git

ref-manual: Added review changes to BBCLASSEXTEND description

Fixes [YOCTO #9909]

Added some technical clarifications to the existing note to be clear
about what is causing the limitations in this case.  Applied some
formatting fixed to for the use of the include word.

(From yocto-docs rev: cbbd960d8665d9fb6b92698c14728d1c0bcc659f)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.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 e265aa94bda..6e6eb22d860 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -1001,19 +1001,21 @@
                         mechanism generates recipe variants by rewriting
                         variable values and applying overrides such as
                         <filename>_class-native</filename>.
-                        For example, to generate a native version of a recipe
-                        named "foo", a
+                        For example, to generate a native version of a recipe,
+                        a
                         <link linkend='var-DEPENDS'><filename>DEPENDS</filename></link>
                         on "foo" is rewritten to a <filename>DEPENDS</filename>
                         on "foo-native".
                         </para>
 
                         <para>
-                        No reparsing, which adds some limitations, of the
-                        recipe is done for each variant.
-                        For example, it is not possible to "include" a
-                        different file depending on the variant, since
-                        "include's" are processed when the recipe is parsed.
+                        Even when using <filename>BBCLASSEXTEND</filename>, the
+                        recipe is only parsed once.
+                        Parsing once adds some limitations.
+                        For example, it is not possible to
+                        include a different file depending on the variant,
+                        since <filename>include</filename> statements are
+                        processed when the recipe is parsed.
                         </para>
                     </note>
                 </para>