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

From: Philipp Salvisberg <philipp(dot)salvisberg(at)gmail(dot)com>
To: jian he <jian(dot)universality(at)gmail(dot)com>
Cc: pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Undocumented := alternative in using option of raise statement
Date: 2024-07-22 14:01:18
Message-ID: BE54F6B0-DC20-408A-9B04-6F4F18B7CF38@gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs


> On 22 Jul 2024, at 15:18, jian he <jian(dot)universality(at)gmail(dot)com> wrote:
>
> 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

Thanks Jan for letting me know. Looks good.

Next time I'll check the devel version of the docs before submitting a correction.

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Tom Lane 2024-07-22 16:24:35 Re: Undocumented count in FORWARD/BACKWARD direction of MOVE statement
Previous Message PG Doc comments form 2024-07-22 13:55:52 Undocumented optionality of handler_statements