bitbake: user-manual-metadata.xml: Sections to handle variable setting added.

Fixes [YOCTO #5507]

I provided further explanation in the "Basic Variable Setting"
section to note that trailing and leading blanks are not stripped
from a value when set (e.g. VARIABLE = " value").

I added a new section "Null and Blank Setting" explaning that setting
a variable to "" and " " are two different things.

(Bitbake rev: 96d0b38577476a3576487f1fa9a4b6c9dff5d3ed)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark 2014-03-20 04:35:43 -06:00 committed by Richard Purdie
parent 019c868596
commit c0a13d21cf
1 changed files with 20 additions and 0 deletions

View File

@ -30,6 +30,26 @@
<literallayout class='monospaced'>
VARIABLE = "value"
</literallayout>
As expected, if you include leading or trailing spaces as part of
an assignment, the spaces are retained:
<literallayout class='monospaced'>
VARIABLE = " value"
VARIABLE = "value "
</literallayout>
</para>
</section>
<section id='null-and-blank-variable-setting'>
<title>Null and Blank Variable Setting</title>
<para>
Setting <filename>VARIABLE</filename> to "" sets it to null,
while setting the variable to " " sets it to a blank space
(i.e. these are not the same values).
<literallayout class='monospaced'>
VARIABLE = ""
VARIABLE = " "
</literallayout>
</para>
</section>