From openldap-technical Sun Nov 12 20:07:36 2023 From: Howard Chu Date: Sun, 12 Nov 2023 20:07:36 +0000 To: openldap-technical Subject: Re: "user"/"users" keyword in documentation Message-Id: X-MARC-Message: https://marc.info/?l=openldap-technical&m=169981945226189 Howard Chu wrote: > 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. In particular, the Admin Guide is only a guide, not a reference manual. Read the slapd.access(5) manpage for exact syntax. -- -- Howard Chu CTO, Symas Corp. http://www.symas.com Director, Highland Sun http://highlandsun.com/hyc/ Chief Architect, OpenLDAP http://www.openldap.org/project/