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.
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 |