[oe-commits] [bitbake] 06/09: bitbake-user-manual: Added non-existant variable expansion

[git at git.openembedded.org]

rpurdie pushed a commit to branch master
in repository bitbake.

commit 8006da3f229d0227215ccd59cd273edacf72f9ce
Author: Scott Rifenbark <srifenbark at gmail.com>
AuthorDate: Fri Jul 22 08:36:09 2016 -0700

    bitbake-user-manual: Added non-existant variable expansion
    
    Fixes [YOCTO #10003]
    
    I added a small paragraph explaining what happens when expansion
    of a variable that does not exist occurs.
    
    Signed-off-by: Scott Rifenbark <srifenbark at gmail.com>
---
 doc/bitbake-user-manual/bitbake-user-manual-metadata.xml | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml b/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml
index fe04103..ce0e84d 100644
--- a/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml
+++ b/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml
@@ -86,6 +86,17 @@
                 <link linkend='immediate-variable-expansion'>immediate variable expansion</link>
                 operator (i.e. ":=").
             </para>
+
+            <para>
+                If the variable expansion syntax is used on a variable that
+                does not exist, the string is kept as is.
+                For example, given the following assignment,
+                <filename>BAR</filename> expands to the literal string
+                "${FOO}" as long as <filename>FOO</filename> does not exist.
+                <literallayout class='monospaced'>
+     BAR = "${FOO}"
+                </literallayout>
+            </para>
         </section>
 
         <section id='setting-a-default-value'>

-- 
To stop receiving notification emails like this one, please contact
the administrator of this repository.