[gnome-continuous-yocto/gnomeostree-3.28-rocko: 1486/8267] bitbake: bitbake-user-manual: Added review changes to BBCLASSEXTEND description

[Emmanuele Bassi <ebassi src gnome org>]

commit 9a9577ed498c9e9333f9640871378d67481011d2
Author: Scott Rifenbark <srifenbark gmail com>
Date:   Thu Jul 14 12:52:30 2016 -0700

    bitbake: bitbake-user-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.
    
    (Bitbake rev: e9ad2e0f6d2681dd793cc39c468eb86e57fd6f48)
    
    Signed-off-by: Scott Rifenbark <srifenbark gmail com>
    Signed-off-by: Richard Purdie <richard purdie linuxfoundation org>

 .../bitbake-user-manual-ref-variables.xml          |   16 +++++++++-------
 1 files changed, 9 insertions(+), 7 deletions(-)
---
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.xml 
b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.xml
index e81f3ed..4d8ee69 100644
--- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.xml
+++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.xml
@@ -992,19 +992,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>