Re: Incorrect Syntax in Function Syntax diagram

Поиск
Список
Период
Сортировка
От David G. Johnston
Тема Re: Incorrect Syntax in Function Syntax diagram
Дата
Msg-id CAKFQuwaGV+47J9yqoi16Ke7jkzKALO1V=VXrjMPwhMe9tL580w@mail.gmail.com
обсуждение исходный текст
Ответ на Incorrect Syntax in Function Syntax diagram  (PG Doc comments form <noreply@postgresql.org>)
Ответы Re: Incorrect Syntax in Function Syntax diagram  (Tom Lane <tgl@sss.pgh.pa.us>)
Список pgsql-docs
On Wed, Jun 23, 2021 at 6:31 AM PG Doc comments form <noreply@postgresql.org> wrote:
The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/13/sql-createfunction.html
Description:

| IMMUTABLE | STABLE | VOLATILE | [ NOT ] LEAKPROOF

[ NOT ] LEAKPROOF  is accepting separately ,
So why you written [ NOT ] LEAKPROOF with | IMMUTABLE | STABLE | VOLATILE |


The commit message doesn't say - but I can see how from a technical perspective that the claim that something is immutable is considered similar to a claim that something has no side effects, thus there is a connection.  As noted below, the fact that the first three are mutually exclusive while leakproof is not is convincing enough a reason to list leakproof separately.

Please separate the [ NOT ] LEAKPROOF from the OR list

I would agree, and would add that I wonder whether the syntax for the three mutually exclusive options should be shown as such instead of having to read that in the description notes.  Does writing < | { IMMUTABLE | STABLE | VOLATILE } > work?

Note: Your documentation must be correct

Is that so? It is a good thing then that it is presently correct and that this is just a readability suggestion.  The presence of them all on the same line does not by itself imply any kind of relationship in the actual grammar.

David J.

В списке pgsql-docs по дате отправления:

Предыдущее
От: PG Doc comments form
Дата:
Сообщение: Incorrect Syntax in Function Syntax diagram
Следующее
От: Tom Lane
Дата:
Сообщение: Re: Incorrect Syntax in Function Syntax diagram