ereport documentation patch

Started by Christophe Pettusover 12 years ago4 messages
#1Christophe Pettus
xof@thebuild.com

Is it reasonable to note in the documentation that ereport does not return if the error severity is greater than or equal to ERROR?

--
-- Christophe Pettus
xof@thebuild.com

--
Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers

#2Heikki Linnakangas
hlinnakangas@vmware.com
In reply to: Christophe Pettus (#1)
Re: ereport documentation patch

On 19.08.2013 23:40, Christophe Pettus wrote:

Is it reasonable to note in the documentation that ereport does not return if the error severity is greater than or equal to ERROR?

Yeah, it probably would be good to mention that. Got a patch?

- Heikki

--
Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers

#3Christophe Pettus
xof@thebuild.com
In reply to: Heikki Linnakangas (#2)
1 attachment(s)
Re: ereport documentation patch

On Aug 19, 2013, at 11:28 PM, Heikki Linnakangas wrote:

On 19.08.2013 23:40, Christophe Pettus wrote:

Is it reasonable to note in the documentation that ereport does not return if the error severity is greater than or equal to ERROR?

Yeah, it probably would be good to mention that. Got a patch?

Attached!

Attachments:

ereport-no-return-doc.patchapplication/octet-stream; name=ereport-no-return-doc.patch; x-unix-mode=0644Download
*** a/doc/src/sgml/sources.sgml
--- b/doc/src/sgml/sources.sgml
***************
*** 143,148 **** ereport(ERROR,
--- 143,155 ----
     </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>
     <listitem>
#4Robert Haas
robertmhaas@gmail.com
In reply to: Christophe Pettus (#3)
Re: ereport documentation patch

On Tue, Aug 20, 2013 at 11:47 AM, Christophe Pettus <xof@thebuild.com> wrote:

Attached!

Committed.

...Robert

--
Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers