aboutsummaryrefslogtreecommitdiffstats
path: root/bitbake/doc
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2014-04-14 17:56:23 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2014-04-21 23:03:19 +0100
commitf1b9c7ea32539180d236cf977aac2eb975afe260 (patch)
tree1464fbf76fc0f6504d9226a5b429118a4530b00c /bitbake/doc
parentef7fac5bba0fc9dcd12f8bdd1a4e0fd0c3576e00 (diff)
downloadopenembedded-core-contrib-f1b9c7ea32539180d236cf977aac2eb975afe260.tar.gz
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>
Diffstat (limited to 'bitbake/doc')
-rw-r--r--bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml23
1 files changed, 23 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 5304e40ce7..a9f5072128 100644
--- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml
+++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml
@@ -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'>