Re: incorrect (incomplete) description for "alter domain"

Поиск
Список
Период
Сортировка
От David G. Johnston
Тема Re: incorrect (incomplete) description for "alter domain"
Дата
Msg-id CAKFQuwbZ3KDq3CtG0qtw7gVT4EWgmD8XFMktEFcruVs98ihCSw@mail.gmail.com
обсуждение исходный текст
Ответ на incorrect (incomplete) description for "alter domain"  (PG Doc comments form <noreply@postgresql.org>)
Ответы Re: incorrect (incomplete) description for "alter domain"
Список pgsql-docs
On Monday, July 29, 2024, 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/sql-alterdomain.html
Description:

In the Synopsis section of
https://www.postgresql.org/docs/current/sql-alterdomain.html
this is incorrect (incomplete):
"ALTER DOMAIN name ADD domain_constraint [ NOT VALID ]"
It should be
"ALTER DOMAIN name ADD CONSTRAINT domain_constraint [ NOT VALID ]"

The definition of “domain_constraint” includes the optional “constraint constraint_name” clause.  Though reading the page and seeing the number of times we say “alter domain add constraint” I even more inclined to agree that bringing the word constraint there is desirable.  I am not a huge fan of the indirect syntax references anyway.  But I think your proposed fix is technically wrong since the word constraint is optional but your change makes it mandatory.

David J.

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