Re: Question about role attributes docs - Mailing list pgsql-docs

From Shinya Kato
Subject Re: Question about role attributes docs
Date
Msg-id 746e739062e232ce42a3a8d07ecac1c5@oss.nttdata.com
Whole thread Raw
In response to Question about role attributes docs  (Shinya Kato <Shinya11.Kato@oss.nttdata.com>)
Responses Re: Question about role attributes docs  (Swaha Miller <swaha.miller@gmail.com>)
List pgsql-docs
On 2022-01-12 02:07, Laurenz Albe wrote:
> On Tue, 2022-01-11 at 16:40 +0900, Shinya Kato wrote:
>> I have a question about the documentation on ROLE.
>> 
>> According to [1], INHERIT and BYPASSRLS can be specified when 
>> executing
>> the CREATE ROLE command. However, there is no such description in Role
>> Attributes in [2]. Are these concepts different from Role Attributes? 
>> Or
>> are they just not documented? If they need to be documented, I'll 
>> create
>> a patch.
>> 
>> [1] https://www.postgresql.org/docs/devel/sql-createrole.html
>> [2] https://www.postgresql.org/docs/devel/role-attributes.html
> 
> I think that is indeed an omission, and adding documentation would be a
> good idea.
Thanks! I created the patch, and attached it.

> On the other hand, a lot of that information is more or less
> a duplicate of the CREATE ROLE documentation.  I wonder if the latter
> page could be removed altogether.
I think there is certainly a lot of overlap. However, I think that the 
SQL commands page and the database roles page should exist separately, 
and should be maintained as they are because there are parts that do not 
overlap (for example, IN ROLE and ADMIN).

-- 
Regards,

--
Shinya Kato
Advanced Computing Technology Center
Research and Development Headquarters
NTT DATA CORPORATION
Attachment

pgsql-docs by date:

Previous
From: Fujii Masao
Date:
Subject: Re: "(process)" is missing for some terms about process in glossary
Next
From: PG Doc comments form
Date:
Subject: Why can NUMERIC columns not use deduplication?