Undocumented := alternative in using option of raise statement

From: PG Doc comments form <noreply(at)postgresql(dot)org>
To: pgsql-docs(at)lists(dot)postgresql(dot)org
Cc: philipp(dot)salvisberg(at)gmail(dot)com
Subject: Undocumented := alternative in using option of raise statement
Date: 2024-07-22 08:00:26
Message-ID: 172163522625.709.14011263605748671820@wrigleys.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/16/plpgsql-errors-and-messages.html
Description:

The using option is documented as follows for all variants of the raise
statement:

USING option = expression [, ... ]

However, since "do $$ begin raise notice using message := 'foo'; end $$;"
works and the alternative to "=" is documented in
https://www.postgresql.org/docs/current/plpgsql-statements.html#PLPGSQL-STATEMENTS-ASSIGNMENT
I suggest to change the grammar to

USING option { := | = } expression [, ... ]

for the raise statement.

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Amit Kapila 2024-07-22 10:54:55 Re: Fix an incorrect statement for failover option in alter_subscription.sgml
Previous Message 日向充 2024-07-22 06:33:44 Re: A minor bug in the doc of "SQL Functions Returning Sets" in xfunc.sgml.