Re: Undocumented := alternative in using option of raise statement

From: jian he <jian(dot)universality(at)gmail(dot)com>
To: philipp(dot)salvisberg(at)gmail(dot)com, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Undocumented := alternative in using option of raise statement
Date: 2024-07-22 13:18:41
Message-ID: CACJufxGENQMvdQqn+EnkzJzquU3C9Kxb7gvHo51MBVeA9ucjQw@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Mon, Jul 22, 2024 at 8:38 PM PG Doc comments form
<noreply(at)postgresql(dot)org> wrote:
>
> 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.

I think this has been committed.
https://git.postgresql.org/cgit/postgresql.git/commit/?id=56c6be57af6bd1c7eb7dff50e5f169ced4ed3045

you can check latest doc at:
https://www.postgresql.org/docs/devel/plpgsql-errors-and-messages.html

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message PG Doc comments form 2024-07-22 13:55:52 Undocumented optionality of handler_statements
Previous Message Amit Kapila 2024-07-22 11:12:55 Re: Correction in doc of failover ready steps