summaryrefslogtreecommitdiffstats
path: root/bitbake
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2016-02-23 09:18:08 -0800
committerRichard Purdie <richard.purdie@linuxfoundation.org>2016-03-03 17:34:14 +0000
commit638ad177aa4e36636113bc1c1608085380d264ce (patch)
tree1014db1188d252d0b5f51fbc10f404bc72ced86e /bitbake
parentda22add33b8f44ff3019ee9edd7a520b54769c27 (diff)
downloadpoky-638ad177aa4e36636113bc1c1608085380d264ce.tar.gz
bitbake: bitbake-user-manual: Added note for Python variable ref expansion.
Fixes [YOCTO #9148] Added a note about Variable expressions (e.g. ${X}) are no longer expanded within Python functions. (Bitbake rev: 4ebe55cb8c8db1c5cf5d127e213487c5a453a68a) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'bitbake')
-rw-r--r--bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml12
1 files changed, 12 insertions, 0 deletions
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml
index cfa85b379a..359df8f75f 100644
--- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml
+++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml
@@ -840,6 +840,18 @@
840 is a global variable and is always automatically 840 is a global variable and is always automatically
841 available. 841 available.
842 </para> 842 </para>
843
844 <note>
845 Variable expressions (e.g. <filename>${X}</filename>) are no
846 longer expanded within Python functions.
847 This behavior is intentional in order to allow you to freely
848 set variable values to expandable expressions without having
849 them expanded prematurely.
850 If you do wish to expand a variable within a Python function,
851 use <filename>d.getVar("X", True)</filename>.
852 Or, for more complicated expressions, use
853 <filename>d.expand()</filename>.
854 </note>
843 </section> 855 </section>
844 856
845 <section id='python-functions'> 857 <section id='python-functions'>