bitbake: user-manual: Review edits applied throughout from Paul Eggleton.

Applied review edits from Paul Eggleton spanning the entire book.
Small areas affected in all chapters except the "Hello World"
Appendix.

Noteworthy changes in the variables chapter where I added two new
variables: BBINCLUDELOGS_LINES and BB_CONSOLELOG.

(Bitbake rev: 2d4b09be70c6df0c1605f7e291149c682999cf50)

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

1 files changed, 20 insertions, 20 deletions

diff --git a/bitbake/doc/user-manual/user-manual-metadata.xml b/bitbake/doc/user-manual/user-manual-metadata.xml
index 3a19b96303..f7682c0fed 100644
--- a/bitbake/doc/user-manual/user-manual-metadata.xml
+++ b/bitbake/doc/user-manual/user-manual-metadata.xml
@@ -41,14 +41,18 @@
                 contents using a syntax that is similar to shell scripting.
                 Following is an example that results in <filename>A</filename>
                 containing "aval" and <filename>B</filename> evaluating to
-                "preavalpost".
+                "preavalpost" based on that current value of
+                <filename>A</filename>.
                 <literallayout class='monospaced'>
      A = "aval"
      B = "pre${A}post"
                 </literallayout>
-                Because the expansion happens later, the value of
-                <filename>B</filename> expands differently if the value
-                of <filename>A</filename> changes.
+                You should realize that whenever <filename>B</filename> is
+                referenced, its evaluation will depend on the state of
+                <filename>A</filename> at that time.
+                Thus, later evaluations of <filename>B</filename> in the
+                previous example could result in different values
+                depending on the value of <filename>A</filename>.
             </para>
         </section>
 
@@ -1387,19 +1391,16 @@
                                 Using "expand=True" expands the value.</entry>
                         </row>
                         <row>
-                            <entry align="left"><filename>d.setVar("X", value)</filename></entry>
-                            <entry align="left">Sets the variable "X" to the value of the Python
-                            variable called "value".</entry>
+                            <entry align="left"><filename>d.setVar("X", "value")</filename></entry>
+                            <entry align="left">Sets the variable "X" to "value".</entry>
                         </row>
                         <row>
-                            <entry align="left"><filename>d.appendVar("X", value)</filename></entry>
-                            <entry align="left">Adds the value of the Python variable called
-                            "value" to the end of the variable "X".</entry>
+                            <entry align="left"><filename>d.appendVar("X", "value")</filename></entry>
+                            <entry align="left">Adds "value" to the end of the variable "X".</entry>
                         </row>
                         <row>
-                            <entry align="left"><filename>d.prependVar("X", value)</filename></entry>
-                            <entry align="left">Adds the value of the Python variable called
-                            "value" to the start of the variable "X".</entry>
+                            <entry align="left"><filename>d.prependVar("X", "value")</filename></entry>
+                            <entry align="left">Adds "value" to the start of the variable "X".</entry>
                         </row>
                         <row>
                             <entry align="left"><filename>d.delVar("X")</filename></entry>
@@ -1415,18 +1416,17 @@
                                 Using "expand=True" expands the named flag.</entry>
                         </row>
                         <row>
-                            <entry align="left"><filename>d.setVarFlag("X", flag, value)</filename></entry>
-                            <entry align="left">Sets the named flag for variable "X" to the value
-                                of the Python variable called "value".</entry>
+                            <entry align="left"><filename>d.setVarFlag("X", flag, "value")</filename></entry>
+                            <entry align="left">Sets the named flag for variable "X" to "value".</entry>
                         </row>
                         <row>
-                            <entry align="left"><filename>d.appendVarFlag("X", flag, value)</filename></entry>
-                            <entry align="left">Appends a value to the named flag on the
+                            <entry align="left"><filename>d.appendVarFlag("X", flag, "value")</filename></entry>
+                            <entry align="left">Appends "value" to the named flag on the
                             variable "X".</entry>
                         </row>
                         <row>
-                            <entry align="left"><filename>d.prependVarFlag("X", flag, value)</filename></entry>
-                            <entry align="left">Prepends a value to the named flag on
+                            <entry align="left"><filename>d.prependVarFlag("X", flag, "value")</filename></entry>
+                            <entry align="left">Prepends "value" to the named flag on
                                the variable "X".</entry>
                         </row>
                         <row>