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

Christophe Pettus

diff --git a/doc/src/sgml/sources.sgml b/doc/src/sgml/sources.sgml
index 4b78679d32d808ddddc3c291ba8689a653fa1023..61ab9325c9ebab7540efdfc4c0a6e20b1a25bdf4 100644 (file)
--- 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>