Re: doc - improve description of default privileges

From: Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com>
To: Brad DeJong <bpd0018(at)gmail(dot)com>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: Fabien COELHO <coelho(at)cri(dot)ensmp(dot)fr>, PostgreSQL Developers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: doc - improve description of default privileges
Date: 2018-09-28 19:01:04
Message-ID: 36afbc06-4286-b135-063a-a195b748768d@2ndquadrant.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

Some thoughts:

We should keep the GRANT reference page about GRANT. There is a section
about Privileges in the Data Definition chapter, which we could use to
expand on general concepts.

The ALTER DEFAULT PRIVILEGES reference page would be another place this
could be put.

The Owner column is redundant, because it's always all applicable
privileges. (Having this column would give the impression that it's not
always all privileges, so it would be confusing.)

Privileges should be listed using their full name (e.g., "SELECT"), not
their internal abbreviation letter.

The psql commands seem out of place here. If you want to learn about
how to use psql, you can go to the psql documentation.

--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Alvaro Herrera 2018-09-28 19:06:30 Re: ALTER TABLE on system catalogs
Previous Message Tom Lane 2018-09-28 18:59:58 Re: Let's stop with the retail rebuilds of src/port/ files already