1 files changed, 36 insertions, 0 deletions

diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 9f8fb333dc..7d8b84986c 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -726,6 +726,42 @@
             types of packages.
         </para>
 
+        <note>
+            <para>When writing shell functions, you need to be aware of BitBake's
+            curly brace parsing.
+            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 &lt;&lt; "EOF" &gt; ${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 &lt;&lt; "EOF" &gt; ${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 id='usingpoky-extend-addpkg-singlec'>
             <title>Single .c File Package (Hello World!)</title>