doc: Explain that ereport doesn't return for ERROR or higher levels.

robertmhaas · robertmhaas · commit 8d00ab630668 · 2013-08-26T14:27:43.000-04:00
Christophe Pettus
diff --git a/doc/src/sgml/sources.sgml b/doc/src/sgml/sources.sgml
@@ -142,6 +142,13 @@ ereport(ERROR,
     a message text.  Also, an optional <quote>hint</> message is provided.
    </para>
 
+   <para>
+    If the severity level is <literal>ERROR</> or higher,
+    <function>ereport</> aborts the execution of the user-defined
+    function and does not return to the caller. If the severity level is
+    lower than <literal>ERROR</>, <function>ereport</> returns normally.
+   </para>
+    
    <para>
     The available auxiliary routines for <function>ereport</> are:
   <itemizedlist>
