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 23:05:14 +0100
commit1eb75407ae192a91667dd5527c51f3c8b27d770b (patch)
tree1aac143b6736199d39bbf3faed7fefddd87228e5
parent2c79d57ded82ab9e8997f835e694002ba04d06ae (diff)
downloadpoky-1eb75407ae192a91667dd5527c51f3c8b27d770b.tar.gz
poky-1eb75407ae192a91667dd5527c51f3c8b27d770b.tar.bz2
poky-1eb75407ae192a91667dd5527c51f3c8b27d770b.zip
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: a98ee7b67127a18bb8a81b1e7840c386134812c6) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
-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'>