Обсуждение: Documentation of FOR ROLE clause of ALTER DEFAULT PRIVILEGES missing

Поиск
Список
Период
Сортировка

Documentation of FOR ROLE clause of ALTER DEFAULT PRIVILEGES missing

От
PG Doc comments form
Дата:
The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/10/static/sql-alterdefaultprivileges.html
Description:

The documentation of ALTER DEFAULT PRIVILEGES statements seems to lack an
elaboration of the FOR ROLE clause.

It specifies what restrictions exist (namely "The name of an existing role
of which the current role is a member."), but what the specified role is
actually used for remains a mystery.

The documentation should read something like: "The default permissions are
only granted on objects created by this role."

Re: Documentation of FOR ROLE clause of ALTER DEFAULT PRIVILEGES missing

От
Bruce Momjian
Дата:
On Thu, Feb 22, 2018 at 07:50:19PM +0000, PG Doc comments form wrote:
> The following documentation comment has been logged on the website:
> 
> Page: https://www.postgresql.org/docs/10/static/sql-alterdefaultprivileges.html
> Description:
> 
> The documentation of ALTER DEFAULT PRIVILEGES statements seems to lack an
> elaboration of the FOR ROLE clause.
> 
> It specifies what restrictions exist (namely "The name of an existing role
> of which the current role is a member."), but what the specified role is
> actually used for remains a mystery.
> 
> The documentation should read something like: "The default permissions are
> only granted on objects created by this role."

I know this is five years late, but we fixed this issue and the new docs
will appear in Postgres 17:

    https://www.postgresql.org/docs/devel/sql-alterdefaultprivileges.html

We felt the doc rewrite was too extensive to backpatch.

-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  Only you can decide what is important to you.