Re: [PATCH] Add ACL (Access Control List) acronym - Mailing list pgsql-hackers

On Mon, Jun 24, 2024, at 18:02, David G. Johnston wrote:
> On Mon, Jun 24, 2024 at 8:44 AM Nathan Bossart <nathandbossart@gmail.com> wrote:
>> I think we could omit "i.e. privileges list."
>>
>
> Agreed.  Between the docs and code we say "privileges list" once and
> that refers to the dumputIls description of the arguments to grant.  As
> the acronym page now defines the term using fundamentals, introducing
> another term not used elsewhere seems undesirable.

New version attached.

> Observations:
> We are referencing a disambiguation page.  We never actually spell out
> ACL anywhere so we might as well just reference what Wikipedia believes
> is the expected spelling.
>
> The page we link to uses "permissions" while we consistently use
> "privileges" to describe the contents of the list.  This seems like an
> obvious synonym, but as the point of these is to formally define
> things, pointing this equivalence is worth considering.

I like this idea. How could this be implemented in the docs? Maybe a <note>...</note> for ACL in acronyms.sgml?

/Joel