Re: doc - improve description of default privileges

Hello Tom,

Thanks for this precise feedback.

> Progress on this patch seems to be blocked on the question of whether
> we want to keep enlarging the amount of psql-specific information
> in the GRANT reference page, or move that all somewhere else.

Yep.

> FWIW, I think I agree with Peter's position that moving it somewhere
> else is the better option. Section 5.6 "Privileges" seems like a
> reasonable choice.

Ok.

> * Perhaps we could fix Peter's complaint about the "Owner" column by
> relabeling it "All Privileges".

Ok.

> I'd be inclined to label the last column "Default PUBLIC Privileges",
> too, if we can fit that in.

Ok.

> * The phrase "relation-like objects" seems way too vague, especially since
> one has to read it as excluding sequences, which surely are relations for
> most purposes. Is there a good reason not to just leave that entry as
> "TABLE", full stop? Or maybe it could be "TABLE, VIEW, etc" or some such.

Ok.

> * I don't think the use of "hardcoded" adds anything.

Hmmm. As "default privileges" can be altered, the point is to describe the
"default default privileges", but this looks absurd, hence the look for
something to add the idea that there is another one. ISTM that removing
"hardcoded" without replacing it makes the thing slightly ambiguous.
No big deal.

> * Is it worth adding another table matching privilege names ("INSERT")
> with their aclitem letters ("a"), rather than having the semi-formal
> format currently appearing in grant.sgml?

Indeed I thought about that, because the description is not easy to read.

> There's also some related material in 9.25 with the aclitem functions;
> it'd be worth unifying that too maybe.

I've put a reference to it at least.

Attached v4:
- moves the table to the privileges section
- updates the table column headers
- adds a privilege/aclitem letter mapping table
- adds some appropriate links towards psql & aclitem

--
Fabien.