From 8d00ab630668a15e86b584b39187ef3bf3154511 Mon Sep 17 00:00:00 2001
From: Robert Haas <rhaas@postgresql.org>
Date: Mon, 26 Aug 2013 14:27:43 -0400
Subject: [PATCH] doc: Explain that ereport doesn't return for ERROR or higher
 levels.

Christophe Pettus
---
 doc/src/sgml/sources.sgml | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/doc/src/sgml/sources.sgml b/doc/src/sgml/sources.sgml
index 4b78679d32d..61ab9325c9e 100644
--- 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>
-- 
GitLab