Re: role attributes are missing from this page

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: wantakeith+160(at)gmail(dot)com
Cc: pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: role attributes are missing from this page
Date: 2022-04-12 19:29:48
Message-ID: 910015.1649791788@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

PG Doc comments form <noreply(at)postgresql(dot)org> writes:
> Issue #1:
> "old" is a keyword, but I cannot query the old column explicitely with
> surrounding quotes.
> SELECT "old" FROM pg_roles;

Look closer. That column is "oid" not "old".

> Issue #2:
> You do not have ALL role attributes documented on this page. Please add and
> document the missing role attributes.
> https://www.postgresql.org/docs/current/role-attributes.html

AFAICS this page is merely trying to document the role properties that
can reasonably be considered to be kinds of privileges. I don't have
a problem with it not mentioning role name or password, for example.
In any case, if you want a full list of what is in the pg_roles view,
the place to look is under the system views documentation:

https://www.postgresql.org/docs/current/view-pg-roles.html

role-attributes.html is not intended to be a substitute for that.

regards, tom lane

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Peter Geoghegan 2022-04-12 19:34:52 Re: "GIN and GiST Index Types" page is about usage in full text search, but looks general purpose
Previous Message PG Doc comments form 2022-04-12 18:43:42 "GIN and GiST Index Types" page is about usage in full text search, but looks general purpose