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

On Mon, Jun 24, 2024, at 21:51, David G. Johnston wrote:
> On Mon, Jun 24, 2024 at 12:46 PM Joel Jacobson <joel(at)compiler(dot)org> wrote:
>> On Mon, Jun 24, 2024, at 18:02, David G. Johnston wrote:
>>
>> > 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?
>>
>
> Add a second <para> under the one holding the link?

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