diff --git a/documentation/ref-manual/usingpoky.xml b/documentation/ref-manual/usingpoky.xml
index 36525c47b0..f7345547c5 100644
--- a/documentation/ref-manual/usingpoky.xml
+++ b/documentation/ref-manual/usingpoky.xml
@@ -902,6 +902,11 @@
                     This logging function is similar to
                     <filename>bb.error(</filename><replaceable>msg</replaceable><filename>)</filename>
                     but also causes the calling task to fail.
+                    <note>
+                        <filename>bb.fatal()</filename> raises an exception,
+                        which means you do not need to put a "return"
+                        statement after the function.
+                    </note>
                     </para></listitem>
             </itemizedlist>
         </para>