bitbake: bitbake-user-manual-metadata.xml: Added section on pathname syntax

Added a brief subsection to the "Basic Syntax" section that
describes the issue using the tilde character (~) when providing
a pathname as part of a statement.  BitBake does not expand
this character like the shell does.  We recommend to not use
it in pathnames.

(Bitbake rev: 8e4c5cee932c3f38d4147c59612d76ca0b002727)

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-04-14 17:56:23 -07:00
committed by Richard Purdie
parent ef7fac5bba
commit f1b9c7ea32

View File

@@ -301,6 +301,29 @@
variable becoming the current date.
</para>
</section>
<section id='providing-pathnames'>
<title>Providing Pathnames</title>
<para>
When specifying pathnames for use with BitBake,
do not use the tilde ("~") character as a shortcut
for your home directory.
Doing so might cause BitBake to not recognize the
path since BitBake does not expand this character in
the same way a shell would.
</para>
<para>
Instead, provide a fuller path as the following
example illustrates:
<literallayout class='monospaced'>
BBLAYERS ?= " \
/home/scott-lenovo/LayerA \
"
</literallayout>
</para>
</section>
</section>
<section id='conditional-syntax-overrides'>