Re: Documentation does not describes format for access privileges: =Tc/user

Поиск
Список
Период
Сортировка
От David G. Johnston
Тема Re: Documentation does not describes format for access privileges: =Tc/user
Дата
Msg-id CAKFQuwbRk15AthfdkzZ9xDS0E+QvXG07Btcvv8V6DUg9jJdz2g@mail.gmail.com
обсуждение исходный текст
Ответ на Re: Documentation does not describes format for access privileges: =Tc/user  ("David G. Johnston" <david.g.johnston@gmail.com>)
Ответы Re: Documentation does not describes format for access privileges: =Tc/user  (Tom Lane <tgl@sss.pgh.pa.us>)
Список pgsql-docs
On Monday, December 25, 2023, David G. Johnston <david.g.johnston@gmail.com> wrote:
On Monday, December 25, 2023, Eugen Konkov <konkove@gmail.com> wrote:
No, it does not. If you refer to `An empty grantee field in an aclitem
stands for PUBLIC.` then "grantee field" was never described. What is
this?

It would be very clear if it was described in this way:
The access privileges has the following format: "grantee=privileges/who grants".


Yes, it requires a bit of mental gymnastics to read.  The description says Calvin is the role being granted the privileges which makes that the grantee and Calvin is listed before the equal sign in the reference.

“Who grants” is the “grantor”.

I’ll accept that this can be improved but aside from a dictionary definition of grantee, which we don’t usually do, everything is shown.

We probably should write the syntax like we do everywhere else:

[grantee]={privilege[*]}[…]/grantor

Then define the placeholders in the subsequent paragraph.

David J.

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

Предыдущее
От: "David G. Johnston"
Дата:
Сообщение: Re: Documentation does not describes format for access privileges: =Tc/user
Следующее
От: Tom Lane
Дата:
Сообщение: Re: Documentation does not describes format for access privileges: =Tc/user