<quote who="hyc@symas.com">
ando@sys-net.it wrote:
ghenry@suretecsystems.com wrote:
<quote who="hyc@symas.com">
> ghenry@OpenLDAP.org wrote:
>> Full_Name: Gavin Henry
>> Version: HEAD
>> OS:
>> URL: ftp://ftp.openldap.org/incoming/
>> Submission from: (NULL) (80.229.93.1)
>> Submitted by: ghenry
>>
>>
>> Dear All,
>>
>> It's not clear or explained what AVA means in slapd-meta(5) and
>> slapo-rwm(5)
> Standard terminology in X.500/LDAP. "Attribute Value Assertion"
>> A user was asking in #ldap
>>
>> I presume it means "Attribute Value"?
>>
>> If so, I will add an explaination in each man page.
> OpenLDAP docs are not intended to explain the basics of LDAP. You're
> expected
> to already know LDAP or refer to the RFCs for basic terminology.
Closing ITS.
In any case, expanding acronyms when first used sounds "polite"; any
further reference to the most appropriate RFC should allow newbie
readers to learn more.
Perhaps, in the Admin Guide.
We have it in preamble.sdf already, so I think this is covered.
But in the man page? Where do you draw the line?
Do we have to start every man page with e.g. "the meta backend to slapd
(the
Standalone LDAP (Lightweight Directory Access Protocol) Daemon) performs
basic
LDAP proxying..." ?
In this case, what good would it do? Would someone who hasn't read any
RFCs
know what "Attribute Value Assertion" means? Anyone who doesn't understand
the
X.500 information model has no business administering slapd. They need to
absorb that basic groundwork first, and IMO manpages are not the mechanism
for
teaching that.
--
-- Howard Chu
Chief Architect, Symas Corp. http://www.symas.com
Director, Highland Sun http://highlandsun.com/hyc/
Chief Architect, OpenLDAP http://www.openldap.org/project/