Message-ID: <72652d72e1816bfc3c05d40f9e0e0373d07823c8.camel@octave.org>
Subject: Document target_role param of ALTER DEFAULT PRIVILEGES
From: Jordi =?ISO-8859-1?Q?Guti=E9rrez?= Hermoso <jordigh@octave.org>
To: pgsql-docs@lists.postgresql.org
Date: Wed, 17 Feb 2021 15:08:35 -0500
Content-Type: text/plain; charset="UTF-8"
User-Agent: Evolution 3.30.5-1.1+jordigh 
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Precedence: bulk

I just had a confusing moment trying to figure out why my roles
weren't creating tables the way I was expecting them to. I didn't
understand what the `target_role` parameter did. No matter how I try
to read this page, I can't see an explanation for that parameter:

https://www.postgresql.org/docs/current/sql-alterdefaultprivileges.html

I propose an explanation like the following be added to the
`target_role` parameter:

    This is the role that will create objects with altered default
    privileges. Note that changes in default privileges aren't
    inherited, so altering the default privileges of created objects
    for a parent role will not change the default privileges of
    objects created by inherited roles.