[gnome-continuous-yocto/gnomeostree-3.28-rocko: 2726/8267] ref-manual: Updated "Viewing Variable Values" section.

[Emmanuele Bassi <ebassi src gnome org>]

commit 89621b137eba2b0678eff5abf4ee57134946d3ef
Author: Scott Rifenbark <srifenbark gmail com>
Date:   Wed Sep 21 13:50:58 2016 -0700

    ref-manual: Updated "Viewing Variable Values" section.
    
    Fixes [YOCTO #10292]
    
    I added an additional paragraph at the end of the section that
    provided more detail on what the bitbake -e and bitbake -e recipe
    commands provide in the way output.
    
    (From yocto-docs rev: 1dcdb6781105f046328271e2b4ba7d875b222dcf)
    
    Signed-off-by: Scott Rifenbark <srifenbark gmail com>
    Signed-off-by: Richard Purdie <richard purdie linuxfoundation org>

 documentation/ref-manual/usingpoky.xml |   32 ++++++++++++++++++++++++++++++++
 1 files changed, 32 insertions(+), 0 deletions(-)
---
diff --git a/documentation/ref-manual/usingpoky.xml b/documentation/ref-manual/usingpoky.xml
index b63e031..75ee86f 100644
--- a/documentation/ref-manual/usingpoky.xml
+++ b/documentation/ref-manual/usingpoky.xml
@@ -246,6 +246,38 @@
      export CC="i586-poky-linux-gcc -m32 -march=i586 --sysroot=/home/ulf/poky/build/tmp/sysroots/qemux86"
             </literallayout>
         </para>
+
+        <para>
+            In addition to variable values, the output of the
+            <filename>bitbake -e</filename> and
+            <filename>bitbake -e</filename>&nbsp;<replaceable>recipe</replaceable>
+            commands includes the following information:
+            <itemizedlist>
+                <listitem><para>
+                    The output starts with a tree listing all configuration
+                    files and classes included globally, recursively listing
+                    the files they include or inherit in turn.
+                    Much of the behavior of the OpenEmbedded build system
+                    (including the behavior of the
+                    <link linkend='normal-recipe-build-tasks'>normal recipe build tasks</link>)
+                    is implemented in the
+                    <link linkend='ref-classes-base'><filename>base</filename></link>
+                    class and the classes it inherits, rather than being built
+                    into BitBake itself.
+                    </para></listitem>
+                <listitem><para>
+                    After the variable values, all functions appear in the
+                    output.
+                    For shell functions, variables referenced within the
+                    function body are expanded.
+                    If a function has been modified using overrides or
+                    using override-style operators like
+                    <filename>_append</filename> and
+                    <filename>_prepend</filename>, then the final assembled
+                    function body appears in the output.
+                    </para></listitem>
+            </itemizedlist>
+        </para>
     </section>
 
     <section id='viewing-package-information-with-oe-pkgdata-util'>