diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2014-01-10 17:24:16 -0600 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2014-01-21 21:58:00 +0000 |
commit | a66675e2833dd1340963bd825956f67221b516d6 (patch) | |
tree | 2027974b6461a83eecd9440aa768974e91cd705b /documentation | |
parent | c113777087cd64992a5b7d6d4607190ecc401411 (diff) | |
download | ast2050-yocto-poky-a66675e2833dd1340963bd825956f67221b516d6.zip ast2050-yocto-poky-a66675e2833dd1340963bd825956f67221b516d6.tar.gz |
ref-manual: Added note about curly brace parsing to BitBake chapter.
(From yocto-docs rev: 91f199552f0012f1790dbac4d038eac101f2a274)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-rw-r--r-- | documentation/ref-manual/ref-bitbake.xml | 40 |
1 files changed, 40 insertions, 0 deletions
diff --git a/documentation/ref-manual/ref-bitbake.xml b/documentation/ref-manual/ref-bitbake.xml index e24ea45..28496de 100644 --- a/documentation/ref-manual/ref-bitbake.xml +++ b/documentation/ref-manual/ref-bitbake.xml @@ -114,6 +114,46 @@ configuration files or class files on which the <filename>.bb</filename> file depends change. </para> + + <note> + <para> + You need to be aware of how BitBake parses curly braces. + If a recipe uses a closing curly brace within the function and + the character has no leading spaces, BitBake produces a parsing + error. + If you use a pair of curly brace in a shell function, the + closing curly brace must not be located at the start of the line + without leading spaces. + </para> + + <para> + Here is an example that causes BitBake to produce a parsing + error: + <literallayout class='monospaced'> + fakeroot create_shar() { + cat << "EOF" > ${SDK_DEPLOY}/${TOOLCHAIN_OUTPUTNAME}.sh + usage() + { + echo "test" + ###### The following "}" at the start of the line causes a parsing error ###### + } + EOF + } + </literallayout> + Writing the recipe this way avoids the error: + <literallayout class='monospaced'> + fakeroot create_shar() { + cat << "EOF" > ${SDK_DEPLOY}/${TOOLCHAIN_OUTPUTNAME}.sh + usage() + { + echo "test" + ######The following "}" with a leading space at the start of the line avoids the error ###### + } + EOF + } + </literallayout> + </para> + </note> </section> <section id='ref-bitbake-providers'> |