Content-Type: text/plain;
	charset=utf-8
Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3774.600.62\))
Subject: Re: Undocumented := alternative in using option of raise statement
From: Philipp Salvisberg <philipp.salvisberg@gmail.com>
In-Reply-To: 
 <CACJufxGENQMvdQqn+EnkzJzquU3C9Kxb7gvHo51MBVeA9ucjQw@mail.gmail.com>
Date: Mon, 22 Jul 2024 16:01:18 +0200
Cc: pgsql-docs@lists.postgresql.org
Content-Transfer-Encoding: quoted-printable
Message-Id: <BE54F6B0-DC20-408A-9B04-6F4F18B7CF38@gmail.com>
References: <172163522625.709.14011263605748671820@wrigleys.postgresql.org>
 <CACJufxGENQMvdQqn+EnkzJzquU3C9Kxb7gvHo51MBVeA9ucjQw@mail.gmail.com>
To: jian he <jian.universality@gmail.com>
Archived-At: 
 <https://www.postgresql.org/message-id/BE54F6B0-DC20-408A-9B04-6F4F18B7CF38%40gmail.com>
Precedence: bulk


> On 22 Jul 2024, at 15:18, jian he <jian.universality@gmail.com> wrote:
>=20
> On Mon, Jul 22, 2024 at 8:38=E2=80=AFPM PG Doc comments form
> <noreply@postgresql.org> wrote:
>>=20
>> The following documentation comment has been logged on the website:
>>=20
>> Page: =
https://www.postgresql.org/docs/16/plpgsql-errors-and-messages.html
>> Description:
>>=20
>> The using option is documented as follows for all variants of the =
raise
>> statement:
>>=20
>> USING option =3D expression [, ... ]
>>=20
>> However, since "do $$ begin raise notice using message :=3D 'foo'; =
end $$;"
>> works and the alternative to "=3D" is documented in
>> =
https://www.postgresql.org/docs/current/plpgsql-statements.html#PLPGSQL-ST=
ATEMENTS-ASSIGNMENT
>> I suggest to change the grammar to
>>=20
>> USING option { :=3D | =3D } expression [, ... ]
>>=20
>> for the raise statement.
>=20
> I think this has been committed.
> =
https://git.postgresql.org/cgit/postgresql.git/commit/?id=3D56c6be57af6bd1=
c7eb7dff50e5f169ced4ed3045
>=20
> 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.=20

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