[prev in list] [next in list] [prev in thread] [next in thread] 

List:       openldap-technical
Subject:    Re: "user"/"users" keyword in documentation
From:       Howard Chu <hyc () symas ! com>
Date:       2023-11-12 20:05:46
Message-ID: 410933c4-fbde-1f22-c2a9-672617b7db4d () symas ! com
[Download RAW message or body]

Uwe Sauter wrote:
> Hi all,
> 
> in the ACL chapter of the online documentation to OpenLDAP 2.6 (and likely the \
> versions before) there might be a mismatch of singular/plural usage of the "users" \
> keyword. 
> In chapter 8.3.2 "who to grant access to" table 5.3 lists specifier "users" as \
> "authenticated users" entities. This is further shown in chapter 8.4.2 "matching \
> anonymous and authenticated users". 
> In chapter 8.4.9 "tips for using regular expressions in access control" the \
> singular is used: "Use shorthands. The user directive matches authenticated users \
> and the anonymous directive matches anonymous users."
> 
> As well as in the subchapters 8.5.x where the singular is used in set definitions.

The examples in monospaced font use the exact keywords. The wording in the regular \
text is just conversational English.

The keywords for sets are not the same as for regular ACLs.


> My question now is: does it matter whether singular or plural of user is used in \
> ACLs? If so, where to use one and where to use the other? Does it follow natural \
> language useage?

Use them as shown in the examples.

-- 
  -- Howard Chu
  CTO, Symas Corp.           http://www.symas.com
  Director, Highland Sun     http://highlandsun.com/hyc/
  Chief Architect, OpenLDAP  http://www.openldap.org/project/


[prev in list] [next in list] [prev in thread] [next in thread]