Re: [PATCH] Add ACL (Access Control List) acronym

On Mon, Jun 24, 2024 at 1:49 PM Joel Jacobson <joel(at)compiler(dot)org> wrote:

> How about?
>
> + <para>
> + The linked page uses "permissions" while we consistently use the
> synonym
> + "privileges", to describe the contents of the list. For avoidance of
> + doubt and clarity, these two terms are equivalent in the
> + <productname>PostgreSQL</productname> documentation.
> + </para>
>
> /Joel

I really dislike "For avoidance of doubt and clarity" - and in terms of
being equivalent the following seems like a more accurate description of
reality.

The PostgreSQL documentation, and code, refers to the specifications within
the ACL as "privileges". This has the same meaning as "permissions" on the
linked page. Generally if we say "permissions" we are referring to
something that is not covered by the ACL. In routine communication the two
words are often used interchangeably.

David J.