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