summaryrefslogtreecommitdiffstats
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 22:51:24 +0100
commita98ee7b67127a18bb8a81b1e7840c386134812c6 (patch)
treea0ad967f43da1858864725db3f70269fd47e6c5f
parent0fa37e4ba864620972854e8405ed68bb8e8b1560 (diff)
downloadbitbake-a98ee7b67127a18bb8a81b1e7840c386134812c6.tar.gz
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. Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
-rw-r--r--doc/bitbake-user-manual/bitbake-user-manual-metadata.xml23
1 files changed, 23 insertions, 0 deletions
diff --git a/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml b/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml
index 5304e40ce..a9f507212 100644
--- a/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml
+++ b/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'>