pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  

help / color / mirror / Atom feed

From: Philipp Salvisberg <philipp.salvisberg@gmail.com>
To: jian he <jian.universality@gmail.com>
Cc: pgsql-docs@lists.postgresql.org
Subject: Re: Undocumented := alternative in using option of raise statement
Date: Mon, 22 Jul 2024 16:01:18 +0200
Message-ID: <BE54F6B0-DC20-408A-9B04-6F4F18B7CF38@gmail.com> (raw)
In-Reply-To: <CACJufxGENQMvdQqn+EnkzJzquU3C9Kxb7gvHo51MBVeA9ucjQw@mail.gmail.com>
References: <172163522625.709.14011263605748671820@wrigleys.postgresql.org>
	<CACJufxGENQMvdQqn+EnkzJzquU3C9Kxb7gvHo51MBVeA9ucjQw@mail.gmail.com>


> On 22 Jul 2024, at 15:18, jian he <jian.universality@gmail.com> wrote:
> 
> On Mon, Jul 22, 2024 at 8:38 PM PG Doc comments form
> <noreply@postgresql.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.

view thread (3+ messages)

Message-ID: <BE54F6B0-DC20-408A-9B04-6F4F18B7CF38@gmail.com>
Permalink:  ../BE54F6B0-DC20-408A-9B04-6F4F18B7CF38@gmail.com/
Also on:    postgresql.org/message-id/BE54F6B0-DC20-408A-9B04-6F4F18B7CF38@gmail.com

copy link · copy postgr.es

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-docs@postgresql.org
  Cc: philipp.salvisberg@gmail.com, jian.universality@gmail.com, pgsql-docs@lists.postgresql.org
  Subject: Re: Undocumented := alternative in using option of raise statement
  In-Reply-To: <BE54F6B0-DC20-408A-9B04-6F4F18B7CF38@gmail.com>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox