Re: Version 14/15 documentation Section "Alter Default Privileges"

From: Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at>
To: Michael Banck <mbanck(at)gmx(dot)net>
Cc: David Burns <david(dot)burns(at)fedex(dot)com>, pgsql-hackers(at)lists(dot)postgresql(dot)org
Subject: Re: Version 14/15 documentation Section "Alter Default Privileges"
Date: 2023-10-27 15:49:42
Message-ID: 7de5f33f49a91d7b30b8c01fe46fc280713ebae1.camel@cybertec.at
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-hackers

On Fri, 2023-10-27 at 11:34 +0200, Michael Banck wrote:
> On Fri, Oct 27, 2023 at 09:03:04AM +0200, Laurenz Albe wrote:
> > On Fri, 2022-11-04 at 10:49 +0100, Laurenz Albe wrote:
> > > On Thu, 2022-11-03 at 11:32 +0100, Laurenz Albe wrote:
> > > > On Wed, 2022-11-02 at 19:29 +0000, David Burns wrote:
> > > > > Some additional clarity in the versions 14/15 documentation
> > > > > would be helpful specifically surrounding the "target_role"
> > > > > clause for the ALTER DEFAULT PRIVILEGES command. To the
> > > > > uninitiated, the current description seems vague.  Maybe
> > > > > something like the following would help:
> > >
> > > After some more thinking, I came up with the attached patch.
> >
> I think something like this is highly useful because I have also seen
> people very confused why default privileges are not applied.
>
> However, maybe it could be made even clearer if also the main
> description is amended, like
>
> "You can change default privileges only for objects that will be created
> by yourself or by roles that you are a member of (via target_role)."
>
> or something.

True. I have done that in the attached patch.
In this patch, it is mentioned *twice* that ALTER DEFAULT PRIVILEGES
only affects objects created by the current user. I thought that
would not harm, but if it is too redundant, I can remove the second
mention.

Yours,
Laurenz Albe

Attachment Content-Type Size
0001-Improve-ALTER-DEFAULT-PRIVILEGES-documentation.V2.patch text/x-patch 2.3 KB

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2023-10-27 21:23:45 Re: Minor inconsistencies
Previous Message Bruce Momjian 2023-10-27 15:40:08 Re: [very minor] Documentation suggestion

Browse pgsql-hackers by date

  From Date Subject
Next Message Pavel Stehule 2023-10-27 15:58:14 Re: Schema variables - new implementation for Postgres 15
Previous Message Drouvot, Bertrand 2023-10-27 15:30:20 Re: Synchronizing slots from primary to standby